@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,240 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * FormFieldRecord Component
+ *
+ * Handles z.record() and z.map() schema types.
+ * Renders a dynamic list of key-value pairs with add/remove controls.
+ *
+ * ## Architecture
+ *
+ * **Single source of truth: RHF.**
+ *
+ * The record is stored in RHF as a plain object at the field path (e.g., `metadata`).
+ * Each value is rendered via `FormField` at `${name}.${key}`, which binds to RHF
+ * via Controller. This means every value gets the full FormField infrastructure:
+ * validation, autosave, error display, decorator handling, type-specific rendering.
+ *
+ * This component only manages:
+ * - The ordered list of entry IDs and keys (for rendering order and key editing)
+ * - Syncing the record structure to RHF on key changes, adds, and removes
+ *
+ * Value changes flow directly through FormField → RHF, never through this component.
+ *
+ * ## Key Lifecycle
+ *
+ * - **Empty key**: Placeholder shown instead of FormField (no valid RHF path).
+ *   A default value is held locally until the key is committed.
+ * - **Key rename**: Value is read from old RHF path, record is rebuilt at parent
+ *   level with the new key, FormField remounts at the new path.
+ * - **Key uniqueness**: Computed per-render, duplicate keys show inline error.
+ */
+import { useCallback, useRef, useEffect, useState, useMemo } from 'react';
+import { z } from 'zod';
+import { useFormContext } from 'react-hook-form';
+import { FormFieldChrome } from '../chromes/FormFieldChrome.js';
+import { useUI } from '../../../core/ui/useUI.js';
+import { useIconRegistry } from '../../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { cn } from '../../../core/ui/cn.js';
+import { FieldSet, FieldLegend, FieldDescription as FieldSetDescription, FieldGroup, } from '../../../components/form/chromes/field.js';
+import { Input } from '../../../components/form/controls/input.js';
+import { FormField } from './FormField.js';
+import { DUPLICATE_KEY_ERROR_TYPE } from '../form-context.js';
+import { useOptionalAutosave } from './AutosaveContext.js';
+import { AutosaveTrigger } from '@wildo-ai/zod-decorators';
+import { AutomatedLayoutFrontendUtils } from '../../../core/automated-layout/automated-layout.frontend.utils.js';
+import { FrontendComponentType, UIBehavior, TypographyVariant } from '@wildo-ai/presets-components-models';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+// =============================================================================
+// HELPERS
+// =============================================================================
+let entryIdCounter = 0;
+function generateEntryId() {
+    return `kv-${++entryIdCounter}-${Date.now()}`;
+}
+/**
+ * Initialize entries from an existing RHF record value.
+ * Preserves insertion order from Object.entries.
+ */
+function recordToEntries(record) {
+    if (!record || typeof record !== 'object') {
+        return [];
+    }
+    return Object.entries(record).map(([key]) => ({
+        id: generateEntryId(),
+        key,
+        pendingValue: undefined, // Value is already in RHF
+    }));
+}
+/**
+ * Build a record object from entries, reading current values from RHF.
+ *
+ * @param entries - Current entries list
+ * @param parentName - RHF field path for the record (e.g., "metadata")
+ * @param getValues - RHF getValues function
+ * @param valueOverrides - Map of entryId → value for entries where RHF doesn't
+ *   have the right value yet (e.g., key renames, new entries)
+ */
+function buildRecord(entries, parentName, getValues, valueOverrides) {
+    const record = {};
+    for (const entry of entries) {
+        const trimmedKey = entry.key.trim();
+        if (trimmedKey === '')
+            continue;
+        // Use override if provided (key rename or new entry), otherwise read from RHF
+        if (valueOverrides?.has(entry.id)) {
+            record[trimmedKey] = valueOverrides.get(entry.id);
+        }
+        else {
+            const rhfValue = getValues(`${parentName}.${trimmedKey}`);
+            record[trimmedKey] = rhfValue !== undefined ? rhfValue : entry.pendingValue;
+        }
+    }
+    return record;
+}
+function KeyValueRow({ entry, index, valueSchema, parentName, disabled, canRemove, keyError, onKeyChange, onRemove, keyLabel, valueLabel, emptyKeyPlaceholder, renderIcon, }) {
+    const { getRecipe } = useUI();
+    const descriptionRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.DESCRIPTION);
+    const handleKeyInputChange = useCallback((newKey) => {
+        onKeyChange(entry.id, newKey);
+    }, [entry.id, onKeyChange]);
+    const hasKey = entry.key.trim() !== '';
+    return (_jsxs("div", { className: "relative rounded-lg border border-border p-card", "data-testid": `record-entry-${index}`, children: [canRemove && (_jsx(Button, { type: "button", variant: ButtonVariants_Variant.GHOST, size: ButtonSize.ICON, onClick: () => onRemove(entry.id), disabled: disabled, className: "absolute -top-3 right-3 h-6 w-6 bg-background", "aria-label": `Remove entry ${entry.key || index + 1}`, children: renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM }) })), _jsxs("div", { className: "pt-item space-y-field", children: [_jsx(FormFieldChrome, { label: keyLabel, error: keyError, fieldName: `${parentName}.__key_${entry.id}`, disabled: disabled, children: _jsx(Input, { schema: z.string(), name: `${parentName}.__key_${entry.id}`, value: entry.key, onChange: (v) => handleKeyInputChange(String(v)), disabled: disabled }) }), hasKey ? (_jsx(FormField, { name: `${parentName}.${entry.key}`, schema: valueSchema, label: valueLabel, disabled: disabled })) : (_jsx("p", { className: cn(descriptionRecipe.base, "py-card-sm px-card-sm rounded-md border border-dashed border-border"), children: emptyKeyPlaceholder }))] })] }));
+}
+// =============================================================================
+// MAIN COMPONENT
+// =============================================================================
+/**
+ * Renders fields for z.record() and z.map() schemas.
+ *
+ * Entries track key order and identity. Values live in RHF,
+ * rendered by FormField at `${name}.${key}` for full infrastructure support.
+ */
+function FormFieldRecordComponent({ name, schema, label, description, disabled, className, valueSchema, keySchema, }) {
+    const { setValue, getValues, trigger, setError, clearErrors, getFieldState, formState } = useFormContext();
+    const { renderIcon } = useIconRegistry();
+    const autosaveContext = useOptionalAutosave();
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_MESSAGE });
+    const { getRecipe } = useUI();
+    const descriptionRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.DESCRIPTION);
+    // Resolve i18n labels
+    const addLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'recordAddEntry');
+    const keyLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'recordKeyLabel');
+    const valueLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'recordValueLabel');
+    const emptyMessage = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'recordEmptyMessage');
+    const duplicateKeyMessage = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'recordDuplicateKey');
+    const emptyKeyPlaceholder = tComponent(FrontendComponentType.LOW_LEVEL_FORM_MESSAGE, 'recordEnterKeyFirst');
+    // Track mounted state to prevent operations after unmount
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        return () => { mountedRef.current = false; };
+    }, []);
+    // Internal entries state — tracks key order and identity only.
+    // Initialized from the current RHF record value.
+    const [entries, setEntries] = useState(() => {
+        const currentValue = getValues(name);
+        return recordToEntries(currentValue);
+    });
+    // Compute duplicate keys for validation display
+    const duplicateKeys = useMemo(() => {
+        const keyCounts = new Map();
+        for (const entry of entries) {
+            const trimmed = entry.key.trim();
+            if (trimmed !== '') {
+                keyCounts.set(trimmed, (keyCounts.get(trimmed) || 0) + 1);
+            }
+        }
+        const duplicates = new Set();
+        for (const [key, count] of keyCounts) {
+            if (count > 1)
+                duplicates.add(key);
+        }
+        return duplicates;
+    }, [entries]);
+    useEffect(() => {
+        if (duplicateKeys.size > 0) {
+            setError(name, { type: DUPLICATE_KEY_ERROR_TYPE, message: duplicateKeyMessage });
+        }
+        else {
+            const currentError = getFieldState(name, formState).error;
+            if (currentError?.type === DUPLICATE_KEY_ERROR_TYPE) {
+                clearErrors(name);
+            }
+        }
+    }, [duplicateKeys, name, setError, clearErrors, getFieldState, formState, duplicateKeyMessage]);
+    /**
+     * Sync the record structure to RHF.
+     * Reads current values from RHF for each entry, optionally overriding specific entries.
+     */
+    const syncRecordToRHF = useCallback((updatedEntries, valueOverrides) => {
+        const record = buildRecord(updatedEntries, name, getValues, valueOverrides);
+        setValue(name, record, { shouldDirty: true, shouldValidate: true });
+        if (autosaveContext) {
+            autosaveContext.triggerSave(name, record, AutosaveTrigger.DEBOUNCE);
+        }
+        setTimeout(() => {
+            if (mountedRef.current) {
+                trigger(name);
+            }
+        }, 0);
+    }, [name, setValue, getValues, trigger, autosaveContext]);
+    /**
+     * Handle key change.
+     * Reads the value from the old RHF path and writes it to the new key.
+     */
+    const handleKeyChange = useCallback((id, newKey) => {
+        setEntries(prev => {
+            const entry = prev.find(e => e.id === id);
+            if (!entry)
+                return prev;
+            const oldKey = entry.key.trim();
+            // Read value from old RHF path (FormField may have changed it)
+            // Fall back to pendingValue for entries that were never committed to RHF
+            const currentValue = oldKey !== ''
+                ? getValues(`${name}.${oldKey}`)
+                : entry.pendingValue;
+            const updated = prev.map(e => e.id === id ? { ...e, key: newKey, pendingValue: currentValue } : e);
+            // Rebuild the record. Override the renamed entry with the value we just read.
+            const overrides = new Map([[id, currentValue]]);
+            syncRecordToRHF(updated, overrides);
+            return updated;
+        });
+    }, [name, getValues, syncRecordToRHF]);
+    // Handle add entry
+    const handleAdd = useCallback(() => {
+        if (disabled)
+            return;
+        const newEntry = {
+            id: generateEntryId(),
+            key: '',
+            pendingValue: AutomatedLayoutFrontendUtils.getDefaultValueForSchema(valueSchema),
+        };
+        setEntries(prev => {
+            const updated = [...prev, newEntry];
+            // Don't sync to RHF yet — entry has empty key, nothing to write
+            return updated;
+        });
+    }, [disabled, valueSchema]);
+    // Handle remove entry
+    const handleRemove = useCallback((id) => {
+        if (disabled)
+            return;
+        setEntries(prev => {
+            const updated = prev.filter(e => e.id !== id);
+            syncRecordToRHF(updated);
+            return updated;
+        });
+    }, [disabled, syncRecordToRHF]);
+    return (_jsxs(FieldSet, { disabled: disabled, className: className, "data-field": name, "data-testid": `field-record-${name}`, children: [_jsx(FieldLegend, { children: label }), description && _jsx(FieldSetDescription, { children: description }), _jsxs(FieldGroup, { className: "space-y-field", children: [entries.map((entry, index) => {
+                        const keyTrimmed = entry.key.trim();
+                        const keyError = keyTrimmed !== '' && duplicateKeys.has(keyTrimmed)
+                            ? duplicateKeyMessage
+                            : undefined;
+                        return (_jsx(KeyValueRow, { entry: entry, index: index, valueSchema: valueSchema, parentName: name, disabled: disabled, canRemove: !disabled, keyError: keyError, onKeyChange: handleKeyChange, onRemove: handleRemove, keyLabel: keyLabel, valueLabel: valueLabel, emptyKeyPlaceholder: emptyKeyPlaceholder, renderIcon: renderIcon }, entry.id));
+                    }), _jsxs(Button, { type: "button", variant: ButtonVariants_Variant.OUTLINE, onClick: handleAdd, disabled: disabled, className: "w-full", children: [renderIcon(StandardIconReference.PLUS, { size: IconSize.SM, className: "me-element" }), addLabel] }), entries.length === 0 && (_jsx("p", { className: cn(descriptionRecipe.base, "text-center py-card"), children: emptyMessage }))] })] }));
+}
+FormFieldRecordComponent.displayName = 'FormFieldRecord';
+export const FormFieldRecord = FormFieldRecordComponent;
+//# sourceMappingURL=FormFieldRecord.js.map

