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

package/dist/esm/components/resources/resource-filter-field-type.frontend.schemas.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The classified type of one filter field in a resource list/search panel — the closed vocabulary that decides
+ * which control the panel draws and how a chip prints the active value.
+ *
+ * Classification is owned by `ResourceLayoutUtils.parseFilterFieldDefinitions`; the panel
+ * (`ResourceLayout_FiltersControl`) and the chips (`ResourceLayout_FilterChips`) only branch on it. It lives in
+ * its own module rather than beside `FilterFieldDefinition` because the chips are imported BY the panel: reading
+ * the vocabulary from the panel's module would make that import a runtime cycle.
+ */
+export declare enum FilterFieldType {
+    /** Free text — a text input; the default for any schema the classifier does not recognise as something richer. */
+    STRING = "string",
+    /** A number (including big decimals) compared by EQUALITY. A threshold is {@link FilterFieldType.NUMBER_RANGE}. */
+    NUMBER = "number",
+    /** A tri-state choice — any / yes / no — so "no filter" stays distinct from "false". */
+    BOOLEAN = "boolean",
+    /** One value of the field's enum, drawn by the enum's own declared edit mode; labels come from i18n. */
+    ENUM = "enum",
+    /** A date or date-time, filtered as the `{ startDate, endDate }` window the backend's date filter applies (#2413). */
+    DATE = "date",
+    /**
+     * A string field whose name resolves to a foreign key: the value space is ids of the target resource, so the
+     * panel draws a searchable reference picker and the chip resolves the id to the target's label, never a raw id.
+     */
+    REFERENCE = "reference",
+    /**
+     * The one STRUCTURED member: the value is a `{ min?, max? }` bound pair rather than a scalar, because the
+     * question asked of a number is almost always a threshold. Opt-in — an author writes
+     * `Resources_Filter_NumberRangeSchema` in `filterFields` — so a plain number filter keeps meaning equality.
+     */
+    NUMBER_RANGE = "numberRange",
+    /** Not yet classified. The classifier's starting value; a definition it returns never carries it. */
+    UNKNOWN = "unknown"
+}
+//# sourceMappingURL=resource-filter-field-type.frontend.schemas.d.ts.map

package/dist/esm/components/resources/resource-filter-field-type.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-filter-field-type.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/resource-filter-field-type.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,oBAAY,eAAe;IACzB,kHAAkH;IAClH,MAAM,WAAW;IACjB,mHAAmH;IACnH,MAAM,WAAW;IACjB,wFAAwF;IACxF,OAAO,YAAY;IACnB,wGAAwG;IACxG,IAAI,SAAS;IACb,sHAAsH;IACtH,IAAI,SAAS;IACb;;;OAGG;IACH,SAAS,cAAc;IACvB;;;;OAIG;IACH,YAAY,gBAAgB;IAC5B,qGAAqG;IACrG,OAAO,YAAY;CACpB"}

package/dist/esm/components/resources/resource-filter-field-type.frontend.schemas.js

@@ -0,0 +1,36 @@
+/**
+ * The classified type of one filter field in a resource list/search panel — the closed vocabulary that decides
+ * which control the panel draws and how a chip prints the active value.
+ *
+ * Classification is owned by `ResourceLayoutUtils.parseFilterFieldDefinitions`; the panel
+ * (`ResourceLayout_FiltersControl`) and the chips (`ResourceLayout_FilterChips`) only branch on it. It lives in
+ * its own module rather than beside `FilterFieldDefinition` because the chips are imported BY the panel: reading
+ * the vocabulary from the panel's module would make that import a runtime cycle.
+ */
+export var FilterFieldType;
+(function (FilterFieldType) {
+    /** Free text — a text input; the default for any schema the classifier does not recognise as something richer. */
+    FilterFieldType["STRING"] = "string";
+    /** A number (including big decimals) compared by EQUALITY. A threshold is {@link FilterFieldType.NUMBER_RANGE}. */
+    FilterFieldType["NUMBER"] = "number";
+    /** A tri-state choice — any / yes / no — so "no filter" stays distinct from "false". */
+    FilterFieldType["BOOLEAN"] = "boolean";
+    /** One value of the field's enum, drawn by the enum's own declared edit mode; labels come from i18n. */
+    FilterFieldType["ENUM"] = "enum";
+    /** A date or date-time, filtered as the `{ startDate, endDate }` window the backend's date filter applies (#2413). */
+    FilterFieldType["DATE"] = "date";
+    /**
+     * A string field whose name resolves to a foreign key: the value space is ids of the target resource, so the
+     * panel draws a searchable reference picker and the chip resolves the id to the target's label, never a raw id.
+     */
+    FilterFieldType["REFERENCE"] = "reference";
+    /**
+     * The one STRUCTURED member: the value is a `{ min?, max? }` bound pair rather than a scalar, because the
+     * question asked of a number is almost always a threshold. Opt-in — an author writes
+     * `Resources_Filter_NumberRangeSchema` in `filterFields` — so a plain number filter keeps meaning equality.
+     */
+    FilterFieldType["NUMBER_RANGE"] = "numberRange";
+    /** Not yet classified. The classifier's starting value; a definition it returns never carries it. */
+    FilterFieldType["UNKNOWN"] = "unknown";
+})(FilterFieldType || (FilterFieldType = {}));
+//# sourceMappingURL=resource-filter-field-type.frontend.schemas.js.map

package/dist/esm/components/resources/resource-filter-field-type.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-filter-field-type.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/components/resources/resource-filter-field-type.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,eAwBX;AAxBD,WAAY,eAAe;IACzB,kHAAkH;IAClH,oCAAiB,CAAA;IACjB,mHAAmH;IACnH,oCAAiB,CAAA;IACjB,wFAAwF;IACxF,sCAAmB,CAAA;IACnB,wGAAwG;IACxG,gCAAa,CAAA;IACb,sHAAsH;IACtH,gCAAa,CAAA;IACb;;;OAGG;IACH,0CAAuB,CAAA;IACvB;;;;OAIG;IACH,+CAA4B,CAAA;IAC5B,qGAAqG;IACrG,sCAAmB,CAAA;AACrB,CAAC,EAxBW,eAAe,KAAf,eAAe,QAwB1B","sourcesContent":["/**\n * The classified type of one filter field in a resource list/search panel — the closed vocabulary that decides\n * which control the panel draws and how a chip prints the active value.\n *\n * Classification is owned by `ResourceLayoutUtils.parseFilterFieldDefinitions`; the panel\n * (`ResourceLayout_FiltersControl`) and the chips (`ResourceLayout_FilterChips`) only branch on it. It lives in\n * its own module rather than beside `FilterFieldDefinition` because the chips are imported BY the panel: reading\n * the vocabulary from the panel's module would make that import a runtime cycle.\n */\nexport enum FilterFieldType {\n  /** Free text — a text input; the default for any schema the classifier does not recognise as something richer. */\n  STRING = 'string',\n  /** A number (including big decimals) compared by EQUALITY. A threshold is {@link FilterFieldType.NUMBER_RANGE}. */\n  NUMBER = 'number',\n  /** A tri-state choice — any / yes / no — so \"no filter\" stays distinct from \"false\". */\n  BOOLEAN = 'boolean',\n  /** One value of the field's enum, drawn by the enum's own declared edit mode; labels come from i18n. */\n  ENUM = 'enum',\n  /** A date or date-time, filtered as the `{ startDate, endDate }` window the backend's date filter applies (#2413). */\n  DATE = 'date',\n  /**\n   * A string field whose name resolves to a foreign key: the value space is ids of the target resource, so the\n   * panel draws a searchable reference picker and the chip resolves the id to the target's label, never a raw id.\n   */\n  REFERENCE = 'reference',\n  /**\n   * The one STRUCTURED member: the value is a `{ min?, max? }` bound pair rather than a scalar, because the\n   * question asked of a number is almost always a threshold. Opt-in — an author writes\n   * `Resources_Filter_NumberRangeSchema` in `filterFields` — so a plain number filter keeps meaning equality.\n   */\n  NUMBER_RANGE = 'numberRange',\n  /** Not yet classified. The classifier's starting value; a definition it returns never carries it. */\n  UNKNOWN = 'unknown',\n}\n"]}

package/dist/esm/components/resources/resource-header-geometry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The record header's own width, as the header and its contributors read it.
+ *
+ * The header (`ResourceLayout_Header`) declares an `@container/resource-header`, so what sits in it
+ * answers to the HEADER's width rather than the viewport's: the same record is wide on a page and
+ * narrow in a split pane on the same screen.
+ */
+/** Declared on the header's root. */
+export declare const RESOURCE_HEADER_CONTAINER_CLASS = "@container/resource-header";
+/**
+ * Visually hide a label while the header is narrow (below 48rem), keeping it as the accessible name.
+ *
+ * 48rem because that is where the title line stops holding a title and a labelled action cluster side
+ * by side: measured on a Wonder Todos todo in a 670px pane, the "Todo Workspace" launcher's words alone
+ * were 216px and pushed the actions onto a line of their own. Pair it with a `title` so a pointer still
+ * gets the words.
+ */
+export declare const RESOURCE_HEADER_NARROW_SR_ONLY_CLASS = "@max-[48rem]/resource-header:sr-only";
+//# sourceMappingURL=resource-header-geometry.d.ts.map

