@flyingrobots/bijou-tui 7.2.0 → 8.0.0-rc.1

package/dist/input-map.js

@@ -1,161 +1,4 @@
-/**
- * Input feature events and semantic action maps.
- *
- * This module sits above raw terminal input parsing and below app/frame
- * reducers. It lets shells bind actions to semantic input feature events such
- * as "keyboard.tab double-tap" without hard-coding gesture state into a single
- * component.
- */
-export const DEFAULT_DOUBLE_TAP_MS = 300;
-export const KEYBOARD_INPUT_DEVICE_ID = 'keyboard';
-export function defineInputDevice(device) {
-    return freezePlain({
-        ...device,
-        id: normalizeId(device.id, 'input device id'),
-        kind: normalizeId(device.kind, 'input device kind'),
-    });
-}
-export function defineInputFeature(feature) {
-    return freezePlain({
-        ...feature,
-        deviceId: normalizeId(feature.deviceId, 'input feature device id'),
-        id: normalizeId(feature.id, 'input feature id'),
-        kind: normalizeId(feature.kind, 'input feature kind'),
-    });
-}
-export function keyboardFeature(key) {
-    const normalizedKey = normalizeId(key, 'keyboard feature key');
-    return defineInputFeature({
-        deviceId: KEYBOARD_INPUT_DEVICE_ID,
-        id: `key.${normalizedKey}`,
-        kind: 'key',
-        label: normalizedKey,
-    });
-}
-export function keyboardModifierFeature(modifier) {
-    return defineInputFeature({
-        deviceId: KEYBOARD_INPUT_DEVICE_ID,
-        id: `modifier.${modifier}`,
-        kind: 'modifier',
-        label: modifier,
-    });
-}
-export function inputFeatureEvent(feature, type, atMs) {
-    return freezePlain({
-        feature,
-        type: normalizeId(type, 'input feature event type'),
-        atMs: normalizeTimestamp(atMs),
-    });
-}
-export function createInputGestureRecognizer(options = {}) {
-    const device = defineInputDevice(options.device ?? {
-        id: KEYBOARD_INPUT_DEVICE_ID,
-        kind: 'keyboard',
-        label: 'Keyboard',
-    });
-    const doubleTapMs = normalizePositiveDuration(options.doubleTapMs, DEFAULT_DOUBLE_TAP_MS);
-    let lastTap;
-    return {
-        observeKey(msg, atMs) {
-            const timestamp = normalizeTimestamp(atMs);
-            const featureEvents = [];
-            if (msg.ctrl) {
-                featureEvents.push(inputFeatureEvent(keyboardModifierFeature('ctrl'), 'held', timestamp));
-            }
-            if (msg.alt) {
-                featureEvents.push(inputFeatureEvent(keyboardModifierFeature('alt'), 'held', timestamp));
-            }
-            if (msg.shift) {
-                featureEvents.push(inputFeatureEvent(keyboardModifierFeature('shift'), 'held', timestamp));
-            }
-            const keyFeature = keyboardFeature(msg.key);
-            featureEvents.push(inputFeatureEvent(keyFeature, 'press', timestamp));
-            featureEvents.push(inputFeatureEvent(keyFeature, 'tap', timestamp));
-            const signature = keySignature(msg);
-            const isDoubleTap = lastTap?.signature === signature
-                && timestamp - lastTap.atMs <= doubleTapMs;
-            if (isDoubleTap) {
-                featureEvents.push(inputFeatureEvent(keyFeature, 'double-tap', timestamp));
-                lastTap = undefined;
-            }
-            else {
-                lastTap = { signature, atMs: timestamp };
-            }
-            return freezePlain({
-                device,
-                featureEvents: Object.freeze(featureEvents),
-                atMs: timestamp,
-            });
-        },
-        reset() {
-            lastTap = undefined;
-        },
-    };
-}
-export function createInputActionMap() {
-    const bindings = [];
-    return {
-        bind(id, description, featureEvents, action) {
-            const normalizedFeatureEvents = featureEvents.map((featureEvent) => freezePlain({
-                ...featureEvent,
-                featureId: normalizeId(featureEvent.featureId, 'input action feature id'),
-                type: normalizeId(featureEvent.type, 'input action event type'),
-                deviceId: featureEvent.deviceId != null
-                    ? normalizeId(featureEvent.deviceId, 'input action device id')
-                    : undefined,
-            }));
-            bindings.push(freezePlain({
-                id: normalizeId(id, 'input action id'),
-                description,
-                featureEvents: Object.freeze(normalizedFeatureEvents),
-                action,
-                enabled: true,
-            }));
-            return this;
-        },
-        handle(event) {
-            return bindings.find((binding) => binding.enabled && inputEventMatches(event, binding.featureEvents))?.action;
-        },
-        bindings() {
-            return Object.freeze([...bindings]);
-        },
-    };
-}
-export function inputEventMatches(event, patterns) {
-    return patterns.every((pattern) => event.featureEvents.some((featureEvent) => featureEvent.type === pattern.type
-        && featureEvent.feature.id === pattern.featureId
-        && (pattern.deviceId == null || featureEvent.feature.deviceId === pattern.deviceId)));
-}
-function keySignature(msg) {
-    return [
-        msg.ctrl ? 'ctrl' : '',
-        msg.alt ? 'alt' : '',
-        msg.shift ? 'shift' : '',
-        msg.key,
-    ].join('|');
-}
-function normalizeId(value, label) {
-    const normalized = value.trim();
-    if (normalized === '') {
-        throw new Error(`${label} is required`);
-    }
-    return normalized;
-}
-function normalizeTimestamp(value) {
-    if (!Number.isFinite(value)) {
-        throw new Error('input event timestamp must be finite');
-    }
-    return value;
-}
-function normalizePositiveDuration(value, fallback) {
-    if (value == null)
-        return fallback;
-    if (!Number.isFinite(value) || value <= 0) {
-        throw new Error('input gesture doubleTapMs must be a positive finite number');
-    }
-    return value;
-}
-function freezePlain(value) {
-    return Object.freeze(value);
-}
+export { DEFAULT_DOUBLE_TAP_MS, KEYBOARD_INPUT_DEVICE_ID, defineInputDevice, defineInputFeature, keyboardFeature, keyboardModifierFeature, } from './input-map.part01.js';
+export { inputFeatureEvent, createInputGestureRecognizer, createInputActionMap, } from './input-map.part02.js';
+export { inputEventMatches } from './input-map.part04.js';
 //# sourceMappingURL=input-map.js.map

