@realnation/builder-shared-sdk 2.5.0 → 2.6.0

package/dist/gamepad/source.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Where device snapshots come from.
+ *
+ * The session never touches `navigator` directly: it polls a source. The live
+ * source reads the Gamepad API on animation frames; the mock source replays a
+ * script. Tests and machines without a wheel drive the same session code the
+ * hardware does, which is the point (same principle as the runtime mock: it
+ * may be stricter than the real thing, never looser).
+ */
+import type { GamepadLike } from './normalize.js';
+export interface GamepadSource {
+    /** Starts delivering snapshots. Called once when the session connects. */
+    start(onFrame: (pads: readonly GamepadLike[]) => void): void;
+    /** Stops delivering. Must be safe to call when never started. */
+    stop(): void;
+    /** One snapshot on demand, for the connect-time device probe. */
+    read(): readonly GamepadLike[];
+    /** True when this environment can report gamepads at all. */
+    readonly supported: boolean;
+}
+/**
+ * Reads the browser's Gamepad API.
+ *
+ * Polling is the only option the API offers: there are no per-frame events,
+ * and Chrome hands out a fresh snapshot object on every call. `getGamepads()`
+ * returns a sparse array whose holes are disconnected slots, hence the filter.
+ */
+export declare class LiveGamepadSource implements GamepadSource {
+    private readonly requestFrame;
+    private readonly cancelFrame;
+    private handle;
+    private onFrame;
+    readonly supported: boolean;
+    constructor(requestFrame?: (cb: () => void) => number, cancelFrame?: (handle: number) => void);
+    read(): readonly GamepadLike[];
+    start(onFrame: (pads: readonly GamepadLike[]) => void): void;
+    stop(): void;
+}
+export interface MockGamepadOptions {
+    /** The device to report. Absent means "nothing plugged in". */
+    pad?: GamepadLike | null;
+    /** Leaves frame delivery to `step()` instead of a timer. For tests. */
+    manual?: boolean;
+    /** Frame interval when not manual. */
+    intervalMs?: number;
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    clearTimer?: (handle: unknown) => void;
+}
+/**
+ * A scripted device.
+ *
+ * Mutate `pad` between frames to drive a turn or a pedal. In manual mode the
+ * caller decides when a frame happens, so a test can assert on exactly the
+ * sequence it wrote rather than on whatever a timer produced.
+ */
+export declare class MockGamepadSource implements GamepadSource {
+    readonly supported = true;
+    private onFrame;
+    private timer;
+    private readonly setTimer;
+    private readonly clearTimer;
+    private readonly intervalMs;
+    private readonly manual;
+    pad: GamepadLike | null;
+    constructor(options?: MockGamepadOptions);
+    read(): readonly GamepadLike[];
+    start(onFrame: (pads: readonly GamepadLike[]) => void): void;
+    stop(): void;
+    /** Delivers one frame. The only way frames happen in manual mode. */
+    step(): void;
+}
+/** Builds a mock device with every axis at rest and every button up. */
+export declare function mockPad(id: string, axisCount: number, buttonCount: number, overrides?: {
+    axes?: number[];
+    buttons?: number[];
+    index?: number;
+}): GamepadLike;
+//# sourceMappingURL=source.d.ts.map

package/dist/gamepad/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/gamepad/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7D,iEAAiE;IACjE,IAAI,IAAI,IAAI,CAAC;IACb,iEAAiE;IACjE,IAAI,IAAI,SAAS,WAAW,EAAE,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAOnD,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAyD;IAExE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAGT,YAAY,GAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAA0C,EAC5E,WAAW,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAqC;IAKzF,IAAI,IAAI,SAAS,WAAW,EAAE;IAO9B,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,KAAK,IAAI,GAAG,IAAI;IAU5D,IAAI,IAAI,IAAI;CAKb;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,SAAS,QAAQ;IAE1B,OAAO,CAAC,OAAO,CAAyD;IACxE,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;gBAEZ,OAAO,GAAE,kBAAuB;IAQ5C,IAAI,IAAI,SAAS,WAAW,EAAE;IAI9B,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,KAAK,IAAI,GAAG,IAAI;IAM5D,IAAI,IAAI,IAAI;IAMZ,qEAAqE;IACrE,IAAI,IAAI,IAAI;CAGb;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACtE,WAAW,CAOb"}

