@devalok/shilp-sutra 0.23.3 → 0.24.0

package/dist/composed/command-palette.d.ts

@@ -8,21 +8,51 @@
 import * as React from 'react';
 export interface CommandItem {
     id: string;
-    label: string;
-    description?: string;
+    /** Display label — string or ReactNode. When ReactNode, provide `filterValue` for search filtering. */
+    label: string | React.ReactNode;
+    /** Optional description — string or ReactNode. */
+    description?: string | React.ReactNode;
     icon?: React.ReactNode;
+    /** Keyboard shortcut hint displayed as keycap badges (e.g., "G D", "Ctrl+N"). */
     shortcut?: string;
+    /** Custom render override for the label. Receives the current search query for match highlighting. */
+    renderLabel?: (query: string) => React.ReactNode;
+    /** Plain-text value used for search filtering when `label` is a ReactNode. Falls back to `label` if string. */
+    filterValue?: string;
     onSelect: () => void;
 }
 export interface CommandGroup {
     label: string;
     items: CommandItem[];
 }
+/** A single keyboard hint shown in the footer. */
+export interface FooterHint {
+    /** Key(s) to display — rendered as text inside `<kbd>` or as an icon. */
+    keys: string;
+    /** Human-readable label for the hint (e.g., "Navigate", "Select"). */
+    label: string;
+}
 export interface CommandPaletteProps extends React.ComponentPropsWithoutRef<'div'> {
     groups?: CommandGroup[];
     placeholder?: string;
     onSearch?: (query: string) => void;
     emptyMessage?: string;
+    /** Full custom empty state ReactNode — overrides `emptyMessage` when provided. */
+    emptyState?: React.ReactNode;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Default open state for uncontrolled usage. */
+    defaultOpen?: boolean;
+    /** Called when the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Keybinding(s) to toggle the palette. Pass `false` to disable.
+     *  String format: modifier+key, e.g., 'mod+k', 'ctrl+shift+p'.
+     *  'mod' maps to Meta on macOS, Ctrl otherwise. */
+    keybinding?: string | string[] | false;
+    /** Max height of the results container. CSS value. Default '320px'. */
+    maxHeight?: string | number;
+    /** Custom footer keyboard hints. Pass `false` to hide the footer entirely. */
+    footerHints?: FooterHint[] | false;
 }
 declare const CommandPalette: React.ForwardRefExoticComponent<CommandPaletteProps & React.RefAttributes<HTMLDivElement>>;
 export { CommandPalette };

