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

package/dist/esm/components/form/form-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-context.js","sourceRoot":"","sources":["../../../../../src/components/form/form-context.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAiB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI9D,OAAO,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAkDzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgD,aAAa,CAA+B,IAAI,CAAC,CAAC;AA0BhI,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,UAAU,GAAG,cAAc,CAAC,WAAW,EACvC,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,QAAQ,GACgB;IACxB,6DAA6D;IAC7D,6EAA6E;IAC7E,8DAA8D;IAE9D,yFAAyF;IACzF,kFAAkF;IAClF,MAAM,6BAA6B,GAAG,0BAA0B;QAC9D,CAAC,CAAC,IAAI,CAAC,SAAS,CACZ,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC;aACvC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAC1C;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,8BAA8B,GAAG,2BAA2B;QAChE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,UAAU;QACV,IAAI;QACJ,YAAY;QACZ,cAAc;QACd,gBAAgB;QAChB,UAAU;QACV,aAAa;QACb,0BAA0B;QAC1B,2BAA2B;QAC3B,cAAc;KACf,CAAC;IACF,gGAAgG;IAChG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,cAAc,CAAC,CACrL,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC7C,KAAC,YAAY,OAAK,IAAI,YACnB,QAAQ,GACI,GACY,CAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAA+B,CAAC","sourcesContent":["/**\n * Form Context\n * \n * Provides schema access to child form components.\n */\n\nimport React, { createContext, useMemo } from 'react';\nimport { z } from 'zod';\nimport { UseFormReturn, FormProvider } from 'react-hook-form';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\nimport { FormSchemaKind, type ValidationMode } from './form-field-types';\n\nexport interface FormSchemaContextType {\n  schema: z.ZodTypeAny;\n  /**\n   * Which KIND of schema `schema` is. Decides how field clearability is answered — see\n   * {@link FormSchemaKind}. Defaults to REQUEST_DTO, which is what every resource form supplies.\n   */\n  schemaKind: FormSchemaKind;\n  form: UseFormReturn<any>;\n  /** Resource type for i18n field label lookup (optional) */\n  resourceType?: string;\n  /** Form-level validation mode - applies to all fields unless overridden */\n  validationMode?: ValidationMode;\n  /** \n   * Base URL for the validate-field endpoint (e.g., \"/api/v1/todos/validate-field\").\n   * When present, fields with isUnique() decorator will trigger server-side uniqueness checks on blur.\n   */\n  validateFieldUrl?: string;\n  /**\n   * Resource ID for UPDATE operations. Used as excludeId in uniqueness checks\n   * to avoid false conflicts with the resource's own current values.\n   */\n  resourceId?: string;\n  /**\n   * Current operation type (e.g., 'create', 'update', or custom operation names).\n   * Used by operation-aware decorators like isNotEditable({ operations: ['update'] })\n   * to determine field editability based on the current form operation.\n   */\n  operationType?: string;\n  /**\n   * Resource context identifiers map: ResourceType → resourceId | { fieldIdentifier, resourceId }.\n   * Propagated from FrontendResourceOperationContext so that nested field components\n   * (e.g., FK display/edit) can build correct scoped URLs and context-aware searches.\n   */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /**\n   * Route parent evidence supplied by the resource surface. Generated relationship\n   * fields use it when the current context has no serializable identifiers yet.\n   */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /**\n   * Current navigation zone hosting this form surface.\n   *\n   * Quick-create workflows need the source zone so they can open a temporary\n   * create surface without replacing the form currently being edited.\n   */\n  navigationZone?: NavigationZone;\n}\n\n/**\n * Form Schema Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useFormSchemaContext() hook instead of accessing this directly\n */\nexport const FormSchemaContext: React.Context<FormSchemaContextType | null> = createContext<FormSchemaContextType | null>(null);\n\nexport interface FormSchemaProviderProps {\n  schema: z.ZodTypeAny;\n  /** Which kind of schema is being validated — see {@link FormSchemaKind}. @default REQUEST_DTO */\n  schemaKind?: FormSchemaKind;\n  form: UseFormReturn<any>;\n  /** Resource type for i18n field label lookup (optional) */\n  resourceType?: string;\n  /** Form-level validation mode - applies to all fields unless overridden by decorator or prop */\n  validationMode?: ValidationMode;\n  /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */\n  validateFieldUrl?: string;\n  /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */\n  resourceId?: string;\n  /** Current operation type for operation-aware decorators (e.g., isNotEditable) */\n  operationType?: string;\n  /** Resource context identifiers for FK context propagation */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship mutation surfaces */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n  children: React.ReactNode;\n}\n\nexport function FormSchemaProvider({\n  schema,\n  schemaKind = FormSchemaKind.REQUEST_DTO,\n  form,\n  resourceType,\n  validationMode,\n  validateFieldUrl,\n  resourceId,\n  operationType,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n  children,\n}: FormSchemaProviderProps): React.JSX.Element {\n  // Memoize the context value to prevent cascading re-renders.\n  // Without this, every render of the provider creates a new object reference,\n  // forcing every useFormSchemaContext() consumer to re-render.\n  \n  // Stabilize contextResourceIdentifiers — object reference changes on every parent render\n  // but we only care about value changes. Use a sorted JSON key for dep comparison.\n  const contextResourceIdentifiersKey = contextResourceIdentifiers\n    ? JSON.stringify(\n        Object.entries(contextResourceIdentifiers)\n          .sort(([a], [b]) => a.localeCompare(b))\n      )\n    : undefined;\n  const parentResourcesRequirementsKey = parentResourcesRequirements\n    ? JSON.stringify(parentResourcesRequirements)\n    : undefined;\n  \n  const contextValue = useMemo(\n    () => ({\n      schema,\n      schemaKind,\n      form,\n      resourceType,\n      validationMode,\n      validateFieldUrl,\n      resourceId,\n      operationType,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n      navigationZone,\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- using stable keys for context objects\n    [schema, schemaKind, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiersKey, parentResourcesRequirementsKey, navigationZone]\n  );\n  \n  return (\n    <FormSchemaContext.Provider value={contextValue}>\n      <FormProvider {...form}>\n        {children}\n      </FormProvider>\n    </FormSchemaContext.Provider>\n  );\n}\n\n// =============================================================================\n// ERROR CATEGORIZATION CONSTANTS\n// =============================================================================\n\n/**\n * Error type set by ResourceAutomatedForm when injecting server-side validation errors.\n * Used to distinguish server errors from client-side Zod validation errors.\n */\nexport const SERVER_ERROR_TYPE = 'server' as const;\n\n/**\n * Error type set by the uniqueness pre-validation hook when a field value\n * conflicts with an existing resource. Distinguished from SERVER_ERROR_TYPE\n * (which is set post-submission) to allow targeted UI treatment (e.g., checking spinner).\n */\nexport const UNIQUE_ERROR_TYPE = 'server-unique' as const;\n\n/**\n * Error type set by FormFieldRecord when duplicate keys are detected in a record field.\n * Uses a namespaced value to avoid collision with Zod's 'custom' issue code from .refine().\n */\nexport const DUPLICATE_KEY_ERROR_TYPE = 'record-duplicate-key' as const;\n\n/** Flattened error entry with optional type from RHF */\nexport interface FlattenedError {\n  path: string;\n  message: string;\n  /** Error type (e.g., 'server' for server validation errors, 'required', 'pattern', etc.) */\n  type?: string;\n}\n\n/**\n * Categorized errors result.\n * Separates field-level errors from cross-field (schema-level) errors\n * and server-side validation errors.\n */\nexport interface CategorizedErrors {\n  /** Client-side errors with a specific field path (display inline under fields) */\n  fieldErrors: Array<FlattenedError>;\n  /** Errors without a specific path or from schema-level refinements (display in summary) */\n  crossFieldErrors: Array<FlattenedError>;\n  /** Server-side validation errors (type: 'server') that should be shown in summary banner */\n  serverErrors: Array<FlattenedError>;\n}"]}
+{"version":3,"file":"form-context.js","sourceRoot":"","sources":["../../../../../src/components/form/form-context.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAiB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI9D,OAAO,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAkDzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgD,aAAa,CAA+B,IAAI,CAAC,CAAC;AA0BhI,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,UAAU,GAAG,cAAc,CAAC,WAAW,EACvC,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,QAAQ,GACgB;IACxB,6DAA6D;IAC7D,6EAA6E;IAC7E,8DAA8D;IAE9D,yFAAyF;IACzF,kFAAkF;IAClF,MAAM,6BAA6B,GAAG,0BAA0B;QAC9D,CAAC,CAAC,IAAI,CAAC,SAAS,CACZ,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC;aACvC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAC1C;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,8BAA8B,GAAG,2BAA2B;QAChE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,UAAU;QACV,IAAI;QACJ,YAAY;QACZ,cAAc;QACd,gBAAgB;QAChB,UAAU;QACV,aAAa;QACb,0BAA0B;QAC1B,2BAA2B;QAC3B,cAAc;KACf,CAAC;IACF,gGAAgG;IAChG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,cAAc,CAAC,CACrL,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC7C,KAAC,YAAY,OAAK,IAAI,YACnB,QAAQ,GACI,GACY,CAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAwB,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAgB,CAAC;AAEtD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAA+B,CAAC","sourcesContent":["/**\n * Form Context\n * \n * Provides schema access to child form components.\n */\n\nimport React, { createContext, useMemo } from 'react';\nimport { z } from 'zod';\nimport { UseFormReturn, FormProvider } from 'react-hook-form';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\nimport { FormSchemaKind, type ValidationMode } from './form-field-types';\n\nexport interface FormSchemaContextType {\n  schema: z.ZodTypeAny;\n  /**\n   * Which KIND of schema `schema` is. Decides how field clearability is answered — see\n   * {@link FormSchemaKind}. Defaults to REQUEST_DTO, which is what every resource form supplies.\n   */\n  schemaKind: FormSchemaKind;\n  form: UseFormReturn<any>;\n  /** Resource type for i18n field label lookup (optional) */\n  resourceType?: string;\n  /** Form-level validation mode - applies to all fields unless overridden */\n  validationMode?: ValidationMode;\n  /** \n   * Base URL for the validate-field endpoint (e.g., \"/api/v1/todos/validate-field\").\n   * When present, fields with isUnique() decorator will trigger server-side uniqueness checks on blur.\n   */\n  validateFieldUrl?: string;\n  /**\n   * Resource ID for UPDATE operations. Used as excludeId in uniqueness checks\n   * to avoid false conflicts with the resource's own current values.\n   */\n  resourceId?: string;\n  /**\n   * Current operation type (e.g., 'create', 'update', or custom operation names).\n   * Used by operation-aware decorators like isNotEditable({ operations: ['update'] })\n   * to determine field editability based on the current form operation.\n   */\n  operationType?: string;\n  /**\n   * Resource context identifiers map: ResourceType → resourceId | { fieldIdentifier, resourceId }.\n   * Propagated from FrontendResourceOperationContext so that nested field components\n   * (e.g., FK display/edit) can build correct scoped URLs and context-aware searches.\n   */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /**\n   * Route parent evidence supplied by the resource surface. Generated relationship\n   * fields use it when the current context has no serializable identifiers yet.\n   */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /**\n   * Current navigation zone hosting this form surface.\n   *\n   * Quick-create workflows need the source zone so they can open a temporary\n   * create surface without replacing the form currently being edited.\n   */\n  navigationZone?: NavigationZone;\n}\n\n/**\n * Form Schema Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useFormSchemaContext() hook instead of accessing this directly\n */\nexport const FormSchemaContext: React.Context<FormSchemaContextType | null> = createContext<FormSchemaContextType | null>(null);\n\nexport interface FormSchemaProviderProps {\n  schema: z.ZodTypeAny;\n  /** Which kind of schema is being validated — see {@link FormSchemaKind}. @default REQUEST_DTO */\n  schemaKind?: FormSchemaKind;\n  form: UseFormReturn<any>;\n  /** Resource type for i18n field label lookup (optional) */\n  resourceType?: string;\n  /** Form-level validation mode - applies to all fields unless overridden by decorator or prop */\n  validationMode?: ValidationMode;\n  /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */\n  validateFieldUrl?: string;\n  /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */\n  resourceId?: string;\n  /** Current operation type for operation-aware decorators (e.g., isNotEditable) */\n  operationType?: string;\n  /** Resource context identifiers for FK context propagation */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship mutation surfaces */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n  children: React.ReactNode;\n}\n\nexport function FormSchemaProvider({\n  schema,\n  schemaKind = FormSchemaKind.REQUEST_DTO,\n  form,\n  resourceType,\n  validationMode,\n  validateFieldUrl,\n  resourceId,\n  operationType,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n  children,\n}: FormSchemaProviderProps): React.JSX.Element {\n  // Memoize the context value to prevent cascading re-renders.\n  // Without this, every render of the provider creates a new object reference,\n  // forcing every useFormSchemaContext() consumer to re-render.\n  \n  // Stabilize contextResourceIdentifiers — object reference changes on every parent render\n  // but we only care about value changes. Use a sorted JSON key for dep comparison.\n  const contextResourceIdentifiersKey = contextResourceIdentifiers\n    ? JSON.stringify(\n        Object.entries(contextResourceIdentifiers)\n          .sort(([a], [b]) => a.localeCompare(b))\n      )\n    : undefined;\n  const parentResourcesRequirementsKey = parentResourcesRequirements\n    ? JSON.stringify(parentResourcesRequirements)\n    : undefined;\n  \n  const contextValue = useMemo(\n    () => ({\n      schema,\n      schemaKind,\n      form,\n      resourceType,\n      validationMode,\n      validateFieldUrl,\n      resourceId,\n      operationType,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n      navigationZone,\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- using stable keys for context objects\n    [schema, schemaKind, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiersKey, parentResourcesRequirementsKey, navigationZone]\n  );\n  \n  return (\n    <FormSchemaContext.Provider value={contextValue}>\n      <FormProvider {...form}>\n        {children}\n      </FormProvider>\n    </FormSchemaContext.Provider>\n  );\n}\n\n// =============================================================================\n// ERROR CATEGORIZATION CONSTANTS\n// =============================================================================\n\n/**\n * Error type set by ResourceAutomatedForm when injecting server-side validation errors.\n * Used to distinguish server errors from client-side Zod validation errors.\n */\nexport const SERVER_ERROR_TYPE = 'server' as const;\n\n/**\n * Error type set by the uniqueness pre-validation hook when a field value\n * conflicts with an existing resource. Distinguished from SERVER_ERROR_TYPE\n * (which is set post-submission) to allow targeted UI treatment (e.g., checking spinner).\n */\nexport const UNIQUE_ERROR_TYPE = 'server-unique' as const;\n\n/**\n * The error key a FORM-LEVEL issue is recorded under: a refinement on the whole object (`.refine(fn, { message })`\n * with no `path`), whose issue therefore names no field.\n *\n * Not react-hook-form's own `root`: `handleSubmit` deletes `errors.root` before deciding whether the form is valid\n * (it reserves `root` for server errors, which live until the next submit), so a client issue recorded there would\n * still let the form submit — with the empty `values` the resolver returns on failure. A key RHF does not reserve\n * blocks the submit like any field error. `FormContextUtils.categorizeErrors` counts it, and every `_root…` path,\n * as cross-field, which is how the error summary lists it.\n */\nexport const FORM_LEVEL_ERROR_PATH = '_root' as const;\n\n/**\n * Error type set by FormFieldRecord when duplicate keys are detected in a record field.\n * Uses a namespaced value to avoid collision with Zod's 'custom' issue code from .refine().\n */\nexport const DUPLICATE_KEY_ERROR_TYPE = 'record-duplicate-key' as const;\n\n/** Flattened error entry with optional type from RHF */\nexport interface FlattenedError {\n  path: string;\n  message: string;\n  /** Error type (e.g., 'server' for server validation errors, 'required', 'pattern', etc.) */\n  type?: string;\n}\n\n/**\n * Categorized errors result.\n * Separates field-level errors from cross-field (schema-level) errors\n * and server-side validation errors.\n */\nexport interface CategorizedErrors {\n  /** Client-side errors with a specific field path (display inline under fields) */\n  fieldErrors: Array<FlattenedError>;\n  /** Errors without a specific path or from schema-level refinements (display in summary) */\n  crossFieldErrors: Array<FlattenedError>;\n  /** Server-side validation errors (type: 'server') that should be shown in summary banner */\n  serverErrors: Array<FlattenedError>;\n}"]}

package/dist/esm/components/form/form-context.utils.d.ts

@@ -8,6 +8,8 @@ export declare class FormContextUtils {
     private static readonly ROOT_ERROR_PATHS;
     private static readonly ROOT_ERROR_PREFIX;
     private static isCrossFieldErrorPath;
+    /** Whether an error path names no field: it belongs to the record as a whole (a form-level rule, a refusal with no field). */
+    static isFormLevelErrorPath(path: string | undefined): boolean;
     private static flattenErrors;
     /**
      * Categorize form errors into field-level, cross-field, and server errors.

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

@@ -1 +1 @@
-{"version":3,"file":"form-context.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAA6D,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnH;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO;IAEP,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAW;IAEpD,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAKpC,OAAO,CAAC,MAAM,CAAC,aAAa;IAmB5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB;CAgChE"}
+{"version":3,"file":"form-context.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAoF,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAK1I;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO;IAEP,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAElE,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAIpC,8HAA8H;IAC9H,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IAK9D,OAAO,CAAC,MAAM,CAAC,aAAa;IAmB5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB;CAgChE"}

package/dist/esm/components/form/form-context.utils.js

@@ -1,5 +1,5 @@
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
-import { SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from './form-context.js';
+import { FORM_LEVEL_ERROR_PATH, SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from './form-context.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('FormErrorCategorization');
 /**
@@ -8,8 +8,12 @@ const logDebug = logger.debugByType('FormErrorCategorization');
 export class FormContextUtils {
     constructor() { }
     static ROOT_ERROR_PATHS = new Set(['', 'root', '_']);
-    static ROOT_ERROR_PREFIX = '_root';
+    static ROOT_ERROR_PREFIX = FORM_LEVEL_ERROR_PATH;
     static isCrossFieldErrorPath(path) {
+        return FormContextUtils.isFormLevelErrorPath(path);
+    }
+    /** Whether an error path names no field: it belongs to the record as a whole (a form-level rule, a refusal with no field). */
+    static isFormLevelErrorPath(path) {
         if (!path)
             return true;
         return FormContextUtils.ROOT_ERROR_PATHS.has(path) || path.startsWith(FormContextUtils.ROOT_ERROR_PREFIX);

package/dist/esm/components/form/form-context.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-context.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FieldErrors } from 'react-hook-form';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE, type FlattenedError, type CategorizedErrors } from './form-context';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('FormErrorCategorization');\n\n/**\n * Static utility class for form error categorisation.\n */\nexport class FormContextUtils {\n  private constructor() {}\n\n  private static readonly ROOT_ERROR_PATHS = new Set(['', 'root', '_']);\n  private static readonly ROOT_ERROR_PREFIX = '_root';\n\n  private static isCrossFieldErrorPath(path: string | undefined): boolean {\n    if (!path) return true;\n    return FormContextUtils.ROOT_ERROR_PATHS.has(path) || path.startsWith(FormContextUtils.ROOT_ERROR_PREFIX);\n  }\n\n  private static flattenErrors(\n    errors: FieldErrors,\n    prefix: string = ''\n  ): Array<FlattenedError> {\n    const result: Array<FlattenedError> = [];\n\n    for (const [key, value] of Object.entries(errors)) {\n      const path = prefix ? `${prefix}.${key}` : key;\n\n      if (value?.message && typeof value.message === 'string') {\n        result.push({ path, message: value.message, type: value.type as string | undefined });\n      } else if (typeof value === 'object' && value !== null) {\n        result.push(...FormContextUtils.flattenErrors(value as FieldErrors, path));\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Categorize form errors into field-level, cross-field, and server errors.\n   */\n  static categorizeErrors(errors: FieldErrors): CategorizedErrors {\n    const allErrors = FormContextUtils.flattenErrors(errors);\n\n    const fieldErrors: Array<FlattenedError> = [];\n    const crossFieldErrors: Array<FlattenedError> = [];\n    const serverErrors: Array<FlattenedError> = [];\n\n    for (const error of allErrors) {\n      const isServerError = error.type === SERVER_ERROR_TYPE || error.type === UNIQUE_ERROR_TYPE;\n      if (isServerError) {\n        serverErrors.push(error);\n        continue;\n      }\n\n      if (FormContextUtils.isCrossFieldErrorPath(error.path)) {\n        crossFieldErrors.push(error);\n      } else {\n        fieldErrors.push(error);\n      }\n    }\n\n    logDebug('categorizeErrors', {\n      totalErrors: allErrors.length,\n      fieldErrors: fieldErrors.length,\n      crossFieldErrors: crossFieldErrors.length,\n      serverErrors: serverErrors.length,\n      serverFields: serverErrors.map(e => e.path),\n      crossFieldPaths: crossFieldErrors.map(e => e.path),\n    });\n\n    return { fieldErrors, crossFieldErrors, serverErrors };\n  }\n}\n"]}
+{"version":3,"file":"form-context.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAA+C,MAAM,gBAAgB,CAAC;AAE1I,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B,gBAAuB,CAAC;IAEhB,MAAM,CAAU,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAU,iBAAiB,GAAG,qBAAqB,CAAC;IAE1D,MAAM,CAAC,qBAAqB,CAAC,IAAwB;QAC3D,OAAO,gBAAgB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,8HAA8H;IAC9H,MAAM,CAAC,oBAAoB,CAAC,IAAwB;QAClD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IAC5G,CAAC;IAEO,MAAM,CAAC,aAAa,CAC1B,MAAmB,EACnB,SAAiB,EAAE;QAEnB,MAAM,MAAM,GAA0B,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAE/C,IAAI,KAAK,EAAE,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACxD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAA0B,EAAE,CAAC,CAAC;YACxF,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,aAAa,CAAC,KAAoB,EAAE,IAAI,CAAC,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAmB;QACzC,MAAM,SAAS,GAAG,gBAAgB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,WAAW,GAA0B,EAAE,CAAC;QAC9C,MAAM,gBAAgB,GAA0B,EAAE,CAAC;QACnD,MAAM,YAAY,GAA0B,EAAE,CAAC;QAE/C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC;YAC3F,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzB,SAAS;YACX,CAAC;YAED,IAAI,gBAAgB,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvD,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,kBAAkB,EAAE;YAC3B,WAAW,EAAE,SAAS,CAAC,MAAM;YAC7B,WAAW,EAAE,WAAW,CAAC,MAAM;YAC/B,gBAAgB,EAAE,gBAAgB,CAAC,MAAM;YACzC,YAAY,EAAE,YAAY,CAAC,MAAM;YACjC,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3C,eAAe,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACnD,CAAC,CAAC;QAEH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACzD,CAAC","sourcesContent":["import type { FieldErrors } from 'react-hook-form';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { FORM_LEVEL_ERROR_PATH, SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE, type FlattenedError, type CategorizedErrors } from './form-context';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('FormErrorCategorization');\n\n/**\n * Static utility class for form error categorisation.\n */\nexport class FormContextUtils {\n  private constructor() {}\n\n  private static readonly ROOT_ERROR_PATHS = new Set(['', 'root', '_']);\n  private static readonly ROOT_ERROR_PREFIX = FORM_LEVEL_ERROR_PATH;\n\n  private static isCrossFieldErrorPath(path: string | undefined): boolean {\n    return FormContextUtils.isFormLevelErrorPath(path);\n  }\n\n  /** Whether an error path names no field: it belongs to the record as a whole (a form-level rule, a refusal with no field). */\n  static isFormLevelErrorPath(path: string | undefined): boolean {\n    if (!path) return true;\n    return FormContextUtils.ROOT_ERROR_PATHS.has(path) || path.startsWith(FormContextUtils.ROOT_ERROR_PREFIX);\n  }\n\n  private static flattenErrors(\n    errors: FieldErrors,\n    prefix: string = ''\n  ): Array<FlattenedError> {\n    const result: Array<FlattenedError> = [];\n\n    for (const [key, value] of Object.entries(errors)) {\n      const path = prefix ? `${prefix}.${key}` : key;\n\n      if (value?.message && typeof value.message === 'string') {\n        result.push({ path, message: value.message, type: value.type as string | undefined });\n      } else if (typeof value === 'object' && value !== null) {\n        result.push(...FormContextUtils.flattenErrors(value as FieldErrors, path));\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Categorize form errors into field-level, cross-field, and server errors.\n   */\n  static categorizeErrors(errors: FieldErrors): CategorizedErrors {\n    const allErrors = FormContextUtils.flattenErrors(errors);\n\n    const fieldErrors: Array<FlattenedError> = [];\n    const crossFieldErrors: Array<FlattenedError> = [];\n    const serverErrors: Array<FlattenedError> = [];\n\n    for (const error of allErrors) {\n      const isServerError = error.type === SERVER_ERROR_TYPE || error.type === UNIQUE_ERROR_TYPE;\n      if (isServerError) {\n        serverErrors.push(error);\n        continue;\n      }\n\n      if (FormContextUtils.isCrossFieldErrorPath(error.path)) {\n        crossFieldErrors.push(error);\n      } else {\n        fieldErrors.push(error);\n      }\n    }\n\n    logDebug('categorizeErrors', {\n      totalErrors: allErrors.length,\n      fieldErrors: fieldErrors.length,\n      crossFieldErrors: crossFieldErrors.length,\n      serverErrors: serverErrors.length,\n      serverFields: serverErrors.map(e => e.path),\n      crossFieldPaths: crossFieldErrors.map(e => e.path),\n    });\n\n    return { fieldErrors, crossFieldErrors, serverErrors };\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;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"}
+{"version":3,"file":"FormErrorSummary.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/FormErrorSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAsBvC,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,CAsGlD;kBA3GQ,yBAAyB;;;AA+GlC,eAAO,MAAM,gBAAgB,EAAE,OAAO,yBAAyB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAA8B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useMemo } from 'react';
 import { useFormContext } from 'react-hook-form';
 import { Alert, AlertTitle, AlertDescription } from '../../../components/overlays/containers/alert.js';
@@ -12,6 +12,7 @@ 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';
+import { FORM_ERROR_SUMMARY_ATTRIBUTE } from './scroll-to-first-error.utils.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('FormErrorSummary');
 logger.setDebugTypeLogging('FormErrorSummary', false);
@@ -30,22 +31,23 @@ function FormErrorSummaryComponent({ title, className, maxErrors = 10, stepField
     // 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(() => {
+    /*
+     * In wizard mode, a field's error is listed on the step that holds the field. Two errors used to fall through:
+     * a server refusal that names NO field (it belongs to the record, so it is listed on every step, like a cross-field
+     * error), and one on a nested path (`address.city`) when the step registered its parent (`address`), which an exact
+     * match never found. Cross-field errors are always shown: they cannot be attributed to a step.
+     */
+    const isOnThisStep = useMemo(() => {
         if (!stepFieldNames)
-            return serverErrors;
-        const stepFields = new Set(stepFieldNames);
-        return serverErrors.filter(e => stepFields.has(e.path));
-    }, [serverErrors, stepFieldNames]);
+            return () => true;
+        return (path) => stepFieldNames.some((field) => path === field || path.startsWith(`${field}.`));
+    }, [stepFieldNames]);
+    const filteredServerErrors = useMemo(() => serverErrors.filter((e) => FormContextUtils.isFormLevelErrorPath(e.path) || isOnThisStep(e.path)), [serverErrors, isOnThisStep]);
     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]);
+        return fieldErrors.filter((e) => isOnThisStep(e.path));
+    }, [fieldErrors, shouldIncludeFieldErrors, isOnThisStep]);
     const errorsToShow = [...crossFieldErrors, ...filteredServerErrors, ...filteredFieldErrors];
     const formatFieldLabel = useMemo(() => AutomatedLayoutFrontendUtils.createFieldLabelResolver(resourceType, tResourceFieldEdit, schemaContext?.schema), [resourceType, tResourceFieldEdit, schemaContext?.schema]);
     if (errorsToShow.length === 0) {
@@ -63,10 +65,10 @@ function FormErrorSummaryComponent({ title, className, maxErrors = 10, stepField
     });
     const displayErrors = errorsToShow.slice(0, maxErrors);
     const hasMoreErrors = errorsToShow.length > maxErrors;
-    return (_jsx(Alert, { variant: "destructive", className: cn(className), role: "alert", "data-testid": "form-error-summary", children: _jsxs("div", { className: "flex items-start gap-element", children: [renderIcon(StandardIconReference.ERROR, {
+    return (_jsx(Alert, { variant: "destructive", className: cn(className), role: "alert", "data-testid": "form-error-summary", [FORM_ERROR_SUMMARY_ATTRIBUTE]: '', tabIndex: -1, children: _jsxs("div", { className: "flex items-start gap-element", children: [renderIcon(StandardIconReference.ERROR, {
                     size: IconSize.SM,
                     className: 'mt-0.5'
-                }), _jsxs("div", { className: "flex-1", children: [_jsx(AlertTitle, { className: "mb-element", children: effectiveTitle }), _jsxs(AlertDescription, { children: [_jsx("ul", { className: "list-disc list-inside space-y-item-xs text-sm", children: displayErrors.map(({ path, message }, index) => (_jsxs("li", { children: [_jsxs("span", { className: "font-medium", children: [formatFieldLabel(path), ":"] }), ' ', message] }, `${path}-${index}`))) }), hasMoreErrors && (_jsx("p", { className: "mt-item text-sm opacity-[var(--opacity-hover)]", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'moreErrors', { count: errorsToShow.length - maxErrors }) }))] })] })] }) }));
+                }), _jsxs("div", { className: "flex-1", children: [_jsx(AlertTitle, { className: "mb-element", children: effectiveTitle }), _jsxs(AlertDescription, { children: [_jsx("ul", { className: "list-disc list-inside space-y-item-xs text-sm", children: displayErrors.map(({ path, message }, index) => (_jsxs("li", { children: [FormContextUtils.isFormLevelErrorPath(path) ? null : _jsxs(_Fragment, { children: [_jsxs("span", { className: "font-medium", children: [formatFieldLabel(path), ":"] }), ' '] }), message] }, `${path}-${index}`))) }), hasMoreErrors && (_jsx("p", { className: "mt-item text-sm opacity-[var(--opacity-hover)]", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'moreErrors', { count: errorsToShow.length - maxErrors }) }))] })] })] }) }));
 }
 FormErrorSummaryComponent.displayName = 'FormErrorSummary';
 export const FormErrorSummary = FormErrorSummaryComponent;

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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","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, schemaContext?.schema),\n    [resourceType, tResourceFieldEdit, schemaContext?.schema]\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"]}
+{"version":3,"file":"FormErrorSummary.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/FormErrorSummary.tsx"],"names":[],"mappings":"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","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';\nimport { FORM_ERROR_SUMMARY_ATTRIBUTE } from './scroll-to-first-error.utils';\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  /*\n   * In wizard mode, a field's error is listed on the step that holds the field. Two errors used to fall through:\n   * a server refusal that names NO field (it belongs to the record, so it is listed on every step, like a cross-field\n   * error), and one on a nested path (`address.city`) when the step registered its parent (`address`), which an exact\n   * match never found. Cross-field errors are always shown: they cannot be attributed to a step.\n   */\n  const isOnThisStep = useMemo(() => {\n    if (!stepFieldNames) return () => true;\n    return (path: string) => stepFieldNames.some((field) => path === field || path.startsWith(`${field}.`));\n  }, [stepFieldNames]);\n\n  const filteredServerErrors = useMemo(\n    () => serverErrors.filter((e) => FormContextUtils.isFormLevelErrorPath(e.path) || isOnThisStep(e.path)),\n    [serverErrors, isOnThisStep],\n  );\n\n  const filteredFieldErrors = useMemo(() => {\n    if (!shouldIncludeFieldErrors) return [];\n    return fieldErrors.filter((e) => isOnThisStep(e.path));\n  }, [fieldErrors, shouldIncludeFieldErrors, isOnThisStep]);\n  \n  const errorsToShow = [...crossFieldErrors, ...filteredServerErrors, ...filteredFieldErrors];\n  \n  const formatFieldLabel = useMemo(\n    () => AutomatedLayoutFrontendUtils.createFieldLabelResolver(resourceType, tResourceFieldEdit, schemaContext?.schema),\n    [resourceType, tResourceFieldEdit, schemaContext?.schema]\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      // Focused by the error scroll when the error belongs to no field (`scroll-to-first-error.utils.ts`).\n      {...{ [FORM_ERROR_SUMMARY_ATTRIBUTE]: '' }}\n      tabIndex={-1}\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                  {/* An error that names no field belongs to the record, so it is listed without a field label. */}\n                  {FormContextUtils.isFormLevelErrorPath(path) ? null : <><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/field-reveal.d.ts

