@opentui/keymap 0.2.1 → 0.2.3

package/src/extras/index.js

@@ -0,0 +1,239 @@
+// @bun
+// src/extras/binding-sections.ts
+var hasOwn = Object.prototype.hasOwnProperty;
+function isObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isKeyLike(value) {
+  return typeof value === "string" || isObject(value);
+}
+function cloneKeyLike(key) {
+  if (typeof key === "string") {
+    return key;
+  }
+  return { ...key };
+}
+function invalidBindingValue(section, command, index) {
+  const location = index === undefined ? `"${section}.${command}"` : `"${section}.${command}" at index ${index}`;
+  return new Error(`Invalid binding value for ${location}: expected false, a key, a binding object, or an array of keys/binding objects`);
+}
+function resolveBindingItem(section, command, item, index) {
+  if (!isKeyLike(item)) {
+    throw invalidBindingValue(section, command, index);
+  }
+  if (typeof item === "string" || !("key" in item)) {
+    return {
+      key: cloneKeyLike(item),
+      cmd: command
+    };
+  }
+  const key = item.key;
+  if (!isKeyLike(key)) {
+    throw invalidBindingValue(section, command, index);
+  }
+  return {
+    ...item,
+    key: cloneKeyLike(key),
+    cmd: command
+  };
+}
+function resolveBindingValue(section, command, value) {
+  if (value === false || value === "none") {
+    return;
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return;
+    }
+    const items = value;
+    const bindings = new Array(items.length);
+    for (let index = 0;index < items.length; index += 1) {
+      bindings[index] = resolveBindingItem(section, command, items[index], index);
+    }
+    return bindings;
+  }
+  return [resolveBindingItem(section, command, value)];
+}
+function resolveBindingSections(config, options) {
+  const sections = {};
+  const lookups = new Map;
+  for (const section of options?.sections ?? []) {
+    sections[section] = [];
+    lookups.set(section, new Map);
+  }
+  for (const section in config) {
+    if (!hasOwn.call(config, section)) {
+      continue;
+    }
+    const sectionConfig = config[section];
+    if (!isObject(sectionConfig)) {
+      throw new Error(`Invalid binding section "${section}": expected an object`);
+    }
+    const sectionLookup = new Map;
+    for (const rawCommand in sectionConfig) {
+      if (!hasOwn.call(sectionConfig, rawCommand)) {
+        continue;
+      }
+      const command = rawCommand.trim();
+      const bindings = resolveBindingValue(section, command, sectionConfig[rawCommand]);
+      if (!bindings) {
+        sectionLookup.delete(command);
+        continue;
+      }
+      sectionLookup.set(command, bindings);
+    }
+    let sectionBindingCount = 0;
+    for (const bindings of sectionLookup.values()) {
+      sectionBindingCount += bindings.length;
+    }
+    const sectionBindings = new Array(sectionBindingCount);
+    let bindingIndex = 0;
+    for (const bindings of sectionLookup.values()) {
+      for (let index = 0;index < bindings.length; index += 1) {
+        sectionBindings[bindingIndex] = bindings[index];
+        bindingIndex += 1;
+      }
+    }
+    sections[section] = sectionBindings;
+    lookups.set(section, sectionLookup);
+  }
+  return {
+    sections,
+    get(section, cmd) {
+      return lookups.get(section)?.get(cmd.trim());
+    }
+  };
+}
+// src/extras/command-bindings.ts
+function isCommandBindingKey(value) {
+  return typeof value === "string" || !!value && typeof value === "object" && !Array.isArray(value);
+}
+function commandBindings(bindings, options) {
+  const normalized = [];
+  const indexesByCommand = new Map;
+  for (const [command, key] of Object.entries(bindings)) {
+    if (!isCommandBindingKey(key)) {
+      const error = new Error(`Invalid command binding for "${command}": command bindings must map command strings to key strings or keystroke objects`);
+      options?.onError?.({
+        code: "invalid-command-binding",
+        command,
+        value: key,
+        reason: error
+      });
+      continue;
+    }
+    const normalizedCommand = command.trim();
+    const nextBinding = {
+      key: typeof key === "string" ? key : { ...key },
+      cmd: normalizedCommand
+    };
+    const existingIndex = indexesByCommand.get(normalizedCommand);
+    if (existingIndex !== undefined) {
+      const previousBinding = normalized[existingIndex];
+      options?.onWarning?.({
+        code: "command-binding-override",
+        command: normalizedCommand,
+        previousKey: previousBinding.key,
+        nextKey: nextBinding.key
+      });
+      normalized[existingIndex] = nextBinding;
+      continue;
+    }
+    indexesByCommand.set(normalizedCommand, normalized.length);
+    normalized.push(nextBinding);
+  }
+  return normalized;
+}
+// src/extras/formatting.ts
+function formatStroke(part, options) {
+  if (part.tokenName) {
+    const tokenDisplay = options.tokenDisplay;
+    if (!tokenDisplay)
+      return part.display;
+    if (typeof tokenDisplay === "function")
+      return tokenDisplay(part.tokenName, part) ?? part.display;
+    return tokenDisplay[part.tokenName] ?? part.display;
+  }
+  if (part.patternName) {
+    const patternDisplay = options.patternDisplay;
+    if (!patternDisplay)
+      return part.display;
+    if (typeof patternDisplay === "function")
+      return patternDisplay(part.patternName, part) ?? part.display;
+    return patternDisplay[part.patternName] ?? part.display;
+  }
+  if (!options.keyNameAliases && !options.modifierAliases)
+    return part.display;
+  const stroke = part.stroke;
+  const modifierAliases = options.modifierAliases;
+  let formatted = "";
+  let pieceCount = 0;
+  if (stroke.ctrl) {
+    formatted = modifierAliases?.ctrl ?? "ctrl";
+    pieceCount = 1;
+  }
+  if (stroke.shift) {
+    const alias = modifierAliases?.shift ?? "shift";
+    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`;
+    pieceCount += 1;
+  }
+  if (stroke.meta) {
+    const alias = modifierAliases?.meta ?? "meta";
+    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`;
+    pieceCount += 1;
+  }
+  if (stroke.super) {
+    const alias = modifierAliases?.super ?? "super";
+    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`;
+    pieceCount += 1;
+  }
+  if (stroke.hyper) {
+    const alias = modifierAliases?.hyper ?? "hyper";
+    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`;
+    pieceCount += 1;
+  }
+  const name = stroke.name === "return" ? "enter" : stroke.name;
+  const keyName = options.keyNameAliases?.[name] ?? name;
+  return pieceCount === 0 ? keyName : `${formatted}+${keyName}`;
+}
+function formatKeySequence(parts, options = {}) {
+  if (!parts || parts.length === 0)
+    return "";
+  const separator = options.separator ?? " ";
+  let formatted = formatStroke(parts[0], options);
+  for (let index = 1;index < parts.length; index += 1) {
+    formatted += separator + formatStroke(parts[index], options);
+  }
+  return formatted;
+}
+function formatCommandBindings(bindings, options = {}) {
+  if (!bindings?.length)
+    return;
+  const bindingSeparator = options.bindingSeparator ?? ", ";
+  const dedupe = options.dedupe !== false;
+  const seen = dedupe ? new Set : undefined;
+  let formatted = "";
+  let itemCount = 0;
+  for (const binding of bindings) {
+    const item = formatKeySequence(binding.sequence, options);
+    if (!item)
+      continue;
+    if (seen) {
+      if (seen.has(item))
+        continue;
+      seen.add(item);
+    }
+    formatted = itemCount === 0 ? item : `${formatted}${bindingSeparator}${item}`;
+    itemCount += 1;
+  }
+  return formatted;
+}
+export {
+  resolveBindingSections,
+  formatKeySequence,
+  formatCommandBindings,
+  commandBindings
+};
+
+//# debugId=7BE7E370039A4BC264756E2164756E21
+//# sourceMappingURL=index.js.map