package/dist/input-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"input-map.js","sourceRoot":"","sources":["../src/input-map.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"input-map.js","sourceRoot":"","sources":["../src/input-map.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/input-map.part01.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Input feature events and semantic action maps.
+ *
+ * This module sits above raw terminal input parsing and below app/frame
+ * reducers. It lets shells bind actions to semantic input feature events such
+ * as "keyboard.tab double-tap" without hard-coding gesture state into a single
+ * component.
+ */
+import type { KeyMsg } from './types.js';
+export declare const DEFAULT_DOUBLE_TAP_MS = 300;
+export declare const KEYBOARD_INPUT_DEVICE_ID = "keyboard";
+export type StandardInputFeatureEventType = 'press' | 'held' | 'long-press' | 'release' | 'tap' | 'double-tap';
+export type InputFeatureEventType = StandardInputFeatureEventType | (string & {});
+export interface InputDevice {
+    readonly id: string;
+    readonly kind: string;
+    readonly label?: string;
+}
+export interface InputFeature {
+    readonly deviceId: string;
+    readonly id: string;
+    readonly kind: string;
+    readonly label?: string;
+}
+export interface InputFeatureEvent {
+    readonly feature: InputFeature;
+    readonly type: InputFeatureEventType;
+    readonly atMs: number;
+}
+export interface InputEvent {
+    readonly device: InputDevice;
+    readonly featureEvents: readonly InputFeatureEvent[];
+    readonly atMs: number;
+}
+export interface InputFeatureEventPattern {
+    readonly featureId: string;
+    readonly type: InputFeatureEventType;
+    readonly deviceId?: string;
+}
+export interface InputActionBinding<Action> {
+    readonly id: string;
+    readonly description: string;
+    readonly featureEvents: readonly InputFeatureEventPattern[];
+    readonly action: Action;
+    readonly enabled: boolean;
+}
+export interface InputActionMap<Action> {
+    bind(id: string, description: string, featureEvents: readonly InputFeatureEventPattern[], action: Action): InputActionMap<Action>;
+    handle(event: InputEvent): Action | undefined;
+    bindings(): readonly InputActionBinding<Action>[];
+}
+export interface InputGestureRecognizer {
+    observeKey(msg: KeyMsg, atMs: number): InputEvent;
+    reset(): void;
+}
+export interface InputGestureRecognizerOptions {
+    readonly doubleTapMs?: number;
+    readonly device?: InputDevice;
+}
+export interface LastTap {
+    readonly signature: string;
+    readonly atMs: number;
+}
+export declare function defineInputDevice(device: InputDevice): InputDevice;
+export declare function defineInputFeature(feature: InputFeature): InputFeature;
+export declare function keyboardFeature(key: string): InputFeature;
+export declare function keyboardModifierFeature(modifier: 'ctrl' | 'alt' | 'shift'): InputFeature;
+//# sourceMappingURL=input-map.part01.d.ts.map

package/dist/input-map.part01.d.ts.map

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

package/dist/input-map.part01.js

@@ -0,0 +1,36 @@
+import { freezePlain, normalizeId } from './input-map.part03.js';
+export const DEFAULT_DOUBLE_TAP_MS = 300;
+export const KEYBOARD_INPUT_DEVICE_ID = 'keyboard';
+export function defineInputDevice(device) {
+    return freezePlain({
+        ...device,
+        id: normalizeId(device.id, 'input device id'),
+        kind: normalizeId(device.kind, 'input device kind'),
+    });
+}
+export function defineInputFeature(feature) {
+    return freezePlain({
+        ...feature,
+        deviceId: normalizeId(feature.deviceId, 'input feature device id'),
+        id: normalizeId(feature.id, 'input feature id'),
+        kind: normalizeId(feature.kind, 'input feature kind'),
+    });
+}
+export function keyboardFeature(key) {
+    const normalizedKey = normalizeId(key, 'keyboard feature key');
+    return defineInputFeature({
+        deviceId: KEYBOARD_INPUT_DEVICE_ID,
+        id: `key.${normalizedKey}`,
+        kind: 'key',
+        label: normalizedKey,
+    });
+}
+export function keyboardModifierFeature(modifier) {
+    return defineInputFeature({
+        deviceId: KEYBOARD_INPUT_DEVICE_ID,
+        id: `modifier.${modifier}`,
+        kind: 'modifier',
+        label: modifier,
+    });
+}
+//# sourceMappingURL=input-map.part01.js.map

package/dist/input-map.part01.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-map.part01.js","sourceRoot":"","sources":["../src/input-map.part01.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AA4DnD,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO,WAAW,CAAC;QACjB,GAAG,MAAM;QACT,EAAE,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,CAAC;QAC7C,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC;KACpD,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,OAAO,WAAW,CAAC;QACjB,GAAG,OAAO;QACV,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,yBAAyB,CAAC;QAClE,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,kBAAkB,CAAC;QAC/C,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAC/D,OAAO,kBAAkB,CAAC;QACxB,QAAQ,EAAE,wBAAwB;QAClC,EAAE,EAAE,OAAO,aAAa,EAAE;QAC1B,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,aAAa;KACrB,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,uBAAuB,CACrC,QAAkC;IAElC,OAAO,kBAAkB,CAAC;QACxB,QAAQ,EAAE,wBAAwB;QAClC,EAAE,EAAE,YAAY,QAAQ,EAAE;QAC1B,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/input-map.part02.d.ts

@@ -0,0 +1,5 @@
+import { type InputActionMap, type InputFeature, type InputFeatureEvent, type InputFeatureEventType, type InputGestureRecognizer, type InputGestureRecognizerOptions } from './input-map.part01.js';
+export declare function inputFeatureEvent(feature: InputFeature, type: InputFeatureEventType, atMs: number): InputFeatureEvent;
+export declare function createInputGestureRecognizer(options?: InputGestureRecognizerOptions): InputGestureRecognizer;
+export declare function createInputActionMap<Action>(): InputActionMap<Action>;
+//# sourceMappingURL=input-map.part02.d.ts.map

package/dist/input-map.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-map.part02.d.ts","sourceRoot":"","sources":["../src/input-map.part02.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAOnC,MAAM,uBAAuB,CAAC;AAU/B,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,MAAM,GACX,iBAAiB,CAMnB;AACD,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,CAmExB;AACD,wBAAgB,oBAAoB,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,CAAC,CAwCrE"}

package/dist/input-map.part02.js

@@ -0,0 +1,85 @@
+import { DEFAULT_DOUBLE_TAP_MS, KEYBOARD_INPUT_DEVICE_ID, defineInputDevice, keyboardFeature, keyboardModifierFeature, } from './input-map.part01.js';
+import { freezePlain, keySignature, normalizeId, normalizePositiveDuration, normalizeTimestamp, } from './input-map.part03.js';
+import { inputEventMatches } from './input-map.part04.js';
+export function inputFeatureEvent(feature, type, atMs) {
+    return freezePlain({
+        feature,
+        type: normalizeId(type, 'input feature event type'),
+        atMs: normalizeTimestamp(atMs),
+    });
+}
+export function createInputGestureRecognizer(options = {}) {
+    const device = defineInputDevice(options.device ?? {
+        id: KEYBOARD_INPUT_DEVICE_ID,
+        kind: 'keyboard',
+        label: 'Keyboard',
+    });
+    const doubleTapMs = normalizePositiveDuration(options.doubleTapMs, DEFAULT_DOUBLE_TAP_MS);
+    let lastTap;
+    return {
+        observeKey(msg, atMs) {
+            const timestamp = normalizeTimestamp(atMs);
+            const featureEvents = [];
+            if (msg.ctrl) {
+                featureEvents.push(inputFeatureEvent(keyboardModifierFeature('ctrl'), 'held', timestamp));
+            }
+            if (msg.alt) {
+                featureEvents.push(inputFeatureEvent(keyboardModifierFeature('alt'), 'held', timestamp));
+            }
+            if (msg.shift) {
+                featureEvents.push(inputFeatureEvent(keyboardModifierFeature('shift'), 'held', timestamp));
+            }
+            const keyFeature = keyboardFeature(msg.key);
+            featureEvents.push(inputFeatureEvent(keyFeature, 'press', timestamp));
+            featureEvents.push(inputFeatureEvent(keyFeature, 'tap', timestamp));
+            const signature = keySignature(msg);
+            const isDoubleTap = lastTap?.signature === signature &&
+                timestamp - lastTap.atMs <= doubleTapMs;
+            if (isDoubleTap) {
+                featureEvents.push(inputFeatureEvent(keyFeature, 'double-tap', timestamp));
+                lastTap = undefined;
+            }
+            else {
+                lastTap = { signature, atMs: timestamp };
+            }
+            return freezePlain({
+                device,
+                featureEvents: Object.freeze(featureEvents),
+                atMs: timestamp,
+            });
+        },
+        reset() {
+            lastTap = undefined;
+        },
+    };
+}
+export function createInputActionMap() {
+    const bindings = [];
+    return {
+        bind(id, description, featureEvents, action) {
+            const normalizedFeatureEvents = featureEvents.map((featureEvent) => freezePlain({
+                ...featureEvent,
+                featureId: normalizeId(featureEvent.featureId, 'input action feature id'),
+                type: normalizeId(featureEvent.type, 'input action event type'),
+                deviceId: featureEvent.deviceId != null
+                    ? normalizeId(featureEvent.deviceId, 'input action device id')
+                    : undefined,
+            }));
+            bindings.push(freezePlain({
+                id: normalizeId(id, 'input action id'),
+                description,
+                featureEvents: Object.freeze(normalizedFeatureEvents),
+                action,
+                enabled: true,
+            }));
+            return this;
+        },
+        handle(event) {
+            return bindings.find((binding) => binding.enabled && inputEventMatches(event, binding.featureEvents))?.action;
+        },
+        bindings() {
+            return Object.freeze([...bindings]);
+        },
+    };
+}
+//# sourceMappingURL=input-map.part02.js.map

package/dist/input-map.part02.js.map

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

package/dist/input-map.part03.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Input feature events and semantic action maps.
+ *
+ * This module sits above raw terminal input parsing and below app/frame
+ * reducers. It lets shells bind actions to semantic input feature events such
+ * as "keyboard.tab double-tap" without hard-coding gesture state into a single
+ * component.
+ */
+import type { KeyMsg } from './types.js';
+export declare function keySignature(msg: KeyMsg): string;
+export declare function normalizeId(value: string, label: string): string;
+export declare function normalizeTimestamp(value: number): number;
+export declare function normalizePositiveDuration(value: number | undefined, fallback: number): number;
+export declare function freezePlain<T extends object>(value: T): T;
+//# sourceMappingURL=input-map.part03.d.ts.map

package/dist/input-map.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-map.part03.d.ts","sourceRoot":"","sources":["../src/input-map.part03.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhE;AACD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxD;AACD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR;AACD,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEzD"}

package/dist/input-map.part03.js

@@ -0,0 +1,33 @@
+export function keySignature(msg) {
+    return [
+        msg.ctrl ? 'ctrl' : '',
+        msg.alt ? 'alt' : '',
+        msg.shift ? 'shift' : '',
+        msg.key,
+    ].join('|');
+}
+export function normalizeId(value, label) {
+    const normalized = value.trim();
+    if (normalized === '') {
+        throw new Error(`${label} is required`);
+    }
+    return normalized;
+}
+export function normalizeTimestamp(value) {
+    if (!Number.isFinite(value)) {
+        throw new Error('input event timestamp must be finite');
+    }
+    return value;
+}
+export function normalizePositiveDuration(value, fallback) {
+    if (value == null)
+        return fallback;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error('input gesture doubleTapMs must be a positive finite number');
+    }
+    return value;
+}
+export function freezePlain(value) {
+    return Object.freeze(value);
+}
+//# sourceMappingURL=input-map.part03.js.map