package/dist/esm/components/form/automated/FormFieldRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldRecord.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/FormFieldRecord.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,47 @@
+/**
+ * FormLayoutMapContext
+ *
+ * Provides nested OBJECT field layout metadata to deeply nested FormFieldComposite
+ * components. This context bridges the gap between the extraction algorithm
+ * (which correctly handles scope bubbling at any depth) and the rendering chain
+ * (which previously could only pass excludedChildKeys for root-level OBJECT fields).
+ *
+ * The map contains a NestedObjectLayoutEntry for every OBJECT-type field discovered
+ * during form layout extraction, keyed by dotted field path (e.g. "a", "a.b", "a.b.c").
+ *
+ * Each entry provides:
+ * - excludedChildKeys: child schema keys that were extracted via scope bubbling
+ * - injectedFields: fields that were bubbled TO this level from deeper OBJECT children
+ *
+ * Usage:
+ * - AutomatedForm wraps its content with <FormLayoutMapProvider>
+ * - FormFieldComposite consumes via useFormLayoutMap()
+ * - When used outside AutomatedForm (standalone), the hook returns null (graceful no-op)
+ */
+import React from 'react';
+import type { NestedObjectLayoutEntry } from '../../../core/automated-layout/automated-layout.frontend.schemas.js';
+type FormLayoutMap = Map<string, NestedObjectLayoutEntry>;
+export interface FormLayoutMapProviderProps {
+    /** The nested layout map from FormLayoutResult.nestedLayoutMap */
+    nestedLayoutMap: FormLayoutMap | undefined;
+    children: React.ReactNode;
+}
+/**
+ * Provides the nested OBJECT layout map to descendant FormFieldComposite components.
+ *
+ * When `nestedLayoutMap` is undefined (flat schema, no OBJECT nesting), the context
+ * value is null and consumers gracefully fall back to existing prop-based behavior.
+ */
+export declare function FormLayoutMapProvider({ nestedLayoutMap, children }: FormLayoutMapProviderProps): React.JSX.Element;
+/**
+ * Accesses the nested OBJECT layout map from the nearest FormLayoutMapProvider.
+ *
+ * Returns null when:
+ * - Not inside an AutomatedForm (standalone FormFieldComposite usage)
+ * - Schema has no OBJECT fields with scope bubbling (flat schema)
+ *
+ * Consumers should fall back to prop-based behavior when null.
+ */
+export declare function useFormLayoutMap(): FormLayoutMap | null;
+export {};
+//# sourceMappingURL=FormLayoutMapContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormLayoutMapContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/FormLayoutMapContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6EAA6E,CAAC;AAE3H,KAAK,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAI1D,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,eAAe,EAAE,aAAa,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQlH;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD"}

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

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * FormLayoutMapContext
+ *
+ * Provides nested OBJECT field layout metadata to deeply nested FormFieldComposite
+ * components. This context bridges the gap between the extraction algorithm
+ * (which correctly handles scope bubbling at any depth) and the rendering chain
+ * (which previously could only pass excludedChildKeys for root-level OBJECT fields).
+ *
+ * The map contains a NestedObjectLayoutEntry for every OBJECT-type field discovered
+ * during form layout extraction, keyed by dotted field path (e.g. "a", "a.b", "a.b.c").
+ *
+ * Each entry provides:
+ * - excludedChildKeys: child schema keys that were extracted via scope bubbling
+ * - injectedFields: fields that were bubbled TO this level from deeper OBJECT children
+ *
+ * Usage:
+ * - AutomatedForm wraps its content with <FormLayoutMapProvider>
+ * - FormFieldComposite consumes via useFormLayoutMap()
+ * - When used outside AutomatedForm (standalone), the hook returns null (graceful no-op)
+ */
+import { createContext, useContext, useMemo } from 'react';
+const FormLayoutMapContext = createContext(null);
+/**
+ * Provides the nested OBJECT layout map to descendant FormFieldComposite components.
+ *
+ * When `nestedLayoutMap` is undefined (flat schema, no OBJECT nesting), the context
+ * value is null and consumers gracefully fall back to existing prop-based behavior.
+ */
+export function FormLayoutMapProvider({ nestedLayoutMap, children }) {
+    const value = useMemo(() => nestedLayoutMap ?? null, [nestedLayoutMap]);
+    return (_jsx(FormLayoutMapContext.Provider, { value: value, children: children }));
+}
+/**
+ * Accesses the nested OBJECT layout map from the nearest FormLayoutMapProvider.
+ *
+ * Returns null when:
+ * - Not inside an AutomatedForm (standalone FormFieldComposite usage)
+ * - Schema has no OBJECT fields with scope bubbling (flat schema)
+ *
+ * Consumers should fall back to prop-based behavior when null.
+ */
+export function useFormLayoutMap() {
+    return useContext(FormLayoutMapContext);
+}
+//# sourceMappingURL=FormLayoutMapContext.js.map

