@forgeax/engine-input 0.0.0-dev.8d955ade1c79

package/dist/controller-db.d.ts

@@ -0,0 +1,70 @@
+/** A single mapping token target: physical button / axis / hat index. */
+export type MappingToken = {
+    readonly kind: 'button';
+    readonly index: number;
+} | {
+    readonly kind: 'axis';
+    readonly index: number;
+    readonly half?: '+' | '-';
+} | {
+    readonly kind: 'hat';
+    readonly index: number;
+    readonly mask: number;
+};
+/**
+ * Parsed mapping tokens for one controller entry, keyed by the SDL logical
+ * name (`a`, `b`, `leftx`, `dpup`, `lefttrigger`, ...). Values are the
+ * physical source (button `bN`, axis `aN`, hat `hN.M`).
+ */
+export type MappingTokens = Readonly<Record<string, MappingToken>>;
+/** One controller-DB row: its platform section + parsed mapping tokens. */
+export interface ControllerDbEntry {
+    readonly platform: string | undefined;
+    readonly tokens: MappingTokens;
+}
+/**
+ * Parsed controller DB: SDL GUID (32-char hex) -> one entry per platform
+ * section. The same GUID can appear in multiple platform sections, so the
+ * value is an array.
+ */
+export type ControllerDb = Readonly<Record<string, readonly ControllerDbEntry[]>>;
+/** Recognised web platform section labels (D-13). */
+declare const CONTROLLER_PLATFORMS: readonly ["Windows", "Mac OS X", "Linux", "Android", "iOS"];
+export type ControllerPlatform = (typeof CONTROLLER_PLATFORMS)[number];
+/**
+ * Parse a gamecontrollerdb.txt string into a ControllerDb map. Comment
+ * (`#`) and blank lines are skipped. Each data line is
+ * `GUID,Name,token:source,...,platform:PLATFORM,`.
+ */
+export declare function parseControllerDb(txt: string): ControllerDb;
+/**
+ * Build a 32-char SDL GUID hex from a VID/PID pair (D-13 strategy 2):
+ * bus (default USB 0x03) + CRC=0 + VID + fill + PID + fill + version=0 +
+ * driver sig/data=0. Each 16-bit field is little-endian within the string.
+ *
+ * Example: buildGuidFromVidPid(0x045e, 0x028e) ->
+ * '030000005e0400008e02000000000000' (Xbox 360).
+ */
+export declare function buildGuidFromVidPid(vid: number, pid: number, bus?: number): string;
+/**
+ * Extract an SDL GUID from a browser `Gamepad.id` string. Handles the
+ * Chrome/Edge (`Vendor: XXXX Product: YYYY`) and Firefox (`VID-PID-Name`,
+ * leading-zero tolerant) formats. Returns undefined when VID/PID cannot be
+ * extracted (Safari name-only strings, XInput devices) so the caller keeps
+ * the Feat1 empty-signal (graceful degradation, R-3).
+ */
+export declare function extractGuidFromGamepadId(id: string): string | undefined;
+/**
+ * Map a `navigator.userAgent` string to a gamecontrollerdb.txt platform
+ * section label (D-13). Returns undefined when the UA is unrecognised, in
+ * which case the caller falls back to any-platform entry selection.
+ */
+export declare function platformFromUserAgent(ua: string): ControllerPlatform | undefined;
+/**
+ * Select the best mapping entry for a GUID: prefer the entry whose platform
+ * section matches `platform`, else fall back to the first available entry
+ * (any platform). Returns undefined when the GUID is absent from the DB.
+ */
+export declare function selectBestMappingEntry(db: ControllerDb, guid: string, platform: string | undefined): ControllerDbEntry | undefined;
+export {};
+//# sourceMappingURL=controller-db.d.ts.map

package/dist/controller-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-db.d.ts","sourceRoot":"","sources":["../src/controller-db.ts"],"names":[],"mappings":"AAeA,yEAAyE;AACzE,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AAEnE,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC,CAAC,CAAC;AAElF,qDAAqD;AACrD,QAAA,MAAM,oBAAoB,6DAA8D,CAAC;AACzF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAgCvE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAmC3D;AASD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,MAAM,CAWhF;AAKD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA2BvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAShF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,iBAAiB,GAAG,SAAS,CAQ/B"}

