npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.3 → 1.1.5 - Mend

@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2521) hide show

package/dist/esm/components/form/validation-errors/getFieldError.d.ts CHANGED Viewed

@@ -2,6 +2,11 @@
  * getFieldError utility
  *
  * Separated from FormField.tsx for React Fast Refresh compatibility.
+ *
+ * Translates through `errors_validation.<type>.msg`, where `type` is the Zod issue code the form's
+ * resolver kept (`zodIssueResolver`, issue #995) and `params` are the issue's own fields. A field
+ * error with no type — a Standard Schema that is not Zod, or an error set by hand — still shows its
+ * message.
  */
 import { ValidationMode } from '@wildo-ai/zod-decorators';
 declare const FILE_VALIDATION_ERROR_TYPE: "file-validation";
@@ -26,6 +31,7 @@ export declare function getFieldError(fieldState: {
     error?: {
         type: string;
         message?: string;
+        params?: Record<string, unknown>;
     };
 }, isFormSubmitted: boolean, validationMode: ValidationMode, tErrorValidation: (code: string, suffix: string, params?: Record<string, unknown>) => string): string | undefined;
 export { FILE_VALIDATION_ERROR_TYPE, isRequiredFieldError };

package/dist/esm/components/form/validation-errors/getFieldError.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"getFieldError.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/form/validation-errors/getFieldError.ts"],"names":[],"mappings":"AAAA~~;;;;GAIG~~;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,QAAA,MAAM,0BAA0B,EAAG,iBAA0B,CAAC;AAK9D,iBAAS,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,~~EACjG~~,eAAe,EAAE,OAAO,EACxB,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAC3F,MAAM,GAAG,SAAS,~~CA4CpB~~;AAED,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,CAAC"}
1	+ {"version":3,"file":"getFieldError.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/getFieldError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,QAAA,MAAM,0BAA0B,EAAG,iBAA0B,CAAC;AAK9D,iBAAS,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,EACnI,eAAe,EAAE,OAAO,EACxB,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAC3F,MAAM,GAAG,SAAS,CAkDpB;AAED,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/esm/components/form/validation-errors/getFieldError.js CHANGED Viewed

@@ -2,6 +2,11 @@
  * getFieldError utility
  *
  * Separated from FormField.tsx for React Fast Refresh compatibility.
+ *
+ * Translates through `errors_validation.<type>.msg`, where `type` is the Zod issue code the form's
+ * resolver kept (`zodIssueResolver`, issue #995) and `params` are the issue's own fields. A field
+ * error with no type — a Standard Schema that is not Zod, or an error set by hand — still shows its
+ * message.
  */
 import { ValidationMode } from '@wildo-ai/zod-decorators';
 import { UNIQUE_ERROR_TYPE } from '../form-context.js';
@@ -47,7 +52,13 @@ export function getFieldError(fieldState, isFormSubmitted, validationMode, tErro
     if (errorType === UNIQUE_ERROR_TYPE) {
         return fieldState.error.message || tErrorValidation('custom', 'msg');
     }
-    const translated = tErrorValidation(errorType, 'msg', fieldState.error.message ? { message: fieldState.error.message } : undefined);
+    // The issue's own fields (`minimum`, `origin`, `format`, …) are the parameters the catalog is
+    // planned with (issue #995); the schema's message rides along as `message` for a catalog that
+    // chooses to show it.
+    const translated = tErrorValidation(errorType, 'msg', {
+        ...(fieldState.error.params ?? {}),
+        ...(fieldState.error.message ? { message: fieldState.error.message } : {}),
+    });
     if (translated === `errors_validation.${errorType}.msg` || translated.includes('..')) {
         if (fieldState.error.message) {
             return fieldState.error.message;

package/dist/esm/components/form/validation-errors/getFieldError.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"getFieldError.js","sourceRoot":"","sources":["~~../../../../../~~src/components/form/validation-errors/getFieldError.ts"],"names":[],"mappings":"AAAA~~;;;;GAIG~~;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,0BAA0B,GAAG,iBAA0B,CAAC;AAE9D,MAAM,sBAAsB,GAAG,8BAA8B,CAAC;AAC9D,MAAM,+BAA+B,GAAG,yCAAyC,CAAC;AAElF,SAAS,oBAAoB,CAAC,YAAoB;IAChD,OAAO,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,+BAA+B,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACzG,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,~~UAAiG~~,~~EACjG~~,eAAwB,EACxB,cAA8B,EAC9B,gBAA4F;IAE5F,MAAM,eAAe,GAAG,UAAU,CAAC,SAAS,IAAI,eAAe,IAAI,CACjE,CAAC,cAAc,KAAK,cAAc,CAAC,SAAS,IAAI,cAAc,KAAK,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CACtH,CAAC;IACF,IAAI,CAAC,eAAe,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IAClD,IAAI,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IAExC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,SAAS,KAAK,0BAA0B,EAAE,CAAC;QAC7C,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;QACpC,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CACjC,SAAS,EACT,KAAK,EACL,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,~~SAAS~~,~~CAC7E~~,CAAC;IAEF,IAAI,UAAU,KAAK,qBAAqB,SAAS,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrF,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["/*\n getFieldError utility\n * \n * Separated from FormField.tsx for React Fast Refresh compatibility.\n /\n\nimport { ValidationMode } from '@wildo-ai/zod-decorators';\nimport { UNIQUE_ERROR_TYPE } from '../form-context';\n\nconst FILE_VALIDATION_ERROR_TYPE = 'file-validation' as const;\n\nconst REQUIRED_FIELD_PATTERN = /received (undefined\|null)\\b/i;\nconst REQUIRED_FIELD_PATTERN_EXTENDED = /expected .+, received (undefined\|null)/i;\n\nfunction isRequiredFieldError(errorMessage: string): boolean {\n return REQUIRED_FIELD_PATTERN.test(errorMessage) \|\| REQUIRED_FIELD_PATTERN_EXTENDED.test(errorMessage);\n}\n\n/\n Calculate translated error message based on field state and touch behavior.\n * \n * Touch State Behavior\n * Only show validation errors if:\n * 1. Field has been touched (user interacted and blurred), OR\n * 2. Form has been submitted at least once\n * This prevents showing errors on initial render with invalid defaultValues.\n * \n * @param fieldState - RHF field state containing isTouched and error\n * @param isFormSubmitted - Whether the form has been submitted at least once\n * @param tErrorValidation - Translation function for error messages\n * @returns Translated error message or undefined if no error should be shown\n */\nexport function getFieldError(\n fieldState: { isTouched: boolean; isDirty?: boolean; error?: { type: string; message?: string } },\n isFormSubmitted: boolean,\n validationMode: ValidationMode,\n tErrorValidation: (code: string, suffix: string, params?: Record<string, unknown>) => string\n): string \| undefined {\n const shouldShowError = fieldState.isTouched \|\| isFormSubmitted \|\| (\n (validationMode === ValidationMode.ON_CHANGE \|\| validationMode === ValidationMode.ON_TOUCHED) && !!fieldState.isDirty\n );\n if (!shouldShowError \|\| !fieldState.error) {\n return undefined;\n }\n \n const rawMessage = fieldState.error.message \|\| '';\n if (isRequiredFieldError(rawMessage)) {\n return tErrorValidation('required', 'msg');\n }\n \n const errorType = fieldState.error.type;\n \n if (!errorType \|\| errorType.trim() === '') {\n if (fieldState.error.message) {\n return fieldState.error.message;\n }\n return tErrorValidation('custom', 'msg');\n }\n \n if (errorType === FILE_VALIDATION_ERROR_TYPE) {\n return fieldState.error.message \|\| tErrorValidation('custom', 'msg');\n }\n \n if (errorType === UNIQUE_ERROR_TYPE) {\n return fieldState.error.message \|\| tErrorValidation('custom', 'msg');\n }\n \n const translated = tErrorValidation(\n errorType,\n 'msg',\n fieldState.error.message ? { message: fieldState.error.message } : ~~undefined~~\n );\n \n if (translated === `errors_validation.${errorType}.msg` \|\| translated.includes('..')) {\n if (fieldState.error.message) {\n return fieldState.error.message;\n }\n return tErrorValidation('custom', 'msg');\n }\n \n return translated;\n}\n\nexport { FILE_VALIDATION_ERROR_TYPE, isRequiredFieldError };\n"]}
1	+ {"version":3,"file":"getFieldError.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/getFieldError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,0BAA0B,GAAG,iBAA0B,CAAC;AAE9D,MAAM,sBAAsB,GAAG,8BAA8B,CAAC;AAC9D,MAAM,+BAA+B,GAAG,yCAAyC,CAAC;AAElF,SAAS,oBAAoB,CAAC,YAAoB;IAChD,OAAO,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,+BAA+B,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACzG,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAmI,EACnI,eAAwB,EACxB,cAA8B,EAC9B,gBAA4F;IAE5F,MAAM,eAAe,GAAG,UAAU,CAAC,SAAS,IAAI,eAAe,IAAI,CACjE,CAAC,cAAc,KAAK,cAAc,CAAC,SAAS,IAAI,cAAc,KAAK,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CACtH,CAAC;IACF,IAAI,CAAC,eAAe,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IAClD,IAAI,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IAExC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,SAAS,KAAK,0BAA0B,EAAE,CAAC;QAC7C,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;QACpC,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,8FAA8F;IAC9F,8FAA8F;IAC9F,sBAAsB;IACtB,MAAM,UAAU,GAAG,gBAAgB,CACjC,SAAS,EACT,KAAK,EACL;QACE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAClC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CACF,CAAC;IAEF,IAAI,UAAU,KAAK,qBAAqB,SAAS,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrF,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["/*\n getFieldError utility\n \n Separated from FormField.tsx for React Fast Refresh compatibility.\n \n Translates through `errors_validation.<type>.msg`, where `type` is the Zod issue code the form's\n * resolver kept (`zodIssueResolver`, issue #995) and `params` are the issue's own fields. A field\n * error with no type — a Standard Schema that is not Zod, or an error set by hand — still shows its\n * message.\n /\n\nimport { ValidationMode } from '@wildo-ai/zod-decorators';\nimport { UNIQUE_ERROR_TYPE } from '../form-context';\n\nconst FILE_VALIDATION_ERROR_TYPE = 'file-validation' as const;\n\nconst REQUIRED_FIELD_PATTERN = /received (undefined\|null)\\b/i;\nconst REQUIRED_FIELD_PATTERN_EXTENDED = /expected .+, received (undefined\|null)/i;\n\nfunction isRequiredFieldError(errorMessage: string): boolean {\n return REQUIRED_FIELD_PATTERN.test(errorMessage) \|\| REQUIRED_FIELD_PATTERN_EXTENDED.test(errorMessage);\n}\n\n/\n Calculate translated error message based on field state and touch behavior.\n * \n * Touch State Behavior\n * Only show validation errors if:\n * 1. Field has been touched (user interacted and blurred), OR\n * 2. Form has been submitted at least once\n * This prevents showing errors on initial render with invalid defaultValues.\n * \n * @param fieldState - RHF field state containing isTouched and error\n * @param isFormSubmitted - Whether the form has been submitted at least once\n * @param tErrorValidation - Translation function for error messages\n * @returns Translated error message or undefined if no error should be shown\n */\nexport function getFieldError(\n fieldState: { isTouched: boolean; isDirty?: boolean; error?: { type: string; message?: string; params?: Record<string, unknown> } },\n isFormSubmitted: boolean,\n validationMode: ValidationMode,\n tErrorValidation: (code: string, suffix: string, params?: Record<string, unknown>) => string\n): string \| undefined {\n const shouldShowError = fieldState.isTouched \|\| isFormSubmitted \|\| (\n (validationMode === ValidationMode.ON_CHANGE \|\| validationMode === ValidationMode.ON_TOUCHED) && !!fieldState.isDirty\n );\n if (!shouldShowError \|\| !fieldState.error) {\n return undefined;\n }\n \n const rawMessage = fieldState.error.message \|\| '';\n if (isRequiredFieldError(rawMessage)) {\n return tErrorValidation('required', 'msg');\n }\n \n const errorType = fieldState.error.type;\n \n if (!errorType \|\| errorType.trim() === '') {\n if (fieldState.error.message) {\n return fieldState.error.message;\n }\n return tErrorValidation('custom', 'msg');\n }\n \n if (errorType === FILE_VALIDATION_ERROR_TYPE) {\n return fieldState.error.message \|\| tErrorValidation('custom', 'msg');\n }\n \n if (errorType === UNIQUE_ERROR_TYPE) {\n return fieldState.error.message \|\| tErrorValidation('custom', 'msg');\n }\n \n // The issue's own fields (`minimum`, `origin`, `format`, …) are the parameters the catalog is\n // planned with (issue #995); the schema's message rides along as `message` for a catalog that\n // chooses to show it.\n const translated = tErrorValidation(\n errorType,\n 'msg',\n {\n ...(fieldState.error.params ?? {}),\n ...(fieldState.error.message ? { message: fieldState.error.message } : {}),\n }\n );\n \n if (translated === `errors_validation.${errorType}.msg` \|\| translated.includes('..')) {\n if (fieldState.error.message) {\n return fieldState.error.message;\n }\n return tErrorValidation('custom', 'msg');\n }\n \n return translated;\n}\n\nexport { FILE_VALIDATION_ERROR_TYPE, isRequiredFieldError };\n"]}

package/dist/esm/components/form/validation-errors/resource-error-notification-context.utils.d.ts ADDED Viewed

@@ -0,0 +1,23 @@
+/**
+ * What a resource form hands the notification layer about a failed request — ONE place (#1048).
+ *
+ * `ResourceAutomatedForm` built this context by hand at four error sites, and they had already drifted:
+ * one carried the HTTP status and three did not. Adding the refusal code at four hand-built sites would
+ * have been the same invariant applied at some of its call sites, so every site spreads this instead.
+ *
+ * - `errorCustomMessageReference` — the backend's generic reference (`validation`, `conflict`, …).
+ * - `errorRefusalCode` — the DECLARED refusal the backend returned in `details.code`
+ *   (e.g. `SECRET_SLUG_NOT_DECLARED`). It is read from `error.context`, where the HTTP client keeps the
+ *   error body's `details`; the top-level `code` is deliberately not used, because on this error object
+ *   `code` is axios's own transport code (`ERR_BAD_REQUEST`), a different vocabulary.
+ * - `errorHttpStatus` — the status, for the notification layer's status-shaped defaults.
+ *
+ * The server's `details.message` is never carried: it is English prose, and display reads labels.
+ */
+export interface ResourceErrorNotificationContext {
+    errorCustomMessageReference?: string;
+    errorRefusalCode?: string;
+    errorHttpStatus?: number;
+}
+export declare function describeResourceErrorForNotification(error: unknown): ResourceErrorNotificationContext;
+//# sourceMappingURL=resource-error-notification-context.utils.d.ts.map

package/dist/esm/components/form/validation-errors/resource-error-notification-context.utils.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"resource-error-notification-context.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/resource-error-notification-context.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gCAAgC;IAC/C,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,gCAAgC,CAQrG"}

package/dist/esm/components/form/validation-errors/resource-error-notification-context.utils.js ADDED Viewed

@@ -0,0 +1,10 @@
+export function describeResourceErrorForNotification(error) {
+    const candidate = (error ?? {});
+    const context = (candidate.context ?? {});
+    return {
+        ...(typeof candidate.customMessageReference === 'string' ? { errorCustomMessageReference: candidate.customMessageReference } : {}),
+        ...(typeof context.code === 'string' && context.code.length > 0 ? { errorRefusalCode: context.code } : {}),
+        ...(typeof candidate.httpStatus === 'number' ? { errorHttpStatus: candidate.httpStatus } : {}),
+    };
+}
+//# sourceMappingURL=resource-error-notification-context.utils.js.map

package/dist/esm/components/form/validation-errors/resource-error-notification-context.utils.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"resource-error-notification-context.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/resource-error-notification-context.utils.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,oCAAoC,CAAC,KAAc;IACjE,MAAM,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE,CAAkF,CAAC;IACjH,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAuB,CAAC;IAChE,OAAO;QACL,GAAG,CAAC,OAAO,SAAS,CAAC,sBAAsB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,2BAA2B,EAAE,SAAS,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClI,GAAG,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1G,GAAG,CAAC,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC","sourcesContent":["/**\n * What a resource form hands the notification layer about a failed request — ONE place (#1048).\n *\n * `ResourceAutomatedForm` built this context by hand at four error sites, and they had already drifted:\n * one carried the HTTP status and three did not. Adding the refusal code at four hand-built sites would\n * have been the same invariant applied at some of its call sites, so every site spreads this instead.\n *\n * - `errorCustomMessageReference` — the backend's generic reference (`validation`, `conflict`, …).\n * - `errorRefusalCode` — the DECLARED refusal the backend returned in `details.code`\n * (e.g. `SECRET_SLUG_NOT_DECLARED`). It is read from `error.context`, where the HTTP client keeps the\n * error body's `details`; the top-level `code` is deliberately not used, because on this error object\n * `code` is axios's own transport code (`ERR_BAD_REQUEST`), a different vocabulary.\n * - `errorHttpStatus` — the status, for the notification layer's status-shaped defaults.\n *\n * The server's `details.message` is never carried: it is English prose, and display reads labels.\n */\nexport interface ResourceErrorNotificationContext {\n errorCustomMessageReference?: string;\n errorRefusalCode?: string;\n errorHttpStatus?: number;\n}\n\nexport function describeResourceErrorForNotification(error: unknown): ResourceErrorNotificationContext {\n const candidate = (error ?? {}) as { customMessageReference?: unknown; httpStatus?: unknown; context?: unknown };\n const context = (candidate.context ?? {}) as { code?: unknown };\n return {\n ...(typeof candidate.customMessageReference === 'string' ? { errorCustomMessageReference: candidate.customMessageReference } : {}),\n ...(typeof context.code === 'string' && context.code.length > 0 ? { errorRefusalCode: context.code } : {}),\n ...(typeof candidate.httpStatus === 'number' ? { errorHttpStatus: candidate.httpStatus } : {}),\n };\n}\n"]}

package/dist/esm/components/form/validation-errors/scroll-to-first-error.utils.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"scroll-to-first-error.utils.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/form/validation-errors/scroll-to-first-error.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAyBhG;AAWD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAkD/E"}
1	+ {"version":3,"file":"scroll-to-first-error.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/scroll-to-first-error.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAyBhG;AAWD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAkD/E"}

package/dist/esm/components/form/validation-errors/scroll-to-first-error.utils.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"scroll-to-first-error.utils.js","sourceRoot":"","sources":["~~../../../../../~~src/components/form/validation-errors/scroll-to-first-error.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n scroll-to-first-error.utils — bring the first invalid field into view after a\n * failed submit.\n \n ## Why this exists (audit finding D4)\n \n On submit-validation failure the errors render inline next to their fields,\n * but the viewport stays wherever the user was — typically at the submit button\n * at the BOTTOM of a long form, while the errored required fields sit invisible\n * at the top. The user sees a click that \"did nothing\".\n \n ## How the DOM lookup works\n \n Every visible `FormFieldChrome` mode renders `data-field={fieldName}` on its\n * outer wrapper (documented as the \"data-field safety net\" in\n * `FormFieldChrome.tsx`), and `AutomatedArrayField` renders it on the array's\n * `ContentSection`. We therefore:\n \n 1. Flatten the error object (react-hook-form `FieldErrors` or a server\n * validation-error map) into dotted field paths.\n * 2. Walk `[data-field]` elements in DOM order (error-object key order is\n * insertion order, not visual order) and pick the first element whose\n * `data-field` equals an errored path or is a structural ancestor of one\n * (e.g. the `checklist` array section for a `checklist.0.label` error).\n * 3. Scroll it into view (centered, smooth) and focus the first focusable\n * control inside it, so keyboard users land where the repair happens.\n \n The `[name=\"...\"]` fallback covers controls rendered outside a chrome wrapper.\n /\n\nimport type { FieldErrors } from 'react-hook-form';\n\n/\n Flatten a react-hook-form `FieldErrors` tree into dotted field paths.\n \n An error LEAF is any node carrying a string `message` or a string `type`\n * (the shape both the standard-schema resolver and `setError` produce). Array\n * `root` errors are attributed to the array path itself (`checklist.root` →\n * `checklist`). Order follows the error object's own insertion order — DOM\n * ordering is applied later by {@link scrollAndFocusFirstErroredField}.\n /\nexport function collectErroredFieldPaths(errors: FieldErrors \| Record<string, unknown>): string[] {\n const paths: string[] = [];\n\n const walk = (node: unknown, path: string): void => {\n if (!node \|\| typeof node !== 'object') return;\n const record = node as Record<string, unknown>;\n\n // Error leaf: RHF error objects carry `type` (string) and usually `message`.\n if (typeof record.message === 'string' \|\| typeof record.type === 'string') {\n if (path) paths.push(path);\n return;\n }\n\n for (const [key, value] of Object.entries(record)) {\n if (key === 'root') {\n // Array/object root errors belong to the container path itself.\n walk(value, path);\n continue;\n }\n walk(value, path ? `${path}.${key}` : key);\n }\n };\n\n walk(errors, '');\n return paths;\n}\n\nfunction escapeAttributeValue(value: string): string {\n // CSS.escape is available in every supported browser; fall back to a\n // conservative quote/backslash escape for non-DOM test environments.\n if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\n return CSS.escape(value);\n }\n return value.replace(/[\"\\\\]/g, '\\\\$&');\n}\n\n/\n Scroll the first errored field (in DOM order) into view and focus it.\n \n @param erroredPaths dotted field paths, e.g. from {@link collectErroredFieldPaths}\n * or `Object.keys(serverValidationErrors)`.\n * @returns `true` when a matching element was found and scrolled.\n */\nexport function scrollAndFocusFirstErroredField(erroredPaths: string[]): boolean {\n if (typeof document === 'undefined' \|\| erroredPaths.length === 0) return false;\n\n const pathSet = new Set(erroredPaths);\n let target: HTMLElement \| null = null;\n\n // DOM order is the authoritative \"first\" — the error map's key order is not.\n const chromeElements = document.querySelectorAll<HTMLElement>('[data-field]');\n for (const element of chromeElements) {\n const dataField = element.getAttribute('data-field');\n if (!dataField) continue;\n if (pathSet.has(dataField) \|\| erroredPaths.some((path) => path.startsWith(`${dataField}.`))) {\n target = element;\n break;\n }\n }\n\n // Fallback: controls registered by name without a chrome wrapper.\n if (!target) {\n for (const path of erroredPaths) {\n const byName = document.querySelector<HTMLElement>(`[name=\"${escapeAttributeValue(path)}\"]`);\n if (byName) {\n target = byName;\n break;\n }\n }\n }\n\n if (!target) return false;\n\n target.scrollIntoView({ behavior: 'smooth', block: 'center' });\n\n // Focus after the smooth scroll has started; `preventScroll` keeps the focus\n // jump from fighting the centered smooth scroll already in flight.\n const focusTarget = target;\n setTimeout(() => {\n if (!document.body.contains(focusTarget)) return;\n const focusable = focusTarget.matches('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])')\n ? focusTarget\n : focusTarget.querySelector<HTMLElement>('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])');\n if (focusable && document.body.contains(focusable)) {\n try {\n focusable.focus({ preventScroll: true });\n } catch {\n focusable.focus();\n }\n }\n }, 100);\n\n return true;\n}\n"]}
1	+ {"version":3,"file":"scroll-to-first-error.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/scroll-to-first-error.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n scroll-to-first-error.utils — bring the first invalid field into view after a\n * failed submit.\n \n ## Why this exists (audit finding D4)\n \n On submit-validation failure the errors render inline next to their fields,\n * but the viewport stays wherever the user was — typically at the submit button\n * at the BOTTOM of a long form, while the errored required fields sit invisible\n * at the top. The user sees a click that \"did nothing\".\n \n ## How the DOM lookup works\n \n Every visible `FormFieldChrome` mode renders `data-field={fieldName}` on its\n * outer wrapper (documented as the \"data-field safety net\" in\n * `FormFieldChrome.tsx`), and `AutomatedArrayField` renders it on the array's\n * `ContentSection`. We therefore:\n \n 1. Flatten the error object (react-hook-form `FieldErrors` or a server\n * validation-error map) into dotted field paths.\n * 2. Walk `[data-field]` elements in DOM order (error-object key order is\n * insertion order, not visual order) and pick the first element whose\n * `data-field` equals an errored path or is a structural ancestor of one\n * (e.g. the `checklist` array section for a `checklist.0.label` error).\n * 3. Scroll it into view (centered, smooth) and focus the first focusable\n * control inside it, so keyboard users land where the repair happens.\n \n The `[name=\"...\"]` fallback covers controls rendered outside a chrome wrapper.\n /\n\nimport type { FieldErrors } from 'react-hook-form';\n\n/\n Flatten a react-hook-form `FieldErrors` tree into dotted field paths.\n \n An error LEAF is any node carrying a string `message` or a string `type`\n * (the shape both the standard-schema resolver and `setError` produce). Array\n * `root` errors are attributed to the array path itself (`checklist.root` →\n * `checklist`). Order follows the error object's own insertion order — DOM\n * ordering is applied later by {@link scrollAndFocusFirstErroredField}.\n /\nexport function collectErroredFieldPaths(errors: FieldErrors \| Record<string, unknown>): string[] {\n const paths: string[] = [];\n\n const walk = (node: unknown, path: string): void => {\n if (!node \|\| typeof node !== 'object') return;\n const record = node as Record<string, unknown>;\n\n // Error leaf: RHF error objects carry `type` (string) and usually `message`.\n if (typeof record.message === 'string' \|\| typeof record.type === 'string') {\n if (path) paths.push(path);\n return;\n }\n\n for (const [key, value] of Object.entries(record)) {\n if (key === 'root') {\n // Array/object root errors belong to the container path itself.\n walk(value, path);\n continue;\n }\n walk(value, path ? `${path}.${key}` : key);\n }\n };\n\n walk(errors, '');\n return paths;\n}\n\nfunction escapeAttributeValue(value: string): string {\n // CSS.escape is available in every supported browser; fall back to a\n // conservative quote/backslash escape for non-DOM test environments.\n if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\n return CSS.escape(value);\n }\n return value.replace(/[\"\\\\]/g, '\\\\$&');\n}\n\n/\n Scroll the first errored field (in DOM order) into view and focus it.\n \n @param erroredPaths dotted field paths, e.g. from {@link collectErroredFieldPaths}\n * or `Object.keys(serverValidationErrors)`.\n * @returns `true` when a matching element was found and scrolled.\n */\nexport function scrollAndFocusFirstErroredField(erroredPaths: string[]): boolean {\n if (typeof document === 'undefined' \|\| erroredPaths.length === 0) return false;\n\n const pathSet = new Set(erroredPaths);\n let target: HTMLElement \| null = null;\n\n // DOM order is the authoritative \"first\" — the error map's key order is not.\n const chromeElements = document.querySelectorAll<HTMLElement>('[data-field]');\n for (const element of chromeElements) {\n const dataField = element.getAttribute('data-field');\n if (!dataField) continue;\n if (pathSet.has(dataField) \|\| erroredPaths.some((path) => path.startsWith(`${dataField}.`))) {\n target = element;\n break;\n }\n }\n\n // Fallback: controls registered by name without a chrome wrapper.\n if (!target) {\n for (const path of erroredPaths) {\n const byName = document.querySelector<HTMLElement>(`[name=\"${escapeAttributeValue(path)}\"]`);\n if (byName) {\n target = byName;\n break;\n }\n }\n }\n\n if (!target) return false;\n\n target.scrollIntoView({ behavior: 'smooth', block: 'center' });\n\n // Focus after the smooth scroll has started; `preventScroll` keeps the focus\n // jump from fighting the centered smooth scroll already in flight.\n const focusTarget = target;\n setTimeout(() => {\n if (!document.body.contains(focusTarget)) return;\n const focusable = focusTarget.matches('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])')\n ? focusTarget\n : focusTarget.querySelector<HTMLElement>('input, textarea, select, button, [tabindex]:not([tabindex=\"-1\"])');\n if (focusable && document.body.contains(focusable)) {\n try {\n focusable.focus({ preventScroll: true });\n } catch {\n focusable.focus();\n }\n }\n }, 100);\n\n return true;\n}\n"]}

package/dist/esm/components/form/validation-errors/unstarted-field-visit.d.ts ADDED Viewed

@@ -0,0 +1,60 @@
+/**
+ * Whether a form value holds nothing the person entered: absent, the framework's cleared `null`, an
+ * empty string, or an empty array. `0` and `false` are values, not emptiness.
+ *
+ * An object-valued field — an address, a `{ from, to }` range — is never unfilled by this test, so it
+ * keeps validating on blur. Deliberate: emptiness there is per-part and belongs to the control.
+ */
+export declare function isUnfilledFieldValue(value: unknown): boolean;
+export interface UnstartedFieldVisitGate {
+    /**
+     * Call in place of react-hook-form's `field.onBlur`. Answers whether the blur was an UNSTARTED VISIT,
+     * in which case the field was marked touched WITHOUT validating and the caller must not validate
+     * either. Otherwise `field.onBlur` ran as usual and the caller proceeds with its own rules.
+     */
+    handleFieldBlur: (fieldOnBlur: () => void) => boolean;
+    /** Record that the person entered something into this field. Call from the change handler. */
+    noteInputReceived: () => void;
+}
+/**
+ * A blur is not a verdict on a field the person never filled.
+ *
+ * Focus leaves an input for reasons that say nothing about intent: picking a browser autofill
+ * suggestion (the case that surfaced this — Chrome's saved-email list on the sign-in field), switching
+ * to a password manager, tabbing past a field on the way to another. Validating then reports
+ * "required" / "invalid format" on a field the person has not started, and on autofill the error
+ * flashes until the filled value re-validates it away.
+ *
+ * So a blur on a field that is EMPTY, has received NO input since it mounted and shows NO error yet
+ * only records the visit. An empty required field is still reported at submit, which validates every
+ * field regardless. Everything else is unchanged: a field holding a value is validated on blur, a
+ * field the person typed into and then emptied is, and a field already in error keeps re-validating.
+ *
+ * Decided from practice rather than asked: Cloudscape's validation pattern — "delay validation until
+ * after a user has entered data, unless they are in the process of fixing validation errors".
+ * spec-cite: https://cloudscape.design/patterns/general/errors/validation/ — "General" timing guidance.
+ * The rejected alternative, validating every blur (the same page's on-blur example includes empty
+ * fields), is what produced the defect.
+ *
+ * ## Why this is a shared hook and not a rule inside `FormField`
+ *
+ * The form-level react-hook-form `mode` is `onBlur` (`Form.tsx`), so RHF's OWN blur handler validates.
+ * Every site that hands a control `field.onBlur` therefore carries this decision, not just the one
+ * that also calls `trigger`. `FormField` covers the ordinary fields; `AutomatedArrayField` renders its
+ * multi-select and checkbox-group array fields through its own `Controller`s and needs the same gate.
+ * A second hand-written copy is how one of the two drifts — see
+ * `.claude/rules/invariant-call-site-enumeration.md`.
+ *
+ * Not RHF's `isDirty`, which compares the CURRENT value with the default: typing "a" and deleting it
+ * returns to the default and reads as pristine, although the person did start the field.
+ *
+ * Known limits, each of which only ever makes validation LESS eager and never lets a value through —
+ * submit, wizard Next, section save and autosave all validate independently:
+ * - the record lives with the mounted field, so a remount resets it and `form.reset()` does not clear it;
+ * - an ARRAY-valued field is not marked touched. RHF tracks touched per ELEMENT for array values, so an
+ *   empty array has nothing to mark and `touchedFields` stays empty. Nothing depends on it there — the
+ *   array controls show an error from the submitted state, not from touched — and refusing to judge is
+ *   the part that matters. Measured by the array pins.
+ */
+export declare function useUnstartedFieldVisit(fieldName: string): UnstartedFieldVisitGate;
+//# sourceMappingURL=unstarted-field-visit.d.ts.map

package/dist/esm/components/form/validation-errors/unstarted-field-visit.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"unstarted-field-visit.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/unstarted-field-visit.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;IACtD,8FAA8F;IAC9F,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CA+BjF"}

package/dist/esm/components/form/validation-errors/unstarted-field-visit.js ADDED Viewed

@@ -0,0 +1,79 @@
+import { useCallback, useRef } from 'react';
+import { useFormContext } from 'react-hook-form';
+/**
+ * Whether a form value holds nothing the person entered: absent, the framework's cleared `null`, an
+ * empty string, or an empty array. `0` and `false` are values, not emptiness.
+ *
+ * An object-valued field — an address, a `{ from, to }` range — is never unfilled by this test, so it
+ * keeps validating on blur. Deliberate: emptiness there is per-part and belongs to the control.
+ */
+export function isUnfilledFieldValue(value) {
+    if (value === undefined || value === null || value === '')
+        return true;
+    return Array.isArray(value) && value.length === 0;
+}
+/**
+ * A blur is not a verdict on a field the person never filled.
+ *
+ * Focus leaves an input for reasons that say nothing about intent: picking a browser autofill
+ * suggestion (the case that surfaced this — Chrome's saved-email list on the sign-in field), switching
+ * to a password manager, tabbing past a field on the way to another. Validating then reports
+ * "required" / "invalid format" on a field the person has not started, and on autofill the error
+ * flashes until the filled value re-validates it away.
+ *
+ * So a blur on a field that is EMPTY, has received NO input since it mounted and shows NO error yet
+ * only records the visit. An empty required field is still reported at submit, which validates every
+ * field regardless. Everything else is unchanged: a field holding a value is validated on blur, a
+ * field the person typed into and then emptied is, and a field already in error keeps re-validating.
+ *
+ * Decided from practice rather than asked: Cloudscape's validation pattern — "delay validation until
+ * after a user has entered data, unless they are in the process of fixing validation errors".
+ * spec-cite: https://cloudscape.design/patterns/general/errors/validation/ — "General" timing guidance.
+ * The rejected alternative, validating every blur (the same page's on-blur example includes empty
+ * fields), is what produced the defect.
+ *
+ * ## Why this is a shared hook and not a rule inside `FormField`
+ *
+ * The form-level react-hook-form `mode` is `onBlur` (`Form.tsx`), so RHF's OWN blur handler validates.
+ * Every site that hands a control `field.onBlur` therefore carries this decision, not just the one
+ * that also calls `trigger`. `FormField` covers the ordinary fields; `AutomatedArrayField` renders its
+ * multi-select and checkbox-group array fields through its own `Controller`s and needs the same gate.
+ * A second hand-written copy is how one of the two drifts — see
+ * `.claude/rules/invariant-call-site-enumeration.md`.
+ *
+ * Not RHF's `isDirty`, which compares the CURRENT value with the default: typing "a" and deleting it
+ * returns to the default and reads as pristine, although the person did start the field.
+ *
+ * Known limits, each of which only ever makes validation LESS eager and never lets a value through —
+ * submit, wizard Next, section save and autosave all validate independently:
+ * - the record lives with the mounted field, so a remount resets it and `form.reset()` does not clear it;
+ * - an ARRAY-valued field is not marked touched. RHF tracks touched per ELEMENT for array values, so an
+ *   empty array has nothing to mark and `touchedFields` stays empty. Nothing depends on it there — the
+ *   array controls show an error from the submitted state, not from touched — and refusing to judge is
+ *   the part that matters. Measured by the array pins.
+ */
+export function useUnstartedFieldVisit(fieldName) {
+    const formContext = useFormContext();
+    const hasReceivedInputRef = useRef(false);
+    const handleFieldBlur = useCallback((fieldOnBlur) => {
+        const fieldState = formContext.getFieldState(fieldName);
+        const currentValue = formContext.getValues(fieldName);
+        const isUnstartedVisit = !fieldState.error && !hasReceivedInputRef.current && isUnfilledFieldValue(currentValue);
+        if (isUnstartedVisit) {
+            /*
+             * The touch goes through `setValue` rather than `field.onBlur` because RHF's blur handler
+             * validates under a blur mode: skipping only the caller's own `trigger` would leave that
+             * second validation in place.
+             */
+            formContext.setValue(fieldName, currentValue, { shouldTouch: true, shouldDirty: false, shouldValidate: false });
+            return true;
+        }
+        fieldOnBlur();
+        return false;
+    }, [formContext, fieldName]);
+    const noteInputReceived = useCallback(() => {
+        hasReceivedInputRef.current = true;
+    }, []);
+    return { handleFieldBlur, noteInputReceived };
+}
+//# sourceMappingURL=unstarted-field-visit.js.map

package/dist/esm/components/form/validation-errors/unstarted-field-visit.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"unstarted-field-visit.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/unstarted-field-visit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACvE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;AACpD,CAAC;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,mBAAmB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE1C,MAAM,eAAe,GAAG,WAAW,CACjC,CAAC,WAAuB,EAAW,EAAE;QACnC,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,gBAAgB,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,mBAAmB,CAAC,OAAO,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAEjH,IAAI,gBAAgB,EAAE,CAAC;YACrB;;;;eAIG;YACH,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;YAChH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,WAAW,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC,EACD,CAAC,WAAW,EAAE,SAAS,CAAC,CACzB,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE;QACzC,mBAAmB,CAAC,OAAO,GAAG,IAAI,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC;AAChD,CAAC","sourcesContent":["import { useCallback, useRef } from 'react';\nimport { useFormContext } from 'react-hook-form';\n\n/**\n * Whether a form value holds nothing the person entered: absent, the framework's cleared `null`, an\n * empty string, or an empty array. `0` and `false` are values, not emptiness.\n *\n * An object-valued field — an address, a `{ from, to }` range — is never unfilled by this test, so it\n * keeps validating on blur. Deliberate: emptiness there is per-part and belongs to the control.\n */\nexport function isUnfilledFieldValue(value: unknown): boolean {\n if (value === undefined || value === null || value === '') return true;\n return Array.isArray(value) && value.length === 0;\n}\n\nexport interface UnstartedFieldVisitGate {\n /**\n * Call in place of react-hook-form's `field.onBlur`. Answers whether the blur was an UNSTARTED VISIT,\n * in which case the field was marked touched WITHOUT validating and the caller must not validate\n * either. Otherwise `field.onBlur` ran as usual and the caller proceeds with its own rules.\n */\n handleFieldBlur: (fieldOnBlur: () => void) => boolean;\n /** Record that the person entered something into this field. Call from the change handler. */\n noteInputReceived: () => void;\n}\n\n/**\n * A blur is not a verdict on a field the person never filled.\n *\n * Focus leaves an input for reasons that say nothing about intent: picking a browser autofill\n * suggestion (the case that surfaced this — Chrome's saved-email list on the sign-in field), switching\n * to a password manager, tabbing past a field on the way to another. Validating then reports\n * \"required\" / \"invalid format\" on a field the person has not started, and on autofill the error\n * flashes until the filled value re-validates it away.\n *\n * So a blur on a field that is EMPTY, has received NO input since it mounted and shows NO error yet\n * only records the visit. An empty required field is still reported at submit, which validates every\n * field regardless. Everything else is unchanged: a field holding a value is validated on blur, a\n * field the person typed into and then emptied is, and a field already in error keeps re-validating.\n *\n * Decided from practice rather than asked: Cloudscape's validation pattern — \"delay validation until\n * after a user has entered data, unless they are in the process of fixing validation errors\".\n * spec-cite: https://cloudscape.design/patterns/general/errors/validation/ — \"General\" timing guidance.\n * The rejected alternative, validating every blur (the same page's on-blur example includes empty\n * fields), is what produced the defect.\n *\n * ## Why this is a shared hook and not a rule inside `FormField`\n *\n * The form-level react-hook-form `mode` is `onBlur` (`Form.tsx`), so RHF's OWN blur handler validates.\n * Every site that hands a control `field.onBlur` therefore carries this decision, not just the one\n * that also calls `trigger`. `FormField` covers the ordinary fields; `AutomatedArrayField` renders its\n * multi-select and checkbox-group array fields through its own `Controller`s and needs the same gate.\n * A second hand-written copy is how one of the two drifts — see\n * `.claude/rules/invariant-call-site-enumeration.md`.\n *\n * Not RHF's `isDirty`, which compares the CURRENT value with the default: typing \"a\" and deleting it\n * returns to the default and reads as pristine, although the person did start the field.\n *\n * Known limits, each of which only ever makes validation LESS eager and never lets a value through —\n * submit, wizard Next, section save and autosave all validate independently:\n * - the record lives with the mounted field, so a remount resets it and `form.reset()` does not clear it;\n * - an ARRAY-valued field is not marked touched. RHF tracks touched per ELEMENT for array values, so an\n * empty array has nothing to mark and `touchedFields` stays empty. Nothing depends on it there — the\n * array controls show an error from the submitted state, not from touched — and refusing to judge is\n * the part that matters. Measured by the array pins.\n */\nexport function useUnstartedFieldVisit(fieldName: string): UnstartedFieldVisitGate {\n const formContext = useFormContext();\n const hasReceivedInputRef = useRef(false);\n\n const handleFieldBlur = useCallback(\n (fieldOnBlur: () => void): boolean => {\n const fieldState = formContext.getFieldState(fieldName);\n const currentValue = formContext.getValues(fieldName);\n const isUnstartedVisit = !fieldState.error && !hasReceivedInputRef.current && isUnfilledFieldValue(currentValue);\n\n if (isUnstartedVisit) {\n /*\n * The touch goes through `setValue` rather than `field.onBlur` because RHF's blur handler\n * validates under a blur mode: skipping only the caller's own `trigger` would leave that\n * second validation in place.\n */\n formContext.setValue(fieldName, currentValue, { shouldTouch: true, shouldDirty: false, shouldValidate: false });\n return true;\n }\n\n fieldOnBlur();\n return false;\n },\n [formContext, fieldName],\n );\n\n const noteInputReceived = useCallback(() => {\n hasReceivedInputRef.current = true;\n }, []);\n\n return { handleFieldBlur, noteInputReceived };\n}\n"]}

