@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

package/dist/esm/components/form/form-field-types.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import type { ControlSize } from '@wildo-ai/presets-components-models';
 import { ValidationMode, type FileMetadata } from '@wildo-ai/zod-decorators';
 export { ValidationMode };
 export interface FieldOption<T extends string | number = string, TData = unknown> {
@@ -41,12 +42,48 @@ export interface FileHttpOperations {
      * @returns Parsed JSON response
      */
     get: <T = any>(url: string) => Promise<T>;
+    /**
+     * Authenticated GET request that returns the raw file BYTES as a Blob.
+     *
+     * The transport for inline previews: an `<img>` / PDF.js cannot attach the bearer,
+     * so components fetch the bytes here (auth added by the client; the backend serve
+     * route authorizes via the linked resource's READ) and wrap the Blob in an object
+     * URL. Optional for backwards-compat with hosts that only inject metadata ops.
+     *
+     * @param url - Full serve URL (already includes the fileId).
+     * @param options.signal - Abort signal to cancel on unmount.
+     */
+    getBlob?: (url: string, options?: {
+        signal?: AbortSignal;
+    }) => Promise<Blob>;
     /**
      * Authenticated DELETE request (for file deletion).
      * @param url - Full request URL
      */
     delete: (url: string) => Promise<void>;
 }
+/**
+ * WHICH schema a form is validating against.
+ *
+ * This is not bookkeeping — it decides the answer to "may this field be cleared?", and the two
+ * kinds answer it differently and cannot be told apart by shape:
+ *
+ * - On a **request DTO**, PATCH semantics have already made every field optional, so a required
+ *   field is structurally identical to an optional one. Clearability is therefore exactly "does it
+ *   accept `null`", which `toPatchOptionalField` granted only to the clearable fields.
+ * - On a **main schema**, an ordinary `.optional()` field does NOT accept `null`, so that same
+ *   question answers "no" for every field that is in fact clearable.
+ *
+ * Asking the wrong one is silent and field-shape dependent: an inline-edit surface builds its form
+ * from the MAIN schema, and asking the request-DTO question there left refined optional fields
+ * (colour, email, url) unclearable while plain optional strings still worked by accident.
+ */
+export declare enum FormSchemaKind {
+    /** An operation's UPDATE/CREATE request DTO — the default for resource forms. */
+    REQUEST_DTO = "request-dto",
+    /** A resource's main schema, used by surfaces that build a form around a single declared field. */
+    MAIN_SCHEMA = "main-schema"
+}
 export declare enum AutosaveFieldState {
     IDLE = "idle",
     SAVING = "saving",
@@ -63,6 +100,19 @@ export declare enum AutosaveFieldState {
  */
 export interface ControlBaseProps<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
     schema: TSchema;
+    /**
+     * Whether "clear this field" is a meaningful instruction here, RESOLVED by the form.
+     *
+     * A control must not re-derive this from `schema`: the answer depends on which KIND of schema
+     * the surrounding form validates (see {@link FormSchemaKind}), and the two are indistinguishable
+     * by shape. A control that asks the wrong question substitutes a value the user never entered —
+     * a stepper coercing an emptied box to `min`, a money input to zero, a toggle refusing to
+     * deselect.
+     *
+     * Absent (standalone control usage outside a form) means "not clearable", the conservative
+     * direction: the control keeps its existing substitution behaviour.
+     */
+    clearable?: boolean;
     name: string;
     disabled?: boolean;
     readOnly?: boolean;
@@ -72,6 +122,8 @@ export interface ControlBaseProps<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
      * Only applicable to focusable controls (input, textarea, select).
      */
     autoFocus?: boolean;
+    /** Resolved control density from explicit form props or surface policy. */
+    controlSize?: ControlSize;
     className?: string;
     value?: z.infer<TSchema>;
     onChange?: (value: z.infer<TSchema>) => void;

package/dist/esm/components/form/form-field-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-types.d.ts","sourceRoot":"","sources":["../../../../src/components/form/form-field-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-field-types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/form-field-types.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/form/form-field-types.js

@@ -1,5 +1,28 @@
 import { ValidationMode } from '@wildo-ai/zod-decorators';
 export { ValidationMode };
+/**
+ * WHICH schema a form is validating against.
+ *
+ * This is not bookkeeping — it decides the answer to "may this field be cleared?", and the two
+ * kinds answer it differently and cannot be told apart by shape:
+ *
+ * - On a **request DTO**, PATCH semantics have already made every field optional, so a required
+ *   field is structurally identical to an optional one. Clearability is therefore exactly "does it
+ *   accept `null`", which `toPatchOptionalField` granted only to the clearable fields.
+ * - On a **main schema**, an ordinary `.optional()` field does NOT accept `null`, so that same
+ *   question answers "no" for every field that is in fact clearable.
+ *
+ * Asking the wrong one is silent and field-shape dependent: an inline-edit surface builds its form
+ * from the MAIN schema, and asking the request-DTO question there left refined optional fields
+ * (colour, email, url) unclearable while plain optional strings still worked by accident.
+ */
+export var FormSchemaKind;
+(function (FormSchemaKind) {
+    /** An operation's UPDATE/CREATE request DTO — the default for resource forms. */
+    FormSchemaKind["REQUEST_DTO"] = "request-dto";
+    /** A resource's main schema, used by surfaces that build a form around a single declared field. */
+    FormSchemaKind["MAIN_SCHEMA"] = "main-schema";
+})(FormSchemaKind || (FormSchemaKind = {}));
 export var AutosaveFieldState;
 (function (AutosaveFieldState) {
     AutosaveFieldState["IDLE"] = "idle";
@@ -7,4 +30,4 @@ export var AutosaveFieldState;
     AutosaveFieldState["SAVED"] = "saved";
     AutosaveFieldState["ERROR"] = "error";
 })(AutosaveFieldState || (AutosaveFieldState = {}));
-//# sourceMappingURL=form-field-types.js.map
+//# sourceMappingURL=form-field-types.js.map

package/dist/esm/components/form/form-field-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-types.js","sourceRoot":"","sources":["../../../../src/components/form/form-field-types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,CAAC;AAqD1B,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,uCAAiB,CAAA;IACjB,qCAAe,CAAA;IACf,qCAAe,CAAA;AACjB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}
+{"version":3,"file":"form-field-types.js","sourceRoot":"","sources":["../../../../../src/components/form/form-field-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,CAAC;AAkE1B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,iFAAiF;IACjF,6CAA2B,CAAA;IAC3B,mGAAmG;IACnG,6CAA2B,CAAA;AAC7B,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAED,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,uCAAiB,CAAA;IACjB,qCAAe,CAAA;IACf,qCAAe,CAAA;AACjB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B","sourcesContent":["import { z } from 'zod';\nimport type { ControlSize } from '@wildo-ai/presets-components-models';\nimport { ValidationMode, type FileMetadata } from '@wildo-ai/zod-decorators';\n\nexport { ValidationMode };\n\nexport interface FieldOption<T extends string | number = string, TData = unknown> {\n  value: T;\n  label: string;\n  disabled?: boolean;\n  /** Arbitrary payload for rich rendering (resource objects, icons, metadata, etc.) */\n  data?: TData;\n}\n\n/**\n * HTTP operations for file management.\n *\n * Injected from the engine layer (saas-frontend-lib) to maintain separation\n * of concerns — presets-components should not depend on the HTTP client directly.\n *\n * The engine layer implements this using WildoBackendHttpClient, which\n * provides authentication (JWT Bearer token), retry logic, error handling,\n * and network queue management automatically.\n */\nexport interface FileHttpOperations {\n  /**\n   * Upload a file with progress tracking.\n   * Auth headers are added automatically by the underlying HTTP client.\n   *\n   * @param url - Upload endpoint URL\n   * @param formData - FormData with 'file' field and optional 'fileId' for overrides\n   * @param options - Progress callback and abort signal\n   * @returns Upload result with fileId and optional metadata\n   */\n  upload: (\n    url: string,\n    formData: FormData,\n    options?: {\n      onProgress?: (percent: number) => void;\n      signal?: AbortSignal;\n    }\n  ) => Promise<{ fileId: string; metadata?: FileMetadata }>;\n\n  /**\n   * Authenticated GET request (for metadata, download URLs, etc.).\n   * @param url - Full request URL\n   * @returns Parsed JSON response\n   */\n  get: <T = any>(url: string) => Promise<T>;\n\n  /**\n   * Authenticated GET request that returns the raw file BYTES as a Blob.\n   *\n   * The transport for inline previews: an `<img>` / PDF.js cannot attach the bearer,\n   * so components fetch the bytes here (auth added by the client; the backend serve\n   * route authorizes via the linked resource's READ) and wrap the Blob in an object\n   * URL. Optional for backwards-compat with hosts that only inject metadata ops.\n   *\n   * @param url - Full serve URL (already includes the fileId).\n   * @param options.signal - Abort signal to cancel on unmount.\n   */\n  getBlob?: (url: string, options?: { signal?: AbortSignal }) => Promise<Blob>;\n\n  /**\n   * Authenticated DELETE request (for file deletion).\n   * @param url - Full request URL\n   */\n  delete: (url: string) => Promise<void>;\n}\n\n/**\n * WHICH schema a form is validating against.\n *\n * This is not bookkeeping — it decides the answer to \"may this field be cleared?\", and the two\n * kinds answer it differently and cannot be told apart by shape:\n *\n * - On a **request DTO**, PATCH semantics have already made every field optional, so a required\n *   field is structurally identical to an optional one. Clearability is therefore exactly \"does it\n *   accept `null`\", which `toPatchOptionalField` granted only to the clearable fields.\n * - On a **main schema**, an ordinary `.optional()` field does NOT accept `null`, so that same\n *   question answers \"no\" for every field that is in fact clearable.\n *\n * Asking the wrong one is silent and field-shape dependent: an inline-edit surface builds its form\n * from the MAIN schema, and asking the request-DTO question there left refined optional fields\n * (colour, email, url) unclearable while plain optional strings still worked by accident.\n */\nexport enum FormSchemaKind {\n  /** An operation's UPDATE/CREATE request DTO — the default for resource forms. */\n  REQUEST_DTO = 'request-dto',\n  /** A resource's main schema, used by surfaces that build a form around a single declared field. */\n  MAIN_SCHEMA = 'main-schema',\n}\n\nexport enum AutosaveFieldState {\n  IDLE = 'idle',\n  SAVING = 'saving',\n  SAVED = 'saved',\n  ERROR = 'error',\n}\n\n/**\n * Base props for bare control components (presets).\n * Does NOT include chrome props (label, description, error) or autosave props —\n * those are handled externally by FormFieldChrome.\n *\n * All preset form-field components should extend this interface\n * (or an Omit of it for type-specific value/onChange overrides).\n */\nexport interface ControlBaseProps<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {\n  schema: TSchema;\n  /**\n   * Whether \"clear this field\" is a meaningful instruction here, RESOLVED by the form.\n   *\n   * A control must not re-derive this from `schema`: the answer depends on which KIND of schema\n   * the surrounding form validates (see {@link FormSchemaKind}), and the two are indistinguishable\n   * by shape. A control that asks the wrong question substitutes a value the user never entered —\n   * a stepper coercing an emptied box to `min`, a money input to zero, a toggle refusing to\n   * deselect.\n   *\n   * Absent (standalone control usage outside a form) means \"not clearable\", the conservative\n   * direction: the control keeps its existing substitution behaviour.\n   */\n  clearable?: boolean;\n  name: string;\n  disabled?: boolean;\n  readOnly?: boolean;\n  /**\n   * When true, the field receives focus on mount.\n   * Can be set via schema decorator or passed directly.\n   * Only applicable to focusable controls (input, textarea, select).\n   */\n  autoFocus?: boolean;\n  /** Resolved control density from explicit form props or surface policy. */\n  controlSize?: ControlSize;\n  className?: string;\n  value?: z.infer<TSchema>;\n  onChange?: (value: z.infer<TSchema>) => void;\n  onBlur?: () => void;\n  defaultValue?: z.infer<TSchema>;\n  validationMode?: ValidationMode;\n\n  /**\n   * Whether this field is effectively required.\n   * Computed by FormField based on schema optionality AND visibility.\n   * Hidden fields (due to discriminator mismatch) return false even if required in schema.\n   */\n  required?: boolean;\n}\n\n/**\n * Base props for all display field components.\n * These are read-only display components that show values without editing capability.\n */\nexport interface DisplayFieldBaseProps<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {\n  /** The Zod schema used for display policy and type information */\n  schema: TSchema;\n  /** The value to display */\n  value: z.infer<TSchema> | null | undefined;\n  /** Field label to display above the value */\n  label?: string;\n  /** Field description to display below the value */\n  description?: string;\n  /** Additional CSS class names */\n  className?: string;\n  /** Force display of label even if showLabel in schema is false */\n  forceDisplayLabel?: boolean;\n  /** Force display of description even if showDescription in schema is false */\n  forceDisplayDescription?: boolean;\n  /** Force hide label even if showLabel in schema is true */\n  forceHideLabel?: boolean;\n  /** Force hide description even if showDescription in schema is true */\n  forceHideDescription?: boolean;\n}\n"]}

package/dist/esm/components/form/useFormSchemaContext.d.ts

@@ -3,7 +3,7 @@
  *
  * Separated from form-context.tsx for React Fast Refresh compatibility.
  */
-import { type FormSchemaContextType } from './form-context.js';
+import { type FormSchemaContextType } from './form-context';
 /**
  * Hook to access the Form Schema context
  * @returns FormSchemaContextType with schema and form instance

package/dist/esm/components/form/useFormSchemaContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormSchemaContext.d.ts","sourceRoot":"","sources":["../../../../src/components/form/useFormSchemaContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAqB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAM5D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,qBAAqB,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"useFormSchemaContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/useFormSchemaContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAqB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAM5D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,qBAAqB,GAAG,IAAI,CAE3E"}

package/dist/esm/components/form/useFormSchemaContext.js

@@ -24,4 +24,4 @@ export function useFormSchemaContext() {
 export function useOptionalFormSchemaContext() {
     return useContext(FormSchemaContext);
 }
-//# sourceMappingURL=useFormSchemaContext.js.map
+//# sourceMappingURL=useFormSchemaContext.js.map

package/dist/esm/components/form/useFormSchemaContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFormSchemaContext.js","sourceRoot":"","sources":["../../../../src/components/form/useFormSchemaContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAA8B,MAAM,gBAAgB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"useFormSchemaContext.js","sourceRoot":"","sources":["../../../../../src/components/form/useFormSchemaContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAA8B,MAAM,gBAAgB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/**\n * Form Schema Context Hooks\n * \n * Separated from form-context.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext } from 'react';\nimport { FormSchemaContext, type FormSchemaContextType } from './form-context';\n\n/**\n * Hook to access the Form Schema context\n * @returns FormSchemaContextType with schema and form instance\n * @throws Error if used outside of FormSchemaProvider\n */\nexport function useFormSchemaContext(): FormSchemaContextType {\n  const ctx = useContext(FormSchemaContext);\n  if (!ctx) {\n    throw new Error('useFormSchemaContext must be used within a FormSchemaProvider');\n  }\n  return ctx;\n}\n\n/**\n * Hook to optionally access the Form Schema context\n * @returns FormSchemaContextType or null if not in a FormSchemaProvider\n */\nexport function useOptionalFormSchemaContext(): FormSchemaContextType | null {\n  return useContext(FormSchemaContext);\n}\n\n\n\n"]}

package/dist/esm/components/form/validation-errors/FormErrorSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormErrorSummary.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/validation-errors/FormErrorSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAoBvC,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,iBAAS,yBAAyB,CAAC,EACjC,KAAK,EACL,SAAS,EACT,SAAc,EACd,cAAc,GACf,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAgFlD;kBArFQ,yBAAyB;;;AAyFlC,eAAO,MAAM,gBAAgB,EAAE,OAAO,yBAAyB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAA8B,CAAC"}
+{"version":3,"file":"FormErrorSummary.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/FormErrorSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAqBvC,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,iBAAS,yBAAyB,CAAC,EACjC,KAAK,EACL,SAAS,EACT,SAAc,EACd,cAAc,GACf,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA4FlD;kBAjGQ,yBAAyB;;;AAqGlC,eAAO,MAAM,gBAAgB,EAAE,OAAO,yBAAyB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAA8B,CAAC"}

package/dist/esm/components/form/validation-errors/FormErrorSummary.js

@@ -11,12 +11,14 @@ import { FormContextUtils } from '../form-context.utils.js';
 import { useI18n } from '../../../core/i18n/useI18n.js';
 import { AutomatedLayoutFrontendUtils } from '../../../core/automated-layout/automated-layout.frontend.utils.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
+import { useSurfacePolicy } from '../../../core/ui/SurfacePolicyContext.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('FormErrorSummary');
 logger.setDebugTypeLogging('FormErrorSummary', false);
 function FormErrorSummaryComponent({ title, className, maxErrors = 10, stepFieldNames, }) {
     const { formState } = useFormContext();
     const { renderIcon } = useIconRegistry();
+    const surfacePolicy = useSurfacePolicy();
     const schemaContext = useOptionalFormSchemaContext();
     const resourceType = schemaContext?.resourceType;
     const { tResourceFieldEdit, tComponent, isReady } = useI18n({
@@ -24,9 +26,10 @@ function FormErrorSummaryComponent({ title, className, maxErrors = 10, stepField
         ...(resourceType ? { resource: resourceType } : {}),
     });
     const effectiveTitle = title ?? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'formErrorsTitle');
-    // Show cross-field + server errors in the summary banner.
-    // Field-level client errors are displayed inline under each field.
-    const { crossFieldErrors, serverErrors } = FormContextUtils.categorizeErrors(formState.errors);
+    // Show cross-field + server errors by default. Surface policy can promote
+    // field-level errors into this summary and FormField suppresses inline copies.
+    const { fieldErrors, crossFieldErrors, serverErrors } = FormContextUtils.categorizeErrors(formState.errors);
+    const shouldIncludeFieldErrors = surfacePolicy.autoRender?.autoErrorPlacement === 'summary-at-surface-top';
     // In wizard mode, filter server errors to only show those for the current step.
     // Cross-field errors (root-level) are always shown — they can't be attributed to a step.
     const filteredServerErrors = useMemo(() => {
@@ -35,12 +38,23 @@ function FormErrorSummaryComponent({ title, className, maxErrors = 10, stepField
         const stepFields = new Set(stepFieldNames);
         return serverErrors.filter(e => stepFields.has(e.path));
     }, [serverErrors, stepFieldNames]);
-    const errorsToShow = [...crossFieldErrors, ...filteredServerErrors];
+    const filteredFieldErrors = useMemo(() => {
+        if (!shouldIncludeFieldErrors)
+            return [];
+        if (!stepFieldNames)
+            return fieldErrors;
+        const stepFields = new Set(stepFieldNames);
+        return fieldErrors.filter(e => stepFields.has(e.path));
+    }, [fieldErrors, shouldIncludeFieldErrors, stepFieldNames]);
+    const errorsToShow = [...crossFieldErrors, ...filteredServerErrors, ...filteredFieldErrors];
     const formatFieldLabel = useMemo(() => AutomatedLayoutFrontendUtils.createFieldLabelResolver(resourceType, tResourceFieldEdit), [resourceType, tResourceFieldEdit]);
     if (errorsToShow.length === 0) {
         return null;
     }
+    if (!isReady)
+        return null;
     logDebug('rendering error summary', {
+        fieldCount: filteredFieldErrors.length,
         crossFieldCount: crossFieldErrors.length,
         serverCount: filteredServerErrors.length,
         totalServerErrors: serverErrors.length,
@@ -56,4 +70,4 @@ function FormErrorSummaryComponent({ title, className, maxErrors = 10, stepField
 }
 FormErrorSummaryComponent.displayName = 'FormErrorSummary';
 export const FormErrorSummary = FormErrorSummaryComponent;
-//# sourceMappingURL=FormErrorSummary.js.map
+//# sourceMappingURL=FormErrorSummary.js.map

package/dist/esm/components/form/validation-errors/FormErrorSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormErrorSummary.js","sourceRoot":"","sources":["../../../../../src/components/form/validation-errors/FormErrorSummary.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"FormErrorSummary.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/FormErrorSummary.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAC/G,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAEhH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2EAA2E,CAAC;AACzH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEpF,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;AACxD,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AActD,SAAS,yBAAyB,CAAC,EACjC,KAAK,EACL,SAAS,EACT,SAAS,GAAG,EAAE,EACd,cAAc,GACQ;IACtB,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,4BAA4B,EAAE,CAAC;IACrD,MAAM,YAAY,GAAG,aAAa,EAAE,YAAY,CAAC;IACjD,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC1D,SAAS,EAAE,qBAAqB,CAAC,sBAAsB;QACvD,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,KAAK,IAAI,UAAU,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;IAE5G,0EAA0E;IAC1E,+EAA+E;IAC/E,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5G,MAAM,wBAAwB,GAAG,aAAa,CAAC,UAAU,EAAE,kBAAkB,KAAK,wBAAwB,CAAC;IAE3G,gFAAgF;IAChF,yFAAyF;IACzF,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,EAAE;QACxC,IAAI,CAAC,cAAc;YAAE,OAAO,YAAY,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QAC3C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;IAEnC,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,EAAE;QACvC,IAAI,CAAC,wBAAwB;YAAE,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC,cAAc;YAAE,OAAO,WAAW,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QAC3C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,WAAW,EAAE,wBAAwB,EAAE,cAAc,CAAC,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,oBAAoB,EAAE,GAAG,mBAAmB,CAAC,CAAC;IAE5F,MAAM,gBAAgB,GAAG,OAAO,CAC9B,GAAG,EAAE,CAAC,4BAA4B,CAAC,wBAAwB,CAAC,YAAY,EAAE,kBAAkB,CAAC,EAC7F,CAAC,YAAY,EAAE,kBAAkB,CAAC,CACnC,CAAC;IAEF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,QAAQ,CAAC,yBAAyB,EAAE;QAClC,UAAU,EAAE,mBAAmB,CAAC,MAAM;QACtC,eAAe,EAAE,gBAAgB,CAAC,MAAM;QACxC,WAAW,EAAE,oBAAoB,CAAC,MAAM;QACxC,iBAAiB,EAAE,YAAY,CAAC,MAAM;QACtC,gBAAgB,EAAE,CAAC,CAAC,cAAc;QAClC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;KACpF,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC;IAEtD,OAAO,CACL,KAAC,KAAK,IACJ,OAAO,EAAC,aAAa,EACrB,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EACxB,IAAI,EAAC,OAAO,iBACA,oBAAoB,YAEhC,eAAK,SAAS,EAAC,8BAA8B,aAC1C,UAAU,CAAC,qBAAqB,CAAC,KAAK,EAAE;oBACvC,IAAI,EAAE,QAAQ,CAAC,EAAE;oBACjB,SAAS,EAAE,QAAQ;iBACpB,CAAC,EACF,eAAK,SAAS,EAAC,QAAQ,aACrB,KAAC,UAAU,IAAC,SAAS,EAAC,YAAY,YAAE,cAAc,GAAc,EAChE,MAAC,gBAAgB,eACf,aAAI,SAAS,EAAC,+CAA+C,YAC1D,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAC/C,yBACE,gBAAM,SAAS,EAAC,aAAa,aAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAC,GAAG,EACjE,OAAO,KAFD,GAAG,IAAI,IAAI,KAAK,EAAE,CAGtB,CACN,CAAC,GACC,EAEJ,aAAa,IAAI,CAChB,YAAG,SAAS,EAAC,gDAAgD,YAC1D,UAAU,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC,GACjH,CACL,IACgB,IACf,IACF,GACA,CACT,CAAC;AACJ,CAAC;AAED,yBAAyB,CAAC,WAAW,GAAG,kBAAkB,CAAC;AAE3D,MAAM,CAAC,MAAM,gBAAgB,GAA+D,yBAAyB,CAAC","sourcesContent":["import React, { useMemo } from 'react';\nimport { useFormContext } from 'react-hook-form';\n\nimport { Alert, AlertTitle, AlertDescription } from '~wildo-frontend-lib/components/overlays/containers/alert';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { IconSize, StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useOptionalFormSchemaContext } from '../useFormSchemaContext';\nimport { FormContextUtils } from '../form-context.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { useSurfacePolicy } from '~wildo-frontend-lib/core/ui/SurfacePolicyContext';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('FormErrorSummary');\nlogger.setDebugTypeLogging('FormErrorSummary', false);\n\nexport interface FormErrorSummaryProps {\n  title?: string;\n  className?: string;\n  maxErrors?: number;\n  /**\n   * When provided (wizard mode), filters error display to only show errors\n   * for fields in the current step. Cross-field/root errors are always shown.\n   * When omitted, all errors are shown (non-wizard mode).\n   */\n  stepFieldNames?: string[];\n}\n\nfunction FormErrorSummaryComponent({\n  title,\n  className,\n  maxErrors = 10,\n  stepFieldNames,\n}: FormErrorSummaryProps): React.JSX.Element | null {\n  const { formState } = useFormContext();\n  const { renderIcon } = useIconRegistry();\n  const surfacePolicy = useSurfacePolicy();\n  const schemaContext = useOptionalFormSchemaContext();\n  const resourceType = schemaContext?.resourceType;\n  const { tResourceFieldEdit, tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE,\n    ...(resourceType ? { resource: resourceType } : {}),\n  });\n  \n  const effectiveTitle = title ?? tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'formErrorsTitle');\n  \n  // Show cross-field + server errors by default. Surface policy can promote\n  // field-level errors into this summary and FormField suppresses inline copies.\n  const { fieldErrors, crossFieldErrors, serverErrors } = FormContextUtils.categorizeErrors(formState.errors);\n  const shouldIncludeFieldErrors = surfacePolicy.autoRender?.autoErrorPlacement === 'summary-at-surface-top';\n  \n  // In wizard mode, filter server errors to only show those for the current step.\n  // Cross-field errors (root-level) are always shown — they can't be attributed to a step.\n  const filteredServerErrors = useMemo(() => {\n    if (!stepFieldNames) return serverErrors;\n    const stepFields = new Set(stepFieldNames);\n    return serverErrors.filter(e => stepFields.has(e.path));\n  }, [serverErrors, stepFieldNames]);\n\n  const filteredFieldErrors = useMemo(() => {\n    if (!shouldIncludeFieldErrors) return [];\n    if (!stepFieldNames) return fieldErrors;\n    const stepFields = new Set(stepFieldNames);\n    return fieldErrors.filter(e => stepFields.has(e.path));\n  }, [fieldErrors, shouldIncludeFieldErrors, stepFieldNames]);\n  \n  const errorsToShow = [...crossFieldErrors, ...filteredServerErrors, ...filteredFieldErrors];\n  \n  const formatFieldLabel = useMemo(\n    () => AutomatedLayoutFrontendUtils.createFieldLabelResolver(resourceType, tResourceFieldEdit),\n    [resourceType, tResourceFieldEdit]\n  );\n  \n  if (errorsToShow.length === 0) {\n    return null;\n  }\n\n  if (!isReady) return null;\n\n  logDebug('rendering error summary', {\n    fieldCount: filteredFieldErrors.length,\n    crossFieldCount: crossFieldErrors.length,\n    serverCount: filteredServerErrors.length,\n    totalServerErrors: serverErrors.length,\n    isWizardFiltered: !!stepFieldNames,\n    errors: errorsToShow.map(e => ({ path: e.path, type: e.type, message: e.message })),\n  });\n  \n  const displayErrors = errorsToShow.slice(0, maxErrors);\n  const hasMoreErrors = errorsToShow.length > maxErrors;\n  \n  return (\n    <Alert \n      variant=\"destructive\" \n      className={cn(className)}\n      role=\"alert\"\n      data-testid=\"form-error-summary\"\n    >\n      <div className=\"flex items-start gap-element\">\n        {renderIcon(StandardIconReference.ERROR, { \n          size: IconSize.SM, \n          className: 'mt-0.5' \n        })}\n        <div className=\"flex-1\">\n          <AlertTitle className=\"mb-element\">{effectiveTitle}</AlertTitle>\n          <AlertDescription>\n            <ul className=\"list-disc list-inside space-y-item-xs text-sm\">\n              {displayErrors.map(({ path, message }, index) => (\n                <li key={`${path}-${index}`}>\n                  <span className=\"font-medium\">{formatFieldLabel(path)}:</span>{' '}\n                  {message}\n                </li>\n              ))}\n            </ul>\n            \n            {hasMoreErrors && (\n              <p className=\"mt-item text-sm opacity-[var(--opacity-hover)]\">\n                {tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'moreErrors', { count: errorsToShow.length - maxErrors })}\n              </p>\n            )}\n          </AlertDescription>\n        </div>\n      </div>\n    </Alert>\n  );\n}\n\nFormErrorSummaryComponent.displayName = 'FormErrorSummary';\n\nexport const FormErrorSummary: typeof FormErrorSummaryComponent & { displayName: string } = FormErrorSummaryComponent;\n"]}

package/dist/esm/components/form/validation-errors/form-error-extraction.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-error-extraction.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/validation-errors/form-error-extraction.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,uBAAuB,CAAC;AAO/B;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,2FAA2F;IAC3F,mBAAmB,EAAE,gBAAgB,CAAC;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,GAAG,IAAI,CA4DhG"}
+{"version":3,"file":"form-error-extraction.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/form-error-extraction.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,uBAAuB,CAAC;AAO/B;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,2FAA2F;IAC3F,mBAAmB,EAAE,gBAAgB,CAAC;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,GAAG,IAAI,CA4DhG"}

package/dist/esm/components/form/validation-errors/form-error-extraction.utils.js

@@ -104,4 +104,4 @@ function isValidationStatus(status) {
 function isValidationErrorsMap(value) {
     return !!value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length > 0;
 }
-//# sourceMappingURL=form-error-extraction.utils.js.map
+//# sourceMappingURL=form-error-extraction.utils.js.map

package/dist/esm/components/form/validation-errors/form-error-extraction.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-error-extraction.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/validation-errors/form-error-extraction.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-error-extraction.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/form-error-extraction.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Typed utilities for extracting server validation errors from HTTP errors.\n * \n * Handles the error shape produced by the Wildo HTTP client interceptor,\n * which enhances Axios errors with backend response data.\n * \n * Error chain:\n * 1. Backend sends: { error: { type, validationErrors: { field: \"message\" | ValidationErrorEntry }, ... } }\n * 2. HTTP client interceptor extracts: error.httpStatus, error.validationErrors, error.errorType\n * 3. This utility resolves structured entries to display strings and provides typed access.\n * \n * The validationErrors values can be:\n * - Plain strings (legacy format, from Zod validation)\n * - Structured `ValidationErrorEntry` objects (i18n-ready, from uniqueness checks etc.)\n * \n * This module resolves structured entries to display strings so consumers \n * always receive `Record<string, string>`.\n */\n\nimport {\n  type ValidationErrors,\n  type ValidationErrorValue,\n  resolveValidationErrors,\n  extractValidationErrors as extractValidationErrorsFromPayload,\n  ErrorCustomMessageReference,\n} from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('FormErrorExtraction');\nlogger.setDebugTypeLogging('FormErrorExtraction', false);\n\n/**\n * Result of extracting server validation errors from an HTTP error.\n */\nexport interface ServerValidationErrorResult {\n  /** HTTP status code (e.g., 400, 409) */\n  httpStatus: number;\n  /** Field-level validation errors resolved to display strings: { fieldName: \"error message\" } */\n  validationErrors: Record<string, string>;\n  /** Raw validation errors (may contain structured i18n entries) — for advanced consumers */\n  rawValidationErrors: ValidationErrors;\n}\n\n/**\n * Extract server validation errors from an HTTP error.\n * \n * Checks multiple locations for validation errors to handle both\n * the enhanced error properties (set by HTTP client interceptor)\n * and the raw response data as fallback.\n * \n * Structured `ValidationErrorEntry` values are resolved to display strings\n * using their fallback message. Frontend i18n resolution can be applied\n * by consumers using the `rawValidationErrors` field.\n * \n * @param error - The caught error from a doOperation call\n * @returns Extracted validation errors, or null if this is not a validation error\n */\nexport function extractServerValidationErrors(error: unknown): ServerValidationErrorResult | null {\n  if (!error || typeof error !== 'object') {\n    logDebug('extractServerValidationErrors: not an object, skipping', { errorType: typeof error });\n    return null;\n  }\n\n  const err = error as Record<string, unknown>;\n\n  // Version conflicts are not validation errors — they are optimistic locking failures\n  // handled by the RMM conflict flow (CONFLICT_RESET). Exclude them before validation extraction.\n  if (err.customMessageReference === ErrorCustomMessageReference.VERSION_CONFLICT) {\n    logDebug('extractServerValidationErrors: version conflict, not a validation error');\n    return null;\n  }\n  \n  logDebug('extractServerValidationErrors: inspecting error shape', {\n    httpStatus: err.httpStatus,\n    hasValidationErrors: !!err.validationErrors,\n    errorType: err.errorType,\n    hasResponse: !!err.response,\n    message: err.message,\n  });\n  \n  // Primary path: enhanced properties set by HTTP client interceptor\n  const httpStatus = err.httpStatus as number | undefined;\n  const rawValidationErrors = err.validationErrors as ValidationErrors | undefined;\n  \n  if (isValidationStatus(httpStatus) && isValidationErrorsMap(rawValidationErrors)) {\n    const resolved = resolveValidationErrors(rawValidationErrors);\n    logDebug('extractServerValidationErrors: MATCHED via interceptor properties', {\n      httpStatus,\n      fieldCount: Object.keys(resolved).length,\n      fields: Object.keys(resolved),\n    });\n    return { httpStatus, validationErrors: resolved, rawValidationErrors };\n  }\n  \n  // Fallback path: read directly from raw Axios response data\n  const response = err.response as Record<string, unknown> | undefined;\n  if (response) {\n    const status = response.status as number | undefined;\n    const data = response.data as Record<string, unknown> | undefined;\n    \n    if (isValidationStatus(status) && data) {\n      // Use shared extraction utility from saas-models\n      const extracted = extractValidationErrorsFromPayload(data);\n      if (extracted && Object.keys(extracted).length > 0) {\n        const resolved = resolveValidationErrors(extracted);\n        logDebug('extractServerValidationErrors: MATCHED via raw response', {\n          httpStatus: status,\n          fieldCount: Object.keys(resolved).length,\n          fields: Object.keys(resolved),\n        });\n        return { httpStatus: status, validationErrors: resolved, rawValidationErrors: extracted };\n      }\n    }\n  }\n  \n  logDebug('extractServerValidationErrors: NO validation errors found');\n  return null;\n}\n\n/**\n * Check if an HTTP status code indicates a validation error.\n * - 400: Bad Request (general validation)\n * - 409: Conflict (unique constraint violations — version conflicts excluded by caller)\n * - 422: Unprocessable Entity (semantic validation errors — standard for REST APIs)\n */\nfunction isValidationStatus(status: number | undefined): status is number {\n  return status === 400 || status === 409 || status === 422;\n}\n\n/**\n * Type guard: check if a value is a non-empty validation errors map.\n * Accepts both plain string values and structured ValidationErrorEntry values.\n */\nfunction isValidationErrorsMap(value: unknown): value is ValidationErrors {\n  return !!value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length > 0;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"form-validation.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/validation-errors/form-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CAkBhB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW9F"}
+{"version":3,"file":"form-validation.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/form-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CAkBhB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW9F"}

package/dist/esm/components/form/validation-errors/form-validation.js

@@ -62,4 +62,4 @@ export function getZodErrorParams(issue) {
     }
     return params;
 }
-//# sourceMappingURL=form-validation.js.map
+//# sourceMappingURL=form-validation.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"form-validation.js","sourceRoot":"","sources":["../../../../../src/components/form/validation-errors/form-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAErE,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAoB,EACpB,QAAyB;IAEzB,qCAAqC;IACrC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,cAAc,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,iEAAiE;IACjE,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,cAAc,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,oBAAoB;IACpB,OAAO,cAAc,CAAC,OAAO,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,UAAU,EAAE,IAAI,IAAI,SAAS,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAmC;IACnE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,iDAAiD;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"form-validation.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/form-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAErE,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAoB,EACpB,QAAyB;IAEzB,qCAAqC;IACrC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,cAAc,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,iEAAiE;IACjE,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,cAAc,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,oBAAoB;IACpB,OAAO,cAAc,CAAC,OAAO,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,UAAU,EAAE,IAAI,IAAI,SAAS,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAmC;IACnE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,iDAAiD;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Form Validation Utilities\n * \n * Utilities for determining validation modes based on schema configuration.\n * \n * ## Architecture Note (P1-T10 - Greenfield Cleanup)\n * \n * Field-level validation is now handled entirely by React Hook Form (RHF) via\n * the standardSchemaResolver. This file only provides:\n * - ValidationMode type for configuration\n * - determineValidationMode() for schema-based mode detection\n * - Zod error utilities for i18n translation\n * \n * The deprecated validateField(), ValidationResult, and createValidationHandler()\n * have been removed as they are no longer needed with RHF as the single source\n * of validation truth.\n */\n\nimport { z } from 'zod';\nimport { hasRefine, ValidationMode } from '@wildo-ai/zod-decorators';\n\n// Re-export ValidationMode enum for consumers\nexport { ValidationMode } from '@wildo-ai/zod-decorators';\n\n/**\n * Determine the validation mode for a field based on its schema\n * \n * Rules:\n * - If schema has refine/superRefine → ON_CHANGE (immediate feedback needed)\n * - Otherwise use the provided override or default to ON_BLUR\n */\nexport function determineValidationMode(\n  schema: z.ZodTypeAny, \n  override?: ValidationMode\n): ValidationMode {\n  // If explicitly overridden, use that\n  if (override) {\n    return override;\n  }\n  \n  // Guard against non-Zod schemas\n  if (!schema || typeof schema !== 'object') {\n    return ValidationMode.ON_BLUR;\n  }\n  \n  // If schema has refinements, use onChange for immediate feedback\n  if (hasRefine(schema)) {\n    return ValidationMode.ON_CHANGE;\n  }\n  \n  // Default to onBlur\n  return ValidationMode.ON_BLUR;\n}\n\n/**\n * Extract Zod error code from a Zod error\n * Used for translation lookup\n */\nexport function getZodErrorCode(error: z.ZodError): string {\n  const firstIssue = error.issues[0];\n  return firstIssue?.code ?? 'unknown';\n}\n\n/**\n * Extract error parameters from a Zod issue for translation\n */\nexport function getZodErrorParams(issue: z.ZodError['issues'][number]): Record<string, unknown> {\n  const params: Record<string, unknown> = {};\n  \n  // Copy all properties except code, message, path\n  for (const [key, value] of Object.entries(issue)) {\n    if (key !== 'code' && key !== 'message' && key !== 'path') {\n      params[key] = value;\n    }\n  }\n  \n  return params;\n}\n\n"]}

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

@@ -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"}
+{"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"}

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

@@ -57,4 +57,4 @@ export function getFieldError(fieldState, isFormSubmitted, validationMode, tErro
     return translated;
 }
 export { FILE_VALIDATION_ERROR_TYPE, isRequiredFieldError };
-//# sourceMappingURL=getFieldError.js.map
+//# sourceMappingURL=getFieldError.js.map

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

@@ -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"}
+{"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"]}

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

@@ -0,0 +1,49 @@
+/**
+ * scroll-to-first-error.utils — bring the first invalid field into view after a
+ * failed submit.
+ *
+ * ## Why this exists (audit finding D4)
+ *
+ * On submit-validation failure the errors render inline next to their fields,
+ * but the viewport stays wherever the user was — typically at the submit button
+ * at the BOTTOM of a long form, while the errored required fields sit invisible
+ * at the top. The user sees a click that "did nothing".
+ *
+ * ## How the DOM lookup works
+ *
+ * Every visible `FormFieldChrome` mode renders `data-field={fieldName}` on its
+ * outer wrapper (documented as the "data-field safety net" in
+ * `FormFieldChrome.tsx`), and `AutomatedArrayField` renders it on the array's
+ * `ContentSection`. We therefore:
+ *
+ * 1. Flatten the error object (react-hook-form `FieldErrors` or a server
+ *    validation-error map) into dotted field paths.
+ * 2. Walk `[data-field]` elements **in DOM order** (error-object key order is
+ *    insertion order, not visual order) and pick the first element whose
+ *    `data-field` equals an errored path or is a structural ancestor of one
+ *    (e.g. the `checklist` array section for a `checklist.0.label` error).
+ * 3. Scroll it into view (centered, smooth) and focus the first focusable
+ *    control inside it, so keyboard users land where the repair happens.
+ *
+ * The `[name="..."]` fallback covers controls rendered outside a chrome wrapper.
+ */
+import type { FieldErrors } from 'react-hook-form';
+/**
+ * Flatten a react-hook-form `FieldErrors` tree into dotted field paths.
+ *
+ * An error LEAF is any node carrying a string `message` or a string `type`
+ * (the shape both the standard-schema resolver and `setError` produce). Array
+ * `root` errors are attributed to the array path itself (`checklist.root` →
+ * `checklist`). Order follows the error object's own insertion order — DOM
+ * ordering is applied later by {@link scrollAndFocusFirstErroredField}.
+ */
+export declare function collectErroredFieldPaths(errors: FieldErrors | Record<string, unknown>): string[];
+/**
+ * Scroll the first errored field (in DOM order) into view and focus it.
+ *
+ * @param erroredPaths dotted field paths, e.g. from {@link collectErroredFieldPaths}
+ *   or `Object.keys(serverValidationErrors)`.
+ * @returns `true` when a matching element was found and scrolled.
+ */
+export declare function scrollAndFocusFirstErroredField(erroredPaths: string[]): boolean;
+//# sourceMappingURL=scroll-to-first-error.utils.d.ts.map

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

@@ -0,0 +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

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

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

@@ -0,0 +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/useFieldUniquenessValidation.d.ts.map

@@ -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"}
+{"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"}

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

@@ -119,4 +119,4 @@ export function useFieldUniquenessValidation({ fieldName, fieldSchema, }) {
         isChecking: isCheckingRef.current,
     };
 }
-//# sourceMappingURL=useFieldUniquenessValidation.js.map
+//# sourceMappingURL=useFieldUniquenessValidation.js.map