feat(signal, single-pointer): sperate package single-pointer from package signal

Author: devphilip21

.github/workflows/publish-package.yml

@@ -0,0 +1,82 @@
+name: Release
+run-name: "Release packages @${{ github.sha }}"
+
+on:
+  workflow_dispatch:
+    inputs:
+      dry-run:
+        description: 'Dry-run mode (no publish)'
+        required: false
+        default: 'false'
+        type: boolean
+      first-release:
+        description: 'First release (no git tags exist yet)'
+        required: false
+        default: 'false'
+        type: boolean
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Run tests
+        run: npx nx run-many -t test --projects=packages/*
+
+      - name: Build packages
+        run: npx nx run-many -t build --projects=packages/*
+
+      - name: Set release flags
+        id: flags
+        run: |
+          FLAGS=""
+          if [ "${{ inputs.first-release }}" == "true" ]; then
+            FLAGS="$FLAGS --first-release"
+          fi
+          echo "flags=$FLAGS" >> $GITHUB_OUTPUT
+
+      - name: Release (dry-run)
+        if: ${{ inputs.dry-run == 'true' }}
+        run: npx nx release --skip-publish --dry-run ${{ steps.flags.outputs.flags }}
+
+      - name: Release
+        if: ${{ inputs.dry-run != 'true' }}
+        run: npx nx release ${{ steps.flags.outputs.flags }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true
+
+      - name: Push changes and tags
+        if: ${{ inputs.dry-run != 'true' }}
+        run: git push --follow-tags

.github/workflows/release.yml

@@ -3,6 +3,37 @@
   "targetDefaults": {
     "build": {
       "dependsOn": ["^build"]
+    },
+    "nx-release-publish": {
+      "dependsOn": ["build"],
+      "options": {
+        "packageRoot": "{projectRoot}"
+      }
+    }
+  },
+  "release": {
+    "projects": ["packages/*"],
+    "projectsRelationship": "independent",
+    "releaseTagPattern": "{projectName}@{version}",
+    "changelog": {
+      "automaticFromRef": true,
+      "workspaceChangelog": false,
+      "projectChangelogs": {
+        "file": "{projectRoot}/CHANGELOG.md",
+        "createRelease": "github"
+      }
+    },
+    "version": {
+      "conventionalCommits": true,
+      "generatorOptions": {
+        "currentVersionResolver": "registry",
+        "fallbackCurrentVersionResolver": "disk"
+      }
+    },
+    "git": {
+      "commit": true,
+      "commitMessage": "chore(release): publish {version}",
+      "tag": true
     }
   }
 }

nx.json

@@ -4,6 +4,7 @@
     "postinstall": "[ -n \"$SKIP_POSTINSTALL\" ] || (npx nx build @gesturejs/builder && SKIP_POSTINSTALL=1 pnpm rebuild)"
   },
   "devDependencies": {
+    "@nx/js": "^22.3.3",
     "@vitest/coverage-v8": "^2.0.0",
     "jsdom": "^25.0.0",
     "nx": "^22.2",

package.json

@@ -2,76 +2,51 @@
 
 **Signal** is a higher-level abstraction over events that merges and refines disparate inputs into a single, composable stream.
 
-## Why @gesturejs/signal?
-
-- **Unified Interface** - Subscribe to diverse event sources through one consistent API by normalizing them into a unified signal stream.
-- **GC Optimized** - Built-in object pooling prevents garbage collection pauses during high-frequency input (60+ events/sec)
-- **Observable-Based** - Works seamlessly with reactive patterns via `@gesturejs/stream`.
-
 ## Installation
 
 ```bash
-npm install @gesturejs/signal
+npm install --save @gesturejs/signal
 ```
 
-## Quick Start
+## Core Concepts
 
-### Single Pointer
+### Signal
 
-```typescript
-import { singlePointer } from "@gesturejs/signal";
+A `Signal` is the base interface for all normalized event data:
 
-const stream = singlePointer(canvasElement);
-const unsub = stream.subscribe((pointer) => {
-  console.log(pointer.x, pointer.y);
-  console.log(pointer.phase); // start, move, end, cancel
-});
+```typescript
+interface Signal<T extends string = string> {
+  type: T;
+  timestamp: number;
+  deviceId: string;
+}
 ```
 
-## Recipes
+### SignalPool
 
-### Use Other Events
+Built-in object pooling for Signal types to prevent garbage collection pauses during high-frequency input (60+ events/sec):
 
 ```typescript
-import { touchEventsToSinglePointer } from "@gesturejs/signal";
-import { fromEvent, merge, pipe, filter } from "@gesturejs/stream";
-
-/**
- * The `singlePointer()` factory is primarily designed for PointerEvents.
- * If you're working with TouchEvents, you can convert a TouchEvent stream via
- * `touchEventsToSinglePointer()` and keep using the same SinglePointer pipeline.
- */
-const stream = pipe(
-  merge(
-    fromEvent(el, "touchstart"),
-    fromEvent(el, "touchmove"),
-    fromEvent(el, "touchend"),
-    fromEvent(el, "touchcancel")
-  ),
-  touchEventsToSinglePointer(),
-  filter((p) => p.phase === "move")
+import { createSignalPool, type Signal } from "@gesturejs/signal";
+
+interface MySignal extends Signal<"custom"> {
+  type: "custom";
+  x: number;
+  y: number;
+}
+
+const pool = createSignalPool<MySignal>(
+  () => ({ type: "custom", timestamp: 0, deviceId: "", x: 0, y: 0 }),
+  (obj) => { obj.timestamp = 0; obj.deviceId = ""; obj.x = 0; obj.y = 0; },
+  20,   // initial size
+  100   // max size
 );
-const unsub = stream.subscribe((pointer) => {
-  draw(pointer.x, pointer.y);
-});
-```
-
-### Object Pooling
 
-```typescript
-/**
- * Pooling reduces allocations/GC pressure for high-frequency input
- * - but emitted objects are reused (mutated/reset). Don't keep references.
- * - If you need to persist data, copy the fields you need.
- */
-const spStream = singlePointer(canvasElement, { pooling: true });
+const signal = pool.acquire();
+// use signal...
+pool.release(signal);
 ```
 
-## Documentation
-
-- [API Reference](./docs/api.md)
-- [Signal Structure](./docs/signal.md)
-
 ## License
 
 MIT

packages/signal/README.md

@@ -1,7 +1,7 @@
 {
   "name": "@gesturejs/signal",
   "description": "A higher-level abstraction over events that merges and refines disparate inputs into a single, composable stream",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "author": "devphilip21 <philip21.dev@gmail.com>",
   "repository": {
@@ -35,16 +35,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
-    },
-    "./core": {
-      "types": "./dist/core/index.d.ts",
-      "import": "./dist/core/index.js",
-      "require": "./dist/core/index.cjs"
-    },
-    "./single-pointer": {
-      "types": "./dist/single-pointer/index.d.ts",
-      "import": "./dist/single-pointer/index.js",
-      "require": "./dist/single-pointer/index.cjs"
     }
   },
   "files": [
@@ -59,10 +49,10 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@gesturejs/stream": "^0.1.0"
+    "@gesturejs/stream": "workspace:^"
   },
   "devDependencies": {
-    "@gesturejs/builder": "workspace:*",
+    "@gesturejs/builder": "workspace:^",
     "@vitest/coverage-v8": "*",
     "jsdom": "*",
     "vite": "*",

packages/signal/package.json

@@ -1,5 +1,12 @@
-export * from "./core/index.js";
+export type {
+  Signal,
+  SignalWithMetadata,
+  CancellableSignal,
+  SignalPhase,
+} from "./signal.js";
+export { createSignal } from "./signal.js";
 
-export * from "./single-pointer/index.js";
+export type { SignalPool } from "./pool.js";
+export { createSignalPool } from "./pool.js";
 
-export const VERSION = "0.1.0";
+export const VERSION = "0.2.0";