package/dist/controller-db.mjs

@@ -0,0 +1,119 @@
+// src/controller-db.ts
+var CONTROLLER_PLATFORMS = ["Windows", "Mac OS X", "Linux", "Android", "iOS"];
+function parseMappingToken(source) {
+  let half;
+  let body = source;
+  if (body.startsWith("+") || body.startsWith("-")) {
+    half = body[0];
+    body = body.slice(1);
+  }
+  const prefix = body[0];
+  if (prefix === "b") {
+    const index = Number.parseInt(body.slice(1), 10);
+    return Number.isNaN(index) ? void 0 : { kind: "button", index };
+  }
+  if (prefix === "a") {
+    const index = Number.parseInt(body.slice(1), 10);
+    if (Number.isNaN(index)) return void 0;
+    return half ? { kind: "axis", index, half } : { kind: "axis", index };
+  }
+  if (prefix === "h") {
+    const dot = body.indexOf(".");
+    if (dot < 0) return void 0;
+    const index = Number.parseInt(body.slice(1, dot), 10);
+    const mask = Number.parseInt(body.slice(dot + 1), 10);
+    return Number.isNaN(index) || Number.isNaN(mask) ? void 0 : { kind: "hat", index, mask };
+  }
+  return void 0;
+}
+function parseControllerDb(txt) {
+  const db = {};
+  for (const rawLine of txt.split("\n")) {
+    const line = rawLine.trim();
+    if (line.length === 0 || line.startsWith("#")) continue;
+    const fields = line.split(",");
+    const guid = fields[0];
+    if (!guid || guid.length !== 32) continue;
+    let platform;
+    const tokens = {};
+    for (let i = 2; i < fields.length; i++) {
+      const field = fields[i];
+      if (!field) continue;
+      const colon = field.indexOf(":");
+      if (colon < 0) continue;
+      const key = field.slice(0, colon);
+      const source = field.slice(colon + 1);
+      if (key === "platform") {
+        platform = source;
+        continue;
+      }
+      const token = parseMappingToken(source);
+      if (token) tokens[key] = token;
+    }
+    const entry = { platform, tokens };
+    const bucket = db[guid];
+    if (bucket) {
+      bucket.push(entry);
+    } else {
+      db[guid] = [entry];
+    }
+  }
+  return db;
+}
+function le16Hex(value) {
+  const lo = value & 255;
+  const hi = value >> 8 & 255;
+  return lo.toString(16).padStart(2, "0") + hi.toString(16).padStart(2, "0");
+}
+function buildGuidFromVidPid(vid, pid, bus = 3) {
+  return le16Hex(bus) + // bytes 0-1: bus type
+  "0000" + // bytes 2-3: CRC = 0
+  le16Hex(vid) + // bytes 4-5: VID (LE)
+  "0000" + // bytes 6-7: fill
+  le16Hex(pid) + // bytes 8-9: PID (LE)
+  "000000000000";
+}
+var CHROME_VENDOR_RE = /Vendor:\s*([0-9a-f]{1,4})/i;
+var CHROME_PRODUCT_RE = /Product:\s*([0-9a-f]{1,4})/i;
+function extractGuidFromGamepadId(id) {
+  if (id.toLowerCase().includes("xinput")) return void 0;
+  const vendorMatch = id.match(CHROME_VENDOR_RE);
+  const productMatch = id.match(CHROME_PRODUCT_RE);
+  if (vendorMatch?.[1] && productMatch?.[1]) {
+    const vid = Number.parseInt(vendorMatch[1], 16);
+    const pid = Number.parseInt(productMatch[1], 16);
+    if (!Number.isNaN(vid) && !Number.isNaN(pid)) return buildGuidFromVidPid(vid, pid);
+  }
+  const parts = id.split("-");
+  if (parts.length >= 3 && parts[0] && parts[1]) {
+    const vidHex = parts[0];
+    const pidHex = parts[1];
+    if (/^[0-9a-f]{1,4}$/i.test(vidHex) && /^[0-9a-f]{1,4}$/i.test(pidHex)) {
+      const vid = Number.parseInt(vidHex, 16);
+      const pid = Number.parseInt(pidHex, 16);
+      if (!Number.isNaN(vid) && !Number.isNaN(pid)) return buildGuidFromVidPid(vid, pid);
+    }
+  }
+  return void 0;
+}
+function platformFromUserAgent(ua) {
+  if (/iPhone|iPad|iPod/.test(ua)) return CONTROLLER_PLATFORMS[4];
+  if (/Android/.test(ua)) return CONTROLLER_PLATFORMS[3];
+  if (/Windows/.test(ua)) return CONTROLLER_PLATFORMS[0];
+  if (/Mac OS X|Macintosh/.test(ua)) return CONTROLLER_PLATFORMS[1];
+  if (/Linux/.test(ua)) return CONTROLLER_PLATFORMS[2];
+  return void 0;
+}
+function selectBestMappingEntry(db, guid, platform) {
+  const entries = db[guid];
+  if (!entries || entries.length === 0) return void 0;
+  if (platform) {
+    const match = entries.find((e) => e.platform === platform);
+    if (match) return match;
+  }
+  return entries[0];
+}
+
+export { buildGuidFromVidPid, extractGuidFromGamepadId, parseControllerDb, platformFromUserAgent, selectBestMappingEntry };
+//# sourceMappingURL=controller-db.mjs.map
+//# sourceMappingURL=controller-db.mjs.map

