@entifix/react-controls 0.1.1 → 0.1.3

package/dist/ui/molecules/segmented-nav/segmented-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/molecules/segmented-nav/segmented-nav.tsx"],"sourcesContent":["import type { ComponentType, ReactNode } from 'react';\n\nimport { CURRENT, LIST, OTHER } from './segment-classes.js';\n\n/** One segment: a page of its own, the current one marked. */\nexport interface SegmentedNavItem {\n  readonly key: string;\n  readonly label: ReactNode;\n  readonly href: string;\n  readonly current: boolean;\n}\n\n/** What renders a segment that leads elsewhere: an `<a>`, or a router's link. */\nexport type SegmentedNavLink = ComponentType<{\n  href: string;\n  className?: string;\n  children: ReactNode;\n}>;\n\nconst ANCHOR: SegmentedNavLink = props => <a {...props} />;\n\n/**\n * A choice between pages, drawn as one segmented control: each segment is a\n * link, the current page's is a marked span. A visible label names the\n * choice; the `<nav>` carries it for assistive technology.\n *\n * No hooks, so a server component renders it, and every segment works with\n * scripting off. Its parts carry `data-slot` (`segmented-nav`,\n * `segmented-nav-label`, `segmented-nav-list`, `segmented-nav-item`).\n */\nexport function SegmentedNav({\n  label,\n  items,\n  link: Link = ANCHOR,\n  className,\n}: {\n  label: string;\n  items: readonly SegmentedNavItem[];\n  link?: SegmentedNavLink;\n  className?: string;\n}) {\n  return (\n    <nav data-slot=\"segmented-nav\" aria-label={label} className={className}>\n      <span\n        data-slot=\"segmented-nav-label\"\n        aria-hidden=\"true\"\n        className=\"text-step-sm text-content-muted\"\n      >\n        {label}\n      </span>\n      <ul data-slot=\"segmented-nav-list\" className={LIST}>\n        {items.map(item => (\n          <li\n            key={item.key}\n            data-slot=\"segmented-nav-item\"\n            className=\"flex-none\"\n          >\n            {item.current ? (\n              <span aria-current=\"page\" className={CURRENT}>\n                {item.label}\n              </span>\n            ) : (\n              <Link href={item.href} className={OTHER}>\n                {item.label}\n              </Link>\n            )}\n          </li>\n        ))}\n      </ul>\n    </nav>\n  );\n}\n"],"names":["CURRENT","LIST","OTHER","ANCHOR","props","a","SegmentedNav","label","items","link","Link","className","nav","data-slot","aria-label","span","aria-hidden","ul","map","item","li","current","aria-current","href","key"],"mappings":";;AAEA,SAASA,OAAO,EAAEC,IAAI,EAAEC,KAAK,QAAQ,uBAAuB;AAiB5D,MAAMC,SAA2BC,CAAAA,sBAAS,KAACC,kBAAMD;AAEjD;;;;;;;;CAQC,GACD,OAAO,SAASE,aAAa,EAC3BC,KAAK,EACLC,KAAK,EACLC,MAAMC,OAAOP,MAAM,EACnBQ,SAAS,EAMV;IACC,qBACE,MAACC;QAAIC,aAAU;QAAgBC,cAAYP;QAAOI,WAAWA;;0BAC3D,KAACI;gBACCF,aAAU;gBACVG,eAAY;gBACZL,WAAU;0BAETJ;;0BAEH,KAACU;gBAAGJ,aAAU;gBAAqBF,WAAWV;0BAC3CO,MAAMU,GAAG,CAACC,CAAAA,qBACT,KAACC;wBAECP,aAAU;wBACVF,WAAU;kCAETQ,KAAKE,OAAO,iBACX,KAACN;4BAAKO,gBAAa;4BAAOX,WAAWX;sCAClCmB,KAAKZ,KAAK;2CAGb,KAACG;4BAAKa,MAAMJ,KAAKI,IAAI;4BAAEZ,WAAWT;sCAC/BiB,KAAKZ,KAAK;;uBAVVY,KAAKK,GAAG;;;;AAkBzB"}

package/dist/ui/molecules/split-button/index.d.ts

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

package/dist/ui/molecules/split-button/index.d.ts.map

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

package/dist/ui/molecules/split-button/index.js

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

package/dist/ui/molecules/split-button/index.js.map

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