package/dist/esm/components/form/automated/FormLayoutMapContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormLayoutMapContext.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/FormLayoutMapContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAKlE,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAQvE;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,eAAe,EAAE,QAAQ,EAA8B;IAC7F,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAExE,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACxC,QAAQ,GACqB,CACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,159 @@
+/**
+ * FormTemplateContext — carries resolved form-level values so skeleton components
+ * (FormField in name-only mode, Section, WizardLayout, etc.) can read from context.
+ *
+ * AutomatedForm provides this context inside the form render tree. Skeleton
+ * components and developer-authored templates both read from it via
+ * `useFormTemplateContext()` or `useOptionalFormTemplateContext()`.
+ *
+ * **What this context carries (and where each value comes from):**
+ *
+ * | Value                  | Source in AutomatedForm            | Template consumer |
+ * |------------------------|------------------------------------|-------------------|
+ * | schema                 | `schema` prop                      | FormField (resolves field schemas by path) |
+ * | fieldLabels            | `useResourceLabels()` hook         | FormField `label` |
+ * | fieldDescriptions      | `useResourceLabels()` hook         | FormField `description` |
+ * | fieldTooltips          | `useResourceLabels()` hook         | FormField `tooltip` |
+ * | enumLabels             | `useResourceLabels()` hook         | FormField `enumLabels` |
+ * | sectionLabels          | `useResourceLabels()` hook         | Section `legend` |
+ * | sectionDescriptions    | `useResourceLabels()` hook         | Section `description` |
+ * | groupLabels            | `useResourceLabels()` hook         | Group `title` |
+ * | wizardStepLabels       | `useResourceLabels()` hook         | WizardLayout step titles |
+ * | wizardStepDescriptions | `useResourceLabels()` hook         | WizardLayout step descriptions |
+ * | readOnly               | `readOnly` prop                    | FormField `readOnly` |
+ * | disabled               | `disabled` prop                    | Section `disabled`, FormField |
+ * | fileUploadContext      | `fileUploadContext` prop           | FormField `fileUploadContext` |
+ * | contextFieldValues     | `contextFieldValues` prop          | Generated templates hide context-owned fields |
+ * | hiddenFieldNames       | upstream wrapper shaping           | Generated templates hide wrapper-resolved fields and submit paths prune them |
+ * | generatedFieldOverrides| upstream wrapper shaping           | Standard `FormField` slots or generated templates replace raw DTO slots |
+ * | onSectionSave          | `onSectionSave` prop               | Section `saveable` handler |
+ * | operationType          | `operationType` / `operationLike`  | Field visibility |
+ * | operationRef           | `operationRef` prop                | Operation-specific field visibility |
+ * | isExisting             | operationType === 'update'         | Template conditional rendering (create vs update) |
+ *
+ * **Infrastructure responsibility split (template-only architecture):**
+ *
+ * - Form wrapper / RHF provider: `<Form>` component — not in this context
+ * - Error summary: template places `<FormErrorSummarySlot>` explicitly
+ * - Section chromeMode: `FormChromeProvider` — not in this context
+ * - Discriminator visibility: skeleton `<DiscriminatorSwitch>`
+ * - AutoFocus: `FormLayout` skeleton — not in this context
+ * - Submit filtering: `wrappedOnSubmit` in AutomatedForm — not in this context
+ * - Unsaved changes: `<Form>` wrapper — not in this context
+ * - Labels/i18n: **this context** provides resolved labels
+ * - data-guidance attributes: FormField handles internally
+ *
+ * All remaining behaviors (readOnly, disabled, fileUploadContext, onSectionSave,
+ * schema, operationType) are carried by **this context**.
+ */
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { z } from 'zod';
+import type { FileFieldEndpoints } from '@wildo-ai/zod-decorators';
+import type { FormOperationType } from '../../../core/automated-layout/automated-layout.frontend.schemas.js';
+import type { InheritanceSchemaDefinition } from '../../../core/automated-layout/automated-layout.frontend.schemas.js';
+export interface FormTemplateContextValue {
+    /** Root form schema — enables field schema resolution by name for name-only FormField usage */
+    schema: z.ZodTypeAny;
+    /** Resolved field labels (keyed by field name). Produced by useResourceLabels(). */
+    fieldLabels: Record<string, string>;
+    /** Resolved field descriptions (keyed by field name). Produced by useResourceLabels(). */
+    fieldDescriptions: Record<string, string>;
+    /** Resolved field tooltips (keyed by field name). Produced by useResourceLabels(). */
+    fieldTooltips: Record<string, string>;
+    /**
+     * Resolved enum labels per field (keyed by field name → enum value → label).
+     * Produced by useResourceLabels().
+     */
+    enumLabels: Record<string, Record<string, string>>;
+    /** Resolved section labels (keyed by section ref). Produced by useResourceLabels(). */
+    sectionLabels: Record<string, string>;
+    /** Resolved section descriptions (keyed by section ref). Produced by useResourceLabels(). */
+    sectionDescriptions: Record<string, string>;
+    /** Resolved group labels (keyed by group name). Falls back to sectionLabels if not provided. */
+    groupLabels?: Record<string, string>;
+    /** Resolved wizard step labels (keyed by step ref). Produced by useResourceLabels(). */
+    wizardStepLabels: Record<string, string>;
+    /** Resolved wizard step descriptions (keyed by step ref). Produced by useResourceLabels(). */
+    wizardStepDescriptions: Record<string, string>;
+    /**
+     * Form-level read-only flag. When true, all fields should be non-editable
+     * but their values are included in submission (unlike disabled).
+     */
+    readOnly?: boolean;
+    /** Form-level disabled flag. Fields and sections should be non-interactive. */
+    disabled?: boolean;
+    /**
+     * File upload endpoints per file field (keyed by field name).
+     * Enables resource-integrated upload/delete for file fields in the template.
+     */
+    fileUploadContext?: Record<string, FileFieldEndpoints>;
+    /**
+     * Context-derived field values injected by an outer wrapper.
+     * These are often parent/context-owned values coming from the active view.
+     *
+     * Generated templates use this to hide context-owned fields instead of rendering
+     * editable controls for values that are already fixed by the active view context.
+     */
+    contextFieldValues?: Record<string, unknown>;
+    /**
+     * Additional field names that should be hidden from generated templates after
+     * upstream wrapper shaping. Unlike `contextFieldValues`, these fields are not
+     * auto-injected into submit payloads; they are removed from the generated UI
+     * path and pruned from submit/draft payloads by `AutomatedForm`.
+     *
+     * The generic form layer treats these names as opaque inputs. Resource-aware
+     * decisions about which fields belong here should stay in
+     * `ResourceAutomatedForm` or another domain-aware wrapper.
+     */
+    hiddenFieldNames?: string[];
+    /**
+     * Generated-form replacements keyed by top-level field name. This lets the
+     * upstream preparation layer replace one field slot with a business-facing
+     * control while keeping `FormField` as the standard template slot primitive.
+     * The generic form layer mounts the override but does not derive it.
+     */
+    generatedFieldOverrides?: Record<string, ReactNode>;
+    /**
+     * Callback for saving individual sections (partial updates).
+     * Skeleton `<Section saveable>` reads this to implement section-level save.
+     */
+    onSectionSave?: (sectionRef: string, fieldNames: string[], data: Record<string, unknown>) => void | Promise<void>;
+    /**
+     * Effective operation type for field visibility rules.
+     * Resolves `operationLike || operationType` — used by isHidden/excludeFromCreate/excludeFromUpdate checks.
+     */
+    operationType?: FormOperationType;
+    /** Operation ref for operation-specific field visibility (isHidden({ operations: [...] })). */
+    operationRef?: string;
+    /**
+     * Whether the form is editing an existing resource (update) or creating a new one.
+     * Templates use this for conditional rendering (e.g., hide certain fields on create).
+     * Replaces the deleted `LayoutTemplateContext.isExisting`.
+     */
+    isExisting: boolean;
+    /** Discriminator metadata for schema-family forms. */
+    inheritanceConfig?: InheritanceSchemaDefinition;
+}
+export interface FormTemplateProviderProps {
+    value: FormTemplateContextValue;
+    children: React.ReactNode;
+}
+/**
+ * Provides form-level resolved values to the template tree.
+ * Placed by AutomatedForm inside the form render tree so that skeleton
+ * components can resolve labels, schema, and operation context.
+ */
+export declare function FormTemplateProvider({ value, children }: FormTemplateProviderProps): React.JSX.Element;
+/**
+ * Read the form template context. Throws if not inside a FormTemplateProvider.
+ * Use in components that REQUIRE AutomatedForm context (skeleton Section, etc.).
+ */
+export declare function useFormTemplateContext(): FormTemplateContextValue;
+/**
+ * Read the form template context if available, or null when outside AutomatedForm.
+ * Use in components that work both standalone and inside AutomatedForm
+ * (e.g., FormField can receive explicit props OR resolve from context).
+ */
+export declare function useOptionalFormTemplateContext(): FormTemplateContextValue | null;
+//# sourceMappingURL=FormTemplateContext.d.ts.map

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

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

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

