@entifix/next-shell 0.1.0-0

package/dist/lib/back-office/nav.d.ts

@@ -0,0 +1,39 @@
+import type { ScreenType } from '@entifix/authz';
+import type { ReactNode } from 'react';
+export interface NavItem {
+    label: string;
+    href: string;
+    /** Optional leading glyph, shown in both expanded and collapsed states. */
+    icon?: ReactNode;
+    /**
+     * When set, the item also offers "Open in workspace" — a link to
+     * `/workspace?tab=<workspace>` that opens this destination as a persisted tab
+     * instead of navigating the whole page.
+     */
+    workspace?: string;
+}
+export interface NavSection {
+    /** The domain group's heading, already translated. */
+    title?: string;
+    items: NavItem[];
+    /**
+     * What shape these screens are — the sidebar's **top tier**, above the domain
+     * ([ADR 0033](../../../../../../../docs/adr/0033-the-screen-taxonomy.md)).
+     *
+     * A `ScreenType` rather than a translated string, unlike `title`: the four
+     * names are one shipped vocabulary that `SCREEN_TYPE_LABEL_KEYS` maps into the
+     * `shell:` namespace, so this component resolves them itself. A host that
+     * translated them would be translating copy it does not own.
+     *
+     * **Optional, and narrowly so.** A section with no type is not a fifth
+     * category, it is a section that is not a screen group at all — the account
+     * surface is the one case. Untyped sections render below every typed one.
+     */
+    type?: ScreenType;
+}
+/** A tier of the sidebar: the sections sharing one {@link ScreenType}. */
+export interface NavTier {
+    type?: ScreenType;
+    sections: NavSection[];
+}
+//# sourceMappingURL=nav.d.ts.map

package/dist/lib/back-office/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../../src/lib/back-office/nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB"}

package/dist/lib/back-office/nav.js

@@ -0,0 +1,3 @@
+/** A tier of the sidebar: the sections sharing one {@link ScreenType}. */ export { };
+
+//# sourceMappingURL=nav.js.map

package/dist/lib/back-office/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/back-office/nav.ts"],"sourcesContent":["import type { ScreenType } from '@entifix/authz';\nimport type { ReactNode } from 'react';\n\nexport interface NavItem {\n  label: string;\n  href: string;\n  /** Optional leading glyph, shown in both expanded and collapsed states. */\n  icon?: ReactNode;\n  /**\n   * When set, the item also offers \"Open in workspace\" — a link to\n   * `/workspace?tab=<workspace>` that opens this destination as a persisted tab\n   * instead of navigating the whole page.\n   */\n  workspace?: string;\n}\n\nexport interface NavSection {\n  /** The domain group's heading, already translated. */\n  title?: string;\n  items: NavItem[];\n  /**\n   * What shape these screens are — the sidebar's **top tier**, above the domain\n   * ([ADR 0033](../../../../../../../docs/adr/0033-the-screen-taxonomy.md)).\n   *\n   * A `ScreenType` rather than a translated string, unlike `title`: the four\n   * names are one shipped vocabulary that `SCREEN_TYPE_LABEL_KEYS` maps into the\n   * `shell:` namespace, so this component resolves them itself. A host that\n   * translated them would be translating copy it does not own.\n   *\n   * **Optional, and narrowly so.** A section with no type is not a fifth\n   * category, it is a section that is not a screen group at all — the account\n   * surface is the one case. Untyped sections render below every typed one.\n   */\n  type?: ScreenType;\n}\n\n/** A tier of the sidebar: the sections sharing one {@link ScreenType}. */\nexport interface NavTier {\n  type?: ScreenType;\n  sections: NavSection[];\n}\n"],"names":[],"mappings":"AAoCA,wEAAwE,GACxE,WAGC"}

package/dist/lib/back-office/sidebar-nav.d.ts

@@ -0,0 +1,26 @@
+import type { NavSection } from './nav.js';
+export interface SidebarNavProps {
+    sections: NavSection[];
+    /** When collapsed, labels and headings hide; only icons remain. */
+    collapsed?: boolean;
+    /** Which domain groups are collapsed, keyed by heading. */
+    collapsedGroups?: Record<string, boolean>;
+    onToggleGroup?: (title: string) => void;
+}
+/** A path is active when it equals the item href or is nested beneath it. */
+export declare function isActive(pathname: string, href: string): boolean;
+/**
+ * The back office's primary navigation: screen type › domain › destination.
+ *
+ * The top tier is the **type**, not the domain (ADR 0033). Four fixed entries
+ * against the eleven domains ADR 0022 fixes for v1, so a new operator has one
+ * place to look; the daily operator's speed is the command palette's job.
+ *
+ * **Collapsed mode deliberately does not nest.** The icon column stays flat and
+ * every group becomes a labelled separator, because a flyout submenu would cost
+ * an extra click per navigation to precisely the operator who chose the compact
+ * mode. What collapsing hides is labels, and the per-item tooltip already
+ * returns those. Group collapse is therefore an expanded-mode affordance.
+ */
+export declare function SidebarNav({ sections, collapsed, collapsedGroups, onToggleGroup, }: SidebarNavProps): import("react").JSX.Element;
+//# sourceMappingURL=sidebar-nav.d.ts.map

package/dist/lib/back-office/sidebar-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-nav.d.ts","sourceRoot":"","sources":["../../../src/lib/back-office/sidebar-nav.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,UAAU,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhE;AA+ED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,SAAiB,EACjB,eAAoB,EACpB,aAAa,GACd,EAAE,eAAe,+BA2GjB"}

package/dist/lib/back-office/sidebar-nav.js

