@yali-engine/input 0.0.0-stage → 0.4.0

package/dist/dom.d.ts

@@ -0,0 +1,19 @@
+import type { Input } from './input.ts';
+/** What `attachDom` listens on. */
+export interface DomSource {
+    /** Pointer and wheel events (the canvas). */
+    readonly target: EventTarget;
+    /** Key events and blur (default: `window` when there is one, else `target`). */
+    readonly keys?: EventTarget;
+    /** Stop the page scrolling on wheel over the target (default true). */
+    readonly preventWheel?: boolean;
+}
+/**
+ * Feeds DOM pointer, wheel and key events into `input`, and releases every key on blur so
+ * none stays stuck down. Returns the detach function and the listener count (for the
+ * dispose leak check).
+ */
+export declare function attachDom(input: Input, source: DomSource): {
+    detach(): void;
+    listeners(): number;
+};

package/dist/dom.js

@@ -0,0 +1,57 @@
+/**
+ * Feeds DOM pointer, wheel and key events into `input`, and releases every key on blur so
+ * none stays stuck down. Returns the detach function and the listener count (for the
+ * dispose leak check).
+ */
+export function attachDom(input, source) {
+    const keys = source.keys ?? (typeof window !== 'undefined' ? window : source.target);
+    const off = [];
+    const listen = (t, type, fn, opts) => {
+        const h = fn;
+        t.addEventListener(type, h, opts);
+        off.push(() => t.removeEventListener(type, h, opts));
+    };
+    // Movement: a mouse's movementX/Y (pointer lock needs it); for touch and pen, the change
+    // in position. Chrome on Android reports touch movementX in other units (a 10 CSS px move
+    // came as -4 at devicePixelRatio 2.625, rounded), so a drag turned 2.6x slower there.
+    let lastId = -1;
+    let lastX = 0;
+    let lastY = 0;
+    const pointer = (kind) => (e) => {
+        if (kind === 'pointerdown')
+            source.target.setPointerCapture?.(e.pointerId);
+        let mx = e.movementX;
+        let my = e.movementY;
+        if (e.pointerType !== 'mouse') {
+            const same = kind !== 'pointerdown' && e.pointerId === lastId;
+            mx = same ? e.offsetX - lastX : 0;
+            my = same ? e.offsetY - lastY : 0;
+            lastId = e.pointerId;
+            lastX = e.offsetX;
+            lastY = e.offsetY;
+        }
+        input.push({ kind, x: e.offsetX, y: e.offsetY, movementX: mx, movementY: my, buttons: e.buttons, pointerId: e.pointerId });
+    };
+    listen(source.target, 'pointerdown', pointer('pointerdown'));
+    listen(source.target, 'pointermove', pointer('pointermove'));
+    listen(source.target, 'pointerup', pointer('pointerup'));
+    listen(source.target, 'wheel', (e) => {
+        if (source.preventWheel ?? true)
+            e.preventDefault();
+        input.push({ kind: 'wheel', deltaX: e.deltaX, deltaY: e.deltaY });
+    }, { passive: false });
+    listen(keys, 'keydown', (e) => {
+        if (!e.repeat)
+            input.push({ kind: 'keydown', code: e.code });
+    });
+    listen(keys, 'keyup', (e) => input.push({ kind: 'keyup', code: e.code }));
+    listen(keys, 'blur', () => input.releaseAll());
+    return {
+        detach() {
+            for (const f of off.splice(0))
+                f();
+        },
+        listeners: () => off.length,
+    };
+}
+//# sourceMappingURL=dom.js.map

