@parto-system-design/ui 1.1.11 → 1.1.17

package/dist/components/ui/tooltip.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"tooltip.js"}
+{"version":3,"sources":["../../../src/lib/utils.ts","../../../src/components/ui/tooltip.tsx"],"names":[],"mappings":";;;;;;AAIO,SAAS,MAAM,MAAA,EAAsB;AAC1C,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;ACCA,IAAM,eAAA,GAAmC,gBAAA,CAAA;AAEzC,IAAM,OAAA,GAA2B,gBAAA,CAAA;AAEjC,IAAM,cAAA,GAAkC,gBAAA,CAAA;AAexC,IAAM,cAAA,GAAuB,KAAA,CAAA,UAAA;AAAA,EAC3B,CAAC,EAAE,SAAA,EAAW,UAAU,SAAA,EAAW,IAAA,GAAO,MAAM,SAAA,GAAY,KAAA,EAAO,UAAA,GAAa,CAAA,EAAG,UAAU,GAAG,KAAA,IAAS,GAAA,qBACvG,GAAA,CAAkB,yBAAjB,EACC,QAAA,kBAAA,IAAA;AAAA,IAAkB,gBAAA,CAAA,OAAA;AAAA,IAAjB;AAAA,MACC,GAAA;AAAA,MACA,WAAA,EAAU,iBAAA;AAAA,MACV,UAAA;AAAA,MACA,SAAA,EAAW,EAAA;AAAA,QACT,iDAAA;AAAA,QACA,mLAAA;AAAA,QACA,gGAAA;AAAA;AAAA,QAEA,YAAY,SAAA,IAAa,uCAAA;AAAA,QACzB,YAAY,OAAA,IAAW,uDAAA;AAAA,QACvB,YAAY,OAAA,IAAW,uEAAA;AAAA;AAAA,QAEvB,SAAS,IAAA,IAAQ,qBAAA;AAAA,QACjB,SAAS,IAAA,IAAQ,mBAAA;AAAA,QACjB;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEH,QAAA,EAAA;AAAA,QAAA,QAAA;AAAA,QACA,SAAA,oBACC,GAAA;AAAA,UAAkB,gBAAA,CAAA,KAAA;AAAA,UAAjB;AAAA,YACC,SAAA,EAAW,EAAA;AAAA,cACT,cAAA;AAAA,cACA,YAAY,SAAA,IAAa,kBAAA;AAAA,cACzB,YAAY,OAAA,IAAW,kBAAA;AAAA,cACvB,YAAY,OAAA,IAAW;AAAA,aACzB;AAAA,YACA,KAAA,EAAO,CAAA;AAAA,YACP,MAAA,EAAQ;AAAA;AAAA;AACV;AAAA;AAAA,GAEJ,EACF;AAEJ;AACA,cAAA,CAAe,cAA+B,gBAAA,CAAA,OAAA,CAAQ,WAAA","file":"tooltip.js","sourcesContent":["import { type ClassValue, clsx } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\nimport { formatJalaliDate } from '@/lib/jalali-utils'\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n\nexport type SupportedLocale = 'fa' | 'ar' | 'en'\n\n/**\n * Convert digits in a string to Persian/Arabic numerals based on locale.\n * @example convertToLocalNumbers('123', 'fa') => '۱۲۳'\n * @example convertToLocalNumbers('123', 'en') => '123'\n */\nexport function convertToLocalNumbers(text: string | number, locale: SupportedLocale): string {\n  if (locale === 'fa' || locale === 'ar') {\n    const persianDigits = ['۰', '۱', '۲', '۳', '۴', '۵', '۶', '۷', '۸', '۹']\n    return String(text).replace(/\\d/g, (digit) => persianDigits[parseInt(digit)])\n  }\n  return String(text)\n}\n\n/**\n * Format large numbers with locale-aware suffixes (K/M/B).\n * @example formatLargeNumber(1500, 'fa') => '۱.۵ هزار'\n * @example formatLargeNumber(1500, 'en') => '1.5K'\n */\nexport function formatLargeNumber(num: number, locale: SupportedLocale): string {\n  if (num >= 1_000_000_000) {\n    const formatted = (num / 1_000_000_000).toFixed(1).replace(/\\.0$/, '')\n    return convertToLocalNumbers(formatted, locale) + (locale === 'en' ? 'B' : ' میلیارد')\n  }\n  if (num >= 1_000_000) {\n    const formatted = (num / 1_000_000).toFixed(1).replace(/\\.0$/, '')\n    return convertToLocalNumbers(formatted, locale) + (locale === 'en' ? 'M' : ' میلیون')\n  }\n  if (num >= 1_000) {\n    const formatted = (num / 1_000).toFixed(1).replace(/\\.0$/, '')\n    return convertToLocalNumbers(formatted, locale) + (locale === 'en' ? 'K' : ' هزار')\n  }\n  return convertToLocalNumbers(num.toString().replace(/\\B(?=(\\d{3})+(?!\\d))/g, ','), locale)\n}\n\n/**\n * Format number to Instagram-style short format (English only).\n * @example formatNumber(123456, 'short') => '123K'\n * @example formatNumber(123456, 'exact') => '123,456'\n */\nexport function formatNumber(num: number | undefined, format: 'exact' | 'short' = 'exact'): string {\n  if (num === undefined || num === null) return '0'\n\n  if (format === 'exact') {\n    return num.toLocaleString('en-US')\n  }\n\n  // Short format (Instagram style)\n  if (num >= 1_000_000_000) {\n    return `${(num / 1_000_000_000).toFixed(1).replace(/\\.0$/, '')}B`\n  }\n  if (num >= 1_000_000) {\n    return `${(num / 1_000_000).toFixed(1).replace(/\\.0$/, '')}M`\n  }\n  if (num >= 1_000) {\n    return `${(num / 1_000).toFixed(1).replace(/\\.0$/, '')}K`\n  }\n  return num.toString()\n}\n\n/**\n * Format date to relative time with absolute on hover (Persian)\n * @example formatRelativeTime(new Date()) => '۲ ساعت پیش'\n */\nexport function formatRelativeTime(date: Date | string | number): string {\n  const now = new Date()\n  const then = new Date(date)\n  const diffInSeconds = Math.floor((now.getTime() - then.getTime()) / 1000)\n\n  if (diffInSeconds < 60) {\n    return 'همین الان'\n  }\n\n  const diffInMinutes = Math.floor(diffInSeconds / 60)\n  if (diffInMinutes < 60) {\n    return `${convertToLocalNumbers(diffInMinutes, 'fa')} دقیقه پیش`\n  }\n\n  const diffInHours = Math.floor(diffInMinutes / 60)\n  if (diffInHours < 24) {\n    return `${convertToLocalNumbers(diffInHours, 'fa')} ساعت پیش`\n  }\n\n  const diffInDays = Math.floor(diffInHours / 24)\n  if (diffInDays < 7) {\n    return `${convertToLocalNumbers(diffInDays, 'fa')} روز پیش`\n  }\n\n  const diffInWeeks = Math.floor(diffInDays / 7)\n  if (diffInWeeks < 4) {\n    return `${convertToLocalNumbers(diffInWeeks, 'fa')} هفته پیش`\n  }\n\n  const diffInMonths = Math.floor(diffInDays / 30)\n  if (diffInMonths < 12) {\n    return `${convertToLocalNumbers(diffInMonths, 'fa')} ماه پیش`\n  }\n\n  const diffInYears = Math.floor(diffInDays / 365)\n  return `${convertToLocalNumbers(diffInYears, 'fa')} سال پیش`\n}\n\n/**\n * Format date to absolute format (Persian / Jalali)\n * Uses date-fns-jalali for accurate Jalali conversion.\n * @example formatAbsoluteTime(new Date()) => '۱۵ دی ۱۴۰۳، ۱۵:۳۰'\n */\nexport function formatAbsoluteTime(date: Date | string | number): string {\n  const d = new Date(date)\n  return formatJalaliDate(d, 'd MMMM yyyy، HH:mm')\n}\n","'use client'\n\nimport * as React from 'react'\nimport * as TooltipPrimitive from '@radix-ui/react-tooltip'\n\nimport { cn } from '@/lib/utils'\n\nconst TooltipProvider = TooltipPrimitive.Provider\n\nconst Tooltip = TooltipPrimitive.Root\n\nconst TooltipTrigger = TooltipPrimitive.Trigger\n\n/* -------------------------------------------------------------------------- */\n/*  TooltipContent                                                             */\n/* -------------------------------------------------------------------------- */\n\ninterface TooltipContentProps extends React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content> {\n  /** Visual variant */\n  variant?: 'default' | 'light' | 'error'\n  /** Size */\n  size?: 'sm' | 'md'\n  /** Show arrow/caret pointing to trigger */\n  showArrow?: boolean\n}\n\nconst TooltipContent = React.forwardRef<React.ElementRef<typeof TooltipPrimitive.Content>, TooltipContentProps>(\n  ({ className, variant = 'default', size = 'sm', showArrow = false, sideOffset = 4, children, ...props }, ref) => (\n    <TooltipPrimitive.Portal>\n      <TooltipPrimitive.Content\n        ref={ref}\n        data-slot=\"tooltip-content\"\n        sideOffset={sideOffset}\n        className={cn(\n          'z-50 overflow-hidden rounded-md shadow-dropdown',\n          'animate-in fade-in-50 data-[side=bottom]:slide-in-from-top-1 data-[side=left]:slide-in-from-right-1 data-[side=right]:slide-in-from-left-1 data-[side=top]:slide-in-from-bottom-1',\n          'data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n          // Variant styles\n          variant === 'default' && 'border bg-alternative text-foreground',\n          variant === 'light' && 'border bg-surface-100 text-foreground shadow-dropdown',\n          variant === 'error' && 'border border-destructive-500 bg-destructive-200 text-destructive-600',\n          // Size\n          size === 'sm' && 'px-3 py-1.5 text-xs',\n          size === 'md' && 'px-4 py-2 text-sm',\n          className\n        )}\n        {...props}\n      >\n        {children}\n        {showArrow && (\n          <TooltipPrimitive.Arrow\n            className={cn(\n              'fill-current',\n              variant === 'default' && 'text-alternative',\n              variant === 'light' && 'text-surface-100',\n              variant === 'error' && 'text-destructive-200'\n            )}\n            width={8}\n            height={4}\n          />\n        )}\n      </TooltipPrimitive.Content>\n    </TooltipPrimitive.Portal>\n  )\n)\nTooltipContent.displayName = TooltipPrimitive.Content.displayName\n\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }\n"]}