package/dist/input-map.part03.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-map.part03.js","sourceRoot":"","sources":["../src/input-map.part03.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO;QACL,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACtB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACpB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACxB,GAAG,CAAC,GAAG;KACR,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,KAAa;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,yBAAyB,CACvC,KAAyB,EACzB,QAAgB;IAEhB,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,WAAW,CAAmB,KAAQ;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/input-map.part04.d.ts

@@ -0,0 +1,3 @@
+import type { InputEvent, InputFeatureEventPattern } from './input-map.part01.js';
+export declare function inputEventMatches(event: InputEvent, patterns: readonly InputFeatureEventPattern[]): boolean;
+//# sourceMappingURL=input-map.part04.d.ts.map

package/dist/input-map.part04.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-map.part04.d.ts","sourceRoot":"","sources":["../src/input-map.part04.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAE/B,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,OAAO,CAUT"}

package/dist/input-map.part04.js

@@ -0,0 +1,7 @@
+export function inputEventMatches(event, patterns) {
+    return patterns.every((pattern) => event.featureEvents.some((featureEvent) => featureEvent.type === pattern.type &&
+        featureEvent.feature.id === pattern.featureId &&
+        (pattern.deviceId == null ||
+            featureEvent.feature.deviceId === pattern.deviceId)));
+}
+//# sourceMappingURL=input-map.part04.js.map