@@ -0,0 +1,181 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { SCREEN_TYPE_LABEL_KEYS } from '@entifix/authz';
+import { cn, useT, useTranslateKey } from '@entifix/react-controls';
+import { usePathname } from 'next/navigation';
+import { useMemo } from 'react';
+import { LocaleLink, useLocaleHref } from '../i18n/index.js';
+import { groupByScreenType } from './group-by-screen-type.js';
+/** A path is active when it equals the item href or is nested beneath it. */ export function isActive(pathname, href) {
+    return pathname === href || pathname.startsWith(`${href}/`);
+}
+const workspaceHref = (workspace)=>`/workspace?tab=${encodeURIComponent(workspace)}`;
+/**
+ * The two "open where" choices for one destination.
+ *
+ * Both used to be either absent or invisible. The workspace link existed but was
+ * `opacity-0` until `group-hover/nav` — undiscoverable on touch, where there is
+ * no hover — and was dropped entirely while collapsed, which is the mode a power
+ * operator lives in. There was no open-in-a-browser-tab control at all; middle
+ * click worked by accident, and only with a mouse.
+ *
+ * They are now always rendered and always focusable. `text-content-muted` plus a
+ * hover/focus lift is what keeps a permanently visible control from competing
+ * with the destination itself — the affordance is quiet, not hidden.
+ */ function ItemActions({ item, label }) {
+    const t = useT('shell');
+    const withLocale = useLocaleHref();
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            item.workspace !== undefined && /*#__PURE__*/ _jsx(LocaleLink, {
+                href: workspaceHref(item.workspace),
+                "aria-label": t('nav.openInWorkspace', {
+                    label
+                }),
+                title: t('nav.openInWorkspaceShort'),
+                className: "rounded shrink-0 p-3xs text-content-muted focus-ring transition-colors hover:bg-surface hover:text-content",
+                children: /*#__PURE__*/ _jsx("span", {
+                    "aria-hidden": "true",
+                    children: "⧉"
+                })
+            }),
+            /*#__PURE__*/ _jsx("a", {
+                href: withLocale(item.href),
+                target: "_blank",
+                rel: "noopener noreferrer",
+                "aria-label": t('nav.openInNewTab', {
+                    label
+                }),
+                title: t('nav.openInNewTabShort'),
+                className: "rounded shrink-0 p-3xs text-content-muted focus-ring transition-colors hover:bg-surface hover:text-content",
+                children: /*#__PURE__*/ _jsx("span", {
+                    "aria-hidden": "true",
+                    children: "↗"
+                })
+            })
+        ]
+    });
+}
+function ItemLink({ item, active, collapsed }) {
+    return /*#__PURE__*/ _jsxs(LocaleLink, {
+        href: item.href,
+        "aria-current": active ? 'page' : undefined,
+        title: collapsed ? item.label : undefined,
+        className: cn('flex flex-1 items-center gap-2xs rounded-md px-2xs py-3xs text-step-sm focus-ring transition-colors', active ? 'bg-primary text-primary-content' : 'text-content hover:bg-surface'),
+        children: [
+            item.icon !== undefined && /*#__PURE__*/ _jsx("span", {
+                "aria-hidden": "true",
+                className: "shrink-0",
+                children: item.icon
+            }),
+            !collapsed && /*#__PURE__*/ _jsx("span", {
+                className: "truncate",
+                children: item.label
+            })
+        ]
+    });
+}
+/**
+ * The back office's primary navigation: screen type › domain › destination.
+ *
+ * The top tier is the **type**, not the domain (ADR 0033). Four fixed entries
+ * against the eleven domains ADR 0022 fixes for v1, so a new operator has one
+ * place to look; the daily operator's speed is the command palette's job.
+ *
+ * **Collapsed mode deliberately does not nest.** The icon column stays flat and
+ * every group becomes a labelled separator, because a flyout submenu would cost
+ * an extra click per navigation to precisely the operator who chose the compact
+ * mode. What collapsing hides is labels, and the per-item tooltip already
+ * returns those. Group collapse is therefore an expanded-mode affordance.
+ */ export function SidebarNav({ sections, collapsed = false, collapsedGroups = {}, onToggleGroup }) {
+    var _usePathname;
+    const t = useT('shell');
+    // The four type names are `shell:` copy owned by `@entifix/authz`'s
+    // `SCREEN_TYPE_LABEL_KEYS`, so they arrive as fully-qualified keys rather than
+    // as names in this namespace — the documented escape hatch, not authored copy.
+    const translateKey = useTranslateKey();
+    const pathname = (_usePathname = usePathname()) != null ? _usePathname : '';
+    const tiers = useMemo(()=>groupByScreenType(sections), [
+        sections
+    ]);
+    return /*#__PURE__*/ _jsx("nav", {
+        "aria-label": t('nav.primary'),
+        className: "flex flex-col gap-m",
+        children: tiers.map((tier, tierIndex)=>{
+            var _tier_type;
+            return /*#__PURE__*/ _jsxs("div", {
+                className: "flex flex-col gap-2xs",
+                children: [
+                    tier.type !== undefined && !collapsed && /*#__PURE__*/ _jsx("p", {
+                        className: "tracking-wide px-2xs text-step-xs font-semibold text-content uppercase",
+                        children: translateKey(SCREEN_TYPE_LABEL_KEYS[tier.type])
+                    }),
+                    collapsed && tierIndex > 0 && /*#__PURE__*/ _jsx("hr", {
+                        className: "border-border",
+                        "aria-hidden": "true"
+                    }),
+                    /*#__PURE__*/ _jsx("div", _extends({
+                        className: "flex flex-col gap-2xs"
+                    }, tier.type === undefined ? {} : {
+                        role: 'group',
+                        'aria-label': translateKey(SCREEN_TYPE_LABEL_KEYS[tier.type])
+                    }, {
+                        children: tier.sections.map((section, sectionIndex)=>{
+                            const title = section.title;
+                            const groupCollapsed = title !== undefined && collapsedGroups[title] === true;
+                            // A collapsed group holding the active route still shows where you
+                            // are — otherwise collapsing a group hides the answer.
+                            const hasActive = section.items.some((item)=>isActive(pathname, item.href));
+                            return /*#__PURE__*/ _jsxs("div", {
+                                className: "flex flex-col gap-3xs",
+                                children: [
+                                    title !== undefined && !collapsed && (onToggleGroup === undefined ? /*#__PURE__*/ _jsx("p", {
+                                        className: "tracking-wide px-2xs text-step-xs text-content-muted uppercase",
+                                        children: title
+                                    }) : /*#__PURE__*/ _jsxs("button", {
+                                        type: "button",
+                                        onClick: ()=>onToggleGroup(title),
+                                        "aria-expanded": !groupCollapsed,
+                                        "aria-label": groupCollapsed ? t('sidebar.expandGroup', {
+                                            group: title
+                                        }) : t('sidebar.collapseGroup', {
+                                            group: title
+                                        }),
+                                        className: cn('rounded tracking-wide flex items-center gap-3xs px-2xs text-step-xs uppercase focus-ring transition-colors hover:text-content', groupCollapsed && hasActive ? 'text-content' : 'text-content-muted'),
+                                        children: [
+                                            /*#__PURE__*/ _jsx("span", {
+                                                "aria-hidden": "true",
+                                                children: groupCollapsed ? '▸' : '▾'
+                                            }),
+                                            /*#__PURE__*/ _jsx("span", {
+                                                className: "truncate",
+                                                children: title
+                                            })
+                                        ]
+                                    })),
+                                    !(groupCollapsed && !collapsed) && section.items.map((item)=>/*#__PURE__*/ _jsxs("div", {
+                                            className: "flex items-center gap-3xs",
+                                            children: [
+                                                /*#__PURE__*/ _jsx(ItemLink, {
+                                                    item: item,
+                                                    active: isActive(pathname, item.href),
+                                                    collapsed: collapsed
+                                                }),
+                                                !collapsed && /*#__PURE__*/ _jsx(ItemActions, {
+                                                    item: item,
+                                                    label: item.label
+                                                })
+                                            ]
+                                        }, item.href))
+                                ]
+                            }, title != null ? title : `section-${sectionIndex}`);
+                        })
+                    }))
+                ]
+            }, (_tier_type = tier.type) != null ? _tier_type : `tier-${tierIndex}`);
+        })
+    });
+}
+
+//# sourceMappingURL=sidebar-nav.js.map

