@slowclap/rezi-core 0.1.0-fork.1

package/dist/keybindings/manager.js

@@ -0,0 +1,448 @@
+/**
+ * packages/core/src/keybindings/manager.ts — Keybinding registry and event routing.
+ *
+ * Why: Central manager for registering keybindings, handling mode switching,
+ * and routing key events through the binding system. Provides the main API
+ * for the app runtime to integrate keybindings.
+ *
+ * @see docs/guide/input-and-focus.md
+ */
+const NODE_ENV = globalThis.process?.env?.NODE_ENV ??
+    "development";
+const DEV_MODE = NODE_ENV !== "production";
+function warnDev(message) {
+    if (!DEV_MODE)
+        return;
+    const c = globalThis.console;
+    c?.warn?.(message);
+}
+import { CHORD_TIMEOUT_MS, INITIAL_CHORD_STATE, buildTrie, matchKey, resetChordState, } from "./chordMatcher.js";
+import { modsFromBitmask } from "./keyCodes.js";
+import { keyToString, keysEqual, parseKeySequence, sequenceToString } from "./parser.js";
+/** Default mode name. */
+export const DEFAULT_MODE = "default";
+/**
+ * Create initial manager state with empty default mode.
+ *
+ * @returns Fresh manager state
+ */
+export function createManagerState() {
+    const defaultMode = Object.freeze({
+        name: DEFAULT_MODE,
+        bindings: Object.freeze([]),
+        trie: buildTrie([]),
+    });
+    return Object.freeze({
+        currentMode: DEFAULT_MODE,
+        chordState: INITIAL_CHORD_STATE,
+        modes: new Map([[DEFAULT_MODE, defaultMode]]),
+    });
+}
+/**
+ * Parse binding definitions into KeyBinding array.
+ * Returns both valid bindings and any invalid keys that were skipped.
+ */
+function parseBindings(map) {
+    const bindings = [];
+    const invalidKeys = [];
+    for (const [keyStr, def] of Object.entries(map)) {
+        const parsed = parseKeySequence(keyStr);
+        if (!parsed.ok) {
+            invalidKeys.push({ key: keyStr, detail: parsed.error.detail });
+            continue;
+        }
+        let handler;
+        let priority = 0;
+        let when;
+        let description;
+        if (typeof def === "function") {
+            handler = def;
+        }
+        else {
+            handler = def.handler;
+            priority = def.priority ?? 0;
+            when = def.when;
+            description = def.description;
+        }
+        const binding = when !== undefined && description !== undefined
+            ? Object.freeze({
+                sequence: parsed.value,
+                priority,
+                handler,
+                when,
+                description,
+            })
+            : when !== undefined
+                ? Object.freeze({ sequence: parsed.value, priority, handler, when })
+                : description !== undefined
+                    ? Object.freeze({
+                        sequence: parsed.value,
+                        priority,
+                        handler,
+                        description,
+                    })
+                    : Object.freeze({ sequence: parsed.value, priority, handler });
+        bindings.push(binding);
+    }
+    return Object.freeze({
+        bindings: Object.freeze(bindings),
+        invalidKeys: Object.freeze(invalidKeys),
+    });
+}
+function parseBindingsWithOptions(map, options) {
+    const parsed = parseBindings(map);
+    const sourceTag = options?.sourceTag;
+    if (sourceTag === undefined)
+        return parsed;
+    const bindings = [];
+    for (const binding of parsed.bindings) {
+        bindings.push(Object.freeze({
+            ...binding,
+            sourceTag,
+        }));
+    }
+    return Object.freeze({
+        bindings: Object.freeze(bindings),
+        invalidKeys: parsed.invalidKeys,
+    });
+}
+function keySequencesEqual(a, b) {
+    if (a.keys.length !== b.keys.length)
+        return false;
+    for (let i = 0; i < a.keys.length; i++) {
+        const aKey = a.keys[i];
+        const bKey = b.keys[i];
+        if (!aKey || !bKey || !keysEqual(aKey, bKey))
+            return false;
+    }
+    return true;
+}
+function mergeBindingsReplacingSequences(existing, incoming) {
+    const merged = [...existing];
+    for (const next of incoming) {
+        for (let i = merged.length - 1; i >= 0; i--) {
+            const current = merged[i];
+            if (current && keySequencesEqual(current.sequence, next.sequence)) {
+                if (DEV_MODE) {
+                    warnDev(`[rezi] keybinding "${sequenceToString(next.sequence)}" registered multiple times, later definition wins`);
+                }
+                merged.splice(i, 1);
+            }
+        }
+        merged.push(next);
+    }
+    return merged;
+}
+/**
+ * Register keybindings in the manager.
+ *
+ * Bindings are added to the specified mode (default mode if not specified).
+ * If the mode doesn't exist, it is created.
+ *
+ * @param state - Current manager state
+ * @param bindings - Binding map (key string -> handler)
+ * @param options - Registration options
+ * @returns New manager state with bindings registered and any invalid keys
+ */
+export function registerBindings(state, bindings, options) {
+    const modeName = options?.mode ?? DEFAULT_MODE;
+    const parsed = parseBindingsWithOptions(bindings, options);
+    const existingMode = state.modes.get(modeName);
+    const existingBindings = existingMode?.bindings ?? [];
+    // Merge bindings while replacing existing entries for the same key sequence.
+    const mergedBindings = mergeBindingsReplacingSequences(existingBindings, parsed.bindings);
+    const mergedTrie = buildTrie(mergedBindings);
+    const parentName = existingMode?.parent;
+    const newMode = parentName
+        ? Object.freeze({
+            name: modeName,
+            bindings: Object.freeze(mergedBindings),
+            parent: parentName,
+            trie: mergedTrie,
+        })
+        : Object.freeze({
+            name: modeName,
+            bindings: Object.freeze(mergedBindings),
+            trie: mergedTrie,
+        });
+    const newModes = new Map(state.modes);
+    newModes.set(modeName, newMode);
+    return Object.freeze({
+        state: Object.freeze({
+            ...state,
+            modes: newModes,
+        }),
+        invalidKeys: parsed.invalidKeys,
+    });
+}
+function isModeWithParent(v) {
+    return typeof v === "object" && v !== null && "bindings" in v;
+}
+/**
+ * Register multiple modes with their bindings.
+ *
+ * @param state - Current manager state
+ * @param modes - Map of mode names to binding maps
+ * @returns New manager state with modes registered and any invalid keys
+ */
+export function registerModes(state, modes) {
+    let newState = state;
+    const allInvalidKeys = [];
+    for (const [modeName, modeDef] of Object.entries(modes)) {
+        let bindingMap;
+        let parent;
+        if (isModeWithParent(modeDef)) {
+            bindingMap = modeDef.bindings;
+            parent = modeDef.parent;
+        }
+        else {
+            bindingMap = modeDef;
+        }
+        const parsed = parseBindings(bindingMap);
+        for (const inv of parsed.invalidKeys) {
+            allInvalidKeys.push(inv);
+        }
+        const existingMode = newState.modes.get(modeName);
+        const existingBindings = existingMode?.bindings ?? [];
+        const mergedBindings = mergeBindingsReplacingSequences(existingBindings, parsed.bindings);
+        const mergedTrie = buildTrie(mergedBindings);
+        const parentName = parent ?? existingMode?.parent;
+        const newMode = parentName
+            ? Object.freeze({
+                name: modeName,
+                bindings: Object.freeze(mergedBindings),
+                parent: parentName,
+                trie: mergedTrie,
+            })
+            : Object.freeze({
+                name: modeName,
+                bindings: Object.freeze(mergedBindings),
+                trie: mergedTrie,
+            });
+        const newModes = new Map(newState.modes);
+        newModes.set(modeName, newMode);
+        newState = Object.freeze({
+            ...newState,
+            modes: newModes,
+        });
+    }
+    validateModeGraph(newState.modes);
+    return Object.freeze({
+        state: newState,
+        invalidKeys: Object.freeze(allInvalidKeys),
+    });
+}
+function validateModeGraph(modes) {
+    for (const [modeName, mode] of modes) {
+        if (mode.parent === undefined)
+            continue;
+        if (!modes.has(mode.parent)) {
+            throw new Error(`unknown parent mode "${mode.parent}" for mode "${modeName}" (register the parent first or in the same app.modes() call)`);
+        }
+    }
+}
+/**
+ * Switch to a different mode.
+ *
+ * Resets chord state when switching modes.
+ *
+ * @param state - Current manager state
+ * @param modeName - Name of the mode to switch to
+ * @returns New manager state with mode switched
+ */
+export function setMode(state, modeName) {
+    if (state.currentMode === modeName)
+        return state;
+    // Mode names must be registered up front.
+    if (!state.modes.has(modeName)) {
+        throw new Error(`unknown keybinding mode "${modeName}" (register it first via app.modes() or registerBindings(..., { mode }))`);
+    }
+    return Object.freeze({
+        ...state,
+        currentMode: modeName,
+        chordState: resetChordState(),
+        modes: state.modes,
+    });
+}
+/**
+ * Get the current mode name.
+ *
+ * @param state - Manager state
+ * @returns Current mode name
+ */
+export function getMode(state) {
+    return state.currentMode;
+}
+/**
+ * Get registered keybindings as user-facing sequence strings.
+ *
+ * @param state - Manager state
+ * @param mode - Optional mode name to filter by
+ * @returns Bindings in registration order (grouped by mode insertion order)
+ */
+export function getBindings(state, mode) {
+    const out = [];
+    if (mode !== undefined) {
+        const compiled = state.modes.get(mode);
+        if (!compiled)
+            return Object.freeze(out);
+        for (const binding of compiled.bindings) {
+            out.push(binding.description === undefined
+                ? Object.freeze({
+                    sequence: sequenceToString(binding.sequence),
+                    mode,
+                })
+                : Object.freeze({
+                    sequence: sequenceToString(binding.sequence),
+                    description: binding.description,
+                    mode,
+                }));
+        }
+        return Object.freeze(out);
+    }
+    for (const [modeName, compiled] of state.modes) {
+        for (const binding of compiled.bindings) {
+            out.push(binding.description === undefined
+                ? Object.freeze({
+                    sequence: sequenceToString(binding.sequence),
+                    mode: modeName,
+                })
+                : Object.freeze({
+                    sequence: sequenceToString(binding.sequence),
+                    description: binding.description,
+                    mode: modeName,
+                }));
+        }
+    }
+    return Object.freeze(out);
+}
+export function removeBindingsBySource(state, sourceTag, options) {
+    const modeName = options?.mode;
+    let didChange = false;
+    const nextModes = new Map();
+    for (const [currentModeName, compiled] of state.modes) {
+        if (modeName !== undefined && currentModeName !== modeName) {
+            nextModes.set(currentModeName, compiled);
+            continue;
+        }
+        const filteredBindings = compiled.bindings.filter((binding) => binding.sourceTag !== sourceTag);
+        if (filteredBindings.length === compiled.bindings.length) {
+            nextModes.set(currentModeName, compiled);
+            continue;
+        }
+        didChange = true;
+        nextModes.set(currentModeName, compiled.parent !== undefined
+            ? Object.freeze({
+                name: compiled.name,
+                parent: compiled.parent,
+                bindings: Object.freeze(filteredBindings),
+                trie: buildTrie(filteredBindings),
+            })
+            : Object.freeze({
+                name: compiled.name,
+                bindings: Object.freeze(filteredBindings),
+                trie: buildTrie(filteredBindings),
+            }));
+    }
+    if (!didChange)
+        return state;
+    return Object.freeze({
+        ...state,
+        modes: nextModes,
+    });
+}
+/**
+ * Get pending chord as a sequence string, or null when idle.
+ */
+export function getPendingChord(state) {
+    const pendingKeys = state.chordState.pendingKeys;
+    if (pendingKeys.length === 0)
+        return null;
+    return pendingKeys.map((key) => keyToString(key)).join(" ");
+}
+/**
+ * Try to match a key in a mode and its parents.
+ */
+function matchInModeChain(state, key, timeMs, context) {
+    let modeName = state.currentMode;
+    const visited = new Set();
+    while (modeName !== undefined) {
+        if (visited.has(modeName))
+            break; // Prevent infinite loops
+        visited.add(modeName);
+        const mode = state.modes.get(modeName);
+        if (!mode)
+            break;
+        const matchResult = matchKey(mode.trie, state.chordState, key, timeMs);
+        if (matchResult.result.kind === "matched") {
+            const binding = matchResult.result.binding;
+            // Check when condition
+            if (binding.when && !binding.when(context)) {
+                // Condition failed, continue to parent
+                modeName = mode.parent;
+                continue;
+            }
+            return {
+                nextChordState: matchResult.nextState,
+                result: matchResult.result,
+            };
+        }
+        if (matchResult.result.kind === "pending") {
+            return {
+                nextChordState: matchResult.nextState,
+                result: matchResult.result,
+            };
+        }
+        // No match in this mode, try parent
+        modeName = mode.parent;
+    }
+    return {
+        nextChordState: resetChordState(),
+        result: Object.freeze({ kind: "none" }),
+    };
+}
+/**
+ * Route a key event through the keybinding system.
+ *
+ * Only processes "key" events with "down" action.
+ * Returns consumed=true if the key matched a binding or is pending for a chord.
+ *
+ * @param state - Current manager state
+ * @param event - Engine event from ZREV
+ * @param context - Context to pass to handlers
+ * @returns New state and consumed flag
+ */
+export function routeKeyEvent(state, event, context) {
+    // Only handle key down events
+    if (event.kind !== "key" || event.action !== "down") {
+        return { nextState: state, consumed: false };
+    }
+    // Convert event to ParsedKey
+    const key = { key: event.key, mods: modsFromBitmask(event.mods) };
+    // Match in current mode chain
+    const { nextChordState, result } = matchInModeChain(state, key, event.timeMs, context);
+    const nextState = Object.freeze({
+        ...state,
+        chordState: nextChordState,
+    });
+    if (result.kind === "matched") {
+        // Execute handler
+        try {
+            result.binding.handler(context);
+        }
+        catch (e) {
+            // Return error to caller instead of logging
+            return { nextState, consumed: true, handlerError: e };
+        }
+        return { nextState, consumed: true };
+    }
+    if (result.kind === "pending") {
+        // Chord in progress, consume the key
+        return { nextState, consumed: true };
+    }
+    // No match
+    return { nextState, consumed: false };
+}
+// Re-export for convenience
+export { CHORD_TIMEOUT_MS };
+//# sourceMappingURL=manager.js.map

