@entifix/react-controls 0.1.0-0

package/dist/preferences/use-viewport-mode.d.ts

@@ -0,0 +1,33 @@
+/**
+ * How much room the viewport has for chrome.
+ *
+ * - `compact` — under 768px. Navigation belongs behind a drawer; there is no
+ *   room for a persistent rail beside the content.
+ * - `rail` — 768px to 1024px. Enough for icons, not for labels.
+ * - `wide` — 1024px and up. The stored preference decides.
+ */
+export type ViewportMode = 'compact' | 'rail' | 'wide';
+/**
+ * The viewport mode, as a media query the shell may branch on.
+ *
+ * ⚠️ This is the one place in the design system that asks about the viewport,
+ * and it is deliberate. `docs/FRONTEND.md`'s no-media-query rule governs the
+ * **layout primitives** in `ui/layout/`: they lay themselves out intrinsically
+ * with `flex-wrap`/`flex-basis`/`gap`, and `Sidebar` still does. Choosing
+ * between a drawer and a persistent rail is not laying out a box — it is picking
+ * a navigation *mode*, and no amount of intrinsic sizing produces a focus trap.
+ * See ADR 0041.
+ *
+ * It lives beside the UI preferences rather than in `ui/` because it belongs to
+ * the same decision: what the viewport allows and what the person chose are the
+ * two inputs to one answer, and only the second is a preference.
+ *
+ * Resolved in an effect, not during render, and defaulting to `wide`. The server
+ * has no viewport, so any other default would render markup the first client
+ * pass immediately contradicts — the same reason `useUiPreference` reads after
+ * mount rather than during it.
+ */
+export declare function useViewportMode(): ViewportMode;
+/** Exported for tests and for callers that already hold a width. */
+export declare const viewportModeFor: (width: number) => ViewportMode;
+//# sourceMappingURL=use-viewport-mode.d.ts.map

package/dist/preferences/use-viewport-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-viewport-mode.d.ts","sourceRoot":"","sources":["../../src/preferences/use-viewport-mode.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAUvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,IAAI,YAAY,CA+B9C;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe,UA3DJ,MAAM,KAAG,YA2DK,CAAC"}

package/dist/preferences/use-viewport-mode.js

@@ -0,0 +1,53 @@
+'use client';
+import { useEffect, useState } from 'react';
+const RAIL_MIN = 768;
+const WIDE_MIN = 1024;
+const modeFor = (width)=>{
+    if (width < RAIL_MIN) return 'compact';
+    return width < WIDE_MIN ? 'rail' : 'wide';
+};
+/**
+ * The viewport mode, as a media query the shell may branch on.
+ *
+ * ⚠️ This is the one place in the design system that asks about the viewport,
+ * and it is deliberate. `docs/FRONTEND.md`'s no-media-query rule governs the
+ * **layout primitives** in `ui/layout/`: they lay themselves out intrinsically
+ * with `flex-wrap`/`flex-basis`/`gap`, and `Sidebar` still does. Choosing
+ * between a drawer and a persistent rail is not laying out a box — it is picking
+ * a navigation *mode*, and no amount of intrinsic sizing produces a focus trap.
+ * See ADR 0041.
+ *
+ * It lives beside the UI preferences rather than in `ui/` because it belongs to
+ * the same decision: what the viewport allows and what the person chose are the
+ * two inputs to one answer, and only the second is a preference.
+ *
+ * Resolved in an effect, not during render, and defaulting to `wide`. The server
+ * has no viewport, so any other default would render markup the first client
+ * pass immediately contradicts — the same reason `useUiPreference` reads after
+ * mount rather than during it.
+ */ export function useViewportMode() {
+    const [mode, setMode] = useState('wide');
+    useEffect(()=>{
+        // `typeof`, not `'matchMedia' in window`: jsdom declares the property and
+        // leaves it uncallable, so the `in` check passes and the call then throws
+        // inside a passive effect — which surfaces as a broken shell, not a missing
+        // media query.
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return;
+        const compact = window.matchMedia(`(max-width: ${RAIL_MIN - 1}px)`);
+        const wide = window.matchMedia(`(min-width: ${WIDE_MIN}px)`);
+        const sync = ()=>{
+            setMode(compact.matches ? 'compact' : wide.matches ? 'wide' : 'rail');
+        };
+        sync();
+        compact.addEventListener('change', sync);
+        wide.addEventListener('change', sync);
+        return ()=>{
+            compact.removeEventListener('change', sync);
+            wide.removeEventListener('change', sync);
+        };
+    }, []);
+    return mode;
+}
+/** Exported for tests and for callers that already hold a width. */ export const viewportModeFor = modeFor;
+
+//# sourceMappingURL=use-viewport-mode.js.map