package/dist/ui/molecules/split-button/split-button.d.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react';
+/**
+ * One main action, and a menu of the related ones beside it: `[Download │ ▾]`.
+ *
+ * The caller renders the main action — a link or a button, styled as the
+ * primary button — so it stays in the static HTML and keeps its own
+ * attributes; without `children` it stands alone, as before scripting runs.
+ * The menu is a `NavMenu`, so it opens with scripting off and the page's own
+ * menu handling closes it. Parts carry `data-slot` (`split-button`, and the
+ * menu's own).
+ */
+export declare function SplitButton({ primary, menuLabel, children, className, }: {
+    /** The main action, its corners squared on the side the menu joins. */
+    primary: ReactNode;
+    /** The accessible name of the ▾ trigger. */
+    menuLabel: string;
+    /** The menu's entries; none, and the main action stands alone. */
+    children?: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=split-button.d.ts.map

package/dist/ui/molecules/split-button/split-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-button.d.ts","sourceRoot":"","sources":["../../../../src/ui/molecules/split-button/split-button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAYvC;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,SAAS,EACT,QAAQ,EACR,SAAS,GACV,EAAE;IACD,uEAAuE;IACvE,OAAO,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAuBA"}

package/dist/ui/molecules/split-button/split-button.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { button } from '../../atoms/button/button-recipe.js';
+import { cn } from '../../utils/cn.js';
+import { NavMenu } from '../nav-menu/nav-menu.js';
+/** The ▾ segment: the primary button's look, joined to the action before it. */ const TRIGGER = cn(button({
+    variant: 'primary',
+    size: 'sm'
+}), 'h-auto cursor-pointer list-none self-stretch rounded-l-none border-l border-l-[color-mix(in_srgb,var(--color-primary-content)_25%,transparent)] px-2xs select-none [&_[data-slot=nav-menu-chevron]]:text-current [&::-webkit-details-marker]:hidden');
+/**
+ * One main action, and a menu of the related ones beside it: `[Download │ ▾]`.
+ *
+ * The caller renders the main action — a link or a button, styled as the
+ * primary button — so it stays in the static HTML and keeps its own
+ * attributes; without `children` it stands alone, as before scripting runs.
+ * The menu is a `NavMenu`, so it opens with scripting off and the page's own
+ * menu handling closes it. Parts carry `data-slot` (`split-button`, and the
+ * menu's own).
+ */ export function SplitButton({ primary, menuLabel, children, className }) {
+    return /*#__PURE__*/ _jsxs("div", {
+        "data-slot": "split-button",
+        className: cn('inline-flex items-stretch', children !== undefined && '[&>:first-child]:rounded-r-none', className),
+        children: [
+            primary,
+            children !== undefined && /*#__PURE__*/ _jsx(NavMenu, {
+                label: menuLabel,
+                icon: null,
+                className: "flex",
+                triggerClassName: TRIGGER,
+                children: children
+            })
+        ]
+    });
+}
+
+//# sourceMappingURL=split-button.js.map

package/dist/ui/molecules/split-button/split-button.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/molecules/split-button/split-button.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { button } from '../../atoms/button/button-recipe.js';\nimport { cn } from '../../utils/cn.js';\nimport { NavMenu } from '../nav-menu/nav-menu.js';\n\n/** The ▾ segment: the primary button's look, joined to the action before it. */\nconst TRIGGER = cn(\n  button({ variant: 'primary', size: 'sm' }),\n  'h-auto cursor-pointer list-none self-stretch rounded-l-none border-l border-l-[color-mix(in_srgb,var(--color-primary-content)_25%,transparent)] px-2xs select-none [&_[data-slot=nav-menu-chevron]]:text-current [&::-webkit-details-marker]:hidden',\n);\n\n/**\n * One main action, and a menu of the related ones beside it: `[Download │ ▾]`.\n *\n * The caller renders the main action — a link or a button, styled as the\n * primary button — so it stays in the static HTML and keeps its own\n * attributes; without `children` it stands alone, as before scripting runs.\n * The menu is a `NavMenu`, so it opens with scripting off and the page's own\n * menu handling closes it. Parts carry `data-slot` (`split-button`, and the\n * menu's own).\n */\nexport function SplitButton({\n  primary,\n  menuLabel,\n  children,\n  className,\n}: {\n  /** The main action, its corners squared on the side the menu joins. */\n  primary: ReactNode;\n  /** The accessible name of the ▾ trigger. */\n  menuLabel: string;\n  /** The menu's entries; none, and the main action stands alone. */\n  children?: ReactNode;\n  className?: string;\n}) {\n  return (\n    <div\n      data-slot=\"split-button\"\n      className={cn(\n        'inline-flex items-stretch',\n        children !== undefined && '[&>:first-child]:rounded-r-none',\n        className,\n      )}\n    >\n      {primary}\n      {children !== undefined && (\n        <NavMenu\n          label={menuLabel}\n          icon={null}\n          className=\"flex\"\n          triggerClassName={TRIGGER}\n        >\n          {children}\n        </NavMenu>\n      )}\n    </div>\n  );\n}\n"],"names":["button","cn","NavMenu","TRIGGER","variant","size","SplitButton","primary","menuLabel","children","className","div","data-slot","undefined","label","icon","triggerClassName"],"mappings":";AAEA,SAASA,MAAM,QAAQ,sCAAsC;AAC7D,SAASC,EAAE,QAAQ,oBAAoB;AACvC,SAASC,OAAO,QAAQ,0BAA0B;AAElD,8EAA8E,GAC9E,MAAMC,UAAUF,GACdD,OAAO;IAAEI,SAAS;IAAWC,MAAM;AAAK,IACxC;AAGF;;;;;;;;;CASC,GACD,OAAO,SAASC,YAAY,EAC1BC,OAAO,EACPC,SAAS,EACTC,QAAQ,EACRC,SAAS,EASV;IACC,qBACE,MAACC;QACCC,aAAU;QACVF,WAAWT,GACT,6BACAQ,aAAaI,aAAa,mCAC1BH;;YAGDH;YACAE,aAAaI,2BACZ,KAACX;gBACCY,OAAON;gBACPO,MAAM;gBACNL,WAAU;gBACVM,kBAAkBb;0BAEjBM;;;;AAKX"}

package/dist/ui/molecules/split-view/index.d.ts

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

package/dist/ui/molecules/split-view/index.d.ts.map

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

package/dist/ui/molecules/split-view/index.js

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

package/dist/ui/molecules/split-view/index.js.map

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

package/dist/ui/molecules/split-view/split-view.d.ts

@@ -0,0 +1,35 @@
+import type { ReactNode } from 'react';
+export interface SplitViewItem {
+    readonly id: string;
+    /** What the list shows of the item: its number and title, say. */
+    readonly head: ReactNode;
+    /** What the pane shows once the item is chosen. */
+    readonly detail: ReactNode;
+    /** Where the item lives on its own: followed without scripting. */
+    readonly href: string;
+}
+/**
+ * A list beside a reading pane: the chosen item's detail shows next to the
+ * list on a wide screen, and under its own row on a narrow one, where the
+ * list reads as an accordion.
+ *
+ * One markup for both: the chosen row carries its detail. On a wide screen
+ * the list is a column of fixed height that scrolls, and the detail is placed
+ * against the whole view, so the list's overflow neither clips nor scrolls it.
+ *
+ * Each row is a link to the item's own page, which is what a visitor without
+ * scripting follows. With it, a plain click chooses instead, and ↑, ↓, Home
+ * and End move the choice, focus following it (one row in the tab order).
+ * Parts carry `data-slot` (`split-view`, `split-list`, `split-row`,
+ * `split-trigger`, `split-detail`) for a page to restyle.
+ */
+export declare function SplitView({ label, items, selected, onSelect, className, }: {
+    /** The list's accessible name. */
+    label: string;
+    items: readonly SplitViewItem[];
+    /** The chosen item's id; an unknown one chooses nothing. */
+    selected: string | undefined;
+    onSelect: (id: string) => void;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=split-view.d.ts.map

package/dist/ui/molecules/split-view/split-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-view.d.ts","sourceRoot":"","sources":["../../../../src/ui/molecules/split-view/split-view.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA6B,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAYD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,EAAE;IACD,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BA8DA"}

package/dist/ui/molecules/split-view/split-view.js

@@ -0,0 +1,76 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../../utils/cn.js';
+/** The keys that move the choice, and where each moves it. */ const MOVES = {
+    ArrowDown: (index, count)=>Math.min(index + 1, count - 1),
+    ArrowUp: (index)=>Math.max(index - 1, 0),
+    Home: ()=>0,
+    End: (_, count)=>count - 1
+};
+/**
+ * A list beside a reading pane: the chosen item's detail shows next to the
+ * list on a wide screen, and under its own row on a narrow one, where the
+ * list reads as an accordion.
+ *
+ * One markup for both: the chosen row carries its detail. On a wide screen
+ * the list is a column of fixed height that scrolls, and the detail is placed
+ * against the whole view, so the list's overflow neither clips nor scrolls it.
+ *
+ * Each row is a link to the item's own page, which is what a visitor without
+ * scripting follows. With it, a plain click chooses instead, and ↑, ↓, Home
+ * and End move the choice, focus following it (one row in the tab order).
+ * Parts carry `data-slot` (`split-view`, `split-list`, `split-row`,
+ * `split-trigger`, `split-detail`) for a page to restyle.
+ */ export function SplitView({ label, items, selected, onSelect, className }) {
+    const index = items.findIndex((item)=>item.id === selected);
+    const focusable = index === -1 ? 0 : index;
+    const choose = (event, id)=>{
+        // A new tab or window is the link's own business.
+        if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey) return;
+        event.preventDefault();
+        onSelect(id);
+    };
+    const move = (event)=>{
+        var _event_currentTarget_querySelectorAll_next;
+        const to = MOVES[event.key];
+        if (to === undefined) return;
+        event.preventDefault();
+        const next = to(focusable, items.length);
+        (_event_currentTarget_querySelectorAll_next = event.currentTarget.querySelectorAll('[data-slot="split-trigger"]')[next]) == null ? void 0 : _event_currentTarget_querySelectorAll_next.focus();
+        onSelect(items[next].id);
+    };
+    return /*#__PURE__*/ _jsx("div", {
+        "data-slot": "split-view",
+        className: cn('lg:min-h-[28rem] relative', className),
+        children: /*#__PURE__*/ _jsx("ol", {
+            "data-slot": "split-list",
+            "aria-label": label,
+            onKeyDown: move,
+            className: "m-0 p-0 lg:max-h-[28rem] lg:w-[40%] lg:overflow-y-auto list-none",
+            children: items.map((item, at)=>{
+                const chosen = at === index;
+                return /*#__PURE__*/ _jsxs("li", {
+                    "data-slot": "split-row",
+                    children: [
+                        /*#__PURE__*/ _jsx("a", {
+                            href: item.href,
+                            "data-slot": "split-trigger",
+                            "aria-current": chosen ? 'true' : undefined,
+                            tabIndex: at === focusable ? 0 : -1,
+                            onClick: (event)=>choose(event, item.id),
+                            className: "block rounded-md px-xs py-2xs text-inherit no-underline focus-ring hover:bg-[color-mix(in_srgb,var(--color-content)_6%,transparent)] aria-[current]:bg-[color-mix(in_srgb,var(--color-primary)_14%,transparent)]",
+                            children: item.head
+                        }),
+                        chosen && /*#__PURE__*/ _jsx("div", {
+                            "data-slot": "split-detail",
+                            className: "lg:absolute lg:top-0 lg:right-0 lg:max-h-[28rem] lg:w-[58%] lg:overflow-y-auto lg:p-0 px-xs py-s",
+                            children: item.detail
+                        })
+                    ]
+                }, item.id);
+            })
+        })
+    });
+}
+
+//# sourceMappingURL=split-view.js.map

package/dist/ui/molecules/split-view/split-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/molecules/split-view/split-view.tsx"],"sourcesContent":["'use client';\n\nimport type { KeyboardEvent, MouseEvent, ReactNode } from 'react';\n\nimport { cn } from '../../utils/cn.js';\n\nexport interface SplitViewItem {\n  readonly id: string;\n  /** What the list shows of the item: its number and title, say. */\n  readonly head: ReactNode;\n  /** What the pane shows once the item is chosen. */\n  readonly detail: ReactNode;\n  /** Where the item lives on its own: followed without scripting. */\n  readonly href: string;\n}\n\n/** The keys that move the choice, and where each moves it. */\nconst MOVES: Readonly<\n  Record<string, (index: number, count: number) => number>\n> = {\n  ArrowDown: (index, count) => Math.min(index + 1, count - 1),\n  ArrowUp: index => Math.max(index - 1, 0),\n  Home: () => 0,\n  End: (_, count) => count - 1,\n};\n\n/**\n * A list beside a reading pane: the chosen item's detail shows next to the\n * list on a wide screen, and under its own row on a narrow one, where the\n * list reads as an accordion.\n *\n * One markup for both: the chosen row carries its detail. On a wide screen\n * the list is a column of fixed height that scrolls, and the detail is placed\n * against the whole view, so the list's overflow neither clips nor scrolls it.\n *\n * Each row is a link to the item's own page, which is what a visitor without\n * scripting follows. With it, a plain click chooses instead, and ↑, ↓, Home\n * and End move the choice, focus following it (one row in the tab order).\n * Parts carry `data-slot` (`split-view`, `split-list`, `split-row`,\n * `split-trigger`, `split-detail`) for a page to restyle.\n */\nexport function SplitView({\n  label,\n  items,\n  selected,\n  onSelect,\n  className,\n}: {\n  /** The list's accessible name. */\n  label: string;\n  items: readonly SplitViewItem[];\n  /** The chosen item's id; an unknown one chooses nothing. */\n  selected: string | undefined;\n  onSelect: (id: string) => void;\n  className?: string;\n}) {\n  const index = items.findIndex(item => item.id === selected);\n  const focusable = index === -1 ? 0 : index;\n\n  const choose = (event: MouseEvent, id: string) => {\n    // A new tab or window is the link's own business.\n    if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey)\n      return;\n    event.preventDefault();\n    onSelect(id);\n  };\n\n  const move = (event: KeyboardEvent<HTMLOListElement>) => {\n    const to = MOVES[event.key];\n    if (to === undefined) return;\n    event.preventDefault();\n    const next = to(focusable, items.length);\n    event.currentTarget\n      .querySelectorAll<HTMLElement>('[data-slot=\"split-trigger\"]')\n      [next]?.focus();\n    onSelect((items[next] as SplitViewItem).id);\n  };\n\n  return (\n    <div\n      data-slot=\"split-view\"\n      className={cn('lg:min-h-[28rem] relative', className)}\n    >\n      <ol\n        data-slot=\"split-list\"\n        aria-label={label}\n        onKeyDown={move}\n        className=\"m-0 p-0 lg:max-h-[28rem] lg:w-[40%] lg:overflow-y-auto list-none\"\n      >\n        {items.map((item, at) => {\n          const chosen = at === index;\n          return (\n            <li key={item.id} data-slot=\"split-row\">\n              <a\n                href={item.href}\n                data-slot=\"split-trigger\"\n                aria-current={chosen ? 'true' : undefined}\n                tabIndex={at === focusable ? 0 : -1}\n                onClick={event => choose(event, item.id)}\n                className=\"block rounded-md px-xs py-2xs text-inherit no-underline focus-ring hover:bg-[color-mix(in_srgb,var(--color-content)_6%,transparent)] aria-[current]:bg-[color-mix(in_srgb,var(--color-primary)_14%,transparent)]\"\n              >\n                {item.head}\n              </a>\n              {chosen && (\n                <div\n                  data-slot=\"split-detail\"\n                  className=\"lg:absolute lg:top-0 lg:right-0 lg:max-h-[28rem] lg:w-[58%] lg:overflow-y-auto lg:p-0 px-xs py-s\"\n                >\n                  {item.detail}\n                </div>\n              )}\n            </li>\n          );\n        })}\n      </ol>\n    </div>\n  );\n}\n"],"names":["cn","MOVES","ArrowDown","index","count","Math","min","ArrowUp","max","Home","End","_","SplitView","label","items","selected","onSelect","className","findIndex","item","id","focusable","choose","event","button","metaKey","ctrlKey","shiftKey","preventDefault","move","to","key","undefined","next","length","currentTarget","querySelectorAll","focus","div","data-slot","ol","aria-label","onKeyDown","map","at","chosen","li","a","href","aria-current","tabIndex","onClick","head","detail"],"mappings":"AAAA;;AAIA,SAASA,EAAE,QAAQ,oBAAoB;AAYvC,4DAA4D,GAC5D,MAAMC,QAEF;IACFC,WAAW,CAACC,OAAOC,QAAUC,KAAKC,GAAG,CAACH,QAAQ,GAAGC,QAAQ;IACzDG,SAASJ,CAAAA,QAASE,KAAKG,GAAG,CAACL,QAAQ,GAAG;IACtCM,MAAM,IAAM;IACZC,KAAK,CAACC,GAAGP,QAAUA,QAAQ;AAC7B;AAEA;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASQ,UAAU,EACxBC,KAAK,EACLC,KAAK,EACLC,QAAQ,EACRC,QAAQ,EACRC,SAAS,EASV;IACC,MAAMd,QAAQW,MAAMI,SAAS,CAACC,CAAAA,OAAQA,KAAKC,EAAE,KAAKL;IAClD,MAAMM,YAAYlB,UAAU,CAAC,IAAI,IAAIA;IAErC,MAAMmB,SAAS,CAACC,OAAmBH;QACjC,kDAAkD;QAClD,IAAIG,MAAMC,MAAM,KAAK,KAAKD,MAAME,OAAO,IAAIF,MAAMG,OAAO,IAAIH,MAAMI,QAAQ,EACxE;QACFJ,MAAMK,cAAc;QACpBZ,SAASI;IACX;IAEA,MAAMS,OAAO,CAACN;YAKZA;QAJA,MAAMO,KAAK7B,KAAK,CAACsB,MAAMQ,GAAG,CAAC;QAC3B,IAAID,OAAOE,WAAW;QACtBT,MAAMK,cAAc;QACpB,MAAMK,OAAOH,GAAGT,WAAWP,MAAMoB,MAAM;SACvCX,6CAAAA,MAAMY,aAAa,CAChBC,gBAAgB,CAAc,8BAC/B,CAACH,KAAK,qBAFRV,2CAEUc,KAAK;QACfrB,SAAS,AAACF,KAAK,CAACmB,KAAK,CAAmBb,EAAE;IAC5C;IAEA,qBACE,KAACkB;QACCC,aAAU;QACVtB,WAAWjB,GAAG,6BAA6BiB;kBAE3C,cAAA,KAACuB;YACCD,aAAU;YACVE,cAAY5B;YACZ6B,WAAWb;YACXZ,WAAU;sBAETH,MAAM6B,GAAG,CAAC,CAACxB,MAAMyB;gBAChB,MAAMC,SAASD,OAAOzC;gBACtB,qBACE,MAAC2C;oBAAiBP,aAAU;;sCAC1B,KAACQ;4BACCC,MAAM7B,KAAK6B,IAAI;4BACfT,aAAU;4BACVU,gBAAcJ,SAAS,SAASb;4BAChCkB,UAAUN,OAAOvB,YAAY,IAAI,CAAC;4BAClC8B,SAAS5B,CAAAA,QAASD,OAAOC,OAAOJ,KAAKC,EAAE;4BACvCH,WAAU;sCAETE,KAAKiC,IAAI;;wBAEXP,wBACC,KAACP;4BACCC,aAAU;4BACVtB,WAAU;sCAETE,KAAKkC,MAAM;;;mBAhBTlC,KAAKC,EAAE;YAqBpB;;;AAIR"}

package/dist/ui/organisms/entity-form/entity-form.d.ts

@@ -1,4 +1,4 @@
 import { type Entity } from '@entifix/core';
 import type { EntityFormProps } from './entity-form.types.js';
-export declare function EntityForm<TEntity extends Entity>({ entityConstructor, entity, values, onFieldChange, linkSources, onLinkChange, mode: modeProp, defaultMode, onModeChange, errors, formError, onSubmit, onDelete, embedded, isLoading, skeleton, isSaving, isDeleting, error, backHref, title, metadata, isMetadataLoading, onUseCase, onClone, children, }: EntityFormProps<TEntity>): import("react").JSX.Element;
+export declare function EntityForm<TEntity extends Entity>({ entityConstructor, entity, values, onFieldChange, linkSources, onLinkChange, mode: modeProp, defaultMode, onModeChange, errors, formError, onSubmit, onDelete, embedded, isLoading, skeleton, isSaving, isDeleting, error, backHref, renderLink, title, metadata, isMetadataLoading, onUseCase, onClone, children, }: EntityFormProps<TEntity>): import("react").JSX.Element;
 //# sourceMappingURL=entity-form.d.ts.map

package/dist/ui/organisms/entity-form/entity-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-form.d.ts","sourceRoot":"","sources":["../../../../src/ui/organisms/entity-form/entity-form.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,MAAM,EASZ,MAAM,eAAe,CAAC;AAsBvB,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,wBAAwB,CAAC;AA6DhC,wBAAgB,UAAU,CAAC,OAAO,SAAS,MAAM,EAAE,EACjD,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,IAAI,EAAE,QAAQ,EACd,WAAW,EACX,YAAY,EACZ,MAAM,EACN,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAgB,EAChB,SAAiB,EACjB,QAAe,EACf,QAAgB,EAChB,UAAkB,EAClB,KAAK,EACL,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,iBAAyB,EACzB,SAAS,EACT,OAAO,EACP,QAAQ,GACT,EAAE,eAAe,CAAC,OAAO,CAAC,+BAuW1B"}
+{"version":3,"file":"entity-form.d.ts","sourceRoot":"","sources":["../../../../src/ui/organisms/entity-form/entity-form.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,MAAM,EASZ,MAAM,eAAe,CAAC;AA2BvB,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,wBAAwB,CAAC;AA6DhC,wBAAgB,UAAU,CAAC,OAAO,SAAS,MAAM,EAAE,EACjD,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,IAAI,EAAE,QAAQ,EACd,WAAW,EACX,YAAY,EACZ,MAAM,EACN,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAgB,EAChB,SAAiB,EACjB,QAAe,EACf,QAAgB,EAChB,UAAkB,EAClB,KAAK,EACL,QAAQ,EACR,UAAyB,EACzB,KAAK,EACL,QAAQ,EACR,iBAAyB,EACzB,SAAS,EACT,OAAO,EACP,QAAQ,GACT,EAAE,eAAe,CAAC,OAAO,CAAC,+BA8W1B"}

package/dist/ui/organisms/entity-form/entity-form.js

@@ -3,8 +3,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { cloneEntityDraft, describeEntityColumns, EntifixLogicError, readDraftString, readRowDrafts } from '@entifix/core';
 import { useId, useState } from 'react';
 import { useErrorMessage, useLocalizedDescriptors, useT, useTranslateKey } from '../../../i18n/index.js';
-import { OVERFLOW_GLYPH, useCasesForSurface } from '../../actions/index.js';
-import { Button } from '../../atoms/button/index.js';
+import { OVERFLOW_GLYPH, renderAnchor, useCasesForSurface } from '../../actions/index.js';
+import { Button, button } from '../../atoms/button/index.js';
 import { CellValue } from '../../atoms/cell-value/index.js';
 import { FieldControl } from '../../atoms/field-control/index.js';
 import { Skeleton } from '../../atoms/skeleton/index.js';
@@ -15,6 +15,7 @@ import { EntityLinkInput } from '../../molecules/entity-link-input/index.js';
 import { LoadingBoundary } from '../../molecules/loading-boundary/index.js';
 import { Menu } from '../../molecules/menu/index.js';
 import { Stack } from '../../molecules/stack/index.js';
+import { cn } from '../../utils/cn.js';
 import { EntityDetailGrid } from '../entity-detail-grid/index.js';
 import { readEntityFormFields } from './entity-form-slots.js';
 import { resolveEntityFormFields } from './use-entity-form-fields.js';
@@ -64,7 +65,7 @@ import { resolveEntityFormFields } from './use-entity-form-fields.js';
  * without the row wrapping — the same number Fiori's object-page header settles
  * on. It is a layout constant, not a policy: raising it does not grant anything.
  */ const VISIBLE_ACTION_LIMIT = 4;
-export function EntityForm({ entityConstructor, entity, values, onFieldChange, linkSources, onLinkChange, mode: modeProp, defaultMode, onModeChange, errors, formError, onSubmit, onDelete, embedded = false, isLoading = false, skeleton = true, isSaving = false, isDeleting = false, error, backHref, title, metadata, isMetadataLoading = false, onUseCase, onClone, children }) {
+export function EntityForm({ entityConstructor, entity, values, onFieldChange, linkSources, onLinkChange, mode: modeProp, defaultMode, onModeChange, errors, formError, onSubmit, onDelete, embedded = false, isLoading = false, skeleton = true, isSaving = false, isDeleting = false, error, backHref, renderLink = renderAnchor, title, metadata, isMetadataLoading = false, onUseCase, onClone, children }) {
     const formId = useId();
     const slots = readEntityFormFields(children);
     // The *field* descriptors, which stay local and synchronous — a column is a
@@ -319,14 +320,15 @@ export function EntityForm({ entityConstructor, entity, values, onFieldChange, l
                                 children: t('form.clone')
                             }),
                             slots.footerActions,
-                            backHref && /*#__PURE__*/ _jsx("a", {
+                            backHref && renderLink({
                                 href: backHref,
-                                children: /*#__PURE__*/ _jsx(Button, {
-                                    type: "button",
-                                    variant: "ghost",
-                                    disabled: busy,
-                                    children: t('form.back')
-                                })
+                                className: cn(button({
+                                    variant: 'ghost'
+                                }), busy && 'pointer-events-none opacity-50'),
+                                children: t('form.back'),
+                                intent: {
+                                    kind: 'back'
+                                }
                             })
                         ]
                     }),

package/dist/ui/organisms/entity-form/entity-form.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/ui/organisms/entity-form/entity-form.tsx"],"sourcesContent":["'use client';\n\nimport {\n  cloneEntityDraft,\n  describeEntityColumns,\n  EntifixLogicError,\n  type Entity,\n  type EntityAction,\n  type EntityDraft,\n  type EntityDraftValue,\n  type EntityLinkSource,\n  type MetaAccessorType,\n  readDraftString,\n  readRowDrafts,\n  type UseCaseDescriptor,\n} from '@entifix/core';\nimport { type ReactNode, useId, useState } from 'react';\n\nimport {\n  useErrorMessage,\n  useLocalizedDescriptors,\n  useT,\n  useTranslateKey,\n} from '../../../i18n/index.js';\nimport { OVERFLOW_GLYPH, useCasesForSurface } from '../../actions/index.js';\nimport { Button } from '../../atoms/button/index.js';\nimport { CellValue } from '../../atoms/cell-value/index.js';\nimport { FieldControl } from '../../atoms/field-control/index.js';\nimport { Skeleton } from '../../atoms/skeleton/index.js';\nimport { Text } from '../../atoms/text/index.js';\nimport { Card } from '../../molecules/card/index.js';\nimport { ConfirmDialog } from '../../molecules/confirm-dialog/index.js';\nimport { EntityLinkInput } from '../../molecules/entity-link-input/index.js';\nimport { LoadingBoundary } from '../../molecules/loading-boundary/index.js';\nimport { Menu } from '../../molecules/menu/index.js';\nimport { Stack } from '../../molecules/stack/index.js';\nimport { EntityDetailGrid } from '../entity-detail-grid/index.js';\nimport type {\n  EntityFormField,\n  EntityFormMode,\n  EntityFormProps,\n} from './entity-form.types.js';\nimport { readEntityFormFields } from './entity-form-slots.js';\nimport { resolveEntityFormFields } from './use-entity-form-fields.js';\n\n/**\n * The member types a `linkSources` entry can actually produce an editor for.\n *\n * `link` is the obvious one. `string` is here because a foreign key does not\n * have to be a typed relation: when the target lives in **another slice's\n * store**, an `EntityLink` would be an illegal edge and a storage-layer join\n * across a store boundary, so the member is a plain id and the relation exists\n * only in the operator's head (ADR 0022, and `ProductSpecification.brandId` is\n * the live case). Nothing about the editor cares which of the two it is —\n * `EntityLinkInput` writes `String(target.id)` into the draft either way, and\n * the *only* place `link`-ness still matters is `applyEntityLinks` at submit,\n * which skips a non-`link` descriptor and so leaves the id as the truth.\n *\n * Everything else is excluded on purpose rather than by omission: a `boolean`,\n * `enum`, `number` or `date` member cannot name another record, so a source\n * pointed at one is a wiring mistake — see {@link assertLinkSourcesAreEditable}.\n */\nconst PICKABLE_TYPES: ReadonlySet<MetaAccessorType> = new Set<MetaAccessorType>(\n  ['link', 'string'],\n);\n\n/**\n * A form that builds itself from an entity's metadata: fields, labels and value\n * formatting all come from `@accessor()` declarations, so editing a new entity\n * needs no bespoke form. The read/edit toggle is the whole point — the same\n * component shows a record as text or as inputs.\n *\n * Two things layer on top of that default:\n * - **modes** — `read` renders each member through `CellValue`; `edit` renders\n *   the matching `FieldControl`. A member in {@link PICKABLE_TYPES} with an\n *   entry in `linkSources` gets the full picker instead — a to-one `link`, or a\n *   `string` holding a foreign key into another slice's store. Without a source,\n *   a relation stays read-only, and a `linkCollection` always does, the to-many\n *   editor being a follow-up. A source aimed at a member that can render no\n *   picker is a wiring mistake rather than a no-op, and throws.\n * - **slots** — `<EntityField>` children override one field's label, control or\n *   read display, or add a computed field.\n *\n * It is presentational: the draft, its errors and the save/delete actions are\n * all props, so the same form hosts on a plain route and inside a workspace tab.\n */\n/**\n * How many verbs a surface shows before the rest fold into an overflow menu.\n *\n * Four, because that is roughly what fits beside a title at a laptop width\n * without the row wrapping — the same number Fiori's object-page header settles\n * on. It is a layout constant, not a policy: raising it does not grant anything.\n */\nconst VISIBLE_ACTION_LIMIT = 4;\n\n/** A verb waiting on its confirmation — narrowed so `confirm` is not optional. */\ninterface PendingConfirmation {\n  key: string;\n  labelKey: string;\n  confirm: NonNullable<UseCaseDescriptor['confirm']>;\n}\n\nexport function EntityForm<TEntity extends Entity>({\n  entityConstructor,\n  entity,\n  values,\n  onFieldChange,\n  linkSources,\n  onLinkChange,\n  mode: modeProp,\n  defaultMode,\n  onModeChange,\n  errors,\n  formError,\n  onSubmit,\n  onDelete,\n  embedded = false,\n  isLoading = false,\n  skeleton = true,\n  isSaving = false,\n  isDeleting = false,\n  error,\n  backHref,\n  title,\n  metadata,\n  isMetadataLoading = false,\n  onUseCase,\n  onClone,\n  children,\n}: EntityFormProps<TEntity>) {\n  const formId = useId();\n  const slots = readEntityFormFields<TEntity>(children);\n  // The *field* descriptors, which stay local and synchronous — a column is a\n  // property of the class every caller holds. Only an action's availability is\n  // a property of the caller, which is why that half arrives as `metadata`.\n  const columnDescriptors = describeEntityColumns(\n    entityConstructor,\n    entity,\n  ) as Array<EntityFormField<TEntity>>;\n  // Before slots resolve, so an `<EntityField label>` override still wins.\n  const described = useLocalizedDescriptors(columnDescriptors);\n  const resolved = resolveEntityFormFields(described, slots.fields);\n  assertLinkSourcesAreEditable(resolved, linkSources);\n\n  // **Form above, table below**, and it is a partition rather than an ordering\n  // hint. A grid rendered between two labelled inputs reads as a field, which\n  // it is not — it is a second record list — so every owned collection is\n  // pulled out of the field stack whatever `order` it declared, and rendered\n  // full width beneath it. A composition that named no child has nothing to\n  // render and stays where it was, showing its row count as before.\n  const fields = resolved.filter(field => !isOwnedCollection(field));\n  const ownedCollections = resolved.filter(isOwnedCollection);\n\n  /**\n   * `true`/omitted → the built-in default, which draws one label+control pair\n   * per resolved field; a node → that node; `false` → nothing. The field list\n   * comes from the constructor's metadata, not from the record, so it is already\n   * complete while the record is still in flight — which is what lets the\n   * placeholder match the form it is standing in for.\n   */\n  const customSkeleton = typeof skeleton === 'boolean' ? undefined : skeleton;\n  const showSkeleton = isLoading && skeleton !== false;\n\n  const [internalMode, setInternalMode] = useState<EntityFormMode>(\n    defaultMode ?? (entity ? 'read' : 'edit'),\n  );\n  const mode = modeProp ?? internalMode;\n  const editing = mode === 'edit';\n\n  const draft: EntityDraft = values ?? {};\n  const setField = (name: string, value: EntityDraftValue) =>\n    onFieldChange?.(name, value);\n\n  const toggleMode = () => {\n    const next: EntityFormMode = editing ? 'read' : 'edit';\n    setInternalMode(next);\n    onModeChange?.(next);\n  };\n\n  const t = useT();\n  const translateKey = useTranslateKey();\n  const errorMessage = useErrorMessage();\n  const busy = isSaving || isDeleting;\n\n  // A draft restored from storage holds relation ids and no instances, so every\n  // picker is resolving its target for a moment after mount. Saving inside that\n  // window is exactly the case `applyEntityLinks` refuses: an `embedded` member\n  // with an id and nothing to inline. Gating the save is the honest answer —\n  // the form is still assembling itself, and the wait is one lookup long.\n  //\n  // Deliberately not narrowed to `embedded` members: a descriptor's\n  // serialization is not what makes an in-flight lookup a bad moment to submit,\n  // and a form that saves half-resolved is confusing whichever shape it writes.\n  const resolvingLinks = Object.values(linkSources ?? {}).some(\n    source => source.selected.isLoading,\n  );\n\n  // Absent metadata keeps the pre-ADR-0026 behaviour, so an un-migrated call\n  // site renders exactly as before. Present metadata is authoritative: it is\n  // what the service already decided this caller may do.\n  const may = (action: EntityAction) =>\n    metadata === undefined || metadata.actions.includes(action);\n\n  // A single-record form shows the verbs that act on *this* record. Which cell\n  // lands where is `action-surfaces`' business and nobody else's — a\n  // `context-dependent` entity verb belongs to a row's overflow menu and a\n  // `collection`-bound one to the bulk bar, and resolving that here as well is\n  // how the two surfaces drifted apart in the first place.\n  //\n  // ⚠️ **Only when there is somewhere for them to go.** Every cell these two\n  // surfaces render is `binding: 'entity'`, so without an `onUseCase` the\n  // button has no handler and clicking it does nothing at all. That is not a\n  // hypothetical: `makeEntityCrud` withholds the handler on a create, because\n  // there is no record for a verb to act on — and Publish and Unpublish\n  // rendered on a new `ProductOffering` and were inert, which reads as a broken\n  // feature rather than an inapplicable one.\n  //\n  // The hooks are called unconditionally and their *results* are gated: React's\n  // hook count must stay fixed across renders.\n  const declaredHeaderUseCases = useCasesForSurface(\n    'form-header',\n    metadata?.useCases,\n  );\n  const declaredFooterUseCases = useCasesForSurface(\n    'form-footer',\n    metadata?.useCases,\n  );\n  const headerUseCases = onUseCase ? declaredHeaderUseCases : [];\n  const footerUseCases = onUseCase ? declaredFooterUseCases : [];\n\n  // A descriptor carrying `confirm` must be asked about before it fires;\n  // `revoke-sessions` ends every session a user holds. The state holds the\n  // confirmation itself rather than the descriptor, so the dialog cannot be\n  // opened for a verb that never asked for one.\n  const [pending, setPending] = useState<PendingConfirmation | undefined>(\n    undefined,\n  );\n  const invoke = (descriptor: UseCaseDescriptor) => {\n    const confirm = descriptor.confirm;\n    if (confirm) {\n      setPending({\n        key: descriptor.key,\n        labelKey: descriptor.labelKey,\n        confirm,\n      });\n      return;\n    }\n    onUseCase?.(descriptor.key);\n  };\n\n  const useCaseButton = (descriptor: UseCaseDescriptor) => (\n    <Button\n      key={descriptor.key}\n      type=\"button\"\n      variant={\n        descriptor.confirm?.tone === 'destructive' ? 'destructive' : 'secondary'\n      }\n      size={descriptor.placement === 'context-independent' ? 'sm' : 'md'}\n      disabled={busy}\n      onClick={() => invoke(descriptor)}\n    >\n      {/* A descriptor's labels are *runtime* catalog keys — they never resolve\n          at compile time, which is why `@r10c/i18n-check` is what catches a\n          typo here rather than the type system. */}\n      {translateKey(descriptor.labelKey)}\n    </Button>\n  );\n\n  const useCaseMenuItem = (descriptor: UseCaseDescriptor) => (\n    <Menu.Item\n      key={descriptor.key}\n      tone={\n        descriptor.confirm?.tone === 'destructive' ? 'destructive' : 'neutral'\n      }\n      disabled={busy}\n      onClick={() => invoke(descriptor)}\n    >\n      {translateKey(descriptor.labelKey)}\n    </Menu.Item>\n  );\n\n  /**\n   * Four actions fit a row; twelve do not.\n   *\n   * So a surface renders its first {@link VISIBLE_ACTION_LIMIT} verbs as\n   * buttons and folds the rest behind one overflow trigger, in **declaration\n   * order** — the entity's author decided which verbs matter by writing them\n   * first, and a rule that sorted by anything else (alphabetical, destructive\n   * last) would reorder the row every time a verb was added.\n   *\n   * The split is only applied when there is something to fold: a fifth action\n   * is the point at which a menu is cheaper than a wider row, and a menu\n   * holding one entry is strictly worse than the button it replaced.\n   */\n  const withOverflow = (descriptors: UseCaseDescriptor[]) => {\n    if (descriptors.length <= VISIBLE_ACTION_LIMIT) {\n      return descriptors.map(useCaseButton);\n    }\n\n    const visible = descriptors.slice(0, VISIBLE_ACTION_LIMIT);\n    const folded = descriptors.slice(VISIBLE_ACTION_LIMIT);\n\n    return [\n      ...visible.map(useCaseButton),\n      <Menu key=\"overflow\">\n        <Menu.Trigger aria-label={t('form.moreActions')}>\n          {OVERFLOW_GLYPH}\n        </Menu.Trigger>\n        <Menu.Items>{folded.map(useCaseMenuItem)}</Menu.Items>\n      </Menu>,\n    ];\n  };\n\n  return (\n    <Card>\n      <Stack gap=\"s\">\n        {/* An embedded form brings only its fields: the heading and the action\n            row belong to whatever is hosting it — a wizard step sits under the\n            wizard's own heading and advances with the wizard's own footer, so\n            rendering a second of each is two controls for one job. */}\n        {!embedded && (\n          <Stack direction=\"row\" gap=\"xs\" align=\"center\">\n            <Text as=\"h2\" step={1} weight=\"semibold\">\n              {/* `entity` is undefined while the record is still in flight, so\n                testing it alone made a loading edit form announce itself as\n                \"New\" for as long as the fetch took, then relabel when the\n                record landed. A form that is loading is never a create. */}\n              {title ??\n                (entity || isLoading ? t('form.details') : t('form.new'))}\n            </Text>\n            {/* The built-in toggle only appears when the form owns its mode and\n              there is a record to view — a create form has nothing to read. */}\n            {modeProp === undefined && entity && (\n              <Button\n                type=\"button\"\n                variant=\"ghost\"\n                size=\"sm\"\n                onClick={toggleMode}\n              >\n                {editing ? t('form.view') : t('form.edit')}\n              </Button>\n            )}\n            <LoadingBoundary isLoading={isMetadataLoading} lines={0}>\n              <>\n                {withOverflow(headerUseCases)}\n                {slots.headerActions}\n              </>\n            </LoadingBoundary>\n          </Stack>\n        )}\n\n        {/* One announcement for the form; the shimmer below is aria-hidden. */}\n        <span role=\"status\" aria-live=\"polite\" className=\"sr-only\">\n          {isLoading ? t('form.loading') : ''}\n        </span>\n\n        {error && (\n          <p\n            role=\"alert\"\n            data-testid=\"entity-form-error\"\n            className=\"rounded-sm border border-danger bg-danger-subtle px-s py-2xs text-step-sm text-danger\"\n          >\n            {errorMessage(error)}\n          </p>\n        )}\n\n        {/* The placeholder *replaces* the rows rather than sitting above them.\n            Rendering both meant a shimmer stacked on a full set of empty fields,\n            which is two loading signals for one region and twice the height the\n            loaded form settles at. */}\n        {showSkeleton\n          ? (customSkeleton ??\n            fields.map(field => (\n              <Stack key={field.name} gap=\"3xs\">\n                <Skeleton shape=\"line\" className=\"w-24\" />\n                <Skeleton className=\"h-9 w-full\" />\n              </Stack>\n            )))\n          : fields.map(field => (\n              <FieldRow\n                key={field.name}\n                field={field}\n                entity={entity}\n                draft={draft}\n                value={readDraftString(draft, field.name)}\n                editing={editing}\n                error={editing ? errors?.[field.name] : undefined}\n                setField={setField}\n                linkSource={linkSources?.[field.name]}\n                onLinkChange={onLinkChange}\n                id={`${formId}-${field.name}`}\n              />\n            ))}\n\n        {/* The rows the record owns, full width and below every field. Each\n            grid is handed the *whole* error map and picks out the keys naming\n            its own member, so a record owning two collections needs no\n            bookkeeping here. */}\n        {ownedCollections.map(field => (\n          <EntityDetailGrid\n            key={field.name}\n            descriptor={field}\n            rows={readRowDrafts(draft[field.name])}\n            onRowsChange={rows => setField(field.name, rows)}\n            errors={editing ? errors : undefined}\n            editing={editing}\n            isLoading={isLoading}\n            skeleton={skeleton}\n          />\n        ))}\n\n        {/* A cross-field rule has no row to sit under, so it sits with the\n            actions it blocks. */}\n        {editing && formError && (\n          <span role=\"alert\" className=\"text-step-sm text-danger\">\n            {formError}\n          </span>\n        )}\n\n        {editing && !embedded && (\n          <Stack direction=\"row\" gap=\"xs\">\n            {may('write') && (\n              <Button\n                type=\"button\"\n                onClick={() => onSubmit?.(draft)}\n                disabled={busy || resolvingLinks}\n              >\n                {isSaving ? t('form.saving') : t('form.save')}\n              </Button>\n            )}\n            {onDelete && may('delete') && (\n              <Button\n                type=\"button\"\n                variant=\"secondary\"\n                onClick={onDelete}\n                disabled={busy}\n              >\n                {isDeleting ? t('form.deleting') : t('form.delete')}\n              </Button>\n            )}\n            {withOverflow(footerUseCases)}\n            {/* Clone is the CRUD triple's, not a declared verb's: every entity\n                can be copied, so giving it a `@useCase()` would mean declaring\n                the same verb on all 28 of them. It needs `write`, because what\n                it produces is a create. */}\n            {onClone && entity && may('write') && (\n              <Button\n                type=\"button\"\n                variant=\"secondary\"\n                disabled={busy}\n                onClick={() =>\n                  onClone(cloneEntityDraft(entityConstructor, draft))\n                }\n              >\n                {t('form.clone')}\n              </Button>\n            )}\n            {slots.footerActions}\n            {backHref && (\n              <a href={backHref}>\n                <Button type=\"button\" variant=\"ghost\" disabled={busy}>\n                  {t('form.back')}\n                </Button>\n              </a>\n            )}\n          </Stack>\n        )}\n\n        {slots.rest}\n      </Stack>\n\n      {pending && (\n        <ConfirmDialog\n          open\n          tone={pending.confirm.tone}\n          title={translateKey(pending.labelKey)}\n          message={translateKey(pending.confirm.messageKey)}\n          busy={busy}\n          onCancel={() => setPending(undefined)}\n          onConfirm={() => {\n            const key = pending.key;\n            setPending(undefined);\n            onUseCase?.(key);\n          }}\n        />\n      )}\n    </Card>\n  );\n}\n\n/**\n * A member the detail grid renders rather than the field stack.\n *\n * The `childType` half is not defensive: a `composition` that declared no child\n * has no columns, so there is nothing for a grid to draw. It keeps its place in\n * the field stack and reads as its row count, which is what it did before this\n * control existed — an honest \"some rows\" rather than an empty table implying\n * there are none.\n */\nfunction isOwnedCollection<TEntity extends Entity>(\n  field: EntityFormField<TEntity>,\n): boolean {\n  return field.type === 'composition' && field.childType !== undefined;\n}\n\n/**\n * Refuse a `linkSources` entry that names a member no picker can be built for.\n *\n * `FieldRow` asks for {@link PICKABLE_TYPES} before it builds an editor, so a\n * source handed to anything else used to fall through to the read-only display\n * or a plain `FieldControl` with nothing said: the caller wired a picker, no\n * picker appeared, and the field was indistinguishable from one the entity had\n * declared read-only. That is a wiring mistake rather than a state — the entry\n * is dead in *every* shape such a field can render, since an\n * `<EntityField render>` slot is handed the draft and never the source — so it\n * costs the render instead of a warning nobody reads. `useEntityLinkSource`\n * already throws `EntifixLogicError` at render for the sibling mistake (a search\n * property the target does not declare `filterable`); this is the same fault\n * caught one level up.\n *\n * Two messages, because the two faults are not the same thing. A\n * `linkCollection` is a member the editor has simply not been built for yet\n * (#26), so the fix is to wait or to point at the to-one you meant. Any other\n * type is a member that can never name another record at all, so the fix is to\n * remove the entry.\n *\n * Here rather than inside `FieldRow`, and that is the whole reason it is a\n * separate pass: a row only reaches its editor branch in **edit** mode, so a\n * per-row check would stay silent on a form that opens in `read` — the default\n * whenever there is a record — and then throw on a click, minutes later. One\n * pass over the registry fires on the first render either way.\n *\n * Against the resolved fields rather than the raw metadata: a slot may drop a\n * member, and a source left behind for a field that no longer renders is not\n * worth a page.\n */\nfunction assertLinkSourcesAreEditable<TEntity extends Entity>(\n  fields: Array<EntityFormField<TEntity>>,\n  // Same reason as the prop's own declaration: a source's target is another\n  // entity entirely and cannot be expressed in terms of `TEntity`.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  linkSources: Record<string, EntityLinkSource<any>> | undefined,\n): void {\n  if (linkSources === undefined) return;\n\n  const sourced = fields.filter(\n    field =>\n      linkSources[field.name] !== undefined && !PICKABLE_TYPES.has(field.type),\n  );\n  if (sourced.length === 0) return;\n\n  const toMany = sourced\n    .filter(field => field.type === 'linkCollection')\n    .map(field => field.name);\n  if (toMany.length > 0) {\n    throw new EntifixLogicError(\n      `EntityForm was given a link source for a to-many member: ${toMany.join(', ')}. ` +\n        'A `linkCollection` has no editor yet, so the source can only be dropped ' +\n        'and the field would render read-only with no sign anything was wired. ' +\n        'Remove the entry, or point it at the to-one `link` you meant.',\n      undefined,\n      { fields: toMany },\n    );\n  }\n\n  const owned = sourced\n    .filter(field => field.type === 'composition')\n    .map(field => field.name);\n  if (owned.length > 0) {\n    throw new EntifixLogicError(\n      `EntityForm was given a link source for an owned collection: ${owned.join(', ')}. ` +\n        'A `composition` is not a reference — its rows have no life outside this ' +\n        'record and are never picked from existing ones, so there is nothing for a ' +\n        'picker to look up. The detail grid that edits them is #122.',\n      undefined,\n      { fields: owned },\n    );\n  }\n\n  const unpickable = sourced.map(field => `${field.name} (${field.type})`);\n  throw new EntifixLogicError(\n    `EntityForm was given a link source for a member that cannot hold one: ${unpickable.join(', ')}. ` +\n      'A picker writes the target’s id into the draft, so the member has to be a ' +\n      '`link` or the `string` that carries a foreign key. Remove the entry, or ' +\n      'point it at the member that actually holds the reference.',\n    undefined,\n    { fields: sourced.map(field => field.name) },\n  );\n}\n\ninterface FieldRowProps<TEntity extends Entity> {\n  field: EntityFormField<TEntity>;\n  entity: TEntity | undefined;\n  draft: EntityDraft;\n  value: string;\n  editing: boolean;\n  error: string | undefined;\n  setField: (name: string, value: EntityDraftValue) => void;\n  // The target of a relation is a different entity than the form's own.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  linkSource: EntityLinkSource<any> | undefined;\n  onLinkChange:\n    ((name: string, entity: Entity | undefined) => void) | undefined;\n  id: string;\n}\n\n/**\n * One label + control (or value) row. A `readonly` member renders its read\n * display even in edit mode, and so does a relation with no source; everything\n * else edits through `FieldControl` — or, when a source was supplied for a\n * member in {@link PICKABLE_TYPES}, through `EntityLinkInput`. A boolean edited\n * inline carries its own label, so the row does not add a second one.\n *\n * The source branch sits above the `virtual || isRelation` fallback and below\n * `field.render`, which is what lets a slot still override a picked field.\n */\nfunction FieldRow<TEntity extends Entity>({\n  field,\n  entity,\n  draft,\n  value,\n  editing,\n  error,\n  setField,\n  linkSource,\n  onLinkChange,\n  id,\n}: FieldRowProps<TEntity>) {\n  const readNode: ReactNode = field.readRender ? (\n    field.readRender(entity)\n  ) : (\n    <CellValue\n      value={\n        entity ? (entity as Record<string, unknown>)[field.name] : undefined\n      }\n      descriptor={field}\n    />\n  );\n\n  // Members with no editor of their own here: a to-one `link` whose picker was\n  // never wired, a `linkCollection` (#26) and a `composition` (#122). All three\n  // fall back to the read display, which is honest — a disabled text box\n  // holding `[object Object]` is not.\n  const isRelation =\n    field.type === 'link' ||\n    field.type === 'linkCollection' ||\n    field.type === 'composition';\n\n  let control: ReactNode;\n  if (!editing) {\n    control = readNode;\n  } else if (field.render) {\n    control = field.render({ draft, value, setField, id });\n  } else if (linkSource && PICKABLE_TYPES.has(field.type)) {\n    control = (\n      <EntityLinkInput\n        descriptor={field}\n        value={value}\n        source={linkSource}\n        id={id}\n        disabled={field.readonly}\n        onSelect={target => {\n          setField(field.name, target.id == null ? '' : String(target.id));\n          onLinkChange?.(field.name, target);\n        }}\n        onClear={() => {\n          setField(field.name, '');\n          onLinkChange?.(field.name, undefined);\n        }}\n      />\n    );\n  } else if (field.virtual || isRelation) {\n    // A relation with no source has no input to offer, and a virtual field has\n    // no member to edit unless a `render` was supplied — both fall back to the\n    // read display.\n    control = readNode;\n  } else {\n    control = (\n      <FieldControl\n        descriptor={field}\n        value={value}\n        onChange={next => setField(field.name, next)}\n        id={id}\n      />\n    );\n  }\n\n  const ownsLabel =\n    editing && field.type === 'boolean' && !field.render && !field.virtual;\n\n  return (\n    <Stack gap=\"3xs\">\n      {!ownsLabel && (\n        <label htmlFor={id} className=\"text-step-sm text-content-muted\">\n          {field.label}\n        </label>\n      )}\n      {control}\n      {error && (\n        <span role=\"alert\" className=\"text-step-sm text-danger\">\n          {error}\n        </span>\n      )}\n    </Stack>\n  );\n}\n"],"names":["cloneEntityDraft","describeEntityColumns","EntifixLogicError","readDraftString","readRowDrafts","useId","useState","useErrorMessage","useLocalizedDescriptors","useT","useTranslateKey","OVERFLOW_GLYPH","useCasesForSurface","Button","CellValue","FieldControl","Skeleton","Text","Card","ConfirmDialog","EntityLinkInput","LoadingBoundary","Menu","Stack","EntityDetailGrid","readEntityFormFields","resolveEntityFormFields","PICKABLE_TYPES","Set","VISIBLE_ACTION_LIMIT","EntityForm","entityConstructor","entity","values","onFieldChange","linkSources","onLinkChange","mode","modeProp","defaultMode","onModeChange","errors","formError","onSubmit","onDelete","embedded","isLoading","skeleton","isSaving","isDeleting","error","backHref","title","metadata","isMetadataLoading","onUseCase","onClone","children","formId","slots","columnDescriptors","described","resolved","fields","assertLinkSourcesAreEditable","filter","field","isOwnedCollection","ownedCollections","customSkeleton","undefined","showSkeleton","internalMode","setInternalMode","editing","draft","setField","name","value","toggleMode","next","t","translateKey","errorMessage","busy","resolvingLinks","Object","some","source","selected","may","action","actions","includes","declaredHeaderUseCases","useCases","declaredFooterUseCases","headerUseCases","footerUseCases","pending","setPending","invoke","descriptor","confirm","key","labelKey","useCaseButton","type","variant","tone","size","placement","disabled","onClick","useCaseMenuItem","Item","withOverflow","descriptors","length","map","visible","slice","folded","Trigger","aria-label","Items","gap","direction","align","as","step","weight","lines","headerActions","span","role","aria-live","className","p","data-testid","shape","FieldRow","linkSource","id","rows","onRowsChange","footerActions","a","href","rest","open","message","messageKey","onCancel","onConfirm","childType","sourced","has","toMany","join","owned","unpickable","readNode","readRender","isRelation","control","render","readonly","onSelect","target","String","onClear","virtual","onChange","ownsLabel","label","htmlFor"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/ui/organisms/entity-form/entity-form.tsx"],"sourcesContent":["'use client';\n\nimport {\n  cloneEntityDraft,\n  describeEntityColumns,\n  EntifixLogicError,\n  type Entity,\n  type EntityAction,\n  type EntityDraft,\n  type EntityDraftValue,\n  type EntityLinkSource,\n  type MetaAccessorType,\n  readDraftString,\n  readRowDrafts,\n  type UseCaseDescriptor,\n} from '@entifix/core';\nimport { type ReactNode, useId, useState } from 'react';\n\nimport {\n  useErrorMessage,\n  useLocalizedDescriptors,\n  useT,\n  useTranslateKey,\n} from '../../../i18n/index.js';\nimport {\n  OVERFLOW_GLYPH,\n  renderAnchor,\n  useCasesForSurface,\n} from '../../actions/index.js';\nimport { Button, button } from '../../atoms/button/index.js';\nimport { CellValue } from '../../atoms/cell-value/index.js';\nimport { FieldControl } from '../../atoms/field-control/index.js';\nimport { Skeleton } from '../../atoms/skeleton/index.js';\nimport { Text } from '../../atoms/text/index.js';\nimport { Card } from '../../molecules/card/index.js';\nimport { ConfirmDialog } from '../../molecules/confirm-dialog/index.js';\nimport { EntityLinkInput } from '../../molecules/entity-link-input/index.js';\nimport { LoadingBoundary } from '../../molecules/loading-boundary/index.js';\nimport { Menu } from '../../molecules/menu/index.js';\nimport { Stack } from '../../molecules/stack/index.js';\nimport { cn } from '../../utils/cn.js';\nimport { EntityDetailGrid } from '../entity-detail-grid/index.js';\nimport type {\n  EntityFormField,\n  EntityFormMode,\n  EntityFormProps,\n} from './entity-form.types.js';\nimport { readEntityFormFields } from './entity-form-slots.js';\nimport { resolveEntityFormFields } from './use-entity-form-fields.js';\n\n/**\n * The member types a `linkSources` entry can actually produce an editor for.\n *\n * `link` is the obvious one. `string` is here because a foreign key does not\n * have to be a typed relation: when the target lives in **another slice's\n * store**, an `EntityLink` would be an illegal edge and a storage-layer join\n * across a store boundary, so the member is a plain id and the relation exists\n * only in the operator's head (ADR 0022, and `ProductSpecification.brandId` is\n * the live case). Nothing about the editor cares which of the two it is —\n * `EntityLinkInput` writes `String(target.id)` into the draft either way, and\n * the *only* place `link`-ness still matters is `applyEntityLinks` at submit,\n * which skips a non-`link` descriptor and so leaves the id as the truth.\n *\n * Everything else is excluded on purpose rather than by omission: a `boolean`,\n * `enum`, `number` or `date` member cannot name another record, so a source\n * pointed at one is a wiring mistake — see {@link assertLinkSourcesAreEditable}.\n */\nconst PICKABLE_TYPES: ReadonlySet<MetaAccessorType> = new Set<MetaAccessorType>(\n  ['link', 'string'],\n);\n\n/**\n * A form that builds itself from an entity's metadata: fields, labels and value\n * formatting all come from `@accessor()` declarations, so editing a new entity\n * needs no bespoke form. The read/edit toggle is the whole point — the same\n * component shows a record as text or as inputs.\n *\n * Two things layer on top of that default:\n * - **modes** — `read` renders each member through `CellValue`; `edit` renders\n *   the matching `FieldControl`. A member in {@link PICKABLE_TYPES} with an\n *   entry in `linkSources` gets the full picker instead — a to-one `link`, or a\n *   `string` holding a foreign key into another slice's store. Without a source,\n *   a relation stays read-only, and a `linkCollection` always does, the to-many\n *   editor being a follow-up. A source aimed at a member that can render no\n *   picker is a wiring mistake rather than a no-op, and throws.\n * - **slots** — `<EntityField>` children override one field's label, control or\n *   read display, or add a computed field.\n *\n * It is presentational: the draft, its errors and the save/delete actions are\n * all props, so the same form hosts on a plain route and inside a workspace tab.\n */\n/**\n * How many verbs a surface shows before the rest fold into an overflow menu.\n *\n * Four, because that is roughly what fits beside a title at a laptop width\n * without the row wrapping — the same number Fiori's object-page header settles\n * on. It is a layout constant, not a policy: raising it does not grant anything.\n */\nconst VISIBLE_ACTION_LIMIT = 4;\n\n/** A verb waiting on its confirmation — narrowed so `confirm` is not optional. */\ninterface PendingConfirmation {\n  key: string;\n  labelKey: string;\n  confirm: NonNullable<UseCaseDescriptor['confirm']>;\n}\n\nexport function EntityForm<TEntity extends Entity>({\n  entityConstructor,\n  entity,\n  values,\n  onFieldChange,\n  linkSources,\n  onLinkChange,\n  mode: modeProp,\n  defaultMode,\n  onModeChange,\n  errors,\n  formError,\n  onSubmit,\n  onDelete,\n  embedded = false,\n  isLoading = false,\n  skeleton = true,\n  isSaving = false,\n  isDeleting = false,\n  error,\n  backHref,\n  renderLink = renderAnchor,\n  title,\n  metadata,\n  isMetadataLoading = false,\n  onUseCase,\n  onClone,\n  children,\n}: EntityFormProps<TEntity>) {\n  const formId = useId();\n  const slots = readEntityFormFields<TEntity>(children);\n  // The *field* descriptors, which stay local and synchronous — a column is a\n  // property of the class every caller holds. Only an action's availability is\n  // a property of the caller, which is why that half arrives as `metadata`.\n  const columnDescriptors = describeEntityColumns(\n    entityConstructor,\n    entity,\n  ) as Array<EntityFormField<TEntity>>;\n  // Before slots resolve, so an `<EntityField label>` override still wins.\n  const described = useLocalizedDescriptors(columnDescriptors);\n  const resolved = resolveEntityFormFields(described, slots.fields);\n  assertLinkSourcesAreEditable(resolved, linkSources);\n\n  // **Form above, table below**, and it is a partition rather than an ordering\n  // hint. A grid rendered between two labelled inputs reads as a field, which\n  // it is not — it is a second record list — so every owned collection is\n  // pulled out of the field stack whatever `order` it declared, and rendered\n  // full width beneath it. A composition that named no child has nothing to\n  // render and stays where it was, showing its row count as before.\n  const fields = resolved.filter(field => !isOwnedCollection(field));\n  const ownedCollections = resolved.filter(isOwnedCollection);\n\n  /**\n   * `true`/omitted → the built-in default, which draws one label+control pair\n   * per resolved field; a node → that node; `false` → nothing. The field list\n   * comes from the constructor's metadata, not from the record, so it is already\n   * complete while the record is still in flight — which is what lets the\n   * placeholder match the form it is standing in for.\n   */\n  const customSkeleton = typeof skeleton === 'boolean' ? undefined : skeleton;\n  const showSkeleton = isLoading && skeleton !== false;\n\n  const [internalMode, setInternalMode] = useState<EntityFormMode>(\n    defaultMode ?? (entity ? 'read' : 'edit'),\n  );\n  const mode = modeProp ?? internalMode;\n  const editing = mode === 'edit';\n\n  const draft: EntityDraft = values ?? {};\n  const setField = (name: string, value: EntityDraftValue) =>\n    onFieldChange?.(name, value);\n\n  const toggleMode = () => {\n    const next: EntityFormMode = editing ? 'read' : 'edit';\n    setInternalMode(next);\n    onModeChange?.(next);\n  };\n\n  const t = useT();\n  const translateKey = useTranslateKey();\n  const errorMessage = useErrorMessage();\n  const busy = isSaving || isDeleting;\n\n  // A draft restored from storage holds relation ids and no instances, so every\n  // picker is resolving its target for a moment after mount. Saving inside that\n  // window is exactly the case `applyEntityLinks` refuses: an `embedded` member\n  // with an id and nothing to inline. Gating the save is the honest answer —\n  // the form is still assembling itself, and the wait is one lookup long.\n  //\n  // Deliberately not narrowed to `embedded` members: a descriptor's\n  // serialization is not what makes an in-flight lookup a bad moment to submit,\n  // and a form that saves half-resolved is confusing whichever shape it writes.\n  const resolvingLinks = Object.values(linkSources ?? {}).some(\n    source => source.selected.isLoading,\n  );\n\n  // Absent metadata keeps the pre-ADR-0026 behaviour, so an un-migrated call\n  // site renders exactly as before. Present metadata is authoritative: it is\n  // what the service already decided this caller may do.\n  const may = (action: EntityAction) =>\n    metadata === undefined || metadata.actions.includes(action);\n\n  // A single-record form shows the verbs that act on *this* record. Which cell\n  // lands where is `action-surfaces`' business and nobody else's — a\n  // `context-dependent` entity verb belongs to a row's overflow menu and a\n  // `collection`-bound one to the bulk bar, and resolving that here as well is\n  // how the two surfaces drifted apart in the first place.\n  //\n  // ⚠️ **Only when there is somewhere for them to go.** Every cell these two\n  // surfaces render is `binding: 'entity'`, so without an `onUseCase` the\n  // button has no handler and clicking it does nothing at all. That is not a\n  // hypothetical: `makeEntityCrud` withholds the handler on a create, because\n  // there is no record for a verb to act on — and Publish and Unpublish\n  // rendered on a new `ProductOffering` and were inert, which reads as a broken\n  // feature rather than an inapplicable one.\n  //\n  // The hooks are called unconditionally and their *results* are gated: React's\n  // hook count must stay fixed across renders.\n  const declaredHeaderUseCases = useCasesForSurface(\n    'form-header',\n    metadata?.useCases,\n  );\n  const declaredFooterUseCases = useCasesForSurface(\n    'form-footer',\n    metadata?.useCases,\n  );\n  const headerUseCases = onUseCase ? declaredHeaderUseCases : [];\n  const footerUseCases = onUseCase ? declaredFooterUseCases : [];\n\n  // A descriptor carrying `confirm` must be asked about before it fires;\n  // `revoke-sessions` ends every session a user holds. The state holds the\n  // confirmation itself rather than the descriptor, so the dialog cannot be\n  // opened for a verb that never asked for one.\n  const [pending, setPending] = useState<PendingConfirmation | undefined>(\n    undefined,\n  );\n  const invoke = (descriptor: UseCaseDescriptor) => {\n    const confirm = descriptor.confirm;\n    if (confirm) {\n      setPending({\n        key: descriptor.key,\n        labelKey: descriptor.labelKey,\n        confirm,\n      });\n      return;\n    }\n    onUseCase?.(descriptor.key);\n  };\n\n  const useCaseButton = (descriptor: UseCaseDescriptor) => (\n    <Button\n      key={descriptor.key}\n      type=\"button\"\n      variant={\n        descriptor.confirm?.tone === 'destructive' ? 'destructive' : 'secondary'\n      }\n      size={descriptor.placement === 'context-independent' ? 'sm' : 'md'}\n      disabled={busy}\n      onClick={() => invoke(descriptor)}\n    >\n      {/* A descriptor's labels are *runtime* catalog keys — they never resolve\n          at compile time, which is why `@r10c/i18n-check` is what catches a\n          typo here rather than the type system. */}\n      {translateKey(descriptor.labelKey)}\n    </Button>\n  );\n\n  const useCaseMenuItem = (descriptor: UseCaseDescriptor) => (\n    <Menu.Item\n      key={descriptor.key}\n      tone={\n        descriptor.confirm?.tone === 'destructive' ? 'destructive' : 'neutral'\n      }\n      disabled={busy}\n      onClick={() => invoke(descriptor)}\n    >\n      {translateKey(descriptor.labelKey)}\n    </Menu.Item>\n  );\n\n  /**\n   * Four actions fit a row; twelve do not.\n   *\n   * So a surface renders its first {@link VISIBLE_ACTION_LIMIT} verbs as\n   * buttons and folds the rest behind one overflow trigger, in **declaration\n   * order** — the entity's author decided which verbs matter by writing them\n   * first, and a rule that sorted by anything else (alphabetical, destructive\n   * last) would reorder the row every time a verb was added.\n   *\n   * The split is only applied when there is something to fold: a fifth action\n   * is the point at which a menu is cheaper than a wider row, and a menu\n   * holding one entry is strictly worse than the button it replaced.\n   */\n  const withOverflow = (descriptors: UseCaseDescriptor[]) => {\n    if (descriptors.length <= VISIBLE_ACTION_LIMIT) {\n      return descriptors.map(useCaseButton);\n    }\n\n    const visible = descriptors.slice(0, VISIBLE_ACTION_LIMIT);\n    const folded = descriptors.slice(VISIBLE_ACTION_LIMIT);\n\n    return [\n      ...visible.map(useCaseButton),\n      <Menu key=\"overflow\">\n        <Menu.Trigger aria-label={t('form.moreActions')}>\n          {OVERFLOW_GLYPH}\n        </Menu.Trigger>\n        <Menu.Items>{folded.map(useCaseMenuItem)}</Menu.Items>\n      </Menu>,\n    ];\n  };\n\n  return (\n    <Card>\n      <Stack gap=\"s\">\n        {/* An embedded form brings only its fields: the heading and the action\n            row belong to whatever is hosting it — a wizard step sits under the\n            wizard's own heading and advances with the wizard's own footer, so\n            rendering a second of each is two controls for one job. */}\n        {!embedded && (\n          <Stack direction=\"row\" gap=\"xs\" align=\"center\">\n            <Text as=\"h2\" step={1} weight=\"semibold\">\n              {/* `entity` is undefined while the record is still in flight, so\n                testing it alone made a loading edit form announce itself as\n                \"New\" for as long as the fetch took, then relabel when the\n                record landed. A form that is loading is never a create. */}\n              {title ??\n                (entity || isLoading ? t('form.details') : t('form.new'))}\n            </Text>\n            {/* The built-in toggle only appears when the form owns its mode and\n              there is a record to view — a create form has nothing to read. */}\n            {modeProp === undefined && entity && (\n              <Button\n                type=\"button\"\n                variant=\"ghost\"\n                size=\"sm\"\n                onClick={toggleMode}\n              >\n                {editing ? t('form.view') : t('form.edit')}\n              </Button>\n            )}\n            <LoadingBoundary isLoading={isMetadataLoading} lines={0}>\n              <>\n                {withOverflow(headerUseCases)}\n                {slots.headerActions}\n              </>\n            </LoadingBoundary>\n          </Stack>\n        )}\n\n        {/* One announcement for the form; the shimmer below is aria-hidden. */}\n        <span role=\"status\" aria-live=\"polite\" className=\"sr-only\">\n          {isLoading ? t('form.loading') : ''}\n        </span>\n\n        {error && (\n          <p\n            role=\"alert\"\n            data-testid=\"entity-form-error\"\n            className=\"rounded-sm border border-danger bg-danger-subtle px-s py-2xs text-step-sm text-danger\"\n          >\n            {errorMessage(error)}\n          </p>\n        )}\n\n        {/* The placeholder *replaces* the rows rather than sitting above them.\n            Rendering both meant a shimmer stacked on a full set of empty fields,\n            which is two loading signals for one region and twice the height the\n            loaded form settles at. */}\n        {showSkeleton\n          ? (customSkeleton ??\n            fields.map(field => (\n              <Stack key={field.name} gap=\"3xs\">\n                <Skeleton shape=\"line\" className=\"w-24\" />\n                <Skeleton className=\"h-9 w-full\" />\n              </Stack>\n            )))\n          : fields.map(field => (\n              <FieldRow\n                key={field.name}\n                field={field}\n                entity={entity}\n                draft={draft}\n                value={readDraftString(draft, field.name)}\n                editing={editing}\n                error={editing ? errors?.[field.name] : undefined}\n                setField={setField}\n                linkSource={linkSources?.[field.name]}\n                onLinkChange={onLinkChange}\n                id={`${formId}-${field.name}`}\n              />\n            ))}\n\n        {/* The rows the record owns, full width and below every field. Each\n            grid is handed the *whole* error map and picks out the keys naming\n            its own member, so a record owning two collections needs no\n            bookkeeping here. */}\n        {ownedCollections.map(field => (\n          <EntityDetailGrid\n            key={field.name}\n            descriptor={field}\n            rows={readRowDrafts(draft[field.name])}\n            onRowsChange={rows => setField(field.name, rows)}\n            errors={editing ? errors : undefined}\n            editing={editing}\n            isLoading={isLoading}\n            skeleton={skeleton}\n          />\n        ))}\n\n        {/* A cross-field rule has no row to sit under, so it sits with the\n            actions it blocks. */}\n        {editing && formError && (\n          <span role=\"alert\" className=\"text-step-sm text-danger\">\n            {formError}\n          </span>\n        )}\n\n        {editing && !embedded && (\n          <Stack direction=\"row\" gap=\"xs\">\n            {may('write') && (\n              <Button\n                type=\"button\"\n                onClick={() => onSubmit?.(draft)}\n                disabled={busy || resolvingLinks}\n              >\n                {isSaving ? t('form.saving') : t('form.save')}\n              </Button>\n            )}\n            {onDelete && may('delete') && (\n              <Button\n                type=\"button\"\n                variant=\"secondary\"\n                onClick={onDelete}\n                disabled={busy}\n              >\n                {isDeleting ? t('form.deleting') : t('form.delete')}\n              </Button>\n            )}\n            {withOverflow(footerUseCases)}\n            {/* Clone is the CRUD triple's, not a declared verb's: every entity\n                can be copied, so giving it a `@useCase()` would mean declaring\n                the same verb on all 28 of them. It needs `write`, because what\n                it produces is a create. */}\n            {onClone && entity && may('write') && (\n              <Button\n                type=\"button\"\n                variant=\"secondary\"\n                disabled={busy}\n                onClick={() =>\n                  onClone(cloneEntityDraft(entityConstructor, draft))\n                }\n              >\n                {t('form.clone')}\n              </Button>\n            )}\n            {slots.footerActions}\n            {/* A link styled as a button, not a button inside a link: the old\n                nesting was two interactive elements for one action, and its\n                `disabled` stopped nothing, because the anchor around it still\n                navigated. While busy the link is inert instead. */}\n            {backHref &&\n              renderLink({\n                href: backHref,\n                className: cn(\n                  button({ variant: 'ghost' }),\n                  busy && 'pointer-events-none opacity-50',\n                ),\n                children: t('form.back'),\n                intent: { kind: 'back' },\n              })}\n          </Stack>\n        )}\n\n        {slots.rest}\n      </Stack>\n\n      {pending && (\n        <ConfirmDialog\n          open\n          tone={pending.confirm.tone}\n          title={translateKey(pending.labelKey)}\n          message={translateKey(pending.confirm.messageKey)}\n          busy={busy}\n          onCancel={() => setPending(undefined)}\n          onConfirm={() => {\n            const key = pending.key;\n            setPending(undefined);\n            onUseCase?.(key);\n          }}\n        />\n      )}\n    </Card>\n  );\n}\n\n/**\n * A member the detail grid renders rather than the field stack.\n *\n * The `childType` half is not defensive: a `composition` that declared no child\n * has no columns, so there is nothing for a grid to draw. It keeps its place in\n * the field stack and reads as its row count, which is what it did before this\n * control existed — an honest \"some rows\" rather than an empty table implying\n * there are none.\n */\nfunction isOwnedCollection<TEntity extends Entity>(\n  field: EntityFormField<TEntity>,\n): boolean {\n  return field.type === 'composition' && field.childType !== undefined;\n}\n\n/**\n * Refuse a `linkSources` entry that names a member no picker can be built for.\n *\n * `FieldRow` asks for {@link PICKABLE_TYPES} before it builds an editor, so a\n * source handed to anything else used to fall through to the read-only display\n * or a plain `FieldControl` with nothing said: the caller wired a picker, no\n * picker appeared, and the field was indistinguishable from one the entity had\n * declared read-only. That is a wiring mistake rather than a state — the entry\n * is dead in *every* shape such a field can render, since an\n * `<EntityField render>` slot is handed the draft and never the source — so it\n * costs the render instead of a warning nobody reads. `useEntityLinkSource`\n * already throws `EntifixLogicError` at render for the sibling mistake (a search\n * property the target does not declare `filterable`); this is the same fault\n * caught one level up.\n *\n * Two messages, because the two faults are not the same thing. A\n * `linkCollection` is a member the editor has simply not been built for yet\n * (#26), so the fix is to wait or to point at the to-one you meant. Any other\n * type is a member that can never name another record at all, so the fix is to\n * remove the entry.\n *\n * Here rather than inside `FieldRow`, and that is the whole reason it is a\n * separate pass: a row only reaches its editor branch in **edit** mode, so a\n * per-row check would stay silent on a form that opens in `read` — the default\n * whenever there is a record — and then throw on a click, minutes later. One\n * pass over the registry fires on the first render either way.\n *\n * Against the resolved fields rather than the raw metadata: a slot may drop a\n * member, and a source left behind for a field that no longer renders is not\n * worth a page.\n */\nfunction assertLinkSourcesAreEditable<TEntity extends Entity>(\n  fields: Array<EntityFormField<TEntity>>,\n  // Same reason as the prop's own declaration: a source's target is another\n  // entity entirely and cannot be expressed in terms of `TEntity`.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  linkSources: Record<string, EntityLinkSource<any>> | undefined,\n): void {\n  if (linkSources === undefined) return;\n\n  const sourced = fields.filter(\n    field =>\n      linkSources[field.name] !== undefined && !PICKABLE_TYPES.has(field.type),\n  );\n  if (sourced.length === 0) return;\n\n  const toMany = sourced\n    .filter(field => field.type === 'linkCollection')\n    .map(field => field.name);\n  if (toMany.length > 0) {\n    throw new EntifixLogicError(\n      `EntityForm was given a link source for a to-many member: ${toMany.join(', ')}. ` +\n        'A `linkCollection` has no editor yet, so the source can only be dropped ' +\n        'and the field would render read-only with no sign anything was wired. ' +\n        'Remove the entry, or point it at the to-one `link` you meant.',\n      undefined,\n      { fields: toMany },\n    );\n  }\n\n  const owned = sourced\n    .filter(field => field.type === 'composition')\n    .map(field => field.name);\n  if (owned.length > 0) {\n    throw new EntifixLogicError(\n      `EntityForm was given a link source for an owned collection: ${owned.join(', ')}. ` +\n        'A `composition` is not a reference — its rows have no life outside this ' +\n        'record and are never picked from existing ones, so there is nothing for a ' +\n        'picker to look up. The detail grid that edits them is #122.',\n      undefined,\n      { fields: owned },\n    );\n  }\n\n  const unpickable = sourced.map(field => `${field.name} (${field.type})`);\n  throw new EntifixLogicError(\n    `EntityForm was given a link source for a member that cannot hold one: ${unpickable.join(', ')}. ` +\n      'A picker writes the target’s id into the draft, so the member has to be a ' +\n      '`link` or the `string` that carries a foreign key. Remove the entry, or ' +\n      'point it at the member that actually holds the reference.',\n    undefined,\n    { fields: sourced.map(field => field.name) },\n  );\n}\n\ninterface FieldRowProps<TEntity extends Entity> {\n  field: EntityFormField<TEntity>;\n  entity: TEntity | undefined;\n  draft: EntityDraft;\n  value: string;\n  editing: boolean;\n  error: string | undefined;\n  setField: (name: string, value: EntityDraftValue) => void;\n  // The target of a relation is a different entity than the form's own.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  linkSource: EntityLinkSource<any> | undefined;\n  onLinkChange:\n    ((name: string, entity: Entity | undefined) => void) | undefined;\n  id: string;\n}\n\n/**\n * One label + control (or value) row. A `readonly` member renders its read\n * display even in edit mode, and so does a relation with no source; everything\n * else edits through `FieldControl` — or, when a source was supplied for a\n * member in {@link PICKABLE_TYPES}, through `EntityLinkInput`. A boolean edited\n * inline carries its own label, so the row does not add a second one.\n *\n * The source branch sits above the `virtual || isRelation` fallback and below\n * `field.render`, which is what lets a slot still override a picked field.\n */\nfunction FieldRow<TEntity extends Entity>({\n  field,\n  entity,\n  draft,\n  value,\n  editing,\n  error,\n  setField,\n  linkSource,\n  onLinkChange,\n  id,\n}: FieldRowProps<TEntity>) {\n  const readNode: ReactNode = field.readRender ? (\n    field.readRender(entity)\n  ) : (\n    <CellValue\n      value={\n        entity ? (entity as Record<string, unknown>)[field.name] : undefined\n      }\n      descriptor={field}\n    />\n  );\n\n  // Members with no editor of their own here: a to-one `link` whose picker was\n  // never wired, a `linkCollection` (#26) and a `composition` (#122). All three\n  // fall back to the read display, which is honest — a disabled text box\n  // holding `[object Object]` is not.\n  const isRelation =\n    field.type === 'link' ||\n    field.type === 'linkCollection' ||\n    field.type === 'composition';\n\n  let control: ReactNode;\n  if (!editing) {\n    control = readNode;\n  } else if (field.render) {\n    control = field.render({ draft, value, setField, id });\n  } else if (linkSource && PICKABLE_TYPES.has(field.type)) {\n    control = (\n      <EntityLinkInput\n        descriptor={field}\n        value={value}\n        source={linkSource}\n        id={id}\n        disabled={field.readonly}\n        onSelect={target => {\n          setField(field.name, target.id == null ? '' : String(target.id));\n          onLinkChange?.(field.name, target);\n        }}\n        onClear={() => {\n          setField(field.name, '');\n          onLinkChange?.(field.name, undefined);\n        }}\n      />\n    );\n  } else if (field.virtual || isRelation) {\n    // A relation with no source has no input to offer, and a virtual field has\n    // no member to edit unless a `render` was supplied — both fall back to the\n    // read display.\n    control = readNode;\n  } else {\n    control = (\n      <FieldControl\n        descriptor={field}\n        value={value}\n        onChange={next => setField(field.name, next)}\n        id={id}\n      />\n    );\n  }\n\n  const ownsLabel =\n    editing && field.type === 'boolean' && !field.render && !field.virtual;\n\n  return (\n    <Stack gap=\"3xs\">\n      {!ownsLabel && (\n        <label htmlFor={id} className=\"text-step-sm text-content-muted\">\n          {field.label}\n        </label>\n      )}\n      {control}\n      {error && (\n        <span role=\"alert\" className=\"text-step-sm text-danger\">\n          {error}\n        </span>\n      )}\n    </Stack>\n  );\n}\n"],"names":["cloneEntityDraft","describeEntityColumns","EntifixLogicError","readDraftString","readRowDrafts","useId","useState","useErrorMessage","useLocalizedDescriptors","useT","useTranslateKey","OVERFLOW_GLYPH","renderAnchor","useCasesForSurface","Button","button","CellValue","FieldControl","Skeleton","Text","Card","ConfirmDialog","EntityLinkInput","LoadingBoundary","Menu","Stack","cn","EntityDetailGrid","readEntityFormFields","resolveEntityFormFields","PICKABLE_TYPES","Set","VISIBLE_ACTION_LIMIT","EntityForm","entityConstructor","entity","values","onFieldChange","linkSources","onLinkChange","mode","modeProp","defaultMode","onModeChange","errors","formError","onSubmit","onDelete","embedded","isLoading","skeleton","isSaving","isDeleting","error","backHref","renderLink","title","metadata","isMetadataLoading","onUseCase","onClone","children","formId","slots","columnDescriptors","described","resolved","fields","assertLinkSourcesAreEditable","filter","field","isOwnedCollection","ownedCollections","customSkeleton","undefined","showSkeleton","internalMode","setInternalMode","editing","draft","setField","name","value","toggleMode","next","t","translateKey","errorMessage","busy","resolvingLinks","Object","some","source","selected","may","action","actions","includes","declaredHeaderUseCases","useCases","declaredFooterUseCases","headerUseCases","footerUseCases","pending","setPending","invoke","descriptor","confirm","key","labelKey","useCaseButton","type","variant","tone","size","placement","disabled","onClick","useCaseMenuItem","Item","withOverflow","descriptors","length","map","visible","slice","folded","Trigger","aria-label","Items","gap","direction","align","as","step","weight","lines","headerActions","span","role","aria-live","className","p","data-testid","shape","FieldRow","linkSource","id","rows","onRowsChange","footerActions","href","intent","kind","rest","open","message","messageKey","onCancel","onConfirm","childType","sourced","has","toMany","join","owned","unpickable","readNode","readRender","isRelation","control","render","readonly","onSelect","target","String","onClear","virtual","onChange","ownsLabel","label","htmlFor"],"mappings":"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"}

package/dist/ui/organisms/entity-form/entity-form.types.d.ts

@@ -1,5 +1,6 @@
 import type { EntifixError, Entity, EntityConstructor, EntityDraft, EntityDraftValue, EntityFieldDescriptor, EntityLinkSource, EntityMetadataDocument } from '@entifix/core';
 import type { ReactNode } from 'react';
+import type { RenderLink } from '../../actions/index.js';
 /** Whether the form shows values as text (`read`) or as inputs (`edit`). */
 export type EntityFormMode = 'read' | 'edit';
 /** What a custom edit control for one field is handed. */
@@ -143,6 +144,11 @@ export interface EntityFormProps<TEntity extends Entity> {
     error?: EntifixError;
     /** Link to return to, rendered as a `Back` action. Omit to hide it. */
     backHref?: string;
+    /**
+     * Renders the `Back` link. Defaults to a plain anchor, which a client-routed
+     * host experiences as a full document load. See {@link RenderLink}.
+     */
+    renderLink?: RenderLink;
     /** Heading for the card. Defaults to a generic label. */
     title?: ReactNode;
     /** Customization slots — see `entity-form-slots`. */

package/dist/ui/organisms/entity-form/entity-form.types.d.ts.map

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

package/dist/ui/organisms/entity-form/entity-form.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/ui/organisms/entity-form/entity-form.types.ts"],"sourcesContent":["import type {\n  EntifixError,\n  Entity,\n  EntityConstructor,\n  EntityDraft,\n  EntityDraftValue,\n  EntityFieldDescriptor,\n  EntityLinkSource,\n  EntityMetadataDocument,\n} from '@entifix/core';\nimport type { ReactNode } from 'react';\n\n/** Whether the form shows values as text (`read`) or as inputs (`edit`). */\nexport type EntityFormMode = 'read' | 'edit';\n\n/** What a custom edit control for one field is handed. */\nexport interface EntityFieldRenderContext {\n  draft: EntityDraft;\n  value: string;\n  setField: (name: string, value: EntityDraftValue) => void;\n  /** The id the field's label points at — put it on your control. */\n  id: string;\n}\n\n/**\n * A field as the form finally renders it: the metadata descriptor plus the\n * per-field overrides a caller supplied through an `<EntityField>` slot.\n */\nexport interface EntityFormField<\n  TEntity extends Entity,\n> extends EntityFieldDescriptor {\n  /** Replaces the default edit control. */\n  render?: (context: EntityFieldRenderContext) => ReactNode;\n  /** Replaces the default read display. */\n  readRender?: (entity: TEntity | undefined) => ReactNode;\n  /** True when the field has no backing entity member (slot-only field). */\n  virtual?: boolean;\n}\n\nexport interface EntityFormProps<TEntity extends Entity> {\n  /** Metadata source. Fields, labels and types derive from its accessors. */\n  entityConstructor: EntityConstructor<TEntity>;\n  /** The record being viewed/edited. The read display and, in a wrapper, the\n   *  initial draft both come from it; omit for a create form. */\n  entity?: TEntity;\n\n  /** The current draft. The form is controlled — a host (the `useEntityForm`\n   *  hook or a `useState`) owns this and updates it via `onFieldChange`. */\n  values?: EntityDraft;\n  /**\n   * Called when one field changes.\n   *\n   * The value is a union rather than a string because a `composition`\n   * member's is its list of rows — the one member with no lossless string form.\n   * Every scalar editor still writes a string, so a host that only edits\n   * scalars is unaffected.\n   */\n  onFieldChange?: (name: string, value: EntityDraftValue) => void;\n\n  /**\n   * A search/browse source per reference, keyed by accessor name. A `link` field\n   * with a source gets the full editor; one without keeps its read-only display,\n   * which is what a form that only shows a relation still wants.\n   *\n   * A **`string`** field with a source gets the same editor, because a foreign\n   * key whose target lives in another slice's store cannot be a typed `link` at\n   * all and is a plain id member (ADR 0022). The editor does not know the\n   * difference — it writes the target's id into the draft either way.\n   *\n   * A key naming any other member throws: `linkCollection` has no editor\n   * anywhere yet, and a `boolean`/`enum`/`number`/`date` can never name another\n   * record, so the entry could only be dropped — and a dropped source looks\n   * exactly like a member the entity declared read-only.\n   *\n   * A registry rather than a slot per relation: the whole point is that an entity\n   * declaring a reference needs no bespoke control. The sources are built by the\n   * caller because fetching them is the integration layer's job, and this package\n   * cannot reach it.\n   */\n  // A source's target is another entity entirely, so it cannot be expressed in\n  // terms of `TEntity`; the input it feeds is instantiated per field anyway.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  linkSources?: Record<string, EntityLinkSource<any>>;\n  /**\n   * A relation was set or cleared. The instance travels alongside the id the\n   * draft holds, so a host can remember it — an id alone cannot be written as an\n   * embedded relation.\n   */\n  onLinkChange?: (name: string, entity: Entity | undefined) => void;\n\n  /** Force a mode. Omit to let the form own it (with the built-in toggle). */\n  mode?: EntityFormMode;\n  /** Initial mode when uncontrolled. Defaults to `read` with an `entity`, else\n   *  `edit` (a create form opens ready to type). */\n  defaultMode?: EntityFormMode;\n  onModeChange?: (mode: EntityFormMode) => void;\n\n  /** Per-field validation messages, keyed by field name. */\n  errors?: Record<string, string>;\n  /**\n   * A validation message that belongs to no single field — a rule spanning two\n   * of them. Rendered above the actions, since no row can host it.\n   */\n  formError?: string;\n\n  onSubmit?: (draft: EntityDraft) => void;\n  onDelete?: () => void;\n\n  /**\n   * What this caller may do with the entity, as served by\n   * `GET /api/<entity>/$metadata` and already filtered against the verified\n   * principal (ADR 0026).\n   *\n   * **Optional, and absent means \"as before\".** Without it the form renders Save\n   * and Delete exactly as it always has, so a call site that has not migrated is\n   * unaffected. This is not a security control — hiding a button protects\n   * nothing; the route guard does. It is what stops a screen offering an action\n   * the service will refuse.\n   */\n  metadata?: EntityMetadataDocument;\n  /** The document is still in flight; the action row renders as a skeleton. */\n  isMetadataLoading?: boolean;\n  /**\n   * A declared use case was invoked, by its `key`. The form renders the button\n   * and asks for confirmation where the descriptor says to; performing the act\n   * is the caller's — the browser must never import a use-case class.\n   */\n  onUseCase?: (key: string) => void;\n\n  /**\n   * Copies the record into a new draft, dropping the members declared\n   * `@accessor({ resetOnClone: true })` and always the id.\n   *\n   * A prop rather than something the form does by itself, because the *result*\n   * of a clone is a navigation — a create form holding the copy — and this\n   * package knows no router. The form supplies the cleaned draft\n   * (`cloneEntityDraft`); where it lands is the caller's.\n   *\n   * Absent renders no Clone action.\n   */\n  onClone?: (draft: EntityDraft) => void;\n\n  /**\n   * Render the **fields and nothing else** — no heading, no action row.\n   *\n   * For a form hosted inside something that already owns those controls: a\n   * wizard step sits under the wizard's own heading and advances with the\n   * wizard's own footer, so a second heading and a Save button beside Siguiente\n   * would be two controls for one job, and the Save would commit a partial\n   * record mid-flow.\n   *\n   * Opt-in and defaulted off, so every existing form is untouched.\n   */\n  embedded?: boolean;\n  isLoading?: boolean;\n  /**\n   * What holds the form's shape while the record is in flight.\n   *\n   * `true` (the default) renders the built-in placeholder — one label+control\n   * pair per resolved field, so the swap to the real rows shifts nothing. A node\n   * replaces that default; `false` renders no placeholder at all.\n   *\n   * The placeholder *replaces* the field rows; it never stacks above them.\n   */\n  skeleton?: boolean | ReactNode;\n  isSaving?: boolean;\n  isDeleting?: boolean;\n  /** The failure of the last load/save, shown as an alert. */\n  error?: EntifixError;\n\n  /** Link to return to, rendered as a `Back` action. Omit to hide it. */\n  backHref?: string;\n  /** Heading for the card. Defaults to a generic label. */\n  title?: ReactNode;\n\n  /** Customization slots — see `entity-form-slots`. */\n  children?: ReactNode;\n}\n"],"names":[],"mappings":"AAuCA,WA0IC"}
+{"version":3,"sources":["../../../../src/ui/organisms/entity-form/entity-form.types.ts"],"sourcesContent":["import type {\n  EntifixError,\n  Entity,\n  EntityConstructor,\n  EntityDraft,\n  EntityDraftValue,\n  EntityFieldDescriptor,\n  EntityLinkSource,\n  EntityMetadataDocument,\n} from '@entifix/core';\nimport type { ReactNode } from 'react';\n\nimport type { RenderLink } from '../../actions/index.js';\n\n/** Whether the form shows values as text (`read`) or as inputs (`edit`). */\nexport type EntityFormMode = 'read' | 'edit';\n\n/** What a custom edit control for one field is handed. */\nexport interface EntityFieldRenderContext {\n  draft: EntityDraft;\n  value: string;\n  setField: (name: string, value: EntityDraftValue) => void;\n  /** The id the field's label points at — put it on your control. */\n  id: string;\n}\n\n/**\n * A field as the form finally renders it: the metadata descriptor plus the\n * per-field overrides a caller supplied through an `<EntityField>` slot.\n */\nexport interface EntityFormField<\n  TEntity extends Entity,\n> extends EntityFieldDescriptor {\n  /** Replaces the default edit control. */\n  render?: (context: EntityFieldRenderContext) => ReactNode;\n  /** Replaces the default read display. */\n  readRender?: (entity: TEntity | undefined) => ReactNode;\n  /** True when the field has no backing entity member (slot-only field). */\n  virtual?: boolean;\n}\n\nexport interface EntityFormProps<TEntity extends Entity> {\n  /** Metadata source. Fields, labels and types derive from its accessors. */\n  entityConstructor: EntityConstructor<TEntity>;\n  /** The record being viewed/edited. The read display and, in a wrapper, the\n   *  initial draft both come from it; omit for a create form. */\n  entity?: TEntity;\n\n  /** The current draft. The form is controlled — a host (the `useEntityForm`\n   *  hook or a `useState`) owns this and updates it via `onFieldChange`. */\n  values?: EntityDraft;\n  /**\n   * Called when one field changes.\n   *\n   * The value is a union rather than a string because a `composition`\n   * member's is its list of rows — the one member with no lossless string form.\n   * Every scalar editor still writes a string, so a host that only edits\n   * scalars is unaffected.\n   */\n  onFieldChange?: (name: string, value: EntityDraftValue) => void;\n\n  /**\n   * A search/browse source per reference, keyed by accessor name. A `link` field\n   * with a source gets the full editor; one without keeps its read-only display,\n   * which is what a form that only shows a relation still wants.\n   *\n   * A **`string`** field with a source gets the same editor, because a foreign\n   * key whose target lives in another slice's store cannot be a typed `link` at\n   * all and is a plain id member (ADR 0022). The editor does not know the\n   * difference — it writes the target's id into the draft either way.\n   *\n   * A key naming any other member throws: `linkCollection` has no editor\n   * anywhere yet, and a `boolean`/`enum`/`number`/`date` can never name another\n   * record, so the entry could only be dropped — and a dropped source looks\n   * exactly like a member the entity declared read-only.\n   *\n   * A registry rather than a slot per relation: the whole point is that an entity\n   * declaring a reference needs no bespoke control. The sources are built by the\n   * caller because fetching them is the integration layer's job, and this package\n   * cannot reach it.\n   */\n  // A source's target is another entity entirely, so it cannot be expressed in\n  // terms of `TEntity`; the input it feeds is instantiated per field anyway.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  linkSources?: Record<string, EntityLinkSource<any>>;\n  /**\n   * A relation was set or cleared. The instance travels alongside the id the\n   * draft holds, so a host can remember it — an id alone cannot be written as an\n   * embedded relation.\n   */\n  onLinkChange?: (name: string, entity: Entity | undefined) => void;\n\n  /** Force a mode. Omit to let the form own it (with the built-in toggle). */\n  mode?: EntityFormMode;\n  /** Initial mode when uncontrolled. Defaults to `read` with an `entity`, else\n   *  `edit` (a create form opens ready to type). */\n  defaultMode?: EntityFormMode;\n  onModeChange?: (mode: EntityFormMode) => void;\n\n  /** Per-field validation messages, keyed by field name. */\n  errors?: Record<string, string>;\n  /**\n   * A validation message that belongs to no single field — a rule spanning two\n   * of them. Rendered above the actions, since no row can host it.\n   */\n  formError?: string;\n\n  onSubmit?: (draft: EntityDraft) => void;\n  onDelete?: () => void;\n\n  /**\n   * What this caller may do with the entity, as served by\n   * `GET /api/<entity>/$metadata` and already filtered against the verified\n   * principal (ADR 0026).\n   *\n   * **Optional, and absent means \"as before\".** Without it the form renders Save\n   * and Delete exactly as it always has, so a call site that has not migrated is\n   * unaffected. This is not a security control — hiding a button protects\n   * nothing; the route guard does. It is what stops a screen offering an action\n   * the service will refuse.\n   */\n  metadata?: EntityMetadataDocument;\n  /** The document is still in flight; the action row renders as a skeleton. */\n  isMetadataLoading?: boolean;\n  /**\n   * A declared use case was invoked, by its `key`. The form renders the button\n   * and asks for confirmation where the descriptor says to; performing the act\n   * is the caller's — the browser must never import a use-case class.\n   */\n  onUseCase?: (key: string) => void;\n\n  /**\n   * Copies the record into a new draft, dropping the members declared\n   * `@accessor({ resetOnClone: true })` and always the id.\n   *\n   * A prop rather than something the form does by itself, because the *result*\n   * of a clone is a navigation — a create form holding the copy — and this\n   * package knows no router. The form supplies the cleaned draft\n   * (`cloneEntityDraft`); where it lands is the caller's.\n   *\n   * Absent renders no Clone action.\n   */\n  onClone?: (draft: EntityDraft) => void;\n\n  /**\n   * Render the **fields and nothing else** — no heading, no action row.\n   *\n   * For a form hosted inside something that already owns those controls: a\n   * wizard step sits under the wizard's own heading and advances with the\n   * wizard's own footer, so a second heading and a Save button beside Siguiente\n   * would be two controls for one job, and the Save would commit a partial\n   * record mid-flow.\n   *\n   * Opt-in and defaulted off, so every existing form is untouched.\n   */\n  embedded?: boolean;\n  isLoading?: boolean;\n  /**\n   * What holds the form's shape while the record is in flight.\n   *\n   * `true` (the default) renders the built-in placeholder — one label+control\n   * pair per resolved field, so the swap to the real rows shifts nothing. A node\n   * replaces that default; `false` renders no placeholder at all.\n   *\n   * The placeholder *replaces* the field rows; it never stacks above them.\n   */\n  skeleton?: boolean | ReactNode;\n  isSaving?: boolean;\n  isDeleting?: boolean;\n  /** The failure of the last load/save, shown as an alert. */\n  error?: EntifixError;\n\n  /** Link to return to, rendered as a `Back` action. Omit to hide it. */\n  backHref?: string;\n  /**\n   * Renders the `Back` link. Defaults to a plain anchor, which a client-routed\n   * host experiences as a full document load. See {@link RenderLink}.\n   */\n  renderLink?: RenderLink;\n  /** Heading for the card. Defaults to a generic label. */\n  title?: ReactNode;\n\n  /** Customization slots — see `entity-form-slots`. */\n  children?: ReactNode;\n}\n"],"names":[],"mappings":"AAyCA,WA+IC"}