@parto-system-design/ui 1.1.9 → 1.1.16

package/dist/hooks/use-hotkeys.cjs

@@ -1,16 +1,151 @@
+'use client';
 'use strict';
 
-var chunkU5FLLCGC_cjs = require('../chunk-U5FLLCGC.cjs');
+var React = require('react');
 
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
 
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
-Object.defineProperty(exports, "formatHotkey", {
-  enumerable: true,
-  get: function () { return chunkU5FLLCGC_cjs.formatHotkey; }
-});
-Object.defineProperty(exports, "useHotkeys", {
-  enumerable: true,
-  get: function () { return chunkU5FLLCGC_cjs.useHotkeys; }
-});
+function isMac() {
+  if (typeof navigator === "undefined") return false;
+  const ua = navigator.userAgentData?.platform;
+  const platform = ua ?? navigator.platform ?? "";
+  return /mac|darwin/i.test(platform);
+}
+var SPECIAL_KEY_MAP = {
+  " ": "space",
+  spacebar: "space",
+  esc: "escape",
+  del: "delete",
+  return: "enter",
+  arrowup: "up",
+  arrowdown: "down",
+  arrowleft: "left",
+  arrowright: "right"
+};
+function normalizeKey(raw) {
+  const lower = raw.toLowerCase();
+  return SPECIAL_KEY_MAP[lower] ?? lower;
+}
+function parseCombo(combo) {
+  const parts = combo.toLowerCase().split("+").map((s) => s.trim()).filter(Boolean);
+  const result = {
+    mod: false,
+    ctrl: false,
+    cmd: false,
+    shift: false,
+    alt: false,
+    meta: false,
+    key: ""
+  };
+  for (const p of parts) {
+    if (p === "mod") result.mod = true;
+    else if (p === "ctrl" || p === "control") result.ctrl = true;
+    else if (p === "cmd" || p === "command" || p === "win") result.cmd = true;
+    else if (p === "shift") result.shift = true;
+    else if (p === "alt" || p === "option" || p === "opt") result.alt = true;
+    else if (p === "meta") result.meta = true;
+    else result.key = normalizeKey(p);
+  }
+  return result;
+}
+function matches(parsed, event, mac) {
+  const requiredCmd = parsed.cmd || parsed.mod && mac;
+  const requiredCtrl = parsed.ctrl || parsed.mod && !mac;
+  if (requiredCmd !== event.metaKey) return false;
+  if (requiredCtrl !== event.ctrlKey) return false;
+  if (parsed.shift !== event.shiftKey) return false;
+  if (parsed.alt !== event.altKey) return false;
+  if (parsed.meta && !mac && !event.metaKey) return false;
+  if (!parsed.key) return true;
+  const eventKey = normalizeKey(event.key);
+  return eventKey === parsed.key;
+}
+function isEditable(el) {
+  if (!(el instanceof HTMLElement)) return false;
+  if (el.isContentEditable) return true;
+  const tag = el.tagName;
+  if (tag === "INPUT") {
+    const type = el.type;
+    return !["button", "submit", "reset", "checkbox", "radio", "range", "color", "file"].includes(type);
+  }
+  return tag === "TEXTAREA" || tag === "SELECT";
+}
+function hasModifier(event) {
+  return event.metaKey || event.ctrlKey || event.altKey;
+}
+function resolveTarget(target) {
+  if (!target) return typeof document !== "undefined" ? document : null;
+  if (target instanceof Document) return target;
+  if ("current" in target) return target.current ?? null;
+  return target;
+}
+function useHotkeys(combo, handler, options = {}) {
+  const { preventDefault = true, ignoreWhenTyping = true, enabled = true, target } = options;
+  const handlerRef = React__namespace.useRef(handler);
+  React__namespace.useEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+  React__namespace.useEffect(() => {
+    if (!enabled) return;
+    const resolvedTarget = resolveTarget(target);
+    if (!resolvedTarget) return;
+    const combos = (Array.isArray(combo) ? combo : [combo]).map(parseCombo);
+    const mac = isMac();
+    const listener = (event) => {
+      const keyboardEvent = event;
+      const matched = combos.find((parsed) => matches(parsed, keyboardEvent, mac));
+      if (!matched) return;
+      if (ignoreWhenTyping && isEditable(keyboardEvent.target) && !hasModifier(keyboardEvent)) {
+        return;
+      }
+      if (preventDefault) keyboardEvent.preventDefault();
+      handlerRef.current(keyboardEvent);
+    };
+    resolvedTarget.addEventListener("keydown", listener);
+    return () => {
+      resolvedTarget.removeEventListener("keydown", listener);
+    };
+  }, [Array.isArray(combo) ? combo.join("|") : combo, enabled, ignoreWhenTyping, preventDefault, target]);
+}
+function formatHotkey(combo) {
+  const mac = isMac();
+  return combo.split("+").map((p) => {
+    const t = p.trim().toLowerCase();
+    if (t === "mod") return mac ? "\u2318" : "Ctrl";
+    if (t === "cmd" || t === "meta") return mac ? "\u2318" : "Win";
+    if (t === "ctrl" || t === "control") return mac ? "\u2303" : "Ctrl";
+    if (t === "shift") return mac ? "\u21E7" : "Shift";
+    if (t === "alt" || t === "option" || t === "opt") return mac ? "\u2325" : "Alt";
+    if (t === "enter" || t === "return") return "\u21B5";
+    if (t === "escape" || t === "esc") return "Esc";
+    if (t === "space") return "Space";
+    if (t === "up") return "\u2191";
+    if (t === "down") return "\u2193";
+    if (t === "left") return "\u2190";
+    if (t === "right") return "\u2192";
+    return t.length === 1 ? t.toUpperCase() : t;
+  }).join(mac ? "" : "+");
+}
+
+exports.formatHotkey = formatHotkey;
+exports.useHotkeys = useHotkeys;
 //# sourceMappingURL=use-hotkeys.cjs.map
 //# sourceMappingURL=use-hotkeys.cjs.map

