@densedash/core 0.1.0 → 0.2.0

package/dist/commands/scopes.js

@@ -1,3 +1,4 @@
+import { isKeyboardEditable } from "../ports/keyboard.js";
 // src/commands/scopes.ts
 /** Scope-family ordering matches the port contract; no key matching happens here. */
 function activeScopes(scopes) {
@@ -34,13 +35,39 @@ function activeScopes(scopes) {
 	const global = ordered.findIndex((scope) => scope.name === "global");
 	if (global >= 0) ordered.push(...ordered.splice(global, 1));
 	const exclusive = ordered.find((scope) => scope.options.only);
-	return exclusive ? ordered.filter((scope) => scope === exclusive || isDescendant(scope, exclusive)) : ordered;
+	const active = exclusive ? ordered.filter((scope) => scope === exclusive || isDescendant(scope, exclusive)) : ordered;
+	return [...active.filter((scope) => scope.options.keys), ...active.filter((scope) => !scope.options.keys)];
 }
 /** Element targets participate only while focus is inside them; document/window targets are ambient. */
 function scopeHasFocus(scope) {
 	const target = scope.options.target;
-	return !target || !("ownerDocument" in target) || target.ownerDocument === null || target.contains(target.ownerDocument?.activeElement ?? null);
+	return scope.options.keys !== void 0 || !target || !("ownerDocument" in target) || target.ownerDocument === null || target.contains(target.ownerDocument?.activeElement ?? null);
 }
-export { activeScopes, scopeHasFocus };
+/** Editable-only command bindings are disabled while a text control has focus. */
+function scopeAcceptsKeys(scope) {
+	if (!scopeHasFocus(scope)) return false;
+	if (!scope.options.keys && (scope.options.ignoreInputs ?? "editable") !== "editable") return true;
+	const target = scope.options.target;
+	const document = target && "document" in target ? target.document : target && "defaultView" in target ? target : target?.ownerDocument ?? globalThis.document;
+	return !isKeyboardEditable(document?.activeElement);
+}
+/** Element listeners see bubbling keys before ambient listeners, regardless of scope age. */
+function keymapScopes(scopes) {
+	return activeScopes(scopes).filter(scopeAcceptsKeys).sort((a, b) => {
+		if (Boolean(a.options.keys) !== Boolean(b.options.keys)) return a.options.keys ? -1 : 1;
+		if (a.options.keys && b.options.keys) return 0;
+		const aTarget = a.options.target;
+		const bTarget = b.options.target;
+		const aElement = aTarget && "ownerDocument" in aTarget && aTarget.ownerDocument ? aTarget : void 0;
+		const bElement = bTarget && "ownerDocument" in bTarget && bTarget.ownerDocument ? bTarget : void 0;
+		if (aElement && bElement) {
+			if (aElement === bElement) return 0;
+			if (aElement.contains(bElement)) return 1;
+			if (bElement.contains(aElement)) return -1;
+		}
+		return Number(Boolean(bElement)) - Number(Boolean(aElement));
+	});
+}
+export { activeScopes, keymapScopes, scopeAcceptsKeys, scopeHasFocus };
 
 //# sourceMappingURL=scopes.js.map

package/dist/commands/scopes.js.map

@@ -1 +1 @@
-{"version":3,"file":"scopes.js","names":[],"sources":["../../src/commands/scopes.ts"],"sourcesContent":["import type { KeyboardBinding } from \"../ports/keyboard.js\";\nimport type { Command, CommandScopeOptions } from \"./types.js\";\n\nexport interface Scope {\n  readonly name: string;\n  readonly commands: readonly Command[];\n  readonly options: CommandScopeOptions;\n  readonly release: () => void;\n  readonly unregister: () => void;\n  readonly bindings: KeyboardBinding[];\n  readonly warned: Set<string>;\n}\n\n/** Scope-family ordering matches the port contract; no key matching happens here. */\nexport function activeScopes(scopes: ReadonlyMap<string, Scope>): Scope[] {\n  function isDescendant(scope: Scope, ancestor: Scope): boolean {\n    let parent = scope.options.parent ?? (scope.name === \"global\" ? undefined : \"global\");\n    const visited = new Set<string>();\n    while (parent !== undefined && !visited.has(parent)) {\n      if (parent === ancestor.name) return true;\n      visited.add(parent);\n      parent = scopes.get(parent)?.options.parent;\n    }\n    return false;\n  }\n\n  const registered = Array.from(scopes.values());\n  // Keep a scope family together even when a child mounts before its parent.\n  const ranked = registered.map((scope, order) => {\n    const earliest = registered.findIndex(\n      (candidate) => candidate === scope || isDescendant(candidate, scope),\n    );\n    let depth = scope.name === \"global\" ? 0 : 1;\n    let parent = scope.options.parent;\n    const visited = new Set<string>();\n    while (parent !== undefined && parent !== \"global\" && !visited.has(parent)) {\n      visited.add(parent);\n      depth++;\n      parent = scopes.get(parent)?.options.parent;\n    }\n    return { scope, order, earliest, depth };\n  });\n  ranked.sort((a, b) => b.earliest - a.earliest || b.depth - a.depth || b.order - a.order);\n  const ordered = ranked.map(({ scope }) => scope);\n  const global = ordered.findIndex((scope) => scope.name === \"global\");\n  if (global >= 0) ordered.push(...ordered.splice(global, 1));\n  const exclusive = ordered.find((scope) => scope.options.only);\n  return exclusive\n    ? ordered.filter((scope) => scope === exclusive || isDescendant(scope, exclusive))\n    : ordered;\n}\n\n/** Element targets participate only while focus is inside them; document/window targets are ambient. */\nexport function scopeHasFocus(scope: Scope): boolean {\n  const target = scope.options.target;\n  return (\n    !target ||\n    !(\"ownerDocument\" in target) ||\n    target.ownerDocument === null ||\n    target.contains(target.ownerDocument?.activeElement ?? null)\n  );\n}\n"],"mappings":";;AAcA,SAAgB,aAAa,QAA6C;CACxE,SAAS,aAAa,OAAc,UAA0B;EAC5D,IAAI,SAAS,MAAM,QAAQ,WAAW,MAAM,SAAS,WAAW,KAAA,IAAY;EAC5E,MAAM,0BAAU,IAAI,IAAY;EAChC,OAAO,WAAW,KAAA,KAAa,CAAC,QAAQ,IAAI,MAAM,GAAG;GACnD,IAAI,WAAW,SAAS,MAAM,OAAO;GACrC,QAAQ,IAAI,MAAM;GAClB,SAAS,OAAO,IAAI,MAAM,CAAC,EAAE,QAAQ;EACvC;EACA,OAAO;CACT;CAEA,MAAM,aAAa,MAAM,KAAK,OAAO,OAAO,CAAC;CAE7C,MAAM,SAAS,WAAW,KAAK,OAAO,UAAU;EAC9C,MAAM,WAAW,WAAW,WACzB,cAAc,cAAc,SAAS,aAAa,WAAW,KAAK,CACrE;EACA,IAAI,QAAQ,MAAM,SAAS,WAAW,IAAI;EAC1C,IAAI,SAAS,MAAM,QAAQ;EAC3B,MAAM,0BAAU,IAAI,IAAY;EAChC,OAAO,WAAW,KAAA,KAAa,WAAW,YAAY,CAAC,QAAQ,IAAI,MAAM,GAAG;GAC1E,QAAQ,IAAI,MAAM;GAClB;GACA,SAAS,OAAO,IAAI,MAAM,CAAC,EAAE,QAAQ;EACvC;EACA,OAAO;GAAE;GAAO;GAAO;GAAU;EAAM;CACzC,CAAC;CACD,OAAO,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK;CACvF,MAAM,UAAU,OAAO,KAAK,EAAE,YAAY,KAAK;CAC/C,MAAM,SAAS,QAAQ,WAAW,UAAU,MAAM,SAAS,QAAQ;CACnE,IAAI,UAAU,GAAG,QAAQ,KAAK,GAAG,QAAQ,OAAO,QAAQ,CAAC,CAAC;CAC1D,MAAM,YAAY,QAAQ,MAAM,UAAU,MAAM,QAAQ,IAAI;CAC5D,OAAO,YACH,QAAQ,QAAQ,UAAU,UAAU,aAAa,aAAa,OAAO,SAAS,CAAC,IAC/E;AACN;;AAGA,SAAgB,cAAc,OAAuB;CACnD,MAAM,SAAS,MAAM,QAAQ;CAC7B,OACE,CAAC,UACD,EAAE,mBAAmB,WACrB,OAAO,kBAAkB,QACzB,OAAO,SAAS,OAAO,eAAe,iBAAiB,IAAI;AAE/D"}
+{"version":3,"file":"scopes.js","names":[],"sources":["../../src/commands/scopes.ts"],"sourcesContent":["import type { KeyboardBinding } from \"../ports/keyboard.js\";\nimport { isKeyboardEditable } from \"../ports/keyboard.js\";\nimport type { createKeys } from \"./keys.js\";\nimport type { Command, CommandScopeOptions } from \"./types.js\";\n\nexport interface Scope {\n  readonly name: string;\n  readonly keys: ReturnType<typeof createKeys>;\n  commands: readonly Command[];\n  readonly options: CommandScopeOptions;\n  readonly release: () => void;\n  readonly unregister: () => void;\n  readonly bindings: {\n    readonly key: string;\n    readonly commandIndex: number;\n    readonly binding: KeyboardBinding;\n    enabled: boolean;\n  }[];\n  readonly warned: Set<string>;\n}\n\n/** Scope-family ordering matches the port contract; no key matching happens here. */\nexport function activeScopes(scopes: ReadonlyMap<string, Scope>): Scope[] {\n  function isDescendant(scope: Scope, ancestor: Scope): boolean {\n    let parent = scope.options.parent ?? (scope.name === \"global\" ? undefined : \"global\");\n    const visited = new Set<string>();\n    while (parent !== undefined && !visited.has(parent)) {\n      if (parent === ancestor.name) return true;\n      visited.add(parent);\n      parent = scopes.get(parent)?.options.parent;\n    }\n    return false;\n  }\n\n  const registered = Array.from(scopes.values());\n  // Keep a scope family together even when a child mounts before its parent.\n  const ranked = registered.map((scope, order) => {\n    const earliest = registered.findIndex(\n      (candidate) => candidate === scope || isDescendant(candidate, scope),\n    );\n    let depth = scope.name === \"global\" ? 0 : 1;\n    let parent = scope.options.parent;\n    const visited = new Set<string>();\n    while (parent !== undefined && parent !== \"global\" && !visited.has(parent)) {\n      visited.add(parent);\n      depth++;\n      parent = scopes.get(parent)?.options.parent;\n    }\n    return { scope, order, earliest, depth };\n  });\n  ranked.sort((a, b) => b.earliest - a.earliest || b.depth - a.depth || b.order - a.order);\n  const ordered = ranked.map(({ scope }) => scope);\n  const global = ordered.findIndex((scope) => scope.name === \"global\");\n  if (global >= 0) ordered.push(...ordered.splice(global, 1));\n  const exclusive = ordered.find((scope) => scope.options.only);\n  const active = exclusive\n    ? ordered.filter((scope) => scope === exclusive || isDescendant(scope, exclusive))\n    : ordered;\n  return [\n    ...active.filter((scope) => scope.options.keys),\n    ...active.filter((scope) => !scope.options.keys),\n  ];\n}\n\n/** Element targets participate only while focus is inside them; document/window targets are ambient. */\nexport function scopeHasFocus(scope: Scope): boolean {\n  const target = scope.options.target;\n  return (\n    scope.options.keys !== undefined ||\n    !target ||\n    !(\"ownerDocument\" in target) ||\n    target.ownerDocument === null ||\n    target.contains(target.ownerDocument?.activeElement ?? null)\n  );\n}\n\n/** Editable-only command bindings are disabled while a text control has focus. */\nexport function scopeAcceptsKeys(scope: Scope): boolean {\n  if (!scopeHasFocus(scope)) return false;\n  if (!scope.options.keys && (scope.options.ignoreInputs ?? \"editable\") !== \"editable\") return true;\n  const target = scope.options.target;\n  const document =\n    target && \"document\" in target\n      ? target.document\n      : target && \"defaultView\" in target\n        ? target\n        : (target?.ownerDocument ?? globalThis.document);\n  return !isKeyboardEditable(document?.activeElement);\n}\n\n/** Element listeners see bubbling keys before ambient listeners, regardless of scope age. */\nexport function keymapScopes(scopes: ReadonlyMap<string, Scope>): Scope[] {\n  return activeScopes(scopes)\n    .filter(scopeAcceptsKeys)\n    .sort((a, b) => {\n      if (Boolean(a.options.keys) !== Boolean(b.options.keys)) return a.options.keys ? -1 : 1;\n      if (a.options.keys && b.options.keys) return 0;\n      const aTarget = a.options.target;\n      const bTarget = b.options.target;\n      const aElement =\n        aTarget && \"ownerDocument\" in aTarget && aTarget.ownerDocument ? aTarget : undefined;\n      const bElement =\n        bTarget && \"ownerDocument\" in bTarget && bTarget.ownerDocument ? bTarget : undefined;\n      if (aElement && bElement) {\n        if (aElement === bElement) return 0;\n        if (aElement.contains(bElement)) return 1;\n        if (bElement.contains(aElement)) return -1;\n      }\n      return Number(Boolean(bElement)) - Number(Boolean(aElement));\n    });\n}\n"],"mappings":"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"}

package/dist/commands/trading-preset.d.ts

@@ -1,3 +1,7 @@
 /** Keys only: navigation handlers and confirmation prompts belong to the app. */
-export declare const tradingPreset: Readonly<Record<"tree.next" | "tree.prev" | "tree.first" | "tree.last" | "tree.page-up" | "tree.page-down" | "tree.parent" | "tree.expand" | "tree.collapse" | "tree.toggle" | "tree.select" | "tree.extend-selection" | "tree.open" | "table.sort" | "table.next-column" | "tabs.select.1" | "tabs.select.2" | "tabs.select.3" | "tabs.select.4" | "tabs.select.5" | "tabs.select.6" | "tabs.select.7" | "tabs.select.8" | "tabs.select.9" | "next" | "previous" | "first" | "last" | "open" | "collapse" | "expand" | "approve" | "reject" | "back" | "forward" | "confirm" | "cancel" | "p-components" | "p-home" | "p-hyperliquid-account" | "p-portfolio-studies" | "p-portfolio-paper" | "p-portfolio" | "p-market" | "p-ideas" | "p-ops-activity" | "p-ops-notifications" | "p-ops-backfills", readonly import("@tanstack/hotkeys").Hotkey[]>>;
+export declare const tradingPreset: Readonly<Record<"tree.next" | "tree.prev" | "tree.first" | "tree.last" | "tree.page-up" | "tree.page-down" | "tree.parent" | "tree.expand" | "tree.collapse" | "tree.toggle" | "tree.select" | "tree.extend-selection" | "tree.open" | "table.sort" | "table.next-column" | "tabs.select.1" | "tabs.select.2" | "tabs.select.3" | "tabs.select.4" | "tabs.select.5" | "tabs.select.6" | "tabs.select.7" | "tabs.select.8" | "tabs.select.9" | "tabs.next" | "tabs.prev" | "tabs.first" | "tabs.last" | "tabs.down" | "tabs.up" | "next" | "previous" | "open" | "approve" | "confirm" | "cancel" | "p-home", readonly import("@tanstack/hotkeys").Hotkey[]>>;
+/** A Tree/List's default page-wide layer: only the four unshifted navigation keys. */
+export declare const treePreset: Readonly<Record<"tree.next" | "tree.prev" | "tree.expand" | "tree.collapse", readonly import("@tanstack/hotkeys").Hotkey[]>>;
+/** A second Tree/List's complete layer: only the four shifted navigation keys. */
+export declare const shiftedTreePreset: Readonly<Record<"tree.next" | "tree.prev" | "tree.expand" | "tree.collapse", readonly import("@tanstack/hotkeys").Hotkey[]>>;
 //# sourceMappingURL=trading-preset.d.ts.map

package/dist/commands/trading-preset.js

@@ -36,55 +36,34 @@ const tradingPreset = definePreset({
 	"tabs.select.7": ["7"],
 	"tabs.select.8": ["8"],
 	"tabs.select.9": ["9"],
+	"tabs.next": ["ArrowRight"],
+	"tabs.prev": ["ArrowLeft"],
+	"tabs.first": ["Home"],
+	"tabs.last": ["End"],
+	"tabs.down": ["ArrowDown"],
+	"tabs.up": ["ArrowUp"],
 	next: ["J", "ArrowDown"],
 	previous: ["K", "ArrowUp"],
-	first: ["Control+U"],
-	last: ["Control+D"],
 	open: ["Enter"],
-	collapse: ["H", "ArrowLeft"],
-	expand: ["L", "ArrowRight"],
 	approve: ["Shift+Y"],
-	reject: ["Shift+X"],
-	back: ["["],
-	forward: ["]"],
 	confirm: ["Y"],
 	cancel: ["N", "Escape"],
-	"p-components": [["G", "C"]],
-	"p-home": [["G", "H"]],
-	"p-hyperliquid-account": [["G", "A"]],
-	"p-portfolio-studies": [[
-		"G",
-		"P",
-		"S"
-	]],
-	"p-portfolio-paper": [[
-		"G",
-		"P",
-		"P"
-	]],
-	"p-portfolio": [[
-		"G",
-		"P",
-		"B"
-	]],
-	"p-market": [["G", "M"]],
-	"p-ideas": [["G", "R"]],
-	"p-ops-activity": [[
-		"G",
-		"O",
-		"A"
-	]],
-	"p-ops-notifications": [[
-		"G",
-		"O",
-		"N"
-	]],
-	"p-ops-backfills": [[
-		"G",
-		"O",
-		"B"
-	]]
+	"p-home": [["G", "H"]]
 });
-export { tradingPreset };
+/** A Tree/List's default page-wide layer: only the four unshifted navigation keys. */
+const treePreset = definePreset({
+	"tree.next": ["J"],
+	"tree.prev": ["K"],
+	"tree.expand": ["L"],
+	"tree.collapse": ["H"]
+});
+/** A second Tree/List's complete layer: only the four shifted navigation keys. */
+const shiftedTreePreset = definePreset({
+	"tree.next": ["Shift+J"],
+	"tree.prev": ["Shift+K"],
+	"tree.expand": ["Shift+L"],
+	"tree.collapse": ["Shift+H"]
+});
+export { shiftedTreePreset, tradingPreset, treePreset };
 
 //# sourceMappingURL=trading-preset.js.map

package/dist/commands/trading-preset.js.map

@@ -1 +1 @@
-{"version":3,"file":"trading-preset.js","names":[],"sources":["../../src/commands/trading-preset.ts"],"sourcesContent":["import type { KeyboardHotkey } from \"../ports/keyboard.js\";\n\nfunction definePreset<const Id extends string>(\n  preset: Readonly<Record<Id, readonly KeyboardHotkey[]>>,\n): Readonly<Record<Id, readonly KeyboardHotkey[]>> {\n  return preset;\n}\n\n/** Keys only: navigation handlers and confirmation prompts belong to the app. */\nexport const tradingPreset = definePreset({\n  \"tree.next\": [\"J\", \"ArrowDown\", \"Shift+ArrowDown\"],\n  \"tree.prev\": [\"K\", \"ArrowUp\", \"Shift+ArrowUp\"],\n  \"tree.first\": [\"Home\", \"Control+U\"],\n  \"tree.last\": [\"End\", \"Control+D\"],\n  \"tree.page-up\": [\"PageUp\"],\n  \"tree.page-down\": [\"PageDown\"],\n  \"tree.parent\": [\"Alt+ArrowUp\"],\n  \"tree.expand\": [\"L\", \"ArrowRight\"],\n  \"tree.collapse\": [\"H\", \"ArrowLeft\"],\n  \"tree.toggle\": [],\n  \"tree.select\": [\"Space\"],\n  \"tree.extend-selection\": [\"Shift+Space\"],\n  \"tree.open\": [\"Enter\"],\n  \"table.sort\": [\"S\"],\n  \"table.next-column\": [\"Shift+S\"],\n  \"tabs.select.1\": [\"1\"],\n  \"tabs.select.2\": [\"2\"],\n  \"tabs.select.3\": [\"3\"],\n  \"tabs.select.4\": [\"4\"],\n  \"tabs.select.5\": [\"5\"],\n  \"tabs.select.6\": [\"6\"],\n  \"tabs.select.7\": [\"7\"],\n  \"tabs.select.8\": [\"8\"],\n  \"tabs.select.9\": [\"9\"],\n  next: [\"J\", \"ArrowDown\"],\n  previous: [\"K\", \"ArrowUp\"],\n  first: [\"Control+U\"],\n  last: [\"Control+D\"],\n  open: [\"Enter\"],\n  collapse: [\"H\", \"ArrowLeft\"],\n  expand: [\"L\", \"ArrowRight\"],\n  approve: [\"Shift+Y\"],\n  reject: [\"Shift+X\"],\n  back: [\"[\"],\n  forward: [\"]\"],\n  confirm: [\"Y\"],\n  cancel: [\"N\", \"Escape\"],\n  \"p-components\": [[\"G\", \"C\"]],\n  \"p-home\": [[\"G\", \"H\"]],\n  \"p-hyperliquid-account\": [[\"G\", \"A\"]],\n  \"p-portfolio-studies\": [[\"G\", \"P\", \"S\"]],\n  \"p-portfolio-paper\": [[\"G\", \"P\", \"P\"]],\n  \"p-portfolio\": [[\"G\", \"P\", \"B\"]],\n  \"p-market\": [[\"G\", \"M\"]],\n  \"p-ideas\": [[\"G\", \"R\"]],\n  \"p-ops-activity\": [[\"G\", \"O\", \"A\"]],\n  \"p-ops-notifications\": [[\"G\", \"O\", \"N\"]],\n  \"p-ops-backfills\": [[\"G\", \"O\", \"B\"]],\n});\n"],"mappings":";AAEA,SAAS,aACP,QACiD;CACjD,OAAO;AACT;;AAGA,MAAa,gBAAgB,aAAa;CACxC,aAAa;EAAC;EAAK;EAAa;CAAiB;CACjD,aAAa;EAAC;EAAK;EAAW;CAAe;CAC7C,cAAc,CAAC,QAAQ,WAAW;CAClC,aAAa,CAAC,OAAO,WAAW;CAChC,gBAAgB,CAAC,QAAQ;CACzB,kBAAkB,CAAC,UAAU;CAC7B,eAAe,CAAC,aAAa;CAC7B,eAAe,CAAC,KAAK,YAAY;CACjC,iBAAiB,CAAC,KAAK,WAAW;CAClC,eAAe,CAAC;CAChB,eAAe,CAAC,OAAO;CACvB,yBAAyB,CAAC,aAAa;CACvC,aAAa,CAAC,OAAO;CACrB,cAAc,CAAC,GAAG;CAClB,qBAAqB,CAAC,SAAS;CAC/B,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,MAAM,CAAC,KAAK,WAAW;CACvB,UAAU,CAAC,KAAK,SAAS;CACzB,OAAO,CAAC,WAAW;CACnB,MAAM,CAAC,WAAW;CAClB,MAAM,CAAC,OAAO;CACd,UAAU,CAAC,KAAK,WAAW;CAC3B,QAAQ,CAAC,KAAK,YAAY;CAC1B,SAAS,CAAC,SAAS;CACnB,QAAQ,CAAC,SAAS;CAClB,MAAM,CAAC,GAAG;CACV,SAAS,CAAC,GAAG;CACb,SAAS,CAAC,GAAG;CACb,QAAQ,CAAC,KAAK,QAAQ;CACtB,gBAAgB,CAAC,CAAC,KAAK,GAAG,CAAC;CAC3B,UAAU,CAAC,CAAC,KAAK,GAAG,CAAC;CACrB,yBAAyB,CAAC,CAAC,KAAK,GAAG,CAAC;CACpC,uBAAuB,CAAC;EAAC;EAAK;EAAK;CAAG,CAAC;CACvC,qBAAqB,CAAC;EAAC;EAAK;EAAK;CAAG,CAAC;CACrC,eAAe,CAAC;EAAC;EAAK;EAAK;CAAG,CAAC;CAC/B,YAAY,CAAC,CAAC,KAAK,GAAG,CAAC;CACvB,WAAW,CAAC,CAAC,KAAK,GAAG,CAAC;CACtB,kBAAkB,CAAC;EAAC;EAAK;EAAK;CAAG,CAAC;CAClC,uBAAuB,CAAC;EAAC;EAAK;EAAK;CAAG,CAAC;CACvC,mBAAmB,CAAC;EAAC;EAAK;EAAK;CAAG,CAAC;AACrC,CAAC"}
+{"version":3,"file":"trading-preset.js","names":[],"sources":["../../src/commands/trading-preset.ts"],"sourcesContent":["import type { KeyboardHotkey } from \"../ports/keyboard.js\";\n\nfunction definePreset<const Id extends string>(\n  preset: Readonly<Record<Id, readonly KeyboardHotkey[]>>,\n): Readonly<Record<Id, readonly KeyboardHotkey[]>> {\n  return preset;\n}\n\n/** Keys only: navigation handlers and confirmation prompts belong to the app. */\nexport const tradingPreset = definePreset({\n  \"tree.next\": [\"J\", \"ArrowDown\", \"Shift+ArrowDown\"],\n  \"tree.prev\": [\"K\", \"ArrowUp\", \"Shift+ArrowUp\"],\n  \"tree.first\": [\"Home\", \"Control+U\"],\n  \"tree.last\": [\"End\", \"Control+D\"],\n  \"tree.page-up\": [\"PageUp\"],\n  \"tree.page-down\": [\"PageDown\"],\n  \"tree.parent\": [\"Alt+ArrowUp\"],\n  \"tree.expand\": [\"L\", \"ArrowRight\"],\n  \"tree.collapse\": [\"H\", \"ArrowLeft\"],\n  // Unbound actions stay out of Legend until an app supplies an override.\n  \"tree.toggle\": [],\n  \"tree.select\": [\"Space\"],\n  \"tree.extend-selection\": [\"Shift+Space\"],\n  \"tree.open\": [\"Enter\"],\n  \"table.sort\": [\"S\"],\n  \"table.next-column\": [\"Shift+S\"],\n  \"tabs.select.1\": [\"1\"],\n  \"tabs.select.2\": [\"2\"],\n  \"tabs.select.3\": [\"3\"],\n  \"tabs.select.4\": [\"4\"],\n  \"tabs.select.5\": [\"5\"],\n  \"tabs.select.6\": [\"6\"],\n  \"tabs.select.7\": [\"7\"],\n  \"tabs.select.8\": [\"8\"],\n  \"tabs.select.9\": [\"9\"],\n  // Bound by the focused tab list only, so ArrowRight and ArrowLeft stay free in panels.\n  \"tabs.next\": [\"ArrowRight\"],\n  \"tabs.prev\": [\"ArrowLeft\"],\n  \"tabs.first\": [\"Home\"],\n  \"tabs.last\": [\"End\"],\n  // A vertical tab list's next and previous tab.\n  \"tabs.down\": [\"ArrowDown\"],\n  \"tabs.up\": [\"ArrowUp\"],\n  next: [\"J\", \"ArrowDown\"],\n  previous: [\"K\", \"ArrowUp\"],\n  open: [\"Enter\"],\n  approve: [\"Shift+Y\"],\n  confirm: [\"Y\"],\n  cancel: [\"N\", \"Escape\"],\n  \"p-home\": [[\"G\", \"H\"]],\n});\n\n/** A Tree/List's default page-wide layer: only the four unshifted navigation keys. */\nexport const treePreset = definePreset({\n  \"tree.next\": [\"J\"],\n  \"tree.prev\": [\"K\"],\n  \"tree.expand\": [\"L\"],\n  \"tree.collapse\": [\"H\"],\n});\n\n/** A second Tree/List's complete layer: only the four shifted navigation keys. */\nexport const shiftedTreePreset = definePreset({\n  \"tree.next\": [\"Shift+J\"],\n  \"tree.prev\": [\"Shift+K\"],\n  \"tree.expand\": [\"Shift+L\"],\n  \"tree.collapse\": [\"Shift+H\"],\n});\n"],"mappings":";AAEA,SAAS,aACP,QACiD;CACjD,OAAO;AACT;;AAGA,MAAa,gBAAgB,aAAa;CACxC,aAAa;EAAC;EAAK;EAAa;CAAiB;CACjD,aAAa;EAAC;EAAK;EAAW;CAAe;CAC7C,cAAc,CAAC,QAAQ,WAAW;CAClC,aAAa,CAAC,OAAO,WAAW;CAChC,gBAAgB,CAAC,QAAQ;CACzB,kBAAkB,CAAC,UAAU;CAC7B,eAAe,CAAC,aAAa;CAC7B,eAAe,CAAC,KAAK,YAAY;CACjC,iBAAiB,CAAC,KAAK,WAAW;CAElC,eAAe,CAAC;CAChB,eAAe,CAAC,OAAO;CACvB,yBAAyB,CAAC,aAAa;CACvC,aAAa,CAAC,OAAO;CACrB,cAAc,CAAC,GAAG;CAClB,qBAAqB,CAAC,SAAS;CAC/B,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CACrB,iBAAiB,CAAC,GAAG;CAErB,aAAa,CAAC,YAAY;CAC1B,aAAa,CAAC,WAAW;CACzB,cAAc,CAAC,MAAM;CACrB,aAAa,CAAC,KAAK;CAEnB,aAAa,CAAC,WAAW;CACzB,WAAW,CAAC,SAAS;CACrB,MAAM,CAAC,KAAK,WAAW;CACvB,UAAU,CAAC,KAAK,SAAS;CACzB,MAAM,CAAC,OAAO;CACd,SAAS,CAAC,SAAS;CACnB,SAAS,CAAC,GAAG;CACb,QAAQ,CAAC,KAAK,QAAQ;CACtB,UAAU,CAAC,CAAC,KAAK,GAAG,CAAC;AACvB,CAAC;;AAGD,MAAa,aAAa,aAAa;CACrC,aAAa,CAAC,GAAG;CACjB,aAAa,CAAC,GAAG;CACjB,eAAe,CAAC,GAAG;CACnB,iBAAiB,CAAC,GAAG;AACvB,CAAC;;AAGD,MAAa,oBAAoB,aAAa;CAC5C,aAAa,CAAC,SAAS;CACvB,aAAa,CAAC,SAAS;CACvB,eAAe,CAAC,SAAS;CACzB,iBAAiB,CAAC,SAAS;AAC7B,CAAC"}

package/dist/commands/types.d.ts

@@ -4,13 +4,13 @@ import { tradingPreset } from "./trading-preset.js";
 /** Augment through either public entry with `commands: { open: unknown; ... }`. */
 export interface Register {}
 /** Commands that densedash parts register themselves, so apps can rebind them by id. */
-type PartCommandId = Extract<keyof typeof tradingPreset, `tree.${string}` | `tabs.${string}` | `table.${string}`>;
+type PartCommandId = keyof typeof tradingPreset & (`tree.${string}` | `tabs.${string}` | `table.${string}`);
 export type CommandId = PartCommandId | (Register extends {
   commands: infer Commands;
-} ? Extract<keyof Commands, string> : string);
+} ? keyof Commands & string : string);
 export type KeyOverrideId = Register extends {
   commands: infer Commands;
-} ? Extract<keyof Commands, string> | PartCommandId | "confirm" | "cancel" : keyof typeof tradingPreset;
+} ? (keyof Commands & string) | PartCommandId | "confirm" | "cancel" : keyof typeof tradingPreset;
 export interface CommandContext {
   readonly event?: KeyboardEvent;
 }