package/dist/dom.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@yali-engine/input`: keyboard, pointer and wheel as per-frame state, fed by the DOM or by
+ * forwarded events (worker render mode), with frame-exact recording and replay for the
+ * headless deterministic mode (DESIGN.md §19, ADR-0040).
+ *
+ * @example
+ * import { inputPlugin, type Input } from '@yali-engine/input';
+ * const app = App.create({ core, plugins: [inputPlugin({ dom: { target: canvas } })] });
+ * const input = app.resource<Input>('input');
+ * if (input.pressed('Space')) jump();
+ */
+export { attachDom, type DomSource } from './dom.ts';
+export { Input, type InputEvent, type InputRecording, KINDS, type PointerState } from './input.ts';
+export { inputPlugin, type InputPluginOptions } from './plugin.ts';

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@yali-engine/input`: keyboard, pointer and wheel as per-frame state, fed by the DOM or by
+ * forwarded events (worker render mode), with frame-exact recording and replay for the
+ * headless deterministic mode (DESIGN.md §19, ADR-0040).
+ *
+ * @example
+ * import { inputPlugin, type Input } from '@yali-engine/input';
+ * const app = App.create({ core, plugins: [inputPlugin({ dom: { target: canvas } })] });
+ * const input = app.resource<Input>('input');
+ * if (input.pressed('Space')) jump();
+ */
+export { attachDom } from "./dom.js";
+export { Input, KINDS } from "./input.js";
+export { inputPlugin } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAkB,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,KAAK,EAAwC,KAAK,EAAqB,MAAM,YAAY,CAAC;AACnG,OAAO,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,104 @@
+/**
+ * One input event as plain data: what a DOM listener sees, what the page forwards to a
+ * render worker (it matches `@yali-engine/render`'s `ForwardedInput`), and what a recording holds.
+ * Keys are identified by `code` (the physical key, `KeyW`), so layouts do not matter.
+ */
+export type InputEvent = {
+    readonly kind: 'pointerdown' | 'pointermove' | 'pointerup';
+    readonly x: number;
+    readonly y: number;
+    readonly movementX: number;
+    readonly movementY: number;
+    readonly buttons: number;
+    readonly pointerId?: number;
+} | {
+    readonly kind: 'wheel';
+    readonly deltaX: number;
+    readonly deltaY: number;
+} | {
+    readonly kind: 'keydown' | 'keyup';
+    readonly code: string;
+    readonly key?: string;
+};
+/**
+ * A recording: every event applied, keyed by the frame it was applied in (counted from the
+ * recording's first frame). Plain JSON. Replaying it on a fixed clock reproduces a run.
+ */
+export interface InputRecording {
+    readonly version: 1;
+    /** Frames the recording spans; replay ends after this many. */
+    readonly frames: number;
+    /** Key codes, indexed by the key events below. */
+    readonly codes: readonly string[];
+    /** Flattened `[frame, kind, a, b, c, d, e]` per event (see `KINDS`). */
+    readonly events: readonly number[];
+}
+/** Event kinds in recording order: a recording's kind field indexes this. */
+export declare const KINDS: readonly ["pointerdown", "pointermove", "pointerup", "wheel", "keydown", "keyup"];
+/** Pointer state for the current frame. Fields update in place; nothing is allocated. */
+export interface PointerState {
+    /** Position in CSS pixels, relative to the input target. */
+    x: number;
+    y: number;
+    /** Movement during this frame. */
+    dx: number;
+    dy: number;
+    /** Wheel delta during this frame. */
+    wheelX: number;
+    wheelY: number;
+    /** Buttons held now (PointerEvent.buttons: 1 primary, 2 secondary, 4 middle). */
+    buttons: number;
+    /** Buttons that went down / up during this frame. */
+    pressed: number;
+    released: number;
+}
+/**
+ * Input as per-frame state (DESIGN.md §19). Events are queued as they arrive and applied
+ * all at once in the frame's `Input` stage, so every system in a frame sees the same state
+ * and a frame's input does not depend on when, within it, a DOM event landed.
+ *
+ * Recording keeps the events with the frame they were applied in; replay applies them in
+ * the same frames and ignores live input meanwhile. With a fixed clock and a seed
+ * (ADR-0030), that reproduces a run exactly. The queue is a preallocated ring: pushing
+ * and applying allocate nothing (recording grows its arrays).
+ *
+ * @example
+ * const input = app.resource<Input>('input');
+ * if (input.down('KeyW')) speed += 1;
+ * if (input.pointer.buttons & 1) camera.yaw -= input.pointer.dx * 0.005;
+ */
+export declare class Input {
+    #private;
+    readonly pointer: PointerState;
+    /** Events lost because the queue was full (it holds `capacity` until the next frame). */
+    dropped: number;
+    constructor(options?: {
+        capacity?: number;
+    });
+    /** Whether `code` is held this frame. */
+    down(code: string): boolean;
+    /** Whether `code` went down during this frame. */
+    pressed(code: string): boolean;
+    /** Whether `code` went up during this frame. */
+    released(code: string): boolean;
+    /** Queues an event for the next `Input` stage. */
+    push(e: InputEvent): void;
+    /** Queues a key-up for every held key (on blur, so no key stays stuck down). */
+    releaseAll(): void;
+    /** Starts recording from the next frame. */
+    record(): void;
+    /** Stops recording and returns it (an empty recording if none was running). */
+    stopRecording(): InputRecording;
+    /** Whether a recording is running. */
+    get recording(): boolean;
+    /** Replays `rec` from the next frame; live input is ignored until it ends. */
+    replay(rec: InputRecording): void;
+    /** Whether a replay is running (it ends by itself after the recording's last frame). */
+    get replaying(): boolean;
+    /**
+     * Applies the frame's input: called once per frame by `inputPlugin` in the `Input` stage
+     * (or by hand in tests). Clears per-frame state, then applies the queued events, or the
+     * replay's events for this frame.
+     */
+    frame(): void;
+}