package/dist/esm/components/form/validation-errors/useFieldUniquenessValidation.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useFieldUniquenessValidation.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/form/validation-errors/useFieldUniquenessValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;~~AAaxB~~,MAAM,WAAW,mCAAmC;IAClD,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,kCAAkC;IACjD;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACvD,wDAAwD;IACxD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,SAAS,EACT,WAAW,GACZ,EAAE,mCAAmC,GAAG,kCAAkC,~~CAiG1E~~"}
1	+ {"version":3,"file":"useFieldUniquenessValidation.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useFieldUniquenessValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,MAAM,WAAW,mCAAmC;IAClD,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,kCAAkC;IACjD;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACvD,wDAAwD;IACxD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,SAAS,EACT,WAAW,GACZ,EAAE,mCAAmC,GAAG,kCAAkC,CAmG1E"}

package/dist/esm/components/form/validation-errors/useFieldUniquenessValidation.js CHANGED Viewed

@@ -22,6 +22,7 @@ import { isUnique } from '@wildo-ai/zod-decorators';
 import { useOptionalFormSchemaContext } from '../useFormSchemaContext.js';
 import { UNIQUE_ERROR_TYPE } from '../form-context.js';
 import { useApplication } from '../../../core/runtime/useApplication.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('FieldUniquenessValidation');