@@ -0,0 +1,86 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * FormTemplateContext — carries resolved form-level values so skeleton components
+ * (FormField in name-only mode, Section, WizardLayout, etc.) can read from context.
+ *
+ * AutomatedForm provides this context inside the form render tree. Skeleton
+ * components and developer-authored templates both read from it via
+ * `useFormTemplateContext()` or `useOptionalFormTemplateContext()`.
+ *
+ * **What this context carries (and where each value comes from):**
+ *
+ * | Value                  | Source in AutomatedForm            | Template consumer |
+ * |------------------------|------------------------------------|-------------------|
+ * | schema                 | `schema` prop                      | FormField (resolves field schemas by path) |
+ * | fieldLabels            | `useResourceLabels()` hook         | FormField `label` |
+ * | fieldDescriptions      | `useResourceLabels()` hook         | FormField `description` |
+ * | fieldTooltips          | `useResourceLabels()` hook         | FormField `tooltip` |
+ * | enumLabels             | `useResourceLabels()` hook         | FormField `enumLabels` |
+ * | sectionLabels          | `useResourceLabels()` hook         | Section `legend` |
+ * | sectionDescriptions    | `useResourceLabels()` hook         | Section `description` |
+ * | groupLabels            | `useResourceLabels()` hook         | Group `title` |
+ * | wizardStepLabels       | `useResourceLabels()` hook         | WizardLayout step titles |
+ * | wizardStepDescriptions | `useResourceLabels()` hook         | WizardLayout step descriptions |
+ * | readOnly               | `readOnly` prop                    | FormField `readOnly` |
+ * | disabled               | `disabled` prop                    | Section `disabled`, FormField |
+ * | fileUploadContext      | `fileUploadContext` prop           | FormField `fileUploadContext` |
+ * | contextFieldValues     | `contextFieldValues` prop          | Generated templates hide context-owned fields |
+ * | hiddenFieldNames       | upstream wrapper shaping           | Generated templates hide wrapper-resolved fields and submit paths prune them |
+ * | generatedFieldOverrides| upstream wrapper shaping           | Standard `FormField` slots or generated templates replace raw DTO slots |
+ * | onSectionSave          | `onSectionSave` prop               | Section `saveable` handler |
+ * | operationType          | `operationType` / `operationLike`  | Field visibility |
+ * | operationRef           | `operationRef` prop                | Operation-specific field visibility |
+ * | isExisting             | operationType === 'update'         | Template conditional rendering (create vs update) |
+ *
+ * **Infrastructure responsibility split (template-only architecture):**
+ *
+ * - Form wrapper / RHF provider: `<Form>` component — not in this context
+ * - Error summary: template places `<FormErrorSummarySlot>` explicitly
+ * - Section chromeMode: `FormChromeProvider` — not in this context
+ * - Discriminator visibility: skeleton `<DiscriminatorSwitch>`
+ * - AutoFocus: `FormLayout` skeleton — not in this context
+ * - Submit filtering: `wrappedOnSubmit` in AutomatedForm — not in this context
+ * - Unsaved changes: `<Form>` wrapper — not in this context
+ * - Labels/i18n: **this context** provides resolved labels
+ * - data-guidance attributes: FormField handles internally
+ *
+ * All remaining behaviors (readOnly, disabled, fileUploadContext, onSectionSave,
+ * schema, operationType) are carried by **this context**.
+ */
+import { createContext, useContext } from 'react';
+// =============================================================================
+// REACT CONTEXT
+// =============================================================================
+const FormTemplateContext = createContext(null);
+/**
+ * Provides form-level resolved values to the template tree.
+ * Placed by AutomatedForm inside the form render tree so that skeleton
+ * components can resolve labels, schema, and operation context.
+ */
+export function FormTemplateProvider({ value, children }) {
+    return (_jsx(FormTemplateContext.Provider, { value: value, children: children }));
+}
+// =============================================================================
+// HOOKS
+// =============================================================================
+/**
+ * Read the form template context. Throws if not inside a FormTemplateProvider.
+ * Use in components that REQUIRE AutomatedForm context (skeleton Section, etc.).
+ */
+export function useFormTemplateContext() {
+    const ctx = useContext(FormTemplateContext);
+    if (!ctx) {
+        throw new Error('useFormTemplateContext() must be used within a <FormTemplateProvider>. ' +
+            'This is provided automatically by AutomatedForm.');
+    }
+    return ctx;
+}
+/**
+ * Read the form template context if available, or null when outside AutomatedForm.
+ * Use in components that work both standalone and inside AutomatedForm
+ * (e.g., FormField can receive explicit props OR resolve from context).
+ */
+export function useOptionalFormTemplateContext() {
+    return useContext(FormTemplateContext);
+}
+//# sourceMappingURL=FormTemplateContext.js.map

