@opentui/keymap 0.2.2 → 0.2.3

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/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

@@ -10,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";
@@ -17,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;

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

@@ -1,4 +1,4 @@
-import type { Keymap, KeymapEvent } from "../../index.js";
+import type { Keymap, KeymapEvent } from "@opentui/keymap";
 /**
  * Warns when a string command name cannot be resolved by registered commands
  * or resolvers.

package/src/extras/binding-sections.d.ts

@@ -1,12 +1,12 @@
-import type { BindingInput, KeyLike, KeymapEvent } from "../types.js";
-export type BindingSectionItem<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> = KeyLike | BindingInput<TTarget, TEvent>;
+import type { Binding, KeyLike, KeymapEvent } from "../types.js";
+export type BindingSectionItem<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> = KeyLike | Binding<TTarget, TEvent>;
 export type BindingValue<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> = false | "none" | BindingSectionItem<TTarget, TEvent> | readonly BindingSectionItem<TTarget, TEvent>[];
 export type BindingSectionConfig<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> = Readonly<Record<string, BindingValue<TTarget, TEvent>>>;
 export type BindingSectionsConfig<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> = Readonly<Record<string, BindingSectionConfig<TTarget, TEvent>>>;
 type LiteralStringKeys<T> = string extends Extract<keyof T, string> ? never : Extract<keyof T, string>;
 export interface ResolvedBindingSections<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent, TSection extends string = string> {
-    sections: Record<TSection, BindingInput<TTarget, TEvent>[]>;
-    get(section: string, cmd: string): readonly BindingInput<TTarget, TEvent>[] | undefined;
+    sections: Record<TSection, Binding<TTarget, TEvent>[]>;
+    get(section: string, cmd: string): readonly Binding<TTarget, TEvent>[] | undefined;
 }
 export interface ResolveBindingSectionsOptions<TSection extends string = string> {
     sections?: readonly TSection[];

package/src/extras/command-bindings.d.ts

@@ -1,4 +1,4 @@
-import type { BindingInput, KeyLike, KeymapEvent } from "../types.js";
+import type { Binding, KeyLike, KeymapEvent } from "../types.js";
 export type CommandBindingMap = Record<string, KeyLike>;
 export interface CommandBindingsOverrideWarning {
     code: "command-binding-override";
@@ -16,4 +16,4 @@ export interface CommandBindingsOptions {
     onWarning?: (warning: CommandBindingsOverrideWarning) => void;
     onError?: (error: CommandBindingsError) => void;
 }
-export declare function commandBindings<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent>(bindings: Readonly<CommandBindingMap>, options?: CommandBindingsOptions): BindingInput<TTarget, TEvent>[];
+export declare function commandBindings<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent>(bindings: Readonly<CommandBindingMap>, options?: CommandBindingsOptions): Binding<TTarget, TEvent>[];

package/src/extras/formatting.d.ts

@@ -5,10 +5,13 @@ export interface KeySequenceFormatPart {
     display: string;
     match?: KeySequencePart["match"];
     tokenName?: string;
+    patternName?: string;
 }
 export type TokenDisplayResolver = Readonly<Record<string, string>> | ((tokenName: string, part: KeySequenceFormatPart) => string | undefined);
+export type PatternDisplayResolver = Readonly<Record<string, string>> | ((patternName: string, part: KeySequenceFormatPart) => string | undefined);
 export interface FormatKeySequenceOptions {
     tokenDisplay?: TokenDisplayResolver;
+    patternDisplay?: PatternDisplayResolver;
     keyNameAliases?: Readonly<Record<string, string>>;
     modifierAliases?: Partial<Record<KeyModifierName, string>>;
     separator?: string;

package/src/extras/graph.d.ts

@@ -0,0 +1,9 @@
+import { type KeymapExtensionProvider } from "../services/extension-context.js";
+import type { KeymapEvent } from "../types.js";
+import type { GraphSnapshot, GraphSnapshotOptions } from "./lib/graph-types.js";
+export type { GraphBinding, GraphCommand, GraphInactiveReason, GraphLayer, GraphSequenceNode, GraphSnapshot, GraphSnapshotOptions, } from "./lib/graph-types.js";
+export interface KeymapGraphExtra<TTarget extends object, TEvent extends KeymapEvent> {
+    getGraphSnapshot(options?: GraphSnapshotOptions<TTarget>): GraphSnapshot<TTarget, TEvent>;
+}
+export declare function getGraphSnapshot<TTarget extends object, TEvent extends KeymapEvent>(keymap: KeymapExtensionProvider<TTarget, TEvent>, options?: GraphSnapshotOptions<TTarget>): GraphSnapshot<TTarget, TEvent>;
+export declare function createGraphExtra<TTarget extends object, TEvent extends KeymapEvent>(keymap: KeymapExtensionProvider<TTarget, TEvent>): KeymapGraphExtra<TTarget, TEvent>;

package/src/extras/graph.js

@@ -0,0 +1,373 @@
+// @bun
+import {
+  KEYMAP_EXTENSION_CONTEXT,
+  childNodes,
+  cloneKeySequence,
+  cloneKeyStroke,
+  getActivationPath,
+  getCaptureNode,
+  getFocusedTargetIfAvailable,
+  getNodePresentation,
+  getNodeSequence,
+  getSortedLayers,
+  isLayerActiveForFocused
+} from "../../chunks/index-frk6sdcd.js";
+
+// src/extras/lib/graph-snapshot.ts
+function hasOwnFocused(options) {
+  return !!options && Object.prototype.hasOwnProperty.call(options, "focused");
+}
+function layerId(layer) {
+  return `layer:${layer.order}`;
+}
+function bindingId(layer, index) {
+  return `binding:${layer.order}:${index}`;
+}
+function commandId(layer, index) {
+  return `command:${layer.order}:${index}`;
+}
+function nodeId(layer, index) {
+  return `node:${layer.order}:${index}`;
+}
+function getSequenceMatches(sequence) {
+  return sequence.map((part) => part.match);
+}
+function isPrefix(left, right) {
+  if (left.length > right.length) {
+    return false;
+  }
+  for (let index = 0;index < left.length; index += 1) {
+    if (left[index] !== right[index]) {
+      return false;
+    }
+  }
+  return true;
+}
+function collectPendingNodes(pending, layerIds, nodeIds, roots) {
+  const pendingIds = new Set;
+  const pendingPathIds = new Set;
+  if (!pending) {
+    return { pending: pendingIds, pendingPath: pendingPathIds };
+  }
+  for (const capture of pending.captures) {
+    const layerGraphId = layerIds.get(capture.layer);
+    if (!layerGraphId) {
+      continue;
+    }
+    const root = roots.get(capture.layer);
+    if (!root) {
+      continue;
+    }
+    let current = getCaptureNode(root, capture) ?? null;
+    const capturedNodeId = current ? nodeIds.get(current) : undefined;
+    if (capturedNodeId) {
+      pendingIds.add(capturedNodeId);
+    }
+    while (current) {
+      const currentNodeId = nodeIds.get(current);
+      if (currentNodeId) {
+        pendingPathIds.add(currentNodeId);
+      }
+      current = current.parent;
+    }
+  }
+  return { pending: pendingIds, pendingPath: pendingPathIds };
+}
+function createGraphSnapshot(options) {
+  const { state, host, conditions, catalog, activation, snapshotOptions } = options;
+  const includeTargets = snapshotOptions?.includeTargets !== false;
+  const currentFocused = getFocusedTargetIfAvailable(host);
+  const focused = hasOwnFocused(snapshotOptions) ? snapshotOptions.focused ?? null : currentFocused;
+  const activeView = catalog.getActiveCommandView(focused);
+  const activeCommandStates = new Set(activeView.entries.map((entry) => entry.commandState));
+  const reachableCommandStates = new Set(activeView.reachable.map((entry) => entry.commandState));
+  const activationPath = getActivationPath(host, focused);
+  const sortedLayers = getSortedLayers(state.layers);
+  const layerStates = new Map;
+  const commandStates = new Map;
+  const bindingStates = new Map;
+  const commandIdsByCommand = new Map;
+  const commandIdsByName = new Map;
+  const nodeIds = new Map;
+  const layerIds = new Map;
+  const layerRoots = new Map;
+  const bindingNodeIds = new Map;
+  const sequenceNodes = [];
+  for (const layer of sortedLayers) {
+    layerRoots.set(layer, layer.root);
+  }
+  for (const layer of sortedLayers) {
+    const currentLayerId = layerId(layer);
+    const targetDestroyed = layer.target ? host.isTargetDestroyed(layer.target) : false;
+    const focusActive = isLayerActiveForFocused(host, layer, focused, activationPath);
+    const enabled = conditions.matchesConditions(layer);
+    const inactiveReasons = [];
+    if (targetDestroyed)
+      inactiveReasons.push("target-destroyed");
+    if (!focusActive)
+      inactiveReasons.push("focus");
+    if (!enabled)
+      inactiveReasons.push("layer-disabled");
+    layerIds.set(layer, currentLayerId);
+    layerStates.set(layer, {
+      layer,
+      id: currentLayerId,
+      focusActive,
+      enabled,
+      active: !targetDestroyed && focusActive && enabled,
+      inactiveReasons
+    });
+  }
+  for (const layer of sortedLayers) {
+    const currentLayerId = layerIds.get(layer);
+    for (const [index, command] of layer.commands.entries()) {
+      const currentCommandId = commandId(layer, index);
+      const idsByCommand = commandIdsByCommand.get(command.command);
+      if (idsByCommand) {
+        idsByCommand.push(currentCommandId);
+      } else {
+        commandIdsByCommand.set(command.command, [currentCommandId]);
+      }
+      const idsByName = commandIdsByName.get(command.command.name);
+      if (idsByName) {
+        idsByName.push(currentCommandId);
+      } else {
+        commandIdsByName.set(command.command.name, [currentCommandId]);
+      }
+      const layerState = layerStates.get(layer);
+      const enabled = conditions.matchesConditions(command);
+      const active = activeCommandStates.has(command);
+      const reachable = reachableCommandStates.has(command);
+      const inactiveReasons = [...layerState.inactiveReasons];
+      if (!enabled) {
+        inactiveReasons.push("command-disabled");
+      }
+      if (active && !reachable) {
+        inactiveReasons.push("shadowed");
+      }
+      commandStates.set(command, {
+        command,
+        id: currentCommandId,
+        layerState,
+        active,
+        reachable,
+        enabled,
+        inactiveReasons
+      });
+    }
+    let nextNodeIndex = 0;
+    const visitNode = (node, parentId) => {
+      const currentNodeId = nodeId(layer, nextNodeIndex);
+      nextNodeIndex += 1;
+      nodeIds.set(node, currentNodeId);
+      for (const binding of node.bindings) {
+        bindingNodeIds.set(binding, currentNodeId);
+      }
+      for (const child of childNodes(node)) {
+        visitNode(child, currentNodeId);
+      }
+    };
+    const root = layerRoots.get(layer);
+    visitNode(root, null);
+    if (!nodeIds.has(root)) {
+      nodeIds.set(root, `${currentLayerId}:root`);
+    }
+  }
+  const stoppedSequences = [];
+  for (const layer of sortedLayers) {
+    const layerState = layerStates.get(layer);
+    for (const [index, binding] of layer.bindings.entries()) {
+      const enabled = conditions.matchesConditions(binding);
+      const commandResolved = catalog.isBindingVisible(binding, focused, activeView);
+      const active = layerState.active && enabled && commandResolved;
+      const matches = getSequenceMatches(binding.sequence);
+      const shadowed = active && stoppedSequences.some((stop) => stop.event === binding.event && isPrefix(stop.matches, matches));
+      const inactiveReasons = [...layerState.inactiveReasons];
+      if (!enabled) {
+        inactiveReasons.push("binding-disabled");
+      }
+      if (!commandResolved) {
+        const unavailable = typeof binding.command === "string" ? catalog.getDispatchUnavailableCommandState(binding.command, focused, false) : undefined;
+        if (unavailable?.reason === "disabled") {
+          inactiveReasons.push("command-disabled");
+        } else if (unavailable?.reason === "inactive") {
+          inactiveReasons.push("command-inactive");
+        } else {
+          inactiveReasons.push("command-unresolved");
+        }
+      }
+      if (shadowed) {
+        inactiveReasons.push("shadowed");
+      }
+      const currentBindingState = {
+        binding,
+        id: bindingId(layer, index),
+        layerState,
+        commandIds: [],
+        enabled,
+        commandResolved,
+        active,
+        reachable: active && !shadowed,
+        shadowed,
+        inactiveReasons
+      };
+      bindingStates.set(binding, currentBindingState);
+      if (active && binding.command !== undefined && !binding.fallthrough) {
+        stoppedSequences.push({ event: binding.event, matches });
+      }
+    }
+  }
+  for (const state2 of bindingStates.values()) {
+    if (typeof state2.binding.command !== "string") {
+      continue;
+    }
+    const ids = new Set(commandIdsByName.get(state2.binding.command) ?? []);
+    const chain = catalog.getResolvedCommandChain(state2.binding.command, focused).entries;
+    for (const entry of chain ?? []) {
+      for (const id of commandIdsByCommand.get(entry.command) ?? []) {
+        ids.add(id);
+      }
+    }
+    state2.commandIds = [...ids];
+  }
+  const pending = focused === currentFocused ? activation.ensureValidPendingSequence() : undefined;
+  const pendingNodes = collectPendingNodes(pending ?? null, layerIds, nodeIds, layerRoots);
+  for (const layer of sortedLayers) {
+    const currentLayerId = layerIds.get(layer);
+    const visitNode = (node, parentId) => {
+      const currentNodeId = nodeIds.get(node);
+      const childIds = childNodes(node).map((child) => nodeIds.get(child)).filter(Boolean);
+      const bindingIds = node.bindings.map((binding) => bindingStates.get(binding)?.id).filter((id) => !!id);
+      const reachableBindingIds = node.reachableBindings.map((binding) => bindingStates.get(binding)?.id).filter((id) => !!id);
+      const sequence = getNodeSequence(node);
+      const presentation = getNodePresentation(node);
+      const active = node.reachableBindings.some((binding) => bindingStates.get(binding)?.active === true);
+      const reachable = node.reachableBindings.some((binding) => bindingStates.get(binding)?.reachable === true);
+      for (let index = 0;index < sequence.length; index += 1) {
+        const sourcePart = node.reachableBindings[0]?.sequence[index];
+        if (sourcePart) {
+          sequence[index] = { ...sourcePart, stroke: cloneKeyStroke(sourcePart.stroke) };
+        }
+      }
+      sequenceNodes.push({
+        id: currentNodeId,
+        layerId: currentLayerId,
+        parentId,
+        childIds,
+        bindingIds,
+        reachableBindingIds,
+        depth: node.depth,
+        sequence,
+        stroke: node.stroke ? cloneKeyStroke(node.stroke) : null,
+        match: node.match,
+        display: presentation.display,
+        tokenName: presentation.tokenName,
+        active,
+        reachable,
+        pending: pendingNodes.pending.has(currentNodeId),
+        pendingPath: pendingNodes.pendingPath.has(currentNodeId)
+      });
+      for (const child of childNodes(node)) {
+        visitNode(child, currentNodeId);
+      }
+    };
+    visitNode(layerRoots.get(layer), null);
+  }
+  const layers = sortedLayers.map((layer) => {
+    const state2 = layerStates.get(layer);
+    return {
+      id: state2.id,
+      order: layer.order,
+      priority: layer.priority,
+      target: includeTargets ? layer.target : undefined,
+      targetMode: layer.targetMode,
+      fields: layer.fields ?? {},
+      attrs: layer.attrs,
+      active: state2.active,
+      focusActive: state2.focusActive,
+      enabled: state2.enabled,
+      inactiveReasons: state2.inactiveReasons,
+      rootNodeId: nodeIds.get(layerRoots.get(layer)),
+      bindingIds: layer.bindings.map((binding) => bindingStates.get(binding).id),
+      commandIds: layer.commands.map((command) => commandStates.get(command).id)
+    };
+  });
+  const commands = [];
+  for (const state2 of commandStates.values()) {
+    commands.push({
+      id: state2.id,
+      layerId: state2.layerState.id,
+      name: state2.command.command.name,
+      command: state2.command.command,
+      fields: state2.command.fields,
+      attrs: state2.command.attrs,
+      target: includeTargets ? state2.layerState.layer.target : undefined,
+      active: state2.active,
+      reachable: state2.reachable,
+      enabled: state2.enabled,
+      inactiveReasons: state2.inactiveReasons
+    });
+  }
+  const bindings = [];
+  for (const state2 of bindingStates.values()) {
+    const binding = state2.binding;
+    bindings.push({
+      id: state2.id,
+      layerId: state2.layerState.id,
+      sourceLayerOrder: binding.sourceLayerOrder,
+      bindingIndex: binding.bindingIndex,
+      nodeId: bindingNodeIds.get(binding),
+      commandIds: state2.commandIds,
+      sequence: cloneKeySequence(binding.sequence),
+      command: binding.command,
+      commandAttrs: catalog.getBindingCommandAttrs(binding, focused, activeView),
+      attrs: binding.attrs,
+      event: binding.event,
+      preventDefault: binding.preventDefault,
+      fallthrough: binding.fallthrough,
+      active: state2.active,
+      reachable: state2.reachable,
+      enabled: state2.enabled,
+      commandResolved: state2.commandResolved,
+      shadowed: state2.shadowed,
+      inactiveReasons: state2.inactiveReasons
+    });
+  }
+  const activeKeys = activation.getActiveKeysForFocused(focused, { includeBindings: true, includeMetadata: true });
+  return {
+    focused: includeTargets ? focused : undefined,
+    pendingSequence: focused === currentFocused ? activation.getPendingSequence() : [],
+    activeKeys,
+    layers,
+    commands,
+    bindings,
+    sequenceNodes
+  };
+}
+
+// src/extras/graph.ts
+function getGraphSnapshot(keymap, options) {
+  const context = keymap[KEYMAP_EXTENSION_CONTEXT]();
+  return createGraphSnapshot({
+    state: context.state,
+    host: context.host,
+    conditions: context.conditions,
+    catalog: context.catalog,
+    activation: context.activation,
+    snapshotOptions: options
+  });
+}
+function createGraphExtra(keymap) {
+  return {
+    getGraphSnapshot(options) {
+      return getGraphSnapshot(keymap, options);
+    }
+  };
+}
+export {
+  getGraphSnapshot,
+  createGraphExtra
+};
+
+//# debugId=68A22ECA1358D66B64756E2164756E21
+//# sourceMappingURL=graph.js.map