@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/components/data-display/chromes/field-tile-boundaries.js

@@ -0,0 +1,30 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { DisplayChromeProvider, useDisplayChromeContext } from './DisplayChromeContext.js';
+import { FieldTilesContext } from './field-tiles.utils.js';
+/** Render a tile's value as content OUTSIDE the host: nested fields neither tile nor hide by default. */
+export function FieldTileContentBoundary({ children }) {
+    const { displayChromeMode } = useDisplayChromeContext();
+    return (_jsx(FieldTilesContext.Provider, { value: false, children: _jsx(DisplayChromeProvider, { displayChromeMode: displayChromeMode, sectionChromeMode: undefined, children: children }) }));
+}
+/**
+ * A whole-row term/description group of a `<FieldTiles>` host, for a field that does not render as a
+ * tile: one that brings its own frame (an inline-editable array, a read-only array section) or one whose
+ * own chrome is not TILE at this breakpoint (a fact declaring STACKED, INLINE or HIDDEN — audit B-4).
+ * Pass-through outside the host.
+ *
+ * The `<dt>` is there because a `<dd>` with no term is invalid in the host's `<dl>`. It is visually hidden
+ * always, and hidden from assistive technology too UNLESS `termAnnounced`: a legend or a visible label
+ * inside the row already names the field and a screen reader heard the name twice (audit B-14), while a
+ * HIDDEN or COMPACT chrome shows no name at all, and there the term is the only one the value has. Its
+ * content is rendered outside the host ({@link FieldTileContentBoundary}).
+ */
+export function InFieldTilesRow({ active, name, label, termAnnounced = false, children }) {
+    if (!active)
+        return _jsx(_Fragment, { children: children });
+    return (
+    // `data-tile-row`: a whole-row group of the grid, not a tile — its name is visually hidden on purpose, so a
+    // reader of tile names (a browser lane comparing their voice) leaves it out.
+    _jsxs("div", { "data-slot": "field-chrome", "data-chrome-mode": "tile", "data-tile-row": "", "data-tile-span": "full", "data-field": name, className: "min-w-0", children: [label && _jsx("dt", { className: "sr-only", "aria-hidden": termAnnounced ? undefined : 'true', children: label }), _jsx("dd", { className: "m-0 min-w-0", children: _jsx(FieldTileContentBoundary, { children: children }) })] }));
+}
+//# sourceMappingURL=field-tile-boundaries.js.map

package/dist/esm/components/data-display/chromes/field-tile-boundaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tile-boundaries.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/chromes/field-tile-boundaries.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAeZ,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,yGAAyG;AACzG,MAAM,UAAU,wBAAwB,CAAC,EAAE,QAAQ,EAAiC;IAClF,MAAM,EAAE,iBAAiB,EAAE,GAAG,uBAAuB,EAAE,CAAA;IACvD,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACtC,KAAC,qBAAqB,IAAC,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,YACtF,QAAQ,GACa,GACG,CAC9B,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,GAAG,KAAK,EAAE,QAAQ,EAOrF;IACC,IAAI,CAAC,MAAM;QAAE,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACpC,OAAO;IACL,4GAA4G;IAC5G,6EAA6E;IAC7E,4BAAe,cAAc,sBAAkB,MAAM,mBAAe,EAAE,oBAAgB,MAAM,gBAAa,IAAI,EAAE,SAAS,EAAC,SAAS,aAC/H,KAAK,IAAI,aAAI,SAAS,EAAC,SAAS,iBAAc,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,YAAG,KAAK,GAAM,EAC/F,aAAI,SAAS,EAAC,aAAa,YAAC,KAAC,wBAAwB,cAAE,QAAQ,GAA4B,GAAK,IAC5F,CACP,CAAC;AACJ,CAAC","sourcesContent":["\"use client\"\n\n/**\n * The two places a `<FieldTiles>` host ENDS. Internal to the display layer — not part of the package's\n * public surface: an application places fields in a host; it never draws a host's boundary itself.\n *\n * A host gives its direct fields TILE chrome and the empty-fact default through context, and context\n * reaches every descendant. Without a boundary, the values a tile renders — an array's items, an object\n * value's members, a relationship shown in place — became tiles of their own: a `<dd>` inside a `<dd>`,\n * a `<dt>`/`<dd>` with no `<dl>`, array items as nameless tiles, and empty nested members silently\n * dropped (audit B-1, reproduced in jsdom 2026-10-01: `['a','b']` drew three tiles). A tile's CONTENT is\n * therefore rendered outside the host: no tile context, no section chrome, the record's display chrome\n * kept.\n */\nimport * as React from \"react\"\nimport { DisplayChromeProvider, useDisplayChromeContext } from './DisplayChromeContext'\nimport { FieldTilesContext } from './field-tiles.utils'\n\n/** Render a tile's value as content OUTSIDE the host: nested fields neither tile nor hide by default. */\nexport function FieldTileContentBoundary({ children }: { children: React.ReactNode }): React.JSX.Element {\n  const { displayChromeMode } = useDisplayChromeContext()\n  return (\n    <FieldTilesContext.Provider value={false}>\n      <DisplayChromeProvider displayChromeMode={displayChromeMode} sectionChromeMode={undefined}>\n        {children}\n      </DisplayChromeProvider>\n    </FieldTilesContext.Provider>\n  )\n}\n\n/**\n * A whole-row term/description group of a `<FieldTiles>` host, for a field that does not render as a\n * tile: one that brings its own frame (an inline-editable array, a read-only array section) or one whose\n * own chrome is not TILE at this breakpoint (a fact declaring STACKED, INLINE or HIDDEN — audit B-4).\n * Pass-through outside the host.\n *\n * The `<dt>` is there because a `<dd>` with no term is invalid in the host's `<dl>`. It is visually hidden\n * always, and hidden from assistive technology too UNLESS `termAnnounced`: a legend or a visible label\n * inside the row already names the field and a screen reader heard the name twice (audit B-14), while a\n * HIDDEN or COMPACT chrome shows no name at all, and there the term is the only one the value has. Its\n * content is rendered outside the host ({@link FieldTileContentBoundary}).\n */\nexport function InFieldTilesRow({ active, name, label, termAnnounced = false, children }: {\n  active: boolean;\n  name: string | undefined;\n  label: string | undefined;\n  /** The row's content shows no name of its own, so the term is announced (still visually hidden). */\n  termAnnounced?: boolean;\n  children: React.ReactNode;\n}): React.JSX.Element {\n  if (!active) return <>{children}</>;\n  return (\n    // `data-tile-row`: a whole-row group of the grid, not a tile — its name is visually hidden on purpose, so a\n    // reader of tile names (a browser lane comparing their voice) leaves it out.\n    <div data-slot=\"field-chrome\" data-chrome-mode=\"tile\" data-tile-row=\"\" data-tile-span=\"full\" data-field={name} className=\"min-w-0\">\n      {label && <dt className=\"sr-only\" aria-hidden={termAnnounced ? undefined : 'true'}>{label}</dt>}\n      <dd className=\"m-0 min-w-0\"><FieldTileContentBoundary>{children}</FieldTileContentBoundary></dd>\n    </div>\n  );\n}\n"]}

package/dist/esm/components/data-display/chromes/field-tiles.utils.d.ts

