@opentui/keymap 0.2.1 → 0.2.3

package/src/addons/opentui/index.js

@@ -0,0 +1,467 @@
+// @bun
+// src/addons/opentui/index.ts
+export * from "@opentui/keymap/addons";
+
+// src/addons/opentui/base-layout.ts
+var BASE_LAYOUT_FALLBACK_RESOURCE = Symbol("keymap:base-layout-fallback");
+function getBaseLayoutKeyName(baseCode) {
+  if (baseCode === undefined || baseCode < 32 || baseCode === 127) {
+    return;
+  }
+  try {
+    const name = String.fromCodePoint(baseCode);
+    if (name.length === 1 && name >= "A" && name <= "Z") {
+      return name.toLowerCase();
+    }
+    return name;
+  } catch {
+    return;
+  }
+}
+function registerBaseLayoutFallback(keymap) {
+  return keymap.acquireResource(BASE_LAYOUT_FALLBACK_RESOURCE, () => {
+    return keymap.appendEventMatchResolver((event, ctx) => {
+      const name = getBaseLayoutKeyName(event.baseCode);
+      if (!name) {
+        return;
+      }
+      return [
+        ctx.resolveKey({
+          name,
+          ctrl: event.ctrl,
+          shift: event.shift,
+          meta: event.meta,
+          super: event.super ?? false,
+          hyper: event.hyper || undefined
+        })
+      ];
+    });
+  });
+}
+// src/addons/opentui/edit-buffer-bindings.ts
+import {
+  CliRenderEvents,
+  InputRenderable,
+  TextareaRenderable,
+  defaultTextareaKeyBindings
+} from "@opentui/core";
+function keyBindingToString(binding) {
+  const parts = [];
+  if (binding.ctrl)
+    parts.push("ctrl");
+  if (binding.shift)
+    parts.push("shift");
+  if (binding.meta)
+    parts.push("meta");
+  if (binding.super)
+    parts.push("super");
+  parts.push(binding.name);
+  return parts.join("+");
+}
+var editBufferActions = [
+  "move-left",
+  "move-right",
+  "move-up",
+  "move-down",
+  "select-left",
+  "select-right",
+  "select-up",
+  "select-down",
+  "line-home",
+  "line-end",
+  "select-line-home",
+  "select-line-end",
+  "visual-line-home",
+  "visual-line-end",
+  "select-visual-line-home",
+  "select-visual-line-end",
+  "buffer-home",
+  "buffer-end",
+  "select-buffer-home",
+  "select-buffer-end",
+  "delete-line",
+  "delete-to-line-end",
+  "delete-to-line-start",
+  "backspace",
+  "delete",
+  "newline",
+  "undo",
+  "redo",
+  "word-forward",
+  "word-backward",
+  "select-word-forward",
+  "select-word-backward",
+  "delete-word-forward",
+  "delete-word-backward",
+  "select-all",
+  "submit"
+];
+var DEFAULT_EDIT_BUFFER_METADATA_GROUP = "Text Editing";
+var editBufferCommandNames = {
+  "move-left": "input.move.left",
+  "move-right": "input.move.right",
+  "move-up": "input.move.up",
+  "move-down": "input.move.down",
+  "select-left": "input.select.left",
+  "select-right": "input.select.right",
+  "select-up": "input.select.up",
+  "select-down": "input.select.down",
+  "line-home": "input.line.home",
+  "line-end": "input.line.end",
+  "select-line-home": "input.select.line.home",
+  "select-line-end": "input.select.line.end",
+  "visual-line-home": "input.visual.line.home",
+  "visual-line-end": "input.visual.line.end",
+  "select-visual-line-home": "input.select.visual.line.home",
+  "select-visual-line-end": "input.select.visual.line.end",
+  "buffer-home": "input.buffer.home",
+  "buffer-end": "input.buffer.end",
+  "select-buffer-home": "input.select.buffer.home",
+  "select-buffer-end": "input.select.buffer.end",
+  "delete-line": "input.delete.line",
+  "delete-to-line-end": "input.delete.to.line.end",
+  "delete-to-line-start": "input.delete.to.line.start",
+  backspace: "input.backspace",
+  delete: "input.delete",
+  newline: "input.newline",
+  undo: "input.undo",
+  redo: "input.redo",
+  "word-forward": "input.word.forward",
+  "word-backward": "input.word.backward",
+  "select-word-forward": "input.select.word.forward",
+  "select-word-backward": "input.select.word.backward",
+  "delete-word-forward": "input.delete.word.forward",
+  "delete-word-backward": "input.delete.word.backward",
+  "select-all": "input.select.all",
+  submit: "input.submit"
+};
+var editBufferCommandDescriptions = {
+  "move-left": "Cursor left",
+  "move-right": "Cursor right",
+  "move-up": "Cursor up",
+  "move-down": "Cursor down",
+  "select-left": "Select left",
+  "select-right": "Select right",
+  "select-up": "Select up",
+  "select-down": "Select down",
+  "line-home": "Line start",
+  "line-end": "Line end",
+  "select-line-home": "Select to line start",
+  "select-line-end": "Select to line end",
+  "visual-line-home": "Visual line start",
+  "visual-line-end": "Visual line end",
+  "select-visual-line-home": "Select to visual line start",
+  "select-visual-line-end": "Select to visual line end",
+  "buffer-home": "Buffer start",
+  "buffer-end": "Buffer end",
+  "select-buffer-home": "Select to buffer start",
+  "select-buffer-end": "Select to buffer end",
+  "delete-line": "Delete line",
+  "delete-to-line-end": "Delete to line end",
+  "delete-to-line-start": "Delete to line start",
+  backspace: "Delete backward",
+  delete: "Delete forward",
+  newline: "New line",
+  undo: "Undo",
+  redo: "Redo",
+  "word-forward": "Next word",
+  "word-backward": "Previous word",
+  "select-word-forward": "Select next word",
+  "select-word-backward": "Select previous word",
+  "delete-word-forward": "Delete next word",
+  "delete-word-backward": "Delete previous word",
+  "select-all": "Select all",
+  submit: "Submit"
+};
+var editBufferFineGroups = {
+  "move-left": "Cursor",
+  "move-right": "Cursor",
+  "move-up": "Cursor",
+  "move-down": "Cursor",
+  "select-left": "Selection",
+  "select-right": "Selection",
+  "select-up": "Selection",
+  "select-down": "Selection",
+  "line-home": "Cursor",
+  "line-end": "Cursor",
+  "select-line-home": "Selection",
+  "select-line-end": "Selection",
+  "visual-line-home": "Cursor",
+  "visual-line-end": "Cursor",
+  "select-visual-line-home": "Selection",
+  "select-visual-line-end": "Selection",
+  "buffer-home": "Cursor",
+  "buffer-end": "Cursor",
+  "select-buffer-home": "Selection",
+  "select-buffer-end": "Selection",
+  "delete-line": "Delete",
+  "delete-to-line-end": "Delete",
+  "delete-to-line-start": "Delete",
+  backspace: "Delete",
+  delete: "Delete",
+  newline: "Insert",
+  undo: "History",
+  redo: "History",
+  "word-forward": "Cursor",
+  "word-backward": "Cursor",
+  "select-word-forward": "Selection",
+  "select-word-backward": "Selection",
+  "delete-word-forward": "Delete",
+  "delete-word-backward": "Delete",
+  "select-all": "Selection",
+  submit: "Submit"
+};
+var EDIT_BUFFER_COMMANDS_RESOURCE = Symbol("keymap:edit-buffer-commands");
+var TEXTAREA_MAPPING_SUSPENSION_RESOURCE = Symbol("keymap:textarea-mapping-suspension");
+function isManagedTextarea(editor) {
+  return editor instanceof TextareaRenderable && !(editor instanceof InputRenderable);
+}
+function resolveEditBufferCommandDescriptions(options) {
+  const descriptions = { ...editBufferCommandDescriptions };
+  const overrides = options?.descriptions;
+  if (!overrides) {
+    return descriptions;
+  }
+  for (const name of editBufferActions) {
+    const override = overrides[name];
+    if (override === undefined) {
+      continue;
+    }
+    const normalized = override.trim();
+    if (!normalized) {
+      throw new Error(`Edit buffer command description for "${name}" cannot be empty`);
+    }
+    descriptions[name] = normalized;
+  }
+  return descriptions;
+}
+function normalizeEditBufferMetadataField(fieldName, value) {
+  const normalized = (value ?? DEFAULT_EDIT_BUFFER_METADATA_GROUP).trim();
+  if (!normalized) {
+    throw new Error(`Edit buffer metadata field "${fieldName}" cannot be empty`);
+  }
+  return normalized;
+}
+function resolveEditBufferMetadataOptions(options) {
+  return {
+    category: normalizeEditBufferMetadataField("category", options?.category),
+    group: normalizeEditBufferMetadataField("group", options?.group),
+    includeFineGroup: options?.includeFineGroup === true
+  };
+}
+function resolveEditBufferCommandNames(options) {
+  const commandNames = { ...editBufferCommandNames };
+  const overrides = options?.commandNames;
+  if (overrides) {
+    for (const action of editBufferActions) {
+      const override = overrides[action];
+      if (override === undefined) {
+        continue;
+      }
+      const normalized = override.trim();
+      if (!normalized) {
+        throw new Error(`Edit buffer command name for "${action}" cannot be empty`);
+      }
+      commandNames[action] = normalized;
+    }
+  }
+  const seenNames = new Map;
+  for (const action of editBufferActions) {
+    const commandName = commandNames[action];
+    const existingAction = seenNames.get(commandName);
+    if (existingAction !== undefined) {
+      throw new Error(`Edit buffer command name "${commandName}" is assigned to both "${existingAction}" and "${action}"`);
+    }
+    seenNames.set(commandName, action);
+  }
+  return commandNames;
+}
+function setTextareaSuspend(editor, suspended) {
+  const nextTraits = { ...editor.traits };
+  if (suspended) {
+    nextTraits.suspend = true;
+  } else {
+    delete nextTraits.suspend;
+  }
+  editor.traits = nextTraits;
+}
+function createDefaultTextareaBindings(commandNames, descriptions, metadata) {
+  return defaultTextareaKeyBindings.map((binding) => {
+    const generated = {
+      key: keyBindingToString(binding),
+      cmd: commandNames[binding.action],
+      desc: descriptions[binding.action],
+      group: metadata.group
+    };
+    if (metadata.includeFineGroup) {
+      generated.fineGroup = editBufferFineGroups[binding.action];
+    }
+    return generated;
+  });
+}
+function createTextareaBindings(overrides, options) {
+  return createTextareaBindingsWithResolvedOptions(overrides, resolveEditBufferCommandNames(options), resolveEditBufferCommandDescriptions(options), resolveEditBufferMetadataOptions(options));
+}
+function createTextareaBindingsWithResolvedOptions(overrides, commandNames, descriptions, metadata) {
+  const overrideBindings = overrides ?? [];
+  return [...overrideBindings, ...createDefaultTextareaBindings(commandNames, descriptions, metadata)];
+}
+function getLiveRenderer(renderer) {
+  if (renderer.isDestroyed) {
+    throw new Error("Cannot use a keymap after its renderer was destroyed");
+  }
+  return renderer;
+}
+function registerTextareaMappingSuspension(keymap, renderer) {
+  return keymap.acquireResource(TEXTAREA_MAPPING_SUSPENSION_RESOURCE, () => {
+    const previousSuspendStates = new WeakMap;
+    let suspendedEditor = null;
+    const suspendEditor = (editor) => {
+      if (!isManagedTextarea(editor) || editor.isDestroyed) {
+        suspendedEditor = null;
+        return;
+      }
+      if (!previousSuspendStates.has(editor)) {
+        previousSuspendStates.set(editor, editor.traits.suspend === true);
+      }
+      setTextareaSuspend(editor, true);
+      suspendedEditor = editor;
+    };
+    const restoreEditor = (editor) => {
+      if (!isManagedTextarea(editor)) {
+        return;
+      }
+      const previousSuspend = previousSuspendStates.get(editor);
+      if (previousSuspend === undefined) {
+        return;
+      }
+      previousSuspendStates.delete(editor);
+      if (!editor.isDestroyed) {
+        setTextareaSuspend(editor, previousSuspend);
+      }
+      if (suspendedEditor === editor) {
+        suspendedEditor = null;
+      }
+    };
+    const onFocusedEditor = (current, previous) => {
+      restoreEditor(previous);
+      suspendEditor(current);
+    };
+    const liveRenderer = getLiveRenderer(renderer);
+    liveRenderer.on(CliRenderEvents.FOCUSED_EDITOR, onFocusedEditor);
+    suspendEditor(liveRenderer.currentFocusedEditor);
+    return () => {
+      liveRenderer.off(CliRenderEvents.FOCUSED_EDITOR, onFocusedEditor);
+      restoreEditor(suspendedEditor);
+    };
+  });
+}
+function withFocusedEditor(renderer, run) {
+  const editor = getLiveRenderer(renderer).currentFocusedEditor;
+  if (!editor || editor.isDestroyed) {
+    return false;
+  }
+  return run(editor);
+}
+function hasSubmit(editor) {
+  return typeof editor.submit === "function";
+}
+var editBufferCommandHandlers = {
+  "move-left": (editor) => editor.moveCursorLeft(),
+  "move-right": (editor) => editor.moveCursorRight(),
+  "move-up": (editor) => editor.moveCursorUp(),
+  "move-down": (editor) => editor.moveCursorDown(),
+  "select-left": (editor) => editor.moveCursorLeft({ select: true }),
+  "select-right": (editor) => editor.moveCursorRight({ select: true }),
+  "select-up": (editor) => editor.moveCursorUp({ select: true }),
+  "select-down": (editor) => editor.moveCursorDown({ select: true }),
+  "line-home": (editor) => editor.gotoLineHome(),
+  "line-end": (editor) => editor.gotoLineEnd(),
+  "select-line-home": (editor) => editor.gotoLineHome({ select: true }),
+  "select-line-end": (editor) => editor.gotoLineEnd({ select: true }),
+  "visual-line-home": (editor) => editor.gotoVisualLineHome(),
+  "visual-line-end": (editor) => editor.gotoVisualLineEnd(),
+  "select-visual-line-home": (editor) => editor.gotoVisualLineHome({ select: true }),
+  "select-visual-line-end": (editor) => editor.gotoVisualLineEnd({ select: true }),
+  "buffer-home": (editor) => editor.gotoBufferHome(),
+  "buffer-end": (editor) => editor.gotoBufferEnd(),
+  "select-buffer-home": (editor) => editor.gotoBufferHome({ select: true }),
+  "select-buffer-end": (editor) => editor.gotoBufferEnd({ select: true }),
+  "delete-line": (editor) => editor.deleteLine(),
+  "delete-to-line-end": (editor) => editor.deleteToLineEnd(),
+  "delete-to-line-start": (editor) => editor.deleteToLineStart(),
+  backspace: (editor) => editor.deleteCharBackward(),
+  delete: (editor) => editor.deleteChar(),
+  newline: (editor) => editor.newLine(),
+  undo: (editor) => editor.undo(),
+  redo: (editor) => editor.redo(),
+  "word-forward": (editor) => editor.moveWordForward(),
+  "word-backward": (editor) => editor.moveWordBackward(),
+  "select-word-forward": (editor) => editor.moveWordForward({ select: true }),
+  "select-word-backward": (editor) => editor.moveWordBackward({ select: true }),
+  "delete-word-forward": (editor) => editor.deleteWordForward(),
+  "delete-word-backward": (editor) => editor.deleteWordBackward(),
+  "select-all": (editor) => editor.selectAll(),
+  submit: (editor) => {
+    if (!hasSubmit(editor)) {
+      return false;
+    }
+    return editor.submit();
+  }
+};
+function createEditBufferCommand(renderer, action, commandNames, run, descriptions, metadata) {
+  return {
+    name: commandNames[action],
+    desc: descriptions[action],
+    category: metadata.category,
+    run() {
+      return withFocusedEditor(renderer, run);
+    }
+  };
+}
+function createEditBufferCommands(renderer, commandNames, descriptions, metadata) {
+  return editBufferActions.map((action) => createEditBufferCommand(renderer, action, commandNames, editBufferCommandHandlers[action], descriptions, metadata));
+}
+function registerEditBufferCommands(keymap, renderer, options) {
+  const commandNames = resolveEditBufferCommandNames(options);
+  const descriptions = resolveEditBufferCommandDescriptions(options);
+  const metadata = resolveEditBufferMetadataOptions(options);
+  return keymap.acquireResource(EDIT_BUFFER_COMMANDS_RESOURCE, () => {
+    return keymap.registerLayer({
+      commands: createEditBufferCommands(renderer, commandNames, descriptions, metadata)
+    });
+  });
+}
+function registerManagedTextareaLayer(keymap, renderer, layer, options) {
+  const commandNames = resolveEditBufferCommandNames(options);
+  const descriptions = resolveEditBufferCommandDescriptions(options);
+  const metadata = resolveEditBufferMetadataOptions(options);
+  const offCommands = registerEditBufferCommands(keymap, renderer, options);
+  const offSuspension = registerTextareaMappingSuspension(keymap, renderer);
+  try {
+    const { bindings, target: _ignoredTarget, targetMode: _ignoredTargetMode, ...rest } = layer;
+    const offLayer = keymap.registerLayer({
+      ...rest,
+      bindings: createTextareaBindingsWithResolvedOptions(bindings, commandNames, descriptions, metadata)
+    });
+    return () => {
+      offLayer();
+      offSuspension();
+      offCommands();
+    };
+  } catch (error) {
+    offSuspension();
+    offCommands();
+    throw error;
+  }
+}
+export {
+  registerTextareaMappingSuspension,
+  registerManagedTextareaLayer,
+  registerEditBufferCommands,
+  registerBaseLayoutFallback,
+  createTextareaBindings
+};
+
+//# debugId=41E23EFAAC69B76764756E2164756E21
+//# sourceMappingURL=index.js.map