package/dist/lib/back-office/sidebar-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/back-office/sidebar-nav.tsx"],"sourcesContent":["'use client';\n\nimport { SCREEN_TYPE_LABEL_KEYS } from '@entifix/authz';\nimport { cn, useT, useTranslateKey } from '@entifix/react-controls';\nimport { usePathname } from 'next/navigation';\nimport { useMemo } from 'react';\n\nimport { LocaleLink, useLocaleHref } from '../i18n/index.js';\nimport { groupByScreenType } from './group-by-screen-type.js';\nimport type { NavItem, NavSection } from './nav.js';\n\nexport interface SidebarNavProps {\n  sections: NavSection[];\n  /** When collapsed, labels and headings hide; only icons remain. */\n  collapsed?: boolean;\n  /** Which domain groups are collapsed, keyed by heading. */\n  collapsedGroups?: Record<string, boolean>;\n  onToggleGroup?: (title: string) => void;\n}\n\n/** A path is active when it equals the item href or is nested beneath it. */\nexport function isActive(pathname: string, href: string): boolean {\n  return pathname === href || pathname.startsWith(`${href}/`);\n}\n\nconst workspaceHref = (workspace: string) =>\n  `/workspace?tab=${encodeURIComponent(workspace)}`;\n\n/**\n * The two \"open where\" choices for one destination.\n *\n * Both used to be either absent or invisible. The workspace link existed but was\n * `opacity-0` until `group-hover/nav` — undiscoverable on touch, where there is\n * no hover — and was dropped entirely while collapsed, which is the mode a power\n * operator lives in. There was no open-in-a-browser-tab control at all; middle\n * click worked by accident, and only with a mouse.\n *\n * They are now always rendered and always focusable. `text-content-muted` plus a\n * hover/focus lift is what keeps a permanently visible control from competing\n * with the destination itself — the affordance is quiet, not hidden.\n */\nfunction ItemActions({ item, label }: { item: NavItem; label: string }) {\n  const t = useT('shell');\n  const withLocale = useLocaleHref();\n\n  return (\n    <>\n      {item.workspace !== undefined && (\n        <LocaleLink\n          href={workspaceHref(item.workspace)}\n          aria-label={t('nav.openInWorkspace', { label })}\n          title={t('nav.openInWorkspaceShort')}\n          className=\"rounded shrink-0 p-3xs text-content-muted focus-ring transition-colors hover:bg-surface hover:text-content\"\n        >\n          <span aria-hidden=\"true\">⧉</span>\n        </LocaleLink>\n      )}\n      <a\n        href={withLocale(item.href)}\n        target=\"_blank\"\n        rel=\"noopener noreferrer\"\n        aria-label={t('nav.openInNewTab', { label })}\n        title={t('nav.openInNewTabShort')}\n        className=\"rounded shrink-0 p-3xs text-content-muted focus-ring transition-colors hover:bg-surface hover:text-content\"\n      >\n        <span aria-hidden=\"true\">↗</span>\n      </a>\n    </>\n  );\n}\n\nfunction ItemLink({\n  item,\n  active,\n  collapsed,\n}: {\n  item: NavItem;\n  active: boolean;\n  collapsed: boolean;\n}) {\n  return (\n    <LocaleLink\n      href={item.href}\n      aria-current={active ? 'page' : undefined}\n      title={collapsed ? item.label : undefined}\n      className={cn(\n        'flex flex-1 items-center gap-2xs rounded-md px-2xs py-3xs text-step-sm focus-ring transition-colors',\n        active\n          ? 'bg-primary text-primary-content'\n          : 'text-content hover:bg-surface',\n      )}\n    >\n      {item.icon !== undefined && (\n        <span aria-hidden=\"true\" className=\"shrink-0\">\n          {item.icon}\n        </span>\n      )}\n      {!collapsed && <span className=\"truncate\">{item.label}</span>}\n    </LocaleLink>\n  );\n}\n\n/**\n * The back office's primary navigation: screen type › domain › destination.\n *\n * The top tier is the **type**, not the domain (ADR 0033). Four fixed entries\n * against the eleven domains ADR 0022 fixes for v1, so a new operator has one\n * place to look; the daily operator's speed is the command palette's job.\n *\n * **Collapsed mode deliberately does not nest.** The icon column stays flat and\n * every group becomes a labelled separator, because a flyout submenu would cost\n * an extra click per navigation to precisely the operator who chose the compact\n * mode. What collapsing hides is labels, and the per-item tooltip already\n * returns those. Group collapse is therefore an expanded-mode affordance.\n */\nexport function SidebarNav({\n  sections,\n  collapsed = false,\n  collapsedGroups = {},\n  onToggleGroup,\n}: SidebarNavProps) {\n  const t = useT('shell');\n  // The four type names are `shell:` copy owned by `@entifix/authz`'s\n  // `SCREEN_TYPE_LABEL_KEYS`, so they arrive as fully-qualified keys rather than\n  // as names in this namespace — the documented escape hatch, not authored copy.\n  const translateKey = useTranslateKey();\n  const pathname = usePathname() ?? '';\n  const tiers = useMemo(() => groupByScreenType(sections), [sections]);\n\n  return (\n    <nav aria-label={t('nav.primary')} className=\"flex flex-col gap-m\">\n      {tiers.map((tier, tierIndex) => (\n        <div\n          key={tier.type ?? `tier-${tierIndex}`}\n          className=\"flex flex-col gap-2xs\"\n        >\n          {tier.type !== undefined && !collapsed && (\n            <p className=\"tracking-wide px-2xs text-step-xs font-semibold text-content uppercase\">\n              {translateKey(SCREEN_TYPE_LABEL_KEYS[tier.type])}\n            </p>\n          )}\n          {/* Collapsed, the heading is gone but the grouping is not: a rule plus\n              an accessible name is what keeps the icon column from reading as\n              one undifferentiated list. */}\n          {collapsed && tierIndex > 0 && (\n            <hr className=\"border-border\" aria-hidden=\"true\" />\n          )}\n          {/* `role=\"group\"` only where there is a name for it. An unnamed group\n              is announced as an empty landmark, which is noise rather than\n              structure — and the untyped section is not a screen group at all. */}\n          <div\n            className=\"flex flex-col gap-2xs\"\n            {...(tier.type === undefined\n              ? {}\n              : {\n                  role: 'group',\n                  'aria-label': translateKey(SCREEN_TYPE_LABEL_KEYS[tier.type]),\n                })}\n          >\n            {tier.sections.map((section, sectionIndex) => {\n              const title = section.title;\n              const groupCollapsed =\n                title !== undefined && collapsedGroups[title] === true;\n              // A collapsed group holding the active route still shows where you\n              // are — otherwise collapsing a group hides the answer.\n              const hasActive = section.items.some(item =>\n                isActive(pathname, item.href),\n              );\n\n              return (\n                <div\n                  key={title ?? `section-${sectionIndex}`}\n                  className=\"flex flex-col gap-3xs\"\n                >\n                  {title !== undefined &&\n                    !collapsed &&\n                    (onToggleGroup === undefined ? (\n                      <p className=\"tracking-wide px-2xs text-step-xs text-content-muted uppercase\">\n                        {title}\n                      </p>\n                    ) : (\n                      <button\n                        type=\"button\"\n                        onClick={() => onToggleGroup(title)}\n                        aria-expanded={!groupCollapsed}\n                        aria-label={\n                          groupCollapsed\n                            ? t('sidebar.expandGroup', { group: title })\n                            : t('sidebar.collapseGroup', { group: title })\n                        }\n                        className={cn(\n                          'rounded tracking-wide flex items-center gap-3xs px-2xs text-step-xs uppercase focus-ring transition-colors hover:text-content',\n                          groupCollapsed && hasActive\n                            ? 'text-content'\n                            : 'text-content-muted',\n                        )}\n                      >\n                        <span aria-hidden=\"true\">\n                          {groupCollapsed ? '▸' : '▾'}\n                        </span>\n                        <span className=\"truncate\">{title}</span>\n                      </button>\n                    ))}\n                  {!(groupCollapsed && !collapsed) &&\n                    section.items.map(item => (\n                      <div\n                        key={item.href}\n                        className=\"flex items-center gap-3xs\"\n                      >\n                        <ItemLink\n                          item={item}\n                          active={isActive(pathname, item.href)}\n                          collapsed={collapsed}\n                        />\n                        {!collapsed && (\n                          <ItemActions item={item} label={item.label} />\n                        )}\n                      </div>\n                    ))}\n                </div>\n              );\n            })}\n          </div>\n        </div>\n      ))}\n    </nav>\n  );\n}\n"],"names":["SCREEN_TYPE_LABEL_KEYS","cn","useT","useTranslateKey","usePathname","useMemo","LocaleLink","useLocaleHref","groupByScreenType","isActive","pathname","href","startsWith","workspaceHref","workspace","encodeURIComponent","ItemActions","item","label","t","withLocale","undefined","aria-label","title","className","span","aria-hidden","a","target","rel","ItemLink","active","collapsed","aria-current","icon","SidebarNav","sections","collapsedGroups","onToggleGroup","translateKey","tiers","nav","map","tier","tierIndex","div","type","p","hr","role","section","sectionIndex","groupCollapsed","hasActive","items","some","button","onClick","aria-expanded","group"],"mappings":"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"}

package/dist/lib/command-palette/command-palette-host.d.ts

@@ -0,0 +1,41 @@
+import type { NavSection } from '../back-office/nav.js';
+import type { PaletteCommand } from './palette-command.js';
+import { type UseCaseCommandEntity } from './use-use-cases-source.js';
+export interface CommandPaletteHostProps {
+    /**
+     * Deterministic commands, already permission-filtered and translated by the
+     * server layout that has the principal.
+     */
+    readonly commands: readonly PaletteCommand[];
+    /** The same resolved nav tree the sidebar renders. */
+    readonly nav: readonly NavSection[];
+    /**
+     * Entities whose served `$metadata` contributes `unbound` verbs, with the
+     * handler for each.
+     *
+     * ⚠️ Must be a **module-scope constant**: the sources are produced by a hook
+     * per entity, so a fresh array each render changes the hook count. See
+     * `useUseCaseSources`.
+     */
+    readonly useCaseEntities?: readonly UseCaseCommandEntity[];
+}
+/**
+ * The back office's command palette: its trigger, its shortcuts, and everything
+ * it can reach.
+ *
+ * This is the composition point. The control in `@entifix/react-controls` is
+ * presentational and the sources are hooks; what lives here is the small set of
+ * decisions neither can make — which sources a typed prefix asks for, what
+ * selecting an option does, and when to ask first.
+ *
+ * **The grammar is for entry, the stack is for depth.** `>` narrows to commands
+ * and actions, `#` to records, and anything else searches everything. Descending
+ * into "Nuevo…" is a pushed page rather than a third prefix, because a prefix has
+ * to be remembered and a list can be read.
+ *
+ * The whole thing is mounted in the chrome, so it is reachable from every route
+ * the back office serves — including `/workspace`, which is where the open-tabs
+ * group has anything in it.
+ */
+export declare function CommandPaletteHost({ commands, nav, useCaseEntities, }: CommandPaletteHostProps): import("react").JSX.Element;
+//# sourceMappingURL=command-palette-host.d.ts.map

package/dist/lib/command-palette/command-palette-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette-host.d.ts","sourceRoot":"","sources":["../../../src/lib/command-palette/command-palette-host.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,2BAA2B,CAAC;AAmBnC,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC5D;AAWD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,GAAG,EACH,eAA6B,GAC9B,EAAE,uBAAuB,+BA6JzB"}

package/dist/lib/command-palette/command-palette-host.js

@@ -0,0 +1,196 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { NEW_COMMAND_PAGE } from '@entifix/authz';
+import { parseCommandTerm, ROOT_COMMAND_PAGE } from '@entifix/core';
+import { Button, CommandPalette, ConfirmDialog, useHotkey, useT } from '@entifix/react-controls';
+import { useRouter } from 'next/navigation';
+import { useState } from 'react';
+import { useCommandRecency } from './use-command-recency.js';
+import { useCommandSource } from './use-command-source.js';
+import { useNavSource } from './use-nav-source.js';
+import { useRecordsSource } from './use-records-source.js';
+import { useTabsSource } from './use-tabs-source.js';
+import { useUseCaseSources } from './use-use-cases-source.js';
+/**
+ * ⌘K **and** ⌘⇧P, and neither is load-bearing.
+ *
+ * #112 argued for ⌘⇧P alone because Chrome and Firefox claim ⌘K for address-bar
+ * search. That is half the picture: ⌘⇧P / Ctrl+Shift+P is Firefox's private
+ * window, so **both** candidates collide somewhere. ⌘K is also what Linear,
+ * GitHub, Slack and Vercel trained people on, so leaving it unbound costs a
+ * reflex.
+ *
+ * Binding both, plus a permanently visible trigger, is what makes the collision
+ * a non-issue: whichever a given browser swallows, two other ways in remain.
+ */ const HOTKEYS = [
+    {
+        key: 'k',
+        mod: true
+    },
+    {
+        key: 'p',
+        mod: true,
+        shift: true
+    }
+];
+const NO_ENTITIES = [];
+/**
+ * The back office's command palette: its trigger, its shortcuts, and everything
+ * it can reach.
+ *
+ * This is the composition point. The control in `@entifix/react-controls` is
+ * presentational and the sources are hooks; what lives here is the small set of
+ * decisions neither can make — which sources a typed prefix asks for, what
+ * selecting an option does, and when to ask first.
+ *
+ * **The grammar is for entry, the stack is for depth.** `>` narrows to commands
+ * and actions, `#` to records, and anything else searches everything. Descending
+ * into "Nuevo…" is a pushed page rather than a third prefix, because a prefix has
+ * to be remembered and a list can be read.
+ *
+ * The whole thing is mounted in the chrome, so it is reachable from every route
+ * the back office serves — including `/workspace`, which is where the open-tabs
+ * group has anything in it.
+ */ export function CommandPaletteHost({ commands, nav, useCaseEntities = NO_ENTITIES }) {
+    const t = useT('shell');
+    const router = useRouter();
+    const recency = useCommandRecency();
+    const [open, setOpen] = useState(false);
+    const [rawTerm, setRawTerm] = useState('');
+    const [stack, setStack] = useState([]);
+    const [pending, setPending] = useState(null);
+    const { scope, term } = parseCommandTerm(rawTerm);
+    // Every source runs on every render — the hook count may not depend on the
+    // page or the prefix. What those decide is which sources are *shown*, which is
+    // why each returns a whole `CommandSource` instead of being called
+    // conditionally. So the root's commands and the create page's are two sources
+    // rather than one that reads the stack.
+    const commandSource = useCommandSource(commands, term, undefined);
+    const createSource = useCommandSource(commands, term, NEW_COMMAND_PAGE);
+    const useCaseSources = useUseCaseSources(useCaseEntities, term);
+    const navSource = useNavSource(nav, term);
+    const tabsSource = useTabsSource(term);
+    const recordsSource = useRecordsSource(term, // A record fan-out is four authenticated requests per keystroke, so it is
+    // spent only where its answer is rendered: not while closed, not while the
+    // prefix says commands, and not on a pushed page, which shows its own
+    // sources and nothing else.
+    open && scope !== 'commands' && stack.length === 0);
+    const rank = (source)=>_extends({}, source, {
+            groups: source.groups.map(recency.rank)
+        });
+    const rootSources = scope === 'records' ? [
+        recordsSource
+    ] : scope === 'commands' ? [
+        commandSource,
+        ...useCaseSources
+    ] : [
+        commandSource,
+        ...useCaseSources,
+        navSource,
+        tabsSource,
+        recordsSource
+    ];
+    const pages = [
+        {
+            id: ROOT_COMMAND_PAGE,
+            placeholder: t('commandPalette.placeholder'),
+            sources: rootSources.map(rank)
+        },
+        {
+            id: NEW_COMMAND_PAGE,
+            title: t('commandPalette.newTitle'),
+            placeholder: t('commandPalette.newPlaceholder'),
+            sources: [
+                rank(createSource)
+            ]
+        }
+    ];
+    const labels = {
+        title: t('commandPalette.title'),
+        empty: t('commandPalette.empty'),
+        loading: t('commandPalette.loading'),
+        more: (remaining)=>t('commandPalette.more', {
+                count: remaining
+            }),
+        back: t('commandPalette.back')
+    };
+    const close = ()=>{
+        setOpen(false);
+        setPending(null);
+    };
+    // Opening resets the term and the stack in the same handler that opens it,
+    // rather than from an effect keyed on `open` — a fresh palette is a fact about
+    // this event, not something to react to afterwards.
+    const openPalette = ()=>{
+        setRawTerm('');
+        setStack([]);
+        setPending(null);
+        setOpen(true);
+    };
+    useHotkey(HOTKEYS, openPalette);
+    const perform = (option)=>{
+        recency.remember(option.id);
+        close();
+        if (option.href !== undefined) {
+            router.push(option.href);
+            return;
+        }
+        // A rejected command is the handler's to report — it owns the request and
+        // therefore the only context in which the failure means anything. Letting it
+        // reject unhandled here would surface as an unhandled rejection instead.
+        void (option.run == null ? void 0 : option.run.call(option));
+    };
+    const select = (option)=>{
+        if (option.confirm !== undefined) {
+            // The palette closes and the question stands alone. Leaving the list
+            // behind a modal invites a second selection against a dialog that is
+            // already about the first one.
+            setOpen(false);
+            setPending({
+                option,
+                message: option.confirm.message,
+                tone: option.confirm.tone
+            });
+            return;
+        }
+        perform(option);
+    };
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                type: "button",
+                variant: "ghost",
+                size: "sm",
+                onClick: openPalette,
+                "data-testid": "command-palette-trigger",
+                children: t('commandPalette.open')
+            }),
+            /*#__PURE__*/ _jsx(CommandPalette, {
+                open: open,
+                onClose: close,
+                pages: pages,
+                stack: stack,
+                onStackChange: setStack,
+                term: rawTerm,
+                onTermChange: setRawTerm,
+                onSelect: select,
+                labels: labels
+            }),
+            pending !== null && /*#__PURE__*/ _jsx(ConfirmDialog, {
+                open: true,
+                title: pending.option.label,
+                message: pending.message,
+                tone: pending.tone,
+                onConfirm: ()=>{
+                    const option = pending.option;
+                    setPending(null);
+                    perform(option);
+                },
+                onCancel: ()=>setPending(null)
+            })
+        ]
+    });
+}
+
+//# sourceMappingURL=command-palette-host.js.map