@@ -0,0 +1,22 @@
+import { FieldSchemaType } from '@wildo-ai/zod-decorators';
+/**
+ * Whether the field sits inside a `<FieldTiles>` host — which renders a `<dl>`, so a TILE chrome
+ * inside it names its value with `<dt>`/`<dd>` and a screen reader hears the pair as a term and its
+ * description. A TILE chrome outside a host keeps plain elements: it has no list to belong to.
+ */
+export declare const FieldTilesContext: import("react").Context<boolean>;
+export declare function useInFieldTiles(): boolean;
+/**
+ * Whether a value takes a whole row of a `<FieldTiles>` grid rather than one tile.
+ *
+ * Derived from what the value IS, so an author never lists which fields are wide: a list of tags, an
+ * address, a file card, a paragraph of markdown or a reference shown as the referenced record's summary
+ * CARD each needs the width, and a date, a number, a status or a name does not. Total over the
+ * vocabulary by construction — a schema type not named above is one short value, which is the safe
+ * default (a narrow tile wraps; it never clips).
+ *
+ * @param foreignKeyDisplayMode - the field's FK display mode when it is a foreign key
+ *   (`getForeignKeyUIDisplay(schema)?.mode`): a SUMMARY reference renders a card, which a 9rem tile squeezed.
+ */
+export declare function isWideDisplayValue(schemaType: FieldSchemaType | undefined, stringDisplayMode: string | undefined, foreignKeyDisplayMode?: string): boolean;
+//# sourceMappingURL=field-tiles.utils.d.ts.map

package/dist/esm/components/data-display/chromes/field-tiles.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tiles.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/chromes/field-tiles.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAA4C,MAAM,0BAA0B,CAAA;AAEpG;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kCAAgC,CAAA;AAE9D,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAKT"}

package/dist/esm/components/data-display/chromes/field-tiles.utils.js

@@ -0,0 +1,52 @@
+import { createContext, useContext } from 'react';
+import { FieldSchemaType, ForeignKeyDisplayMode, StringDisplayMode } from '@wildo-ai/zod-decorators';
+/**
+ * Whether the field sits inside a `<FieldTiles>` host — which renders a `<dl>`, so a TILE chrome
+ * inside it names its value with `<dt>`/`<dd>` and a screen reader hears the pair as a term and its
+ * description. A TILE chrome outside a host keeps plain elements: it has no list to belong to.
+ */
+export const FieldTilesContext = createContext(false);
+export function useInFieldTiles() {
+    return useContext(FieldTilesContext);
+}
+/** Value shapes that need a whole row of the tile grid: they are read as content, not scanned as one fact. */
+const WIDE_SCHEMA_TYPES = new Set([
+    FieldSchemaType.ARRAY,
+    FieldSchemaType.SET,
+    FieldSchemaType.TUPLE,
+    FieldSchemaType.RECORD,
+    FieldSchemaType.MAP,
+    FieldSchemaType.OBJECT,
+    FieldSchemaType.VERSIONED_OBJECT,
+    FieldSchemaType.CODE,
+    FieldSchemaType.FILE,
+    FieldSchemaType.ADDRESS,
+]);
+/** String phrasings that are prose or markup rather than one short value. */
+const WIDE_STRING_DISPLAY_MODES = new Set([
+    StringDisplayMode.MULTILINE,
+    StringDisplayMode.MARKDOWN,
+    StringDisplayMode.UNTRUSTED_HTML,
+]);
+/**
+ * Whether a value takes a whole row of a `<FieldTiles>` grid rather than one tile.
+ *
+ * Derived from what the value IS, so an author never lists which fields are wide: a list of tags, an
+ * address, a file card, a paragraph of markdown or a reference shown as the referenced record's summary
+ * CARD each needs the width, and a date, a number, a status or a name does not. Total over the
+ * vocabulary by construction — a schema type not named above is one short value, which is the safe
+ * default (a narrow tile wraps; it never clips).
+ *
+ * @param foreignKeyDisplayMode - the field's FK display mode when it is a foreign key
+ *   (`getForeignKeyUIDisplay(schema)?.mode`): a SUMMARY reference renders a card, which a 9rem tile squeezed.
+ */
+export function isWideDisplayValue(schemaType, stringDisplayMode, foreignKeyDisplayMode) {
+    if (foreignKeyDisplayMode === ForeignKeyDisplayMode.SUMMARY)
+        return true;
+    if (!schemaType)
+        return false;
+    if (WIDE_SCHEMA_TYPES.has(schemaType))
+        return true;
+    return schemaType === FieldSchemaType.STRING && !!stringDisplayMode && WIDE_STRING_DISPLAY_MODES.has(stringDisplayMode);
+}
+//# sourceMappingURL=field-tiles.utils.js.map

package/dist/esm/components/data-display/chromes/field-tiles.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tiles.utils.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/chromes/field-tiles.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAU,KAAK,CAAC,CAAA;AAE9D,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAA;AACtC,CAAC;AAED,8GAA8G;AAC9G,MAAM,iBAAiB,GAAiC,IAAI,GAAG,CAAC;IAC9D,eAAe,CAAC,KAAK;IACrB,eAAe,CAAC,GAAG;IACnB,eAAe,CAAC,KAAK;IACrB,eAAe,CAAC,MAAM;IACtB,eAAe,CAAC,GAAG;IACnB,eAAe,CAAC,MAAM;IACtB,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,IAAI;IACpB,eAAe,CAAC,IAAI;IACpB,eAAe,CAAC,OAAO;CACxB,CAAC,CAAA;AAEF,6EAA6E;AAC7E,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC;IAC7D,iBAAiB,CAAC,SAAS;IAC3B,iBAAiB,CAAC,QAAQ;IAC1B,iBAAiB,CAAC,cAAc;CACjC,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAuC,EACvC,iBAAqC,EACrC,qBAA8B;IAE9B,IAAI,qBAAqB,KAAK,qBAAqB,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACxE,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7B,IAAI,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAA;IAClD,OAAO,UAAU,KAAK,eAAe,CAAC,MAAM,IAAI,CAAC,CAAC,iBAAiB,IAAI,yBAAyB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AACzH,CAAC","sourcesContent":["import { createContext, useContext } from 'react'\nimport { FieldSchemaType, ForeignKeyDisplayMode, StringDisplayMode } from '@wildo-ai/zod-decorators'\n\n/**\n * Whether the field sits inside a `<FieldTiles>` host — which renders a `<dl>`, so a TILE chrome\n * inside it names its value with `<dt>`/`<dd>` and a screen reader hears the pair as a term and its\n * description. A TILE chrome outside a host keeps plain elements: it has no list to belong to.\n */\nexport const FieldTilesContext = createContext<boolean>(false)\n\nexport function useInFieldTiles(): boolean {\n  return useContext(FieldTilesContext)\n}\n\n/** Value shapes that need a whole row of the tile grid: they are read as content, not scanned as one fact. */\nconst WIDE_SCHEMA_TYPES: ReadonlySet<FieldSchemaType> = new Set([\n  FieldSchemaType.ARRAY,\n  FieldSchemaType.SET,\n  FieldSchemaType.TUPLE,\n  FieldSchemaType.RECORD,\n  FieldSchemaType.MAP,\n  FieldSchemaType.OBJECT,\n  FieldSchemaType.VERSIONED_OBJECT,\n  FieldSchemaType.CODE,\n  FieldSchemaType.FILE,\n  FieldSchemaType.ADDRESS,\n])\n\n/** String phrasings that are prose or markup rather than one short value. */\nconst WIDE_STRING_DISPLAY_MODES: ReadonlySet<string> = new Set([\n  StringDisplayMode.MULTILINE,\n  StringDisplayMode.MARKDOWN,\n  StringDisplayMode.UNTRUSTED_HTML,\n])\n\n/**\n * Whether a value takes a whole row of a `<FieldTiles>` grid rather than one tile.\n *\n * Derived from what the value IS, so an author never lists which fields are wide: a list of tags, an\n * address, a file card, a paragraph of markdown or a reference shown as the referenced record's summary\n * CARD each needs the width, and a date, a number, a status or a name does not. Total over the\n * vocabulary by construction — a schema type not named above is one short value, which is the safe\n * default (a narrow tile wraps; it never clips).\n *\n * @param foreignKeyDisplayMode - the field's FK display mode when it is a foreign key\n *   (`getForeignKeyUIDisplay(schema)?.mode`): a SUMMARY reference renders a card, which a 9rem tile squeezed.\n */\nexport function isWideDisplayValue(\n  schemaType: FieldSchemaType | undefined,\n  stringDisplayMode: string | undefined,\n  foreignKeyDisplayMode?: string,\n): boolean {\n  if (foreignKeyDisplayMode === ForeignKeyDisplayMode.SUMMARY) return true\n  if (!schemaType) return false\n  if (WIDE_SCHEMA_TYPES.has(schemaType)) return true\n  return schemaType === FieldSchemaType.STRING && !!stringDisplayMode && WIDE_STRING_DISPLAY_MODES.has(stringDisplayMode)\n}\n"]}