package/dist/{concept-card-RwPbqJ06.d.cts → concept-card-BXra9mr0.d.cts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { S as SupportedLocale } from './utils-DlXWmDZ-.cjs';
-import { F as FlowKey, c as StatusKey, d as SeverityKey } from './i18n-CAd9wGOr.cjs';
+import { F as FlowKey, c as StatusKey, d as SeverityKey } from './i18n-BfRhV5aw.cjs';
 
 type FlowData = Partial<Record<FlowKey, number>>;
 interface FlowDistributionProps extends React.HTMLAttributes<HTMLDivElement> {
@@ -49,7 +49,7 @@ declare const SentimentDistribution: React.ForwardRefExoticComponent<SentimentDi
  * to fit in a card grid with rich, comparable signals.
  */
 interface ConceptCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
-    /** Concept name (e.g., "افزایش قیمت بنزین") */
+    /** Concept name (e.g., "رونمایی گوشی جدید") */
     title: React.ReactNode;
     /** Short subtitle (e.g., "خوشه ۴ — ۱۲۰ پست") */
     subtitle?: React.ReactNode;

package/dist/{concept-card-CcOBb2Nz.d.ts → concept-card-BoJ5gIJD.d.ts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { S as SupportedLocale } from './utils-DlXWmDZ-.js';
-import { F as FlowKey, c as StatusKey, d as SeverityKey } from './i18n-ArS3mqj0.js';
+import { F as FlowKey, c as StatusKey, d as SeverityKey } from './i18n-ewyqbKM-.js';
 
 type FlowData = Partial<Record<FlowKey, number>>;
 interface FlowDistributionProps extends React.HTMLAttributes<HTMLDivElement> {
@@ -49,7 +49,7 @@ declare const SentimentDistribution: React.ForwardRefExoticComponent<SentimentDi
  * to fit in a card grid with rich, comparable signals.
  */
 interface ConceptCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
-    /** Concept name (e.g., "افزایش قیمت بنزین") */
+    /** Concept name (e.g., "رونمایی گوشی جدید") */
     title: React.ReactNode;
     /** Short subtitle (e.g., "خوشه ۴ — ۱۲۰ پست") */
     subtitle?: React.ReactNode;

package/dist/hooks/use-hotkey-registry.cjs

@@ -1,21 +1,208 @@
+'use client';
 'use strict';
 
-var chunkISCSZMYW_cjs = require('../chunk-ISCSZMYW.cjs');
-require('../chunk-U5FLLCGC.cjs');
+var React2 = require('react');
+var jsxRuntime = require('react/jsx-runtime');
 
+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 React2__namespace = /*#__PURE__*/_interopNamespace(React2);
 
-Object.defineProperty(exports, "HotkeyProvider", {
-  enumerable: true,
-  get: function () { return chunkISCSZMYW_cjs.HotkeyProvider; }
-});
-Object.defineProperty(exports, "useHotkey", {
-  enumerable: true,
-  get: function () { return chunkISCSZMYW_cjs.useHotkey; }
-});
-Object.defineProperty(exports, "useHotkeyRegistry", {
-  enumerable: true,
-  get: function () { return chunkISCSZMYW_cjs.useHotkeyRegistry; }
-});
+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 = React2__namespace.useRef(handler);
+  React2__namespace.useEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+  React2__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]);
+}
+var HotkeyRegisterContext = React2__namespace.createContext(null);
+var HotkeyListContext = React2__namespace.createContext([]);
+function HotkeyProvider({ enabled = true, children }) {
+  const [entries, setEntries] = React2__namespace.useState(() => /* @__PURE__ */ new Map());
+  const handlersRef = React2__namespace.useRef(/* @__PURE__ */ new Map());
+  const register = React2__namespace.useRef((entry, handler) => {
+    handlersRef.current.set(entry.id, handler);
+    setEntries((prev) => {
+      const next = new Map(prev);
+      next.set(entry.id, entry);
+      return next;
+    });
+    return () => {
+      handlersRef.current.delete(entry.id);
+      setEntries((prev) => {
+        if (!prev.has(entry.id)) return prev;
+        const next = new Map(prev);
+        next.delete(entry.id);
+        return next;
+      });
+    };
+  }).current;
+  const hotkeys = React2__namespace.useMemo(() => Array.from(entries.values()), [entries]);
+  return /* @__PURE__ */ jsxRuntime.jsx(HotkeyRegisterContext.Provider, { value: register, children: /* @__PURE__ */ jsxRuntime.jsxs(HotkeyListContext.Provider, { value: hotkeys, children: [
+    children,
+    enabled && /* @__PURE__ */ jsxRuntime.jsx(HotkeyDispatcher, { entries: hotkeys, handlersRef })
+  ] }) });
+}
+function HotkeyDispatcher({
+  entries,
+  handlersRef
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: entries.map((entry) => /* @__PURE__ */ jsxRuntime.jsx(HotkeyEntry, { entry, handlersRef }, entry.id)) });
+}
+function HotkeyEntry({
+  entry,
+  handlersRef
+}) {
+  useHotkeys(
+    entry.combo,
+    (event) => {
+      const handler = handlersRef.current.get(entry.id);
+      handler?.(event);
+    },
+    { enabled: entry.enabled !== false }
+  );
+  return null;
+}
+function useHotkey(id, combo, handler, options = {}) {
+  const register = React2__namespace.useContext(HotkeyRegisterContext);
+  const handlerRef = React2__namespace.useRef(handler);
+  React2__namespace.useEffect(() => {
+    handlerRef.current = handler;
+  });
+  const comboKey = Array.isArray(combo) ? combo.join("|") : combo;
+  React2__namespace.useEffect(() => {
+    if (!register) return;
+    if (!comboKey) return;
+    return register(
+      {
+        id,
+        combo,
+        description: options.description,
+        group: options.group,
+        enabled: options.enabled
+      },
+      (event) => handlerRef.current(event)
+    );
+  }, [register, id, comboKey, options.description, options.group, options.enabled]);
+}
+function useHotkeyRegistry() {
+  const hotkeys = React2__namespace.useContext(HotkeyListContext);
+  return { hotkeys };
+}
+
+exports.HotkeyProvider = HotkeyProvider;
+exports.useHotkey = useHotkey;
+exports.useHotkeyRegistry = useHotkeyRegistry;
 //# sourceMappingURL=use-hotkey-registry.cjs.map
 //# sourceMappingURL=use-hotkey-registry.cjs.map

