impact-nova 1.3.0 → 1.5.2

package/dist/components/ui/command-palette/use-shortcut.d.ts

@@ -0,0 +1,47 @@
+import { ShortcutScope, KeyBinding } from './utils';
+/**
+ * useShortcut — Hook to register a scoped keyboard shortcut.
+ *
+ * Registers the command on mount, unregisters on unmount.
+ * Any saved user override is automatically applied by the registry.
+ */
+import * as React from 'react';
+export interface UseShortcutOptions {
+    /** Unique command ID, e.g. 'planning.save-draft' */
+    id: string;
+    /** Human-readable label shown in the command palette */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Optional icon (React node) */
+    icon?: React.ReactNode;
+    /** Category for grouping in the palette (e.g. 'Navigation') */
+    category?: string;
+    /** Scope: 'global' | 'module' | 'page' | 'modal' */
+    scope: ShortcutScope;
+    /** Default keybinding (can be overridden by user) */
+    defaultKeybinding?: KeyBinding;
+    /** Whether the user can customise this shortcut (default: true) */
+    customisable?: boolean;
+    /** Hide from the command palette list (default: false) */
+    hidden?: boolean;
+    /** Condition guard — shortcut only fires when this returns true */
+    when?: () => boolean;
+    /** The action to perform */
+    handler: () => void;
+    /** Source label for the settings panel */
+    source?: 'system' | 'user' | 'ag-grid';
+    /** Whether the shortcut is currently enabled (default: true) */
+    enabled?: boolean;
+    /**
+     * When true, the shortcut is display-only — shown in the palette/settings
+     * but the registry will NOT intercept the keyboard event.
+     */
+    passive?: boolean;
+    /**
+     * Instance ID — usually auto-inherited from the parent ShortcutScopeProvider.
+     * Only provide explicitly if needed.
+     */
+    instance?: string;
+}
+export declare function useShortcut(options: UseShortcutOptions): void;

package/dist/components/ui/command-palette/use-shortcut.js

@@ -0,0 +1,49 @@
+import * as e from "react";
+import { useCommandPalette as I } from "./command-palette-context.js";
+import { ShortcutInstanceContext as S } from "./shortcut-scope-provider.js";
+function P(l) {
+  const { registerCommand: r, unregisterCommand: s } = I(), h = e.useContext(S), {
+    id: n,
+    label: c,
+    description: p,
+    icon: C,
+    category: x,
+    scope: o,
+    defaultKeybinding: R,
+    customisable: b = !0,
+    hidden: g = !1,
+    when: a,
+    handler: i,
+    source: w = "user",
+    enabled: u = !0,
+    passive: d = !1,
+    instance: v
+  } = l, m = v ?? h?.instance, f = e.useRef(i);
+  f.current = i;
+  const t = e.useRef(a);
+  t.current = a, e.useEffect(() => {
+    if (!u) return;
+    const y = {
+      id: n,
+      label: c,
+      description: p,
+      icon: C,
+      category: x,
+      scope: o,
+      defaultKeybinding: R,
+      customisable: b,
+      hidden: g,
+      when: t.current ? () => t.current() : void 0,
+      handler: () => f.current(),
+      source: w,
+      passive: d,
+      instance: m
+    };
+    return r(y), () => {
+      s(n);
+    };
+  }, [n, c, o, u, d, m, r, s]);
+}
+export {
+  P as useShortcut
+};