package/dist/input-map.part04.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-map.part04.js","sourceRoot":"","sources":["../src/input-map.part04.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,iBAAiB,CAC/B,KAAiB,EACjB,QAA6C;IAE7C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAChC,KAAK,CAAC,aAAa,CAAC,IAAI,CACtB,CAAC,YAAY,EAAE,EAAE,CACf,YAAY,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI;QAClC,YAAY,CAAC,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,SAAS;QAC7C,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI;YACvB,YAAY,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CACxD,CACF,CAAC;AACJ,CAAC"}

package/dist/inputstack-types.d.ts

@@ -0,0 +1,86 @@
+/** Type contracts for stack-based input dispatch. */
+/**
+ * Anything that can handle an input message and optionally return an action.
+ *
+ * Return `undefined` to indicate "not handled" (pass through).
+ * {@link KeyMap}.handle() already satisfies this interface.
+ *
+ * @template Msg - Input message type.
+ * @template A - Action type returned on match.
+ */
+export interface InputHandler<Msg, A> {
+    /**
+     * Attempt to handle the given message.
+     *
+     * @param msg - Input message to handle.
+     * @returns The matched action, or `undefined` if not handled.
+     */
+    handle(msg: Msg): A | undefined;
+}
+/** Configuration options when pushing a layer onto the stack. */
+export interface LayerOptions {
+    /**
+     * When true, unhandled events pass through to layers below even
+     * when this layer is on top. When false (default), the layer is
+     * opaque — events that reach it but aren't handled are swallowed.
+     */
+    passthrough?: boolean;
+    /** Optional name for debugging and removal by name. */
+    name?: string;
+}
+/** Read-only snapshot of a layer's metadata. */
+export interface LayerInfo {
+    /** Unique identifier assigned when the layer was pushed. */
+    readonly id: number;
+    /** Layer name (empty string if unnamed). */
+    readonly name: string;
+    /** Whether unhandled events pass through to layers below. */
+    readonly passthrough: boolean;
+}
+/**
+ * Stack-based input dispatcher for layered TUI input handling.
+ *
+ * @template Msg - Input message type dispatched through the stack.
+ * @template A - Action type returned when a handler matches.
+ */
+export interface InputStack<Msg, A> {
+    /**
+     * Push a handler onto the top of the stack.
+     * Returns a unique layer ID for targeted removal.
+     */
+    push(handler: InputHandler<Msg, A>, options?: LayerOptions): number;
+    /** Remove and return the top layer. Returns undefined if empty. */
+    pop(): LayerInfo | undefined;
+    /** Remove a specific layer by ID. Returns true if found. */
+    remove(id: number): boolean;
+    /**
+     * Dispatch a message through the stack, top-down.
+     *
+     * - If a layer's handler returns an action, dispatch returns it immediately.
+     * - If a layer's handler returns undefined:
+     *   - passthrough layer: continue to the next layer
+     *   - opaque layer: stop, return undefined (event swallowed)
+     */
+    dispatch(msg: Msg): A | undefined;
+    /** Return info about all layers, bottom to top. */
+    layers(): readonly LayerInfo[];
+    /** Number of layers in the stack. */
+    readonly size: number;
+}
+/**
+ * Internal layer entry stored in the stack.
+ *
+ * @template Msg - Input message type.
+ * @template A - Action type returned on match.
+ */
+export interface Layer<Msg, A> {
+    /** Unique identifier assigned at push time. */
+    readonly id: number;
+    /** Handler that processes input messages for this layer. */
+    readonly handler: InputHandler<Msg, A>;
+    /** Whether unhandled events pass through to layers below. */
+    readonly passthrough: boolean;
+    /** Layer name for debugging (empty string if unnamed). */
+    readonly name: string;
+}
+//# sourceMappingURL=inputstack-types.d.ts.map