package/src/addons/opentui/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/addons/opentui/index.ts", "../src/addons/opentui/base-layout.ts", "../src/addons/opentui/edit-buffer-bindings.ts"],
+  "sourcesContent": [
+    "export * from \"@opentui/keymap/addons\"\nexport { registerBaseLayoutFallback } from \"./base-layout.js\"\nexport {\n  createTextareaBindings,\n  registerEditBufferCommands,\n  registerManagedTextareaLayer,\n  registerTextareaMappingSuspension,\n} from \"./edit-buffer-bindings.js\"\nexport type { EditBufferCommandName, EditBufferCommandOptions, EditBufferFineGroup } from \"./edit-buffer-bindings.js\"\n",
+    "import type { KeyEvent, Renderable } from \"@opentui/core\"\nimport type { Keymap } from \"../../index.js\"\n\nconst BASE_LAYOUT_FALLBACK_RESOURCE = Symbol(\"keymap:base-layout-fallback\")\n\nfunction getBaseLayoutKeyName(baseCode: number | undefined): string | undefined {\n  if (baseCode === undefined || baseCode < 32 || baseCode === 127) {\n    return undefined\n  }\n\n  try {\n    const name = String.fromCodePoint(baseCode)\n\n    if (name.length === 1 && name >= \"A\" && name <= \"Z\") {\n      return name.toLowerCase()\n    }\n\n    return name\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Falls back to the event's base layout code so bindings can ignore active\n * keyboard layout changes.\n */\nexport function registerBaseLayoutFallback(keymap: Keymap<Renderable, KeyEvent>): () => void {\n  return keymap.acquireResource(BASE_LAYOUT_FALLBACK_RESOURCE, () => {\n    return keymap.appendEventMatchResolver((event, ctx) => {\n      const name = getBaseLayoutKeyName(event.baseCode)\n      if (!name) {\n        return undefined\n      }\n\n      return [\n        ctx.resolveKey({\n          name,\n          ctrl: event.ctrl,\n          shift: event.shift,\n          meta: event.meta,\n          super: event.super ?? false,\n          hyper: event.hyper || undefined,\n        }),\n      ]\n    })\n  })\n}\n",
+    "import {\n  CliRenderEvents,\n  InputRenderable,\n  TextareaRenderable,\n  defaultTextareaKeyBindings,\n  type CliRenderer,\n  type EditBufferRenderable,\n  type KeyEvent,\n  type Renderable,\n  type TextareaAction,\n} from \"@opentui/core\"\nimport type { Binding, Bindings, Command, Keymap, Layer } from \"../../index.js\"\n\ninterface KeyBindingLike {\n  name: string\n  ctrl?: boolean\n  shift?: boolean\n  meta?: boolean\n  super?: boolean\n}\n\nfunction keyBindingToString(binding: KeyBindingLike): string {\n  const parts: string[] = []\n\n  if (binding.ctrl) parts.push(\"ctrl\")\n  if (binding.shift) parts.push(\"shift\")\n  if (binding.meta) parts.push(\"meta\")\n  if (binding.super) parts.push(\"super\")\n\n  parts.push(binding.name)\n\n  return parts.join(\"+\")\n}\n\nconst editBufferActions = [\n  \"move-left\",\n  \"move-right\",\n  \"move-up\",\n  \"move-down\",\n  \"select-left\",\n  \"select-right\",\n  \"select-up\",\n  \"select-down\",\n  \"line-home\",\n  \"line-end\",\n  \"select-line-home\",\n  \"select-line-end\",\n  \"visual-line-home\",\n  \"visual-line-end\",\n  \"select-visual-line-home\",\n  \"select-visual-line-end\",\n  \"buffer-home\",\n  \"buffer-end\",\n  \"select-buffer-home\",\n  \"select-buffer-end\",\n  \"delete-line\",\n  \"delete-to-line-end\",\n  \"delete-to-line-start\",\n  \"backspace\",\n  \"delete\",\n  \"newline\",\n  \"undo\",\n  \"redo\",\n  \"word-forward\",\n  \"word-backward\",\n  \"select-word-forward\",\n  \"select-word-backward\",\n  \"delete-word-forward\",\n  \"delete-word-backward\",\n  \"select-all\",\n  \"submit\",\n] as const satisfies readonly TextareaAction[]\n\nexport type EditBufferCommandName = (typeof editBufferActions)[number]\n\nexport type EditBufferFineGroup = \"Cursor\" | \"Selection\" | \"Delete\" | \"History\" | \"Insert\" | \"Submit\"\n\nconst DEFAULT_EDIT_BUFFER_METADATA_GROUP = \"Text Editing\"\n\nconst editBufferCommandNames = {\n  \"move-left\": \"input.move.left\",\n  \"move-right\": \"input.move.right\",\n  \"move-up\": \"input.move.up\",\n  \"move-down\": \"input.move.down\",\n  \"select-left\": \"input.select.left\",\n  \"select-right\": \"input.select.right\",\n  \"select-up\": \"input.select.up\",\n  \"select-down\": \"input.select.down\",\n  \"line-home\": \"input.line.home\",\n  \"line-end\": \"input.line.end\",\n  \"select-line-home\": \"input.select.line.home\",\n  \"select-line-end\": \"input.select.line.end\",\n  \"visual-line-home\": \"input.visual.line.home\",\n  \"visual-line-end\": \"input.visual.line.end\",\n  \"select-visual-line-home\": \"input.select.visual.line.home\",\n  \"select-visual-line-end\": \"input.select.visual.line.end\",\n  \"buffer-home\": \"input.buffer.home\",\n  \"buffer-end\": \"input.buffer.end\",\n  \"select-buffer-home\": \"input.select.buffer.home\",\n  \"select-buffer-end\": \"input.select.buffer.end\",\n  \"delete-line\": \"input.delete.line\",\n  \"delete-to-line-end\": \"input.delete.to.line.end\",\n  \"delete-to-line-start\": \"input.delete.to.line.start\",\n  backspace: \"input.backspace\",\n  delete: \"input.delete\",\n  newline: \"input.newline\",\n  undo: \"input.undo\",\n  redo: \"input.redo\",\n  \"word-forward\": \"input.word.forward\",\n  \"word-backward\": \"input.word.backward\",\n  \"select-word-forward\": \"input.select.word.forward\",\n  \"select-word-backward\": \"input.select.word.backward\",\n  \"delete-word-forward\": \"input.delete.word.forward\",\n  \"delete-word-backward\": \"input.delete.word.backward\",\n  \"select-all\": \"input.select.all\",\n  submit: \"input.submit\",\n} as const satisfies Record<EditBufferCommandName, string>\n\nconst editBufferCommandDescriptions = {\n  \"move-left\": \"Cursor left\",\n  \"move-right\": \"Cursor right\",\n  \"move-up\": \"Cursor up\",\n  \"move-down\": \"Cursor down\",\n  \"select-left\": \"Select left\",\n  \"select-right\": \"Select right\",\n  \"select-up\": \"Select up\",\n  \"select-down\": \"Select down\",\n  \"line-home\": \"Line start\",\n  \"line-end\": \"Line end\",\n  \"select-line-home\": \"Select to line start\",\n  \"select-line-end\": \"Select to line end\",\n  \"visual-line-home\": \"Visual line start\",\n  \"visual-line-end\": \"Visual line end\",\n  \"select-visual-line-home\": \"Select to visual line start\",\n  \"select-visual-line-end\": \"Select to visual line end\",\n  \"buffer-home\": \"Buffer start\",\n  \"buffer-end\": \"Buffer end\",\n  \"select-buffer-home\": \"Select to buffer start\",\n  \"select-buffer-end\": \"Select to buffer end\",\n  \"delete-line\": \"Delete line\",\n  \"delete-to-line-end\": \"Delete to line end\",\n  \"delete-to-line-start\": \"Delete to line start\",\n  backspace: \"Delete backward\",\n  delete: \"Delete forward\",\n  newline: \"New line\",\n  undo: \"Undo\",\n  redo: \"Redo\",\n  \"word-forward\": \"Next word\",\n  \"word-backward\": \"Previous word\",\n  \"select-word-forward\": \"Select next word\",\n  \"select-word-backward\": \"Select previous word\",\n  \"delete-word-forward\": \"Delete next word\",\n  \"delete-word-backward\": \"Delete previous word\",\n  \"select-all\": \"Select all\",\n  submit: \"Submit\",\n} as const satisfies Record<EditBufferCommandName, string>\n\nconst editBufferFineGroups = {\n  \"move-left\": \"Cursor\",\n  \"move-right\": \"Cursor\",\n  \"move-up\": \"Cursor\",\n  \"move-down\": \"Cursor\",\n  \"select-left\": \"Selection\",\n  \"select-right\": \"Selection\",\n  \"select-up\": \"Selection\",\n  \"select-down\": \"Selection\",\n  \"line-home\": \"Cursor\",\n  \"line-end\": \"Cursor\",\n  \"select-line-home\": \"Selection\",\n  \"select-line-end\": \"Selection\",\n  \"visual-line-home\": \"Cursor\",\n  \"visual-line-end\": \"Cursor\",\n  \"select-visual-line-home\": \"Selection\",\n  \"select-visual-line-end\": \"Selection\",\n  \"buffer-home\": \"Cursor\",\n  \"buffer-end\": \"Cursor\",\n  \"select-buffer-home\": \"Selection\",\n  \"select-buffer-end\": \"Selection\",\n  \"delete-line\": \"Delete\",\n  \"delete-to-line-end\": \"Delete\",\n  \"delete-to-line-start\": \"Delete\",\n  backspace: \"Delete\",\n  delete: \"Delete\",\n  newline: \"Insert\",\n  undo: \"History\",\n  redo: \"History\",\n  \"word-forward\": \"Cursor\",\n  \"word-backward\": \"Cursor\",\n  \"select-word-forward\": \"Selection\",\n  \"select-word-backward\": \"Selection\",\n  \"delete-word-forward\": \"Delete\",\n  \"delete-word-backward\": \"Delete\",\n  \"select-all\": \"Selection\",\n  submit: \"Submit\",\n} as const satisfies Record<EditBufferCommandName, EditBufferFineGroup>\n\ninterface EditBufferMetadataOptions {\n  category: string\n  group: string\n  includeFineGroup: boolean\n}\n\nexport interface EditBufferCommandOptions {\n  category?: string\n  group?: string\n  includeFineGroup?: boolean\n  commandNames?: Partial<Record<EditBufferCommandName, string>>\n  descriptions?: Partial<Record<EditBufferCommandName, string>>\n}\n\nconst EDIT_BUFFER_COMMANDS_RESOURCE = Symbol(\"keymap:edit-buffer-commands\")\nconst TEXTAREA_MAPPING_SUSPENSION_RESOURCE = Symbol(\"keymap:textarea-mapping-suspension\")\n\nexport type ManagedTextareaLayer = Omit<Layer<Renderable, KeyEvent>, \"bindings\" | \"target\" | \"targetMode\"> & {\n  bindings?: Bindings<Renderable, KeyEvent>\n  target?: never\n  targetMode?: never\n}\n\nfunction isManagedTextarea(editor: EditBufferRenderable | null): editor is TextareaRenderable {\n  return editor instanceof TextareaRenderable && !(editor instanceof InputRenderable)\n}\n\nfunction resolveEditBufferCommandDescriptions(\n  options?: EditBufferCommandOptions,\n): Record<EditBufferCommandName, string> {\n  const descriptions: Record<EditBufferCommandName, string> = { ...editBufferCommandDescriptions }\n  const overrides = options?.descriptions\n  if (!overrides) {\n    return descriptions\n  }\n\n  for (const name of editBufferActions) {\n    const override = overrides[name]\n    if (override === undefined) {\n      continue\n    }\n\n    const normalized = override.trim()\n    if (!normalized) {\n      throw new Error(`Edit buffer command description for \"${name}\" cannot be empty`)\n    }\n\n    descriptions[name] = normalized\n  }\n\n  return descriptions\n}\n\nfunction normalizeEditBufferMetadataField(fieldName: \"category\" | \"group\", value: string | undefined): string {\n  const normalized = (value ?? DEFAULT_EDIT_BUFFER_METADATA_GROUP).trim()\n  if (!normalized) {\n    throw new Error(`Edit buffer metadata field \"${fieldName}\" cannot be empty`)\n  }\n\n  return normalized\n}\n\nfunction resolveEditBufferMetadataOptions(options?: EditBufferCommandOptions): EditBufferMetadataOptions {\n  return {\n    category: normalizeEditBufferMetadataField(\"category\", options?.category),\n    group: normalizeEditBufferMetadataField(\"group\", options?.group),\n    includeFineGroup: options?.includeFineGroup === true,\n  }\n}\n\nfunction resolveEditBufferCommandNames(options?: EditBufferCommandOptions): Record<EditBufferCommandName, string> {\n  const commandNames: Record<EditBufferCommandName, string> = { ...editBufferCommandNames }\n  const overrides = options?.commandNames\n\n  if (overrides) {\n    for (const action of editBufferActions) {\n      const override = overrides[action]\n      if (override === undefined) {\n        continue\n      }\n\n      const normalized = override.trim()\n      if (!normalized) {\n        throw new Error(`Edit buffer command name for \"${action}\" cannot be empty`)\n      }\n\n      commandNames[action] = normalized\n    }\n  }\n\n  const seenNames = new Map<string, EditBufferCommandName>()\n\n  for (const action of editBufferActions) {\n    const commandName = commandNames[action]\n    const existingAction = seenNames.get(commandName)\n    if (existingAction !== undefined) {\n      throw new Error(\n        `Edit buffer command name \"${commandName}\" is assigned to both \"${existingAction}\" and \"${action}\"`,\n      )\n    }\n\n    seenNames.set(commandName, action)\n  }\n\n  return commandNames\n}\n\nfunction setTextareaSuspend(editor: TextareaRenderable, suspended: boolean): void {\n  const nextTraits = { ...editor.traits }\n  if (suspended) {\n    nextTraits.suspend = true\n  } else {\n    delete nextTraits.suspend\n  }\n\n  editor.traits = nextTraits\n}\n\nfunction createDefaultTextareaBindings(\n  commandNames: Readonly<Record<EditBufferCommandName, string>>,\n  descriptions: Readonly<Record<EditBufferCommandName, string>>,\n  metadata: Readonly<EditBufferMetadataOptions>,\n): Binding[] {\n  return defaultTextareaKeyBindings.map((binding) => {\n    const generated: Binding = {\n      key: keyBindingToString(binding),\n      cmd: commandNames[binding.action],\n      desc: descriptions[binding.action],\n      group: metadata.group,\n    }\n\n    if (metadata.includeFineGroup) {\n      generated.fineGroup = editBufferFineGroups[binding.action]\n    }\n\n    return generated\n  })\n}\n\n/**\n * Returns the default textarea bindings with any overrides prepended so they\n * take precedence. Prefer `registerManagedTextareaLayer` unless you are\n * composing a custom textarea integration.\n */\nexport function createTextareaBindings(overrides?: readonly Binding[], options?: EditBufferCommandOptions): Binding[] {\n  return createTextareaBindingsWithResolvedOptions(\n    overrides,\n    resolveEditBufferCommandNames(options),\n    resolveEditBufferCommandDescriptions(options),\n    resolveEditBufferMetadataOptions(options),\n  )\n}\n\nfunction createTextareaBindingsWithResolvedOptions(\n  overrides: readonly Binding[] | undefined,\n  commandNames: Readonly<Record<EditBufferCommandName, string>>,\n  descriptions: Readonly<Record<EditBufferCommandName, string>>,\n  metadata: Readonly<EditBufferMetadataOptions>,\n): Binding[] {\n  const overrideBindings = overrides ?? []\n  return [...overrideBindings, ...createDefaultTextareaBindings(commandNames, descriptions, metadata)]\n}\n\nfunction getLiveRenderer(renderer: CliRenderer): CliRenderer {\n  if (renderer.isDestroyed) {\n    throw new Error(\"Cannot use a keymap after its renderer was destroyed\")\n  }\n\n  return renderer\n}\n\n/**\n * Suspends a focused `TextareaRenderable`'s own key handling so keymap\n * bindings can take over, restoring the previous suspend state on cleanup or\n * focus change. Reference-counted per `Keymap`; prefer\n * `registerManagedTextareaLayer` unless you need this separately.\n */\nexport function registerTextareaMappingSuspension(\n  keymap: Keymap<Renderable, KeyEvent>,\n  renderer: CliRenderer,\n): () => void {\n  return keymap.acquireResource(TEXTAREA_MAPPING_SUSPENSION_RESOURCE, () => {\n    const previousSuspendStates = new WeakMap<TextareaRenderable, boolean>()\n    let suspendedEditor: TextareaRenderable | null = null\n\n    const suspendEditor = (editor: EditBufferRenderable | null): void => {\n      if (!isManagedTextarea(editor) || editor.isDestroyed) {\n        suspendedEditor = null\n        return\n      }\n\n      if (!previousSuspendStates.has(editor)) {\n        previousSuspendStates.set(editor, editor.traits.suspend === true)\n      }\n\n      setTextareaSuspend(editor, true)\n      suspendedEditor = editor\n    }\n\n    const restoreEditor = (editor: EditBufferRenderable | null): void => {\n      if (!isManagedTextarea(editor)) {\n        return\n      }\n\n      const previousSuspend = previousSuspendStates.get(editor)\n      if (previousSuspend === undefined) {\n        return\n      }\n\n      previousSuspendStates.delete(editor)\n      if (!editor.isDestroyed) {\n        setTextareaSuspend(editor, previousSuspend)\n      }\n\n      if (suspendedEditor === editor) {\n        suspendedEditor = null\n      }\n    }\n\n    const onFocusedEditor = (current: EditBufferRenderable | null, previous: EditBufferRenderable | null): void => {\n      restoreEditor(previous)\n      suspendEditor(current)\n    }\n\n    const liveRenderer = getLiveRenderer(renderer)\n\n    liveRenderer.on(CliRenderEvents.FOCUSED_EDITOR, onFocusedEditor)\n    suspendEditor(liveRenderer.currentFocusedEditor)\n\n    return () => {\n      liveRenderer.off(CliRenderEvents.FOCUSED_EDITOR, onFocusedEditor)\n      restoreEditor(suspendedEditor)\n    }\n  })\n}\n\nfunction withFocusedEditor(renderer: CliRenderer, run: (editor: EditBufferRenderable) => boolean): boolean {\n  const editor = getLiveRenderer(renderer).currentFocusedEditor\n  if (!editor || editor.isDestroyed) {\n    return false\n  }\n\n  return run(editor)\n}\n\nfunction hasSubmit(editor: EditBufferRenderable): editor is EditBufferRenderable & { submit: () => boolean } {\n  return typeof (editor as { submit?: unknown }).submit === \"function\"\n}\n\nconst editBufferCommandHandlers = {\n  \"move-left\": (editor: EditBufferRenderable) => editor.moveCursorLeft(),\n  \"move-right\": (editor: EditBufferRenderable) => editor.moveCursorRight(),\n  \"move-up\": (editor: EditBufferRenderable) => editor.moveCursorUp(),\n  \"move-down\": (editor: EditBufferRenderable) => editor.moveCursorDown(),\n  \"select-left\": (editor: EditBufferRenderable) => editor.moveCursorLeft({ select: true }),\n  \"select-right\": (editor: EditBufferRenderable) => editor.moveCursorRight({ select: true }),\n  \"select-up\": (editor: EditBufferRenderable) => editor.moveCursorUp({ select: true }),\n  \"select-down\": (editor: EditBufferRenderable) => editor.moveCursorDown({ select: true }),\n  \"line-home\": (editor: EditBufferRenderable) => editor.gotoLineHome(),\n  \"line-end\": (editor: EditBufferRenderable) => editor.gotoLineEnd(),\n  \"select-line-home\": (editor: EditBufferRenderable) => editor.gotoLineHome({ select: true }),\n  \"select-line-end\": (editor: EditBufferRenderable) => editor.gotoLineEnd({ select: true }),\n  \"visual-line-home\": (editor: EditBufferRenderable) => editor.gotoVisualLineHome(),\n  \"visual-line-end\": (editor: EditBufferRenderable) => editor.gotoVisualLineEnd(),\n  \"select-visual-line-home\": (editor: EditBufferRenderable) => editor.gotoVisualLineHome({ select: true }),\n  \"select-visual-line-end\": (editor: EditBufferRenderable) => editor.gotoVisualLineEnd({ select: true }),\n  \"buffer-home\": (editor: EditBufferRenderable) => editor.gotoBufferHome(),\n  \"buffer-end\": (editor: EditBufferRenderable) => editor.gotoBufferEnd(),\n  \"select-buffer-home\": (editor: EditBufferRenderable) => editor.gotoBufferHome({ select: true }),\n  \"select-buffer-end\": (editor: EditBufferRenderable) => editor.gotoBufferEnd({ select: true }),\n  \"delete-line\": (editor: EditBufferRenderable) => editor.deleteLine(),\n  \"delete-to-line-end\": (editor: EditBufferRenderable) => editor.deleteToLineEnd(),\n  \"delete-to-line-start\": (editor: EditBufferRenderable) => editor.deleteToLineStart(),\n  backspace: (editor: EditBufferRenderable) => editor.deleteCharBackward(),\n  delete: (editor: EditBufferRenderable) => editor.deleteChar(),\n  newline: (editor: EditBufferRenderable) => editor.newLine(),\n  undo: (editor: EditBufferRenderable) => editor.undo(),\n  redo: (editor: EditBufferRenderable) => editor.redo(),\n  \"word-forward\": (editor: EditBufferRenderable) => editor.moveWordForward(),\n  \"word-backward\": (editor: EditBufferRenderable) => editor.moveWordBackward(),\n  \"select-word-forward\": (editor: EditBufferRenderable) => editor.moveWordForward({ select: true }),\n  \"select-word-backward\": (editor: EditBufferRenderable) => editor.moveWordBackward({ select: true }),\n  \"delete-word-forward\": (editor: EditBufferRenderable) => editor.deleteWordForward(),\n  \"delete-word-backward\": (editor: EditBufferRenderable) => editor.deleteWordBackward(),\n  \"select-all\": (editor: EditBufferRenderable) => editor.selectAll(),\n  submit: (editor: EditBufferRenderable) => {\n    if (!hasSubmit(editor)) {\n      return false\n    }\n\n    return editor.submit()\n  },\n} as const satisfies Record<EditBufferCommandName, (editor: EditBufferRenderable) => boolean>\n\nfunction createEditBufferCommand(\n  renderer: CliRenderer,\n  action: EditBufferCommandName,\n  commandNames: Readonly<Record<EditBufferCommandName, string>>,\n  run: (editor: EditBufferRenderable) => boolean,\n  descriptions: Readonly<Record<EditBufferCommandName, string>>,\n  metadata: Readonly<EditBufferMetadataOptions>,\n): Command<Renderable, KeyEvent> {\n  return {\n    name: commandNames[action],\n    desc: descriptions[action],\n    category: metadata.category,\n    run() {\n      return withFocusedEditor(renderer, run)\n    },\n  }\n}\n\nfunction createEditBufferCommands(\n  renderer: CliRenderer,\n  commandNames: Readonly<Record<EditBufferCommandName, string>>,\n  descriptions: Readonly<Record<EditBufferCommandName, string>>,\n  metadata: Readonly<EditBufferMetadataOptions>,\n): Command<Renderable, KeyEvent>[] {\n  return editBufferActions.map((action) =>\n    createEditBufferCommand(renderer, action, commandNames, editBufferCommandHandlers[action], descriptions, metadata),\n  )\n}\n\n/**\n * Registers the standard edit-buffer commands against\n * `renderer.currentFocusedEditor`. Reference-counted per `Keymap`; prefer\n * `registerManagedTextareaLayer` unless you need the commands without the\n * default bindings or textarea suspension.\n */\nexport function registerEditBufferCommands(\n  keymap: Keymap<Renderable, KeyEvent>,\n  renderer: CliRenderer,\n  options?: EditBufferCommandOptions,\n): () => void {\n  const commandNames = resolveEditBufferCommandNames(options)\n  const descriptions = resolveEditBufferCommandDescriptions(options)\n  const metadata = resolveEditBufferMetadataOptions(options)\n\n  return keymap.acquireResource(EDIT_BUFFER_COMMANDS_RESOURCE, () => {\n    return keymap.registerLayer({\n      commands: createEditBufferCommands(renderer, commandNames, descriptions, metadata),\n    })\n  })\n}\n\n/**\n * High-level global textarea integration: registers the edit-buffer commands,\n * suspends the textarea's built-in key handling while focused, and installs\n * the layer with default bindings plus overrides. Safe to combine with the\n * lower-level helpers because they are reference-counted.\n */\nexport function registerManagedTextareaLayer(\n  keymap: Keymap<Renderable, KeyEvent>,\n  renderer: CliRenderer,\n  layer: ManagedTextareaLayer,\n  options?: EditBufferCommandOptions,\n): () => void {\n  const commandNames = resolveEditBufferCommandNames(options)\n  const descriptions = resolveEditBufferCommandDescriptions(options)\n  const metadata = resolveEditBufferMetadataOptions(options)\n  const offCommands = registerEditBufferCommands(keymap, renderer, options)\n  const offSuspension = registerTextareaMappingSuspension(keymap, renderer)\n\n  try {\n    const { bindings, target: _ignoredTarget, targetMode: _ignoredTargetMode, ...rest } = layer\n    const offLayer = keymap.registerLayer({\n      ...rest,\n      bindings: createTextareaBindingsWithResolvedOptions(bindings, commandNames, descriptions, metadata),\n    })\n\n    return () => {\n      offLayer()\n      offSuspension()\n      offCommands()\n    }\n  } catch (error) {\n    offSuspension()\n    offCommands()\n    throw error\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "41E23EFAAC69B76764756E2164756E21",
+  "names": []
+}