package/dist/composed/command-palette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-palette.d.ts","sourceRoot":"","sources":["../../src/composed/command-palette.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAmB9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAChF,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAMD,QAAA,MAAM,cAAc,4FAqVnB,CAAA;AAID,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"command-palette.d.ts","sourceRoot":"","sources":["../../src/composed/command-palette.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAoB9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,uGAAuG;IACvG,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAA;IAC/B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAA;IACtC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sGAAsG;IACtG,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAA;IAChD,+GAA+G;IAC/G,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAChF,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kFAAkF;IAClF,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAE5B,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC;;uDAEmD;IACnD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,CAAA;IAEtC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAE3B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;CACnC;AAyED,QAAA,MAAM,cAAc,4FAmanB,CAAA;AAID,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/composed/command-palette.js

@@ -1,104 +1,154 @@
 "use client";
-import { jsx as t, jsxs as r } from "react/jsx-runtime";
+import { jsx as t, jsxs as i } from "react/jsx-runtime";
 import * as n from "react";
-import { Dialog as S, DialogPortal as $, DialogOverlay as K, DialogContentRaw as q, DialogTitle as z, DialogDescription as O } from "../ui/dialog.js";
-import { IconSearch as Q, IconCornerDownLeft as C, IconArrowUp as U, IconArrowDown as V } from "@tabler/icons-react";
-import { cn as p } from "../ui/lib/utils.js";
-import { springs as D, tweens as b } from "../ui/lib/motion.js";
-import { VisuallyHidden as F } from "../ui/visually-hidden.js";
-import { m as c, A as G } from "../_chunks/framer.js";
-const H = n.forwardRef(
+import { Dialog as ne, DialogPortal as oe, DialogOverlay as ie, DialogContentRaw as de, DialogTitle as le, DialogDescription as ce } from "../ui/dialog.js";
+import { IconSearch as fe, IconCornerDownLeft as B, IconArrowUp as ue, IconArrowDown as me } from "@tabler/icons-react";
+import { cn as I } from "../ui/lib/utils.js";
+import { springs as Q, tweens as T } from "../ui/lib/motion.js";
+import { VisuallyHidden as pe } from "../ui/visually-hidden.js";
+import { u as be } from "../_chunks/motion-provider.js";
+import { m as h, A as xe } from "../_chunks/framer.js";
+function U() {
+  var o;
+  if (typeof navigator > "u") return !1;
+  const a = ((o = navigator.userAgentData) == null ? void 0 : o.platform) ?? navigator.userAgent;
+  return /mac|iphone|ipad|ipod/i.test(a);
+}
+function ge(a) {
+  return a.filterValue ? a.filterValue : typeof a.label == "string" ? a.label : "";
+}
+function he(a) {
+  return typeof a.description == "string" ? a.description : "";
+}
+function ye(a, o) {
+  const y = o.toLowerCase().split("+"), w = y[y.length - 1], f = new Set(y.slice(0, -1)), A = U(), v = f.has("mod"), N = f.has("ctrl") || !A && v, d = f.has("meta") || A && v, l = f.has("shift"), b = f.has("alt");
+  return N && !a.ctrlKey || d && !a.metaKey || l && !a.shiftKey || b && !a.altKey || !N && !d && a.ctrlKey || !d && !N && a.metaKey || !l && a.shiftKey || !b && a.altKey ? !1 : a.key.toLowerCase() === w;
+}
+function we(a) {
+  return a.includes("+") ? a.split("+").map((o) => o.trim()).filter(Boolean) : a.split(/\s+/).filter(Boolean);
+}
+function ve(a) {
+  return a ? "⌘" : "Ctrl";
+}
+const Ne = n.forwardRef(
   function({
-    groups: h = [],
-    placeholder: I = "Search or jump to...",
-    onSearch: g,
-    emptyMessage: j = "No results found.",
-    className: A,
-    ...E
-  }, M) {
-    const [y, l] = n.useState(!1), [x, N] = n.useState(""), [d, f] = n.useState(0), v = n.useRef(null), k = n.useRef(null), w = n.useId(), _ = `command-palette-listbox-${w}`, i = n.useMemo(() => {
-      if (!x.trim()) return h;
-      const e = x.toLowerCase();
-      return h.map((s) => ({
+    groups: o = [],
+    placeholder: y = "Search or jump to...",
+    onSearch: w,
+    emptyMessage: f = "No results found.",
+    emptyState: A,
+    open: v,
+    defaultOpen: N,
+    onOpenChange: d,
+    keybinding: l = "mod+k",
+    maxHeight: b = "320px",
+    footerHints: E,
+    className: G,
+    ...H
+  }, J) {
+    const j = v !== void 0, [W, X] = n.useState(N ?? !1), k = j ? v : W, $ = n.useRef(k);
+    $.current = k;
+    const u = n.useCallback(
+      (e) => {
+        const s = typeof e == "function" ? e($.current) : e;
+        j || X(s), d == null || d(s);
+      },
+      [j, d]
+    ), [_, V] = n.useState(""), [x, C] = n.useState(0), F = n.useRef(null), P = n.useRef(null), L = n.useId(), q = `command-palette-listbox-${L}`, { reducedMotion: m } = be(), K = { duration: 0 }, Y = n.useMemo(() => U(), []), g = n.useMemo(() => {
+      if (!_.trim()) return o;
+      const e = _.toLowerCase();
+      return o.map((s) => ({
         ...s,
         items: s.items.filter(
-          (a) => {
-            var o;
-            return a.label.toLowerCase().includes(e) || ((o = a.description) == null ? void 0 : o.toLowerCase().includes(e));
-          }
+          (r) => ge(r).toLowerCase().includes(e) || he(r).toLowerCase().includes(e)
         )
       })).filter((s) => s.items.length > 0);
-    }, [h, x]), m = n.useMemo(
-      () => i.flatMap((e) => e.items),
-      [i]
+    }, [o, _]), D = n.useMemo(
+      () => g.flatMap((e) => e.items),
+      [g]
     );
     n.useEffect(() => {
-      function e(s) {
-        (s.metaKey || s.ctrlKey) && s.key === "k" && (s.preventDefault(), l((a) => !a));
+      if (l === !1) return;
+      const e = Array.isArray(l) ? l : [l];
+      function s(r) {
+        for (const c of e)
+          if (ye(r, c)) {
+            r.preventDefault(), u((p) => !p);
+            return;
+          }
       }
-      return document.addEventListener("keydown", e), () => document.removeEventListener("keydown", e);
-    }, []), n.useEffect(() => {
-      y && (N(""), f(0), requestAnimationFrame(() => {
+      return document.addEventListener("keydown", s), () => document.removeEventListener("keydown", s);
+    }, [l, u]), n.useEffect(() => {
+      k && (V(""), C(0), requestAnimationFrame(() => {
         var e;
-        (e = v.current) == null || e.focus();
+        (e = F.current) == null || e.focus();
       }));
-    }, [y]);
-    const R = (e) => {
+    }, [k]);
+    const Z = (e) => {
       switch (e.key) {
         case "ArrowDown": {
-          e.preventDefault(), f(
-            (s) => s < m.length - 1 ? s + 1 : 0
+          e.preventDefault(), C(
+            (s) => s < D.length - 1 ? s + 1 : 0
           );
           break;
         }
         case "ArrowUp": {
-          e.preventDefault(), f(
-            (s) => s > 0 ? s - 1 : m.length - 1
+          e.preventDefault(), C(
+            (s) => s > 0 ? s - 1 : D.length - 1
           );
           break;
         }
         case "Enter": {
           e.preventDefault();
-          const s = m[d];
-          s && (s.onSelect(), l(!1));
+          const s = D[x];
+          s && (s.onSelect(), u(!1));
           break;
         }
         case "Escape": {
-          e.preventDefault(), l(!1);
+          e.preventDefault(), u(!1);
           break;
         }
       }
     };
     n.useEffect(() => {
       var s;
-      const e = (s = k.current) == null ? void 0 : s.querySelector(
-        `[data-command-index="${d}"]`
+      const e = (s = P.current) == null ? void 0 : s.querySelector(
+        `[data-command-index="${x}"]`
       );
       e == null || e.scrollIntoView({ block: "nearest" });
-    }, [d]);
-    const L = (e) => {
-      N(e), f(0), g == null || g(e);
-    }, P = n.useMemo(() => {
+    }, [x]);
+    const O = (e) => {
+      V(e), C(0), w == null || w(e);
+    }, ee = n.useMemo(() => {
       const e = /* @__PURE__ */ new Map();
       let s = 0;
-      for (const a of i)
-        for (const o of a.items)
-          e.set(o.id, s++);
+      for (const r of g)
+        for (const c of r.items)
+          e.set(c.id, s++);
       return e;
-    }, [i]);
-    return /* @__PURE__ */ t(S, { open: y, onOpenChange: l, children: /* @__PURE__ */ r($, { children: [
+    }, [g]), te = m ? K : Q.snappy, R = m ? K : T.fade, M = m ? { opacity: 1, scale: 1, y: 0 } : void 0, se = typeof b == "number" ? `${b}px` : b, z = E === !1 ? !1 : E ?? [
+      { keys: "↑↓", label: "Navigate" },
+      { keys: "↵", label: "Select" },
+      { keys: "Esc", label: "Close" }
+    ], ae = n.useCallback(
+      (e) => {
+        u(e);
+      },
+      [u]
+    );
+    return /* @__PURE__ */ t(ne, { open: k, onOpenChange: ae, children: /* @__PURE__ */ i(oe, { children: [
       /* @__PURE__ */ t(
-        K,
+        ie,
         {
           className: "fixed inset-0 z-overlay bg-overlay data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0"
         }
       ),
-      /* @__PURE__ */ r(
-        q,
+      /* @__PURE__ */ i(
+        de,
         {
-          ref: M,
-          ...E,
-          className: p(
+          ref: J,
+          ...H,
+          className: I(
             "fixed left-1/2 top-[20%] z-modal w-full max-w-[560px] -translate-x-1/2",
             "overflow-hidden rounded-ds-xl border border-surface-border-strong bg-surface-overlay shadow-overlay",
             "duration-moderate-02 data-[state=open]:animate-in data-[state=closed]:animate-out",
@@ -106,24 +156,24 @@ const H = n.forwardRef(
             "data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95",
             "data-[state=closed]:slide-out-to-left-1/2 data-[state=open]:slide-in-from-left-1/2",
             "data-[state=closed]:slide-out-to-top-2 data-[state=open]:slide-in-from-top-2",
-            A
+            G
           ),
-          onKeyDown: R,
+          onKeyDown: Z,
           children: [
-            /* @__PURE__ */ r(F, { children: [
-              /* @__PURE__ */ t(z, { children: "Command Palette" }),
-              /* @__PURE__ */ t(O, { children: "Search or jump to pages, projects, tasks, and actions" })
+            /* @__PURE__ */ i(pe, { children: [
+              /* @__PURE__ */ t(le, { children: "Command Palette" }),
+              /* @__PURE__ */ t(ce, { children: "Search or jump to pages, projects, tasks, and actions" })
             ] }),
-            /* @__PURE__ */ r("div", { className: "flex items-center gap-ds-04 border-b border-surface-border-strong px-ds-05 py-ds-04", children: [
+            /* @__PURE__ */ i("div", { className: "flex items-center gap-ds-04 border-b border-surface-border-strong px-ds-05 py-ds-04", children: [
               /* @__PURE__ */ t(
-                c.span,
+                h.span,
                 {
-                  initial: { opacity: 0, scale: 0.96 },
+                  initial: M ?? { opacity: 0, scale: 0.96 },
                   animate: { opacity: 1, scale: 1 },
-                  transition: D.snappy,
+                  transition: te,
                   className: "inline-flex shrink-0",
                   children: /* @__PURE__ */ t(
-                    Q,
+                    fe,
                     {
                       className: "h-ico-sm w-ico-sm text-surface-fg-subtle",
                       stroke: 1.5
@@ -134,16 +184,16 @@ const H = n.forwardRef(
               /* @__PURE__ */ t(
                 "input",
                 {
-                  ref: v,
-                  value: x,
-                  onChange: (e) => L(e.target.value),
-                  placeholder: I,
+                  ref: F,
+                  value: _,
+                  onChange: (e) => O(e.target.value),
+                  placeholder: y,
                   role: "combobox",
                   "aria-expanded": !0,
-                  "aria-controls": _,
-                  "aria-activedescendant": m[d] ? `command-item-${w}-${m[d].id}` : void 0,
+                  "aria-controls": q,
+                  "aria-activedescendant": D[x] ? `command-item-${L}-${D[x].id}` : void 0,
                   "aria-autocomplete": "list",
-                  className: p(
+                  className: I(
                     "flex-1 bg-transparent text-ds-base text-surface-fg outline-none",
                     "placeholder:text-surface-fg-subtle"
                   ),
@@ -154,85 +204,93 @@ const H = n.forwardRef(
               ),
               /* @__PURE__ */ t("kbd", { className: "hidden shrink-0 select-none rounded-ds-md border border-surface-border-strong bg-surface-raised px-ds-02b py-ds-01 text-ds-sm font-medium text-surface-fg-subtle shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)] sm:inline-flex", children: "Esc" })
             ] }),
-            /* @__PURE__ */ r(
+            /* @__PURE__ */ i(
               "div",
               {
-                ref: k,
-                id: _,
+                ref: P,
+                id: q,
                 role: "listbox",
                 "aria-label": "Command results",
-                className: "max-h-[320px] overflow-y-auto px-ds-03 py-ds-03",
+                className: "overflow-y-auto px-ds-03 py-ds-03",
+                style: { maxHeight: se },
                 children: [
-                  i.length === 0 && /* @__PURE__ */ t(
-                    c.div,
+                  g.length === 0 && /* @__PURE__ */ t(
+                    h.div,
                     {
-                      initial: { opacity: 0 },
+                      initial: M ?? { opacity: 0 },
                       animate: { opacity: 1 },
-                      transition: b.fade,
+                      transition: R,
                       className: "flex items-center justify-center py-ds-07",
-                      children: /* @__PURE__ */ t("p", { className: "text-ds-md text-surface-fg-subtle", children: j })
+                      children: A ?? /* @__PURE__ */ t("p", { className: "text-ds-md text-surface-fg-subtle", children: f })
                     }
                   ),
-                  i.map((e, s) => /* @__PURE__ */ r(
-                    c.div,
+                  g.map((e, s) => /* @__PURE__ */ i(
+                    h.div,
                     {
-                      initial: { opacity: 0 },
+                      initial: M ?? { opacity: 0 },
                       animate: { opacity: 1 },
-                      transition: { ...b.fade, delay: s * 0.06 },
+                      transition: m ? K : { ...T.fade, delay: s * 0.06 },
                       className: "mb-ds-02",
                       children: [
                         /* @__PURE__ */ t("div", { className: "px-ds-03 pb-ds-02 pt-ds-03", children: /* @__PURE__ */ t("span", { className: "text-ds-xs font-semibold uppercase tracking-wider text-surface-fg-subtle", children: e.label }) }),
-                        e.items.map((a) => {
-                          const o = P.get(a.id) ?? 0, u = o === d;
-                          return /* @__PURE__ */ r(
-                            c.button,
+                        e.items.map((r) => {
+                          const c = ee.get(r.id) ?? 0, p = c === x;
+                          return /* @__PURE__ */ i(
+                            h.button,
                             {
-                              id: `command-item-${w}-${a.id}`,
+                              id: `command-item-${L}-${r.id}`,
                               type: "button",
                               role: "option",
-                              "aria-selected": u,
-                              "data-command-index": o,
-                              initial: { opacity: 0, y: 4 },
+                              "aria-selected": p,
+                              "data-command-index": c,
+                              initial: M ?? { opacity: 0, y: 4 },
                               animate: { opacity: 1, y: 0 },
-                              transition: { ...D.snappy, delay: o * 0.03 },
+                              transition: m ? K : { ...Q.snappy, delay: c * 0.03 },
                               onClick: () => {
-                                a.onSelect(), l(!1);
+                                r.onSelect(), u(!1);
                               },
-                              onMouseEnter: () => f(o),
-                              className: p(
+                              onMouseEnter: () => C(c),
+                              className: I(
                                 "flex w-full items-center gap-ds-04 rounded-ds-lg px-ds-03 py-ds-03 text-left transition-[color,background-color] duration-fast-02 ease-productive-standard",
-                                u ? "bg-surface-raised-hover text-surface-fg" : "text-surface-fg-muted hover:bg-surface-raised"
+                                p ? "bg-surface-raised-hover text-surface-fg" : "text-surface-fg-muted hover:bg-surface-raised"
                               ),
                               children: [
-                                a.icon && /* @__PURE__ */ t(
+                                r.icon && /* @__PURE__ */ t(
                                   "span",
                                   {
-                                    className: p(
+                                    className: I(
                                       "[&>svg]:h-ico-sm [&>svg]:w-ico-sm shrink-0 transition-colors duration-fast-02 ease-productive-standard",
-                                      u ? "text-accent-11" : "text-surface-fg-subtle"
+                                      p ? "text-accent-11" : "text-surface-fg-subtle"
                                     ),
                                     "aria-hidden": "true",
-                                    children: a.icon
+                                    children: r.icon
                                   }
                                 ),
-                                /* @__PURE__ */ r("div", { className: "flex flex-1 flex-col", children: [
-                                  /* @__PURE__ */ t("span", { className: "text-ds-md", children: a.label }),
-                                  a.description && /* @__PURE__ */ t("span", { className: "text-ds-sm text-surface-fg-subtle", children: a.description })
+                                /* @__PURE__ */ i("div", { className: "flex flex-1 flex-col", children: [
+                                  /* @__PURE__ */ t("span", { className: "text-ds-md", children: r.renderLabel ? r.renderLabel(_) : r.label }),
+                                  r.description && /* @__PURE__ */ t("span", { className: "text-ds-sm text-surface-fg-subtle", children: r.description })
                                 ] }),
-                                a.shortcut && /* @__PURE__ */ t("kbd", { className: p(
-                                  "shrink-0 rounded border border-surface-border-strong px-ds-02b py-ds-01 text-ds-xs font-medium shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)] transition-colors duration-fast-02 ease-productive-standard",
-                                  u ? "bg-accent-2 text-accent-11 border-accent-6" : "bg-surface-raised text-surface-fg-subtle"
-                                ), children: a.shortcut }),
-                                /* @__PURE__ */ t(G, { children: u && /* @__PURE__ */ t(
-                                  c.span,
+                                r.shortcut && /* @__PURE__ */ t("span", { className: "flex shrink-0 items-center gap-ds-01", children: we(r.shortcut).map((S, re) => /* @__PURE__ */ t(
+                                  "kbd",
                                   {
-                                    initial: { opacity: 0 },
+                                    className: I(
+                                      "inline-flex min-w-[20px] items-center justify-center rounded border px-ds-02b py-ds-01 text-ds-xs font-medium shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)] transition-colors duration-fast-02 ease-productive-standard",
+                                      p ? "bg-accent-2 text-accent-11 border-accent-6" : "bg-surface-raised text-surface-fg-subtle border-surface-border-strong"
+                                    ),
+                                    children: S === "Ctrl" || S === "ctrl" ? ve(Y) : S
+                                  },
+                                  re
+                                )) }),
+                                /* @__PURE__ */ t(xe, { children: p && /* @__PURE__ */ t(
+                                  h.span,
+                                  {
+                                    initial: m ? void 0 : { opacity: 0 },
                                     animate: { opacity: 1 },
-                                    exit: { opacity: 0 },
-                                    transition: b.fade,
+                                    exit: m ? void 0 : { opacity: 0 },
+                                    transition: R,
                                     className: "inline-flex shrink-0",
                                     children: /* @__PURE__ */ t(
-                                      C,
+                                      B,
                                       {
                                         className: "h-ico-sm w-ico-sm text-surface-fg-subtle",
                                         stroke: 1.5
@@ -242,7 +300,7 @@ const H = n.forwardRef(
                                 ) })
                               ]
                             },
-                            a.id
+                            r.id
                           );
                         })
                       ]
@@ -252,30 +310,20 @@ const H = n.forwardRef(
                 ]
               }
             ),
-            /* @__PURE__ */ r(
-              c.div,
+            z !== !1 && /* @__PURE__ */ t(
+              h.div,
               {
-                initial: { opacity: 0 },
+                initial: M ?? { opacity: 0 },
                 animate: { opacity: 1 },
-                transition: b.fade,
+                transition: R,
                 className: "flex items-center gap-ds-05 border-t border-surface-border-strong px-ds-05 py-ds-03",
-                children: [
-                  /* @__PURE__ */ r("div", { className: "flex items-center gap-ds-02b", children: [
-                    /* @__PURE__ */ r("div", { className: "flex items-center gap-ds-01", children: [
-                      /* @__PURE__ */ t("kbd", { className: "inline-flex h-ico-md w-ico-md items-center justify-center rounded border border-surface-border-strong bg-surface-raised shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: /* @__PURE__ */ t(U, { className: "h-ds-03 w-ds-03 text-surface-fg-subtle", stroke: 2 }) }),
-                      /* @__PURE__ */ t("kbd", { className: "inline-flex h-ico-md w-ico-md items-center justify-center rounded border border-surface-border-strong bg-surface-raised shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: /* @__PURE__ */ t(V, { className: "h-ds-03 w-ds-03 text-surface-fg-subtle", stroke: 2 }) })
-                    ] }),
-                    /* @__PURE__ */ t("span", { className: "text-ds-xs text-surface-fg-subtle", children: "Navigate" })
-                  ] }),
-                  /* @__PURE__ */ r("div", { className: "flex items-center gap-ds-02b", children: [
-                    /* @__PURE__ */ t("kbd", { className: "inline-flex h-[20px] items-center justify-center rounded-ds-md border border-surface-border-strong bg-surface-raised px-ds-02b shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: /* @__PURE__ */ t(C, { className: "h-ds-03 w-ds-03 text-surface-fg-subtle", stroke: 2 }) }),
-                    /* @__PURE__ */ t("span", { className: "text-ds-xs text-surface-fg-subtle", children: "Select" })
-                  ] }),
-                  /* @__PURE__ */ r("div", { className: "flex items-center gap-ds-02b", children: [
-                    /* @__PURE__ */ t("kbd", { className: "inline-flex h-[20px] items-center justify-center rounded-ds-md border border-surface-border-strong bg-surface-raised px-ds-02b text-ds-xs font-medium text-surface-fg-subtle shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: "Esc" }),
-                    /* @__PURE__ */ t("span", { className: "text-ds-xs text-surface-fg-subtle", children: "Close" })
-                  ] })
-                ]
+                children: z.map((e, s) => /* @__PURE__ */ i("div", { className: "flex items-center gap-ds-02b", children: [
+                  e.keys === "↑↓" ? /* @__PURE__ */ i("div", { className: "flex items-center gap-ds-01", children: [
+                    /* @__PURE__ */ t("kbd", { className: "inline-flex h-ico-md w-ico-md items-center justify-center rounded border border-surface-border-strong bg-surface-raised shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: /* @__PURE__ */ t(ue, { className: "h-ds-03 w-ds-03 text-surface-fg-subtle", stroke: 2 }) }),
+                    /* @__PURE__ */ t("kbd", { className: "inline-flex h-ico-md w-ico-md items-center justify-center rounded border border-surface-border-strong bg-surface-raised shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: /* @__PURE__ */ t(me, { className: "h-ds-03 w-ds-03 text-surface-fg-subtle", stroke: 2 }) })
+                  ] }) : e.keys === "↵" ? /* @__PURE__ */ t("kbd", { className: "inline-flex h-[20px] items-center justify-center rounded-ds-md border border-surface-border-strong bg-surface-raised px-ds-02b shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: /* @__PURE__ */ t(B, { className: "h-ds-03 w-ds-03 text-surface-fg-subtle", stroke: 2 }) }) : /* @__PURE__ */ t("kbd", { className: "inline-flex h-[20px] items-center justify-center rounded-ds-md border border-surface-border-strong bg-surface-raised px-ds-02b text-ds-xs font-medium text-surface-fg-subtle shadow-[inset_0_-1px_0_rgba(0,0,0,0.1)]", children: e.keys }),
+                  /* @__PURE__ */ t("span", { className: "text-ds-xs text-surface-fg-subtle", children: e.label })
+                ] }, s))
               }
             )
           ]
@@ -284,7 +332,7 @@ const H = n.forwardRef(
     ] }) });
   }
 );
-H.displayName = "CommandPalette";
+Ne.displayName = "CommandPalette";
 export {
-  H as CommandPalette
+  Ne as CommandPalette
 };

package/dist/composed/index.d.ts

@@ -37,7 +37,7 @@ export type { ErrorDisplayProps } from './error-boundary';
 export { GlobalLoading } from './global-loading';
 export type { GlobalLoadingProps } from './global-loading';
 export { CommandPalette } from './command-palette';
-export type { CommandPaletteProps, CommandGroup, CommandItem } from './command-palette';
+export type { CommandPaletteProps, CommandGroup, CommandItem, FooterHint } from './command-palette';
 export { MemberPicker } from './member-picker';
 export type { MemberPickerProps, MemberPickerMember } from './member-picker';
 export { SimpleTooltip } from './simple-tooltip';

package/dist/composed/index.d.ts.map

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

package/dist/shell/app-command-palette.d.ts

@@ -1,5 +1,5 @@
 "use client";
-import { CommandGroup } from '../composed/command-palette';
+import { CommandGroup, CommandPaletteProps, FooterHint } from '../composed/command-palette';
 /**
  * AppCommandPalette -- Application-level command palette wrapper.
  *
@@ -7,8 +7,6 @@ import { CommandGroup } from '../composed/command-palette';
  * info instead of reading from Zustand stores or Remix hooks.
  *
  * Depends on the CommandPalette shared component being available.
- * If you haven't created `src/shared/command-palette.tsx`, this
- * component re-exports a minimal inline implementation.
  */
 import * as React from 'react';
 export interface SearchResult {
@@ -18,6 +16,17 @@ export interface SearchResult {
     entityType: string;
     projectId?: string | null;
     metadata?: Record<string, unknown>;
+    /** Custom icon for this result. Overrides the default entity-type icon. */
+    icon?: React.ReactNode;
+    /** Relevance score for sorting (higher = more relevant). */
+    rank?: number;
+    /** Keyboard shortcut hint to display on this result. */
+    shortcut?: string;
+}
+/** A group of search results with a label. */
+export interface SearchResultGroup {
+    label: string;
+    results: SearchResult[];
 }
 export interface AppCommandPaletteUser {
     name: string;
@@ -34,12 +43,34 @@ export interface AppCommandPaletteProps extends Omit<React.ComponentPropsWithRef
     onNavigate?: (path: string) => void;
     /** Called when the search input changes (for server-side search) */
     onSearch?: (query: string) => void;
-    /** IconSearch results from external search provider */
+    /** Flat search results (displayed in a single "Search Results" group).
+     *  For grouped results, use `searchResultGroups` instead. */
     searchResults?: SearchResult[];
+    /** Grouped search results — displayed as multiple labeled sections.
+     *  Takes precedence over `searchResults` when provided. */
+    searchResultGroups?: SearchResultGroup[];
     /** Whether a search is currently in progress */
     isSearching?: boolean;
-    /** Called when the user selects a search result */
+    /** Called when the user selects a search result. When provided, the component
+     *  does NOT perform internal navigation — the consumer owns routing entirely. */
     onSearchResultSelect?: (result: SearchResult) => void;
+    /** Custom label for the search results group. Overrides "Search Results" / "Searching...".
+     *  Can be a string or a function receiving the result count. */
+    searchResultsLabel?: string | ((count: number) => string);
+    /** Controlled open state. */
+    open?: boolean;
+    /** Default open state. */
+    defaultOpen?: boolean;
+    /** Called when the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Keybinding(s) to toggle. Pass `false` to disable. Default: 'mod+k'. */
+    keybinding?: CommandPaletteProps['keybinding'];
+    /** Max height of results. Default '320px'. */
+    maxHeight?: CommandPaletteProps['maxHeight'];
+    /** Custom empty state. */
+    emptyState?: React.ReactNode;
+    /** Custom footer hints. Pass `false` to hide. */
+    footerHints?: FooterHint[] | false;
 }
 declare const AppCommandPalette: React.ForwardRefExoticComponent<Omit<AppCommandPaletteProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { AppCommandPalette };

package/dist/shell/app-command-palette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-command-palette.d.ts","sourceRoot":"","sources":["../../src/shell/app-command-palette.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAsB9B,OAAO,EAAkB,KAAK,YAAY,EAAoB,MAAM,6BAA6B,CAAA;AAQjG,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5D,oDAAoD;IACpD,IAAI,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACnC,iHAAiH;IACjH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wCAAwC;IACxC,WAAW,CAAC,EAAE,YAAY,EAAE,CAAA;IAC5B,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,uDAAuD;IACvD,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;IAC9B,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;CACtD;AA0HD,QAAA,MAAM,iBAAiB,4GA0JtB,CAAA;AAID,OAAO,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"app-command-palette.d.ts","sourceRoot":"","sources":["../../src/shell/app-command-palette.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAsB9B,OAAO,EAAkB,KAAK,YAAY,EAAoB,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAQ5I,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5D,oDAAoD;IACpD,IAAI,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACnC,iHAAiH;IACjH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wCAAwC;IACxC,WAAW,CAAC,EAAE,YAAY,EAAE,CAAA;IAC5B,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC;iEAC6D;IAC7D,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;IAC9B;+DAC2D;IAC3D,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAA;IACxC,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;qFACiF;IACjF,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IACrD;oEACgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAA;IAEzD,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC9C,8CAA8C;IAC9C,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAA;IAC5C,0BAA0B;IAC1B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B,iDAAiD;IACjD,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;CACnC;AA+KD,QAAA,MAAM,iBAAiB,4GAuJtB,CAAA;AAID,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/shell/app-command-palette.js

@@ -1,220 +1,241 @@
 "use client";
-import { jsx as a } from "react/jsx-runtime";
-import * as w from "react";
-import { useCallback as g, useMemo as r } from "react";
-import { IconFileText as D, IconLayoutDashboard as N, IconCalendarCheck as A, IconUmbrella as C, IconLayoutKanban as E, IconListCheck as h, IconBook as O, IconAdjustmentsHorizontal as U, IconUserCircle as B, IconShieldCheck as K, IconClipboardList as G, IconUserPlus as R, IconSettings as V, IconPackage as v, IconLink as x, IconVideo as J, IconMessage as Y, IconUsers as _ } from "@tabler/icons-react";
-import { CommandPalette as z } from "../composed/command-palette.js";
-import { cn as F } from "../ui/lib/utils.js";
-import { useCommandRegistry as H } from "./command-registry.js";
-const q = {
-  TASK: /* @__PURE__ */ a(h, {}),
-  PROJECT: /* @__PURE__ */ a(E, {}),
-  USER: /* @__PURE__ */ a(_, {}),
-  COMMENT: /* @__PURE__ */ a(Y, {}),
-  MEETING: /* @__PURE__ */ a(J, {}),
-  LINK: /* @__PURE__ */ a(x, {}),
-  DELIVERABLE: /* @__PURE__ */ a(v, {})
+import { jsx as n } from "react/jsx-runtime";
+import * as _ from "react";
+import { useCallback as g, useMemo as b } from "react";
+import { IconLayoutDashboard as z, IconCalendarCheck as P, IconUmbrella as M, IconLayoutKanban as $, IconListCheck as w, IconBook as G, IconAdjustmentsHorizontal as H, IconUserCircle as q, IconShieldCheck as Q, IconClipboardList as W, IconUserPlus as X, IconSettings as Z, IconFileText as R, IconPackage as ee, IconLink as ne, IconVideo as te, IconMessage as oe, IconUsers as ae } from "@tabler/icons-react";
+import { CommandPalette as ie } from "../composed/command-palette.js";
+import { cn as ce } from "../ui/lib/utils.js";
+import { useCommandRegistry as de } from "./command-registry.js";
+const le = {
+  TASK: /* @__PURE__ */ n(w, {}),
+  PROJECT: /* @__PURE__ */ n($, {}),
+  USER: /* @__PURE__ */ n(ae, {}),
+  COMMENT: /* @__PURE__ */ n(oe, {}),
+  MEETING: /* @__PURE__ */ n(te, {}),
+  LINK: /* @__PURE__ */ n(ne, {}),
+  DELIVERABLE: /* @__PURE__ */ n(ee, {})
 };
-function Q(o) {
+function se(e) {
   return [
     {
       id: "nav-dashboard",
       label: "Dashboard",
-      icon: /* @__PURE__ */ a(N, {}),
-      onSelect: () => o("/")
+      icon: /* @__PURE__ */ n(z, {}),
+      onSelect: () => e("/")
     },
     {
       id: "nav-attendance",
       label: "Attendance",
-      icon: /* @__PURE__ */ a(A, {}),
-      onSelect: () => o("/attendance")
+      icon: /* @__PURE__ */ n(P, {}),
+      onSelect: () => e("/attendance")
     },
     {
       id: "nav-breaks",
       label: "Breaks",
-      icon: /* @__PURE__ */ a(C, {}),
-      onSelect: () => o("/breaks")
+      icon: /* @__PURE__ */ n(M, {}),
+      onSelect: () => e("/breaks")
     },
     {
       id: "nav-projects",
       label: "Projects",
-      icon: /* @__PURE__ */ a(E, {}),
-      onSelect: () => o("/projects")
+      icon: /* @__PURE__ */ n($, {}),
+      onSelect: () => e("/projects")
     },
     {
       id: "nav-my-tasks",
       label: "My Tasks",
-      icon: /* @__PURE__ */ a(h, {}),
-      onSelect: () => o("/my-tasks")
+      icon: /* @__PURE__ */ n(w, {}),
+      onSelect: () => e("/my-tasks")
     },
     {
       id: "nav-devsabha",
       label: "Devsabha",
-      icon: /* @__PURE__ */ a(O, {}),
-      onSelect: () => o("/devsabha")
+      icon: /* @__PURE__ */ n(G, {}),
+      onSelect: () => e("/devsabha")
     },
     {
       id: "nav-adjustments",
       label: "Adjustments",
-      icon: /* @__PURE__ */ a(U, {}),
-      onSelect: () => o("/adjustments")
+      icon: /* @__PURE__ */ n(H, {}),
+      onSelect: () => e("/adjustments")
     },
     {
       id: "nav-profile",
       label: "Profile",
-      icon: /* @__PURE__ */ a(B, {}),
-      onSelect: () => o("/profile")
+      icon: /* @__PURE__ */ n(q, {}),
+      onSelect: () => e("/profile")
     }
   ];
 }
-function W(o) {
+function re(e) {
   return [
     {
       id: "nav-admin-dashboard",
       label: "Admin Dashboard",
-      icon: /* @__PURE__ */ a(K, {}),
-      onSelect: () => o("/admin")
+      icon: /* @__PURE__ */ n(Q, {}),
+      onSelect: () => e("/admin")
     },
     {
       id: "nav-admin-breaks",
       label: "Manage Breaks",
-      icon: /* @__PURE__ */ a(C, {}),
-      onSelect: () => o("/admin/breaks")
+      icon: /* @__PURE__ */ n(M, {}),
+      onSelect: () => e("/admin/breaks")
     },
     {
       id: "nav-admin-attendance",
       label: "Manage Attendance",
-      icon: /* @__PURE__ */ a(A, {}),
-      onSelect: () => o("/admin/attendance")
+      icon: /* @__PURE__ */ n(P, {}),
+      onSelect: () => e("/admin/attendance")
     },
     {
       id: "nav-admin-lokwasi",
       label: "Lokwasi",
-      icon: /* @__PURE__ */ a(G, {}),
-      onSelect: () => o("/admin/lokwasi")
+      icon: /* @__PURE__ */ n(W, {}),
+      onSelect: () => e("/admin/lokwasi")
     },
     {
       id: "nav-admin-onboarding",
       label: "Onboarding",
-      icon: /* @__PURE__ */ a(R, {}),
-      onSelect: () => o("/admin/onboarding")
+      icon: /* @__PURE__ */ n(X, {}),
+      onSelect: () => e("/admin/onboarding")
     },
     {
       id: "nav-admin-config",
       label: "System Config",
-      icon: /* @__PURE__ */ a(V, {}),
-      onSelect: () => o("/admin/system-config")
+      icon: /* @__PURE__ */ n(Z, {}),
+      onSelect: () => e("/admin/system-config")
     }
   ];
 }
-const X = w.forwardRef(
+function me(e) {
+  var o;
+  switch (e.entityType) {
+    case "TASK":
+      return e.projectId ? `/projects/${e.projectId}?taskId=${e.id}` : "/";
+    case "PROJECT":
+      return `/projects/${e.id}`;
+    case "USER":
+      return "/teammates";
+    case "COMMENT":
+      return e.projectId && ((o = e.metadata) != null && o.taskId) ? `/projects/${e.projectId}?taskId=${e.metadata.taskId}` : "/";
+    case "MEETING":
+      return e.projectId ? `/projects/${e.projectId}?tab=meetings` : "/";
+    case "LINK":
+      return e.projectId ? `/projects/${e.projectId}?tab=karyakram` : "/";
+    case "DELIVERABLE":
+      return e.projectId ? `/projects/${e.projectId}?tab=deliverables` : "/";
+    default:
+      return "/";
+  }
+}
+function h(e, o, I) {
+  return {
+    id: `search-${e.entityType}-${e.id}`,
+    label: e.title,
+    filterValue: e.title,
+    description: e.snippet,
+    icon: e.icon ?? le[e.entityType] ?? /* @__PURE__ */ n(R, {}),
+    shortcut: e.shortcut,
+    onSelect: () => {
+      o ? o(e) : I(me(e));
+    }
+  };
+}
+const pe = _.forwardRef(
   function({
-    user: c,
-    isAdmin: T,
-    extraGroups: I = [],
-    onNavigate: s,
-    onSearch: l,
-    searchResults: b = [],
-    isSearching: k = !1,
-    onSearchResultSelect: m,
-    className: S,
-    ...P
-  }, L) {
-    const f = T ?? ((c == null ? void 0 : c.role) === "Admin" || (c == null ? void 0 : c.role) === "SuperAdmin"), d = H(), t = g(
-      (e) => {
-        s == null || s(e);
+    user: o,
+    isAdmin: I,
+    extraGroups: j = [],
+    onNavigate: r,
+    onSearch: m,
+    searchResults: d = [],
+    searchResultGroups: p,
+    isSearching: y = !1,
+    onSearchResultSelect: k,
+    searchResultsLabel: l,
+    open: D,
+    defaultOpen: L,
+    onOpenChange: N,
+    keybinding: O,
+    maxHeight: U,
+    emptyState: B,
+    footerHints: K,
+    className: V,
+    ...v
+  }, x) {
+    const C = I ?? ((o == null ? void 0 : o.role) === "Admin" || (o == null ? void 0 : o.role) === "SuperAdmin"), c = de(), i = g(
+      (t) => {
+        r == null || r(t);
       },
-      [s]
-    ), j = r(
+      [r]
+    ), S = b(
       () => ({
         label: "Pages",
-        items: d ? d.pages.map((e) => ({
-          id: e.id,
-          label: e.label,
-          icon: e.icon,
-          keywords: e.keywords,
-          onSelect: () => t(e.path)
-        })) : Q(t)
+        items: c ? c.pages.map((t) => ({
+          id: t.id,
+          label: t.label,
+          icon: t.icon,
+          keywords: t.keywords,
+          onSelect: () => i(t.path)
+        })) : se(i)
       }),
-      [t, d]
-    ), y = r(
+      [i, c]
+    ), A = b(
       () => ({
         label: "Admin",
-        items: d ? d.adminPages.map((e) => ({
-          id: e.id,
-          label: e.label,
-          icon: e.icon,
-          keywords: e.keywords,
-          onSelect: () => t(e.path)
-        })) : W(t)
+        items: c ? c.adminPages.map((t) => ({
+          id: t.id,
+          label: t.label,
+          icon: t.icon,
+          keywords: t.keywords,
+          onSelect: () => i(t.path)
+        })) : re(i)
       }),
-      [t, d]
-    ), p = r(() => {
-      if (b.length === 0) return null;
-      const e = b.map((n) => {
-        var u;
-        let i = "/";
-        switch (n.entityType) {
-          case "TASK":
-            i = n.projectId ? `/projects/${n.projectId}?taskId=${n.id}` : "/";
-            break;
-          case "PROJECT":
-            i = `/projects/${n.id}`;
-            break;
-          case "USER":
-            i = "/teammates";
-            break;
-          case "COMMENT":
-            i = n.projectId && ((u = n.metadata) != null && u.taskId) ? `/projects/${n.projectId}?taskId=${n.metadata.taskId}` : "/";
-            break;
-          case "MEETING":
-            i = n.projectId ? `/projects/${n.projectId}?tab=meetings` : "/";
-            break;
-          case "LINK":
-            i = n.projectId ? `/projects/${n.projectId}?tab=karyakram` : "/";
-            break;
-          case "DELIVERABLE":
-            i = n.projectId ? `/projects/${n.projectId}?tab=deliverables` : "/";
-            break;
-        }
-        return {
-          id: `search-${n.entityType}-${n.id}`,
-          label: n.title,
-          description: n.snippet,
-          icon: q[n.entityType] ?? /* @__PURE__ */ a(D, {}),
-          onSelect: () => {
-            m == null || m(n), t(i);
-          }
-        };
-      });
-      return {
-        label: k ? "Searching..." : "Search Results",
-        items: e
-      };
-    }, [b, k, t, m]), M = r(() => {
-      const e = [];
-      return p && e.push(p), e.push(j), f && e.push(y), e.push(...I), e;
-    }, [p, j, f, y, I]), $ = g(
-      (e) => {
-        l == null || l(e);
+      [i, c]
+    ), E = b(() => {
+      if (p && p.length > 0)
+        return p.map((a) => {
+          const u = a.results.some((s) => s.rank != null) ? [...a.results].sort((s, Y) => (Y.rank ?? 0) - (s.rank ?? 0)) : a.results;
+          return {
+            label: a.label,
+            items: u.map((s) => h(s, k, i))
+          };
+        });
+      if (d.length === 0) return [];
+      const T = (d.some((a) => a.rank != null) ? [...d].sort((a, u) => (u.rank ?? 0) - (a.rank ?? 0)) : d).map((a) => h(a, k, i));
+      let f;
+      return l ? f = typeof l == "function" ? l(T.length) : l : f = y ? "Searching..." : "Search Results", [{ label: f, items: T }];
+    }, [d, p, y, i, k, l]), F = b(() => {
+      const t = [];
+      return t.push(...E), t.push(S), C && t.push(A), t.push(...j), t;
+    }, [E, S, C, A, j]), J = g(
+      (t) => {
+        m == null || m(t);
       },
-      [l]
+      [m]
     );
-    return /* @__PURE__ */ a(
-      z,
+    return /* @__PURE__ */ n(
+      ie,
       {
-        ref: L,
-        groups: M,
+        ref: x,
+        groups: F,
         placeholder: "Search or jump to...",
-        onSearch: $,
+        onSearch: J,
         emptyMessage: "No results found. Try a different search term.",
-        className: F(S),
-        ...P
+        open: D,
+        defaultOpen: L,
+        onOpenChange: N,
+        keybinding: O,
+        maxHeight: U,
+        emptyState: B,
+        footerHints: K,
+        className: ce(V),
+        ...v
       }
     );
   }
 );
-X.displayName = "AppCommandPalette";
+pe.displayName = "AppCommandPalette";
 export {
-  X as AppCommandPalette
+  pe as AppCommandPalette
 };

package/dist/shell/index.d.ts

@@ -15,6 +15,6 @@ export { TopBar, type TopBarUser, type UserMenuItem, type TopBarProps, } from '.
 export { BottomNavbar, type BottomNavItem, type BottomNavbarUser, type BottomNavbarProps, } from './bottom-navbar';
 export { NotificationCenter, type Notification, type NotificationCenterProps, } from './notification-center';
 export { NotificationPreferences, type NotificationPreference, type NotificationProject, type NotificationPreferencesProps, } from './notification-preferences';
-export { AppCommandPalette, type SearchResult, type AppCommandPaletteUser, type AppCommandPaletteProps, } from './app-command-palette';
+export { AppCommandPalette, type SearchResult, type SearchResultGroup, type AppCommandPaletteUser, type AppCommandPaletteProps, } from './app-command-palette';
 export { CommandRegistryProvider, useCommandRegistry, type CommandRegistry, type CommandPageItem, type CommandRegistryProviderProps, } from './command-registry';
 //# sourceMappingURL=index.d.ts.map

package/dist/shell/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shell/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE9E,OAAO,EACL,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,MAAM,EACN,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shell/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE9E,OAAO,EACL,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,MAAM,EACN,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAA"}

package/llms-full.txt

@@ -5,7 +5,7 @@
 > All variant values and props verified from source CVA definitions.
 >
 > Package: @devalok/shilp-sutra
-> Version: 0.23.3
+> Version: 0.24.0
 
 ---
 

package/llms.txt

@@ -320,7 +320,8 @@ NOTIFICATION SELECTION GUIDE:
 - RichTextEditor: Tiptap editor — bold/italic/underline/strike/highlight, headings, blockquote, lists (bullet/ordered/task), code, links, images (paste/drop/upload), file attachments, @mentions, emoji picker + :shortcode:, text alignment, HR. Props: onImageUpload?, onFileUpload?, mentions?, onMentionSearch?, onMentionSelect?(item: MentionItem)
 - RichTextViewer: read-only renderer for RichTextEditor HTML content (renders all above content types)
 - ActivityFeed: items(ActivityItem[]), onLoadMore, loading, hasMore, emptyState, compact, maxInitialItems, groupBy?('time'|'none'), groupLabels?({ today, yesterday, thisWeek, older }). Type: ActivityItem = { id, actor?, action, timestamp, icon?, color?, detail? }. Utility: groupItemsByTime(items, labels) exported.
-- CommandPalette, MemberPicker
+- CommandPalette: open, defaultOpen, onOpenChange (controlled/uncontrolled), keybinding(string|string[]|false), maxHeight, emptyState(ReactNode), footerHints(FooterHint[]|false). CommandItem: label(string|ReactNode), description(string|ReactNode), renderLabel(query=>ReactNode), filterValue(string), shortcut(rendered as keycap badges). Keyboard shortcuts rendered per-key with platform-aware Cmd/Ctrl. Reduced-motion support via MotionProvider.
+- MemberPicker
 - ErrorDisplay, GlobalLoading
 - Loading skeletons: CardSkeleton, TableSkeleton, BoardSkeleton, ListSkeleton
 - Page skeletons: DashboardSkeleton, ProjectListSkeleton, TaskDetailSkeleton (no props, server-safe)
@@ -342,7 +343,7 @@ NOTIFICATION SELECTION GUIDE:
 - BottomNavbar: mobile navigation, user is optional. Types: BottomNavItem = { title, href, icon, exact?, badge? }, BottomNavbarUser = { name, role? }
 - NotificationCenter: notifications[], onMarkRead, onMarkAllRead, onNavigate, getNotificationRoute?, footerSlot?, emptyState?, headerActions?, popoverClassName?, onDismiss?(id). Types: Notification = { id, title, body?, tier, isRead, createdAt, entityType?, entityId?, projectId?, project?, actions? }, NotificationAction = { label, variant?, onClick }
 - NotificationPreferences: preferences[], projects[], onSave, onToggleMute, onUpdateTier, onDelete. Types: NotificationPreference = { id, userId?, projectId, channel, minTier, muted }, NotificationProject = { id, title }
-- AppCommandPalette: user, isAdmin, onNavigate, onSearch, searchResults, isSearching, onSearchResultSelect. Types: SearchResult = { id, title, snippet?, entityType, projectId?, metadata? }, AppCommandPaletteUser = { name, role? }
+- AppCommandPalette: user, isAdmin, onNavigate, onSearch, searchResults, searchResultGroups(SearchResultGroup[]), isSearching, onSearchResultSelect (when provided, consumer owns routing — no internal URL computation), searchResultsLabel(string|((count)=>string)), open, defaultOpen, onOpenChange, keybinding, maxHeight, emptyState, footerHints. Types: SearchResult = { id, title, snippet?, entityType, projectId?, metadata?, icon?(ReactNode), rank?(number), shortcut?(string) }, SearchResultGroup = { label, results: SearchResult[] }, AppCommandPaletteUser = { name, role? }
 - LinkProvider: wraps app with router-agnostic Link component — component(ForwardRefComponent), children. useLink() hook returns the Link component.
 
 ### Motion System (Framer Motion)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devalok/shilp-sutra",
-  "version": "0.23.3",
+  "version": "0.24.0",
   "description": "Devalok Design System — tokens, components, and patterns for Next.js",
   "license": "MIT",
   "type": "module",