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

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

@@ -1 +1 @@
-{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../../../../src/components/form/Form.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Form Component\n * \n * Schema-driven form wrapper that uses react-hook-form with `zodIssueResolver`.\n * Provides FormProvider context for child fields.\n * \n * Note: `zodIssueResolver` is the Standard Schema resolver (Zod 4 implements that interface; requires\n * @hookform/resolvers >= 5.0.0) with one difference: it keeps each issue's CODE as the field error's\n * `type` and the issue's fields as `params`, so `getFieldError` can translate through the\n * `errors_validation` catalog instead of showing the schema's English (issue #995).\n */\n\nimport React, { useEffect } from 'react';\nimport { z } from 'zod';\nimport { useForm, FieldErrors, UseFormReturn, DefaultValues } from 'react-hook-form';\nimport { zodIssueResolver } from './validation-errors/zod-issue-resolver';\n\nimport { FormExternalValidationContext, withExternalFieldValidation, type ExternalFieldErrors } from './form-external-validation';\nimport { FormSchemaKind, type ValidationMode } from './form-field-types';\n\nimport { FormSchemaProvider } from './form-context';\nimport { ContentSection } from '~wildo-frontend-lib/components/sections/content-section';\nimport { DEFAULT_VALIDATION_MODE } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.schemas';\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\n/**\n * Direct-children-dependent utilities that can NEVER work on the `<form>`\n * element: all children render inside one `display: contents` fieldset (the\n * disabled-cascade carrier), so the form has exactly one direct child and\n * Tailwind's `> * + *` selectors never reach the rows. A class name is a free\n * string, so this trap cannot be made unbypassable — make it VISIBLE instead\n * with a dev-only, deduped warning (invariant-call-site-enumeration: prefer\n * unbypassable, else visible).\n */\nconst INERT_FORM_CLASS_PATTERN = /(?:^|\\s)(?:[a-z-]+:)*(?:space-[xy]|divide-[xy])(?:-|\\s|$)/;\nconst warnedInertFormClassNames = new Set<string>();\nfunction warnOnInertFormClassName(className: string | undefined): void {\n  if (process.env.NODE_ENV === 'production' || !className) return;\n  if (!INERT_FORM_CLASS_PATTERN.test(className)) return;\n  if (warnedInertFormClassNames.has(className)) return;\n  warnedInertFormClassNames.add(className);\n  // eslint-disable-next-line no-console -- dev-only authoring diagnostic\n  console.warn(\n    `[Form] className \"${className}\" contains a direct-children utility (space-y-*/space-x-*/divide-*) that is structurally inert on the form element — all form children render inside one display:contents fieldset, so these selectors never apply. Own the spacing in the layout template/containers instead.`,\n  );\n}\n\n/**\n * Form methods interface for external access.\n * Curated subset of RHF's UseFormReturn — exposes what callers actually need\n * without leaking the full RHF API.\n */\nexport interface FormMethods {\n  /** Set an error on a specific field */\n  setError: (name: string, error: { type: string; message: string }) => void;\n  /** Clear error on a specific field or all errors */\n  clearErrors: (name?: string | string[]) => void;\n  /** Watch form values for changes */\n  watch: UseFormReturn<any>['watch'];\n  /** Reset form to default values or provided values */\n  reset: UseFormReturn<any>['reset'];\n  /** Get current form values (all fields or a specific field) */\n  getValues: UseFormReturn<any>['getValues'];\n  /** Set a specific field value programmatically */\n  setValue: UseFormReturn<any>['setValue'];\n  /** Trigger validation for specific fields or the entire form */\n  trigger: UseFormReturn<any>['trigger'];\n  /** Submit the form programmatically (e.g., from an external button) */\n  handleSubmit: UseFormReturn<any>['handleSubmit'];\n  /** Reactive form state (isDirty, isSubmitting, isValid, errors, etc.) */\n  formState: UseFormReturn<any>['formState'];\n  /** Get field state (isDirty, isTouched, invalid, error) for a specific field */\n  getFieldState: UseFormReturn<any>['getFieldState'];\n}\n\nexport interface FormProps<TSchema extends z.ZodTypeAny> {\n  /** The main schema (used for context and type inference) */\n  schema: TSchema;\n  /**\n   * Which KIND of schema `schema` is. Decides how field clearability is answered — see\n   * {@link FormSchemaKind}. Resource forms validate a request DTO (the default); a surface that\n   * wraps a single MAIN-schema field must say so, or clearing silently stops working for refined\n   * optional fields on it.\n   */\n  schemaKind?: FormSchemaKind;\n  /** \n   * Optional prepared schema for validation.\n   * When provided, this schema is used for RHF validation instead of the main schema.\n   * Use prepareFormSchema() to create this from the main schema.\n   */\n  validationSchema?: z.ZodTypeAny;\n  defaultValues?: DefaultValues<z.infer<TSchema>>;\n  onSubmit: (data: z.infer<TSchema>) => void | Promise<void>;\n  onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;\n  validationMode?: ValidationMode;\n  children: React.ReactNode;\n  /**\n   * Extra classes for the `<form>` element — BOX-level styling only (width\n   * constraints, grid placement). The form is NOT a spacing stack: all children\n   * render inside one `display: contents` fieldset (the disabled-cascade\n   * carrier), so the form has exactly one direct child and direct-children\n   * utilities (`space-y-*`, `space-x-*`, `divide-*`) are structurally inert\n   * here — Tailwind compiles them to `> * + *`, which never reaches\n   * grandchildren. Vertical rhythm between top-level form rows is owned by the\n   * layout template/containers (`FormLayout`, section containers, template\n   * divs). A dev-only warning fires when an inert utility is passed.\n   */\n  className?: string;\n  disabled?: boolean;\n  id?: string;\n  /** Resource type for i18n field label lookup (used by FormErrorSummary) */\n  resourceType?: string;\n  /**\n   * Callback invoked with form methods when the form is ready.\n   * Use this to get access to setError/clearErrors for setting server-side validation errors.\n   */\n  onFormReady?: (formMethods: FormMethods) => void;\n  /**\n   * When true, shows a browser confirmation dialog when the user tries to leave\n   * the page (tab close, refresh) while the form has unsaved changes (isDirty).\n   * @default false\n   */\n  warnOnUnsavedChanges?: boolean;\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 to nested field components */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship field mutations */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n}\n\nfunction FormComponent<TSchema extends z.ZodTypeAny>({\n  schema,\n  schemaKind,\n  validationSchema,\n  defaultValues,\n  onSubmit,\n  onError,\n  validationMode,\n  children,\n  className,\n  disabled,\n  id,\n  resourceType,\n  onFormReady,\n  warnOnUnsavedChanges = false,\n  validateFieldUrl,\n  resourceId,\n  operationType,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n}: FormProps<TSchema>): React.JSX.Element {\n  // Use centralized DEFAULT_VALIDATION_MODE constant\n  const rhfMode = validationMode ?? DEFAULT_VALIDATION_MODE;\n  \n  // Use prepared validation schema if provided, otherwise use main schema\n  const schemaForValidation = validationSchema ?? schema;\n  \n  const externalErrors = React.useRef<ExternalFieldErrors>(new Map()).current;\n  const form = useForm<z.infer<TSchema>>({\n    // Cast required for Zod 4 + TypeScript compatibility with Standard Schema interface\n    resolver: withExternalFieldValidation(zodIssueResolver(schemaForValidation) as any, externalErrors),\n    defaultValues: defaultValues as any,\n    mode: rhfMode,\n    disabled,\n  });\n  \n  // Dirty guard: warn user before leaving page with unsaved changes\n  useEffect(() => {\n    if (!warnOnUnsavedChanges) return;\n    \n    const handleBeforeUnload = (e: BeforeUnloadEvent) => {\n      if (form.formState.isDirty) {\n        e.preventDefault();\n      }\n    };\n    \n    window.addEventListener('beforeunload', handleBeforeUnload);\n    return () => window.removeEventListener('beforeunload', handleBeforeUnload);\n  }, [warnOnUnsavedChanges, form.formState.isDirty]);\n  \n  // Notify parent when form is ready with form methods.\n  // `form` is a stable reference (useForm returns the same object across renders),\n  // so this effect only meaningfully re-runs when `onFormReady` changes.\n  useEffect(() => {\n    if (onFormReady) {\n      onFormReady({\n        setError: (name, error) => form.setError(name as any, error),\n        clearErrors: (name) => form.clearErrors(name as any),\n        watch: form.watch,\n        reset: form.reset,\n        getValues: form.getValues,\n        setValue: form.setValue as FormMethods['setValue'],\n        trigger: form.trigger,\n        handleSubmit: form.handleSubmit,\n        formState: form.formState,\n        getFieldState: form.getFieldState,\n      });\n    }\n  }, [onFormReady, form]);\n  \n  const handleSubmit = form.handleSubmit(\n    async (data: z.infer<TSchema>) => {\n      await onSubmit(data);\n    },\n    (errors) => {\n      onError?.(errors);\n    }\n  );\n\n  warnOnInertFormClassName(className);\n\n  return (\n    <FormSchemaProvider\n      schema={schema}\n      schemaKind={schemaKind}\n      form={form}\n      resourceType={resourceType}\n      validationMode={validationMode}\n      validateFieldUrl={validateFieldUrl}\n      resourceId={resourceId}\n      operationType={operationType}\n      contextResourceIdentifiers={contextResourceIdentifiers}\n      parentResourcesRequirements={parentResourcesRequirements}\n      navigationZone={navigationZone}\n    >\n      {/* No spacing utilities here on purpose: the ContentSection below is\n          `display: contents`, so the form's only direct child is the fieldset\n          and `space-y-*` on the form can never apply (a hardcoded\n          `space-y-field` sat here dead until 2026-08-19). Spacing between\n          top-level rows is owned by the layout template/containers. */}\n      <FormExternalValidationContext.Provider value={externalErrors}>\n      <form\n        id={id}\n        onSubmit={handleSubmit}\n        className={className}\n        noValidate // Let react-hook-form handle validation\n        data-testid=\"form\"\n      >\n        <ContentSection disabled={disabled} className=\"contents\">\n          {children}\n        </ContentSection>\n      </form>\n      </FormExternalValidationContext.Provider>\n    </FormSchemaProvider>\n  );\n}\n\nFormComponent.displayName = 'Form';\n\nexport const Form: typeof FormComponent & { displayName: string } = FormComponent;"]}
+{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../../../../src/components/form/Form.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Form Component\n * \n * Schema-driven form wrapper that uses react-hook-form with `zodIssueResolver`.\n * Provides FormProvider context for child fields.\n * \n * Note: `zodIssueResolver` is the Standard Schema resolver (Zod 4 implements that interface) with one\n * difference: it keeps each issue's CODE as the field error's\n * `type` and the issue's fields as `params`, so `getFieldError` can translate through the\n * `errors_validation` catalog instead of showing the schema's English (issue #995).\n */\n\nimport React, { useEffect } from 'react';\nimport { z } from 'zod';\nimport { useForm, FieldErrors, UseFormReturn, DefaultValues } from 'react-hook-form';\nimport { zodIssueResolver } from './validation-errors/zod-issue-resolver';\n\nimport { FormExternalValidationContext, withExternalFieldValidation, type ExternalFieldErrors } from './form-external-validation';\nimport { FormSchemaKind, type ValidationMode } from './form-field-types';\n\nimport { FormSchemaProvider } from './form-context';\nimport { ContentSection } from '~wildo-frontend-lib/components/sections/content-section';\nimport { DEFAULT_VALIDATION_MODE } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.schemas';\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\n/**\n * Direct-children-dependent utilities that can NEVER work on the `<form>`\n * element: all children render inside one `display: contents` fieldset (the\n * disabled-cascade carrier), so the form has exactly one direct child and\n * Tailwind's `> * + *` selectors never reach the rows. A class name is a free\n * string, so this trap cannot be made unbypassable — make it VISIBLE instead\n * with a dev-only, deduped warning (invariant-call-site-enumeration: prefer\n * unbypassable, else visible).\n */\nconst INERT_FORM_CLASS_PATTERN = /(?:^|\\s)(?:[a-z-]+:)*(?:space-[xy]|divide-[xy])(?:-|\\s|$)/;\nconst warnedInertFormClassNames = new Set<string>();\nfunction warnOnInertFormClassName(className: string | undefined): void {\n  if (process.env.NODE_ENV === 'production' || !className) return;\n  if (!INERT_FORM_CLASS_PATTERN.test(className)) return;\n  if (warnedInertFormClassNames.has(className)) return;\n  warnedInertFormClassNames.add(className);\n  // eslint-disable-next-line no-console -- dev-only authoring diagnostic\n  console.warn(\n    `[Form] className \"${className}\" contains a direct-children utility (space-y-*/space-x-*/divide-*) that is structurally inert on the form element — all form children render inside one display:contents fieldset, so these selectors never apply. Own the spacing in the layout template/containers instead.`,\n  );\n}\n\n/**\n * Form methods interface for external access.\n * Curated subset of RHF's UseFormReturn — exposes what callers actually need\n * without leaking the full RHF API.\n */\nexport interface FormMethods {\n  /** Set an error on a specific field */\n  setError: (name: string, error: { type: string; message: string }) => void;\n  /** Clear error on a specific field or all errors */\n  clearErrors: (name?: string | string[]) => void;\n  /** Watch form values for changes */\n  watch: UseFormReturn<any>['watch'];\n  /** Reset form to default values or provided values */\n  reset: UseFormReturn<any>['reset'];\n  /** Get current form values (all fields or a specific field) */\n  getValues: UseFormReturn<any>['getValues'];\n  /** Set a specific field value programmatically */\n  setValue: UseFormReturn<any>['setValue'];\n  /** Trigger validation for specific fields or the entire form */\n  trigger: UseFormReturn<any>['trigger'];\n  /** Submit the form programmatically (e.g., from an external button) */\n  handleSubmit: UseFormReturn<any>['handleSubmit'];\n  /** Reactive form state (isDirty, isSubmitting, isValid, errors, etc.) */\n  formState: UseFormReturn<any>['formState'];\n  /** Get field state (isDirty, isTouched, invalid, error) for a specific field */\n  getFieldState: UseFormReturn<any>['getFieldState'];\n}\n\nexport interface FormProps<TSchema extends z.ZodTypeAny> {\n  /** The main schema (used for context and type inference) */\n  schema: TSchema;\n  /**\n   * Which KIND of schema `schema` is. Decides how field clearability is answered — see\n   * {@link FormSchemaKind}. Resource forms validate a request DTO (the default); a surface that\n   * wraps a single MAIN-schema field must say so, or clearing silently stops working for refined\n   * optional fields on it.\n   */\n  schemaKind?: FormSchemaKind;\n  /** \n   * Optional prepared schema for validation.\n   * When provided, this schema is used for RHF validation instead of the main schema.\n   * Use prepareFormSchema() to create this from the main schema.\n   */\n  validationSchema?: z.ZodTypeAny;\n  defaultValues?: DefaultValues<z.infer<TSchema>>;\n  onSubmit: (data: z.infer<TSchema>) => void | Promise<void>;\n  onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;\n  validationMode?: ValidationMode;\n  children: React.ReactNode;\n  /**\n   * Extra classes for the `<form>` element — BOX-level styling only (width\n   * constraints, grid placement). The form is NOT a spacing stack: all children\n   * render inside one `display: contents` fieldset (the disabled-cascade\n   * carrier), so the form has exactly one direct child and direct-children\n   * utilities (`space-y-*`, `space-x-*`, `divide-*`) are structurally inert\n   * here — Tailwind compiles them to `> * + *`, which never reaches\n   * grandchildren. Vertical rhythm between top-level form rows is owned by the\n   * layout template/containers (`FormLayout`, section containers, template\n   * divs). A dev-only warning fires when an inert utility is passed.\n   */\n  className?: string;\n  disabled?: boolean;\n  id?: string;\n  /** Resource type for i18n field label lookup (used by FormErrorSummary) */\n  resourceType?: string;\n  /**\n   * Callback invoked with form methods when the form is ready.\n   * Use this to get access to setError/clearErrors for setting server-side validation errors.\n   */\n  onFormReady?: (formMethods: FormMethods) => void;\n  /**\n   * When true, shows a browser confirmation dialog when the user tries to leave\n   * the page (tab close, refresh) while the form has unsaved changes (isDirty).\n   * @default false\n   */\n  warnOnUnsavedChanges?: boolean;\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 to nested field components */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship field mutations */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n}\n\nfunction FormComponent<TSchema extends z.ZodTypeAny>({\n  schema,\n  schemaKind,\n  validationSchema,\n  defaultValues,\n  onSubmit,\n  onError,\n  validationMode,\n  children,\n  className,\n  disabled,\n  id,\n  resourceType,\n  onFormReady,\n  warnOnUnsavedChanges = false,\n  validateFieldUrl,\n  resourceId,\n  operationType,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n}: FormProps<TSchema>): React.JSX.Element {\n  // Use centralized DEFAULT_VALIDATION_MODE constant\n  const rhfMode = validationMode ?? DEFAULT_VALIDATION_MODE;\n  \n  // Use prepared validation schema if provided, otherwise use main schema\n  const schemaForValidation = validationSchema ?? schema;\n  \n  const externalErrors = React.useRef<ExternalFieldErrors>(new Map()).current;\n  const form = useForm<z.infer<TSchema>>({\n    // Cast required for Zod 4 + TypeScript compatibility with Standard Schema interface\n    resolver: withExternalFieldValidation(zodIssueResolver(schemaForValidation) as any, externalErrors),\n    defaultValues: defaultValues as any,\n    mode: rhfMode,\n    disabled,\n  });\n  \n  // Dirty guard: warn user before leaving page with unsaved changes\n  useEffect(() => {\n    if (!warnOnUnsavedChanges) return;\n    \n    const handleBeforeUnload = (e: BeforeUnloadEvent) => {\n      if (form.formState.isDirty) {\n        e.preventDefault();\n      }\n    };\n    \n    window.addEventListener('beforeunload', handleBeforeUnload);\n    return () => window.removeEventListener('beforeunload', handleBeforeUnload);\n  }, [warnOnUnsavedChanges, form.formState.isDirty]);\n  \n  // Notify parent when form is ready with form methods.\n  // `form` is a stable reference (useForm returns the same object across renders),\n  // so this effect only meaningfully re-runs when `onFormReady` changes.\n  useEffect(() => {\n    if (onFormReady) {\n      onFormReady({\n        setError: (name, error) => form.setError(name as any, error),\n        clearErrors: (name) => form.clearErrors(name as any),\n        watch: form.watch,\n        reset: form.reset,\n        getValues: form.getValues,\n        setValue: form.setValue as FormMethods['setValue'],\n        trigger: form.trigger,\n        handleSubmit: form.handleSubmit,\n        formState: form.formState,\n        getFieldState: form.getFieldState,\n      });\n    }\n  }, [onFormReady, form]);\n  \n  const handleSubmit = form.handleSubmit(\n    async (data: z.infer<TSchema>) => {\n      await onSubmit(data);\n    },\n    (errors) => {\n      onError?.(errors);\n    }\n  );\n\n  warnOnInertFormClassName(className);\n\n  return (\n    <FormSchemaProvider\n      schema={schema}\n      schemaKind={schemaKind}\n      form={form}\n      resourceType={resourceType}\n      validationMode={validationMode}\n      validateFieldUrl={validateFieldUrl}\n      resourceId={resourceId}\n      operationType={operationType}\n      contextResourceIdentifiers={contextResourceIdentifiers}\n      parentResourcesRequirements={parentResourcesRequirements}\n      navigationZone={navigationZone}\n    >\n      {/* No spacing utilities here on purpose: the ContentSection below is\n          `display: contents`, so the form's only direct child is the fieldset\n          and `space-y-*` on the form can never apply (a hardcoded\n          `space-y-field` sat here dead until 2026-08-19). Spacing between\n          top-level rows is owned by the layout template/containers. */}\n      <FormExternalValidationContext.Provider value={externalErrors}>\n      <form\n        id={id}\n        onSubmit={handleSubmit}\n        className={className}\n        noValidate // Let react-hook-form handle validation\n        data-testid=\"form\"\n      >\n        <ContentSection disabled={disabled} className=\"contents\">\n          {children}\n        </ContentSection>\n      </form>\n      </FormExternalValidationContext.Provider>\n    </FormSchemaProvider>\n  );\n}\n\nFormComponent.displayName = 'Form';\n\nexport const Form: typeof FormComponent & { displayName: string } = FormComponent;"]}

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

@@ -7,7 +7,7 @@
  */
 import React from 'react';
 import { z } from 'zod';
-import { ArrayObjectItemLayout, type SoloSectionMode } from '@wildo-ai/zod-decorators';
+import { ArrayObjectItemLayout, EditChromeMode, type SoloSectionMode } from '@wildo-ai/zod-decorators';
 export interface AutomatedArrayFieldProps {
     name: string;
     schema: z.ZodTypeAny;
@@ -23,15 +23,40 @@ export interface AutomatedArrayFieldProps {
     /**
      * Appearance of the array's own section frame (the legend + item-list
      * container). Threaded to the `ContentSection` the array renders. Defaults to
-     * `SectionMode.DEFAULT`. Set per-placement from `DisplayFieldArray` /
+     * `SectionMode.GHOST`. Set per-placement from `DisplayFieldArray` /
      * `FormFieldArray`.
      */
     sectionAppearance?: SoloSectionMode;
+    /**
+     * The row frame the HOST surface places this array in, for a host that is not a form and so provides no
+     * `FormChromeProvider` — the read pane's inline editor. A settings-row read pane renders every other field
+     * as a row, and without this the array fell back to a section with its own heading between them (measured
+     * on the SSO policy's emergency-access tab). The field's own decorator still wins; this outranks the form
+     * and section context, which a host that passes it does not have.
+     */
+    chromeMode?: EditChromeMode;
     /**
      * Per-placement override of the item framing (`CARD` framed cards vs compact
      * `ROW`). Wins over the schema's `arrayUI({ objectItemLayout })` default.
      */
     objectItemLayout?: ArrayObjectItemLayout;
+    /**
+     * Words for an enum array's options, keyed by value — the dictionary `FormField` resolved for this field.
+     * Without it the checkbox group rendered each option as its raw value (`in_app`) while the application's
+     * label tree held its word ("In-app"). An option with no word shows its value, so a gap stays visible.
+     */
+    enumLabels?: Record<string, string>;
+    /**
+     * The values an array of STRINGS may hold when its vocabulary is decided at RUNTIME rather than by the
+     * schema — `FormField`'s `allowedValues`, forwarded. An organization OAuth client's `autonomousAgentRefs`
+     * must name agents the APPLICATION declares (#1812), which the engine's schema cannot carry as an enum.
+     *
+     * When present, a string-element array renders as the same one multiple-choice control an enum array does,
+     * over exactly these values, so the same value cannot be chosen twice and nothing can be typed that the
+     * backend will refuse. Labels come from `enumLabels`, else the value itself. An empty list still renders the
+     * choice control, with nothing to pick, rather than falling back to a free-text list.
+     */
+    allowedValues?: readonly string[];
 }
 /**
  * Leading-gutter width for a ROW array that supplies a custom per-item TEMPLATE
@@ -43,7 +68,7 @@ export interface AutomatedArrayFieldProps {
  * `<div className={ARRAY_ROW_TEMPLATE_GUTTER_CLASS + ' shrink-0 flex items-center'}>`.
  */
 export declare const ARRAY_ROW_TEMPLATE_GUTTER_CLASS = "w-7";
-declare function AutomatedArrayFieldComponent({ name, schema, label, description, disabled, className, renderField, addLabel: addLabelProp, itemLabel: itemLabelProp, reorderable: reorderableProp, sectionAppearance, objectItemLayout: objectItemLayoutOverride, }: AutomatedArrayFieldProps): React.JSX.Element | null;
+declare function AutomatedArrayFieldComponent({ name, schema, label, description, disabled, className, renderField, addLabel: addLabelProp, itemLabel: itemLabelProp, reorderable: reorderableProp, sectionAppearance, chromeMode, objectItemLayout: objectItemLayoutOverride, enumLabels, allowedValues, }: AutomatedArrayFieldProps): React.JSX.Element | null;
 declare namespace AutomatedArrayFieldComponent {
     var displayName: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"AutomatedArrayField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutomatedArrayField.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAA4D,MAAM,OAAO,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuCxB,OAAO,EAAmH,qBAAqB,EAAuF,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAS7R,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAiMD;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,QAAQ,CAAC;AAucrD,iBAAS,4BAA4B,CAAC,EACpC,IAAI,EACJ,MAAM,EACN,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,eAAsB,EACnC,iBAAiB,EACjB,gBAAgB,EAAE,wBAAwB,GAC3C,EAAE,wBAAwB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAsfrD;kBAngBQ,4BAA4B;;;AAugBrC,eAAO,MAAM,mBAAmB,EAAE,OAAO,4BAA4B,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAiC,CAAC"}
+{"version":3,"file":"AutomatedArrayField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutomatedArrayField.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAA4D,MAAM,OAAO,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuCxB,OAAO,EAAkI,qBAAqB,EAAuF,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAS5T,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAiMD;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,QAAQ,CAAC;AAucrD,iBAAS,4BAA4B,CAAC,EACpC,IAAI,EACJ,MAAM,EACN,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,eAAsB,EACnC,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAAE,wBAAwB,EAC1C,UAAU,EACV,aAAa,GACd,EAAE,wBAAwB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAyjBrD;kBAzkBQ,4BAA4B;;;AA6kBrC,eAAO,MAAM,mBAAmB,EAAE,OAAO,4BAA4B,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAiC,CAAC"}

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

@@ -25,7 +25,7 @@ import { useUnstartedFieldVisit } from '../validation-errors/unstarted-field-vis
 import { useOptionalFormTemplateContext } from './FormTemplateContext.js';
 import { InputRoot } from '../controls/input.js';
 import { getFieldError } from '../validation-errors/getFieldError.js';
-import { getArrayConstraints, getArrayItemSchema, getSchemaType, getArrayUI, getObjectShape, getObjectKeys, ArrayAddMode, ArrayObjectItemLayout, FieldSchemaType, AutosaveTrigger, ValidationMode, getFieldUIEditConfig, SectionMode } from '@wildo-ai/zod-decorators';
+import { getArrayConstraints, getArrayItemSchema, getEnumValues, getSchemaType, getArrayUI, getObjectShape, getObjectKeys, ArrayAddMode, ArrayObjectItemLayout, FieldSchemaType, AutosaveTrigger, ValidationMode, getFieldUIEditConfig, SectionMode, EditChromeMode } from '@wildo-ai/zod-decorators';
 import { AutomatedLayoutFrontendUtils } from '../../../core/automated-layout/automated-layout.frontend.utils.js';
 import { FrontendComponentType, UIBehavior, TypographyVariant, ButtonSize } from '@wildo-ai/presets-components-models';
 import { useI18n } from '../../../core/i18n/useI18n.js';
@@ -195,7 +195,7 @@ function ArrayQuickAddRow({ primaryField, itemSchema, onAdd, disabled, addLabel,
             }
         }, children: [leadingGutterClassName && _jsx("span", { "aria-hidden": "true", className: cn('shrink-0', leadingGutterClassName) }), _jsx(InputRoot, { type: isNumeric ? 'number' : 'text', value: rawValue, onChange: (e) => setRawValue(e.target.value), placeholder: placeholder ?? addLabel, disabled: disabled, wrapperClassName: "flex-1", "aria-label": addLabel }), _jsx(Button, { type: "button", variant: ButtonVariants_Variant.OUTLINE, onClick: commit, disabled: !canCommit, "aria-label": addLabel, children: renderIcon(StandardIconReference.PLUS, { size: IconSize.SM }) })] }));
 }
-function AutomatedArrayFieldComponent({ name, schema, label, description, disabled, className, renderField, addLabel: addLabelProp, itemLabel: itemLabelProp, reorderable: reorderableProp = true, sectionAppearance, objectItemLayout: objectItemLayoutOverride, }) {
+function AutomatedArrayFieldComponent({ name, schema, label, description, disabled, className, renderField, addLabel: addLabelProp, itemLabel: itemLabelProp, reorderable: reorderableProp = true, sectionAppearance, chromeMode, objectItemLayout: objectItemLayoutOverride, enumLabels, allowedValues, }) {
     const { control, getFieldState, getValues, formState, trigger } = useFormContext();
     /*
      * The two branches below (multi-select combobox, checkbox group) hand their control RHF's own
@@ -214,7 +214,7 @@ function AutomatedArrayFieldComponent({ name, schema, label, description, disabl
     const { formChromeMode, sectionChromeMode } = useFormChromeContext();
     const surfacePolicy = useSurfacePolicy();
     const fieldEditConfig = getFieldUIEditConfig(schema);
-    const resolvedChromeMode = fieldEditConfig?.chromeMode ?? sectionChromeMode ?? formChromeMode ?? resolveSurfaceFormChromeMode(surfacePolicy.autoRender?.autoFieldChrome);
+    const resolvedChromeMode = fieldEditConfig?.chromeMode ?? chromeMode ?? sectionChromeMode ?? formChromeMode ?? resolveSurfaceFormChromeMode(surfacePolicy.autoRender?.autoFieldChrome);
     const resolvedLabelPlacement = resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement);
     const resolvedControlSize = resolveSurfaceAutoFieldDensity(surfacePolicy.autoRender?.autoFieldDensity);
     const hideInlineErrorForPolicy = surfacePolicy.autoRender?.autoErrorPlacement === 'summary-at-surface-top';
@@ -256,8 +256,13 @@ function AutomatedArrayFieldComponent({ name, schema, label, description, disabl
      * add-a-row list in which the same value could be chosen twice. WHICH multiple control to use is
      * now `EnumMultipleEditMode`'s question, answered inside `FormFieldEnum`; this only asks whether
      * the field is an array of a closed vocabulary.
+     *
+     * A runtime vocabulary (`allowedValues`) closes a STRING array exactly as an enum closes one, so it takes the
+     * same one-control path. Only strings: the values are strings, and offering them for an array of numbers or
+     * objects would write a value the element schema refuses.
      */
-    const isEnumArray = itemSchema !== undefined && getSchemaType(itemSchema) === FieldSchemaType.ENUM;
+    const isRuntimeVocabularyArray = allowedValues !== undefined && itemSchemaType === FieldSchemaType.STRING;
+    const isEnumArray = itemSchemaType === FieldSchemaType.ENUM || isRuntimeVocabularyArray;
     // Read sortable config from arrayUI.edit
     const arrayEditUI = getArrayUI(schema)?.edit;
     // Object-array item framing (card vs compact row). Governs both this edit
@@ -388,7 +393,12 @@ function AutomatedArrayFieldComponent({ name, schema, label, description, disabl
      */
     if (isEnumArray) {
         const multiValidationMode = fieldEditConfig?.validationMode ?? ValidationMode.ON_BLUR;
-        return (_jsx(Controller, { name: name, control: control, shouldUnregister: true, render: ({ field, fieldState }) => (_jsx(FormFieldChrome, { mode: resolvedChromeMode, label: label, description: description, error: getFieldError(fieldState, formState.isSubmitted, multiValidationMode, tErrorValidation), labelPlacement: resolvedLabelPlacement, hideError: hideInlineErrorForPolicy, saveState: autosaveContext?.getFieldState(name), saveErrorMessage: autosaveContext?.getFieldStateInfo(name).lastError, onRetrySave: autosaveContext ? () => autosaveContext.retryFieldSave(name) : undefined, fieldName: name, disabled: disabled, className: className, children: _jsx(FormFieldEnum, { multiple: true, schema: schema, name: name, disabled: disabled, value: Array.isArray(field.value) ? field.value : [], onChange: (value) => {
+        const enumOptions = isRuntimeVocabularyArray
+            ? allowedValues.map((value) => ({ value, label: enumLabels?.[value] ?? value }))
+            : enumLabels
+                ? getEnumValues(itemSchema).map((value) => ({ value, label: enumLabels[value] ?? value }))
+                : undefined;
+        return (_jsx(Controller, { name: name, control: control, shouldUnregister: true, render: ({ field, fieldState }) => (_jsx(FormFieldChrome, { mode: resolvedChromeMode, label: label, description: description, error: getFieldError(fieldState, formState.isSubmitted, multiValidationMode, tErrorValidation), labelPlacement: resolvedLabelPlacement, hideError: hideInlineErrorForPolicy, saveState: autosaveContext?.getFieldState(name), saveErrorMessage: autosaveContext?.getFieldStateInfo(name).lastError, onRetrySave: autosaveContext ? () => autosaveContext.retryFieldSave(name) : undefined, fieldName: name, disabled: disabled, className: className, children: _jsx(FormFieldEnum, { multiple: true, schema: schema, options: enumOptions, name: name, disabled: disabled, value: Array.isArray(field.value) ? field.value : [], onChange: (value) => {
                         arrayFieldVisit.noteInputReceived();
                         field.onChange(value);
                         autosaveContext?.triggerSave(name, value, AutosaveTrigger.DEBOUNCE);
@@ -403,7 +413,8 @@ function AutomatedArrayFieldComponent({ name, schema, label, description, disabl
     // conflict, resource deleted) was completely invisible: the optimistic rows
     // kept rendering "saved" state while nothing persisted. Surface the same
     // `AutosaveIndicator` (spinner / check / error + Retry) beside the section
-    // legend, wired to `retryFieldSave` so the error state carries its retry
+    // legend — or, in a settings row, in the row's control column above the
+    // list — wired to `retryFieldSave` so the error state carries its retry
     // affordance exactly like scalar fields. Not hooks — safe below the early
     // returns (the two Controller variants above thread the same state through
     // their `FormFieldChrome` saveState props instead).
@@ -442,6 +453,31 @@ function AutomatedArrayFieldComponent({ name, schema, label, description, disabl
         // Object or nested array items
         return (_jsx(SortableObjectItem, { id: field.id, fieldName: fieldName, fieldLabel: fieldLabel, layout: objectItemLayout, primaryFieldName: itemPrimaryField.name, itemSchema: itemSchema, disabled: disabled, canRemove: canRemove, isValidating: isValidating, reorderable: reorderable, showUpDownIcons: showUpDownIcons, isFirst: index === 0, isLast: index === fields.length - 1, dragHandleAriaLabel: dragAriaLabel, moveUpAriaLabel: moveUpLabel, moveDownAriaLabel: moveDownLabel, removeAriaLabel: removeLabel, renderField: renderField, onRemove: handleRemove, onMoveUp: handleMoveUp, onMoveDown: handleMoveDown, index: index, renderIcon: renderIcon }, field.id));
     });
+    // The array's own list content — the array-level error, the items, the add row, the empty line —
+    // shared by both frames below.
+    const listContent = (_jsxs(_Fragment, { children: [shouldShowArrayError && (_jsx("p", { id: `${name}-error`, className: "text-sm text-destructive mt-item-xs", role: "alert", children: arrayError })), _jsxs(ContentSectionGroup, { className: cn(objectItemLayout === ArrayObjectItemLayout.ROW ? undefined : 'space-y-field'), style: objectItemLayout === ArrayObjectItemLayout.ROW ? { rowGap: 'var(--spacing-element)' } : undefined, children: [_jsx(DndContext, { sensors: sensors, collisionDetection: closestCenter, onDragEnd: handleDragEnd, children: _jsx(SortableContext, { items: sortableIds, strategy: verticalListSortingStrategy, children: renderItems() }) }), canAdd && quickAddPrimaryField ? (_jsx(ArrayQuickAddRow, { primaryField: quickAddPrimaryField, itemSchema: itemSchema, onAdd: handleQuickAdd, disabled: disabled || isValidating, addLabel: addLabel, 
+                        // ROW object arrays: reserve the same leading gutter the item rows
+                        // use for their leading control, so the staging input aligns to one
+                        // column. A custom item template leads with a tighter (checkbox)
+                        // gutter than the default Switch gutter.
+                        leadingGutterClassName: objectItemLayout === ArrayObjectItemLayout.ROW && !isPrimitive
+                            ? (renderField ? ARRAY_ROW_TEMPLATE_GUTTER_CLASS : ROW_GUTTER_WIDTH_CLASS)
+                            : undefined })) : canAdd ? (_jsxs(Button, { type: "button", variant: ButtonVariants_Variant.OUTLINE, onClick: handleAdd, disabled: disabled || isValidating, className: "w-full", children: [renderIcon(StandardIconReference.PLUS, { size: IconSize.SM, className: "me-element" }), addLabel] })) : null, fields.length === 0 && (disabled || !canAdd) && (_jsx("p", { className: cn(descriptionRecipe.base, "text-center py-card"), children: emptyMessage }))] })] }));
+    /*
+     * IN A SETTINGS ROW, the array IS one row of the list. A settings surface (`SETTINGS_ROW` chrome) is a
+     * divided list of label-and-control rows, and an array used to break out of it: a frameless section with
+     * its own heading and description above the list, so on the SSO policy's emergency-access tab the
+     * break-glass list read as a separate block between rows (measured 2026-09-28). It now takes the row's
+     * STACKED shape (`wideControl`): label and description on the row's inline-start side, the list full-width
+     * beneath, the row's rhythm and hairline divider kept. Only the default frame does this — a caller that
+     * asked for a CARD or COLLAPSIBLE section (`sectionAppearance`) gets the section it asked for.
+     */
+    if (resolvedChromeMode === EditChromeMode.SETTINGS_ROW && sectionAppearance === undefined) {
+        return (_jsx(FormFieldChrome, { mode: EditChromeMode.SETTINGS_ROW, label: label, description: description, labelPlacement: resolvedLabelPlacement, fieldName: name, disabled: disabled, className: className, 
+            // The row is marked invalid like any other; the message itself stays inside the list, where
+            // `listContent` already renders it, so the chrome must not print it a second time.
+            error: arrayError, hideError: true, wideControl: true, children: _jsxs("div", { id: `field-${name}`, role: "group", "aria-labelledby": label ? `field-${name}-label` : undefined, className: "flex flex-col", style: { rowGap: 'var(--spacing-element)' }, "data-testid": `field-array-${name}`, "aria-describedby": shouldShowArrayError ? `${name}-error` : undefined, children: [arrayAutosaveIndicator, listContent] }) }));
+    }
     return (_jsxs(ContentSection
     // Arrays default to a QUIET, frameless GHOST section (legend + list, no
     // card border) — the framework baseline for "an array is just a labelled
@@ -454,14 +490,7 @@ function AutomatedArrayFieldComponent({ name, schema, label, description, disabl
         // list here". Callers opt into CARD / COLLAPSIBLE to containerize. Applied
         // at this consumer so EVERY array (wrapper-authored or a direct
         // FormField/DisplayField) shares the default, not only the wrappers.
-        appearance: sectionAppearance ?? SectionMode.GHOST, disabled: disabled, className: cn(className, arrayError && 'border-destructive'), "data-field": name, "data-testid": `field-array-${name}`, "aria-invalid": !!arrayError, "aria-describedby": shouldShowArrayError ? `${name}-error` : undefined, children: [_jsxs(ContentSectionLegend, { children: [label, arrayAutosaveIndicator] }), description && _jsx(ContentSectionDescription, { children: description }), shouldShowArrayError && (_jsx("p", { id: `${name}-error`, className: "text-sm text-destructive mt-item-xs", role: "alert", children: arrayError })), _jsxs(ContentSectionGroup, { className: cn(objectItemLayout === ArrayObjectItemLayout.ROW ? undefined : 'space-y-field'), style: objectItemLayout === ArrayObjectItemLayout.ROW ? { rowGap: 'var(--spacing-element)' } : undefined, children: [_jsx(DndContext, { sensors: sensors, collisionDetection: closestCenter, onDragEnd: handleDragEnd, children: _jsx(SortableContext, { items: sortableIds, strategy: verticalListSortingStrategy, children: renderItems() }) }), canAdd && quickAddPrimaryField ? (_jsx(ArrayQuickAddRow, { primaryField: quickAddPrimaryField, itemSchema: itemSchema, onAdd: handleQuickAdd, disabled: disabled || isValidating, addLabel: addLabel, 
-                        // ROW object arrays: reserve the same leading gutter the item rows
-                        // use for their leading control, so the staging input aligns to one
-                        // column. A custom item template leads with a tighter (checkbox)
-                        // gutter than the default Switch gutter.
-                        leadingGutterClassName: objectItemLayout === ArrayObjectItemLayout.ROW && !isPrimitive
-                            ? (renderField ? ARRAY_ROW_TEMPLATE_GUTTER_CLASS : ROW_GUTTER_WIDTH_CLASS)
-                            : undefined })) : canAdd ? (_jsxs(Button, { type: "button", variant: ButtonVariants_Variant.OUTLINE, onClick: handleAdd, disabled: disabled || isValidating, className: "w-full", children: [renderIcon(StandardIconReference.PLUS, { size: IconSize.SM, className: "me-element" }), addLabel] })) : null, fields.length === 0 && (_jsx("p", { className: cn(descriptionRecipe.base, "text-center py-card"), children: emptyMessage }))] })] }));
+        appearance: sectionAppearance ?? SectionMode.GHOST, disabled: disabled, className: cn(className, arrayError && 'border-destructive'), "data-field": name, "data-testid": `field-array-${name}`, "aria-invalid": !!arrayError, "aria-describedby": shouldShowArrayError ? `${name}-error` : undefined, children: [_jsxs(ContentSectionLegend, { children: [label, arrayAutosaveIndicator] }), description && _jsx(ContentSectionDescription, { children: description }), listContent] }));
 }
 AutomatedArrayFieldComponent.displayName = 'AutomatedArrayField';
 export const AutomatedArrayField = AutomatedArrayFieldComponent;