package/dist/esm/components/resources/resource-header-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-header-geometry.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/resource-header-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qCAAqC;AACrC,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAE5E;;;;;;;GAOG;AACH,eAAO,MAAM,oCAAoC,yCAAyC,CAAC"}

package/dist/esm/components/resources/resource-header-geometry.js

@@ -0,0 +1,19 @@
+/**
+ * The record header's own width, as the header and its contributors read it.
+ *
+ * The header (`ResourceLayout_Header`) declares an `@container/resource-header`, so what sits in it
+ * answers to the HEADER's width rather than the viewport's: the same record is wide on a page and
+ * narrow in a split pane on the same screen.
+ */
+/** Declared on the header's root. */
+export const RESOURCE_HEADER_CONTAINER_CLASS = '@container/resource-header';
+/**
+ * Visually hide a label while the header is narrow (below 48rem), keeping it as the accessible name.
+ *
+ * 48rem because that is where the title line stops holding a title and a labelled action cluster side
+ * by side: measured on a Wonder Todos todo in a 670px pane, the "Todo Workspace" launcher's words alone
+ * were 216px and pushed the actions onto a line of their own. Pair it with a `title` so a pointer still
+ * gets the words.
+ */
+export const RESOURCE_HEADER_NARROW_SR_ONLY_CLASS = '@max-[48rem]/resource-header:sr-only';
+//# sourceMappingURL=resource-header-geometry.js.map

package/dist/esm/components/resources/resource-header-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-header-geometry.js","sourceRoot":"","sources":["../../../../../src/components/resources/resource-header-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qCAAqC;AACrC,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,sCAAsC,CAAC","sourcesContent":["/**\n * The record header's own width, as the header and its contributors read it.\n *\n * The header (`ResourceLayout_Header`) declares an `@container/resource-header`, so what sits in it\n * answers to the HEADER's width rather than the viewport's: the same record is wide on a page and\n * narrow in a split pane on the same screen.\n */\n\n/** Declared on the header's root. */\nexport const RESOURCE_HEADER_CONTAINER_CLASS = '@container/resource-header';\n\n/**\n * Visually hide a label while the header is narrow (below 48rem), keeping it as the accessible name.\n *\n * 48rem because that is where the title line stops holding a title and a labelled action cluster side\n * by side: measured on a Wonder Todos todo in a 670px pane, the \"Todo Workspace\" launcher's words alone\n * were 216px and pushed the actions onto a line of their own. Pair it with a `title` so a pointer still\n * gets the words.\n */\nexport const RESOURCE_HEADER_NARROW_SR_ONLY_CLASS = '@max-[48rem]/resource-header:sr-only';\n"]}

package/dist/esm/components/resources/resource-operation-custom-view.contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-operation-custom-view.contracts.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/resource-operation-custom-view.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC"}
+{"version":3,"file":"resource-operation-custom-view.contracts.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/resource-operation-custom-view.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,+BAA+B,GAAG,KAAK,CAAC,aAAa,CAAC,sCAAsC,CAAC,CAAC;AAC1G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC9G,MAAM,MAAM,iCAAiC,GAAG,KAAK,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC"}

package/dist/esm/components/resources/resourceLayout.utils.d.ts

@@ -1,3 +1,4 @@
+import { type Resources_BulkOperationMatchListing } from '@wildo-ai/saas-models';
 import type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
 import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
 import type { FilterFieldDefinition } from './ResourceLayout_FiltersControl';
@@ -22,7 +23,7 @@ import type { FilterFieldDefinition } from './ResourceLayout_FiltersControl';
  * 2. **Reference fields** — string-typed filter fields whose name resolves to
  *    a resource type through the registry's relationship-enriched
  *    `fieldIdentifierToResourceType` map are foreign keys. They carry