@@ -0,0 +1,41 @@
+/** The DOM event a hidden panel answers by showing itself. Bubbles from the field that must be shown. */
+export declare const REVEAL_FIELD_EVENT = "wildo:reveal-field";
+/**
+ * Asks every container enclosing `element` to show the panel it sits in.
+ *
+ * @returns whether any panel was hidden and is now being shown. The panel appears on a later render, so a caller that
+ *   scrolls or focuses must wait for it ({@link whenRendered}).
+ */
+export declare function requestFieldReveal(element: Element): boolean;
+/**
+ * Runs `callback` once `element` is rendered (it has a layout box), polling one animation frame at a time.
+ *
+ * Gives up after `maxFrames` and runs `callback` anyway: a panel whose owner declined to switch (a controlled tab set
+ * that ignores the request) must not leave the caller waiting, and a scroll that does nothing is no worse than before.
+ */
+export declare function whenRendered(element: Element, callback: () => void, maxFrames?: number): void;
+/**
+ * Listens for reveal requests on behalf of one container.
+ *
+ * @param reveal shows the panel with the given id, and returns `true` when that panel was hidden.
+ * @returns the container's id, to pass to {@link fieldRevealPanelAttributes} for each of its panels.
+ */
+export declare function useFieldRevealRequests(reveal: (panelId: string) => boolean): string;
+/** The attributes that make an element a panel of the container `containerId`, identified by `panelId`. */
+export declare function fieldRevealPanelAttributes(containerId: string, panelId: string): Record<string, string>;
+/**
+ * Whether a container's hidden panels must stay MOUNTED: true inside a form.
+ *
+ * A form field is bound through a `Controller` that unregisters on unmount, and React Hook Form's unregister deletes
+ * the field's value AND its default. So a container that showed one panel at a time by unmounting the others (a tab
+ * not selected, an accordion row closed, a collapsed section, sections past "show more", a step not current) erased
+ * the edits in every panel the person left, and a submit from another panel sent the record without them. Inside a
+ * form those panels stay mounted and are hidden with the `hidden` attribute, and each answers a reveal request
+ * ({@link useFieldRevealRequests}) so the error scroll can show the one holding the first error.
+ *
+ * Outside a form nothing is lost by unmounting, while mounting every panel would load every embedded view at once,
+ * so display layouts keep unmounting. A container an application writes itself, inside a form, needs the same three
+ * things: this hook, {@link useFieldRevealRequests} and {@link fieldRevealPanelAttributes}.
+ */
+export declare function useKeepsHiddenPanelsMounted(): boolean;
+//# sourceMappingURL=field-reveal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-reveal.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/field-reveal.ts"],"names":[],"mappings":"AAoBA,yGAAyG;AACzG,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAUvD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,SAAS,SAAK,GAAG,IAAI,CAYzF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAwBnF;AAED,2GAA2G;AAC3G,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAGrD"}

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