package/dist/inputstack-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputstack-types.d.ts","sourceRoot":"","sources":["../src/inputstack-types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY,CAAC,GAAG,EAAE,CAAC;IAClC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;CACjC;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU,CAAC,GAAG,EAAE,CAAC;IAChC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAEpE,mEAAmE;IACnE,GAAG,IAAI,SAAS,GAAG,SAAS,CAAC;IAE7B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;IAElC,mDAAmD;IACnD,MAAM,IAAI,SAAS,SAAS,EAAE,CAAC;IAE/B,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,KAAK,CAAC,GAAG,EAAE,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/inputstack-types.js

@@ -0,0 +1,3 @@
+/** Type contracts for stack-based input dispatch. */
+export {};
+//# sourceMappingURL=inputstack-types.js.map

package/dist/inputstack-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputstack-types.js","sourceRoot":"","sources":["../src/inputstack-types.ts"],"names":[],"mappings":"AAAA,qDAAqD"}

package/dist/inputstack.d.ts

@@ -33,65 +33,7 @@
  * @template Msg - Input message type.
  * @template A - Action type returned on match.
  */
-export interface InputHandler<Msg, A> {
-    /**
-     * Attempt to handle the given message.
-     *
-     * @param msg - Input message to handle.
-     * @returns The matched action, or `undefined` if not handled.
-     */
-    handle(msg: Msg): A | undefined;
-}
-/** Configuration options when pushing a layer onto the stack. */
-export interface LayerOptions {
-    /**
-     * When true, unhandled events pass through to layers below even
-     * when this layer is on top. When false (default), the layer is
-     * opaque — events that reach it but aren't handled are swallowed.
-     */
-    passthrough?: boolean;
-    /** Optional name for debugging and removal by name. */
-    name?: string;
-}
-/** Read-only snapshot of a layer's metadata. */
-export interface LayerInfo {
-    /** Unique identifier assigned when the layer was pushed. */
-    readonly id: number;
-    /** Layer name (empty string if unnamed). */
-    readonly name: string;
-    /** Whether unhandled events pass through to layers below. */
-    readonly passthrough: boolean;
-}
-/**
- * Stack-based input dispatcher for layered TUI input handling.
- *
- * @template Msg - Input message type dispatched through the stack.
- * @template A - Action type returned when a handler matches.
- */
-export interface InputStack<Msg, A> {
-    /**
-     * Push a handler onto the top of the stack.
-     * Returns a unique layer ID for targeted removal.
-     */
-    push(handler: InputHandler<Msg, A>, options?: LayerOptions): number;
-    /** Remove and return the top layer. Returns undefined if empty. */
-    pop(): LayerInfo | undefined;
-    /** Remove a specific layer by ID. Returns true if found. */
-    remove(id: number): boolean;
-    /**
-     * Dispatch a message through the stack, top-down.
-     *
-     * - If a layer's handler returns an action, dispatch returns it immediately.
-     * - If a layer's handler returns undefined:
-     *   - passthrough layer: continue to the next layer
-     *   - opaque layer: stop, return undefined (event swallowed)
-     */
-    dispatch(msg: Msg): A | undefined;
-    /** Return info about all layers, bottom to top. */
-    layers(): readonly LayerInfo[];
-    /** Number of layers in the stack. */
-    readonly size: number;
-}
+import type { InputStack } from './inputstack-types.js';
 /**
  * Create a new empty input stack.
  *
@@ -104,4 +46,5 @@ export interface InputStack<Msg, A> {
  * @returns A new empty input stack.
  */
 export declare function createInputStack<Msg, A>(): InputStack<Msg, A>;
+export type { InputHandler, LayerOptions, LayerInfo, InputStack, } from './inputstack-types.js';
 //# sourceMappingURL=inputstack.d.ts.map