package/dist/input.js

@@ -0,0 +1,239 @@
+import { YaliError } from '@yali-engine/core';
+/** Event kinds in recording order: a recording's kind field indexes this. */
+export const KINDS = ['pointerdown', 'pointermove', 'pointerup', 'wheel', 'keydown', 'keyup'];
+const PDOWN = 0;
+const PMOVE = 1;
+const PUP = 2;
+const WHEEL = 3;
+const KDOWN = 4;
+const KUP = 5;
+/** Fields per event in the queue and in a recording (after the frame): kind + 5 values. */
+const FIELDS = 6;
+const MAX_CODES = 512;
+/**
+ * Input as per-frame state (DESIGN.md §19). Events are queued as they arrive and applied
+ * all at once in the frame's `Input` stage, so every system in a frame sees the same state
+ * and a frame's input does not depend on when, within it, a DOM event landed.
+ *
+ * Recording keeps the events with the frame they were applied in; replay applies them in
+ * the same frames and ignores live input meanwhile. With a fixed clock and a seed
+ * (ADR-0030), that reproduces a run exactly. The queue is a preallocated ring: pushing
+ * and applying allocate nothing (recording grows its arrays).
+ *
+ * @example
+ * const input = app.resource<Input>('input');
+ * if (input.down('KeyW')) speed += 1;
+ * if (input.pointer.buttons & 1) camera.yaw -= input.pointer.dx * 0.005;
+ */
+export class Input {
+    pointer = { x: 0, y: 0, dx: 0, dy: 0, wheelX: 0, wheelY: 0, buttons: 0, pressed: 0, released: 0 };
+    #queue;
+    #head = 0;
+    #count = 0;
+    /** Events lost because the queue was full (it holds `capacity` until the next frame). */
+    dropped = 0;
+    #codes = new Map();
+    #codeNames = [];
+    #down = new Uint8Array(MAX_CODES);
+    #pressed = new Uint8Array(MAX_CODES);
+    #released = new Uint8Array(MAX_CODES);
+    #frame = 0;
+    #recording = null;
+    #replay = null;
+    #replayPending = null;
+    #recordPending = false;
+    constructor(options = {}) {
+        this.#queue = new Float64Array((options.capacity ?? 1024) * FIELDS);
+    }
+    /** Whether `code` is held this frame. */
+    down(code) {
+        const id = this.#codes.get(code);
+        return id !== undefined && this.#down[id] === 1;
+    }
+    /** Whether `code` went down during this frame. */
+    pressed(code) {
+        const id = this.#codes.get(code);
+        return id !== undefined && this.#pressed[id] === 1;
+    }
+    /** Whether `code` went up during this frame. */
+    released(code) {
+        const id = this.#codes.get(code);
+        return id !== undefined && this.#released[id] === 1;
+    }
+    /** Queues an event for the next `Input` stage. */
+    push(e) {
+        switch (e.kind) {
+            case 'pointerdown':
+            case 'pointermove':
+            case 'pointerup':
+                this.#enqueue(e.kind === 'pointerdown' ? PDOWN : e.kind === 'pointerup' ? PUP : PMOVE, e.x, e.y, e.movementX, e.movementY, e.buttons);
+                break;
+            case 'wheel':
+                this.#enqueue(WHEEL, e.deltaX, e.deltaY, 0, 0, 0);
+                break;
+            case 'keydown':
+            case 'keyup':
+                this.#enqueue(e.kind === 'keydown' ? KDOWN : KUP, this.#intern(e.code), 0, 0, 0, 0);
+                break;
+            default:
+                throw new YaliError('INPUT_KIND', `Unknown input event kind ${e.kind}.`, `Use one of ${KINDS.join(', ')}.`);
+        }
+    }
+    /** Queues a key-up for every held key (on blur, so no key stays stuck down). */
+    releaseAll() {
+        for (let id = 0; id < this.#codeNames.length; id++)
+            if (this.#down[id])
+                this.#enqueue(KUP, id, 0, 0, 0, 0);
+        if (this.pointer.buttons)
+            this.#enqueue(PUP, this.pointer.x, this.pointer.y, 0, 0, 0);
+    }
+    /** Starts recording from the next frame. */
+    record() {
+        this.#recordPending = true;
+    }
+    /** Stops recording and returns it (an empty recording if none was running). */
+    stopRecording() {
+        const r = this.#recording;
+        this.#recording = null;
+        this.#recordPending = false;
+        if (!r)
+            return { version: 1, frames: 0, codes: [], events: [] };
+        return { version: 1, frames: this.#frame - r.start, codes: r.names, events: r.events };
+    }
+    /** Whether a recording is running. */
+    get recording() {
+        return this.#recording !== null || this.#recordPending;
+    }
+    /** Replays `rec` from the next frame; live input is ignored until it ends. */
+    replay(rec) {
+        if (rec?.version !== 1 || !Array.isArray(rec.events) || !Array.isArray(rec.codes) || rec.events.length % (FIELDS + 1) !== 0) {
+            throw new YaliError('INPUT_RECORDING', 'This is not a version 1 input recording.', 'Pass what Input.stopRecording() returned (plain JSON is fine).');
+        }
+        this.#replayPending = rec;
+    }
+    /** Whether a replay is running (it ends by itself after the recording's last frame). */
+    get replaying() {
+        return this.#replay !== null || this.#replayPending !== null;
+    }
+    /**
+     * Applies the frame's input: called once per frame by `inputPlugin` in the `Input` stage
+     * (or by hand in tests). Clears per-frame state, then applies the queued events, or the
+     * replay's events for this frame.
+     */
+    frame() {
+        this.#pressed.fill(0);
+        this.#released.fill(0);
+        const p = this.pointer;
+        p.dx = p.dy = p.wheelX = p.wheelY = p.pressed = p.released = 0;
+        if (this.#replayPending) {
+            const rec = this.#replayPending;
+            this.#replayPending = null;
+            const remap = new Int32Array(rec.codes.length);
+            for (let i = 0; i < rec.codes.length; i++)
+                remap[i] = this.#intern(rec.codes[i]);
+            this.#replay = { rec, start: this.#frame, cursor: 0, remap };
+        }
+        if (this.#recordPending && !this.#recording) {
+            this.#recordPending = false;
+            this.#recording = { start: this.#frame, events: [], codes: new Map(), names: [] };
+        }
+        const q = this.#queue;
+        const cap = q.length / FIELDS;
+        if (this.#replay) {
+            this.#count = 0; // live input is ignored during a replay
+            const r = this.#replay;
+            const ev = r.rec.events;
+            const at = this.#frame - r.start;
+            while (r.cursor < ev.length && ev[r.cursor] === at) {
+                const k = ev[r.cursor + 1];
+                const a = k === KDOWN || k === KUP ? r.remap[ev[r.cursor + 2]] : ev[r.cursor + 2];
+                this.#apply(k, a, ev[r.cursor + 3], ev[r.cursor + 4], ev[r.cursor + 5], ev[r.cursor + 6]);
+                r.cursor += FIELDS + 1;
+            }
+            if (at + 1 >= r.rec.frames)
+                this.#replay = null;
+        }
+        else {
+            for (; this.#count > 0; this.#count--) {
+                const o = this.#head * FIELDS;
+                this.#apply(q[o], q[o + 1], q[o + 2], q[o + 3], q[o + 4], q[o + 5]);
+                this.#head = (this.#head + 1) % cap;
+            }
+        }
+        this.#frame++;
+    }
+    #apply(kind, a, b, c, d, e) {
+        const p = this.pointer;
+        if (kind === KDOWN || kind === KUP) {
+            if (kind === KDOWN) {
+                if (this.#down[a])
+                    return; // auto-repeat
+                this.#down[a] = 1;
+                this.#pressed[a] = 1;
+            }
+            else {
+                if (!this.#down[a])
+                    return;
+                this.#down[a] = 0;
+                this.#released[a] = 1;
+            }
+        }
+        else if (kind === WHEEL) {
+            p.wheelX += a;
+            p.wheelY += b;
+        }
+        else {
+            p.x = a;
+            p.y = b;
+            p.dx += c;
+            p.dy += d;
+            const was = p.buttons;
+            p.buttons = e;
+            p.pressed |= p.buttons & ~was;
+            p.released |= was & ~p.buttons;
+        }
+        const r = this.#recording;
+        if (r) {
+            let ka = a;
+            if (kind === KDOWN || kind === KUP) {
+                let local = r.codes.get(a);
+                if (local === undefined) {
+                    local = r.names.length;
+                    r.codes.set(a, local);
+                    r.names.push(this.#codeNames[a]);
+                }
+                ka = local;
+            }
+            r.events.push(this.#frame - r.start, kind, ka, b, c, d, e);
+        }
+    }
+    #enqueue(kind, a, b, c, d, e) {
+        const q = this.#queue;
+        const cap = q.length / FIELDS;
+        if (this.#count === cap) {
+            this.dropped++;
+            return;
+        }
+        const o = ((this.#head + this.#count) % cap) * FIELDS;
+        q[o] = kind;
+        q[o + 1] = a;
+        q[o + 2] = b;
+        q[o + 3] = c;
+        q[o + 4] = d;
+        q[o + 5] = e;
+        this.#count++;
+    }
+    #intern(code) {
+        let id = this.#codes.get(code);
+        if (id === undefined) {
+            if (this.#codeNames.length >= MAX_CODES) {
+                throw new YaliError('INPUT_TOO_MANY_KEYS', `More than ${MAX_CODES} distinct key codes.`, 'Key codes are KeyboardEvent.code values; pass those, not free text.');
+            }
+            id = this.#codeNames.length;
+            this.#codes.set(code, id);
+            this.#codeNames.push(code);
+        }
+        return id;
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAkC9C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AACvG,MAAM,KAAK,GAAG,CAAC,CAAC;AAChB,MAAM,KAAK,GAAG,CAAC,CAAC;AAChB,MAAM,GAAG,GAAG,CAAC,CAAC;AACd,MAAM,KAAK,GAAG,CAAC,CAAC;AAChB,MAAM,KAAK,GAAG,CAAC,CAAC;AAChB,MAAM,GAAG,GAAG,CAAC,CAAC;AACd,2FAA2F;AAC3F,MAAM,MAAM,GAAG,CAAC,CAAC;AACjB,MAAM,SAAS,GAAG,GAAG,CAAC;AAoBtB;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,KAAK;IACP,OAAO,GAAiB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzH,MAAM,CAAe;IACrB,KAAK,GAAG,CAAC,CAAC;IACV,MAAM,GAAG,CAAC,CAAC;IACX,yFAAyF;IACzF,OAAO,GAAG,CAAC,CAAC;IACZ,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnC,UAAU,GAAa,EAAE,CAAC;IAC1B,KAAK,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACrC,SAAS,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,GAAG,CAAC,CAAC;IACX,UAAU,GAA4F,IAAI,CAAC;IAC3G,OAAO,GAAqF,IAAI,CAAC;IACjG,cAAc,GAA0B,IAAI,CAAC;IAC7C,cAAc,GAAG,KAAK,CAAC;IAEvB,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IACtE,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,IAAY;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,kDAAkD;IAClD,OAAO,CAAC,IAAY;QAClB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,gDAAgD;IAChD,QAAQ,CAAC,IAAY;QACnB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC,CAAa;QAChB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,aAAa,CAAC;YACnB,KAAK,aAAa,CAAC;YACnB,KAAK,WAAW;gBACd,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;gBACtI,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClD,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,OAAO;gBACV,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpF,MAAM;YACR;gBACE,MAAM,IAAI,SAAS,CAAC,YAAY,EAAE,4BAA6B,CAAsB,CAAC,IAAI,GAAG,EAAE,cAAc,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtI,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,UAAU;QACR,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE;YAAE,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3G,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,4CAA4C;IAC5C,MAAM;QACJ,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,+EAA+E;IAC/E,aAAa;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACzF,CAAC;IAED,sCAAsC;IACtC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC;IACzD,CAAC;IAED,8EAA8E;IAC9E,MAAM,CAAC,GAAmB;QACxB,IAAI,GAAG,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5H,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,0CAA0C,EAAE,gEAAgE,CAAC,CAAC;QACvJ,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC;IAC5B,CAAC;IAED,wFAAwF;IACxF,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC;YAChC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACjF,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;QAC/D,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5C,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;YAC5B,IAAI,CAAC,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACpF,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,wCAAwC;YACzD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;YACxB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;YACjC,OAAO,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAClF,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC1F,CAAC,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC;YACzB,CAAC;YACD,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACpE,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;YACtC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;QACxE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACnC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;oBAAE,OAAO,CAAC,cAAc;gBACzC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAClB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;oBAAE,OAAO;gBAC3B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAClB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YAC1B,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;YACd,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACR,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACR,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACV,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;YACtB,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC;YAC9B,CAAC,CAAC,QAAQ,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC;YACN,IAAI,EAAE,GAAG,CAAC,CAAC;YACX,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACnC,IAAI,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;oBACvB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;oBACtB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,CAAC;gBACD,EAAE,GAAG,KAAK,CAAC;YACb,CAAC;YACD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;QAC1E,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC;QACtD,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACZ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;gBACxC,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,aAAa,SAAS,sBAAsB,EAAE,qEAAqE,CAAC,CAAC;YAClK,CAAC;YACD,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/plugin.d.ts

@@ -0,0 +1,22 @@
+import type { YaliPlugin } from '@yali-engine/core';
+import { type DomSource } from './dom.ts';
+/** Options for `inputPlugin`. */
+export interface InputPluginOptions {
+    /**
+     * Where DOM events come from (the canvas). Leave it out where there is no DOM (worker
+     * render mode, headless): push events with `input.push` instead.
+     */
+    readonly dom?: DomSource;
+    /** Queue capacity in events between two frames (default 1024). */
+    readonly capacity?: number;
+}
+/**
+ * `@yali-engine/input` as a plugin: provides the `input` resource and applies the queued events
+ * at the start of every frame (the `Input` stage). Registers three agent tools:
+ * `input.record`, `input.stop_recording` (returns the recording) and `input.replay`.
+ *
+ * @example
+ * App.create({ core, plugins: [inputPlugin({ dom: { target: canvas } }), game] });
+ * // in a system: app.resource<Input>('input').pressed('Space')
+ */
+export declare function inputPlugin(options?: InputPluginOptions): YaliPlugin;

package/dist/plugin.js

@@ -0,0 +1,52 @@
+import { attachDom } from "./dom.js";
+import { Input } from "./input.js";
+/**
+ * `@yali-engine/input` as a plugin: provides the `input` resource and applies the queued events
+ * at the start of every frame (the `Input` stage). Registers three agent tools:
+ * `input.record`, `input.stop_recording` (returns the recording) and `input.replay`.
+ *
+ * @example
+ * App.create({ core, plugins: [inputPlugin({ dom: { target: canvas } }), game] });
+ * // in a system: app.resource<Input>('input').pressed('Space')
+ */
+export function inputPlugin(options = {}) {
+    return {
+        name: '@yali-engine/input',
+        version: '0.4.0',
+        build(b) {
+            const input = new Input({ capacity: options.capacity });
+            b.provide('input', input);
+            b.system({ name: 'input.frame', stage: 'Input', run: () => input.frame() });
+            if (options.dom) {
+                const dom = attachDom(input, options.dom);
+                b.leaks(() => ({ listeners: dom.listeners() }));
+                b.onDispose(() => dom.detach());
+            }
+            b.tool({
+                name: 'input.record',
+                description: 'Starts recording input from the next frame (frame-exact; see input.stop_recording).',
+                input: { type: 'object', properties: {} },
+                run: () => {
+                    input.record();
+                    return { recording: true };
+                },
+            });
+            b.tool({
+                name: 'input.stop_recording',
+                description: 'Stops recording and returns the recording as JSON, for input.replay.',
+                input: { type: 'object', properties: {} },
+                run: () => input.stopRecording(),
+            });
+            b.tool({
+                name: 'input.replay',
+                description: 'Replays a recording from the next frame; live input is ignored until it ends.',
+                input: { type: 'object', properties: { recording: { type: 'object', description: 'What input.stop_recording returned.' } }, required: ['recording'] },
+                run: (args) => {
+                    input.replay(args.recording);
+                    return { replaying: true, frames: args.recording.frames };
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAkB,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,KAAK,EAAuB,MAAM,YAAY,CAAC;AAaxD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;QAChB,KAAK,CAAC,CAAC;YACL,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACxD,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5E,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC1C,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;gBAChD,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,CAAC,CAAC,IAAI,CAAC;gBACL,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,qFAAqF;gBAClG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;gBACzC,GAAG,EAAE,GAAG,EAAE;oBACR,KAAK,CAAC,MAAM,EAAE,CAAC;oBACf,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;gBAC7B,CAAC;aACF,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC;gBACL,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EAAE,sEAAsE;gBACnF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;gBACzC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE;aACjC,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC;gBACL,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,+EAA+E;gBAC5F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;gBACrJ,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;oBACZ,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAA2B,CAAC,CAAC;oBAC/C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAG,IAAI,CAAC,SAA4B,CAAC,MAAM,EAAE,CAAC;gBAChF,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "@yali-engine/input",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.0",
+  "description": "Yali input: keyboard, pointer and wheel as per-frame state, from the DOM or forwarded events, with frame-exact recording and replay.",
+  "license": "MIT OR Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@yali-engine/core": "0.4.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "node --experimental-strip-types --no-warnings --test \"test/*.test.ts\""
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.