package/dist/hooks/use-hotkeys.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"use-hotkeys.cjs"}
+{"version":3,"sources":["../../src/hooks/use-hotkeys.ts"],"names":["React"],"mappings":"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","file":"use-hotkeys.cjs","sourcesContent":["'use client'\n\nimport * as React from 'react'\n\n/**\n * Hotkey string grammar:\n *\n *   <part>[+<part>]*\n *\n * where each <part> is one of:\n *   mod           — Cmd on macOS, Ctrl on everything else (recommended)\n *   ctrl / cmd    — explicit, cross-platform tokens\n *   shift | alt | meta\n *   <single key>  — lowercase character, 'space', 'enter', 'escape', 'tab',\n *                   arrow{up,down,left,right}, 'slash', 'backspace', etc.\n *\n * Examples:\n *   'mod+k'          — ⌘K on macOS, CtrlK elsewhere\n *   'mod+shift+p'\n *   'escape'\n *   'ctrl+k'         — explicit Ctrl (no Cmd fallback on macOS)\n *\n * Passing an array of strings is treated as an OR — any combo fires the handler.\n */\nexport type HotkeyCombo = string | readonly string[]\n\nexport interface UseHotkeysOptions {\n  /**\n   * When true, `event.preventDefault()` is called on matched combos.\n   * Default: true. Useful to allow the browser's native 'mod+k' (address bar)\n   * to keep working — set to false if the handler only does something conditionally.\n   */\n  preventDefault?: boolean\n  /**\n   * Skip the handler when focus is inside an editable control (input, textarea,\n   * contenteditable). The exception: combos that include a modifier (mod/ctrl/\n   * cmd/alt) still fire — they are unambiguous shortcuts, not typing.\n   * Default: true.\n   */\n  ignoreWhenTyping?: boolean\n  /**\n   * When false, the hook unregisters its listener. Useful for conditionally\n   * enabling shortcuts (e.g., only while a panel is open).\n   * Default: true.\n   */\n  enabled?: boolean\n  /**\n   * DOM target. Defaults to `document`. Pass a ref for scoped shortcuts (e.g.,\n   * only when a specific panel has focus within).\n   */\n  target?: React.RefObject<HTMLElement | null> | HTMLElement | Document | null\n}\n\nfunction isMac(): boolean {\n  if (typeof navigator === 'undefined') return false\n  // `userAgentData.platform` is the modern API; fall back to platform string.\n  // Accept 'darwin' (nodejs tests) and 'MacIntel'/'Mac OS X'.\n  const ua = (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform\n  const platform = ua ?? navigator.platform ?? ''\n  return /mac|darwin/i.test(platform)\n}\n\nconst SPECIAL_KEY_MAP: Record<string, string> = {\n  ' ': 'space',\n  spacebar: 'space',\n  esc: 'escape',\n  del: 'delete',\n  return: 'enter',\n  arrowup: 'up',\n  arrowdown: 'down',\n  arrowleft: 'left',\n  arrowright: 'right',\n}\n\nfunction normalizeKey(raw: string): string {\n  const lower = raw.toLowerCase()\n  return SPECIAL_KEY_MAP[lower] ?? lower\n}\n\ntype ParsedCombo = {\n  mod: boolean\n  ctrl: boolean\n  cmd: boolean\n  shift: boolean\n  alt: boolean\n  meta: boolean\n  key: string\n}\n\nfunction parseCombo(combo: string): ParsedCombo {\n  const parts = combo\n    .toLowerCase()\n    .split('+')\n    .map((s) => s.trim())\n    .filter(Boolean)\n  const result: ParsedCombo = {\n    mod: false,\n    ctrl: false,\n    cmd: false,\n    shift: false,\n    alt: false,\n    meta: false,\n    key: '',\n  }\n  for (const p of parts) {\n    if (p === 'mod') result.mod = true\n    else if (p === 'ctrl' || p === 'control') result.ctrl = true\n    else if (p === 'cmd' || p === 'command' || p === 'win') result.cmd = true\n    else if (p === 'shift') result.shift = true\n    else if (p === 'alt' || p === 'option' || p === 'opt') result.alt = true\n    else if (p === 'meta') result.meta = true\n    else result.key = normalizeKey(p)\n  }\n  return result\n}\n\nfunction matches(parsed: ParsedCombo, event: KeyboardEvent, mac: boolean): boolean {\n  // `mod` resolves to Cmd on macOS, Ctrl elsewhere. Track both sides of the combo.\n  const requiredCmd = parsed.cmd || (parsed.mod && mac)\n  const requiredCtrl = parsed.ctrl || (parsed.mod && !mac)\n\n  if (requiredCmd !== event.metaKey) return false\n  if (requiredCtrl !== event.ctrlKey) return false\n  if (parsed.shift !== event.shiftKey) return false\n  if (parsed.alt !== event.altKey) return false\n  // `meta` (plain) aliases Cmd on macOS — avoid double-matching when both mod+meta are specified.\n  if (parsed.meta && !mac && !event.metaKey) return false\n\n  if (!parsed.key) return true\n  const eventKey = normalizeKey(event.key)\n  return eventKey === parsed.key\n}\n\nfunction isEditable(el: EventTarget | null): boolean {\n  if (!(el instanceof HTMLElement)) return false\n  if (el.isContentEditable) return true\n  const tag = el.tagName\n  if (tag === 'INPUT') {\n    const type = (el as HTMLInputElement).type\n    // Buttons and checkboxes aren't \"typing\" — don't block.\n    return !['button', 'submit', 'reset', 'checkbox', 'radio', 'range', 'color', 'file'].includes(type)\n  }\n  return tag === 'TEXTAREA' || tag === 'SELECT'\n}\n\nfunction hasModifier(event: KeyboardEvent): boolean {\n  return event.metaKey || event.ctrlKey || event.altKey\n}\n\nfunction resolveTarget(target: UseHotkeysOptions['target']): EventTarget | null {\n  if (!target) return typeof document !== 'undefined' ? document : null\n  if (target instanceof Document) return target\n  if ('current' in target) return target.current ?? null\n  return target\n}\n\n/**\n * Register a keyboard shortcut. Handler fires when the combo matches, respecting\n * `ignoreWhenTyping` (default true) — except when a modifier is part of the combo,\n * which always wins. Returns nothing; cleanup is automatic.\n *\n * @example\n * useHotkeys('mod+k', () => setOpen((v) => !v))\n * useHotkeys(['escape', 'mod+w'], close, { enabled: open })\n */\nexport function useHotkeys(\n  combo: HotkeyCombo,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeysOptions = {}\n): void {\n  const { preventDefault = true, ignoreWhenTyping = true, enabled = true, target } = options\n\n  // Keep latest handler in a ref so callers don't need to memoize.\n  const handlerRef = React.useRef(handler)\n  React.useEffect(() => {\n    handlerRef.current = handler\n  }, [handler])\n\n  React.useEffect(() => {\n    if (!enabled) return\n    const resolvedTarget = resolveTarget(target)\n    if (!resolvedTarget) return\n\n    const combos = (Array.isArray(combo) ? combo : [combo]).map(parseCombo)\n    const mac = isMac()\n\n    const listener = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent\n      const matched = combos.find((parsed) => matches(parsed, keyboardEvent, mac))\n      if (!matched) return\n\n      if (ignoreWhenTyping && isEditable(keyboardEvent.target) && !hasModifier(keyboardEvent)) {\n        return\n      }\n\n      if (preventDefault) keyboardEvent.preventDefault()\n      handlerRef.current(keyboardEvent)\n    }\n\n    resolvedTarget.addEventListener('keydown', listener)\n    return () => {\n      resolvedTarget.removeEventListener('keydown', listener)\n    }\n    // `combo` is usually a stable string literal; if callers pass a new array every\n    // render we join-stringify to avoid stale closures without surprising rerenders.\n  }, [Array.isArray(combo) ? combo.join('|') : combo, enabled, ignoreWhenTyping, preventDefault, target])\n}\n\n/**\n * Render-helper: returns a platform-appropriate display string for a combo.\n * 'mod+k' → '⌘K' on macOS, 'Ctrl+K' elsewhere. Useful for `<CommandShortcut>`.\n */\nexport function formatHotkey(combo: string): string {\n  const mac = isMac()\n  return combo\n    .split('+')\n    .map((p) => {\n      const t = p.trim().toLowerCase()\n      if (t === 'mod') return mac ? '⌘' : 'Ctrl'\n      if (t === 'cmd' || t === 'meta') return mac ? '⌘' : 'Win'\n      if (t === 'ctrl' || t === 'control') return mac ? '⌃' : 'Ctrl'\n      if (t === 'shift') return mac ? '⇧' : 'Shift'\n      if (t === 'alt' || t === 'option' || t === 'opt') return mac ? '⌥' : 'Alt'\n      if (t === 'enter' || t === 'return') return '↵'\n      if (t === 'escape' || t === 'esc') return 'Esc'\n      if (t === 'space') return 'Space'\n      if (t === 'up') return '↑'\n      if (t === 'down') return '↓'\n      if (t === 'left') return '←'\n      if (t === 'right') return '→'\n      return t.length === 1 ? t.toUpperCase() : t\n    })\n    .join(mac ? '' : '+')\n}\n"]}