@@ -18,6 +18,10 @@ export interface Command {
   readonly id: CommandId;
   readonly label: string;
   readonly group?: string;
+  /** Short legend label for this group; defaults to the group name. */
+  readonly groupLabel?: string;
+  /** Secondary hints stay out of default legends, but remain bound and in the keymap. */
+  readonly legend?: "secondary";
   readonly enabled?: () => boolean;
   readonly confirm?: {
     readonly prompt: string;
@@ -34,8 +38,19 @@ export interface KeysOptions {
   readonly overrides?: KeyOverrides;
   readonly onChange?: (overrides: ValidatedKeyOverrides) => void;
 }
+/** Per-instance keys. Omit to retain focus-scoped bindings. */
+export interface KeyLayer {
+  readonly preset?: Preset;
+  readonly overrides?: KeyOverrides;
+  /** Instance label shown in legends and collision errors. */
+  readonly label: string;
+}
 export interface CommandScopeOptions extends Omit<KeyboardBindingOptions, "scope" | "enabled"> {
+  /** Defaults to "editable": declared commands beat widget typeahead, but leave text fields alone. */
+  readonly ignoreInputs?: boolean | "auto" | "editable";
   readonly parent?: string;
+  /** Bind this instance throughout the document, ahead of focus-scoped keys. */
+  readonly keys?: KeyLayer;
   /** Rebind just the supplied commands in an exclusive scope. */
   readonly only?: boolean;
 }
@@ -43,8 +58,14 @@ export interface KeymapEntry {
   readonly command: string;
   readonly label: string;
   readonly group?: string;
+  readonly groupLabel?: string;
+  readonly legend?: "secondary";
   readonly scope: string;
+  /** Instance label for page-wide key layers. */
+  readonly layer?: string;
   readonly keys: readonly string[];
+  /** Evaluated when the keymap is published; update the scope to refresh app state. */
+  readonly enabled: boolean;
 }
 export interface PendingConfirm {
   readonly command: string;
@@ -55,6 +76,12 @@ export interface PendingConfirm {
 export interface Commands {
   /** A scope name has one owner. Unregister before reusing it. */
   register(scope: string, commands: readonly Command[], options?: CommandScopeOptions): () => void;
+  /**
+   * Replace definitions without rebinding or clearing pending confirmation/sequence state.
+   * The ordered ids must match the registration; unregister to change them or scope options.
+   * Pending confirmation uses the latest definition and refreshes its label/prompt.
+   */
+  update(scope: string, commands: readonly Command[]): void;
   /** Optional scope selects a specific owner; otherwise use descendant/latest precedence. */
   invoke(id: CommandId, context?: CommandContext & {
     readonly scope?: string;
@@ -63,9 +90,9 @@ export interface Commands {
   readonly confirm: Pick<Store<PendingConfirm | null>, "get" | "subscribe">;
   /**
    * The keys bound to a command id (its override, else its preset keys), whether or not a
-   * scope has focus. `keymap` republishes after `setOverrides`, so subscribe to it to follow.
+   * scope has focus. Pass a registration scope to read its instance layer. `keymap` republishes after `setOverrides`, so subscribe to it to follow.
    */
-  keys(id: CommandId): readonly KeyboardHotkey[];
+  keys(id: CommandId, scope?: string): readonly KeyboardHotkey[];
   accept(): void;
   cancel(): void;
   /** Replaces all overrides, rebinds live scopes, then notifies onChange with validated keys. */

package/dist/defaults/keyboard.js

@@ -1,5 +1,20 @@
+import { isKeyboardEditable } from "../ports/keyboard.js";
 import { ALL_KEYS, HotkeyManager, detectPlatform, formatForDisplay, normalizeHotkey, parseHotkey, toHotkeyRegistrationView, validateHotkey } from "@tanstack/hotkeys";
 // src/defaults/keyboard.ts
+/**
+* Hotkeys' display parts, joined as compact keycap labels: glyphs with no separator on macOS
+* (`⇧J`, `⌘K`) and text joined by `+` elsewhere (`Shift+J`, `Ctrl+K`). A letter pressed on its
+* own reads in lower case (`j`, and `g r` for a sequence), as it is typed.
+*/
+function formatChord(chord, platform) {
+	const parts = formatForDisplay(chord, {
+		platform,
+		parts: true
+	});
+	const [only] = parts;
+	if (parts.length === 1 && only !== void 0 && /^[A-Z]$/.test(only)) return only.toLowerCase();
+	return parts.join(platform === "mac" ? "" : "+");
+}
 function createKeyboardPort() {
 	const manager = Reflect.construct(HotkeyManager, []);
 	const register = manager.register;
@@ -76,7 +91,7 @@ function createKeyboardPort() {
 				};
 			}
 		},
-		format: (hotkey) => formatForDisplay(hotkey, { platform }),
+		format: (hotkey) => typeof hotkey === "string" ? formatChord(hotkey, platform) : hotkey.map((step) => formatChord(step, platform)).join(" "),
 		activateScope(scope, options) {
 			requireLive();
 			return own(manager.activateScope(scope, options));
@@ -85,10 +100,41 @@ function createKeyboardPort() {
 			requireLive();
 			let currentOptions = options;
 			let currentHandler = handler;
-			let handle = register.call(manager, hotkey, handler, {
-				...options,
-				conflictBehavior: "allow"
-			});
+			const targetDocument = () => {
+				const target = currentOptions.target;
+				if (target && "document" in target) return target.document;
+				if (target && "defaultView" in target) return target;
+				return target?.ownerDocument ?? (typeof document === "undefined" ? void 0 : document);
+			};
+			const resolvedOptions = () => {
+				const { ignoreInputs, ...bindingOptions } = currentOptions;
+				return {
+					...bindingOptions,
+					...ignoreInputs === void 0 ? {} : { ignoreInputs: ignoreInputs === "editable" ? false : ignoreInputs },
+					enabled: currentOptions.enabled !== false && (ignoreInputs !== "editable" || !isKeyboardEditable(targetDocument()?.activeElement)),
+					conflictBehavior: "allow"
+				};
+			};
+			let handle = register.call(manager, hotkey, handler, resolvedOptions());
+			let releaseFocus = () => {};
+			function watchFocus() {
+				releaseFocus();
+				if (currentOptions.ignoreInputs !== "editable") return;
+				const doc = targetDocument();
+				if (!doc) return;
+				const update = (event) => {
+					const next = event.type === "focusout" ? event.relatedTarget : doc.activeElement;
+					const element = next instanceof (doc.defaultView?.Element ?? Element) ? next : null;
+					handle.setOptions({ enabled: currentOptions.enabled !== false && !isKeyboardEditable(element) });
+				};
+				doc.addEventListener("focusin", update, true);
+				doc.addEventListener("focusout", update, true);
+				releaseFocus = () => {
+					doc.removeEventListener("focusin", update, true);
+					doc.removeEventListener("focusout", update, true);
+				};
+			}
+			watchFocus();
 			let active = true;
 			return {
 				update({ handler: nextHandler, ...nextOptions }) {
@@ -101,17 +147,16 @@ function createKeyboardPort() {
 					currentHandler = nextHandler ?? currentHandler;
 					if (currentOptions.target !== previousTarget) {
 						handle.unregister();
-						handle = register.call(manager, hotkey, currentHandler, {
-							...currentOptions,
-							conflictBehavior: "allow"
-						});
+						handle = register.call(manager, hotkey, currentHandler, resolvedOptions());
 					} else {
 						handle.callback = currentHandler;
-						handle.setOptions(nextOptions);
+						handle.setOptions(resolvedOptions());
 					}
+					watchFocus();
 				},
 				dispose: own(() => {
 					active = false;
+					releaseFocus();
 					handle.unregister();
 				})
 			};

package/dist/defaults/keyboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard.js","names":[],"sources":["../../src/defaults/keyboard.ts"],"sourcesContent":["import {\n  ALL_KEYS,\n  HotkeyManager,\n  detectPlatform,\n  formatForDisplay,\n  normalizeHotkey,\n  parseHotkey,\n  toHotkeyRegistrationView,\n  validateHotkey,\n} from \"@tanstack/hotkeys\";\nimport type { HotkeyRegistrationHandle } from \"@tanstack/hotkeys\";\nimport type {\n  KeyboardBindingOptions,\n  KeyboardHandler,\n  KeyboardHotkey,\n  KeyboardHotkeyChord,\n  KeyboardPort,\n  PendingKeyboardSequence,\n} from \"../ports/keyboard.js\";\n\nexport function createKeyboardPort(): KeyboardPort {\n  // 0.24.0 exposes only a singleton factory and marks its zero-argument constructor\n  // private in types. The shipped constructor is independent of that singleton.\n  // Keep this pinned interop here: each kernel must own its scopes and listeners.\n  const manager = Reflect.construct(HotkeyManager, []) as HotkeyManager;\n  // The port exposes shared options and an event-only callback. Erase upstream's\n  // per-chord conditional inference here rather than distributing its key union.\n  const register = manager.register as unknown as (\n    hotkey: KeyboardHotkey,\n    handler: KeyboardHandler,\n    options: KeyboardBindingOptions & { conflictBehavior: \"allow\" },\n  ) => HotkeyRegistrationHandle<KeyboardBindingOptions>;\n  const platform = detectPlatform();\n  const releases = new Set<() => void>();\n  let disposed = false;\n  let registrations = manager.registrations.state;\n  let pending: readonly PendingKeyboardSequence[] = [];\n\n  function readPending(): readonly PendingKeyboardSequence[] {\n    if (registrations === manager.registrations.state) return pending;\n    registrations = manager.registrations.state;\n    const sequences: PendingKeyboardSequence[] = [];\n    for (const registration of registrations.values()) {\n      const view = toHotkeyRegistrationView(registration);\n      if (view.kind === \"sequence\" && view.matchedStepCount > 0) {\n        sequences.push({\n          id: view.id,\n          hotkey: view.hotkey,\n          matchedStepCount: view.matchedStepCount,\n          scope: view.options.scope ?? \"global\",\n          target: view.target,\n        });\n      }\n    }\n    pending = sequences;\n    return pending;\n  }\n\n  function requireLive(): void {\n    if (disposed) throw new Error(\"Keyboard port has been disposed.\");\n  }\n\n  function own(cleanup: () => void): () => void {\n    const release = () => {\n      if (!releases.delete(release)) return;\n      cleanup();\n    };\n    releases.add(release);\n    return release;\n  }\n\n  return {\n    platform,\n    parse(input) {\n      if (\n        typeof input !== \"string\" &&\n        !(\n          Array.isArray(input) &&\n          Array.from(input).every((step: unknown) => typeof step === \"string\")\n        )\n      ) {\n        return { ok: false, reason: \"Expected a hotkey string or an array of hotkey strings.\" };\n      }\n      try {\n        const steps: readonly string[] = typeof input === \"string\" ? [input] : input;\n        const normalized: KeyboardHotkeyChord[] = [];\n        const knownKeys: ReadonlySet<string> = ALL_KEYS;\n        for (const step of steps) {\n          const validation = validateHotkey(step);\n          if (!validation.valid) return { ok: false, reason: validation.errors.join(\"; \") };\n          const parsed = parseHotkey(step, platform);\n          // Upstream validates key-name shape, so even \"Bogus\" passes. Use its\n          // canonical logical-key set before trusting its normalized return type.\n          if (parsed.key !== undefined && !knownKeys.has(parsed.key)) {\n            return { ok: false, reason: `Unknown key: '${parsed.key}'.` };\n          }\n          normalized.push(normalizeHotkey(step, platform));\n        }\n        const first = normalized[0];\n        if (first === undefined) return { ok: false, reason: \"Sequence cannot be empty.\" };\n        return { ok: true, hotkey: normalized.length === 1 ? first : normalized };\n      } catch (cause) {\n        return { ok: false, reason: cause instanceof Error ? cause.message : \"Invalid hotkey.\" };\n      }\n    },\n    format: (hotkey) => formatForDisplay(hotkey, { platform }),\n    activateScope(scope, options) {\n      requireLive();\n      return own(manager.activateScope(scope, options));\n    },\n    bind(hotkey, handler, options = {}) {\n      requireLive();\n      let currentOptions: KeyboardBindingOptions = options;\n      let currentHandler = handler;\n      let handle = register.call(manager, hotkey, handler, {\n        ...options,\n        conflictBehavior: \"allow\",\n      });\n      let active = true;\n      const dispose = own(() => {\n        active = false;\n        handle.unregister();\n      });\n      return {\n        update({ handler: nextHandler, ...nextOptions }) {\n          if (!active) return;\n          const previousTarget = currentOptions.target;\n          currentOptions = { ...currentOptions, ...nextOptions };\n          currentHandler = nextHandler ?? currentHandler;\n          // Hotkeys setOptions does not move a registration to a different target.\n          if (currentOptions.target !== previousTarget) {\n            handle.unregister();\n            handle = register.call(manager, hotkey, currentHandler, {\n              ...currentOptions,\n              conflictBehavior: \"allow\",\n            });\n          } else {\n            handle.callback = currentHandler;\n            handle.setOptions(nextOptions);\n          }\n        },\n        dispose,\n      };\n    },\n    pending: {\n      get: readPending,\n      subscribe(listener) {\n        if (disposed) return () => {};\n        const subscription = manager.registrations.subscribe(() => listener(readPending()));\n        return own(subscription.unsubscribe);\n      },\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      for (const release of releases) release();\n      manager.destroy();\n      readPending();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"keyboard.js","names":[],"sources":["../../src/defaults/keyboard.ts"],"sourcesContent":["import {\n  ALL_KEYS,\n  HotkeyManager,\n  detectPlatform,\n  formatForDisplay,\n  normalizeHotkey,\n  parseHotkey,\n  toHotkeyRegistrationView,\n  validateHotkey,\n} from \"@tanstack/hotkeys\";\nimport type { HotkeyOptions, HotkeyRegistrationHandle } from \"@tanstack/hotkeys\";\nimport type {\n  KeyboardBindingOptions,\n  KeyboardHandler,\n  KeyboardHotkey,\n  KeyboardHotkeyChord,\n  KeyboardPlatform,\n  KeyboardPort,\n  PendingKeyboardSequence,\n} from \"../ports/keyboard.js\";\nimport { isKeyboardEditable } from \"../ports/keyboard.js\";\n\n/**\n * Hotkeys' display parts, joined as compact keycap labels: glyphs with no separator on macOS\n * (`⇧J`, `⌘K`) and text joined by `+` elsewhere (`Shift+J`, `Ctrl+K`). A letter pressed on its\n * own reads in lower case (`j`, and `g r` for a sequence), as it is typed.\n */\nfunction formatChord(chord: KeyboardHotkeyChord, platform: KeyboardPlatform): string {\n  const parts = formatForDisplay(chord, { platform, parts: true });\n  const [only] = parts;\n  if (parts.length === 1 && only !== undefined && /^[A-Z]$/.test(only)) return only.toLowerCase();\n  return parts.join(platform === \"mac\" ? \"\" : \"+\");\n}\n\nexport function createKeyboardPort(): KeyboardPort {\n  // 0.24.0 exposes only a singleton factory and marks its zero-argument constructor\n  // private in types. The shipped constructor is independent of that singleton.\n  // Keep this pinned interop here: each kernel must own its scopes and listeners.\n  const manager = Reflect.construct(HotkeyManager, []) as HotkeyManager;\n  // The port exposes shared options and an event-only callback. Erase upstream's\n  // per-chord conditional inference here rather than distributing its key union.\n  const register = manager.register as unknown as (\n    hotkey: KeyboardHotkey,\n    handler: KeyboardHandler,\n    options: HotkeyOptions & { conflictBehavior: \"allow\" },\n  ) => HotkeyRegistrationHandle<HotkeyOptions>;\n  const platform = detectPlatform();\n  const releases = new Set<() => void>();\n  let disposed = false;\n  let registrations = manager.registrations.state;\n  let pending: readonly PendingKeyboardSequence[] = [];\n\n  function readPending(): readonly PendingKeyboardSequence[] {\n    if (registrations === manager.registrations.state) return pending;\n    registrations = manager.registrations.state;\n    const sequences: PendingKeyboardSequence[] = [];\n    for (const registration of registrations.values()) {\n      const view = toHotkeyRegistrationView(registration);\n      if (view.kind === \"sequence\" && view.matchedStepCount > 0) {\n        sequences.push({\n          id: view.id,\n          hotkey: view.hotkey,\n          matchedStepCount: view.matchedStepCount,\n          scope: view.options.scope ?? \"global\",\n          target: view.target,\n        });\n      }\n    }\n    pending = sequences;\n    return pending;\n  }\n\n  function requireLive(): void {\n    if (disposed) throw new Error(\"Keyboard port has been disposed.\");\n  }\n\n  function own(cleanup: () => void): () => void {\n    const release = () => {\n      if (!releases.delete(release)) return;\n      cleanup();\n    };\n    releases.add(release);\n    return release;\n  }\n\n  return {\n    platform,\n    parse(input) {\n      if (\n        typeof input !== \"string\" &&\n        !(\n          Array.isArray(input) &&\n          Array.from(input).every((step: unknown) => typeof step === \"string\")\n        )\n      ) {\n        return { ok: false, reason: \"Expected a hotkey string or an array of hotkey strings.\" };\n      }\n      try {\n        const steps: readonly string[] = typeof input === \"string\" ? [input] : input;\n        const normalized: KeyboardHotkeyChord[] = [];\n        const knownKeys: ReadonlySet<string> = ALL_KEYS;\n        for (const step of steps) {\n          const validation = validateHotkey(step);\n          if (!validation.valid) return { ok: false, reason: validation.errors.join(\"; \") };\n          const parsed = parseHotkey(step, platform);\n          // Upstream validates key-name shape, so even \"Bogus\" passes. Use its\n          // canonical logical-key set before trusting its normalized return type.\n          if (parsed.key !== undefined && !knownKeys.has(parsed.key)) {\n            return { ok: false, reason: `Unknown key: '${parsed.key}'.` };\n          }\n          normalized.push(normalizeHotkey(step, platform));\n        }\n        const first = normalized[0];\n        if (first === undefined) return { ok: false, reason: \"Sequence cannot be empty.\" };\n        return { ok: true, hotkey: normalized.length === 1 ? first : normalized };\n      } catch (cause) {\n        return { ok: false, reason: cause instanceof Error ? cause.message : \"Invalid hotkey.\" };\n      }\n    },\n    format: (hotkey) =>\n      typeof hotkey === \"string\"\n        ? formatChord(hotkey, platform)\n        : hotkey.map((step) => formatChord(step, platform)).join(\" \"),\n    activateScope(scope, options) {\n      requireLive();\n      return own(manager.activateScope(scope, options));\n    },\n    bind(hotkey, handler, options = {}) {\n      requireLive();\n      let currentOptions: KeyboardBindingOptions = options;\n      let currentHandler = handler;\n      const targetDocument = () => {\n        const target = currentOptions.target;\n        if (target && \"document\" in target) return target.document;\n        // Document also has ownerDocument, but its value is null.\n        if (target && \"defaultView\" in target) return target;\n        return target?.ownerDocument ?? (typeof document === \"undefined\" ? undefined : document);\n      };\n      const resolvedOptions = (): HotkeyOptions & { conflictBehavior: \"allow\" } => {\n        const { ignoreInputs, ...bindingOptions } = currentOptions;\n        return {\n          ...bindingOptions,\n          ...(ignoreInputs === undefined\n            ? {}\n            : { ignoreInputs: ignoreInputs === \"editable\" ? false : ignoreInputs }),\n          enabled:\n            currentOptions.enabled !== false &&\n            (ignoreInputs !== \"editable\" || !isKeyboardEditable(targetDocument()?.activeElement)),\n          conflictBehavior: \"allow\",\n        };\n      };\n      let handle = register.call(manager, hotkey, handler, resolvedOptions());\n      let releaseFocus = () => {};\n      function watchFocus(): void {\n        releaseFocus();\n        if (currentOptions.ignoreInputs !== \"editable\") return;\n        const doc = targetDocument();\n        if (!doc) return;\n        const update = (event: FocusEvent) => {\n          const next = event.type === \"focusout\" ? event.relatedTarget : doc.activeElement;\n          const element = next instanceof (doc.defaultView?.Element ?? Element) ? next : null;\n          handle.setOptions({\n            enabled: currentOptions.enabled !== false && !isKeyboardEditable(element),\n          });\n        };\n        doc.addEventListener(\"focusin\", update, true);\n        doc.addEventListener(\"focusout\", update, true);\n        releaseFocus = () => {\n          doc.removeEventListener(\"focusin\", update, true);\n          doc.removeEventListener(\"focusout\", update, true);\n        };\n      }\n      watchFocus();\n      let active = true;\n      const dispose = own(() => {\n        active = false;\n        releaseFocus();\n        handle.unregister();\n      });\n      return {\n        update({ handler: nextHandler, ...nextOptions }) {\n          if (!active) return;\n          const previousTarget = currentOptions.target;\n          currentOptions = { ...currentOptions, ...nextOptions };\n          currentHandler = nextHandler ?? currentHandler;\n          // Hotkeys setOptions does not move a registration to a different target.\n          if (currentOptions.target !== previousTarget) {\n            handle.unregister();\n            handle = register.call(manager, hotkey, currentHandler, resolvedOptions());\n          } else {\n            handle.callback = currentHandler;\n            handle.setOptions(resolvedOptions());\n          }\n          watchFocus();\n        },\n        dispose,\n      };\n    },\n    pending: {\n      get: readPending,\n      subscribe(listener) {\n        if (disposed) return () => {};\n        const subscription = manager.registrations.subscribe(() => listener(readPending()));\n        return own(subscription.unsubscribe);\n      },\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      for (const release of releases) release();\n      manager.destroy();\n      readPending();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Store, StorePort } from "./ports/store.js";
 import { KeyboardBinding, KeyboardBindingOptions, KeyboardHandler, KeyboardHotkey, KeyboardHotkeyChord, KeyboardParseResult, KeyboardPendingStore, KeyboardPlatform, KeyboardPort, KeyboardScopeOptions, KeyboardTarget, PendingKeyboardSequence } from "./ports/keyboard.js";
-import { tradingPreset } from "./commands/trading-preset.js";
-import { Command, CommandContext, CommandId, CommandScopeOptions, Commands, KeyOverrideId, KeyOverrides, KeymapEntry, KeysOptions, PendingConfirm, Preset, Register, ValidatedKeyOverrides } from "./commands/types.js";
+import { shiftedTreePreset, tradingPreset, treePreset } from "./commands/trading-preset.js";
+import { Command, CommandContext, CommandId, CommandScopeOptions, Commands, KeyLayer, KeyOverrideId, KeyOverrides, KeymapEntry, KeysOptions, PendingConfirm, Preset, Register, ValidatedKeyOverrides } from "./commands/types.js";
 import { ClockPort } from "./ports/clock.js";
 import { ReporterPort } from "./ports/reporter.js";
 import { BasePorts, CheckedKernelOptions, Kernel, KernelOptions, Plugin, PortProviders, Ports, ResolvedPorts } from "./kernel.js";
@@ -9,15 +9,12 @@ import "./bare.js";
 import { Task } from "./task.js";
 import { ChangeDetails, Controllable } from "./controllable.js";
 import { createCommands } from "./commands/index.js";
-import { Key, Move, MoveOptions, TreeRow, TreeSource, TreeState } from "./collections/types.js";
-import { flatten } from "./collections/flatten.js";
-import { move } from "./collections/move.js";
-import { reconcile } from "./collections/reconcile.js";
-import { clearSelection, selectAll, selectRange, toggleSelection } from "./collections/selection.js";
-import { Tree, TreeAction, TreeChangeReason, TreeCommands, TreeFocusStrategy, TreeMode, TreeOptions, TreePartProps, TreeRootProps, TreeRowProps, TreeSnapshot, TreeToggleProps } from "./tree/types.js";
-import { createTree } from "./tree/index.js";
+import { TreeAction, TreeChangeReason, TreeCommands, TreeFocusStrategy, TreeLabels, TreeMode, TreePartProps, TreeRootProps, TreeRowProps, TreeToggleProps } from "./tree/types.js";
+import { createNavigableTable, navigationFeature, navigationFeatures } from "./navigation/index.js";
+import { NavigableTable, NavigationCommands, NavigationFeatures, NavigationOptions, NavigationRow, NavigationSnapshot, NavigationState, NavigationTable } from "./navigation/types.js";
+import { ExpandedState, RowData, RowSelectionState } from "@tanstack/table-core";
 export declare const version = "0.0.0";
 /** Creates an app-scoped kernel; explicit ports override plugins, which override defaults. */
 export declare function createKernel<const Options extends KernelOptions = KernelOptions>(options?: Options & CheckedKernelOptions<Options>): Kernel<ResolvedPorts<Options>>;
-export { type BasePorts, type ChangeDetails, type ClockPort, type Command, type CommandContext, type CommandId, type CommandScopeOptions, type Commands, type Controllable, type Kernel, type KernelOptions, type Key, type KeyOverrideId, type KeyOverrides, type KeyboardBinding, type KeyboardBindingOptions, type KeyboardHandler, type KeyboardHotkey, type KeyboardHotkeyChord, type KeyboardParseResult, type KeyboardPendingStore, type KeyboardPlatform, type KeyboardPort, type KeyboardScopeOptions, type KeyboardTarget, type KeymapEntry, type KeysOptions, type Move, type MoveOptions, type PendingConfirm, type PendingKeyboardSequence, type Plugin, type PortProviders, type Ports, type Preset, type Register, type ReporterPort, type ResolvedPorts, type Store, type StorePort, type Task, type Tree, type TreeAction, type TreeChangeReason, type TreeCommands, type TreeFocusStrategy, type TreeMode, type TreeOptions, type TreePartProps, type TreeRootProps, type TreeRow, type TreeRowProps, type TreeSnapshot, type TreeSource, type TreeState, type TreeToggleProps, type ValidatedKeyOverrides, clearSelection, createCommands, createTree, flatten, move, reconcile, selectAll, selectRange, toggleSelection, tradingPreset };
+export { type BasePorts, type ChangeDetails, type ClockPort, type Command, type CommandContext, type CommandId, type CommandScopeOptions, type Commands, type Controllable, type ExpandedState, type Kernel, type KernelOptions, type KeyLayer, type KeyOverrideId, type KeyOverrides, type KeyboardBinding, type KeyboardBindingOptions, type KeyboardHandler, type KeyboardHotkey, type KeyboardHotkeyChord, type KeyboardParseResult, type KeyboardPendingStore, type KeyboardPlatform, type KeyboardPort, type KeyboardScopeOptions, type KeyboardTarget, type KeymapEntry, type KeysOptions, type NavigableTable, type NavigationCommands, type NavigationFeatures, type NavigationOptions, type NavigationRow, type NavigationSnapshot, type NavigationState, type NavigationTable, type PendingConfirm, type PendingKeyboardSequence, type Plugin, type PortProviders, type Ports, type Preset, type Register, type ReporterPort, type ResolvedPorts, type RowData, type RowSelectionState, type Store, type StorePort, type Task, type TreeAction, type TreeChangeReason, type TreeCommands, type TreeFocusStrategy, type TreeLabels, type TreeMode, type TreePartProps, type TreeRootProps, type TreeRowProps, type TreeToggleProps, type ValidatedKeyOverrides, createCommands, createNavigableTable, navigationFeature, navigationFeatures, shiftedTreePreset, tradingPreset, treePreset };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,12 +1,8 @@
 import { defaultProviders } from "./defaults/index.js";
-import { tradingPreset } from "./commands/trading-preset.js";
+import { shiftedTreePreset, tradingPreset, treePreset } from "./commands/trading-preset.js";
 import { resolveKernel } from "./kernel.js";
 import { createCommands } from "./commands/index.js";
-import { flatten } from "./collections/flatten.js";
-import { move } from "./collections/move.js";
-import { reconcile } from "./collections/reconcile.js";
-import { clearSelection, selectAll, selectRange, toggleSelection } from "./collections/selection.js";
-import { createTree } from "./tree/index.js";
+import { createNavigableTable, navigationFeature, navigationFeatures } from "./navigation/index.js";
 // src/index.ts
 const version = "0.0.0";
 /** Creates an app-scoped kernel; explicit ports override plugins, which override defaults. */
@@ -16,6 +12,6 @@ function createKernel(options) {
 		defaults: defaultProviders
 	});
 }
-export { clearSelection, createCommands, createKernel, createTree, flatten, move, reconcile, selectAll, selectRange, toggleSelection, tradingPreset, version };
+export { createCommands, createKernel, createNavigableTable, navigationFeature, navigationFeatures, shiftedTreePreset, tradingPreset, treePreset, version };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { defaultProviders } from \"./defaults/index.js\";\nimport { resolveKernel } from \"./kernel.js\";\nimport type { CheckedKernelOptions, Kernel, KernelOptions, ResolvedPorts } from \"./kernel.js\";\n\nexport type {\n  BasePorts,\n  Kernel,\n  KernelOptions,\n  Plugin,\n  PortProviders,\n  Ports,\n  ResolvedPorts,\n  ClockPort,\n  KeyboardPort,\n  KeyboardHotkey,\n  KeyboardHotkeyChord,\n  KeyboardPlatform,\n  KeyboardTarget,\n  KeyboardHandler,\n  KeyboardParseResult,\n  KeyboardScopeOptions,\n  KeyboardBindingOptions,\n  KeyboardBinding,\n  PendingKeyboardSequence,\n  KeyboardPendingStore,\n  ReporterPort,\n  Store,\n  StorePort,\n  Task,\n  ChangeDetails,\n  Controllable,\n} from \"./bare.js\";\n\nexport * from \"./commands/index.js\";\n\nexport const version = \"0.0.0\";\nexport * from \"./collections/index.js\";\nexport * from \"./tree/index.js\";\n\n/** Creates an app-scoped kernel; explicit ports override plugins, which override defaults. */\nexport function createKernel<const Options extends KernelOptions = KernelOptions>(\n  options?: Options & CheckedKernelOptions<Options>,\n): Kernel<ResolvedPorts<Options>> {\n  // The resolver applies the same precedence encoded by ResolvedPorts.\n  return resolveKernel({ options: options ?? {}, defaults: defaultProviders }) as Kernel<\n    ResolvedPorts<Options>\n  >;\n}\n"],"mappings":";;;;;;;;;;AAmCA,MAAa,UAAU;;AAKvB,SAAgB,aACd,SACgC;CAEhC,OAAO,cAAc;EAAE,SAAS,WAAW,CAAC;EAAG,UAAU;CAAiB,CAAC;AAG7E"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { defaultProviders } from \"./defaults/index.js\";\nimport { resolveKernel } from \"./kernel.js\";\nimport type { CheckedKernelOptions, Kernel, KernelOptions, ResolvedPorts } from \"./kernel.js\";\n\nexport type {\n  BasePorts,\n  Kernel,\n  KernelOptions,\n  Plugin,\n  PortProviders,\n  Ports,\n  ResolvedPorts,\n  ClockPort,\n  KeyboardPort,\n  KeyboardHotkey,\n  KeyboardHotkeyChord,\n  KeyboardPlatform,\n  KeyboardTarget,\n  KeyboardHandler,\n  KeyboardParseResult,\n  KeyboardScopeOptions,\n  KeyboardBindingOptions,\n  KeyboardBinding,\n  PendingKeyboardSequence,\n  KeyboardPendingStore,\n  ReporterPort,\n  Store,\n  StorePort,\n  Task,\n  ChangeDetails,\n  Controllable,\n} from \"./bare.js\";\n\nexport * from \"./commands/index.js\";\n\nexport const version = \"0.0.0\";\nexport type {\n  TreeAction,\n  TreeChangeReason,\n  TreeCommands,\n  TreeFocusStrategy,\n  TreeLabels,\n  TreeMode,\n  TreePartProps,\n  TreeRootProps,\n  TreeRowProps,\n  TreeToggleProps,\n} from \"./tree/types.js\";\nexport { createNavigableTable, navigationFeature, navigationFeatures } from \"./navigation/index.js\";\nexport type {\n  NavigableTable,\n  NavigationCommands,\n  NavigationFeatures,\n  NavigationOptions,\n  NavigationRow,\n  NavigationSnapshot,\n  NavigationState,\n  NavigationTable,\n} from \"./navigation/types.js\";\nexport type { ExpandedState, RowData, RowSelectionState } from \"@tanstack/table-core\";\n\n/** Creates an app-scoped kernel; explicit ports override plugins, which override defaults. */\nexport function createKernel<const Options extends KernelOptions = KernelOptions>(\n  options?: Options & CheckedKernelOptions<Options>,\n): Kernel<ResolvedPorts<Options>> {\n  // The resolver applies the same precedence encoded by ResolvedPorts.\n  return resolveKernel({ options: options ?? {}, defaults: defaultProviders }) as Kernel<\n    ResolvedPorts<Options>\n  >;\n}\n"],"mappings":";;;;;;AAmCA,MAAa,UAAU;;AA2BvB,SAAgB,aACd,SACgC;CAEhC,OAAO,cAAc;EAAE,SAAS,WAAW,CAAC;EAAG,UAAU;CAAiB,CAAC;AAG7E"}

package/dist/kernel.d.ts

@@ -34,24 +34,24 @@ export interface KernelOptions {
   ports?: Partial<Ports>;
   keys?: KeysOptions;
 }
-/** Reject extra override ids even through the generic port-inference entrypoints. */
+/** Reject extra override ids; valid keys retain the inferred options without another intersection. */
 export type CheckedKernelOptions<Options extends KernelOptions> = Options extends {
   keys: {
     overrides: infer Overrides;
   };
-} ? Options & {
+} ? keyof Overrides extends KeyOverrideId ? Options : Options & {
   keys: {
     overrides: Record<Exclude<keyof Overrides, KeyOverrideId>, never>;
   };
 } : Options;
 type PluginPort<Installed, Key extends keyof Ports> = Installed extends {
-  provides: Record<Key, (...args: never[]) => infer Value extends Ports[Key]>;
+  provides: { [Port in Key]: (...args: never[]) => infer Value extends Ports[Key]; };
 } ? Value : never;
 type InstalledPort<Installed, Key extends keyof Ports> = Installed extends readonly Plugin[] ? number extends Installed["length"] ? Ports[Key] : [PluginPort<Installed[number], Key>] extends [never] ? Ports[Key] : PluginPort<Installed[number], Key> : Ports[Key];
 type ConfiguredPort<Options extends KernelOptions, Key extends keyof Ports> = "plugins" extends keyof Options ? InstalledPort<Options["plugins"], Key> : Ports[Key];
 /** Shallow inference preserves required overrides and accounts for optional ones. */
 export type ResolvedPorts<Options extends KernelOptions> = { readonly [Key in keyof Ports]: Options extends {
-  ports: Record<Key, infer Value extends Ports[Key]>;
+  ports: { [Port in Key]: infer Value extends Ports[Key]; };
 } ? Value : Key extends keyof NonNullable<Options["ports"]> ? NonNullable<NonNullable<Options["ports"]>[Key]> | ConfiguredPort<Options, Key> : ConfiguredPort<Options, Key>; };
 export {};
 //# sourceMappingURL=kernel.d.ts.map

package/dist/kernel.js.map

@@ -1 +1 @@
-{"version":3,"file":"kernel.js","names":[],"sources":["../src/kernel.ts"],"sourcesContent":["import { createCommands } from \"./commands/index.js\";\nimport type { Commands, KeyOverrideId, KeysOptions } from \"./commands/types.js\";\nimport type { ClockPort } from \"./ports/clock.js\";\nimport type { KeyboardPort } from \"./ports/keyboard.js\";\nimport type { ReporterPort } from \"./ports/reporter.js\";\nimport type { StorePort } from \"./ports/store.js\";\n\nexport interface BasePorts {\n  readonly clock: ClockPort;\n  readonly reporter: ReporterPort;\n}\n\nexport interface Ports extends BasePorts {\n  readonly store: StorePort;\n  readonly keyboard: KeyboardPort;\n}\n\n/** Base factories have no dependencies; leaf factories receive only resolved base ports. */\nexport interface PortProviders {\n  clock?: () => ClockPort;\n  reporter?: () => ReporterPort;\n  store?: (base: BasePorts) => StorePort;\n  keyboard?: (base: BasePorts) => KeyboardPort;\n}\n\nexport interface Plugin {\n  readonly name: string;\n  readonly provides?: PortProviders;\n  setup?(kernel: Kernel): void | (() => void);\n}\n\nexport interface Kernel<P = Ports> {\n  readonly ports: P;\n  readonly commands: Commands;\n  /** Runs setup cleanups in reverse order, then disposes commands and the keyboard port, once. */\n  dispose(): void;\n}\n\nexport interface KernelOptions {\n  plugins?: readonly Plugin[];\n  ports?: Partial<Ports>;\n  keys?: KeysOptions;\n}\n\n/** Reject extra override ids even through the generic port-inference entrypoints. */\nexport type CheckedKernelOptions<Options extends KernelOptions> = Options extends {\n  keys: { overrides: infer Overrides };\n}\n  ? Options & { keys: { overrides: Record<Exclude<keyof Overrides, KeyOverrideId>, never> } }\n  : Options;\n\ntype PluginPort<Installed, Key extends keyof Ports> = Installed extends {\n  provides: Record<Key, (...args: never[]) => infer Value extends Ports[Key]>;\n}\n  ? Value\n  : never;\n\n// A runtime-sized array might be empty. Distribute tuple alternatives so an\n// optional plugin cannot promise a port extension that is absent at runtime.\ntype InstalledPort<Installed, Key extends keyof Ports> = Installed extends readonly Plugin[]\n  ? number extends Installed[\"length\"]\n    ? Ports[Key]\n    : [PluginPort<Installed[number], Key>] extends [never]\n      ? Ports[Key]\n      : PluginPort<Installed[number], Key>\n  : Ports[Key];\n\ntype ConfiguredPort<\n  Options extends KernelOptions,\n  Key extends keyof Ports,\n> = \"plugins\" extends keyof Options ? InstalledPort<Options[\"plugins\"], Key> : Ports[Key];\n\n/** Shallow inference preserves required overrides and accounts for optional ones. */\nexport type ResolvedPorts<Options extends KernelOptions> = {\n  readonly [Key in keyof Ports]: Options extends {\n    ports: Record<Key, infer Value extends Ports[Key]>;\n  }\n    ? Value\n    : Key extends keyof NonNullable<Options[\"ports\"]>\n      ? NonNullable<NonNullable<Options[\"ports\"]>[Key]> | ConfiguredPort<Options, Key>\n      : ConfiguredPort<Options, Key>;\n};\n\nconst portNames = [\"clock\", \"reporter\", \"store\", \"keyboard\"] as const;\n\nfunction requirePort<T>(name: keyof Ports, value: T | undefined): T {\n  if (value === undefined) {\n    throw new Error(`Missing port \"${name}\". Supply it through a plugin or explicit ports.`);\n  }\n  return value;\n}\n\n/** Internal composition root shared by main and bare; imports no implementations. */\nexport function resolveKernel({\n  options = {},\n  defaults = {},\n}: {\n  options?: KernelOptions;\n  defaults?: PortProviders;\n} = {}): Kernel {\n  const plugins = options.plugins ?? [];\n  const overrides: Partial<Ports> = options.ports ?? {};\n  const providers: PortProviders = {};\n  const owners: Partial<Record<keyof Ports, string>> = {};\n\n  // Validate all conflicts and missing ports before invoking any provider.\n  for (const plugin of plugins) {\n    for (const name of portNames) {\n      if (plugin.provides?.[name] === undefined) continue;\n      const owner = owners[name];\n      if (owner !== undefined) {\n        throw new Error(\n          `Port \"${name}\" is provided by both plugins \"${owner}\" and \"${plugin.name}\".`,\n        );\n      }\n      owners[name] = plugin.name;\n    }\n    Object.assign(providers, plugin.provides);\n  }\n  for (const name of portNames) {\n    requirePort(name, overrides[name] ?? providers[name] ?? defaults[name]);\n  }\n\n  const base: BasePorts = {\n    clock: requirePort(\"clock\", overrides.clock ?? (providers.clock ?? defaults.clock)?.()),\n    reporter: requirePort(\n      \"reporter\",\n      overrides.reporter ?? (providers.reporter ?? defaults.reporter)?.(),\n    ),\n  };\n  const ports: Ports = {\n    ...base,\n    store: requirePort(\"store\", overrides.store ?? (providers.store ?? defaults.store)?.(base)),\n    keyboard: requirePort(\n      \"keyboard\",\n      overrides.keyboard ?? (providers.keyboard ?? defaults.keyboard)?.(base),\n    ),\n  };\n  const cleanups: (() => void)[] = [() => ports.keyboard.dispose()];\n  let commands: Commands;\n  try {\n    commands = createCommands({\n      ports,\n      ...(options.keys === undefined ? {} : { keys: options.keys }),\n    });\n  } catch (cause) {\n    try {\n      ports.keyboard.dispose();\n    } catch (cleanupCause) {\n      throw new AggregateError([cause, cleanupCause], \"Command setup and keyboard cleanup failed.\");\n    }\n    throw cause;\n  }\n  cleanups.push(() => commands.dispose());\n  let disposed = false;\n  const kernel: Kernel = {\n    ports,\n    commands,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      const errors: unknown[] = [];\n      for (const cleanup of cleanups.reverse()) {\n        try {\n          cleanup();\n        } catch (cause) {\n          errors.push(cause);\n        }\n      }\n      cleanups.length = 0;\n      if (errors.length > 0) {\n        throw new AggregateError(errors, \"Kernel cleanup failed.\");\n      }\n    },\n  };\n\n  try {\n    for (const plugin of plugins) {\n      if (disposed) break;\n      const cleanup = plugin.setup?.(kernel);\n      if (cleanup) {\n        // setup can itself dispose the kernel before returning its cleanup.\n        if (disposed) cleanup();\n        else cleanups.push(cleanup);\n      }\n    }\n  } catch (cause) {\n    try {\n      kernel.dispose();\n    } catch (cleanupCause) {\n      throw new AggregateError([cause, cleanupCause], \"Kernel setup and cleanup failed.\");\n    }\n    throw cause;\n  }\n\n  return kernel;\n}\n"],"mappings":";;AAmFA,MAAM,YAAY;CAAC;CAAS;CAAY;CAAS;AAAU;AAE3D,SAAS,YAAe,MAAmB,OAAyB;CAClE,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MAAM,iBAAiB,KAAK,iDAAiD;CAEzF,OAAO;AACT;;AAGA,SAAgB,cAAc,EAC5B,UAAU,CAAC,GACX,WAAW,CAAC,MAIV,CAAC,GAAW;CACd,MAAM,UAAU,QAAQ,WAAW,CAAC;CACpC,MAAM,YAA4B,QAAQ,SAAS,CAAC;CACpD,MAAM,YAA2B,CAAC;CAClC,MAAM,SAA+C,CAAC;CAGtD,KAAK,MAAM,UAAU,SAAS;EAC5B,KAAK,MAAM,QAAQ,WAAW;GAC5B,IAAI,OAAO,WAAW,UAAU,KAAA,GAAW;GAC3C,MAAM,QAAQ,OAAO;GACrB,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MACR,SAAS,KAAK,iCAAiC,MAAM,SAAS,OAAO,KAAK,GAC5E;GAEF,OAAO,QAAQ,OAAO;EACxB;EACA,OAAO,OAAO,WAAW,OAAO,QAAQ;CAC1C;CACA,KAAK,MAAM,QAAQ,WACjB,YAAY,MAAM,UAAU,SAAS,UAAU,SAAS,SAAS,KAAK;CAGxE,MAAM,OAAkB;EACtB,OAAO,YAAY,SAAS,UAAU,UAAU,UAAU,SAAS,SAAS,MAAA,GAAS,CAAC;EACtF,UAAU,YACR,YACA,UAAU,aAAa,UAAU,YAAY,SAAS,SAAA,GAAY,CACpE;CACF;CACA,MAAM,QAAe;EACnB,GAAG;EACH,OAAO,YAAY,SAAS,UAAU,UAAU,UAAU,SAAS,SAAS,MAAA,GAAS,IAAI,CAAC;EAC1F,UAAU,YACR,YACA,UAAU,aAAa,UAAU,YAAY,SAAS,SAAA,GAAY,IAAI,CACxE;CACF;CACA,MAAM,WAA2B,OAAO,MAAM,SAAS,QAAQ,CAAC;CAChE,IAAI;CACJ,IAAI;EACF,WAAW,eAAe;GACxB;GACA,GAAI,QAAQ,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;EAC7D,CAAC;CACH,SAAS,OAAO;EACd,IAAI;GACF,MAAM,SAAS,QAAQ;EACzB,SAAS,cAAc;GACrB,MAAM,IAAI,eAAe,CAAC,OAAO,YAAY,GAAG,4CAA4C;EAC9F;EACA,MAAM;CACR;CACA,SAAS,WAAW,SAAS,QAAQ,CAAC;CACtC,IAAI,WAAW;CACf,MAAM,SAAiB;EACrB;EACA;EACA,UAAU;GACR,IAAI,UAAU;GACd,WAAW;GACX,MAAM,SAAoB,CAAC;GAC3B,KAAK,MAAM,WAAW,SAAS,QAAQ,GACrC,IAAI;IACF,QAAQ;GACV,SAAS,OAAO;IACd,OAAO,KAAK,KAAK;GACnB;GAEF,SAAS,SAAS;GAClB,IAAI,OAAO,SAAS,GAClB,MAAM,IAAI,eAAe,QAAQ,wBAAwB;EAE7D;CACF;CAEA,IAAI;EACF,KAAK,MAAM,UAAU,SAAS;GAC5B,IAAI,UAAU;GACd,MAAM,UAAU,OAAO,QAAQ,MAAM;GACrC,IAAI,SAAS;IAEX,IAAI,UAAU,QAAQ;SACjB,SAAS,KAAK,OAAO;GAC5B;EACF;CACF,SAAS,OAAO;EACd,IAAI;GACF,OAAO,QAAQ;EACjB,SAAS,cAAc;GACrB,MAAM,IAAI,eAAe,CAAC,OAAO,YAAY,GAAG,kCAAkC;EACpF;EACA,MAAM;CACR;CAEA,OAAO;AACT"}
+{"version":3,"file":"kernel.js","names":[],"sources":["../src/kernel.ts"],"sourcesContent":["import { createCommands } from \"./commands/index.js\";\nimport type { Commands, KeyOverrideId, KeysOptions } from \"./commands/types.js\";\nimport type { ClockPort } from \"./ports/clock.js\";\nimport type { KeyboardPort } from \"./ports/keyboard.js\";\nimport type { ReporterPort } from \"./ports/reporter.js\";\nimport type { StorePort } from \"./ports/store.js\";\n\nexport interface BasePorts {\n  readonly clock: ClockPort;\n  readonly reporter: ReporterPort;\n}\n\nexport interface Ports extends BasePorts {\n  readonly store: StorePort;\n  readonly keyboard: KeyboardPort;\n}\n\n/** Base factories have no dependencies; leaf factories receive only resolved base ports. */\nexport interface PortProviders {\n  clock?: () => ClockPort;\n  reporter?: () => ReporterPort;\n  store?: (base: BasePorts) => StorePort;\n  keyboard?: (base: BasePorts) => KeyboardPort;\n}\n\nexport interface Plugin {\n  readonly name: string;\n  readonly provides?: PortProviders;\n  setup?(kernel: Kernel): void | (() => void);\n}\n\nexport interface Kernel<P = Ports> {\n  readonly ports: P;\n  readonly commands: Commands;\n  /** Runs setup cleanups in reverse order, then disposes commands and the keyboard port, once. */\n  dispose(): void;\n}\n\nexport interface KernelOptions {\n  plugins?: readonly Plugin[];\n  ports?: Partial<Ports>;\n  keys?: KeysOptions;\n}\n\n/** Reject extra override ids; valid keys retain the inferred options without another intersection. */\nexport type CheckedKernelOptions<Options extends KernelOptions> = Options extends {\n  keys: { overrides: infer Overrides };\n}\n  ? keyof Overrides extends KeyOverrideId\n    ? Options\n    : Options & { keys: { overrides: Record<Exclude<keyof Overrides, KeyOverrideId>, never> } }\n  : Options;\n\ntype PluginPort<Installed, Key extends keyof Ports> = Installed extends {\n  provides: { [Port in Key]: (...args: never[]) => infer Value extends Ports[Key] };\n}\n  ? Value\n  : never;\n\n// A runtime-sized array might be empty. Distribute tuple alternatives so an\n// optional plugin cannot promise a port extension that is absent at runtime.\ntype InstalledPort<Installed, Key extends keyof Ports> = Installed extends readonly Plugin[]\n  ? number extends Installed[\"length\"]\n    ? Ports[Key]\n    : [PluginPort<Installed[number], Key>] extends [never]\n      ? Ports[Key]\n      : PluginPort<Installed[number], Key>\n  : Ports[Key];\n\ntype ConfiguredPort<\n  Options extends KernelOptions,\n  Key extends keyof Ports,\n> = \"plugins\" extends keyof Options ? InstalledPort<Options[\"plugins\"], Key> : Ports[Key];\n\n/** Shallow inference preserves required overrides and accounts for optional ones. */\nexport type ResolvedPorts<Options extends KernelOptions> = {\n  readonly [Key in keyof Ports]: Options extends {\n    ports: { [Port in Key]: infer Value extends Ports[Key] };\n  }\n    ? Value\n    : Key extends keyof NonNullable<Options[\"ports\"]>\n      ? NonNullable<NonNullable<Options[\"ports\"]>[Key]> | ConfiguredPort<Options, Key>\n      : ConfiguredPort<Options, Key>;\n};\n\nconst portNames = [\"clock\", \"reporter\", \"store\", \"keyboard\"] as const;\n\nfunction requirePort<T>(name: keyof Ports, value: T | undefined): T {\n  if (value === undefined) {\n    throw new Error(`Missing port \"${name}\". Supply it through a plugin or explicit ports.`);\n  }\n  return value;\n}\n\n/** Internal composition root shared by main and bare; imports no implementations. */\nexport function resolveKernel({\n  options = {},\n  defaults = {},\n}: {\n  options?: KernelOptions;\n  defaults?: PortProviders;\n} = {}): Kernel {\n  const plugins = options.plugins ?? [];\n  const overrides: Partial<Ports> = options.ports ?? {};\n  const providers: PortProviders = {};\n  const owners: Partial<Record<keyof Ports, string>> = {};\n\n  // Validate all conflicts and missing ports before invoking any provider.\n  for (const plugin of plugins) {\n    for (const name of portNames) {\n      if (plugin.provides?.[name] === undefined) continue;\n      const owner = owners[name];\n      if (owner !== undefined) {\n        throw new Error(\n          `Port \"${name}\" is provided by both plugins \"${owner}\" and \"${plugin.name}\".`,\n        );\n      }\n      owners[name] = plugin.name;\n    }\n    Object.assign(providers, plugin.provides);\n  }\n  for (const name of portNames) {\n    requirePort(name, overrides[name] ?? providers[name] ?? defaults[name]);\n  }\n\n  const base: BasePorts = {\n    clock: requirePort(\"clock\", overrides.clock ?? (providers.clock ?? defaults.clock)?.()),\n    reporter: requirePort(\n      \"reporter\",\n      overrides.reporter ?? (providers.reporter ?? defaults.reporter)?.(),\n    ),\n  };\n  const ports: Ports = {\n    ...base,\n    store: requirePort(\"store\", overrides.store ?? (providers.store ?? defaults.store)?.(base)),\n    keyboard: requirePort(\n      \"keyboard\",\n      overrides.keyboard ?? (providers.keyboard ?? defaults.keyboard)?.(base),\n    ),\n  };\n  const cleanups: (() => void)[] = [() => ports.keyboard.dispose()];\n  let commands: Commands;\n  try {\n    commands = createCommands({\n      ports,\n      ...(options.keys === undefined ? {} : { keys: options.keys }),\n    });\n  } catch (cause) {\n    try {\n      ports.keyboard.dispose();\n    } catch (cleanupCause) {\n      throw new AggregateError([cause, cleanupCause], \"Command setup and keyboard cleanup failed.\");\n    }\n    throw cause;\n  }\n  cleanups.push(() => commands.dispose());\n  let disposed = false;\n  const kernel: Kernel = {\n    ports,\n    commands,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      const errors: unknown[] = [];\n      for (const cleanup of cleanups.reverse()) {\n        try {\n          cleanup();\n        } catch (cause) {\n          errors.push(cause);\n        }\n      }\n      cleanups.length = 0;\n      if (errors.length > 0) {\n        throw new AggregateError(errors, \"Kernel cleanup failed.\");\n      }\n    },\n  };\n\n  try {\n    for (const plugin of plugins) {\n      if (disposed) break;\n      const cleanup = plugin.setup?.(kernel);\n      if (cleanup) {\n        // setup can itself dispose the kernel before returning its cleanup.\n        if (disposed) cleanup();\n        else cleanups.push(cleanup);\n      }\n    }\n  } catch (cause) {\n    try {\n      kernel.dispose();\n    } catch (cleanupCause) {\n      throw new AggregateError([cause, cleanupCause], \"Kernel setup and cleanup failed.\");\n    }\n    throw cause;\n  }\n\n  return kernel;\n}\n"],"mappings":";;AAqFA,MAAM,YAAY;CAAC;CAAS;CAAY;CAAS;AAAU;AAE3D,SAAS,YAAe,MAAmB,OAAyB;CAClE,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MAAM,iBAAiB,KAAK,iDAAiD;CAEzF,OAAO;AACT;;AAGA,SAAgB,cAAc,EAC5B,UAAU,CAAC,GACX,WAAW,CAAC,MAIV,CAAC,GAAW;CACd,MAAM,UAAU,QAAQ,WAAW,CAAC;CACpC,MAAM,YAA4B,QAAQ,SAAS,CAAC;CACpD,MAAM,YAA2B,CAAC;CAClC,MAAM,SAA+C,CAAC;CAGtD,KAAK,MAAM,UAAU,SAAS;EAC5B,KAAK,MAAM,QAAQ,WAAW;GAC5B,IAAI,OAAO,WAAW,UAAU,KAAA,GAAW;GAC3C,MAAM,QAAQ,OAAO;GACrB,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MACR,SAAS,KAAK,iCAAiC,MAAM,SAAS,OAAO,KAAK,GAC5E;GAEF,OAAO,QAAQ,OAAO;EACxB;EACA,OAAO,OAAO,WAAW,OAAO,QAAQ;CAC1C;CACA,KAAK,MAAM,QAAQ,WACjB,YAAY,MAAM,UAAU,SAAS,UAAU,SAAS,SAAS,KAAK;CAGxE,MAAM,OAAkB;EACtB,OAAO,YAAY,SAAS,UAAU,UAAU,UAAU,SAAS,SAAS,MAAA,GAAS,CAAC;EACtF,UAAU,YACR,YACA,UAAU,aAAa,UAAU,YAAY,SAAS,SAAA,GAAY,CACpE;CACF;CACA,MAAM,QAAe;EACnB,GAAG;EACH,OAAO,YAAY,SAAS,UAAU,UAAU,UAAU,SAAS,SAAS,MAAA,GAAS,IAAI,CAAC;EAC1F,UAAU,YACR,YACA,UAAU,aAAa,UAAU,YAAY,SAAS,SAAA,GAAY,IAAI,CACxE;CACF;CACA,MAAM,WAA2B,OAAO,MAAM,SAAS,QAAQ,CAAC;CAChE,IAAI;CACJ,IAAI;EACF,WAAW,eAAe;GACxB;GACA,GAAI,QAAQ,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;EAC7D,CAAC;CACH,SAAS,OAAO;EACd,IAAI;GACF,MAAM,SAAS,QAAQ;EACzB,SAAS,cAAc;GACrB,MAAM,IAAI,eAAe,CAAC,OAAO,YAAY,GAAG,4CAA4C;EAC9F;EACA,MAAM;CACR;CACA,SAAS,WAAW,SAAS,QAAQ,CAAC;CACtC,IAAI,WAAW;CACf,MAAM,SAAiB;EACrB;EACA;EACA,UAAU;GACR,IAAI,UAAU;GACd,WAAW;GACX,MAAM,SAAoB,CAAC;GAC3B,KAAK,MAAM,WAAW,SAAS,QAAQ,GACrC,IAAI;IACF,QAAQ;GACV,SAAS,OAAO;IACd,OAAO,KAAK,KAAK;GACnB;GAEF,SAAS,SAAS;GAClB,IAAI,OAAO,SAAS,GAClB,MAAM,IAAI,eAAe,QAAQ,wBAAwB;EAE7D;CACF;CAEA,IAAI;EACF,KAAK,MAAM,UAAU,SAAS;GAC5B,IAAI,UAAU;GACd,MAAM,UAAU,OAAO,QAAQ,MAAM;GACrC,IAAI,SAAS;IAEX,IAAI,UAAU,QAAQ;SACjB,SAAS,KAAK,OAAO;GAC5B;EACF;CACF,SAAS,OAAO;EACd,IAAI;GACF,OAAO,QAAQ;EACjB,SAAS,cAAc;GACrB,MAAM,IAAI,eAAe,CAAC,OAAO,YAAY,GAAG,kCAAkC;EACpF;EACA,MAAM;CACR;CAEA,OAAO;AACT"}