@@ -0,0 +1,108 @@
+/**
+ * Bringing a field that sits in a hidden panel back on screen.
+ *
+ * Inside a form, a section container keeps every panel MOUNTED and hides the ones not on screen (a tab not selected,
+ * an accordion row closed, a step not current), because an unmounted field loses its value. So the field holding the
+ * first error after a failed submit can be in the DOM and invisible: scrolling to it moves nothing and focusing it does
+ * nothing, and the click on Save reads as having done nothing.
+ *
+ * The containers cannot be asked by name — the scroll helper only has the field's element — so the request travels the
+ * DOM instead. {@link requestFieldReveal} dispatches {@link REVEAL_FIELD_EVENT} from the field's element; every
+ * container that hides panels listens through {@link useFieldRevealRequests} and, when the field is inside one of ITS
+ * panels, shows that panel. Containers nest (a tab inside an accordion row), and each one reveals its own level, so the
+ * field ends up visible however deep it is.
+ *
+ * A panel is recognised by the two attributes {@link fieldRevealPanelAttributes} stamps on it: the container's own id
+ * (so a container never claims a nested container's panel) and the panel's id.
+ */
+import { useEffect, useId, useRef } from 'react';
+import { useFormContext } from 'react-hook-form';
+/** The DOM event a hidden panel answers by showing itself. Bubbles from the field that must be shown. */
+export const REVEAL_FIELD_EVENT = 'wildo:reveal-field';
+const REVEAL_CONTAINER_ATTRIBUTE = 'data-reveal-container';
+const REVEAL_PANEL_ATTRIBUTE = 'data-reveal-panel';
+/**
+ * Asks every container enclosing `element` to show the panel it sits in.
+ *
+ * @returns whether any panel was hidden and is now being shown. The panel appears on a later render, so a caller that
+ *   scrolls or focuses must wait for it ({@link whenRendered}).
+ */
+export function requestFieldReveal(element) {
+    const detail = { revealed: false };
+    element.dispatchEvent(new CustomEvent(REVEAL_FIELD_EVENT, { bubbles: true, detail }));
+    return detail.revealed;
+}
+/**
+ * Runs `callback` once `element` is rendered (it has a layout box), polling one animation frame at a time.
+ *
+ * Gives up after `maxFrames` and runs `callback` anyway: a panel whose owner declined to switch (a controlled tab set
+ * that ignores the request) must not leave the caller waiting, and a scroll that does nothing is no worse than before.
+ */
+export function whenRendered(element, callback, maxFrames = 20) {
+    const schedule = typeof requestAnimationFrame === 'function' ? requestAnimationFrame : (step) => setTimeout(step, 16);
+    let frames = 0;
+    const step = () => {
+        if (element.getClientRects().length > 0 || frames >= maxFrames) {
+            callback();
+            return;
+        }
+        frames += 1;
+        schedule(step);
+    };
+    schedule(step);
+}
+/**
+ * Listens for reveal requests on behalf of one container.
+ *
+ * @param reveal shows the panel with the given id, and returns `true` when that panel was hidden.
+ * @returns the container's id, to pass to {@link fieldRevealPanelAttributes} for each of its panels.
+ */
+export function useFieldRevealRequests(reveal) {
+    const containerId = useId();
+    const revealRef = useRef(reveal);
+    useEffect(() => {
+        revealRef.current = reveal;
+    });
+    useEffect(() => {
+        if (typeof document === 'undefined')
+            return undefined;
+        const listener = (event) => {
+            const detail = event.detail;
+            // The NEAREST panel of this container, walking up from the field: a nested container's panels carry their own id.
+            for (let node = event.target instanceof Element ? event.target : null; node; node = node.parentElement) {
+                if (node.getAttribute(REVEAL_CONTAINER_ATTRIBUTE) !== containerId)
+                    continue;
+                const panelId = node.getAttribute(REVEAL_PANEL_ATTRIBUTE);
+                if (panelId !== null && revealRef.current(panelId) && detail)
+                    detail.revealed = true;
+                return;
+            }
+        };
+        document.addEventListener(REVEAL_FIELD_EVENT, listener);
+        return () => document.removeEventListener(REVEAL_FIELD_EVENT, listener);
+    }, [containerId]);
+    return containerId;
+}
+/** The attributes that make an element a panel of the container `containerId`, identified by `panelId`. */
+export function fieldRevealPanelAttributes(containerId, panelId) {
+    return { [REVEAL_CONTAINER_ATTRIBUTE]: containerId, [REVEAL_PANEL_ATTRIBUTE]: panelId };
+}
+/**
+ * Whether a container's hidden panels must stay MOUNTED: true inside a form.
+ *
+ * A form field is bound through a `Controller` that unregisters on unmount, and React Hook Form's unregister deletes
+ * the field's value AND its default. So a container that showed one panel at a time by unmounting the others (a tab
+ * not selected, an accordion row closed, a collapsed section, sections past "show more", a step not current) erased
+ * the edits in every panel the person left, and a submit from another panel sent the record without them. Inside a
+ * form those panels stay mounted and are hidden with the `hidden` attribute, and each answers a reveal request
+ * ({@link useFieldRevealRequests}) so the error scroll can show the one holding the first error.
+ *
+ * Outside a form nothing is lost by unmounting, while mounting every panel would load every embedded view at once,
+ * so display layouts keep unmounting. A container an application writes itself, inside a form, needs the same three
+ * things: this hook, {@link useFieldRevealRequests} and {@link fieldRevealPanelAttributes}.
+ */
+export function useKeepsHiddenPanelsMounted() {
+    // `useFormContext` is typed non-null, but answers null outside a FormProvider.
+    return useFormContext() != null;
+}
+//# sourceMappingURL=field-reveal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-reveal.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/field-reveal.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bringing a field that sits in a hidden panel back on screen.\n *\n * Inside a form, a section container keeps every panel MOUNTED and hides the ones not on screen (a tab not selected,\n * an accordion row closed, a step not current), because an unmounted field loses its value. So the field holding the\n * first error after a failed submit can be in the DOM and invisible: scrolling to it moves nothing and focusing it does\n * nothing, and the click on Save reads as having done nothing.\n *\n * The containers cannot be asked by name — the scroll helper only has the field's element — so the request travels the\n * DOM instead. {@link requestFieldReveal} dispatches {@link REVEAL_FIELD_EVENT} from the field's element; every\n * container that hides panels listens through {@link useFieldRevealRequests} and, when the field is inside one of ITS\n * panels, shows that panel. Containers nest (a tab inside an accordion row), and each one reveals its own level, so the\n * field ends up visible however deep it is.\n *\n * A panel is recognised by the two attributes {@link fieldRevealPanelAttributes} stamps on it: the container's own id\n * (so a container never claims a nested container's panel) and the panel's id.\n */\nimport { useEffect, useId, useRef } from 'react';\nimport { useFormContext, type UseFormReturn } from 'react-hook-form';\n\n/** The DOM event a hidden panel answers by showing itself. Bubbles from the field that must be shown. */\nexport const REVEAL_FIELD_EVENT = 'wildo:reveal-field';\n\nconst REVEAL_CONTAINER_ATTRIBUTE = 'data-reveal-container';\nconst REVEAL_PANEL_ATTRIBUTE = 'data-reveal-panel';\n\ninterface FieldRevealEventDetail {\n  /** Set by any container that had to SHOW a panel, so the caller knows to wait for the next render before scrolling. */\n  revealed: boolean;\n}\n\n/**\n * Asks every container enclosing `element` to show the panel it sits in.\n *\n * @returns whether any panel was hidden and is now being shown. The panel appears on a later render, so a caller that\n *   scrolls or focuses must wait for it ({@link whenRendered}).\n */\nexport function requestFieldReveal(element: Element): boolean {\n  const detail: FieldRevealEventDetail = { revealed: false };\n  element.dispatchEvent(new CustomEvent<FieldRevealEventDetail>(REVEAL_FIELD_EVENT, { bubbles: true, detail }));\n  return detail.revealed;\n}\n\n/**\n * Runs `callback` once `element` is rendered (it has a layout box), polling one animation frame at a time.\n *\n * Gives up after `maxFrames` and runs `callback` anyway: a panel whose owner declined to switch (a controlled tab set\n * that ignores the request) must not leave the caller waiting, and a scroll that does nothing is no worse than before.\n */\nexport function whenRendered(element: Element, callback: () => void, maxFrames = 20): void {\n  const schedule = typeof requestAnimationFrame === 'function' ? requestAnimationFrame : (step: () => void) => setTimeout(step, 16);\n  let frames = 0;\n  const step = (): void => {\n    if (element.getClientRects().length > 0 || frames >= maxFrames) {\n      callback();\n      return;\n    }\n    frames += 1;\n    schedule(step);\n  };\n  schedule(step);\n}\n\n/**\n * Listens for reveal requests on behalf of one container.\n *\n * @param reveal shows the panel with the given id, and returns `true` when that panel was hidden.\n * @returns the container's id, to pass to {@link fieldRevealPanelAttributes} for each of its panels.\n */\nexport function useFieldRevealRequests(reveal: (panelId: string) => boolean): string {\n  const containerId = useId();\n  const revealRef = useRef(reveal);\n  useEffect(() => {\n    revealRef.current = reveal;\n  });\n\n  useEffect(() => {\n    if (typeof document === 'undefined') return undefined;\n    const listener = (event: Event): void => {\n      const detail = (event as CustomEvent<FieldRevealEventDetail>).detail;\n      // The NEAREST panel of this container, walking up from the field: a nested container's panels carry their own id.\n      for (let node = event.target instanceof Element ? event.target : null; node; node = node.parentElement) {\n        if (node.getAttribute(REVEAL_CONTAINER_ATTRIBUTE) !== containerId) continue;\n        const panelId = node.getAttribute(REVEAL_PANEL_ATTRIBUTE);\n        if (panelId !== null && revealRef.current(panelId) && detail) detail.revealed = true;\n        return;\n      }\n    };\n    document.addEventListener(REVEAL_FIELD_EVENT, listener);\n    return () => document.removeEventListener(REVEAL_FIELD_EVENT, listener);\n  }, [containerId]);\n\n  return containerId;\n}\n\n/** The attributes that make an element a panel of the container `containerId`, identified by `panelId`. */\nexport function fieldRevealPanelAttributes(containerId: string, panelId: string): Record<string, string> {\n  return { [REVEAL_CONTAINER_ATTRIBUTE]: containerId, [REVEAL_PANEL_ATTRIBUTE]: panelId };\n}\n\n/**\n * Whether a container's hidden panels must stay MOUNTED: true inside a form.\n *\n * A form field is bound through a `Controller` that unregisters on unmount, and React Hook Form's unregister deletes\n * the field's value AND its default. So a container that showed one panel at a time by unmounting the others (a tab\n * not selected, an accordion row closed, a collapsed section, sections past \"show more\", a step not current) erased\n * the edits in every panel the person left, and a submit from another panel sent the record without them. Inside a\n * form those panels stay mounted and are hidden with the `hidden` attribute, and each answers a reveal request\n * ({@link useFieldRevealRequests}) so the error scroll can show the one holding the first error.\n *\n * Outside a form nothing is lost by unmounting, while mounting every panel would load every embedded view at once,\n * so display layouts keep unmounting. A container an application writes itself, inside a form, needs the same three\n * things: this hook, {@link useFieldRevealRequests} and {@link fieldRevealPanelAttributes}.\n */\nexport function useKeepsHiddenPanelsMounted(): boolean {\n  // `useFormContext` is typed non-null, but answers null outside a FormProvider.\n  return (useFormContext() as UseFormReturn | null) != null;\n}\n\n"]}