@@ -39,6 +40,8 @@ export function useFieldUniquenessValidation({ fieldName, fieldSchema, }) {
     const formSchemaContext = useOptionalFormSchemaContext();
     const formContext = useFormContext();
     const { httpClient } = useApplication();
+    // The endpoint answers with a CODE; these are the words for it, in the person's language (#1180).
+    const { tErrorValidation } = useI18n();
     // Track in-flight request for cancellation
     const abortControllerRef = useRef(null);
     const isCheckingRef = useRef(false);
@@ -83,7 +86,7 @@ export function useFieldUniquenessValidation({ fieldName, fieldSchema, }) {
                 // Set uniqueness error on the field
                 formContext.setError(fieldName, {
                     type: UNIQUE_ERROR_TYPE,
-                    message: response.error.message,
+                    message: tErrorValidation(response.error.code, 'msg', response.error.params),
                 });
                 return false;
             }
@@ -113,7 +116,7 @@ export function useFieldUniquenessValidation({ fieldName, fieldSchema, }) {
                 abortControllerRef.current = null;
             }
         }
-    }, [fieldName, hasUniqueDecorator, validateFieldUrl, resourceId, httpClient, formContext]);
+    }, [fieldName, hasUniqueDecorator, validateFieldUrl, resourceId, httpClient, formContext, tErrorValidation]);
     return {
         validateUniqueness,
         isChecking: isCheckingRef.current,

package/dist/esm/components/form/validation-errors/useFieldUniquenessValidation.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useFieldUniquenessValidation.js","sourceRoot":"","sources":["../../../../../src/components/form/validation-errors/useFieldUniquenessValidation.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n useFieldUniquenessValidation Hook\n * \n * Provides server-side uniqueness pre-validation for form fields decorated with `isUnique()`.\n * \n * When a field loses focus, this hook checks whether the value is already taken by calling\n * the backend's `POST /validate-field` endpoint. If a conflict is found, it sets a\n * UNIQUE_ERROR_TYPE error on the field via RHF. The error is auto-cleared when the user\n * edits the field (standard server error auto-clear behavior).\n * \n * The hook is designed to be composed into FormField's `useFieldValidation` hook:\n * - Only activates when validateFieldUrl is present in FormSchemaContext\n * - Only fires for fields with the `isUnique()` decorator\n * - Debounced: fires on blur only (not on every keystroke)\n * - Cancellable: previous in-flight request is aborted when a new one starts\n * \n * Authorization: The validate-field endpoint uses CREATE operation rights on the backend.\n /\n\nimport { useCallback, useRef } from 'react';\nimport { useFormContext } from 'react-hook-form';\nimport { z } from 'zod';\nimport { isUnique } from '@wildo-ai/zod-decorators';\nimport type { ValidateFieldResponse } from '@wildo-ai/saas-models';\n\nimport { useOptionalFormSchemaContext } from '../useFormSchemaContext';\nimport { UNIQUE_ERROR_TYPE } from '../form-context';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('FieldUniquenessValidation');\nlogger.setDebugTypeLogging('FieldUniquenessValidation', false);\n\nexport interface UseFieldUniquenessValidationOptions {\n /* The field name in the form /\n fieldName: string;\n /* The field's Zod schema (used to check for isUnique() decorator) /\n fieldSchema?: z.ZodTypeAny;\n}\n\nexport interface UseFieldUniquenessValidationReturn {\n /\n Call this on blur to trigger server-side uniqueness validation.\n * Returns true if the value is valid (unique), false if it conflicts.\n * Returns undefined if the check was not performed (no decorator, no URL, etc.).\n /\n validateUniqueness: () => Promise<boolean \| undefined>;\n /* Whether a uniqueness check is currently in-flight /\n isChecking: boolean;\n}\n\n/\n Hook for field-level uniqueness pre-validation on blur.\n * \n * Integrates with the FormSchemaContext to read validateFieldUrl and resourceId.\n * Only performs validation when:\n * 1. The field has the `isUnique()` decorator\n * 2. A `validateFieldUrl` is available in the form context\n * 3. The field has a non-empty value\n */\nexport function useFieldUniquenessValidation({\n fieldName,\n fieldSchema,\n}: UseFieldUniquenessValidationOptions): UseFieldUniquenessValidationReturn {\n const formSchemaContext = useOptionalFormSchemaContext();\n const formContext = useFormContext();\n const { httpClient } = useApplication();\n \n // Track in-flight request for cancellation\n const abortControllerRef = useRef<AbortController \| null>(null);\n const isCheckingRef = useRef(false);\n \n // Determine if this field needs uniqueness validation\n const hasUniqueDecorator = fieldSchema ? isUnique(fieldSchema) : false;\n const validateFieldUrl = formSchemaContext?.validateFieldUrl;\n const resourceId = formSchemaContext?.resourceId;\n \n const validateUniqueness = useCallback(async (): Promise<boolean \| undefined> => {\n // Guard: only validate if all conditions are met\n if (!hasUniqueDecorator \|\| !validateFieldUrl \|\| !httpClient) {\n return undefined;\n }\n \n const currentValue = formContext.getValues(fieldName);\n \n // Skip validation for empty values (sparse unique fields allow nulls)\n if (currentValue === null \|\| currentValue === undefined \|\| currentValue === '') {\n // Clear any existing unique error\n const currentError = formContext.getFieldState(fieldName).error;\n if (currentError?.type === UNIQUE_ERROR_TYPE) {\n formContext.clearErrors(fieldName);\n }\n return undefined;\n }\n \n logDebug('Starting uniqueness check', { fieldName, value: currentValue, validateFieldUrl, resourceId });\n \n // Cancel any previous in-flight request\n if (abortControllerRef.current) {\n abortControllerRef.current.abort();\n }\n \n const abortController = new AbortController();\n abortControllerRef.current = abortController;\n isCheckingRef.current = true;\n \n try {\n const response = await httpClient.post<ValidateFieldResponse>(\n validateFieldUrl,\n {\n fieldName,\n value: currentValue,\n excludeId: resourceId,\n },\n {\n signal: abortController.signal,\n silent: true, // Don't trigger global error handling\n }\n );\n \n logDebug('Uniqueness check response', { fieldName, valid: response.valid, error: response.error });\n \n if (!response.valid && response.error) {\n // Set uniqueness error on the field\n formContext.setError(fieldName, {\n type: UNIQUE_ERROR_TYPE,\n message: response.error.message,\n });\n return false;\n } else {\n // Clear any existing unique error (value is now valid)\n const currentError = formContext.getFieldState(fieldName).error;\n if (currentError?.type === UNIQUE_ERROR_TYPE) {\n formContext.clearErrors(fieldName);\n }\n return true;\n }\n } catch (error: any) {\n // Ignore aborted requests (a newer request superseded this one)\n if (error?.name === 'AbortError' \|\| error?.code === 'ERR_CANCELED') {\n logDebug('Uniqueness check aborted (superseded)', { fieldName });\n return undefined;\n }\n \n // Log non-abort errors but don't block the form\n // Uniqueness validation is a UX enhancement, not a hard requirement\n logger.warn('Uniqueness pre-validation failed', { fieldName, error: error?.message });\n return undefined;\n } finally {\n isCheckingRef.current = false;\n if (abortControllerRef.current === abortController) {\n abortControllerRef.current = null;\n }\n }\n }, [fieldName, hasUniqueDecorator, validateFieldUrl, resourceId, httpClient, formContext]);\n \n return {\n validateUniqueness,\n isChecking: isCheckingRef.current,\n };\n}\n"]}
1	+ {"version":3,"file":"useFieldUniquenessValidation.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useFieldUniquenessValidation.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n useFieldUniquenessValidation Hook\n * \n * Provides server-side uniqueness pre-validation for form fields decorated with `isUnique()`.\n * \n * When a field loses focus, this hook checks whether the value is already taken by calling\n * the backend's `POST /validate-field` endpoint. If a conflict is found, it sets a\n * UNIQUE_ERROR_TYPE error on the field via RHF. The error is auto-cleared when the user\n * edits the field (standard server error auto-clear behavior).\n * \n * The hook is designed to be composed into FormField's `useFieldValidation` hook:\n * - Only activates when validateFieldUrl is present in FormSchemaContext\n * - Only fires for fields with the `isUnique()` decorator\n * - Debounced: fires on blur only (not on every keystroke)\n * - Cancellable: previous in-flight request is aborted when a new one starts\n * \n * Authorization: The validate-field endpoint uses CREATE operation rights on the backend.\n /\n\nimport { useCallback, useRef } from 'react';\nimport { useFormContext } from 'react-hook-form';\nimport { z } from 'zod';\nimport { isUnique } from '@wildo-ai/zod-decorators';\nimport type { ValidateFieldResponse } from '@wildo-ai/saas-models';\n\nimport { useOptionalFormSchemaContext } from '../useFormSchemaContext';\nimport { UNIQUE_ERROR_TYPE } from '../form-context';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('FieldUniquenessValidation');\nlogger.setDebugTypeLogging('FieldUniquenessValidation', false);\n\nexport interface UseFieldUniquenessValidationOptions {\n /* The field name in the form /\n fieldName: string;\n /* The field's Zod schema (used to check for isUnique() decorator) /\n fieldSchema?: z.ZodTypeAny;\n}\n\nexport interface UseFieldUniquenessValidationReturn {\n /\n Call this on blur to trigger server-side uniqueness validation.\n * Returns true if the value is valid (unique), false if it conflicts.\n * Returns undefined if the check was not performed (no decorator, no URL, etc.).\n /\n validateUniqueness: () => Promise<boolean \| undefined>;\n /* Whether a uniqueness check is currently in-flight /\n isChecking: boolean;\n}\n\n/\n Hook for field-level uniqueness pre-validation on blur.\n * \n * Integrates with the FormSchemaContext to read validateFieldUrl and resourceId.\n * Only performs validation when:\n * 1. The field has the `isUnique()` decorator\n * 2. A `validateFieldUrl` is available in the form context\n * 3. The field has a non-empty value\n */\nexport function useFieldUniquenessValidation({\n fieldName,\n fieldSchema,\n}: UseFieldUniquenessValidationOptions): UseFieldUniquenessValidationReturn {\n const formSchemaContext = useOptionalFormSchemaContext();\n const formContext = useFormContext();\n const { httpClient } = useApplication();\n // The endpoint answers with a CODE; these are the words for it, in the person's language (#1180).\n const { tErrorValidation } = useI18n();\n \n // Track in-flight request for cancellation\n const abortControllerRef = useRef<AbortController \| null>(null);\n const isCheckingRef = useRef(false);\n \n // Determine if this field needs uniqueness validation\n const hasUniqueDecorator = fieldSchema ? isUnique(fieldSchema) : false;\n const validateFieldUrl = formSchemaContext?.validateFieldUrl;\n const resourceId = formSchemaContext?.resourceId;\n \n const validateUniqueness = useCallback(async (): Promise<boolean \| undefined> => {\n // Guard: only validate if all conditions are met\n if (!hasUniqueDecorator \|\| !validateFieldUrl \|\| !httpClient) {\n return undefined;\n }\n \n const currentValue = formContext.getValues(fieldName);\n \n // Skip validation for empty values (sparse unique fields allow nulls)\n if (currentValue === null \|\| currentValue === undefined \|\| currentValue === '') {\n // Clear any existing unique error\n const currentError = formContext.getFieldState(fieldName).error;\n if (currentError?.type === UNIQUE_ERROR_TYPE) {\n formContext.clearErrors(fieldName);\n }\n return undefined;\n }\n \n logDebug('Starting uniqueness check', { fieldName, value: currentValue, validateFieldUrl, resourceId });\n \n // Cancel any previous in-flight request\n if (abortControllerRef.current) {\n abortControllerRef.current.abort();\n }\n \n const abortController = new AbortController();\n abortControllerRef.current = abortController;\n isCheckingRef.current = true;\n \n try {\n const response = await httpClient.post<ValidateFieldResponse>(\n validateFieldUrl,\n {\n fieldName,\n value: currentValue,\n excludeId: resourceId,\n },\n {\n signal: abortController.signal,\n silent: true, // Don't trigger global error handling\n }\n );\n \n logDebug('Uniqueness check response', { fieldName, valid: response.valid, error: response.error });\n \n if (!response.valid && response.error) {\n // Set uniqueness error on the field\n formContext.setError(fieldName, {\n type: UNIQUE_ERROR_TYPE,\n message: tErrorValidation(response.error.code, 'msg', response.error.params),\n });\n return false;\n } else {\n // Clear any existing unique error (value is now valid)\n const currentError = formContext.getFieldState(fieldName).error;\n if (currentError?.type === UNIQUE_ERROR_TYPE) {\n formContext.clearErrors(fieldName);\n }\n return true;\n }\n } catch (error: any) {\n // Ignore aborted requests (a newer request superseded this one)\n if (error?.name === 'AbortError' \|\| error?.code === 'ERR_CANCELED') {\n logDebug('Uniqueness check aborted (superseded)', { fieldName });\n return undefined;\n }\n \n // Log non-abort errors but don't block the form\n // Uniqueness validation is a UX enhancement, not a hard requirement\n logger.warn('Uniqueness pre-validation failed', { fieldName, error: error?.message });\n return undefined;\n } finally {\n isCheckingRef.current = false;\n if (abortControllerRef.current === abortController) {\n abortControllerRef.current = null;\n }\n }\n }, [fieldName, hasUniqueDecorator, validateFieldUrl, resourceId, httpClient, formContext, tErrorValidation]);\n \n return {\n validateUniqueness,\n isChecking: isCheckingRef.current,\n };\n}\n"]}

package/dist/esm/components/form/validation-errors/useServerErrorInjection.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+import { type ValidationErrors } from '@wildo-ai/saas-models';
 import { type FormMethods } from '../Form';
 interface UseServerErrorInjectionReturn {
     /**
@@ -12,8 +13,12 @@ interface UseServerErrorInjectionReturn {
      * Inject server validation errors onto individual form fields via RHF's
      * `setError`. Each field is tracked so it can be auto-cleared on edit.
      * Typically called in a `catch` block after `extractServerValidationErrors()`.
+     *
+     * A value is either a message the schema produced, or a CODED entry — which is resolved here, through the
+     * `errors_validation` catalog, because this is the layer that holds both the catalog and the person's
+     * language (#1180).
      */
-    injectServerErrors: (validationErrors: Record<string, string>) => void;
+    injectServerErrors: (validationErrors: ValidationErrors) => void;
     /**
      * Clear all currently tracked server errors from the form.
      * Call at the start of every submit handler (before the `try` block)

package/dist/esm/components/form/validation-errors/useServerErrorInjection.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useServerErrorInjection.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;~~AAI3C~~,UAAU,6BAA6B;IACrC;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IACrD~~;;;;OAIG~~;IACH,kBAAkB,EAAE,CAAC,gBAAgB,EAAE,~~MAAM~~,~~CAAC,MAAM,EAAE,MAAM,CAAC,~~KAAK,IAAI,CAAC;~~IACvE~~;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAClD,6BAA6B,~~CAqD~~/B"}
1	+ {"version":3,"file":"useServerErrorInjection.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C,UAAU,6BAA6B;IACrC;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IACrD;;;;;;;;OAQG;IACH,kBAAkB,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjE;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAClD,6BAA6B,CA4D/B"}

package/dist/esm/components/form/validation-errors/useServerErrorInjection.js CHANGED Viewed

@@ -1,5 +1,7 @@
 import { useRef, useCallback, useEffect } from 'react';
+import { isValidationErrorEntry } from '@wildo-ai/saas-models';
 import { SERVER_ERROR_TYPE } from '../form-context.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
 import { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils.js';
 /**
  * Manages the lifecycle of server-side validation errors injected into
@@ -56,6 +58,7 @@ import { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils.j
  * (`UserRegister`, `UserPasswordLost`).
  */
 export function useServerErrorInjection(formMethodsRef) {
+    const { tErrorValidation } = useI18n();
     const serverErrorFieldsRef = useRef(new Set());
     const watchSubscriptionRef = useRef(null);
     useEffect(() => {
@@ -83,7 +86,12 @@ export function useServerErrorInjection(formMethodsRef) {
     }, [formMethodsRef]);
     const injectServerErrors = useCallback((validationErrors) => {
         if (formMethodsRef.current) {
-            Object.entries(validationErrors).forEach(([fieldName, message]) => {
+            Object.entries(validationErrors).forEach(([fieldName, value]) => {
+                // A coded entry carries no words on purpose: the server sends `not_unique`, the catalog says what that
+                // means in this person's language. A plain string is a message the schema already produced.
+                const message = isValidationErrorEntry(value)
+                    ? tErrorValidation(value.code, 'msg', value.params)
+                    : value;
                 formMethodsRef.current.setError(fieldName, {
                     type: SERVER_ERROR_TYPE,
                     message,
@@ -99,7 +107,7 @@ export function useServerErrorInjection(formMethodsRef) {
             // No-ops when no matching `[data-field]`/`[name]` element exists.
             scrollAndFocusFirstErroredField(Object.keys(validationErrors));
         }
-    }, [formMethodsRef]);
+    }, [formMethodsRef, tErrorValidation]);
     return { initAutoClearing, injectServerErrors, clearServerErrors };
 }
 //# sourceMappingURL=useServerErrorInjection.js.map

package/dist/esm/components/form/validation-errors/useServerErrorInjection.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useServerErrorInjection.js","sourceRoot":"","sources":["~~../../../../../~~src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;~~AAEvD~~,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;~~AAyBhF~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,uBAAuB,CACrC,cAAmD;IAEnD,MAAM,oBAAoB,GAAG,MAAM,CAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IAC5D,MAAM,oBAAoB,GAAG,MAAM,CAAqC,IAAI,CAAC,CAAC;IAE9E,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,WAAwB,EAAE,EAAE;QAChE,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAE5C,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YAC1D,IAAI,IAAI,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC9B,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,oBAAoB,CAAC,OAAO,GAAG,YAAY,CAAC;IAC9C,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE;QACzC,IAAI,cAAc,CAAC,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;gBAC3D,cAAc,CAAC,OAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;YACH,oBAAoB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IAErB,MAAM,kBAAkB,GAAG,WAAW,CAAC,CAAC,~~gBAAwC~~,EAAE,EAAE;~~QAClF~~,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE;~~gBAChE~~,cAAc,CAAC,OAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE;oBAC1C,IAAI,EAAE,iBAAiB;oBACvB,OAAO;iBACR,CAAC,CAAC;gBACH,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;YACH,yEAAyE;YACzE,qEAAqE;YACrE,qEAAqE;YACrE,yEAAyE;YACzE,mEAAmE;YACnE,uEAAuE;YACvE,kEAAkE;YAClE,+BAA+B,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;~~IAErB~~,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;AACrE,CAAC","sourcesContent":["import { useRef, useCallback, useEffect } from 'react';\nimport { type FormMethods } from '../Form';\nimport { SERVER_ERROR_TYPE } from '../form-context';\nimport { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils';\n\ninterface UseServerErrorInjectionReturn {\n /*\n Start watching form values to auto-clear server errors when the user edits\n * an errored field. Call once when formMethods become available (typically\n * from the `onFormReady` callback of `<AutomatedForm>`).\n \n Safe to call multiple times — previous subscriptions are torn down first.\n /\n initAutoClearing: (formMethods: FormMethods) => void;\n /\n Inject server validation errors onto individual form fields via RHF's\n * `setError`. Each field is tracked so it can be auto-cleared on edit.\n * Typically called in a `catch` block after `extractServerValidationErrors()`.\n /\n injectServerErrors: (validationErrors: ~~Record<string, string>~~) => void;\n /\n Clear all currently tracked server errors from the form.\n * Call at the start of every submit handler (before the `try` block)\n * so stale server errors don't persist across submissions.\n /\n clearServerErrors: () => void;\n}\n\n/\n Manages the lifecycle of server-side validation errors injected into\n * React Hook Form fields. Solves the UX problem where server errors\n * (e.g. \"Email already registered\") stick on a field after the user edits\n * it, only disappearing on re-submit.\n \n The hook owns a `Set<string>` of field names that currently carry a\n * server error, and a `watch()` subscription that clears those errors\n * the moment the user types in the field — providing instant feedback.\n \n Lifecycle (3 parts):\n * 1. Inject — after a failed submit, call `injectServerErrors()` to\n * set `{ type: 'server', message }` on each field and register it for\n * auto-clearing.\n * 2. Auto-clear — a `formMethods.watch()` subscription detects edits\n * on tracked fields and clears the error + removes the field from the set.\n * 3. Bulk clear — `clearServerErrors()` removes all tracked errors at\n * once (call before re-submit to avoid stale errors).\n \n Only errors with `type: SERVER_ERROR_TYPE` are tracked. Client-side\n * Zod/RHF validation errors are never affected.\n \n The hook does not own the `formMethodsRef` — it receives it. This\n * keeps the `<AutomatedForm>` / `onFormReady` callback contract unchanged.\n \n @example\n * ```tsx\n * const formMethodsRef = useRef<FormMethods \| null>(null);\n * const { initAutoClearing, injectServerErrors, clearServerErrors } =\n * useServerErrorInjection(formMethodsRef);\n \n const handleFormReady = useCallback((formMethods: FormMethods) => {\n * formMethodsRef.current = formMethods;\n * initAutoClearing(formMethods);\n * }, [initAutoClearing]);\n \n const handleSubmit = async (data: FormData) => {\n * clearServerErrors();\n * try {\n * await submitToServer(data);\n * } catch (e) {\n * const errors = extractServerValidationErrors(e);\n * if (errors) injectServerErrors(errors.validationErrors);\n * }\n * };\n \n return (\n * <AutomatedForm onFormReady={handleFormReady} onSubmit={handleSubmit} ... />\n * );\n * ```\n \n Used by `ResourceAutomatedForm` and auth public-page presets\n * (`UserRegister`, `UserPasswordLost`).\n */\nexport function useServerErrorInjection(\n formMethodsRef: React.RefObject<FormMethods \| null>,\n): UseServerErrorInjectionReturn {\n const serverErrorFieldsRef = useRef<Set<string>>(new Set());\n const watchSubscriptionRef = useRef<{ unsubscribe: () => void } \| null>(null);\n\n useEffect(() => {\n return () => {\n watchSubscriptionRef.current?.unsubscribe();\n };\n }, []);\n\n const initAutoClearing = useCallback((formMethods: FormMethods) => {\n watchSubscriptionRef.current?.unsubscribe();\n\n const subscription = formMethods.watch((_value, { name }) => {\n if (name && serverErrorFieldsRef.current.has(name)) {\n formMethods.clearErrors(name);\n serverErrorFieldsRef.current.delete(name);\n }\n });\n\n watchSubscriptionRef.current = subscription;\n }, []);\n\n const clearServerErrors = useCallback(() => {\n if (formMethodsRef.current && serverErrorFieldsRef.current.size > 0) {\n Array.from(serverErrorFieldsRef.current).forEach(fieldName => {\n formMethodsRef.current!.clearErrors(fieldName);\n });\n serverErrorFieldsRef.current.clear();\n }\n }, [formMethodsRef]);\n\n const injectServerErrors = useCallback((validationErrors: ~~Record<string, string>~~) => {\n if (formMethodsRef.current) {\n Object.entries(validationErrors).forEach(([fieldName, ~~message~~]) => {\n formMethodsRef.current!.setError(fieldName, {\n type: SERVER_ERROR_TYPE,\n message,\n });\n serverErrorFieldsRef.current.add(fieldName);\n });\n // Bring the first rejected field into view (audit D4). Injection happens\n // after a submit gesture, so the viewport is typically parked at the\n // submit button while the errored fields sit off-screen. Placing the\n // scroll HERE (the single injection seam) instead of at each catch block\n // keeps every server-validation path — direct submit, RMM mutation\n // result, draft save, publish, auth presets — covered by construction.\n // No-ops when no matching `[data-field]`/`[name]` element exists.\n scrollAndFocusFirstErroredField(Object.keys(validationErrors));\n }\n }, [formMethodsRef]);\n\n return { initAutoClearing, injectServerErrors, clearServerErrors };\n}\n"]}
1	+ {"version":3,"file":"useServerErrorInjection.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/useServerErrorInjection.ts"],"names":[],"mappings":"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","sourcesContent":["import { useRef, useCallback, useEffect } from 'react';\nimport { isValidationErrorEntry, type ValidationErrors } from '@wildo-ai/saas-models';\nimport { type FormMethods } from '../Form';\nimport { SERVER_ERROR_TYPE } from '../form-context';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { scrollAndFocusFirstErroredField } from './scroll-to-first-error.utils';\n\ninterface UseServerErrorInjectionReturn {\n /*\n Start watching form values to auto-clear server errors when the user edits\n * an errored field. Call once when formMethods become available (typically\n * from the `onFormReady` callback of `<AutomatedForm>`).\n \n Safe to call multiple times — previous subscriptions are torn down first.\n /\n initAutoClearing: (formMethods: FormMethods) => void;\n /\n Inject server validation errors onto individual form fields via RHF's\n * `setError`. Each field is tracked so it can be auto-cleared on edit.\n * Typically called in a `catch` block after `extractServerValidationErrors()`.\n \n A value is either a message the schema produced, or a CODED entry — which is resolved here, through the\n * `errors_validation` catalog, because this is the layer that holds both the catalog and the person's\n * language (#1180).\n /\n injectServerErrors: (validationErrors: ValidationErrors) => void;\n /\n Clear all currently tracked server errors from the form.\n * Call at the start of every submit handler (before the `try` block)\n * so stale server errors don't persist across submissions.\n /\n clearServerErrors: () => void;\n}\n\n/\n Manages the lifecycle of server-side validation errors injected into\n * React Hook Form fields. Solves the UX problem where server errors\n * (e.g. \"Email already registered\") stick on a field after the user edits\n * it, only disappearing on re-submit.\n \n The hook owns a `Set<string>` of field names that currently carry a\n * server error, and a `watch()` subscription that clears those errors\n * the moment the user types in the field — providing instant feedback.\n \n Lifecycle (3 parts):\n * 1. Inject — after a failed submit, call `injectServerErrors()` to\n * set `{ type: 'server', message }` on each field and register it for\n * auto-clearing.\n * 2. Auto-clear — a `formMethods.watch()` subscription detects edits\n * on tracked fields and clears the error + removes the field from the set.\n * 3. Bulk clear — `clearServerErrors()` removes all tracked errors at\n * once (call before re-submit to avoid stale errors).\n \n Only errors with `type: SERVER_ERROR_TYPE` are tracked. Client-side\n * Zod/RHF validation errors are never affected.\n \n The hook does not own the `formMethodsRef` — it receives it. This\n * keeps the `<AutomatedForm>` / `onFormReady` callback contract unchanged.\n \n @example\n * ```tsx\n * const formMethodsRef = useRef<FormMethods \| null>(null);\n * const { initAutoClearing, injectServerErrors, clearServerErrors } =\n * useServerErrorInjection(formMethodsRef);\n \n const handleFormReady = useCallback((formMethods: FormMethods) => {\n * formMethodsRef.current = formMethods;\n * initAutoClearing(formMethods);\n * }, [initAutoClearing]);\n \n const handleSubmit = async (data: FormData) => {\n * clearServerErrors();\n * try {\n * await submitToServer(data);\n * } catch (e) {\n * const errors = extractServerValidationErrors(e);\n * if (errors) injectServerErrors(errors.validationErrors);\n * }\n * };\n \n return (\n * <AutomatedForm onFormReady={handleFormReady} onSubmit={handleSubmit} ... />\n * );\n * ```\n \n Used by `ResourceAutomatedForm` and auth public-page presets\n * (`UserRegister`, `UserPasswordLost`).\n */\nexport function useServerErrorInjection(\n formMethodsRef: React.RefObject<FormMethods \| null>,\n): UseServerErrorInjectionReturn {\n const { tErrorValidation } = useI18n();\n\n const serverErrorFieldsRef = useRef<Set<string>>(new Set());\n const watchSubscriptionRef = useRef<{ unsubscribe: () => void } \| null>(null);\n\n useEffect(() => {\n return () => {\n watchSubscriptionRef.current?.unsubscribe();\n };\n }, []);\n\n const initAutoClearing = useCallback((formMethods: FormMethods) => {\n watchSubscriptionRef.current?.unsubscribe();\n\n const subscription = formMethods.watch((_value, { name }) => {\n if (name && serverErrorFieldsRef.current.has(name)) {\n formMethods.clearErrors(name);\n serverErrorFieldsRef.current.delete(name);\n }\n });\n\n watchSubscriptionRef.current = subscription;\n }, []);\n\n const clearServerErrors = useCallback(() => {\n if (formMethodsRef.current && serverErrorFieldsRef.current.size > 0) {\n Array.from(serverErrorFieldsRef.current).forEach(fieldName => {\n formMethodsRef.current!.clearErrors(fieldName);\n });\n serverErrorFieldsRef.current.clear();\n }\n }, [formMethodsRef]);\n\n const injectServerErrors = useCallback((validationErrors: ValidationErrors) => {\n if (formMethodsRef.current) {\n Object.entries(validationErrors).forEach(([fieldName, value]) => {\n // A coded entry carries no words on purpose: the server sends `not_unique`, the catalog says what that\n // means in this person's language. A plain string is a message the schema already produced.\n const message = isValidationErrorEntry(value)\n ? tErrorValidation(value.code, 'msg', value.params)\n : value;\n formMethodsRef.current!.setError(fieldName, {\n type: SERVER_ERROR_TYPE,\n message,\n });\n serverErrorFieldsRef.current.add(fieldName);\n });\n // Bring the first rejected field into view (audit D4). Injection happens\n // after a submit gesture, so the viewport is typically parked at the\n // submit button while the errored fields sit off-screen. Placing the\n // scroll HERE (the single injection seam) instead of at each catch block\n // keeps every server-validation path — direct submit, RMM mutation\n // result, draft save, publish, auth presets — covered by construction.\n // No-ops when no matching `[data-field]`/`[name]` element exists.\n scrollAndFocusFirstErroredField(Object.keys(validationErrors));\n }\n }, [formMethodsRef, tErrorValidation]);\n\n return { initAutoClearing, injectServerErrors, clearServerErrors };\n}\n"]}

package/dist/esm/components/form/validation-errors/validate-field-url.frontend.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+import type { ResourceConfiguration_Operation_UrlInitiatorInfo } from '@wildo-ai/saas-models';
+/**
+ * Compose the `validate-field` endpoint for a resource's blur-time server validation (#1238).
+ *
+ * ## Why this is a function rather than three lines inside the form's memo
+ *
+ * The failure mode is SILENT BY CONSTRUCTION. `useFieldUniquenessValidation` treats a failed check
+ * as "no conflict found", so a URL the backend does not serve produces a 404 that nobody sees and a
+ * field that quietly never warns — indistinguishable, to the person typing, from a value that is
+ * genuinely free. It was composed from the create surface's FRONTEND ROUTE, which carries a
+ * `/create` segment, and the whole affordance had therefore never run on any create form.
+ *
+ * Nothing could fail loudly enough to catch that, so the invariant is pinned instead, which needs a
+ * seam to pin it at.
+ *
+ * ## The authority
+ *
+ * The backend mounts this route on the CREATE operation's `initiatorInfos[].url` — the API
+ * collection URL — in `validate-field-handler.backend.service.ts`. Composing from the same field is
+ * what keeps the two sides describing ONE path rather than two paths that happen to agree.
+ *
+ * @returns the absolute endpoint, or `undefined` when the initiator's parameters cannot be resolved
+ *          from the current context — in which case the caller disables the check rather than
+ *          issuing a request that cannot succeed.
+ */
+export declare function buildValidateFieldUrl(params: {
+    apiBaseUrl: string;
+    initiatorInfo: ResourceConfiguration_Operation_UrlInitiatorInfo;
+    /** Narrower than the selector above it takes, because `resolveUrlPath` resolves scalars only. */
+    contextualParameters: Record<string, string | number>;
+}): string | undefined;
+//# sourceMappingURL=validate-field-url.frontend.d.ts.map

package/dist/esm/components/form/validation-errors/validate-field-url.frontend.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"validate-field-url.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/validate-field-url.frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gDAAgD,EAAE,MAAM,uBAAuB,CAAC;AAI9F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,gDAAgD,CAAC;IAChE,iGAAiG;IACjG,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvD,GAAG,MAAM,GAAG,SAAS,CAUrB"}