package/dist/esm/components/data-display/display-field-resolved-props.d.ts

@@ -67,5 +67,9 @@ export interface DisplayFieldResolvedProps {
     resolvedEmptyValue?: AutoEmptyValue;
     /** File upload endpoints from ResourceDisplayContext. */
     fileUploadContext?: Record<string, FileFieldEndpoints>;
+    /** The value is wide (list, object, file, long text) — a TILE chrome spans its grid row. See `isWideDisplayValue`. */
+    wideValue?: boolean;
+    /** Name the value for assistive technology when the chrome shows no name — set on SUMMARY surfaces. */
+    announceName?: boolean;
 }
 //# sourceMappingURL=display-field-resolved-props.d.ts.map

package/dist/esm/components/data-display/display-field-resolved-props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-resolved-props.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACxI,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8DAA8D,CAAC;AAE3G,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,eAAe,CAAC;IAC5B,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;6GACyG;IACzG,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,mGAAmG;IACnG,kBAAkB,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACxD,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACvC,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACxD"}
+{"version":3,"file":"display-field-resolved-props.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACxI,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8DAA8D,CAAC;AAE3G,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,eAAe,CAAC;IAC5B,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;6GACyG;IACzG,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,mGAAmG;IACnG,kBAAkB,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACxD,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACvC,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvD,sHAAsH;IACtH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uGAAuG;IACvG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/esm/components/data-display/display-field-resolved-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-resolved-props.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Shared resolved props interface for DisplayFieldReadOnly and DisplayFieldEditable.\n *\n * These props are resolved by the DisplayField gate component from explicit props\n * and DisplayTemplateContext, then passed to the appropriate child component.\n * All context resolution happens in the gate — children receive concrete values.\n */\n\nimport type React from 'react';\nimport type { z } from 'zod';\nimport type { FieldSchemaType, FileFieldEndpoints, DisplayFieldComponent as DisplayFieldComponentEnum } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, DisplayLabelStyle, ResponsiveAware } from '@wildo-ai/zod-decorators';\nimport type { AutoEmptyValue, AutoLabelPlacement } from '@wildo-ai/presets-components-models';\nimport type { DisplayResourceLinkTrail } from './display-resource-link-trail';\nimport type { DisplayFieldProvenance } from './external-data-provenance/external-data-provenance.frontend';\n\nexport interface DisplayFieldResolvedProps {\n  /** Resolved Zod schema — gate guarantees this is defined. */\n  schema: z.ZodTypeAny;\n  /** Resolved schema type — gate guarantees this is defined. */\n  schemaType: FieldSchemaType;\n  /** Field value — may be undefined for null/missing fields. */\n  value: unknown;\n  /** Fully-qualified field name (with pathPrefix applied). */\n  fieldName?: string;\n  /** Resolved label from props or context. */\n  label?: string;\n  /** Resolved description from props or context. */\n  description?: string;\n  /** Resolved tooltip from props or context. */\n  tooltip?: string;\n  /**\n   * The provenance of a field an external-data pipeline writes (#1997) — the instance and the last completed pass,\n   * resolved by the gate; absent for every other field. The chrome places it and suppresses it in its bare-value modes.\n   */\n  provenance?: DisplayFieldProvenance;\n  /** Resolved enum labels from props or context. */\n  enumLabels?: Record<string, string>;\n  /** Display component override from decorator. */\n  displayComponent?: DisplayFieldComponentEnum;\n  /** Parent data object for FK sibling extraction (REL-02). */\n  parentData?: Record<string, unknown>;\n  /** Resource-link trail — how many relationship objects were expanded to reach this subtree, and\n   * which resource it now belongs to. Absent at the display root. See `display-resource-link-trail.ts`. */\n  resourceLinkTrail?: DisplayResourceLinkTrail;\n  /**\n   * Per-item TEMPLATE for an ARRAY field, authored through `DisplayFieldArray.renderItem`.\n   *\n   * Receives the item's path AS THIS SURFACE ADDRESSES IT — on a read surface that is the display\n   * path (`icps[0]`), which is what a nested `<DisplayField name=…>` resolves against. The\n   * inline-editable path passes the array's LOCAL FORM path instead (`checklist.0`), because that\n   * is what its autosave bindings resolve against. Same prop, two path shapes, because the two\n   * surfaces genuinely address differently — see `DisplayFieldArray`.\n   */\n  renderItem?: (itemPath: string, itemSchema: z.ZodTypeAny) => React.ReactNode;\n  /** CSS class name. */\n  className?: string;\n  /** Whether label is hidden. */\n  hideLabel: boolean;\n  /** Whether description is hidden. */\n  hideDescription: boolean;\n  /** Resolved chrome mode (field decorator → section default → display default → surface policy). */\n  resolvedChromeMode?: ResponsiveAware<DisplayChromeMode>;\n  /** Resolved label placement from explicit prop or surface policy. */\n  resolvedLabelPlacement?: AutoLabelPlacement;\n  /** Resolved label style (decorator `display.labelStyle` or an explicit template override). */\n  resolvedLabelStyle?: DisplayLabelStyle;\n  /** Resolved empty-value strategy from surface policy. */\n  resolvedEmptyValue?: AutoEmptyValue;\n  /** File upload endpoints from ResourceDisplayContext. */\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n}\n"]}
+{"version":3,"file":"display-field-resolved-props.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Shared resolved props interface for DisplayFieldReadOnly and DisplayFieldEditable.\n *\n * These props are resolved by the DisplayField gate component from explicit props\n * and DisplayTemplateContext, then passed to the appropriate child component.\n * All context resolution happens in the gate — children receive concrete values.\n */\n\nimport type React from 'react';\nimport type { z } from 'zod';\nimport type { FieldSchemaType, FileFieldEndpoints, DisplayFieldComponent as DisplayFieldComponentEnum } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, DisplayLabelStyle, ResponsiveAware } from '@wildo-ai/zod-decorators';\nimport type { AutoEmptyValue, AutoLabelPlacement } from '@wildo-ai/presets-components-models';\nimport type { DisplayResourceLinkTrail } from './display-resource-link-trail';\nimport type { DisplayFieldProvenance } from './external-data-provenance/external-data-provenance.frontend';\n\nexport interface DisplayFieldResolvedProps {\n  /** Resolved Zod schema — gate guarantees this is defined. */\n  schema: z.ZodTypeAny;\n  /** Resolved schema type — gate guarantees this is defined. */\n  schemaType: FieldSchemaType;\n  /** Field value — may be undefined for null/missing fields. */\n  value: unknown;\n  /** Fully-qualified field name (with pathPrefix applied). */\n  fieldName?: string;\n  /** Resolved label from props or context. */\n  label?: string;\n  /** Resolved description from props or context. */\n  description?: string;\n  /** Resolved tooltip from props or context. */\n  tooltip?: string;\n  /**\n   * The provenance of a field an external-data pipeline writes (#1997) — the instance and the last completed pass,\n   * resolved by the gate; absent for every other field. The chrome places it and suppresses it in its bare-value modes.\n   */\n  provenance?: DisplayFieldProvenance;\n  /** Resolved enum labels from props or context. */\n  enumLabels?: Record<string, string>;\n  /** Display component override from decorator. */\n  displayComponent?: DisplayFieldComponentEnum;\n  /** Parent data object for FK sibling extraction (REL-02). */\n  parentData?: Record<string, unknown>;\n  /** Resource-link trail — how many relationship objects were expanded to reach this subtree, and\n   * which resource it now belongs to. Absent at the display root. See `display-resource-link-trail.ts`. */\n  resourceLinkTrail?: DisplayResourceLinkTrail;\n  /**\n   * Per-item TEMPLATE for an ARRAY field, authored through `DisplayFieldArray.renderItem`.\n   *\n   * Receives the item's path AS THIS SURFACE ADDRESSES IT — on a read surface that is the display\n   * path (`icps[0]`), which is what a nested `<DisplayField name=…>` resolves against. The\n   * inline-editable path passes the array's LOCAL FORM path instead (`checklist.0`), because that\n   * is what its autosave bindings resolve against. Same prop, two path shapes, because the two\n   * surfaces genuinely address differently — see `DisplayFieldArray`.\n   */\n  renderItem?: (itemPath: string, itemSchema: z.ZodTypeAny) => React.ReactNode;\n  /** CSS class name. */\n  className?: string;\n  /** Whether label is hidden. */\n  hideLabel: boolean;\n  /** Whether description is hidden. */\n  hideDescription: boolean;\n  /** Resolved chrome mode (field decorator → section default → display default → surface policy). */\n  resolvedChromeMode?: ResponsiveAware<DisplayChromeMode>;\n  /** Resolved label placement from explicit prop or surface policy. */\n  resolvedLabelPlacement?: AutoLabelPlacement;\n  /** Resolved label style (decorator `display.labelStyle` or an explicit template override). */\n  resolvedLabelStyle?: DisplayLabelStyle;\n  /** Resolved empty-value strategy from surface policy. */\n  resolvedEmptyValue?: AutoEmptyValue;\n  /** File upload endpoints from ResourceDisplayContext. */\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n  /** The value is wide (list, object, file, long text) — a TILE chrome spans its grid row. See `isWideDisplayValue`. */\n  wideValue?: boolean;\n  /** Name the value for assistive technology when the chrome shows no name — set on SUMMARY surfaces. */\n  announceName?: boolean;\n}\n"]}

