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

package/dist/esm/components/form/automated/bulk-field-clear-context.js

@@ -0,0 +1,77 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The explicit "clear on every selected record" choice of a BULK update form (#2620).
+ *
+ * A bulk form writes only what the person set (#2581), and an untouched control holds the same `null`, `[]` or `false`
+ * that a control set and taken back holds. So clearing a field, emptying a list or turning a switch off on every selected
+ * row is a choice of its own, offered beside each field that can take it, as Jira's bulk edit ("Clear field") and
+ * Salesforce's mass update offer it. The form that writes the patch (`ResourceAutomatedForm`) owns the choices and
+ * provides them here. The affordance (`BulkFieldClearSlot`) renders in every field chrome, and in the renderers that draw
+ * none: a list on its section path (`AutomatedArrayField`), an object, a record and a map (`FormField`). Outside a bulk
+ * update form there is no provider and nothing renders.
+ */
+import { createContext, useContext, useEffect } from 'react';
+import { FrontendComponentType, ButtonSize } from '@wildo-ai/presets-components-models';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { BulkFieldClearKind } from './automated-form-submit.utils.js';
+import { useOptionalAutosave } from './AutosaveContext.js';
+export const BulkFieldClearContext = createContext(null);
+/** The bulk form's clear choices, or `null` outside a bulk update form. */
+export function useBulkFieldClearing() {
+    return useContext(BulkFieldClearContext);
+}
+/** The words of each kind of clear, so a kind added to the vocabulary cannot render without its own. */
+const BULK_FIELD_CLEAR_WORDS = {
+    [BulkFieldClearKind.CLEAR]: { action: 'bulkClearField', pending: 'bulkFieldWillBeCleared', pendingUncounted: 'bulkFieldWillBeClearedOnSelection' },
+    [BulkFieldClearKind.EMPTY]: { action: 'bulkEmptyField', pending: 'bulkFieldWillBeEmptied', pendingUncounted: 'bulkFieldWillBeEmptiedOnSelection' },
+    [BulkFieldClearKind.TURN_OFF]: { action: 'bulkTurnOffField', pending: 'bulkFieldWillBeTurnedOff', pendingUncounted: 'bulkFieldWillBeTurnedOffOnSelection' },
+};
+/**
+ * A field's control, with the bulk clear beside it (#2620).
+ *
+ * Renders the control unchanged outside a bulk update form, for a field that can take no clear (`clearFor`), and for a
+ * disabled one. Otherwise it offers the action under the control, and once chosen REPLACES the control with what will
+ * happen ("will be cleared on 40 records") and an undo: the old value shown greyed beside that sentence would read as two
+ * answers. Undo shows the control again, empty.
+ *
+ * Accessibility, each on purpose:
+ * - the button is described by the field's own label, rendered here (visually hidden), since the chrome renders no
+ *   label element in its compact and hidden modes or under `hideLabel`;
+ * - the status region stays mounted in both states, so the sentence is ANNOUNCED when it appears (a region inserted
+ *   with its text already in it often is not);
+ * - the action and the undo are ONE button in one place, so focus stays on it across the choice.
+ *
+ * @param onSaveFieldNow saves the field at once, for a field that autosaves (its caller knows the field's own autosave
+ *   trigger). Absent, the clear waits for the form's save, as every other change of that field does.
+ */
+export function BulkFieldClearSlot({ fieldName, label, disabled, onSaveFieldNow, children, }) {
+    const clearing = useBulkFieldClearing();
+    const autosave = useOptionalAutosave();
+    const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });
+    const clear = clearing && fieldName && !disabled ? clearing.clearFor(fieldName) : undefined;
+    const registerField = clear && fieldName ? clearing?.registerField : undefined;
+    useEffect(() => (registerField && fieldName ? registerField(fieldName) : undefined), [registerField, fieldName]);
+    if (!clearing || !fieldName || !clear)
+        return _jsx(_Fragment, { children: children });
+    const words = BULK_FIELD_CLEAR_WORDS[clear.kind];
+    const cleared = clearing.isCleared(fieldName);
+    const count = clearing.selectionCount;
+    const labelId = label ? `bulk-clear-${fieldName}-label` : undefined;
+    return (_jsxs("div", { "data-slot": "bulk-field-clear", "data-bulk-clear-kind": clear.kind, "data-bulk-cleared": cleared || undefined, className: "flex flex-col gap-1", children: [labelId && _jsx("span", { id: labelId, className: "sr-only", children: label }), !cleared && children, _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { role: "status", className: "text-sm text-muted-foreground empty:sr-only", children: cleared
+                            ? count === undefined
+                                ? tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, words.pendingUncounted)
+                                : tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, words.pending, { count })
+                            : null }), _jsx(Button, { type: "button", variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, "aria-describedby": labelId, onClick: () => {
+                            if (cleared) {
+                                clearing.setCleared(fieldName, false);
+                                return;
+                            }
+                            // An edit of this field, or of a child of it, still waiting to autosave would fire after the clear and
+                            // write the value back to every selected record: the clear supersedes it.
+                            autosave?.cancelPendingUnder(fieldName);
+                            clearing.setCleared(fieldName, true);
+                            onSaveFieldNow?.(undefined);
+                        }, children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, cleared ? 'bulkFieldUndoClear' : words.action) })] })] }));
+}
+//# sourceMappingURL=bulk-field-clear-context.js.map