package/dist/controller-db.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/controller-db.ts"],"names":[],"mappings":"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","file":"controller-db.mjs","sourcesContent":["// controller-db.ts -- pure SDL_GameControllerDB parsing + GUID derivation.\n//\n// This module holds ONLY pure functions (no DOM, no ECS, no vendored data\n// import). The 554KB gamecontrollerdb.txt lives in the separate\n// `./controller-db-data` sub-export so it never enters the main-entry\n// bundle; the backend dynamic-imports both this module and the data module\n// on first sight of a non-standard gamepad (D-2 lazy-load).\n//\n// SDL GUID reference: KB source\n// .forgeax-harness/knowledge-base/sources/2026-07-07-sdl-guid-browser-gamepad-id-mapping.md\n//\n// D-13 strategy 2: build a match GUID from VID/PID with bus=USB(0x03),\n// CRC=0, version=0, driver signature/data=0. This matches the vast\n// majority of gamecontrollerdb.txt native entries directly.\n\n/** A single mapping token target: physical button / axis / hat index. */\nexport type MappingToken =\n  | { readonly kind: 'button'; readonly index: number }\n  | { readonly kind: 'axis'; readonly index: number; readonly half?: '+' | '-' }\n  | { readonly kind: 'hat'; readonly index: number; readonly mask: number };\n\n/**\n * Parsed mapping tokens for one controller entry, keyed by the SDL logical\n * name (`a`, `b`, `leftx`, `dpup`, `lefttrigger`, ...). Values are the\n * physical source (button `bN`, axis `aN`, hat `hN.M`).\n */\nexport type MappingTokens = Readonly<Record<string, MappingToken>>;\n\n/** One controller-DB row: its platform section + parsed mapping tokens. */\nexport interface ControllerDbEntry {\n  readonly platform: string | undefined;\n  readonly tokens: MappingTokens;\n}\n\n/**\n * Parsed controller DB: SDL GUID (32-char hex) -> one entry per platform\n * section. The same GUID can appear in multiple platform sections, so the\n * value is an array.\n */\nexport type ControllerDb = Readonly<Record<string, readonly ControllerDbEntry[]>>;\n\n/** Recognised web platform section labels (D-13). */\nconst CONTROLLER_PLATFORMS = ['Windows', 'Mac OS X', 'Linux', 'Android', 'iOS'] as const;\nexport type ControllerPlatform = (typeof CONTROLLER_PLATFORMS)[number];\n\n/** Parse one `key:source` mapping token into a MappingToken. */\nfunction parseMappingToken(source: string): MappingToken | undefined {\n  // Half-axis prefix: +aN / -aN.\n  let half: '+' | '-' | undefined;\n  let body = source;\n  if (body.startsWith('+') || body.startsWith('-')) {\n    half = body[0] as '+' | '-';\n    body = body.slice(1);\n  }\n  const prefix = body[0];\n  if (prefix === 'b') {\n    const index = Number.parseInt(body.slice(1), 10);\n    return Number.isNaN(index) ? undefined : { kind: 'button', index };\n  }\n  if (prefix === 'a') {\n    const index = Number.parseInt(body.slice(1), 10);\n    if (Number.isNaN(index)) return undefined;\n    return half ? { kind: 'axis', index, half } : { kind: 'axis', index };\n  }\n  if (prefix === 'h') {\n    // hN.M -- hat N, direction mask M.\n    const dot = body.indexOf('.');\n    if (dot < 0) return undefined;\n    const index = Number.parseInt(body.slice(1, dot), 10);\n    const mask = Number.parseInt(body.slice(dot + 1), 10);\n    return Number.isNaN(index) || Number.isNaN(mask) ? undefined : { kind: 'hat', index, mask };\n  }\n  return undefined;\n}\n\n/**\n * Parse a gamecontrollerdb.txt string into a ControllerDb map. Comment\n * (`#`) and blank lines are skipped. Each data line is\n * `GUID,Name,token:source,...,platform:PLATFORM,`.\n */\nexport function parseControllerDb(txt: string): ControllerDb {\n  const db: Record<string, ControllerDbEntry[]> = {};\n  for (const rawLine of txt.split('\\n')) {\n    const line = rawLine.trim();\n    if (line.length === 0 || line.startsWith('#')) continue;\n    const fields = line.split(',');\n    const guid = fields[0];\n    if (!guid || guid.length !== 32) continue;\n    let platform: string | undefined;\n    const tokens: Record<string, MappingToken> = {};\n    // fields[1] is the human-readable name; mapping tokens start at index 2.\n    for (let i = 2; i < fields.length; i++) {\n      const field = fields[i];\n      if (!field) continue;\n      const colon = field.indexOf(':');\n      if (colon < 0) continue;\n      const key = field.slice(0, colon);\n      const source = field.slice(colon + 1);\n      if (key === 'platform') {\n        platform = source;\n        continue;\n      }\n      // crc / sdk / hint fields are not physical mappings; skip non b/a/h.\n      const token = parseMappingToken(source);\n      if (token) tokens[key] = token;\n    }\n    const entry: ControllerDbEntry = { platform, tokens };\n    const bucket = db[guid];\n    if (bucket) {\n      bucket.push(entry);\n    } else {\n      db[guid] = [entry];\n    }\n  }\n  return db;\n}\n\n/** Format a 16-bit value as a 4-char little-endian hex pair. */\nfunction le16Hex(value: number): string {\n  const lo = value & 0xff;\n  const hi = (value >> 8) & 0xff;\n  return lo.toString(16).padStart(2, '0') + hi.toString(16).padStart(2, '0');\n}\n\n/**\n * Build a 32-char SDL GUID hex from a VID/PID pair (D-13 strategy 2):\n * bus (default USB 0x03) + CRC=0 + VID + fill + PID + fill + version=0 +\n * driver sig/data=0. Each 16-bit field is little-endian within the string.\n *\n * Example: buildGuidFromVidPid(0x045e, 0x028e) ->\n * '030000005e0400008e02000000000000' (Xbox 360).\n */\nexport function buildGuidFromVidPid(vid: number, pid: number, bus = 0x03): string {\n  return (\n    le16Hex(bus) + // bytes 0-1: bus type\n    '0000' + // bytes 2-3: CRC = 0\n    le16Hex(vid) + // bytes 4-5: VID (LE)\n    '0000' + // bytes 6-7: fill\n    le16Hex(pid) + // bytes 8-9: PID (LE)\n    '0000' + // bytes 10-11: fill\n    '0000' + // bytes 12-13: version = 0\n    '0000' // bytes 14-15: driver signature + data = 0\n  );\n}\n\nconst CHROME_VENDOR_RE = /Vendor:\\s*([0-9a-f]{1,4})/i;\nconst CHROME_PRODUCT_RE = /Product:\\s*([0-9a-f]{1,4})/i;\n\n/**\n * Extract an SDL GUID from a browser `Gamepad.id` string. Handles the\n * Chrome/Edge (`Vendor: XXXX Product: YYYY`) and Firefox (`VID-PID-Name`,\n * leading-zero tolerant) formats. Returns undefined when VID/PID cannot be\n * extracted (Safari name-only strings, XInput devices) so the caller keeps\n * the Feat1 empty-signal (graceful degradation, R-3).\n */\nexport function extractGuidFromGamepadId(id: string): string | undefined {\n  // XInput devices expose no VID/PID in either Chrome or Firefox.\n  if (id.toLowerCase().includes('xinput')) return undefined;\n\n  // Chrome / Edge: \"... (STANDARD GAMEPAD Vendor: 054c Product: 09cc)\".\n  const vendorMatch = id.match(CHROME_VENDOR_RE);\n  const productMatch = id.match(CHROME_PRODUCT_RE);\n  if (vendorMatch?.[1] && productMatch?.[1]) {\n    const vid = Number.parseInt(vendorMatch[1], 16);\n    const pid = Number.parseInt(productMatch[1], 16);\n    if (!Number.isNaN(vid) && !Number.isNaN(pid)) return buildGuidFromVidPid(vid, pid);\n  }\n\n  // Firefox: \"046d-c216-Logitech Dual Action\" (VID-PID-Name). The first two\n  // dash segments must be pure hex; a name-only Safari string fails this.\n  const parts = id.split('-');\n  if (parts.length >= 3 && parts[0] && parts[1]) {\n    const vidHex = parts[0];\n    const pidHex = parts[1];\n    if (/^[0-9a-f]{1,4}$/i.test(vidHex) && /^[0-9a-f]{1,4}$/i.test(pidHex)) {\n      const vid = Number.parseInt(vidHex, 16);\n      const pid = Number.parseInt(pidHex, 16);\n      if (!Number.isNaN(vid) && !Number.isNaN(pid)) return buildGuidFromVidPid(vid, pid);\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Map a `navigator.userAgent` string to a gamecontrollerdb.txt platform\n * section label (D-13). Returns undefined when the UA is unrecognised, in\n * which case the caller falls back to any-platform entry selection.\n */\nexport function platformFromUserAgent(ua: string): ControllerPlatform | undefined {\n  // Order matters: iOS + Android both contain substrings that overlap with\n  // the desktop checks, so test the mobile/specific cases first.\n  if (/iPhone|iPad|iPod/.test(ua)) return CONTROLLER_PLATFORMS[4];\n  if (/Android/.test(ua)) return CONTROLLER_PLATFORMS[3];\n  if (/Windows/.test(ua)) return CONTROLLER_PLATFORMS[0];\n  if (/Mac OS X|Macintosh/.test(ua)) return CONTROLLER_PLATFORMS[1];\n  if (/Linux/.test(ua)) return CONTROLLER_PLATFORMS[2];\n  return undefined;\n}\n\n/**\n * Select the best mapping entry for a GUID: prefer the entry whose platform\n * section matches `platform`, else fall back to the first available entry\n * (any platform). Returns undefined when the GUID is absent from the DB.\n */\nexport function selectBestMappingEntry(\n  db: ControllerDb,\n  guid: string,\n  platform: string | undefined,\n): ControllerDbEntry | undefined {\n  const entries = db[guid];\n  if (!entries || entries.length === 0) return undefined;\n  if (platform) {\n    const match = entries.find((e) => e.platform === platform);\n    if (match) return match;\n  }\n  return entries[0];\n}\n"]}