package/dist/hooks/use-hotkeys.js

@@ -1,3 +1,128 @@
-export { formatHotkey, useHotkeys } from '../chunk-RZNRIOLT.js';
+'use client';
+import * as React from 'react';
+
+function isMac() {
+  if (typeof navigator === "undefined") return false;
+  const ua = navigator.userAgentData?.platform;
+  const platform = ua ?? navigator.platform ?? "";
+  return /mac|darwin/i.test(platform);
+}
+var SPECIAL_KEY_MAP = {
+  " ": "space",
+  spacebar: "space",
+  esc: "escape",
+  del: "delete",
+  return: "enter",
+  arrowup: "up",
+  arrowdown: "down",
+  arrowleft: "left",
+  arrowright: "right"
+};
+function normalizeKey(raw) {
+  const lower = raw.toLowerCase();
+  return SPECIAL_KEY_MAP[lower] ?? lower;
+}
+function parseCombo(combo) {
+  const parts = combo.toLowerCase().split("+").map((s) => s.trim()).filter(Boolean);
+  const result = {
+    mod: false,
+    ctrl: false,
+    cmd: false,
+    shift: false,
+    alt: false,
+    meta: false,
+    key: ""
+  };
+  for (const p of parts) {
+    if (p === "mod") result.mod = true;
+    else if (p === "ctrl" || p === "control") result.ctrl = true;
+    else if (p === "cmd" || p === "command" || p === "win") result.cmd = true;
+    else if (p === "shift") result.shift = true;
+    else if (p === "alt" || p === "option" || p === "opt") result.alt = true;
+    else if (p === "meta") result.meta = true;
+    else result.key = normalizeKey(p);
+  }
+  return result;
+}
+function matches(parsed, event, mac) {
+  const requiredCmd = parsed.cmd || parsed.mod && mac;
+  const requiredCtrl = parsed.ctrl || parsed.mod && !mac;
+  if (requiredCmd !== event.metaKey) return false;
+  if (requiredCtrl !== event.ctrlKey) return false;
+  if (parsed.shift !== event.shiftKey) return false;
+  if (parsed.alt !== event.altKey) return false;
+  if (parsed.meta && !mac && !event.metaKey) return false;
+  if (!parsed.key) return true;
+  const eventKey = normalizeKey(event.key);
+  return eventKey === parsed.key;
+}
+function isEditable(el) {
+  if (!(el instanceof HTMLElement)) return false;
+  if (el.isContentEditable) return true;
+  const tag = el.tagName;
+  if (tag === "INPUT") {
+    const type = el.type;
+    return !["button", "submit", "reset", "checkbox", "radio", "range", "color", "file"].includes(type);
+  }
+  return tag === "TEXTAREA" || tag === "SELECT";
+}
+function hasModifier(event) {
+  return event.metaKey || event.ctrlKey || event.altKey;
+}
+function resolveTarget(target) {
+  if (!target) return typeof document !== "undefined" ? document : null;
+  if (target instanceof Document) return target;
+  if ("current" in target) return target.current ?? null;
+  return target;
+}
+function useHotkeys(combo, handler, options = {}) {
+  const { preventDefault = true, ignoreWhenTyping = true, enabled = true, target } = options;
+  const handlerRef = React.useRef(handler);
+  React.useEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+  React.useEffect(() => {
+    if (!enabled) return;
+    const resolvedTarget = resolveTarget(target);
+    if (!resolvedTarget) return;
+    const combos = (Array.isArray(combo) ? combo : [combo]).map(parseCombo);
+    const mac = isMac();
+    const listener = (event) => {
+      const keyboardEvent = event;
+      const matched = combos.find((parsed) => matches(parsed, keyboardEvent, mac));
+      if (!matched) return;
+      if (ignoreWhenTyping && isEditable(keyboardEvent.target) && !hasModifier(keyboardEvent)) {
+        return;
+      }
+      if (preventDefault) keyboardEvent.preventDefault();
+      handlerRef.current(keyboardEvent);
+    };
+    resolvedTarget.addEventListener("keydown", listener);
+    return () => {
+      resolvedTarget.removeEventListener("keydown", listener);
+    };
+  }, [Array.isArray(combo) ? combo.join("|") : combo, enabled, ignoreWhenTyping, preventDefault, target]);
+}
+function formatHotkey(combo) {
+  const mac = isMac();
+  return combo.split("+").map((p) => {
+    const t = p.trim().toLowerCase();
+    if (t === "mod") return mac ? "\u2318" : "Ctrl";
+    if (t === "cmd" || t === "meta") return mac ? "\u2318" : "Win";
+    if (t === "ctrl" || t === "control") return mac ? "\u2303" : "Ctrl";
+    if (t === "shift") return mac ? "\u21E7" : "Shift";
+    if (t === "alt" || t === "option" || t === "opt") return mac ? "\u2325" : "Alt";
+    if (t === "enter" || t === "return") return "\u21B5";
+    if (t === "escape" || t === "esc") return "Esc";
+    if (t === "space") return "Space";
+    if (t === "up") return "\u2191";
+    if (t === "down") return "\u2193";
+    if (t === "left") return "\u2190";
+    if (t === "right") return "\u2192";
+    return t.length === 1 ? t.toUpperCase() : t;
+  }).join(mac ? "" : "+");
+}
+
+export { formatHotkey, useHotkeys };
 //# sourceMappingURL=use-hotkeys.js.map
 //# sourceMappingURL=use-hotkeys.js.map

