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

package/dist/esm/components/form/automated/automated-form-submit.utils.d.ts

@@ -22,6 +22,8 @@ type SubmissionContextFieldValues = Record<string, unknown>;
  */
 export declare function shouldOmitClearedFieldsForOperation(coreOperation: CoreResourceOperation | undefined, formOperationType: string | undefined): boolean;
 export declare function pickSubmissionDataPaths<TData extends Record<string, unknown>>(data: TData, fieldNames: string[]): Partial<TData>;
+/** `data` with `value` written at `path` (`address.city`, `steps[0].title`), as a copy. */
+export declare function withPathValue<TData extends Record<string, unknown>>(data: TData, path: string, value: unknown): TData;
 /**
  * Give a PARTIAL write of a composite its stored siblings, so the UPDATE does not erase them.
  *
@@ -60,16 +62,114 @@ export declare function sanitizeAutomatedFormSubmissionData<TData extends Record
      */
     schema?: z.ZodTypeAny;
 }): TData;
+/**
+ * The paths a BULK update writes for the field paths a form saves (`contact.city`, `steps[0].title`): each path cut at
+ * the first value that cannot be written child by child (#2581).
+ *
+ * A path through child-writable nested objects is kept, so a bulk update changes that child on every row and each row
+ * keeps its other children. A path into an array (`steps[0].title` → `steps`), a value type (`price.amount` → `price`)
+ * or an object with its own refinement is cut there, and that whole value is written, from the form's full values: a
+ * part of it would name something else on every row, or skip the refinement. So is a field the request REQUIRES, which {@link bulkUpdatePatch} writes whole. Duplicates are dropped, and so is
+ * a path under another one in the list.
+ */
+export declare function bulkWriteUnits(paths: readonly string[], schema: z.ZodTypeAny | undefined): string[];
+/**
+ * The body of a BULK update form's write: what the person changed, each nested child by its dotted path (#2581).
+ *
+ * The server replaces a nested object whole on every row it writes, and a bulk selection has a different object on
+ * every row, so `{ contact: { city } }` would erase each row's own `contact.zip`. A child-writable nested object is
+ * therefore written child by child (`'contact.city': 'Paris'`), and only the children the person changed: what a bulk form shows
+ * at first is a seed, not the rows' values ({@link bulkValueChanged}), so an untouched child is not written. Bulk
+ * editors behave this way (Jira's bulk edit and Salesforce's mass update change only the fields you set).
+ *
+ * Written as the form holds them, whatever the seed:
+ * - `writtenAsHeld`: the context-owned fields, which stay authoritative at submit time;
+ * - a field the request REQUIRES (it parses no `undefined`): the operation cannot run without it, and a required
+ *   nested object is written whole, since the request names the object. Except `variantFields`, the fields that select
+ *   a polymorphic record's variant: a seeded one written to every row would move every row to the seed's variant, so
+ *   it is written only when changed.
+ *
+ * A value the person emptied, where the form showed one, is written as `null`, the cleared sentinel: the server clears it
+ * by the field's declaration, or refuses it for a required one.
+ *
+ * `clears` are the person's EXPLICIT choices to clear, empty or turn off a field on every selected row (#2620), each the
+ * value {@link resolveBulkFieldClear} chose for its path. A clear replaces whatever the form holds at that path and under
+ * it: the person said what the field should be, and a value the control still holds is the one they chose to drop.
+ *
+ * @param values what the form holds, or the part of it a section or an autosave writes.
+ * @param seed what the form was initialized with.
+ */
+export declare function bulkUpdatePatch(params: {
+    values: Record<string, unknown>;
+    seed: Record<string, unknown> | null | undefined;
+    schema: z.ZodTypeAny | undefined;
+    writtenAsHeld?: readonly string[];
+    variantFields?: readonly string[];
+    clears?: Readonly<Record<string, unknown>>;
+}): Record<string, unknown>;
+/**
+ * The explicit clears a write of `units` carries (#2620): those at a unit, under one, or over one. A section or an
+ * autosave writes some of the form's fields, and a clear the person chose on one of them belongs to that write; a clear on
+ * another field waits for the write that covers it.
+ */
+export declare function bulkClearsWithin(clears: Readonly<Record<string, unknown>>, units: readonly string[]): Record<string, unknown>;
+/**
+ * What an explicit "on every selected record" choice writes for one field of a bulk update form (#2620).
+ *
+ * A bulk form writes only what the person set, and an untouched control holds the same `null`, `[]` or `false` that a
+ * control set and taken back holds (`bulkValueChanged`). So clearing a field, emptying a list or turning a switch off on
+ * every selected row takes a choice of its own, as Jira's bulk edit ("Clear field") and Salesforce's mass update offer it.
+ */
+export declare enum BulkFieldClearKind {
+    /** An optional value, written as `null`: the server clears it by the field's declaration. */
+    CLEAR = "clear",
+    /** A list, written as `[]`. */
+    EMPTY = "empty",
+    /** A switch, written as `false`. */
+    TURN_OFF = "turn_off"
+}
+export interface BulkFieldClear {
+    kind: BulkFieldClearKind;
+    /** The value the write carries for the field's path. */
+    value: null | [] | false;
+}
+/**
+ * Whether a field of a bulk update form can be cleared on every selected row, and with which value (#2620).
+ *
+ * Decided by the REQUEST's declaration, as the server decides it, never by the bulk form's own schema: that one makes
+ * every nested child optional (`withOptionalNestedChildren`) so a person can change one child alone, and would offer a
+ * clear the server refuses.
+ * - A top-level field is judged by the request DTO as it is: an update DTO admits `null` exactly for the fields that may
+ *   be cleared (`toPatchOptionalField`). A field the request requires is written as the form holds it, so it needs none.
+ * - A nested child (`'address.city'`) is judged as the server parses a child write: its declared schema through
+ *   `toPatchOptionalField` (`parseNestedChildWrites`).
+ *
+ * The value follows the field's base type: a switch is turned off (`false`), a list emptied (`[]`), anything else cleared
+ * (`null`). It is offered only when that value parses, so a required value offers none, nor does a list declaring a
+ * minimum length. Such a list is not offered `null` instead: the form holds a list as an array (a field array resyncs only
+ * from one), and an empty one would fail the list's own minimum before anything was sent.
+ *
+ * Only a field written as its OWN unit is offered one ({@link bulkWriteUnits}): an array item's child, a value type's part
+ * or a child of a required object is written as that whole value, so a clear there would be a different write. Nor is a
+ * field selecting a polymorphic record's variant (`variantFields`): clearing it would move every row to no variant.
+ *
+ * @param path the field's path in the form (`'dueDate'`, `'address.city'`).
+ * @param requestDto the operation's request DTO as declared, before the bulk form relaxes it.
+ * @param formSchema the bulk form's schema, which decides the write units as the patch builder does.
+ */
+export declare function resolveBulkFieldClear(path: string, requestDto: z.ZodTypeAny | undefined, formSchema: z.ZodTypeAny | undefined, variantFields?: readonly string[]): BulkFieldClear | undefined;
 /**
  * Whether a resource form offers its sections a Save of their own.
  *
- * A section save writes part of records that EXIST — one record, or a bulk selection — so a create form, whose
- * record does not exist yet, offers none. Measured on Wonder Todos' reminder rule: the create
- * dialog showed three section "Save" buttons above its own Create, and none of them could create anything. A
- * caller that supplies its own section handler owns what a section save means, so it is honoured on any operation.
+ * A section save writes some of the FIELDS of records that exist (one record, or a bulk selection), so only an
+ * update-like operation offers it. A create form, whose record does not exist yet, offers none: measured on Wonder
+ * Todos' reminder rule, the create dialog showed three section "Save" buttons above its own Create, and none of them
+ * could create anything. Nor does a custom verb that is not update-like (an "approve", a "send invitation"): its form
+ * is the input of ONE action, and saving a section of it ran the action with part of its input. A caller that supplies
+ * its own section handler owns what a section save means, so it is honoured on any operation.
  */
 export declare function formOffersSectionSave(params: {
-    createsRecord: boolean;
+    writesRecordFields: boolean;
     hasCallerSectionHandler: boolean;
 }): boolean;
 export {};

