@entifix/react-controls 0.18.2 → 0.20.0

package/dist/primitives.js

@@ -25,10 +25,14 @@
 export * from './i18n/index.js';
 export * from './theme/index.js';
 // Atoms — text, buttons, fields, tables, loading placeholders.
+export * from './ui/atoms/alert/index.js';
 export * from './ui/atoms/button/index.js';
 export * from './ui/atoms/external-link/index.js';
 export * from './ui/atoms/field/index.js';
+export * from './ui/atoms/money/index.js';
+export * from './ui/atoms/number-input/index.js';
 export * from './ui/atoms/skeleton/index.js';
+export * from './ui/atoms/status-tag/index.js';
 export * from './ui/atoms/switch/index.js';
 export * from './ui/atoms/table/index.js';
 export * from './ui/atoms/text/index.js';
@@ -45,13 +49,15 @@ 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/description-list/index.js';
+export * from './ui/molecules/empty-state/index.js';
 export * from './ui/molecules/loading-boundary/index.js';
+export * from './ui/molecules/media-gallery/index.js';
 export * from './ui/molecules/menu/index.js';
 export * from './ui/molecules/nav-menu/index.js';
 export * from './ui/molecules/pagination/index.js';
 export * from './ui/molecules/segmented-control/index.js';
 export * from './ui/molecules/segmented-nav/index.js';
-export * from './ui/molecules/split-button/index.js';
 export * from './ui/molecules/split-view/index.js';
 export * from './ui/molecules/stack/index.js';
 export * from './ui/molecules/tab-strip/index.js';

package/dist/primitives.js.map

@@ -1 +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/external-link/index.js';\nexport * from './ui/atoms/field/index.js';\nexport * from './ui/atoms/skeleton/index.js';\nexport * from './ui/atoms/switch/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/nav-menu/index.js';\nexport * from './ui/molecules/pagination/index.js';\nexport * from './ui/molecules/segmented-control/index.js';\nexport * from './ui/molecules/segmented-nav/index.js';\nexport * from './ui/molecules/split-button/index.js';\nexport * from './ui/molecules/split-view/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/active-heading/index.js';\nexport * from './ui/utils/active-section/index.js';\nexport * from './ui/utils/cn.js';\nexport * from './ui/utils/fold-script/index.js';\nexport * from './ui/utils/keep-section/index.js';\nexport * from './ui/utils/media-query/index.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,oCAAoC;AAClD,cAAc,4BAA4B;AAC1C,cAAc,+BAA+B;AAC7C,cAAc,6BAA6B;AAC3C,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,mCAAmC;AACjD,cAAc,qCAAqC;AACnD,cAAc,4CAA4C;AAC1D,cAAc,wCAAwC;AACtD,cAAc,uCAAuC;AACrD,cAAc,qCAAqC;AACnD,cAAc,gCAAgC;AAC9C,cAAc,oCAAoC;AAClD,cAAc,yCAAyC;AACvD,cAAc,qCAAqC;AACnD,cAAc,qCAAqC;AACnD,cAAc,mBAAmB;AACjC,cAAc,kCAAkC;AAChD,cAAc,mCAAmC;AACjD,cAAc,kCAAkC"}
+{"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/alert/index.js';\nexport * from './ui/atoms/button/index.js';\nexport * from './ui/atoms/external-link/index.js';\nexport * from './ui/atoms/field/index.js';\nexport * from './ui/atoms/money/index.js';\nexport * from './ui/atoms/number-input/index.js';\nexport * from './ui/atoms/skeleton/index.js';\nexport * from './ui/atoms/status-tag/index.js';\nexport * from './ui/atoms/switch/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/description-list/index.js';\nexport * from './ui/molecules/empty-state/index.js';\nexport * from './ui/molecules/loading-boundary/index.js';\nexport * from './ui/molecules/media-gallery/index.js';\nexport * from './ui/molecules/menu/index.js';\nexport * from './ui/molecules/nav-menu/index.js';\nexport * from './ui/molecules/pagination/index.js';\nexport * from './ui/molecules/segmented-control/index.js';\nexport * from './ui/molecules/segmented-nav/index.js';\nexport * from './ui/molecules/split-view/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/active-heading/index.js';\nexport * from './ui/utils/active-section/index.js';\nexport * from './ui/utils/cn.js';\nexport * from './ui/utils/fold-script/index.js';\nexport * from './ui/utils/keep-section/index.js';\nexport * from './ui/utils/media-query/index.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,4BAA4B;AAC1C,cAAc,6BAA6B;AAC3C,cAAc,oCAAoC;AAClD,cAAc,4BAA4B;AAC1C,cAAc,4BAA4B;AAC1C,cAAc,mCAAmC;AACjD,cAAc,+BAA+B;AAC7C,cAAc,iCAAiC;AAC/C,cAAc,6BAA6B;AAC3C,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,sCAAsC;AACpD,cAAc,2CAA2C;AACzD,cAAc,wCAAwC;AACtD,cAAc,+BAA+B;AAC7C,cAAc,mCAAmC;AACjD,cAAc,qCAAqC;AACnD,cAAc,4CAA4C;AAC1D,cAAc,wCAAwC;AACtD,cAAc,qCAAqC;AACnD,cAAc,gCAAgC;AAC9C,cAAc,oCAAoC;AAClD,cAAc,yCAAyC;AACvD,cAAc,qCAAqC;AACnD,cAAc,qCAAqC;AACnD,cAAc,mBAAmB;AACjC,cAAc,kCAAkC;AAChD,cAAc,mCAAmC;AACjD,cAAc,kCAAkC"}