package/dist/hooks/use-hotkeys.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"use-hotkeys.js"}
+{"version":3,"sources":["../../src/hooks/use-hotkeys.ts"],"names":[],"mappings":"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","file":"use-hotkeys.js","sourcesContent":["'use client'\n\nimport * as React from 'react'\n\n/**\n * Hotkey string grammar:\n *\n *   <part>[+<part>]*\n *\n * where each <part> is one of:\n *   mod           — Cmd on macOS, Ctrl on everything else (recommended)\n *   ctrl / cmd    — explicit, cross-platform tokens\n *   shift | alt | meta\n *   <single key>  — lowercase character, 'space', 'enter', 'escape', 'tab',\n *                   arrow{up,down,left,right}, 'slash', 'backspace', etc.\n *\n * Examples:\n *   'mod+k'          — ⌘K on macOS, CtrlK elsewhere\n *   'mod+shift+p'\n *   'escape'\n *   'ctrl+k'         — explicit Ctrl (no Cmd fallback on macOS)\n *\n * Passing an array of strings is treated as an OR — any combo fires the handler.\n */\nexport type HotkeyCombo = string | readonly string[]\n\nexport interface UseHotkeysOptions {\n  /**\n   * When true, `event.preventDefault()` is called on matched combos.\n   * Default: true. Useful to allow the browser's native 'mod+k' (address bar)\n   * to keep working — set to false if the handler only does something conditionally.\n   */\n  preventDefault?: boolean\n  /**\n   * Skip the handler when focus is inside an editable control (input, textarea,\n   * contenteditable). The exception: combos that include a modifier (mod/ctrl/\n   * cmd/alt) still fire — they are unambiguous shortcuts, not typing.\n   * Default: true.\n   */\n  ignoreWhenTyping?: boolean\n  /**\n   * When false, the hook unregisters its listener. Useful for conditionally\n   * enabling shortcuts (e.g., only while a panel is open).\n   * Default: true.\n   */\n  enabled?: boolean\n  /**\n   * DOM target. Defaults to `document`. Pass a ref for scoped shortcuts (e.g.,\n   * only when a specific panel has focus within).\n   */\n  target?: React.RefObject<HTMLElement | null> | HTMLElement | Document | null\n}\n\nfunction isMac(): boolean {\n  if (typeof navigator === 'undefined') return false\n  // `userAgentData.platform` is the modern API; fall back to platform string.\n  // Accept 'darwin' (nodejs tests) and 'MacIntel'/'Mac OS X'.\n  const ua = (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform\n  const platform = ua ?? navigator.platform ?? ''\n  return /mac|darwin/i.test(platform)\n}\n\nconst SPECIAL_KEY_MAP: Record<string, string> = {\n  ' ': 'space',\n  spacebar: 'space',\n  esc: 'escape',\n  del: 'delete',\n  return: 'enter',\n  arrowup: 'up',\n  arrowdown: 'down',\n  arrowleft: 'left',\n  arrowright: 'right',\n}\n\nfunction normalizeKey(raw: string): string {\n  const lower = raw.toLowerCase()\n  return SPECIAL_KEY_MAP[lower] ?? lower\n}\n\ntype ParsedCombo = {\n  mod: boolean\n  ctrl: boolean\n  cmd: boolean\n  shift: boolean\n  alt: boolean\n  meta: boolean\n  key: string\n}\n\nfunction parseCombo(combo: string): ParsedCombo {\n  const parts = combo\n    .toLowerCase()\n    .split('+')\n    .map((s) => s.trim())\n    .filter(Boolean)\n  const result: ParsedCombo = {\n    mod: false,\n    ctrl: false,\n    cmd: false,\n    shift: false,\n    alt: false,\n    meta: false,\n    key: '',\n  }\n  for (const p of parts) {\n    if (p === 'mod') result.mod = true\n    else if (p === 'ctrl' || p === 'control') result.ctrl = true\n    else if (p === 'cmd' || p === 'command' || p === 'win') result.cmd = true\n    else if (p === 'shift') result.shift = true\n    else if (p === 'alt' || p === 'option' || p === 'opt') result.alt = true\n    else if (p === 'meta') result.meta = true\n    else result.key = normalizeKey(p)\n  }\n  return result\n}\n\nfunction matches(parsed: ParsedCombo, event: KeyboardEvent, mac: boolean): boolean {\n  // `mod` resolves to Cmd on macOS, Ctrl elsewhere. Track both sides of the combo.\n  const requiredCmd = parsed.cmd || (parsed.mod && mac)\n  const requiredCtrl = parsed.ctrl || (parsed.mod && !mac)\n\n  if (requiredCmd !== event.metaKey) return false\n  if (requiredCtrl !== event.ctrlKey) return false\n  if (parsed.shift !== event.shiftKey) return false\n  if (parsed.alt !== event.altKey) return false\n  // `meta` (plain) aliases Cmd on macOS — avoid double-matching when both mod+meta are specified.\n  if (parsed.meta && !mac && !event.metaKey) return false\n\n  if (!parsed.key) return true\n  const eventKey = normalizeKey(event.key)\n  return eventKey === parsed.key\n}\n\nfunction isEditable(el: EventTarget | null): boolean {\n  if (!(el instanceof HTMLElement)) return false\n  if (el.isContentEditable) return true\n  const tag = el.tagName\n  if (tag === 'INPUT') {\n    const type = (el as HTMLInputElement).type\n    // Buttons and checkboxes aren't \"typing\" — don't block.\n    return !['button', 'submit', 'reset', 'checkbox', 'radio', 'range', 'color', 'file'].includes(type)\n  }\n  return tag === 'TEXTAREA' || tag === 'SELECT'\n}\n\nfunction hasModifier(event: KeyboardEvent): boolean {\n  return event.metaKey || event.ctrlKey || event.altKey\n}\n\nfunction resolveTarget(target: UseHotkeysOptions['target']): EventTarget | null {\n  if (!target) return typeof document !== 'undefined' ? document : null\n  if (target instanceof Document) return target\n  if ('current' in target) return target.current ?? null\n  return target\n}\n\n/**\n * Register a keyboard shortcut. Handler fires when the combo matches, respecting\n * `ignoreWhenTyping` (default true) — except when a modifier is part of the combo,\n * which always wins. Returns nothing; cleanup is automatic.\n *\n * @example\n * useHotkeys('mod+k', () => setOpen((v) => !v))\n * useHotkeys(['escape', 'mod+w'], close, { enabled: open })\n */\nexport function useHotkeys(\n  combo: HotkeyCombo,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeysOptions = {}\n): void {\n  const { preventDefault = true, ignoreWhenTyping = true, enabled = true, target } = options\n\n  // Keep latest handler in a ref so callers don't need to memoize.\n  const handlerRef = React.useRef(handler)\n  React.useEffect(() => {\n    handlerRef.current = handler\n  }, [handler])\n\n  React.useEffect(() => {\n    if (!enabled) return\n    const resolvedTarget = resolveTarget(target)\n    if (!resolvedTarget) return\n\n    const combos = (Array.isArray(combo) ? combo : [combo]).map(parseCombo)\n    const mac = isMac()\n\n    const listener = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent\n      const matched = combos.find((parsed) => matches(parsed, keyboardEvent, mac))\n      if (!matched) return\n\n      if (ignoreWhenTyping && isEditable(keyboardEvent.target) && !hasModifier(keyboardEvent)) {\n        return\n      }\n\n      if (preventDefault) keyboardEvent.preventDefault()\n      handlerRef.current(keyboardEvent)\n    }\n\n    resolvedTarget.addEventListener('keydown', listener)\n    return () => {\n      resolvedTarget.removeEventListener('keydown', listener)\n    }\n    // `combo` is usually a stable string literal; if callers pass a new array every\n    // render we join-stringify to avoid stale closures without surprising rerenders.\n  }, [Array.isArray(combo) ? combo.join('|') : combo, enabled, ignoreWhenTyping, preventDefault, target])\n}\n\n/**\n * Render-helper: returns a platform-appropriate display string for a combo.\n * 'mod+k' → '⌘K' on macOS, 'Ctrl+K' elsewhere. Useful for `<CommandShortcut>`.\n */\nexport function formatHotkey(combo: string): string {\n  const mac = isMac()\n  return combo\n    .split('+')\n    .map((p) => {\n      const t = p.trim().toLowerCase()\n      if (t === 'mod') return mac ? '⌘' : 'Ctrl'\n      if (t === 'cmd' || t === 'meta') return mac ? '⌘' : 'Win'\n      if (t === 'ctrl' || t === 'control') return mac ? '⌃' : 'Ctrl'\n      if (t === 'shift') return mac ? '⇧' : 'Shift'\n      if (t === 'alt' || t === 'option' || t === 'opt') return mac ? '⌥' : 'Alt'\n      if (t === 'enter' || t === 'return') return '↵'\n      if (t === 'escape' || t === 'esc') return 'Esc'\n      if (t === 'space') return 'Space'\n      if (t === 'up') return '↑'\n      if (t === 'down') return '↓'\n      if (t === 'left') return '←'\n      if (t === 'right') return '→'\n      return t.length === 1 ? t.toUpperCase() : t\n    })\n    .join(mac ? '' : '+')\n}\n"]}