package/src/addons/universal/binding-overrides.d.ts

@@ -0,0 +1,6 @@
+import type { Keymap, KeymapEvent } from "../../index.js";
+/**
+ * Adds a `bindingOverrides` layer field that replaces bindings by string
+ * command name within that layer before compilation.
+ */
+export declare function registerBindingOverrides<TTarget extends object, TEvent extends KeymapEvent>(keymap: Keymap<TTarget, TEvent>): () => void;

package/src/addons/universal/dead-bindings.d.ts

@@ -1,4 +1,4 @@
-import type { Keymap, KeymapEvent } from "../../index.js";
+import type { Keymap, KeymapEvent } from "@opentui/keymap";
 /**
  * Warns about bindings that can never trigger because they have no command and
  * no reachable continuation.

package/src/addons/universal/default-parser.d.ts

@@ -2,8 +2,8 @@ import type { BindingParser, EventMatchResolver, Keymap, KeymapEvent } from "../
 export declare const defaultBindingParser: BindingParser;
 export declare const defaultEventMatchResolver: EventMatchResolver<KeymapEvent>;
 /**
- * Parses the built-in string binding syntax, including modifiers and
- * `<token>` segments.
+ * Parses the built-in string binding syntax, including modifiers,
+ * `<token>` aliases, and `{pattern}` dynamic sequence segments.
  */
 export declare function registerDefaultBindingParser<TTarget extends object, TEvent extends KeymapEvent>(keymap: Keymap<TTarget, TEvent>): () => void;
 /**

package/src/addons/universal/ex-commands.d.ts

@@ -1,16 +1,19 @@
-import type { CommandContext, Keymap, KeymapEvent } from "../../index.js";
+import type { CommandContext, CommandResult, Keymap, KeymapEvent } from "../../index.js";
+export interface ExCommandPayload {
+    raw: string;
+    args: readonly string[];
+    payload?: unknown;
+}
 export interface ExCommand<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> {
     name: string;
     aliases?: string[];
     nargs?: "0" | "1" | "?" | "*" | "+";
-    run: (ctx: CommandContext<TTarget, TEvent> & {
-        raw: string;
-        args: string[];
-    }) => void | Promise<void>;
+    run: (ctx: CommandContext<TTarget, TEvent, ExCommandPayload>) => CommandResult<TTarget, TEvent>;
     [key: string]: unknown;
 }
 /**
- * Resolves `:name ...args` strings against the provided Ex commands and
- * validated argument lists.
+ * Installs Ex command support. Ex commands are registered through normal
+ * keymap layers by using a colon-prefixed command name or
+ * `namespace: "excommands"`.
  */