package/dist/esm/components/form/automated/FormTemplateContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormTemplateContext.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/FormTemplateContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAW,MAAM,OAAO,CAAC;AAuHlE,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,mBAAmB,GAAG,aAAa,CAAkC,IAAI,CAAC,CAAC;AAWjF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA6B;IACjF,OAAO,CACL,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACvC,QAAQ,GACoB,CAChC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,yEAAyE;YACzE,kDAAkD,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { FrontendResourceConfiguration_Operation } from '../../../core/resources/resources.frontend.schemas.js';
+import type { ResourceMutationManager } from '../../../core/resources/rmm/ResourceMutationManager.js';
+import type { RelationshipWriteSurfaceDescriptor } from '../../../core/resources/relationship-surface-runtime.frontend.utils.js';
+export interface GeneratedAssociationRelationshipFieldProps {
+    writeSurface: RelationshipWriteSurfaceDescriptor;
+    replaceOperation: FrontendResourceConfiguration_Operation;
+    initialRelationshipValue?: unknown;
+    hasHydratedInitialValue?: boolean;
+    rmm?: ResourceMutationManager | null;
+    allowDirectOperationFallback?: boolean;
+}
+export declare function GeneratedAssociationRelationshipField({ writeSurface, replaceOperation, initialRelationshipValue, hasHydratedInitialValue, rmm, allowDirectOperationFallback, }: GeneratedAssociationRelationshipFieldProps): React.JSX.Element | null;
+//# sourceMappingURL=GeneratedAssociationRelationshipField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeneratedAssociationRelationshipField.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/GeneratedAssociationRelationshipField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAazE,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAE9G,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,gFAAgF,CAAC;AAkBzI,MAAM,WAAW,0CAA0C;IACzD,YAAY,EAAE,kCAAkC,CAAC;IACjD,gBAAgB,EAAE,uCAAuC,CAAC;IAC1D,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,GAAG,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACrC,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,wBAAgB,qCAAqC,CAAC,EACpD,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,uBAA+B,EAC/B,GAAG,EACH,4BAAoC,GACrC,EAAE,0CAA0C,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAoTvE"}