package/dist/esm/components/data-display/display-layout-template.utils.d.ts

@@ -0,0 +1,18 @@
+import type { z } from 'zod';
+import type { DisplayChromeMode, ResponsiveAware } from '@wildo-ai/zod-decorators';
+import type { LayoutTemplate } from '../../core/resources/resources.frontend.schemas';
+/**
+ * The template a resource's READ display renders, in priority order: the layout's authored
+ * `layout.display`, else one generated from the display schema, else none (no schema to read).
+ *
+ * The generated one lays the record's facts out as tiles ONLY when the layout declares no display
+ * chrome of its own (`layout.defaultChromeMode.display`): a declared chrome is the author's statement of
+ * how every field reads, and a tile grid would outrank it. Pulled out of `ResourceAutomaticDisplayer`
+ * so that wiring — the one place `factsAsTiles` is decided — has a test (audit B-16).
+ */
+export declare function resolveDisplayLayoutTemplate(input: {
+    explicitTemplate: LayoutTemplate | undefined;
+    displaySchema: z.ZodTypeAny | undefined;
+    defaultDisplayChromeMode: ResponsiveAware<DisplayChromeMode> | undefined;
+}): LayoutTemplate | null;
+//# sourceMappingURL=display-layout-template.utils.d.ts.map

package/dist/esm/components/data-display/display-layout-template.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-layout-template.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/display-layout-template.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AAGpG;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,gBAAgB,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,aAAa,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC;IACxC,wBAAwB,EAAE,eAAe,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;CAC1E,GAAG,cAAc,GAAG,IAAI,CAIxB"}

package/dist/esm/components/data-display/display-layout-template.utils.js

@@ -0,0 +1,18 @@
+import { generateDefaultDisplayTemplate } from '../../core/automated-layout/default-layout-generator.frontend.utils.js';
+/**
+ * The template a resource's READ display renders, in priority order: the layout's authored
+ * `layout.display`, else one generated from the display schema, else none (no schema to read).
+ *
+ * The generated one lays the record's facts out as tiles ONLY when the layout declares no display
+ * chrome of its own (`layout.defaultChromeMode.display`): a declared chrome is the author's statement of
+ * how every field reads, and a tile grid would outrank it. Pulled out of `ResourceAutomaticDisplayer`
+ * so that wiring — the one place `factsAsTiles` is decided — has a test (audit B-16).
+ */
+export function resolveDisplayLayoutTemplate(input) {
+    if (input.explicitTemplate)
+        return input.explicitTemplate;
+    if (!input.displaySchema)
+        return null;
+    return generateDefaultDisplayTemplate(input.displaySchema, { factsAsTiles: input.defaultDisplayChromeMode === undefined });
+}
+//# sourceMappingURL=display-layout-template.utils.js.map

package/dist/esm/components/data-display/display-layout-template.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-layout-template.utils.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-layout-template.utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mFAAmF,CAAC;AAEnI;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAI5C;IACC,IAAI,KAAK,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC,gBAAgB,CAAC;IAC1D,IAAI,CAAC,KAAK,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,8BAA8B,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC,CAAC;AAC7H,CAAC","sourcesContent":["import type { z } from 'zod';\nimport type { DisplayChromeMode, ResponsiveAware } from '@wildo-ai/zod-decorators';\nimport type { LayoutTemplate } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { generateDefaultDisplayTemplate } from '~wildo-frontend-lib/core/automated-layout/default-layout-generator.frontend.utils';\n\n/**\n * The template a resource's READ display renders, in priority order: the layout's authored\n * `layout.display`, else one generated from the display schema, else none (no schema to read).\n *\n * The generated one lays the record's facts out as tiles ONLY when the layout declares no display\n * chrome of its own (`layout.defaultChromeMode.display`): a declared chrome is the author's statement of\n * how every field reads, and a tile grid would outrank it. Pulled out of `ResourceAutomaticDisplayer`\n * so that wiring — the one place `factsAsTiles` is decided — has a test (audit B-16).\n */\nexport function resolveDisplayLayoutTemplate(input: {\n  explicitTemplate: LayoutTemplate | undefined;\n  displaySchema: z.ZodTypeAny | undefined;\n  defaultDisplayChromeMode: ResponsiveAware<DisplayChromeMode> | undefined;\n}): LayoutTemplate | null {\n  if (input.explicitTemplate) return input.explicitTemplate;\n  if (!input.displaySchema) return null;\n  return generateDefaultDisplayTemplate(input.displaySchema, { factsAsTiles: input.defaultDisplayChromeMode === undefined });\n}\n"]}