-export declare function registerExCommands<TTarget extends object, TEvent extends KeymapEvent>(keymap: Keymap<TTarget, TEvent>, commands: ExCommand<TTarget, TEvent>[]): () => void;
+export declare function registerExCommands<TTarget extends object, TEvent extends KeymapEvent>(keymap: Keymap<TTarget, TEvent>): () => void;

package/src/addons/universal/index.d.ts

@@ -1,4 +1,5 @@
 export { defaultBindingParser, defaultEventMatchResolver, registerDefaultBindingParser, registerDefaultEventMatchResolver, registerDefaultKeys, } from "./default-parser.js";
+export { registerBindingOverrides } from "./binding-overrides.js";
 export { registerAliasesField } from "./aliases.js";
 export { registerBackspacePopsPendingSequence } from "./backspace-pops-pending-sequence.js";
 export { registerCommaBindings } from "./comma-bindings.js";
@@ -9,6 +10,7 @@ export { registerEmacsBindings } from "./emacs-bindings.js";
 export { registerExCommands } from "./ex-commands.js";
 export { registerLeader } from "./leader.js";
 export { registerMetadataFields } from "./metadata.js";
+export { registerModBindings } from "./mod-bindings.js";
 export { registerNeovimDisambiguation } from "./neovim-disambiguation.js";
 export { registerTimedLeader } from "./timed-leader.js";
 export { registerUnresolvedCommandWarnings } from "./unresolved-commands.js";