package/dist/theme/index.d.ts

@@ -1,4 +1,5 @@
 export * from './theme-context.js';
+export * from './theme-cookie.js';
 export * from './theme-script.js';
 export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/theme/index.js

@@ -1,4 +1,5 @@
 export * from './theme-context.js';
+export * from './theme-cookie.js';
 export * from './theme-script.js';
 export * from './types.js';
 

package/dist/theme/index.js.map

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

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

@@ -1,13 +1,31 @@
 import { type PropsWithChildren } from 'react';
-import type { ThemeContextValue, ThemeOption, ThemePalette } from './types.js';
+import type { Density, 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. */
+    /**
+     * The density when nothing is stored. Omitted, the provider leaves
+     * `data-density` as the document has it until a density is chosen.
+     */
+    defaultDensity?: Density;
+    /**
+     * The cookie the theme is kept in — namespace it per app so apps don't
+     * clobber each other. The density is kept beside it, under
+     * `${storageKey}-density`. A cookie rather than local storage, so a server
+     * can read the choice and render `data-theme` and `data-density` with the
+     * page: no paint in the wrong palette before a script corrects it.
+     */
     storageKey?: string;
+    /**
+     * The theme and density the server read from those cookies and rendered
+     * the page in (`readThemeCookies` in `@entifix/next-shell/server`). Given,
+     * the provider starts there and nothing changes after the page loads.
+     */
+    initialTheme?: string;
+    initialDensity?: Density;
     /**
      * Runtime palettes for brands not shipped as CSS presets (multi-tenant /
      * white-label). Keyed by theme id; injected as `[data-theme='id']{…}` vars
@@ -16,11 +34,21 @@ export interface ThemeProviderProps extends PropsWithChildren {
     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.
+ * Applies the active palette and density by writing `data-theme` and
+ * `data-density` on <html>, and remembers what the user chooses. 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.
+ *
+ * ⚠️ **Only a choice is written to storage, never a default.** The provider
+ * used to persist whatever theme it held from an effect, and under StrictMode
+ * the effect ran before the stored value had been read back: the default
+ * overwrote the stored theme, and a reload in development always came back on
+ * the default. Writing in `setTheme` and `setDensity` alone means mounting,
+ * however many times, can never lose what was chosen.
  */
-export declare function ThemeProvider({ children, themes, defaultTheme, storageKey, palettes, }: ThemeProviderProps): import("react").JSX.Element;
+export declare function ThemeProvider({ children, themes, defaultTheme, defaultDensity, storageKey, palettes, initialTheme, initialDensity, }: ThemeProviderProps): import("react").JSX.Element;
+/** The theme context, or `null` outside a {@link ThemeProvider}. */
+export declare const useOptionalTheme: () => ThemeContextValue | null;
 export declare function useTheme(): ThemeContextValue;
 //# sourceMappingURL=theme-context.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"theme-context.d.ts","sourceRoot":"","sources":["../../src/theme/theme-context.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D;uEACmE;IACnE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAiCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,cAAc,EACd,UAAyB,EACzB,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,EAAE,kBAAkB,+BAoHpB;AAED,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,QAAO,iBAAiB,GAAG,IAC9B,CAAC;AAE3B,wBAAgB,QAAQ,IAAI,iBAAiB,CAI5C"}

package/dist/theme/theme-context.js

@@ -1,31 +1,83 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
+import { Effect } from 'effect';
 import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { useUiPreferencesState } from '../preferences/ui-preferences-context.js';
+import { densityCookie, THEME_COOKIE } from './theme-cookie.js';
 const ThemeContext = /*#__PURE__*/ createContext(null);
+const DENSITIES = [
+    'comfortable',
+    'compact'
+];
+const isDensity = (value)=>DENSITIES.includes(value);
+/** Storage that may be absent or refuse (a private window, blocked site data). */ /** A year: a preference outlives a session. */ const COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+/** A first-party cookie's value, or `null` when it is not set. */ function readCookie(name) {
+    try {
+        for (const pair of document.cookie.split('; ')){
+            const at = pair.indexOf('=');
+            if (pair.slice(0, at) === name) return decodeURIComponent(pair.slice(at + 1));
+        }
+    } catch (unused) {
+    // A sandboxed document refuses cookies; nothing was stored, then.
+    }
+    return null;
+}
+function writeCookie(name, value) {
+    try {
+        document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${COOKIE_MAX_AGE}; samesite=lax`;
+    } catch (unused) {
+    // Nothing to remember it in; the choice still applies to this page.
+    }
+}
 /**
- * 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;
+ * Applies the active palette and density by writing `data-theme` and
+ * `data-density` on <html>, and remembers what the user chooses. 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.
+ *
+ * ⚠️ **Only a choice is written to storage, never a default.** The provider
+ * used to persist whatever theme it held from an effect, and under StrictMode
+ * the effect ran before the stored value had been read back: the default
+ * overwrote the stored theme, and a reload in development always came back on
+ * the default. Writing in `setTheme` and `setDensity` alone means mounting,
+ * however many times, can never lose what was chosen.
+ */ export function ThemeProvider({ children, themes, defaultTheme, defaultDensity, storageKey = THEME_COOKIE, palettes, initialTheme, initialDensity }) {
+    var _ref, _ref1;
     var _themes_;
-    const initial = (_ref = defaultTheme != null ? defaultTheme : (_themes_ = themes[0]) == null ? void 0 : _themes_.id) != null ? _ref : '';
+    const initial = (_ref = (_ref1 = initialTheme != null ? initialTheme : defaultTheme) != null ? _ref1 : (_themes_ = themes[0]) == null ? void 0 : _themes_.id) != null ? _ref : '';
     const [theme, setThemeState] = useState(initial);
+    const densityKey = densityCookie(storageKey);
+    // `undefined` until a density is stored, chosen or defaulted: the document's
+    // own `data-density` stands until then.
+    const [density, setDensityState] = useState(initialDensity != null ? initialDensity : defaultDensity);
+    const preferences = useUiPreferencesState();
     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.
+    // Read the stored choice on mount, for a host that could not: a static
+    // export has no server to read the cookie, so it renders `initial` and the
+    // client corrects after mount. Reading in render would mismatch hydration.
+    // Where the server read it, `initial` already is the stored choice and this
+    // changes nothing. It only reads, so running twice changes nothing.
     useEffect(()=>{
-        const stored = window.localStorage.getItem(storageKey);
+        const stored = readCookie(storageKey);
         // eslint-disable-next-line react-hooks/set-state-in-effect -- one-shot SSR-safe hydration, see comment above
         if (isKnown(stored)) setThemeState(stored);
+        // A stored density wins; otherwise the default, otherwise whatever the
+        // document was served with, so the context never reports a density the
+        // page is not in.
+        const storedDensity = readCookie(densityKey);
+        const served = document.documentElement.dataset.density;
+        if (isDensity(storedDensity)) setDensityState(storedDensity);
+        else if (defaultDensity === undefined && isDensity(served)) {
+            setDensityState(served);
+        }
     }, [
         storageKey,
-        isKnown
+        densityKey,
+        isKnown,
+        defaultDensity
     ]);
     // 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.
@@ -47,29 +99,65 @@ const ThemeContext = /*#__PURE__*/ createContext(null);
         palettes,
         storageKey
     ]);
-    // Reflect the active theme onto the document + persist it.
+    // Reflect the active theme and density onto the document. Storage is not
+    // touched here — see the ⚠️ above.
+    //
+    // Written only when it differs: a page the server rendered in the stored
+    // theme is already right, and even a write of the same value is a change
+    // something watching the document would see.
     useEffect(()=>{
-        document.documentElement.dataset.theme = theme;
-        window.localStorage.setItem(storageKey, theme);
+        const root = document.documentElement;
+        if (root.dataset.theme !== theme) root.dataset.theme = theme;
     }, [
-        theme,
-        storageKey
+        theme
+    ]);
+    useEffect(()=>{
+        const root = document.documentElement;
+        if (density !== undefined && root.dataset.density !== density) root.dataset.density = density;
+    }, [
+        density
+    ]);
+    // The cookie is what the next page is rendered in; the UI-preferences port
+    // gets a copy, so a host that keeps preferences server-side has them too.
+    const remember = useCallback((cookie, key, value)=>{
+        writeCookie(cookie, value);
+        void Effect.runPromise(preferences.write(key, value)).catch(()=>undefined);
+    }, [
+        preferences
+    ]);
+    const setTheme = useCallback((next)=>{
+        setThemeState(next);
+        remember(storageKey, 'theme', next);
+    }, [
+        storageKey,
+        remember
+    ]);
+    const setDensity = useCallback((next)=>{
+        setDensityState(next);
+        remember(densityKey, 'density', next);
+    }, [
+        densityKey,
+        remember
     ]);
-    const setTheme = useCallback((next)=>setThemeState(next), []);
     const value = useMemo(()=>({
             theme,
             setTheme,
-            themes
+            themes,
+            density: density != null ? density : 'comfortable',
+            setDensity
         }), [
         theme,
         setTheme,
-        themes
+        themes,
+        density,
+        setDensity
     ]);
     return /*#__PURE__*/ _jsx(ThemeContext.Provider, {
         value: value,
         children: children
     });
 }
+/** The theme context, or `null` outside a {@link ThemeProvider}. */ export const useOptionalTheme = ()=>useContext(ThemeContext);
 export function useTheme() {
     const ctx = useContext(ThemeContext);
     if (!ctx) throw new Error('useTheme must be used within a ThemeProvider');

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

@@ -1 +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"}
+{"version":3,"sources":["../../src/theme/theme-context.tsx"],"sourcesContent":["'use client';\n\nimport { Effect } from 'effect';\nimport {\n  createContext,\n  type PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\n\nimport { useUiPreferencesState } from '../preferences/ui-preferences-context.js';\nimport { densityCookie, THEME_COOKIE } from './theme-cookie.js';\nimport type {\n  Density,\n  ThemeContextValue,\n  ThemeOption,\n  ThemePalette,\n} 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  /**\n   * The density when nothing is stored. Omitted, the provider leaves\n   * `data-density` as the document has it until a density is chosen.\n   */\n  defaultDensity?: Density;\n  /**\n   * The cookie the theme is kept in — namespace it per app so apps don't\n   * clobber each other. The density is kept beside it, under\n   * `${storageKey}-density`. A cookie rather than local storage, so a server\n   * can read the choice and render `data-theme` and `data-density` with the\n   * page: no paint in the wrong palette before a script corrects it.\n   */\n  storageKey?: string;\n  /**\n   * The theme and density the server read from those cookies and rendered\n   * the page in (`readThemeCookies` in `@entifix/next-shell/server`). Given,\n   * the provider starts there and nothing changes after the page loads.\n   */\n  initialTheme?: string;\n  initialDensity?: Density;\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\nconst DENSITIES: readonly Density[] = ['comfortable', 'compact'];\n\nconst isDensity = (value: unknown): value is Density =>\n  DENSITIES.includes(value as Density);\n\n/** Storage that may be absent or refuse (a private window, blocked site data). */\n/** A year: a preference outlives a session. */\nconst COOKIE_MAX_AGE = 60 * 60 * 24 * 365;\n\n/** A first-party cookie's value, or `null` when it is not set. */\nfunction readCookie(name: string): string | null {\n  try {\n    for (const pair of document.cookie.split('; ')) {\n      const at = pair.indexOf('=');\n      if (pair.slice(0, at) === name)\n        return decodeURIComponent(pair.slice(at + 1));\n    }\n  } catch {\n    // A sandboxed document refuses cookies; nothing was stored, then.\n  }\n  return null;\n}\n\nfunction writeCookie(name: string, value: string) {\n  try {\n    document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${COOKIE_MAX_AGE}; samesite=lax`;\n  } catch {\n    // Nothing to remember it in; the choice still applies to this page.\n  }\n}\n\n/**\n * Applies the active palette and density by writing `data-theme` and\n * `data-density` on <html>, and remembers what the user chooses. Static palette\n * VALUES live in CSS (@entifix/style presets or an app-local themes.css); this\n * flips the selector. Dynamic palettes passed via `palettes` are injected at\n * runtime under the same `data-theme` mechanism.\n *\n * ⚠️ **Only a choice is written to storage, never a default.** The provider\n * used to persist whatever theme it held from an effect, and under StrictMode\n * the effect ran before the stored value had been read back: the default\n * overwrote the stored theme, and a reload in development always came back on\n * the default. Writing in `setTheme` and `setDensity` alone means mounting,\n * however many times, can never lose what was chosen.\n */\nexport function ThemeProvider({\n  children,\n  themes,\n  defaultTheme,\n  defaultDensity,\n  storageKey = THEME_COOKIE,\n  palettes,\n  initialTheme,\n  initialDensity,\n}: ThemeProviderProps) {\n  const initial = initialTheme ?? defaultTheme ?? themes[0]?.id ?? '';\n  const [theme, setThemeState] = useState<string>(initial);\n  const densityKey = densityCookie(storageKey);\n  // `undefined` until a density is stored, chosen or defaulted: the document's\n  // own `data-density` stands until then.\n  const [density, setDensityState] = useState<Density | undefined>(\n    initialDensity ?? defaultDensity,\n  );\n  const preferences = useUiPreferencesState();\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  // Read the stored choice on mount, for a host that could not: a static\n  // export has no server to read the cookie, so it renders `initial` and the\n  // client corrects after mount. Reading in render would mismatch hydration.\n  // Where the server read it, `initial` already is the stored choice and this\n  // changes nothing. It only reads, so running twice changes nothing.\n  useEffect(() => {\n    const stored = readCookie(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    // A stored density wins; otherwise the default, otherwise whatever the\n    // document was served with, so the context never reports a density the\n    // page is not in.\n    const storedDensity = readCookie(densityKey);\n    const served = document.documentElement.dataset.density;\n    if (isDensity(storedDensity)) setDensityState(storedDensity);\n    else if (defaultDensity === undefined && isDensity(served)) {\n      setDensityState(served);\n    }\n  }, [storageKey, densityKey, isKnown, defaultDensity]);\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 and density onto the document. Storage is not\n  // touched here — see the ⚠️ above.\n  //\n  // Written only when it differs: a page the server rendered in the stored\n  // theme is already right, and even a write of the same value is a change\n  // something watching the document would see.\n  useEffect(() => {\n    const root = document.documentElement;\n    if (root.dataset.theme !== theme) root.dataset.theme = theme;\n  }, [theme]);\n  useEffect(() => {\n    const root = document.documentElement;\n    if (density !== undefined && root.dataset.density !== density)\n      root.dataset.density = density;\n  }, [density]);\n\n  // The cookie is what the next page is rendered in; the UI-preferences port\n  // gets a copy, so a host that keeps preferences server-side has them too.\n  const remember = useCallback(\n    (cookie: string, key: 'theme' | 'density', value: string) => {\n      writeCookie(cookie, value);\n      void Effect.runPromise(preferences.write(key, value)).catch(\n        () => undefined,\n      );\n    },\n    [preferences],\n  );\n  const setTheme = useCallback(\n    (next: string) => {\n      setThemeState(next);\n      remember(storageKey, 'theme', next);\n    },\n    [storageKey, remember],\n  );\n  const setDensity = useCallback(\n    (next: Density) => {\n      setDensityState(next);\n      remember(densityKey, 'density', next);\n    },\n    [densityKey, remember],\n  );\n\n  const value = useMemo<ThemeContextValue>(\n    () => ({\n      theme,\n      setTheme,\n      themes,\n      density: density ?? 'comfortable',\n      setDensity,\n    }),\n    [theme, setTheme, themes, density, setDensity],\n  );\n\n  return (\n    <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>\n  );\n}\n\n/** The theme context, or `null` outside a {@link ThemeProvider}. */\nexport const useOptionalTheme = (): ThemeContextValue | null =>\n  useContext(ThemeContext);\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":["Effect","createContext","useCallback","useContext","useEffect","useMemo","useState","useUiPreferencesState","densityCookie","THEME_COOKIE","ThemeContext","DENSITIES","isDensity","value","includes","COOKIE_MAX_AGE","readCookie","name","pair","document","cookie","split","at","indexOf","slice","decodeURIComponent","writeCookie","encodeURIComponent","ThemeProvider","children","themes","defaultTheme","defaultDensity","storageKey","palettes","initialTheme","initialDensity","initial","id","theme","setThemeState","densityKey","density","setDensityState","preferences","isKnown","some","t","stored","storedDensity","served","documentElement","dataset","undefined","Object","keys","length","styleId","css","entries","map","palette","decls","token","join","el","getElementById","createElement","head","appendChild","textContent","root","remember","key","runPromise","write","catch","setTheme","next","setDensity","Provider","useOptionalTheme","useTheme","ctx","Error"],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+/**
+ * The cookie a theme is kept in unless a provider names another; the density
+ * is kept beside it, under `${name}-density`. Server-safe, so a layout and the
+ * inline script can name it without a client boundary.
+ */
+export declare const THEME_COOKIE = "entifix-theme";
+/** The density's cookie, beside the theme's. */
+export declare const densityCookie: (themeCookie: string) => string;
+//# sourceMappingURL=theme-cookie.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-cookie.d.ts","sourceRoot":"","sources":["../../src/theme/theme-cookie.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,gDAAgD;AAChD,eAAO,MAAM,aAAa,GAAI,aAAa,MAAM,KAAG,MAC1B,CAAC"}

package/dist/theme/theme-cookie.js

@@ -0,0 +1,8 @@
+/**
+ * The cookie a theme is kept in unless a provider names another; the density
+ * is kept beside it, under `${name}-density`. Server-safe, so a layout and the
+ * inline script can name it without a client boundary.
+ */ export const THEME_COOKIE = 'entifix-theme';
+/** The density's cookie, beside the theme's. */ export const densityCookie = (themeCookie)=>`${themeCookie}-density`;
+
+//# sourceMappingURL=theme-cookie.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/theme-cookie.ts"],"sourcesContent":["/**\n * The cookie a theme is kept in unless a provider names another; the density\n * is kept beside it, under `${name}-density`. Server-safe, so a layout and the\n * inline script can name it without a client boundary.\n */\nexport const THEME_COOKIE = 'entifix-theme';\n\n/** The density's cookie, beside the theme's. */\nexport const densityCookie = (themeCookie: string): string =>\n  `${themeCookie}-density`;\n"],"names":["THEME_COOKIE","densityCookie","themeCookie"],"mappings":"AAAA;;;;CAIC,GACD,OAAO,MAAMA,eAAe,gBAAgB;AAE5C,8CAA8C,GAC9C,OAAO,MAAMC,gBAAgB,CAACC,cAC5B,GAAGA,YAAY,QAAQ,CAAC,CAAC"}

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

@@ -4,7 +4,7 @@ export interface ThemeScriptProps {
     themes: readonly ThemeOption[];
     /** Painted when nothing valid is stored; the first theme otherwise. */
     defaultTheme?: string;
-    /** The key `ThemeProvider` stores the choice under. */
+    /** The cookie `ThemeProvider` keeps the choice in. */
     storageKey?: string;
     /** For a Content-Security-Policy that allows inline scripts by nonce. */
     nonce?: string;
@@ -15,10 +15,13 @@ export interface ThemeScriptProps {
  * in <head>: it runs ahead of any stylesheet applying and long before React
  * hydrates.
  *
- * A stored choice wins; otherwise `defaultTheme`, which is then stored too:
- * `ThemeProvider` persists whatever theme it mounts with, and without a stored
- * value to read it would mount with its own default instead. A page whose
- * storage cannot be read is left unthemed, as it would be without the script.
+ * For a host with no server to read the theme cookie — a static export. One
+ * that has a server renders the attributes from `readThemeCookies` instead,
+ * and needs no script at all.
+ *
+ * The stored choice wins; otherwise `defaultTheme`. A stored density is
+ * applied the same way; with none stored the document's own `data-density`
+ * stands. Nothing is written: only a choice is ever stored.
  *
  * Render it from a server component; it ships no client code.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"theme-script.d.ts","sourceRoot":"","sources":["../../src/theme/theme-script.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,YAAY,EACZ,UAA4B,EAC5B,KAAK,GACN,EAAE,gBAAgB,+BAgBlB"}
+{"version":3,"file":"theme-script.d.ts","sourceRoot":"","sources":["../../src/theme/theme-script.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,YAAY,EACZ,UAAyB,EACzB,KAAK,GACN,EAAE,gBAAgB,+BA0BlB"}

package/dist/theme/theme-script.js

@@ -1,17 +1,21 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { THEME_COOKIE } from './theme-cookie.js';
 /**
  * Sets `data-theme` on <html> before the first paint, so a server-rendered or
  * statically exported page never flashes the wrong palette. Render it inline
  * in <head>: it runs ahead of any stylesheet applying and long before React
  * hydrates.
  *
- * A stored choice wins; otherwise `defaultTheme`, which is then stored too:
- * `ThemeProvider` persists whatever theme it mounts with, and without a stored
- * value to read it would mount with its own default instead. A page whose
- * storage cannot be read is left unthemed, as it would be without the script.
+ * For a host with no server to read the theme cookie — a static export. One
+ * that has a server renders the attributes from `readThemeCookies` instead,
+ * and needs no script at all.
+ *
+ * The stored choice wins; otherwise `defaultTheme`. A stored density is
+ * applied the same way; with none stored the document's own `data-density`
+ * stands. Nothing is written: only a choice is ever stored.
  *
  * Render it from a server component; it ships no client code.
- */ export function ThemeScript({ themes, defaultTheme, storageKey = 'entifix-theme', nonce }) {
+ */ export function ThemeScript({ themes, defaultTheme, storageKey = THEME_COOKIE, nonce }) {
     var _ref;
     const ids = themes.map((theme)=>theme.id);
     const fallback = (_ref = defaultTheme != null ? defaultTheme : ids[0]) != null ? _ref : '';
@@ -19,12 +23,22 @@ import { jsx as _jsx } from "react/jsx-runtime";
   try {
     var themes = ${JSON.stringify(ids)};
     var key = ${JSON.stringify(storageKey)};
-    var theme = window.localStorage.getItem(key);
-    if (themes.indexOf(theme) === -1) {
-      theme = ${JSON.stringify(fallback)};
-      window.localStorage.setItem(key, theme);
-    }
+    var read = function (name) {
+      var pairs = document.cookie.split('; ');
+      for (var i = 0; i < pairs.length; i++) {
+        var at = pairs[i].indexOf('=');
+        if (pairs[i].slice(0, at) === name)
+          return decodeURIComponent(pairs[i].slice(at + 1));
+      }
+      return null;
+    };
+    var theme = read(key);
+    if (themes.indexOf(theme) === -1) theme = ${JSON.stringify(fallback)};
     document.documentElement.dataset.theme = theme;
+    var density = read(key + '-density');
+    if (density === 'comfortable' || density === 'compact') {
+      document.documentElement.dataset.density = density;
+    }
   } catch (error) {}
 })();`;
     return /*#__PURE__*/ _jsx("script", {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/theme-script.tsx"],"sourcesContent":["import type { ThemeOption } from './types.js';\n\nexport interface ThemeScriptProps {\n  /** The same registry `ThemeProvider` is given. */\n  themes: readonly ThemeOption[];\n  /** Painted when nothing valid is stored; the first theme otherwise. */\n  defaultTheme?: string;\n  /** The key `ThemeProvider` stores the choice under. */\n  storageKey?: string;\n  /** For a Content-Security-Policy that allows inline scripts by nonce. */\n  nonce?: string;\n}\n\n/**\n * Sets `data-theme` on <html> before the first paint, so a server-rendered or\n * statically exported page never flashes the wrong palette. Render it inline\n * in <head>: it runs ahead of any stylesheet applying and long before React\n * hydrates.\n *\n * A stored choice wins; otherwise `defaultTheme`, which is then stored too:\n * `ThemeProvider` persists whatever theme it mounts with, and without a stored\n * value to read it would mount with its own default instead. A page whose\n * storage cannot be read is left unthemed, as it would be without the script.\n *\n * Render it from a server component; it ships no client code.\n */\nexport function ThemeScript({\n  themes,\n  defaultTheme,\n  storageKey = 'entifix-theme',\n  nonce,\n}: ThemeScriptProps) {\n  const ids = themes.map(theme => theme.id);\n  const fallback = defaultTheme ?? ids[0] ?? '';\n  const script = `(function () {\n  try {\n    var themes = ${JSON.stringify(ids)};\n    var key = ${JSON.stringify(storageKey)};\n    var theme = window.localStorage.getItem(key);\n    if (themes.indexOf(theme) === -1) {\n      theme = ${JSON.stringify(fallback)};\n      window.localStorage.setItem(key, theme);\n    }\n    document.documentElement.dataset.theme = theme;\n  } catch (error) {}\n})();`;\n  return <script nonce={nonce} dangerouslySetInnerHTML={{ __html: script }} />;\n}\n"],"names":["ThemeScript","themes","defaultTheme","storageKey","nonce","ids","map","theme","id","fallback","script","JSON","stringify","dangerouslySetInnerHTML","__html"],"mappings":";AAaA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASA,YAAY,EAC1BC,MAAM,EACNC,YAAY,EACZC,aAAa,eAAe,EAC5BC,KAAK,EACY;QAEAF;IADjB,MAAMG,MAAMJ,OAAOK,GAAG,CAACC,CAAAA,QAASA,MAAMC,EAAE;IACxC,MAAMC,YAAWP,OAAAA,uBAAAA,eAAgBG,GAAG,CAAC,EAAE,YAAtBH,OAA0B;IAC3C,MAAMQ,SAAS,CAAC;;iBAED,EAAEC,KAAKC,SAAS,CAACP,KAAK;cACzB,EAAEM,KAAKC,SAAS,CAACT,YAAY;;;cAG7B,EAAEQ,KAAKC,SAAS,CAACH,UAAU;;;;;KAKpC,CAAC;IACJ,qBAAO,KAACC;QAAON,OAAOA;QAAOS,yBAAyB;YAAEC,QAAQJ;QAAO;;AACzE"}
+{"version":3,"sources":["../../src/theme/theme-script.tsx"],"sourcesContent":["import { THEME_COOKIE } from './theme-cookie.js';\nimport type { ThemeOption } from './types.js';\n\nexport interface ThemeScriptProps {\n  /** The same registry `ThemeProvider` is given. */\n  themes: readonly ThemeOption[];\n  /** Painted when nothing valid is stored; the first theme otherwise. */\n  defaultTheme?: string;\n  /** The cookie `ThemeProvider` keeps the choice in. */\n  storageKey?: string;\n  /** For a Content-Security-Policy that allows inline scripts by nonce. */\n  nonce?: string;\n}\n\n/**\n * Sets `data-theme` on <html> before the first paint, so a server-rendered or\n * statically exported page never flashes the wrong palette. Render it inline\n * in <head>: it runs ahead of any stylesheet applying and long before React\n * hydrates.\n *\n * For a host with no server to read the theme cookie — a static export. One\n * that has a server renders the attributes from `readThemeCookies` instead,\n * and needs no script at all.\n *\n * The stored choice wins; otherwise `defaultTheme`. A stored density is\n * applied the same way; with none stored the document's own `data-density`\n * stands. Nothing is written: only a choice is ever stored.\n *\n * Render it from a server component; it ships no client code.\n */\nexport function ThemeScript({\n  themes,\n  defaultTheme,\n  storageKey = THEME_COOKIE,\n  nonce,\n}: ThemeScriptProps) {\n  const ids = themes.map(theme => theme.id);\n  const fallback = defaultTheme ?? ids[0] ?? '';\n  const script = `(function () {\n  try {\n    var themes = ${JSON.stringify(ids)};\n    var key = ${JSON.stringify(storageKey)};\n    var read = function (name) {\n      var pairs = document.cookie.split('; ');\n      for (var i = 0; i < pairs.length; i++) {\n        var at = pairs[i].indexOf('=');\n        if (pairs[i].slice(0, at) === name)\n          return decodeURIComponent(pairs[i].slice(at + 1));\n      }\n      return null;\n    };\n    var theme = read(key);\n    if (themes.indexOf(theme) === -1) theme = ${JSON.stringify(fallback)};\n    document.documentElement.dataset.theme = theme;\n    var density = read(key + '-density');\n    if (density === 'comfortable' || density === 'compact') {\n      document.documentElement.dataset.density = density;\n    }\n  } catch (error) {}\n})();`;\n  return <script nonce={nonce} dangerouslySetInnerHTML={{ __html: script }} />;\n}\n"],"names":["THEME_COOKIE","ThemeScript","themes","defaultTheme","storageKey","nonce","ids","map","theme","id","fallback","script","JSON","stringify","dangerouslySetInnerHTML","__html"],"mappings":";AAAA,SAASA,YAAY,QAAQ,oBAAoB;AAcjD;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASC,YAAY,EAC1BC,MAAM,EACNC,YAAY,EACZC,aAAaJ,YAAY,EACzBK,KAAK,EACY;QAEAF;IADjB,MAAMG,MAAMJ,OAAOK,GAAG,CAACC,CAAAA,QAASA,MAAMC,EAAE;IACxC,MAAMC,YAAWP,OAAAA,uBAAAA,eAAgBG,GAAG,CAAC,EAAE,YAAtBH,OAA0B;IAC3C,MAAMQ,SAAS,CAAC;;iBAED,EAAEC,KAAKC,SAAS,CAACP,KAAK;cACzB,EAAEM,KAAKC,SAAS,CAACT,YAAY;;;;;;;;;;;8CAWG,EAAEQ,KAAKC,SAAS,CAACH,UAAU;;;;;;;KAOpE,CAAC;IACJ,qBAAO,KAACC;QAAON,OAAOA;QAAOS,yBAAyB;YAAEC,QAAQJ;QAAO;;AACzE"}

package/dist/theme/types.d.ts

@@ -8,15 +8,31 @@ export interface ThemeOption {
 }
 /** 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';
+export type ThemeColorToken = 'surface' | 'surface-elevated' | 'content' | 'content-muted' | 'primary' | 'primary-content' | 'border' | 'border-control' | 'selected' | 'accent' | 'focus-ring' | 'danger' | 'danger-subtle' | 'danger-content' | 'success' | 'success-subtle' | 'success-content' | 'warning' | 'warning-subtle' | 'warning-content' | 'info' | 'info-subtle' | 'info-content' | 'scrim';
+/**
+ * The tokens a runtime palette must state. Each one is held to a contrast pair
+ * against the palette's own surfaces (ADR 0025), so the neutral default cannot
+ * stand in for it: a ring or a control boundary that clears 3:1 on grey may be
+ * invisible on a brand's surface. Omitting one is a type error, not a silent
+ * fallback.
+ */
+export type ThemePaletteRequiredToken = 'focus-ring' | 'border-control' | 'selected';
 /** 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>>;
+ *  brands not known at build time (multi-tenant / white-label). Hold one to
+ *  the contract with `assertPaletteContract` from `@entifix/style/testing`. */
+export type ThemePalette = Partial<Record<ThemeColorToken, string>> & Record<ThemePaletteRequiredToken, string>;
+/** How much room the UI takes: `fixed-scale.css` reads it as `data-density`. */
+export type Density = 'comfortable' | 'compact';
 export interface ThemeContextValue {
     /** Active theme id (written to `data-theme`). */
     theme: string;
+    /** Chooses a theme, and remembers the choice. */
     setTheme: (id: string) => void;
     /** The registry this provider was configured with. */
     themes: ThemeOption[];
+    /** Active density (written to `data-density`). */
+    density: Density;
+    /** Chooses a density, and remembers the choice. */
+    setDensity: (density: Density) => void;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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"}
+{"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,gBAAgB,GAChB,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,gBAAgB,GAChB,iBAAiB,GACjB,SAAS,GACT,gBAAgB,GAChB,iBAAiB,GACjB,MAAM,GACN,aAAa,GACb,cAAc,GACd,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACnC,YAAY,GAAG,gBAAgB,GAAG,UAAU,CAAC;AAE/C;;+EAE+E;AAC/E,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,GACjE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;AAE5C,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,sDAAsD;IACtD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC"}

package/dist/theme/types.js.map

@@ -1 +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"}
+{"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  | 'border-control'\n  | 'selected'\n  | 'accent'\n  | 'focus-ring'\n  | 'danger'\n  | 'danger-subtle'\n  | 'danger-content'\n  | 'success'\n  | 'success-subtle'\n  | 'success-content'\n  | 'warning'\n  | 'warning-subtle'\n  | 'warning-content'\n  | 'info'\n  | 'info-subtle'\n  | 'info-content'\n  | 'scrim';\n\n/**\n * The tokens a runtime palette must state. Each one is held to a contrast pair\n * against the palette's own surfaces (ADR 0025), so the neutral default cannot\n * stand in for it: a ring or a control boundary that clears 3:1 on grey may be\n * invisible on a brand's surface. Omitting one is a type error, not a silent\n * fallback.\n */\nexport type ThemePaletteRequiredToken =\n  'focus-ring' | 'border-control' | 'selected';\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). Hold one to\n *  the contract with `assertPaletteContract` from `@entifix/style/testing`. */\nexport type ThemePalette = Partial<Record<ThemeColorToken, string>> &\n  Record<ThemePaletteRequiredToken, string>;\n\n/** How much room the UI takes: `fixed-scale.css` reads it as `data-density`. */\nexport type Density = 'comfortable' | 'compact';\n\nexport interface ThemeContextValue {\n  /** Active theme id (written to `data-theme`). */\n  theme: string;\n  /** Chooses a theme, and remembers the choice. */\n  setTheme: (id: string) => void;\n  /** The registry this provider was configured with. */\n  themes: ThemeOption[];\n  /** Active density (written to `data-density`). */\n  density: Density;\n  /** Chooses a density, and remembers the choice. */\n  setDensity: (density: Density) => void;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAqDD,WAWC"}

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

@@ -18,7 +18,7 @@ export type ActionSurface = (typeof ACTION_SURFACES)[number];
  * 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,
+ * catalog key (`actions.more`, `actions.forRecord`) — this is only the mark,
  * and it is never read aloud.
  */
 export declare const OVERFLOW_GLYPH = "\u22EF";

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

@@ -43,7 +43,7 @@
  * 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,
+ * catalog key (`actions.more`, `actions.forRecord`) — 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) {