package/dist/esm/components/data-display/display-value-emptiness.utils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * One emptiness predicate for every read surface: `display.hideWhenEmpty`, the `<FieldTiles>` default,
+ * and the summaries (`isPresentSummaryValue`). Two predicates for one concept disagreed on `'  '` and
+ * `{}` (audit B-9, 2026-10-01), so a card drew a "—" cell for a value the record view hid.
+ */
+/**
+ * Emptiness test for the field-level `display.hideWhenEmpty` mechanism.
+ *
+ * A value counts as empty when it is null / undefined, an empty (or
+ * whitespace-only) string, an empty array, or a PLAIN OBJECT with no own
+ * enumerable keys. Every other value — including `false` and `0`, which are
+ * answers rather than absences — is present. This mirrors what every display
+ * formatter treats as the "—" em-dash case, centralized here so a
+ * `hideWhenEmpty` field drops out of the read surface entirely instead of
+ * rendering the placeholder.
+ *
+ * ## Why `{}` counts, added 2026-09-18
+ *
+ * It did not until this change, and the omission made `hideWhenEmpty`
+ * unable to express the one thing an object field needs it for. An object
+ * whose members are all optional — a context bag, a set of locators — is
+ * `{}` whenever none of them applies, and the row then rendered a label
+ * with a void under it. There was no other mechanism: `showWhen` compares a
+ * value, and `{}` satisfies `EXISTS`.
+ *
+ * It is consistent rather than special: an empty array was already empty,
+ * and an empty object is the same absence in the other container. And the
+ * decoration is OPT-IN — or, inside a `<FieldTiles>` host, the default a field
+ * opts OUT of with `hideWhenEmpty: false` — so a field reaching this line has
+ * already been told to disappear rather than render the placeholder: there is no
+ * field for which showing an empty labelled block is the better answer.
+ *
+ * ## The guard is the whole of the risk
+ *
+ * `Object.keys()` is empty for far more than a plain object: a `Date`, a
+ * `Map`, a `Set`, a `File`, and every class instance whose state lives on its
+ * prototype or in private fields. Counting keys without checking the
+ * prototype would make every date field on every read surface vanish. So the
+ * test is PROTOTYPE-first — `Object.prototype` or a null prototype, nothing
+ * else — and `display-field-empty-value.test.tsx` pins each of those shapes
+ * as present.
+ */
+export declare function isEmptyDisplayValue(value: unknown): boolean;
+//# sourceMappingURL=display-value-emptiness.utils.d.ts.map

package/dist/esm/components/data-display/display-value-emptiness.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-value-emptiness.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/display-value-emptiness.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiB3D"}

package/dist/esm/components/data-display/display-value-emptiness.utils.js

@@ -0,0 +1,61 @@
+/**
+ * One emptiness predicate for every read surface: `display.hideWhenEmpty`, the `<FieldTiles>` default,
+ * and the summaries (`isPresentSummaryValue`). Two predicates for one concept disagreed on `'  '` and
+ * `{}` (audit B-9, 2026-10-01), so a card drew a "—" cell for a value the record view hid.
+ */
+/**
+ * Emptiness test for the field-level `display.hideWhenEmpty` mechanism.
+ *
+ * A value counts as empty when it is null / undefined, an empty (or
+ * whitespace-only) string, an empty array, or a PLAIN OBJECT with no own
+ * enumerable keys. Every other value — including `false` and `0`, which are
+ * answers rather than absences — is present. This mirrors what every display
+ * formatter treats as the "—" em-dash case, centralized here so a
+ * `hideWhenEmpty` field drops out of the read surface entirely instead of
+ * rendering the placeholder.
+ *
+ * ## Why `{}` counts, added 2026-09-18
+ *
+ * It did not until this change, and the omission made `hideWhenEmpty`
+ * unable to express the one thing an object field needs it for. An object
+ * whose members are all optional — a context bag, a set of locators — is
+ * `{}` whenever none of them applies, and the row then rendered a label
+ * with a void under it. There was no other mechanism: `showWhen` compares a
+ * value, and `{}` satisfies `EXISTS`.
+ *
+ * It is consistent rather than special: an empty array was already empty,
+ * and an empty object is the same absence in the other container. And the
+ * decoration is OPT-IN — or, inside a `<FieldTiles>` host, the default a field
+ * opts OUT of with `hideWhenEmpty: false` — so a field reaching this line has
+ * already been told to disappear rather than render the placeholder: there is no
+ * field for which showing an empty labelled block is the better answer.
+ *
+ * ## The guard is the whole of the risk
+ *
+ * `Object.keys()` is empty for far more than a plain object: a `Date`, a
+ * `Map`, a `Set`, a `File`, and every class instance whose state lives on its
+ * prototype or in private fields. Counting keys without checking the
+ * prototype would make every date field on every read surface vanish. So the
+ * test is PROTOTYPE-first — `Object.prototype` or a null prototype, nothing
+ * else — and `display-field-empty-value.test.tsx` pins each of those shapes
+ * as present.
+ */
+export function isEmptyDisplayValue(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return value.trim() === '';
+    }
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    if (typeof value === 'object') {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype === Object.prototype || prototype === null) {
+            return Object.keys(value).length === 0;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=display-value-emptiness.utils.js.map

package/dist/esm/components/data-display/display-value-emptiness.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-value-emptiness.utils.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-value-emptiness.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACzD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * One emptiness predicate for every read surface: `display.hideWhenEmpty`, the `<FieldTiles>` default,\n * and the summaries (`isPresentSummaryValue`). Two predicates for one concept disagreed on `'  '` and\n * `{}` (audit B-9, 2026-10-01), so a card drew a \"—\" cell for a value the record view hid.\n */\n\n/**\n * Emptiness test for the field-level `display.hideWhenEmpty` mechanism.\n *\n * A value counts as empty when it is null / undefined, an empty (or\n * whitespace-only) string, an empty array, or a PLAIN OBJECT with no own\n * enumerable keys. Every other value — including `false` and `0`, which are\n * answers rather than absences — is present. This mirrors what every display\n * formatter treats as the \"—\" em-dash case, centralized here so a\n * `hideWhenEmpty` field drops out of the read surface entirely instead of\n * rendering the placeholder.\n *\n * ## Why `{}` counts, added 2026-09-18\n *\n * It did not until this change, and the omission made `hideWhenEmpty`\n * unable to express the one thing an object field needs it for. An object\n * whose members are all optional — a context bag, a set of locators — is\n * `{}` whenever none of them applies, and the row then rendered a label\n * with a void under it. There was no other mechanism: `showWhen` compares a\n * value, and `{}` satisfies `EXISTS`.\n *\n * It is consistent rather than special: an empty array was already empty,\n * and an empty object is the same absence in the other container. And the\n * decoration is OPT-IN — or, inside a `<FieldTiles>` host, the default a field\n * opts OUT of with `hideWhenEmpty: false` — so a field reaching this line has\n * already been told to disappear rather than render the placeholder: there is no\n * field for which showing an empty labelled block is the better answer.\n *\n * ## The guard is the whole of the risk\n *\n * `Object.keys()` is empty for far more than a plain object: a `Date`, a\n * `Map`, a `Set`, a `File`, and every class instance whose state lives on its\n * prototype or in private fields. Counting keys without checking the\n * prototype would make every date field on every read surface vanish. So the\n * test is PROTOTYPE-first — `Object.prototype` or a null prototype, nothing\n * else — and `display-field-empty-value.test.tsx` pins each of those shapes\n * as present.\n */\nexport function isEmptyDisplayValue(value: unknown): boolean {\n  if (value === null || value === undefined) {\n    return true;\n  }\n  if (typeof value === 'string') {\n    return value.trim() === '';\n  }\n  if (Array.isArray(value)) {\n    return value.length === 0;\n  }\n  if (typeof value === 'object') {\n    const prototype = Object.getPrototypeOf(value);\n    if (prototype === Object.prototype || prototype === null) {\n      return Object.keys(value).length === 0;\n    }\n  }\n  return false;\n}\n"]}

