@elabs-ai/components-ui 4.1.0 → 5.0.0

package/dist/chunk-BN4CKDFU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/schema-form/schema-form.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * SchemaForm — a spec-driven configuration-form renderer (issue #22).\n *\n * A product describes a form (connector settings, environment variables, an\n * auth method picker) as data; SchemaForm renders it; the app receives\n * structured `{ formName, values }` on submit. This is the GENERAL, app-UI\n * sibling of `@elabs-ai/components-ai`'s chat-scoped `MessageForm` — see\n * `schema-form-spec.ts` for why the two stay separate schemas rather than one\n * generalized union.\n *\n * Design bar (mirrors MessageForm/AutoChart/ChangeReview):\n * - Spec-driven, zod-validated. The spec author never chooses look.\n * - Never throws on bad input. A malformed spec → `SchemaFormFallback`.\n * - Compound + lifted state, controlled AND uncontrolled: `SchemaFormProvider`\n *   owns the values; the parts read a context.\n * - Tokens only; keyboard-operable; inline errors; focus the first error on\n *   submit; a submitted form renders inert with its values visible.\n * - Submit control is NEVER natively `disabled` while transiently blocked\n *   (submitting) — `aria-disabled` + a click/submit handler guard, so a\n *   keyboard user is never dropped from the focus order right after they\n *   used it (interaction-guidelines.md). An explicit, caller-set `disabled`\n *   (the whole form is read-only) stays native — that is a deliberate,\n *   durable removal from the tab order, not a transient auto-flip.\n *\n * Composes `@elabs-ai/components-ui` inputs (`ListEditor`, `KeyValueEditor`,\n * `FileUpload`, `AdvancedGroup`, `Tabs`) — it does NOT re-invent field\n * primitives.\n *\n * Compound structure (named exports, the Card/CardHeader convention):\n *   <SchemaFormProvider>   — lifted state (values + errors + actions)\n *     <SchemaFormRoot>     — the <form> element (never nest inside another form)\n *       <SchemaFormFields> — every field, or place <SchemaFormField> yourself\n *       <SchemaFormTestAction> — OPT-IN: a form/group-level \"Test connection\"\n *                                 affordance, independent of field validity,\n *                                 never gating submit (not in the default\n *                                 `SchemaForm` composition — place it yourself)\n *       <SchemaFormSubmit> — submit button / submitting spinner / submitted note\n *\n * `fromJsonSchema()` (`from-json-schema.ts`) is a separate, narrow adapter\n * that maps a documented JSON Schema subset onto this module's `FieldSpec`\n * vocabulary — see that file's doc comment for exactly what it supports.\n */\n\nimport {\n  createContext,\n  forwardRef,\n  memo,\n  use,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type FormEvent,\n  type HTMLAttributes,\n  type MouseEvent,\n  type ReactNode,\n} from \"react\";\nimport { Check } from \"lucide-react\";\nimport { cn } from \"../../lib/cn\";\nimport { useLocale } from \"../locale-provider\";\nimport { Badge } from \"../badge\";\nimport { Button } from \"../button\";\nimport { Checkbox } from \"../checkbox\";\nimport { Input } from \"../input\";\nimport { Label } from \"../label\";\nimport { NumberInput } from \"../number-input\";\nimport { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from \"../select\";\nimport { Skeleton } from \"../skeleton\";\nimport { Spinner } from \"../spinner\";\nimport { StatusBadge } from \"../status-badge\";\nimport { Textarea } from \"../textarea\";\nimport { ListEditor } from \"../list-editor\";\nimport { KeyValueEditor, type KeyValueRow } from \"../key-value-editor\";\nimport {\n  FileUpload,\n  FileUploadDropzone,\n  FileUploadList,\n  FileUploadItem,\n  useFileUpload,\n} from \"../file-upload\";\nimport { AdvancedGroup } from \"../advanced-group\";\nimport { Tabs, TabsList, TabsTrigger, TabsContent } from \"../tabs\";\nimport { ChevronRight } from \"lucide-react\";\nimport { Collapsible, CollapsibleContent, CollapsibleTrigger } from \"../collapsible\";\nimport { Descriptions, DescriptionsItem } from \"../descriptions\";\n\nimport {\n  checkFileIssue,\n  fieldLabel,\n  normalizeFormSpec,\n  optionLabel,\n  optionValue,\n  type FieldSpec,\n  type FormSpec,\n  type FormSubmitState,\n  type FormValue,\n  type FormValues,\n  type GroupFieldSpec,\n  type GroupItemSpec,\n  type NormalizedFormSpec,\n} from \"./schema-form-spec\";\nimport {\n  SchemaFormStore,\n  useBranchHasError,\n  useEffectiveValues,\n  useFieldSnapshot,\n  useSchemaFormMeta,\n  useVisibleFieldNames,\n  type SchemaFormStoreProps,\n} from \"./schema-form-store\";\n\n// ─── Context (carries only the STABLE store instance — see schema-form-store.ts) ──\n\nconst SchemaFormStoreContext = createContext<SchemaFormStore | null>(null);\n\nfunction useSchemaFormStore(): SchemaFormStore {\n  const store = use(SchemaFormStoreContext);\n  if (!store) {\n    throw new Error(\"SchemaForm sub-components must be rendered inside <SchemaFormProvider>.\");\n  }\n  return store;\n}\n\n/** Stable DOM id for a field's primary control (used for label + focus). */\nfunction controlId(formId: string, name: string): string {\n  return `${formId}-field-${name}`;\n}\nfunction descId(formId: string, name: string): string {\n  return `${formId}-desc-${name}`;\n}\nfunction errorId(formId: string, name: string): string {\n  return `${formId}-error-${name}`;\n}\n\n// ─── Provider ───────────────────────────────────────────────────────────────\n\nexport interface SchemaFormProviderProps {\n  /** A validated/normalized spec (a plain `FormSpec` also satisfies this). */\n  spec: NormalizedFormSpec;\n  /**\n   * Controlled values. When provided the component is controlled and\n   * `onChange` is the only way to update state.\n   */\n  values?: FormValues;\n  /** Called with the next full values object on any field change. */\n  onChange?: (values: FormValues) => void;\n  /** Called with `{ formName, values }` when a valid form is submitted. */\n  onSubmit?: (state: FormSubmitState) => void;\n  /** Disable every control (form is read-only). A deliberate, durable state. */\n  disabled?: boolean;\n  /** Terminal submitted state: controls are inert, values visible, no submit. */\n  submitted?: boolean;\n  /** In-flight submit: controls transiently blocked, submit shows a spinner. */\n  submitting?: boolean;\n  /** No fields to render yet (e.g. the spec is still being fetched) → skeleton. */\n  loading?: boolean;\n  /** A terminal, form-level submission error rendered above the submit control. */\n  error?: ReactNode;\n  children: ReactNode;\n}\n\n/**\n * Lifts the form values. Controlled (pass `values`) or uncontrolled.\n * Derives `isControlled = values !== undefined` and never flips modes.\n */\nexport function SchemaFormProvider({\n  spec,\n  values: valuesProp,\n  onChange,\n  onSubmit,\n  disabled = false,\n  submitted = false,\n  submitting = false,\n  loading = false,\n  error = null,\n  children,\n}: SchemaFormProviderProps) {\n  const formId = useId();\n\n  const storeProps: SchemaFormStoreProps = {\n    spec,\n    valuesProp,\n    onChange,\n    onSubmit,\n    disabled,\n    submitted,\n    submitting,\n    loading,\n    error,\n  };\n  // Created once (lazy initializer) and then kept in sync on every render via\n  // `syncProps` below — see schema-form-store.ts's module doc comment for why\n  // the store, not React context, is what field-level readers subscribe to.\n  const [store] = useState(() => new SchemaFormStore(storeProps, formId));\n  // `syncProps` runs here, IN render, so a non-memoized descendant\n  // re-rendering this same pass reads fresh values; the resulting `changed`\n  // flag is only ACTED ON (`store.notify()`) from the layout effect below —\n  // see `syncProps`'s doc comment for why calling it synchronously here\n  // instead would trip React's \"setState while rendering a different\n  // component\" guard against an already-mounted, memoized `SchemaFormField`.\n  const changed = store.syncProps(storeProps);\n  useLayoutEffect(() => {\n    if (changed) store.notify();\n  });\n\n  // The field to focus after an invalid submit. `store.submit()` calls this\n  // listener synchronously (in the same click/Enter handler that also flips\n  // `attempted`, which is what makes an error-containing `AdvancedGroup`\n  // branch open itself — see `AdvancedGroupBranch`), so React batches both\n  // updates into ONE commit; the actual `.focus()` call happens from the\n  // `useEffect` below, which runs AFTER that commit (and after Radix has\n  // mounted the newly-open group) — a synchronous `document.getElementById`\n  // right here would run against the PRE-update DOM and could never find a\n  // control that only exists once the just-opened disclosure mounts its\n  // content. A fresh object on every call (not just the name) guarantees the\n  // effect re-fires even when the SAME field is invalid on consecutive\n  // submit attempts, where a primitive dependency wouldn't change.\n  const [pendingFocus, setPendingFocus] = useState<{ name: string } | null>(null);\n  useEffect(() => store.onPendingFocus((name) => setPendingFocus({ name })), [store]);\n  useEffect(() => {\n    if (!pendingFocus || typeof document === \"undefined\") return;\n    const el = document.getElementById(controlId(store.formId, pendingFocus.name));\n    el?.focus();\n  }, [pendingFocus, store]);\n\n  return <SchemaFormStoreContext value={store}>{children}</SchemaFormStoreContext>;\n}\n\n// ─── Field control renderers ──────────────────────────────────────────────────\n\ninterface FieldControlProps {\n  field: FieldSpec;\n  value: FormValue;\n  invalid: boolean;\n  disabled: boolean;\n  readOnly: boolean;\n  id: string;\n  /** Id of the field's visible label (used by grouped controls' aria-labelledby). */\n  labelId: string;\n  describedBy: string | undefined;\n  setValue: (name: string, value: FormValue) => void;\n}\n\nfunction StringControl({\n  field,\n  value,\n  invalid,\n  disabled,\n  readOnly,\n  id,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"string\" }> }) {\n  const text = value === undefined ? \"\" : String(value);\n  const commonAria = {\n    id,\n    \"aria-invalid\": invalid || undefined,\n    \"aria-describedby\": describedBy,\n    \"aria-required\": field.required || undefined,\n    required: field.required,\n  } as const;\n\n  if (field.multiline) {\n    return (\n      <Textarea\n        {...commonAria}\n        name={field.name}\n        value={text}\n        disabled={disabled}\n        readOnly={readOnly}\n        maxLength={field.maxLength}\n        onChange={(e) => setValue(field.name, e.target.value)}\n      />\n    );\n  }\n\n  const inputType =\n    field.format === \"email\"\n      ? \"email\"\n      : field.format === \"uri\"\n        ? \"url\"\n        : field.format === \"date\"\n          ? \"date\"\n          : field.format === \"date-time\"\n            ? \"datetime-local\"\n            : \"text\";\n  const spellCheck = field.format === \"email\" || field.format === \"uri\" ? false : undefined;\n  const inputMode = field.format === \"email\" ? \"email\" : field.format === \"uri\" ? \"url\" : undefined;\n\n  return (\n    <Input\n      {...commonAria}\n      type={inputType}\n      name={field.name}\n      value={text}\n      disabled={disabled}\n      readOnly={readOnly}\n      minLength={field.minLength}\n      maxLength={field.maxLength}\n      spellCheck={spellCheck}\n      inputMode={inputMode}\n      onChange={(e) => setValue(field.name, e.target.value)}\n    />\n  );\n}\n\nfunction NumberControl({\n  field,\n  value,\n  invalid,\n  disabled,\n  readOnly,\n  id,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"number\" | \"integer\" }> }) {\n  const num = typeof value === \"number\" ? value : null;\n  return (\n    <NumberInput\n      id={id}\n      name={field.name}\n      value={num}\n      min={field.min}\n      max={field.max}\n      step={field.type === \"integer\" ? 1 : undefined}\n      disabled={disabled}\n      readOnly={readOnly}\n      aria-invalid={invalid || undefined}\n      aria-describedby={describedBy}\n      aria-required={field.required || undefined}\n      onValueChange={(next) => setValue(field.name, next ?? undefined)}\n    />\n  );\n}\n\nfunction BooleanControl({\n  field,\n  value,\n  disabled,\n  id,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"boolean\" }> }) {\n  return (\n    <div className=\"flex items-center gap-2\">\n      <Checkbox\n        id={id}\n        name={field.name}\n        checked={value === true}\n        disabled={disabled}\n        aria-describedby={describedBy}\n        aria-required={field.required || undefined}\n        onCheckedChange={(checked) => setValue(field.name, checked === true)}\n      />\n      <Label htmlFor={id} className=\"flex items-center gap-1 font-normal\">\n        {fieldLabel(field)}\n        {field.required && (\n          <span aria-hidden=\"true\" className=\"text-destructive-text\">\n            *\n          </span>\n        )}\n      </Label>\n    </div>\n  );\n}\n\nfunction EnumControl({\n  field,\n  value,\n  invalid,\n  disabled,\n  id,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"enum\" }> }) {\n  const { t } = useLocale();\n  const current = typeof value === \"string\" && value.length > 0 ? value : undefined;\n  return (\n    <Select value={current} disabled={disabled} onValueChange={(v) => setValue(field.name, v)}>\n      <SelectTrigger\n        id={id}\n        aria-invalid={invalid || undefined}\n        aria-describedby={describedBy}\n        aria-required={field.required || undefined}\n      >\n        <SelectValue placeholder={t(\"ui.schemaForm.selectPlaceholder\")} />\n      </SelectTrigger>\n      <SelectContent>\n        {field.options.map((option) => (\n          <SelectItem key={optionValue(option)} value={optionValue(option)}>\n            {optionLabel(option)}\n          </SelectItem>\n        ))}\n      </SelectContent>\n    </Select>\n  );\n}\n\nfunction MultiEnumControl({\n  field,\n  value,\n  disabled,\n  id,\n  labelId,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"multi-enum\" }> }) {\n  const { t } = useLocale();\n  const selected = Array.isArray(value) ? (value as string[]) : [];\n  const toggle = (optValue: string, checked: boolean) => {\n    const next = checked ? [...selected, optValue] : selected.filter((v) => v !== optValue);\n    setValue(field.name, next);\n  };\n  return (\n    <div\n      role=\"group\"\n      id={id}\n      tabIndex={-1}\n      aria-labelledby={labelId}\n      aria-describedby={describedBy}\n      className=\"flex flex-col gap-2 focus:outline-none\"\n    >\n      {field.options.map((option) => {\n        const optValue = optionValue(option);\n        const optionId = `${id}-${optValue}`;\n        return (\n          <div key={optValue} className=\"flex items-center gap-2\">\n            <Checkbox\n              id={optionId}\n              checked={selected.includes(optValue)}\n              disabled={disabled}\n              onCheckedChange={(checked) => toggle(optValue, checked === true)}\n            />\n            <Label htmlFor={optionId} className=\"font-normal\">\n              {optionLabel(option)}\n            </Label>\n          </div>\n        );\n      })}\n      {field.options.length === 0 && (\n        <p className=\"text-body text-muted-foreground\">{t(\"noResults\")}</p>\n      )}\n    </div>\n  );\n}\n\nfunction ListControl({\n  field,\n  value,\n  disabled,\n  id,\n  labelId,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"list\" }> }) {\n  const items = Array.isArray(value) ? (value as string[]) : [];\n  return (\n    <ListEditor\n      id={id}\n      aria-labelledby={labelId}\n      aria-describedby={describedBy}\n      value={items}\n      max={field.maxItems}\n      placeholder={field.itemPlaceholder}\n      disabled={disabled}\n      onValueChange={(next) => setValue(field.name, next)}\n    />\n  );\n}\n\nfunction KeyValueControl({\n  field,\n  value,\n  disabled,\n  id,\n  labelId,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"key-value\" }> }) {\n  const rows = Array.isArray(value) ? (value as KeyValueRow[]) : [];\n  return (\n    <KeyValueEditor\n      id={id}\n      aria-labelledby={labelId}\n      aria-describedby={describedBy}\n      value={rows}\n      keyPlaceholder={field.keyPlaceholder}\n      valuePlaceholder={field.valuePlaceholder}\n      disabled={disabled}\n      onValueChange={(next) => setValue(field.name, next)}\n    />\n  );\n}\n\n/** Lists the currently-selected files with per-file wrong-type/too-large state. Reads `FileUpload`'s own context. */\nfunction FileControlList({ field }: { field: Extract<FieldSpec, { type: \"file\" }> }) {\n  const { files } = useFileUpload();\n  if (files.length === 0) return null;\n  return (\n    <FileUploadList>\n      {files.map((uploadFile) => {\n        const issue = checkFileIssue(uploadFile.file, field);\n        return (\n          <FileUploadItem\n            key={uploadFile.id}\n            uploadFile={uploadFile}\n            status={issue ? \"error\" : \"success\"}\n            errorMessage={issue?.message}\n          />\n        );\n      })}\n    </FileUploadList>\n  );\n}\n\n/** A stable per-file id, since `FormValue`'s `File[]` carries no id of its own (unlike `FileUpload`'s own `UploadFile`). */\nfunction fileIdentity(file: File): string {\n  return `${file.name}-${file.size}-${file.lastModified}`;\n}\n\nfunction FileControl({\n  field,\n  value,\n  disabled,\n  id,\n  labelId,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: Extract<FieldSpec, { type: \"file\" }> }) {\n  // Bind `FileUpload` to the field's OWN value rather than letting it manage\n  // uncontrolled internal state: an externally-seeded `values` prop (a\n  // controlled `SchemaForm`, or a spec swap that reseeds `values`) must show\n  // up in the picker, and `setValue` must stay the single source of truth —\n  // otherwise the picker's internal file list and the form's submitted\n  // `values[field.name]` can silently diverge.\n  const controlledFiles = useMemo(() => {\n    const selected = Array.isArray(value) ? (value as File[]) : [];\n    return selected.map((file) => ({\n      id: fileIdentity(file),\n      file,\n    }));\n  }, [value]);\n  // `FileUpload.addFiles` also declines a wrong-type file (`accept`) before it\n  // reaches `files` — right for a bare FileUpload, but here that would make the\n  // \"wrong type\" designed state unreachable for a drop (the file would just\n  // vanish, exactly the `maxSize` failure mode noted below). `addFiles` commits\n  // the accepted list and THEN reports rejections, synchronously, so remember\n  // the last committed list and re-admit the `accept` rejections onto it for\n  // `checkFileIssue` to render with a visible error.\n  const lastCommittedRef = useRef<File[]>([]);\n  const maxFiles = field.multiple ? field.maxFiles : 1;\n  return (\n    <FileUpload\n      id={id}\n      aria-labelledby={labelId}\n      aria-describedby={describedBy}\n      accept={field.accept}\n      multiple={field.multiple}\n      // NOT `maxSize={field.maxSize}` — `FileUpload.addFiles` enforces `maxSize`\n      // by silently DROPPING an oversized file before it ever reaches `files`\n      // state, which would make the \"too large\" designed state below\n      // unreachable (the file the user picked would just vanish with no\n      // feedback). Enforcement instead happens entirely in `checkFileIssue`\n      // below, which renders the oversized file WITH an error item.\n      maxFiles={maxFiles}\n      disabled={disabled}\n      files={controlledFiles}\n      onFilesChange={(list) => {\n        const next = list.map((u) => u.file);\n        lastCommittedRef.current = next;\n        setValue(field.name, next);\n      }}\n      onFilesRejected={(rejections) => {\n        const wrongType = rejections.filter((r) => r.reason === \"accept\").map((r) => r.file);\n        if (wrongType.length === 0) return;\n        const merged = [...lastCommittedRef.current, ...wrongType];\n        setValue(field.name, maxFiles ? merged.slice(0, maxFiles) : merged);\n      }}\n    >\n      <FileUploadDropzone />\n      <FileControlList field={field} />\n    </FileUpload>\n  );\n}\n\n// ─── Group control (tabs / advanced) ───────────────────────────────────────────\n\nfunction GroupTabsControl({\n  field,\n  value,\n  disabled,\n  id,\n  labelId,\n  describedBy,\n  setValue,\n}: FieldControlProps & { field: GroupFieldSpec }) {\n  const active =\n    (typeof value === \"string\" ? value : undefined) ?? field.default ?? field.groups[0]?.key;\n  return (\n    <Tabs\n      value={active}\n      onValueChange={(next) => setValue(field.name, next)}\n      id={id}\n      aria-labelledby={labelId}\n      aria-describedby={describedBy}\n    >\n      <TabsList>\n        {field.groups.map((group) => (\n          <TabsTrigger key={group.key} value={group.key} disabled={disabled}>\n            {group.label}\n          </TabsTrigger>\n        ))}\n      </TabsList>\n      {field.groups.map((group) => (\n        <TabsContent key={group.key} value={group.key} className=\"flex flex-col gap-4 pt-3\">\n          {group.description && (\n            <p className=\"text-caption text-muted-foreground\">{group.description}</p>\n          )}\n          <GroupTabsBranch group={group} />\n        </TabsContent>\n      ))}\n    </Tabs>\n  );\n}\n\n/**\n * One tab branch's visible fields — its own `useVisibleFieldNames`\n * subscription, so a `visibleWhen` inside THIS branch re-evaluates\n * independent of `GroupTabsControl`'s (and its parent `SchemaFormField`'s)\n * own re-render.\n */\nfunction GroupTabsBranch({ group }: { group: GroupItemSpec }) {\n  const store = useSchemaFormStore();\n  const visibleNames = useVisibleFieldNames(store, group.fields);\n  return (\n    <>\n      {visibleNames.map((name) => (\n        <SchemaFormField key={name} name={name} />\n      ))}\n    </>\n  );\n}\n\n/**\n * One `variant: \"advanced\"` branch. Radix's `CollapsibleContent` UNMOUNTS its\n * children while closed, so a required field inside a still-collapsed branch\n * is invisible to both `document.getElementById` (submit's focus step) and\n * the user — reveal the branch automatically the moment it holds a\n * validation error. \"Controlled with override\": the derived open state\n * (`hasError`) drives the disclosure until the user explicitly toggles it\n * themselves, at which point their choice takes over for good (an ordinary\n * disclosure never re-imposes itself over a deliberate user action).\n */\nfunction AdvancedGroupBranch({ group }: { group: GroupItemSpec }) {\n  const store = useSchemaFormStore();\n  const hasError = useBranchHasError(store, group.fields);\n  const visibleNames = useVisibleFieldNames(store, group.fields);\n  const [manualOpen, setManualOpen] = useState<boolean | undefined>(undefined);\n  const open = manualOpen ?? hasError;\n  return (\n    <AdvancedGroup\n      title={group.label}\n      summary={group.description}\n      open={open}\n      onOpenChange={setManualOpen}\n    >\n      {visibleNames.map((name) => (\n        <SchemaFormField key={name} name={name} />\n      ))}\n    </AdvancedGroup>\n  );\n}\n\nfunction GroupAdvancedControl({ field }: { field: GroupFieldSpec }) {\n  return (\n    <div className=\"flex flex-col gap-3\">\n      {field.groups.map((group) => (\n        <AdvancedGroupBranch key={group.key} group={group} />\n      ))}\n    </div>\n  );\n}\n\n// ─── Field ────────────────────────────────────────────────────────────────────\n\nexport interface SchemaFormFieldProps extends Omit<HTMLAttributes<HTMLDivElement>, \"children\"> {\n  /** The field's `name` (its key in the spec + values). Resolved anywhere in the tree, including inside `group` branches. */\n  name: string;\n}\n\n/**\n * Renders one field by name: label, control, description, inline error.\n * Boolean fields render their own inline label (checkbox + label); `group`\n * fields render their OWN label/description internally (a Tabs strip or a\n * stack of disclosures isn't a single labelled control), so the standalone\n * `<Label>` above is suppressed for both.\n *\n * Enforces its OWN `visibleWhen` (returns `null` when hidden) rather than\n * trusting the caller to have filtered it out first: the documented custom-\n * layout composition (`SchemaFormProvider` + the parts, see `SchemaForm`'s\n * own doc comment) lets a consumer place `<SchemaFormField name=\"…\" />`\n * directly, bypassing `SchemaFormFields`'/`GroupTabsControl`'s/\n * `AdvancedGroupBranch`'s own `isFieldVisible` filters — without this check\n * the same spec would render a hidden field in a custom layout while\n * validation/submission (which always excludes it) disagree.\n */\nexport const SchemaFormField = memo(\n  forwardRef<HTMLDivElement, SchemaFormFieldProps>(function SchemaFormField(\n    { name, className, ...props },\n    ref,\n  ) {\n    // Hooks run unconditionally, ahead of the `!field`/`!visible` early\n    // returns below (rules-of-hooks) — this is exactly what makes typing in\n    // field A skip re-rendering field B: `useFieldSnapshot` bails out (via\n    // `useSyncExternalStore`'s `Object.is` check on the cached snapshot) for\n    // every OTHER mounted `SchemaFormField`, so only the field whose own\n    // snapshot changed re-renders.\n    const store = useSchemaFormStore();\n    const meta = useSchemaFormMeta(store);\n    const snapshot = useFieldSnapshot(store, name);\n    const field = store.getField(name);\n    if (!field) return null;\n    if (!snapshot.visible) return null;\n\n    const id = controlId(meta.formId, name);\n    const labelId = `${meta.formId}-label-${name}`;\n    const invalid = snapshot.invalid;\n    const description = field.description;\n    const hasDesc = Boolean(description);\n    const describedBy =\n      [hasDesc ? descId(meta.formId, name) : null, invalid ? errorId(meta.formId, name) : null]\n        .filter(Boolean)\n        .join(\" \") || undefined;\n\n    const controlProps: FieldControlProps = {\n      field,\n      value: snapshot.value,\n      invalid,\n      disabled: snapshot.disabled,\n      readOnly: snapshot.readOnly,\n      id,\n      labelId,\n      describedBy,\n      setValue: store.setValue,\n    };\n\n    if (field.type !== \"group\" && field.readOnly) {\n      return (\n        <div\n          ref={ref}\n          data-slot=\"schema-form-field\"\n          data-readonly=\"\"\n          className={cn(\"flex flex-col gap-1.5\", className)}\n          {...props}\n        >\n          <Descriptions layout=\"vertical\">\n            <DescriptionsItem\n              label={fieldLabel(field)}\n              numeric={field.type === \"number\" || field.type === \"integer\"}\n            >\n              {readOnlyText(snapshot.value)}\n            </DescriptionsItem>\n          </Descriptions>\n          {hasDesc && (\n            <p id={descId(meta.formId, name)} className=\"text-caption text-muted-foreground\">\n              {description}\n            </p>\n          )}\n        </div>\n      );\n    }\n\n    const isBoolean = field.type === \"boolean\";\n    const isGroup = field.type === \"group\";\n    // A multi-value control renders a labelled REGION, not one focusable\n    // element with a native label association (a checkbox group, a list/\n    // key-value editor's several rows, a file dropzone, tabs, or a stack of\n    // disclosures) — its label must NOT use htmlFor, only aria-labelledby.\n    const isRegionField =\n      field.type === \"multi-enum\" ||\n      field.type === \"list\" ||\n      field.type === \"key-value\" ||\n      field.type === \"file\" ||\n      isGroup;\n\n    return (\n      <div\n        ref={ref}\n        data-slot=\"schema-form-field\"\n        className={cn(\"flex flex-col gap-1.5\", className)}\n        {...props}\n      >\n        {!isBoolean && (\n          <Label\n            id={labelId}\n            htmlFor={isRegionField ? undefined : id}\n            className=\"flex items-center gap-1\"\n          >\n            {fieldLabel(field)}\n            {field.required && (\n              <span aria-hidden=\"true\" className=\"text-destructive-text\">\n                *\n              </span>\n            )}\n          </Label>\n        )}\n\n        {field.type === \"string\" && <StringControl {...controlProps} field={field} />}\n        {(field.type === \"number\" || field.type === \"integer\") && (\n          <NumberControl {...controlProps} field={field} />\n        )}\n        {field.type === \"boolean\" && <BooleanControl {...controlProps} field={field} />}\n        {field.type === \"enum\" && <EnumControl {...controlProps} field={field} />}\n        {field.type === \"multi-enum\" && <MultiEnumControl {...controlProps} field={field} />}\n        {field.type === \"list\" && <ListControl {...controlProps} field={field} />}\n        {field.type === \"key-value\" && <KeyValueControl {...controlProps} field={field} />}\n        {field.type === \"file\" && <FileControl {...controlProps} field={field} />}\n        {field.type === \"group\" && field.variant === \"tabs\" && (\n          <GroupTabsControl {...controlProps} field={field} />\n        )}\n        {field.type === \"group\" && field.variant === \"advanced\" && (\n          <GroupAdvancedControl field={field} />\n        )}\n\n        {hasDesc && (\n          <p id={descId(meta.formId, name)} className=\"text-caption text-muted-foreground\">\n            {description}\n          </p>\n        )}\n        {invalid && (\n          <p id={errorId(meta.formId, name)} className=\"text-caption text-destructive-text\">\n            {snapshot.errorText}\n          </p>\n        )}\n      </div>\n    );\n  }),\n);\n\n// ─── Fields (all) ─────────────────────────────────────────────────────────────\n\nexport type SchemaFormFieldsProps = HTMLAttributes<HTMLDivElement>;\n\n/** Renders every top-level field in the spec, in order. A skeleton while `loading` with no fields. */\nexport const SchemaFormFields = forwardRef<HTMLDivElement, SchemaFormFieldsProps>(\n  function SchemaFormFields({ className, ...props }, ref) {\n    const store = useSchemaFormStore();\n    const meta = useSchemaFormMeta(store);\n    const visibleNames = useVisibleFieldNames(store, meta.spec.fields);\n    const { spec, loading } = meta;\n\n    if (spec.fields.length === 0 && loading) {\n      return (\n        <div\n          ref={ref}\n          data-slot=\"schema-form-fields\"\n          className={cn(\"flex flex-col gap-4\", className)}\n          {...props}\n        >\n          <SchemaFormSkeletonAnnouncement />\n          <div aria-hidden=\"true\" className=\"flex flex-col gap-4\">\n            {[0, 1, 2].map((i) => (\n              <div key={i} className=\"flex flex-col gap-1.5\">\n                <Skeleton className=\"h-4 w-24\" />\n                <Skeleton className=\"h-9 w-full\" />\n              </div>\n            ))}\n          </div>\n        </div>\n      );\n    }\n\n    return (\n      <div\n        ref={ref}\n        data-slot=\"schema-form-fields\"\n        className={cn(\"flex flex-col gap-4\", className)}\n        {...props}\n      >\n        {spec.sections\n          ? (() => {\n              const grouped = new Set(spec.sections.flatMap((section) => section.fields));\n              const visible = new Set(visibleNames);\n              return (\n                <>\n                  {visibleNames\n                    .filter((name) => !grouped.has(name))\n                    .map((name) => (\n                      <SchemaFormField key={name} name={name} />\n                    ))}\n                  {spec.sections.map((section) => {\n                    const names = section.fields.filter((name) => visible.has(name));\n                    if (names.length === 0) return null;\n                    return (\n                      <SchemaFormSection\n                        key={section.id}\n                        label={section.label}\n                        collapsed={section.collapsed}\n                      >\n                        {names.map((name) => (\n                          <SchemaFormField key={name} name={name} />\n                        ))}\n                      </SchemaFormSection>\n                    );\n                  })}\n                </>\n              );\n            })()\n          : visibleNames.map((name) => <SchemaFormField key={name} name={name} />)}\n      </div>\n    );\n  },\n);\n\n/** A read-only field's value as text; an empty value renders an em dash. */\nfunction readOnlyText(value: FormValue): string {\n  if (value === undefined || value === \"\") return \"—\";\n  if (Array.isArray(value)) {\n    if (value.length === 0) return \"—\";\n    return value\n      .map((item) =>\n        typeof item === \"string\"\n          ? item\n          : item instanceof File\n            ? item.name\n            : `${item.key}: ${item.value}`,\n      )\n      .join(\", \");\n  }\n  return String(value);\n}\n\n/** One `FormSpec.sections` entry: a disclosure over its fields. */\nfunction SchemaFormSection({\n  label,\n  collapsed,\n  children,\n}: {\n  label: string;\n  collapsed?: boolean;\n  children: ReactNode;\n}) {\n  return (\n    <Collapsible\n      defaultOpen={!collapsed}\n      data-slot=\"schema-form-section\"\n      className=\"group/section flex flex-col gap-3 border-t border-border-strong pt-3\"\n    >\n      <CollapsibleTrigger\n        data-slot=\"schema-form-section-trigger\"\n        className=\"focus-ring flex w-full items-center gap-1 rounded-sm text-start text-subtitle text-foreground\"\n      >\n        <ChevronRight\n          aria-hidden=\"true\"\n          className=\"size-4 shrink-0 transition-transform group-data-[state=open]/section:rotate-90 motion-reduce:transition-none\"\n        />\n        {label}\n      </CollapsibleTrigger>\n      <CollapsibleContent data-slot=\"schema-form-section-content\" className=\"flex flex-col gap-4\">\n        {children}\n      </CollapsibleContent>\n    </Collapsible>\n  );\n}\n\nfunction SchemaFormSkeletonAnnouncement() {\n  const { t } = useLocale();\n  return (\n    <span className=\"sr-only\" role=\"status\" aria-live=\"polite\">\n      {t(\"loading\")}\n    </span>\n  );\n}\n\n// ─── Error (form-level, terminal) ───────────────────────────────────────────────\n\nexport type SchemaFormErrorProps = HTMLAttributes<HTMLDivElement>;\n\n/** A terminal, form-level submission error (e.g. \"Couldn't save settings\"). Renders nothing when absent. */\nexport const SchemaFormError = forwardRef<HTMLDivElement, SchemaFormErrorProps>(\n  function SchemaFormError({ className, ...props }, ref) {\n    const store = useSchemaFormStore();\n    const { error } = useSchemaFormMeta(store);\n    if (!error) return null;\n    return (\n      <div\n        ref={ref}\n        role=\"alert\"\n        // #F2: the `bg-destructive/10` wash alone measures 1.18:1 (light) /\n        // 1.09:1 (dark) against the form ground — the earlier \"the wash already\n        // marks the region\" reasoning (styling-and-tokens.md's own decision\n        // test: \"if I deleted this line, could a sighted user still tell the\n        // two regions apart?\") had a measured answer of no, so the wash was the\n        // SOLE structural cue and dropping the border was wrong. Restore the\n        // boundary as an accent RAIL (`border-s-2 border-s-destructive`), not a\n        // full border — the gate permits rails, and a rail is the idiom the\n        // rest of the repo already uses for a destructive/error box that keeps\n        // its wash (`MermaidDiagram`'s error panel, `packages/editor/src/mermaid-diagram/mermaid-diagram.tsx`).\n        // `border-s-destructive` is the FILL rung (styling-and-tokens.md \"status\n        // rung\"), guaranteed >=3:1 against every surface token — measured here\n        // at 4.70:1 (light) / 4.71:1 (dark) against `--background`.\n        data-slot=\"schema-form-error\"\n        className={cn(\n          \"rounded-md border-s-2 border-s-destructive bg-destructive/10 px-3 py-2 text-body text-destructive-text\",\n          className,\n        )}\n        {...props}\n      >\n        {error}\n      </div>\n    );\n  },\n);\n\n// ─── Submit ───────────────────────────────────────────────────────────────────\n\nexport interface SchemaFormSubmitProps extends Omit<HTMLAttributes<HTMLButtonElement>, \"children\"> {\n  /** Submit button label (overrides `spec.submitLabel`). @default \"Submit\" */\n  label?: string;\n}\n\n/**\n * The submit affordance. Enabled until the request starts (validation runs on\n * click), then transiently blocked. `submitting` uses `aria-disabled` + a\n * click-handler guard — NEVER the native `disabled` attribute — so a focused\n * button is never dropped from the tab order right after the user activates\n * it (see the module doc comment / interaction-guidelines.md). The explicit,\n * caller-set `disabled` (read-only form) stays native: that is a deliberate,\n * durable state, not a transient auto-flip. A submitted form shows an inert\n * \"Submitted\" note instead of a button.\n */\nexport const SchemaFormSubmit = forwardRef<HTMLButtonElement, SchemaFormSubmitProps>(\n  function SchemaFormSubmit({ label, className, onClick, ...props }, ref) {\n    const { t } = useLocale();\n    const store = useSchemaFormStore();\n    const { spec, submitting, submitted, disabled, loading } = useSchemaFormMeta(store);\n\n    if (submitted) {\n      return (\n        <Badge variant=\"success\" aria-live=\"polite\" className=\"w-fit\">\n          <Check aria-hidden=\"true\" className=\"size-3\" />\n          {t(\"ui.schemaForm.submitted\")}\n        </Badge>\n      );\n    }\n\n    const text = label ?? spec.submitLabel ?? t(\"ui.schemaForm.submit\");\n    // The spec is still loading (`SchemaFormFields` shows a skeleton, not the\n    // real fields yet) — blocked exactly like `submitting`: transient, so\n    // `aria-disabled` + a handler guard, never the native attribute (see the\n    // module doc comment). Submitting while the fields haven't rendered would\n    // validate/submit whatever placeholder `values` happen to exist.\n    const blocked = submitting || loading;\n\n    const handleClick = (e: MouseEvent<HTMLButtonElement>) => {\n      // aria-disabled does not block activation the way the native attribute\n      // does, so the handler (and SchemaFormRoot's onSubmit) has to.\n      if (blocked) {\n        e.preventDefault();\n        return;\n      }\n      onClick?.(e);\n    };\n\n    return (\n      <Button\n        ref={ref}\n        type=\"submit\"\n        data-slot=\"schema-form-submit\"\n        disabled={disabled}\n        aria-disabled={blocked || undefined}\n        aria-busy={submitting || undefined}\n        onClick={handleClick}\n        className={cn(blocked && \"cursor-not-allowed\", className)}\n        {...props}\n      >\n        {submitting && <Spinner aria-hidden=\"true\" className=\"text-current\" />}\n        {submitting ? t(\"ui.schemaForm.submitting\") : text}\n      </Button>\n    );\n  },\n);\n\n// ─── Test action (a form/group-level async action, e.g. \"Test connection\") ────\n\n/**\n * `SchemaFormTestAction`'s lifecycle: `idle` → `pending` while `onTest` is in\n * flight → `success`/`failure` once it settles. Deliberately local component\n * state, NOT part of the `SchemaFormStore` — so it can never affect field\n * validity or gate `submit()` (issue #22 maintainer ruling, 2026-09-01: a\n * form/group-level test-action slot, kept separate from field validity and\n * never gating submit — not per-field `validateAsync` in the validation\n * engine).\n */\nexport type SchemaFormTestActionStatus = \"idle\" | \"pending\" | \"success\" | \"failure\";\n\nexport interface SchemaFormTestActionProps extends Omit<HTMLAttributes<HTMLDivElement>, \"onError\"> {\n  /**\n   * Runs the test (e.g. calls an API with the fields typed so far). Receives\n   * the form's CURRENT effective values — the same object `validateForm`\n   * would resolve against — but this call is entirely independent of\n   * validation: a field that is currently invalid, or an unrelated required\n   * field left empty, never blocks a test run. Resolve to signal success;\n   * reject (an `Error`, or throw) to signal failure — a rejected `Error`'s\n   * `message` becomes the shown failure reason.\n   */\n  onTest: (values: FormValues) => void | Promise<void>;\n  /** Button label. @default \"Test connection\" */\n  label?: string;\n  /** Label shown while pending. @default \"Testing…\" */\n  pendingLabel?: string;\n  /** Label shown on success. @default \"Connected\" */\n  successLabel?: string;\n  /** Fallback failure label when the rejection carries no message. @default \"Test failed\" */\n  failureLabel?: string;\n}\n\n/**\n * A form- or group-level \"Test connection\" affordance: an async action the\n * user can run to verify the values typed so far (e.g. hit a connector's\n * `/ping` endpoint) BEFORE submitting. Place it anywhere inside a\n * `SchemaFormProvider` tree — directly under `SchemaFormRoot` for a\n * form-level test, or beside a `SchemaFormField` inside a `group` branch (a\n * `TabsContent`/`AdvancedGroup`) for a per-credential-set test. Not part of\n * `SchemaForm`'s default composition — an opt-in part a consumer places, the\n * same way a custom layout composes `SchemaFormField` directly.\n *\n * Deliberately NOT wired into `errors`/`validateForm`/`submit()` — its\n * pending/success/failure state is entirely local, so it can never block or\n * silently gate the form's own submit control.\n */\nexport const SchemaFormTestAction = forwardRef<HTMLDivElement, SchemaFormTestActionProps>(\n  function SchemaFormTestAction(\n    { onTest, label, pendingLabel, successLabel, failureLabel, className, ...props },\n    ref,\n  ) {\n    const { t } = useLocale();\n    const store = useSchemaFormStore();\n    const { disabled: formDisabled, loading, submitted, submitting } = useSchemaFormMeta(store);\n    const effectiveValues = useEffectiveValues(store);\n    const [status, setStatus] = useState<SchemaFormTestActionStatus>(\"idle\");\n    const [failureMessage, setFailureMessage] = useState<string | null>(null);\n\n    // Always mirrors the LATEST `effectiveValues` (updated every render) so\n    // an in-flight `onTest` can tell, once it settles, whether the values it\n    // was called with are still current — a plain closure over\n    // `effectiveValues` would only ever see the snapshot from the render\n    // that started the request.\n    const latestEffectiveValuesRef = useRef(effectiveValues);\n    latestEffectiveValuesRef.current = effectiveValues;\n    // The specific values snapshot the CURRENT `status` describes — set at\n    // the moment a test starts, read both by the async completion (to\n    // detect \"edited while pending\") and by the effect below (to detect\n    // \"edited after success/failure\").\n    const testedValuesRef = useRef<FormValues | null>(null);\n\n    const pending = status === \"pending\";\n    // Transient (pending) block uses aria-disabled + a handler guard, never\n    // native `disabled` — same reasoning as SchemaFormSubmit's OWN pending\n    // state: a keyboard user who just activated THIS button must not be\n    // dropped from the tab order right after they used it. `pending` (this\n    // button's own in-flight test) and `loading` (the spec itself still\n    // loading — pre-existing, matches SchemaFormSubmit's `blocked`) are both\n    // \"I am mid-task\" states, so they stay transient.\n    //\n    // `submitting`/`submitted` are a DIFFERENT kind of state: they describe\n    // the FORM's submit action, not this button's own. This button is a\n    // bystander to that action the same way a `SchemaFormField` is — never\n    // the control the user just activated — so both go native `disabled`\n    // below, exactly like `SchemaFormField`'s `controlDisabled = ctx.disabled\n    // || ctx.submitted || ctx.submitting`. (Contrast `SchemaFormSubmit`,\n    // where `submitting` IS the button's own state and stays transient — the\n    // two controls are not interchangeable here.)\n    const transientlyBlocked = loading || pending;\n    const nativelyBlocked = formDisabled || submitted || submitting;\n\n    // PR #119 review thread 0 (chatgpt-codex-connector): once the tested\n    // values go stale — the user edited a field after this status settled —\n    // discard the now-inaccurate success/failure and return to idle rather\n    // than keep describing values that no longer exist.\n    useEffect(() => {\n      if (\n        (status === \"success\" || status === \"failure\") &&\n        testedValuesRef.current !== effectiveValues\n      ) {\n        setStatus(\"idle\");\n        setFailureMessage(null);\n      }\n    }, [effectiveValues, status]);\n\n    const handleClick = (e: MouseEvent<HTMLButtonElement>) => {\n      if (nativelyBlocked || transientlyBlocked) {\n        e.preventDefault();\n        return;\n      }\n      const testedValues = effectiveValues;\n      testedValuesRef.current = testedValues;\n      setStatus(\"pending\");\n      setFailureMessage(null);\n      void (async () => {\n        try {\n          await onTest(testedValues);\n          // The values changed WHILE the request was in flight — discard\n          // this now-stale result and go back to idle rather than report\n          // success/failure for a snapshot the user has already moved on\n          // from (also covers the \"resolved after a NEWER click\" case,\n          // since that click's own `testedValuesRef.current` write already\n          // moved this promise's `testedValues` out of date).\n          if (latestEffectiveValuesRef.current !== testedValues) {\n            setStatus(\"idle\");\n            return;\n          }\n          setStatus(\"success\");\n        } catch (err) {\n          if (latestEffectiveValuesRef.current !== testedValues) {\n            setStatus(\"idle\");\n            return;\n          }\n          setStatus(\"failure\");\n          setFailureMessage(err instanceof Error ? err.message : null);\n        }\n      })();\n    };\n\n    return (\n      <div\n        ref={ref}\n        data-slot=\"schema-form-test-action\"\n        className={cn(\"flex flex-wrap items-center gap-2\", className)}\n        {...props}\n      >\n        <Button\n          type=\"button\"\n          variant=\"outline\"\n          disabled={nativelyBlocked}\n          aria-disabled={transientlyBlocked || undefined}\n          aria-busy={pending || undefined}\n          onClick={handleClick}\n          className={cn(transientlyBlocked && \"cursor-not-allowed\")}\n        >\n          {pending && <Spinner aria-hidden=\"true\" className=\"text-current\" />}\n          {pending\n            ? (pendingLabel ?? t(\"ui.schemaForm.testAction.pending\"))\n            : (label ?? t(\"ui.schemaForm.testAction.label\"))}\n        </Button>\n        {status === \"success\" && (\n          <StatusBadge status=\"complete\" aria-live=\"polite\">\n            {successLabel ?? t(\"ui.schemaForm.testAction.success\")}\n          </StatusBadge>\n        )}\n        {status === \"failure\" && (\n          <StatusBadge status=\"failed\" role=\"alert\">\n            {failureMessage ?? failureLabel ?? t(\"ui.schemaForm.testAction.failure\")}\n          </StatusBadge>\n        )}\n      </div>\n    );\n  },\n);\n\n// ─── Root (the <form> element) ────────────────────────────────────────────────\n\nexport type SchemaFormRootProps = Omit<HTMLAttributes<HTMLFormElement>, \"onSubmit\">;\n\n/**\n * The `<form>` element wired to the context's `submit`. Never nest inside\n * another `<form>` — compose it as its own top-level block.\n */\nexport const SchemaFormRoot = forwardRef<HTMLFormElement, SchemaFormRootProps>(\n  function SchemaFormRoot({ className, children, ...props }, ref) {\n    const { t } = useLocale();\n    const store = useSchemaFormStore();\n    const { headingId, spec, disabled, submitting, loading } = useSchemaFormMeta(store);\n    const handleSubmit = (e: FormEvent<HTMLFormElement>) => {\n      e.preventDefault();\n      // The submit control's `aria-disabled` is a signal, not a lock — this is\n      // the actual guard against a double/blocked submit. `loading` blocks it\n      // too (see `SchemaFormSubmit`): the fields are still a skeleton, so\n      // there is nothing real to validate/submit yet.\n      if (disabled || submitting || loading) return;\n      store.submit();\n    };\n    return (\n      <form\n        ref={ref}\n        data-slot=\"schema-form-root\"\n        noValidate\n        onSubmit={handleSubmit}\n        aria-labelledby={spec.title ? headingId : undefined}\n        aria-label={spec.title ? undefined : spec.formName || t(\"ui.schemaForm.label\")}\n        className={cn(\"flex w-full flex-col gap-4\", className)}\n        {...props}\n      >\n        {children}\n      </form>\n    );\n  },\n);\n\n// ─── Title + Description ──────────────────────────────────────────────────────\n\nexport type SchemaFormTitleProps = HTMLAttributes<HTMLParagraphElement>;\n\n/** The form heading. Its id is the `<form>`'s `aria-labelledby` target. */\nexport const SchemaFormTitle = forwardRef<HTMLParagraphElement, SchemaFormTitleProps>(\n  function SchemaFormTitle({ className, children, ...props }, ref) {\n    const store = useSchemaFormStore();\n    const { headingId, spec } = useSchemaFormMeta(store);\n    const content = children ?? spec.title;\n    if (!content) return null;\n    return (\n      <p\n        ref={ref}\n        id={headingId}\n        className={cn(\"text-subtitle text-foreground text-balance\", className)}\n        {...props}\n      >\n        {content}\n      </p>\n    );\n  },\n);\n\nexport type SchemaFormDescriptionProps = HTMLAttributes<HTMLParagraphElement>;\n\n/** Supplemental description under the title. */\nexport const SchemaFormDescription = forwardRef<HTMLParagraphElement, SchemaFormDescriptionProps>(\n  function SchemaFormDescription({ className, children, ...props }, ref) {\n    const store = useSchemaFormStore();\n    const { spec } = useSchemaFormMeta(store);\n    const content = children ?? spec.description;\n    if (!content) return null;\n    return (\n      <p\n        ref={ref}\n        className={cn(\"text-body text-muted-foreground text-pretty\", className)}\n        {...props}\n      >\n        {content}\n      </p>\n    );\n  },\n);\n\n// ─── Fallback ─────────────────────────────────────────────────────────────────\n\nexport interface SchemaFormFallbackProps extends HTMLAttributes<HTMLDivElement> {\n  /** Short human reason the form could not render. */\n  message?: string;\n}\n\n/**\n * Shown when the spec is unusable. Mirrors `MessageFormFallback`: a calm,\n * bordered status box with a short reason — never a thrown error.\n */\nexport const SchemaFormFallback = forwardRef<HTMLDivElement, SchemaFormFallbackProps>(\n  function SchemaFormFallback(\n    { message = \"This form could not be displayed.\", className, ...props },\n    ref,\n  ) {\n    return (\n      <div\n        ref={ref}\n        role=\"status\"\n        aria-live=\"polite\"\n        data-slot=\"schema-form-fallback\"\n        className={cn(\n          // Sole structural cue is the border (no fill) — reads in every theme.\n          \"flex items-center justify-center rounded-md border border-border-strong px-4 py-6 text-center text-body text-muted-foreground\",\n          className,\n        )}\n        {...props}\n      >\n        {message}\n      </div>\n    );\n  },\n);\n\n// ─── Root convenience component ────────────────────────────────────────────────\n\nexport interface SchemaFormProps extends Omit<\n  HTMLAttributes<HTMLDivElement>,\n  \"onSubmit\" | \"onChange\" | \"title\"\n> {\n  /** The serializable form specification. */\n  spec: FormSpec | unknown;\n  /** Controlled values (`{ [fieldName]: value }`). Omit for uncontrolled. */\n  values?: FormValues;\n  /** Called with the next full values object on any change. */\n  onChange?: (values: FormValues) => void;\n  /** Called with `{ formName, values }` on a valid submit. */\n  onSubmit?: (state: FormSubmitState) => void;\n  /** Submit button label (overrides `spec.submitLabel`). */\n  submitLabel?: string;\n  /** Disable every control (the whole form is read-only). */\n  disabled?: boolean;\n  /** Terminal submitted state: inert, values visible, submit replaced. */\n  submitted?: boolean;\n  /** In-flight submit: controls transiently blocked, spinner on submit. */\n  submitting?: boolean;\n  /** No fields to render yet (spec still loading) → skeleton. */\n  loading?: boolean;\n  /** A terminal, form-level submission error rendered above the submit control. */\n  error?: ReactNode;\n}\n\n/**\n * Convenience composition: `Provider → Root(form) → title/description →\n * Fields → Error → Submit`. For a custom layout, compose `SchemaFormProvider`\n * + the parts. A malformed spec renders `SchemaFormFallback` (never throws).\n */\nexport const SchemaForm = forwardRef<HTMLDivElement, SchemaFormProps>(function SchemaForm(\n  {\n    spec,\n    values,\n    onChange,\n    onSubmit,\n    submitLabel,\n    disabled,\n    submitted,\n    submitting,\n    loading,\n    error,\n    className,\n    ...props\n  },\n  ref,\n) {\n  // Memoized on `spec`'s reference: a parent re-rendering with the SAME spec\n  // object (the common case once a spec is loaded) must not re-walk/re-\n  // validate it on every keystroke elsewhere in the app — `SchemaFormStore`\n  // itself already relies on `spec` reference-equality to skip its own\n  // recompute (see `syncProps`), so this keeps that contract meaningful one\n  // level up.\n  const result = useMemo(() => normalizeFormSpec(spec), [spec]);\n  if (!result.ok) {\n    return (\n      <SchemaFormFallback ref={ref} message={result.reason} className={className} {...props} />\n    );\n  }\n\n  const normalized = result.spec;\n  const empty = normalized.fields.length === 0;\n\n  if (empty && !loading) {\n    return (\n      <SchemaFormFallback\n        ref={ref}\n        message=\"This form has no fields to fill in.\"\n        className={className}\n        {...props}\n      />\n    );\n  }\n\n  return (\n    <SchemaFormProvider\n      spec={normalized}\n      values={values}\n      onChange={onChange}\n      onSubmit={onSubmit}\n      disabled={disabled}\n      submitted={submitted}\n      submitting={submitting}\n      loading={loading}\n      error={error}\n    >\n      <div ref={ref} data-slot=\"schema-form\" className={cn(\"w-full\", className)} {...props}>\n        <SchemaFormRoot>\n          {(normalized.title || normalized.description) && (\n            <div className=\"flex flex-col gap-1\">\n              <SchemaFormTitle />\n              <SchemaFormDescription />\n            </div>\n          )}\n          <SchemaFormFields />\n          <SchemaFormError />\n          <SchemaFormSubmit label={submitLabel} />\n        </SchemaFormRoot>\n      </div>\n    </SchemaFormProvider>\n  );\n});\n"],"mappings":"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","names":["SchemaFormField","SchemaFormFields","SchemaFormError","SchemaFormSubmit","SchemaFormTestAction","SchemaFormRoot","SchemaFormTitle","SchemaFormDescription","SchemaFormFallback","SchemaForm"]}

package/dist/chunk-BPXLHGWI.js

@@ -0,0 +1,54 @@
+"use client";
+import {
+  illustrationAccent,
+  illustrationSvgProps
+} from "./chunk-A47AZPCL.js";
+
+// src/illustrations/no-access-illustration.tsx
+import { forwardRef } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var NoAccessIllustration = forwardRef(
+  function NoAccessIllustration2({ size, className, ...props }, ref) {
+    return /* @__PURE__ */ jsxs(
+      "svg",
+      {
+        ref,
+        ...illustrationSvgProps(size, className),
+        "data-slot": "no-access-illustration",
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx("path", { d: "M50,72 V52 A30,20 0 0 1 110,52 V72" }),
+          /* @__PURE__ */ jsx("rect", { x: "36", y: "72", width: "88", height: "48", rx: "10" }),
+          /* @__PURE__ */ jsx(
+            "circle",
+            {
+              cx: "80",
+              cy: "92",
+              r: "6",
+              style: { stroke: illustrationAccent("var(--primary-text)") },
+              strokeWidth: 3
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "rect",
+            {
+              x: "77",
+              y: "98",
+              width: "6",
+              height: "12",
+              rx: "2",
+              style: { stroke: illustrationAccent("var(--primary-text)") },
+              strokeWidth: 3
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+NoAccessIllustration.displayName = "NoAccessIllustration";
+
+export {
+  NoAccessIllustration
+};
+//# sourceMappingURL=chunk-BPXLHGWI.js.map

package/dist/chunk-BPXLHGWI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/illustrations/no-access-illustration.tsx"],"sourcesContent":["import { forwardRef } from \"react\";\nimport {\n  illustrationSvgProps,\n  illustrationAccent,\n  type IllustrationProps,\n} from \"./illustration-base\";\n\n/**\n * Permission / access-denied state. A line-art padlock with a `--primary-text`\n * keyhole — reads as \"restricted\", not \"broken\". The keyhole is meaning-bearing\n * (per the accent-semantics convention in `illustration-base.tsx`, #48\n * finding 1) — it's what distinguishes a padlock from a generic rounded box.\n */\nexport const NoAccessIllustration = forwardRef<SVGSVGElement, IllustrationProps>(\n  function NoAccessIllustration({ size, className, ...props }, ref) {\n    return (\n      <svg\n        ref={ref}\n        {...illustrationSvgProps(size, className)}\n        data-slot=\"no-access-illustration\"\n        {...props}\n      >\n        <path d=\"M50,72 V52 A30,20 0 0 1 110,52 V72\" />\n        <rect x=\"36\" y=\"72\" width=\"88\" height=\"48\" rx=\"10\" />\n        <circle\n          cx=\"80\"\n          cy=\"92\"\n          r=\"6\"\n          style={{ stroke: illustrationAccent(\"var(--primary-text)\") }}\n          strokeWidth={3}\n        />\n        <rect\n          x=\"77\"\n          y=\"98\"\n          width=\"6\"\n          height=\"12\"\n          rx=\"2\"\n          style={{ stroke: illustrationAccent(\"var(--primary-text)\") }}\n          strokeWidth={3}\n        />\n      </svg>\n    );\n  },\n);\nNoAccessIllustration.displayName = \"NoAccessIllustration\";\n"],"mappings":";;;;;;;AAAA,SAAS,kBAAkB;AAgBrB,SAME,KANF;AAHC,IAAM,uBAAuB;AAAA,EAClC,SAASA,sBAAqB,EAAE,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK;AAChE,WACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACC,GAAG,qBAAqB,MAAM,SAAS;AAAA,QACxC,aAAU;AAAA,QACT,GAAG;AAAA,QAEJ;AAAA,8BAAC,UAAK,GAAE,sCAAqC;AAAA,UAC7C,oBAAC,UAAK,GAAE,MAAK,GAAE,MAAK,OAAM,MAAK,QAAO,MAAK,IAAG,MAAK;AAAA,UACnD;AAAA,YAAC;AAAA;AAAA,cACC,IAAG;AAAA,cACH,IAAG;AAAA,cACH,GAAE;AAAA,cACF,OAAO,EAAE,QAAQ,mBAAmB,qBAAqB,EAAE;AAAA,cAC3D,aAAa;AAAA;AAAA,UACf;AAAA,UACA;AAAA,YAAC;AAAA;AAAA,cACC,GAAE;AAAA,cACF,GAAE;AAAA,cACF,OAAM;AAAA,cACN,QAAO;AAAA,cACP,IAAG;AAAA,cACH,OAAO,EAAE,QAAQ,mBAAmB,qBAAqB,EAAE;AAAA,cAC3D,aAAa;AAAA;AAAA,UACf;AAAA;AAAA;AAAA,IACF;AAAA,EAEJ;AACF;AACA,qBAAqB,cAAc;","names":["NoAccessIllustration"]}

package/dist/chunk-BTBYNKT4.js

@@ -0,0 +1,2 @@
+"use client";
+//# sourceMappingURL=chunk-BTBYNKT4.js.map

package/dist/chunk-BTBYNKT4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-BWL7HWEF.js

@@ -0,0 +1,325 @@
+"use client";
+import {
+  collectValidatableFields,
+  initialFormValues,
+  isFieldVisible,
+  validateForm
+} from "./chunk-TNOANK34.js";
+
+// src/components/schema-form/schema-form-store.ts
+import { useCallback, useSyncExternalStore } from "react";
+function effectiveValue(field, values) {
+  const v = values[field.name];
+  if (v !== void 0) return v;
+  if (field.type === "group") return field.default ?? field.groups[0]?.key;
+  if ("default" in field && field.default !== void 0) return field.default;
+  if (field.type === "boolean") return false;
+  if (field.type === "multi-enum" || field.type === "list") return [];
+  if (field.type === "key-value") return [];
+  if (field.type === "file") return [];
+  return void 0;
+}
+function stripFields(fields, values) {
+  for (const field of fields) {
+    delete values[field.name];
+    if (field.type === "group") {
+      for (const group of field.groups) stripFields(group.fields, values);
+    }
+  }
+}
+function activeTabBranch(field, activeKey) {
+  const key = typeof activeKey === "string" ? activeKey : void 0;
+  return field.groups.find((g) => g.key === key) ?? field.groups.find((g) => g.key === field.default) ?? field.groups[0];
+}
+function computeMergedValues(fields, base) {
+  const merged = { ...base };
+  const fill = (fs) => {
+    for (const field of fs) {
+      if (!isFieldVisible(field, merged)) {
+        delete merged[field.name];
+        if (field.type === "group") {
+          for (const group of field.groups) stripFields(group.fields, merged);
+        }
+        continue;
+      }
+      merged[field.name] = effectiveValue(field, merged);
+      if (field.type !== "group") continue;
+      if (field.variant === "tabs") {
+        const active = activeTabBranch(field, merged[field.name]);
+        for (const group of field.groups) {
+          if (group === active) fill(group.fields);
+          else stripFields(group.fields, merged);
+        }
+      } else {
+        for (const group of field.groups) fill(group.fields);
+      }
+    }
+  };
+  fill(fields);
+  return merged;
+}
+function branchHasError(fields, errors) {
+  for (const field of fields) {
+    if (errors[field.name]) return true;
+    if (field.type === "group") {
+      for (const group of field.groups) {
+        if (branchHasError(group.fields, errors)) return true;
+      }
+    }
+  }
+  return false;
+}
+function buildFieldMap(fields) {
+  const map = /* @__PURE__ */ new Map();
+  const walk = (fs) => {
+    for (const field of fs) {
+      map.set(field.name, field);
+      if (field.type === "group") {
+        for (const group of field.groups) walk(group.fields);
+      }
+    }
+  };
+  walk(fields);
+  return map;
+}
+function sameNames(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
+var EMPTY_ERRORS = {};
+function sameFieldValue(a, b) {
+  if (Object.is(a, b)) return true;
+  return Array.isArray(a) && Array.isArray(b) && a.length === 0 && b.length === 0;
+}
+function fieldSnapshotEqual(a, b) {
+  return sameFieldValue(a.value, b.value) && a.invalid === b.invalid && a.errorText === b.errorText && a.visible === b.visible && a.disabled === b.disabled && a.readOnly === b.readOnly;
+}
+function metaEqual(a, b) {
+  return a.spec === b.spec && a.formId === b.formId && a.headingId === b.headingId && a.disabled === b.disabled && a.submitted === b.submitted && a.submitting === b.submitting && a.loading === b.loading && a.error === b.error && a.attempted === b.attempted;
+}
+var SchemaFormStore = class {
+  props;
+  internalValues;
+  attempted = false;
+  listeners = /* @__PURE__ */ new Set();
+  pendingFocusListeners = /* @__PURE__ */ new Set();
+  formId;
+  headingId;
+  mergedCache = null;
+  errorsCache = null;
+  metaCache = null;
+  fieldMapCache = null;
+  fieldSnapshotCache = /* @__PURE__ */ new Map();
+  namesCache = /* @__PURE__ */ new WeakMap();
+  constructor(props, formId) {
+    this.props = props;
+    this.formId = formId;
+    this.headingId = `${formId}-title`;
+    this.internalValues = initialFormValues(props.spec.fields);
+  }
+  subscribe = (listener) => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+  /** Fires once, with the field's own name, whenever an invalid submit should move focus to it. */
+  onPendingFocus(listener) {
+    this.pendingFocusListeners.add(listener);
+    return () => {
+      this.pendingFocusListeners.delete(listener);
+    };
+  }
+  emit() {
+    for (const listener of this.listeners) listener();
+  }
+  /**
+   * Sync the latest render's props/closures. Called unconditionally on every
+   * `SchemaFormProvider` render, DURING that render (not an effect) — so a
+   * non-memoized descendant re-rendering in this SAME pass (`SchemaFormRoot`,
+   * `SchemaFormFields`, …) reads the fresh values via `getMeta`/
+   * `getFieldSnapshot`, not last render's. It deliberately does NOT call
+   * `emit()` itself — that would call an already-mounted, `memo`-wrapped
+   * `SchemaFormField`'s `useSyncExternalStore` listener synchronously WHILE
+   * `SchemaFormProvider` (a different component) is still rendering, which
+   * React explicitly disallows ("Cannot update a component while rendering a
+   * different component"). The caller instead reads the returned `changed`
+   * flag and calls `notify()` from a `useLayoutEffect` — i.e. after this
+   * whole render has committed — to wake any memoized subscriber that this
+   * render's own top-down reconciliation skipped over.
+   */
+  syncProps(next) {
+    const prev = this.props;
+    const formNameChanged = next.spec.formName !== prev.spec.formName;
+    this.props = next;
+    if (next.valuesProp === void 0 && formNameChanged) {
+      this.internalValues = initialFormValues(next.spec.fields);
+    }
+    return formNameChanged || prev.spec !== next.spec || prev.valuesProp !== next.valuesProp || prev.disabled !== next.disabled || prev.submitted !== next.submitted || prev.submitting !== next.submitting || prev.loading !== next.loading || prev.error !== next.error;
+  }
+  /** Wakes every subscriber outside of any component's render phase (see `syncProps`). */
+  notify() {
+    this.emit();
+  }
+  get isControlled() {
+    return this.props.valuesProp !== void 0;
+  }
+  getFieldMap() {
+    const fields = this.props.spec.fields;
+    if (this.fieldMapCache && this.fieldMapCache.fields === fields) return this.fieldMapCache.map;
+    const map = buildFieldMap(fields);
+    this.fieldMapCache = { fields, map };
+    return map;
+  }
+  getField(name) {
+    return this.getFieldMap().get(name);
+  }
+  getValues() {
+    return this.isControlled ? this.props.valuesProp : this.internalValues;
+  }
+  /** The merged/stripped values every visibility check and submit resolves against. Reference-stable when nothing changed (SchemaFormTestAction relies on this to detect a stale in-flight test). */
+  getEffectiveValues() {
+    const base = this.getValues();
+    const fields = this.props.spec.fields;
+    if (this.mergedCache && this.mergedCache.base === base && this.mergedCache.fields === fields) {
+      return this.mergedCache.result;
+    }
+    const result = computeMergedValues(fields, base);
+    this.mergedCache = { base, fields, result };
+    return result;
+  }
+  /** Empty until the first submit attempt (`EMPTY_ERRORS`, a stable reference); live-updates after. */
+  getErrors() {
+    if (!this.attempted) return EMPTY_ERRORS;
+    const merged = this.getEffectiveValues();
+    const fields = this.props.spec.fields;
+    if (this.errorsCache && this.errorsCache.merged === merged && this.errorsCache.fields === fields && this.errorsCache.attempted === this.attempted) {
+      return this.errorsCache.result;
+    }
+    const result = validateForm(fields, merged);
+    this.errorsCache = { merged, fields, attempted: this.attempted, result };
+    return result;
+  }
+  /** The slow-changing, form-wide flags — cached so ordinary typing never changes this object's reference. */
+  getMeta() {
+    const next = {
+      spec: this.props.spec,
+      formId: this.formId,
+      headingId: this.headingId,
+      disabled: this.props.disabled,
+      submitted: this.props.submitted,
+      submitting: this.props.submitting,
+      loading: this.props.loading,
+      error: this.props.error,
+      attempted: this.attempted
+    };
+    if (this.metaCache && metaEqual(this.metaCache, next)) return this.metaCache;
+    this.metaCache = next;
+    return next;
+  }
+  /** One field's reactive data. Cached per name — returns the SAME object when nothing about this field changed, so `useSyncExternalStore` bails out of re-rendering it. */
+  getFieldSnapshot(name) {
+    const field = this.getField(name);
+    const merged = this.getEffectiveValues();
+    const values = this.getValues();
+    const errors = this.getErrors();
+    const errorText = errors[name] ?? null;
+    const next = {
+      value: field ? effectiveValue(field, values) : void 0,
+      invalid: Boolean(errorText),
+      errorText,
+      visible: field ? isFieldVisible(field, merged) : false,
+      disabled: this.props.disabled || this.props.submitted || this.props.submitting,
+      readOnly: this.props.submitted
+    };
+    const prev = this.fieldSnapshotCache.get(name);
+    if (prev && fieldSnapshotEqual(prev, next)) return prev;
+    this.fieldSnapshotCache.set(name, next);
+    return next;
+  }
+  /**
+   * Names of `fields` that are currently visible (top-level filter of
+   * exactly that array — a `group`'s own branches call this again with
+   * their OWN `fields`, which is what lets a branch react to a nested
+   * `visibleWhen` independent of its ancestor `SchemaFormField`'s own
+   * re-render). Cached by array reference, so a caller whose visible SET
+   * didn't change gets back the SAME array across an unrelated keystroke.
+   */
+  getVisibleNames(fields) {
+    const effective = this.getEffectiveValues();
+    const cached = this.namesCache.get(fields);
+    if (cached && cached.effective === effective) return cached.names;
+    const names = fields.filter((field) => isFieldVisible(field, effective)).map((field) => field.name);
+    const stable = cached && sameNames(cached.names, names) ? cached.names : names;
+    this.namesCache.set(fields, { effective, names: stable });
+    return stable;
+  }
+  getBranchHasError(fields) {
+    return branchHasError(fields, this.getErrors());
+  }
+  setValue = (name, value) => {
+    const base = this.getValues();
+    const next = { ...base, [name]: value };
+    if (!this.isControlled) this.internalValues = next;
+    this.props.onChange?.(next);
+    this.emit();
+  };
+  submit = () => {
+    this.attempted = true;
+    const merged = this.getEffectiveValues();
+    const errs = validateForm(this.props.spec.fields, merged);
+    const invalidNames = Object.keys(errs).filter((n) => errs[n]);
+    if (invalidNames.length > 0) {
+      const firstInvalid = collectValidatableFields(this.props.spec.fields, merged).find(
+        (f) => errs[f.name]
+      );
+      this.emit();
+      if (firstInvalid) {
+        for (const listener of this.pendingFocusListeners) listener(firstInvalid.name);
+      }
+      return;
+    }
+    this.emit();
+    this.props.onSubmit?.({ formName: this.props.spec.formName, values: merged });
+  };
+  reset = () => {
+    this.attempted = false;
+    const seeded = initialFormValues(this.props.spec.fields);
+    if (!this.isControlled) this.internalValues = seeded;
+    this.props.onChange?.(seeded);
+    this.emit();
+  };
+};
+function useSchemaFormMeta(store) {
+  const getSnapshot = useCallback(() => store.getMeta(), [store]);
+  return useSyncExternalStore(store.subscribe, getSnapshot);
+}
+function useFieldSnapshot(store, name) {
+  const getSnapshot = useCallback(() => store.getFieldSnapshot(name), [store, name]);
+  return useSyncExternalStore(store.subscribe, getSnapshot);
+}
+function useEffectiveValues(store) {
+  const getSnapshot = useCallback(() => store.getEffectiveValues(), [store]);
+  return useSyncExternalStore(store.subscribe, getSnapshot);
+}
+function useVisibleFieldNames(store, fields) {
+  const getSnapshot = useCallback(() => store.getVisibleNames(fields), [store, fields]);
+  return useSyncExternalStore(store.subscribe, getSnapshot);
+}
+function useBranchHasError(store, fields) {
+  const getSnapshot = useCallback(() => store.getBranchHasError(fields), [store, fields]);
+  return useSyncExternalStore(store.subscribe, getSnapshot);
+}
+
+export {
+  SchemaFormStore,
+  useSchemaFormMeta,
+  useFieldSnapshot,
+  useEffectiveValues,
+  useVisibleFieldNames,
+  useBranchHasError
+};
+//# sourceMappingURL=chunk-BWL7HWEF.js.map