package/dist/preferences/use-viewport-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/preferences/use-viewport-mode.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useState } from 'react';\n\n/**\n * How much room the viewport has for chrome.\n *\n * - `compact` — under 768px. Navigation belongs behind a drawer; there is no\n *   room for a persistent rail beside the content.\n * - `rail` — 768px to 1024px. Enough for icons, not for labels.\n * - `wide` — 1024px and up. The stored preference decides.\n */\nexport type ViewportMode = 'compact' | 'rail' | 'wide';\n\nconst RAIL_MIN = 768;\nconst WIDE_MIN = 1024;\n\nconst modeFor = (width: number): ViewportMode => {\n  if (width < RAIL_MIN) return 'compact';\n  return width < WIDE_MIN ? 'rail' : 'wide';\n};\n\n/**\n * The viewport mode, as a media query the shell may branch on.\n *\n * ⚠️ This is the one place in the design system that asks about the viewport,\n * and it is deliberate. `docs/FRONTEND.md`'s no-media-query rule governs the\n * **layout primitives** in `ui/layout/`: they lay themselves out intrinsically\n * with `flex-wrap`/`flex-basis`/`gap`, and `Sidebar` still does. Choosing\n * between a drawer and a persistent rail is not laying out a box — it is picking\n * a navigation *mode*, and no amount of intrinsic sizing produces a focus trap.\n * See ADR 0041.\n *\n * It lives beside the UI preferences rather than in `ui/` because it belongs to\n * the same decision: what the viewport allows and what the person chose are the\n * two inputs to one answer, and only the second is a preference.\n *\n * Resolved in an effect, not during render, and defaulting to `wide`. The server\n * has no viewport, so any other default would render markup the first client\n * pass immediately contradicts — the same reason `useUiPreference` reads after\n * mount rather than during it.\n */\nexport function useViewportMode(): ViewportMode {\n  const [mode, setMode] = useState<ViewportMode>('wide');\n\n  useEffect(() => {\n    // `typeof`, not `'matchMedia' in window`: jsdom declares the property and\n    // leaves it uncallable, so the `in` check passes and the call then throws\n    // inside a passive effect — which surfaces as a broken shell, not a missing\n    // media query.\n    if (\n      typeof window === 'undefined' ||\n      typeof window.matchMedia !== 'function'\n    )\n      return;\n\n    const compact = window.matchMedia(`(max-width: ${RAIL_MIN - 1}px)`);\n    const wide = window.matchMedia(`(min-width: ${WIDE_MIN}px)`);\n\n    const sync = () => {\n      setMode(compact.matches ? 'compact' : wide.matches ? 'wide' : 'rail');\n    };\n\n    sync();\n    compact.addEventListener('change', sync);\n    wide.addEventListener('change', sync);\n    return () => {\n      compact.removeEventListener('change', sync);\n      wide.removeEventListener('change', sync);\n    };\n  }, []);\n\n  return mode;\n}\n\n/** Exported for tests and for callers that already hold a width. */\nexport const viewportModeFor = modeFor;\n"],"names":["useEffect","useState","RAIL_MIN","WIDE_MIN","modeFor","width","useViewportMode","mode","setMode","window","matchMedia","compact","wide","sync","matches","addEventListener","removeEventListener","viewportModeFor"],"mappings":"AAAA;AAEA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,QAAQ;AAY5C,MAAMC,WAAW;AACjB,MAAMC,WAAW;AAEjB,MAAMC,UAAU,CAACC;IACf,IAAIA,QAAQH,UAAU,OAAO;IAC7B,OAAOG,QAAQF,WAAW,SAAS;AACrC;AAEA;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,SAASG;IACd,MAAM,CAACC,MAAMC,QAAQ,GAAGP,SAAuB;IAE/CD,UAAU;QACR,0EAA0E;QAC1E,0EAA0E;QAC1E,4EAA4E;QAC5E,eAAe;QACf,IACE,OAAOS,WAAW,eAClB,OAAOA,OAAOC,UAAU,KAAK,YAE7B;QAEF,MAAMC,UAAUF,OAAOC,UAAU,CAAC,CAAC,YAAY,EAAER,WAAW,EAAE,GAAG,CAAC;QAClE,MAAMU,OAAOH,OAAOC,UAAU,CAAC,CAAC,YAAY,EAAEP,SAAS,GAAG,CAAC;QAE3D,MAAMU,OAAO;YACXL,QAAQG,QAAQG,OAAO,GAAG,YAAYF,KAAKE,OAAO,GAAG,SAAS;QAChE;QAEAD;QACAF,QAAQI,gBAAgB,CAAC,UAAUF;QACnCD,KAAKG,gBAAgB,CAAC,UAAUF;QAChC,OAAO;YACLF,QAAQK,mBAAmB,CAAC,UAAUH;YACtCD,KAAKI,mBAAmB,CAAC,UAAUH;QACrC;IACF,GAAG,EAAE;IAEL,OAAON;AACT;AAEA,kEAAkE,GAClE,OAAO,MAAMU,kBAAkBb,QAAQ"}

package/dist/primitives.d.ts

@@ -0,0 +1,25 @@
+export * from './i18n/index.js';
+export * from './theme/index.js';
+export * from './ui/atoms/button/index.js';
+export * from './ui/atoms/field/index.js';
+export * from './ui/atoms/skeleton/index.js';
+export * from './ui/atoms/table/index.js';
+export * from './ui/atoms/text/index.js';
+export * from './ui/layout/box/index.js';
+export * from './ui/layout/center/index.js';
+export * from './ui/layout/cluster/index.js';
+export * from './ui/layout/cover/index.js';
+export * from './ui/layout/grid/index.js';
+export * from './ui/layout/sidebar/index.js';
+export * from './ui/layout/switcher/index.js';
+export * from './ui/molecules/breadcrumbs/index.js';
+export * from './ui/molecules/card/index.js';
+export * from './ui/molecules/confirm-dialog/index.js';
+export * from './ui/molecules/loading-boundary/index.js';
+export * from './ui/molecules/menu/index.js';
+export * from './ui/molecules/pagination/index.js';
+export * from './ui/molecules/stack/index.js';
+export * from './ui/molecules/tab-strip/index.js';
+export * from './ui/molecules/theme-switcher/index.js';
+export * from './ui/utils/cn.js';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAyBA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAIzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,wCAAwC,CAAC;AACvD,cAAc,kBAAkB,CAAC"}

package/dist/primitives.js

@@ -0,0 +1,54 @@
+// The entity-free half of the design system, published as
+// `@entifix/react-controls/primitives`.
+//
+// It exists because the package's main barrel is one flat re-export of
+// everything, and a bundler cannot drop what a module graph reaches: a
+// storefront page importing `Card` from `.` pulled `EntityTable`,
+// `FilterBuilder`, `SortBuilder`, `ColumnSettings` and the RSQL machinery
+// behind them into its client bundle — 541 KB of back-office UI shipped to a
+// visitor looking at a product.
+//
+// The line drawn here is not "small vs large", it is **presentational vs
+// entity-aware**: everything below can be understood without knowing what an
+// entity is. Anything that reads entity metadata (`CellValue`, `FieldControl`,
+// `EntityTable`, `EntityForm`, the filter/sort/column builders, the link
+// inputs) stays behind the main entry, where the back-office already imports it.
+//
+// Consumers that need both may import both; nothing is duplicated, and the main
+// barrel keeps re-exporting all of this so no existing import breaks.
+// Providers every app mounts, whatever it renders.
+//
+// `./preferences` is deliberately **not** here. The UI-preferences store is
+// backed by Effect `Layer`s, so re-exporting it drags the whole Effect runtime
+// into the browser — and what it remembers (column visibility, table density)
+// only exists in the back-office. A storefront has no preferences to store.
+export * from './i18n/index.js';
+export * from './theme/index.js';
+// Atoms — text, buttons, fields, tables, loading placeholders.
+export * from './ui/atoms/button/index.js';
+export * from './ui/atoms/field/index.js';
+export * from './ui/atoms/skeleton/index.js';
+export * from './ui/atoms/table/index.js';
+export * from './ui/atoms/text/index.js';
+// Layout primitives (Every Layout): flex-first, with `Grid` the one CSS-Grid
+// escape hatch.
+export * from './ui/layout/box/index.js';
+export * from './ui/layout/center/index.js';
+export * from './ui/layout/cluster/index.js';
+export * from './ui/layout/cover/index.js';
+export * from './ui/layout/grid/index.js';
+export * from './ui/layout/sidebar/index.js';
+export * from './ui/layout/switcher/index.js';
+// Molecules that compose the above and nothing else.
+export * from './ui/molecules/breadcrumbs/index.js';
+export * from './ui/molecules/card/index.js';
+export * from './ui/molecules/confirm-dialog/index.js';
+export * from './ui/molecules/loading-boundary/index.js';
+export * from './ui/molecules/menu/index.js';
+export * from './ui/molecules/pagination/index.js';
+export * from './ui/molecules/stack/index.js';
+export * from './ui/molecules/tab-strip/index.js';
+export * from './ui/molecules/theme-switcher/index.js';
+export * from './ui/utils/cn.js';
+
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives.ts"],"sourcesContent":["// The entity-free half of the design system, published as\n// `@entifix/react-controls/primitives`.\n//\n// It exists because the package's main barrel is one flat re-export of\n// everything, and a bundler cannot drop what a module graph reaches: a\n// storefront page importing `Card` from `.` pulled `EntityTable`,\n// `FilterBuilder`, `SortBuilder`, `ColumnSettings` and the RSQL machinery\n// behind them into its client bundle — 541 KB of back-office UI shipped to a\n// visitor looking at a product.\n//\n// The line drawn here is not \"small vs large\", it is **presentational vs\n// entity-aware**: everything below can be understood without knowing what an\n// entity is. Anything that reads entity metadata (`CellValue`, `FieldControl`,\n// `EntityTable`, `EntityForm`, the filter/sort/column builders, the link\n// inputs) stays behind the main entry, where the back-office already imports it.\n//\n// Consumers that need both may import both; nothing is duplicated, and the main\n// barrel keeps re-exporting all of this so no existing import breaks.\n\n// Providers every app mounts, whatever it renders.\n//\n// `./preferences` is deliberately **not** here. The UI-preferences store is\n// backed by Effect `Layer`s, so re-exporting it drags the whole Effect runtime\n// into the browser — and what it remembers (column visibility, table density)\n// only exists in the back-office. A storefront has no preferences to store.\nexport * from './i18n/index.js';\nexport * from './theme/index.js';\n\n// Atoms — text, buttons, fields, tables, loading placeholders.\nexport * from './ui/atoms/button/index.js';\nexport * from './ui/atoms/field/index.js';\nexport * from './ui/atoms/skeleton/index.js';\nexport * from './ui/atoms/table/index.js';\nexport * from './ui/atoms/text/index.js';\n\n// Layout primitives (Every Layout): flex-first, with `Grid` the one CSS-Grid\n// escape hatch.\nexport * from './ui/layout/box/index.js';\nexport * from './ui/layout/center/index.js';\nexport * from './ui/layout/cluster/index.js';\nexport * from './ui/layout/cover/index.js';\nexport * from './ui/layout/grid/index.js';\nexport * from './ui/layout/sidebar/index.js';\nexport * from './ui/layout/switcher/index.js';\n\n// Molecules that compose the above and nothing else.\nexport * from './ui/molecules/breadcrumbs/index.js';\nexport * from './ui/molecules/card/index.js';\nexport * from './ui/molecules/confirm-dialog/index.js';\nexport * from './ui/molecules/loading-boundary/index.js';\nexport * from './ui/molecules/menu/index.js';\nexport * from './ui/molecules/pagination/index.js';\nexport * from './ui/molecules/stack/index.js';\nexport * from './ui/molecules/tab-strip/index.js';\nexport * from './ui/molecules/theme-switcher/index.js';\nexport * from './ui/utils/cn.js';\n"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,wCAAwC;AACxC,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,kEAAkE;AAClE,0EAA0E;AAC1E,6EAA6E;AAC7E,gCAAgC;AAChC,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,+EAA+E;AAC/E,yEAAyE;AACzE,iFAAiF;AACjF,EAAE;AACF,gFAAgF;AAChF,sEAAsE;AAEtE,mDAAmD;AACnD,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,cAAc,kBAAkB;AAChC,cAAc,mBAAmB;AAEjC,+DAA+D;AAC/D,cAAc,6BAA6B;AAC3C,cAAc,4BAA4B;AAC1C,cAAc,+BAA+B;AAC7C,cAAc,4BAA4B;AAC1C,cAAc,2BAA2B;AAEzC,6EAA6E;AAC7E,gBAAgB;AAChB,cAAc,2BAA2B;AACzC,cAAc,8BAA8B;AAC5C,cAAc,+BAA+B;AAC7C,cAAc,6BAA6B;AAC3C,cAAc,4BAA4B;AAC1C,cAAc,+BAA+B;AAC7C,cAAc,gCAAgC;AAE9C,qDAAqD;AACrD,cAAc,sCAAsC;AACpD,cAAc,+BAA+B;AAC7C,cAAc,yCAAyC;AACvD,cAAc,2CAA2C;AACzD,cAAc,+BAA+B;AAC7C,cAAc,qCAAqC;AACnD,cAAc,gCAAgC;AAC9C,cAAc,oCAAoC;AAClD,cAAc,yCAAyC;AACvD,cAAc,mBAAmB"}

package/dist/theme/index.d.ts

@@ -0,0 +1,3 @@
+export * from './theme-context.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/dist/theme/index.js

@@ -0,0 +1,4 @@
+export * from './theme-context.js';
+export * from './types.js';
+
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/index.ts"],"sourcesContent":["export * from './theme-context.js';\nexport * from './types.js';\n"],"names":[],"mappings":"AAAA,cAAc,qBAAqB;AACnC,cAAc,aAAa"}

package/dist/theme/theme-context.d.ts

@@ -0,0 +1,26 @@
+import { type PropsWithChildren } from 'react';
+import type { ThemeContextValue, ThemeOption, ThemePalette } from './types.js';
+export interface ThemeProviderProps extends PropsWithChildren {
+    /** The themes this app exposes. First entry is the default unless
+     *  `defaultTheme` is given. Drives `data-theme` + the switcher. */
+    themes: ThemeOption[];
+    /** Theme id used for the first paint / when nothing is stored. */
+    defaultTheme?: string;
+    /** localStorage key — namespace it per app so apps don't clobber each other. */
+    storageKey?: string;
+    /**
+     * Runtime palettes for brands not shipped as CSS presets (multi-tenant /
+     * white-label). Keyed by theme id; injected as `[data-theme='id']{…}` vars
+     * appended after the app stylesheet, so they override static presets.
+     */
+    palettes?: Record<string, ThemePalette>;
+}
+/**
+ * Applies the active palette by writing `data-theme` on <html> and persisting
+ * the choice. Static palette VALUES live in CSS (@entifix/style presets or
+ * an app-local themes.css); this flips the selector. Dynamic palettes passed via
+ * `palettes` are injected at runtime under the same `data-theme` mechanism.
+ */
+export declare function ThemeProvider({ children, themes, defaultTheme, storageKey, palettes, }: ThemeProviderProps): import("react").JSX.Element;
+export declare function useTheme(): ThemeContextValue;
+//# sourceMappingURL=theme-context.d.ts.map

package/dist/theme/theme-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-context.d.ts","sourceRoot":"","sources":["../../src/theme/theme-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/E,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D;uEACmE;IACnE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAA4B,EAC5B,QAAQ,GACT,EAAE,kBAAkB,+BA2DpB;AAED,wBAAgB,QAAQ,IAAI,iBAAiB,CAI5C"}

package/dist/theme/theme-context.js

@@ -0,0 +1,79 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+const ThemeContext = /*#__PURE__*/ createContext(null);
+/**
+ * Applies the active palette by writing `data-theme` on <html> and persisting
+ * the choice. Static palette VALUES live in CSS (@entifix/style presets or
+ * an app-local themes.css); this flips the selector. Dynamic palettes passed via
+ * `palettes` are injected at runtime under the same `data-theme` mechanism.
+ */ export function ThemeProvider({ children, themes, defaultTheme, storageKey = 'entifix-theme', palettes }) {
+    var _ref;
+    var _themes_;
+    const initial = (_ref = defaultTheme != null ? defaultTheme : (_themes_ = themes[0]) == null ? void 0 : _themes_.id) != null ? _ref : '';
+    const [theme, setThemeState] = useState(initial);
+    const isKnown = useCallback((value)=>typeof value === 'string' && themes.some((t)=>t.id === value), [
+        themes
+    ]);
+    // Hydrate from a previously stored preference on mount. This intentionally
+    // runs in an effect (not a lazy initializer): localStorage is unavailable
+    // during SSR, so the server renders `initial` and the client corrects after
+    // mount — reading it in render would cause a hydration mismatch.
+    useEffect(()=>{
+        const stored = window.localStorage.getItem(storageKey);
+        // eslint-disable-next-line react-hooks/set-state-in-effect -- one-shot SSR-safe hydration, see comment above
+        if (isKnown(stored)) setThemeState(stored);
+    }, [
+        storageKey,
+        isKnown
+    ]);
+    // Inject runtime palettes as a single <style> appended to <head>. Being last
+    // in the cascade, these win over any static preset defining the same tokens.
+    useEffect(()=>{
+        if (!palettes || Object.keys(palettes).length === 0) return;
+        const styleId = `${storageKey}-runtime-palettes`;
+        const css = Object.entries(palettes).map(([id, palette])=>{
+            const decls = Object.entries(palette).map(([token, value])=>`--color-${token}: ${value};`).join(' ');
+            return `[data-theme='${id}'] { ${decls} }`;
+        }).join('\n');
+        let el = document.getElementById(styleId);
+        if (!el) {
+            el = document.createElement('style');
+            el.id = styleId;
+            document.head.appendChild(el);
+        }
+        el.textContent = css;
+    }, [
+        palettes,
+        storageKey
+    ]);
+    // Reflect the active theme onto the document + persist it.
+    useEffect(()=>{
+        document.documentElement.dataset.theme = theme;
+        window.localStorage.setItem(storageKey, theme);
+    }, [
+        theme,
+        storageKey
+    ]);
+    const setTheme = useCallback((next)=>setThemeState(next), []);
+    const value = useMemo(()=>({
+            theme,
+            setTheme,
+            themes
+        }), [
+        theme,
+        setTheme,
+        themes
+    ]);
+    return /*#__PURE__*/ _jsx(ThemeContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+export function useTheme() {
+    const ctx = useContext(ThemeContext);
+    if (!ctx) throw new Error('useTheme must be used within a ThemeProvider');
+    return ctx;
+}
+
+//# sourceMappingURL=theme-context.js.map

package/dist/theme/theme-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/theme-context.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createContext,\n  type PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\n\nimport type { ThemeContextValue, ThemeOption, ThemePalette } from './types.js';\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nexport interface ThemeProviderProps extends PropsWithChildren {\n  /** The themes this app exposes. First entry is the default unless\n   *  `defaultTheme` is given. Drives `data-theme` + the switcher. */\n  themes: ThemeOption[];\n  /** Theme id used for the first paint / when nothing is stored. */\n  defaultTheme?: string;\n  /** localStorage key — namespace it per app so apps don't clobber each other. */\n  storageKey?: string;\n  /**\n   * Runtime palettes for brands not shipped as CSS presets (multi-tenant /\n   * white-label). Keyed by theme id; injected as `[data-theme='id']{…}` vars\n   * appended after the app stylesheet, so they override static presets.\n   */\n  palettes?: Record<string, ThemePalette>;\n}\n\n/**\n * Applies the active palette by writing `data-theme` on <html> and persisting\n * the choice. Static palette VALUES live in CSS (@entifix/style presets or\n * an app-local themes.css); this flips the selector. Dynamic palettes passed via\n * `palettes` are injected at runtime under the same `data-theme` mechanism.\n */\nexport function ThemeProvider({\n  children,\n  themes,\n  defaultTheme,\n  storageKey = 'entifix-theme',\n  palettes,\n}: ThemeProviderProps) {\n  const initial = defaultTheme ?? themes[0]?.id ?? '';\n  const [theme, setThemeState] = useState<string>(initial);\n\n  const isKnown = useCallback(\n    (value: unknown): value is string =>\n      typeof value === 'string' && themes.some(t => t.id === value),\n    [themes],\n  );\n\n  // Hydrate from a previously stored preference on mount. This intentionally\n  // runs in an effect (not a lazy initializer): localStorage is unavailable\n  // during SSR, so the server renders `initial` and the client corrects after\n  // mount — reading it in render would cause a hydration mismatch.\n  useEffect(() => {\n    const stored = window.localStorage.getItem(storageKey);\n    // eslint-disable-next-line react-hooks/set-state-in-effect -- one-shot SSR-safe hydration, see comment above\n    if (isKnown(stored)) setThemeState(stored);\n  }, [storageKey, isKnown]);\n\n  // Inject runtime palettes as a single <style> appended to <head>. Being last\n  // in the cascade, these win over any static preset defining the same tokens.\n  useEffect(() => {\n    if (!palettes || Object.keys(palettes).length === 0) return;\n    const styleId = `${storageKey}-runtime-palettes`;\n    const css = Object.entries(palettes)\n      .map(([id, palette]) => {\n        const decls = Object.entries(palette)\n          .map(([token, value]) => `--color-${token}: ${value};`)\n          .join(' ');\n        return `[data-theme='${id}'] { ${decls} }`;\n      })\n      .join('\\n');\n\n    let el = document.getElementById(styleId) as HTMLStyleElement | null;\n    if (!el) {\n      el = document.createElement('style');\n      el.id = styleId;\n      document.head.appendChild(el);\n    }\n    el.textContent = css;\n  }, [palettes, storageKey]);\n\n  // Reflect the active theme onto the document + persist it.\n  useEffect(() => {\n    document.documentElement.dataset.theme = theme;\n    window.localStorage.setItem(storageKey, theme);\n  }, [theme, storageKey]);\n\n  const setTheme = useCallback((next: string) => setThemeState(next), []);\n\n  const value = useMemo<ThemeContextValue>(\n    () => ({ theme, setTheme, themes }),\n    [theme, setTheme, themes],\n  );\n\n  return (\n    <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>\n  );\n}\n\nexport function useTheme(): ThemeContextValue {\n  const ctx = useContext(ThemeContext);\n  if (!ctx) throw new Error('useTheme must be used within a ThemeProvider');\n  return ctx;\n}\n"],"names":["createContext","useCallback","useContext","useEffect","useMemo","useState","ThemeContext","ThemeProvider","children","themes","defaultTheme","storageKey","palettes","initial","id","theme","setThemeState","isKnown","value","some","t","stored","window","localStorage","getItem","Object","keys","length","styleId","css","entries","map","palette","decls","token","join","el","document","getElementById","createElement","head","appendChild","textContent","documentElement","dataset","setItem","setTheme","next","Provider","useTheme","ctx","Error"],"mappings":"AAAA;;AAEA,SACEA,aAAa,EAEbC,WAAW,EACXC,UAAU,EACVC,SAAS,EACTC,OAAO,EACPC,QAAQ,QACH,QAAQ;AAIf,MAAMC,6BAAeN,cAAwC;AAkB7D;;;;;CAKC,GACD,OAAO,SAASO,cAAc,EAC5BC,QAAQ,EACRC,MAAM,EACNC,YAAY,EACZC,aAAa,eAAe,EAC5BC,QAAQ,EACW;QACHF;QAAgBD;IAAhC,MAAMI,WAAUH,OAAAA,uBAAAA,gBAAgBD,WAAAA,MAAM,CAAC,EAAE,qBAATA,SAAWK,EAAE,YAA7BJ,OAAiC;IACjD,MAAM,CAACK,OAAOC,cAAc,GAAGX,SAAiBQ;IAEhD,MAAMI,UAAUhB,YACd,CAACiB,QACC,OAAOA,UAAU,YAAYT,OAAOU,IAAI,CAACC,CAAAA,IAAKA,EAAEN,EAAE,KAAKI,QACzD;QAACT;KAAO;IAGV,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,iEAAiE;IACjEN,UAAU;QACR,MAAMkB,SAASC,OAAOC,YAAY,CAACC,OAAO,CAACb;QAC3C,6GAA6G;QAC7G,IAAIM,QAAQI,SAASL,cAAcK;IACrC,GAAG;QAACV;QAAYM;KAAQ;IAExB,6EAA6E;IAC7E,6EAA6E;IAC7Ed,UAAU;QACR,IAAI,CAACS,YAAYa,OAAOC,IAAI,CAACd,UAAUe,MAAM,KAAK,GAAG;QACrD,MAAMC,UAAU,GAAGjB,WAAW,iBAAiB,CAAC;QAChD,MAAMkB,MAAMJ,OAAOK,OAAO,CAAClB,UACxBmB,GAAG,CAAC,CAAC,CAACjB,IAAIkB,QAAQ;YACjB,MAAMC,QAAQR,OAAOK,OAAO,CAACE,SAC1BD,GAAG,CAAC,CAAC,CAACG,OAAOhB,MAAM,GAAK,CAAC,QAAQ,EAAEgB,MAAM,EAAE,EAAEhB,MAAM,CAAC,CAAC,EACrDiB,IAAI,CAAC;YACR,OAAO,CAAC,aAAa,EAAErB,GAAG,KAAK,EAAEmB,MAAM,EAAE,CAAC;QAC5C,GACCE,IAAI,CAAC;QAER,IAAIC,KAAKC,SAASC,cAAc,CAACV;QACjC,IAAI,CAACQ,IAAI;YACPA,KAAKC,SAASE,aAAa,CAAC;YAC5BH,GAAGtB,EAAE,GAAGc;YACRS,SAASG,IAAI,CAACC,WAAW,CAACL;QAC5B;QACAA,GAAGM,WAAW,GAAGb;IACnB,GAAG;QAACjB;QAAUD;KAAW;IAEzB,2DAA2D;IAC3DR,UAAU;QACRkC,SAASM,eAAe,CAACC,OAAO,CAAC7B,KAAK,GAAGA;QACzCO,OAAOC,YAAY,CAACsB,OAAO,CAAClC,YAAYI;IAC1C,GAAG;QAACA;QAAOJ;KAAW;IAEtB,MAAMmC,WAAW7C,YAAY,CAAC8C,OAAiB/B,cAAc+B,OAAO,EAAE;IAEtE,MAAM7B,QAAQd,QACZ,IAAO,CAAA;YAAEW;YAAO+B;YAAUrC;QAAO,CAAA,GACjC;QAACM;QAAO+B;QAAUrC;KAAO;IAG3B,qBACE,KAACH,aAAa0C,QAAQ;QAAC9B,OAAOA;kBAAQV;;AAE1C;AAEA,OAAO,SAASyC;IACd,MAAMC,MAAMhD,WAAWI;IACvB,IAAI,CAAC4C,KAAK,MAAM,IAAIC,MAAM;IAC1B,OAAOD;AACT"}

package/dist/theme/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A selectable theme. `id` is written to `data-theme` on <html> and matched
+ * against the CSS palette blocks; `label` is what the switcher renders.
+ */
+export interface ThemeOption {
+    id: string;
+    label: string;
+}
+/** The semantic color tokens an app may supply values for. Matches the
+ *  `--color-*` contract declared in @entifix/style/tokens.css. */
+export type ThemeColorToken = 'surface' | 'surface-elevated' | 'content' | 'content-muted' | 'primary' | 'primary-content' | 'border' | 'accent' | 'danger' | 'danger-subtle' | 'danger-content';
+/** A runtime palette: token → CSS color. Injected as `[data-theme]` vars for
+ *  brands not known at build time (multi-tenant / white-label). */
+export type ThemePalette = Partial<Record<ThemeColorToken, string>>;
+export interface ThemeContextValue {
+    /** Active theme id (written to `data-theme`). */
+    theme: string;
+    setTheme: (id: string) => void;
+    /** The registry this provider was configured with. */
+    themes: ThemeOption[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;kEACkE;AAClE,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,kBAAkB,GAClB,SAAS,GACT,eAAe,GACf,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,eAAe,GACf,gBAAgB,CAAC;AAErB;mEACmE;AACnE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,sDAAsD;IACtD,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB"}

package/dist/theme/types.js

@@ -0,0 +1,6 @@
+/**
+ * A selectable theme. `id` is written to `data-theme` on <html> and matched
+ * against the CSS palette blocks; `label` is what the switcher renders.
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/theme/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/types.ts"],"sourcesContent":["/**\n * A selectable theme. `id` is written to `data-theme` on <html> and matched\n * against the CSS palette blocks; `label` is what the switcher renders.\n */\nexport interface ThemeOption {\n  id: string;\n  label: string;\n}\n\n/** The semantic color tokens an app may supply values for. Matches the\n *  `--color-*` contract declared in @entifix/style/tokens.css. */\nexport type ThemeColorToken =\n  | 'surface'\n  | 'surface-elevated'\n  | 'content'\n  | 'content-muted'\n  | 'primary'\n  | 'primary-content'\n  | 'border'\n  | 'accent'\n  | 'danger'\n  | 'danger-subtle'\n  | 'danger-content';\n\n/** A runtime palette: token → CSS color. Injected as `[data-theme]` vars for\n *  brands not known at build time (multi-tenant / white-label). */\nexport type ThemePalette = Partial<Record<ThemeColorToken, string>>;\n\nexport interface ThemeContextValue {\n  /** Active theme id (written to `data-theme`). */\n  theme: string;\n  setTheme: (id: string) => void;\n  /** The registry this provider was configured with. */\n  themes: ThemeOption[];\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAyBD,WAMC"}

package/dist/ui/actions/action-surfaces.d.ts

@@ -0,0 +1,59 @@
+import { type UseCaseDescriptor } from '@entifix/core';
+/**
+ * Where a declared verb is rendered.
+ *
+ * ADR 0026 gave a use case two independent axes and then built only one
+ * surface, so four of the nine cells had nowhere to go: `EntityForm` filtered
+ * `binding === 'entity' && placement !== 'context-dependent'` and everything
+ * else was dropped without a word. This is the map that closes it —
+ * **placement decides the surface, binding decides the payload** — and it lives
+ * in one module so no surface re-derives it and the two axes cannot drift
+ * apart again ([ADR 0035](../../../../../../docs/adr/0035-entity-actions-selection-and-bulk.md)).
+ */
+export declare const ACTION_SURFACES: readonly ["form-header", "form-footer", "row-menu", "bulk-bar", "table-toolbar", "command-palette"];
+export type ActionSurface = (typeof ACTION_SURFACES)[number];
+/**
+ * The overflow trigger's glyph.
+ *
+ * A constant rather than a literal in JSX, because `react/jsx-no-literals`
+ * fails the build on written-in copy and is right to: it cannot tell a
+ * typographic glyph from a forgotten Spanish string. The trigger's *name* is a
+ * catalog key (`form.moreActions`, `table.actions`) — this is only the mark,
+ * and it is never read aloud.
+ */
+export declare const OVERFLOW_GLYPH = "\u22EF";
+/**
+ * Every surface this descriptor renders on.
+ *
+ * ⚠️ **A verb may name more than one cell**, and that is what makes publishing
+ * reachable from a form header, a row menu and a selection without becoming
+ * three permissions (#216). The primary `binding` + `placement` come first, then
+ * whatever `alsoAt` adds, and each is validated the same way — an illegal cell
+ * in `alsoAt` throws exactly as one in the primary pair does.
+ *
+ * Duplicates are collapsed. A descriptor that named the same cell twice would
+ * otherwise render the verb twice in one menu, which reads as a bug in the
+ * screen rather than in the declaration.
+ */
+export declare function surfacesFor(descriptor: UseCaseDescriptor): readonly ActionSurface[];
+/**
+ * The single surface this descriptor renders on.
+ *
+ * Kept for the callers that genuinely have one — the command palette asks "is
+ * this mine?" of an `unbound` verb, which can only ever be in one place. Any
+ * caller that renders a *list* of verbs wants {@link surfacesFor}.
+ */
+export declare function surfaceFor(descriptor: UseCaseDescriptor): ActionSurface;
+/**
+ * The descriptors one surface should render, in declaration order.
+ *
+ * Every descriptor is passed through {@link surfacesFor}, so an unrenderable
+ * cell throws on the **first render of any surface** rather than only on the
+ * one that would have shown it — the same reason
+ * `assertLinkSourcesAreEditable` runs as one pass over the registry instead of
+ * per row: a check that only fires on the screen that was already looking for
+ * the verb is a check that fires after the bug is reported. A cell declared in
+ * `alsoAt` is validated on that same first render, not on the surface it names.
+ */
+export declare function useCasesForSurface(surface: ActionSurface, useCases: readonly UseCaseDescriptor[] | undefined): UseCaseDescriptor[];
+//# sourceMappingURL=action-surfaces.d.ts.map

package/dist/ui/actions/action-surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-surfaces.d.ts","sourceRoot":"","sources":["../../../src/ui/actions/action-surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,qGAOlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAyB7D;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,WAAW,CAAC;AAyBvC;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,iBAAiB,GAC5B,SAAS,aAAa,EAAE,CAa1B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,iBAAiB,GAAG,aAAa,CAMvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GACjD,iBAAiB,EAAE,CAIrB"}

package/dist/ui/actions/action-surfaces.js

@@ -0,0 +1,109 @@
+import { EntifixLogicError } from '@entifix/core';
+/**
+ * Where a declared verb is rendered.
+ *
+ * ADR 0026 gave a use case two independent axes and then built only one
+ * surface, so four of the nine cells had nowhere to go: `EntityForm` filtered
+ * `binding === 'entity' && placement !== 'context-dependent'` and everything
+ * else was dropped without a word. This is the map that closes it —
+ * **placement decides the surface, binding decides the payload** — and it lives
+ * in one module so no surface re-derives it and the two axes cannot drift
+ * apart again ([ADR 0035](../../../../../../docs/adr/0035-entity-actions-selection-and-bulk.md)).
+ */ export const ACTION_SURFACES = [
+    'form-header',
+    'form-footer',
+    'row-menu',
+    'bulk-bar',
+    'table-toolbar',
+    'command-palette'
+];
+/**
+ * The nine cells, exhaustively.
+ *
+ * `collection` + `determining` is deliberately absent, and asking for it
+ * throws rather than returning `undefined`. A determining action *finalizes a
+ * page* — it is the footer that ends an object page — and a list screen has no
+ * such thing to finalize, which is Fiori's own rule. Dropping it silently is
+ * the fault this repo already writes an assertion against elsewhere: the verb
+ * would be declared, granted, exported, pass every `@r10c/slices` invariant,
+ * and simply never appear, which reads to its author as "the permission is
+ * wrong" and sends them looking in the wrong place entirely.
+ */ const SURFACE_BY_CELL = {
+    'entity:context-independent': 'form-header',
+    'entity:determining': 'form-footer',
+    'entity:context-dependent': 'row-menu',
+    'collection:context-dependent': 'bulk-bar',
+    'collection:context-independent': 'table-toolbar',
+    'unbound:context-dependent': 'command-palette',
+    'unbound:context-independent': 'command-palette',
+    'unbound:determining': 'command-palette'
+};
+/**
+ * The overflow trigger's glyph.
+ *
+ * A constant rather than a literal in JSX, because `react/jsx-no-literals`
+ * fails the build on written-in copy and is right to: it cannot tell a
+ * typographic glyph from a forgotten Spanish string. The trigger's *name* is a
+ * catalog key (`form.moreActions`, `table.actions`) — this is only the mark,
+ * and it is never read aloud.
+ */ export const OVERFLOW_GLYPH = '\u22ef';
+/** Which surface renders one cell. Throws on a cell no surface owns. */ function surfaceForCell(key, binding, placement) {
+    const surface = SURFACE_BY_CELL[`${binding}:${placement}`];
+    if (surface === undefined) {
+        throw new EntifixLogicError(`The use case "${key}" is declared ${binding} + ${placement}, which no surface renders. ` + 'A `determining` action finalizes a page — it is an object page’s footer — and a list ' + 'screen has no page to finalize, so a collection-bound verb cannot be determining. ' + 'Declare it `context-dependent` to reach the bulk bar, or `context-independent` to sit ' + 'in the table toolbar.', undefined, {
+            key,
+            binding,
+            placement
+        });
+    }
+    return surface;
+}
+/**
+ * Every surface this descriptor renders on.
+ *
+ * ⚠️ **A verb may name more than one cell**, and that is what makes publishing
+ * reachable from a form header, a row menu and a selection without becoming
+ * three permissions (#216). The primary `binding` + `placement` come first, then
+ * whatever `alsoAt` adds, and each is validated the same way — an illegal cell
+ * in `alsoAt` throws exactly as one in the primary pair does.
+ *
+ * Duplicates are collapsed. A descriptor that named the same cell twice would
+ * otherwise render the verb twice in one menu, which reads as a bug in the
+ * screen rather than in the declaration.
+ */ export function surfacesFor(descriptor) {
+    var _descriptor_alsoAt;
+    const cells = [
+        {
+            binding: descriptor.binding,
+            placement: descriptor.placement
+        },
+        ...(_descriptor_alsoAt = descriptor.alsoAt) != null ? _descriptor_alsoAt : []
+    ];
+    return [
+        ...new Set(cells.map((cell)=>surfaceForCell(descriptor.key, cell.binding, cell.placement)))
+    ];
+}
+/**
+ * The single surface this descriptor renders on.
+ *
+ * Kept for the callers that genuinely have one — the command palette asks "is
+ * this mine?" of an `unbound` verb, which can only ever be in one place. Any
+ * caller that renders a *list* of verbs wants {@link surfacesFor}.
+ */ export function surfaceFor(descriptor) {
+    return surfaceForCell(descriptor.key, descriptor.binding, descriptor.placement);
+}
+/**
+ * The descriptors one surface should render, in declaration order.
+ *
+ * Every descriptor is passed through {@link surfacesFor}, so an unrenderable
+ * cell throws on the **first render of any surface** rather than only on the
+ * one that would have shown it — the same reason
+ * `assertLinkSourcesAreEditable` runs as one pass over the registry instead of
+ * per row: a check that only fires on the screen that was already looking for
+ * the verb is a check that fires after the bug is reported. A cell declared in
+ * `alsoAt` is validated on that same first render, not on the surface it names.
+ */ export function useCasesForSurface(surface, useCases) {
+    return (useCases != null ? useCases : []).filter((descriptor)=>surfacesFor(descriptor).includes(surface));
+}
+
+//# sourceMappingURL=action-surfaces.js.map

package/dist/ui/actions/action-surfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/actions/action-surfaces.ts"],"sourcesContent":["import {\n  EntifixLogicError,\n  type UseCaseBinding,\n  type UseCaseDescriptor,\n  type UseCasePlacement,\n} from '@entifix/core';\n\n/**\n * Where a declared verb is rendered.\n *\n * ADR 0026 gave a use case two independent axes and then built only one\n * surface, so four of the nine cells had nowhere to go: `EntityForm` filtered\n * `binding === 'entity' && placement !== 'context-dependent'` and everything\n * else was dropped without a word. This is the map that closes it —\n * **placement decides the surface, binding decides the payload** — and it lives\n * in one module so no surface re-derives it and the two axes cannot drift\n * apart again ([ADR 0035](../../../../../../docs/adr/0035-entity-actions-selection-and-bulk.md)).\n */\nexport const ACTION_SURFACES = [\n  'form-header',\n  'form-footer',\n  'row-menu',\n  'bulk-bar',\n  'table-toolbar',\n  'command-palette',\n] as const;\nexport type ActionSurface = (typeof ACTION_SURFACES)[number];\n\n/**\n * The nine cells, exhaustively.\n *\n * `collection` + `determining` is deliberately absent, and asking for it\n * throws rather than returning `undefined`. A determining action *finalizes a\n * page* — it is the footer that ends an object page — and a list screen has no\n * such thing to finalize, which is Fiori's own rule. Dropping it silently is\n * the fault this repo already writes an assertion against elsewhere: the verb\n * would be declared, granted, exported, pass every `@r10c/slices` invariant,\n * and simply never appear, which reads to its author as \"the permission is\n * wrong\" and sends them looking in the wrong place entirely.\n */\nconst SURFACE_BY_CELL: Record<string, ActionSurface> = {\n  'entity:context-independent': 'form-header',\n  'entity:determining': 'form-footer',\n  'entity:context-dependent': 'row-menu',\n  'collection:context-dependent': 'bulk-bar',\n  'collection:context-independent': 'table-toolbar',\n  'unbound:context-dependent': 'command-palette',\n  'unbound:context-independent': 'command-palette',\n  'unbound:determining': 'command-palette',\n};\n\n/**\n * The overflow trigger's glyph.\n *\n * A constant rather than a literal in JSX, because `react/jsx-no-literals`\n * fails the build on written-in copy and is right to: it cannot tell a\n * typographic glyph from a forgotten Spanish string. The trigger's *name* is a\n * catalog key (`form.moreActions`, `table.actions`) — this is only the mark,\n * and it is never read aloud.\n */\nexport const OVERFLOW_GLYPH = '\\u22ef';\n\n/** Which surface renders one cell. Throws on a cell no surface owns. */\nfunction surfaceForCell(\n  key: string,\n  binding: UseCaseBinding,\n  placement: UseCasePlacement,\n): ActionSurface {\n  const surface = SURFACE_BY_CELL[`${binding}:${placement}`];\n\n  if (surface === undefined) {\n    throw new EntifixLogicError(\n      `The use case \"${key}\" is declared ${binding} + ${placement}, which no surface renders. ` +\n        'A `determining` action finalizes a page — it is an object page’s footer — and a list ' +\n        'screen has no page to finalize, so a collection-bound verb cannot be determining. ' +\n        'Declare it `context-dependent` to reach the bulk bar, or `context-independent` to sit ' +\n        'in the table toolbar.',\n      undefined,\n      { key, binding, placement },\n    );\n  }\n\n  return surface;\n}\n\n/**\n * Every surface this descriptor renders on.\n *\n * ⚠️ **A verb may name more than one cell**, and that is what makes publishing\n * reachable from a form header, a row menu and a selection without becoming\n * three permissions (#216). The primary `binding` + `placement` come first, then\n * whatever `alsoAt` adds, and each is validated the same way — an illegal cell\n * in `alsoAt` throws exactly as one in the primary pair does.\n *\n * Duplicates are collapsed. A descriptor that named the same cell twice would\n * otherwise render the verb twice in one menu, which reads as a bug in the\n * screen rather than in the declaration.\n */\nexport function surfacesFor(\n  descriptor: UseCaseDescriptor,\n): readonly ActionSurface[] {\n  const cells = [\n    { binding: descriptor.binding, placement: descriptor.placement },\n    ...(descriptor.alsoAt ?? []),\n  ];\n\n  return [\n    ...new Set(\n      cells.map(cell =>\n        surfaceForCell(descriptor.key, cell.binding, cell.placement),\n      ),\n    ),\n  ];\n}\n\n/**\n * The single surface this descriptor renders on.\n *\n * Kept for the callers that genuinely have one — the command palette asks \"is\n * this mine?\" of an `unbound` verb, which can only ever be in one place. Any\n * caller that renders a *list* of verbs wants {@link surfacesFor}.\n */\nexport function surfaceFor(descriptor: UseCaseDescriptor): ActionSurface {\n  return surfaceForCell(\n    descriptor.key,\n    descriptor.binding,\n    descriptor.placement,\n  );\n}\n\n/**\n * The descriptors one surface should render, in declaration order.\n *\n * Every descriptor is passed through {@link surfacesFor}, so an unrenderable\n * cell throws on the **first render of any surface** rather than only on the\n * one that would have shown it — the same reason\n * `assertLinkSourcesAreEditable` runs as one pass over the registry instead of\n * per row: a check that only fires on the screen that was already looking for\n * the verb is a check that fires after the bug is reported. A cell declared in\n * `alsoAt` is validated on that same first render, not on the surface it names.\n */\nexport function useCasesForSurface(\n  surface: ActionSurface,\n  useCases: readonly UseCaseDescriptor[] | undefined,\n): UseCaseDescriptor[] {\n  return (useCases ?? []).filter(descriptor =>\n    surfacesFor(descriptor).includes(surface),\n  );\n}\n"],"names":["EntifixLogicError","ACTION_SURFACES","SURFACE_BY_CELL","OVERFLOW_GLYPH","surfaceForCell","key","binding","placement","surface","undefined","surfacesFor","descriptor","cells","alsoAt","Set","map","cell","surfaceFor","useCasesForSurface","useCases","filter","includes"],"mappings":"AAAA,SACEA,iBAAiB,QAIZ,gBAAgB;AAEvB;;;;;;;;;;CAUC,GACD,OAAO,MAAMC,kBAAkB;IAC7B;IACA;IACA;IACA;IACA;IACA;CACD,CAAU;AAGX;;;;;;;;;;;CAWC,GACD,MAAMC,kBAAiD;IACrD,8BAA8B;IAC9B,sBAAsB;IACtB,4BAA4B;IAC5B,gCAAgC;IAChC,kCAAkC;IAClC,6BAA6B;IAC7B,+BAA+B;IAC/B,uBAAuB;AACzB;AAEA;;;;;;;;CAQC,GACD,OAAO,MAAMC,iBAAiB,SAAS;AAEvC,sEAAsE,GACtE,SAASC,eACPC,GAAW,EACXC,OAAuB,EACvBC,SAA2B;IAE3B,MAAMC,UAAUN,eAAe,CAAC,GAAGI,QAAQ,CAAC,EAAEC,WAAW,CAAC;IAE1D,IAAIC,YAAYC,WAAW;QACzB,MAAM,IAAIT,kBACR,CAAC,cAAc,EAAEK,IAAI,cAAc,EAAEC,QAAQ,GAAG,EAAEC,UAAU,4BAA4B,CAAC,GACvF,0FACA,uFACA,2FACA,yBACFE,WACA;YAAEJ;YAAKC;YAASC;QAAU;IAE9B;IAEA,OAAOC;AACT;AAEA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASE,YACdC,UAA6B;QAIvBA;IAFN,MAAMC,QAAQ;QACZ;YAAEN,SAASK,WAAWL,OAAO;YAAEC,WAAWI,WAAWJ,SAAS;QAAC;YAC3DI,qBAAAA,WAAWE,MAAM,YAAjBF,qBAAqB,EAAE;KAC5B;IAED,OAAO;WACF,IAAIG,IACLF,MAAMG,GAAG,CAACC,CAAAA,OACRZ,eAAeO,WAAWN,GAAG,EAAEW,KAAKV,OAAO,EAAEU,KAAKT,SAAS;KAGhE;AACH;AAEA;;;;;;CAMC,GACD,OAAO,SAASU,WAAWN,UAA6B;IACtD,OAAOP,eACLO,WAAWN,GAAG,EACdM,WAAWL,OAAO,EAClBK,WAAWJ,SAAS;AAExB;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASW,mBACdV,OAAsB,EACtBW,QAAkD;IAElD,OAAO,CAACA,mBAAAA,WAAY,EAAE,EAAEC,MAAM,CAACT,CAAAA,aAC7BD,YAAYC,YAAYU,QAAQ,CAACb;AAErC"}

package/dist/ui/actions/index.d.ts

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

package/dist/ui/actions/index.d.ts.map

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

package/dist/ui/actions/index.js

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

package/dist/ui/actions/index.js.map

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

package/dist/ui/atoms/button/button-link.d.ts

@@ -0,0 +1,27 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { type ButtonVariantProps } from './button-recipe.js';
+/**
+ * An anchor wearing {@link Button}'s clothes — and, unlike `Button`, a
+ * **server** component.
+ *
+ * Most call-to-action buttons are not buttons: "View product", "Browse
+ * category" and "Keep shopping" navigate, and a `<button>` that navigates is
+ * both worse for the visitor (no middle-click, no open-in-new-tab, no status
+ * bar) and more expensive for the page, because `Button` carries a
+ * `'use client'` and would turn every card in a grid into its own client
+ * boundary.
+ *
+ * Reach for `Button` when something actually happens on click; reach for this
+ * when the click is a link. It takes no event handlers on purpose — accepting
+ * one would quietly demand a client parent to pass it.
+ */
+export interface ButtonLinkProps extends Omit<ComponentPropsWithoutRef<'a'>, 'onClick'>, ButtonVariantProps {
+    /**
+     * Required: a link with no content is invisible to a screen reader and
+     * unclickable to everyone else. `jsx-a11y/anchor-has-content` cannot see
+     * through the prop spread below, so the type is what enforces it.
+     */
+    children: ReactNode;
+}
+export declare function ButtonLink({ variant, size, className, children, ...props }: ButtonLinkProps): import("react").JSX.Element;
+//# sourceMappingURL=button-link.d.ts.map