package/src/extras/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/extras/binding-sections.ts", "../src/extras/command-bindings.ts", "../src/extras/formatting.ts"],
+  "sourcesContent": [
+    "// Opinionated config-to-keymap transformation helper. Treat this as one\n// practical shape you can copy and adjust for application-specific needs.\nimport type { Binding, KeyLike, KeymapEvent } from \"../types.js\"\n\nexport type BindingSectionItem<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> =\n  | KeyLike\n  | Binding<TTarget, TEvent>\n\nexport type BindingValue<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> =\n  | false\n  | \"none\"\n  | BindingSectionItem<TTarget, TEvent>\n  | readonly BindingSectionItem<TTarget, TEvent>[]\n\nexport type BindingSectionConfig<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> = Readonly<\n  Record<string, BindingValue<TTarget, TEvent>>\n>\n\nexport type BindingSectionsConfig<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> = Readonly<\n  Record<string, BindingSectionConfig<TTarget, TEvent>>\n>\n\ntype LiteralStringKeys<T> = string extends Extract<keyof T, string> ? never : Extract<keyof T, string>\n\nconst hasOwn = Object.prototype.hasOwnProperty\n\nexport interface ResolvedBindingSections<\n  TTarget extends object = object,\n  TEvent extends KeymapEvent = KeymapEvent,\n  TSection extends string = string,\n> {\n  sections: Record<TSection, Binding<TTarget, TEvent>[]>\n  get(section: string, cmd: string): readonly Binding<TTarget, TEvent>[] | undefined\n}\n\nexport interface ResolveBindingSectionsOptions<TSection extends string = string> {\n  sections?: readonly TSection[]\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value)\n}\n\nfunction isKeyLike(value: unknown): value is KeyLike {\n  return typeof value === \"string\" || isObject(value)\n}\n\nfunction cloneKeyLike(key: KeyLike): KeyLike {\n  if (typeof key === \"string\") {\n    return key\n  }\n\n  return { ...key }\n}\n\nfunction invalidBindingValue(section: string, command: string, index?: number): Error {\n  const location = index === undefined ? `\"${section}.${command}\"` : `\"${section}.${command}\" at index ${index}`\n  return new Error(\n    `Invalid binding value for ${location}: expected false, a key, a binding object, or an array of keys/binding objects`,\n  )\n}\n\nfunction resolveBindingItem<TTarget extends object, TEvent extends KeymapEvent>(\n  section: string,\n  command: string,\n  item: BindingSectionItem<TTarget, TEvent>,\n  index?: number,\n): Binding<TTarget, TEvent> {\n  if (!isKeyLike(item)) {\n    throw invalidBindingValue(section, command, index)\n  }\n\n  if (typeof item === \"string\" || !(\"key\" in item)) {\n    return {\n      key: cloneKeyLike(item),\n      cmd: command,\n    }\n  }\n\n  const key = item.key\n  if (!isKeyLike(key)) {\n    throw invalidBindingValue(section, command, index)\n  }\n\n  return {\n    ...item,\n    key: cloneKeyLike(key),\n    cmd: command,\n  }\n}\n\nfunction resolveBindingValue<TTarget extends object, TEvent extends KeymapEvent>(\n  section: string,\n  command: string,\n  value: BindingValue<TTarget, TEvent>,\n): Binding<TTarget, TEvent>[] | undefined {\n  if (value === false || value === \"none\") {\n    return undefined\n  }\n\n  if (Array.isArray(value)) {\n    if (value.length === 0) {\n      return undefined\n    }\n\n    const items = value as readonly BindingSectionItem<TTarget, TEvent>[]\n    const bindings = new Array<Binding<TTarget, TEvent>>(items.length)\n    for (let index = 0; index < items.length; index += 1) {\n      bindings[index] = resolveBindingItem(section, command, items[index]!, index)\n    }\n\n    return bindings\n  }\n\n  return [resolveBindingItem(section, command, value as BindingSectionItem<TTarget, TEvent>)]\n}\n\nexport function resolveBindingSections<\n  TTarget extends object = object,\n  TEvent extends KeymapEvent = KeymapEvent,\n  const TConfig extends BindingSectionsConfig<TTarget, TEvent> = BindingSectionsConfig<TTarget, TEvent>,\n  const TSection extends string = string,\n>(\n  config: TConfig,\n  options: ResolveBindingSectionsOptions<TSection> & { sections: readonly TSection[] },\n): ResolvedBindingSections<TTarget, TEvent, TSection | LiteralStringKeys<TConfig>>\nexport function resolveBindingSections<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent>(\n  config: BindingSectionsConfig<TTarget, TEvent>,\n  options?: ResolveBindingSectionsOptions,\n): ResolvedBindingSections<TTarget, TEvent>\nexport function resolveBindingSections<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent>(\n  config: BindingSectionsConfig<TTarget, TEvent>,\n  options?: ResolveBindingSectionsOptions,\n): ResolvedBindingSections<TTarget, TEvent> {\n  const sections: Record<string, Binding<TTarget, TEvent>[]> = {}\n  const lookups = new Map<string, Map<string, Binding<TTarget, TEvent>[]>>()\n\n  for (const section of options?.sections ?? []) {\n    sections[section] = []\n    lookups.set(section, new Map())\n  }\n\n  // Own-property loops avoid Object.entries allocations while still ignoring inherited config.\n  for (const section in config) {\n    if (!hasOwn.call(config, section)) {\n      continue\n    }\n\n    const sectionConfig = config[section]\n    if (!isObject(sectionConfig)) {\n      throw new Error(`Invalid binding section \"${section}\": expected an object`)\n    }\n\n    const sectionLookup = new Map<string, Binding<TTarget, TEvent>[]>()\n\n    for (const rawCommand in sectionConfig) {\n      if (!hasOwn.call(sectionConfig, rawCommand)) {\n        continue\n      }\n\n      const command = rawCommand.trim()\n      const bindings = resolveBindingValue(section, command, sectionConfig[rawCommand]!)\n\n      if (!bindings) {\n        sectionLookup.delete(command)\n        continue\n      }\n\n      sectionLookup.set(command, bindings)\n    }\n\n    // Manual flattening avoids Array.flat allocations on large generated configs.\n    let sectionBindingCount = 0\n    for (const bindings of sectionLookup.values()) {\n      sectionBindingCount += bindings.length\n    }\n\n    const sectionBindings = new Array<Binding<TTarget, TEvent>>(sectionBindingCount)\n    let bindingIndex = 0\n    for (const bindings of sectionLookup.values()) {\n      for (let index = 0; index < bindings.length; index += 1) {\n        sectionBindings[bindingIndex] = bindings[index]!\n        bindingIndex += 1\n      }\n    }\n\n    sections[section] = sectionBindings\n    lookups.set(section, sectionLookup)\n  }\n\n  return {\n    sections,\n    get(section, cmd) {\n      return lookups.get(section)?.get(cmd.trim())\n    },\n  }\n}\n",
+    "import type { Binding, KeyLike, KeymapEvent } from \"../types.js\"\n\nexport type CommandBindingMap = Record<string, KeyLike>\n\nexport interface CommandBindingsOverrideWarning {\n  code: \"command-binding-override\"\n  command: string\n  previousKey: KeyLike\n  nextKey: KeyLike\n}\n\nexport interface CommandBindingsError {\n  code: \"invalid-command-binding\"\n  command: string\n  value: unknown\n  reason: Error\n}\n\nexport interface CommandBindingsOptions {\n  onWarning?: (warning: CommandBindingsOverrideWarning) => void\n  onError?: (error: CommandBindingsError) => void\n}\n\nfunction isCommandBindingKey(value: unknown): value is KeyLike {\n  return typeof value === \"string\" || (!!value && typeof value === \"object\" && !Array.isArray(value))\n}\n\nexport function commandBindings<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent>(\n  bindings: Readonly<CommandBindingMap>,\n  options?: CommandBindingsOptions,\n): Binding<TTarget, TEvent>[] {\n  const normalized: Binding<TTarget, TEvent>[] = []\n  const indexesByCommand = new Map<string, number>()\n\n  for (const [command, key] of Object.entries(bindings)) {\n    if (!isCommandBindingKey(key)) {\n      const error = new Error(\n        `Invalid command binding for \"${command}\": command bindings must map command strings to key strings or keystroke objects`,\n      )\n\n      options?.onError?.({\n        code: \"invalid-command-binding\",\n        command,\n        value: key,\n        reason: error,\n      })\n      continue\n    }\n\n    const normalizedCommand = command.trim()\n\n    const nextBinding = {\n      key: typeof key === \"string\" ? key : { ...key },\n      cmd: normalizedCommand,\n    } satisfies Binding<TTarget, TEvent>\n\n    const existingIndex = indexesByCommand.get(normalizedCommand)\n    if (existingIndex !== undefined) {\n      const previousBinding = normalized[existingIndex]!\n      options?.onWarning?.({\n        code: \"command-binding-override\",\n        command: normalizedCommand,\n        previousKey: previousBinding.key,\n        nextKey: nextBinding.key,\n      })\n      normalized[existingIndex] = nextBinding\n      continue\n    }\n\n    indexesByCommand.set(normalizedCommand, normalized.length)\n    normalized.push(nextBinding)\n  }\n\n  return normalized\n}\n",
+    "import type { KeySequencePart } from \"../types.js\"\n\nexport type KeyModifierName = \"ctrl\" | \"shift\" | \"meta\" | \"super\" | \"hyper\"\n\nexport interface KeySequenceFormatPart {\n  stroke: KeySequencePart[\"stroke\"]\n  display: string\n  match?: KeySequencePart[\"match\"]\n  tokenName?: string\n  patternName?: string\n}\n\nexport type TokenDisplayResolver =\n  | Readonly<Record<string, string>>\n  | ((tokenName: string, part: KeySequenceFormatPart) => string | undefined)\n\nexport type PatternDisplayResolver =\n  | Readonly<Record<string, string>>\n  | ((patternName: string, part: KeySequenceFormatPart) => string | undefined)\n\nexport interface FormatKeySequenceOptions {\n  tokenDisplay?: TokenDisplayResolver\n  patternDisplay?: PatternDisplayResolver\n  keyNameAliases?: Readonly<Record<string, string>>\n  modifierAliases?: Partial<Record<KeyModifierName, string>>\n  separator?: string\n}\n\nexport interface FormatCommandBindingsOptions extends FormatKeySequenceOptions {\n  bindingSeparator?: string\n  dedupe?: boolean\n}\n\nexport interface SequenceBindingLike {\n  sequence: readonly KeySequenceFormatPart[]\n}\n\nfunction formatStroke(part: KeySequenceFormatPart, options: FormatKeySequenceOptions): string {\n  if (part.tokenName) {\n    const tokenDisplay = options.tokenDisplay\n    if (!tokenDisplay) return part.display\n    if (typeof tokenDisplay === \"function\") return tokenDisplay(part.tokenName, part) ?? part.display\n    return tokenDisplay[part.tokenName] ?? part.display\n  }\n\n  if (part.patternName) {\n    const patternDisplay = options.patternDisplay\n    if (!patternDisplay) return part.display\n    if (typeof patternDisplay === \"function\") return patternDisplay(part.patternName, part) ?? part.display\n    return patternDisplay[part.patternName] ?? part.display\n  }\n\n  if (!options.keyNameAliases && !options.modifierAliases) return part.display\n\n  // This is on the command-palette hot path; build directly to avoid per-stroke arrays.\n  const stroke = part.stroke\n  const modifierAliases = options.modifierAliases\n  let formatted = \"\"\n  let pieceCount = 0\n\n  if (stroke.ctrl) {\n    formatted = modifierAliases?.ctrl ?? \"ctrl\"\n    pieceCount = 1\n  }\n\n  if (stroke.shift) {\n    const alias = modifierAliases?.shift ?? \"shift\"\n    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`\n    pieceCount += 1\n  }\n\n  if (stroke.meta) {\n    const alias = modifierAliases?.meta ?? \"meta\"\n    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`\n    pieceCount += 1\n  }\n\n  if (stroke.super) {\n    const alias = modifierAliases?.super ?? \"super\"\n    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`\n    pieceCount += 1\n  }\n\n  if (stroke.hyper) {\n    const alias = modifierAliases?.hyper ?? \"hyper\"\n    formatted = pieceCount === 0 ? alias : `${formatted}+${alias}`\n    pieceCount += 1\n  }\n\n  const name = stroke.name === \"return\" ? \"enter\" : stroke.name\n  const keyName = options.keyNameAliases?.[name] ?? name\n  return pieceCount === 0 ? keyName : `${formatted}+${keyName}`\n}\n\nexport function formatKeySequence(\n  parts: readonly KeySequenceFormatPart[] | undefined,\n  options: FormatKeySequenceOptions = {},\n): string {\n  if (!parts || parts.length === 0) return \"\"\n\n  // Avoid map/join allocation here; binding-list formatting calls this repeatedly.\n  const separator = options.separator ?? \" \"\n  let formatted = formatStroke(parts[0]!, options)\n  for (let index = 1; index < parts.length; index += 1) {\n    formatted += separator + formatStroke(parts[index]!, options)\n  }\n\n  return formatted\n}\n\nexport function formatCommandBindings(\n  bindings: readonly SequenceBindingLike[] | undefined,\n  options: FormatCommandBindingsOptions = {},\n): string | undefined {\n  if (!bindings?.length) return\n\n  const bindingSeparator = options.bindingSeparator ?? \", \"\n  const dedupe = options.dedupe !== false\n  const seen = dedupe ? new Set<string>() : undefined\n  let formatted = \"\"\n  let itemCount = 0\n\n  // One pass keeps dedupe, filtering, and joining allocation-light for large binding lists.\n  for (const binding of bindings) {\n    const item = formatKeySequence(binding.sequence, options)\n    if (!item) continue\n\n    if (seen) {\n      if (seen.has(item)) continue\n      seen.add(item)\n    }\n\n    formatted = itemCount === 0 ? item : `${formatted}${bindingSeparator}${item}`\n    itemCount += 1\n  }\n\n  return formatted\n}\n"
+  ],
+  "mappings": ";;AAwBA,IAAM,SAAS,OAAO,UAAU;AAehC,SAAS,QAAQ,CAAC,OAAkD;AAAA,EAClE,OAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAAA;AAGrE,SAAS,SAAS,CAAC,OAAkC;AAAA,EACnD,OAAO,OAAO,UAAU,YAAY,SAAS,KAAK;AAAA;AAGpD,SAAS,YAAY,CAAC,KAAuB;AAAA,EAC3C,IAAI,OAAO,QAAQ,UAAU;AAAA,IAC3B,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,KAAK,IAAI;AAAA;AAGlB,SAAS,mBAAmB,CAAC,SAAiB,SAAiB,OAAuB;AAAA,EACpF,MAAM,WAAW,UAAU,YAAY,IAAI,WAAW,aAAa,IAAI,WAAW,qBAAqB;AAAA,EACvG,OAAO,IAAI,MACT,6BAA6B,wFAC/B;AAAA;AAGF,SAAS,kBAAsE,CAC7E,SACA,SACA,MACA,OAC0B;AAAA,EAC1B,IAAI,CAAC,UAAU,IAAI,GAAG;AAAA,IACpB,MAAM,oBAAoB,SAAS,SAAS,KAAK;AAAA,EACnD;AAAA,EAEA,IAAI,OAAO,SAAS,YAAY,EAAE,SAAS,OAAO;AAAA,IAChD,OAAO;AAAA,MACL,KAAK,aAAa,IAAI;AAAA,MACtB,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,KAAK;AAAA,EACjB,IAAI,CAAC,UAAU,GAAG,GAAG;AAAA,IACnB,MAAM,oBAAoB,SAAS,SAAS,KAAK;AAAA,EACnD;AAAA,EAEA,OAAO;AAAA,OACF;AAAA,IACH,KAAK,aAAa,GAAG;AAAA,IACrB,KAAK;AAAA,EACP;AAAA;AAGF,SAAS,mBAAuE,CAC9E,SACA,SACA,OACwC;AAAA,EACxC,IAAI,UAAU,SAAS,UAAU,QAAQ;AAAA,IACvC;AAAA,EACF;AAAA,EAEA,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,IACxB,IAAI,MAAM,WAAW,GAAG;AAAA,MACtB;AAAA,IACF;AAAA,IAEA,MAAM,QAAQ;AAAA,IACd,MAAM,WAAW,IAAI,MAAgC,MAAM,MAAM;AAAA,IACjE,SAAS,QAAQ,EAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AAAA,MACpD,SAAS,SAAS,mBAAmB,SAAS,SAAS,MAAM,QAAS,KAAK;AAAA,IAC7E;AAAA,IAEA,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,CAAC,mBAAmB,SAAS,SAAS,KAA4C,CAAC;AAAA;AAgBrF,SAAS,sBAAiG,CAC/G,QACA,SAC0C;AAAA,EAC1C,MAAM,WAAuD,CAAC;AAAA,EAC9D,MAAM,UAAU,IAAI;AAAA,EAEpB,WAAW,WAAW,SAAS,YAAY,CAAC,GAAG;AAAA,IAC7C,SAAS,WAAW,CAAC;AAAA,IACrB,QAAQ,IAAI,SAAS,IAAI,GAAK;AAAA,EAChC;AAAA,EAGA,WAAW,WAAW,QAAQ;AAAA,IAC5B,IAAI,CAAC,OAAO,KAAK,QAAQ,OAAO,GAAG;AAAA,MACjC;AAAA,IACF;AAAA,IAEA,MAAM,gBAAgB,OAAO;AAAA,IAC7B,IAAI,CAAC,SAAS,aAAa,GAAG;AAAA,MAC5B,MAAM,IAAI,MAAM,4BAA4B,8BAA8B;AAAA,IAC5E;AAAA,IAEA,MAAM,gBAAgB,IAAI;AAAA,IAE1B,WAAW,cAAc,eAAe;AAAA,MACtC,IAAI,CAAC,OAAO,KAAK,eAAe,UAAU,GAAG;AAAA,QAC3C;AAAA,MACF;AAAA,MAEA,MAAM,UAAU,WAAW,KAAK;AAAA,MAChC,MAAM,WAAW,oBAAoB,SAAS,SAAS,cAAc,WAAY;AAAA,MAEjF,IAAI,CAAC,UAAU;AAAA,QACb,cAAc,OAAO,OAAO;AAAA,QAC5B;AAAA,MACF;AAAA,MAEA,cAAc,IAAI,SAAS,QAAQ;AAAA,IACrC;AAAA,IAGA,IAAI,sBAAsB;AAAA,IAC1B,WAAW,YAAY,cAAc,OAAO,GAAG;AAAA,MAC7C,uBAAuB,SAAS;AAAA,IAClC;AAAA,IAEA,MAAM,kBAAkB,IAAI,MAAgC,mBAAmB;AAAA,IAC/E,IAAI,eAAe;AAAA,IACnB,WAAW,YAAY,cAAc,OAAO,GAAG;AAAA,MAC7C,SAAS,QAAQ,EAAG,QAAQ,SAAS,QAAQ,SAAS,GAAG;AAAA,QACvD,gBAAgB,gBAAgB,SAAS;AAAA,QACzC,gBAAgB;AAAA,MAClB;AAAA,IACF;AAAA,IAEA,SAAS,WAAW;AAAA,IACpB,QAAQ,IAAI,SAAS,aAAa;AAAA,EACpC;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA,GAAG,CAAC,SAAS,KAAK;AAAA,MAChB,OAAO,QAAQ,IAAI,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC;AAAA;AAAA,EAE/C;AAAA;;AC5KF,SAAS,mBAAmB,CAAC,OAAkC;AAAA,EAC7D,OAAO,OAAO,UAAU,YAAa,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAAA;AAG5F,SAAS,eAA0F,CACxG,UACA,SAC4B;AAAA,EAC5B,MAAM,aAAyC,CAAC;AAAA,EAChD,MAAM,mBAAmB,IAAI;AAAA,EAE7B,YAAY,SAAS,QAAQ,OAAO,QAAQ,QAAQ,GAAG;AAAA,IACrD,IAAI,CAAC,oBAAoB,GAAG,GAAG;AAAA,MAC7B,MAAM,QAAQ,IAAI,MAChB,gCAAgC,yFAClC;AAAA,MAEA,SAAS,UAAU;AAAA,QACjB,MAAM;AAAA,QACN;AAAA,QACA,OAAO;AAAA,QACP,QAAQ;AAAA,MACV,CAAC;AAAA,MACD;AAAA,IACF;AAAA,IAEA,MAAM,oBAAoB,QAAQ,KAAK;AAAA,IAEvC,MAAM,cAAc;AAAA,MAClB,KAAK,OAAO,QAAQ,WAAW,MAAM,KAAK,IAAI;AAAA,MAC9C,KAAK;AAAA,IACP;AAAA,IAEA,MAAM,gBAAgB,iBAAiB,IAAI,iBAAiB;AAAA,IAC5D,IAAI,kBAAkB,WAAW;AAAA,MAC/B,MAAM,kBAAkB,WAAW;AAAA,MACnC,SAAS,YAAY;AAAA,QACnB,MAAM;AAAA,QACN,SAAS;AAAA,QACT,aAAa,gBAAgB;AAAA,QAC7B,SAAS,YAAY;AAAA,MACvB,CAAC;AAAA,MACD,WAAW,iBAAiB;AAAA,MAC5B;AAAA,IACF;AAAA,IAEA,iBAAiB,IAAI,mBAAmB,WAAW,MAAM;AAAA,IACzD,WAAW,KAAK,WAAW;AAAA,EAC7B;AAAA,EAEA,OAAO;AAAA;;ACpCT,SAAS,YAAY,CAAC,MAA6B,SAA2C;AAAA,EAC5F,IAAI,KAAK,WAAW;AAAA,IAClB,MAAM,eAAe,QAAQ;AAAA,IAC7B,IAAI,CAAC;AAAA,MAAc,OAAO,KAAK;AAAA,IAC/B,IAAI,OAAO,iBAAiB;AAAA,MAAY,OAAO,aAAa,KAAK,WAAW,IAAI,KAAK,KAAK;AAAA,IAC1F,OAAO,aAAa,KAAK,cAAc,KAAK;AAAA,EAC9C;AAAA,EAEA,IAAI,KAAK,aAAa;AAAA,IACpB,MAAM,iBAAiB,QAAQ;AAAA,IAC/B,IAAI,CAAC;AAAA,MAAgB,OAAO,KAAK;AAAA,IACjC,IAAI,OAAO,mBAAmB;AAAA,MAAY,OAAO,eAAe,KAAK,aAAa,IAAI,KAAK,KAAK;AAAA,IAChG,OAAO,eAAe,KAAK,gBAAgB,KAAK;AAAA,EAClD;AAAA,EAEA,IAAI,CAAC,QAAQ,kBAAkB,CAAC,QAAQ;AAAA,IAAiB,OAAO,KAAK;AAAA,EAGrE,MAAM,SAAS,KAAK;AAAA,EACpB,MAAM,kBAAkB,QAAQ;AAAA,EAChC,IAAI,YAAY;AAAA,EAChB,IAAI,aAAa;AAAA,EAEjB,IAAI,OAAO,MAAM;AAAA,IACf,YAAY,iBAAiB,QAAQ;AAAA,IACrC,aAAa;AAAA,EACf;AAAA,EAEA,IAAI,OAAO,OAAO;AAAA,IAChB,MAAM,QAAQ,iBAAiB,SAAS;AAAA,IACxC,YAAY,eAAe,IAAI,QAAQ,GAAG,aAAa;AAAA,IACvD,cAAc;AAAA,EAChB;AAAA,EAEA,IAAI,OAAO,MAAM;AAAA,IACf,MAAM,QAAQ,iBAAiB,QAAQ;AAAA,IACvC,YAAY,eAAe,IAAI,QAAQ,GAAG,aAAa;AAAA,IACvD,cAAc;AAAA,EAChB;AAAA,EAEA,IAAI,OAAO,OAAO;AAAA,IAChB,MAAM,QAAQ,iBAAiB,SAAS;AAAA,IACxC,YAAY,eAAe,IAAI,QAAQ,GAAG,aAAa;AAAA,IACvD,cAAc;AAAA,EAChB;AAAA,EAEA,IAAI,OAAO,OAAO;AAAA,IAChB,MAAM,QAAQ,iBAAiB,SAAS;AAAA,IACxC,YAAY,eAAe,IAAI,QAAQ,GAAG,aAAa;AAAA,IACvD,cAAc;AAAA,EAChB;AAAA,EAEA,MAAM,OAAO,OAAO,SAAS,WAAW,UAAU,OAAO;AAAA,EACzD,MAAM,UAAU,QAAQ,iBAAiB,SAAS;AAAA,EAClD,OAAO,eAAe,IAAI,UAAU,GAAG,aAAa;AAAA;AAG/C,SAAS,iBAAiB,CAC/B,OACA,UAAoC,CAAC,GAC7B;AAAA,EACR,IAAI,CAAC,SAAS,MAAM,WAAW;AAAA,IAAG,OAAO;AAAA,EAGzC,MAAM,YAAY,QAAQ,aAAa;AAAA,EACvC,IAAI,YAAY,aAAa,MAAM,IAAK,OAAO;AAAA,EAC/C,SAAS,QAAQ,EAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AAAA,IACpD,aAAa,YAAY,aAAa,MAAM,QAAS,OAAO;AAAA,EAC9D;AAAA,EAEA,OAAO;AAAA;AAGF,SAAS,qBAAqB,CACnC,UACA,UAAwC,CAAC,GACrB;AAAA,EACpB,IAAI,CAAC,UAAU;AAAA,IAAQ;AAAA,EAEvB,MAAM,mBAAmB,QAAQ,oBAAoB;AAAA,EACrD,MAAM,SAAS,QAAQ,WAAW;AAAA,EAClC,MAAM,OAAO,SAAS,IAAI,MAAgB;AAAA,EAC1C,IAAI,YAAY;AAAA,EAChB,IAAI,YAAY;AAAA,EAGhB,WAAW,WAAW,UAAU;AAAA,IAC9B,MAAM,OAAO,kBAAkB,QAAQ,UAAU,OAAO;AAAA,IACxD,IAAI,CAAC;AAAA,MAAM;AAAA,IAEX,IAAI,MAAM;AAAA,MACR,IAAI,KAAK,IAAI,IAAI;AAAA,QAAG;AAAA,MACpB,KAAK,IAAI,IAAI;AAAA,IACf;AAAA,IAEA,YAAY,cAAc,IAAI,OAAO,GAAG,YAAY,mBAAmB;AAAA,IACvE,aAAa;AAAA,EACf;AAAA,EAEA,OAAO;AAAA;",
+  "debugId": "7BE7E370039A4BC264756E2164756E21",
+  "names": []
+}