package/dist/frame-start-scan-system.d.ts

@@ -0,0 +1,37 @@
+import { type SystemHandle } from '@forgeax/engine-ecs';
+/**
+ * Stable system name (locked by `frame-start-scan-system.test.ts`). User
+ * systems reference it through `after: [FRAME_START_SCAN_SYSTEM_NAME]`
+ * to ensure they observe the freshly written snapshot.
+ */
+export declare const FRAME_START_SCAN_SYSTEM_NAME = "input-frame-start-scan";
+export declare const InputSet: import("@forgeax/engine-ecs").SystemSet;
+/**
+ * Resource key under which the {@link InputBackend} producer is inserted
+ * (M2 — full resource-ification, D-2 / D-7). The frame-start scan system
+ * declares it in `resources`; the fn body reads it back via
+ * `world.getResource(INPUT_BACKEND_KEY)`.
+ *
+ * Aligns with the `INPUT_SNAPSHOT_RESOURCE_KEY` naming. Consumers import the
+ * constant rather than the bare string so a typo degrades to an import error
+ * (charter P3).
+ */
+export declare const INPUT_BACKEND_KEY: "InputBackend";
+/**
+ * The frame-start scan system token (M2 — full resource-ification, D-4).
+ *
+ * Module-level `defineSystem` with the real fn body — no factory, no closure.
+ * Each `world.update()` tick:
+ *   1. reads the {@link InputBackend} from `INPUT_BACKEND_KEY` and calls
+ *      `backend.sample()` to drain the per-frame accumulator (movement delta +
+ *      up-edge set);
+ *   2. derives a fresh `InputSnapshot` via `snapshotFromSample`;
+ *   3. writes it under `INPUT_SNAPSHOT_RESOURCE_KEY` via
+ *      `world.insertResource` -- idempotent overwrite, charter P4
+ *      consistent abstraction (consumers always read the same Resource key
+ *      regardless of which backend produced the sample).
+ *
+ * Labelled `'input'` (spec §6.2 label-anchor map).
+ */
+export declare const InputFrameStartScan: SystemHandle<readonly []>;
+//# sourceMappingURL=frame-start-scan-system.d.ts.map