package/dist/hooks/use-hotkey-registry.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"use-hotkey-registry.cjs"}
+{"version":3,"sources":["../../src/hooks/use-hotkeys.ts","../../src/hooks/use-hotkey-registry.tsx"],"names":["React","React2","jsx","jsxs","Fragment"],"mappings":"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","file":"use-hotkey-registry.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","'use client'\n\nimport * as React from 'react'\nimport { useHotkeys, type HotkeyCombo } from './use-hotkeys'\n\n/* -------------------------------------------------------------------------- */\n/* Types                                                                       */\n/* -------------------------------------------------------------------------- */\n\nexport interface RegisteredHotkey {\n  /** Stable id — used for de-registration + dedupe. */\n  id: string\n  /** The combo string(s) — `'mod+k'`, `['escape', 'mod+w']`, etc. */\n  combo: HotkeyCombo\n  /** Short human-readable description (e.g. \"باز کردن پالت دستور\"). */\n  description?: string\n  /** Optional grouping label for cheatsheet rendering (\"سراسری\", \"ناوبری\"…). */\n  group?: string\n  /** When false, the entry is listed but the listener doesn't fire. */\n  enabled?: boolean\n}\n\ntype RegisterFn = (entry: RegisteredHotkey, handler: (event: KeyboardEvent) => void) => () => void\n\n/**\n * Two contexts so consumers can depend on a *stable* register fn (never\n * changes for the provider's lifetime) without re-running their effect\n * every time the entries list updates.\n */\nconst HotkeyRegisterContext = React.createContext<RegisterFn | null>(null)\nconst HotkeyListContext = React.createContext<RegisteredHotkey[]>([])\n\n/* -------------------------------------------------------------------------- */\n/* Provider                                                                    */\n/* -------------------------------------------------------------------------- */\n\nexport interface HotkeyProviderProps {\n  /** Globally disable all registered hotkeys (e.g. while a modal owns the page). */\n  enabled?: boolean\n  children: React.ReactNode\n}\n\n/**\n * Centralised hotkey registry. Wrap your app once; descendants register\n * combos via `useHotkey()` and any UI (CommandPalette, help cheatsheet)\n * can read the full list via `useHotkeyRegistry()`.\n *\n * Compared to scattering `useHotkeys` calls across the tree:\n *   - Per-entry mounting is centralized (one place that handles\n *     `enabled`, key parsing, ignore-when-typing semantics)\n *   - Discoverable: cheatsheets / palettes can list every active combo\n *   - De-duplicated: registering the same id twice replaces the entry\n *\n * Optional. `useHotkeys` (the bare hook) continues to work outside a provider.\n */\nexport function HotkeyProvider({ enabled = true, children }: HotkeyProviderProps) {\n  const [entries, setEntries] = React.useState<Map<string, RegisteredHotkey>>(() => new Map())\n  const handlersRef = React.useRef<Map<string, (event: KeyboardEvent) => void>>(new Map())\n\n  // Stable across the provider's lifetime so descendants don't re-register\n  // every time the entries list changes.\n  const register = React.useRef<RegisterFn>((entry, handler) => {\n    handlersRef.current.set(entry.id, handler)\n    setEntries((prev) => {\n      const next = new Map(prev)\n      next.set(entry.id, entry)\n      return next\n    })\n    return () => {\n      handlersRef.current.delete(entry.id)\n      setEntries((prev) => {\n        if (!prev.has(entry.id)) return prev\n        const next = new Map(prev)\n        next.delete(entry.id)\n        return next\n      })\n    }\n  }).current\n\n  const hotkeys = React.useMemo(() => Array.from(entries.values()), [entries])\n\n  return (\n    <HotkeyRegisterContext.Provider value={register}>\n      <HotkeyListContext.Provider value={hotkeys}>\n        {children}\n        {enabled && <HotkeyDispatcher entries={hotkeys} handlersRef={handlersRef} />}\n      </HotkeyListContext.Provider>\n    </HotkeyRegisterContext.Provider>\n  )\n}\n\n/**\n * Internal — one useHotkeys per registered entry, mounted under the\n * provider rather than per-component. Per-entry useHotkeys keeps key\n * parsing and ignoreWhenTyping logic in one tested place.\n */\nfunction HotkeyDispatcher({\n  entries,\n  handlersRef,\n}: {\n  entries: RegisteredHotkey[]\n  handlersRef: React.MutableRefObject<Map<string, (event: KeyboardEvent) => void>>\n}) {\n  return (\n    <>\n      {entries.map((entry) => (\n        <HotkeyEntry key={entry.id} entry={entry} handlersRef={handlersRef} />\n      ))}\n    </>\n  )\n}\n\nfunction HotkeyEntry({\n  entry,\n  handlersRef,\n}: {\n  entry: RegisteredHotkey\n  handlersRef: React.MutableRefObject<Map<string, (event: KeyboardEvent) => void>>\n}) {\n  useHotkeys(\n    entry.combo,\n    (event) => {\n      const handler = handlersRef.current.get(entry.id)\n      handler?.(event)\n    },\n    { enabled: entry.enabled !== false }\n  )\n  return null\n}\n\n/* -------------------------------------------------------------------------- */\n/* Hooks                                                                       */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Register a hotkey under the active provider. The combo is added to the\n * cheatsheet-readable registry; the handler fires when the combo matches\n * (subject to `useHotkeys` rules around editable targets + modifiers).\n *\n * @example\n *   useHotkey('palette', 'mod+k', () => setOpen(true), {\n *     description: 'باز کردن پالت دستور',\n *     group: 'سراسری',\n *   })\n *\n * The first argument is a stable id — use a unique slug per call site so\n * registry updates can dedupe. When called outside a `<HotkeyProvider>`,\n * silently no-ops (so consumers can layer the provider in later without\n * a refactor sweep).\n */\nexport function useHotkey(\n  id: string,\n  combo: HotkeyCombo,\n  handler: (event: KeyboardEvent) => void,\n  options: { description?: string; group?: string; enabled?: boolean } = {}\n): void {\n  const register = React.useContext(HotkeyRegisterContext)\n\n  // Capture the latest handler so callers can pass an inline arrow each\n  // render without re-registering the entry.\n  const handlerRef = React.useRef(handler)\n  React.useEffect(() => {\n    handlerRef.current = handler\n  })\n\n  // Stringify combo for stable dependency tracking.\n  const comboKey = Array.isArray(combo) ? combo.join('|') : combo\n\n  React.useEffect(() => {\n    if (!register) return\n    // Skip registration when combo is empty/falsy — lets consumers conditionally\n    // disable a hotkey without violating rules of hooks (still call useHotkey\n    // unconditionally, but pass `''` to opt out).\n    if (!comboKey) return\n    return register(\n      {\n        id,\n        combo,\n        description: options.description,\n        group: options.group,\n        enabled: options.enabled,\n      },\n      (event) => handlerRef.current(event)\n    )\n    // `combo` (the original value) intentionally elided; comboKey covers it.\n  }, [register, id, comboKey, options.description, options.group, options.enabled])\n}\n\n/**\n * Read the active registry. Returns an empty array outside a provider.\n * Useful for CommandPalette items, \"?\" cheatsheet overlays, settings pages.\n */\nexport function useHotkeyRegistry(): { hotkeys: RegisteredHotkey[] } {\n  const hotkeys = React.useContext(HotkeyListContext)\n  return { hotkeys }\n}\n"]}