package/src/extras/lib/graph-snapshot.d.ts

@@ -0,0 +1,14 @@
+import type { ActivationService } from "../../services/activation.js";
+import type { CommandCatalogService } from "../../services/command-catalog.js";
+import type { ConditionService } from "../../services/conditions.js";
+import type { State } from "../../services/state.js";
+import type { KeymapEvent, KeymapHost } from "../../types.js";
+import type { GraphSnapshot, GraphSnapshotOptions } from "./graph-types.js";
+export declare function createGraphSnapshot<TTarget extends object, TEvent extends KeymapEvent>(options: {
+    state: State<TTarget, TEvent>;
+    host: KeymapHost<TTarget, TEvent>;
+    conditions: ConditionService<TTarget, TEvent>;
+    catalog: CommandCatalogService<TTarget, TEvent>;
+    activation: ActivationService<TTarget, TEvent>;
+    snapshotOptions?: GraphSnapshotOptions<TTarget>;
+}): GraphSnapshot<TTarget, TEvent>;

package/src/extras/lib/graph-types.d.ts

@@ -0,0 +1,83 @@
+import type { ActiveKey, Attributes, BindingCommand, BindingEvent, Command, KeymapEvent, KeyMatch, KeySequencePart, NormalizedKeyStroke, TargetMode } from "../../types.js";
+export interface GraphSnapshotOptions<TTarget extends object = object> {
+    focused?: TTarget | null;
+    includeTargets?: boolean;
+}
+export type GraphInactiveReason = "focus" | "target-destroyed" | "layer-disabled" | "binding-disabled" | "command-disabled" | "command-inactive" | "command-unresolved" | "shadowed";
+export interface GraphLayer<TTarget extends object = object> {
+    id: string;
+    order: number;
+    priority: number;
+    target?: TTarget;
+    targetMode?: TargetMode;
+    fields: Readonly<Record<string, unknown>>;
+    attrs?: Readonly<Attributes>;
+    active: boolean;
+    focusActive: boolean;
+    enabled: boolean;
+    inactiveReasons: readonly GraphInactiveReason[];
+    rootNodeId: string;
+    bindingIds: readonly string[];
+    commandIds: readonly string[];
+}
+export interface GraphCommand<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> {
+    id: string;
+    layerId: string;
+    name: string;
+    command: Command<TTarget, TEvent>;
+    fields: Readonly<Record<string, unknown>>;
+    attrs?: Readonly<Attributes>;
+    target?: TTarget;
+    active: boolean;
+    reachable: boolean;
+    enabled: boolean;
+    inactiveReasons: readonly GraphInactiveReason[];
+}
+export interface GraphBinding<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> {
+    id: string;
+    layerId: string;
+    sourceLayerOrder: number;
+    bindingIndex: number;
+    nodeId?: string;
+    commandIds: readonly string[];
+    sequence: readonly KeySequencePart[];
+    command?: BindingCommand<TTarget, TEvent>;
+    commandAttrs?: Readonly<Attributes>;
+    attrs?: Readonly<Attributes>;
+    event: BindingEvent;
+    preventDefault: boolean;
+    fallthrough: boolean;
+    active: boolean;
+    reachable: boolean;
+    enabled: boolean;
+    commandResolved: boolean;
+    shadowed: boolean;
+    inactiveReasons: readonly GraphInactiveReason[];
+}
+export interface GraphSequenceNode {
+    id: string;
+    layerId: string;
+    parentId: string | null;
+    childIds: readonly string[];
+    bindingIds: readonly string[];
+    reachableBindingIds: readonly string[];
+    depth: number;
+    sequence: readonly KeySequencePart[];
+    stroke: NormalizedKeyStroke | null;
+    match: KeyMatch | null;
+    display: string;
+    tokenName?: string;
+    active: boolean;
+    reachable: boolean;
+    pending: boolean;
+    pendingPath: boolean;
+}
+export interface GraphSnapshot<TTarget extends object = object, TEvent extends KeymapEvent = KeymapEvent> {
+    focused?: TTarget | null;
+    pendingSequence: readonly KeySequencePart[];
+    activeKeys: readonly ActiveKey<TTarget, TEvent>[];
+    layers: readonly GraphLayer<TTarget>[];
+    commands: readonly GraphCommand<TTarget, TEvent>[];
+    bindings: readonly GraphBinding<TTarget, TEvent>[];
+    sequenceNodes: readonly GraphSequenceNode[];
+}

package/src/html.d.ts

@@ -1,6 +1,5 @@
-import { Keymap } from "./keymap.js";
-import type { EventMatchResolver, KeymapEvent, KeymapHost } from "./types.js";
-export * from "./index.js";
+import { Keymap } from "@opentui/keymap";
+import type { EventMatchResolver, KeymapEvent, KeymapHost } from "@opentui/keymap";
 export interface HtmlKeymapEvent extends KeymapEvent {
     readonly originalEvent?: KeyboardEvent;
 }
@@ -19,3 +18,4 @@ export declare function createHtmlKeymapHost(root: HTMLElement): KeymapHost<HTML
 export declare const htmlEventMatchResolver: EventMatchResolver<HtmlKeymapEvent>;
 export declare function createHtmlKeymap(root: HTMLElement): Keymap<HTMLElement, HtmlKeymapEvent>;
 export declare function createDefaultHtmlKeymap(root: HTMLElement): Keymap<HTMLElement, HtmlKeymapEvent>;
+export {};