package/dist/frame-start-scan-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-start-scan-system.d.ts","sourceRoot":"","sources":["../src/frame-start-scan-system.ts"],"names":[],"mappings":"AAWA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAevF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AACrE,eAAO,MAAM,QAAQ,yCAAqC,CAAC;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAG,cAAuB,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,SAAS,EAAE,CA8BxD,CAAC"}

package/dist/gamepad-frame.d.ts

@@ -0,0 +1,42 @@
+import type { MappingTokens } from './controller-db';
+import type { GamepadSlotSample } from './input-snapshot';
+/**
+ * Minimal raw Gamepad shape from browser API (no DOM types here).
+ *
+ * M3 F-2 seam fix: `id` mirrors the browser `Gamepad.id` string so the
+ * remap lookup can derive the SDL GUID keyed by device identity (not by
+ * slot index, which is unstable across reconnects).
+ */
+export interface RawGamepadStub {
+    readonly index: number;
+    readonly id: string;
+    readonly connected: boolean;
+    readonly mapping: string;
+    readonly buttons: readonly {
+        readonly value: number;
+        readonly pressed: boolean;
+    }[];
+    readonly axes: readonly number[];
+}
+/**
+ * Diff prev vs cur frames for all gamepad slots. Returns a flat
+ * GamepadSlotSample[] array keyed by gamepad.index.
+ *
+ * - Standard-mapping slots produce GamepadSlotSample with edge sets filled
+ *   from prev vs cur pressed-set delta.
+ * - Non-standard slots: when `remapLookup` returns mapping tokens for the
+ *   gamepad id, raw HID indices are re-projected onto the standard layout
+ *   and the slot reports standardMapping=true (D-1 semantic redefinition).
+ *   With no lookup or no match, the slot reports standardMapping=false with
+ *   empty readpoints and connected=true (Feat1 behaviour, AC-04).
+ * - Disconnected slots (in prev but not in cur) produce a slot with
+ *   standardMapping=false and all readpoints empty.
+ * - Null entries in the browser getGamepads() array are skipped by the
+ *   caller before calling this function.
+ *
+ * @param remapLookup - Optional acquisition-layer normalizer. Given a
+ *   browser Gamepad.id, returns SDL mapping tokens or null. Only consulted
+ *   for non-standard-mapping gamepads (D-1 option A).
+ */
+export declare function diffGamepadFrame(prev: ReadonlyMap<number, GamepadSlotSample>, curGamepads: readonly RawGamepadStub[], remapLookup?: (gamepadId: string) => MappingTokens | null): GamepadSlotSample[];
+//# sourceMappingURL=gamepad-frame.d.ts.map