- *    `fieldType: 'reference'` plus the resolved target so the filter UI can
+ *    `fieldType: FilterFieldType.REFERENCE` plus the resolved target so the filter UI can
  *    render a resource-reference selector instead of a raw ID text input.
  */
 export interface FilterFieldTransportContext {
@@ -68,6 +69,31 @@ export declare class ResourceLayoutUtils {
      * definition both collection layouts use, for SEARCH filters and LIST query parameters alike.
      */
     static withPinnedFilters<V>(readerFilters: Readonly<Record<string, V>>, pinnedFilters: Readonly<Record<string, string>> | undefined): Record<string, V | string>;
+    /**
+     * The variant key of an operation a layout shows, or `null` for its unkeyed variant. ONE reading, shared by the export
+     * filter (#2705) and the listing a match selection names (#2718).
+     */
+    static variantKeyOf(shown: unknown): string | null;
+    /**
+     * The operation a LIST layout's rows came from: its inline SEARCH while a term is typed (and it has one), else its list.
+     * The same choice its fetch makes, so a list view with no term never claims to be a search.
+     */
+    static listingOperationShown<T>(params: {
+        inlineSearchTerm: string | undefined;
+        listOperation: T;
+        searchOperation: T | null;
+    }): T;
+    /**
+     * The listing a "select all matching" selection came from (#2718): the collection operation the layout ran and the
+     * variant of it, read from the SAME operation object its request is keyed by. The server re-runs exactly that one, so
+     * a keyed listing (`directory`) and a search view with no term are re-run as what the person saw, never as the default
+     * list.
+     *
+     * `undefined` for a listing run by a CUSTOM operation that only acts like a list or a search (`listMyRequests`): the
+     * wire can name only LIST and SEARCH, and the server would re-run the default list in its place, a different and
+     * usually wider population. A layout offers no "select all matching" then (fail closed).
+     */
+    static matchListingOf(shown: unknown): Resources_BulkOperationMatchListing | undefined;
     /**
      * Compute the set of filter-field names that the transport already pins for
      * the given operation in the current context. See
@@ -87,7 +113,7 @@ export declare class ResourceLayoutUtils {
      * When `transportContext` is provided, the definitions are additionally:
      * - reduced to fields the user can actually act on (transport-pinned
      *   fields are excluded — see {@link FilterFieldTransportContext}), and
-     * - enriched with foreign-key classification (`fieldType: 'reference'` +
+     * - enriched with foreign-key classification (`fieldType: FilterFieldType.REFERENCE` +
      *   `referenceTargetResourceType`) so the filter UI renders reference
      *   selectors for FK fields instead of raw ID inputs.
      *

package/dist/esm/components/resources/resourceLayout.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceLayout.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/resources/resourceLayout.utils.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,gCAAgC,EAChC,uCAAuC,EACvC,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAG7E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,cAAc,EAAE,gCAAgC,CAAC;IACjD,SAAS,EAAE,uCAAuC,CAAC;IACnD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAC7E,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;CAC5E;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO;IAEP;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,mBAAmB,CACxB,cAAc,EAAE,gCAAgC,GAAG,SAAS,GAC3D,MAAM,EAAE;IAIX;;;;OAIG;IACH,MAAM,CAAC,yBAAyB,CAAC,CAAC,SAAS;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC9D,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GAC1D,CAAC,EAAE;IAKN;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EACxB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAC1C,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GAC1D,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;IAI7B;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gCAAgC;IAwC/C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,2BAA2B,CAChC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACpD,gBAAgB,CAAC,EAAE,2BAA2B,GAC7C,SAAS,qBAAqB,EAAE;CAiFpC"}
+{"version":3,"file":"resourceLayout.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/resourceLayout.utils.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,mCAAmC,EAGzC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,gCAAgC,EAChC,uCAAuC,EACvC,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,cAAc,EAAE,gCAAgC,CAAC;IACjD,SAAS,EAAE,uCAAuC,CAAC;IACnD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAC7E,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;CAC5E;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO;IAEP;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,mBAAmB,CACxB,cAAc,EAAE,gCAAgC,GAAG,SAAS,GAC3D,MAAM,EAAE;IAIX;;;;OAIG;IACH,MAAM,CAAC,yBAAyB,CAAC,CAAC,SAAS;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC9D,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GAC1D,CAAC,EAAE;IAKN;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EACxB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAC1C,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GAC1D,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;IAI7B;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAKlD;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,aAAa,EAAE,CAAC,CAAC;QAAC,eAAe,EAAE,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,CAAC;IAIjI;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,mCAAmC,GAAG,SAAS;IAOtF;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gCAAgC;IAwC/C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,2BAA2B,CAChC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACpD,gBAAgB,CAAC,EAAE,2BAA2B,GAC7C,SAAS,qBAAqB,EAAE;CAiFpC"}

package/dist/esm/components/resources/resourceLayout.utils.js

@@ -1,5 +1,6 @@
 import { getSchemaType, FieldSchemaType, getEnumValues, unwrapSchema, } from '@wildo-ai/zod-decorators';
-import { PRIMARY_SCOPE_TO_FIELD_IDENTIFIER, isResourcesFilterNumberRangeSchema, } from '@wildo-ai/saas-models';
+import { CoreResourceOperation, PRIMARY_SCOPE_TO_FIELD_IDENTIFIER, isResourcesFilterNumberRangeSchema, } from '@wildo-ai/saas-models';
+import { FilterFieldType } from './resource-filter-field-type.frontend.schemas.js';
 import { FrontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
 /**
  * Static utility class for ResourceLayout non-component logic.
@@ -43,6 +44,38 @@ export class ResourceLayoutUtils {
     static withPinnedFilters(readerFilters, pinnedFilters) {
         return { ...readerFilters, ...(pinnedFilters ?? {}) };
     }
+    /**
+     * The variant key of an operation a layout shows, or `null` for its unkeyed variant. ONE reading, shared by the export
+     * filter (#2705) and the listing a match selection names (#2718).
+     */
+    static variantKeyOf(shown) {
+        const key = shown?.variantKey;
+        return typeof key === 'string' && key.length > 0 ? key : null;
+    }
+    /**
+     * The operation a LIST layout's rows came from: its inline SEARCH while a term is typed (and it has one), else its list.
+     * The same choice its fetch makes, so a list view with no term never claims to be a search.
+     */
+    static listingOperationShown(params) {
+        return params.inlineSearchTerm && params.searchOperation ? params.searchOperation : params.listOperation;
+    }
+    /**
+     * The listing a "select all matching" selection came from (#2718): the collection operation the layout ran and the
+     * variant of it, read from the SAME operation object its request is keyed by. The server re-runs exactly that one, so
+     * a keyed listing (`directory`) and a search view with no term are re-run as what the person saw, never as the default
+     * list.
+     *
+     * `undefined` for a listing run by a CUSTOM operation that only acts like a list or a search (`listMyRequests`): the
+     * wire can name only LIST and SEARCH, and the server would re-run the default list in its place, a different and
+     * usually wider population. A layout offers no "select all matching" then (fail closed).
+     */
+    static matchListingOf(shown) {
+        const identifier = shown?.operationIdentifier;
+        if (identifier !== CoreResourceOperation.LIST && identifier !== CoreResourceOperation.SEARCH)
+            return undefined;
+        const variantKey = ResourceLayoutUtils.variantKeyOf(shown);
+        return { operation: identifier, ...(variantKey ? { variantKey } : {}) };
+    }
     /**
      * Compute the set of filter-field names that the transport already pins for
      * the given operation in the current context. See
@@ -93,7 +126,7 @@ export class ResourceLayoutUtils {
      * When `transportContext` is provided, the definitions are additionally:
      * - reduced to fields the user can actually act on (transport-pinned
      *   fields are excluded — see {@link FilterFieldTransportContext}), and
-     * - enriched with foreign-key classification (`fieldType: 'reference'` +
+     * - enriched with foreign-key classification (`fieldType: FilterFieldType.REFERENCE` +
      *   `referenceTargetResourceType`) so the filter UI renders reference
      *   selectors for FK fields instead of raw ID inputs.
      *
@@ -121,29 +154,29 @@ export class ResourceLayoutUtils {
                 continue;
             const schema = rawSchema;
             const schemaType = getSchemaType(schema);
-            let fieldType = 'unknown';
+            let fieldType = FilterFieldType.UNKNOWN;
             // The NUMERIC RANGE is recognised before the type switch, because `getSchemaType` sees an
             // object and answers with whatever it answers for objects. It is not a shape the switch
             // could classify anyway: the vocabulary is what identifies it, not the type of its members.
             if (isResourcesFilterNumberRangeSchema(schema)) {
-                definitions.push({ fieldName, schema, fieldType: 'numberRange', enumValues: undefined, referenceTargetResourceType: undefined });
+                definitions.push({ fieldName, schema, fieldType: FilterFieldType.NUMBER_RANGE, enumValues: undefined, referenceTargetResourceType: undefined });
                 continue;
             }
             let enumValues;
             let referenceTargetResourceType;
             switch (schemaType) {
                 case FieldSchemaType.STRING:
-                    fieldType = 'string';
+                    fieldType = FilterFieldType.STRING;
                     break;
                 case FieldSchemaType.NUMBER:
                 case FieldSchemaType.BIGDECIMAL:
-                    fieldType = 'number';
+                    fieldType = FilterFieldType.NUMBER;
                     break;
                 case FieldSchemaType.BOOLEAN:
-                    fieldType = 'boolean';
+                    fieldType = FilterFieldType.BOOLEAN;
                     break;
                 case FieldSchemaType.ENUM:
-                    fieldType = 'enum';
+                    fieldType = FilterFieldType.ENUM;
                     try {
                         enumValues = getEnumValues(unwrapSchema(schema));
                     }
@@ -153,15 +186,15 @@ export class ResourceLayoutUtils {
                     break;
                 case FieldSchemaType.DATE:
                 case FieldSchemaType.DATETIME:
-                    fieldType = 'date';
+                    fieldType = FilterFieldType.DATE;
                     break;
                 default:
-                    fieldType = 'string';
+                    fieldType = FilterFieldType.STRING;
             }
             // FK classification: a string filter whose field name resolves through
             // the relationship-enriched registry map IS a reference filter — the
             // value space is "ids of the target resource", not free text.
-            if (fieldType === 'string' && transportContext) {
+            if (fieldType === FilterFieldType.STRING && transportContext) {
                 const targetResourceType = transportContext.registry.fieldIdentifierToResourceType?.[fieldName];
                 if (targetResourceType) {
                     // A string filter whose field name resolves through the
@@ -169,7 +202,7 @@ export class ResourceLayoutUtils {
                     // space is "ids of the target resource", not free text. The picker
                     // searches the target (scope-required scoping is inferred at fetch time
                     // from `registry.manyToManyScopeJunctions`; no surface declaration).
-                    fieldType = 'reference';
+                    fieldType = FilterFieldType.REFERENCE;
                     referenceTargetResourceType = targetResourceType;
                 }
             }

package/dist/esm/components/resources/resourceLayout.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resourceLayout.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/resourceLayout.utils.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iCAAiC,EAGjC,kCAAkC,GACnC,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAkCnG;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAC9B,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,mBAAmB,CACxB,cAA4D;QAE5D,OAAO,qBAAqB,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,yBAAyB,CAC9B,MAAoB,EACpB,aAA2D;QAE3D,IAAI,CAAC,aAAa;YAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACzG,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CACtB,aAA0C,EAC1C,aAA2D;QAE3D,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IAED;;;;;;;;OAQG;IACK,MAAM,CAAC,gCAAgC,CAC7C,OAAoC;QAEpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QAEjC,wEAAwE;QACxE,0EAA0E;QAC1E,mEAAmE;QACnE,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC;QACjE,MAAM,2BAA2B,GAAG,YAAY;YAC9C,CAAC,CAAC,iCAAiC,CAAC,YAAY,CAAC;YACjD,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,2BAA2B,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAC1C,CAAC;QAED,yEAAyE;QACzE,yEAAyE;QACzE,yDAAyD;QACzD,MAAM,cAAc,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,SAAS;YAC3D,CAAC,CAAE,OAAO,CAAC,SAAqF,CAAC,cAAc;YAC/G,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAErB,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,+BAA+B,CAAC;gBACrE,cAAc;gBACd,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;gBAClD,kBAAkB,EAAE,OAAO,CAAC,cAAc,CAAC,kBAAkC;gBAC7E,4BAA4B,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,uBAAuB,IAAI,EAAE,CAAC;gBAC1F,2BAA2B,EAAE,OAAO,CAAC,2BAA2B;aACjE,CAAC,CAAC;YAEH,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,2BAA2B,CAChC,eAAoD,EACpD,gBAA8C;QAE9C,IAAI,CAAC,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEvE,MAAM,gBAAgB,GAAG,gBAAgB;YACvC,CAAC,CAAC,mBAAmB,CAAC,gCAAgC,CAAC,gBAAgB,CAAC;YACxE,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,WAAW,GAA4B,EAAE,CAAC;QAEhD,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YACrE,IAAI,OAAO,SAAS,KAAK,UAAU;gBAAE,SAAS;YAC9C,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,SAAS;YAC1D,IAAI,gBAAgB,EAAE,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS;YAC/C,6FAA6F;YAC7F,sFAAsF;YACtF,IAAI,SAAS,KAAK,KAAK;gBAAE,SAAS;YAElC,MAAM,MAAM,GAAG,SAAyB,CAAC;YACzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,SAAS,GAAuC,SAAS,CAAC;YAE9D,0FAA0F;YAC1F,wFAAwF;YACxF,4FAA4F;YAC5F,IAAI,kCAAkC,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,2BAA2B,EAAE,SAAS,EAAE,CAAC,CAAC;gBACjI,SAAS;YACX,CAAC;YACD,IAAI,UAAyC,CAAC;YAC9C,IAAI,2BAA+C,CAAC;YAEpD,QAAQ,UAAU,EAAE,CAAC;gBACnB,KAAK,eAAe,CAAC,MAAM;oBACzB,SAAS,GAAG,QAAQ,CAAC;oBACrB,MAAM;gBACR,KAAK,eAAe,CAAC,MAAM,CAAC;gBAC5B,KAAK,eAAe,CAAC,UAAU;oBAC7B,SAAS,GAAG,QAAQ,CAAC;oBACrB,MAAM;gBACR,KAAK,eAAe,CAAC,OAAO;oBAC1B,SAAS,GAAG,SAAS,CAAC;oBACtB,MAAM;gBACR,KAAK,eAAe,CAAC,IAAI;oBACvB,SAAS,GAAG,MAAM,CAAC;oBACnB,IAAI,CAAC;wBACH,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;oBACnD,CAAC;oBAAC,MAAM,CAAC;wBACP,UAAU,GAAG,EAAE,CAAC;oBAClB,CAAC;oBACD,MAAM;gBACR,KAAK,eAAe,CAAC,IAAI,CAAC;gBAC1B,KAAK,eAAe,CAAC,QAAQ;oBAC3B,SAAS,GAAG,MAAM,CAAC;oBACnB,MAAM;gBACR;oBACE,SAAS,GAAG,QAAQ,CAAC;YACzB,CAAC;YAED,uEAAuE;YACvE,qEAAqE;YACrE,8DAA8D;YAC9D,IAAI,SAAS,KAAK,QAAQ,IAAI,gBAAgB,EAAE,CAAC;gBAC/C,MAAM,kBAAkB,GACtB,gBAAgB,CAAC,QAAQ,CAAC,6BAA6B,EAAE,CAAC,SAAS,CAAC,CAAC;gBACvE,IAAI,kBAAkB,EAAE,CAAC;oBACvB,wDAAwD;oBACxD,uEAAuE;oBACvE,mEAAmE;oBACnE,wEAAwE;oBACxE,qEAAqE;oBACrE,SAAS,GAAG,WAAW,CAAC;oBACxB,2BAA2B,GAAG,kBAA4B,CAAC;gBAC7D,CAAC;YACH,CAAC;YAED,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CAEF","sourcesContent":["import { z } from 'zod';\nimport {\n  getSchemaType,\n  FieldSchemaType,\n  getEnumValues,\n  unwrapSchema,\n} from '@wildo-ai/zod-decorators';\nimport {\n  PRIMARY_SCOPE_TO_FIELD_IDENTIFIER,\n  type ResourceConfiguration_Operation_UrlInitiatorInfo,\n  type ResourceType,\n  isResourcesFilterNumberRangeSchema,\n} from '@wildo-ai/saas-models';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FilterFieldDefinition } from './ResourceLayout_FiltersControl';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\n\n/**\n * Transport context for filter-field parsing.\n *\n * When provided, `parseFilterFieldDefinitions` derives two transport truths\n * that a bare `filterFields` record cannot express:\n *\n * 1. **Pinned fields** — fields whose value the transport already fixes for\n *    this operation in the current context. A user-facing filter on a pinned\n *    field is meaningless (the constraint applies before any filter could),\n *    so pinned fields are excluded from the returned definitions. The pinned\n *    set is the union of:\n *      - parameters consumed by the URL route the transport will select\n *        (computed via `FrontendResourceUtils.selectOperationUrlInitiatorInfo`\n *        — the same deterministic selection the HTTP client performs), and\n *      - the resource's primary-scope field identifier (backend authorization\n *        scope-filters the collection by it regardless of route shape, so a\n *        user-supplied value could never widen the result set).\n *\n * 2. **Reference fields** — string-typed filter fields whose name resolves to\n *    a resource type through the registry's relationship-enriched\n *    `fieldIdentifierToResourceType` map are foreign keys. They carry\n *    `fieldType: 'reference'` plus the resolved target so the filter UI can\n *    render a resource-reference selector instead of a raw ID text input.\n */\nexport interface FilterFieldTransportContext {\n  registry: FrontendResourcesRegistry;\n  resourceConfig: AnyFrontendResourceConfiguration;\n  operation: FrontendResourceConfiguration_Operation;\n  contextualParameters: Record<string, string | number | string[] | undefined>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n}\n\n/**\n * Static utility class for ResourceLayout non-component logic.\n * Centralises filter field parsing and summary field extraction used across\n * ResourceLayout_Search, ResourceLayout_List, ResourceLayout_List_Table, etc.\n */\nexport class ResourceLayoutUtils {\n  private constructor() {}\n\n  /**\n   * Detect summary fields from resource configuration via `isSummaryField()` decorator scan.\n   * Returns only explicitly annotated fields — no config overrides, no heuristic fallbacks.\n   *\n   * MOVED to {@link FrontendResourceUtils.detectSummaryFields} and delegated to from here.\n   * The scan is no longer a layout concern alone: the record-label fallback\n   * (`getResourceLabel`) needs the same answer, and it lives one layer down in\n   * `frontend-resource.utils`, which this module already imports. Defining it there and\n   * delegating up keeps ONE definition without an import cycle; a second copy would have\n   * drifted the moment either set of exclusions changed.\n   *\n   * Kept as a member of this class because three layout call sites and a test address it by\n   * this name, and the name is right for them.\n   */\n  static detectSummaryFields(\n    resourceConfig: AnyFrontendResourceConfiguration | undefined,\n  ): string[] {\n    return FrontendResourceUtils.detectSummaryFields(resourceConfig);\n  }\n\n  /**\n   * The filter fields a READER may set, given the host's pins (#1630): a field the host pinned through\n   * `FrontendResourceOperationContext.pinnedFilters` is fixed on every fetch, so offering it in the panel would\n   * offer a choice that changes nothing. The one definition both collection layouts (LIST, SEARCH) use.\n   */\n  static withoutPinnedFilterFields<T extends { fieldName: string }>(\n    fields: readonly T[],\n    pinnedFilters: Readonly<Record<string, string>> | undefined,\n  ): T[] {\n    if (!pinnedFilters) return [...fields];\n    return fields.filter((field) => !Object.prototype.hasOwnProperty.call(pinnedFilters, field.fieldName));\n  }\n\n  /**\n   * The filters a collection fetch sends: the reader's, then the host's pins on top (#1630). A pin wins over a\n   * reader's value for the same key, so an embed pinned to one record can never be widened to another. The one\n   * definition both collection layouts use, for SEARCH filters and LIST query parameters alike.\n   */\n  static withPinnedFilters<V>(\n    readerFilters: Readonly<Record<string, V>>,\n    pinnedFilters: Readonly<Record<string, string>> | undefined,\n  ): Record<string, V | string> {\n    return { ...readerFilters, ...(pinnedFilters ?? {}) };\n  }\n\n  /**\n   * Compute the set of filter-field names that the transport already pins for\n   * the given operation in the current context. See\n   * {@link FilterFieldTransportContext} for the semantics of each component.\n   *\n   * Returns an empty set when the operation carries no URL surface (e.g.\n   * non-URL variants) — primary-scope pinning still applies because backend\n   * authorization enforces it independently of routing.\n   */\n  private static computeTransportPinnedFieldNames(\n    context: FilterFieldTransportContext,\n  ): Set<string> {\n    const pinned = new Set<string>();\n\n    // Primary-scope FK: always pinned. The backend injects the scope filter\n    // from the authenticated execution context — a user-supplied filter value\n    // either duplicates it or gets rejected; neither is a real filter.\n    const primaryScope = context.resourceConfig.resourcePrimaryScope;\n    const primaryScopeFieldIdentifier = primaryScope\n      ? PRIMARY_SCOPE_TO_FIELD_IDENTIFIER[primaryScope]\n      : undefined;\n    if (primaryScopeFieldIdentifier) {\n      pinned.add(primaryScopeFieldIdentifier);\n    }\n\n    // URL-route parameters: pinned when the deterministically selected route\n    // consumes them. Mirrors the HTTP client's selection exactly — both call\n    // FrontendResourceUtils.selectOperationUrlInitiatorInfo.\n    const initiatorInfos = ('initiatorInfos' in context.operation\n      ? (context.operation as { initiatorInfos?: ResourceConfiguration_Operation_UrlInitiatorInfo[] }).initiatorInfos\n      : undefined) ?? [];\n\n    if (initiatorInfos.length > 0) {\n      const selected = FrontendResourceUtils.selectOperationUrlInitiatorInfo({\n        initiatorInfos,\n        contextualParameters: context.contextualParameters,\n        targetResourceType: context.resourceConfig.resourceIdentifier as ResourceType,\n        targetDefaultFieldIdentifier: String(context.resourceConfig.resourceFieldIdentifier ?? ''),\n        parentResourcesRequirements: context.parentResourcesRequirements,\n      });\n\n      for (const parameter of selected?.parameters ?? []) {\n        pinned.add(parameter.fieldIdentifier);\n      }\n    }\n\n    return pinned;\n  }\n\n  /**\n   * Parse raw filterFields (Record) into FilterFieldDefinition[].\n   * Used when reading directly from an operation object (LIST or SEARCH).\n   * Skips function-typed entries (filter references) and maps each field's\n   * Zod schema to a UI-friendly type.\n   *\n   * When `transportContext` is provided, the definitions are additionally:\n   * - reduced to fields the user can actually act on (transport-pinned\n   *   fields are excluded — see {@link FilterFieldTransportContext}), and\n   * - enriched with foreign-key classification (`fieldType: 'reference'` +\n   *   `referenceTargetResourceType`) so the filter UI renders reference\n   *   selectors for FK fields instead of raw ID inputs.\n   *\n   * Without `transportContext` the parse is purely structural (schema-type\n   * mapping only) — callers that have no operation/registry at hand keep the\n   * legacy behavior.\n   */\n  static parseFilterFieldDefinitions(\n    rawFilterFields: Record<string, unknown> | undefined,\n    transportContext?: FilterFieldTransportContext,\n  ): readonly FilterFieldDefinition[] {\n    if (!rawFilterFields || typeof rawFilterFields !== 'object') return [];\n\n    const pinnedFieldNames = transportContext\n      ? ResourceLayoutUtils.computeTransportPinnedFieldNames(transportContext)\n      : undefined;\n\n    const definitions: FilterFieldDefinition[] = [];\n\n    for (const [fieldName, rawSchema] of Object.entries(rawFilterFields)) {\n      if (typeof rawSchema === 'function') continue;\n      if (!rawSchema || typeof rawSchema !== 'object') continue;\n      if (pinnedFieldNames?.has(fieldName)) continue;\n      // A raw primary key is a MACHINE filter — how the framework resolves one referenced record's\n      // label through a scoped search (#1661) — never something a person narrows a list by.\n      if (fieldName === '_id') continue;\n\n      const schema = rawSchema as z.ZodTypeAny;\n      const schemaType = getSchemaType(schema);\n      let fieldType: FilterFieldDefinition['fieldType'] = 'unknown';\n\n      // The NUMERIC RANGE is recognised before the type switch, because `getSchemaType` sees an\n      // object and answers with whatever it answers for objects. It is not a shape the switch\n      // could classify anyway: the vocabulary is what identifies it, not the type of its members.\n      if (isResourcesFilterNumberRangeSchema(schema)) {\n        definitions.push({ fieldName, schema, fieldType: 'numberRange', enumValues: undefined, referenceTargetResourceType: undefined });\n        continue;\n      }\n      let enumValues: readonly string[] | undefined;\n      let referenceTargetResourceType: string | undefined;\n\n      switch (schemaType) {\n        case FieldSchemaType.STRING:\n          fieldType = 'string';\n          break;\n        case FieldSchemaType.NUMBER:\n        case FieldSchemaType.BIGDECIMAL:\n          fieldType = 'number';\n          break;\n        case FieldSchemaType.BOOLEAN:\n          fieldType = 'boolean';\n          break;\n        case FieldSchemaType.ENUM:\n          fieldType = 'enum';\n          try {\n            enumValues = getEnumValues(unwrapSchema(schema));\n          } catch {\n            enumValues = [];\n          }\n          break;\n        case FieldSchemaType.DATE:\n        case FieldSchemaType.DATETIME:\n          fieldType = 'date';\n          break;\n        default:\n          fieldType = 'string';\n      }\n\n      // FK classification: a string filter whose field name resolves through\n      // the relationship-enriched registry map IS a reference filter — the\n      // value space is \"ids of the target resource\", not free text.\n      if (fieldType === 'string' && transportContext) {\n        const targetResourceType =\n          transportContext.registry.fieldIdentifierToResourceType?.[fieldName];\n        if (targetResourceType) {\n          // A string filter whose field name resolves through the\n          // relationship-enriched registry map IS a reference filter — the value\n          // space is \"ids of the target resource\", not free text. The picker\n          // searches the target (scope-required scoping is inferred at fetch time\n          // from `registry.manyToManyScopeJunctions`; no surface declaration).\n          fieldType = 'reference';\n          referenceTargetResourceType = targetResourceType as string;\n        }\n      }\n\n      definitions.push({ fieldName, schema, fieldType, enumValues, referenceTargetResourceType });\n    }\n\n    return definitions;\n  }\n\n}\n"]}
+{"version":3,"file":"resourceLayout.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources/resourceLayout.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {\n  getSchemaType,\n  FieldSchemaType,\n  getEnumValues,\n  unwrapSchema,\n} from '@wildo-ai/zod-decorators';\nimport {\n  CoreResourceOperation,\n  PRIMARY_SCOPE_TO_FIELD_IDENTIFIER,\n  type ResourceConfiguration_Operation_UrlInitiatorInfo,\n  type Resources_BulkOperationMatchListing,\n  type ResourceType,\n  isResourcesFilterNumberRangeSchema,\n} from '@wildo-ai/saas-models';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FilterFieldDefinition } from './ResourceLayout_FiltersControl';\nimport { FilterFieldType } from './resource-filter-field-type.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\n\n/**\n * Transport context for filter-field parsing.\n *\n * When provided, `parseFilterFieldDefinitions` derives two transport truths\n * that a bare `filterFields` record cannot express:\n *\n * 1. **Pinned fields** — fields whose value the transport already fixes for\n *    this operation in the current context. A user-facing filter on a pinned\n *    field is meaningless (the constraint applies before any filter could),\n *    so pinned fields are excluded from the returned definitions. The pinned\n *    set is the union of:\n *      - parameters consumed by the URL route the transport will select\n *        (computed via `FrontendResourceUtils.selectOperationUrlInitiatorInfo`\n *        — the same deterministic selection the HTTP client performs), and\n *      - the resource's primary-scope field identifier (backend authorization\n *        scope-filters the collection by it regardless of route shape, so a\n *        user-supplied value could never widen the result set).\n *\n * 2. **Reference fields** — string-typed filter fields whose name resolves to\n *    a resource type through the registry's relationship-enriched\n *    `fieldIdentifierToResourceType` map are foreign keys. They carry\n *    `fieldType: FilterFieldType.REFERENCE` plus the resolved target so the filter UI can\n *    render a resource-reference selector instead of a raw ID text input.\n */\nexport interface FilterFieldTransportContext {\n  registry: FrontendResourcesRegistry;\n  resourceConfig: AnyFrontendResourceConfiguration;\n  operation: FrontendResourceConfiguration_Operation;\n  contextualParameters: Record<string, string | number | string[] | undefined>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n}\n\n/**\n * Static utility class for ResourceLayout non-component logic.\n * Centralises filter field parsing and summary field extraction used across\n * ResourceLayout_Search, ResourceLayout_List, ResourceLayout_List_Table, etc.\n */\nexport class ResourceLayoutUtils {\n  private constructor() {}\n\n  /**\n   * Detect summary fields from resource configuration via `isSummaryField()` decorator scan.\n   * Returns only explicitly annotated fields — no config overrides, no heuristic fallbacks.\n   *\n   * MOVED to {@link FrontendResourceUtils.detectSummaryFields} and delegated to from here.\n   * The scan is no longer a layout concern alone: the record-label fallback\n   * (`getResourceLabel`) needs the same answer, and it lives one layer down in\n   * `frontend-resource.utils`, which this module already imports. Defining it there and\n   * delegating up keeps ONE definition without an import cycle; a second copy would have\n   * drifted the moment either set of exclusions changed.\n   *\n   * Kept as a member of this class because three layout call sites and a test address it by\n   * this name, and the name is right for them.\n   */\n  static detectSummaryFields(\n    resourceConfig: AnyFrontendResourceConfiguration | undefined,\n  ): string[] {\n    return FrontendResourceUtils.detectSummaryFields(resourceConfig);\n  }\n\n  /**\n   * The filter fields a READER may set, given the host's pins (#1630): a field the host pinned through\n   * `FrontendResourceOperationContext.pinnedFilters` is fixed on every fetch, so offering it in the panel would\n   * offer a choice that changes nothing. The one definition both collection layouts (LIST, SEARCH) use.\n   */\n  static withoutPinnedFilterFields<T extends { fieldName: string }>(\n    fields: readonly T[],\n    pinnedFilters: Readonly<Record<string, string>> | undefined,\n  ): T[] {\n    if (!pinnedFilters) return [...fields];\n    return fields.filter((field) => !Object.prototype.hasOwnProperty.call(pinnedFilters, field.fieldName));\n  }\n\n  /**\n   * The filters a collection fetch sends: the reader's, then the host's pins on top (#1630). A pin wins over a\n   * reader's value for the same key, so an embed pinned to one record can never be widened to another. The one\n   * definition both collection layouts use, for SEARCH filters and LIST query parameters alike.\n   */\n  static withPinnedFilters<V>(\n    readerFilters: Readonly<Record<string, V>>,\n    pinnedFilters: Readonly<Record<string, string>> | undefined,\n  ): Record<string, V | string> {\n    return { ...readerFilters, ...(pinnedFilters ?? {}) };\n  }\n\n  /**\n   * The variant key of an operation a layout shows, or `null` for its unkeyed variant. ONE reading, shared by the export\n   * filter (#2705) and the listing a match selection names (#2718).\n   */\n  static variantKeyOf(shown: unknown): string | null {\n    const key = (shown as { variantKey?: unknown } | null | undefined)?.variantKey;\n    return typeof key === 'string' && key.length > 0 ? key : null;\n  }\n\n  /**\n   * The operation a LIST layout's rows came from: its inline SEARCH while a term is typed (and it has one), else its list.\n   * The same choice its fetch makes, so a list view with no term never claims to be a search.\n   */\n  static listingOperationShown<T>(params: { inlineSearchTerm: string | undefined; listOperation: T; searchOperation: T | null }): T {\n    return params.inlineSearchTerm && params.searchOperation ? params.searchOperation : params.listOperation;\n  }\n\n  /**\n   * The listing a \"select all matching\" selection came from (#2718): the collection operation the layout ran and the\n   * variant of it, read from the SAME operation object its request is keyed by. The server re-runs exactly that one, so\n   * a keyed listing (`directory`) and a search view with no term are re-run as what the person saw, never as the default\n   * list.\n   *\n   * `undefined` for a listing run by a CUSTOM operation that only acts like a list or a search (`listMyRequests`): the\n   * wire can name only LIST and SEARCH, and the server would re-run the default list in its place, a different and\n   * usually wider population. A layout offers no \"select all matching\" then (fail closed).\n   */\n  static matchListingOf(shown: unknown): Resources_BulkOperationMatchListing | undefined {\n    const identifier = (shown as { operationIdentifier?: unknown } | null | undefined)?.operationIdentifier;\n    if (identifier !== CoreResourceOperation.LIST && identifier !== CoreResourceOperation.SEARCH) return undefined;\n    const variantKey = ResourceLayoutUtils.variantKeyOf(shown);\n    return { operation: identifier, ...(variantKey ? { variantKey } : {}) };\n  }\n\n  /**\n   * Compute the set of filter-field names that the transport already pins for\n   * the given operation in the current context. See\n   * {@link FilterFieldTransportContext} for the semantics of each component.\n   *\n   * Returns an empty set when the operation carries no URL surface (e.g.\n   * non-URL variants) — primary-scope pinning still applies because backend\n   * authorization enforces it independently of routing.\n   */\n  private static computeTransportPinnedFieldNames(\n    context: FilterFieldTransportContext,\n  ): Set<string> {\n    const pinned = new Set<string>();\n\n    // Primary-scope FK: always pinned. The backend injects the scope filter\n    // from the authenticated execution context — a user-supplied filter value\n    // either duplicates it or gets rejected; neither is a real filter.\n    const primaryScope = context.resourceConfig.resourcePrimaryScope;\n    const primaryScopeFieldIdentifier = primaryScope\n      ? PRIMARY_SCOPE_TO_FIELD_IDENTIFIER[primaryScope]\n      : undefined;\n    if (primaryScopeFieldIdentifier) {\n      pinned.add(primaryScopeFieldIdentifier);\n    }\n\n    // URL-route parameters: pinned when the deterministically selected route\n    // consumes them. Mirrors the HTTP client's selection exactly — both call\n    // FrontendResourceUtils.selectOperationUrlInitiatorInfo.\n    const initiatorInfos = ('initiatorInfos' in context.operation\n      ? (context.operation as { initiatorInfos?: ResourceConfiguration_Operation_UrlInitiatorInfo[] }).initiatorInfos\n      : undefined) ?? [];\n\n    if (initiatorInfos.length > 0) {\n      const selected = FrontendResourceUtils.selectOperationUrlInitiatorInfo({\n        initiatorInfos,\n        contextualParameters: context.contextualParameters,\n        targetResourceType: context.resourceConfig.resourceIdentifier as ResourceType,\n        targetDefaultFieldIdentifier: String(context.resourceConfig.resourceFieldIdentifier ?? ''),\n        parentResourcesRequirements: context.parentResourcesRequirements,\n      });\n\n      for (const parameter of selected?.parameters ?? []) {\n        pinned.add(parameter.fieldIdentifier);\n      }\n    }\n\n    return pinned;\n  }\n\n  /**\n   * Parse raw filterFields (Record) into FilterFieldDefinition[].\n   * Used when reading directly from an operation object (LIST or SEARCH).\n   * Skips function-typed entries (filter references) and maps each field's\n   * Zod schema to a UI-friendly type.\n   *\n   * When `transportContext` is provided, the definitions are additionally:\n   * - reduced to fields the user can actually act on (transport-pinned\n   *   fields are excluded — see {@link FilterFieldTransportContext}), and\n   * - enriched with foreign-key classification (`fieldType: FilterFieldType.REFERENCE` +\n   *   `referenceTargetResourceType`) so the filter UI renders reference\n   *   selectors for FK fields instead of raw ID inputs.\n   *\n   * Without `transportContext` the parse is purely structural (schema-type\n   * mapping only) — callers that have no operation/registry at hand keep the\n   * legacy behavior.\n   */\n  static parseFilterFieldDefinitions(\n    rawFilterFields: Record<string, unknown> | undefined,\n    transportContext?: FilterFieldTransportContext,\n  ): readonly FilterFieldDefinition[] {\n    if (!rawFilterFields || typeof rawFilterFields !== 'object') return [];\n\n    const pinnedFieldNames = transportContext\n      ? ResourceLayoutUtils.computeTransportPinnedFieldNames(transportContext)\n      : undefined;\n\n    const definitions: FilterFieldDefinition[] = [];\n\n    for (const [fieldName, rawSchema] of Object.entries(rawFilterFields)) {\n      if (typeof rawSchema === 'function') continue;\n      if (!rawSchema || typeof rawSchema !== 'object') continue;\n      if (pinnedFieldNames?.has(fieldName)) continue;\n      // A raw primary key is a MACHINE filter — how the framework resolves one referenced record's\n      // label through a scoped search (#1661) — never something a person narrows a list by.\n      if (fieldName === '_id') continue;\n\n      const schema = rawSchema as z.ZodTypeAny;\n      const schemaType = getSchemaType(schema);\n      let fieldType: FilterFieldType = FilterFieldType.UNKNOWN;\n\n      // The NUMERIC RANGE is recognised before the type switch, because `getSchemaType` sees an\n      // object and answers with whatever it answers for objects. It is not a shape the switch\n      // could classify anyway: the vocabulary is what identifies it, not the type of its members.\n      if (isResourcesFilterNumberRangeSchema(schema)) {\n        definitions.push({ fieldName, schema, fieldType: FilterFieldType.NUMBER_RANGE, enumValues: undefined, referenceTargetResourceType: undefined });\n        continue;\n      }\n      let enumValues: readonly string[] | undefined;\n      let referenceTargetResourceType: string | undefined;\n\n      switch (schemaType) {\n        case FieldSchemaType.STRING:\n          fieldType = FilterFieldType.STRING;\n          break;\n        case FieldSchemaType.NUMBER:\n        case FieldSchemaType.BIGDECIMAL:\n          fieldType = FilterFieldType.NUMBER;\n          break;\n        case FieldSchemaType.BOOLEAN:\n          fieldType = FilterFieldType.BOOLEAN;\n          break;\n        case FieldSchemaType.ENUM:\n          fieldType = FilterFieldType.ENUM;\n          try {\n            enumValues = getEnumValues(unwrapSchema(schema));\n          } catch {\n            enumValues = [];\n          }\n          break;\n        case FieldSchemaType.DATE:\n        case FieldSchemaType.DATETIME:\n          fieldType = FilterFieldType.DATE;\n          break;\n        default:\n          fieldType = FilterFieldType.STRING;\n      }\n\n      // FK classification: a string filter whose field name resolves through\n      // the relationship-enriched registry map IS a reference filter — the\n      // value space is \"ids of the target resource\", not free text.\n      if (fieldType === FilterFieldType.STRING && transportContext) {\n        const targetResourceType =\n          transportContext.registry.fieldIdentifierToResourceType?.[fieldName];\n        if (targetResourceType) {\n          // A string filter whose field name resolves through the\n          // relationship-enriched registry map IS a reference filter — the value\n          // space is \"ids of the target resource\", not free text. The picker\n          // searches the target (scope-required scoping is inferred at fetch time\n          // from `registry.manyToManyScopeJunctions`; no surface declaration).\n          fieldType = FilterFieldType.REFERENCE;\n          referenceTargetResourceType = targetResourceType as string;\n        }\n      }\n\n      definitions.push({ fieldName, schema, fieldType, enumValues, referenceTargetResourceType });\n    }\n\n    return definitions;\n  }\n\n}\n"]}

package/dist/esm/components/resources/skeleton/ArrayField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayField.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/ArrayField.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAS9C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,eAAe,GAAG,SAAS,CAyD7B"}
+{"version":3,"file":"ArrayField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ArrayField.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAW9C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,eAAe,GAAG,SAAS,CAiE7B"}

package/dist/esm/components/resources/skeleton/ArrayField.js

@@ -8,6 +8,8 @@ import { useI18n } from '../../../core/i18n/useI18n.js';
 import { FieldScopeProvider, useResolvedFieldName } from './FieldScopeContext.js';
 import { ArrayItemTemplate } from './ArrayItemTemplate.js';
 import { declarePlacesNamedField } from '../../form/automated/TemplatePlacedFieldsContext.js';
+import { useSectionFieldRegistration } from './SectionFieldsContext.js';
+import { useWizardFieldRegistration } from './WizardStepFieldsContext.js';
 /**
  * Array container for array-of-object fields.
  *
@@ -36,6 +38,14 @@ export function ArrayField({ name, className, addLabel, removeLabel, minItems, m
     const resolvedName = useResolvedFieldName(name);
     const { control } = useFormContext();
     const { fields, append, remove } = useFieldArray({ control, name: resolvedName });
+    /*
+     * The ARRAY is one of the section's (and the wizard step's) fields, not only its items' leaves. Registered by its
+     * leaves alone (`steps[0].title`), a section save wrote those leaves onto the STORED array: an item the person had
+     * removed came back, and reordered items mixed their values. An array is written whole, as every other array
+     * editor writes it; registering the root is what tells the save so, and what lets the wizard check it.
+     */
+    useSectionFieldRegistration(resolvedName);
+    useWizardFieldRegistration(resolvedName);
     const { tComponent, isReady } = useI18n({
         component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,
     });

package/dist/esm/components/resources/skeleton/ArrayField.js.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayField.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ArrayField.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { type ReactNode } from 'react';\nimport { useFieldArray, useFormContext } from 'react-hook-form';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FieldScopeProvider, useResolvedFieldName } from './FieldScopeContext';\nimport { ArrayItemTemplate } from './ArrayItemTemplate';\nimport { declarePlacesNamedField } from '../../form/automated/TemplatePlacedFieldsContext';\n\nexport interface ArrayFieldProps {\n  /**\n   * Name of the array field in the parent schema.\n   * The component iterates over items and renders `<ArrayItemTemplate>`\n   * children for each item, with scoped field names.\n   */\n  name: string;\n  /** Additional CSS classes for the array container. */\n  className?: string;\n  /** Label for the \"Add\" button. Falls back to i18n default. */\n  addLabel?: string;\n  /** Label for each \"Remove\" button. Falls back to i18n default. */\n  removeLabel?: string;\n  /** Minimum number of items (disables remove when at minimum). */\n  minItems?: number;\n  /** Maximum number of items (disables add when at maximum). */\n  maxItems?: number;\n  children: ReactNode;\n}\n\n/**\n * Array container for array-of-object fields.\n *\n * Iterates over current items (from RHF field array state),\n * rendering `<ArrayItemTemplate>` children for each item with\n * a scoped `FieldScopeContext` (`\"{name}.{index}\"`).\n *\n * Provides add/remove infrastructure. For arrays of primitives\n * (e.g., `z.array(z.string())`), use `<FormField name=\"tags\" />`\n * directly — no `<ArrayField>` needed.\n *\n * @example\n * ```tsx\n * <ArrayField name=\"addresses\" className=\"space-y-4\">\n *   <ArrayItemTemplate>\n *     <div className=\"grid grid-cols-2 gap-4\">\n *       <FormField name=\"street\" className=\"col-span-2\" />\n *       <FormField name=\"city\" />\n *       <FormField name=\"zipCode\" />\n *     </div>\n *   </ArrayItemTemplate>\n * </ArrayField>\n * ```\n */\nexport function ArrayField({\n  name,\n  className,\n  addLabel,\n  removeLabel,\n  minItems,\n  maxItems,\n  children,\n}: ArrayFieldProps): ReactNode {\n  const resolvedName = useResolvedFieldName(name);\n  const { control } = useFormContext();\n  const { fields, append, remove } = useFieldArray({ control, name: resolvedName });\n\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  if (!isReady) return null;\n\n  const itemTemplate = findItemTemplate(children);\n\n  const canAdd = maxItems === undefined || fields.length < maxItems;\n  const canRemove = minItems === undefined || fields.length > minItems;\n\n  // Shared LOW_LEVEL_FORM_MESSAGE vocabulary with the automated AutomatedArrayField —\n  // one key per concept (arrayAddItem / arrayItemLabel / arrayRemoveItem), so\n  // handwritten and generated array UIs stay wording-consistent.\n  const effectiveAddLabel = addLabel ?? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'arrayAddItem');\n  const itemBaseLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'arrayItemLabel');\n\n  return (\n    <div className={className} data-guidance-array={name}>\n      {fields.map((field, index) => (\n        <div key={field.id} className=\"relative\" data-guidance-array-item={index}>\n          <FieldScopeProvider pathPrefix={`${resolvedName}[${index}]`}>\n            {itemTemplate ? React.cloneElement(itemTemplate) : null}\n          </FieldScopeProvider>\n          {canRemove && (\n            <Button\n              type=\"button\"\n              variant={ButtonVariants_Variant.GHOST}\n              onClick={() => remove(index)}\n              className=\"mt-1\"\n            >\n              {removeLabel\n                ?? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'arrayRemoveItem', {\n                  label: `${itemBaseLabel} ${index + 1}`,\n                })}\n            </Button>\n          )}\n        </div>\n      ))}\n\n      {canAdd && (\n        <Button\n          type=\"button\"\n          variant={ButtonVariants_Variant.OUTLINE}\n          onClick={() => append({})}\n          className=\"mt-2\"\n        >\n          {effectiveAddLabel}\n        </Button>\n      )}\n    </div>\n  );\n}\n\n/**\n * Extracts the first `<ArrayItemTemplate>` from children.\n * This is the template that gets cloned for each array item.\n */\nfunction findItemTemplate(children: ReactNode): React.ReactElement | null {\n  let template: React.ReactElement | null = null;\n  React.Children.forEach(children, (child) => {\n    if (!template && React.isValidElement(child) && child.type === ArrayItemTemplate) {\n      template = child;\n    }\n  });\n  return template;\n}\n\n// Edits the field named by `name` without being a `FormField` slot, and has no item slots while empty.\ndeclarePlacesNamedField(ArrayField);\n"]}
+{"version":3,"file":"ArrayField.js","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/ArrayField.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { type ReactNode } from 'react';\nimport { useFieldArray, useFormContext } from 'react-hook-form';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FieldScopeProvider, useResolvedFieldName } from './FieldScopeContext';\nimport { ArrayItemTemplate } from './ArrayItemTemplate';\nimport { declarePlacesNamedField } from '../../form/automated/TemplatePlacedFieldsContext';\nimport { useSectionFieldRegistration } from './SectionFieldsContext';\nimport { useWizardFieldRegistration } from './WizardStepFieldsContext';\n\nexport interface ArrayFieldProps {\n  /**\n   * Name of the array field in the parent schema.\n   * The component iterates over items and renders `<ArrayItemTemplate>`\n   * children for each item, with scoped field names.\n   */\n  name: string;\n  /** Additional CSS classes for the array container. */\n  className?: string;\n  /** Label for the \"Add\" button. Falls back to i18n default. */\n  addLabel?: string;\n  /** Label for each \"Remove\" button. Falls back to i18n default. */\n  removeLabel?: string;\n  /** Minimum number of items (disables remove when at minimum). */\n  minItems?: number;\n  /** Maximum number of items (disables add when at maximum). */\n  maxItems?: number;\n  children: ReactNode;\n}\n\n/**\n * Array container for array-of-object fields.\n *\n * Iterates over current items (from RHF field array state),\n * rendering `<ArrayItemTemplate>` children for each item with\n * a scoped `FieldScopeContext` (`\"{name}.{index}\"`).\n *\n * Provides add/remove infrastructure. For arrays of primitives\n * (e.g., `z.array(z.string())`), use `<FormField name=\"tags\" />`\n * directly — no `<ArrayField>` needed.\n *\n * @example\n * ```tsx\n * <ArrayField name=\"addresses\" className=\"space-y-4\">\n *   <ArrayItemTemplate>\n *     <div className=\"grid grid-cols-2 gap-4\">\n *       <FormField name=\"street\" className=\"col-span-2\" />\n *       <FormField name=\"city\" />\n *       <FormField name=\"zipCode\" />\n *     </div>\n *   </ArrayItemTemplate>\n * </ArrayField>\n * ```\n */\nexport function ArrayField({\n  name,\n  className,\n  addLabel,\n  removeLabel,\n  minItems,\n  maxItems,\n  children,\n}: ArrayFieldProps): ReactNode {\n  const resolvedName = useResolvedFieldName(name);\n  const { control } = useFormContext();\n  const { fields, append, remove } = useFieldArray({ control, name: resolvedName });\n  /*\n   * The ARRAY is one of the section's (and the wizard step's) fields, not only its items' leaves. Registered by its\n   * leaves alone (`steps[0].title`), a section save wrote those leaves onto the STORED array: an item the person had\n   * removed came back, and reordered items mixed their values. An array is written whole, as every other array\n   * editor writes it; registering the root is what tells the save so, and what lets the wizard check it.\n   */\n  useSectionFieldRegistration(resolvedName);\n  useWizardFieldRegistration(resolvedName);\n\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n  });\n\n  if (!isReady) return null;\n\n  const itemTemplate = findItemTemplate(children);\n\n  const canAdd = maxItems === undefined || fields.length < maxItems;\n  const canRemove = minItems === undefined || fields.length > minItems;\n\n  // Shared LOW_LEVEL_FORM_MESSAGE vocabulary with the automated AutomatedArrayField —\n  // one key per concept (arrayAddItem / arrayItemLabel / arrayRemoveItem), so\n  // handwritten and generated array UIs stay wording-consistent.\n  const effectiveAddLabel = addLabel ?? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'arrayAddItem');\n  const itemBaseLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'arrayItemLabel');\n\n  return (\n    <div className={className} data-guidance-array={name}>\n      {fields.map((field, index) => (\n        <div key={field.id} className=\"relative\" data-guidance-array-item={index}>\n          <FieldScopeProvider pathPrefix={`${resolvedName}[${index}]`}>\n            {itemTemplate ? React.cloneElement(itemTemplate) : null}\n          </FieldScopeProvider>\n          {canRemove && (\n            <Button\n              type=\"button\"\n              variant={ButtonVariants_Variant.GHOST}\n              onClick={() => remove(index)}\n              className=\"mt-1\"\n            >\n              {removeLabel\n                ?? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'arrayRemoveItem', {\n                  label: `${itemBaseLabel} ${index + 1}`,\n                })}\n            </Button>\n          )}\n        </div>\n      ))}\n\n      {canAdd && (\n        <Button\n          type=\"button\"\n          variant={ButtonVariants_Variant.OUTLINE}\n          onClick={() => append({})}\n          className=\"mt-2\"\n        >\n          {effectiveAddLabel}\n        </Button>\n      )}\n    </div>\n  );\n}\n\n/**\n * Extracts the first `<ArrayItemTemplate>` from children.\n * This is the template that gets cloned for each array item.\n */\nfunction findItemTemplate(children: ReactNode): React.ReactElement | null {\n  let template: React.ReactElement | null = null;\n  React.Children.forEach(children, (child) => {\n    if (!template && React.isValidElement(child) && child.type === ArrayItemTemplate) {\n      template = child;\n    }\n  });\n  return template;\n}\n\n// Edits the field named by `name` without being a `FormField` slot, and has no item slots while empty.\ndeclarePlacesNamedField(ArrayField);\n"]}

package/dist/esm/components/resources/skeleton/DisplayDiscriminatorSwitch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayDiscriminatorSwitch.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/DisplayDiscriminatorSwitch.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,+BAA+B;IAC9C,sHAAsH;IACtH,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,+BAA+B,GAAG,SAAS,CAMpH"}
+{"version":3,"file":"DisplayDiscriminatorSwitch.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/DisplayDiscriminatorSwitch.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,+BAA+B;IAC9C,sHAAsH;IACtH,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,+BAA+B,GAAG,SAAS,CAMpH"}

package/dist/esm/components/resources/skeleton/DisplayLayout.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import type { ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';
+import { type ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';
 /** @wildo_source:part:start saas.frontend.display-layout.reading-measure facet:layer:frontend facet:family:layout facet:audience:app-developer */
 export interface DisplayLayoutProps {
     /** Additional CSS classes for the root container. */
@@ -7,9 +7,9 @@ export interface DisplayLayoutProps {
     /**
      * How wide the layout root lets its content grow, named in the framework's own vocabulary.
      *
-     * Defaults to `'measure'` — the reading-measure cap (~42rem, themeable via `--measure-max-width`)
-     * that keeps a single-column stack of label/value pairs readable instead of stretched edge to edge.
-     * That default is right for what this layout was built for and is unchanged.
+     * Left unset, the width is DERIVED from what the layout renders: the reading-measure cap (~42rem, themeable
+     * via `--measure-max-width`) that keeps a single-column stack of label/value pairs readable instead of
+     * stretched edge to edge — lifted as soon as the layout holds a collection (see the last paragraph).
      *
      * It is WRONG for a composed document. A template that renders tabs, quote blocks, tables or regions
      * is not a field stack: those set their own measure internally, and a 42rem cap around them squeezes
@@ -19,11 +19,27 @@ export interface DisplayLayoutProps {
      * area at the page-content width (`'content'`, ~80rem) and an adjacent pane is narrower still. This
      * prop decides only whether a SECOND, tighter cap applies inside that, and the answer depends on what
      * the template renders, which is why the template is the one asked.
+     *
+     * Left UNSET, the cap is derived from what the layout actually renders: the reading measure for fields,
+     * lifted as soon as the layout holds a COLLECTION (a related list, an embedded collection — any surface
+     * marked {@link COLLECTION_SURFACE_ATTRIBUTE}). A list squeezed into a 42rem column, under a header that
+     * spans the page, is what a field-only cap does to a record whose page is mostly its list. Declared, the
+     * value is the template's statement and is applied as given.
      */
     responsiveMaxWidth?: ResponsiveMaxWidth;
     children?: ReactNode;
 }
 /** @wildo_source:part:end saas.frontend.display-layout.reading-measure */
+/**
+ * The attribute that marks a COLLECTION in the rendered page, so a layout around it can tell it holds a list.
+ *
+ * Carried by the `ResourceLayout_List` / `ResourceLayout_Search` wrappers (around any preset or custom view, from
+ * the first paint) and by a `RelatedResourceSections` block that holds a list (before its labels load, whichever
+ * tab is open). Read by CSS `:has()`: by `DisplayLayout`, to lift its reading measure, and by the READ page, to give
+ * the danger zone the same width as the record body (`--record-body-max-inline-size`). Being CSS, the decision
+ * follows the DOM and never needs a second render.
+ */
+export declare const COLLECTION_SURFACE_ATTRIBUTE = "data-collection-surface";
 /**
  * Root wrapper for display (read-only) layout templates.
  *

package/dist/esm/components/resources/skeleton/DisplayLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayLayout.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources/skeleton/DisplayLayout.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAc9E,kJAAkJ;AAClJ,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AACD,0EAA0E;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAA8B,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAmDpH"}
+{"version":3,"file":"DisplayLayout.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources/skeleton/DisplayLayout.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAejG,kJAAkJ;AAClJ,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AACD,0EAA0E;AAE1E;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,kBAAkB,GAAG,SAAS,CA2DxG"}

package/dist/esm/components/resources/skeleton/DisplayLayout.js

@@ -1,6 +1,8 @@
 'use client';
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import React, { useMemo } from 'react';
+import { TypographyVariant } from '@wildo-ai/presets-components-models';
+import { SectionLegendVoiceHost } from '../../sections/section-legend-voice.js';
 import { cn } from '../../../core/ui/cn.js';
 import { responsiveMaxWidthToCssValue } from '../../sections/surface.js';
 import { FieldScopeProvider } from './FieldScopeContext.js';
@@ -10,6 +12,16 @@ import { groupSectionsByAppearance, buildSectionConfigFromGroup, } from './secti
 import { GroupedSectionBody } from './Section.js';
 import { GroupedSectionHostKind } from './Section.shared.js';
 /** @wildo_source:part:end saas.frontend.display-layout.reading-measure */
+/**
+ * The attribute that marks a COLLECTION in the rendered page, so a layout around it can tell it holds a list.
+ *
+ * Carried by the `ResourceLayout_List` / `ResourceLayout_Search` wrappers (around any preset or custom view, from
+ * the first paint) and by a `RelatedResourceSections` block that holds a list (before its labels load, whichever
+ * tab is open). Read by CSS `:has()`: by `DisplayLayout`, to lift its reading measure, and by the READ page, to give
+ * the danger zone the same width as the record body (`--record-body-max-inline-size`). Being CSS, the decision
+ * follows the DOM and never needs a second render.
+ */
+export const COLLECTION_SURFACE_ATTRIBUTE = 'data-collection-surface';
 /**
  * Root wrapper for display (read-only) layout templates.
  *
@@ -29,10 +41,15 @@ import { GroupedSectionHostKind } from './Section.shared.js';
  * </DisplayLayout>
  * ```
  */
-export function DisplayLayout({ className, children, responsiveMaxWidth = 'measure' }) {
+export function DisplayLayout({ className, children, responsiveMaxWidth }) {
     const displayCtx = useOptionalDisplayTemplateContext();
     const renderedChildren = useMemo(() => renderGroupedChildren(children, displayCtx), [children, displayCtx]);
-    return (_jsx(FieldScopeProvider, { pathPrefix: "", children: _jsx("div", { className: cn('mr-auto w-full space-y-section', '[&>[data-chrome-mode^=settings]:has(+[data-chrome-mode^=settings])]:mb-0', className), style: { maxInlineSize: responsiveMaxWidthToCssValue(responsiveMaxWidth) }, "data-inline-size-tier": responsiveMaxWidth, "data-guidance-display": true, children: renderedChildren }) }));
+    return (_jsx(FieldScopeProvider, { pathPrefix: "", children: _jsx(SectionLegendVoiceHost, { voice: TypographyVariant.EYEBROW, children: _jsx("div", { className: cn('mr-auto w-full space-y-section', '[&>[data-chrome-mode^=settings]:has(+[data-chrome-mode^=settings])]:mb-0', 
+                // Derived width (no declaration): the reading measure, lifted when the layout holds a collection.
+                // The selector spells the attribute literally because Tailwind reads class names statically;
+                // `display-layout-derived-width.test.tsx` holds it equal to `COLLECTION_SURFACE_ATTRIBUTE`.
+                responsiveMaxWidth === undefined
+                    && '[max-inline-size:var(--measure-max-width,42rem)] has-[[data-collection-surface]]:[max-inline-size:none]', className), style: responsiveMaxWidth === undefined ? undefined : { maxInlineSize: responsiveMaxWidthToCssValue(responsiveMaxWidth) }, "data-inline-size-tier": responsiveMaxWidth ?? 'derived', "data-guidance-display": true, children: renderedChildren }) }) }));
 }
 /**
  * Introspects children for `<Section>` elements with container-mode `appearance`.