package/dist/keybindings/manager.js.map

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

package/dist/keybindings/parser.d.ts

@@ -0,0 +1,71 @@
+/**
+ * packages/core/src/keybindings/parser.ts — Parse keybinding strings to KeySequence.
+ *
+ * Why: Converts human-readable keybinding strings like "ctrl+s" or "g g" into
+ * structured KeySequence objects that can be used for matching. Handles single
+ * keys, modifier combinations, and chord sequences.
+ *
+ * Format examples:
+ *   - Single key: "a", "escape", "f1"
+ *   - With modifiers: "ctrl+s", "shift+a", "ctrl+shift+z"
+ *   - Chords (space-separated): "g g", "ctrl+k ctrl+c"
+ *
+ * @see docs/guide/input-and-focus.md
+ */
+import type { KeySequence, ParseKeyResult, ParsedKey } from "./types.js";
+/**
+ * Parse a keybinding string into a KeySequence.
+ *
+ * Supports:
+ *   - Single keys: "a", "escape", "f1"
+ *   - With modifiers: "ctrl+s", "shift+a", "ctrl+shift+z"
+ *   - Chord sequences (space-separated): "g g", "ctrl+k ctrl+c"
+ *
+ * Modifier names (case-insensitive):
+ *   - shift
+ *   - ctrl, control
+ *   - alt
+ *   - meta, cmd, command, win, super
+ *
+ * Key names (case-insensitive):
+ *   - Single letters: a-z
+ *   - Digits: 0-9
+ *   - Named keys: escape, enter, tab, backspace, space, etc.
+ *   - Function keys: f1-f12
+ *   - Navigation: up, down, left, right, home, end, pageup, pagedown
+ *   - Editing: insert, delete
+ *
+ * @param input - Keybinding string to parse
+ * @returns ParseKeyResult with KeySequence or error
+ *
+ * @example
+ * ```ts
+ * parseKeySequence("ctrl+s")      // Single key with modifier
+ * parseKeySequence("g g")         // Two-key chord
+ * parseKeySequence("ctrl+k ctrl+c") // Chord with modifiers
+ * ```
+ */
+export declare function parseKeySequence(input: string): ParseKeyResult;
+/**
+ * Check if two ParsedKey objects are equal.
+ *
+ * @param a - First key
+ * @param b - Second key
+ * @returns True if keys and modifiers match
+ */
+export declare function keysEqual(a: ParsedKey, b: ParsedKey): boolean;
+/**
+ * Convert a ParsedKey to a human-readable string (for debugging).
+ *
+ * @param key - ParsedKey to stringify
+ * @returns String representation like "ctrl+a" or "escape"
+ */
+export declare function keyToString(key: ParsedKey): string;
+/**
+ * Convert a KeySequence to a human-readable string (for debugging).
+ *
+ * @param seq - KeySequence to stringify
+ * @returns String representation like "g g" or "ctrl+k ctrl+c"
+ */
+export declare function sequenceToString(seq: KeySequence): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/keybindings/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/keybindings/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAiB,WAAW,EAAa,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmKnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CA2C9D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CA+BlD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAEzD"}