package/dist/esm/components/form/automated/automated-form-submit.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automated-form-submit.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,KAAK,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,OAAO,CAGT;AA8FD,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,IAAI,EAAE,KAAK,EACX,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,KAAK,CAAC,CAkBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAwDD;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvF,IAAI,EAAE,KAAK,EACX,OAAO,EAAE;IACP,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,4BAA4B,CAAC;IAClD,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CACvB,GACA,KAAK,CAwBP;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,uBAAuB,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEnH"}
+{"version":3,"file":"automated-form-submit.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/form/automated/automated-form-submit.utils.js

@@ -1,4 +1,5 @@
-import { getObjectLikeFieldSchema } from '@wildo-ai/zod-decorators';
+import isEqual from 'lodash/isEqual.js';
+import { getNestedChildFieldSchema, getObjectLikeFieldSchema, getObjectShape, getZodType, isChildWritableObject, toPatchOptionalField, unwrapSchema } from '@wildo-ai/zod-decorators';
 import { isUpdateLikeCoreOperation } from '../../../core/resources/operation-semantics.frontend.utils.js';
 /**
  * Should a cleared (`null`) key be DROPPED from this submission?
@@ -113,6 +114,11 @@ export function pickSubmissionDataPaths(data, fieldNames) {
     }
     return subset;
 }
+/** `data` with `value` written at `path` (`address.city`, `steps[0].title`), as a copy. */
+export function withPathValue(data, path, value) {
+    const pathTokens = tokenizePath(path);
+    return (pathTokens.length === 0 ? data : setPath(data, pathTokens, value));
+}
 /**
  * Give a PARTIAL write of a composite its stored siblings, so the UPDATE does not erase them.
  *
@@ -237,15 +243,228 @@ export function sanitizeAutomatedFormSubmissionData(data, options) {
     }
     return sanitizedData;
 }
+/**
+ * Whether `schema` is a nested object whose children a bulk update writes one by one: the predicate the server walks a
+ * dotted path with (`isChildWritableObject`), so the two cannot disagree. A value type stored as an object (money, a
+ * file), an object with a refinement of its own, and an array are written whole.
+ */
+function isChildWritable(schema) {
+    return schema !== undefined && isChildWritableObject(schema);
+}
+/** A child of a nested object's shape, by OWN key only (`constructor` is no child of anything). */
+function ownShapeEntry(schema, key) {
+    const shape = getObjectShape(schema);
+    return shape && Object.hasOwn(shape, key) ? shape[key] : undefined;
+}
+function isPlainRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) && !(value instanceof Date);
+}
+/**
+ * The paths a BULK update writes for the field paths a form saves (`contact.city`, `steps[0].title`): each path cut at
+ * the first value that cannot be written child by child (#2581).
+ *
+ * A path through child-writable nested objects is kept, so a bulk update changes that child on every row and each row
+ * keeps its other children. A path into an array (`steps[0].title` → `steps`), a value type (`price.amount` → `price`)
+ * or an object with its own refinement is cut there, and that whole value is written, from the form's full values: a
+ * part of it would name something else on every row, or skip the refinement. So is a field the request REQUIRES, which {@link bulkUpdatePatch} writes whole. Duplicates are dropped, and so is
+ * a path under another one in the list.
+ */
+export function bulkWriteUnits(paths, schema) {
+    const units = new Set();
+    for (const path of paths) {
+        const [root, ...rest] = tokenizePath(path);
+        if (root === undefined)
+            continue;
+        let unit = root;
+        let current = schema ? getObjectLikeFieldSchema(schema, root) : undefined;
+        if (current !== undefined && !current.safeParse(undefined).success) {
+            units.add(unit);
+            continue;
+        }
+        for (const segment of rest) {
+            if (!isChildWritable(current))
+                break;
+            unit = `${unit}.${segment}`;
+            current = ownShapeEntry(current, segment);
+        }
+        units.add(unit);
+    }
+    const all = [...units];
+    return all.filter((unit) => !all.some((other) => other !== unit && unit.startsWith(`${other}.`)));
+}
+/**
+ * Whether a value in a bulk form differs from what the form showed at first: whether the person CHANGED it.
+ *
+ * What a bulk form shows at first is not any row's value (each selected row has its own); it is the SEED the form
+ * starts from, the schema's defaults. So an unchanged field says nothing about the rows, and is not written.
+ *
+ * Every value a control holds when it LOOKS untouched is one value here: `undefined`, `''`, `null`, `false` and `[]`.
+ * Each is what some control leaves behind after a person sets it and takes it back: an emptied text input holds `null`
+ * (`FormField`'s clearing normalisation), a checkbox group checked then unchecked holds `[]`, a switch turned on then
+ * off holds `false`. Writing any of them would change that field on every selected row while the form looks exactly
+ * as it did. Emptying a field that showed a value IS a change, and is written.
+ *
+ * So clearing a field, emptying a list or turning a switch off on every row is never read off an input that looks the
+ * same set or unset: it is an explicit choice beside the field, as Jira's bulk edit and Salesforce's mass update offer it,
+ * carried as `clears` by {@link bulkUpdatePatch} (#2620).
+ */
+function bulkValueChanged(value, seed) {
+    const looksUntouched = (candidate) => candidate === undefined || candidate === null || candidate === ''
+        || candidate === false || (Array.isArray(candidate) && candidate.length === 0);
+    if (looksUntouched(value))
+        return !looksUntouched(seed);
+    return !isEqual(value, seed);
+}
+/**
+ * The body of a BULK update form's write: what the person changed, each nested child by its dotted path (#2581).
+ *
+ * The server replaces a nested object whole on every row it writes, and a bulk selection has a different object on
+ * every row, so `{ contact: { city } }` would erase each row's own `contact.zip`. A child-writable nested object is
+ * therefore written child by child (`'contact.city': 'Paris'`), and only the children the person changed: what a bulk form shows
+ * at first is a seed, not the rows' values ({@link bulkValueChanged}), so an untouched child is not written. Bulk
+ * editors behave this way (Jira's bulk edit and Salesforce's mass update change only the fields you set).
+ *
+ * Written as the form holds them, whatever the seed:
+ * - `writtenAsHeld`: the context-owned fields, which stay authoritative at submit time;
+ * - a field the request REQUIRES (it parses no `undefined`): the operation cannot run without it, and a required
+ *   nested object is written whole, since the request names the object. Except `variantFields`, the fields that select
+ *   a polymorphic record's variant: a seeded one written to every row would move every row to the seed's variant, so
+ *   it is written only when changed.
+ *
+ * A value the person emptied, where the form showed one, is written as `null`, the cleared sentinel: the server clears it
+ * by the field's declaration, or refuses it for a required one.
+ *
+ * `clears` are the person's EXPLICIT choices to clear, empty or turn off a field on every selected row (#2620), each the
+ * value {@link resolveBulkFieldClear} chose for its path. A clear replaces whatever the form holds at that path and under
+ * it: the person said what the field should be, and a value the control still holds is the one they chose to drop.
+ *
+ * @param values what the form holds, or the part of it a section or an autosave writes.
+ * @param seed what the form was initialized with.
+ */
+export function bulkUpdatePatch(params) {
+    const writtenAsHeld = new Set(params.writtenAsHeld ?? []);
+    const variantFields = new Set(params.variantFields ?? []);
+    const patch = {};
+    const collect = (value, seed, fieldSchema, path) => {
+        if (isChildWritable(fieldSchema) && isPlainRecord(value)) {
+            for (const [key, child] of Object.entries(value)) {
+                collect(child, isPlainRecord(seed) ? seed[key] : undefined, ownShapeEntry(fieldSchema, key), `${path}.${key}`);
+            }
+            return;
+        }
+        if (bulkValueChanged(value, seed))
+            patch[path] = value === undefined || value === '' ? null : value;
+    };
+    for (const [key, value] of Object.entries(params.values)) {
+        const fieldSchema = params.schema ? getObjectLikeFieldSchema(params.schema, key) : undefined;
+        const required = fieldSchema !== undefined && !variantFields.has(key) && !fieldSchema.safeParse(undefined).success;
+        if (writtenAsHeld.has(key) || required) {
+            if (value !== undefined)
+                patch[key] = value;
+            continue;
+        }
+        collect(value, params.seed?.[key], fieldSchema, key);
+    }
+    // A clear under another clear is part of it (clearing `address` clears `address.city`): written once, at the outer
+    // path, whatever order the clears come in, since the server refuses an object written beside its own child.
+    const clearPaths = Object.keys(params.clears ?? {});
+    for (const path of clearPaths) {
+        if (clearPaths.some((other) => path.startsWith(`${other}.`)))
+            continue;
+        for (const written of Object.keys(patch)) {
+            if (written === path || written.startsWith(`${path}.`))
+                delete patch[written];
+        }
+        patch[path] = params.clears[path];
+    }
+    return patch;
+}
+/**
+ * The explicit clears a write of `units` carries (#2620): those at a unit, under one, or over one. A section or an
+ * autosave writes some of the form's fields, and a clear the person chose on one of them belongs to that write; a clear on
+ * another field waits for the write that covers it.
+ */
+export function bulkClearsWithin(clears, units) {
+    return Object.fromEntries(Object.entries(clears).filter(([path]) => units.some((unit) => (path === unit || path.startsWith(`${unit}.`) || unit.startsWith(`${path}.`)))));
+}
+/**
+ * What an explicit "on every selected record" choice writes for one field of a bulk update form (#2620).
+ *
+ * A bulk form writes only what the person set, and an untouched control holds the same `null`, `[]` or `false` that a
+ * control set and taken back holds (`bulkValueChanged`). So clearing a field, emptying a list or turning a switch off on
+ * every selected row takes a choice of its own, as Jira's bulk edit ("Clear field") and Salesforce's mass update offer it.
+ */
+export var BulkFieldClearKind;
+(function (BulkFieldClearKind) {
+    /** An optional value, written as `null`: the server clears it by the field's declaration. */
+    BulkFieldClearKind["CLEAR"] = "clear";
+    /** A list, written as `[]`. */
+    BulkFieldClearKind["EMPTY"] = "empty";
+    /** A switch, written as `false`. */
+    BulkFieldClearKind["TURN_OFF"] = "turn_off";
+})(BulkFieldClearKind || (BulkFieldClearKind = {}));
+/**
+ * Whether a field of a bulk update form can be cleared on every selected row, and with which value (#2620).
+ *
+ * Decided by the REQUEST's declaration, as the server decides it, never by the bulk form's own schema: that one makes
+ * every nested child optional (`withOptionalNestedChildren`) so a person can change one child alone, and would offer a
+ * clear the server refuses.
+ * - A top-level field is judged by the request DTO as it is: an update DTO admits `null` exactly for the fields that may
+ *   be cleared (`toPatchOptionalField`). A field the request requires is written as the form holds it, so it needs none.
+ * - A nested child (`'address.city'`) is judged as the server parses a child write: its declared schema through
+ *   `toPatchOptionalField` (`parseNestedChildWrites`).
+ *
+ * The value follows the field's base type: a switch is turned off (`false`), a list emptied (`[]`), anything else cleared
+ * (`null`). It is offered only when that value parses, so a required value offers none, nor does a list declaring a
+ * minimum length. Such a list is not offered `null` instead: the form holds a list as an array (a field array resyncs only
+ * from one), and an empty one would fail the list's own minimum before anything was sent.
+ *
+ * Only a field written as its OWN unit is offered one ({@link bulkWriteUnits}): an array item's child, a value type's part
+ * or a child of a required object is written as that whole value, so a clear there would be a different write. Nor is a
+ * field selecting a polymorphic record's variant (`variantFields`): clearing it would move every row to no variant.
+ *
+ * @param path the field's path in the form (`'dueDate'`, `'address.city'`).
+ * @param requestDto the operation's request DTO as declared, before the bulk form relaxes it.
+ * @param formSchema the bulk form's schema, which decides the write units as the patch builder does.
+ */
+export function resolveBulkFieldClear(path, requestDto, formSchema, variantFields = []) {
+    if (!requestDto || !formSchema || variantFields.includes(path))
+        return undefined;
+    const units = bulkWriteUnits([path], formSchema);
+    if (units.length !== 1 || units[0] !== path)
+        return undefined;
+    let target;
+    if (path.includes('.')) {
+        const declared = getNestedChildFieldSchema(requestDto, path);
+        target = declared ? toPatchOptionalField(declared) : undefined;
+    }
+    else {
+        target = getObjectLikeFieldSchema(requestDto, path);
+        if (target && !target.safeParse(undefined).success)
+            return undefined;
+    }
+    if (!target)
+        return undefined;
+    const writeSchema = target;
+    const baseType = getZodType(unwrapSchema(writeSchema));
+    const candidate = baseType === 'boolean'
+        ? { kind: BulkFieldClearKind.TURN_OFF, value: false }
+        : baseType === 'array'
+            ? { kind: BulkFieldClearKind.EMPTY, value: [] }
+            : { kind: BulkFieldClearKind.CLEAR, value: null };
+    return writeSchema.safeParse(candidate.value).success ? candidate : undefined;
+}
 /**
  * Whether a resource form offers its sections a Save of their own.
  *
- * A section save writes part of records that EXIST — one record, or a bulk selection — so a create form, whose
- * record does not exist yet, offers none. Measured on Wonder Todos' reminder rule: the create
- * dialog showed three section "Save" buttons above its own Create, and none of them could create anything. A
- * caller that supplies its own section handler owns what a section save means, so it is honoured on any operation.
+ * A section save writes some of the FIELDS of records that exist (one record, or a bulk selection), so only an
+ * update-like operation offers it. A create form, whose record does not exist yet, offers none: measured on Wonder
+ * Todos' reminder rule, the create dialog showed three section "Save" buttons above its own Create, and none of them
+ * could create anything. Nor does a custom verb that is not update-like (an "approve", a "send invitation"): its form
+ * is the input of ONE action, and saving a section of it ran the action with part of its input. A caller that supplies
+ * its own section handler owns what a section save means, so it is honoured on any operation.
  */
 export function formOffersSectionSave(params) {
-    return !params.createsRecord || params.hasCallerSectionHandler;
+    return params.writesRecordFields || params.hasCallerSectionHandler;
 }
 //# sourceMappingURL=automated-form-submit.utils.js.map