package/dist/esm/components/data-display/empty-value-mark.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import { FieldSchemaType } from '@wildo-ai/zod-decorators';
+import { TypographyVariant } from '@wildo-ai/presets-components-models';
+/**
+ * The mark a read surface shows where a field holds no value: a muted em-dash for the eye, and the
+ * field's "no value" wording for assistive technology.
+ *
+ * ONE mark for every formatter and for the value dispatcher, so the absence of a value reads the same
+ * everywhere. It takes the VOICE of the value it stands in for: a missing date, number or amount is set in
+ * the theme's DATA voice, like the values around it in a column or a tile grid, instead of body type
+ * between two tabular figures (audit A-L9). Before it existed, the same fragment was hand-written in
+ * twenty-five places.
+ *
+ * Import from `@wildo-ai/saas-frontend-lib`.
+ *
+ * @param noValueLabel - the field's "no value" wording, read to assistive technology (`tComponent(…, 'noValue')`).
+ * @param typography - the voice of the missing value; pass {@link emptyValueTypographyFor} the schema type.
+ *
+ * @example
+ * ```tsx
+ * if (value == null) return <EmptyValueMark noValueLabel={tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue')} typography={TypographyVariant.DATA} />
+ * ```
+ */
+export declare function EmptyValueMark({ noValueLabel, typography, className }: {
+    noValueLabel: string;
+    typography?: TypographyVariant;
+    className?: string;
+}): React.JSX.Element;
+/** The voice an empty value of this schema type is set in: DATA for figures and dates, the default otherwise. */
+export declare function emptyValueTypographyFor(schemaType: FieldSchemaType | undefined): TypographyVariant | undefined;
+//# sourceMappingURL=empty-value-mark.d.ts.map

package/dist/esm/components/data-display/empty-value-mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-value-mark.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/empty-value-mark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAOpB;AAmBD,iHAAiH;AACjH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAE9G"}

package/dist/esm/components/data-display/empty-value-mark.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { FieldSchemaType } from '@wildo-ai/zod-decorators';
+import { TypographyVariant } from '@wildo-ai/presets-components-models';
+import { Text } from '../../components/typography/text.js';
+import { cn } from '../../core/ui/cn.js';
+/**
+ * The mark a read surface shows where a field holds no value: a muted em-dash for the eye, and the
+ * field's "no value" wording for assistive technology.
+ *
+ * ONE mark for every formatter and for the value dispatcher, so the absence of a value reads the same
+ * everywhere. It takes the VOICE of the value it stands in for: a missing date, number or amount is set in
+ * the theme's DATA voice, like the values around it in a column or a tile grid, instead of body type
+ * between two tabular figures (audit A-L9). Before it existed, the same fragment was hand-written in
+ * twenty-five places.
+ *
+ * Import from `@wildo-ai/saas-frontend-lib`.
+ *
+ * @param noValueLabel - the field's "no value" wording, read to assistive technology (`tComponent(…, 'noValue')`).
+ * @param typography - the voice of the missing value; pass {@link emptyValueTypographyFor} the schema type.
+ *
+ * @example
+ * ```tsx
+ * if (value == null) return <EmptyValueMark noValueLabel={tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue')} typography={TypographyVariant.DATA} />
+ * ```
+ */
+export function EmptyValueMark({ noValueLabel, typography, className }) {
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { typography: typography, className: cn('text-muted-foreground italic', className), "aria-hidden": "true", children: "\u2014" }), _jsx("span", { className: "sr-only", children: noValueLabel })] }));
+}
+/** The schema types whose values are set in the DATA voice, so their absence is too. */
+const DATA_VOICED_SCHEMA_TYPES = new Set([
+    FieldSchemaType.NUMBER,
+    FieldSchemaType.BIGDECIMAL,
+    FieldSchemaType.MONEY,
+    FieldSchemaType.DURATION,
+    FieldSchemaType.DATE,
+    FieldSchemaType.TIME,
+    FieldSchemaType.DATETIME,
+    FieldSchemaType.RANGE_NUMBER,
+    FieldSchemaType.RANGE_BIGDECIMAL,
+    FieldSchemaType.RANGE_MONEY,
+    FieldSchemaType.RANGE_DATE,
+    FieldSchemaType.RANGE_TIME,
+    FieldSchemaType.RANGE_DATETIME,
+]);
+/** The voice an empty value of this schema type is set in: DATA for figures and dates, the default otherwise. */
+export function emptyValueTypographyFor(schemaType) {
+    return schemaType && DATA_VOICED_SCHEMA_TYPES.has(schemaType) ? TypographyVariant.DATA : undefined;
+}
+//# sourceMappingURL=empty-value-mark.js.map

package/dist/esm/components/data-display/empty-value-mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-value-mark.js","sourceRoot":"","sources":["../../../../../src/components/data-display/empty-value-mark.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,gDAAgD,CAAC;AACtE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAInE;IACC,OAAO,CACL,8BACE,KAAC,IAAI,IAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,8BAA8B,EAAE,SAAS,CAAC,iBAAc,MAAM,uBAAS,EACnH,eAAM,SAAS,EAAC,SAAS,YAAE,YAAY,GAAQ,IAC9C,CACJ,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,wBAAwB,GAAiC,IAAI,GAAG,CAAC;IACrE,eAAe,CAAC,MAAM;IACtB,eAAe,CAAC,UAAU;IAC1B,eAAe,CAAC,KAAK;IACrB,eAAe,CAAC,QAAQ;IACxB,eAAe,CAAC,IAAI;IACpB,eAAe,CAAC,IAAI;IACpB,eAAe,CAAC,QAAQ;IACxB,eAAe,CAAC,YAAY;IAC5B,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,WAAW;IAC3B,eAAe,CAAC,UAAU;IAC1B,eAAe,CAAC,UAAU;IAC1B,eAAe,CAAC,cAAc;CAC/B,CAAC,CAAC;AAEH,iHAAiH;AACjH,MAAM,UAAU,uBAAuB,CAAC,UAAuC;IAC7E,OAAO,UAAU,IAAI,wBAAwB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrG,CAAC","sourcesContent":["import * as React from 'react';\nimport { FieldSchemaType } from '@wildo-ai/zod-decorators';\nimport { TypographyVariant } from '@wildo-ai/presets-components-models';\nimport { Text } from '~wildo-frontend-lib/components/typography/text';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\n\n/**\n * The mark a read surface shows where a field holds no value: a muted em-dash for the eye, and the\n * field's \"no value\" wording for assistive technology.\n *\n * ONE mark for every formatter and for the value dispatcher, so the absence of a value reads the same\n * everywhere. It takes the VOICE of the value it stands in for: a missing date, number or amount is set in\n * the theme's DATA voice, like the values around it in a column or a tile grid, instead of body type\n * between two tabular figures (audit A-L9). Before it existed, the same fragment was hand-written in\n * twenty-five places.\n *\n * Import from `@wildo-ai/saas-frontend-lib`.\n *\n * @param noValueLabel - the field's \"no value\" wording, read to assistive technology (`tComponent(…, 'noValue')`).\n * @param typography - the voice of the missing value; pass {@link emptyValueTypographyFor} the schema type.\n *\n * @example\n * ```tsx\n * if (value == null) return <EmptyValueMark noValueLabel={tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue')} typography={TypographyVariant.DATA} />\n * ```\n */\nexport function EmptyValueMark({ noValueLabel, typography, className }: {\n  noValueLabel: string;\n  typography?: TypographyVariant;\n  className?: string;\n}): React.JSX.Element {\n  return (\n    <>\n      <Text typography={typography} className={cn('text-muted-foreground italic', className)} aria-hidden=\"true\">—</Text>\n      <span className=\"sr-only\">{noValueLabel}</span>\n    </>\n  );\n}\n\n/** The schema types whose values are set in the DATA voice, so their absence is too. */\nconst DATA_VOICED_SCHEMA_TYPES: ReadonlySet<FieldSchemaType> = new Set([\n  FieldSchemaType.NUMBER,\n  FieldSchemaType.BIGDECIMAL,\n  FieldSchemaType.MONEY,\n  FieldSchemaType.DURATION,\n  FieldSchemaType.DATE,\n  FieldSchemaType.TIME,\n  FieldSchemaType.DATETIME,\n  FieldSchemaType.RANGE_NUMBER,\n  FieldSchemaType.RANGE_BIGDECIMAL,\n  FieldSchemaType.RANGE_MONEY,\n  FieldSchemaType.RANGE_DATE,\n  FieldSchemaType.RANGE_TIME,\n  FieldSchemaType.RANGE_DATETIME,\n]);\n\n/** The voice an empty value of this schema type is set in: DATA for figures and dates, the default otherwise. */\nexport function emptyValueTypographyFor(schemaType: FieldSchemaType | undefined): TypographyVariant | undefined {\n  return schemaType && DATA_VOICED_SCHEMA_TYPES.has(schemaType) ? TypographyVariant.DATA : undefined;\n}\n"]}

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.d.ts