package/dist/components/ui/command-palette/utils.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Command Palette & Keyboard Shortcuts — Shared Utilities
+ *
+ * Platform detection, keybinding parsing/matching, fuzzy search,
+ * and browser-reserved shortcut constants.
+ */
+export type ShortcutScope = 'global' | 'module' | 'page' | 'modal';
+export interface KeyBinding {
+    key: string;
+    meta?: boolean;
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
+export interface CommandDefinition {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: React.ReactNode;
+    category?: string;
+    scope: ShortcutScope;
+    defaultKeybinding?: KeyBinding;
+    keybinding?: KeyBinding;
+    customisable: boolean;
+    hidden?: boolean;
+    when?: () => boolean;
+    handler: () => void;
+    source?: 'system' | 'user' | 'ag-grid' | 'browser';
+    /**
+     * When true, the shortcut is displayed in the palette/settings but the
+     * registry will NOT intercept the keyboard event. The owning component
+     * (e.g. AG Grid) handles its own keyboard handling natively.
+     */
+    passive?: boolean;
+    /**
+     * Optional instance identifier. When multiple components of the same type
+     * exist on a page (e.g. two DataTables), each registers commands with a
+     * unique instance id. Only the *focused* instance's commands are dispatched.
+     */
+    instance?: string;
+}
+export declare function isMac(): boolean;
+/**
+ * Get the display symbol for a modifier or special key.
+ */
+export declare function getKeySymbol(key: string): string;
+/**
+ * Convert a KeyBinding into an ordered array of display symbols.
+ * Order: Ctrl → Alt → Shift → Meta → Key (Mac: ⌃ ⌥ ⇧ ⌘ Key)
+ */
+export declare function keybindingToSymbols(kb: KeyBinding): string[];
+/**
+ * Human-readable string representation of a keybinding.
+ * e.g. "⌘⇧P" on Mac, "Ctrl+Shift+P" on Windows
+ */
+export declare function keybindingToString(kb: KeyBinding): string;
+/**
+ * Check if a keyboard event matches a KeyBinding definition.
+ */
+export declare function matchesKeybinding(event: KeyboardEvent, kb: KeyBinding): boolean;
+/**
+ * Parse a human-readable string like "Ctrl+Shift+P" or "⌘⇧P" into a KeyBinding.
+ * Accepts both Mac symbol and Windows-style notation.
+ */
+export declare function parseKeybinding(str: string): KeyBinding;
+export declare function keybindingsEqual(a: KeyBinding, b: KeyBinding): boolean;
+/**
+ * Capture the current keyboard state from an event as a KeyBinding.
+ * Useful for the "recording mode" in shortcut settings.
+ */
+export declare function keybindingFromEvent(event: KeyboardEvent): KeyBinding | null;
+/**
+ * Comprehensive list of Chrome browser shortcuts that web pages cannot
+ * reliably override. Sourced from:
+ * https://support.google.com/chrome/answer/157179
+ *
+ * Stored as normalised strings: modifiers in order meta/alt/shift + key.
+ * `meta` means ⌘ on Mac and Ctrl on Windows/Linux.
+ */
+export interface BrowserShortcutInfo {
+    /** Normalised shortcut string (used for matching) */
+    shortcut: string;
+    /** Human-readable description */
+    label: string;
+    /** Category grouping */
+    category: 'Tab & Window' | 'Chrome Features' | 'Address Bar' | 'Webpage' | 'System';
+}
+export declare const BROWSER_SHORTCUTS: BrowserShortcutInfo[];
+export declare function isReservedShortcut(kb: KeyBinding): boolean;
+/**
+ * Get browser shortcut info for a given keybinding (if it's reserved).
+ * Returns the label and category to show in the settings panel.
+ */
+export declare function getBrowserShortcutInfo(kb: KeyBinding): BrowserShortcutInfo | undefined;
+export interface FuzzyResult<T> {
+    item: T;
+    score: number;
+    matches: [number, number][];
+}
+/**
+ * Lightweight fuzzy search scorer.
+ * Scores based on: consecutive character matches, word-start bonus,
+ * exact prefix bonus, and case-sensitive bonus.
+ */
+export declare function fuzzyScore(query: string, text: string): {
+    score: number;
+    matches: [number, number][];
+} | null;
+/**
+ * Filter and rank an array of items by a fuzzy query.
+ */
+export declare function fuzzyFilter<T>(items: T[], query: string, getText: (item: T) => string): FuzzyResult<T>[];
+export declare function scopePriority(scope: ShortcutScope): number;
+export interface SerializedOverride {
+    commandId: string;
+    keybinding: KeyBinding;
+}
+export declare function serialiseOverrides(overrides: Map<string, KeyBinding>): string;
+export declare function deserialiseOverrides(json: string): Map<string, KeyBinding>;

package/dist/components/ui/command-palette/utils.js

@@ -0,0 +1,248 @@
+let f = null;
+function u() {
+  return f !== null ? f : typeof navigator > "u" ? !1 : (f = /mac|ipod|iphone|ipad/i.test(navigator.platform ?? navigator.userAgent ?? ""), f);
+}
+const d = {
+  meta: "⌘",
+  ctrl: "⌃",
+  alt: "⌥",
+  shift: "⇧",
+  enter: "↵",
+  backspace: "⌫",
+  delete: "⌦",
+  escape: "Esc",
+  arrowup: "↑",
+  arrowdown: "↓",
+  arrowleft: "←",
+  arrowright: "→",
+  tab: "⇥",
+  space: "␣"
+}, w = {
+  meta: "Ctrl",
+  ctrl: "Ctrl",
+  alt: "Alt",
+  shift: "Shift",
+  enter: "Enter",
+  backspace: "Backspace",
+  delete: "Delete",
+  escape: "Esc",
+  arrowup: "↑",
+  arrowdown: "↓",
+  arrowleft: "←",
+  arrowright: "→",
+  tab: "Tab",
+  space: "Space"
+};
+function i(t) {
+  return (u() ? d : w)[t.toLowerCase()] ?? t.toUpperCase();
+}
+function C(t) {
+  const e = [];
+  return u() ? (t.ctrl && e.push(i("ctrl")), t.alt && e.push(i("alt")), t.shift && e.push(i("shift")), t.meta && e.push(i("meta"))) : ((t.meta || t.ctrl) && e.push(i("ctrl")), t.alt && e.push(i("alt")), t.shift && e.push(i("shift"))), e.push(i(t.key)), e;
+}
+function W(t) {
+  const e = C(t);
+  return u() ? e.join("") : e.join("+");
+}
+function O(t, e) {
+  if (!(t.key.toLowerCase() === e.key.toLowerCase())) return !1;
+  const o = !!e.meta, a = !!e.ctrl, s = !!e.alt, c = !!e.shift;
+  if (u())
+    return t.metaKey === o && t.ctrlKey === a && t.altKey === s && t.shiftKey === c;
+  const h = o || a;
+  return t.ctrlKey === h && t.altKey === s && t.shiftKey === c && !t.metaKey;
+}
+function k(t) {
+  const e = { key: "" }, r = t.includes("+") ? t.split("+").map((o) => o.trim()) : S(t);
+  for (const o of r) {
+    const a = o.toLowerCase();
+    a === "⌘" || a === "meta" || a === "cmd" || a === "command" ? e.meta = !0 : a === "⌃" || a === "ctrl" || a === "control" ? e.ctrl = !0 : a === "⌥" || a === "alt" || a === "option" ? e.alt = !0 : a === "⇧" || a === "shift" ? e.shift = !0 : e.key = o;
+  }
+  return e;
+}
+function S(t) {
+  const e = ["⌘", "⌃", "⌥", "⇧"], r = [];
+  let o = t;
+  for (const a of e)
+    o.includes(a) && (r.push(a), o = o.replace(a, ""));
+  return o.trim() && r.push(o.trim()), r;
+}
+function K(t, e) {
+  return t.key.toLowerCase() === e.key.toLowerCase() && !!t.meta == !!e.meta && !!t.ctrl == !!e.ctrl && !!t.alt == !!e.alt && !!t.shift == !!e.shift;
+}
+function R(t) {
+  return (/* @__PURE__ */ new Set([
+    "Control",
+    "Shift",
+    "Alt",
+    "Meta",
+    "CapsLock",
+    "NumLock",
+    "ScrollLock"
+  ])).has(t.key) ? null : {
+    key: t.key,
+    meta: u() ? t.metaKey : !1,
+    ctrl: u() ? t.ctrlKey : t.ctrlKey || t.metaKey,
+    alt: t.altKey,
+    shift: t.shiftKey
+  };
+}
+const b = [
+  // ─── Tab & Window Shortcuts ────────────────────────────────────────────
+  { shortcut: "meta+n", label: "New window", category: "Tab & Window" },
+  { shortcut: "meta+shift+n", label: "New incognito window", category: "Tab & Window" },
+  { shortcut: "meta+t", label: "New tab", category: "Tab & Window" },
+  { shortcut: "meta+w", label: "Close current tab", category: "Tab & Window" },
+  { shortcut: "meta+shift+w", label: "Close current window", category: "Tab & Window" },
+  { shortcut: "meta+shift+t", label: "Reopen last closed tab", category: "Tab & Window" },
+  { shortcut: "meta+1", label: "Switch to tab 1", category: "Tab & Window" },
+  { shortcut: "meta+2", label: "Switch to tab 2", category: "Tab & Window" },
+  { shortcut: "meta+3", label: "Switch to tab 3", category: "Tab & Window" },
+  { shortcut: "meta+4", label: "Switch to tab 4", category: "Tab & Window" },
+  { shortcut: "meta+5", label: "Switch to tab 5", category: "Tab & Window" },
+  { shortcut: "meta+6", label: "Switch to tab 6", category: "Tab & Window" },
+  { shortcut: "meta+7", label: "Switch to tab 7", category: "Tab & Window" },
+  { shortcut: "meta+8", label: "Switch to tab 8", category: "Tab & Window" },
+  { shortcut: "meta+9", label: "Switch to last tab", category: "Tab & Window" },
+  { shortcut: "meta+shift+a", label: "Search open tabs", category: "Tab & Window" },
+  { shortcut: "meta+m", label: "Minimise window", category: "Tab & Window" },
+  { shortcut: "meta+q", label: "Quit Chrome", category: "Tab & Window" },
+  // ─── Google Chrome Feature Shortcuts ───────────────────────────────────
+  { shortcut: "meta+shift+b", label: "Show/hide bookmarks bar", category: "Chrome Features" },
+  { shortcut: "meta+alt+b", label: "Open Bookmarks Manager", category: "Chrome Features" },
+  { shortcut: "meta+,", label: "Open Chrome Settings", category: "Chrome Features" },
+  { shortcut: "meta+shift+delete", label: "Open Clear Browsing Data", category: "Chrome Features" },
+  { shortcut: "meta+d", label: "Bookmark current page", category: "Chrome Features" },
+  { shortcut: "meta+shift+d", label: "Bookmark all open tabs", category: "Chrome Features" },
+  { shortcut: "meta+f", label: "Find on page", category: "Chrome Features" },
+  { shortcut: "meta+g", label: "Find next", category: "Chrome Features" },
+  { shortcut: "meta+shift+g", label: "Find previous", category: "Chrome Features" },
+  { shortcut: "meta+h", label: "Hide Chrome", category: "Chrome Features" },
+  { shortcut: "meta+y", label: "Open History", category: "Chrome Features" },
+  { shortcut: "meta+j", label: "Open Downloads", category: "Chrome Features" },
+  { shortcut: "meta+shift+j", label: "Open DevTools (Console)", category: "Chrome Features" },
+  { shortcut: "meta+l", label: "Focus address bar", category: "Chrome Features" },
+  { shortcut: "meta+shift+m", label: "Switch Chrome profile", category: "Chrome Features" },
+  { shortcut: "meta+o", label: "Open file", category: "Chrome Features" },
+  { shortcut: "meta+p", label: "Print", category: "Chrome Features" },
+  { shortcut: "meta+r", label: "Reload page", category: "Chrome Features" },
+  { shortcut: "meta+shift+r", label: "Hard reload (skip cache)", category: "Chrome Features" },
+  { shortcut: "meta+s", label: "Save page as", category: "Chrome Features" },
+  { shortcut: "meta+shift+i", label: "Open DevTools", category: "Chrome Features" },
+  { shortcut: "meta+alt+i", label: "Open DevTools (Elements)", category: "Chrome Features" },
+  { shortcut: "meta+alt+j", label: "Open DevTools (Console)", category: "Chrome Features" },
+  { shortcut: "meta+shift+c", label: "Open DevTools (Inspect)", category: "Chrome Features" },
+  { shortcut: "meta+alt+u", label: "View page source", category: "Chrome Features" },
+  { shortcut: "meta+u", label: "View page source", category: "Chrome Features" },
+  // ─── Address Bar Shortcuts ─────────────────────────────────────────────
+  { shortcut: "meta+e", label: "Search from address bar", category: "Address Bar" },
+  // ─── Webpage Shortcuts ─────────────────────────────────────────────────
+  { shortcut: "meta+z", label: "Undo", category: "Webpage" },
+  { shortcut: "meta+shift+z", label: "Redo", category: "Webpage" },
+  { shortcut: "meta+x", label: "Cut", category: "Webpage" },
+  { shortcut: "meta+c", label: "Copy", category: "Webpage" },
+  { shortcut: "meta+v", label: "Paste", category: "Webpage" },
+  { shortcut: "meta+a", label: "Select all", category: "Webpage" },
+  { shortcut: "meta+shift+v", label: "Paste without formatting", category: "Webpage" },
+  { shortcut: "meta+plus", label: "Zoom in", category: "Webpage" },
+  { shortcut: "meta+-", label: "Zoom out", category: "Webpage" },
+  { shortcut: "meta+=", label: "Zoom in", category: "Webpage" },
+  { shortcut: "meta+0", label: "Reset zoom", category: "Webpage" },
+  // ─── System / Function Keys ────────────────────────────────────────────
+  { shortcut: "f1", label: "Open Help", category: "System" },
+  { shortcut: "f3", label: "Find on page", category: "System" },
+  { shortcut: "f5", label: "Reload page", category: "System" },
+  { shortcut: "f6", label: "Focus address bar / panels", category: "System" },
+  { shortcut: "f7", label: "Toggle caret browsing", category: "System" },
+  { shortcut: "f11", label: "Toggle fullscreen", category: "System" },
+  { shortcut: "f12", label: "Open DevTools", category: "System" },
+  { shortcut: "meta+f5", label: "Hard reload", category: "System" },
+  { shortcut: "ctrl+f5", label: "Hard reload (Windows)", category: "System" },
+  { shortcut: "ctrl+r", label: "Reload (Windows)", category: "System" },
+  { shortcut: "ctrl+shift+i", label: "DevTools (Windows)", category: "System" },
+  { shortcut: "ctrl+shift+j", label: "DevTools Console (Windows)", category: "System" }
+], g = new Set(
+  b.map((t) => t.shortcut)
+);
+function p(t) {
+  const e = [];
+  return (t.meta || t.ctrl) && e.push("meta"), t.alt && e.push("alt"), t.shift && e.push("shift"), e.push(t.key.toLowerCase()), e.join("+");
+}
+function L(t) {
+  const e = p(t);
+  return g.has(e) || g.has(e.replace("meta+", "ctrl+"));
+}
+function M(t) {
+  const e = p(t);
+  return b.find(
+    (r) => r.shortcut === e || r.shortcut === e.replace("meta+", "ctrl+")
+  );
+}
+function T(t, e) {
+  if (!t) return { score: 0, matches: [] };
+  const r = t.toLowerCase(), o = e.toLowerCase();
+  let a = 0;
+  for (const l of r) {
+    const m = o.indexOf(l, a);
+    if (m === -1) return null;
+    a = m + 1;
+  }
+  let s = 0, c = 0, h = 0;
+  const y = [];
+  let n = -1;
+  for (let l = 0; l < e.length && c < r.length; l++)
+    o[l] === r[c] ? (s += 1, h++, h > 1 && (s += h), (l === 0 || /[\s\-_./:]/.test(e[l - 1])) && (s += 5), e[l] === t[c] && (s += 0.5), n === -1 && (n = l), c++) : (n !== -1 && (y.push([n, l - 1]), n = -1), h = 0);
+  return n !== -1 && y.push([n, n + (c - y.reduce((l, m) => l + (m[1] - m[0] + 1), 0)) - 1]), c < r.length ? null : (o.startsWith(r) && (s += 10), s += Math.max(0, 5 - (e.length - t.length) * 0.1), { score: s, matches: y });
+}
+function D(t, e, r) {
+  if (!e.trim()) return t.map((a) => ({ item: a, score: 0, matches: [] }));
+  const o = [];
+  for (const a of t) {
+    const s = r(a), c = T(e, s);
+    c && o.push({ item: a, score: c.score, matches: c.matches });
+  }
+  return o.sort((a, s) => s.score - a.score), o;
+}
+const F = {
+  global: 0,
+  module: 1,
+  page: 2,
+  modal: 3
+};
+function E(t) {
+  return F[t];
+}
+function B(t) {
+  const e = [];
+  return t.forEach((r, o) => {
+    e.push({ commandId: o, keybinding: r });
+  }), JSON.stringify(e);
+}
+function x(t) {
+  const e = /* @__PURE__ */ new Map();
+  try {
+    const r = JSON.parse(t);
+    for (const o of r)
+      e.set(o.commandId, o.keybinding);
+  } catch {
+  }
+  return e;
+}
+export {
+  b as BROWSER_SHORTCUTS,
+  x as deserialiseOverrides,
+  D as fuzzyFilter,
+  T as fuzzyScore,
+  M as getBrowserShortcutInfo,
+  i as getKeySymbol,
+  u as isMac,
+  L as isReservedShortcut,
+  R as keybindingFromEvent,
+  W as keybindingToString,
+  C as keybindingToSymbols,
+  K as keybindingsEqual,
+  O as matchesKeybinding,
+  k as parseKeybinding,
+  E as scopePriority,
+  B as serialiseOverrides
+};