@@ -16,7 +18,7 @@ export type { Aliases } from "./aliases.js";
 export type { BackspacePopsPendingSequenceOptions } from "./backspace-pops-pending-sequence.js";
 export type { EscapeClearsPendingSequenceOptions } from "./escape-clears-pending-sequence.js";
 export type { Enabled } from "./enabled.js";
-export type { ExCommand } from "./ex-commands.js";
+export type { ExCommand, ExCommandPayload } from "./ex-commands.js";
 export type { LeaderOptions } from "./leader.js";
 export type { NeovimDisambiguationOptions } from "./neovim-disambiguation.js";
 export type { TimedLeaderOptions } from "./timed-leader.js";

package/src/addons/universal/leader.d.ts

@@ -4,6 +4,6 @@ export interface LeaderOptions {
     name?: string;
 }
 /**
- * Defines a token such as `<leader>` that expands to a chosen trigger key.
+ * Defines a token such as `leader` that the default parser can reference as `<leader>`.
  */
 export declare function registerLeader<TTarget extends object, TEvent extends KeymapEvent>(keymap: Keymap<TTarget, TEvent>, options: LeaderOptions): () => void;

package/src/addons/universal/metadata.d.ts

@@ -3,7 +3,7 @@ import type { Keymap, KeymapEvent } from "../../index.js";
  * Maps `desc`, `group`, `title`, and `category` fields into binding and
  * command attrs.
  *
- * Layer fields intentionally do not compile into attrs in the current model,
- * so this addon only registers binding and command field compilers.
+ * This addon only registers binding and command field compilers. Apps can
+ * register layer metadata fields directly with `registerLayerFields`.
  */
 export declare function registerMetadataFields<TTarget extends object, TEvent extends KeymapEvent>(keymap: Keymap<TTarget, TEvent>): () => void;

package/src/addons/universal/mod-bindings.d.ts

@@ -0,0 +1,6 @@
+import type { Keymap, KeymapEvent } from "../../index.js";
+/**
+ * Adds a platform-aware `mod+...` modifier alias. `mod` resolves to the host's
+ * primary modifier, with `ctrl` as the fallback when the host is unknown.
+ */
+export declare function registerModBindings<TTarget extends object, TEvent extends KeymapEvent>(keymap: Keymap<TTarget, TEvent>): () => void;