package/dist/hooks/use-hotkey-registry.js

@@ -1,4 +1,184 @@
-export { HotkeyProvider, useHotkey, useHotkeyRegistry } from '../chunk-IXFEFIDO.js';
-import '../chunk-RZNRIOLT.js';
+'use client';
+import * as React2 from 'react';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+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 = React2.useRef(handler);
+  React2.useEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+  React2.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]);
+}
+var HotkeyRegisterContext = React2.createContext(null);
+var HotkeyListContext = React2.createContext([]);
+function HotkeyProvider({ enabled = true, children }) {
+  const [entries, setEntries] = React2.useState(() => /* @__PURE__ */ new Map());
+  const handlersRef = React2.useRef(/* @__PURE__ */ new Map());
+  const register = React2.useRef((entry, handler) => {
+    handlersRef.current.set(entry.id, handler);
+    setEntries((prev) => {
+      const next = new Map(prev);
+      next.set(entry.id, entry);
+      return next;
+    });
+    return () => {
+      handlersRef.current.delete(entry.id);
+      setEntries((prev) => {
+        if (!prev.has(entry.id)) return prev;
+        const next = new Map(prev);
+        next.delete(entry.id);
+        return next;
+      });
+    };
+  }).current;
+  const hotkeys = React2.useMemo(() => Array.from(entries.values()), [entries]);
+  return /* @__PURE__ */ jsx(HotkeyRegisterContext.Provider, { value: register, children: /* @__PURE__ */ jsxs(HotkeyListContext.Provider, { value: hotkeys, children: [
+    children,
+    enabled && /* @__PURE__ */ jsx(HotkeyDispatcher, { entries: hotkeys, handlersRef })
+  ] }) });
+}
+function HotkeyDispatcher({
+  entries,
+  handlersRef
+}) {
+  return /* @__PURE__ */ jsx(Fragment, { children: entries.map((entry) => /* @__PURE__ */ jsx(HotkeyEntry, { entry, handlersRef }, entry.id)) });
+}
+function HotkeyEntry({
+  entry,
+  handlersRef
+}) {
+  useHotkeys(
+    entry.combo,
+    (event) => {
+      const handler = handlersRef.current.get(entry.id);
+      handler?.(event);
+    },
+    { enabled: entry.enabled !== false }
+  );
+  return null;
+}
+function useHotkey(id, combo, handler, options = {}) {
+  const register = React2.useContext(HotkeyRegisterContext);
+  const handlerRef = React2.useRef(handler);
+  React2.useEffect(() => {
+    handlerRef.current = handler;
+  });
+  const comboKey = Array.isArray(combo) ? combo.join("|") : combo;
+  React2.useEffect(() => {
+    if (!register) return;
+    if (!comboKey) return;
+    return register(
+      {
+        id,
+        combo,
+        description: options.description,
+        group: options.group,
+        enabled: options.enabled
+      },
+      (event) => handlerRef.current(event)
+    );
+  }, [register, id, comboKey, options.description, options.group, options.enabled]);
+}
+function useHotkeyRegistry() {
+  const hotkeys = React2.useContext(HotkeyListContext);
+  return { hotkeys };
+}
+
+export { HotkeyProvider, useHotkey, useHotkeyRegistry };
 //# sourceMappingURL=use-hotkey-registry.js.map
 //# sourceMappingURL=use-hotkey-registry.js.map

