@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

package/dist/esm/core/hotkey/DefaultHotkeyHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultHotkeyHandler.js","sourceRoot":"","sources":["../../../../src/core/hotkey/DefaultHotkeyHandler.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Registers config-driven application hotkeys:\n * - `[HOTKEY].emitShortcuts` → dispatch `FrontendEvents` (sidebar toggle, palette-adjacent surfaces, etc.)\n * - `[HOTKEY].bindings` → navigate via `resolveHotkeyBindings` / `NavigationUtils`\n *\n * Command menu keyboard open is owned by `useCommandMenuBehavior` (`[COMMAND_MENU].openShortcut`),\n * not this component, so Cmd+K is not double-registered.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  ApplicationLevelComponentType,\n  HotkeyDispatchableEvent,\n  HotkeyGroup,\n  HotkeyScope,\n  type HotkeyEmitShortcut,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type { HotkeyBinding } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { useHotkeyRegistry } from './useHotkey';\nimport { HOTKEY_FRAMEWORK_DEFAULT_PRIORITY } from './hotkey-registry.frontend.schemas';\nimport { mergeHotkeyEmitShortcuts } from './merge-hotkey-emit-shortcuts';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport {\n  FrontendEvents,\n  type FrontendEvent_HotkeyNotificationsOpen,\n  type FrontendEvent_HotkeyQuickSwitcherOpen,\n  type FrontendEvent_HotkeyShortcutsHelp,\n  type FrontendEvent_HotkeySidebarToggle,\n} from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport {\n  filterHotkeyBindingsByRuntimeAvailability,\n  useLauncherRuntimeAvailabilityContext,\n} from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport { resolveHotkeyBindings, type ResolvedHotkeyBinding } from '~wildo-frontend-lib/core/navigation/launcher-resolution';\nimport { useLauncherResolutionContext } from '~wildo-frontend-lib/core/navigation/useLauncherResolutionContext';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\nconst DEFAULT_EMIT_DESCRIPTION_KEYS: Record<HotkeyDispatchableEvent, string> = {\n  [HotkeyDispatchableEvent.HOTKEY_SIDEBAR_TOGGLE]: 'engine.hotkeys.sidebarToggle',\n  [HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN]: 'engine.hotkeys.notificationsOpen',\n  [HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN]: 'engine.hotkeys.quickSwitcherOpen',\n  [HotkeyDispatchableEvent.HOTKEY_SHORTCUTS_HELP]: 'engine.hotkeys.shortcutsHelp',\n};\n\n/**\n * The framework's DEFAULT chord for each dispatchable event (#441).\n *\n * Until 2026-09-08 the baseline was `[]`: an application's `emitShortcuts` was the ONLY binding\n * channel, no shipped configuration declared one, and so the shortcuts help dialog was mounted for\n * every application and openable by keyboard in none of them.\n *\n * ## How an application overrides\n *\n * `mergeHotkeyEmitShortcuts` keys by EVENT, so an application row for the same event replaces the\n * default outright — application beats framework, with no new mechanism and no arbitration. Setting\n * `enabled: false` on a row removes the binding entirely.\n *\n * ## Why these chords\n *\n * Conventions people already have in their fingers, not inventions:\n *   - `Mod+B` — the sidebar toggle in VS Code, Linear and Notion.\n *   - `Mod+P` — quick-open / switcher, from VS Code. `Mod+K` was NOT available: the command menu\n *     owns it through `[COMMAND_MENU].openShortcut`, and double-registering it is the collision\n *     this issue's other half exists to arbitrate.\n *   - `Mod+I` — inbox, Linear's mnemonic for the notification surface.\n *   - `Shift+?` — the universal \"show shortcuts\" chord (GitHub, Slack, Gmail, Linear).\n *\n * `Shift+?` is spelled with its modifier deliberately. Matching is strict, and typing `?` raises\n * `shiftKey`, so a chord written `?` alone can never match — it would have shipped a help dialog\n * that still could not be opened, which is the exact defect being closed.\n */\nexport const ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS: readonly HotkeyEmitShortcut[] = [\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_SIDEBAR_TOGGLE,\n    shortcut: 'Mod+B',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.NAVIGATION,\n  },\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN,\n    shortcut: 'Mod+P',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.NAVIGATION,\n  },\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN,\n    shortcut: 'Mod+I',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.NAVIGATION,\n  },\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_SHORTCUTS_HELP,\n    shortcut: 'Shift+?',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.HELP,\n  },\n];\n\n/**\n * Whether a merged row is the framework's own default rather than one the application authored.\n *\n * Identity by REFERENCE: `mergeHotkeyEmitShortcuts` either keeps the default object or replaces it\n * with the application's, so the surviving object IS the answer. Comparing by event would be wrong\n * — an application row for the same event is exactly the case that must NOT be treated as a\n * framework default.\n */\nfunction isFrameworkDefaultRow(row: HotkeyEmitShortcut): boolean {\n  return ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS.includes(row);\n}\n\nfunction launcherForEmitEvent(event: HotkeyDispatchableEvent): ApplicationLevelComponentType | undefined {\n  switch (event) {\n    case HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN:\n      return ApplicationLevelComponentType.QUICK_SWITCHER;\n    case HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN:\n      return ApplicationLevelComponentType.NOTIFICATION_CENTER;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Renderless component — registers hotkeys from `[HOTKEY]` config.\n */\nexport function DefaultHotkeyHandler(): null {\n  const { register } = useHotkeyRegistry();\n  const { emit } = useEventBus();\n  const resolutionCtx = useLauncherResolutionContext();\n  const { navigate } = useNavigationController();\n  const { appComponentsConfiguration } = useUI();\n  const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();\n\n  const hotkeyConfig = appComponentsConfiguration?.[ApplicationLevelComponentType.HOTKEY];\n  const rawConfigBindings: HotkeyBinding[] | undefined =\n    typeof hotkeyConfig === 'object' && hotkeyConfig !== null\n      ? (hotkeyConfig as { bindings?: HotkeyBinding[] }).bindings\n      : undefined;\n  const configBindings = useMemo(() => (\n    filterHotkeyBindingsByRuntimeAvailability(rawConfigBindings, runtimeAvailabilityContext)\n  ), [rawConfigBindings, runtimeAvailabilityContext]);\n\n  const configEmitShortcuts: HotkeyEmitShortcut[] | undefined =\n    typeof hotkeyConfig === 'object' && hotkeyConfig !== null\n      ? (hotkeyConfig as { emitShortcuts?: HotkeyEmitShortcut[] }).emitShortcuts\n      : undefined;\n\n  const emitShortcuts = useMemo(\n    // The baseline was `[]` until #441 — which is why an application declaring no `emitShortcuts`\n    // got no working shortcuts at all, help dialog included.\n    () => mergeHotkeyEmitShortcuts(ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS, configEmitShortcuts),\n    [configEmitShortcuts],\n  );\n\n  const resolvedBindings = useMemo((): ResolvedHotkeyBinding[] => {\n    if (!configBindings || !resolutionCtx) return [];\n    return resolveHotkeyBindings(configBindings, resolutionCtx);\n  }, [configBindings, resolutionCtx]);\n\n  useEffect(() => {\n    const unregisterFns: Array<() => void> = [];\n\n    const describeEmitRow = (row: HotkeyEmitShortcut): string => {\n      const key = row.descriptionLabellingRef ?? DEFAULT_EMIT_DESCRIPTION_KEYS[row.event];\n      return resolutionCtx ? resolutionCtx.t(key) : key;\n    };\n\n    for (const row of emitShortcuts) {\n      if (row.enabled === false) continue;\n      unregisterFns.push(\n        register({\n          id: `app-emit-${row.event}`,\n          shortcut: row.shortcut,\n          description: describeEmitRow(row),\n          scope: row.scope ?? HotkeyScope.GLOBAL,\n          group: row.group,\n          handler: () => {\n            switch (row.event) {\n              case HotkeyDispatchableEvent.HOTKEY_SIDEBAR_TOGGLE:\n                emit(FrontendEvents.HOTKEY_SIDEBAR_TOGGLE, {} as FrontendEvent_HotkeySidebarToggle);\n                break;\n              case HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN:\n                emit(FrontendEvents.HOTKEY_NOTIFICATIONS_OPEN, {} as FrontendEvent_HotkeyNotificationsOpen);\n                break;\n              case HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN:\n                emit(FrontendEvents.HOTKEY_QUICK_SWITCHER_OPEN, {} as FrontendEvent_HotkeyQuickSwitcherOpen);\n                break;\n              case HotkeyDispatchableEvent.HOTKEY_SHORTCUTS_HELP:\n                emit(FrontendEvents.HOTKEY_SHORTCUTS_HELP, {} as FrontendEvent_HotkeyShortcutsHelp);\n                break;\n              default:\n                break;\n            }\n          },\n          launcher: launcherForEmitEvent(row.event),\n          preventDefault: row.preventDefault !== false,\n          /*\n           * A row the FRAMEWORK supplied registers below an application's own (#441). The merge\n           * already replaces a default per event, so this only matters for the other collision: an\n           * application binding a DIFFERENT event to a chord a framework default also claims. The\n           * application meant its binding; the default is what was offered when nothing was said.\n           */\n          priority: isFrameworkDefaultRow(row) ? HOTKEY_FRAMEWORK_DEFAULT_PRIORITY : undefined,\n        }),\n      );\n    }\n\n    for (const binding of resolvedBindings) {\n      unregisterFns.push(\n        register({\n          id: `app-hotkey-${binding.id}`,\n          shortcut: binding.shortcut,\n          description: binding.description ?? binding.label,\n          scope: binding.scope ?? HotkeyScope.GLOBAL,\n          group: HotkeyGroup.ACTIONS,\n          handler: () => {\n            NavigationUtils.dispatchNavigationForResolvedTarget(\n              navigate,\n              binding,\n              ApplicationLevelComponentType.HOTKEY,\n            );\n          },\n          launcher: ApplicationLevelComponentType.HOTKEY,\n          preventDefault: true,\n        }),\n      );\n    }\n\n    return () => {\n      for (const unregister of unregisterFns) {\n        unregister();\n      }\n    };\n  }, [register, emit, resolvedBindings, navigate, emitShortcuts, resolutionCtx]);\n\n  return null;\n}\n"]}
+{"version":3,"file":"DefaultHotkeyHandler.js","sourceRoot":"","sources":["../../../../../src/core/hotkey/DefaultHotkeyHandler.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Registers config-driven application hotkeys:\n * - `[HOTKEY].emitShortcuts` → dispatch `FrontendEvents` (sidebar toggle, palette-adjacent surfaces, etc.)\n * - `[HOTKEY].bindings` → navigate via `resolveHotkeyBindings` / `NavigationUtils`\n *\n * Command menu keyboard open is owned by `useCommandMenuBehavior` (`[COMMAND_MENU].openShortcut`),\n * not this component, so Cmd+K is not double-registered.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  ApplicationLevelComponentType,\n  HotkeyDispatchableEvent,\n  HotkeyGroup,\n  HotkeyScope,\n  type HotkeyEmitShortcut,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type { HotkeyBinding } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { useHotkeyRegistry } from './useHotkey';\nimport { HOTKEY_FRAMEWORK_DEFAULT_PRIORITY } from './hotkey-registry.frontend.schemas';\nimport { mergeHotkeyEmitShortcuts } from './merge-hotkey-emit-shortcuts';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport {\n  FrontendEvents,\n  type FrontendEvent_HotkeyNotificationsOpen,\n  type FrontendEvent_HotkeyQuickSwitcherOpen,\n  type FrontendEvent_HotkeyShortcutsHelp,\n  type FrontendEvent_HotkeySidebarToggle,\n} from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport {\n  filterHotkeyBindingsByRuntimeAvailability,\n  useLauncherRuntimeAvailabilityContext,\n} from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport { resolveHotkeyBindings, type ResolvedHotkeyBinding } from '~wildo-frontend-lib/core/navigation/launcher-resolution';\nimport { useLauncherResolutionContext } from '~wildo-frontend-lib/core/navigation/useLauncherResolutionContext';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\nconst DEFAULT_EMIT_DESCRIPTION_KEYS: Record<HotkeyDispatchableEvent, string> = {\n  [HotkeyDispatchableEvent.HOTKEY_SIDEBAR_TOGGLE]: 'engine.hotkeys.sidebarToggle',\n  [HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN]: 'engine.hotkeys.notificationsOpen',\n  [HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN]: 'engine.hotkeys.quickSwitcherOpen',\n  [HotkeyDispatchableEvent.HOTKEY_SHORTCUTS_HELP]: 'engine.hotkeys.shortcutsHelp',\n};\n\n/**\n * The framework's DEFAULT chord for each dispatchable event (#441).\n *\n * Until 2026-09-08 the baseline was `[]`: an application's `emitShortcuts` was the ONLY binding\n * channel, no shipped configuration declared one, and so the shortcuts help dialog was mounted for\n * every application and openable by keyboard in none of them.\n *\n * ## How an application overrides\n *\n * `mergeHotkeyEmitShortcuts` keys by EVENT, so an application row for the same event replaces the\n * default outright — application beats framework, with no new mechanism and no arbitration. Setting\n * `enabled: false` on a row removes the binding entirely.\n *\n * ## Why these chords\n *\n * Conventions people already have in their fingers, not inventions:\n *   - `Mod+B` — the sidebar toggle in VS Code, Linear and Notion.\n *   - `Mod+P` — quick-open / switcher, from VS Code. `Mod+K` was NOT available: the command menu\n *     owns it through `[COMMAND_MENU].openShortcut`, and double-registering it is the collision\n *     this issue's other half exists to arbitrate.\n *   - `Mod+I` — inbox, Linear's mnemonic for the notification surface.\n *   - `?` — the universal \"show shortcuts\" chord (GitHub, Slack, Gmail, Linear).\n *\n * `?` is spelled WITHOUT a Shift modifier, and this replaces a `Shift+?` that shipped from\n * 2026-09-08 to 2026-09-15. That spelling reasoned from a US keyboard — typing `?` there raises\n * `shiftKey`, and the matcher compared it strictly — and rendered `⇧?` in the shortcuts dialog. But\n * whether Shift is part of typing `?` is a property of the LAYOUT, not of the chord, so Shift is\n * not a modifier axis for a glyph key at all: `parseShortcut` normalizes it away and\n * `matchesShortcut` ignores `shiftKey` for one (see `isGlyphKey`). The chord is `?` on every\n * keyboard, and the dialog shows exactly the key the reader types.\n */\nexport const ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS: readonly HotkeyEmitShortcut[] = [\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_SIDEBAR_TOGGLE,\n    shortcut: 'Mod+B',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.NAVIGATION,\n  },\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN,\n    shortcut: 'Mod+P',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.NAVIGATION,\n  },\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN,\n    shortcut: 'Mod+I',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.NAVIGATION,\n  },\n  {\n    event: HotkeyDispatchableEvent.HOTKEY_SHORTCUTS_HELP,\n    shortcut: '?',\n    scope: HotkeyScope.GLOBAL,\n    group: HotkeyGroup.HELP,\n  },\n];\n\n/**\n * Whether a merged row is the framework's own default rather than one the application authored.\n *\n * Identity by REFERENCE: `mergeHotkeyEmitShortcuts` either keeps the default object or replaces it\n * with the application's, so the surviving object IS the answer. Comparing by event would be wrong\n * — an application row for the same event is exactly the case that must NOT be treated as a\n * framework default.\n */\nfunction isFrameworkDefaultRow(row: HotkeyEmitShortcut): boolean {\n  return ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS.includes(row);\n}\n\nfunction launcherForEmitEvent(event: HotkeyDispatchableEvent): ApplicationLevelComponentType | undefined {\n  switch (event) {\n    case HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN:\n      return ApplicationLevelComponentType.QUICK_SWITCHER;\n    case HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN:\n      return ApplicationLevelComponentType.NOTIFICATION_CENTER;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Renderless component — registers hotkeys from `[HOTKEY]` config.\n */\nexport function DefaultHotkeyHandler(): null {\n  const { register } = useHotkeyRegistry();\n  const { emit } = useEventBus();\n  const resolutionCtx = useLauncherResolutionContext();\n  const { navigate } = useNavigationController();\n  const { appComponentsConfiguration } = useUI();\n  const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();\n\n  const hotkeyConfig = appComponentsConfiguration?.[ApplicationLevelComponentType.HOTKEY];\n  const rawConfigBindings: HotkeyBinding[] | undefined =\n    typeof hotkeyConfig === 'object' && hotkeyConfig !== null\n      ? (hotkeyConfig as { bindings?: HotkeyBinding[] }).bindings\n      : undefined;\n  const configBindings = useMemo(() => (\n    filterHotkeyBindingsByRuntimeAvailability(rawConfigBindings, runtimeAvailabilityContext)\n  ), [rawConfigBindings, runtimeAvailabilityContext]);\n\n  const configEmitShortcuts: HotkeyEmitShortcut[] | undefined =\n    typeof hotkeyConfig === 'object' && hotkeyConfig !== null\n      ? (hotkeyConfig as { emitShortcuts?: HotkeyEmitShortcut[] }).emitShortcuts\n      : undefined;\n\n  const emitShortcuts = useMemo(\n    // The baseline was `[]` until #441 — which is why an application declaring no `emitShortcuts`\n    // got no working shortcuts at all, help dialog included.\n    () => mergeHotkeyEmitShortcuts(ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS, configEmitShortcuts),\n    [configEmitShortcuts],\n  );\n\n  const resolvedBindings = useMemo((): ResolvedHotkeyBinding[] => {\n    if (!configBindings || !resolutionCtx) return [];\n    return resolveHotkeyBindings(configBindings, resolutionCtx);\n  }, [configBindings, resolutionCtx]);\n\n  useEffect(() => {\n    const unregisterFns: Array<() => void> = [];\n\n    const describeEmitRow = (row: HotkeyEmitShortcut): string => {\n      const key = row.descriptionLabellingRef ?? DEFAULT_EMIT_DESCRIPTION_KEYS[row.event];\n      return resolutionCtx ? resolutionCtx.t(key) : key;\n    };\n\n    for (const row of emitShortcuts) {\n      if (row.enabled === false) continue;\n      unregisterFns.push(\n        register({\n          id: `app-emit-${row.event}`,\n          shortcut: row.shortcut,\n          description: describeEmitRow(row),\n          scope: row.scope ?? HotkeyScope.GLOBAL,\n          group: row.group,\n          handler: () => {\n            switch (row.event) {\n              case HotkeyDispatchableEvent.HOTKEY_SIDEBAR_TOGGLE:\n                emit(FrontendEvents.HOTKEY_SIDEBAR_TOGGLE, {} as FrontendEvent_HotkeySidebarToggle);\n                break;\n              case HotkeyDispatchableEvent.HOTKEY_NOTIFICATIONS_OPEN:\n                emit(FrontendEvents.HOTKEY_NOTIFICATIONS_OPEN, {} as FrontendEvent_HotkeyNotificationsOpen);\n                break;\n              case HotkeyDispatchableEvent.HOTKEY_QUICK_SWITCHER_OPEN:\n                emit(FrontendEvents.HOTKEY_QUICK_SWITCHER_OPEN, {} as FrontendEvent_HotkeyQuickSwitcherOpen);\n                break;\n              case HotkeyDispatchableEvent.HOTKEY_SHORTCUTS_HELP:\n                emit(FrontendEvents.HOTKEY_SHORTCUTS_HELP, {} as FrontendEvent_HotkeyShortcutsHelp);\n                break;\n              default:\n                break;\n            }\n          },\n          launcher: launcherForEmitEvent(row.event),\n          preventDefault: row.preventDefault !== false,\n          /*\n           * A row the FRAMEWORK supplied registers below an application's own (#441). The merge\n           * already replaces a default per event, so this only matters for the other collision: an\n           * application binding a DIFFERENT event to a chord a framework default also claims. The\n           * application meant its binding; the default is what was offered when nothing was said.\n           */\n          priority: isFrameworkDefaultRow(row) ? HOTKEY_FRAMEWORK_DEFAULT_PRIORITY : undefined,\n        }),\n      );\n    }\n\n    for (const binding of resolvedBindings) {\n      unregisterFns.push(\n        register({\n          id: `app-hotkey-${binding.id}`,\n          shortcut: binding.shortcut,\n          description: binding.description ?? binding.label,\n          scope: binding.scope ?? HotkeyScope.GLOBAL,\n          group: HotkeyGroup.ACTIONS,\n          handler: () => {\n            NavigationUtils.dispatchNavigationForResolvedTarget(\n              navigate,\n              binding,\n              ApplicationLevelComponentType.HOTKEY,\n            );\n          },\n          launcher: ApplicationLevelComponentType.HOTKEY,\n          preventDefault: true,\n        }),\n      );\n    }\n\n    return () => {\n      for (const unregister of unregisterFns) {\n        unregister();\n      }\n    };\n  }, [register, emit, resolvedBindings, navigate, emitShortcuts, resolutionCtx]);\n\n  return null;\n}\n"]}

package/dist/esm/core/hotkey/HotkeyRegistryContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HotkeyRegistryContext.d.ts","sourceRoot":"","sources":["../../../../src/core/hotkey/HotkeyRegistryContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA2E,MAAM,OAAO,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,uEAAuE,CAAC;AACpG,OAAO,EAEL,yBAAyB,EAO1B,MAAM,oCAAoC,CAAC;AAE5C,QAAA,MAAM,qBAAqB,0CAAwD,CAAC;AAMpF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAuPxE,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"HotkeyRegistryContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/hotkey/HotkeyRegistryContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA2E,MAAM,OAAO,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,uEAAuE,CAAC;AACpG,OAAO,EAEL,yBAAyB,EAO1B,MAAM,oCAAoC,CAAC;AAE5C,QAAA,MAAM,qBAAqB,0CAAwD,CAAC;AAMpF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAwPxE,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/esm/core/hotkey/HotkeyRegistryContext.js

@@ -27,7 +27,7 @@ export const HotkeyRegistryProvider = ({ children, initialScope = HotkeyScope.GL
     const register = useCallback((definition) => {
         const parsed = parseShortcut(definition.shortcut);
         const conflictingHotkeys = Array.from(hotkeysRef.current.values()).filter((hotkey) => hotkey.id !== definition.id &&
-            hotkey.shortcut.toLowerCase() === definition.shortcut.toLowerCase() &&
+            hotkey.parsed.chord === parsed.chord &&
             scopesOverlap(hotkey.scope, definition.scope));
         if (conflictingHotkeys.length > 0) {
             /*
@@ -91,7 +91,8 @@ export const HotkeyRegistryProvider = ({ children, initialScope = HotkeyScope.GL
     const getConflicts = useCallback(() => {
         const byShortcut = new Map();
         for (const hotkey of hotkeysRef.current.values()) {
-            const key = hotkey.shortcut.toLowerCase();
+            // Keyed by chord IDENTITY, not by the authored string: `?` and `Shift+?` are one chord.
+            const key = hotkey.parsed.chord;
             const existing = byShortcut.get(key) ?? [];
             existing.push(hotkey);
             byShortcut.set(key, existing);

package/dist/esm/core/hotkey/HotkeyRegistryContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"HotkeyRegistryContext.js","sourceRoot":"","sources":["../../../../src/core/hotkey/HotkeyRegistryContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hotkey Registry Context\n * \n * Provides centralized keyboard shortcut management.\n * Based on Specs §7 - HOTKEY Specification (Infrastructure)\n */\n\nimport React, { createContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { HotkeyScope } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport {\n  HotkeyDefinition,\n  HotkeyRegistryContextType,\n  RegisteredHotkey,\n  HotkeyConflict,\n  parseShortcut,\n  matchesShortcut,\n  HOTKEY_DEFAULT_PRIORITY,\n  HOTKEY_SCOPE_SPECIFICITY,\n} from './hotkey-registry.frontend.schemas';\n\nconst HotkeyRegistryContext = createContext<HotkeyRegistryContextType | null>(null);\n\nfunction scopesOverlap(a: HotkeyScope, b: HotkeyScope): boolean {\n  return a === b || a === HotkeyScope.GLOBAL || b === HotkeyScope.GLOBAL;\n}\n\nexport interface HotkeyRegistryProviderProps {\n  children: React.ReactNode;\n  /** Initial active scope */\n  initialScope?: HotkeyScope;\n}\n\nexport const HotkeyRegistryProvider: React.FC<HotkeyRegistryProviderProps> = ({\n  children,\n  initialScope = HotkeyScope.GLOBAL,\n}) => {\n  // ===================================================================\n  // State\n  // ===================================================================\n  \n  const [activeScope, setActiveScope] = useState<HotkeyScope>(initialScope);\n  const [isPaused, setIsPaused] = useState(false);\n  \n  // Use ref for hotkeys to avoid re-renders on registration\n  const hotkeysRef = useRef<Map<string, RegisteredHotkey>>(new Map());\n  const [hotkeyVersion, setHotkeyVersion] = useState(0);\n  \n  // ===================================================================\n  // Registration Functions\n  // ===================================================================\n  \n  const register = useCallback((definition: HotkeyDefinition): (() => void) => {\n    const parsed = parseShortcut(definition.shortcut);\n    const conflictingHotkeys = Array.from(hotkeysRef.current.values()).filter(\n      (hotkey: RegisteredHotkey) =>\n        hotkey.id !== definition.id &&\n        hotkey.shortcut.toLowerCase() === definition.shortcut.toLowerCase() &&\n        scopesOverlap(hotkey.scope, definition.scope),\n    );\n\n    if (conflictingHotkeys.length > 0) {\n      /*\n       * KEPT after precedence became declarative (#441), deliberately. A resolved collision is\n       * still usually a mistake — two shortcuts quietly becoming one — and arbitrating silently is\n       * how that goes unnoticed. What changed is the remedy the message can offer: the outcome is\n       * now something the author can DECLARE rather than something mount order decides.\n       */\n      console.warn(\n        `[HotkeyRegistry] Duplicate shortcut \"${definition.shortcut}\" detected. ` +\n        `Precedence: priority, then scope specificity (component > page > global), then registration order. ` +\n        `Declare \\`priority\\` on the one that should win, or give one of them a different chord.`,\n        {\n          incomingId: definition.id,\n          incomingPriority: definition.priority ?? HOTKEY_DEFAULT_PRIORITY,\n          existing: conflictingHotkeys.map((hotkey: RegisteredHotkey) => ({\n            id: hotkey.id,\n            priority: hotkey.priority ?? HOTKEY_DEFAULT_PRIORITY,\n          })),\n        },\n      );\n    }\n\n    const registered: RegisteredHotkey = {\n      ...definition,\n      enabled: definition.enabled !== false,\n      /** Defaults to true — application hotkeys should prevent browser defaults (e.g. Cmd+K). */\n      preventDefault: definition.preventDefault ?? true,\n      stopPropagation: definition.stopPropagation ?? false,\n      parsed,\n    };\n    \n    hotkeysRef.current.set(definition.id, registered);\n    setHotkeyVersion(v => v + 1);\n    \n    // Return unregister function\n    return () => {\n      hotkeysRef.current.delete(definition.id);\n      setHotkeyVersion(v => v + 1);\n    };\n  }, []);\n  \n  const unregister = useCallback((id: string) => {\n    hotkeysRef.current.delete(id);\n    setHotkeyVersion(v => v + 1);\n  }, []);\n  \n  const setEnabled = useCallback((id: string, enabled: boolean) => {\n    const hotkey = hotkeysRef.current.get(id);\n    if (hotkey) {\n      hotkey.enabled = enabled;\n      setHotkeyVersion(v => v + 1);\n    }\n  }, []);\n  \n  // ===================================================================\n  // Scope and Pause Functions\n  // ===================================================================\n  \n  const pause = useCallback(() => setIsPaused(true), []);\n  const resume = useCallback(() => setIsPaused(false), []);\n  \n  // ===================================================================\n  // Query Functions\n  // ===================================================================\n  \n  const getHotkeys = useCallback((): RegisteredHotkey[] => {\n    return Array.from(hotkeysRef.current.values());\n  }, []);\n  \n  const getHotkeysByGroup = useCallback((group: string): RegisteredHotkey[] => {\n    return Array.from(hotkeysRef.current.values()).filter((h: RegisteredHotkey) => h.group === group);\n  }, []);\n  \n  const getConflicts = useCallback((): HotkeyConflict[] => {\n    const byShortcut = new Map<string, RegisteredHotkey[]>();\n\n    for (const hotkey of hotkeysRef.current.values()) {\n      const key = hotkey.shortcut.toLowerCase();\n      const existing = byShortcut.get(key) ?? [];\n      existing.push(hotkey);\n      byShortcut.set(key, existing);\n    }\n\n    const conflicts: HotkeyConflict[] = [];\n    for (const [shortcut, hotkeys] of byShortcut.entries()) {\n      const conflictingIds = hotkeys.filter((candidate: RegisteredHotkey) =>\n        hotkeys.some((other: RegisteredHotkey) =>\n          other.id !== candidate.id && scopesOverlap(other.scope, candidate.scope),\n        ),\n      ).map((hotkey: RegisteredHotkey) => hotkey.id);\n\n      if (conflictingIds.length > 1) {\n        conflicts.push({ shortcut, hotkeyIds: conflictingIds });\n      }\n    }\n\n    return conflicts;\n  }, []);\n  \n  // ===================================================================\n  // Keyboard Event Handler\n  // ===================================================================\n  \n  useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      // Skip if paused\n      if (isPaused) return;\n      \n      // Skip if target is an input element (unless it's a global shortcut)\n      const target = event.target as HTMLElement;\n      let isInputElement = target.tagName === 'INPUT' || \n                           target.tagName === 'TEXTAREA' || \n                           target.isContentEditable;\n      if (isInputElement && target.closest('[data-hotkey-passthrough]')) {\n        isInputElement = false;\n      }\n      \n      /*\n       * Pick the BEST match, not the first one this iteration happens to reach (#441).\n       *\n       * `hotkeysRef` is a Map, so iterating it is REGISTRATION ORDER — which means, before this,\n       * which of two conflicting shortcuts fired depended on mount order rather than on anything\n       * anyone declared. Two components mounting in a different order swapped the behaviour, and\n       * nothing about the shortcuts said which was supposed to win.\n       *\n       * The order is declarative and total: PRIORITY (explicit, highest wins), then SCOPE\n       * SPECIFICITY (a COMPONENT claim on a chord is narrower than a GLOBAL one), then registration\n       * order as the last resort — which is where two genuinely indistinguishable registrations\n       * land, and is exactly the case the collision warning at registration is for.\n       */\n      let best: RegisteredHotkey | undefined;\n      let bestRank: readonly [number, number] | undefined;\n\n      for (const hotkey of hotkeysRef.current.values()) {\n        // Skip disabled hotkeys\n        if (!hotkey.enabled) continue;\n        \n        // Check scope\n        if (hotkey.scope === HotkeyScope.PAGE && activeScope !== HotkeyScope.PAGE) continue;\n        if (hotkey.scope === HotkeyScope.COMPONENT && activeScope !== HotkeyScope.COMPONENT) continue;\n        \n        // Skip non-global hotkeys when in input\n        if (isInputElement && hotkey.scope !== HotkeyScope.GLOBAL) continue;\n        \n        if (!matchesShortcut(event, hotkey.parsed)) continue;\n\n        const rank = [\n          hotkey.priority ?? HOTKEY_DEFAULT_PRIORITY,\n          HOTKEY_SCOPE_SPECIFICITY[hotkey.scope],\n        ] as const;\n        // STRICTLY greater, so an equal rank keeps the earlier registration — the last-resort rule.\n        if (bestRank === undefined || rank[0] > bestRank[0] || (rank[0] === bestRank[0] && rank[1] > bestRank[1])) {\n          best = hotkey;\n          bestRank = rank;\n        }\n      }\n\n      {\n        const hotkey = best;\n        if (hotkey) {\n          // Execute handler\n          try {\n            hotkey.handler();\n          } catch (error) {\n            console.error(`Hotkey handler error for ${hotkey.id}:`, error);\n          }\n          \n          // Prevent default if configured\n          if (hotkey.preventDefault) {\n            event.preventDefault();\n          }\n          \n          // Stop propagation if configured\n          if (hotkey.stopPropagation) {\n            event.stopPropagation();\n          }\n          \n        }\n      }\n    };\n    \n    document.addEventListener('keydown', handleKeyDown);\n    return () => document.removeEventListener('keydown', handleKeyDown);\n  }, [activeScope, isPaused]);\n  \n  // ===================================================================\n  // Context Value\n  // ===================================================================\n  \n  const contextValue = useMemo((): HotkeyRegistryContextType => ({\n    register,\n    unregister,\n    setEnabled,\n    setActiveScope,\n    pause,\n    resume,\n    getHotkeys,\n    getHotkeysByGroup,\n    getConflicts,\n    activeScope,\n    isPaused,\n  }), [\n    register,\n    unregister,\n    setEnabled,\n    pause,\n    resume,\n    getHotkeys,\n    getHotkeysByGroup,\n    getConflicts,\n    activeScope,\n    isPaused,\n  ]);\n  \n  return (\n    <HotkeyRegistryContext.Provider value={contextValue}>\n      {children}\n    </HotkeyRegistryContext.Provider>\n  );\n};\n\nexport { HotkeyRegistryContext };\n"]}
+{"version":3,"file":"HotkeyRegistryContext.js","sourceRoot":"","sources":["../../../../../src/core/hotkey/HotkeyRegistryContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hotkey Registry Context\n * \n * Provides centralized keyboard shortcut management.\n * Based on Specs §7 - HOTKEY Specification (Infrastructure)\n */\n\nimport React, { createContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { HotkeyScope } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport {\n  HotkeyDefinition,\n  HotkeyRegistryContextType,\n  RegisteredHotkey,\n  HotkeyConflict,\n  parseShortcut,\n  matchesShortcut,\n  HOTKEY_DEFAULT_PRIORITY,\n  HOTKEY_SCOPE_SPECIFICITY,\n} from './hotkey-registry.frontend.schemas';\n\nconst HotkeyRegistryContext = createContext<HotkeyRegistryContextType | null>(null);\n\nfunction scopesOverlap(a: HotkeyScope, b: HotkeyScope): boolean {\n  return a === b || a === HotkeyScope.GLOBAL || b === HotkeyScope.GLOBAL;\n}\n\nexport interface HotkeyRegistryProviderProps {\n  children: React.ReactNode;\n  /** Initial active scope */\n  initialScope?: HotkeyScope;\n}\n\nexport const HotkeyRegistryProvider: React.FC<HotkeyRegistryProviderProps> = ({\n  children,\n  initialScope = HotkeyScope.GLOBAL,\n}) => {\n  // ===================================================================\n  // State\n  // ===================================================================\n  \n  const [activeScope, setActiveScope] = useState<HotkeyScope>(initialScope);\n  const [isPaused, setIsPaused] = useState(false);\n  \n  // Use ref for hotkeys to avoid re-renders on registration\n  const hotkeysRef = useRef<Map<string, RegisteredHotkey>>(new Map());\n  const [hotkeyVersion, setHotkeyVersion] = useState(0);\n  \n  // ===================================================================\n  // Registration Functions\n  // ===================================================================\n  \n  const register = useCallback((definition: HotkeyDefinition): (() => void) => {\n    const parsed = parseShortcut(definition.shortcut);\n    const conflictingHotkeys = Array.from(hotkeysRef.current.values()).filter(\n      (hotkey: RegisteredHotkey) =>\n        hotkey.id !== definition.id &&\n        hotkey.parsed.chord === parsed.chord &&\n        scopesOverlap(hotkey.scope, definition.scope),\n    );\n\n    if (conflictingHotkeys.length > 0) {\n      /*\n       * KEPT after precedence became declarative (#441), deliberately. A resolved collision is\n       * still usually a mistake — two shortcuts quietly becoming one — and arbitrating silently is\n       * how that goes unnoticed. What changed is the remedy the message can offer: the outcome is\n       * now something the author can DECLARE rather than something mount order decides.\n       */\n      console.warn(\n        `[HotkeyRegistry] Duplicate shortcut \"${definition.shortcut}\" detected. ` +\n        `Precedence: priority, then scope specificity (component > page > global), then registration order. ` +\n        `Declare \\`priority\\` on the one that should win, or give one of them a different chord.`,\n        {\n          incomingId: definition.id,\n          incomingPriority: definition.priority ?? HOTKEY_DEFAULT_PRIORITY,\n          existing: conflictingHotkeys.map((hotkey: RegisteredHotkey) => ({\n            id: hotkey.id,\n            priority: hotkey.priority ?? HOTKEY_DEFAULT_PRIORITY,\n          })),\n        },\n      );\n    }\n\n    const registered: RegisteredHotkey = {\n      ...definition,\n      enabled: definition.enabled !== false,\n      /** Defaults to true — application hotkeys should prevent browser defaults (e.g. Cmd+K). */\n      preventDefault: definition.preventDefault ?? true,\n      stopPropagation: definition.stopPropagation ?? false,\n      parsed,\n    };\n    \n    hotkeysRef.current.set(definition.id, registered);\n    setHotkeyVersion(v => v + 1);\n    \n    // Return unregister function\n    return () => {\n      hotkeysRef.current.delete(definition.id);\n      setHotkeyVersion(v => v + 1);\n    };\n  }, []);\n  \n  const unregister = useCallback((id: string) => {\n    hotkeysRef.current.delete(id);\n    setHotkeyVersion(v => v + 1);\n  }, []);\n  \n  const setEnabled = useCallback((id: string, enabled: boolean) => {\n    const hotkey = hotkeysRef.current.get(id);\n    if (hotkey) {\n      hotkey.enabled = enabled;\n      setHotkeyVersion(v => v + 1);\n    }\n  }, []);\n  \n  // ===================================================================\n  // Scope and Pause Functions\n  // ===================================================================\n  \n  const pause = useCallback(() => setIsPaused(true), []);\n  const resume = useCallback(() => setIsPaused(false), []);\n  \n  // ===================================================================\n  // Query Functions\n  // ===================================================================\n  \n  const getHotkeys = useCallback((): RegisteredHotkey[] => {\n    return Array.from(hotkeysRef.current.values());\n  }, []);\n  \n  const getHotkeysByGroup = useCallback((group: string): RegisteredHotkey[] => {\n    return Array.from(hotkeysRef.current.values()).filter((h: RegisteredHotkey) => h.group === group);\n  }, []);\n  \n  const getConflicts = useCallback((): HotkeyConflict[] => {\n    const byShortcut = new Map<string, RegisteredHotkey[]>();\n\n    for (const hotkey of hotkeysRef.current.values()) {\n      // Keyed by chord IDENTITY, not by the authored string: `?` and `Shift+?` are one chord.\n      const key = hotkey.parsed.chord;\n      const existing = byShortcut.get(key) ?? [];\n      existing.push(hotkey);\n      byShortcut.set(key, existing);\n    }\n\n    const conflicts: HotkeyConflict[] = [];\n    for (const [shortcut, hotkeys] of byShortcut.entries()) {\n      const conflictingIds = hotkeys.filter((candidate: RegisteredHotkey) =>\n        hotkeys.some((other: RegisteredHotkey) =>\n          other.id !== candidate.id && scopesOverlap(other.scope, candidate.scope),\n        ),\n      ).map((hotkey: RegisteredHotkey) => hotkey.id);\n\n      if (conflictingIds.length > 1) {\n        conflicts.push({ shortcut, hotkeyIds: conflictingIds });\n      }\n    }\n\n    return conflicts;\n  }, []);\n  \n  // ===================================================================\n  // Keyboard Event Handler\n  // ===================================================================\n  \n  useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      // Skip if paused\n      if (isPaused) return;\n      \n      // Skip if target is an input element (unless it's a global shortcut)\n      const target = event.target as HTMLElement;\n      let isInputElement = target.tagName === 'INPUT' || \n                           target.tagName === 'TEXTAREA' || \n                           target.isContentEditable;\n      if (isInputElement && target.closest('[data-hotkey-passthrough]')) {\n        isInputElement = false;\n      }\n      \n      /*\n       * Pick the BEST match, not the first one this iteration happens to reach (#441).\n       *\n       * `hotkeysRef` is a Map, so iterating it is REGISTRATION ORDER — which means, before this,\n       * which of two conflicting shortcuts fired depended on mount order rather than on anything\n       * anyone declared. Two components mounting in a different order swapped the behaviour, and\n       * nothing about the shortcuts said which was supposed to win.\n       *\n       * The order is declarative and total: PRIORITY (explicit, highest wins), then SCOPE\n       * SPECIFICITY (a COMPONENT claim on a chord is narrower than a GLOBAL one), then registration\n       * order as the last resort — which is where two genuinely indistinguishable registrations\n       * land, and is exactly the case the collision warning at registration is for.\n       */\n      let best: RegisteredHotkey | undefined;\n      let bestRank: readonly [number, number] | undefined;\n\n      for (const hotkey of hotkeysRef.current.values()) {\n        // Skip disabled hotkeys\n        if (!hotkey.enabled) continue;\n        \n        // Check scope\n        if (hotkey.scope === HotkeyScope.PAGE && activeScope !== HotkeyScope.PAGE) continue;\n        if (hotkey.scope === HotkeyScope.COMPONENT && activeScope !== HotkeyScope.COMPONENT) continue;\n        \n        // Skip non-global hotkeys when in input\n        if (isInputElement && hotkey.scope !== HotkeyScope.GLOBAL) continue;\n        \n        if (!matchesShortcut(event, hotkey.parsed)) continue;\n\n        const rank = [\n          hotkey.priority ?? HOTKEY_DEFAULT_PRIORITY,\n          HOTKEY_SCOPE_SPECIFICITY[hotkey.scope],\n        ] as const;\n        // STRICTLY greater, so an equal rank keeps the earlier registration — the last-resort rule.\n        if (bestRank === undefined || rank[0] > bestRank[0] || (rank[0] === bestRank[0] && rank[1] > bestRank[1])) {\n          best = hotkey;\n          bestRank = rank;\n        }\n      }\n\n      {\n        const hotkey = best;\n        if (hotkey) {\n          // Execute handler\n          try {\n            hotkey.handler();\n          } catch (error) {\n            console.error(`Hotkey handler error for ${hotkey.id}:`, error);\n          }\n          \n          // Prevent default if configured\n          if (hotkey.preventDefault) {\n            event.preventDefault();\n          }\n          \n          // Stop propagation if configured\n          if (hotkey.stopPropagation) {\n            event.stopPropagation();\n          }\n          \n        }\n      }\n    };\n    \n    document.addEventListener('keydown', handleKeyDown);\n    return () => document.removeEventListener('keydown', handleKeyDown);\n  }, [activeScope, isPaused]);\n  \n  // ===================================================================\n  // Context Value\n  // ===================================================================\n  \n  const contextValue = useMemo((): HotkeyRegistryContextType => ({\n    register,\n    unregister,\n    setEnabled,\n    setActiveScope,\n    pause,\n    resume,\n    getHotkeys,\n    getHotkeysByGroup,\n    getConflicts,\n    activeScope,\n    isPaused,\n  }), [\n    register,\n    unregister,\n    setEnabled,\n    pause,\n    resume,\n    getHotkeys,\n    getHotkeysByGroup,\n    getConflicts,\n    activeScope,\n    isPaused,\n  ]);\n  \n  return (\n    <HotkeyRegistryContext.Provider value={contextValue}>\n      {children}\n    </HotkeyRegistryContext.Provider>\n  );\n};\n\nexport { HotkeyRegistryContext };\n"]}

package/dist/esm/core/hotkey/HotkeyShortcutsHelpDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HotkeyShortcutsHelpDialog.d.ts","sourceRoot":"","sources":["../../../../src/core/hotkey/HotkeyShortcutsHelpDialog.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AA8DjC,wBAAgB,yBAAyB,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CA8H9D"}
+{"version":3,"file":"HotkeyShortcutsHelpDialog.d.ts","sourceRoot":"","sources":["../../../../../src/core/hotkey/HotkeyShortcutsHelpDialog.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AA+DjC,wBAAgB,yBAAyB,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CA4H9D"}

package/dist/esm/core/hotkey/HotkeyShortcutsHelpDialog.js

@@ -9,6 +9,7 @@ import { useI18n } from '../../core/i18n/useI18n.js';
 import { resolveComponentLabel, resolveTranslationKey, } from '../../core/i18n/component-label-resolution.utils.js';
 import { Dialog, DialogContent, DialogHeader, DialogTitle } from '../../components/overlays/containers/dialog.js';
 import { ScrollArea } from '../../components/layout/scroll-area.js';
+import { Kbd } from '../../components/data-display/kbd.js';
 const HOTKEY_GROUP_ORDER = [
     HotkeyGroup.NAVIGATION,
     HotkeyGroup.ACTIONS,
@@ -97,6 +98,6 @@ export function HotkeyShortcutsHelpDialog() {
         t,
         key: 'engine.hotkeys.shortcutsHelp',
     });
-    return (_jsx(Dialog, { open: isOpen, onOpenChange: setIsOpen, children: _jsxs(DialogContent, { className: "max-w-3xl pt-10", children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: title }) }), _jsxs("div", { className: "space-y-card-sm", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground", children: [_jsxs("span", { children: [tc('shortcutsHelpActiveScope'), ": ", scopeLabel(activeScope, tc)] }), _jsxs("span", { children: [tc('shortcutsHelpRegistry'), ": ", isPaused ? tc('shortcutsHelpRegistryPaused') : tc('shortcutsHelpRegistryListening')] }), _jsx("span", { children: tc('shortcutsHelpCount', { count: hotkeys.length }) })] }), conflicts.length > 0 && (_jsxs("div", { className: "rounded-md border border-warning/40 bg-warning/10 p-card-sm text-sm text-warning-foreground", children: [_jsx("div", { className: "font-medium", children: tc('shortcutsHelpConflictsDetected') }), _jsx("ul", { className: "mt-item-xs space-y-item-xs", children: conflicts.map(conflict => (_jsxs("li", { children: [_jsx("code", { children: conflict.shortcut }), " ", tc('shortcutsHelpConflictUsedBy'), " ", conflict.hotkeyIds.join(', ')] }, conflict.shortcut))) })] })), _jsx(ScrollArea, { className: "max-h-[60vh] pe-item-sm", children: _jsx("div", { className: "space-y-card", children: groupedHotkeys.map(({ group, label, hotkeys: groupHotkeys }) => (_jsxs("section", { className: "space-y-item-sm", children: [_jsx("h3", { className: "text-sm font-semibold text-foreground", children: label }), _jsx("div", { className: "space-y-item-xs", children: groupHotkeys.map(hotkey => (_jsxs("div", { className: "flex items-start justify-between gap-field rounded-md border border-border/70 px-card-sm py-item-sm", children: [_jsxs("div", { className: "min-w-0 space-y-[2px]", children: [_jsx("div", { className: "text-sm font-medium text-foreground", children: hotkey.description }), _jsxs("div", { className: "flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground", children: [_jsx("span", { children: scopeLabel(hotkey.scope, tc) }), hotkey.launcher && _jsx("span", { children: hotkey.launcher }), _jsx("span", { children: hotkey.id })] })] }), _jsx("kbd", { className: "shrink-0 rounded border border-border bg-muted px-item-sm py-[2px] text-xs font-medium text-foreground", children: hotkey.parsed.display })] }, hotkey.id))) })] }, group))) }) })] })] }) }));
+    return (_jsx(Dialog, { open: isOpen, onOpenChange: setIsOpen, children: _jsxs(DialogContent, { className: "max-w-3xl pt-10", children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: title }) }), _jsxs("div", { className: "space-y-card-sm", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground", children: [_jsxs("span", { children: [tc('shortcutsHelpActiveScope'), ": ", scopeLabel(activeScope, tc)] }), _jsxs("span", { children: [tc('shortcutsHelpRegistry'), ": ", isPaused ? tc('shortcutsHelpRegistryPaused') : tc('shortcutsHelpRegistryListening')] }), _jsx("span", { children: tc('shortcutsHelpCount', { count: hotkeys.length }) })] }), conflicts.length > 0 && (_jsxs("div", { className: "rounded-md border border-warning/40 bg-warning/10 p-card-sm text-sm text-warning-foreground", children: [_jsx("div", { className: "font-medium", children: tc('shortcutsHelpConflictsDetected') }), _jsx("ul", { className: "mt-item-xs space-y-item-xs", children: conflicts.map(conflict => (_jsxs("li", { children: [_jsx("code", { children: conflict.shortcut }), " ", tc('shortcutsHelpConflictUsedBy'), " ", conflict.hotkeyIds.join(', ')] }, conflict.shortcut))) })] })), _jsx(ScrollArea, { className: "max-h-[60vh] pe-item-sm", children: _jsx("div", { className: "space-y-card", children: groupedHotkeys.map(({ group, label, hotkeys: groupHotkeys }) => (_jsxs("section", { className: "space-y-item-sm", children: [_jsx("h3", { className: "text-sm font-semibold text-foreground", children: label }), _jsx("div", { className: "space-y-item-xs", children: groupHotkeys.map(hotkey => (_jsxs("div", { className: "flex items-start justify-between gap-field rounded-md border border-border/70 px-card-sm py-item-sm", children: [_jsxs("div", { className: "min-w-0 space-y-[2px]", children: [_jsx("div", { className: "text-sm font-medium text-foreground", children: hotkey.description }), _jsxs("div", { className: "flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground", children: [_jsx("span", { children: scopeLabel(hotkey.scope, tc) }), hotkey.launcher && _jsx("span", { children: hotkey.launcher }), _jsx("span", { children: hotkey.id })] })] }), _jsx(Kbd, { children: hotkey.parsed.display })] }, hotkey.id))) })] }, group))) }) })] })] }) }));
 }
 //# sourceMappingURL=HotkeyShortcutsHelpDialog.js.map

package/dist/esm/core/hotkey/HotkeyShortcutsHelpDialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"HotkeyShortcutsHelpDialog.js","sourceRoot":"","sources":["../../../../src/core/hotkey/HotkeyShortcutsHelpDialog.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo, useState } from 'react';\nimport type { JSX } from 'react';\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport {\n  HotkeyGroup,\n  HotkeyScope,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { useHotkeyRegistry } from '~wildo-frontend-lib/core/hotkey/useHotkey';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport {\n  resolveComponentLabel,\n  resolveTranslationKey,\n} from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { Dialog, DialogContent, DialogHeader, DialogTitle } from '~wildo-frontend-lib/components/overlays/containers/dialog';\nimport { ScrollArea } from '~wildo-frontend-lib/components/layout/scroll-area';\n\nimport type {\n  HotkeyConflict,\n  RegisteredHotkey,\n} from '~wildo-frontend-lib/core/hotkey/hotkey-registry.frontend.schemas';\n\nconst HOTKEY_GROUP_ORDER: readonly string[] = [\n  HotkeyGroup.NAVIGATION,\n  HotkeyGroup.ACTIONS,\n  HotkeyGroup.HELP,\n  'other',\n];\n\nfunction groupLabel(\n  group: string,\n  tc: (key: string, params?: Record<string, string | number>) => string,\n): string {\n  switch (group) {\n    case HotkeyGroup.NAVIGATION:\n      return tc('navigation');\n    case HotkeyGroup.ACTIONS:\n      return tc('actions');\n    case HotkeyGroup.HELP:\n      return tc('help');\n    default:\n      return tc('other');\n  }\n}\n\nfunction scopeLabel(\n  scope: HotkeyScope,\n  tc: (key: string, params?: Record<string, string | number>) => string,\n): string {\n  switch (scope) {\n    case HotkeyScope.GLOBAL:\n      return tc('shortcutsHelpScopeGlobal');\n    case HotkeyScope.PAGE:\n      return tc('shortcutsHelpScopePage');\n    case HotkeyScope.COMPONENT:\n      return tc('shortcutsHelpScopeComponent');\n    default:\n      return tc('shortcutsHelpScopeUnknown');\n  }\n}\n\nexport function HotkeyShortcutsHelpDialog(): JSX.Element | null {\n  const [isOpen, setIsOpen] = useState(false);\n  const { on } = useEventBus();\n  const { getHotkeys, getConflicts, activeScope, isPaused } = useHotkeyRegistry();\n  const { t, tComponent, isReady } = useI18n({\n    component: FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU,\n  });\n\n  useEffect(() => {\n    return on(FrontendEvents.HOTKEY_SHORTCUTS_HELP, () => {\n      setIsOpen(prev => !prev);\n    });\n  }, [on]);\n\n  const tc = (key: string, params?: Record<string, string | number>) =>\n    resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU,\n      key,\n      params,\n    });\n\n  const hotkeys = useMemo((): RegisteredHotkey[] => {\n    if (!isOpen) return [];\n\n    return getHotkeys()\n      .slice()\n      .sort((a, b) => {\n        const groupA = HOTKEY_GROUP_ORDER.indexOf(a.group ?? 'other');\n        const groupB = HOTKEY_GROUP_ORDER.indexOf(b.group ?? 'other');\n        if (groupA !== groupB) return groupA - groupB;\n        return a.description.localeCompare(b.description);\n      });\n  }, [getHotkeys, isOpen]);\n\n  const groupedHotkeys = useMemo(() => {\n    const groups = new Map<string, RegisteredHotkey[]>();\n\n    for (const hotkey of hotkeys) {\n      const group = hotkey.group ?? 'other';\n      const existing = groups.get(group) ?? [];\n      existing.push(hotkey);\n      groups.set(group, existing);\n    }\n\n    return HOTKEY_GROUP_ORDER\n      .map(group => ({\n        group,\n        label: groupLabel(group, tc),\n        hotkeys: groups.get(group) ?? [],\n      }))\n      .filter(entry => entry.hotkeys.length > 0);\n  }, [hotkeys, tc]);\n\n  const conflicts = useMemo((): HotkeyConflict[] => {\n    if (!isOpen) return [];\n    return getConflicts();\n  }, [getConflicts, isOpen]);\n\n  if (!isReady) return null;\n\n  const title = resolveTranslationKey({\n    t,\n    key: 'engine.hotkeys.shortcutsHelp',\n  });\n\n  return (\n    <Dialog open={isOpen} onOpenChange={setIsOpen}>\n      <DialogContent className=\"max-w-3xl pt-10\">\n        <DialogHeader>\n          <DialogTitle>{title}</DialogTitle>\n        </DialogHeader>\n\n        <div className=\"space-y-card-sm\">\n          <div className=\"flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground\">\n            <span>{tc('shortcutsHelpActiveScope')}: {scopeLabel(activeScope, tc)}</span>\n            <span>{tc('shortcutsHelpRegistry')}: {isPaused ? tc('shortcutsHelpRegistryPaused') : tc('shortcutsHelpRegistryListening')}</span>\n            <span>{tc('shortcutsHelpCount', { count: hotkeys.length })}</span>\n          </div>\n\n          {conflicts.length > 0 && (\n            <div className=\"rounded-md border border-warning/40 bg-warning/10 p-card-sm text-sm text-warning-foreground\">\n              <div className=\"font-medium\">{tc('shortcutsHelpConflictsDetected')}</div>\n              <ul className=\"mt-item-xs space-y-item-xs\">\n                {conflicts.map(conflict => (\n                  <li key={conflict.shortcut}>\n                    <code>{conflict.shortcut}</code> {tc('shortcutsHelpConflictUsedBy')} {conflict.hotkeyIds.join(', ')}\n                  </li>\n                ))}\n              </ul>\n            </div>\n          )}\n\n          <ScrollArea className=\"max-h-[60vh] pe-item-sm\">\n            <div className=\"space-y-card\">\n              {groupedHotkeys.map(({ group, label, hotkeys: groupHotkeys }) => (\n                <section key={group} className=\"space-y-item-sm\">\n                  <h3 className=\"text-sm font-semibold text-foreground\">{label}</h3>\n                  <div className=\"space-y-item-xs\">\n                    {groupHotkeys.map(hotkey => (\n                      <div\n                        key={hotkey.id}\n                        className=\"flex items-start justify-between gap-field rounded-md border border-border/70 px-card-sm py-item-sm\"\n                      >\n                        <div className=\"min-w-0 space-y-[2px]\">\n                          <div className=\"text-sm font-medium text-foreground\">{hotkey.description}</div>\n                          <div className=\"flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground\">\n                            <span>{scopeLabel(hotkey.scope, tc)}</span>\n                            {hotkey.launcher && <span>{hotkey.launcher}</span>}\n                            <span>{hotkey.id}</span>\n                          </div>\n                        </div>\n                        <kbd className=\"shrink-0 rounded border border-border bg-muted px-item-sm py-[2px] text-xs font-medium text-foreground\">\n                          {hotkey.parsed.display}\n                        </kbd>\n                      </div>\n                    ))}\n                  </div>\n                </section>\n              ))}\n            </div>\n          </ScrollArea>\n        </div>\n      </DialogContent>\n    </Dialog>\n  );\n}\n"]}
+{"version":3,"file":"HotkeyShortcutsHelpDialog.js","sourceRoot":"","sources":["../../../../../src/core/hotkey/HotkeyShortcutsHelpDialog.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo, useState } from 'react';\nimport type { JSX } from 'react';\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport {\n  HotkeyGroup,\n  HotkeyScope,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { useHotkeyRegistry } from '~wildo-frontend-lib/core/hotkey/useHotkey';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport {\n  resolveComponentLabel,\n  resolveTranslationKey,\n} from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { Dialog, DialogContent, DialogHeader, DialogTitle } from '~wildo-frontend-lib/components/overlays/containers/dialog';\nimport { ScrollArea } from '~wildo-frontend-lib/components/layout/scroll-area';\nimport { Kbd } from '~wildo-frontend-lib/components/data-display/kbd';\n\nimport type {\n  HotkeyConflict,\n  RegisteredHotkey,\n} from '~wildo-frontend-lib/core/hotkey/hotkey-registry.frontend.schemas';\n\nconst HOTKEY_GROUP_ORDER: readonly string[] = [\n  HotkeyGroup.NAVIGATION,\n  HotkeyGroup.ACTIONS,\n  HotkeyGroup.HELP,\n  'other',\n];\n\nfunction groupLabel(\n  group: string,\n  tc: (key: string, params?: Record<string, string | number>) => string,\n): string {\n  switch (group) {\n    case HotkeyGroup.NAVIGATION:\n      return tc('navigation');\n    case HotkeyGroup.ACTIONS:\n      return tc('actions');\n    case HotkeyGroup.HELP:\n      return tc('help');\n    default:\n      return tc('other');\n  }\n}\n\nfunction scopeLabel(\n  scope: HotkeyScope,\n  tc: (key: string, params?: Record<string, string | number>) => string,\n): string {\n  switch (scope) {\n    case HotkeyScope.GLOBAL:\n      return tc('shortcutsHelpScopeGlobal');\n    case HotkeyScope.PAGE:\n      return tc('shortcutsHelpScopePage');\n    case HotkeyScope.COMPONENT:\n      return tc('shortcutsHelpScopeComponent');\n    default:\n      return tc('shortcutsHelpScopeUnknown');\n  }\n}\n\nexport function HotkeyShortcutsHelpDialog(): JSX.Element | null {\n  const [isOpen, setIsOpen] = useState(false);\n  const { on } = useEventBus();\n  const { getHotkeys, getConflicts, activeScope, isPaused } = useHotkeyRegistry();\n  const { t, tComponent, isReady } = useI18n({\n    component: FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU,\n  });\n\n  useEffect(() => {\n    return on(FrontendEvents.HOTKEY_SHORTCUTS_HELP, () => {\n      setIsOpen(prev => !prev);\n    });\n  }, [on]);\n\n  const tc = (key: string, params?: Record<string, string | number>) =>\n    resolveComponentLabel({\n      tComponent,\n      componentType: FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU,\n      key,\n      params,\n    });\n\n  const hotkeys = useMemo((): RegisteredHotkey[] => {\n    if (!isOpen) return [];\n\n    return getHotkeys()\n      .slice()\n      .sort((a, b) => {\n        const groupA = HOTKEY_GROUP_ORDER.indexOf(a.group ?? 'other');\n        const groupB = HOTKEY_GROUP_ORDER.indexOf(b.group ?? 'other');\n        if (groupA !== groupB) return groupA - groupB;\n        return a.description.localeCompare(b.description);\n      });\n  }, [getHotkeys, isOpen]);\n\n  const groupedHotkeys = useMemo(() => {\n    const groups = new Map<string, RegisteredHotkey[]>();\n\n    for (const hotkey of hotkeys) {\n      const group = hotkey.group ?? 'other';\n      const existing = groups.get(group) ?? [];\n      existing.push(hotkey);\n      groups.set(group, existing);\n    }\n\n    return HOTKEY_GROUP_ORDER\n      .map(group => ({\n        group,\n        label: groupLabel(group, tc),\n        hotkeys: groups.get(group) ?? [],\n      }))\n      .filter(entry => entry.hotkeys.length > 0);\n  }, [hotkeys, tc]);\n\n  const conflicts = useMemo((): HotkeyConflict[] => {\n    if (!isOpen) return [];\n    return getConflicts();\n  }, [getConflicts, isOpen]);\n\n  if (!isReady) return null;\n\n  const title = resolveTranslationKey({\n    t,\n    key: 'engine.hotkeys.shortcutsHelp',\n  });\n\n  return (\n    <Dialog open={isOpen} onOpenChange={setIsOpen}>\n      <DialogContent className=\"max-w-3xl pt-10\">\n        <DialogHeader>\n          <DialogTitle>{title}</DialogTitle>\n        </DialogHeader>\n\n        <div className=\"space-y-card-sm\">\n          <div className=\"flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground\">\n            <span>{tc('shortcutsHelpActiveScope')}: {scopeLabel(activeScope, tc)}</span>\n            <span>{tc('shortcutsHelpRegistry')}: {isPaused ? tc('shortcutsHelpRegistryPaused') : tc('shortcutsHelpRegistryListening')}</span>\n            <span>{tc('shortcutsHelpCount', { count: hotkeys.length })}</span>\n          </div>\n\n          {conflicts.length > 0 && (\n            <div className=\"rounded-md border border-warning/40 bg-warning/10 p-card-sm text-sm text-warning-foreground\">\n              <div className=\"font-medium\">{tc('shortcutsHelpConflictsDetected')}</div>\n              <ul className=\"mt-item-xs space-y-item-xs\">\n                {conflicts.map(conflict => (\n                  <li key={conflict.shortcut}>\n                    <code>{conflict.shortcut}</code> {tc('shortcutsHelpConflictUsedBy')} {conflict.hotkeyIds.join(', ')}\n                  </li>\n                ))}\n              </ul>\n            </div>\n          )}\n\n          <ScrollArea className=\"max-h-[60vh] pe-item-sm\">\n            <div className=\"space-y-card\">\n              {groupedHotkeys.map(({ group, label, hotkeys: groupHotkeys }) => (\n                <section key={group} className=\"space-y-item-sm\">\n                  <h3 className=\"text-sm font-semibold text-foreground\">{label}</h3>\n                  <div className=\"space-y-item-xs\">\n                    {groupHotkeys.map(hotkey => (\n                      <div\n                        key={hotkey.id}\n                        className=\"flex items-start justify-between gap-field rounded-md border border-border/70 px-card-sm py-item-sm\"\n                      >\n                        <div className=\"min-w-0 space-y-[2px]\">\n                          <div className=\"text-sm font-medium text-foreground\">{hotkey.description}</div>\n                          <div className=\"flex flex-wrap items-center gap-item-sm text-xs text-muted-foreground\">\n                            <span>{scopeLabel(hotkey.scope, tc)}</span>\n                            {hotkey.launcher && <span>{hotkey.launcher}</span>}\n                            <span>{hotkey.id}</span>\n                          </div>\n                        </div>\n                        <Kbd>{hotkey.parsed.display}</Kbd>\n                      </div>\n                    ))}\n                  </div>\n                </section>\n              ))}\n            </div>\n          </ScrollArea>\n        </div>\n      </DialogContent>\n    </Dialog>\n  );\n}\n"]}

package/dist/esm/core/hotkey/hotkey-registry.frontend.schemas.d.ts

@@ -41,7 +41,14 @@ export interface ParsedShortcut {
     modifiers: ModifierKey[];
     /** The main key (single character or special key name) */
     key: string;
-    /** Original shortcut string for display */
+    /**
+     * The chord's IDENTITY, spelling-independent: sorted modifiers then the key, after normalization
+     * (`Shift+?` and `?` share one, `Control+K` and `Ctrl+K` share one). Conflict detection keys on
+     * this rather than on the authored string, so two registrations of the same physical chord are
+     * reported as a collision however each author spelled it.
+     */
+    chord: string;
+    /** Platform-aware rendering for the shortcuts dialog (`⌘B` on macOS, `Ctrl+B` elsewhere) */
     display: string;
 }
 /**
@@ -151,6 +158,19 @@ export interface HotkeyRegistryContextType {
     /** Whether registry is paused */
     isPaused: boolean;
 }
+/**
+ * Whether a main key is a GLYPH — a single printable character that is neither a letter nor a
+ * digit (`?`, `/`, `.`, `,`, `[`, `=`, …).
+ *
+ * For a glyph, Shift is not a modifier axis. `KeyboardEvent.key` carries the character the
+ * keyboard PRODUCED, and whether producing it involved Shift is a property of the layout, not of
+ * the chord: `?` is Shift+`/` on a US keyboard, Shift+`,` on a French one, and unshifted on some
+ * others. So a chord authored `?` is one physical intent everywhere, and `Shift+?` names nothing a
+ * finger can add — the glyph already says it. Letters keep the axis (Shift+P is a real, distinct
+ * chord: the event key is `P`, lowercased to match), and digits keep it because a shifted digit
+ * arrives as a DIFFERENT glyph (`!`), which an author who wants it should spell as that glyph.
+ */
+export declare function isGlyphKey(key: string): boolean;
 /**
  * Parse a shortcut string into modifiers and key
  *
@@ -159,6 +179,10 @@ export interface HotkeyRegistryContextType {
  * - "Ctrl+Shift+P"
  * - "Alt+Enter"
  * - Single keys: "Escape", "F1"
+ * - Glyph keys: "?", "/", "." — Shift is IMPLIED by the glyph and never a modifier of it (see
+ *   {@link isGlyphKey}). A chord spelled `Shift+?` is normalized to `?`: same physical intent, and
+ *   without the normalization the shortcuts dialog would render `⇧?`, telling the reader to hold a
+ *   key that on their layout may not be part of typing `?` at all.
  */
 export declare function parseShortcut(shortcut: string): ParsedShortcut;
 /**

package/dist/esm/core/hotkey/hotkey-registry.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotkey-registry.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/hotkey/hotkey-registry.frontend.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hotkey-registry.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/hotkey/hotkey-registry.frontend.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/hotkey/hotkey-registry.frontend.schemas.js

@@ -58,6 +58,21 @@ export const HOTKEY_SCOPE_SPECIFICITY = {
     [HotkeyScope.PAGE]: 1,
     [HotkeyScope.GLOBAL]: 0,
 };
+/**
+ * Whether a main key is a GLYPH — a single printable character that is neither a letter nor a
+ * digit (`?`, `/`, `.`, `,`, `[`, `=`, …).
+ *
+ * For a glyph, Shift is not a modifier axis. `KeyboardEvent.key` carries the character the
+ * keyboard PRODUCED, and whether producing it involved Shift is a property of the layout, not of
+ * the chord: `?` is Shift+`/` on a US keyboard, Shift+`,` on a French one, and unshifted on some
+ * others. So a chord authored `?` is one physical intent everywhere, and `Shift+?` names nothing a
+ * finger can add — the glyph already says it. Letters keep the axis (Shift+P is a real, distinct
+ * chord: the event key is `P`, lowercased to match), and digits keep it because a shifted digit
+ * arrives as a DIFFERENT glyph (`!`), which an author who wants it should spell as that glyph.
+ */
+export function isGlyphKey(key) {
+    return key.length === 1 && !/[a-z0-9]/i.test(key);
+}
 /**
  * Parse a shortcut string into modifiers and key
  *
@@ -66,10 +81,14 @@ export const HOTKEY_SCOPE_SPECIFICITY = {
  * - "Ctrl+Shift+P"
  * - "Alt+Enter"
  * - Single keys: "Escape", "F1"
+ * - Glyph keys: "?", "/", "." — Shift is IMPLIED by the glyph and never a modifier of it (see
+ *   {@link isGlyphKey}). A chord spelled `Shift+?` is normalized to `?`: same physical intent, and
+ *   without the normalization the shortcuts dialog would render `⇧?`, telling the reader to hold a
+ *   key that on their layout may not be part of typing `?` at all.
  */
 export function parseShortcut(shortcut) {
     const parts = shortcut.split('+').map(p => p.trim().toLowerCase());
-    const modifiers = [];
+    let modifiers = [];
     let key = '';
     for (const part of parts) {
         switch (part) {
@@ -99,6 +118,9 @@ export function parseShortcut(shortcut) {
                 key = part;
         }
     }
+    if (isGlyphKey(key)) {
+        modifiers = modifiers.filter(modifier => modifier !== ModifierKey.SHIFT);
+    }
     // Generate display string (platform-aware)
     const isMac = isMacPlatform();
     const displayParts = [];
@@ -118,6 +140,7 @@ export function parseShortcut(shortcut) {
     return {
         modifiers,
         key,
+        chord: [...[...modifiers].sort(), key].join('+'),
         display: displayParts.join(isMac ? '' : '+'),
     };
 }
@@ -142,7 +165,10 @@ export function matchesShortcut(event, parsed) {
         return false;
     if (hasAlt !== needsAlt)
         return false;
-    if (hasShift !== needsShift)
+    // A glyph key carries its own shift state in `event.key` (see `isGlyphKey`), so the physical
+    // `shiftKey` flag says nothing about the chord and must not be compared — on a US layout `?`
+    // arrives with it raised, on others it does not, and both are the same shortcut.
+    if (!isGlyphKey(parsed.key) && hasShift !== needsShift)
         return false;
     if (hasMeta !== needsMeta)
         return false;

package/dist/esm/core/hotkey/hotkey-registry.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"hotkey-registry.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/hotkey/hotkey-registry.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hotkey Registry Schemas\n * \n * Defines the types and schemas for the hotkey system.\n * Based on Specs §7 - HOTKEY Specification (Infrastructure)\n */\n\nimport { ApplicationLevelComponentType, HotkeyScope } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\n/**\n * Modifier keys that can be combined with shortcuts\n */\n/**\n * `mod` is the CROSS-PLATFORM modifier: ⌘ on macOS, Ctrl everywhere else.\n *\n * It exists because matching is strict — `hasMeta !== needsMeta` fails — so a chord written `Cmd+K`\n * is DEAD on Windows and `Ctrl+K` is not the Mac convention. That is tolerable while every shortcut\n * is one application's own choice; it is not tolerable for a shortcut the FRAMEWORK ships to every\n * application (#441), which is why this landed with the default binding set rather than after it.\n *\n * Prefer `mod` in new shortcuts. `ctrl` and `meta` stay available for the rare chord that genuinely\n * means one physical key on both platforms.\n */\nexport enum ModifierKey {\n  /** The physical Control key, on every platform. */\n  CTRL = 'ctrl',\n  /** Alt on Windows and Linux, Option on macOS. */\n  ALT = 'alt',\n  SHIFT = 'shift',\n  /** The physical Command key on macOS, the Windows key elsewhere. */\n  META = 'meta',\n  /**\n   * The CROSS-PLATFORM modifier — ⌘ on macOS, Ctrl everywhere else. Prefer it; see above for why a\n   * framework-shipped chord written with `ctrl` or `meta` is dead on one of the two platforms.\n   */\n  MOD = 'mod',\n}\n\n/** True when the runtime is macOS, where `mod` means ⌘ rather than Ctrl. */\nfunction isMacPlatform(): boolean {\n  return typeof navigator !== 'undefined' && navigator.platform.toLowerCase().includes('mac');\n}\n\n/**\n * Parsed shortcut definition\n */\nexport interface ParsedShortcut {\n  /** Modifier keys (ctrl, alt, shift, meta) */\n  modifiers: ModifierKey[];\n  /** The main key (single character or special key name) */\n  key: string;\n  /** Original shortcut string for display */\n  display: string;\n}\n\n/**\n * Hotkey registration definition\n */\nexport interface HotkeyDefinition {\n  /** Unique identifier for this hotkey */\n  id: string;\n  \n  /** Keyboard shortcut (e.g., \"Ctrl+K\", \"Cmd+Shift+P\") */\n  shortcut: string;\n  \n  /** Human-readable description */\n  description: string;\n  \n  /** Scope of the hotkey */\n  scope: HotkeyScope;\n  \n  /** Handler function to execute when triggered */\n  handler: () => void;\n  \n  /** Whether this hotkey is currently enabled */\n  enabled?: boolean;\n  \n  /** Optional: Group for organization (e.g., \"navigation\", \"editing\") */\n  group?: string;\n  \n  /** Optional: Associated launcher for navigation hotkeys */\n  launcher?: ApplicationLevelComponentType;\n  \n  /** Optional: Prevent default browser behavior */\n  preventDefault?: boolean;\n  \n  /** Optional: Stop event propagation */\n  stopPropagation?: boolean;\n\n  /**\n   * Explicit precedence when two hotkeys claim the same chord in overlapping scopes. Higher wins.\n   *\n   * Defaults to {@link HOTKEY_DEFAULT_PRIORITY}. The framework's own default bindings register\n   * BELOW it ({@link HOTKEY_FRAMEWORK_DEFAULT_PRIORITY}) so anything an application registers\n   * outranks them without having to say so.\n   *\n   * Ties fall to SCOPE SPECIFICITY (COMPONENT beats PAGE beats GLOBAL), and only then to\n   * registration order. Before #441 registration order was the WHOLE rule, so which of two\n   * conflicting shortcuts fired depended on mount order — on nothing anyone declared.\n   */\n  priority?: number;\n}\n\n/** Precedence for an ordinary registration — the implicit default. */\nexport const HOTKEY_DEFAULT_PRIORITY = 0;\n\n/**\n * Precedence for the framework's own shipped bindings: BELOW an application's.\n *\n * A framework default colliding with an application's own chord is not a conflict to arbitrate on\n * the fly — the application meant its binding, and the default is what the framework offered when\n * nothing was said. Making that a number rather than a special case keeps one comparison in\n * dispatch.\n */\nexport const HOTKEY_FRAMEWORK_DEFAULT_PRIORITY = -100;\n\n/**\n * How specific a scope is, for tie-breaking. A COMPONENT hotkey is a narrower claim on a chord than\n * a GLOBAL one, so it wins when both are live and neither declared a priority.\n */\nexport const HOTKEY_SCOPE_SPECIFICITY: Record<HotkeyScope, number> = {\n  [HotkeyScope.COMPONENT]: 2,\n  [HotkeyScope.PAGE]: 1,\n  [HotkeyScope.GLOBAL]: 0,\n};\n\n/**\n * Registered hotkey with parsed shortcut\n */\nexport interface RegisteredHotkey extends HotkeyDefinition {\n  /** Parsed shortcut for efficient matching */\n  parsed: ParsedShortcut;\n}\n\n/**\n * Hotkey conflict information\n */\nexport interface HotkeyConflict {\n  /** The shortcut that has conflicts */\n  shortcut: string;\n  /** IDs of hotkeys using this shortcut */\n  hotkeyIds: string[];\n}\n\n/**\n * Hotkey registry state\n */\nexport interface HotkeyRegistryState {\n  /** All registered hotkeys */\n  hotkeys: Map<string, RegisteredHotkey>;\n  \n  /** Currently active scope */\n  activeScope: HotkeyScope;\n  \n  /** Whether the registry is paused (e.g., when modal is open) */\n  isPaused: boolean;\n}\n\n/**\n * Context type for the hotkey registry\n */\nexport interface HotkeyRegistryContextType {\n  /** Register a new hotkey */\n  register: (definition: HotkeyDefinition) => () => void;\n  \n  /** Unregister a hotkey by ID */\n  unregister: (id: string) => void;\n  \n  /** Enable/disable a hotkey */\n  setEnabled: (id: string, enabled: boolean) => void;\n  \n  /** Set the active scope */\n  setActiveScope: (scope: HotkeyScope) => void;\n  \n  /** Pause all hotkey handling */\n  pause: () => void;\n  \n  /** Resume hotkey handling */\n  resume: () => void;\n  \n  /** Get all registered hotkeys */\n  getHotkeys: () => RegisteredHotkey[];\n  \n  /** Get hotkeys for a specific group */\n  getHotkeysByGroup: (group: string) => RegisteredHotkey[];\n  \n  /** Check for conflicts */\n  getConflicts: () => HotkeyConflict[];\n  \n  /** Current active scope */\n  activeScope: HotkeyScope;\n  \n  /** Whether registry is paused */\n  isPaused: boolean;\n}\n\n/**\n * Parse a shortcut string into modifiers and key\n * \n * Supports formats:\n * - \"Ctrl+K\", \"Cmd+K\" (Cmd maps to Meta on Mac, Ctrl on others)\n * - \"Ctrl+Shift+P\"\n * - \"Alt+Enter\"\n * - Single keys: \"Escape\", \"F1\"\n */\nexport function parseShortcut(shortcut: string): ParsedShortcut {\n  const parts = shortcut.split('+').map(p => p.trim().toLowerCase());\n  const modifiers: ModifierKey[] = [];\n  let key = '';\n  \n  for (const part of parts) {\n    switch (part) {\n      case 'ctrl':\n      case 'control':\n        modifiers.push(ModifierKey.CTRL);\n        break;\n      case 'alt':\n      case 'option':\n        modifiers.push(ModifierKey.ALT);\n        break;\n      case 'shift':\n        modifiers.push(ModifierKey.SHIFT);\n        break;\n      case 'meta':\n      case 'cmd':\n      case 'command':\n      case 'win':\n      case 'windows':\n        modifiers.push(ModifierKey.META);\n        break;\n      case 'mod':\n        modifiers.push(ModifierKey.MOD);\n        break;\n      default:\n        // This is the main key\n        key = part;\n    }\n  }\n  \n  // Generate display string (platform-aware)\n  const isMac = isMacPlatform();\n  const displayParts: string[] = [];\n  \n  // `mod` renders as the key this platform actually presses, so the shortcuts dialog never shows a\n  // chord the reader cannot type.\n  if (modifiers.includes(ModifierKey.MOD)) displayParts.push(isMac ? '⌘' : 'Ctrl');\n  if (modifiers.includes(ModifierKey.CTRL)) displayParts.push(isMac ? '⌃' : 'Ctrl');\n  if (modifiers.includes(ModifierKey.ALT)) displayParts.push(isMac ? '⌥' : 'Alt');\n  if (modifiers.includes(ModifierKey.SHIFT)) displayParts.push(isMac ? '⇧' : 'Shift');\n  if (modifiers.includes(ModifierKey.META)) displayParts.push(isMac ? '⌘' : 'Win');\n  displayParts.push(key.toUpperCase());\n  \n  return {\n    modifiers,\n    key,\n    display: displayParts.join(isMac ? '' : '+'),\n  };\n}\n\n/**\n * Check if an event matches a parsed shortcut\n */\nexport function matchesShortcut(event: KeyboardEvent, parsed: ParsedShortcut): boolean {\n  // Check modifiers\n  const hasCtrl = event.ctrlKey;\n  const hasAlt = event.altKey;\n  const hasShift = event.shiftKey;\n  const hasMeta = event.metaKey;\n  \n  // `mod` resolves to the platform's own command modifier before the strict comparison below, so a\n  // single authored chord matches ⌘ on macOS and Ctrl elsewhere.\n  const needsMod = parsed.modifiers.includes(ModifierKey.MOD);\n  const modIsMeta = isMacPlatform();\n  const needsCtrl = parsed.modifiers.includes(ModifierKey.CTRL) || (needsMod && !modIsMeta);\n  const needsAlt = parsed.modifiers.includes(ModifierKey.ALT);\n  const needsShift = parsed.modifiers.includes(ModifierKey.SHIFT);\n  const needsMeta = parsed.modifiers.includes(ModifierKey.META) || (needsMod && modIsMeta);\n  \n  if (hasCtrl !== needsCtrl) return false;\n  if (hasAlt !== needsAlt) return false;\n  if (hasShift !== needsShift) return false;\n  if (hasMeta !== needsMeta) return false;\n  \n  // Check main key\n  const eventKey = event.key.toLowerCase();\n  return eventKey === parsed.key;\n}\n"]}
+{"version":3,"file":"hotkey-registry.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/hotkey/hotkey-registry.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hotkey Registry Schemas\n * \n * Defines the types and schemas for the hotkey system.\n * Based on Specs §7 - HOTKEY Specification (Infrastructure)\n */\n\nimport { ApplicationLevelComponentType, HotkeyScope } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\n/**\n * Modifier keys that can be combined with shortcuts\n */\n/**\n * `mod` is the CROSS-PLATFORM modifier: ⌘ on macOS, Ctrl everywhere else.\n *\n * It exists because matching is strict — `hasMeta !== needsMeta` fails — so a chord written `Cmd+K`\n * is DEAD on Windows and `Ctrl+K` is not the Mac convention. That is tolerable while every shortcut\n * is one application's own choice; it is not tolerable for a shortcut the FRAMEWORK ships to every\n * application (#441), which is why this landed with the default binding set rather than after it.\n *\n * Prefer `mod` in new shortcuts. `ctrl` and `meta` stay available for the rare chord that genuinely\n * means one physical key on both platforms.\n */\nexport enum ModifierKey {\n  /** The physical Control key, on every platform. */\n  CTRL = 'ctrl',\n  /** Alt on Windows and Linux, Option on macOS. */\n  ALT = 'alt',\n  SHIFT = 'shift',\n  /** The physical Command key on macOS, the Windows key elsewhere. */\n  META = 'meta',\n  /**\n   * The CROSS-PLATFORM modifier — ⌘ on macOS, Ctrl everywhere else. Prefer it; see above for why a\n   * framework-shipped chord written with `ctrl` or `meta` is dead on one of the two platforms.\n   */\n  MOD = 'mod',\n}\n\n/** True when the runtime is macOS, where `mod` means ⌘ rather than Ctrl. */\nfunction isMacPlatform(): boolean {\n  return typeof navigator !== 'undefined' && navigator.platform.toLowerCase().includes('mac');\n}\n\n/**\n * Parsed shortcut definition\n */\nexport interface ParsedShortcut {\n  /** Modifier keys (ctrl, alt, shift, meta) */\n  modifiers: ModifierKey[];\n  /** The main key (single character or special key name) */\n  key: string;\n  /**\n   * The chord's IDENTITY, spelling-independent: sorted modifiers then the key, after normalization\n   * (`Shift+?` and `?` share one, `Control+K` and `Ctrl+K` share one). Conflict detection keys on\n   * this rather than on the authored string, so two registrations of the same physical chord are\n   * reported as a collision however each author spelled it.\n   */\n  chord: string;\n  /** Platform-aware rendering for the shortcuts dialog (`⌘B` on macOS, `Ctrl+B` elsewhere) */\n  display: string;\n}\n\n/**\n * Hotkey registration definition\n */\nexport interface HotkeyDefinition {\n  /** Unique identifier for this hotkey */\n  id: string;\n  \n  /** Keyboard shortcut (e.g., \"Ctrl+K\", \"Cmd+Shift+P\") */\n  shortcut: string;\n  \n  /** Human-readable description */\n  description: string;\n  \n  /** Scope of the hotkey */\n  scope: HotkeyScope;\n  \n  /** Handler function to execute when triggered */\n  handler: () => void;\n  \n  /** Whether this hotkey is currently enabled */\n  enabled?: boolean;\n  \n  /** Optional: Group for organization (e.g., \"navigation\", \"editing\") */\n  group?: string;\n  \n  /** Optional: Associated launcher for navigation hotkeys */\n  launcher?: ApplicationLevelComponentType;\n  \n  /** Optional: Prevent default browser behavior */\n  preventDefault?: boolean;\n  \n  /** Optional: Stop event propagation */\n  stopPropagation?: boolean;\n\n  /**\n   * Explicit precedence when two hotkeys claim the same chord in overlapping scopes. Higher wins.\n   *\n   * Defaults to {@link HOTKEY_DEFAULT_PRIORITY}. The framework's own default bindings register\n   * BELOW it ({@link HOTKEY_FRAMEWORK_DEFAULT_PRIORITY}) so anything an application registers\n   * outranks them without having to say so.\n   *\n   * Ties fall to SCOPE SPECIFICITY (COMPONENT beats PAGE beats GLOBAL), and only then to\n   * registration order. Before #441 registration order was the WHOLE rule, so which of two\n   * conflicting shortcuts fired depended on mount order — on nothing anyone declared.\n   */\n  priority?: number;\n}\n\n/** Precedence for an ordinary registration — the implicit default. */\nexport const HOTKEY_DEFAULT_PRIORITY = 0;\n\n/**\n * Precedence for the framework's own shipped bindings: BELOW an application's.\n *\n * A framework default colliding with an application's own chord is not a conflict to arbitrate on\n * the fly — the application meant its binding, and the default is what the framework offered when\n * nothing was said. Making that a number rather than a special case keeps one comparison in\n * dispatch.\n */\nexport const HOTKEY_FRAMEWORK_DEFAULT_PRIORITY = -100;\n\n/**\n * How specific a scope is, for tie-breaking. A COMPONENT hotkey is a narrower claim on a chord than\n * a GLOBAL one, so it wins when both are live and neither declared a priority.\n */\nexport const HOTKEY_SCOPE_SPECIFICITY: Record<HotkeyScope, number> = {\n  [HotkeyScope.COMPONENT]: 2,\n  [HotkeyScope.PAGE]: 1,\n  [HotkeyScope.GLOBAL]: 0,\n};\n\n/**\n * Registered hotkey with parsed shortcut\n */\nexport interface RegisteredHotkey extends HotkeyDefinition {\n  /** Parsed shortcut for efficient matching */\n  parsed: ParsedShortcut;\n}\n\n/**\n * Hotkey conflict information\n */\nexport interface HotkeyConflict {\n  /** The shortcut that has conflicts */\n  shortcut: string;\n  /** IDs of hotkeys using this shortcut */\n  hotkeyIds: string[];\n}\n\n/**\n * Hotkey registry state\n */\nexport interface HotkeyRegistryState {\n  /** All registered hotkeys */\n  hotkeys: Map<string, RegisteredHotkey>;\n  \n  /** Currently active scope */\n  activeScope: HotkeyScope;\n  \n  /** Whether the registry is paused (e.g., when modal is open) */\n  isPaused: boolean;\n}\n\n/**\n * Context type for the hotkey registry\n */\nexport interface HotkeyRegistryContextType {\n  /** Register a new hotkey */\n  register: (definition: HotkeyDefinition) => () => void;\n  \n  /** Unregister a hotkey by ID */\n  unregister: (id: string) => void;\n  \n  /** Enable/disable a hotkey */\n  setEnabled: (id: string, enabled: boolean) => void;\n  \n  /** Set the active scope */\n  setActiveScope: (scope: HotkeyScope) => void;\n  \n  /** Pause all hotkey handling */\n  pause: () => void;\n  \n  /** Resume hotkey handling */\n  resume: () => void;\n  \n  /** Get all registered hotkeys */\n  getHotkeys: () => RegisteredHotkey[];\n  \n  /** Get hotkeys for a specific group */\n  getHotkeysByGroup: (group: string) => RegisteredHotkey[];\n  \n  /** Check for conflicts */\n  getConflicts: () => HotkeyConflict[];\n  \n  /** Current active scope */\n  activeScope: HotkeyScope;\n  \n  /** Whether registry is paused */\n  isPaused: boolean;\n}\n\n/**\n * Whether a main key is a GLYPH — a single printable character that is neither a letter nor a\n * digit (`?`, `/`, `.`, `,`, `[`, `=`, …).\n *\n * For a glyph, Shift is not a modifier axis. `KeyboardEvent.key` carries the character the\n * keyboard PRODUCED, and whether producing it involved Shift is a property of the layout, not of\n * the chord: `?` is Shift+`/` on a US keyboard, Shift+`,` on a French one, and unshifted on some\n * others. So a chord authored `?` is one physical intent everywhere, and `Shift+?` names nothing a\n * finger can add — the glyph already says it. Letters keep the axis (Shift+P is a real, distinct\n * chord: the event key is `P`, lowercased to match), and digits keep it because a shifted digit\n * arrives as a DIFFERENT glyph (`!`), which an author who wants it should spell as that glyph.\n */\nexport function isGlyphKey(key: string): boolean {\n  return key.length === 1 && !/[a-z0-9]/i.test(key);\n}\n\n/**\n * Parse a shortcut string into modifiers and key\n * \n * Supports formats:\n * - \"Ctrl+K\", \"Cmd+K\" (Cmd maps to Meta on Mac, Ctrl on others)\n * - \"Ctrl+Shift+P\"\n * - \"Alt+Enter\"\n * - Single keys: \"Escape\", \"F1\"\n * - Glyph keys: \"?\", \"/\", \".\" — Shift is IMPLIED by the glyph and never a modifier of it (see\n *   {@link isGlyphKey}). A chord spelled `Shift+?` is normalized to `?`: same physical intent, and\n *   without the normalization the shortcuts dialog would render `⇧?`, telling the reader to hold a\n *   key that on their layout may not be part of typing `?` at all.\n */\nexport function parseShortcut(shortcut: string): ParsedShortcut {\n  const parts = shortcut.split('+').map(p => p.trim().toLowerCase());\n  let modifiers: ModifierKey[] = [];\n  let key = '';\n  \n  for (const part of parts) {\n    switch (part) {\n      case 'ctrl':\n      case 'control':\n        modifiers.push(ModifierKey.CTRL);\n        break;\n      case 'alt':\n      case 'option':\n        modifiers.push(ModifierKey.ALT);\n        break;\n      case 'shift':\n        modifiers.push(ModifierKey.SHIFT);\n        break;\n      case 'meta':\n      case 'cmd':\n      case 'command':\n      case 'win':\n      case 'windows':\n        modifiers.push(ModifierKey.META);\n        break;\n      case 'mod':\n        modifiers.push(ModifierKey.MOD);\n        break;\n      default:\n        // This is the main key\n        key = part;\n    }\n  }\n\n  if (isGlyphKey(key)) {\n    modifiers = modifiers.filter(modifier => modifier !== ModifierKey.SHIFT);\n  }\n  \n  // Generate display string (platform-aware)\n  const isMac = isMacPlatform();\n  const displayParts: string[] = [];\n  \n  // `mod` renders as the key this platform actually presses, so the shortcuts dialog never shows a\n  // chord the reader cannot type.\n  if (modifiers.includes(ModifierKey.MOD)) displayParts.push(isMac ? '⌘' : 'Ctrl');\n  if (modifiers.includes(ModifierKey.CTRL)) displayParts.push(isMac ? '⌃' : 'Ctrl');\n  if (modifiers.includes(ModifierKey.ALT)) displayParts.push(isMac ? '⌥' : 'Alt');\n  if (modifiers.includes(ModifierKey.SHIFT)) displayParts.push(isMac ? '⇧' : 'Shift');\n  if (modifiers.includes(ModifierKey.META)) displayParts.push(isMac ? '⌘' : 'Win');\n  displayParts.push(key.toUpperCase());\n  \n  return {\n    modifiers,\n    key,\n    chord: [...[...modifiers].sort(), key].join('+'),\n    display: displayParts.join(isMac ? '' : '+'),\n  };\n}\n\n/**\n * Check if an event matches a parsed shortcut\n */\nexport function matchesShortcut(event: KeyboardEvent, parsed: ParsedShortcut): boolean {\n  // Check modifiers\n  const hasCtrl = event.ctrlKey;\n  const hasAlt = event.altKey;\n  const hasShift = event.shiftKey;\n  const hasMeta = event.metaKey;\n  \n  // `mod` resolves to the platform's own command modifier before the strict comparison below, so a\n  // single authored chord matches ⌘ on macOS and Ctrl elsewhere.\n  const needsMod = parsed.modifiers.includes(ModifierKey.MOD);\n  const modIsMeta = isMacPlatform();\n  const needsCtrl = parsed.modifiers.includes(ModifierKey.CTRL) || (needsMod && !modIsMeta);\n  const needsAlt = parsed.modifiers.includes(ModifierKey.ALT);\n  const needsShift = parsed.modifiers.includes(ModifierKey.SHIFT);\n  const needsMeta = parsed.modifiers.includes(ModifierKey.META) || (needsMod && modIsMeta);\n  \n  if (hasCtrl !== needsCtrl) return false;\n  if (hasAlt !== needsAlt) return false;\n  // A glyph key carries its own shift state in `event.key` (see `isGlyphKey`), so the physical\n  // `shiftKey` flag says nothing about the chord and must not be compared — on a US layout `?`\n  // arrives with it raised, on others it does not, and both are the same shortcut.\n  if (!isGlyphKey(parsed.key) && hasShift !== needsShift) return false;\n  if (hasMeta !== needsMeta) return false;\n  \n  // Check main key\n  const eventKey = event.key.toLowerCase();\n  return eventKey === parsed.key;\n}\n"]}

package/dist/esm/core/hotkey/merge-hotkey-emit-shortcuts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-hotkey-emit-shortcuts.d.ts","sourceRoot":"","sources":["../../../../src/core/hotkey/merge-hotkey-emit-shortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,uEAAuE,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,GAC/C,kBAAkB,EAAE,CAiBtB"}
+{"version":3,"file":"merge-hotkey-emit-shortcuts.d.ts","sourceRoot":"","sources":["../../../../../src/core/hotkey/merge-hotkey-emit-shortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,uEAAuE,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,GAC/C,kBAAkB,EAAE,CAiBtB"}

package/dist/esm/core/hotkey/merge-hotkey-emit-shortcuts.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge-hotkey-emit-shortcuts.js","sourceRoot":"","sources":["../../../../src/core/hotkey/merge-hotkey-emit-shortcuts.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAuC,EACvC,SAAgD;IAEhD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA+C,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAyB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAE,CAAC,CAAC;IAC3E,KAAK,MAAM,GAAG,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import {\n  HotkeyDispatchableEvent,\n  type HotkeyEmitShortcut,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\n/**\n * Merge preset/app `emitShortcuts` over a baseline list by `event`.\n * Used by `DefaultHotkeyHandler` with baseline `[]` when config already carries the\n * full list from presets, or with a baseline slice for partial overrides.\n */\nexport function mergeHotkeyEmitShortcuts(\n  defaults: readonly HotkeyEmitShortcut[],\n  overrides?: readonly HotkeyEmitShortcut[] | null,\n): HotkeyEmitShortcut[] {\n  const map = new Map<HotkeyDispatchableEvent, HotkeyEmitShortcut>();\n  for (const row of defaults) {\n    map.set(row.event, row);\n  }\n  if (overrides) {\n    for (const row of overrides) {\n      map.set(row.event, row);\n    }\n  }\n  const ordered: HotkeyEmitShortcut[] = defaults.map(d => map.get(d.event)!);\n  for (const row of overrides ?? []) {\n    if (!defaults.some(d => d.event === row.event)) {\n      ordered.push(map.get(row.event)!);\n    }\n  }\n  return ordered;\n}\n"]}
+{"version":3,"file":"merge-hotkey-emit-shortcuts.js","sourceRoot":"","sources":["../../../../../src/core/hotkey/merge-hotkey-emit-shortcuts.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAuC,EACvC,SAAgD;IAEhD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA+C,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAyB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAE,CAAC,CAAC;IAC3E,KAAK,MAAM,GAAG,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import {\n  HotkeyDispatchableEvent,\n  type HotkeyEmitShortcut,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\n/**\n * Merge preset/app `emitShortcuts` over a baseline list by `event`.\n * Used by `DefaultHotkeyHandler` with baseline `[]` when config already carries the\n * full list from presets, or with a baseline slice for partial overrides.\n */\nexport function mergeHotkeyEmitShortcuts(\n  defaults: readonly HotkeyEmitShortcut[],\n  overrides?: readonly HotkeyEmitShortcut[] | null,\n): HotkeyEmitShortcut[] {\n  const map = new Map<HotkeyDispatchableEvent, HotkeyEmitShortcut>();\n  for (const row of defaults) {\n    map.set(row.event, row);\n  }\n  if (overrides) {\n    for (const row of overrides) {\n      map.set(row.event, row);\n    }\n  }\n  const ordered: HotkeyEmitShortcut[] = defaults.map(d => map.get(d.event)!);\n  for (const row of overrides ?? []) {\n    if (!defaults.some(d => d.event === row.event)) {\n      ordered.push(map.get(row.event)!);\n    }\n  }\n  return ordered;\n}\n"]}

package/dist/esm/core/hotkey/useHotkey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHotkey.d.ts","sourceRoot":"","sources":["../../../../src/core/hotkey/useHotkey.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,uEAAuE,CAAC;AAIpG;;GAEG;AACH,wBAAgB,iBAAiB,2EAMhC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,IAAI,EACnB,OAAO,GAAE,gBAAqB,+DAwB/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,QA4BH;AAED;;;GAGG;AACH,wBAAgB,cAAc;;;;EAG7B;AAED;;;GAGG;AACH,wBAAgB,cAAc;;;EAG7B"}
+{"version":3,"file":"useHotkey.d.ts","sourceRoot":"","sources":["../../../../../src/core/hotkey/useHotkey.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,uEAAuE,CAAC;AAIpG;;GAEG;AACH,wBAAgB,iBAAiB,2EAMhC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,IAAI,EACnB,OAAO,GAAE,gBAAqB,+DAwB/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,QA4BH;AAED;;;GAGG;AACH,wBAAgB,cAAc;;;;EAG7B;AAED;;;GAGG;AACH,wBAAgB,cAAc;;;EAG7B"}

package/dist/esm/core/hotkey/useHotkey.js.map

@@ -1 +1 @@
-{"version":3,"file":"useHotkey.js","sourceRoot":"","sources":["../../../../src/core/hotkey/useHotkey.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useHotkey Hook\n * \n * Hook for registering and managing keyboard shortcuts.\n * Based on Specs §7 - HOTKEY Specification (Infrastructure)\n */\n\nimport { useContext, useEffect, useMemo } from 'react';\nimport { HotkeyScope } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { HotkeyRegistryContext } from './HotkeyRegistryContext';\nimport { HotkeyDefinition, parseShortcut } from './hotkey-registry.frontend.schemas';\n\n/**\n * Hook to access the hotkey registry\n */\nexport function useHotkeyRegistry() {\n  const context = useContext(HotkeyRegistryContext);\n  if (!context) {\n    throw new Error('useHotkeyRegistry must be used within a HotkeyRegistryProvider');\n  }\n  return context;\n}\n\n/**\n * Options for the useHotkey hook\n */\nexport interface UseHotkeyOptions {\n  /** Unique identifier (auto-generated if not provided) */\n  id?: string;\n  /** Scope of the hotkey */\n  scope?: HotkeyScope;\n  /** Whether enabled */\n  enabled?: boolean;\n  /** Group for organization */\n  group?: string;\n  /** Description for help dialogs */\n  description?: string;\n  /** Prevent default browser behavior */\n  preventDefault?: boolean;\n}\n\nlet hotkeyCounter = 0;\n\n/**\n * Hook to register a single hotkey\n * \n * @param shortcut - Keyboard shortcut (e.g., \"Ctrl+K\", \"Cmd+Shift+P\")\n * @param handler - Function to execute when triggered\n * @param options - Additional options\n * \n * @example\n * ```tsx\n * useHotkey('Ctrl+S', () => saveDocument(), {\n *   description: 'Save document',\n *   preventDefault: true,\n * });\n * ```\n */\nexport function useHotkey(\n  shortcut: string,\n  handler: () => void,\n  options: UseHotkeyOptions = {}\n) {\n  const { register } = useHotkeyRegistry();\n  \n  const id = useMemo(() => options.id ?? `hotkey-${++hotkeyCounter}`, [options.id]);\n  \n  useEffect(() => {\n    const definition: HotkeyDefinition = {\n      id,\n      shortcut,\n      handler,\n      description: options.description ?? shortcut,\n      scope: options.scope ?? HotkeyScope.GLOBAL,\n      enabled: options.enabled !== false,\n      group: options.group,\n      preventDefault: options.preventDefault,\n    };\n    \n    const unregister = register(definition);\n    return unregister;\n  }, [id, shortcut, handler, options.description, options.scope, options.enabled, options.group, options.preventDefault, register]);\n  \n  // Return the parsed shortcut for display purposes\n  return useMemo(() => parseShortcut(shortcut), [shortcut]);\n}\n\n/**\n * Hook to register multiple hotkeys at once\n * \n * @param hotkeys - Array of hotkey definitions\n * \n * @example\n * ```tsx\n * useHotkeys([\n *   { shortcut: 'Ctrl+S', handler: save, description: 'Save' },\n *   { shortcut: 'Ctrl+Z', handler: undo, description: 'Undo' },\n * ]);\n * ```\n */\nexport function useHotkeys(\n  hotkeys: Array<{\n    shortcut: string;\n    handler: () => void;\n    id?: string;\n    description?: string;\n    scope?: HotkeyScope;\n    enabled?: boolean;\n    group?: string;\n  }>\n) {\n  const { register } = useHotkeyRegistry();\n  \n  useEffect(() => {\n    const unregisters: Array<() => void> = [];\n    \n    for (const hotkey of hotkeys) {\n      const id = hotkey.id ?? `hotkey-batch-${++hotkeyCounter}`;\n      const definition: HotkeyDefinition = {\n        id,\n        shortcut: hotkey.shortcut,\n        handler: hotkey.handler,\n        description: hotkey.description ?? hotkey.shortcut,\n        scope: hotkey.scope ?? HotkeyScope.GLOBAL,\n        enabled: hotkey.enabled !== false,\n        group: hotkey.group,\n      };\n      \n      unregisters.push(register(definition));\n    }\n    \n    return () => {\n      for (const unregister of unregisters) {\n        unregister();\n      }\n    };\n  }, [hotkeys, register]);\n}\n\n/**\n * Hook to pause/resume hotkey handling\n * Useful when a modal or dialog is open\n */\nexport function useHotkeyPause() {\n  const { pause, resume, isPaused } = useHotkeyRegistry();\n  return { pause, resume, isPaused };\n}\n\n/**\n * Hook to change the active scope\n * Useful for component-level hotkey contexts\n */\nexport function useHotkeyScope() {\n  const { activeScope, setActiveScope } = useHotkeyRegistry();\n  return { activeScope, setActiveScope };\n}\n"]}
+{"version":3,"file":"useHotkey.js","sourceRoot":"","sources":["../../../../../src/core/hotkey/useHotkey.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,uEAAuE,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAoB,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAErF;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAoBD,IAAI,aAAa,GAAG,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,OAAmB,EACnB,UAA4B,EAAE;IAE9B,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAEzC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,UAAU,EAAE,aAAa,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAElF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,UAAU,GAAqB;YACnC,EAAE;YACF,QAAQ;YACR,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ;YAC5C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM;YAC1C,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,KAAK;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC;QAEF,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC;IACpB,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElI,kDAAkD;IAClD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CACxB,OAQE;IAEF,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAsB,EAAE,CAAC;QAE1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,gBAAgB,EAAE,aAAa,EAAE,CAAC;YAC1D,MAAM,UAAU,GAAqB;gBACnC,EAAE;gBACF,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,QAAQ;gBAClD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM;gBACzC,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK;gBACjC,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;YAEF,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,UAAU,EAAE,CAAC;YACf,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACxD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAC5D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACzC,CAAC","sourcesContent":["/**\n * useHotkey Hook\n * \n * Hook for registering and managing keyboard shortcuts.\n * Based on Specs §7 - HOTKEY Specification (Infrastructure)\n */\n\nimport { useContext, useEffect, useMemo } from 'react';\nimport { HotkeyScope } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { HotkeyRegistryContext } from './HotkeyRegistryContext';\nimport { HotkeyDefinition, parseShortcut } from './hotkey-registry.frontend.schemas';\n\n/**\n * Hook to access the hotkey registry\n */\nexport function useHotkeyRegistry() {\n  const context = useContext(HotkeyRegistryContext);\n  if (!context) {\n    throw new Error('useHotkeyRegistry must be used within a HotkeyRegistryProvider');\n  }\n  return context;\n}\n\n/**\n * Options for the useHotkey hook\n */\nexport interface UseHotkeyOptions {\n  /** Unique identifier (auto-generated if not provided) */\n  id?: string;\n  /** Scope of the hotkey */\n  scope?: HotkeyScope;\n  /** Whether enabled */\n  enabled?: boolean;\n  /** Group for organization */\n  group?: string;\n  /** Description for help dialogs */\n  description?: string;\n  /** Prevent default browser behavior */\n  preventDefault?: boolean;\n}\n\nlet hotkeyCounter = 0;\n\n/**\n * Hook to register a single hotkey\n * \n * @param shortcut - Keyboard shortcut (e.g., \"Ctrl+K\", \"Cmd+Shift+P\")\n * @param handler - Function to execute when triggered\n * @param options - Additional options\n * \n * @example\n * ```tsx\n * useHotkey('Ctrl+S', () => saveDocument(), {\n *   description: 'Save document',\n *   preventDefault: true,\n * });\n * ```\n */\nexport function useHotkey(\n  shortcut: string,\n  handler: () => void,\n  options: UseHotkeyOptions = {}\n) {\n  const { register } = useHotkeyRegistry();\n  \n  const id = useMemo(() => options.id ?? `hotkey-${++hotkeyCounter}`, [options.id]);\n  \n  useEffect(() => {\n    const definition: HotkeyDefinition = {\n      id,\n      shortcut,\n      handler,\n      description: options.description ?? shortcut,\n      scope: options.scope ?? HotkeyScope.GLOBAL,\n      enabled: options.enabled !== false,\n      group: options.group,\n      preventDefault: options.preventDefault,\n    };\n    \n    const unregister = register(definition);\n    return unregister;\n  }, [id, shortcut, handler, options.description, options.scope, options.enabled, options.group, options.preventDefault, register]);\n  \n  // Return the parsed shortcut for display purposes\n  return useMemo(() => parseShortcut(shortcut), [shortcut]);\n}\n\n/**\n * Hook to register multiple hotkeys at once\n * \n * @param hotkeys - Array of hotkey definitions\n * \n * @example\n * ```tsx\n * useHotkeys([\n *   { shortcut: 'Ctrl+S', handler: save, description: 'Save' },\n *   { shortcut: 'Ctrl+Z', handler: undo, description: 'Undo' },\n * ]);\n * ```\n */\nexport function useHotkeys(\n  hotkeys: Array<{\n    shortcut: string;\n    handler: () => void;\n    id?: string;\n    description?: string;\n    scope?: HotkeyScope;\n    enabled?: boolean;\n    group?: string;\n  }>\n) {\n  const { register } = useHotkeyRegistry();\n  \n  useEffect(() => {\n    const unregisters: Array<() => void> = [];\n    \n    for (const hotkey of hotkeys) {\n      const id = hotkey.id ?? `hotkey-batch-${++hotkeyCounter}`;\n      const definition: HotkeyDefinition = {\n        id,\n        shortcut: hotkey.shortcut,\n        handler: hotkey.handler,\n        description: hotkey.description ?? hotkey.shortcut,\n        scope: hotkey.scope ?? HotkeyScope.GLOBAL,\n        enabled: hotkey.enabled !== false,\n        group: hotkey.group,\n      };\n      \n      unregisters.push(register(definition));\n    }\n    \n    return () => {\n      for (const unregister of unregisters) {\n        unregister();\n      }\n    };\n  }, [hotkeys, register]);\n}\n\n/**\n * Hook to pause/resume hotkey handling\n * Useful when a modal or dialog is open\n */\nexport function useHotkeyPause() {\n  const { pause, resume, isPaused } = useHotkeyRegistry();\n  return { pause, resume, isPaused };\n}\n\n/**\n * Hook to change the active scope\n * Useful for component-level hotkey contexts\n */\nexport function useHotkeyScope() {\n  const { activeScope, setActiveScope } = useHotkeyRegistry();\n  return { activeScope, setActiveScope };\n}\n"]}