@simpludify/web 0.1.5 → 0.1.6

package/README.md

@@ -1,11 +1,11 @@
 # @simpludify/web
 
-Experimental v0.1.5 browser SDK for Simpludify, a code-first TypeScript 2D engine. APIs may change between 0.x releases. Includes Game, PixiJS rendering, browser input and Canvas/DOM UI adapters; re-exports the host-independent Core API. Core and PixiJS are installed as runtime dependencies, not bundled into this package.
+Experimental v0.1.6 browser SDK for Simpludify, a code-first TypeScript 2D engine. APIs may change between 0.x releases. Includes Game, PixiJS rendering, browser input and Canvas/DOM UI adapters; re-exports the host-independent Core API. Core and PixiJS are installed as runtime dependencies, not bundled into this package.
 
-Registry installation (check availability with `npm view @simpludify/web@0.1.5 version`):
+Registry installation (check availability with `npm view @simpludify/web@0.1.6 version`):
 
 ```sh
-npm install @simpludify/web@0.1.5
+npm install @simpludify/web@0.1.6
 npm install --save-dev vite typescript
 ```
 

package/dist/game.d.ts

@@ -1,5 +1,5 @@
 import type { CanvasNode } from "@simpludify/core";
-import { type ActionBindings, ActionController, type ActionSet, type Actor, Aspect, Camera, CanvasUI, type CanvasUIOptions, Engine, type FixedStepOptions, type FrameDriver, type JsonValue, type LogicalResolution, type RendererPort, type ReplayControllers, ReplayPlayer, Scene, ScenePointer, type ScreenPoint, type TweenScheduler, type Viewport, type ViewTransform, VirtualInput, type WorldPoint } from "@simpludify/core";
+import { type ActionBindings, ActionController, type ActionSet, type Actor, Aspect, Camera, CanvasUI, type CanvasUIOptions, Engine, type FixedStepOptions, type FrameDriver, type InputCapture, type InputCaptureOptions, type JsonValue, type LogicalResolution, type RendererPort, type ReplayControllers, ReplayPlayer, Scene, ScenePointer, type ScreenPoint, type TweenScheduler, type Viewport, type ViewTransform, VirtualInput, type WorldPoint } from "@simpludify/core";
 import { GamepadInput } from "./gamepads.js";
 import { Theme, type ThemeTokens, type UINode } from "./ui.js";
 export interface SceneContext {
@@ -42,6 +42,8 @@ export declare class Game<SceneId extends string = string> {
     readonly gamepads: GamepadInput;
     private readonly renderer;
     private readonly keyboard;
+    private readonly captures;
+    captureInput(options?: InputCaptureOptions): InputCapture;
     private readonly pointers;
     private readonly pointerChannels;
     private readonly virtualInputs;

package/dist/gamepad-bindings.d.ts

@@ -1,100 +1,2 @@
-import { type ActionKind, type ActionSet, type ActionToken } from "@simpludify/core";
-/** Standard mapping physical positions, not product-specific printed labels. */
-export declare const GamepadButton: Readonly<{
-    South: 0;
-    East: 1;
-    West: 2;
-    North: 3;
-    LeftShoulder: 4;
-    RightShoulder: 5;
-    LeftTrigger: 6;
-    RightTrigger: 7;
-    Select: 8;
-    Start: 9;
-    LeftStick: 10;
-    RightStick: 11;
-    DPadUp: 12;
-    DPadDown: 13;
-    DPadLeft: 14;
-    DPadRight: 15;
-    Home: 16;
-}>;
-export type GamepadButton = (typeof GamepadButton)[keyof typeof GamepadButton];
-export declare const GamepadAxis: Readonly<{
-    LeftX: 0;
-    LeftY: 1;
-    RightX: 2;
-    RightY: 3;
-}>;
-export type GamepadAxis = (typeof GamepadAxis)[keyof typeof GamepadAxis];
-export interface GamepadButtonBinding {
-    readonly buttons?: readonly (number | {
-        readonly button: number;
-        readonly threshold?: number;
-    })[];
-}
-export interface GamepadAxisBinding {
-    readonly axis?: number;
-    readonly invert?: boolean;
-    readonly negative?: readonly number[];
-    readonly positive?: readonly number[];
-    readonly deadZone?: number;
-}
-export interface GamepadVectorBinding {
-    readonly x?: GamepadAxisBinding;
-    readonly y?: GamepadAxisBinding;
-}
-export interface GamepadVector3Binding extends GamepadVectorBinding {
-    readonly z?: GamepadAxisBinding;
-}
-export type GamepadBinding<K extends ActionKind> = K extends "button" ? GamepadButtonBinding : K extends "axis1d" ? GamepadAxisBinding : K extends "axis2d" ? GamepadVectorBinding : GamepadVector3Binding;
-export type GamepadBindings<A extends ActionSet> = {
-    readonly [N in keyof A]?: GamepadBinding<A[N]["kind"]>;
-};
-/** Ready-to-use data; game Actions retain application-defined names. */
-export declare const GamepadBindings: Readonly<{
-    LeftStick: Readonly<{
-        x: Readonly<{
-            axis: number;
-        }>;
-        y: Readonly<{
-            axis: number;
-        }>;
-    }>;
-    RightStick: Readonly<{
-        x: Readonly<{
-            axis: number;
-        }>;
-        y: Readonly<{
-            axis: number;
-        }>;
-    }>;
-    DPad: Readonly<{
-        x: Readonly<{
-            negative: readonly number[];
-            positive: readonly number[];
-        }>;
-        y: Readonly<{
-            negative: readonly number[];
-            positive: readonly number[];
-        }>;
-    }>;
-    Move: Readonly<{
-        x: Readonly<{
-            axis: 0;
-            negative: readonly number[];
-            positive: readonly number[];
-        }>;
-        y: Readonly<{
-            axis: 1;
-            negative: readonly number[];
-            positive: readonly number[];
-        }>;
-    }>;
-}>;
-type Binding = GamepadButtonBinding | GamepadAxisBinding | GamepadVector3Binding;
-export type CheckedGamepadBinding = readonly [ActionToken, Binding];
-export declare function gamepadIndex(value: unknown): number;
-export declare function gamepadDeadZone(value: unknown): number;
-export declare function checkedGamepadBindings(actions: ActionSet, value: unknown): readonly CheckedGamepadBinding[];
-export {};
+export type { CheckedGamepadBinding, GamepadAxisBinding, GamepadBinding, GamepadButtonBinding, GamepadVector3Binding, GamepadVectorBinding, } from "@simpludify/core";
+export { checkedGamepadBindings, GamepadAxis, GamepadBindings, GamepadButton, gamepadDeadZone, gamepadIndex, } from "@simpludify/core";

package/dist/gamepads.d.ts

@@ -16,7 +16,8 @@ export interface GamepadState {
 export type GamepadPoll = () => readonly (GamepadState | null)[];
 export interface GamepadOptions<A extends ActionSet> {
     readonly index: number;
-    readonly bindings: GamepadBindings<A>;
+    /** Omit to follow ActionController's common gamepad settings. */
+    readonly bindings?: GamepadBindings<A>;
     readonly deadZone?: number;
     /** Positional constants require standard mapping; raw is an explicit opt-in. */
     readonly mapping?: "standard" | "raw";
@@ -33,6 +34,9 @@ export declare class GamepadSource<A extends ActionSet> {
     private signature;
     private readonly zone;
     private readonly mapping;
+    private following;
+    private bindingRevision;
+    private readonly waiting;
     constructor(input: GamepadInput, controller: ActionController<A>, options: GamepadOptions<A>);
     get disposed(): boolean;
     get enabled(): boolean;
@@ -42,7 +46,9 @@ export declare class GamepadSource<A extends ActionSet> {
     get connected(): boolean;
     get usable(): boolean;
     assign(index: number): void;
-    rebind(bindings: GamepadBindings<A>): void;
+    rebind(bindings?: GamepadBindings<A>): void;
+    private commonBindings;
+    private syncBindings;
     clear(): void;
     private alive;
     /** @internal */ sample(pad: GamepadState | undefined, allowed: boolean): void;
@@ -60,10 +66,13 @@ export declare class GamepadInput implements InputAdapter {
     private readable;
     private readonly poll;
     private readonly active;
+    private readonly observe;
     constructor(input: InputSystem, options?: {
         readonly poll?: GamepadPoll;
         readonly active?: () => boolean;
         readonly events?: EventTarget;
+        /** @internal Host capture observes the same poll before any device contribution. */
+        readonly observe?: (pads: ReadonlyMap<number, GamepadState>) => void;
     });
     get disposed(): boolean;
     /** Whether the most recent polling attempt completed; an empty list may still need a user gesture. */