package/dist/hooks/use-hotkey-registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"use-hotkey-registry.js"}
+{"version":3,"sources":["../../src/hooks/use-hotkeys.ts","../../src/hooks/use-hotkey-registry.tsx"],"names":["React"],"mappings":"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","file":"use-hotkey-registry.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","'use client'\n\nimport * as React from 'react'\nimport { useHotkeys, type HotkeyCombo } from './use-hotkeys'\n\n/* -------------------------------------------------------------------------- */\n/* Types                                                                       */\n/* -------------------------------------------------------------------------- */\n\nexport interface RegisteredHotkey {\n  /** Stable id — used for de-registration + dedupe. */\n  id: string\n  /** The combo string(s) — `'mod+k'`, `['escape', 'mod+w']`, etc. */\n  combo: HotkeyCombo\n  /** Short human-readable description (e.g. \"باز کردن پالت دستور\"). */\n  description?: string\n  /** Optional grouping label for cheatsheet rendering (\"سراسری\", \"ناوبری\"…). */\n  group?: string\n  /** When false, the entry is listed but the listener doesn't fire. */\n  enabled?: boolean\n}\n\ntype RegisterFn = (entry: RegisteredHotkey, handler: (event: KeyboardEvent) => void) => () => void\n\n/**\n * Two contexts so consumers can depend on a *stable* register fn (never\n * changes for the provider's lifetime) without re-running their effect\n * every time the entries list updates.\n */\nconst HotkeyRegisterContext = React.createContext<RegisterFn | null>(null)\nconst HotkeyListContext = React.createContext<RegisteredHotkey[]>([])\n\n/* -------------------------------------------------------------------------- */\n/* Provider                                                                    */\n/* -------------------------------------------------------------------------- */\n\nexport interface HotkeyProviderProps {\n  /** Globally disable all registered hotkeys (e.g. while a modal owns the page). */\n  enabled?: boolean\n  children: React.ReactNode\n}\n\n/**\n * Centralised hotkey registry. Wrap your app once; descendants register\n * combos via `useHotkey()` and any UI (CommandPalette, help cheatsheet)\n * can read the full list via `useHotkeyRegistry()`.\n *\n * Compared to scattering `useHotkeys` calls across the tree:\n *   - Per-entry mounting is centralized (one place that handles\n *     `enabled`, key parsing, ignore-when-typing semantics)\n *   - Discoverable: cheatsheets / palettes can list every active combo\n *   - De-duplicated: registering the same id twice replaces the entry\n *\n * Optional. `useHotkeys` (the bare hook) continues to work outside a provider.\n */\nexport function HotkeyProvider({ enabled = true, children }: HotkeyProviderProps) {\n  const [entries, setEntries] = React.useState<Map<string, RegisteredHotkey>>(() => new Map())\n  const handlersRef = React.useRef<Map<string, (event: KeyboardEvent) => void>>(new Map())\n\n  // Stable across the provider's lifetime so descendants don't re-register\n  // every time the entries list changes.\n  const register = React.useRef<RegisterFn>((entry, handler) => {\n    handlersRef.current.set(entry.id, handler)\n    setEntries((prev) => {\n      const next = new Map(prev)\n      next.set(entry.id, entry)\n      return next\n    })\n    return () => {\n      handlersRef.current.delete(entry.id)\n      setEntries((prev) => {\n        if (!prev.has(entry.id)) return prev\n        const next = new Map(prev)\n        next.delete(entry.id)\n        return next\n      })\n    }\n  }).current\n\n  const hotkeys = React.useMemo(() => Array.from(entries.values()), [entries])\n\n  return (\n    <HotkeyRegisterContext.Provider value={register}>\n      <HotkeyListContext.Provider value={hotkeys}>\n        {children}\n        {enabled && <HotkeyDispatcher entries={hotkeys} handlersRef={handlersRef} />}\n      </HotkeyListContext.Provider>\n    </HotkeyRegisterContext.Provider>\n  )\n}\n\n/**\n * Internal — one useHotkeys per registered entry, mounted under the\n * provider rather than per-component. Per-entry useHotkeys keeps key\n * parsing and ignoreWhenTyping logic in one tested place.\n */\nfunction HotkeyDispatcher({\n  entries,\n  handlersRef,\n}: {\n  entries: RegisteredHotkey[]\n  handlersRef: React.MutableRefObject<Map<string, (event: KeyboardEvent) => void>>\n}) {\n  return (\n    <>\n      {entries.map((entry) => (\n        <HotkeyEntry key={entry.id} entry={entry} handlersRef={handlersRef} />\n      ))}\n    </>\n  )\n}\n\nfunction HotkeyEntry({\n  entry,\n  handlersRef,\n}: {\n  entry: RegisteredHotkey\n  handlersRef: React.MutableRefObject<Map<string, (event: KeyboardEvent) => void>>\n}) {\n  useHotkeys(\n    entry.combo,\n    (event) => {\n      const handler = handlersRef.current.get(entry.id)\n      handler?.(event)\n    },\n    { enabled: entry.enabled !== false }\n  )\n  return null\n}\n\n/* -------------------------------------------------------------------------- */\n/* Hooks                                                                       */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Register a hotkey under the active provider. The combo is added to the\n * cheatsheet-readable registry; the handler fires when the combo matches\n * (subject to `useHotkeys` rules around editable targets + modifiers).\n *\n * @example\n *   useHotkey('palette', 'mod+k', () => setOpen(true), {\n *     description: 'باز کردن پالت دستور',\n *     group: 'سراسری',\n *   })\n *\n * The first argument is a stable id — use a unique slug per call site so\n * registry updates can dedupe. When called outside a `<HotkeyProvider>`,\n * silently no-ops (so consumers can layer the provider in later without\n * a refactor sweep).\n */\nexport function useHotkey(\n  id: string,\n  combo: HotkeyCombo,\n  handler: (event: KeyboardEvent) => void,\n  options: { description?: string; group?: string; enabled?: boolean } = {}\n): void {\n  const register = React.useContext(HotkeyRegisterContext)\n\n  // Capture the latest handler so callers can pass an inline arrow each\n  // render without re-registering the entry.\n  const handlerRef = React.useRef(handler)\n  React.useEffect(() => {\n    handlerRef.current = handler\n  })\n\n  // Stringify combo for stable dependency tracking.\n  const comboKey = Array.isArray(combo) ? combo.join('|') : combo\n\n  React.useEffect(() => {\n    if (!register) return\n    // Skip registration when combo is empty/falsy — lets consumers conditionally\n    // disable a hotkey without violating rules of hooks (still call useHotkey\n    // unconditionally, but pass `''` to opt out).\n    if (!comboKey) return\n    return register(\n      {\n        id,\n        combo,\n        description: options.description,\n        group: options.group,\n        enabled: options.enabled,\n      },\n      (event) => handlerRef.current(event)\n    )\n    // `combo` (the original value) intentionally elided; comboKey covers it.\n  }, [register, id, comboKey, options.description, options.group, options.enabled])\n}\n\n/**\n * Read the active registry. Returns an empty array outside a provider.\n * Useful for CommandPalette items, \"?\" cheatsheet overlays, settings pages.\n */\nexport function useHotkeyRegistry(): { hotkeys: RegisteredHotkey[] } {\n  const hotkeys = React.useContext(HotkeyListContext)\n  return { hotkeys }\n}\n"]}