package/dist/gamepad/source.js

@@ -0,0 +1,92 @@
+/**
+ * Reads the browser's Gamepad API.
+ *
+ * Polling is the only option the API offers: there are no per-frame events,
+ * and Chrome hands out a fresh snapshot object on every call. `getGamepads()`
+ * returns a sparse array whose holes are disconnected slots, hence the filter.
+ */
+export class LiveGamepadSource {
+    requestFrame;
+    cancelFrame;
+    handle = null;
+    onFrame = null;
+    supported;
+    constructor(requestFrame = (cb) => requestAnimationFrame(cb), cancelFrame = (h) => cancelAnimationFrame(h)) {
+        this.requestFrame = requestFrame;
+        this.cancelFrame = cancelFrame;
+        this.supported = typeof navigator !== 'undefined' && typeof navigator.getGamepads === 'function';
+    }
+    read() {
+        if (!this.supported)
+            return [];
+        return Array.from(navigator.getGamepads()).filter((pad) => Boolean(pad?.connected));
+    }
+    start(onFrame) {
+        this.onFrame = onFrame;
+        if (!this.supported || this.handle !== null)
+            return;
+        const tick = () => {
+            this.handle = this.requestFrame(tick);
+            this.onFrame?.(this.read());
+        };
+        this.handle = this.requestFrame(tick);
+    }
+    stop() {
+        if (this.handle !== null)
+            this.cancelFrame(this.handle);
+        this.handle = null;
+        this.onFrame = null;
+    }
+}
+/**
+ * A scripted device.
+ *
+ * Mutate `pad` between frames to drive a turn or a pedal. In manual mode the
+ * caller decides when a frame happens, so a test can assert on exactly the
+ * sequence it wrote rather than on whatever a timer produced.
+ */
+export class MockGamepadSource {
+    supported = true;
+    onFrame = null;
+    timer = null;
+    setTimer;
+    clearTimer;
+    intervalMs;
+    manual;
+    pad;
+    constructor(options = {}) {
+        this.pad = options.pad ?? null;
+        this.manual = options.manual ?? false;
+        this.intervalMs = options.intervalMs ?? 16;
+        this.setTimer = options.setTimer ?? ((fn, ms) => setInterval(fn, ms));
+        this.clearTimer = options.clearTimer ?? ((h) => clearInterval(h));
+    }
+    read() {
+        return this.pad?.connected ? [this.pad] : [];
+    }
+    start(onFrame) {
+        this.onFrame = onFrame;
+        if (this.manual || this.timer !== null)
+            return;
+        this.timer = this.setTimer(() => this.step(), this.intervalMs);
+    }
+    stop() {
+        if (this.timer !== null)
+            this.clearTimer(this.timer);
+        this.timer = null;
+        this.onFrame = null;
+    }
+    /** Delivers one frame. The only way frames happen in manual mode. */
+    step() {
+        this.onFrame?.(this.read());
+    }
+}
+/** Builds a mock device with every axis at rest and every button up. */
+export function mockPad(id, axisCount, buttonCount, overrides = {}) {
+    const axes = Array.from({ length: axisCount }, (_, i) => overrides.axes?.[i] ?? 0);
+    const buttons = Array.from({ length: buttonCount }, (_, i) => {
+        const value = overrides.buttons?.[i] ?? 0;
+        return { value, pressed: value > 0.5 };
+    });
+    return { id, index: overrides.index ?? 0, connected: true, mapping: '', axes, buttons };
+}

package/dist/souvenir/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/souvenir/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AA6CpB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO5F;AAyPD,gFAAgF;AAChF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAAC,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBhE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,CAEpF;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAStH;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,CAY/E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAc5F;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAQnH;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,MAAM,GAAE,cAAmB,EAC3B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA2E5B"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/souvenir/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AA6CpB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO5F;AAyPD,gFAAgF;AAChF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAAC,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBhE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,CAEpF;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAStH;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,CAa/E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAc5F;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAQnH;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,MAAM,GAAE,cAAmB,EAC3B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA2E5B"}