package/dist/{i18n-CAd9wGOr.d.cts → i18n-BfRhV5aw.d.cts}

@@ -39,9 +39,11 @@ declare const EMOTION_KEYS: readonly EmotionKey[];
 /** Emotion label translations used by EmotionBadge / EmotionDistribution. */
 declare const emotionLabels: Record<SupportedLocale, Record<EmotionKey, string>>;
 /**
- * Political flow keys — 5-class classification used in افکارسنجی clustering.
- * A concept / post / page belongs to exactly one flow (primary) but usually
- * also has secondary flow composition expressed as percentages.
+ * Stance keys — 5-class audience-stance classification used in clustering.
+ * A concept / post / page belongs to exactly one primary stance, but usually
+ * also has a secondary composition expressed as percentages. Keys are kept
+ * short and historical; display labels are framed as audience stance toward
+ * a tracked topic/brand (supporter ↔ detractor + undecided).
  */
 type FlowKey = 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey';
 declare const FLOW_KEYS: readonly FlowKey[];

package/dist/{i18n-ArS3mqj0.d.ts → i18n-ewyqbKM-.d.ts}

@@ -39,9 +39,11 @@ declare const EMOTION_KEYS: readonly EmotionKey[];
 /** Emotion label translations used by EmotionBadge / EmotionDistribution. */
 declare const emotionLabels: Record<SupportedLocale, Record<EmotionKey, string>>;
 /**
- * Political flow keys — 5-class classification used in افکارسنجی clustering.
- * A concept / post / page belongs to exactly one flow (primary) but usually
- * also has secondary flow composition expressed as percentages.
+ * Stance keys — 5-class audience-stance classification used in clustering.
+ * A concept / post / page belongs to exactly one primary stance, but usually
+ * also has a secondary composition expressed as percentages. Keys are kept
+ * short and historical; display labels are framed as audience stance toward
+ * a tracked topic/brand (supporter ↔ detractor + undecided).
  */
 type FlowKey = 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey';
 declare const FLOW_KEYS: readonly FlowKey[];