package/dist/esm/components/form/automated/bulk-field-clear-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-field-clear-context.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/bulk-field-clear-context.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The explicit \"clear on every selected record\" choice of a BULK update form (#2620).\n *\n * A bulk form writes only what the person set (#2581), and an untouched control holds the same `null`, `[]` or `false`\n * that a control set and taken back holds. So clearing a field, emptying a list or turning a switch off on every selected\n * row is a choice of its own, offered beside each field that can take it, as Jira's bulk edit (\"Clear field\") and\n * Salesforce's mass update offer it. The form that writes the patch (`ResourceAutomatedForm`) owns the choices and\n * provides them here. The affordance (`BulkFieldClearSlot`) renders in every field chrome, and in the renderers that draw\n * none: a list on its section path (`AutomatedArrayField`), an object, a record and a map (`FormField`). Outside a bulk\n * update form there is no provider and nothing renders.\n */\nimport { createContext, useContext, useEffect, type ReactNode } from 'react';\n\nimport { FrontendComponentType, ButtonSize } 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';\n\nimport { BulkFieldClearKind, type BulkFieldClear } from './automated-form-submit.utils';\nimport { useOptionalAutosave } from './AutosaveContext';\n\nexport interface BulkFieldClearing {\n  /** How many records the form writes to, or `undefined` when its selection carries no count. */\n  selectionCount: number | undefined;\n  /** The clear a field may take on every selected record (`resolveBulkFieldClear`), or `undefined` for none. */\n  clearFor: (fieldName: string) => BulkFieldClear | undefined;\n  /** Whether the person chose to clear the field. */\n  isCleared: (fieldName: string) => boolean;\n  /** Chooses or withdraws a clear. Choosing one also empties what the field's control holds. */\n  setCleared: (fieldName: string, cleared: boolean) => void;\n  /**\n   * Records that the field's affordance is on screen, and returns the call that records it gone. A write carries only\n   * the clears of fields on screen: a field hidden after its clear was chosen (a `showWhen`, a variant switch) leaves\n   * the form's values, so its clear leaves the write too, and comes back with the field.\n   */\n  registerField: (fieldName: string) => () => void;\n}\n\nexport const BulkFieldClearContext = createContext<BulkFieldClearing | null>(null);\n\n/** The bulk form's clear choices, or `null` outside a bulk update form. */\nexport function useBulkFieldClearing(): BulkFieldClearing | null {\n  return useContext(BulkFieldClearContext);\n}\n\n/** The words of each kind of clear, so a kind added to the vocabulary cannot render without its own. */\nconst BULK_FIELD_CLEAR_WORDS: Record<BulkFieldClearKind, { action: string; pending: string; pendingUncounted: string }> = {\n  [BulkFieldClearKind.CLEAR]: { action: 'bulkClearField', pending: 'bulkFieldWillBeCleared', pendingUncounted: 'bulkFieldWillBeClearedOnSelection' },\n  [BulkFieldClearKind.EMPTY]: { action: 'bulkEmptyField', pending: 'bulkFieldWillBeEmptied', pendingUncounted: 'bulkFieldWillBeEmptiedOnSelection' },\n  [BulkFieldClearKind.TURN_OFF]: { action: 'bulkTurnOffField', pending: 'bulkFieldWillBeTurnedOff', pendingUncounted: 'bulkFieldWillBeTurnedOffOnSelection' },\n};\n\n/**\n * A field's control, with the bulk clear beside it (#2620).\n *\n * Renders the control unchanged outside a bulk update form, for a field that can take no clear (`clearFor`), and for a\n * disabled one. Otherwise it offers the action under the control, and once chosen REPLACES the control with what will\n * happen (\"will be cleared on 40 records\") and an undo: the old value shown greyed beside that sentence would read as two\n * answers. Undo shows the control again, empty.\n *\n * Accessibility, each on purpose:\n * - the button is described by the field's own label, rendered here (visually hidden), since the chrome renders no\n *   label element in its compact and hidden modes or under `hideLabel`;\n * - the status region stays mounted in both states, so the sentence is ANNOUNCED when it appears (a region inserted\n *   with its text already in it often is not);\n * - the action and the undo are ONE button in one place, so focus stays on it across the choice.\n *\n * @param onSaveFieldNow saves the field at once, for a field that autosaves (its caller knows the field's own autosave\n *   trigger). Absent, the clear waits for the form's save, as every other change of that field does.\n */\nexport function BulkFieldClearSlot({\n  fieldName,\n  label,\n  disabled,\n  onSaveFieldNow,\n  children,\n}: {\n  fieldName?: string;\n  /** The field's label, which describes the action for assistive technology. */\n  label?: string;\n  disabled?: boolean;\n  onSaveFieldNow?: (value: unknown) => void;\n  children: ReactNode;\n}): React.JSX.Element {\n  const clearing = useBulkFieldClearing();\n  const autosave = useOptionalAutosave();\n  const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });\n  const clear = clearing && fieldName && !disabled ? clearing.clearFor(fieldName) : undefined;\n  const registerField = clear && fieldName ? clearing?.registerField : undefined;\n  useEffect(() => (registerField && fieldName ? registerField(fieldName) : undefined), [registerField, fieldName]);\n  if (!clearing || !fieldName || !clear) return <>{children}</>;\n\n  const words = BULK_FIELD_CLEAR_WORDS[clear.kind];\n  const cleared = clearing.isCleared(fieldName);\n  const count = clearing.selectionCount;\n  const labelId = label ? `bulk-clear-${fieldName}-label` : undefined;\n  return (\n    <div data-slot=\"bulk-field-clear\" data-bulk-clear-kind={clear.kind} data-bulk-cleared={cleared || undefined} className=\"flex flex-col gap-1\">\n      {labelId && <span id={labelId} className=\"sr-only\">{label}</span>}\n      {!cleared && children}\n      <div className=\"flex flex-wrap items-center gap-2\">\n        <span role=\"status\" className=\"text-sm text-muted-foreground empty:sr-only\">\n          {cleared\n            ? count === undefined\n              ? tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, words.pendingUncounted)\n              : tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, words.pending, { count })\n            : null}\n        </span>\n        <Button\n          type=\"button\"\n          variant={ButtonVariants_Variant.GHOST}\n          size={ButtonSize.SM}\n          aria-describedby={labelId}\n          onClick={() => {\n            if (cleared) {\n              clearing.setCleared(fieldName, false);\n              return;\n            }\n            // An edit of this field, or of a child of it, still waiting to autosave would fire after the clear and\n            // write the value back to every selected record: the clear supersedes it.\n            autosave?.cancelPendingUnder(fieldName);\n            clearing.setCleared(fieldName, true);\n            onSaveFieldNow?.(undefined);\n          }}\n        >\n          {tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, cleared ? 'bulkFieldUndoClear' : words.action)}\n        </Button>\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/esm/components/form/automated/generated-relationship-field.hooks.d.ts