package/dist/souvenir/render.js

@@ -306,8 +306,9 @@ export function drawOrder(page, region) {
         .filter((eid) => !isHidden(page.properties?.[eid] ?? {}))
         // Controls stay on screen over the picture, so they are not in it
         .filter((eid) => !isSouvenirInteractive(page.elements[eid]?.type, page.properties?.[eid] ?? {}))
-        // 框外的元件是页面的一部分，不进图
-        .filter((eid) => !box || isInsideRegion(page.properties?.[eid] ?? {}, box))
+        // 框外的元件是页面的一部分，不进图。背景是整页的底，框在哪一块都画在它上面，
+        // 所以不按中心点判（背景的中心是画布中心，框摆到一边就会把底丢掉，出图透明一片）
+        .filter((eid) => !box || page.elements[eid]?.type === 'bg' || isInsideRegion(page.properties?.[eid] ?? {}, box))
         .map((eid, index) => ({ eid, index, z: num((page.properties?.[eid] ?? {})['zIndex']) }))
         .sort((a, b) => (a.z === b.z ? a.index - b.index : a.z - b.z))
         .map((entry) => entry.eid);

package/package.json

@@ -1,64 +1,68 @@
-{
-  "name": "@realnation/builder-shared-sdk",
-  "version": "2.5.0",
-  "type": "module",
-  "private": false,
-  "exports": {
-    "./package.json": "./package.json",
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./runtime": {
-      "types": "./dist/runtime/index.d.ts",
-      "import": "./dist/runtime/index.js"
-    },
-    "./runtime/vue": {
-      "types": "./dist/runtime/vue/index.d.ts",
-      "import": "./dist/runtime/vue/index.js"
-    },
-    "./interaction": {
-      "types": "./dist/interaction/index.d.ts",
-      "import": "./dist/interaction/index.js"
-    },
-    "./interaction/vue": {
-      "types": "./dist/interaction/vue.d.ts",
-      "import": "./dist/interaction/vue.js"
-    },
-    "./souvenir": {
-      "types": "./dist/souvenir/index.d.ts",
-      "import": "./dist/souvenir/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "clean": "rimraf dist",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run clean && npm run test && npm run build",
-    "prepare": "npm run clean && npm run build"
-  },
-  "dependencies": {
-    "ali-oss": "^6.23.0",
-    "axios": "^1.7.7"
-  },
-  "peerDependencies": {
-    "vue": "^3.4.0"
-  },
-  "peerDependenciesMeta": {
-    "vue": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/ali-oss": "^6.16.11",
-    "@types/node": "^26.1.2",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.4.5",
-    "vitest": "^2.1.0",
-    "vue": "^3.4.0"
-  }
-}
+{
+  "name": "@realnation/builder-shared-sdk",
+  "version": "2.6.0",
+  "type": "module",
+  "private": false,
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./runtime/vue": {
+      "types": "./dist/runtime/vue/index.d.ts",
+      "import": "./dist/runtime/vue/index.js"
+    },
+    "./interaction": {
+      "types": "./dist/interaction/index.d.ts",
+      "import": "./dist/interaction/index.js"
+    },
+    "./interaction/vue": {
+      "types": "./dist/interaction/vue.d.ts",
+      "import": "./dist/interaction/vue.js"
+    },
+    "./souvenir": {
+      "types": "./dist/souvenir/index.d.ts",
+      "import": "./dist/souvenir/index.js"
+    },
+    "./gamepad": {
+      "types": "./dist/gamepad/index.d.ts",
+      "import": "./dist/gamepad/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run clean && npm run test && npm run build",
+    "prepare": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "ali-oss": "^6.23.0",
+    "axios": "^1.7.7"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/ali-oss": "^6.16.11",
+    "@types/node": "^26.1.2",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.4.5",
+    "vitest": "^2.1.0",
+    "vue": "^3.4.0"
+  }
+}