package/dist/esm/components/form/automated/automated-form-submit.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"automated-form-submit.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { getObjectLikeFieldSchema } from '@wildo-ai/zod-decorators';\nimport { isUpdateLikeCoreOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\n\ntype SubmissionContextFieldValues = Record<string, unknown>;\n\n/**\n * Should a cleared (`null`) key be DROPPED from this submission?\n *\n * Yes on a create-like operation, where \"the user emptied this\" and \"the user never filled it\" are\n * the same state and absence already says it. No on an update-like one, where dropping the key\n * would discard the user's clear — the stored value would simply survive.\n *\n * A named decision rather than an inline comparison, because the inline version was WRONG: it\n * compared a raw operation IDENTIFIER against the literal `'update'`, and that identifier is an\n * arbitrary string for any custom operation. `UPDATE_MANY` and every custom update-like operation\n * that does not declare `resourceOperationLike` were therefore classified as creates, and their\n * clears were silently stripped before leaving the form.\n *\n * @param coreOperation - the RESOLVED core operation, supplied by a resource-aware wrapper. When\n *   present it is the only input consulted.\n * @param formOperationType - the raw identifier fallback, for a bare form mounted with no resource\n *   semantics. An unresolved operation is treated as create-like, the conservative direction: such a\n *   surface has no stored row whose value a dropped key could discard.\n */\nexport function shouldOmitClearedFieldsForOperation(\n  coreOperation: CoreResourceOperation | undefined,\n  formOperationType: string | undefined,\n): boolean {\n  if (coreOperation !== undefined) return !isUpdateLikeCoreOperation(coreOperation);\n  return formOperationType !== 'update';\n}\n\nfunction tokenizePath(path: string): string[] {\n  return path.match(/[^.[\\]]+/g) ?? [];\n}\n\nfunction omitPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0 || value === null || value === undefined || typeof value !== 'object') {\n    return value;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return value;\n    }\n\n    const copy = [...value];\n    if (rest.length === 0) {\n      copy.splice(index, 1);\n      return copy;\n    }\n\n    copy[index] = omitPath(copy[index], rest);\n    return copy;\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return value;\n  }\n\n  const copy = { ...recordValue };\n  if (rest.length === 0) {\n    delete copy[head];\n    return copy;\n  }\n\n  copy[head] = omitPath(copy[head], rest);\n  return copy;\n}\n\nfunction getPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0) {\n    return value;\n  }\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return undefined;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return undefined;\n    }\n    return getPath(value[index], rest);\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return undefined;\n  }\n\n  return getPath(recordValue[head], rest);\n}\n\nfunction setPath(value: unknown, pathTokens: string[], nextValue: unknown): unknown {\n  if (pathTokens.length === 0) {\n    return nextValue;\n  }\n\n  const [head, ...rest] = pathTokens;\n  const isArrayIndex = Number.isInteger(Number(head));\n\n  if (isArrayIndex) {\n    const index = Number(head);\n    const copy = Array.isArray(value) ? [...value] : [];\n    copy[index] = setPath(copy[index], rest, nextValue);\n    return copy;\n  }\n\n  const recordValue = value !== null && value !== undefined && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n  return {\n    ...recordValue,\n    [head]: setPath(recordValue[head], rest, nextValue),\n  };\n}\n\nexport function pickSubmissionDataPaths<TData extends Record<string, unknown>>(\n  data: TData,\n  fieldNames: string[],\n): Partial<TData> {\n  let subset: Record<string, unknown> = {};\n\n  for (const fieldName of fieldNames) {\n    const pathTokens = tokenizePath(fieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n\n    const fieldValue = getPath(data, pathTokens);\n    if (fieldValue === undefined) {\n      continue;\n    }\n\n    subset = setPath(subset, pathTokens, fieldValue) as Record<string, unknown>;\n  }\n\n  return subset as Partial<TData>;\n}\n\n/**\n * Give a PARTIAL write of a composite its stored siblings, so the UPDATE does not erase them.\n *\n * A section save sends only the paths its section registered, via\n * {@link pickSubmissionDataPaths}. That nests correctly, and it is still wrong when a composite's\n * children are split across sections: `{ address: { city } }` reaches an UPDATE that REPLACES a\n * nested object whole (a `jsonb` column on PostgreSQL, a subdocument `$set` on MongoDB), so the\n * `address.zip` owned by another section is erased (#1410).\n *\n * So each registered NESTED path is written into a copy of that parent's `stored` value — the last\n * thing the server said, the same source the RMM's `buildWireRequestData` and autosave use (#1395).\n * Not the form's values: those can hold another section's unsaved, possibly invalid edits, and a\n * section save must not commit them.\n *\n * Two cases are deliberately left as the body already has them:\n * - a root the section registers WHOLE (`address` itself) — its form value is complete, and merging\n *   stored keys into it would resurrect a key the person removed;\n * - a path the body no longer carries (sanitization dropped it) — the stored value stands.\n */\nexport function carryStoredSiblingsIntoPartialWrites(\n  body: Record<string, unknown>,\n  fieldNames: string[],\n  stored: Record<string, unknown> | null | undefined,\n): Record<string, unknown> {\n  if (!stored) return body;\n\n  const rootsRegisteredWhole = new Set(\n    fieldNames.map(tokenizePath).filter((tokens) => tokens.length === 1).map((tokens) => tokens[0]),\n  );\n  const rebasedRoots = new Set<string>();\n  let result: Record<string, unknown> = body;\n\n  for (const fieldName of fieldNames) {\n    const tokens = tokenizePath(fieldName);\n    if (tokens.length < 2) continue;\n    const root = tokens[0];\n    if (rootsRegisteredWhole.has(root)) continue;\n\n    const value = getPath(body, tokens);\n    if (value === undefined) continue;\n\n    if (!rebasedRoots.has(root)) {\n      rebasedRoots.add(root);\n      const storedParent = stored[root];\n      if (storedParent !== null && typeof storedParent === 'object') {\n        result = { ...result, [root]: storedParent };\n      }\n    }\n    result = setPath(result, tokens, value) as Record<string, unknown>;\n  }\n\n  return result;\n}\n\n/**\n * Drop top-level keys whose value is the framework's CLEARED sentinel (`null`).\n *\n * Only meaningful on a CREATE-like submission, and only there. On an UPDATE the two states are\n * genuinely different — an absent key leaves the stored value alone, a `null` clears it — so\n * stripping would silently discard the user's clear. On a CREATE there is nothing to leave alone:\n * \"the user emptied this field\" and \"the user never filled it\" are the same state, absence already\n * says it, and the CREATE request DTO deliberately does not accept null.\n *\n * The strip happens HERE rather than in the field change handler because form state must keep\n * `null`: react-hook-form reserves `undefined` to mean \"fall back to defaultValue\" and rejects it\n * from `onChange`, so a cleared field cannot be represented as `undefined` while it is being\n * edited. It only becomes absence at the boundary where the payload leaves the form.\n *\n * Nested objects are left alone: clearing a member of a nested object is expressed by replacing the\n * object, and this pass must not reach inside one and change its shape.\n */\nfunction omitClearedFieldKeys(\n  data: Record<string, unknown>,\n  schema: z.ZodTypeAny | undefined,\n): Record<string, unknown> {\n  const withoutClearedKeys: Record<string, unknown> = {};\n\n  for (const [fieldName, value] of Object.entries(data)) {\n    if (value === null && !fieldAcceptsNullAsAValue(schema, fieldName)) continue;\n    withoutClearedKeys[fieldName] = value;\n  }\n\n  return withoutClearedKeys;\n}\n\n/**\n * Did the AUTHOR declare `null` as a meaningful value for this field, or is it merely the\n * framework's cleared sentinel?\n *\n * The distinction decides whether the CREATE strip may drop the key. A field the create DTO refuses\n * a null for can only be carrying OUR sentinel, so dropping it is lossless. A field that ACCEPTS\n * null — an authored `.nullish()` — is one where the author modelled null as a value distinct from\n * absence, and dropping it changes what gets created.\n *\n * The case that makes this more than pedantry is `z.string().nullish().default('x')`: a default\n * fires on `undefined`, so stripping the user's explicit null makes the server apply the DEFAULT —\n * the opposite of what the user asked for. Found by independent review.\n *\n * An unresolvable field is treated as NOT null-accepting, i.e. stripped. That is the conservative\n * direction here: the create DTO would reject a null it does not declare, so keeping it would turn\n * a clear into a 400.\n */\nfunction fieldAcceptsNullAsAValue(schema: z.ZodTypeAny | undefined, fieldName: string): boolean {\n  if (!schema) return false;\n  const fieldSchema = getObjectLikeFieldSchema(schema, fieldName);\n  return fieldSchema ? fieldSchema.safeParse(null).success : false;\n}\n\n/**\n * Removes framework-hidden fields from the outgoing payload, then reapplies\n * context-owned values that must stay authoritative at submit time.\n *\n * On a CREATE-like operation it also drops cleared (`null`) keys — see `omitClearedFieldKeys` for\n * why that belongs at this boundary and why it must NOT happen on an UPDATE.\n */\nexport function sanitizeAutomatedFormSubmissionData<TData extends Record<string, unknown>>(\n  data: TData,\n  options: {\n    hiddenFieldNames?: string[];\n    contextFieldValues?: SubmissionContextFieldValues;\n    /** True when the submission creates a row, so absence and \"cleared\" are the same state. */\n    omitClearedFields?: boolean;\n    /**\n     * The schema this form validates. Used ONLY to tell an authored `.nullish()` null (a value)\n     * from the framework's cleared sentinel, so the CREATE strip does not discard the former.\n     */\n    schema?: z.ZodTypeAny;\n  },\n): TData {\n  let sanitizedData = options.omitClearedFields\n    ? omitClearedFieldKeys(data as Record<string, unknown>, options.schema)\n    : data as Record<string, unknown>;\n\n  for (const hiddenFieldName of options.hiddenFieldNames ?? []) {\n    const pathTokens = tokenizePath(hiddenFieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n    sanitizedData = omitPath(sanitizedData, pathTokens) as Record<string, unknown>;\n  }\n\n  if (options.contextFieldValues && Object.keys(options.contextFieldValues).length > 0) {\n    for (const [fieldName, fieldValue] of Object.entries(options.contextFieldValues)) {\n      const pathTokens = tokenizePath(fieldName);\n      if (pathTokens.length === 0) {\n        continue;\n      }\n      sanitizedData = setPath(sanitizedData, pathTokens, fieldValue) as Record<string, unknown>;\n    }\n  }\n\n  return sanitizedData as TData;\n}\n\n/**\n * Whether a resource form offers its sections a Save of their own.\n *\n * A section save writes part of records that EXIST — one record, or a bulk selection — so a create form, whose\n * record does not exist yet, offers none. Measured on Wonder Todos' reminder rule: the create\n * dialog showed three section \"Save\" buttons above its own Create, and none of them could create anything. A\n * caller that supplies its own section handler owns what a section save means, so it is honoured on any operation.\n */\nexport function formOffersSectionSave(params: { createsRecord: boolean; hasCallerSectionHandler: boolean }): boolean {\n  return !params.createsRecord || params.hasCallerSectionHandler;\n}\n"]}
+{"version":3,"file":"automated-form-submit.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/automated-form-submit.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import isEqual from 'lodash/isEqual.js';\nimport { z } from 'zod';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { getNestedChildFieldSchema, getObjectLikeFieldSchema, getObjectShape, getZodType, isChildWritableObject, toPatchOptionalField, unwrapSchema } from '@wildo-ai/zod-decorators';\nimport { isUpdateLikeCoreOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\n\ntype SubmissionContextFieldValues = Record<string, unknown>;\n\n/**\n * Should a cleared (`null`) key be DROPPED from this submission?\n *\n * Yes on a create-like operation, where \"the user emptied this\" and \"the user never filled it\" are\n * the same state and absence already says it. No on an update-like one, where dropping the key\n * would discard the user's clear — the stored value would simply survive.\n *\n * A named decision rather than an inline comparison, because the inline version was WRONG: it\n * compared a raw operation IDENTIFIER against the literal `'update'`, and that identifier is an\n * arbitrary string for any custom operation. `UPDATE_MANY` and every custom update-like operation\n * that does not declare `resourceOperationLike` were therefore classified as creates, and their\n * clears were silently stripped before leaving the form.\n *\n * @param coreOperation - the RESOLVED core operation, supplied by a resource-aware wrapper. When\n *   present it is the only input consulted.\n * @param formOperationType - the raw identifier fallback, for a bare form mounted with no resource\n *   semantics. An unresolved operation is treated as create-like, the conservative direction: such a\n *   surface has no stored row whose value a dropped key could discard.\n */\nexport function shouldOmitClearedFieldsForOperation(\n  coreOperation: CoreResourceOperation | undefined,\n  formOperationType: string | undefined,\n): boolean {\n  if (coreOperation !== undefined) return !isUpdateLikeCoreOperation(coreOperation);\n  return formOperationType !== 'update';\n}\n\nfunction tokenizePath(path: string): string[] {\n  return path.match(/[^.[\\]]+/g) ?? [];\n}\n\nfunction omitPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0 || value === null || value === undefined || typeof value !== 'object') {\n    return value;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return value;\n    }\n\n    const copy = [...value];\n    if (rest.length === 0) {\n      copy.splice(index, 1);\n      return copy;\n    }\n\n    copy[index] = omitPath(copy[index], rest);\n    return copy;\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return value;\n  }\n\n  const copy = { ...recordValue };\n  if (rest.length === 0) {\n    delete copy[head];\n    return copy;\n  }\n\n  copy[head] = omitPath(copy[head], rest);\n  return copy;\n}\n\nfunction getPath(value: unknown, pathTokens: string[]): unknown {\n  if (pathTokens.length === 0) {\n    return value;\n  }\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return undefined;\n  }\n\n  const [head, ...rest] = pathTokens;\n\n  if (Array.isArray(value)) {\n    const index = Number(head);\n    if (!Number.isInteger(index) || index < 0 || index >= value.length) {\n      return undefined;\n    }\n    return getPath(value[index], rest);\n  }\n\n  const recordValue = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(recordValue, head)) {\n    return undefined;\n  }\n\n  return getPath(recordValue[head], rest);\n}\n\nfunction setPath(value: unknown, pathTokens: string[], nextValue: unknown): unknown {\n  if (pathTokens.length === 0) {\n    return nextValue;\n  }\n\n  const [head, ...rest] = pathTokens;\n  const isArrayIndex = Number.isInteger(Number(head));\n\n  if (isArrayIndex) {\n    const index = Number(head);\n    const copy = Array.isArray(value) ? [...value] : [];\n    copy[index] = setPath(copy[index], rest, nextValue);\n    return copy;\n  }\n\n  const recordValue = value !== null && value !== undefined && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n  return {\n    ...recordValue,\n    [head]: setPath(recordValue[head], rest, nextValue),\n  };\n}\n\nexport function pickSubmissionDataPaths<TData extends Record<string, unknown>>(\n  data: TData,\n  fieldNames: string[],\n): Partial<TData> {\n  let subset: Record<string, unknown> = {};\n\n  for (const fieldName of fieldNames) {\n    const pathTokens = tokenizePath(fieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n\n    const fieldValue = getPath(data, pathTokens);\n    if (fieldValue === undefined) {\n      continue;\n    }\n\n    subset = setPath(subset, pathTokens, fieldValue) as Record<string, unknown>;\n  }\n\n  return subset as Partial<TData>;\n}\n\n/** `data` with `value` written at `path` (`address.city`, `steps[0].title`), as a copy. */\nexport function withPathValue<TData extends Record<string, unknown>>(data: TData, path: string, value: unknown): TData {\n  const pathTokens = tokenizePath(path);\n  return (pathTokens.length === 0 ? data : setPath(data, pathTokens, value)) as TData;\n}\n\n/**\n * Give a PARTIAL write of a composite its stored siblings, so the UPDATE does not erase them.\n *\n * A section save sends only the paths its section registered, via\n * {@link pickSubmissionDataPaths}. That nests correctly, and it is still wrong when a composite's\n * children are split across sections: `{ address: { city } }` reaches an UPDATE that REPLACES a\n * nested object whole (a `jsonb` column on PostgreSQL, a subdocument `$set` on MongoDB), so the\n * `address.zip` owned by another section is erased (#1410).\n *\n * So each registered NESTED path is written into a copy of that parent's `stored` value — the last\n * thing the server said, the same source the RMM's `buildWireRequestData` and autosave use (#1395).\n * Not the form's values: those can hold another section's unsaved, possibly invalid edits, and a\n * section save must not commit them.\n *\n * Two cases are deliberately left as the body already has them:\n * - a root the section registers WHOLE (`address` itself) — its form value is complete, and merging\n *   stored keys into it would resurrect a key the person removed;\n * - a path the body no longer carries (sanitization dropped it) — the stored value stands.\n */\nexport function carryStoredSiblingsIntoPartialWrites(\n  body: Record<string, unknown>,\n  fieldNames: string[],\n  stored: Record<string, unknown> | null | undefined,\n): Record<string, unknown> {\n  if (!stored) return body;\n\n  const rootsRegisteredWhole = new Set(\n    fieldNames.map(tokenizePath).filter((tokens) => tokens.length === 1).map((tokens) => tokens[0]),\n  );\n  const rebasedRoots = new Set<string>();\n  let result: Record<string, unknown> = body;\n\n  for (const fieldName of fieldNames) {\n    const tokens = tokenizePath(fieldName);\n    if (tokens.length < 2) continue;\n    const root = tokens[0];\n    if (rootsRegisteredWhole.has(root)) continue;\n\n    const value = getPath(body, tokens);\n    if (value === undefined) continue;\n\n    if (!rebasedRoots.has(root)) {\n      rebasedRoots.add(root);\n      const storedParent = stored[root];\n      if (storedParent !== null && typeof storedParent === 'object') {\n        result = { ...result, [root]: storedParent };\n      }\n    }\n    result = setPath(result, tokens, value) as Record<string, unknown>;\n  }\n\n  return result;\n}\n\n/**\n * Drop top-level keys whose value is the framework's CLEARED sentinel (`null`).\n *\n * Only meaningful on a CREATE-like submission, and only there. On an UPDATE the two states are\n * genuinely different — an absent key leaves the stored value alone, a `null` clears it — so\n * stripping would silently discard the user's clear. On a CREATE there is nothing to leave alone:\n * \"the user emptied this field\" and \"the user never filled it\" are the same state, absence already\n * says it, and the CREATE request DTO deliberately does not accept null.\n *\n * The strip happens HERE rather than in the field change handler because form state must keep\n * `null`: react-hook-form reserves `undefined` to mean \"fall back to defaultValue\" and rejects it\n * from `onChange`, so a cleared field cannot be represented as `undefined` while it is being\n * edited. It only becomes absence at the boundary where the payload leaves the form.\n *\n * Nested objects are left alone: clearing a member of a nested object is expressed by replacing the\n * object, and this pass must not reach inside one and change its shape.\n */\nfunction omitClearedFieldKeys(\n  data: Record<string, unknown>,\n  schema: z.ZodTypeAny | undefined,\n): Record<string, unknown> {\n  const withoutClearedKeys: Record<string, unknown> = {};\n\n  for (const [fieldName, value] of Object.entries(data)) {\n    if (value === null && !fieldAcceptsNullAsAValue(schema, fieldName)) continue;\n    withoutClearedKeys[fieldName] = value;\n  }\n\n  return withoutClearedKeys;\n}\n\n/**\n * Did the AUTHOR declare `null` as a meaningful value for this field, or is it merely the\n * framework's cleared sentinel?\n *\n * The distinction decides whether the CREATE strip may drop the key. A field the create DTO refuses\n * a null for can only be carrying OUR sentinel, so dropping it is lossless. A field that ACCEPTS\n * null — an authored `.nullish()` — is one where the author modelled null as a value distinct from\n * absence, and dropping it changes what gets created.\n *\n * The case that makes this more than pedantry is `z.string().nullish().default('x')`: a default\n * fires on `undefined`, so stripping the user's explicit null makes the server apply the DEFAULT —\n * the opposite of what the user asked for. Found by independent review.\n *\n * An unresolvable field is treated as NOT null-accepting, i.e. stripped. That is the conservative\n * direction here: the create DTO would reject a null it does not declare, so keeping it would turn\n * a clear into a 400.\n */\nfunction fieldAcceptsNullAsAValue(schema: z.ZodTypeAny | undefined, fieldName: string): boolean {\n  if (!schema) return false;\n  const fieldSchema = getObjectLikeFieldSchema(schema, fieldName);\n  return fieldSchema ? fieldSchema.safeParse(null).success : false;\n}\n\n/**\n * Removes framework-hidden fields from the outgoing payload, then reapplies\n * context-owned values that must stay authoritative at submit time.\n *\n * On a CREATE-like operation it also drops cleared (`null`) keys — see `omitClearedFieldKeys` for\n * why that belongs at this boundary and why it must NOT happen on an UPDATE.\n */\nexport function sanitizeAutomatedFormSubmissionData<TData extends Record<string, unknown>>(\n  data: TData,\n  options: {\n    hiddenFieldNames?: string[];\n    contextFieldValues?: SubmissionContextFieldValues;\n    /** True when the submission creates a row, so absence and \"cleared\" are the same state. */\n    omitClearedFields?: boolean;\n    /**\n     * The schema this form validates. Used ONLY to tell an authored `.nullish()` null (a value)\n     * from the framework's cleared sentinel, so the CREATE strip does not discard the former.\n     */\n    schema?: z.ZodTypeAny;\n  },\n): TData {\n  let sanitizedData = options.omitClearedFields\n    ? omitClearedFieldKeys(data as Record<string, unknown>, options.schema)\n    : data as Record<string, unknown>;\n\n  for (const hiddenFieldName of options.hiddenFieldNames ?? []) {\n    const pathTokens = tokenizePath(hiddenFieldName);\n    if (pathTokens.length === 0) {\n      continue;\n    }\n    sanitizedData = omitPath(sanitizedData, pathTokens) as Record<string, unknown>;\n  }\n\n  if (options.contextFieldValues && Object.keys(options.contextFieldValues).length > 0) {\n    for (const [fieldName, fieldValue] of Object.entries(options.contextFieldValues)) {\n      const pathTokens = tokenizePath(fieldName);\n      if (pathTokens.length === 0) {\n        continue;\n      }\n      sanitizedData = setPath(sanitizedData, pathTokens, fieldValue) as Record<string, unknown>;\n    }\n  }\n\n  return sanitizedData as TData;\n}\n\n/**\n * Whether `schema` is a nested object whose children a bulk update writes one by one: the predicate the server walks a\n * dotted path with (`isChildWritableObject`), so the two cannot disagree. A value type stored as an object (money, a\n * file), an object with a refinement of its own, and an array are written whole.\n */\nfunction isChildWritable(schema: z.ZodTypeAny | undefined): schema is z.ZodTypeAny {\n  return schema !== undefined && isChildWritableObject(schema);\n}\n\n/** A child of a nested object's shape, by OWN key only (`constructor` is no child of anything). */\nfunction ownShapeEntry(schema: z.ZodTypeAny, key: string): z.ZodTypeAny | undefined {\n  const shape = getObjectShape(schema);\n  return shape && Object.hasOwn(shape, key) ? shape[key] : undefined;\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value) && !(value instanceof Date);\n}\n\n/**\n * The paths a BULK update writes for the field paths a form saves (`contact.city`, `steps[0].title`): each path cut at\n * the first value that cannot be written child by child (#2581).\n *\n * A path through child-writable nested objects is kept, so a bulk update changes that child on every row and each row\n * keeps its other children. A path into an array (`steps[0].title` → `steps`), a value type (`price.amount` → `price`)\n * or an object with its own refinement is cut there, and that whole value is written, from the form's full values: a\n * part of it would name something else on every row, or skip the refinement. So is a field the request REQUIRES, which {@link bulkUpdatePatch} writes whole. Duplicates are dropped, and so is\n * a path under another one in the list.\n */\nexport function bulkWriteUnits(paths: readonly string[], schema: z.ZodTypeAny | undefined): string[] {\n  const units = new Set<string>();\n  for (const path of paths) {\n    const [root, ...rest] = tokenizePath(path);\n    if (root === undefined) continue;\n    let unit = root;\n    let current = schema ? getObjectLikeFieldSchema(schema, root) : undefined;\n    if (current !== undefined && !current.safeParse(undefined).success) {\n      units.add(unit);\n      continue;\n    }\n    for (const segment of rest) {\n      if (!isChildWritable(current)) break;\n      unit = `${unit}.${segment}`;\n      current = ownShapeEntry(current, segment);\n    }\n    units.add(unit);\n  }\n  const all = [...units];\n  return all.filter((unit) => !all.some((other) => other !== unit && unit.startsWith(`${other}.`)));\n}\n\n/**\n * Whether a value in a bulk form differs from what the form showed at first: whether the person CHANGED it.\n *\n * What a bulk form shows at first is not any row's value (each selected row has its own); it is the SEED the form\n * starts from, the schema's defaults. So an unchanged field says nothing about the rows, and is not written.\n *\n * Every value a control holds when it LOOKS untouched is one value here: `undefined`, `''`, `null`, `false` and `[]`.\n * Each is what some control leaves behind after a person sets it and takes it back: an emptied text input holds `null`\n * (`FormField`'s clearing normalisation), a checkbox group checked then unchecked holds `[]`, a switch turned on then\n * off holds `false`. Writing any of them would change that field on every selected row while the form looks exactly\n * as it did. Emptying a field that showed a value IS a change, and is written.\n *\n * So clearing a field, emptying a list or turning a switch off on every row is never read off an input that looks the\n * same set or unset: it is an explicit choice beside the field, as Jira's bulk edit and Salesforce's mass update offer it,\n * carried as `clears` by {@link bulkUpdatePatch} (#2620).\n */\nfunction bulkValueChanged(value: unknown, seed: unknown): boolean {\n  const looksUntouched = (candidate: unknown): boolean => candidate === undefined || candidate === null || candidate === ''\n    || candidate === false || (Array.isArray(candidate) && candidate.length === 0);\n  if (looksUntouched(value)) return !looksUntouched(seed);\n  return !isEqual(value, seed);\n}\n\n/**\n * The body of a BULK update form's write: what the person changed, each nested child by its dotted path (#2581).\n *\n * The server replaces a nested object whole on every row it writes, and a bulk selection has a different object on\n * every row, so `{ contact: { city } }` would erase each row's own `contact.zip`. A child-writable nested object is\n * therefore written child by child (`'contact.city': 'Paris'`), and only the children the person changed: what a bulk form shows\n * at first is a seed, not the rows' values ({@link bulkValueChanged}), so an untouched child is not written. Bulk\n * editors behave this way (Jira's bulk edit and Salesforce's mass update change only the fields you set).\n *\n * Written as the form holds them, whatever the seed:\n * - `writtenAsHeld`: the context-owned fields, which stay authoritative at submit time;\n * - a field the request REQUIRES (it parses no `undefined`): the operation cannot run without it, and a required\n *   nested object is written whole, since the request names the object. Except `variantFields`, the fields that select\n *   a polymorphic record's variant: a seeded one written to every row would move every row to the seed's variant, so\n *   it is written only when changed.\n *\n * A value the person emptied, where the form showed one, is written as `null`, the cleared sentinel: the server clears it\n * by the field's declaration, or refuses it for a required one.\n *\n * `clears` are the person's EXPLICIT choices to clear, empty or turn off a field on every selected row (#2620), each the\n * value {@link resolveBulkFieldClear} chose for its path. A clear replaces whatever the form holds at that path and under\n * it: the person said what the field should be, and a value the control still holds is the one they chose to drop.\n *\n * @param values what the form holds, or the part of it a section or an autosave writes.\n * @param seed what the form was initialized with.\n */\nexport function bulkUpdatePatch(params: {\n  values: Record<string, unknown>;\n  seed: Record<string, unknown> | null | undefined;\n  schema: z.ZodTypeAny | undefined;\n  writtenAsHeld?: readonly string[];\n  variantFields?: readonly string[];\n  clears?: Readonly<Record<string, unknown>>;\n}): Record<string, unknown> {\n  const writtenAsHeld = new Set(params.writtenAsHeld ?? []);\n  const variantFields = new Set(params.variantFields ?? []);\n  const patch: Record<string, unknown> = {};\n\n  const collect = (value: unknown, seed: unknown, fieldSchema: z.ZodTypeAny | undefined, path: string): void => {\n    if (isChildWritable(fieldSchema) && isPlainRecord(value)) {\n      for (const [key, child] of Object.entries(value)) {\n        collect(child, isPlainRecord(seed) ? seed[key] : undefined, ownShapeEntry(fieldSchema, key), `${path}.${key}`);\n      }\n      return;\n    }\n    if (bulkValueChanged(value, seed)) patch[path] = value === undefined || value === '' ? null : value;\n  };\n\n  for (const [key, value] of Object.entries(params.values)) {\n    const fieldSchema = params.schema ? getObjectLikeFieldSchema(params.schema, key) : undefined;\n    const required = fieldSchema !== undefined && !variantFields.has(key) && !fieldSchema.safeParse(undefined).success;\n    if (writtenAsHeld.has(key) || required) {\n      if (value !== undefined) patch[key] = value;\n      continue;\n    }\n    collect(value, params.seed?.[key], fieldSchema, key);\n  }\n  // A clear under another clear is part of it (clearing `address` clears `address.city`): written once, at the outer\n  // path, whatever order the clears come in, since the server refuses an object written beside its own child.\n  const clearPaths = Object.keys(params.clears ?? {});\n  for (const path of clearPaths) {\n    if (clearPaths.some((other) => path.startsWith(`${other}.`))) continue;\n    for (const written of Object.keys(patch)) {\n      if (written === path || written.startsWith(`${path}.`)) delete patch[written];\n    }\n    patch[path] = params.clears![path];\n  }\n  return patch;\n}\n\n/**\n * The explicit clears a write of `units` carries (#2620): those at a unit, under one, or over one. A section or an\n * autosave writes some of the form's fields, and a clear the person chose on one of them belongs to that write; a clear on\n * another field waits for the write that covers it.\n */\nexport function bulkClearsWithin(\n  clears: Readonly<Record<string, unknown>>,\n  units: readonly string[],\n): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(clears).filter(([path]) => units.some((unit) => (\n    path === unit || path.startsWith(`${unit}.`) || unit.startsWith(`${path}.`)\n  ))));\n}\n\n/**\n * What an explicit \"on every selected record\" choice writes for one field of a bulk update form (#2620).\n *\n * A bulk form writes only what the person set, and an untouched control holds the same `null`, `[]` or `false` that a\n * control set and taken back holds (`bulkValueChanged`). So clearing a field, emptying a list or turning a switch off on\n * every selected row takes a choice of its own, as Jira's bulk edit (\"Clear field\") and Salesforce's mass update offer it.\n */\nexport enum BulkFieldClearKind {\n  /** An optional value, written as `null`: the server clears it by the field's declaration. */\n  CLEAR = 'clear',\n  /** A list, written as `[]`. */\n  EMPTY = 'empty',\n  /** A switch, written as `false`. */\n  TURN_OFF = 'turn_off',\n}\n\nexport interface BulkFieldClear {\n  kind: BulkFieldClearKind;\n  /** The value the write carries for the field's path. */\n  value: null | [] | false;\n}\n\n/**\n * Whether a field of a bulk update form can be cleared on every selected row, and with which value (#2620).\n *\n * Decided by the REQUEST's declaration, as the server decides it, never by the bulk form's own schema: that one makes\n * every nested child optional (`withOptionalNestedChildren`) so a person can change one child alone, and would offer a\n * clear the server refuses.\n * - A top-level field is judged by the request DTO as it is: an update DTO admits `null` exactly for the fields that may\n *   be cleared (`toPatchOptionalField`). A field the request requires is written as the form holds it, so it needs none.\n * - A nested child (`'address.city'`) is judged as the server parses a child write: its declared schema through\n *   `toPatchOptionalField` (`parseNestedChildWrites`).\n *\n * The value follows the field's base type: a switch is turned off (`false`), a list emptied (`[]`), anything else cleared\n * (`null`). It is offered only when that value parses, so a required value offers none, nor does a list declaring a\n * minimum length. Such a list is not offered `null` instead: the form holds a list as an array (a field array resyncs only\n * from one), and an empty one would fail the list's own minimum before anything was sent.\n *\n * Only a field written as its OWN unit is offered one ({@link bulkWriteUnits}): an array item's child, a value type's part\n * or a child of a required object is written as that whole value, so a clear there would be a different write. Nor is a\n * field selecting a polymorphic record's variant (`variantFields`): clearing it would move every row to no variant.\n *\n * @param path the field's path in the form (`'dueDate'`, `'address.city'`).\n * @param requestDto the operation's request DTO as declared, before the bulk form relaxes it.\n * @param formSchema the bulk form's schema, which decides the write units as the patch builder does.\n */\nexport function resolveBulkFieldClear(\n  path: string,\n  requestDto: z.ZodTypeAny | undefined,\n  formSchema: z.ZodTypeAny | undefined,\n  variantFields: readonly string[] = [],\n): BulkFieldClear | undefined {\n  if (!requestDto || !formSchema || variantFields.includes(path)) return undefined;\n  const units = bulkWriteUnits([path], formSchema);\n  if (units.length !== 1 || units[0] !== path) return undefined;\n\n  let target: z.ZodTypeAny | undefined;\n  if (path.includes('.')) {\n    const declared = getNestedChildFieldSchema(requestDto, path);\n    target = declared ? toPatchOptionalField(declared) : undefined;\n  } else {\n    target = getObjectLikeFieldSchema(requestDto, path);\n    if (target && !target.safeParse(undefined).success) return undefined;\n  }\n  if (!target) return undefined;\n  const writeSchema = target;\n\n  const baseType = getZodType(unwrapSchema(writeSchema));\n  const candidate: BulkFieldClear = baseType === 'boolean'\n    ? { kind: BulkFieldClearKind.TURN_OFF, value: false }\n    : baseType === 'array'\n      ? { kind: BulkFieldClearKind.EMPTY, value: [] }\n      : { kind: BulkFieldClearKind.CLEAR, value: null };\n  return writeSchema.safeParse(candidate.value).success ? candidate : undefined;\n}\n\n/**\n * Whether a resource form offers its sections a Save of their own.\n *\n * A section save writes some of the FIELDS of records that exist (one record, or a bulk selection), so only an\n * update-like operation offers it. A create form, whose record does not exist yet, offers none: measured on Wonder\n * Todos' reminder rule, the create dialog showed three section \"Save\" buttons above its own Create, and none of them\n * could create anything. Nor does a custom verb that is not update-like (an \"approve\", a \"send invitation\"): its form\n * is the input of ONE action, and saving a section of it ran the action with part of its input. A caller that supplies\n * its own section handler owns what a section save means, so it is honoured on any operation.\n */\nexport function formOffersSectionSave(params: { writesRecordFields: boolean; hasCallerSectionHandler: boolean }): boolean {\n  return params.writesRecordFields || params.hasCallerSectionHandler;\n}\n\n"]}

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