package/dist/esm/components/form/validation-errors/form-level-error-recheck.d.ts

@@ -0,0 +1,3 @@
+import type { FieldValues, UseFormReturn } from 'react-hook-form';
+export declare function useFormLevelErrorRecheck<TValues extends FieldValues>(form: UseFormReturn<TValues>): void;
+//# sourceMappingURL=form-level-error-recheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-level-error-recheck.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/form-level-error-recheck.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGlE,wBAAgB,wBAAwB,CAAC,OAAO,SAAS,WAAW,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAUxG"}

package/dist/esm/components/form/validation-errors/form-level-error-recheck.js

@@ -0,0 +1,37 @@
+/**
+ * Clearing a form-level error once the person has fixed it.
+ *
+ * A rule on the whole object (`.refine(fn, { message })` with no `path`) is recorded at {@link FORM_LEVEL_ERROR_PATH}
+ * (`zod-issue-resolver.ts`). React Hook Form re-validates only the field that changed or blurred: it runs the schema
+ * and updates the error AT THAT FIELD'S NAME, so the form-level error, which sits at no field's name, was never
+ * re-read. Fixing the dates that broke "the end must not be before the start" left the message on screen until the
+ * next submit, telling the person the form was still wrong when it no longer was.
+ *
+ * So while a form-level CLIENT error stands, every edit the person makes re-checks it, and it goes away as soon as the
+ * rule holds. Two limits, both deliberate:
+ *
+ * - **It never RAISES one.** With no form-level error standing, nothing runs: a rule across fields is reported on
+ *   submit, not while the person is half-way through filling the fields it compares.
+ * - **Any change of a value counts**, not only typing: a rule fixed by adding an item to a list, or by a control that
+ *   writes its value with `setValue`, is cleared too. Only an update that names no field (the form's own state, as
+ *   the re-check itself publishes) is ignored.
+ * - **A server's refusal is left alone.** The client schema cannot tell whether the server would now accept the
+ *   record, so re-reading the client rule would erase a refusal it knows nothing about. Server errors are cleared by
+ *   the next submit (`useServerErrorInjection`).
+ */
+import { useEffect } from 'react';
+import { FORM_LEVEL_ERROR_PATH, SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from '../form-context.js';
+export function useFormLevelErrorRecheck(form) {
+    useEffect(() => {
+        const subscription = form.watch((_values, { name, type }) => {
+            if (type !== 'change' && name === undefined)
+                return;
+            const standing = form.getFieldState(FORM_LEVEL_ERROR_PATH).error;
+            if (!standing || standing.type === SERVER_ERROR_TYPE || standing.type === UNIQUE_ERROR_TYPE)
+                return;
+            void form.trigger(FORM_LEVEL_ERROR_PATH);
+        });
+        return () => subscription.unsubscribe();
+    }, [form]);
+}
+//# sourceMappingURL=form-level-error-recheck.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-level-error-recheck.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/form-level-error-recheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE9F,MAAM,UAAU,wBAAwB,CAA8B,IAA4B;IAChG,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;YAC1D,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,qBAA8B,CAAC,CAAC,KAAK,CAAC;YAC1E,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAiB,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAiB;gBAAE,OAAO;YACpG,KAAK,IAAI,CAAC,OAAO,CAAC,qBAA8B,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACb,CAAC","sourcesContent":["/**\n * Clearing a form-level error once the person has fixed it.\n *\n * A rule on the whole object (`.refine(fn, { message })` with no `path`) is recorded at {@link FORM_LEVEL_ERROR_PATH}\n * (`zod-issue-resolver.ts`). React Hook Form re-validates only the field that changed or blurred: it runs the schema\n * and updates the error AT THAT FIELD'S NAME, so the form-level error, which sits at no field's name, was never\n * re-read. Fixing the dates that broke \"the end must not be before the start\" left the message on screen until the\n * next submit, telling the person the form was still wrong when it no longer was.\n *\n * So while a form-level CLIENT error stands, every edit the person makes re-checks it, and it goes away as soon as the\n * rule holds. Two limits, both deliberate:\n *\n * - **It never RAISES one.** With no form-level error standing, nothing runs: a rule across fields is reported on\n *   submit, not while the person is half-way through filling the fields it compares.\n * - **Any change of a value counts**, not only typing: a rule fixed by adding an item to a list, or by a control that\n *   writes its value with `setValue`, is cleared too. Only an update that names no field (the form's own state, as\n *   the re-check itself publishes) is ignored.\n * - **A server's refusal is left alone.** The client schema cannot tell whether the server would now accept the\n *   record, so re-reading the client rule would erase a refusal it knows nothing about. Server errors are cleared by\n *   the next submit (`useServerErrorInjection`).\n */\nimport { useEffect } from 'react';\nimport type { FieldValues, UseFormReturn } from 'react-hook-form';\nimport { FORM_LEVEL_ERROR_PATH, SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from '../form-context';\n\nexport function useFormLevelErrorRecheck<TValues extends FieldValues>(form: UseFormReturn<TValues>): void {\n  useEffect(() => {\n    const subscription = form.watch((_values, { name, type }) => {\n      if (type !== 'change' && name === undefined) return;\n      const standing = form.getFieldState(FORM_LEVEL_ERROR_PATH as never).error;\n      if (!standing || standing.type === SERVER_ERROR_TYPE || standing.type === UNIQUE_ERROR_TYPE) return;\n      void form.trigger(FORM_LEVEL_ERROR_PATH as never);\n    });\n    return () => subscription.unsubscribe();\n  }, [form]);\n}\n"]}

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

@@ -20,6 +20,12 @@ declare function isRequiredFieldError(errorMessage: string): boolean;
  * 2. Form has been submitted at least once
  * This prevents showing errors on initial render with invalid defaultValues.
  *
+ * A SERVER error (a refusal the server returned, a uniqueness conflict) is shown whatever the touch state. The gate
+ * exists to hide what the client schema says about values nobody has entered yet, and a server error is never that:
+ * it answers a save, a submit or a uniqueness check somebody started. Gated, a refusal on a field the person never
+ * visited (the server rejecting a value carried from the stored record, a section saved without a form submit) was
+ * recorded and never shown.
+ *
  * @param fieldState - RHF field state containing isTouched and error
  * @param isFormSubmitted - Whether the form has been submitted at least once
  * @param tErrorValidation - Translation function for error messages

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;;;;;;;;;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"}
+{"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;;;;;;;;;;;;;;;;;;;GAmBG;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,CAmDpB;AAED,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,CAAC"}

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

@@ -9,7 +9,7 @@
  * message.
  */
 import { ValidationMode } from '@wildo-ai/zod-decorators';
-import { UNIQUE_ERROR_TYPE } from '../form-context.js';
+import { SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from '../form-context.js';
 const FILE_VALIDATION_ERROR_TYPE = 'file-validation';
 const REQUIRED_FIELD_PATTERN = /received (undefined|null)\b/i;
 const REQUIRED_FIELD_PATTERN_EXTENDED = /expected .+, received (undefined|null)/i;
@@ -25,13 +25,20 @@ function isRequiredFieldError(errorMessage) {
  * 2. Form has been submitted at least once
  * This prevents showing errors on initial render with invalid defaultValues.
  *
+ * A SERVER error (a refusal the server returned, a uniqueness conflict) is shown whatever the touch state. The gate
+ * exists to hide what the client schema says about values nobody has entered yet, and a server error is never that:
+ * it answers a save, a submit or a uniqueness check somebody started. Gated, a refusal on a field the person never
+ * visited (the server rejecting a value carried from the stored record, a section saved without a form submit) was
+ * recorded and never shown.
+ *
  * @param fieldState - RHF field state containing isTouched and error
  * @param isFormSubmitted - Whether the form has been submitted at least once
  * @param tErrorValidation - Translation function for error messages
  * @returns Translated error message or undefined if no error should be shown
  */
 export function getFieldError(fieldState, isFormSubmitted, validationMode, tErrorValidation) {
-    const shouldShowError = fieldState.isTouched || isFormSubmitted || ((validationMode === ValidationMode.ON_CHANGE || validationMode === ValidationMode.ON_TOUCHED) && !!fieldState.isDirty);
+    const isServerError = fieldState.error?.type === SERVER_ERROR_TYPE || fieldState.error?.type === UNIQUE_ERROR_TYPE;
+    const shouldShowError = isServerError || fieldState.isTouched || isFormSubmitted || ((validationMode === ValidationMode.ON_CHANGE || validationMode === ValidationMode.ON_TOUCHED) && !!fieldState.isDirty);
     if (!shouldShowError || !fieldState.error) {
         return undefined;
     }

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;;;;;;;;;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"]}
+{"version":3,"file":"getFieldError.js","sourceRoot":"","sources":["../../../../../../src/components/form/validation-errors/getFieldError.ts"],"names":[],"mappings":"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","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 { SERVER_ERROR_TYPE, 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 * A SERVER error (a refusal the server returned, a uniqueness conflict) is shown whatever the touch state. The gate\n * exists to hide what the client schema says about values nobody has entered yet, and a server error is never that:\n * it answers a save, a submit or a uniqueness check somebody started. Gated, a refusal on a field the person never\n * visited (the server rejecting a value carried from the stored record, a section saved without a form submit) was\n * recorded and never shown.\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 isServerError = fieldState.error?.type === SERVER_ERROR_TYPE || fieldState.error?.type === UNIQUE_ERROR_TYPE;\n  const shouldShowError = isServerError || 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/scroll-to-first-error.utils.d.ts

@@ -22,12 +22,19 @@
  *    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
+ * 3. Ask every section panel enclosing it to show itself ({@link requestFieldReveal}): inside a form, a tab not
+ *    selected, an accordion row closed or a step not current keeps its fields mounted but hidden, and a hidden field
+ *    cannot be scrolled to or focused. When a panel had to be shown, the scroll waits for it to render.
+ * 4. 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';
+/**
+ * The attribute the form error summary carries, so the scroll can reach it when the error belongs to no field.
+ */
+export declare const FORM_ERROR_SUMMARY_ATTRIBUTE = "data-form-error-summary";
 /**
  * Flatten a react-hook-form `FieldErrors` tree into dotted field paths.
  *

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

@@ -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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD;;GAEG;AACH,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE;;;;;;;;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,CA2C/E"}