@@ -4,8 +4,9 @@
  * Every word comes from the i18n tree (`display-text-comes-from-i18n.md`):
  * - the sentence is `components.LOW_LEVEL_FORM_FIELD.syncedFromAsOf`, with `system` and `asOf` params;
  * - the instance is `systems_of_record.<name>.displayName`, planned by the labelling pipeline for every declared
- *   instance. A name nobody generated words for renders RAW (`odoo`) — the missing label looking missing, never a
- *   word derived from the identifier;
+ *   instance. A name nobody generated words for renders its raw KEY, as every unresolved label does — the missing label
+ *   looking missing (#2109). The instance's identifier is never substituted for it: that is the
+ *   `t(key) === key ? fallback : t(key)` shape the rule forbids, and it made a missing label look finished;
  * - the instant is the viewer's regional formatting, relative when near ("12 minutes ago") and a date when far.
  *
  * Rendered with the `FieldDescription` recipe so it reads in the description voice, as a note about the value.

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayFieldProvenanceNote.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAkB,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,sBAAsB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,0BAA0B,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,+BAA+B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAkB/H;yBAlBe,0BAA0B"}
+{"version":3,"file":"DisplayFieldProvenanceNote.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAkB,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,sBAAsB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,0BAA0B,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,+BAA+B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAiB/H;yBAjBe,0BAA0B"}

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.js

@@ -5,8 +5,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Every word comes from the i18n tree (`display-text-comes-from-i18n.md`):
  * - the sentence is `components.LOW_LEVEL_FORM_FIELD.syncedFromAsOf`, with `system` and `asOf` params;
  * - the instance is `systems_of_record.<name>.displayName`, planned by the labelling pipeline for every declared
- *   instance. A name nobody generated words for renders RAW (`odoo`) — the missing label looking missing, never a
- *   word derived from the identifier;
+ *   instance. A name nobody generated words for renders its raw KEY, as every unresolved label does — the missing label
+ *   looking missing (#2109). The instance's identifier is never substituted for it: that is the
+ *   `t(key) === key ? fallback : t(key)` shape the rule forbids, and it made a missing label look finished;
  * - the instant is the viewer's regional formatting, relative when near ("12 minutes ago") and a date when far.
  *
  * Rendered with the `FieldDescription` recipe so it reads in the description voice, as a note about the value.
@@ -26,8 +27,7 @@ export function DisplayFieldProvenanceNote({ provenance, className }) {
     });
     if (!isReady)
         return null;
-    const translatedSystem = t(systemKey);
-    const system = translatedSystem && translatedSystem !== systemKey ? translatedSystem : provenance.system;
+    const system = t(systemKey);
     const asOf = formatDateTimeForDisplayMode(provenance.currentAsOf, DateDisplayMode.AUTO);
     return (_jsx(FieldDescription, { className: className, "data-field-provenance": "", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'syncedFromAsOf', { system, asOf }) }));
 }

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.js.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayFieldProvenanceNote.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;AACH,OAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAQhE,MAAM,UAAU,0BAA0B,CAAC,EAAE,UAAU,EAAE,SAAS,EAAmC;IACnG,MAAM,SAAS,GAAG,sCAAsC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,4BAA4B,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACvE,SAAS,EAAE,qBAAqB,CAAC,oBAAoB;QACrD,IAAI;KACL,CAAC,CAAC;IACH,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,gBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,gBAAgB,IAAI,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACzG,MAAM,IAAI,GAAG,4BAA4B,CAAC,UAAU,CAAC,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAExF,OAAO,CACL,KAAC,gBAAgB,IAAC,SAAS,EAAE,SAAS,2BAAwB,EAAE,YAC7D,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAC1E,CACpB,CAAC;AACJ,CAAC;AAED,0BAA0B,CAAC,WAAW,GAAG,4BAA4B,CAAC","sourcesContent":["/**\n * The provenance note beneath a pipeline-written value (#1997): \"Synced from Odoo · as of 12 minutes ago\".\n *\n * Every word comes from the i18n tree (`display-text-comes-from-i18n.md`):\n * - the sentence is `components.LOW_LEVEL_FORM_FIELD.syncedFromAsOf`, with `system` and `asOf` params;\n * - the instance is `systems_of_record.<name>.displayName`, planned by the labelling pipeline for every declared\n *   instance. A name nobody generated words for renders RAW (`odoo`) — the missing label looking missing, never a\n *   word derived from the identifier;\n * - the instant is the viewer's regional formatting, relative when near (\"12 minutes ago\") and a date when far.\n *\n * Rendered with the `FieldDescription` recipe so it reads in the description voice, as a note about the value.\n */\nimport React, { useMemo } from 'react';\nimport { DateDisplayMode } from '@wildo-ai/zod-decorators';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { buildSystemOfRecordDisplayNameLabelKey } from '@wildo-ai/saas-models';\n\nimport { FieldDescription } from '~wildo-frontend-lib/components/form/chromes/field';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { DisplayFieldProvenance } from './external-data-provenance.frontend';\n\nexport interface DisplayFieldProvenanceNoteProps {\n  provenance: DisplayFieldProvenance;\n  className?: string;\n}\n\nexport function DisplayFieldProvenanceNote({ provenance, className }: DisplayFieldProvenanceNoteProps): React.JSX.Element | null {\n  const systemKey = buildSystemOfRecordDisplayNameLabelKey(provenance.system);\n  const keys = useMemo(() => [systemKey], [systemKey]);\n  const { tComponent, t, formatDateTimeForDisplayMode, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_FIELD,\n    keys,\n  });\n  if (!isReady) return null;\n\n  const translatedSystem = t(systemKey);\n  const system = translatedSystem && translatedSystem !== systemKey ? translatedSystem : provenance.system;\n  const asOf = formatDateTimeForDisplayMode(provenance.currentAsOf, DateDisplayMode.AUTO);\n\n  return (\n    <FieldDescription className={className} data-field-provenance=\"\">\n      {tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'syncedFromAsOf', { system, asOf })}\n    </FieldDescription>\n  );\n}\n\nDisplayFieldProvenanceNote.displayName = 'DisplayFieldProvenanceNote';\n"]}
+{"version":3,"file":"DisplayFieldProvenanceNote.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AACH,OAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAQhE,MAAM,UAAU,0BAA0B,CAAC,EAAE,UAAU,EAAE,SAAS,EAAmC;IACnG,MAAM,SAAS,GAAG,sCAAsC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,4BAA4B,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACvE,SAAS,EAAE,qBAAqB,CAAC,oBAAoB;QACrD,IAAI;KACL,CAAC,CAAC;IACH,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,4BAA4B,CAAC,UAAU,CAAC,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAExF,OAAO,CACL,KAAC,gBAAgB,IAAC,SAAS,EAAE,SAAS,2BAAwB,EAAE,YAC7D,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAC1E,CACpB,CAAC;AACJ,CAAC;AAED,0BAA0B,CAAC,WAAW,GAAG,4BAA4B,CAAC","sourcesContent":["/**\n * The provenance note beneath a pipeline-written value (#1997): \"Synced from Odoo · as of 12 minutes ago\".\n *\n * Every word comes from the i18n tree (`display-text-comes-from-i18n.md`):\n * - the sentence is `components.LOW_LEVEL_FORM_FIELD.syncedFromAsOf`, with `system` and `asOf` params;\n * - the instance is `systems_of_record.<name>.displayName`, planned by the labelling pipeline for every declared\n *   instance. A name nobody generated words for renders its raw KEY, as every unresolved label does — the missing label\n *   looking missing (#2109). The instance's identifier is never substituted for it: that is the\n *   `t(key) === key ? fallback : t(key)` shape the rule forbids, and it made a missing label look finished;\n * - the instant is the viewer's regional formatting, relative when near (\"12 minutes ago\") and a date when far.\n *\n * Rendered with the `FieldDescription` recipe so it reads in the description voice, as a note about the value.\n */\nimport React, { useMemo } from 'react';\nimport { DateDisplayMode } from '@wildo-ai/zod-decorators';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { buildSystemOfRecordDisplayNameLabelKey } from '@wildo-ai/saas-models';\n\nimport { FieldDescription } from '~wildo-frontend-lib/components/form/chromes/field';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { DisplayFieldProvenance } from './external-data-provenance.frontend';\n\nexport interface DisplayFieldProvenanceNoteProps {\n  provenance: DisplayFieldProvenance;\n  className?: string;\n}\n\nexport function DisplayFieldProvenanceNote({ provenance, className }: DisplayFieldProvenanceNoteProps): React.JSX.Element | null {\n  const systemKey = buildSystemOfRecordDisplayNameLabelKey(provenance.system);\n  const keys = useMemo(() => [systemKey], [systemKey]);\n  const { tComponent, t, formatDateTimeForDisplayMode, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_FIELD,\n    keys,\n  });\n  if (!isReady) return null;\n\n  const system = t(systemKey);\n  const asOf = formatDateTimeForDisplayMode(provenance.currentAsOf, DateDisplayMode.AUTO);\n\n  return (\n    <FieldDescription className={className} data-field-provenance=\"\">\n      {tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'syncedFromAsOf', { system, asOf })}\n    </FieldDescription>\n  );\n}\n\nDisplayFieldProvenanceNote.displayName = 'DisplayFieldProvenanceNote';\n"]}