@@ -0,0 +1,59 @@
+/**
+ * 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 { type ReactNode } from 'react';
+import { type BulkFieldClear } from './automated-form-submit.utils';
+export interface BulkFieldClearing {
+    /** How many records the form writes to, or `undefined` when its selection carries no count. */
+    selectionCount: number | undefined;
+    /** The clear a field may take on every selected record (`resolveBulkFieldClear`), or `undefined` for none. */
+    clearFor: (fieldName: string) => BulkFieldClear | undefined;
+    /** Whether the person chose to clear the field. */
+    isCleared: (fieldName: string) => boolean;
+    /** Chooses or withdraws a clear. Choosing one also empties what the field's control holds. */
+    setCleared: (fieldName: string, cleared: boolean) => void;
+    /**
+     * Records that the field's affordance is on screen, and returns the call that records it gone. A write carries only
+     * the clears of fields on screen: a field hidden after its clear was chosen (a `showWhen`, a variant switch) leaves
+     * the form's values, so its clear leaves the write too, and comes back with the field.
+     */
+    registerField: (fieldName: string) => () => void;
+}
+export declare const BulkFieldClearContext: import("react").Context<BulkFieldClearing>;
+/** The bulk form's clear choices, or `null` outside a bulk update form. */
+export declare function useBulkFieldClearing(): BulkFieldClearing | null;
+/**
+ * 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 declare function BulkFieldClearSlot({ fieldName, label, disabled, onSaveFieldNow, children, }: {
+    fieldName?: string;
+    /** The field's label, which describes the action for assistive technology. */
+    label?: string;
+    disabled?: boolean;
+    onSaveFieldNow?: (value: unknown) => void;
+    children: ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=bulk-field-clear-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-field-clear-context.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/bulk-field-clear-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAM7E,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGxF,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,8GAA8G;IAC9G,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAC5D,mDAAmD;IACnD,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,8FAA8F;IAC9F,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D;;;;OAIG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;CAClD;AAED,eAAO,MAAM,qBAAqB,4CAAgD,CAAC;AAEnF,2EAA2E;AAC3E,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D;AASD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,SAAS,EACT,KAAK,EACL,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,EAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+CpB"}