package/dist/lib/command-palette/command-palette-host.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/command-palette/command-palette-host.tsx"],"sourcesContent":["'use client';\n\nimport { NEW_COMMAND_PAGE } from '@entifix/authz';\nimport {\n  type CommandOption,\n  type CommandPage,\n  type CommandSource,\n  parseCommandTerm,\n  ROOT_COMMAND_PAGE,\n} from '@entifix/core';\nimport {\n  Button,\n  CommandPalette,\n  type CommandPaletteLabels,\n  ConfirmDialog,\n  useHotkey,\n  useT,\n} from '@entifix/react-controls';\nimport { useRouter } from 'next/navigation';\nimport { useState } from 'react';\n\nimport type { NavSection } from '../back-office/nav.js';\nimport type { PaletteCommand } from './palette-command.js';\nimport { useCommandRecency } from './use-command-recency.js';\nimport { useCommandSource } from './use-command-source.js';\nimport { useNavSource } from './use-nav-source.js';\nimport { useRecordsSource } from './use-records-source.js';\nimport { useTabsSource } from './use-tabs-source.js';\nimport {\n  type UseCaseCommandEntity,\n  useUseCaseSources,\n} from './use-use-cases-source.js';\n\n/**\n * ⌘K **and** ⌘⇧P, and neither is load-bearing.\n *\n * #112 argued for ⌘⇧P alone because Chrome and Firefox claim ⌘K for address-bar\n * search. That is half the picture: ⌘⇧P / Ctrl+Shift+P is Firefox's private\n * window, so **both** candidates collide somewhere. ⌘K is also what Linear,\n * GitHub, Slack and Vercel trained people on, so leaving it unbound costs a\n * reflex.\n *\n * Binding both, plus a permanently visible trigger, is what makes the collision\n * a non-issue: whichever a given browser swallows, two other ways in remain.\n */\nconst HOTKEYS = [\n  { key: 'k', mod: true },\n  { key: 'p', mod: true, shift: true },\n] as const;\n\nexport interface CommandPaletteHostProps {\n  /**\n   * Deterministic commands, already permission-filtered and translated by the\n   * server layout that has the principal.\n   */\n  readonly commands: readonly PaletteCommand[];\n  /** The same resolved nav tree the sidebar renders. */\n  readonly nav: readonly NavSection[];\n  /**\n   * Entities whose served `$metadata` contributes `unbound` verbs, with the\n   * handler for each.\n   *\n   * ⚠️ Must be a **module-scope constant**: the sources are produced by a hook\n   * per entity, so a fresh array each render changes the hook count. See\n   * `useUseCaseSources`.\n   */\n  readonly useCaseEntities?: readonly UseCaseCommandEntity[];\n}\n\n/** A verb waiting on its confirmation. */\ninterface PendingConfirm {\n  readonly option: CommandOption;\n  readonly message: string;\n  readonly tone: 'destructive' | 'neutral';\n}\n\nconst NO_ENTITIES: readonly UseCaseCommandEntity[] = [];\n\n/**\n * The back office's command palette: its trigger, its shortcuts, and everything\n * it can reach.\n *\n * This is the composition point. The control in `@entifix/react-controls` is\n * presentational and the sources are hooks; what lives here is the small set of\n * decisions neither can make — which sources a typed prefix asks for, what\n * selecting an option does, and when to ask first.\n *\n * **The grammar is for entry, the stack is for depth.** `>` narrows to commands\n * and actions, `#` to records, and anything else searches everything. Descending\n * into \"Nuevo…\" is a pushed page rather than a third prefix, because a prefix has\n * to be remembered and a list can be read.\n *\n * The whole thing is mounted in the chrome, so it is reachable from every route\n * the back office serves — including `/workspace`, which is where the open-tabs\n * group has anything in it.\n */\nexport function CommandPaletteHost({\n  commands,\n  nav,\n  useCaseEntities = NO_ENTITIES,\n}: CommandPaletteHostProps) {\n  const t = useT('shell');\n  const router = useRouter();\n  const recency = useCommandRecency();\n\n  const [open, setOpen] = useState(false);\n  const [rawTerm, setRawTerm] = useState('');\n  const [stack, setStack] = useState<readonly string[]>([]);\n  const [pending, setPending] = useState<PendingConfirm | null>(null);\n\n  const { scope, term } = parseCommandTerm(rawTerm);\n\n  // Every source runs on every render — the hook count may not depend on the\n  // page or the prefix. What those decide is which sources are *shown*, which is\n  // why each returns a whole `CommandSource` instead of being called\n  // conditionally. So the root's commands and the create page's are two sources\n  // rather than one that reads the stack.\n  const commandSource = useCommandSource(commands, term, undefined);\n  const createSource = useCommandSource(commands, term, NEW_COMMAND_PAGE);\n  const useCaseSources = useUseCaseSources(useCaseEntities, term);\n  const navSource = useNavSource(nav, term);\n  const tabsSource = useTabsSource(term);\n  const recordsSource = useRecordsSource(\n    term,\n    // A record fan-out is four authenticated requests per keystroke, so it is\n    // spent only where its answer is rendered: not while closed, not while the\n    // prefix says commands, and not on a pushed page, which shows its own\n    // sources and nothing else.\n    open && scope !== 'commands' && stack.length === 0,\n  );\n\n  const rank = (source: CommandSource): CommandSource => ({\n    ...source,\n    groups: source.groups.map(recency.rank),\n  });\n\n  const rootSources: CommandSource[] =\n    scope === 'records'\n      ? [recordsSource]\n      : scope === 'commands'\n        ? [commandSource, ...useCaseSources]\n        : [\n            commandSource,\n            ...useCaseSources,\n            navSource,\n            tabsSource,\n            recordsSource,\n          ];\n\n  const pages: CommandPage[] = [\n    {\n      id: ROOT_COMMAND_PAGE,\n      placeholder: t('commandPalette.placeholder'),\n      sources: rootSources.map(rank),\n    },\n    {\n      id: NEW_COMMAND_PAGE,\n      title: t('commandPalette.newTitle'),\n      placeholder: t('commandPalette.newPlaceholder'),\n      sources: [rank(createSource)],\n    },\n  ];\n\n  const labels: CommandPaletteLabels = {\n    title: t('commandPalette.title'),\n    empty: t('commandPalette.empty'),\n    loading: t('commandPalette.loading'),\n    more: remaining => t('commandPalette.more', { count: remaining }),\n    back: t('commandPalette.back'),\n  };\n\n  const close = () => {\n    setOpen(false);\n    setPending(null);\n  };\n\n  // Opening resets the term and the stack in the same handler that opens it,\n  // rather than from an effect keyed on `open` — a fresh palette is a fact about\n  // this event, not something to react to afterwards.\n  const openPalette = () => {\n    setRawTerm('');\n    setStack([]);\n    setPending(null);\n    setOpen(true);\n  };\n\n  useHotkey(HOTKEYS, openPalette);\n\n  const perform = (option: CommandOption) => {\n    recency.remember(option.id);\n    close();\n    if (option.href !== undefined) {\n      router.push(option.href);\n      return;\n    }\n    // A rejected command is the handler's to report — it owns the request and\n    // therefore the only context in which the failure means anything. Letting it\n    // reject unhandled here would surface as an unhandled rejection instead.\n    void option.run?.();\n  };\n\n  const select = (option: CommandOption) => {\n    if (option.confirm !== undefined) {\n      // The palette closes and the question stands alone. Leaving the list\n      // behind a modal invites a second selection against a dialog that is\n      // already about the first one.\n      setOpen(false);\n      setPending({\n        option,\n        message: option.confirm.message,\n        tone: option.confirm.tone,\n      });\n      return;\n    }\n    perform(option);\n  };\n\n  return (\n    <>\n      <Button\n        type=\"button\"\n        variant=\"ghost\"\n        size=\"sm\"\n        onClick={openPalette}\n        data-testid=\"command-palette-trigger\"\n      >\n        {t('commandPalette.open')}\n      </Button>\n\n      <CommandPalette\n        open={open}\n        onClose={close}\n        pages={pages}\n        stack={stack}\n        onStackChange={setStack}\n        term={rawTerm}\n        onTermChange={setRawTerm}\n        onSelect={select}\n        labels={labels}\n      />\n\n      {pending !== null && (\n        <ConfirmDialog\n          open\n          title={pending.option.label}\n          message={pending.message}\n          tone={pending.tone}\n          onConfirm={() => {\n            const option = pending.option;\n            setPending(null);\n            perform(option);\n          }}\n          onCancel={() => setPending(null)}\n        />\n      )}\n    </>\n  );\n}\n"],"names":["NEW_COMMAND_PAGE","parseCommandTerm","ROOT_COMMAND_PAGE","Button","CommandPalette","ConfirmDialog","useHotkey","useT","useRouter","useState","useCommandRecency","useCommandSource","useNavSource","useRecordsSource","useTabsSource","useUseCaseSources","HOTKEYS","key","mod","shift","NO_ENTITIES","CommandPaletteHost","commands","nav","useCaseEntities","t","router","recency","open","setOpen","rawTerm","setRawTerm","stack","setStack","pending","setPending","scope","term","commandSource","undefined","createSource","useCaseSources","navSource","tabsSource","recordsSource","length","rank","source","groups","map","rootSources","pages","id","placeholder","sources","title","labels","empty","loading","more","remaining","count","back","close","openPalette","perform","option","remember","href","push","run","select","confirm","message","tone","type","variant","size","onClick","data-testid","onClose","onStackChange","onTermChange","onSelect","label","onConfirm","onCancel"],"mappings":"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"}

package/dist/lib/command-palette/index.d.ts

@@ -0,0 +1,9 @@
+export * from './command-palette-host.js';
+export * from './palette-command.js';
+export * from './use-command-recency.js';
+export * from './use-command-source.js';
+export * from './use-nav-source.js';
+export * from './use-records-source.js';
+export * from './use-tabs-source.js';
+export * from './use-use-cases-source.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/command-palette/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/command-palette/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC"}

package/dist/lib/command-palette/index.js

@@ -0,0 +1,10 @@
+export * from './command-palette-host.js';
+export * from './palette-command.js';
+export * from './use-command-recency.js';
+export * from './use-command-source.js';
+export * from './use-nav-source.js';
+export * from './use-records-source.js';
+export * from './use-tabs-source.js';
+export * from './use-use-cases-source.js';
+
+//# sourceMappingURL=index.js.map

package/dist/lib/command-palette/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/command-palette/index.ts"],"sourcesContent":["export * from './command-palette-host.js';\nexport * from './palette-command.js';\nexport * from './use-command-recency.js';\nexport * from './use-command-source.js';\nexport * from './use-nav-source.js';\nexport * from './use-records-source.js';\nexport * from './use-tabs-source.js';\nexport * from './use-use-cases-source.js';\n"],"names":[],"mappings":"AAAA,cAAc,4BAA4B;AAC1C,cAAc,uBAAuB;AACrC,cAAc,2BAA2B;AACzC,cAAc,0BAA0B;AACxC,cAAc,sBAAsB;AACpC,cAAc,0BAA0B;AACxC,cAAc,uBAAuB;AACrC,cAAc,4BAA4B"}

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

@@ -0,0 +1,32 @@
+/**
+ * A deterministic command, with its copy already resolved.
+ *
+ * The wire shape between a **server** layout — which is where `visibleNav`'s
+ * principal and the translate function live — and the client palette. So it is
+ * plain serializable data and nothing else: a `GuardedCommand` carries catalog
+ * keys and a `Permission`, neither of which a client component should have to
+ * deal with, and a function would not survive the crossing at all.
+ */
+export interface PaletteCommand {
+    /** Stable across renders and hosts. Also the recency key. */
+    readonly key: string;
+    readonly label: string;
+    /** Already split from the catalog's comma list by the host. */
+    readonly keywords: readonly string[];
+    /** Locale-free; the palette prefixes it. */
+    readonly href: string;
+    /** The page this command sits on. Omitted means the root. */
+    readonly page?: string;
+}
+/**
+ * How many characters before records are queried at all.
+ *
+ * The same floor `/api/search` enforces, restated here so the palette can *say*
+ * why a record group is absent instead of silently showing nothing. Below it the
+ * route answers empty groups, which would otherwise read as "no matches" for a
+ * search that never ran.
+ */
+export declare const RECORD_SEARCH_MIN_TERM = 2;
+/** How long after the last keystroke the fan-out runs. */
+export declare const RECORD_SEARCH_DEBOUNCE_MS = 250;
+//# sourceMappingURL=palette-command.d.ts.map