package/dist/gamepad-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamepad-frame.d.ts","sourceRoot":"","sources":["../src/gamepad-frame.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IACnF,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAyHD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC5C,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,GACxD,iBAAiB,EAAE,CAwBrB"}

package/dist/gesture-recognizer.d.ts

@@ -0,0 +1,145 @@
+import type { PointerPhaseEvent, PointerType } from './input-snapshot';
+export declare const LONG_PRESS_DURATION_MS = 500;
+export declare const LONG_PRESS_SLOP = 10;
+export declare const DOUBLE_TAP_INTERVAL_MS = 350;
+export declare const DOUBLE_TAP_DISTANCE = 10;
+export declare const SWIPE_VELOCITY_THRESHOLD = 0.5;
+export declare const SWIPE_WINDOW_MS = 100;
+/** Swipe direction taken from the dominant displacement axis (D-10). */
+declare const SWIPE_DIRECTIONS: readonly ["left", "right", "up", "down"];
+export type SwipeDirection = (typeof SWIPE_DIRECTIONS)[number];
+/**
+ * Continuous gesture values read each frame via `snap.gesture` (D-4).
+ * Identity when no gesture is active or after a cancel/reset (AC-12):
+ * pinchScale = 1.0, rotationAngle = 0.
+ */
+export interface GestureState {
+    readonly pinchScale: number;
+    readonly rotationAngle: number;
+}
+/**
+ * Closed discriminant union of gesture lifecycle + instantaneous events
+ * (AC-13). One-frame lifecycle: an event appears in exactly one frame's
+ * `gestureEvents`. Every member carries `pointerType` (narrowed union,
+ * AC-19) so consumers can exhaustively switch on gesture kind AND device
+ * type without a default branch.
+ */
+export type GestureEvent = {
+    readonly kind: 'pinch-begin';
+    readonly pointerIds: readonly [number, number];
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'pinch-end';
+    readonly pointerIds: readonly [number, number];
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'pinch-cancel';
+    readonly pointerIds: readonly [number, number];
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'rotate-begin';
+    readonly pointerIds: readonly [number, number];
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'rotate-end';
+    readonly pointerIds: readonly [number, number];
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'rotate-cancel';
+    readonly pointerIds: readonly [number, number];
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'swipe';
+    readonly pointerId: number;
+    readonly direction: SwipeDirection;
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'long-press';
+    readonly pointerId: number;
+    readonly x: number;
+    readonly y: number;
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+} | {
+    readonly kind: 'double-tap';
+    readonly pointerId: number;
+    readonly x: number;
+    readonly y: number;
+    readonly pointerType: PointerType;
+    readonly timestamp: number;
+};
+/** Live position + device type for a pointer (subset of the backend pointerMap entry). */
+export interface RecognizerPointer {
+    readonly x: number;
+    readonly y: number;
+    readonly pointerType: PointerType;
+}
+/** Locked dual-finger tracker for pinch + rotate (D-11). */
+export interface PinchRotateTracker {
+    readonly pointerA: number;
+    readonly pointerB: number;
+    readonly initialDistance: number;
+    /** Previous frame's raw atan2 angle; rotation accumulates frame deltas (D-11). */
+    readonly lastAngle: number;
+    readonly pointerType: PointerType;
+}
+/** Per-pointer long-press arming state (D-10). */
+export interface LongPressTracker {
+    readonly downTime: number;
+    readonly x: number;
+    readonly y: number;
+    readonly pointerType: PointerType;
+    readonly armed: boolean;
+    readonly fired: boolean;
+}
+/** Timestamped position sample for swipe velocity (D-10, 100ms window). */
+export interface SwipeSample {
+    readonly t: number;
+    readonly x: number;
+    readonly y: number;
+}
+/** Last recorded tap for double-tap window matching (D-10). */
+export interface TapRecord {
+    readonly time: number;
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * The single legal cross-frame gesture state (C-3). Immutable: each
+ * `processGestureFrame` returns a fresh copy; the producer stores it for
+ * the next frame. `gesture` is the current continuous value read by
+ * `snap.gesture` -- live during pinch, frozen after a 2->1 end, identity
+ * after cancel/reset or when no gesture ever activated.
+ */
+export interface RecognizerState {
+    readonly pinch: PinchRotateTracker | null;
+    readonly gesture: GestureState;
+    readonly longPresses: ReadonlyMap<number, LongPressTracker>;
+    readonly lastTap: TapRecord | null;
+    readonly swipeHistory: ReadonlyMap<number, readonly SwipeSample[]>;
+}
+/** Result of processing one frame of phase events (D-4 dual channel). */
+export interface GestureFrameResult {
+    readonly newState: RecognizerState;
+    readonly gestureState: GestureState;
+    readonly gestureEvents: readonly GestureEvent[];
+}
+/** Identity continuous value (AC-12): no scale, no rotation. */
+export declare const IDENTITY_GESTURE: GestureState;
+/** Fresh recognizer state with no active gestures. */
+export declare function createRecognizerState(): RecognizerState;
+/**
+ * Process one frame of pointer phase events, advancing all timers off
+ * `now`, and return the new state + continuous values + one-frame event
+ * list (D-4). Never mutates its inputs.
+ */
+export declare function processGestureFrame(phaseQueue: readonly PointerPhaseEvent[], pointerMap: ReadonlyMap<number, RecognizerPointer>, prevState: RecognizerState, now: number): GestureFrameResult;
+export {};
+//# sourceMappingURL=gesture-recognizer.d.ts.map

package/dist/gesture-recognizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture-recognizer.d.ts","sourceRoot":"","sources":["../src/gesture-recognizer.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type { ActionBinding, ActionConfig, ActionState, GetVectorOptions, } from './action-state';
+export { deriveActionStates, getAxis, getVector, INPUT_MAP_KEY, } from './action-state';
+export { attachBrowserInputBackend, type BrowserInputBackendOptions, type PointerLockProvider, } from './browser-backend';
+export { type CanvasInputBoundary, createCanvasInputBoundary, } from './canvas-input-boundary';
+export { type CompositeBackendOptions, type CompositeInputBackend, makeCompositeBackend, } from './composite-backend';
+export { FRAME_START_SCAN_SYSTEM_NAME, INPUT_BACKEND_KEY, InputFrameStartScan, InputSet, } from './frame-start-scan-system';
+export type { GestureEvent, GestureState, SwipeDirection, } from './gesture-recognizer';
+export { DOUBLE_TAP_DISTANCE, DOUBLE_TAP_INTERVAL_MS, IDENTITY_GESTURE, LONG_PRESS_DURATION_MS, LONG_PRESS_SLOP, SWIPE_VELOCITY_THRESHOLD, SWIPE_WINDOW_MS, } from './gesture-recognizer';
+export type { Capabilities, GamepadAxisIndex, GamepadButtonIndex, GamepadSlotSample, InputBackend, InputBackendSample, InputSnapshot, MouseButtonIndex, PointerPhaseEvent, PointerSample, PointerType, VirtualAxisSample, VirtualJoystickConfig, } from './input-snapshot';
+export { createInputSnapshot, INPUT_SNAPSHOT_RESOURCE_KEY, snapshotFromSample, } from './input-snapshot';
+export { inputBackendPlugin, ownedInputBackendPlugin } from './plugin-service';
+export { createUiInputResetBoundary, isUiOwnedEvent, resolveUiOwnership, type UiInputResetBoundary, type UiInputResetBoundaryOptions, type UiOwnershipResult, } from './ui-ownership';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0BA,YAAY,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,SAAS,EACT,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,mBAAmB,EACxB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,GACT,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,wBAAwB,EACxB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EACL,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC"}