package/dist/esm/components/data-display/external-data-provenance/external-data-provenance.frontend.d.ts

@@ -28,20 +28,23 @@ export declare function buildExternalDataProvenancePath(params: {
     resourceConfiguration: AnyFrontendResourceConfiguration;
     contextualParameters: Record<string, string | number>;
 }): string | undefined;
+/** The client a read goes through; only its identity and `get` are used. */
+type ProvenanceClient = Pick<WildoBackendHttpClient, 'get'>;
 /** `useSyncExternalStore` subscription. */
 export declare function subscribeExternalDataProvenance(listener: () => void): () => void;
 /**
  * How long until the cached answer for a path expires (ms, never negative), or `undefined` when nothing is cached — the
  * hook's cue to schedule its re-read.
  */
-export declare function msUntilExternalDataProvenanceExpires(path: string | undefined, now?: number): number | undefined;
+export declare function msUntilExternalDataProvenanceExpires(path: string | undefined, client: ProvenanceClient | undefined, now?: number): number | undefined;
 /** The cached answer for a path: the response, `null` for a refused/failed read, `undefined` while unknown. */
-export declare function peekExternalDataProvenance(path: string | undefined): ExternalDataProvenanceResponse | null | undefined;
+export declare function peekExternalDataProvenance(path: string | undefined, client: ProvenanceClient | undefined): ExternalDataProvenanceResponse | null | undefined;
 /**
  * Read the path unless a fresh answer is cached or a read is already on its way. Every synced field of a record calls
  * this; exactly one request leaves.
  */
-export declare function ensureExternalDataProvenance(path: string, httpClient: Pick<WildoBackendHttpClient, 'get'>, now?: number): void;
+export declare function ensureExternalDataProvenance(path: string, httpClient: ProvenanceClient, now?: number): void;
 /** Test seam: forget every cached answer. */
 export declare function resetExternalDataProvenanceCache(): void;
+export {};
 //# sourceMappingURL=external-data-provenance.frontend.d.ts.map

package/dist/esm/components/data-display/external-data-provenance/external-data-provenance.frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-data-provenance.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/external-data-provenance.frontend.ts"],"names":[],"mappings":"AA0BA,OAAO,EAIL,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACpC,MAAM,qCAAqC,CAAC;AAI7C,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AACtH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sEAAsE,CAAC;AAEnH,qHAAqH;AACrH,eAAO,MAAM,+BAA+B,QAAgB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,+GAA+G;IAC/G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6GAA6G;IAC7G,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID,+FAA+F;AAC/F,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,+BAA+B,GAAG,WAAW,CAAC,MAAM,CAAC,CAO5G;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,qBAAqB,EAAE,gCAAgC,CAAC;IACxD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvD,GAAG,MAAM,GAAG,SAAS,CAiBrB;AAeD,2CAA2C;AAC3C,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGhF;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,SAAS,CAG3H;AAED,+GAA+G;AAC/G,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,8BAA8B,GAAG,IAAI,GAAG,SAAS,CAGtH;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAiB1I;AAED,6CAA6C;AAC7C,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}
+{"version":3,"file":"external-data-provenance.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/external-data-provenance.frontend.ts"],"names":[],"mappings":"AA4BA,OAAO,EAIL,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACpC,MAAM,qCAAqC,CAAC;AAI7C,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AACtH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sEAAsE,CAAC;AAEnH,qHAAqH;AACrH,eAAO,MAAM,+BAA+B,QAAgB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,+GAA+G;IAC/G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6GAA6G;IAC7G,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID,+FAA+F;AAC/F,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,+BAA+B,GAAG,WAAW,CAAC,MAAM,CAAC,CAO5G;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,qBAAqB,EAAE,gCAAgC,CAAC;IACxD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvD,GAAG,MAAM,GAAG,SAAS,CAiBrB;AAOD,4EAA4E;AAC5E,KAAK,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;AAwB5D,2CAA2C;AAC3C,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGhF;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,GAAG,GAAE,MAAmB,GACvB,MAAM,GAAG,SAAS,CAGpB;AAED,+GAA+G;AAC/G,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,8BAA8B,GAAG,IAAI,GAAG,SAAS,CAG5J;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAkBvH;AAED,6CAA6C;AAC7C,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD"}