@@ -9,7 +9,7 @@ export declare function useGeneratedRelationshipFieldCommon(params: {
     registry: import("../../..").FrontendResourcesRegistry;
     doOperation: <TResponse = any>(operationPath: import("../../..").OperationPathIdentifier, parameters: import("../../..").ResourceOperationCallParameters | import("../../..").ResourceSearchCallParameters, options?: import("../../..").RequestOptions) => Promise<TResponse>;
     fieldSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
-    resolvedChromeMode: "hidden" | "inline" | "stacked" | "settings_row" | "compact" | "relaxed" | Partial<Record<import("@wildo-ai/zod-decorators").ViewportBreakpoint, import("@wildo-ai/zod-decorators").EditChromeMode>>;
+    resolvedChromeMode: "hidden" | "inline" | "compact" | "stacked" | "settings_row" | "relaxed" | Partial<Record<import("@wildo-ai/zod-decorators").ViewportBreakpoint, import("@wildo-ai/zod-decorators").EditChromeMode>>;
     resolvedLabelPlacement: import("@wildo-ai/presets-components-models").AutoLabelPlacement;
     resolvedControlSize: import("@wildo-ai/presets-components-models").ControlSize;
     hideInlineErrorForPolicy: boolean;

package/dist/esm/components/form/automated/unplaced-request-fields.context.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The request fields a custom operation's authored template does not place, offered to a layout that can show them
+ * where they belong.
+ *
+ * `ResourceAutomatedForm` appends those fields AFTER the template, so the action can still set them. Under a wizard
+ * that put them below its Previous/Next row, outside every step, on every step: fields that belong to the record the
+ * last step submits, shown beside the first. A layout with a better place claims them, as the wizard claims the
+ * host's footer (`ResourceFormActionsContext.claimFooter`), and renders `content` there; while one holds the claim the
+ * form does not append them.
+ */
+import { type ReactNode } from 'react';
+export interface UnplacedRequestFieldsContextValue {
+    /** The fields' controls, or null while there are none to show. */
+    content: ReactNode | null;
+    /** Taken by a layout that renders `content` itself. Returns the release. */
+    claim: () => () => void;
+}
+export declare const UnplacedRequestFieldsContext: import("react").Context<UnplacedRequestFieldsContextValue>;
+//# sourceMappingURL=unplaced-request-fields.context.d.ts.map

package/dist/esm/components/form/automated/unplaced-request-fields.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unplaced-request-fields.context.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/unplaced-request-fields.context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,MAAM,WAAW,iCAAiC;IAChD,kEAAkE;IAClE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,MAAM,IAAI,CAAC;CACzB;AAED,eAAO,MAAM,4BAA4B,4DAAgE,CAAC"}

package/dist/esm/components/form/automated/unplaced-request-fields.context.js

@@ -0,0 +1,13 @@
+/**
+ * The request fields a custom operation's authored template does not place, offered to a layout that can show them
+ * where they belong.
+ *
+ * `ResourceAutomatedForm` appends those fields AFTER the template, so the action can still set them. Under a wizard
+ * that put them below its Previous/Next row, outside every step, on every step: fields that belong to the record the
+ * last step submits, shown beside the first. A layout with a better place claims them, as the wizard claims the
+ * host's footer (`ResourceFormActionsContext.claimFooter`), and renders `content` there; while one holds the claim the
+ * form does not append them.
+ */
+import { createContext } from 'react';
+export const UnplacedRequestFieldsContext = createContext(null);
+//# sourceMappingURL=unplaced-request-fields.context.js.map

package/dist/esm/components/form/automated/unplaced-request-fields.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unplaced-request-fields.context.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/unplaced-request-fields.context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AAStD,MAAM,CAAC,MAAM,4BAA4B,GAAG,aAAa,CAA2C,IAAI,CAAC,CAAC","sourcesContent":["/**\n * The request fields a custom operation's authored template does not place, offered to a layout that can show them\n * where they belong.\n *\n * `ResourceAutomatedForm` appends those fields AFTER the template, so the action can still set them. Under a wizard\n * that put them below its Previous/Next row, outside every step, on every step: fields that belong to the record the\n * last step submits, shown beside the first. A layout with a better place claims them, as the wizard claims the\n * host's footer (`ResourceFormActionsContext.claimFooter`), and renders `content` there; while one holds the claim the\n * form does not append them.\n */\nimport { createContext, type ReactNode } from 'react';\n\nexport interface UnplacedRequestFieldsContextValue {\n  /** The fields' controls, or null while there are none to show. */\n  content: ReactNode | null;\n  /** Taken by a layout that renders `content` itself. Returns the release. */\n  claim: () => () => void;\n}\n\nexport const UnplacedRequestFieldsContext = createContext<UnplacedRequestFieldsContextValue | null>(null);\n"]}

package/dist/esm/components/form/automated/useArrayItemAutosaveField.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Whether the ARRAY around an item template autosaves. The array decides it from its own field declaration
+ * (`resolveFieldAutosaveTrigger`) and provides it here, because a template binds an item's sub-field and cannot see
+ * the array's schema. Without a provider it is true: the read-side inline array editor and the settings screens
+ * mount an autosave provider precisely so that every edit saves.
+ */
+export declare const ArrayAutosavesContext: import("react").Context<boolean>;
 export interface ArrayItemAutosaveField<T> {
     /** Live value of the bound field path (re-renders on change). */
     value: T;

package/dist/esm/components/form/automated/useArrayItemAutosaveField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useArrayItemAutosaveField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useArrayItemAutosaveField.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,iEAAiE;IACjE,KAAK,EAAE,CAAC,CAAC;IACT,iFAAiF;IACjF,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAiBnG"}
+{"version":3,"file":"useArrayItemAutosaveField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useArrayItemAutosaveField.ts"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,kCAAsB,CAAC;AAEzD,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,iEAAiE;IACjE,KAAK,EAAE,CAAC,CAAC;IACT,iFAAiF;IACjF,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAkBnG"}

package/dist/esm/components/form/automated/useArrayItemAutosaveField.js

@@ -18,14 +18,22 @@
  * plain control (`Checkbox`, `InlineEditText`, …) instead of a raw `Controller`,
  * which would silently NOT persist in the autosave context.
  */
-import { useCallback } from 'react';
+import { createContext, useCallback, useContext } from 'react';
 import { useFormContext, useWatch } from 'react-hook-form';
 import { AutosaveTrigger } from '@wildo-ai/zod-decorators';
 import { useOptionalAutosave } from './AutosaveContext.js';
+/**
+ * Whether the ARRAY around an item template autosaves. The array decides it from its own field declaration
+ * (`resolveFieldAutosaveTrigger`) and provides it here, because a template binds an item's sub-field and cannot see
+ * the array's schema. Without a provider it is true: the read-side inline array editor and the settings screens
+ * mount an autosave provider precisely so that every edit saves.
+ */
+export const ArrayAutosavesContext = createContext(true);
 export function useArrayItemAutosaveField(fieldPath) {
     const { setValue: rhfSetValue } = useFormContext();
     const value = useWatch({ name: fieldPath });
-    const autosave = useOptionalAutosave();
+    const contextAutosave = useOptionalAutosave();
+    const autosave = useContext(ArrayAutosavesContext) ? contextAutosave : null;
     const setValue = useCallback((next) => {
         rhfSetValue(fieldPath, next, { shouldDirty: true, shouldTouch: true });
         // The array's autosave bridge ignores this fieldName/value and re-reads the

package/dist/esm/components/form/automated/useArrayItemAutosaveField.js.map

@@ -1 +1 @@
-{"version":3,"file":"useArrayItemAutosaveField.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useArrayItemAutosaveField.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AASxD,MAAM,UAAU,yBAAyB,CAAc,SAAiB;IACtE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAM,CAAC;IACjD,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,IAAO,EAAQ,EAAE;QAChB,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,4EAA4E;QAC5E,6EAA6E;QAC7E,sEAAsE;QACtE,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC,EACD,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CACnC,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["\"use client\"\n\n/**\n * useArrayItemAutosaveField — bind ONE sub-field of an array item inside a\n * per-item TEMPLATE (the `renderItem`/`renderField` render-prop), correct in\n * BOTH contexts the template can render in:\n *\n *  - **Inline-editable READ array** (`DisplayFieldEditableArray` → autosave):\n *    each change must kick the whole-array debounced autosave. The array's\n *    `handleSave` re-reads the WHOLE array from the form and PATCHes it, so the\n *    value we pass to `triggerSave` is irrelevant — what matters is that a save\n *    is triggered after the RHF field is updated.\n *  - **Plain edit FORM** (`FormField name=\"checklist\" renderField=…`, no\n *    `AutosaveProvider`): `useOptionalAutosave()` is null, so we only update RHF\n *    and the surrounding form's submit persists the change.\n *\n * Returns the live field `value` (via `useWatch`) and a `setValue` that writes\n * the field and triggers autosave when present. Templates compose this with a\n * plain control (`Checkbox`, `InlineEditText`, …) instead of a raw `Controller`,\n * which would silently NOT persist in the autosave context.\n */\n\nimport { useCallback } from 'react';\nimport { useFormContext, useWatch } from 'react-hook-form';\nimport { AutosaveTrigger } from '@wildo-ai/zod-decorators';\n\nimport { useOptionalAutosave } from './AutosaveContext';\n\nexport interface ArrayItemAutosaveField<T> {\n  /** Live value of the bound field path (re-renders on change). */\n  value: T;\n  /** Write the field and, in an autosave context, trigger the whole-array save. */\n  setValue: (next: T) => void;\n}\n\nexport function useArrayItemAutosaveField<T = unknown>(fieldPath: string): ArrayItemAutosaveField<T> {\n  const { setValue: rhfSetValue } = useFormContext();\n  const value = useWatch({ name: fieldPath }) as T;\n  const autosave = useOptionalAutosave();\n\n  const setValue = useCallback(\n    (next: T): void => {\n      rhfSetValue(fieldPath, next, { shouldDirty: true, shouldTouch: true });\n      // The array's autosave bridge ignores this fieldName/value and re-reads the\n      // whole array — passing the field path keeps the autosave state keyed like a\n      // normal per-item FormField edit. DEBOUNCE matches text/edit cadence.\n      autosave?.triggerSave(fieldPath, next, AutosaveTrigger.DEBOUNCE);\n    },\n    [rhfSetValue, fieldPath, autosave],\n  );\n\n  return { value, setValue };\n}\n"]}
+{"version":3,"file":"useArrayItemAutosaveField.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useArrayItemAutosaveField.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;AASzD,MAAM,UAAU,yBAAyB,CAAc,SAAiB;IACtE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAM,CAAC;IACjD,MAAM,eAAe,GAAG,mBAAmB,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5E,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,IAAO,EAAQ,EAAE;QAChB,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,4EAA4E;QAC5E,6EAA6E;QAC7E,sEAAsE;QACtE,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC,EACD,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CACnC,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["\"use client\"\n\n/**\n * useArrayItemAutosaveField — bind ONE sub-field of an array item inside a\n * per-item TEMPLATE (the `renderItem`/`renderField` render-prop), correct in\n * BOTH contexts the template can render in:\n *\n *  - **Inline-editable READ array** (`DisplayFieldEditableArray` → autosave):\n *    each change must kick the whole-array debounced autosave. The array's\n *    `handleSave` re-reads the WHOLE array from the form and PATCHes it, so the\n *    value we pass to `triggerSave` is irrelevant — what matters is that a save\n *    is triggered after the RHF field is updated.\n *  - **Plain edit FORM** (`FormField name=\"checklist\" renderField=…`, no\n *    `AutosaveProvider`): `useOptionalAutosave()` is null, so we only update RHF\n *    and the surrounding form's submit persists the change.\n *\n * Returns the live field `value` (via `useWatch`) and a `setValue` that writes\n * the field and triggers autosave when present. Templates compose this with a\n * plain control (`Checkbox`, `InlineEditText`, …) instead of a raw `Controller`,\n * which would silently NOT persist in the autosave context.\n */\n\nimport { createContext, useCallback, useContext } from 'react';\nimport { useFormContext, useWatch } from 'react-hook-form';\nimport { AutosaveTrigger } from '@wildo-ai/zod-decorators';\n\nimport { useOptionalAutosave } from './AutosaveContext';\n\n/**\n * Whether the ARRAY around an item template autosaves. The array decides it from its own field declaration\n * (`resolveFieldAutosaveTrigger`) and provides it here, because a template binds an item's sub-field and cannot see\n * the array's schema. Without a provider it is true: the read-side inline array editor and the settings screens\n * mount an autosave provider precisely so that every edit saves.\n */\nexport const ArrayAutosavesContext = createContext(true);\n\nexport interface ArrayItemAutosaveField<T> {\n  /** Live value of the bound field path (re-renders on change). */\n  value: T;\n  /** Write the field and, in an autosave context, trigger the whole-array save. */\n  setValue: (next: T) => void;\n}\n\nexport function useArrayItemAutosaveField<T = unknown>(fieldPath: string): ArrayItemAutosaveField<T> {\n  const { setValue: rhfSetValue } = useFormContext();\n  const value = useWatch({ name: fieldPath }) as T;\n  const contextAutosave = useOptionalAutosave();\n  const autosave = useContext(ArrayAutosavesContext) ? contextAutosave : null;\n\n  const setValue = useCallback(\n    (next: T): void => {\n      rhfSetValue(fieldPath, next, { shouldDirty: true, shouldTouch: true });\n      // The array's autosave bridge ignores this fieldName/value and re-reads the\n      // whole array — passing the field path keeps the autosave state keyed like a\n      // normal per-item FormField edit. DEBOUNCE matches text/edit cadence.\n      autosave?.triggerSave(fieldPath, next, AutosaveTrigger.DEBOUNCE);\n    },\n    [rhfSetValue, fieldPath, autosave],\n  );\n\n  return { value, setValue };\n}\n"]}

package/dist/esm/components/form/automated/useReferenceRecordLabels.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The display labels of some records of one resource, keyed by id, for a choice among them (#2943): each read as a
+ * reference picker reads its selected record — the target's preferred READ, scoped to the tenancy by
+ * `scopeReferencedRecord` — and labelled the same way. A record not read yet, or that cannot be read, has no entry, and
+ * the choice shows its id until it has one.
+ *
+ * Costs one READ per id the first time a mounted form asks for it, with no cache across forms: the reference picker
+ * this stands in for makes the same reads. A caller offered many units pays as many reads; one LIST filtered on the ids
+ * would be cheaper and needs a list filter by `_id` the target may not offer.
+ */
+export declare function useReferenceRecordLabels(params: {
+    readonly resourceType: string;
+    readonly ids: readonly string[] | undefined;
+    readonly hostContextualParameters: Readonly<Record<string, string>>;
+}): Readonly<Record<string, string>>;
+//# sourceMappingURL=useReferenceRecordLabels.d.ts.map

package/dist/esm/components/form/automated/useReferenceRecordLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReferenceRecordLabels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useReferenceRecordLabels.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkDnC"}

package/dist/esm/components/form/automated/useReferenceRecordLabels.js

@@ -0,0 +1,66 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { scopeReferencedRecord } from '../../../core/resources/referenced-record-scope.frontend.utils.js';
+import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { fetchResourceReferenceRecordAndLabel } from '../../../components/resources-fields/resource-reference/resource-reference.shared.utils.js';
+/**
+ * The display labels of some records of one resource, keyed by id, for a choice among them (#2943): each read as a
+ * reference picker reads its selected record — the target's preferred READ, scoped to the tenancy by
+ * `scopeReferencedRecord` — and labelled the same way. A record not read yet, or that cannot be read, has no entry, and
+ * the choice shows its id until it has one.
+ *
+ * Costs one READ per id the first time a mounted form asks for it, with no cache across forms: the reference picker
+ * this stands in for makes the same reads. A caller offered many units pays as many reads; one LIST filtered on the ids
+ * would be cheaper and needs a list filter by `_id` the target may not offer.
+ */
+export function useReferenceRecordLabels(params) {
+    const { resourceType, ids, hostContextualParameters } = params;
+    const { registry, doOperation } = useResourceRegistry();
+    const { t, formatDate, formatDateTime } = useI18n({});
+    const latest = useRef({ registry, doOperation, t, formatDate, formatDateTime, hostContextualParameters });
+    latest.current = { registry, doOperation, t, formatDate, formatDateTime, hostContextualParameters };
+    const [labels, setLabels] = useState({});
+    const idsKey = (ids ?? []).join('|');
+    useEffect(() => {
+        let cancelled = false;
+        const warn = (id, error) => console.warn(`[useReferenceRecordLabels] The ${resourceType} "${id}" could not be read; the choice shows its id.`, error);
+        const readLabel = async (id) => {
+            const current = latest.current;
+            const readOperation = pickPreferredOperationForCoreSemantic(current.registry.resourceConfigurations?.[resourceType]?.operations ?? [], CoreResourceOperation.READ) ?? null;
+            const { label } = await fetchResourceReferenceRecordAndLabel({
+                resourceType: resourceType,
+                id,
+                registry: current.registry,
+                doOperation: current.doOperation,
+                contextualParameters: scopeReferencedRecord({
+                    hostIdentifiers: {},
+                    hostContextualParameters: current.hostContextualParameters,
+                    targetResourceType: resourceType,
+                    targetId: id,
+                    registry: current.registry,
+                }).contextualParameters,
+                readOperation,
+                t: current.t,
+                formatDate: current.formatDate,
+                formatDateTime: current.formatDateTime,
+            });
+            return typeof label === 'string' && label.length > 0 ? label : undefined;
+        };
+        for (const id of ids ?? []) {
+            if (labels[id] !== undefined)
+                continue;
+            // A label is a convenience: nothing about reading one may break the form that offers the choice, so a failure,
+            // asynchronous or not, leaves the id showing.
+            readLabel(id)
+                .then((label) => { if (!cancelled && label !== undefined)
+                setLabels((held) => ({ ...held, [id]: label })); })
+                .catch((error) => warn(id, error));
+        }
+        return () => { cancelled = true; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the ids
+    }, [resourceType, idsKey]);
+    return useMemo(() => labels, [labels]);
+}
+//# sourceMappingURL=useReferenceRecordLabels.js.map

package/dist/esm/components/form/automated/useReferenceRecordLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReferenceRecordLabels.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useReferenceRecordLabels.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo, useRef, useState } from 'react';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { scopeReferencedRecord } from '~wildo-frontend-lib/core/resources/referenced-record-scope.frontend.utils';\nimport { pickPreferredOperationForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { fetchResourceReferenceRecordAndLabel } from '~wildo-frontend-lib/components/resources-fields/resource-reference/resource-reference.shared.utils';\n\n/**\n * The display labels of some records of one resource, keyed by id, for a choice among them (#2943): each read as a\n * reference picker reads its selected record — the target's preferred READ, scoped to the tenancy by\n * `scopeReferencedRecord` — and labelled the same way. A record not read yet, or that cannot be read, has no entry, and\n * the choice shows its id until it has one.\n *\n * Costs one READ per id the first time a mounted form asks for it, with no cache across forms: the reference picker\n * this stands in for makes the same reads. A caller offered many units pays as many reads; one LIST filtered on the ids\n * would be cheaper and needs a list filter by `_id` the target may not offer.\n */\nexport function useReferenceRecordLabels(params: {\n  readonly resourceType: string;\n  readonly ids: readonly string[] | undefined;\n  readonly hostContextualParameters: Readonly<Record<string, string>>;\n}): Readonly<Record<string, string>> {\n  const { resourceType, ids, hostContextualParameters } = params;\n  const { registry, doOperation } = useResourceRegistry();\n  const { t, formatDate, formatDateTime } = useI18n({});\n  const latest = useRef({ registry, doOperation, t, formatDate, formatDateTime, hostContextualParameters });\n  latest.current = { registry, doOperation, t, formatDate, formatDateTime, hostContextualParameters };\n\n  const [labels, setLabels] = useState<Readonly<Record<string, string>>>({});\n  const idsKey = (ids ?? []).join('|');\n  useEffect(() => {\n    let cancelled = false;\n    const warn = (id: string, error: unknown) =>\n      console.warn(`[useReferenceRecordLabels] The ${resourceType} \"${id}\" could not be read; the choice shows its id.`, error);\n    const readLabel = async (id: string): Promise<string | undefined> => {\n      const current = latest.current;\n      const readOperation = pickPreferredOperationForCoreSemantic(\n        current.registry.resourceConfigurations?.[resourceType]?.operations ?? [], CoreResourceOperation.READ,\n      ) ?? null;\n      const { label } = await fetchResourceReferenceRecordAndLabel({\n        resourceType: resourceType as never,\n        id,\n        registry: current.registry,\n        doOperation: current.doOperation,\n        contextualParameters: scopeReferencedRecord({\n          hostIdentifiers: {},\n          hostContextualParameters: current.hostContextualParameters,\n          targetResourceType: resourceType,\n          targetId: id,\n          registry: current.registry,\n        }).contextualParameters,\n        readOperation,\n        t: current.t,\n        formatDate: current.formatDate,\n        formatDateTime: current.formatDateTime,\n      });\n      return typeof label === 'string' && label.length > 0 ? label : undefined;\n    };\n    for (const id of ids ?? []) {\n      if (labels[id] !== undefined) continue;\n      // A label is a convenience: nothing about reading one may break the form that offers the choice, so a failure,\n      // asynchronous or not, leaves the id showing.\n      readLabel(id)\n        .then((label) => { if (!cancelled && label !== undefined) setLabels((held) => ({ ...held, [id]: label })); })\n        .catch((error: unknown) => warn(id, error));\n    }\n    return () => { cancelled = true; };\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the ids\n  }, [resourceType, idsKey]);\n\n  return useMemo(() => labels, [labels]);\n}\n"]}

package/dist/esm/components/form/automated/useRequestFieldOffer.d.ts

@@ -0,0 +1,18 @@
+import { type AppConfiguration_Shared, type RequestFieldOffer, type RequestFieldOfferDeclaration } from '@wildo-ai/saas-models';
+/**
+ * What the form offers in one request field (#2744), from the operation's `requestFieldOffers` declaration: evaluated
+ * against the row the operation acts on, the request values the declaration `readsFields` (watched, so the offer
+ * follows a kind chosen in the same form), the rows its `readsReferences` fields reference, and the application's
+ * shared configuration.
+ *
+ * `EVERY` when the field declares nothing, which is every field of every form that does not opt in. A declaration that
+ * throws also answers `EVERY` (`resolveRequestFieldOffer`): an offer narrows a form for the person's convenience, and the
+ * operation still refuses what it cannot accept.
+ */
+export declare function useRequestFieldOffer(params: {
+    readonly declaration: RequestFieldOfferDeclaration | undefined;
+    readonly record: Readonly<Record<string, unknown>> | undefined;
+    readonly appConfig: Partial<AppConfiguration_Shared> | undefined;
+    readonly fieldName: string;
+}): RequestFieldOffer;
+//# sourceMappingURL=useRequestFieldOffer.d.ts.map

package/dist/esm/components/form/automated/useRequestFieldOffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRequestFieldOffer.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useRequestFieldOffer.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAC;AAa/B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,WAAW,EAAE,4BAA4B,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GAAG,iBAAiB,CAmBpB"}

package/dist/esm/components/form/automated/useRequestFieldOffer.js

@@ -0,0 +1,107 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { useWatch } from 'react-hook-form';
+import { CoreResourceOperation, EVERY_REQUEST_FIELD_VALUE, resolveRequestFieldOffer, } from '@wildo-ai/saas-models';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { scopeReferencedRecord } from '../../../core/resources/referenced-record-scope.frontend.utils.js';
+import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
+import { useOptionalFormSchemaContext } from '../../../components/form/useFormSchemaContext.js';
+import { useOptionalResourceOperationViewContext } from '../../../core/resources/ResourceOperationViewContext.js';
+import { fetchResourceReferenceRecordAndLabel } from '../../../components/resources-fields/resource-reference/resource-reference.shared.utils.js';
+const NO_FIELDS = Object.freeze([]);
+/**
+ * What the form offers in one request field (#2744), from the operation's `requestFieldOffers` declaration: evaluated
+ * against the row the operation acts on, the request values the declaration `readsFields` (watched, so the offer
+ * follows a kind chosen in the same form), the rows its `readsReferences` fields reference, and the application's
+ * shared configuration.
+ *
+ * `EVERY` when the field declares nothing, which is every field of every form that does not opt in. A declaration that
+ * throws also answers `EVERY` (`resolveRequestFieldOffer`): an offer narrows a form for the person's convenience, and the
+ * operation still refuses what it cannot accept.
+ */
+export function useRequestFieldOffer(params) {
+    const { declaration, record, appConfig, fieldName } = params;
+    const readsFields = declaration?.readsFields ?? NO_FIELDS;
+    const watched = useWatch({ name: readsFields });
+    const watchedKey = JSON.stringify(watched ?? null);
+    const values = useMemo(() => {
+        const list = Array.isArray(watched) ? watched : [watched];
+        return Object.fromEntries(readsFields.map((name, index) => [name, list[index]]));
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the watched values' content, not their array identity
+    }, [readsFields, watchedKey]);
+    const references = useRequestFieldReferences(declaration?.readsReferences);
+    return useMemo(() => {
+        if (!declaration)
+            return EVERY_REQUEST_FIELD_VALUE;
+        return resolveRequestFieldOffer(declaration, { appConfig, currentObject: record, values, references }, (error) => console.warn(`[requestFieldOffers] The offer for "${fieldName}" threw; every value is offered and the operation decides.`, error));
+    }, [declaration, appConfig, record, values, references, fieldName]);
+}
+/**
+ * The rows a declaration's `readsReferences` fields reference, read the way a reference picker reads its selected
+ * record (`useResourceSearch`): the target's preferred READ, scoped to the tenancy by `scopeReferencedRecord`, never the
+ * host's parents. Keyed by request field; a field with nothing picked, a row still loading and one that cannot be read
+ * are all `undefined`, which a declaration answers with `EVERY`.
+ */
+function useRequestFieldReferences(readsReferences) {
+    const referenceFields = useMemo(() => Object.keys(readsReferences ?? {}), [readsReferences]);
+    const watched = useWatch({ name: referenceFields });
+    const ids = useMemo(() => {
+        const list = Array.isArray(watched) ? watched : [watched];
+        return referenceFields.map((field, index) => {
+            const value = list[index];
+            return { field, resourceType: readsReferences[field], id: typeof value === 'string' && value.length > 0 ? value : undefined };
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the picked ids' content
+    }, [referenceFields, readsReferences, JSON.stringify(watched ?? null)]);
+    const { registry, doOperation } = useResourceRegistry();
+    const { t, formatDate, formatDateTime } = useI18n({});
+    const formSchemaContext = useOptionalFormSchemaContext();
+    const operationViewContext = useOptionalResourceOperationViewContext();
+    const contextualParameters = useMemo(() => (formSchemaContext?.contextResourceIdentifiers
+        ? FrontendResourceUtils.buildContextualParameters(formSchemaContext.contextResourceIdentifiers, registry)
+        : operationViewContext?.contextualParameters ?? {}), [formSchemaContext?.contextResourceIdentifiers, operationViewContext?.contextualParameters, registry]);
+    const hostRecord = formSchemaContext ? { resourceType: formSchemaContext.resourceType, id: formSchemaContext.resourceId } : undefined;
+    const latest = useRef({ registry, doOperation, t, formatDate, formatDateTime, contextualParameters, hostRecord });
+    latest.current = { registry, doOperation, t, formatDate, formatDateTime, contextualParameters, hostRecord };
+    const [rows, setRows] = useState({});
+    const idsKey = ids.map(({ resourceType, id }) => `${resourceType}:${id ?? ''}`).join('|');
+    useEffect(() => {
+        let cancelled = false;
+        for (const { resourceType, id } of ids) {
+            const key = `${resourceType}:${id}`;
+            if (!id || rows[key])
+                continue;
+            const current = latest.current;
+            const readOperation = pickPreferredOperationForCoreSemantic(current.registry.resourceConfigurations?.[resourceType]?.operations ?? [], CoreResourceOperation.READ) ?? null;
+            void fetchResourceReferenceRecordAndLabel({
+                resourceType: resourceType,
+                id,
+                registry: current.registry,
+                doOperation: current.doOperation,
+                contextualParameters: scopeReferencedRecord({
+                    hostIdentifiers: {},
+                    hostContextualParameters: current.contextualParameters,
+                    hostRecord: current.hostRecord,
+                    targetResourceType: resourceType,
+                    targetId: id,
+                    registry: current.registry,
+                }).contextualParameters,
+                readOperation,
+                t: current.t,
+                formatDate: current.formatDate,
+                formatDateTime: current.formatDateTime,
+            }).then(({ record }) => {
+                if (!cancelled)
+                    setRows((held) => ({ ...held, [key]: record }));
+            }).catch((error) => {
+                // Fails open: the declaration sees no row and offers what it can without one; the operation still refuses.
+                console.warn(`[requestFieldOffers] The ${resourceType} "${id}" a request field references could not be read; its offer narrows nothing by it.`, error);
+            });
+        }
+        return () => { cancelled = true; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the picked ids
+    }, [idsKey]);
+    return useMemo(() => Object.fromEntries(ids.map(({ field, resourceType, id }) => [field, id ? rows[`${resourceType}:${id}`] : undefined])), [ids, rows]);
+}
+//# sourceMappingURL=useRequestFieldOffer.js.map

package/dist/esm/components/form/automated/useRequestFieldOffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRequestFieldOffer.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useRequestFieldOffer.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo, useRef, useState } from 'react';\nimport { useWatch } from 'react-hook-form';\nimport {\n  CoreResourceOperation,\n  EVERY_REQUEST_FIELD_VALUE,\n  resolveRequestFieldOffer,\n  type AppConfiguration_Shared,\n  type RequestFieldOffer,\n  type RequestFieldOfferDeclaration,\n} from '@wildo-ai/saas-models';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { scopeReferencedRecord } from '~wildo-frontend-lib/core/resources/referenced-record-scope.frontend.utils';\nimport { pickPreferredOperationForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useOptionalFormSchemaContext } from '~wildo-frontend-lib/components/form/useFormSchemaContext';\nimport { useOptionalResourceOperationViewContext } from '~wildo-frontend-lib/core/resources/ResourceOperationViewContext';\nimport { fetchResourceReferenceRecordAndLabel } from '~wildo-frontend-lib/components/resources-fields/resource-reference/resource-reference.shared.utils';\n\nconst NO_FIELDS: readonly string[] = Object.freeze([]);\ntype ReferencedRow = Readonly<Record<string, unknown>>;\n\n/**\n * What the form offers in one request field (#2744), from the operation's `requestFieldOffers` declaration: evaluated\n * against the row the operation acts on, the request values the declaration `readsFields` (watched, so the offer\n * follows a kind chosen in the same form), the rows its `readsReferences` fields reference, and the application's\n * shared configuration.\n *\n * `EVERY` when the field declares nothing, which is every field of every form that does not opt in. A declaration that\n * throws also answers `EVERY` (`resolveRequestFieldOffer`): an offer narrows a form for the person's convenience, and the\n * operation still refuses what it cannot accept.\n */\nexport function useRequestFieldOffer(params: {\n  readonly declaration: RequestFieldOfferDeclaration | undefined;\n  readonly record: Readonly<Record<string, unknown>> | undefined;\n  readonly appConfig: Partial<AppConfiguration_Shared> | undefined;\n  readonly fieldName: string;\n}): RequestFieldOffer {\n  const { declaration, record, appConfig, fieldName } = params;\n  const readsFields = declaration?.readsFields ?? NO_FIELDS;\n  const watched = useWatch({ name: readsFields as string[] });\n  const watchedKey = JSON.stringify(watched ?? null);\n  const values = useMemo(() => {\n    const list = Array.isArray(watched) ? watched : [watched];\n    return Object.fromEntries(readsFields.map((name, index) => [name, list[index]]));\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the watched values' content, not their array identity\n  }, [readsFields, watchedKey]);\n  const references = useRequestFieldReferences(declaration?.readsReferences);\n  return useMemo(() => {\n    if (!declaration) return EVERY_REQUEST_FIELD_VALUE;\n    return resolveRequestFieldOffer(\n      declaration,\n      { appConfig, currentObject: record, values, references },\n      (error) => console.warn(`[requestFieldOffers] The offer for \"${fieldName}\" threw; every value is offered and the operation decides.`, error),\n    );\n  }, [declaration, appConfig, record, values, references, fieldName]);\n}\n\n/**\n * The rows a declaration's `readsReferences` fields reference, read the way a reference picker reads its selected\n * record (`useResourceSearch`): the target's preferred READ, scoped to the tenancy by `scopeReferencedRecord`, never the\n * host's parents. Keyed by request field; a field with nothing picked, a row still loading and one that cannot be read\n * are all `undefined`, which a declaration answers with `EVERY`.\n */\nfunction useRequestFieldReferences(readsReferences: Readonly<Record<string, string>> | undefined): Readonly<Record<string, ReferencedRow | undefined>> {\n  const referenceFields = useMemo(() => Object.keys(readsReferences ?? {}), [readsReferences]);\n  const watched = useWatch({ name: referenceFields as string[] });\n  const ids = useMemo(() => {\n    const list = Array.isArray(watched) ? watched : [watched];\n    return referenceFields.map((field, index) => {\n      const value = list[index];\n      return { field, resourceType: readsReferences![field]!, id: typeof value === 'string' && value.length > 0 ? value : undefined };\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the picked ids' content\n  }, [referenceFields, readsReferences, JSON.stringify(watched ?? null)]);\n\n  const { registry, doOperation } = useResourceRegistry();\n  const { t, formatDate, formatDateTime } = useI18n({});\n  const formSchemaContext = useOptionalFormSchemaContext();\n  const operationViewContext = useOptionalResourceOperationViewContext();\n  const contextualParameters = useMemo(() => (formSchemaContext?.contextResourceIdentifiers\n    ? FrontendResourceUtils.buildContextualParameters(formSchemaContext.contextResourceIdentifiers, registry)\n    : operationViewContext?.contextualParameters ?? {}), [formSchemaContext?.contextResourceIdentifiers, operationViewContext?.contextualParameters, registry]);\n  const hostRecord = formSchemaContext ? { resourceType: formSchemaContext.resourceType, id: formSchemaContext.resourceId } : undefined;\n  const latest = useRef({ registry, doOperation, t, formatDate, formatDateTime, contextualParameters, hostRecord });\n  latest.current = { registry, doOperation, t, formatDate, formatDateTime, contextualParameters, hostRecord };\n\n  const [rows, setRows] = useState<Readonly<Record<string, ReferencedRow>>>({});\n  const idsKey = ids.map(({ resourceType, id }) => `${resourceType}:${id ?? ''}`).join('|');\n  useEffect(() => {\n    let cancelled = false;\n    for (const { resourceType, id } of ids) {\n      const key = `${resourceType}:${id}`;\n      if (!id || rows[key]) continue;\n      const current = latest.current;\n      const readOperation = pickPreferredOperationForCoreSemantic(\n        current.registry.resourceConfigurations?.[resourceType]?.operations ?? [], CoreResourceOperation.READ,\n      ) ?? null;\n      void fetchResourceReferenceRecordAndLabel({\n        resourceType: resourceType as never,\n        id,\n        registry: current.registry,\n        doOperation: current.doOperation,\n        contextualParameters: scopeReferencedRecord({\n          hostIdentifiers: {},\n          hostContextualParameters: current.contextualParameters,\n          hostRecord: current.hostRecord as never,\n          targetResourceType: resourceType,\n          targetId: id,\n          registry: current.registry,\n        }).contextualParameters,\n        readOperation,\n        t: current.t,\n        formatDate: current.formatDate,\n        formatDateTime: current.formatDateTime,\n      }).then(({ record }) => {\n        if (!cancelled) setRows((held) => ({ ...held, [key]: record }));\n      }).catch((error: unknown) => {\n        // Fails open: the declaration sees no row and offers what it can without one; the operation still refuses.\n        console.warn(`[requestFieldOffers] The ${resourceType} \"${id}\" a request field references could not be read; its offer narrows nothing by it.`, error);\n      });\n    }\n    return () => { cancelled = true; };\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- keyed on the picked ids\n  }, [idsKey]);\n\n  return useMemo(\n    () => Object.fromEntries(ids.map(({ field, resourceType, id }) => [field, id ? rows[`${resourceType}:${id}`] : undefined])),\n    [ids, rows],\n  );\n}\n"]}

package/dist/esm/components/form/chromes/FormFieldChrome.d.ts

@@ -36,6 +36,12 @@ export interface FormFieldChromeProps {
     saveState?: AutosaveFieldState;
     saveErrorMessage?: string;
     onRetrySave?: () => void;
+    /**
+     * Saves this field at once, given for a field that AUTOSAVES (only its caller knows the field's own autosave trigger).
+     * A bulk update form's explicit clear (#2620) uses it so the clear is written as the field's other changes are; absent,
+     * the clear waits for the form's save.
+     */
+    onSaveFieldNow?: (value: unknown) => void;
     fieldName?: string;
     disabled?: boolean;
     tooltip?: string;
@@ -57,6 +63,6 @@ export interface FormFieldChromeProps {
 }
 import { type AutoLabelPlacement } from "@wildo-ai/presets-components-models";
 declare function resolveEffectiveChromeMode(chromeMode: ResponsiveChromeMode | undefined, currentBreakpoint: ViewportBreakpoint, isMobile: boolean): EditChromeMode;
-declare function FormFieldChrome({ mode, label, description, error, required, labelPlacement, hideLabel, hideDescription, hideError, saveState, saveErrorMessage, onRetrySave, fieldName, disabled, tooltip, wideControl, className, children, }: FormFieldChromeProps): React.JSX.Element;
+declare function FormFieldChrome({ mode, label, description, error, required, labelPlacement, hideLabel, hideDescription, hideError, saveState, saveErrorMessage, onRetrySave, onSaveFieldNow, fieldName, disabled, tooltip, wideControl, className, children, }: FormFieldChromeProps): React.JSX.Element;
 export { FormFieldChrome, resolveEffectiveChromeMode };
 //# sourceMappingURL=FormFieldChrome.d.ts.map

package/dist/esm/components/form/chromes/FormFieldChrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormFieldChrome.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/chromes/FormFieldChrome.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,kBAAkB,EACnB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,oBAAoB,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAID,OAAO,EAAqC,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAA;AAShH,iBAAS,0BAA0B,CACjC,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,iBAAiB,EAAE,kBAAkB,EACrC,QAAQ,EAAE,OAAO,GAChB,cAAc,CAuBhB;AAmCD,iBAAS,eAAe,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,cAAc,EACd,SAAS,EACT,eAAe,EACf,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,GACT,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmR1C;AAID,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,CAAA"}
+{"version":3,"file":"FormFieldChrome.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/chromes/FormFieldChrome.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,kBAAkB,EACnB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,oBAAoB,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAID,OAAO,EAAqC,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAA;AAUhH,iBAAS,0BAA0B,CACjC,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,iBAAiB,EAAE,kBAAkB,EACrC,QAAQ,EAAE,OAAO,GAChB,cAAc,CAuBhB;AAmCD,iBAAS,eAAe,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,cAAc,EACd,SAAS,EACT,eAAe,EACf,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,SAAS,EACT,QAAQ,EACR,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,GACT,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqR1C;AAID,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,CAAA"}

package/dist/esm/components/form/chromes/FormFieldChrome.js

@@ -12,6 +12,7 @@ import { useI18n } from "../../../core/i18n/useI18n.js";
 import { FrontendComponentType, ButtonSize } from "@wildo-ai/presets-components-models";
 import { useUI } from "../../../core/ui/useUI.js";
 import { Button, ButtonVariants_Variant } from "../../../components/actions/button.js";
+import { BulkFieldClearSlot } from "../../../components/form/automated/bulk-field-clear-context.js";
 // =============================================================================
 // VIEWPORT-AWARE MODE RESOLUTION
 // =============================================================================
@@ -50,7 +51,7 @@ function TooltipIcon({ text }) {
 // =============================================================================
 // COMPONENT
 // =============================================================================
-function FormFieldChrome({ mode, label, description, error, required, labelPlacement, hideLabel, hideDescription, hideError, saveState, saveErrorMessage, onRetrySave, fieldName, disabled, tooltip, wideControl, className, children, }) {
+function FormFieldChrome({ mode, label, description, error, required, labelPlacement, hideLabel, hideDescription, hideError, saveState, saveErrorMessage, onRetrySave, onSaveFieldNow, fieldName, disabled, tooltip, wideControl, className, children, }) {
     const { currentBreakpoint, isMobile } = useUI();
     const effectiveMode = useMemo(() => resolveEffectiveChromeMode(mode, currentBreakpoint, isMobile), [mode, currentBreakpoint, isMobile]);
     // Deterministic IDs for aria-describedby linkage and label-input association
@@ -69,8 +70,10 @@ function FormFieldChrome({ mode, label, description, error, required, labelPlace
         : null;
     // Determine autosave indicator variant based on chrome mode
     const autosaveVariant = effectiveLabelPlacement === 'start' || effectiveLabelPlacement === 'inline' ? "inline" : "block";
-    // Wrap children with autosave indicator
-    const wrappedChildren = wrapWithAutosaveIndicator(_jsx(_Fragment, { children: children }), { saveState, saveErrorMessage, onRetrySave, variant: autosaveVariant });
+    // Wrap children with autosave indicator. On a bulk update form the control carries the explicit "clear on every selected
+    // record" choice (#2620), here so every chrome mode gets it from one place. The renderers that draw no chrome carry it
+    // themselves: a list on its section path (AutomatedArrayField), an object, a record and a map (FormField).
+    const wrappedChildren = wrapWithAutosaveIndicator(_jsx(BulkFieldClearSlot, { fieldName: fieldName, label: label, disabled: disabled, onSaveFieldNow: onSaveFieldNow, children: children }), { saveState, saveErrorMessage, onRetrySave, variant: autosaveVariant });
     // ── HIDDEN mode: pass through ──
     if (effectiveMode === EditChromeMode.HIDDEN) {
         return _jsxs(_Fragment, { children: [hiddenLabel, wrappedChildren] });