@tooee/commands 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @tooee/commands
+
+Vim-inspired modal command system for Tooee.
+
+Part of the [Tooee](https://github.com/gingerhendrix/tooee) monorepo. See the main repo for documentation.

package/dist/context.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from "react";
+import type { Command, CommandContext, CommandRegistry } from "./types.js";
+import type { Mode } from "./mode.jsx";
+type ContextGetter = () => Partial<CommandContext>;
+interface CommandContextValue {
+    registry: CommandRegistry;
+    leaderKey?: string;
+    contextSources: Map<string, ContextGetter>;
+}
+declare const CommandContext: import("react").Context<CommandContextValue | null>;
+export interface CommandProviderProps {
+    children: ReactNode;
+    leader?: string;
+    keymap?: Record<string, string>;
+    initialMode?: Mode;
+}
+export declare function CommandProvider({ children, leader, keymap, initialMode }: CommandProviderProps): ReactNode;
+export declare function useCommandContext(): {
+    commands: Command[];
+    invoke: (id: string) => void;
+};
+export declare function useCommandRegistry(): CommandContextValue;
+export declare function useProvideCommandContext(getter: () => Partial<CommandContext>): void;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjG,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,YAAY,CAAA;AACxF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAQtC,KAAK,aAAa,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAA;AAElD,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,eAAe,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAC3C;AAED,QAAA,MAAM,cAAc,qDAAkD,CAAA;AAEtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,WAAW,CAAC,EAAE,IAAI,CAAA;CACnB;AAED,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,oBAAoB,aAQ9F;AAwID,wBAAgB,iBAAiB,IAAI;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAazF;AAED,wBAAgB,kBAAkB,IAAI,mBAAmB,CAMxD;AAID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAuBpF"}

package/dist/context.js

@@ -0,0 +1,161 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { createContext, useContext, useRef, useCallback, useEffect } from "react";
+import { useKeyboard } from "@opentui/react";
+import { ModeProvider, useMode, useSetMode } from "./mode.jsx";
+import { parseHotkey } from "./parse.js";
+import { matchStep } from "./match.js";
+import { SequenceTracker } from "./sequence.js";
+const DEFAULT_MODES = ["cursor"];
+const CommandContext = createContext(null);
+export function CommandProvider({ children, leader, keymap, initialMode }) {
+    return (_jsx(ModeProvider, { initialMode: initialMode, children: _jsx(CommandDispatcher, { leader: leader, keymap: keymap, children: children }) }));
+}
+function CommandDispatcher({ children, leader, keymap, }) {
+    const registryRef = useRef(null);
+    const contextSourcesRef = useRef(new Map());
+    const mode = useMode();
+    const modeRef = useRef(mode);
+    modeRef.current = mode;
+    const setMode = useSetMode();
+    const buildCtx = useCallback(() => {
+        const ctx = {
+            mode: modeRef.current,
+            setMode,
+            commands: {
+                invoke: (id) => registryRef.current?.invoke(id),
+                list: () => Array.from(registryRef.current?.commands.values() ?? []),
+            },
+            exit: () => { },
+        };
+        for (const getter of contextSourcesRef.current.values()) {
+            Object.assign(ctx, getter());
+        }
+        return ctx;
+    }, [setMode]);
+    if (registryRef.current === null) {
+        const commands = new Map();
+        registryRef.current = {
+            commands,
+            register(command) {
+                commands.set(command.id, command);
+                return () => {
+                    commands.delete(command.id);
+                };
+            },
+            invoke(id) {
+                const ctx = buildCtx();
+                const cmd = commands.get(id);
+                if (cmd && (!cmd.when || cmd.when(ctx))) {
+                    cmd.handler(ctx);
+                }
+            },
+        };
+    }
+    const trackerRef = useRef(new SequenceTracker());
+    const parseCacheRef = useRef(new Map());
+    const getParsedHotkey = useCallback((hotkey) => {
+        const cache = parseCacheRef.current;
+        const cacheKey = `${hotkey}:${leader ?? ""}`;
+        let parsed = cache.get(cacheKey);
+        if (!parsed) {
+            parsed = parseHotkey(hotkey, leader);
+            cache.set(cacheKey, parsed);
+        }
+        return parsed;
+    }, [leader]);
+    useKeyboard((event) => {
+        if (event.defaultPrevented)
+            return;
+        const registry = registryRef.current;
+        if (!registry)
+            return;
+        const currentMode = mode;
+        const ctx = buildCtx();
+        // Collect eligible commands with their parsed hotkeys
+        const singleStepCandidates = [];
+        const multiStepHotkeys = [];
+        const multiStepCommands = [];
+        for (const command of registry.commands.values()) {
+            const commandModes = command.modes ?? DEFAULT_MODES;
+            if (!commandModes.includes(currentMode))
+                continue;
+            if (command.when && !command.when(ctx))
+                continue;
+            const hotkey = keymap?.[command.id] ?? command.defaultHotkey;
+            if (!hotkey)
+                continue;
+            const parsed = getParsedHotkey(hotkey);
+            if (parsed.steps.length === 1) {
+                singleStepCandidates.push({ command, parsed });
+            }
+            else {
+                multiStepHotkeys.push(parsed);
+                multiStepCommands.push(command);
+            }
+        }
+        // Check multi-step sequences first (they consume buffer state)
+        if (multiStepHotkeys.length > 0) {
+            const idx = trackerRef.current.feed(event, multiStepHotkeys);
+            if (idx >= 0) {
+                event.preventDefault();
+                multiStepCommands[idx].handler(ctx);
+                return;
+            }
+        }
+        // Check single-step matches
+        for (const { command, parsed } of singleStepCandidates) {
+            if (matchStep(event, parsed.steps[0])) {
+                event.preventDefault();
+                command.handler(ctx);
+                return;
+            }
+        }
+    });
+    return (_jsx(CommandContext.Provider, { value: {
+            registry: registryRef.current,
+            leaderKey: leader,
+            contextSources: contextSourcesRef.current,
+        }, children: children }));
+}
+export function useCommandContext() {
+    const ctx = useContext(CommandContext);
+    if (!ctx) {
+        throw new Error("useCommandContext must be used within a CommandProvider");
+    }
+    const { registry } = ctx;
+    return {
+        get commands() {
+            return Array.from(registry.commands.values());
+        },
+        invoke: registry.invoke,
+    };
+}
+export function useCommandRegistry() {
+    const ctx = useContext(CommandContext);
+    if (!ctx) {
+        throw new Error("useCommandRegistry must be used within a CommandProvider");
+    }
+    return ctx;
+}
+let nextContextSourceId = 0;
+export function useProvideCommandContext(getter) {
+    const ctx = useContext(CommandContext);
+    if (!ctx) {
+        throw new Error("useProvideCommandContext must be used within a CommandProvider");
+    }
+    const idRef = useRef(null);
+    if (idRef.current === null) {
+        idRef.current = `ctx-${nextContextSourceId++}`;
+    }
+    const getterRef = useRef(getter);
+    getterRef.current = getter;
+    const { contextSources } = ctx;
+    useEffect(() => {
+        const id = idRef.current;
+        contextSources.set(id, () => getterRef.current());
+        return () => {
+            contextSources.delete(id);
+        };
+    }, [contextSources]);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export type { Command, CommandContext, CommandContextBase, CommandHandler, CommandWhen, ParsedHotkey, ParsedStep, } from "./types.js";
+export type { Mode } from "./mode.jsx";
+export { ModeProvider, useMode, useSetMode } from "./mode.jsx";
+export type { ModeProviderProps } from "./mode.jsx";
+export { parseHotkey } from "./parse.js";
+export { matchStep } from "./match.js";
+export { SequenceTracker } from "./sequence.js";
+export type { SequenceTrackerOptions } from "./sequence.js";
+export { CommandProvider, useCommandContext, useProvideCommandContext } from "./context.jsx";
+export type { CommandProviderProps } from "./context.jsx";
+export { useCommand } from "./use-command.js";
+export type { UseCommandOptions } from "./use-command.js";
+export { useActions } from "./use-actions.js";
+export type { ActionDefinition } from "./use-actions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAC5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { ModeProvider, useMode, useSetMode } from "./mode.jsx";
+export { parseHotkey } from "./parse.js";
+export { matchStep } from "./match.js";
+export { SequenceTracker } from "./sequence.js";
+export { CommandProvider, useCommandContext, useProvideCommandContext } from "./context.jsx";
+export { useCommand } from "./use-command.js";
+export { useActions } from "./use-actions.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":"AAUA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAE5F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/match.d.ts

@@ -0,0 +1,7 @@
+import type { KeyEvent } from "@opentui/core";
+import type { ParsedStep } from "./types.js";
+/**
+ * Check if a KeyEvent matches a ParsedStep.
+ */
+export declare function matchStep(event: KeyEvent, step: ParsedStep): boolean;
+//# sourceMappingURL=match.d.ts.map

package/dist/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAOpE"}

package/dist/match.js

@@ -0,0 +1,17 @@
+/**
+ * Check if a KeyEvent matches a ParsedStep.
+ */
+export function matchStep(event, step) {
+    if (event.name !== step.key)
+        return false;
+    if (event.ctrl !== step.ctrl)
+        return false;
+    if (event.meta !== step.meta)
+        return false;
+    if (event.shift !== step.shift)
+        return false;
+    if (event.option !== step.option)
+        return false;
+    return true;
+}
+//# sourceMappingURL=match.js.map

package/dist/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAe,EAAE,IAAgB;IACzD,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAA;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAC1C,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAC9C,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/mode.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from "react";
+export type Mode = "cursor" | "insert" | "select";
+export interface ModeProviderProps {
+    children: ReactNode;
+    initialMode?: Mode;
+}
+export declare function ModeProvider({ children, initialMode }: ModeProviderProps): ReactNode;
+export declare function useMode(): Mode;
+export declare function useSetMode(): (mode: Mode) => void;
+//# sourceMappingURL=mode.d.ts.map

package/dist/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../src/mode.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAExF,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AASjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,CAAA;IACnB,WAAW,CAAC,EAAE,IAAI,CAAA;CACnB;AAED,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,WAAsB,EAAE,EAAE,iBAAiB,aAKnF;AAED,wBAAgB,OAAO,IAAI,IAAI,CAM9B;AAED,wBAAgB,UAAU,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAMjD"}

package/dist/mode.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { createContext, useContext, useState, useCallback } from "react";
+const ModeContext = createContext(null);
+export function ModeProvider({ children, initialMode = "cursor" }) {
+    const [mode, setModeState] = useState(initialMode);
+    const setMode = useCallback((m) => setModeState(m), []);
+    return _jsx(ModeContext.Provider, { value: { mode, setMode }, children: children });
+}
+export function useMode() {
+    const ctx = useContext(ModeContext);
+    if (!ctx) {
+        throw new Error("useMode must be used within a ModeProvider");
+    }
+    return ctx.mode;
+}
+export function useSetMode() {
+    const ctx = useContext(ModeContext);
+    if (!ctx) {
+        throw new Error("useSetMode must be used within a ModeProvider");
+    }
+    return ctx.setMode;
+}
+//# sourceMappingURL=mode.js.map

package/dist/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAkB,MAAM,OAAO,CAAA;AASxF,MAAM,WAAW,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAA;AAOhE,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,WAAW,GAAG,QAAQ,EAAqB;IAClF,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAO,WAAW,CAAC,CAAA;IACxD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAO,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAE7D,OAAO,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,YAAG,QAAQ,GAAwB,CAAA;AAC1F,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAA;AACpB,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedHotkey } from "./types.js";
+/**
+ * Parse a hotkey string into a ParsedHotkey.
+ *
+ * Supports:
+ * - Modifier combos: "ctrl+s", "ctrl+shift+p"
+ * - Sequences (space-separated): "g g", "d d"
+ * - Leader prefix: "<leader>n" expands to leaderKey + "n"
+ */
+export declare function parseHotkey(hotkey: string, leaderKey?: string): ParsedHotkey;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,YAAY,CAAA;AA6C1D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAiB5E"}

package/dist/parse.js

@@ -0,0 +1,68 @@
+const KEY_ALIASES = {
+    esc: "escape",
+    enter: "return",
+    cr: "return",
+    del: "delete",
+    space: " ",
+    tab: "tab",
+    backspace: "backspace",
+};
+function normalizeKey(key) {
+    const lower = key.toLowerCase();
+    return KEY_ALIASES[lower] ?? lower;
+}
+function parseStep(step) {
+    const parts = step.toLowerCase().split("+");
+    let key = "";
+    let ctrl = false;
+    let meta = false;
+    let shift = false;
+    let option = false;
+    for (const part of parts) {
+        const trimmed = part.trim();
+        if (trimmed === "ctrl" || trimmed === "control") {
+            ctrl = true;
+        }
+        else if (trimmed === "meta" || trimmed === "alt") {
+            meta = true;
+        }
+        else if (trimmed === "shift") {
+            shift = true;
+        }
+        else if (trimmed === "option") {
+            option = true;
+        }
+        else if (trimmed === "super") {
+            // super modifier — not tracked in ParsedStep currently
+        }
+        else {
+            key = normalizeKey(trimmed);
+        }
+    }
+    return { key, ctrl, meta, shift, option };
+}
+/**
+ * Parse a hotkey string into a ParsedHotkey.
+ *
+ * Supports:
+ * - Modifier combos: "ctrl+s", "ctrl+shift+p"
+ * - Sequences (space-separated): "g g", "d d"
+ * - Leader prefix: "<leader>n" expands to leaderKey + "n"
+ */
+export function parseHotkey(hotkey, leaderKey) {
+    const trimmed = hotkey.trim();
+    // Handle leader prefix
+    const leaderMatch = trimmed.match(/^<leader>(.+)$/);
+    if (leaderMatch) {
+        const leaderStep = leaderKey
+            ? parseStep(leaderKey)
+            : { key: "x", ctrl: true, meta: false, shift: false, option: false };
+        const followStep = parseStep(leaderMatch[1]);
+        return { steps: [leaderStep, followStep] };
+    }
+    // Space-separated = sequence
+    const parts = trimmed.split(/\s+/);
+    const steps = parts.map(parseStep);
+    return { steps };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,QAAQ;IACb,KAAK,EAAE,QAAQ;IACf,EAAE,EAAE,QAAQ;IACZ,GAAG,EAAE,QAAQ;IACb,KAAK,EAAE,GAAG;IACV,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;CACvB,CAAA;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAA;IAC/B,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAA;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC3C,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,IAAI,KAAK,GAAG,KAAK,CAAA;IACjB,IAAI,MAAM,GAAG,KAAK,CAAA;IAElB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAChD,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;aAAM,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACnD,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;aAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,KAAK,GAAG,IAAI,CAAA;QACd,CAAC;aAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,uDAAuD;QACzD,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,SAAkB;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAE7B,uBAAuB;IACvB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;IACnD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,SAAS;YAC1B,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC;YACtB,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;QACtE,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAA;QAC7C,OAAO,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAA;IAC5C,CAAC;IAED,6BAA6B;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAClC,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC"}

package/dist/sequence.d.ts

@@ -0,0 +1,21 @@
+import type { KeyEvent } from "@opentui/core";
+import type { ParsedHotkey } from "./types.js";
+export interface SequenceTrackerOptions {
+    timeout?: number;
+}
+export declare class SequenceTracker {
+    private buffer;
+    private timer;
+    private timeout;
+    constructor(options?: SequenceTrackerOptions);
+    /**
+     * Feed a key event and check against registered hotkeys.
+     * Returns the index of the matched hotkey, or -1 if no match.
+     */
+    feed(event: KeyEvent, hotkeys: ParsedHotkey[]): number;
+    private matchesBuffer;
+    reset(): void;
+    private resetTimer;
+    private clearTimer;
+}
+//# sourceMappingURL=sequence.d.ts.map

package/dist/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,OAAO,CAAQ;gBAEX,OAAO,CAAC,EAAE,sBAAsB;IAI5C;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM;IAqBtD,OAAO,CAAC,aAAa;IAWrB,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;CAMnB"}

package/dist/sequence.js

@@ -0,0 +1,56 @@
+import { matchStep } from "./match.js";
+export class SequenceTracker {
+    buffer = [];
+    timer = null;
+    timeout;
+    constructor(options) {
+        this.timeout = options?.timeout ?? 500;
+    }
+    /**
+     * Feed a key event and check against registered hotkeys.
+     * Returns the index of the matched hotkey, or -1 if no match.
+     */
+    feed(event, hotkeys) {
+        this.buffer.push(event);
+        this.resetTimer();
+        for (let i = 0; i < hotkeys.length; i++) {
+            const hotkey = hotkeys[i];
+            if (this.matchesBuffer(hotkey)) {
+                this.reset();
+                return i;
+            }
+        }
+        // Prune buffer if no hotkey could possibly match
+        const maxLen = Math.max(...hotkeys.map((h) => h.steps.length));
+        if (this.buffer.length > maxLen) {
+            this.buffer.shift();
+        }
+        return -1;
+    }
+    matchesBuffer(hotkey) {
+        const { steps } = hotkey;
+        if (this.buffer.length < steps.length)
+            return false;
+        const start = this.buffer.length - steps.length;
+        for (let i = 0; i < steps.length; i++) {
+            if (!matchStep(this.buffer[start + i], steps[i]))
+                return false;
+        }
+        return true;
+    }
+    reset() {
+        this.buffer = [];
+        this.clearTimer();
+    }
+    resetTimer() {
+        this.clearTimer();
+        this.timer = setTimeout(() => this.reset(), this.timeout);
+    }
+    clearTimer() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+}
+//# sourceMappingURL=sequence.js.map

package/dist/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAMtC,MAAM,OAAO,eAAe;IAClB,MAAM,GAAe,EAAE,CAAA;IACvB,KAAK,GAAyC,IAAI,CAAA;IAClD,OAAO,CAAQ;IAEvB,YAAY,OAAgC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,GAAG,CAAA;IACxC,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAe,EAAE,OAAuB;QAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,IAAI,CAAC,UAAU,EAAE,CAAA;QAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAA;YAC1B,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,KAAK,EAAE,CAAA;gBACZ,OAAO,CAAC,CAAA;YACV,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;QAC9D,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;QAED,OAAO,CAAC,CAAC,CAAA;IACX,CAAC;IAEO,aAAa,CAAC,MAAoB;QACxC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QAEnD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC;gBAAE,OAAO,KAAK,CAAA;QAClE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,CAAC,UAAU,EAAE,CAAA;IACnB,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+import type { Mode } from "./mode.jsx";
+export interface CommandContextBase {
+    mode: Mode;
+    setMode: (mode: Mode) => void;
+    commands: {
+        invoke: (id: string) => void;
+        list: () => Command[];
+    };
+    exit: () => void;
+}
+export interface CommandContext extends CommandContextBase {
+    [key: string]: any;
+}
+export type CommandHandler = (ctx: CommandContext) => void | Promise<void>;
+export type CommandWhen = (ctx: CommandContext) => boolean;
+export interface Command {
+    id: string;
+    title: string;
+    handler: CommandHandler;
+    defaultHotkey?: string;
+    modes?: Mode[];
+    when?: CommandWhen;
+    category?: string;
+    group?: string;
+    icon?: string;
+    hidden?: boolean;
+}
+export interface ParsedHotkey {
+    steps: ParsedStep[];
+}
+export interface ParsedStep {
+    key: string;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    option: boolean;
+}
+export interface CommandRegistry {
+    commands: Map<string, Command>;
+    register: (command: Command) => () => void;
+    invoke: (id: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC7B,QAAQ,EAAE;QAAE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,EAAE,CAAA;KAAE,CAAA;IACjE,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1E,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;AAE1D,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,cAAc,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IACd,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,IAAI,CAAA;IAC1C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/use-actions.d.ts

@@ -0,0 +1,12 @@
+import type { CommandHandler, CommandWhen } from "./types.js";
+import type { Mode } from "./mode.jsx";
+export interface ActionDefinition {
+    id: string;
+    title: string;
+    hotkey?: string;
+    modes?: Mode[];
+    handler: CommandHandler;
+    when?: CommandWhen;
+}
+export declare function useActions(actions: ActionDefinition[] | undefined): void;
+//# sourceMappingURL=use-actions.d.ts.map

package/dist/use-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-actions.d.ts","sourceRoot":"","sources":["../src/use-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IACd,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,SAAS,GAAG,IAAI,CAgCxE"}

package/dist/use-actions.js

@@ -0,0 +1,30 @@
+import { useEffect, useMemo, useRef } from "react";
+import { useCommandRegistry } from "./context.jsx";
+export function useActions(actions) {
+    const { registry } = useCommandRegistry();
+    const actionsRef = useRef(actions);
+    actionsRef.current = actions;
+    const key = useMemo(() => actions?.map((a) => `${a.id}:${a.hotkey ?? ""}`).join(",") ?? "", [actions]);
+    useEffect(() => {
+        const current = actionsRef.current;
+        if (!current || current.length === 0)
+            return;
+        const unregisters = current.map((action, i) => {
+            const command = {
+                id: action.id,
+                title: action.title,
+                defaultHotkey: action.hotkey,
+                modes: action.modes,
+                handler: (ctx) => actionsRef.current?.[i]?.handler(ctx),
+                when: action.when ? (ctx) => actionsRef.current?.[i]?.when?.(ctx) ?? false : undefined,
+            };
+            return registry.register(command);
+        });
+        return () => {
+            for (const unregister of unregisters) {
+                unregister();
+            }
+        };
+    }, [key, registry]);
+}
+//# sourceMappingURL=use-actions.js.map

package/dist/use-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-actions.js","sourceRoot":"","sources":["../src/use-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAalD,MAAM,UAAU,UAAU,CAAC,OAAuC;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAAA;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAE5B,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EACtE,CAAC,OAAO,CAAC,CACV,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAA;QAClC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAE5C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC5C,MAAM,OAAO,GAAY;gBACvB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,aAAa,EAAE,MAAM,CAAC,MAAM;gBAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC;gBACvD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,SAAS;aACvF,CAAA;YACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,UAAU,EAAE,CAAA;YACd,CAAC;QACH,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;AACrB,CAAC"}

package/dist/use-command.d.ts

@@ -0,0 +1,16 @@
+import type { CommandHandler, CommandWhen } from "./types.js";
+import type { Mode } from "./mode.jsx";
+export interface UseCommandOptions {
+    id: string;
+    title: string;
+    handler: CommandHandler;
+    hotkey?: string;
+    modes?: Mode[];
+    category?: string;
+    group?: string;
+    icon?: string;
+    when?: CommandWhen;
+    hidden?: boolean;
+}
+export declare function useCommand(options: UseCommandOptions): void;
+//# sourceMappingURL=use-command.d.ts.map

package/dist/use-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-command.d.ts","sourceRoot":"","sources":["../src/use-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGtC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,cAAc,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA8B3D"}