@entifix/react-controls 0.18.2 → 0.20.0

package/dist/ui/atoms/table/table.js

@@ -1,31 +1,80 @@
+'use client';
 import { _ as _extends } from "@swc/helpers/_/_extends";
 import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useRef, useState } from 'react';
 import { cn } from '../../utils/cn.js';
+/**
+ * Whether an element's content is larger than its box, on either axis —
+ * measured again whenever the box or the content it holds resizes.
+ */ function useOverflows(ref) {
+    const [overflows, setOverflows] = useState(false);
+    useEffect(()=>{
+        const node = ref.current;
+        const measure = ()=>setOverflows(node.scrollWidth > node.clientWidth || node.scrollHeight > node.clientHeight);
+        measure();
+        const observer = new ResizeObserver(measure);
+        observer.observe(node);
+        // The table grows with its rows while the container keeps its size.
+        for (const child of Array.from(node.children))observer.observe(child);
+        return ()=>observer.disconnect();
+    }, [
+        ref
+    ]);
+    return overflows;
+}
 /**
  * Styled table primitive — no entity knowledge, no data fetching. `EntityTable`
  * composes these; anything rendering non-entity tabular data can use them too.
  *
  * Wide tables scroll inside their own container rather than pushing the page
- * sideways.
+ * sideways. A container that scrolls is a **focusable region** named by the
+ * caption, so a keyboard can scroll it — and one that fits is neither, so it
+ * adds no tab stop that does nothing.
  */ export function Table(_0) {
-    let { className, containerClassName } = _0, props = _object_without_properties_loose(_0, [
+    let { className, containerClassName, caption, captionClassName = 'sr-only', children } = _0, props = _object_without_properties_loose(_0, [
         "className",
-        "containerClassName"
+        "containerClassName",
+        "caption",
+        "captionClassName",
+        "children"
     ]);
-    return /*#__PURE__*/ _jsx("div", {
-        className: cn('w-full overflow-x-auto rounded-xl border border-border bg-surface-elevated', containerClassName),
-        children: /*#__PURE__*/ _jsx("table", _extends({
+    const container = useRef(null);
+    const captionId = useId();
+    const overflows = useOverflows(container);
+    const named = caption !== undefined;
+    return /*#__PURE__*/ _jsx("div", _extends({
+        ref: container,
+        "data-overflows": overflows || undefined
+    }, overflows && {
+        tabIndex: 0,
+        role: named ? 'region' : undefined,
+        'aria-labelledby': named ? captionId : undefined
+    }, {
+        className: cn('w-full overflow-auto rounded-xl border border-border bg-surface-elevated focus-ring', containerClassName),
+        children: /*#__PURE__*/ _jsxs("table", _extends({
             className: cn('w-full border-collapse text-step-0 text-content', className)
-        }, props))
-    });
+        }, props, {
+            children: [
+                named && /*#__PURE__*/ _jsx("caption", {
+                    id: captionId,
+                    className: captionClassName,
+                    children: caption
+                }),
+                children
+            ]
+        }))
+    }));
 }
 export function TableHead(_0) {
     let { className } = _0, props = _object_without_properties_loose(_0, [
         "className"
     ]);
     return /*#__PURE__*/ _jsx("thead", _extends({
-        className: cn('border-b border-border bg-surface', className)
+        // Sticky inside a container that scrolls: the column names stay in view
+        // over a long page of rows. One layer above the rows, and no higher: a
+        // row menu opened under it must still paint over it.
+        className: cn('top-0 sticky z-1 border-b border-border bg-surface', className)
     }, props));
 }
 export function TableBody(_0) {

package/dist/ui/atoms/table/table.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/ui/atoms/table/table.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef } from 'react';\n\nimport { cn } from '../../utils/cn.js';\n\nexport interface TableProps extends ComponentPropsWithoutRef<'table'> {\n  /** Class names for the scroll container wrapping the `<table>`. */\n  containerClassName?: string;\n}\n\n/**\n * Styled table primitive — no entity knowledge, no data fetching. `EntityTable`\n * composes these; anything rendering non-entity tabular data can use them too.\n *\n * Wide tables scroll inside their own container rather than pushing the page\n * sideways.\n */\nexport function Table({ className, containerClassName, ...props }: TableProps) {\n  return (\n    <div\n      className={cn(\n        'w-full overflow-x-auto rounded-xl border border-border bg-surface-elevated',\n        containerClassName,\n      )}\n    >\n      <table\n        className={cn(\n          'w-full border-collapse text-step-0 text-content',\n          className,\n        )}\n        {...props}\n      />\n    </div>\n  );\n}\n\nexport function TableHead({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'thead'>) {\n  return (\n    <thead\n      className={cn('border-b border-border bg-surface', className)}\n      {...props}\n    />\n  );\n}\n\nexport function TableBody({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'tbody'>) {\n  return (\n    <tbody className={cn('divide-y divide-border', className)} {...props} />\n  );\n}\n\nexport function TableRow({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'tr'>) {\n  return (\n    <tr\n      className={cn(\n        'transition-colors duration-200 ease-smooth hover:bg-surface',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport type TableCellAlign = 'start' | 'center' | 'end';\n\nconst ALIGN_CLASS: Record<TableCellAlign, string> = {\n  start: 'text-left',\n  center: 'text-center',\n  end: 'text-right',\n};\n\n// `align` shadows the deprecated HTML attribute, which allows a different set\n// of values — omit the native one rather than narrow it.\nexport interface TableHeaderCellProps extends Omit<\n  ComponentPropsWithoutRef<'th'>,\n  'align'\n> {\n  align?: TableCellAlign;\n}\n\nexport function TableHeaderCell({\n  align = 'start',\n  className,\n  ...props\n}: TableHeaderCellProps) {\n  return (\n    <th\n      scope=\"col\"\n      className={cn(\n        'px-s py-2xs text-step-sm font-semibold whitespace-nowrap text-content-muted',\n        ALIGN_CLASS[align],\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport interface TableCellProps extends Omit<\n  ComponentPropsWithoutRef<'td'>,\n  'align'\n> {\n  align?: TableCellAlign;\n}\n\nexport function TableCell({\n  align = 'start',\n  className,\n  ...props\n}: TableCellProps) {\n  return (\n    <td\n      className={cn('px-s py-2xs align-middle', ALIGN_CLASS[align], className)}\n      {...props}\n    />\n  );\n}\n\n/** Full-width message row — empty results, an error, a loading state. */\nexport function TableMessageRow({\n  colSpan,\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'td'> & { colSpan: number }) {\n  return (\n    <tr>\n      <td\n        colSpan={colSpan}\n        className={cn(\n          'px-s py-m text-center text-step-sm text-content-muted',\n          className,\n        )}\n        {...props}\n      />\n    </tr>\n  );\n}\n"],"names":["cn","Table","className","containerClassName","props","div","table","TableHead","thead","TableBody","tbody","TableRow","tr","ALIGN_CLASS","start","center","end","TableHeaderCell","align","th","scope","TableCell","td","TableMessageRow","colSpan"],"mappings":";;;AAEA,SAASA,EAAE,QAAQ,oBAAoB;AAOvC;;;;;;CAMC,GACD,OAAO,SAASC,MAAM,EAAuD;QAAvD,EAAEC,SAAS,EAAEC,kBAAkB,EAAwB,OAAnBC;;;;IACxD,qBACE,KAACC;QACCH,WAAWF,GACT,8EACAG;kBAGF,cAAA,KAACG;YACCJ,WAAWF,GACT,mDACAE;WAEEE;;AAIZ;AAEA,OAAO,SAASG,UAAU,EAGU;QAHV,EACxBL,SAAS,EAEyB,OAD/BE;;;IAEH,qBACE,KAACI;QACCN,WAAWF,GAAG,qCAAqCE;OAC/CE;AAGV;AAEA,OAAO,SAASK,UAAU,EAGU;QAHV,EACxBP,SAAS,EAEyB,OAD/BE;;;IAEH,qBACE,KAACM;QAAMR,WAAWF,GAAG,0BAA0BE;OAAgBE;AAEnE;AAEA,OAAO,SAASO,SAAS,EAGQ;QAHR,EACvBT,SAAS,EAEsB,OAD5BE;;;IAEH,qBACE,KAACQ;QACCV,WAAWF,GACT,+DACAE;OAEEE;AAGV;AAIA,MAAMS,cAA8C;IAClDC,OAAO;IACPC,QAAQ;IACRC,KAAK;AACP;AAWA,OAAO,SAASC,gBAAgB,EAIT;QAJS,EAC9BC,QAAQ,OAAO,EACfhB,SAAS,EAEY,OADlBE;;;;IAEH,qBACE,KAACe;QACCC,OAAM;QACNlB,WAAWF,GACT,+EACAa,WAAW,CAACK,MAAM,EAClBhB;OAEEE;AAGV;AASA,OAAO,SAASiB,UAAU,EAIT;QAJS,EACxBH,QAAQ,OAAO,EACfhB,SAAS,EAEM,OADZE;;;;IAEH,qBACE,KAACkB;QACCpB,WAAWF,GAAG,4BAA4Ba,WAAW,CAACK,MAAM,EAAEhB;OAC1DE;AAGV;AAEA,uEAAuE,GACvE,OAAO,SAASmB,gBAAgB,EAIuB;QAJvB,EAC9BC,OAAO,EACPtB,SAAS,EAE4C,OADlDE;;;;IAEH,qBACE,KAACQ;kBACC,cAAA,KAACU;YACCE,SAASA;YACTtB,WAAWF,GACT,yDACAE;WAEEE;;AAIZ"}
+{"version":3,"sources":["../../../../src/ui/atoms/table/table.tsx"],"sourcesContent":["'use client';\n\nimport {\n  type ComponentPropsWithoutRef,\n  type ReactNode,\n  type RefObject,\n  useEffect,\n  useId,\n  useRef,\n  useState,\n} from 'react';\n\nimport { cn } from '../../utils/cn.js';\n\nexport interface TableProps extends ComponentPropsWithoutRef<'table'> {\n  /** Class names for the scroll container wrapping the `<table>`. */\n  containerClassName?: string;\n  /**\n   * What the table holds — \"Clientes, 12 resultados\". It names the table and,\n   * once the table overflows its container, the scroll region too.\n   */\n  caption?: ReactNode;\n  /** Class names for the caption; screen-reader only unless overridden. */\n  captionClassName?: string;\n}\n\n/**\n * Whether an element's content is larger than its box, on either axis —\n * measured again whenever the box or the content it holds resizes.\n */\nfunction useOverflows(ref: RefObject<HTMLElement | null>): boolean {\n  const [overflows, setOverflows] = useState(false);\n  useEffect(() => {\n    const node = ref.current as HTMLElement;\n    const measure = () =>\n      setOverflows(\n        node.scrollWidth > node.clientWidth ||\n          node.scrollHeight > node.clientHeight,\n      );\n    measure();\n    const observer = new ResizeObserver(measure);\n    observer.observe(node);\n    // The table grows with its rows while the container keeps its size.\n    for (const child of Array.from(node.children)) observer.observe(child);\n    return () => observer.disconnect();\n  }, [ref]);\n  return overflows;\n}\n\n/**\n * Styled table primitive — no entity knowledge, no data fetching. `EntityTable`\n * composes these; anything rendering non-entity tabular data can use them too.\n *\n * Wide tables scroll inside their own container rather than pushing the page\n * sideways. A container that scrolls is a **focusable region** named by the\n * caption, so a keyboard can scroll it — and one that fits is neither, so it\n * adds no tab stop that does nothing.\n */\nexport function Table({\n  className,\n  containerClassName,\n  caption,\n  captionClassName = 'sr-only',\n  children,\n  ...props\n}: TableProps) {\n  const container = useRef<HTMLDivElement>(null);\n  const captionId = useId();\n  const overflows = useOverflows(container);\n  const named = caption !== undefined;\n\n  return (\n    <div\n      ref={container}\n      data-overflows={overflows || undefined}\n      {...(overflows && {\n        tabIndex: 0,\n        role: named ? 'region' : undefined,\n        'aria-labelledby': named ? captionId : undefined,\n      })}\n      className={cn(\n        'w-full overflow-auto rounded-xl border border-border bg-surface-elevated focus-ring',\n        containerClassName,\n      )}\n    >\n      <table\n        className={cn(\n          'w-full border-collapse text-step-0 text-content',\n          className,\n        )}\n        {...props}\n      >\n        {named && (\n          <caption id={captionId} className={captionClassName}>\n            {caption}\n          </caption>\n        )}\n        {children}\n      </table>\n    </div>\n  );\n}\n\nexport function TableHead({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'thead'>) {\n  return (\n    <thead\n      // Sticky inside a container that scrolls: the column names stay in view\n      // over a long page of rows. One layer above the rows, and no higher: a\n      // row menu opened under it must still paint over it.\n      className={cn(\n        'top-0 sticky z-1 border-b border-border bg-surface',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport function TableBody({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'tbody'>) {\n  return (\n    <tbody className={cn('divide-y divide-border', className)} {...props} />\n  );\n}\n\nexport function TableRow({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'tr'>) {\n  return (\n    <tr\n      className={cn(\n        'transition-colors duration-200 ease-smooth hover:bg-surface',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport type TableCellAlign = 'start' | 'center' | 'end';\n\nconst ALIGN_CLASS: Record<TableCellAlign, string> = {\n  start: 'text-left',\n  center: 'text-center',\n  end: 'text-right',\n};\n\n// `align` shadows the deprecated HTML attribute, which allows a different set\n// of values — omit the native one rather than narrow it.\nexport interface TableHeaderCellProps extends Omit<\n  ComponentPropsWithoutRef<'th'>,\n  'align'\n> {\n  align?: TableCellAlign;\n}\n\nexport function TableHeaderCell({\n  align = 'start',\n  className,\n  ...props\n}: TableHeaderCellProps) {\n  return (\n    <th\n      scope=\"col\"\n      className={cn(\n        'px-s py-2xs text-step-sm font-semibold whitespace-nowrap text-content-muted',\n        ALIGN_CLASS[align],\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport interface TableCellProps extends Omit<\n  ComponentPropsWithoutRef<'td'>,\n  'align'\n> {\n  align?: TableCellAlign;\n}\n\nexport function TableCell({\n  align = 'start',\n  className,\n  ...props\n}: TableCellProps) {\n  return (\n    <td\n      className={cn('px-s py-2xs align-middle', ALIGN_CLASS[align], className)}\n      {...props}\n    />\n  );\n}\n\n/** Full-width message row — empty results, an error, a loading state. */\nexport function TableMessageRow({\n  colSpan,\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'td'> & { colSpan: number }) {\n  return (\n    <tr>\n      <td\n        colSpan={colSpan}\n        className={cn(\n          'px-s py-m text-center text-step-sm text-content-muted',\n          className,\n        )}\n        {...props}\n      />\n    </tr>\n  );\n}\n"],"names":["useEffect","useId","useRef","useState","cn","useOverflows","ref","overflows","setOverflows","node","current","measure","scrollWidth","clientWidth","scrollHeight","clientHeight","observer","ResizeObserver","observe","child","Array","from","children","disconnect","Table","className","containerClassName","caption","captionClassName","props","container","captionId","named","undefined","div","data-overflows","tabIndex","role","table","id","TableHead","thead","TableBody","tbody","TableRow","tr","ALIGN_CLASS","start","center","end","TableHeaderCell","align","th","scope","TableCell","td","TableMessageRow","colSpan"],"mappings":"AAAA;;;;AAEA,SAIEA,SAAS,EACTC,KAAK,EACLC,MAAM,EACNC,QAAQ,QACH,QAAQ;AAEf,SAASC,EAAE,QAAQ,oBAAoB;AAcvC;;;CAGC,GACD,SAASC,aAAaC,GAAkC;IACtD,MAAM,CAACC,WAAWC,aAAa,GAAGL,SAAS;IAC3CH,UAAU;QACR,MAAMS,OAAOH,IAAII,OAAO;QACxB,MAAMC,UAAU,IACdH,aACEC,KAAKG,WAAW,GAAGH,KAAKI,WAAW,IACjCJ,KAAKK,YAAY,GAAGL,KAAKM,YAAY;QAE3CJ;QACA,MAAMK,WAAW,IAAIC,eAAeN;QACpCK,SAASE,OAAO,CAACT;QACjB,oEAAoE;QACpE,KAAK,MAAMU,SAASC,MAAMC,IAAI,CAACZ,KAAKa,QAAQ,EAAGN,SAASE,OAAO,CAACC;QAChE,OAAO,IAAMH,SAASO,UAAU;IAClC,GAAG;QAACjB;KAAI;IACR,OAAOC;AACT;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASiB,MAAM,EAOT;QAPS,EACpBC,SAAS,EACTC,kBAAkB,EAClBC,OAAO,EACPC,mBAAmB,SAAS,EAC5BN,QAAQ,EAEG,OADRO;;;;;;;IAEH,MAAMC,YAAY5B,OAAuB;IACzC,MAAM6B,YAAY9B;IAClB,MAAMM,YAAYF,aAAayB;IAC/B,MAAME,QAAQL,YAAYM;IAE1B,qBACE,KAACC;QACC5B,KAAKwB;QACLK,kBAAgB5B,aAAa0B;OACxB1B,aAAa;QAChB6B,UAAU;QACVC,MAAML,QAAQ,WAAWC;QACzB,mBAAmBD,QAAQD,YAAYE;IACzC;QACAR,WAAWrB,GACT,uFACAsB;kBAGF,cAAA,MAACY;YACCb,WAAWrB,GACT,mDACAqB;WAEEI;;gBAEHG,uBACC,KAACL;oBAAQY,IAAIR;oBAAWN,WAAWG;8BAChCD;;gBAGJL;;;;AAIT;AAEA,OAAO,SAASkB,UAAU,EAGU;QAHV,EACxBf,SAAS,EAEyB,OAD/BI;;;IAEH,qBACE,KAACY;QACC,wEAAwE;QACxE,uEAAuE;QACvE,qDAAqD;QACrDhB,WAAWrB,GACT,sDACAqB;OAEEI;AAGV;AAEA,OAAO,SAASa,UAAU,EAGU;QAHV,EACxBjB,SAAS,EAEyB,OAD/BI;;;IAEH,qBACE,KAACc;QAAMlB,WAAWrB,GAAG,0BAA0BqB;OAAgBI;AAEnE;AAEA,OAAO,SAASe,SAAS,EAGQ;QAHR,EACvBnB,SAAS,EAEsB,OAD5BI;;;IAEH,qBACE,KAACgB;QACCpB,WAAWrB,GACT,+DACAqB;OAEEI;AAGV;AAIA,MAAMiB,cAA8C;IAClDC,OAAO;IACPC,QAAQ;IACRC,KAAK;AACP;AAWA,OAAO,SAASC,gBAAgB,EAIT;QAJS,EAC9BC,QAAQ,OAAO,EACf1B,SAAS,EAEY,OADlBI;;;;IAEH,qBACE,KAACuB;QACCC,OAAM;QACN5B,WAAWrB,GACT,+EACA0C,WAAW,CAACK,MAAM,EAClB1B;OAEEI;AAGV;AASA,OAAO,SAASyB,UAAU,EAIT;QAJS,EACxBH,QAAQ,OAAO,EACf1B,SAAS,EAEM,OADZI;;;;IAEH,qBACE,KAAC0B;QACC9B,WAAWrB,GAAG,4BAA4B0C,WAAW,CAACK,MAAM,EAAE1B;OAC1DI;AAGV;AAEA,uEAAuE,GACvE,OAAO,SAAS2B,gBAAgB,EAIuB;QAJvB,EAC9BC,OAAO,EACPhC,SAAS,EAE4C,OADlDI;;;;IAEH,qBACE,KAACgB;kBACC,cAAA,KAACU;YACCE,SAASA;YACThC,WAAWrB,GACT,yDACAqB;WAEEI;;AAIZ"}

package/dist/ui/atoms/text/text.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentPropsWithoutRef, ElementType } from 'react';
+import type { ComponentProps, ComponentPropsWithoutRef, ElementType } from 'react';
 /** Fluid type step (Utopia). Negatives taper below body for fine print. */
 type Step = -2 | -1 | 0 | 1 | 2 | 3;
 /**
@@ -17,7 +17,7 @@ type Tone = 'default' | 'muted' | 'primary' | 'accent';
 type Align = 'start' | 'center' | 'end';
 /** Multi-line clamp (static classes so Tailwind can see them). */
 type Clamp = 1 | 2 | 3 | 4;
-export interface TextProps extends ComponentPropsWithoutRef<'p'> {
+export interface TextProps extends ComponentProps<'p'> {
     /** Fluid type step (Utopia). Defaults to body (0). */
     step?: Step;
     /** Font weight. */

package/dist/ui/atoms/text/text.d.ts.map

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

package/dist/ui/atoms/text/text.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/ui/atoms/text/text.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, ElementType } from 'react';\n\nimport { cn } from '../../utils/cn.js';\n\n/** Fluid type step (Utopia). Negatives taper below body for fine print. */\ntype Step = -2 | -1 | 0 | 1 | 2 | 3;\n\nconst STEP_CLASS: Record<Step, string> = {\n  '-2': 'text-step-xs',\n  '-1': 'text-step-sm',\n  0: 'text-step-0',\n  1: 'text-step-1',\n  2: 'text-step-2',\n  3: 'text-step-3',\n};\n\n/**\n * Three weights, and no fourth.\n *\n * 400 body, 500 secondary emphasis, 600 headings and labels. `bold` (700) was\n * removed: \"heading\" and \"emphatic heading\" were never distinct roles here,\n * only different authors — measured, `font-bold` appeared three times against\n * `font-semibold`'s thirteen, all of them headings that had no reason to differ\n * from their neighbours. A fourth weight comes back when a role needs it, not\n * when a screen wants one.\n */\ntype Weight = 'normal' | 'medium' | 'semibold';\n\nconst WEIGHT_CLASS: Record<Weight, string> = {\n  normal: 'font-normal',\n  medium: 'font-medium',\n  semibold: 'font-semibold',\n};\n\n/** Semantic content color. Superset of the legacy `muted` flag. */\ntype Tone = 'default' | 'muted' | 'primary' | 'accent';\n\nconst TONE_CLASS: Record<Tone, string> = {\n  default: 'text-content',\n  muted: 'text-content-muted',\n  primary: 'text-primary',\n  accent: 'text-accent',\n};\n\ntype Align = 'start' | 'center' | 'end';\n\nconst ALIGN_CLASS: Record<Align, string> = {\n  start: 'text-left',\n  center: 'text-center',\n  end: 'text-right',\n};\n\n/** Multi-line clamp (static classes so Tailwind can see them). */\ntype Clamp = 1 | 2 | 3 | 4;\n\nconst CLAMP_CLASS: Record<Clamp, string> = {\n  1: 'line-clamp-1',\n  2: 'line-clamp-2',\n  3: 'line-clamp-3',\n  4: 'line-clamp-4',\n};\n\nexport interface TextProps extends ComponentPropsWithoutRef<'p'> {\n  /** Fluid type step (Utopia). Defaults to body (0). */\n  step?: Step;\n  /** Font weight. */\n  weight?: Weight;\n  /** Semantic color. */\n  tone?: Tone;\n  /** Text alignment. */\n  align?: Align;\n  /** Truncate to a single line with an ellipsis. */\n  truncate?: boolean;\n  /** Clamp to N lines with an ellipsis. */\n  lineClamp?: Clamp;\n  /** Shortcut for `tone=\"muted\"`. */\n  muted?: boolean;\n  as?: ElementType;\n}\n\n/** Body text with fluid sizing and theme-driven color. */\nexport function Text({\n  step = 0,\n  weight,\n  tone = 'default',\n  align,\n  truncate = false,\n  lineClamp,\n  muted = false,\n  as: Tag = 'p',\n  className,\n  ...props\n}: TextProps) {\n  return (\n    <Tag\n      className={cn(\n        STEP_CLASS[step],\n        weight && WEIGHT_CLASS[weight],\n        TONE_CLASS[muted ? 'muted' : tone],\n        align && ALIGN_CLASS[align],\n        truncate && 'truncate',\n        lineClamp && CLAMP_CLASS[lineClamp],\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/** Larger intro paragraph — sets a subject up before the body copy. */\nexport function Lead({ className, ...props }: Omit<TextProps, 'step'>) {\n  return (\n    <Text\n      step={1}\n      tone=\"muted\"\n      className={cn('max-w-prose leading-relaxed', className)}\n      {...props}\n    />\n  );\n}\n\n/** Small supporting copy (helper text, meta). */\nexport function Small({ className, ...props }: Omit<TextProps, 'step' | 'as'>) {\n  return <Text as=\"small\" step={-1} className={className} {...props} />;\n}\n\n/** Caption / fine print — smallest step, muted by default. */\nexport function Caption({\n  className,\n  ...props\n}: Omit<TextProps, 'step' | 'as'>) {\n  return (\n    <Text as=\"span\" step={-2} tone=\"muted\" className={className} {...props} />\n  );\n}\n\n/** Overline / eyebrow — uppercase tracked label above a heading. */\nexport function Overline({\n  className,\n  ...props\n}: Omit<TextProps, 'step' | 'as' | 'weight'>) {\n  return (\n    <Text\n      as=\"span\"\n      step={-2}\n      weight=\"semibold\"\n      tone=\"muted\"\n      className={cn('tracking-wide uppercase', className)}\n      {...props}\n    />\n  );\n}\n\n/* ---------- Inline emphasis ---------- */\n\n/** Bold inline emphasis. */\nexport function Strong({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'strong'>) {\n  return (\n    <strong\n      className={cn('font-semibold text-content', className)}\n      {...props}\n    />\n  );\n}\n\n/** Italic inline emphasis. */\nexport function Em({ className, ...props }: ComponentPropsWithoutRef<'em'>) {\n  return <em className={cn('italic', className)} {...props} />;\n}\n\n/** Inline code. */\nexport function Code({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'code'>) {\n  return (\n    <code\n      className={cn(\n        'rounded-sm border border-border bg-surface px-2xs py-3xs',\n        'font-mono text-step-sm text-content tabular-nums',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/** Keyboard key. */\nexport function Kbd({ className, ...props }: ComponentPropsWithoutRef<'kbd'>) {\n  return (\n    <kbd\n      className={cn(\n        'inline-flex items-center rounded-md border border-border bg-surface-elevated',\n        'px-2xs py-3xs font-mono text-step-xs text-content-muted shadow-edge',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * {@link Link}'s styling on its own, for a host that renders its own link\n * component (a router's) and should still look like one.\n */\nexport const linkClassName = cn(\n  'font-medium text-primary underline underline-offset-2',\n  'transition-colors duration-200 ease-smooth hover:text-accent',\n  'focus-ring',\n);\n\n/** Themed anchor. */\nexport function Link({\n  className,\n  children,\n  ...props\n}: ComponentPropsWithoutRef<'a'>) {\n  return (\n    <a className={cn(linkClassName, className)} {...props}>\n      {children}\n    </a>\n  );\n}\n\n/* ---------- Block-level ---------- */\n\n/** Pull quote — left border + muted italic body. */\nexport function Blockquote({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'blockquote'>) {\n  return (\n    <blockquote\n      className={cn(\n        'border-l-4 border-primary pl-s italic',\n        'text-step-1 text-content-muted',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport interface ListProps extends ComponentPropsWithoutRef<'ul'> {\n  /** Render an ordered list (`<ol>`) with numeric markers. */\n  ordered?: boolean;\n}\n\n/** Bulleted or numbered list with themed markers and fluid spacing. */\nexport function List({ ordered = false, className, ...props }: ListProps) {\n  const Tag = ordered ? 'ol' : 'ul';\n  return (\n    <Tag\n      className={cn(\n        ordered ? 'list-decimal' : 'list-disc',\n        'ms-m flex flex-col gap-2xs text-step-0 text-content marker:text-content-muted',\n        className,\n      )}\n      {...(props as ComponentPropsWithoutRef<'ol'>)}\n    />\n  );\n}\n\n/** List item — pairs with `List`. */\nexport function ListItem({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'li'>) {\n  return <li className={cn('ps-2xs', className)} {...props} />;\n}\n\n/* ---------- Headings ---------- */\n\nexport interface HeadingProps extends ComponentPropsWithoutRef<'h2'> {\n  step?: Step;\n  weight?: Weight;\n  as?: ElementType;\n}\n\n/** Heading primitive — fluid step + weight, defaults to the largest step. */\nexport function Heading({\n  step = 3,\n  weight = 'semibold',\n  as: Tag = 'h2',\n  className,\n  ...props\n}: HeadingProps) {\n  return (\n    <Tag\n      className={cn(\n        STEP_CLASS[step],\n        WEIGHT_CLASS[weight],\n        'text-content',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * Semantic heading components (h1–h6) mapped to the fluid type scale.\n * Sizes taper past the four Utopia steps by dropping weight for h5/h6.\n */\nexport type NamedHeadingProps = Omit<HeadingProps, 'as' | 'step'>;\n\nexport function HeadingOne(props: NamedHeadingProps) {\n  return <Heading as=\"h1\" step={3} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingTwo(props: NamedHeadingProps) {\n  return <Heading as=\"h2\" step={2} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingThree(props: NamedHeadingProps) {\n  return <Heading as=\"h3\" step={1} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingFour(props: NamedHeadingProps) {\n  return <Heading as=\"h4\" step={0} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingFive(props: NamedHeadingProps) {\n  return <Heading as=\"h5\" step={0} weight=\"medium\" {...props} />;\n}\n\nexport function HeadingSix({ className, ...props }: NamedHeadingProps) {\n  return (\n    <Heading\n      as=\"h6\"\n      step={0}\n      weight=\"medium\"\n      className={cn('tracking-wide text-content-muted uppercase', className)}\n      {...props}\n    />\n  );\n}\n"],"names":["cn","STEP_CLASS","WEIGHT_CLASS","normal","medium","semibold","TONE_CLASS","default","muted","primary","accent","ALIGN_CLASS","start","center","end","CLAMP_CLASS","Text","step","weight","tone","align","truncate","lineClamp","as","Tag","className","props","Lead","Small","Caption","Overline","Strong","strong","Em","em","Code","code","Kbd","kbd","linkClassName","Link","children","a","Blockquote","blockquote","List","ordered","ListItem","li","Heading","HeadingOne","HeadingTwo","HeadingThree","HeadingFour","HeadingFive","HeadingSix"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/ui/atoms/text/text.tsx"],"sourcesContent":["import type {\n  ComponentProps,\n  ComponentPropsWithoutRef,\n  ElementType,\n} from 'react';\n\nimport { cn } from '../../utils/cn.js';\n\n/** Fluid type step (Utopia). Negatives taper below body for fine print. */\ntype Step = -2 | -1 | 0 | 1 | 2 | 3;\n\nconst STEP_CLASS: Record<Step, string> = {\n  '-2': 'text-step-xs',\n  '-1': 'text-step-sm',\n  0: 'text-step-0',\n  1: 'text-step-1',\n  2: 'text-step-2',\n  3: 'text-step-3',\n};\n\n/**\n * Three weights, and no fourth.\n *\n * 400 body, 500 secondary emphasis, 600 headings and labels. `bold` (700) was\n * removed: \"heading\" and \"emphatic heading\" were never distinct roles here,\n * only different authors — measured, `font-bold` appeared three times against\n * `font-semibold`'s thirteen, all of them headings that had no reason to differ\n * from their neighbours. A fourth weight comes back when a role needs it, not\n * when a screen wants one.\n */\ntype Weight = 'normal' | 'medium' | 'semibold';\n\nconst WEIGHT_CLASS: Record<Weight, string> = {\n  normal: 'font-normal',\n  medium: 'font-medium',\n  semibold: 'font-semibold',\n};\n\n/** Semantic content color. Superset of the legacy `muted` flag. */\ntype Tone = 'default' | 'muted' | 'primary' | 'accent';\n\nconst TONE_CLASS: Record<Tone, string> = {\n  default: 'text-content',\n  muted: 'text-content-muted',\n  primary: 'text-primary',\n  accent: 'text-accent',\n};\n\ntype Align = 'start' | 'center' | 'end';\n\nconst ALIGN_CLASS: Record<Align, string> = {\n  start: 'text-left',\n  center: 'text-center',\n  end: 'text-right',\n};\n\n/** Multi-line clamp (static classes so Tailwind can see them). */\ntype Clamp = 1 | 2 | 3 | 4;\n\nconst CLAMP_CLASS: Record<Clamp, string> = {\n  1: 'line-clamp-1',\n  2: 'line-clamp-2',\n  3: 'line-clamp-3',\n  4: 'line-clamp-4',\n};\n\nexport interface TextProps extends ComponentProps<'p'> {\n  /** Fluid type step (Utopia). Defaults to body (0). */\n  step?: Step;\n  /** Font weight. */\n  weight?: Weight;\n  /** Semantic color. */\n  tone?: Tone;\n  /** Text alignment. */\n  align?: Align;\n  /** Truncate to a single line with an ellipsis. */\n  truncate?: boolean;\n  /** Clamp to N lines with an ellipsis. */\n  lineClamp?: Clamp;\n  /** Shortcut for `tone=\"muted\"`. */\n  muted?: boolean;\n  as?: ElementType;\n}\n\n/** Body text with fluid sizing and theme-driven color. */\nexport function Text({\n  step = 0,\n  weight,\n  tone = 'default',\n  align,\n  truncate = false,\n  lineClamp,\n  muted = false,\n  as: Tag = 'p',\n  className,\n  ...props\n}: TextProps) {\n  return (\n    <Tag\n      className={cn(\n        STEP_CLASS[step],\n        weight && WEIGHT_CLASS[weight],\n        TONE_CLASS[muted ? 'muted' : tone],\n        align && ALIGN_CLASS[align],\n        truncate && 'truncate',\n        lineClamp && CLAMP_CLASS[lineClamp],\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/** Larger intro paragraph — sets a subject up before the body copy. */\nexport function Lead({ className, ...props }: Omit<TextProps, 'step'>) {\n  return (\n    <Text\n      step={1}\n      tone=\"muted\"\n      className={cn('max-w-prose leading-relaxed', className)}\n      {...props}\n    />\n  );\n}\n\n/** Small supporting copy (helper text, meta). */\nexport function Small({ className, ...props }: Omit<TextProps, 'step' | 'as'>) {\n  return <Text as=\"small\" step={-1} className={className} {...props} />;\n}\n\n/** Caption / fine print — smallest step, muted by default. */\nexport function Caption({\n  className,\n  ...props\n}: Omit<TextProps, 'step' | 'as'>) {\n  return (\n    <Text as=\"span\" step={-2} tone=\"muted\" className={className} {...props} />\n  );\n}\n\n/** Overline / eyebrow — uppercase tracked label above a heading. */\nexport function Overline({\n  className,\n  ...props\n}: Omit<TextProps, 'step' | 'as' | 'weight'>) {\n  return (\n    <Text\n      as=\"span\"\n      step={-2}\n      weight=\"semibold\"\n      tone=\"muted\"\n      className={cn('tracking-wide uppercase', className)}\n      {...props}\n    />\n  );\n}\n\n/* ---------- Inline emphasis ---------- */\n\n/** Bold inline emphasis. */\nexport function Strong({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'strong'>) {\n  return (\n    <strong\n      className={cn('font-semibold text-content', className)}\n      {...props}\n    />\n  );\n}\n\n/** Italic inline emphasis. */\nexport function Em({ className, ...props }: ComponentPropsWithoutRef<'em'>) {\n  return <em className={cn('italic', className)} {...props} />;\n}\n\n/** Inline code. */\nexport function Code({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'code'>) {\n  return (\n    <code\n      className={cn(\n        'rounded-sm border border-border bg-surface px-2xs py-3xs',\n        'font-mono text-step-sm text-content tabular-nums',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/** Keyboard key. */\nexport function Kbd({ className, ...props }: ComponentPropsWithoutRef<'kbd'>) {\n  return (\n    <kbd\n      className={cn(\n        'inline-flex items-center rounded-md border border-border bg-surface-elevated',\n        'px-2xs py-3xs font-mono text-step-xs text-content-muted shadow-edge',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * {@link Link}'s styling on its own, for a host that renders its own link\n * component (a router's) and should still look like one.\n */\nexport const linkClassName = cn(\n  'font-medium text-primary underline underline-offset-2',\n  'transition-colors duration-200 ease-smooth hover:text-accent',\n  'focus-ring',\n);\n\n/** Themed anchor. */\nexport function Link({\n  className,\n  children,\n  ...props\n}: ComponentPropsWithoutRef<'a'>) {\n  return (\n    <a className={cn(linkClassName, className)} {...props}>\n      {children}\n    </a>\n  );\n}\n\n/* ---------- Block-level ---------- */\n\n/** Pull quote — left border + muted italic body. */\nexport function Blockquote({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'blockquote'>) {\n  return (\n    <blockquote\n      className={cn(\n        'border-l-4 border-primary pl-s italic',\n        'text-step-1 text-content-muted',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport interface ListProps extends ComponentPropsWithoutRef<'ul'> {\n  /** Render an ordered list (`<ol>`) with numeric markers. */\n  ordered?: boolean;\n}\n\n/** Bulleted or numbered list with themed markers and fluid spacing. */\nexport function List({ ordered = false, className, ...props }: ListProps) {\n  const Tag = ordered ? 'ol' : 'ul';\n  return (\n    <Tag\n      className={cn(\n        ordered ? 'list-decimal' : 'list-disc',\n        'ms-m flex flex-col gap-2xs text-step-0 text-content marker:text-content-muted',\n        className,\n      )}\n      {...(props as ComponentPropsWithoutRef<'ol'>)}\n    />\n  );\n}\n\n/** List item — pairs with `List`. */\nexport function ListItem({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'li'>) {\n  return <li className={cn('ps-2xs', className)} {...props} />;\n}\n\n/* ---------- Headings ---------- */\n\nexport interface HeadingProps extends ComponentPropsWithoutRef<'h2'> {\n  step?: Step;\n  weight?: Weight;\n  as?: ElementType;\n}\n\n/** Heading primitive — fluid step + weight, defaults to the largest step. */\nexport function Heading({\n  step = 3,\n  weight = 'semibold',\n  as: Tag = 'h2',\n  className,\n  ...props\n}: HeadingProps) {\n  return (\n    <Tag\n      className={cn(\n        STEP_CLASS[step],\n        WEIGHT_CLASS[weight],\n        'text-content',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/**\n * Semantic heading components (h1–h6) mapped to the fluid type scale.\n * Sizes taper past the four Utopia steps by dropping weight for h5/h6.\n */\nexport type NamedHeadingProps = Omit<HeadingProps, 'as' | 'step'>;\n\nexport function HeadingOne(props: NamedHeadingProps) {\n  return <Heading as=\"h1\" step={3} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingTwo(props: NamedHeadingProps) {\n  return <Heading as=\"h2\" step={2} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingThree(props: NamedHeadingProps) {\n  return <Heading as=\"h3\" step={1} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingFour(props: NamedHeadingProps) {\n  return <Heading as=\"h4\" step={0} weight=\"semibold\" {...props} />;\n}\n\nexport function HeadingFive(props: NamedHeadingProps) {\n  return <Heading as=\"h5\" step={0} weight=\"medium\" {...props} />;\n}\n\nexport function HeadingSix({ className, ...props }: NamedHeadingProps) {\n  return (\n    <Heading\n      as=\"h6\"\n      step={0}\n      weight=\"medium\"\n      className={cn('tracking-wide text-content-muted uppercase', className)}\n      {...props}\n    />\n  );\n}\n"],"names":["cn","STEP_CLASS","WEIGHT_CLASS","normal","medium","semibold","TONE_CLASS","default","muted","primary","accent","ALIGN_CLASS","start","center","end","CLAMP_CLASS","Text","step","weight","tone","align","truncate","lineClamp","as","Tag","className","props","Lead","Small","Caption","Overline","Strong","strong","Em","em","Code","code","Kbd","kbd","linkClassName","Link","children","a","Blockquote","blockquote","List","ordered","ListItem","li","Heading","HeadingOne","HeadingTwo","HeadingThree","HeadingFour","HeadingFive","HeadingSix"],"mappings":"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"}

package/dist/ui/molecules/action-bar/action-bar.d.ts

@@ -0,0 +1,76 @@
+import type { UseCaseDescriptor } from '@entifix/core';
+import { type ActionSurface, type NavigationIntent, type RenderLink } from '../../actions/index.js';
+/** Every surface an {@link ActionBar} renders: the palette lists, it does not render a bar. */
+export type ActionBarSurface = Exclude<ActionSurface, 'command-palette'>;
+/** How many secondaries stay visible beside the primary before the rest fold. */
+export declare const VISIBLE_SECONDARIES = 3;
+/** One action in a bar: a declared verb, or one the surface brings itself (Save, New). */
+export interface ActionBarItem {
+    readonly key: string;
+    /** Already in the reader's language. */
+    readonly label: string;
+    readonly emphasis?: 'primary' | 'default';
+    /** Order among the secondaries, lowest first; absent keeps the given order. */
+    readonly priority?: number;
+    readonly destructive?: boolean;
+    /** Shown on a row itself rather than only in its menu. */
+    readonly rowInline?: boolean;
+    readonly shortcut?: string;
+    readonly disabled?: boolean;
+    /**
+     * An action that navigates rather than acts — a list's "New". It is never
+     * folded into a menu, whatever its emphasis: a menu entry is a button, and a
+     * link must stay a link so it can be opened in a new tab.
+     */
+    readonly href?: string;
+    /** What the link means, for a host that answers navigation itself. */
+    readonly intent?: NavigationIntent;
+    readonly onSelect?: () => void;
+    /**
+     * Submits the form the bar sits in — a form's Save — so Enter in a field
+     * saves too. As a button it leaves the act to the form's submit handler; in
+     * a menu, where a menu item cannot submit, it runs `onSelect`.
+     */
+    readonly submit?: boolean;
+}
+export interface ActionBarProps {
+    readonly surface: ActionBarSurface;
+    readonly items: readonly ActionBarItem[];
+    /**
+     * The overflow trigger's name. Defaults to "More actions"; a row passes
+     * "Actions for {record}", so a list of rows is not a list of identical
+     * buttons.
+     */
+    readonly menuLabel?: string;
+    readonly size?: 'sm' | 'md';
+    readonly renderLink?: RenderLink;
+    readonly className?: string;
+}
+/**
+ * The bar items for declared verbs: label translated, weight and order carried
+ * from the descriptor, every one routed through `onSelect` — which is where a
+ * surface's `invoke()` asks for a confirmation, so no surface can reach a verb
+ * around it.
+ */
+export declare function itemsForUseCases(descriptors: readonly UseCaseDescriptor[], translate: (key: string) => string, onSelect: (descriptor: UseCaseDescriptor) => void, disabled?: boolean): ActionBarItem[];
+/**
+ * One way every surface renders its verbs
+ * ([ADR 0026](../../../../../../../docs/adr/0026-actions-hierarchy-overflow-and-destructive-verbs.md)):
+ * the primary, then up to {@link VISIBLE_SECONDARIES} secondaries, then a
+ * "More actions" menu button holding the rest — destructive verbs last, after
+ * a separator.
+ *
+ * ⚠️ **It collapses by container, not by viewport.** Below the container's
+ * `md` width it renders the primary and one menu holding every secondary; a
+ * bar inside a split view or a drawer is as narrow as its container, whatever
+ * the window is. Both arrangements are in the DOM and CSS shows one, so the
+ * server renders the right one with no measurement.
+ *
+ * A row renders differently: the verb it declares `rowInline` sits on the row,
+ * and everything else is in one menu named for the record.
+ *
+ * It throws on a second primary, and on a destructive primary on a page
+ * surface — both are declarations no rendering can make sensible.
+ */
+export declare function ActionBar({ surface, items, menuLabel, size, renderLink, className, }: ActionBarProps): import("react").JSX.Element;
+//# sourceMappingURL=action-bar.d.ts.map

package/dist/ui/molecules/action-bar/action-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-bar.d.ts","sourceRoot":"","sources":["../../../../src/ui/molecules/action-bar/action-bar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIvD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAGrB,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAOhC,+FAA+F;AAC/F,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;AAczE,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,SAAS,iBAAiB,EAAE,EACzC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAClC,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,EACjD,QAAQ,UAAQ,GACf,aAAa,EAAE,CAYjB;AA4CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,KAAK,EACL,SAAS,EACT,IAAW,EACX,UAAyB,EACzB,SAAS,GACV,EAAE,cAAc,+BAoIhB"}

package/dist/ui/molecules/action-bar/action-bar.js

@@ -0,0 +1,218 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment } from 'react';
+import { useT } from '../../../i18n/index.js';
+import { OVERFLOW_GLYPH, renderAnchor } from '../../actions/index.js';
+import { ariaKeyShortcuts } from '../../actions/shortcut.js';
+import { Button, button } from '../../atoms/button/index.js';
+import { cn } from '../../utils/cn.js';
+import { useHotkey } from '../../utils/use-hotkey.js';
+import { Menu } from '../menu/index.js';
+/**
+ * Surfaces that are a **page** — a record's header and footer, a list's
+ * toolbar. A destructive verb is never the primary there: the thing a page is
+ * for is not destroying it. A selection's bar and a row are not pages, and
+ * deleting what was selected may well be what the bar is for.
+ */ const PAGE_SURFACES = new Set([
+    'form-header',
+    'form-footer',
+    'table-toolbar'
+]);
+/** How many secondaries stay visible beside the primary before the rest fold. */ export const VISIBLE_SECONDARIES = 3;
+/**
+ * The bar items for declared verbs: label translated, weight and order carried
+ * from the descriptor, every one routed through `onSelect` — which is where a
+ * surface's `invoke()` asks for a confirmation, so no surface can reach a verb
+ * around it.
+ */ export function itemsForUseCases(descriptors, translate, onSelect, disabled = false) {
+    return descriptors.map((descriptor)=>{
+        var _descriptor_confirm;
+        return {
+            key: descriptor.key,
+            label: translate(descriptor.labelKey),
+            emphasis: descriptor.emphasis,
+            priority: descriptor.priority,
+            destructive: ((_descriptor_confirm = descriptor.confirm) == null ? void 0 : _descriptor_confirm.tone) === 'destructive',
+            rowInline: descriptor.rowInline === true,
+            shortcut: descriptor.shortcut,
+            disabled,
+            onSelect: ()=>onSelect(descriptor)
+        };
+    });
+}
+/**
+ * Secondaries in the order they render: by priority, then as given, with the
+ * destructive ones last so a separator can stand between "do" and "destroy".
+ */ function ordered(items) {
+    const ranked = items.map((item, index)=>({
+            item,
+            index
+        })).sort((a, b)=>{
+        var _a_item_priority, _b_item_priority;
+        return ((_a_item_priority = a.item.priority) != null ? _a_item_priority : Infinity) - ((_b_item_priority = b.item.priority) != null ? _b_item_priority : Infinity) || a.index - b.index;
+    }).map(({ item })=>item);
+    return [
+        ...ranked.filter((item)=>!item.destructive),
+        ...ranked.filter((item)=>item.destructive)
+    ];
+}
+function assertHierarchy(surface, items) {
+    const primaries = items.filter((item)=>item.emphasis === 'primary');
+    if (primaries.length > 1) {
+        throw new Error(`The ${surface} surface has ${primaries.length} primary actions (${primaries.map((item)=>item.key).join(', ')}). A surface has one thing it is for: declare one primary and give the rest the default emphasis.`);
+    }
+    const [primary] = primaries;
+    if ((primary == null ? void 0 : primary.destructive) && PAGE_SURFACES.has(surface)) {
+        throw new Error(`"${primary.key}" is destructive and declared primary on ${surface}. A page is never for destroying itself: give it the default emphasis, and it renders last, after a separator.`);
+    }
+    return primary;
+}
+/**
+ * One way every surface renders its verbs
+ * ([ADR 0026](../../../../../../../docs/adr/0026-actions-hierarchy-overflow-and-destructive-verbs.md)):
+ * the primary, then up to {@link VISIBLE_SECONDARIES} secondaries, then a
+ * "More actions" menu button holding the rest — destructive verbs last, after
+ * a separator.
+ *
+ * ⚠️ **It collapses by container, not by viewport.** Below the container's
+ * `md` width it renders the primary and one menu holding every secondary; a
+ * bar inside a split view or a drawer is as narrow as its container, whatever
+ * the window is. Both arrangements are in the DOM and CSS shows one, so the
+ * server renders the right one with no measurement.
+ *
+ * A row renders differently: the verb it declares `rowInline` sits on the row,
+ * and everything else is in one menu named for the record.
+ *
+ * It throws on a second primary, and on a destructive primary on a page
+ * surface — both are declarations no rendering can make sensible.
+ */ export function ActionBar({ surface, items, menuLabel, size = 'sm', renderLink = renderAnchor, className }) {
+    const t = useT();
+    const primary = assertHierarchy(surface, items);
+    // A row's verbs are bound nowhere — every row would claim the same chord —
+    // so they advertise none. Every other surface binds what it advertises.
+    const bindsShortcuts = surface !== 'row-menu';
+    const keyShortcuts = (item)=>bindsShortcuts && item.shortcut !== undefined ? ariaKeyShortcuts(item.shortcut) : undefined;
+    const label = menuLabel != null ? menuLabel : t('actions.more');
+    const asButton = (item, variant)=>{
+        var _item_intent;
+        return item.href === undefined ? /*#__PURE__*/ _jsx(Button, {
+            type: item.submit ? 'submit' : 'button',
+            variant: item.destructive ? 'destructive' : variant,
+            size: size,
+            disabled: item.disabled,
+            "aria-keyshortcuts": keyShortcuts(item),
+            onClick: item.submit ? undefined : item.onSelect,
+            children: item.label
+        }, item.key) : /*#__PURE__*/ _jsx("span", {
+            className: "contents",
+            children: renderLink({
+                href: item.href,
+                className: button({
+                    variant,
+                    size
+                }),
+                children: item.label,
+                intent: (_item_intent = item.intent) != null ? _item_intent : {
+                    kind: 'new'
+                }
+            })
+        }, item.key);
+    };
+    const menu = (folded, key)=>{
+        if (folded.length === 0) return undefined;
+        const firstDestructive = folded.findIndex((item)=>item.destructive);
+        return /*#__PURE__*/ _jsxs(Menu, {
+            children: [
+                /*#__PURE__*/ _jsx(Menu.Trigger, {
+                    "aria-label": label,
+                    title: label,
+                    children: OVERFLOW_GLYPH
+                }),
+                /*#__PURE__*/ _jsx(Menu.Items, {
+                    children: folded.map((item, index)=>/*#__PURE__*/ _jsxs(Fragment, {
+                            children: [
+                                index > 0 && index === firstDestructive && /*#__PURE__*/ _jsx(Menu.Separator, {}),
+                                /*#__PURE__*/ _jsx(Menu.Item, {
+                                    tone: item.destructive ? 'destructive' : 'neutral',
+                                    disabled: item.disabled,
+                                    "aria-keyshortcuts": keyShortcuts(item),
+                                    onClick: item.onSelect,
+                                    children: item.label
+                                })
+                            ]
+                        }, item.key))
+                })
+            ]
+        }, key);
+    };
+    if (surface === 'row-menu') {
+        const inline = items.filter((item)=>item.rowInline);
+        return /*#__PURE__*/ _jsxs("span", {
+            className: cn('flex items-center gap-2xs', className),
+            children: [
+                inline.map((item)=>asButton(item, 'secondary')),
+                menu(ordered(items.filter((item)=>!item.rowInline)), 'row')
+            ]
+        });
+    }
+    const links = items.filter((item)=>item !== primary && item.href !== undefined);
+    const secondaries = ordered(items.filter((item)=>item !== primary && item.href === undefined));
+    const visible = secondaries.slice(0, VISIBLE_SECONDARIES);
+    const separatorAt = visible.findIndex((item)=>item.destructive);
+    // A menu holding one entry is strictly worse than the button it replaced.
+    const collapses = secondaries.length > 1;
+    return /*#__PURE__*/ _jsxs("div", {
+        className: cn('min-w-0 @container/actions flex-1', className),
+        "data-surface": surface,
+        children: [
+            items.map((item)=>item.shortcut === undefined || item.onSelect === undefined || item.href !== undefined ? null : /*#__PURE__*/ _jsx(ItemShortcut, {
+                    chord: item.shortcut,
+                    onSelect: item.onSelect,
+                    enabled: item.disabled !== true
+                }, item.key)),
+            /*#__PURE__*/ _jsxs("div", {
+                className: "flex flex-wrap items-center gap-2xs",
+                children: [
+                    primary && asButton(primary, 'primary'),
+                    links.map((item)=>asButton(item, 'secondary')),
+                    /*#__PURE__*/ _jsxs("div", {
+                        className: cn('flex-wrap items-center gap-2xs', collapses ? '@md/actions:flex hidden' : 'flex'),
+                        "data-arrangement": "wide",
+                        children: [
+                            visible.map((item, index)=>/*#__PURE__*/ _jsxs("span", {
+                                    className: "contents",
+                                    children: [
+                                        index > 0 && index === separatorAt && /*#__PURE__*/ _jsx("span", {
+                                            "aria-hidden": "true",
+                                            className: "w-px self-stretch bg-border"
+                                        }),
+                                        asButton(item, 'secondary')
+                                    ]
+                                }, item.key)),
+                            menu(secondaries.slice(VISIBLE_SECONDARIES), 'overflow')
+                        ]
+                    }),
+                    collapses && /*#__PURE__*/ _jsx("div", {
+                        className: "@md/actions:hidden flex",
+                        "data-arrangement": "narrow",
+                        children: menu(secondaries, 'collapsed')
+                    })
+                ]
+            })
+        ]
+    });
+}
+/**
+ * Binds one item's shortcut for as long as the bar shows it — yielding to a
+ * binding already there, so a host's own chord wins over a surface's default.
+ */ function ItemShortcut({ chord, onSelect, enabled }) {
+    useHotkey([
+        chord
+    ], onSelect, {
+        enabled,
+        ifFree: true
+    });
+    return null;
+}
+
+//# sourceMappingURL=action-bar.js.map

package/dist/ui/molecules/action-bar/action-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/molecules/action-bar/action-bar.tsx"],"sourcesContent":["'use client';\n\nimport type { UseCaseDescriptor } from '@entifix/core';\nimport { Fragment, type ReactNode } from 'react';\n\nimport { useT } from '../../../i18n/index.js';\nimport {\n  type ActionSurface,\n  type NavigationIntent,\n  OVERFLOW_GLYPH,\n  renderAnchor,\n  type RenderLink,\n} from '../../actions/index.js';\nimport { ariaKeyShortcuts } from '../../actions/shortcut.js';\nimport { Button, button } from '../../atoms/button/index.js';\nimport { cn } from '../../utils/cn.js';\nimport { useHotkey } from '../../utils/use-hotkey.js';\nimport { Menu } from '../menu/index.js';\n\n/** Every surface an {@link ActionBar} renders: the palette lists, it does not render a bar. */\nexport type ActionBarSurface = Exclude<ActionSurface, 'command-palette'>;\n\n/**\n * Surfaces that are a **page** — a record's header and footer, a list's\n * toolbar. A destructive verb is never the primary there: the thing a page is\n * for is not destroying it. A selection's bar and a row are not pages, and\n * deleting what was selected may well be what the bar is for.\n */\nconst PAGE_SURFACES: ReadonlySet<ActionBarSurface> = new Set([\n  'form-header',\n  'form-footer',\n  'table-toolbar',\n]);\n\n/** How many secondaries stay visible beside the primary before the rest fold. */\nexport const VISIBLE_SECONDARIES = 3;\n\n/** One action in a bar: a declared verb, or one the surface brings itself (Save, New). */\nexport interface ActionBarItem {\n  readonly key: string;\n  /** Already in the reader's language. */\n  readonly label: string;\n  readonly emphasis?: 'primary' | 'default';\n  /** Order among the secondaries, lowest first; absent keeps the given order. */\n  readonly priority?: number;\n  readonly destructive?: boolean;\n  /** Shown on a row itself rather than only in its menu. */\n  readonly rowInline?: boolean;\n  readonly shortcut?: string;\n  readonly disabled?: boolean;\n  /**\n   * An action that navigates rather than acts — a list's \"New\". It is never\n   * folded into a menu, whatever its emphasis: a menu entry is a button, and a\n   * link must stay a link so it can be opened in a new tab.\n   */\n  readonly href?: string;\n  /** What the link means, for a host that answers navigation itself. */\n  readonly intent?: NavigationIntent;\n  readonly onSelect?: () => void;\n  /**\n   * Submits the form the bar sits in — a form's Save — so Enter in a field\n   * saves too. As a button it leaves the act to the form's submit handler; in\n   * a menu, where a menu item cannot submit, it runs `onSelect`.\n   */\n  readonly submit?: boolean;\n}\n\nexport interface ActionBarProps {\n  readonly surface: ActionBarSurface;\n  readonly items: readonly ActionBarItem[];\n  /**\n   * The overflow trigger's name. Defaults to \"More actions\"; a row passes\n   * \"Actions for {record}\", so a list of rows is not a list of identical\n   * buttons.\n   */\n  readonly menuLabel?: string;\n  readonly size?: 'sm' | 'md';\n  readonly renderLink?: RenderLink;\n  readonly className?: string;\n}\n\n/**\n * The bar items for declared verbs: label translated, weight and order carried\n * from the descriptor, every one routed through `onSelect` — which is where a\n * surface's `invoke()` asks for a confirmation, so no surface can reach a verb\n * around it.\n */\nexport function itemsForUseCases(\n  descriptors: readonly UseCaseDescriptor[],\n  translate: (key: string) => string,\n  onSelect: (descriptor: UseCaseDescriptor) => void,\n  disabled = false,\n): ActionBarItem[] {\n  return descriptors.map(descriptor => ({\n    key: descriptor.key,\n    label: translate(descriptor.labelKey),\n    emphasis: descriptor.emphasis,\n    priority: descriptor.priority,\n    destructive: descriptor.confirm?.tone === 'destructive',\n    rowInline: descriptor.rowInline === true,\n    shortcut: descriptor.shortcut,\n    disabled,\n    onSelect: () => onSelect(descriptor),\n  }));\n}\n\n/**\n * Secondaries in the order they render: by priority, then as given, with the\n * destructive ones last so a separator can stand between \"do\" and \"destroy\".\n */\nfunction ordered(items: readonly ActionBarItem[]): ActionBarItem[] {\n  const ranked = items\n    .map((item, index) => ({ item, index }))\n    .sort(\n      (a, b) =>\n        (a.item.priority ?? Infinity) - (b.item.priority ?? Infinity) ||\n        a.index - b.index,\n    )\n    .map(({ item }) => item);\n  return [\n    ...ranked.filter(item => !item.destructive),\n    ...ranked.filter(item => item.destructive),\n  ];\n}\n\nfunction assertHierarchy(\n  surface: ActionBarSurface,\n  items: readonly ActionBarItem[],\n): ActionBarItem | undefined {\n  const primaries = items.filter(item => item.emphasis === 'primary');\n  if (primaries.length > 1) {\n    throw new Error(\n      `The ${surface} surface has ${primaries.length} primary actions (${primaries\n        .map(item => item.key)\n        .join(\n          ', ',\n        )}). A surface has one thing it is for: declare one primary and give the rest the default emphasis.`,\n    );\n  }\n  const [primary] = primaries;\n  if (primary?.destructive && PAGE_SURFACES.has(surface)) {\n    throw new Error(\n      `\"${primary.key}\" is destructive and declared primary on ${surface}. A page is never for destroying itself: give it the default emphasis, and it renders last, after a separator.`,\n    );\n  }\n  return primary;\n}\n\n/**\n * One way every surface renders its verbs\n * ([ADR 0026](../../../../../../../docs/adr/0026-actions-hierarchy-overflow-and-destructive-verbs.md)):\n * the primary, then up to {@link VISIBLE_SECONDARIES} secondaries, then a\n * \"More actions\" menu button holding the rest — destructive verbs last, after\n * a separator.\n *\n * ⚠️ **It collapses by container, not by viewport.** Below the container's\n * `md` width it renders the primary and one menu holding every secondary; a\n * bar inside a split view or a drawer is as narrow as its container, whatever\n * the window is. Both arrangements are in the DOM and CSS shows one, so the\n * server renders the right one with no measurement.\n *\n * A row renders differently: the verb it declares `rowInline` sits on the row,\n * and everything else is in one menu named for the record.\n *\n * It throws on a second primary, and on a destructive primary on a page\n * surface — both are declarations no rendering can make sensible.\n */\nexport function ActionBar({\n  surface,\n  items,\n  menuLabel,\n  size = 'sm',\n  renderLink = renderAnchor,\n  className,\n}: ActionBarProps) {\n  const t = useT();\n  const primary = assertHierarchy(surface, items);\n  // A row's verbs are bound nowhere — every row would claim the same chord —\n  // so they advertise none. Every other surface binds what it advertises.\n  const bindsShortcuts = surface !== 'row-menu';\n  const keyShortcuts = (item: ActionBarItem) =>\n    bindsShortcuts && item.shortcut !== undefined\n      ? ariaKeyShortcuts(item.shortcut)\n      : undefined;\n  const label = menuLabel ?? t('actions.more');\n\n  const asButton = (item: ActionBarItem, variant: 'primary' | 'secondary') =>\n    item.href === undefined ? (\n      <Button\n        key={item.key}\n        type={item.submit ? 'submit' : 'button'}\n        variant={item.destructive ? 'destructive' : variant}\n        size={size}\n        disabled={item.disabled}\n        aria-keyshortcuts={keyShortcuts(item)}\n        onClick={item.submit ? undefined : item.onSelect}\n      >\n        {item.label}\n      </Button>\n    ) : (\n      <span key={item.key} className=\"contents\">\n        {renderLink({\n          href: item.href,\n          className: button({ variant, size }),\n          children: item.label,\n          intent: item.intent ?? { kind: 'new' },\n        })}\n      </span>\n    );\n\n  const menu = (folded: readonly ActionBarItem[], key: string): ReactNode => {\n    if (folded.length === 0) return undefined;\n    const firstDestructive = folded.findIndex(item => item.destructive);\n    return (\n      <Menu key={key}>\n        <Menu.Trigger aria-label={label} title={label}>\n          {OVERFLOW_GLYPH}\n        </Menu.Trigger>\n        <Menu.Items>\n          {folded.map((item, index) => (\n            <Fragment key={item.key}>\n              {index > 0 && index === firstDestructive && <Menu.Separator />}\n              <Menu.Item\n                tone={item.destructive ? 'destructive' : 'neutral'}\n                disabled={item.disabled}\n                aria-keyshortcuts={keyShortcuts(item)}\n                onClick={item.onSelect}\n              >\n                {item.label}\n              </Menu.Item>\n            </Fragment>\n          ))}\n        </Menu.Items>\n      </Menu>\n    );\n  };\n\n  if (surface === 'row-menu') {\n    const inline = items.filter(item => item.rowInline);\n    return (\n      <span className={cn('flex items-center gap-2xs', className)}>\n        {inline.map(item => asButton(item, 'secondary'))}\n        {menu(ordered(items.filter(item => !item.rowInline)), 'row')}\n      </span>\n    );\n  }\n\n  const links = items.filter(\n    item => item !== primary && item.href !== undefined,\n  );\n  const secondaries = ordered(\n    items.filter(item => item !== primary && item.href === undefined),\n  );\n  const visible = secondaries.slice(0, VISIBLE_SECONDARIES);\n  const separatorAt = visible.findIndex(item => item.destructive);\n  // A menu holding one entry is strictly worse than the button it replaced.\n  const collapses = secondaries.length > 1;\n\n  return (\n    <div\n      className={cn('min-w-0 @container/actions flex-1', className)}\n      data-surface={surface}\n    >\n      {items.map(item =>\n        item.shortcut === undefined ||\n        item.onSelect === undefined ||\n        item.href !== undefined ? null : (\n          <ItemShortcut\n            key={item.key}\n            chord={item.shortcut}\n            onSelect={item.onSelect}\n            enabled={item.disabled !== true}\n          />\n        ),\n      )}\n      <div className=\"flex flex-wrap items-center gap-2xs\">\n        {primary && asButton(primary, 'primary')}\n        {links.map(item => asButton(item, 'secondary'))}\n        <div\n          className={cn(\n            'flex-wrap items-center gap-2xs',\n            collapses ? '@md/actions:flex hidden' : 'flex',\n          )}\n          data-arrangement=\"wide\"\n        >\n          {visible.map((item, index) => (\n            <span key={item.key} className=\"contents\">\n              {index > 0 && index === separatorAt && (\n                <span\n                  aria-hidden=\"true\"\n                  className=\"w-px self-stretch bg-border\"\n                />\n              )}\n              {asButton(item, 'secondary')}\n            </span>\n          ))}\n          {menu(secondaries.slice(VISIBLE_SECONDARIES), 'overflow')}\n        </div>\n        {collapses && (\n          <div className=\"@md/actions:hidden flex\" data-arrangement=\"narrow\">\n            {menu(secondaries, 'collapsed')}\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n\n/**\n * Binds one item's shortcut for as long as the bar shows it — yielding to a\n * binding already there, so a host's own chord wins over a surface's default.\n */\nfunction ItemShortcut({\n  chord,\n  onSelect,\n  enabled,\n}: {\n  chord: string;\n  onSelect: () => void;\n  enabled: boolean;\n}) {\n  useHotkey([chord], onSelect, { enabled, ifFree: true });\n  return null;\n}\n"],"names":["Fragment","useT","OVERFLOW_GLYPH","renderAnchor","ariaKeyShortcuts","Button","button","cn","useHotkey","Menu","PAGE_SURFACES","Set","VISIBLE_SECONDARIES","itemsForUseCases","descriptors","translate","onSelect","disabled","map","descriptor","key","label","labelKey","emphasis","priority","destructive","confirm","tone","rowInline","shortcut","ordered","items","ranked","item","index","sort","a","b","Infinity","filter","assertHierarchy","surface","primaries","length","Error","join","primary","has","ActionBar","menuLabel","size","renderLink","className","t","bindsShortcuts","keyShortcuts","undefined","asButton","variant","href","type","submit","aria-keyshortcuts","onClick","span","children","intent","kind","menu","folded","firstDestructive","findIndex","Trigger","aria-label","title","Items","Separator","Item","inline","links","secondaries","visible","slice","separatorAt","collapses","div","data-surface","ItemShortcut","chord","enabled","data-arrangement","aria-hidden","ifFree"],"mappings":"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"}

package/dist/ui/molecules/action-bar/index.d.ts

@@ -0,0 +1,2 @@
+export * from './action-bar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/molecules/action-bar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/molecules/action-bar/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/ui/molecules/action-bar/index.js

@@ -0,0 +1,3 @@
+export * from './action-bar.js';
+
+//# sourceMappingURL=index.js.map

package/dist/ui/molecules/action-bar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/molecules/action-bar/index.ts"],"sourcesContent":["export * from './action-bar.js';\n"],"names":[],"mappings":"AAAA,cAAc,kBAAkB"}

package/dist/ui/molecules/breadcrumbs/breadcrumbs.d.ts

@@ -5,6 +5,11 @@ export interface BreadcrumbItem {
 }
 export interface BreadcrumbsProps extends Omit<ComponentPropsWithoutRef<'nav'>, 'children'> {
     items: BreadcrumbItem[];
+    /**
+     * The trail's accessible name. English when omitted; a host with a catalog
+     * passes its own (the controls catalog's `breadcrumbs.label`).
+     */
+    label?: string;
     /** Glyph between crumbs. */
     separator?: ReactNode;
     /**
@@ -22,6 +27,10 @@ export interface BreadcrumbsProps extends Omit<ComponentPropsWithoutRef<'nav'>,
         className: string;
     }) => ReactNode;
 }
-/** Accessible breadcrumb trail. Presentational only — no routing knowledge. */
-export declare function Breadcrumbs({ items, separator, renderLink, className, ...props }: BreadcrumbsProps): import("react").JSX.Element;
+/**
+ * Accessible breadcrumb trail. Presentational only — no routing knowledge, and
+ * no hooks: every label arrives as a prop, so a server component renders it
+ * and a storefront never pays a client boundary for its trail.
+ */
+export declare function Breadcrumbs({ items, label, separator, renderLink, className, ...props }: BreadcrumbsProps): import("react").JSX.Element;
 //# sourceMappingURL=breadcrumbs.d.ts.map