npm - @webiny/app-admin - Versions diffs - 6.4.5 → 6.6.0-alpha.0 - Mend

@webiny/app-admin 6.4.5 → 6.6.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (928) hide show

package/features/formModel/abstractions.d.ts CHANGED Viewed

@@ -19,6 +19,7 @@ export interface IFieldConfig {
     note?: string;
     placeholder?: string;
     defaultValue?: unknown;
+    autoFocus?: boolean;
     renderer?: string;
     rendererSettings?: Record<string, unknown>;
     isList?: boolean;
@@ -27,7 +28,7 @@ export interface IFieldConfig {
     requiredMessage?: string;
     disabled: boolean;
     schema?: z.ZodTypeAny;
-    options?: IValueOption[] | ((form: IFormModel) => IValueOption[]);
+    options?: IValueOption[] | ((params: IFieldCallbackParams) => IValueOption[]);
     normalizeValue?: (value: unknown) => unknown;
     beforeChangeCallbacks?: BeforeChangeCallback[];
     afterChangeCallbacks?: AfterChangeCallback[];
@@ -35,19 +36,34 @@ export interface IFieldConfig {
     onBlurCallbacks?: OnBlurCallback[];
     requiredWhenCallbacks?: RequiredWhenCallback[];
     hiddenWhenCallbacks?: HiddenWhenCallback[];
+    disabledWhenCallbacks?: DisabledWhenCallback[];
     computed?: ComputedFieldCallback;
     computedUntilDirty?: ComputedFieldCallback;
     tags?: string[];
     cloneValue?: CloneValueCallback;
+    context?: FieldContextCallback;
     rules?: IRule[];
 }
+export interface IFieldScope {
+    field(name: string): IField;
+    parent(): IFieldScope;
+}
+export interface IFieldNavigator {
+    parent(): IFieldScope;
+}
+export interface IFieldCallbackParams {
+    field: IFieldNavigator;
+    form: IFormModel;
+}
 export interface IRequiredWhenCallbackConfig {
-    fn: (form: IFormModel) => boolean;
+    fn: (params: IFieldCallbackParams) => boolean;
     message?: string;
 }
 export type RequiredWhenCallback = IRequiredWhenCallbackConfig;
-export type HiddenWhenCallback = (form: IFormModel) => boolean;
-export type ComputedFieldCallback = (form: IFormModel) => unknown;
+export type HiddenWhenCallback = (params: IFieldCallbackParams) => boolean;
+export type DisabledWhenCallback = (params: IFieldCallbackParams) => boolean;
+export type ComputedFieldCallback = (params: IFieldCallbackParams) => unknown;
+export type FieldContextCallback = (params: IFieldCallbackParams) => Record<string, unknown>;
 export type RuleAction = "hide" | "disable";
 export type RuleOperator = "eq" | "neq" | "isEmpty" | "isNotEmpty" | "isTruthy" | "isFalsy" | "matches";
 export interface IRule {
@@ -79,6 +95,7 @@ export interface IFieldVM {
     description?: string;
     note?: string;
     placeholder?: string;
+    autoFocus?: boolean;
     value: unknown;
     validation: IFieldValidation;
     validating: boolean;
@@ -95,6 +112,7 @@ export interface IFieldVM {
     removeItem: (index: number) => void;
     focusRequested: boolean;
     clearFocusRequest: () => void;
+    context: Record<string, unknown>;
 }
 export interface IObjectFieldVM extends IFieldVM {
     type: "object";
@@ -123,6 +141,8 @@ export interface IObjectFieldVM extends IFieldVM {
     activeTemplateId: string | null;
     /** Switch to a different template. Discards values not present in the new template. */
     setTemplate: (templateId: string) => void;
+    /** Returns a cloned copy of the current single-value data with cloneValue transforms applied. */
+    getClonedData: () => Record<string, unknown>;
 }
 export interface IObjectFieldItemVM {
     key: string;
@@ -137,6 +157,7 @@ export interface IObjectFieldItemVM {
     moveUp: () => void;
     moveDown: () => void;
     duplicate: () => void;
+    getClonedData: () => Record<string, unknown>;
     /** The template id of this item, if the parent list is templated. */
     templateId?: string;
 }
@@ -182,7 +203,7 @@ export interface IField {
      * form state. The built-in `.required()` flag (if set) always counts as a
      * truthy check and cannot be overridden.
      */
-    addRequiredWhen(fn: (form: IFormModel) => boolean, message?: string): void;
+    addRequiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): void;
     /**
      * Mark this field as a derived value computed from `fn(form)`. The field
      * stays editable (no auto-disable) and is excluded from `isDirty` while
@@ -299,12 +320,12 @@ export interface IListItemField {
     readonly templateId?: string;
     getData(): Record<string, unknown>;
 }
-export type BeforeChangeCallback = (value: unknown, form: IFormModel) => unknown;
-export type AfterChangeCallback = (value: unknown, form: IFormModel) => void;
-export type AfterSetValueCallback = (value: unknown, form: IFormModel) => void;
-export type OnBlurCallback = (value: unknown, form: IFormModel) => void;
+export type BeforeChangeCallback = (value: unknown, params: IFieldCallbackParams) => unknown;
+export type AfterChangeCallback = (value: unknown, params: IFieldCallbackParams) => void;
+export type AfterSetValueCallback = (value: unknown, params: IFieldCallbackParams) => void;
+export type OnBlurCallback = (value: unknown, params: IFieldCallbackParams) => void;
 export type CloneValueCallback = (value: unknown) => unknown;
-export type LayoutNode = IRowNode | ISeparatorNode | ITabsNode | IElementNode | IObjectNode;
+export type LayoutNode = IRowNode | ISeparatorNode | IAlertNode | ITabsNode | IElementNode | IObjectNode;
 export interface IRowNode {
     type: "row";
     fieldIds: string[];
@@ -314,6 +335,9 @@ export interface IRowNode {
 export type IRowNodeHandle = IRowBuilder;
 export interface ISeparatorNode {
     type: "separator";
+    title?: string;
+    description?: string;
+    rules?: IRule[];
 }
 export interface ITabDefinition {
     id: string;
@@ -340,9 +364,16 @@ export interface ITabsNode {
     type: "tabs";
     id?: string;
     renderer?: string;
+    rendererSettings?: Record<string, unknown>;
     tabs: ITabDefinition[];
     rules?: IRule[];
 }
+export interface IAlertNode {
+    type: "alert";
+    message?: string;
+    alertType?: "info" | "success" | "warning" | "danger";
+    rules?: IRule[];
+}
 export interface IElementNode {
     type: "element";
     id?: string;
@@ -375,8 +406,17 @@ export interface IRowBuilder extends ILayoutNodeBuilder {
     build(): IRowNode;
 }
 export interface ISeparatorBuilder extends ILayoutNodeBuilder {
+    title(text: string): this;
+    description(text: string): this;
+    rules(rules: IRule[]): this;
     build(): ISeparatorNode;
 }
+export interface IAlertBuilder extends ILayoutNodeBuilder {
+    message(text: string): this;
+    alertType(type: "info" | "success" | "warning" | "danger"): this;
+    rules(rules: IRule[]): this;
+    build(): IAlertNode;
+}
 export interface ITabBuilder {
     label(text: string): this;
     description(text: string): this;
@@ -385,7 +425,7 @@ export interface ITabBuilder {
     rules(rules: IRule[]): this;
 }
 export interface ITabsBuilder extends ILayoutNodeBuilder {
-    renderer(name: string): this;
+    renderer(name: string, settings?: Record<string, unknown>): this;
     tab(id: string, configure: (tab: ITabBuilder) => void): this;
     before(target: string): this;
     after(target: string): this;
@@ -398,13 +438,20 @@ export interface IElementBuilder extends ILayoutNodeBuilder {
 export interface IObjectBuilder extends ILayoutNodeBuilder {
     build(): IObjectNode;
 }
-export type LayoutNodeVM = IRowNodeVM | ISeparatorNodeVM | ITabsNodeVM | IElementNodeVM;
+export type LayoutNodeVM = IRowNodeVM | ISeparatorNodeVM | IAlertNodeVM | ITabsNodeVM | IElementNodeVM;
 export interface IRowNodeVM {
     type: "row";
     fields: IFieldVM[];
 }
 export interface ISeparatorNodeVM {
     type: "separator";
+    title?: string;
+    description?: string;
+}
+export interface IAlertNodeVM {
+    type: "alert";
+    message?: string;
+    alertType: "info" | "success" | "warning" | "danger";
 }
 export interface ITabDefinitionVM {
     id: string;
@@ -419,6 +466,7 @@ export interface ITabsNodeVM {
     type: "tabs";
     id?: string;
     renderer?: string;
+    rendererSettings?: Record<string, unknown>;
     tabs: ITabDefinitionVM[];
     disabled: boolean;
     activeTabId: string;
@@ -470,6 +518,7 @@ export interface IFormModifier {
 export interface ILayoutModifier {
     row(...fieldIds: string[]): ILayoutNodeHandle;
     separator(): ILayoutNodeHandle;
+    alert(): ILayoutNodeHandle;
     tabs(config: {
         id?: string;
         renderer?: string;
@@ -490,12 +539,15 @@ export interface IFormError {
 export interface IFormVM {
     layout: LayoutNodeVM[];
     errors: IFormError[];
+    hasErrors: boolean;
     isDirty: boolean;
     isValid: boolean | null;
     submitCount: number;
     focusField(path: string): void;
     getData(): Record<string, unknown>;
-    setData(data: Record<string, unknown>): void;
+    setData(data: Record<string, unknown>, options?: {
+        dirty?: boolean;
+    }): void;
 }
 /**
  * Imperative form-level rule. Receives the live form and may return a flat
@@ -526,10 +578,14 @@ export interface IFormModel<T = Record<string, any>> {
      */
     addRule(rule: FormRule): void;
     getData(): T;
-    setData(data: T): void;
+    setData(data: T, options?: {
+        dirty?: boolean;
+    }): void;
     reset(): void;
     validate(): Promise<boolean>;
-    submit<T = Record<string, unknown>>(): Promise<T | false>;
+    submit<T = Record<string, unknown>>(options?: {
+        skipValidation?: boolean;
+    }): Promise<T | false>;
     evaluateRules(rules: IRule[] | undefined): {
         visible: boolean;
         disabled: boolean;
@@ -542,6 +598,7 @@ export interface IFormModel<T = Record<string, any>> {
     readonly errors: IFormError[];
     readonly vm: IFormVM;
     getFieldBuilders(predicate?: (builder: IFieldBuilder) => boolean): IFieldBuilder[];
+    traverse(callback: (builder: IFieldBuilder) => void): void;
     resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[];
     readonly registry: IFieldBuilderRegistry;
 }
@@ -561,6 +618,9 @@ export declare namespace FormModel {
     type LayoutNodeBuilder = ILayoutNodeBuilder;
     type RowBuilder = IRowBuilder;
     type SeparatorBuilder = ISeparatorBuilder;
+    type AlertBuilder = IAlertBuilder;
+    type AlertNode = IAlertNode;
+    type AlertNodeVM = IAlertNodeVM;
     type TabBuilder = ITabBuilder;
     type TabsBuilder = ITabsBuilder;
     type ElementBuilder = IElementBuilder;
@@ -597,8 +657,10 @@ export declare namespace FormModel {
     type RuleEvaluator = IRuleEvaluator;
     type FormRuleFunction = FormRuleFn;
     type FormRuleType = FormRule;
-    type RequiredWhen = (form: IFormModel) => boolean;
+    type CallbackParams = IFieldCallbackParams;
+    type RequiredWhen = (params: IFieldCallbackParams) => boolean;
     type HiddenWhen = HiddenWhenCallback;
+    type DisabledWhen = DisabledWhenCallback;
     type Computed = ComputedFieldCallback;
 }
 export interface IFormModelFactory {
@@ -613,6 +675,7 @@ export interface IFormModelConfig {
 export interface ILayoutBuilder {
     row(...fieldIds: string[]): IRowBuilder;
     separator(): ISeparatorBuilder;
+    alert(): IAlertBuilder;
     tabs(id?: string): ITabsBuilder;
     element(renderer: string, props?: Record<string, unknown>): IElementBuilder;
     /**
@@ -634,18 +697,20 @@ export interface IFieldBuilder<TType extends string = string, TOptions extends b
     description(text: string): this;
     note(text: string): this;
     placeholder(text: string): this;
+    autoFocus(value?: boolean): this;
     schema(zodSchema: z.ZodTypeAny): this;
     defaultValue(value: unknown): this;
     renderer<TName extends FieldRendererName<TType, TOptions>>(name: TName, ...args: undefined extends FieldRendererSettings<TName> ? [settings?: FieldRendererSettings<TName>] : FieldRendererSettings<TName> extends undefined ? [] : [settings: FieldRendererSettings<TName>]): this;
     hidden(): this;
-    hiddenWhen(fn: (form: IFormModel) => boolean): this;
+    hiddenWhen(fn: HiddenWhenCallback): this;
+    disabledWhen(fn: DisabledWhenCallback): this;
     required(message?: string): this;
     /**
      * Conditional required check. Multiple `requiredWhen()` calls chain — the
      * first one to return `true` for the current form state makes the field
      * required. Built-in `.required()` (if set) is evaluated alongside.
      */
-    requiredWhen(fn: (form: IFormModel) => boolean, message?: string): this;
+    requiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): this;
     list(): this;
     disabled(value?: boolean): this;
     rules(rules: IRule[]): this;
@@ -654,6 +719,8 @@ export interface IFieldBuilder<TType extends string = string, TOptions extends b
     afterSetValue(fn: AfterSetValueCallback): this;
     onBlur(fn: OnBlurCallback): this;
     cloneValue(fn: CloneValueCallback): this;
+    getName(): string;
+    getType(): string;
     getTags(): string[];
     tags(tags: string[]): this;
     /**
@@ -672,7 +739,7 @@ export interface IFieldBuilder<TType extends string = string, TOptions extends b
     build(name: string): IFieldConfig;
 }
 export interface IOptionsFieldBuilder<TType extends string, TValue = unknown> extends IFieldBuilder<TType, false, TValue> {
-    options(opts: IValueOption<OptionValueType<TType>>[] | ((form: IFormModel) => IValueOption<OptionValueType<TType>>[])): IFieldBuilder<TType, true, TValue>;
+    options(opts: IValueOption<OptionValueType<TType>>[] | ((params: IFieldCallbackParams) => IValueOption<OptionValueType<TType>>[])): IFieldBuilder<TType, true, TValue>;
 }
 export interface IObjectFieldBuilder extends IFieldBuilder<"object", false, Record<string, unknown> | null> {
     fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;

package/features/formModel/abstractions.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"features/formModel/abstractions.js","sources":["../../../src/features/formModel/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/admin\";\nimport type { z } from \"zod\";\nimport type { Icon } from \"~/components/IconPicker/types.js\";\n\n// ---------------------------------------------------------------------------\n// Renderer registry — augmented by each renderer via declare module\n// ---------------------------------------------------------------------------\n\nexport interface IFieldRendererRegistry {}\n\nexport type FieldRendererName<\n TType extends string = string,\n TOptions extends boolean = boolean\n> = string extends TType\n ? keyof IFieldRendererRegistry & string\n : {\n [K in keyof IFieldRendererRegistry]: TType extends IFieldRendererRegistry[K][\"fieldType\"]\n ? boolean extends TOptions\n ? K\n : TOptions extends true\n ? IFieldRendererRegistry[K] extends { options: true }\n ? K\n : never\n : IFieldRendererRegistry[K] extends { options: true }\n ? never\n : K\n : never;\n }[keyof IFieldRendererRegistry] &\n string;\n\nexport type FieldRendererSettings<TName extends string> = TName extends keyof IFieldRendererRegistry\n ? IFieldRendererRegistry[TName][\"settings\"]\n : Record<string, unknown> \| undefined;\n\n// ---------------------------------------------------------------------------\n// Field types\n// ---------------------------------------------------------------------------\n\nexport interface IFieldConfig {\n name: string;\n type: string;\n label?: string;\n help?: string;\n description?: string;\n note?: string;\n placeholder?: string;\n defaultValue?: unknown;\n renderer?: string;\n rendererSettings?: Record<string, unknown>;\n isList?: boolean;\n hidden: boolean;\n required: boolean;\n requiredMessage?: string;\n disabled: boolean;\n schema?: z.ZodTypeAny;\n options?: IValueOption[] \| ((form: IFormModel) => IValueOption[]);\n normalizeValue?: (value: unknown) => unknown;\n beforeChangeCallbacks?: BeforeChangeCallback[];\n afterChangeCallbacks?: AfterChangeCallback[];\n afterSetValueCallbacks?: AfterSetValueCallback[];\n onBlurCallbacks?: OnBlurCallback[];\n requiredWhenCallbacks?: RequiredWhenCallback[];\n hiddenWhenCallbacks?: HiddenWhenCallback[];\n computed?: ComputedFieldCallback;\n computedUntilDirty?: ComputedFieldCallback;\n tags?: string[];\n cloneValue?: CloneValueCallback;\n rules?: IRule[];\n}\n\nexport interface IRequiredWhenCallbackConfig {\n fn: (form: IFormModel) => boolean;\n message?: string;\n}\n\nexport type RequiredWhenCallback = IRequiredWhenCallbackConfig;\n\nexport type HiddenWhenCallback = (form: IFormModel) => boolean;\n\nexport type ComputedFieldCallback = (form: IFormModel) => unknown;\n\n// ---------------------------------------------------------------------------\n// Rules system\n// ---------------------------------------------------------------------------\n\nexport type RuleAction = \"hide\" \| \"disable\";\n\nexport type RuleOperator =\n \| \"eq\"\n \| \"neq\"\n \| \"isEmpty\"\n \| \"isNotEmpty\"\n \| \"isTruthy\"\n \| \"isFalsy\"\n \| \"matches\";\n\nexport interface IRule {\n type: string;\n target: string;\n operator: RuleOperator \| (string & {});\n value: string \| null;\n action: RuleAction;\n}\n\nexport interface IRuleEvaluator {\n canEvaluate(rule: IRule): boolean;\n evaluate(rule: IRule, form: IFormModel): boolean;\n}\n\nexport interface IValueOption<V extends string \| number = string \| number> {\n label: string;\n value: V;\n disabled?: boolean;\n}\n\nexport type OptionValueType<TType extends string> = TType extends \"number\" ? number : string;\n\nexport interface IFieldValidation {\n isValid: boolean \| null;\n message?: string;\n}\n\nexport interface IFieldVM {\n name: string;\n type: string;\n label?: string;\n help?: string;\n description?: string;\n note?: string;\n placeholder?: string;\n value: unknown;\n validation: IFieldValidation;\n validating: boolean;\n required: boolean;\n visible: boolean;\n disabled: boolean;\n renderer?: string;\n rendererSettings?: Record<string, unknown>;\n isList?: boolean;\n options?: IValueOption[];\n onChange: (value: unknown) => void;\n onBlur: () => void;\n addItem: (value?: unknown) => void;\n removeItem: (index: number) => void;\n focusRequested: boolean;\n clearFocusRequest: () => void;\n}\n\nexport interface IObjectFieldVM extends IFieldVM {\n type: \"object\";\n isList: boolean;\n /** Child field VMs for non-list object fields. /\n fields: IFieldVM[];\n /\n Resolved layout for non-list object fields. For templated objects, resolves\n * against the active template's per-template layout (if registered via\n * `layout.object()`), otherwise defaults to one row per visible child.\n * For list-mode fields, see `items[].layout`.\n /\n layout: LayoutNodeVM[];\n /* Items for list-mode object fields. /\n items: IObjectFieldItemVM[];\n /* Append a new item. Templated lists require a template id. /\n addItem: (value?: unknown) => void;\n moveItem: (fromIndex: number, toIndex: number) => void;\n /* Duplicate a list item (including its `_templateId` when templated) and insert it after the source. /\n duplicateItem: (index: number) => void;\n /* True when the object has templates defined. /\n isTemplated: boolean;\n /* Templates visible in the picker (filtered by each template's reactive `visible`). /\n availableTemplates: ITemplateVM[];\n /* Currently active template id (single-object mode), or null if no template picked. /\n activeTemplateId: string \| null;\n /* Switch to a different template. Discards values not present in the new template. /\n setTemplate: (templateId: string) => void;\n}\n\nexport interface IObjectFieldItemVM {\n key: string;\n fields: IFieldVM[];\n /\n Resolved layout for this item. For templated lists, resolves against the\n * item's template-specific layout (if registered via `layout.object()`),\n * otherwise defaults to one row per visible child.\n /\n layout: LayoutNodeVM[];\n remove: () => void;\n moveUp: () => void;\n moveDown: () => void;\n duplicate: () => void;\n /* The template id of this item, if the parent list is templated. /\n templateId?: string;\n}\n\n/\n VM exposed for each available template in the picker.\n /\nexport interface ITemplateIcon {\n type: string;\n name: string;\n}\n\nexport interface ITemplateVM {\n id: string;\n label: string;\n icon?: ITemplateIcon;\n}\n\nexport interface IField {\n readonly name: string;\n readonly type: string;\n readonly visible: boolean;\n readonly disabled: boolean;\n readonly vm: IFieldVM;\n readonly config: IFieldConfig;\n getValue<T = unknown>(): T;\n setValue(value: unknown): void;\n setValueSilent(value: unknown): void;\n setDisabled(value: boolean): void;\n setVisible(value: boolean): void;\n setForm(form: IFormModel, parentPath?: string): void;\n setAncestorRules(rules: IRule[]): void;\n setValidation(validation: IFieldValidation): void;\n resetValidation(): void;\n validate(options?: { force?: boolean }): Promise<boolean>;\n remove(): void;\n addBeforeChange(cb: BeforeChangeCallback): void;\n addAfterChange(cb: AfterChangeCallback): void;\n addAfterSetValue(cb: AfterSetValueCallback): void;\n addOnBlur(cb: OnBlurCallback): void;\n /\n Append a conditional required check. Multiple callbacks chain additively;\n * the first one returning `true` makes the field required for the current\n * form state. The built-in `.required()` flag (if set) always counts as a\n * truthy check and cannot be overridden.\n /\n addRequiredWhen(fn: (form: IFormModel) => boolean, message?: string): void;\n /\n Mark this field as a derived value computed from `fn(form)`. The field\n * stays editable (no auto-disable) and is excluded from `isDirty` while\n * still tracking the computed value. Validation continues to apply.\n /\n setComputed(fn: ComputedFieldCallback): void;\n /\n Same as `setComputed`, but the field switches to manual mode the first\n * time the user edits its value. After that, the computed callback no\n * longer overrides user input.\n /\n setComputedUntilDirty(fn: ComputedFieldCallback): void;\n blur(): void;\n as<T extends keyof FieldTypeMap>(type: T): FieldTypeMap[T];\n readonly qualifiedName: string;\n focus(): void;\n requestFocus(): void;\n clearFocusRequest(): void;\n}\n\n/\n Maps field type strings to their typed field interfaces.\n * Extended via module augmentation when new field types are registered.\n /\nexport interface ITypedField<V> extends IField {\n getValue<T = V>(): T;\n}\n\ntype InferFieldTypeMap = {\n [K in keyof IFieldBuilderRegistry]: ReturnType<\n IFieldBuilderRegistry[K]\n > extends IObjectFieldBuilder\n ? IObjectField\n : ReturnType<IFieldBuilderRegistry[K]> extends { readonly __valueType?: infer V }\n ? ITypedField<V>\n : IField;\n};\n\nexport type FieldTypeMap = { [K in keyof InferFieldTypeMap]: InferFieldTypeMap[K] };\n\nexport type FileValue = {\n id: string;\n name: string;\n size: number;\n mimeType: string;\n src: string;\n width: number \| undefined;\n height: number \| undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Object / List field types\n// ---------------------------------------------------------------------------\n\nexport interface IObjectFieldConfig extends IFieldConfig {\n childBuilders: Record<string, IFieldBuilder>;\n isList: boolean;\n listSchema?: z.ZodTypeAny;\n templates?: ITemplateConfig[];\n}\n\nexport interface ITemplateBuilder {\n label(text: string): this;\n icon(icon: ITemplateIcon): this;\n fields(factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n visible(predicate: (form: IFormModel) => boolean): this;\n}\n\nexport interface ITemplateConfig {\n id: string;\n label: string;\n icon?: ITemplateIcon;\n childBuilders: Record<string, IFieldBuilder>;\n visible?: (form: IFormModel) => boolean;\n}\n\nexport interface IObjectField extends ITypedField<Record<string, unknown> \| null> {\n readonly isList: boolean;\n readonly children: Map<string, IField>;\n readonly items: IListItemField[];\n readonly isTemplated: boolean;\n readonly activeTemplateId: string \| null;\n readonly availableTemplates: ITemplateVM[];\n /\n Add, replace, or remove children on this object field at runtime.\n * Mirrors `form.fields()` but scoped to this object's children. Existing\n * keys are replaced; new keys are appended; passing `undefined` removes.\n * Throws on templated objects — each template owns its own fields.\n /\n fields(\n factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder \| undefined>\n ): void;\n /\n Register an inner layout used by the field's VM (`field.layout` for\n * single objects, `item.layout` for list items).\n \n Pass `LayoutNode[]` for non-templated objects (the layout applies to the\n * single object or every list item). Pass `Record<templateId, LayoutNode[]>`\n * for templated objects (each entry applies when that template is active\n * or for each list item with that template). Templates without an entry\n * fall back to default one-row-per-visible-child.\n /\n setInnerLayout(layout: LayoutNode[] \| Record<string, LayoutNode[]>): void;\n /\n Append a new list item.\n * - Non-templated list: `addItem(data?)` — data hydrates the new item.\n * - Templated list: `addItem(templateId, data?)` — templateId picks the variant.\n /\n addItem(\n templateIdOrData?: string \| Record<string, unknown>,\n data?: Record<string, unknown>\n ): void;\n removeItem(index: number): void;\n moveItem(fromIndex: number, toIndex: number): void;\n /* Duplicate a list item (including its `_templateId`) and insert after the source. /\n duplicateItem(index: number): void;\n setTemplate(templateId: string): void;\n /\n Runtime template management. Available on every object field but throws\n * when called on a non-templated field (`isTemplated === false`).\n /\n readonly templates: IObjectFieldTemplates;\n getInnerLayout(): LayoutNode[] \| null;\n getData(): Record<string, unknown> \| Record<string, unknown>[];\n}\n\nexport interface IObjectFieldTemplates {\n add(id: string, configure: (t: ITemplateBuilder) => void): void;\n remove(templateId: string): void;\n}\n\nexport interface IListItemField {\n readonly key: string;\n readonly children: Map<string, IField>;\n readonly templateId?: string;\n getData(): Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Callback types\n// ---------------------------------------------------------------------------\n\nexport type BeforeChangeCallback = (value: unknown, form: IFormModel) => unknown;\nexport type AfterChangeCallback = (value: unknown, form: IFormModel) => void;\nexport type AfterSetValueCallback = (value: unknown, form: IFormModel) => void;\nexport type OnBlurCallback = (value: unknown, form: IFormModel) => void;\nexport type CloneValueCallback = (value: unknown) => unknown;\n\n// ---------------------------------------------------------------------------\n// Layout types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNode = IRowNode \| ISeparatorNode \| ITabsNode \| IElementNode \| IObjectNode;\n\nexport interface IRowNode {\n type: \"row\";\n fieldIds: string[];\n position?: LayoutPosition;\n}\n\n/* @deprecated Use IRowBuilder instead /\nexport type IRowNodeHandle = IRowBuilder;\n\nexport interface ISeparatorNode {\n type: \"separator\";\n}\n\nexport interface ITabDefinition {\n id: string;\n label: string;\n description?: string;\n icon?: Icon;\n layout: LayoutNode[];\n rules?: IRule[];\n}\n\n/\n User-facing tab spec accepted by `layout.tabs(...)`. The layout is supplied\n * as a callback receiving the layout builder, mirroring `layout.object(...)`.\n * Resolved to `ITabDefinition` (with `layout: LayoutNode[]`) at build time.\n /\nexport interface ITabDefinitionInput {\n id: string;\n label: string;\n description?: string;\n icon?: Icon;\n layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n rules?: IRule[];\n}\n\nexport interface ITabsNode {\n type: \"tabs\";\n id?: string;\n renderer?: string;\n tabs: ITabDefinition[];\n rules?: IRule[];\n}\n\nexport interface IElementNode {\n type: \"element\";\n id?: string;\n renderer: string;\n props?: Record<string, unknown>;\n}\n\n/\n Layout node that references an object field and registers an inner layout\n * on it. Resolved as a single-field row in the outer layout — the inner\n * layout is exposed on the field's VM (`field.layout` for single objects,\n * `item.layout` for list items).\n \n - For non-templated objects, `inner` is `LayoutNode[]` (one layout, applied\n * to the single object or every list item).\n * - For templated objects, `inner` is `Record<templateId, LayoutNode[]>` —\n * each entry is the layout used when that template is active (or for each\n * list item with that template).\n /\nexport interface IObjectNode {\n type: \"object\";\n fieldName: string;\n inner: LayoutNode[] \| Record<string, LayoutNode[]>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout node builders\n// ---------------------------------------------------------------------------\n\nexport interface ILayoutNodeBuilder {\n build(): LayoutNode;\n}\n\nexport interface IRowBuilder extends ILayoutNodeBuilder {\n before(target: string): IRowBuilder;\n after(target: string): IRowBuilder;\n build(): IRowNode;\n}\n\nexport interface ISeparatorBuilder extends ILayoutNodeBuilder {\n build(): ISeparatorNode;\n}\n\nexport interface ITabBuilder {\n label(text: string): this;\n description(text: string): this;\n icon(icon: Icon): this;\n layout(factory: (l: ILayoutBuilder) => ILayoutNodeBuilder[]): this;\n rules(rules: IRule[]): this;\n}\n\nexport interface ITabsBuilder extends ILayoutNodeBuilder {\n renderer(name: string): this;\n tab(id: string, configure: (tab: ITabBuilder) => void): this;\n before(target: string): this;\n after(target: string): this;\n rules(rules: IRule[]): this;\n build(): ITabsNode;\n}\n\nexport interface IElementBuilder extends ILayoutNodeBuilder {\n build(): IElementNode;\n}\n\nexport interface IObjectBuilder extends ILayoutNodeBuilder {\n build(): IObjectNode;\n}\n\n// ---------------------------------------------------------------------------\n// Layout VM types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNodeVM = IRowNodeVM \| ISeparatorNodeVM \| ITabsNodeVM \| IElementNodeVM;\n\nexport interface IRowNodeVM {\n type: \"row\";\n fields: IFieldVM[];\n}\n\nexport interface ISeparatorNodeVM {\n type: \"separator\";\n}\n\nexport interface ITabDefinitionVM {\n id: string;\n label: string;\n description?: string;\n icon?: Icon;\n hasErrors: boolean;\n disabled: boolean;\n layout: LayoutNodeVM[];\n}\n\nexport interface ITabsNodeVM {\n type: \"tabs\";\n id?: string;\n renderer?: string;\n tabs: ITabDefinitionVM[];\n disabled: boolean;\n activeTabId: string;\n setActiveTab: (id: string) => void;\n}\n\nexport interface IElementNodeVM {\n type: \"element\";\n renderer: string;\n props?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout modifier types\n// ---------------------------------------------------------------------------\n\nexport type LayoutPosition =\n \| { type: \"before\"; target: string }\n \| { type: \"after\"; target: string }\n \| { type: \"replace\"; target: string };\n\nexport interface IPositionedLayoutNode {\n node: LayoutNode;\n position?: LayoutPosition;\n}\n\n/\n Chainable handle returned by modifier layout.row().\n * Can be used as-is (appended) or positioned via .before()/.after()/.replace().\n /\nexport interface ILayoutNodeHandle extends IPositionedLayoutNode {\n before(target: string): IPositionedLayoutNode;\n after(target: string): IPositionedLayoutNode;\n replace(target: string): IPositionedLayoutNode;\n}\n\n// ---------------------------------------------------------------------------\n// Named layout node access types\n// ---------------------------------------------------------------------------\n\nexport interface LayoutNodeHandleMap {\n tabs: ITabsBuilder;\n element: IElementNode;\n object: IObjectNode;\n}\n\nexport interface ILayoutNodeAccessHandle {\n as<T extends keyof LayoutNodeHandleMap>(type: T): LayoutNodeHandleMap[T];\n}\n\n/* @deprecated Use ITabsBuilder instead /\nexport type ITabsHandle = ITabsBuilder;\n\n/* @deprecated Use ITabBuilder instead /\nexport type ITabHandle = ITabBuilder;\n\n// ---------------------------------------------------------------------------\n// Modifier types\n// ---------------------------------------------------------------------------\n\nexport interface IFormModifier {\n modify(form: IFormModel): void;\n}\n\nexport interface ILayoutModifier {\n row(...fieldIds: string[]): ILayoutNodeHandle;\n separator(): ILayoutNodeHandle;\n tabs(config: {\n id?: string;\n renderer?: string;\n tabs: ITabDefinitionInput[];\n rules?: IRule[];\n }): ILayoutNodeHandle;\n element(renderer: string, props?: Record<string, unknown>): ILayoutNodeHandle;\n object(\n fieldName: string,\n layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n ): ILayoutNodeHandle;\n object(\n fieldName: string,\n templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n ): ILayoutNodeHandle;\n remove(target: string): void;\n}\n\n// ---------------------------------------------------------------------------\n// Form types\n// ---------------------------------------------------------------------------\n\nexport interface IFormError {\n path: string;\n label?: string;\n breadcrumb?: string[];\n message: string;\n}\n\nexport interface IFormVM {\n layout: LayoutNodeVM[];\n errors: IFormError[];\n isDirty: boolean;\n isValid: boolean \| null;\n submitCount: number;\n focusField(path: string): void;\n getData(): Record<string, unknown>;\n setData(data: Record<string, unknown>): void;\n}\n\n/\n Imperative form-level rule. Receives the live form and may return a flat\n * list of errors (sync or async). Errors are merged into `form.errors` and\n * surfaced on per-field validation when their `path` matches a known field.\n /\nexport type FormRuleFn = (\n form: IFormModel\n) => IFormError[] \| undefined \| void \| Promise<IFormError[] \| undefined \| void>;\n\n/\n A form-level rule. Either a Zod schema (validated against `form.getData()`)\n * or an imperative function returning an error list.\n /\nexport type FormRule = z.ZodTypeAny \| FormRuleFn;\n\nexport interface IFormModel<T = Record<string, any>> {\n field(name: string): IField;\n fields(\n factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder \| undefined>\n ): void;\n layout(factory: (layout: ILayoutModifier) => (LayoutNode \| IPositionedLayoutNode)[]): void;\n layout(nodeId: string): ILayoutNodeAccessHandle;\n /\n Replace the entire layout. Re-registers per-field inner layouts and\n * propagates ancestor rules. Use `layout()` (modifier form) for additive\n * changes.\n /\n setLayout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): void;\n /\n Append a form-level validation rule. Runs after per-field validation.\n * Accepts a Zod schema (validated against `getData()`) or an imperative\n * function returning a list of errors.\n /\n addRule(rule: FormRule): void;\n getData(): T;\n setData(data: T): void;\n reset(): void;\n validate(): Promise<boolean>;\n submit<T = Record<string, unknown>>(): Promise<T \| false>;\n evaluateRules(rules: IRule[] \| undefined): { visible: boolean; disabled: boolean };\n focusField(name: string): void;\n readonly isDirty: boolean;\n readonly isValid: boolean \| null;\n readonly submitted: boolean;\n readonly submitCount: number;\n readonly errors: IFormError[];\n readonly vm: IFormVM;\n getFieldBuilders(predicate?: (builder: IFieldBuilder) => boolean): IFieldBuilder[];\n resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[];\n readonly registry: IFieldBuilderRegistry;\n}\n\n// ---------------------------------------------------------------------------\n// FormModel namespace — groups all public types under one import\n// ---------------------------------------------------------------------------\n\nexport namespace FormModel {\n export type FieldConfig = IFieldConfig;\n export type ValueOption = IValueOption;\n export type FieldValidation = IFieldValidation;\n export type FieldVM = IFieldVM;\n export type Field = IField;\n export type ObjectField = IObjectField;\n export type ObjectFieldConfig = IObjectFieldConfig;\n export type BeforeChange = BeforeChangeCallback;\n export type AfterChange = AfterChangeCallback;\n export type AfterSetValue = AfterSetValueCallback;\n export type OnBlur = OnBlurCallback;\n export type CloneValue = CloneValueCallback;\n export type LayoutNodeBuilder = ILayoutNodeBuilder;\n export type RowBuilder = IRowBuilder;\n export type SeparatorBuilder = ISeparatorBuilder;\n export type TabBuilder = ITabBuilder;\n export type TabsBuilder = ITabsBuilder;\n export type ElementBuilder = IElementBuilder;\n export type ObjectBuilder = IObjectBuilder;\n export type RowNode = IRowNode;\n /* @deprecated Use RowBuilder instead /\n export type RowNodeHandle = IRowNodeHandle;\n export type RowNodeVM = IRowNodeVM;\n export type SeparatorNode = ISeparatorNode;\n export type SeparatorNodeVM = ISeparatorNodeVM;\n export type TabsNode = ITabsNode;\n export type TabDefinition = ITabDefinition;\n export type TabDefinitionInput = ITabDefinitionInput;\n export type TabsNodeVM = ITabsNodeVM;\n export type TabDefinitionVM = ITabDefinitionVM;\n export type TabIcon = Icon;\n export type ElementNode = IElementNode;\n export type ElementNodeVM = IElementNodeVM;\n export type ObjectNode = IObjectNode;\n export type ObjectFieldVM = IObjectFieldVM;\n export type ObjectFieldItemVM = IObjectFieldItemVM;\n export type TemplateBuilder = ITemplateBuilder;\n export type TemplateConfig = ITemplateConfig;\n export type TemplateIcon = ITemplateIcon;\n export type TemplateVM = ITemplateVM;\n export type ObjectFieldTemplatesAPI = IObjectFieldTemplates;\n export type FormError = IFormError;\n export type FormVM = IFormVM;\n export type Interface<T = Record<string, any>> = IFormModel<T>;\n export type Modifier = IFormModifier;\n export type LayoutModifier = ILayoutModifier;\n export type Rule = IRule;\n export type Action = RuleAction;\n export type RuleEvaluator = IRuleEvaluator;\n export type FormRuleFunction = FormRuleFn;\n export type FormRuleType = FormRule;\n export type RequiredWhen = (form: IFormModel) => boolean;\n export type HiddenWhen = HiddenWhenCallback;\n export type Computed = ComputedFieldCallback;\n}\n\n// ---------------------------------------------------------------------------\n// FormModelFactory abstraction\n// ---------------------------------------------------------------------------\n\nexport interface IFormModelFactory {\n create<T = Record<string, any>>(config: IFormModelConfig): IFormModel<T>;\n}\n\nexport interface IFormModelConfig {\n fields: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>;\n layout?: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n validateOnSubmit?: boolean;\n ruleEvaluators?: IRuleEvaluator[];\n}\n\nexport interface ILayoutBuilder {\n row(...fieldIds: string[]): IRowBuilder;\n separator(): ISeparatorBuilder;\n tabs(id?: string): ITabsBuilder;\n element(renderer: string, props?: Record<string, unknown>): IElementBuilder;\n /\n Reference an object field and register its inner layout.\n \n Non-templated: pass a single layout factory; the layout applies to the\n * single object or to every list item. Templated: pass a map of factories\n * keyed by template id; each entry applies when that template is active\n * (or for each list item with that template). Templates without an entry\n * fall back to default one-row-per-visible-child.\n /\n object(\n fieldName: string,\n layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n ): IObjectBuilder;\n object(\n fieldName: string,\n templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n ): IObjectBuilder;\n}\n\nexport interface IFieldBuilder<\n TType extends string = string,\n TOptions extends boolean = false,\n TValue = unknown\n> {\n readonly __valueType?: TValue;\n label(text: string): this;\n help(text: string): this;\n description(text: string): this;\n note(text: string): this;\n placeholder(text: string): this;\n schema(zodSchema: z.ZodTypeAny): this;\n defaultValue(value: unknown): this;\n renderer<TName extends FieldRendererName<TType, TOptions>>(\n name: TName,\n ...args: undefined extends FieldRendererSettings<TName>\n ? [settings?: FieldRendererSettings<TName>]\n : FieldRendererSettings<TName> extends undefined\n ? []\n : [settings: FieldRendererSettings<TName>]\n ): this;\n hidden(): this;\n hiddenWhen(fn: (form: IFormModel) => boolean): this;\n required(message?: string): this;\n /\n Conditional required check. Multiple `requiredWhen()` calls chain — the\n * first one to return `true` for the current form state makes the field\n * required. Built-in `.required()` (if set) is evaluated alongside.\n /\n requiredWhen(fn: (form: IFormModel) => boolean, message?: string): this;\n list(): this;\n disabled(value?: boolean): this;\n rules(rules: IRule[]): this;\n beforeChange(fn: BeforeChangeCallback): this;\n afterChange(fn: AfterChangeCallback): this;\n afterSetValue(fn: AfterSetValueCallback): this;\n onBlur(fn: OnBlurCallback): this;\n cloneValue(fn: CloneValueCallback): this;\n getTags(): string[];\n tags(tags: string[]): this;\n /\n Mark this field as a derived value computed from `fn(form)`. The field\n * stays editable; user edits are accepted but the computed value continues\n * to flow whenever a dependency changes. To make the user \"win\", use\n * `computedUntilDirty()` instead.\n /\n computed(fn: ComputedFieldCallback): this;\n /\n Same as `computed`, but the field switches to manual mode the first time\n * its value is changed via the UI. After that, `fn(form)` no longer\n * overrides user input.\n */\n computedUntilDirty(fn: ComputedFieldCallback): this;\n build(name: string): IFieldConfig;\n}\n\nexport interface IOptionsFieldBuilder<TType extends string, TValue = unknown> extends IFieldBuilder<\n TType,\n false,\n TValue\n> {\n options(\n opts:\n \| IValueOption<OptionValueType<TType>>[]\n \| ((form: IFormModel) => IValueOption<OptionValueType<TType>>[])\n ): IFieldBuilder<TType, true, TValue>;\n}\n\nexport interface IObjectFieldBuilder extends IFieldBuilder<\n \"object\",\n false,\n Record<string, unknown> \| null\n> {\n fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n list(): this;\n listSchema(schema: z.ZodTypeAny): this;\n template(id: string, configure: (t: ITemplateBuilder) => void): this;\n}\n\nexport interface IFieldBuilderRegistry {}\n\n// ---------------------------------------------------------------------------\n// Field type plugin system\n// ---------------------------------------------------------------------------\n\nexport interface IFieldTypeFactory {\n readonly type: string;\n create(registry: IFieldBuilderRegistry): IFieldBuilder;\n}\n\nexport const FieldType = createAbstraction<IFieldTypeFactory>(\"FormModel/FieldType\");\n\nexport namespace FieldType {\n export type Interface = IFieldTypeFactory;\n export type FieldBuilder = IFieldBuilder;\n export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const FieldBuilderRegistry = createAbstraction<IFieldBuilderRegistry>(\n \"FormModel/FieldBuilderRegistry\"\n);\n\nexport namespace FieldBuilderRegistry {\n export type Interface = IFieldBuilderRegistry;\n}\n\nexport const FormModelFactory = createAbstraction<IFormModelFactory>(\"FormModelFactory\");\n\nexport namespace FormModelFactory {\n export type Interface = IFormModelFactory;\n export type Config = IFormModelConfig;\n export type LayoutBuilder = ILayoutBuilder;\n export type FieldBuilder = IFieldBuilder;\n export type OptionsFieldBuilder<TType extends string> = IOptionsFieldBuilder<TType>;\n export type ObjectFieldBuilder = IObjectFieldBuilder;\n export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const RuleEvaluator = createAbstraction<IRuleEvaluator>(\"FormModelRuleEvaluator\");\n\nexport namespace RuleEvaluator {\n export type Interface = IRuleEvaluator;\n export type Rule = IRule;\n export type Action = RuleAction;\n}\n"],"names":["FieldType","createAbstraction","FieldBuilderRegistry","FormModelFactory","RuleEvaluator"],"mappings":";AAi3BO,MAAMA,YAAYC,kBAAqC;AAQvD,MAAMC,uBAAuBD,kBAChC;AAOG,MAAME,mBAAmBF,kBAAqC;AAY9D,MAAMG,gBAAgBH,kBAAkC"}
1	+ {"version":3,"file":"features/formModel/abstractions.js","sources":["../../../src/features/formModel/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/admin\";\nimport type { z } from \"zod\";\nimport type { Icon } from \"~/components/IconPicker/types.js\";\n\n// ---------------------------------------------------------------------------\n// Renderer registry — augmented by each renderer via declare module\n// ---------------------------------------------------------------------------\n\nexport interface IFieldRendererRegistry {}\n\nexport type FieldRendererName<\n TType extends string = string,\n TOptions extends boolean = boolean\n> = string extends TType\n ? keyof IFieldRendererRegistry & string\n : {\n [K in keyof IFieldRendererRegistry]: TType extends IFieldRendererRegistry[K][\"fieldType\"]\n ? boolean extends TOptions\n ? K\n : TOptions extends true\n ? IFieldRendererRegistry[K] extends { options: true }\n ? K\n : never\n : IFieldRendererRegistry[K] extends { options: true }\n ? never\n : K\n : never;\n }[keyof IFieldRendererRegistry] &\n string;\n\nexport type FieldRendererSettings<TName extends string> = TName extends keyof IFieldRendererRegistry\n ? IFieldRendererRegistry[TName][\"settings\"]\n : Record<string, unknown> \| undefined;\n\n// ---------------------------------------------------------------------------\n// Field types\n// ---------------------------------------------------------------------------\n\nexport interface IFieldConfig {\n name: string;\n type: string;\n label?: string;\n help?: string;\n description?: string;\n note?: string;\n placeholder?: string;\n defaultValue?: unknown;\n autoFocus?: boolean;\n renderer?: string;\n rendererSettings?: Record<string, unknown>;\n isList?: boolean;\n hidden: boolean;\n required: boolean;\n requiredMessage?: string;\n disabled: boolean;\n schema?: z.ZodTypeAny;\n options?: IValueOption[] \| ((params: IFieldCallbackParams) => IValueOption[]);\n normalizeValue?: (value: unknown) => unknown;\n beforeChangeCallbacks?: BeforeChangeCallback[];\n afterChangeCallbacks?: AfterChangeCallback[];\n afterSetValueCallbacks?: AfterSetValueCallback[];\n onBlurCallbacks?: OnBlurCallback[];\n requiredWhenCallbacks?: RequiredWhenCallback[];\n hiddenWhenCallbacks?: HiddenWhenCallback[];\n disabledWhenCallbacks?: DisabledWhenCallback[];\n computed?: ComputedFieldCallback;\n computedUntilDirty?: ComputedFieldCallback;\n tags?: string[];\n cloneValue?: CloneValueCallback;\n context?: FieldContextCallback;\n rules?: IRule[];\n}\n\nexport interface IFieldScope {\n field(name: string): IField;\n parent(): IFieldScope;\n}\n\nexport interface IFieldNavigator {\n parent(): IFieldScope;\n}\n\nexport interface IFieldCallbackParams {\n field: IFieldNavigator;\n form: IFormModel;\n}\n\nexport interface IRequiredWhenCallbackConfig {\n fn: (params: IFieldCallbackParams) => boolean;\n message?: string;\n}\n\nexport type RequiredWhenCallback = IRequiredWhenCallbackConfig;\n\nexport type HiddenWhenCallback = (params: IFieldCallbackParams) => boolean;\n\nexport type DisabledWhenCallback = (params: IFieldCallbackParams) => boolean;\n\nexport type ComputedFieldCallback = (params: IFieldCallbackParams) => unknown;\n\nexport type FieldContextCallback = (params: IFieldCallbackParams) => Record<string, unknown>;\n\n// ---------------------------------------------------------------------------\n// Rules system\n// ---------------------------------------------------------------------------\n\nexport type RuleAction = \"hide\" \| \"disable\";\n\nexport type RuleOperator =\n \| \"eq\"\n \| \"neq\"\n \| \"isEmpty\"\n \| \"isNotEmpty\"\n \| \"isTruthy\"\n \| \"isFalsy\"\n \| \"matches\";\n\nexport interface IRule {\n type: string;\n target: string;\n operator: RuleOperator \| (string & {});\n value: string \| null;\n action: RuleAction;\n}\n\nexport interface IRuleEvaluator {\n canEvaluate(rule: IRule): boolean;\n evaluate(rule: IRule, form: IFormModel): boolean;\n}\n\nexport interface IValueOption<V extends string \| number = string \| number> {\n label: string;\n value: V;\n disabled?: boolean;\n}\n\nexport type OptionValueType<TType extends string> = TType extends \"number\" ? number : string;\n\nexport interface IFieldValidation {\n isValid: boolean \| null;\n message?: string;\n}\n\nexport interface IFieldVM {\n name: string;\n type: string;\n label?: string;\n help?: string;\n description?: string;\n note?: string;\n placeholder?: string;\n autoFocus?: boolean;\n value: unknown;\n validation: IFieldValidation;\n validating: boolean;\n required: boolean;\n visible: boolean;\n disabled: boolean;\n renderer?: string;\n rendererSettings?: Record<string, unknown>;\n isList?: boolean;\n options?: IValueOption[];\n onChange: (value: unknown) => void;\n onBlur: () => void;\n addItem: (value?: unknown) => void;\n removeItem: (index: number) => void;\n focusRequested: boolean;\n clearFocusRequest: () => void;\n context: Record<string, unknown>;\n}\n\nexport interface IObjectFieldVM extends IFieldVM {\n type: \"object\";\n isList: boolean;\n /** Child field VMs for non-list object fields. /\n fields: IFieldVM[];\n /\n Resolved layout for non-list object fields. For templated objects, resolves\n * against the active template's per-template layout (if registered via\n * `layout.object()`), otherwise defaults to one row per visible child.\n * For list-mode fields, see `items[].layout`.\n /\n layout: LayoutNodeVM[];\n /* Items for list-mode object fields. /\n items: IObjectFieldItemVM[];\n /* Append a new item. Templated lists require a template id. /\n addItem: (value?: unknown) => void;\n moveItem: (fromIndex: number, toIndex: number) => void;\n /* Duplicate a list item (including its `_templateId` when templated) and insert it after the source. /\n duplicateItem: (index: number) => void;\n /* True when the object has templates defined. /\n isTemplated: boolean;\n /* Templates visible in the picker (filtered by each template's reactive `visible`). /\n availableTemplates: ITemplateVM[];\n /* Currently active template id (single-object mode), or null if no template picked. /\n activeTemplateId: string \| null;\n /* Switch to a different template. Discards values not present in the new template. /\n setTemplate: (templateId: string) => void;\n /* Returns a cloned copy of the current single-value data with cloneValue transforms applied. /\n getClonedData: () => Record<string, unknown>;\n}\n\nexport interface IObjectFieldItemVM {\n key: string;\n fields: IFieldVM[];\n /\n Resolved layout for this item. For templated lists, resolves against the\n * item's template-specific layout (if registered via `layout.object()`),\n * otherwise defaults to one row per visible child.\n /\n layout: LayoutNodeVM[];\n remove: () => void;\n moveUp: () => void;\n moveDown: () => void;\n duplicate: () => void;\n getClonedData: () => Record<string, unknown>;\n /* The template id of this item, if the parent list is templated. /\n templateId?: string;\n}\n\n/\n VM exposed for each available template in the picker.\n /\nexport interface ITemplateIcon {\n type: string;\n name: string;\n}\n\nexport interface ITemplateVM {\n id: string;\n label: string;\n icon?: ITemplateIcon;\n}\n\nexport interface IField {\n readonly name: string;\n readonly type: string;\n readonly visible: boolean;\n readonly disabled: boolean;\n readonly vm: IFieldVM;\n readonly config: IFieldConfig;\n getValue<T = unknown>(): T;\n setValue(value: unknown): void;\n setValueSilent(value: unknown): void;\n setDisabled(value: boolean): void;\n setVisible(value: boolean): void;\n setForm(form: IFormModel, parentPath?: string): void;\n setAncestorRules(rules: IRule[]): void;\n setValidation(validation: IFieldValidation): void;\n resetValidation(): void;\n validate(options?: { force?: boolean }): Promise<boolean>;\n remove(): void;\n addBeforeChange(cb: BeforeChangeCallback): void;\n addAfterChange(cb: AfterChangeCallback): void;\n addAfterSetValue(cb: AfterSetValueCallback): void;\n addOnBlur(cb: OnBlurCallback): void;\n /\n Append a conditional required check. Multiple callbacks chain additively;\n * the first one returning `true` makes the field required for the current\n * form state. The built-in `.required()` flag (if set) always counts as a\n * truthy check and cannot be overridden.\n /\n addRequiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): void;\n /\n Mark this field as a derived value computed from `fn(form)`. The field\n * stays editable (no auto-disable) and is excluded from `isDirty` while\n * still tracking the computed value. Validation continues to apply.\n /\n setComputed(fn: ComputedFieldCallback): void;\n /\n Same as `setComputed`, but the field switches to manual mode the first\n * time the user edits its value. After that, the computed callback no\n * longer overrides user input.\n /\n setComputedUntilDirty(fn: ComputedFieldCallback): void;\n blur(): void;\n as<T extends keyof FieldTypeMap>(type: T): FieldTypeMap[T];\n readonly qualifiedName: string;\n focus(): void;\n requestFocus(): void;\n clearFocusRequest(): void;\n}\n\n/\n Maps field type strings to their typed field interfaces.\n * Extended via module augmentation when new field types are registered.\n /\nexport interface ITypedField<V> extends IField {\n getValue<T = V>(): T;\n}\n\ntype InferFieldTypeMap = {\n [K in keyof IFieldBuilderRegistry]: ReturnType<\n IFieldBuilderRegistry[K]\n > extends IObjectFieldBuilder\n ? IObjectField\n : ReturnType<IFieldBuilderRegistry[K]> extends { readonly __valueType?: infer V }\n ? ITypedField<V>\n : IField;\n};\n\nexport type FieldTypeMap = { [K in keyof InferFieldTypeMap]: InferFieldTypeMap[K] };\n\nexport type FileValue = {\n id: string;\n name: string;\n size: number;\n mimeType: string;\n src: string;\n width: number \| undefined;\n height: number \| undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Object / List field types\n// ---------------------------------------------------------------------------\n\nexport interface IObjectFieldConfig extends IFieldConfig {\n childBuilders: Record<string, IFieldBuilder>;\n isList: boolean;\n listSchema?: z.ZodTypeAny;\n templates?: ITemplateConfig[];\n}\n\nexport interface ITemplateBuilder {\n label(text: string): this;\n icon(icon: ITemplateIcon): this;\n fields(factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n visible(predicate: (form: IFormModel) => boolean): this;\n}\n\nexport interface ITemplateConfig {\n id: string;\n label: string;\n icon?: ITemplateIcon;\n childBuilders: Record<string, IFieldBuilder>;\n visible?: (form: IFormModel) => boolean;\n}\n\nexport interface IObjectField extends ITypedField<Record<string, unknown> \| null> {\n readonly isList: boolean;\n readonly children: Map<string, IField>;\n readonly items: IListItemField[];\n readonly isTemplated: boolean;\n readonly activeTemplateId: string \| null;\n readonly availableTemplates: ITemplateVM[];\n /\n Add, replace, or remove children on this object field at runtime.\n * Mirrors `form.fields()` but scoped to this object's children. Existing\n * keys are replaced; new keys are appended; passing `undefined` removes.\n * Throws on templated objects — each template owns its own fields.\n /\n fields(\n factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder \| undefined>\n ): void;\n /\n Register an inner layout used by the field's VM (`field.layout` for\n * single objects, `item.layout` for list items).\n \n Pass `LayoutNode[]` for non-templated objects (the layout applies to the\n * single object or every list item). Pass `Record<templateId, LayoutNode[]>`\n * for templated objects (each entry applies when that template is active\n * or for each list item with that template). Templates without an entry\n * fall back to default one-row-per-visible-child.\n /\n setInnerLayout(layout: LayoutNode[] \| Record<string, LayoutNode[]>): void;\n /\n Append a new list item.\n * - Non-templated list: `addItem(data?)` — data hydrates the new item.\n * - Templated list: `addItem(templateId, data?)` — templateId picks the variant.\n /\n addItem(\n templateIdOrData?: string \| Record<string, unknown>,\n data?: Record<string, unknown>\n ): void;\n removeItem(index: number): void;\n moveItem(fromIndex: number, toIndex: number): void;\n /* Duplicate a list item (including its `_templateId`) and insert after the source. /\n duplicateItem(index: number): void;\n setTemplate(templateId: string): void;\n /\n Runtime template management. Available on every object field but throws\n * when called on a non-templated field (`isTemplated === false`).\n /\n readonly templates: IObjectFieldTemplates;\n getInnerLayout(): LayoutNode[] \| null;\n getData(): Record<string, unknown> \| Record<string, unknown>[];\n}\n\nexport interface IObjectFieldTemplates {\n add(id: string, configure: (t: ITemplateBuilder) => void): void;\n remove(templateId: string): void;\n}\n\nexport interface IListItemField {\n readonly key: string;\n readonly children: Map<string, IField>;\n readonly templateId?: string;\n getData(): Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Callback types\n// ---------------------------------------------------------------------------\n\nexport type BeforeChangeCallback = (value: unknown, params: IFieldCallbackParams) => unknown;\nexport type AfterChangeCallback = (value: unknown, params: IFieldCallbackParams) => void;\nexport type AfterSetValueCallback = (value: unknown, params: IFieldCallbackParams) => void;\nexport type OnBlurCallback = (value: unknown, params: IFieldCallbackParams) => void;\nexport type CloneValueCallback = (value: unknown) => unknown;\n\n// ---------------------------------------------------------------------------\n// Layout types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNode =\n \| IRowNode\n \| ISeparatorNode\n \| IAlertNode\n \| ITabsNode\n \| IElementNode\n \| IObjectNode;\n\nexport interface IRowNode {\n type: \"row\";\n fieldIds: string[];\n position?: LayoutPosition;\n}\n\n/* @deprecated Use IRowBuilder instead /\nexport type IRowNodeHandle = IRowBuilder;\n\nexport interface ISeparatorNode {\n type: \"separator\";\n title?: string;\n description?: string;\n rules?: IRule[];\n}\n\nexport interface ITabDefinition {\n id: string;\n label: string;\n description?: string;\n icon?: Icon;\n layout: LayoutNode[];\n rules?: IRule[];\n}\n\n/\n User-facing tab spec accepted by `layout.tabs(...)`. The layout is supplied\n * as a callback receiving the layout builder, mirroring `layout.object(...)`.\n * Resolved to `ITabDefinition` (with `layout: LayoutNode[]`) at build time.\n /\nexport interface ITabDefinitionInput {\n id: string;\n label: string;\n description?: string;\n icon?: Icon;\n layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n rules?: IRule[];\n}\n\nexport interface ITabsNode {\n type: \"tabs\";\n id?: string;\n renderer?: string;\n rendererSettings?: Record<string, unknown>;\n tabs: ITabDefinition[];\n rules?: IRule[];\n}\n\nexport interface IAlertNode {\n type: \"alert\";\n message?: string;\n alertType?: \"info\" \| \"success\" \| \"warning\" \| \"danger\";\n rules?: IRule[];\n}\n\nexport interface IElementNode {\n type: \"element\";\n id?: string;\n renderer: string;\n props?: Record<string, unknown>;\n}\n\n/\n Layout node that references an object field and registers an inner layout\n * on it. Resolved as a single-field row in the outer layout — the inner\n * layout is exposed on the field's VM (`field.layout` for single objects,\n * `item.layout` for list items).\n \n - For non-templated objects, `inner` is `LayoutNode[]` (one layout, applied\n * to the single object or every list item).\n * - For templated objects, `inner` is `Record<templateId, LayoutNode[]>` —\n * each entry is the layout used when that template is active (or for each\n * list item with that template).\n /\nexport interface IObjectNode {\n type: \"object\";\n fieldName: string;\n inner: LayoutNode[] \| Record<string, LayoutNode[]>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout node builders\n// ---------------------------------------------------------------------------\n\nexport interface ILayoutNodeBuilder {\n build(): LayoutNode;\n}\n\nexport interface IRowBuilder extends ILayoutNodeBuilder {\n before(target: string): IRowBuilder;\n after(target: string): IRowBuilder;\n build(): IRowNode;\n}\n\nexport interface ISeparatorBuilder extends ILayoutNodeBuilder {\n title(text: string): this;\n description(text: string): this;\n rules(rules: IRule[]): this;\n build(): ISeparatorNode;\n}\n\nexport interface IAlertBuilder extends ILayoutNodeBuilder {\n message(text: string): this;\n alertType(type: \"info\" \| \"success\" \| \"warning\" \| \"danger\"): this;\n rules(rules: IRule[]): this;\n build(): IAlertNode;\n}\n\nexport interface ITabBuilder {\n label(text: string): this;\n description(text: string): this;\n icon(icon: Icon): this;\n layout(factory: (l: ILayoutBuilder) => ILayoutNodeBuilder[]): this;\n rules(rules: IRule[]): this;\n}\n\nexport interface ITabsBuilder extends ILayoutNodeBuilder {\n renderer(name: string, settings?: Record<string, unknown>): this;\n tab(id: string, configure: (tab: ITabBuilder) => void): this;\n before(target: string): this;\n after(target: string): this;\n rules(rules: IRule[]): this;\n build(): ITabsNode;\n}\n\nexport interface IElementBuilder extends ILayoutNodeBuilder {\n build(): IElementNode;\n}\n\nexport interface IObjectBuilder extends ILayoutNodeBuilder {\n build(): IObjectNode;\n}\n\n// ---------------------------------------------------------------------------\n// Layout VM types\n// ---------------------------------------------------------------------------\n\nexport type LayoutNodeVM =\n \| IRowNodeVM\n \| ISeparatorNodeVM\n \| IAlertNodeVM\n \| ITabsNodeVM\n \| IElementNodeVM;\n\nexport interface IRowNodeVM {\n type: \"row\";\n fields: IFieldVM[];\n}\n\nexport interface ISeparatorNodeVM {\n type: \"separator\";\n title?: string;\n description?: string;\n}\n\nexport interface IAlertNodeVM {\n type: \"alert\";\n message?: string;\n alertType: \"info\" \| \"success\" \| \"warning\" \| \"danger\";\n}\n\nexport interface ITabDefinitionVM {\n id: string;\n label: string;\n description?: string;\n icon?: Icon;\n hasErrors: boolean;\n disabled: boolean;\n layout: LayoutNodeVM[];\n}\n\nexport interface ITabsNodeVM {\n type: \"tabs\";\n id?: string;\n renderer?: string;\n rendererSettings?: Record<string, unknown>;\n tabs: ITabDefinitionVM[];\n disabled: boolean;\n activeTabId: string;\n setActiveTab: (id: string) => void;\n}\n\nexport interface IElementNodeVM {\n type: \"element\";\n renderer: string;\n props?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Layout modifier types\n// ---------------------------------------------------------------------------\n\nexport type LayoutPosition =\n \| { type: \"before\"; target: string }\n \| { type: \"after\"; target: string }\n \| { type: \"replace\"; target: string };\n\nexport interface IPositionedLayoutNode {\n node: LayoutNode;\n position?: LayoutPosition;\n}\n\n/\n Chainable handle returned by modifier layout.row().\n * Can be used as-is (appended) or positioned via .before()/.after()/.replace().\n /\nexport interface ILayoutNodeHandle extends IPositionedLayoutNode {\n before(target: string): IPositionedLayoutNode;\n after(target: string): IPositionedLayoutNode;\n replace(target: string): IPositionedLayoutNode;\n}\n\n// ---------------------------------------------------------------------------\n// Named layout node access types\n// ---------------------------------------------------------------------------\n\nexport interface LayoutNodeHandleMap {\n tabs: ITabsBuilder;\n element: IElementNode;\n object: IObjectNode;\n}\n\nexport interface ILayoutNodeAccessHandle {\n as<T extends keyof LayoutNodeHandleMap>(type: T): LayoutNodeHandleMap[T];\n}\n\n/* @deprecated Use ITabsBuilder instead /\nexport type ITabsHandle = ITabsBuilder;\n\n/* @deprecated Use ITabBuilder instead /\nexport type ITabHandle = ITabBuilder;\n\n// ---------------------------------------------------------------------------\n// Modifier types\n// ---------------------------------------------------------------------------\n\nexport interface IFormModifier {\n modify(form: IFormModel): void;\n}\n\nexport interface ILayoutModifier {\n row(...fieldIds: string[]): ILayoutNodeHandle;\n separator(): ILayoutNodeHandle;\n alert(): ILayoutNodeHandle;\n tabs(config: {\n id?: string;\n renderer?: string;\n tabs: ITabDefinitionInput[];\n rules?: IRule[];\n }): ILayoutNodeHandle;\n element(renderer: string, props?: Record<string, unknown>): ILayoutNodeHandle;\n object(\n fieldName: string,\n layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n ): ILayoutNodeHandle;\n object(\n fieldName: string,\n templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n ): ILayoutNodeHandle;\n remove(target: string): void;\n}\n\n// ---------------------------------------------------------------------------\n// Form types\n// ---------------------------------------------------------------------------\n\nexport interface IFormError {\n path: string;\n label?: string;\n breadcrumb?: string[];\n message: string;\n}\n\nexport interface IFormVM {\n layout: LayoutNodeVM[];\n errors: IFormError[];\n hasErrors: boolean;\n isDirty: boolean;\n isValid: boolean \| null;\n submitCount: number;\n focusField(path: string): void;\n getData(): Record<string, unknown>;\n setData(data: Record<string, unknown>, options?: { dirty?: boolean }): void;\n}\n\n/\n Imperative form-level rule. Receives the live form and may return a flat\n * list of errors (sync or async). Errors are merged into `form.errors` and\n * surfaced on per-field validation when their `path` matches a known field.\n /\nexport type FormRuleFn = (\n form: IFormModel\n) => IFormError[] \| undefined \| void \| Promise<IFormError[] \| undefined \| void>;\n\n/\n A form-level rule. Either a Zod schema (validated against `form.getData()`)\n * or an imperative function returning an error list.\n /\nexport type FormRule = z.ZodTypeAny \| FormRuleFn;\n\nexport interface IFormModel<T = Record<string, any>> {\n field(name: string): IField;\n fields(\n factory: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder \| undefined>\n ): void;\n layout(factory: (layout: ILayoutModifier) => (LayoutNode \| IPositionedLayoutNode)[]): void;\n layout(nodeId: string): ILayoutNodeAccessHandle;\n /\n Replace the entire layout. Re-registers per-field inner layouts and\n * propagates ancestor rules. Use `layout()` (modifier form) for additive\n * changes.\n /\n setLayout(factory: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]): void;\n /\n Append a form-level validation rule. Runs after per-field validation.\n * Accepts a Zod schema (validated against `getData()`) or an imperative\n * function returning a list of errors.\n /\n addRule(rule: FormRule): void;\n getData(): T;\n setData(data: T, options?: { dirty?: boolean }): void;\n reset(): void;\n validate(): Promise<boolean>;\n submit<T = Record<string, unknown>>(options?: { skipValidation?: boolean }): Promise<T \| false>;\n evaluateRules(rules: IRule[] \| undefined): { visible: boolean; disabled: boolean };\n focusField(name: string): void;\n readonly isDirty: boolean;\n readonly isValid: boolean \| null;\n readonly submitted: boolean;\n readonly submitCount: number;\n readonly errors: IFormError[];\n readonly vm: IFormVM;\n getFieldBuilders(predicate?: (builder: IFieldBuilder) => boolean): IFieldBuilder[];\n traverse(callback: (builder: IFieldBuilder) => void): void;\n resolveChildLayout(layout: LayoutNode[], children: Map<string, IField>): LayoutNodeVM[];\n readonly registry: IFieldBuilderRegistry;\n}\n\n// ---------------------------------------------------------------------------\n// FormModel namespace — groups all public types under one import\n// ---------------------------------------------------------------------------\n\nexport namespace FormModel {\n export type FieldConfig = IFieldConfig;\n export type ValueOption = IValueOption;\n export type FieldValidation = IFieldValidation;\n export type FieldVM = IFieldVM;\n export type Field = IField;\n export type ObjectField = IObjectField;\n export type ObjectFieldConfig = IObjectFieldConfig;\n export type BeforeChange = BeforeChangeCallback;\n export type AfterChange = AfterChangeCallback;\n export type AfterSetValue = AfterSetValueCallback;\n export type OnBlur = OnBlurCallback;\n export type CloneValue = CloneValueCallback;\n export type LayoutNodeBuilder = ILayoutNodeBuilder;\n export type RowBuilder = IRowBuilder;\n export type SeparatorBuilder = ISeparatorBuilder;\n export type AlertBuilder = IAlertBuilder;\n export type AlertNode = IAlertNode;\n export type AlertNodeVM = IAlertNodeVM;\n export type TabBuilder = ITabBuilder;\n export type TabsBuilder = ITabsBuilder;\n export type ElementBuilder = IElementBuilder;\n export type ObjectBuilder = IObjectBuilder;\n export type RowNode = IRowNode;\n /* @deprecated Use RowBuilder instead /\n export type RowNodeHandle = IRowNodeHandle;\n export type RowNodeVM = IRowNodeVM;\n export type SeparatorNode = ISeparatorNode;\n export type SeparatorNodeVM = ISeparatorNodeVM;\n export type TabsNode = ITabsNode;\n export type TabDefinition = ITabDefinition;\n export type TabDefinitionInput = ITabDefinitionInput;\n export type TabsNodeVM = ITabsNodeVM;\n export type TabDefinitionVM = ITabDefinitionVM;\n export type TabIcon = Icon;\n export type ElementNode = IElementNode;\n export type ElementNodeVM = IElementNodeVM;\n export type ObjectNode = IObjectNode;\n export type ObjectFieldVM = IObjectFieldVM;\n export type ObjectFieldItemVM = IObjectFieldItemVM;\n export type TemplateBuilder = ITemplateBuilder;\n export type TemplateConfig = ITemplateConfig;\n export type TemplateIcon = ITemplateIcon;\n export type TemplateVM = ITemplateVM;\n export type ObjectFieldTemplatesAPI = IObjectFieldTemplates;\n export type FormError = IFormError;\n export type FormVM = IFormVM;\n export type Interface<T = Record<string, any>> = IFormModel<T>;\n export type Modifier = IFormModifier;\n export type LayoutModifier = ILayoutModifier;\n export type Rule = IRule;\n export type Action = RuleAction;\n export type RuleEvaluator = IRuleEvaluator;\n export type FormRuleFunction = FormRuleFn;\n export type FormRuleType = FormRule;\n export type CallbackParams = IFieldCallbackParams;\n export type RequiredWhen = (params: IFieldCallbackParams) => boolean;\n export type HiddenWhen = HiddenWhenCallback;\n export type DisabledWhen = DisabledWhenCallback;\n export type Computed = ComputedFieldCallback;\n}\n\n// ---------------------------------------------------------------------------\n// FormModelFactory abstraction\n// ---------------------------------------------------------------------------\n\nexport interface IFormModelFactory {\n create<T = Record<string, any>>(config: IFormModelConfig): IFormModel<T>;\n}\n\nexport interface IFormModelConfig {\n fields: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>;\n layout?: (layout: ILayoutBuilder) => ILayoutNodeBuilder[];\n validateOnSubmit?: boolean;\n ruleEvaluators?: IRuleEvaluator[];\n}\n\nexport interface ILayoutBuilder {\n row(...fieldIds: string[]): IRowBuilder;\n separator(): ISeparatorBuilder;\n alert(): IAlertBuilder;\n tabs(id?: string): ITabsBuilder;\n element(renderer: string, props?: Record<string, unknown>): IElementBuilder;\n /\n Reference an object field and register its inner layout.\n \n Non-templated: pass a single layout factory; the layout applies to the\n * single object or to every list item. Templated: pass a map of factories\n * keyed by template id; each entry applies when that template is active\n * (or for each list item with that template). Templates without an entry\n * fall back to default one-row-per-visible-child.\n /\n object(\n fieldName: string,\n layout: (layout: ILayoutBuilder) => ILayoutNodeBuilder[]\n ): IObjectBuilder;\n object(\n fieldName: string,\n templateLayouts: Record<string, (layout: ILayoutBuilder) => ILayoutNodeBuilder[]>\n ): IObjectBuilder;\n}\n\nexport interface IFieldBuilder<\n TType extends string = string,\n TOptions extends boolean = false,\n TValue = unknown\n> {\n readonly __valueType?: TValue;\n label(text: string): this;\n help(text: string): this;\n description(text: string): this;\n note(text: string): this;\n placeholder(text: string): this;\n autoFocus(value?: boolean): this;\n schema(zodSchema: z.ZodTypeAny): this;\n defaultValue(value: unknown): this;\n renderer<TName extends FieldRendererName<TType, TOptions>>(\n name: TName,\n ...args: undefined extends FieldRendererSettings<TName>\n ? [settings?: FieldRendererSettings<TName>]\n : FieldRendererSettings<TName> extends undefined\n ? []\n : [settings: FieldRendererSettings<TName>]\n ): this;\n hidden(): this;\n hiddenWhen(fn: HiddenWhenCallback): this;\n disabledWhen(fn: DisabledWhenCallback): this;\n required(message?: string): this;\n /\n Conditional required check. Multiple `requiredWhen()` calls chain — the\n * first one to return `true` for the current form state makes the field\n * required. Built-in `.required()` (if set) is evaluated alongside.\n /\n requiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): this;\n list(): this;\n disabled(value?: boolean): this;\n rules(rules: IRule[]): this;\n beforeChange(fn: BeforeChangeCallback): this;\n afterChange(fn: AfterChangeCallback): this;\n afterSetValue(fn: AfterSetValueCallback): this;\n onBlur(fn: OnBlurCallback): this;\n cloneValue(fn: CloneValueCallback): this;\n getName(): string;\n getType(): string;\n getTags(): string[];\n tags(tags: string[]): this;\n /\n Mark this field as a derived value computed from `fn(form)`. The field\n * stays editable; user edits are accepted but the computed value continues\n * to flow whenever a dependency changes. To make the user \"win\", use\n * `computedUntilDirty()` instead.\n /\n computed(fn: ComputedFieldCallback): this;\n /\n Same as `computed`, but the field switches to manual mode the first time\n * its value is changed via the UI. After that, `fn(form)` no longer\n * overrides user input.\n */\n computedUntilDirty(fn: ComputedFieldCallback): this;\n build(name: string): IFieldConfig;\n}\n\nexport interface IOptionsFieldBuilder<TType extends string, TValue = unknown> extends IFieldBuilder<\n TType,\n false,\n TValue\n> {\n options(\n opts:\n \| IValueOption<OptionValueType<TType>>[]\n \| ((params: IFieldCallbackParams) => IValueOption<OptionValueType<TType>>[])\n ): IFieldBuilder<TType, true, TValue>;\n}\n\nexport interface IObjectFieldBuilder extends IFieldBuilder<\n \"object\",\n false,\n Record<string, unknown> \| null\n> {\n fields(fn: (registry: IFieldBuilderRegistry) => Record<string, IFieldBuilder>): this;\n list(): this;\n listSchema(schema: z.ZodTypeAny): this;\n template(id: string, configure: (t: ITemplateBuilder) => void): this;\n}\n\nexport interface IFieldBuilderRegistry {}\n\n// ---------------------------------------------------------------------------\n// Field type plugin system\n// ---------------------------------------------------------------------------\n\nexport interface IFieldTypeFactory {\n readonly type: string;\n create(registry: IFieldBuilderRegistry): IFieldBuilder;\n}\n\nexport const FieldType = createAbstraction<IFieldTypeFactory>(\"FormModel/FieldType\");\n\nexport namespace FieldType {\n export type Interface = IFieldTypeFactory;\n export type FieldBuilder = IFieldBuilder;\n export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const FieldBuilderRegistry = createAbstraction<IFieldBuilderRegistry>(\n \"FormModel/FieldBuilderRegistry\"\n);\n\nexport namespace FieldBuilderRegistry {\n export type Interface = IFieldBuilderRegistry;\n}\n\nexport const FormModelFactory = createAbstraction<IFormModelFactory>(\"FormModelFactory\");\n\nexport namespace FormModelFactory {\n export type Interface = IFormModelFactory;\n export type Config = IFormModelConfig;\n export type LayoutBuilder = ILayoutBuilder;\n export type FieldBuilder = IFieldBuilder;\n export type OptionsFieldBuilder<TType extends string> = IOptionsFieldBuilder<TType>;\n export type ObjectFieldBuilder = IObjectFieldBuilder;\n export type FieldBuilderRegistry = IFieldBuilderRegistry;\n}\n\nexport const RuleEvaluator = createAbstraction<IRuleEvaluator>(\"FormModelRuleEvaluator\");\n\nexport namespace RuleEvaluator {\n export type Interface = IRuleEvaluator;\n export type Rule = IRule;\n export type Action = RuleAction;\n}\n"],"names":["FieldType","createAbstraction","FieldBuilderRegistry","FormModelFactory","RuleEvaluator"],"mappings":";AAi8BO,MAAMA,YAAYC,kBAAqC;AAQvD,MAAMC,uBAAuBD,kBAChC;AAOG,MAAME,mBAAmBF,kBAAqC;AAY9D,MAAMG,gBAAgBH,kBAAkC"}

package/features/formModel/demo/FormModelPhase11Presenter.js CHANGED Viewed

@@ -8,9 +8,9 @@ class FormModelPhase11Presenter {
             fields: (fields)=>({
                     first: fields.text().label("First name").defaultValue("Ada"),
                     last: fields.text().label("Last name").defaultValue("Lovelace"),
-                    fullName: fields.text().label("Full name (computed)").computed((f)=>`${f.field("first").getValue()} ${f.field("last").getValue()}`),
-                    slug: fields.text().label("Slug (computed until you edit it)").computedUntilDirty((f)=>{
-                        const full = `${f.field("first").getValue()} ${f.field("last").getValue()}`;
+                    fullName: fields.text().label("Full name (computed)").computed(({ form })=>`${form.field("first").getValue()} ${form.field("last").getValue()}`),
+                    slug: fields.text().label("Slug (computed until you edit it)").computedUntilDirty(({ form })=>{
+                        const full = `${form.field("first").getValue()} ${form.field("last").getValue()}`;
                         return full.trim().toLowerCase().replace(/\s+/g, "-");
                     }),
                     plan: fields.text().label("Plan").defaultValue("free").options([
@@ -27,7 +27,7 @@ class FormModelPhase11Presenter {
                             value: "enterprise"
                         }
                     ]),
-                    seats: fields.text().label("Number of seats").help("Required when plan is pro or enterprise").requiredWhen((f)=>"pro" === f.field("plan").getValue(), "Pro plan needs a seat count"),
+                    seats: fields.text().label("Number of seats").help("Required when plan is pro or enterprise").requiredWhen(({ form })=>"pro" === form.field("plan").getValue(), "Pro plan needs a seat count"),
                     profile: fields.object().label("Profile").fields((f)=>({
                             title: f.text().label("Title")
                         })),
@@ -39,7 +39,7 @@ class FormModelPhase11Presenter {
                 company: f.text().label("Company"),
                 bio: f.text().label("Short bio")
             }));
-        this.form.field("seats").addRequiredWhen((f)=>"enterprise" === f.field("plan").getValue(), "Enterprise plan needs a seat count too");
+        this.form.field("seats").addRequiredWhen(({ form })=>"enterprise" === form.field("plan").getValue(), "Enterprise plan needs a seat count too");
         this.form.addRule(z.object({
             password: z.string().nullable(),
             confirm: z.string().nullable()

package/features/formModel/demo/FormModelPhase11Presenter.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"features/formModel/demo/FormModelPhase11Presenter.js","sources":["../../../../src/features/formModel/demo/FormModelPhase11Presenter.ts"],"sourcesContent":["import { makeAutoObservable, toJS } from \"mobx\";\nimport { z } from \"zod\";\nimport type { IFormModel, IFormModelFactory, IFormVM } from \"../abstractions.js\";\n\nexport interface FormModelPhase11VM {\n form: IFormVM;\n data: Record<string, unknown>;\n lastSubmitted: Record<string, unknown> \| null;\n isSubmitting: boolean;\n formErrors: { path: string; message: string }[];\n}\n\n/*\n Demo presenter exercising Phase 11 features: requiredWhen (builder + modifier\n * chaining), computed/computedUntilDirty, .extend() on object fields, form-level\n * addRule (Zod + imperative), and setLayout.\n */\nexport class FormModelPhase11Presenter {\n private form: IFormModel;\n private lastSubmitted: Record<string, unknown> \| null = null;\n private isSubmitting = false;\n\n constructor(formFactory: IFormModelFactory) {\n this.form = formFactory.create({\n fields: fields => ({\n first: fields.text().label(\"First name\").defaultValue(\"Ada\"),\n last: fields.text().label(\"Last name\").defaultValue(\"Lovelace\"),\n fullName: fields\n .text()\n .label(\"Full name (computed)\")\n .computed(f => `${f.field(\"first\").getValue()} ${f.field(\"last\").getValue()}`),\n slug: fields\n .text()\n .label(\"Slug (computed until you edit it)\")\n .computedUntilDirty(f => {\n const full = `${f.field(\"first\").getValue()} ${f.field(\"last\").getValue()}`;\n return full.trim().toLowerCase().replace(/\\s+/g, \"-\");\n }),\n plan: fields\n .text()\n .label(\"Plan\")\n .defaultValue(\"free\")\n .options([\n { label: \"Free\", value: \"free\" },\n { label: \"Pro\", value: \"pro\" },\n { label: \"Enterprise\", value: \"enterprise\" }\n ]),\n seats: fields\n .text()\n .label(\"Number of seats\")\n .help(\"Required when plan is pro or enterprise\")\n .requiredWhen(\n f => f.field(\"plan\").getValue() === \"pro\",\n \"Pro plan needs a seat count\"\n ),\n profile: fields\n .object()\n .label(\"Profile\")\n .fields(f => ({\n title: f.text().label(\"Title\")\n })),\n password: fields.text().label(\"Password\"),\n confirm: fields.text().label(\"Confirm password\")\n })\n });\n\n // Modifier-style: add children to the existing \"profile\" object field.\n this.form\n .field(\"profile\")\n .as(\"object\")\n .fields(f => ({\n company: f.text().label(\"Company\"),\n bio: f.text().label(\"Short bio\")\n }));\n\n // Modifier-style requiredWhen: chains with the builder-defined one above.\n // First truthy callback wins.\n this.form\n .field(\"seats\")\n .addRequiredWhen(\n f => f.field(\"plan\").getValue() === \"enterprise\",\n \"Enterprise plan needs a seat count too\"\n );\n\n // Form-level Zod rule: confirm must match password.\n this.form.addRule(\n z\n .object({\n password: z.string().nullable(),\n confirm: z.string().nullable()\n })\n .refine(d => d.password === d.confirm \|\| (!d.password && !d.confirm), {\n message: \"Passwords must match\",\n path: [\"confirm\"]\n })\n );\n\n // Imperative form-level rule.\n this.form.addRule(f => {\n const slug = String(f.field(\"slug\").getValue() ?? \"\");\n if (slug.length > 0 && slug.length < 3) {\n return [{ path: \"slug\", message: \"Slug must be at least 3 characters\" }];\n }\n return [];\n });\n\n // setLayout — full replacement.\n this.form.setLayout(layout => [\n layout.row(\"first\", \"last\"),\n layout.row(\"fullName\"),\n layout.row(\"slug\"),\n layout.separator(),\n layout.row(\"plan\", \"seats\"),\n layout.separator(),\n layout.object(\"profile\", l => [l.row(\"title\"), l.row(\"company\"), l.row(\"bio\")]),\n layout.separator(),\n layout.row(\"password\", \"confirm\")\n ]);\n\n makeAutoObservable(this);\n }\n\n get vm(): FormModelPhase11VM {\n return {\n form: this.form.vm,\n data: toJS(this.form.getData()),\n lastSubmitted: this.lastSubmitted,\n isSubmitting: this.isSubmitting,\n formErrors: this.form.errors.map(e => ({\n path: e.path,\n message: e.message\n }))\n };\n }\n\n async submit(): Promise<void> {\n this.isSubmitting = true;\n try {\n const result = await this.form.submit<Record<string, unknown>>();\n if (result !== false) {\n this.lastSubmitted = toJS(result);\n }\n } finally {\n this.isSubmitting = false;\n }\n }\n\n reset(): void {\n this.form.reset();\n this.lastSubmitted = null;\n }\n}\n"],"names":["FormModelPhase11Presenter","formFactory","fields","f","full","z","d","slug","String","layout","l","makeAutoObservable","toJS","e","result"],"mappings":";;AAiBO,MAAMA;IAKT,YAAYC,WAA8B,CAAE;aAHpC,aAAa,GAAmC;aAChD,YAAY,GAAG;QAGnB,IAAI,CAAC,IAAI,GAAGA,YAAY,MAAM,CAAC;YAC3B,QAAQC,CAAAA,SAAW;oBACf,OAAOA,OAAO,IAAI,GAAG,KAAK,CAAC,cAAc,YAAY,CAAC;oBACtD,MAAMA,OAAO,IAAI,GAAG,KAAK,CAAC,aAAa,YAAY,CAAC;oBACpD,UAAUA,OACL,IAAI,GACJ,KAAK,CAAC,wBACN,QAAQ,~~CAACC~~,~~CAAAA~~,~~IAAK~~,~~GAAGA~~,EAAE,KAAK,CAAC,SAAS,QAAQ,GAAG,CAAC,EAAEA,~~EAAE~~,KAAK,CAAC,QAAQ,QAAQ,IAAI;~~oBACjF~~,MAAMD,OACD,IAAI,GACJ,KAAK,CAAC,qCACN,kBAAkB,~~CAACC~~,~~CAAAA~~;~~wBAChB~~,MAAMC,OAAO,GAAGD,~~EAAE~~,KAAK,CAAC,SAAS,QAAQ,GAAG,CAAC,EAAEA,~~EAAE~~,KAAK,CAAC,QAAQ,QAAQ,IAAI;~~wBAC3E~~,OAAOC,KAAK,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,QAAQ;oBACrD;oBACJ,MAAMF,OACD,IAAI,GACJ,KAAK,CAAC,QACN,YAAY,CAAC,QACb,OAAO,CAAC;wBACL;4BAAE,OAAO;4BAAQ,OAAO;wBAAO;wBAC/B;4BAAE,OAAO;4BAAO,OAAO;wBAAM;wBAC7B;4BAAE,OAAO;4BAAc,OAAO;wBAAa;qBAC9C;oBACL,OAAOA,OACF,IAAI,GACJ,KAAK,CAAC,mBACN,IAAI,CAAC,2CACL,YAAY,~~CACTC~~,~~CAAAA~~,~~IAAKA~~,~~AAA+B~~,~~UAA/BA,~~EAAE,KAAK,CAAC,QAAQ,QAAQ,~~IAC7B~~;oBAER,SAASD,OACJ,MAAM,GACN,KAAK,CAAC,WACN,MAAM,~~CAACC~~,CAAAA,IAAM;4BACV,OAAOA,EAAE,IAAI,GAAG,KAAK,CAAC;wBAC1B;oBACJ,~~UAAUD~~,OAAO,IAAI,GAAG,KAAK,CAAC;oBAC9B,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;gBACjC;QACJ;QAGA,IAAI,CAAC,IAAI,CACJ,KAAK,CAAC,WACN,EAAE,CAAC,UACH,MAAM,~~CAACC~~,CAAAA,IAAM;gBACV,SAASA,EAAE,IAAI,GAAG,KAAK,CAAC;gBACxB,KAAKA,EAAE,IAAI,GAAG,KAAK,CAAC;YACxB;QAIJ,IAAI,CAAC,IAAI,CACJ,KAAK,CAAC,SACN,eAAe,~~CACZA~~,~~CAAAA~~,~~IAAKA~~,~~AAA+B~~,~~iBAA/BA,~~EAAE,KAAK,CAAC,QAAQ,QAAQ,~~IAC7B~~;QAIR,IAAI,CAAC,IAAI,CAAC,OAAO,~~CACbE~~,EAAAA,MACW,CAAC;YACJ,UAAUA,EAAE,MAAM,GAAG,QAAQ;YAC7B,SAASA,EAAE,MAAM,GAAG,QAAQ;QAChC,GACC,MAAM,CAACC,CAAAA,IAAKA,EAAE,QAAQ,KAAKA,EAAE,OAAO,IAAK,CAACA,EAAE,QAAQ,IAAI,CAACA,EAAE,OAAO,EAAG;YAClE,SAAS;YACT,MAAM;gBAAC;aAAU;QACrB;QAIR,IAAI,CAAC,IAAI,CAAC,OAAO,~~CAACH~~,CAAAA;YACd,~~MAAMI~~,OAAOC,~~OAAOL~~,EAAE,KAAK,CAAC,QAAQ,QAAQ,MAAM;YAClD,~~IAAII~~,KAAK,MAAM,GAAG,KAAKA,KAAK,MAAM,GAAG,GACjC,OAAO;gBAAC;oBAAE,MAAM;oBAAQ,SAAS;gBAAqC;aAAE;YAE5E,OAAO,EAAE;QACb;QAGA,IAAI,CAAC,IAAI,CAAC,SAAS,CAACE,CAAAA,SAAU;gBAC1BA,OAAO,GAAG,CAAC,SAAS;gBACpBA,OAAO,GAAG,CAAC;gBACXA,OAAO,GAAG,CAAC;gBACXA,OAAO,SAAS;gBAChBA,OAAO,GAAG,CAAC,QAAQ;gBACnBA,OAAO,SAAS;gBAChBA,OAAO,MAAM,CAAC,WAAWC,CAAAA,IAAK;wBAACA,EAAE,GAAG,CAAC;wBAAUA,EAAE,GAAG,CAAC;wBAAYA,EAAE,GAAG,CAAC;qBAAO;gBAC9ED,OAAO,SAAS;gBAChBA,OAAO,GAAG,CAAC,YAAY;aAC1B;QAEDE,mBAAmB,IAAI;IAC3B;IAEA,IAAI,KAAyB;QACzB,OAAO;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE;YAClB,MAAMC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO;YAC5B,eAAe,IAAI,CAAC,aAAa;YACjC,cAAc,IAAI,CAAC,YAAY;YAC/B,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAACC,CAAAA,IAAM;oBACnC,MAAMA,EAAE,IAAI;oBACZ,SAASA,EAAE,OAAO;gBACtB;QACJ;IACJ;IAEA,MAAM,SAAwB;QAC1B,IAAI,CAAC,YAAY,GAAG;QACpB,IAAI;YACA,MAAMC,SAAS,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YACrC,IAAIA,AAAW,UAAXA,QACA,IAAI,CAAC,aAAa,GAAGF,KAAKE;QAElC,SAAU;YACN,IAAI,CAAC,YAAY,GAAG;QACxB;IACJ;IAEA,QAAc;QACV,IAAI,CAAC,IAAI,CAAC,KAAK;QACf,IAAI,CAAC,aAAa,GAAG;IACzB;AACJ"}
1	+ {"version":3,"file":"features/formModel/demo/FormModelPhase11Presenter.js","sources":["../../../../src/features/formModel/demo/FormModelPhase11Presenter.ts"],"sourcesContent":["import { makeAutoObservable, toJS } from \"mobx\";\nimport { z } from \"zod\";\nimport type { IFormModel, IFormModelFactory, IFormVM } from \"../abstractions.js\";\n\nexport interface FormModelPhase11VM {\n form: IFormVM;\n data: Record<string, unknown>;\n lastSubmitted: Record<string, unknown> \| null;\n isSubmitting: boolean;\n formErrors: { path: string; message: string }[];\n}\n\n/*\n Demo presenter exercising Phase 11 features: requiredWhen (builder + modifier\n * chaining), computed/computedUntilDirty, .extend() on object fields, form-level\n * addRule (Zod + imperative), and setLayout.\n */\nexport class FormModelPhase11Presenter {\n private form: IFormModel;\n private lastSubmitted: Record<string, unknown> \| null = null;\n private isSubmitting = false;\n\n constructor(formFactory: IFormModelFactory) {\n this.form = formFactory.create({\n fields: fields => ({\n first: fields.text().label(\"First name\").defaultValue(\"Ada\"),\n last: fields.text().label(\"Last name\").defaultValue(\"Lovelace\"),\n fullName: fields\n .text()\n .label(\"Full name (computed)\")\n .computed(\n ({ form }) =>\n `${form.field(\"first\").getValue()} ${form.field(\"last\").getValue()}`\n ),\n slug: fields\n .text()\n .label(\"Slug (computed until you edit it)\")\n .computedUntilDirty(({ form }) => {\n const full = `${form.field(\"first\").getValue()} ${form.field(\"last\").getValue()}`;\n return full.trim().toLowerCase().replace(/\\s+/g, \"-\");\n }),\n plan: fields\n .text()\n .label(\"Plan\")\n .defaultValue(\"free\")\n .options([\n { label: \"Free\", value: \"free\" },\n { label: \"Pro\", value: \"pro\" },\n { label: \"Enterprise\", value: \"enterprise\" }\n ]),\n seats: fields\n .text()\n .label(\"Number of seats\")\n .help(\"Required when plan is pro or enterprise\")\n .requiredWhen(\n ({ form }) => form.field(\"plan\").getValue() === \"pro\",\n \"Pro plan needs a seat count\"\n ),\n profile: fields\n .object()\n .label(\"Profile\")\n .fields(f => ({\n title: f.text().label(\"Title\")\n })),\n password: fields.text().label(\"Password\"),\n confirm: fields.text().label(\"Confirm password\")\n })\n });\n\n // Modifier-style: add children to the existing \"profile\" object field.\n this.form\n .field(\"profile\")\n .as(\"object\")\n .fields(f => ({\n company: f.text().label(\"Company\"),\n bio: f.text().label(\"Short bio\")\n }));\n\n // Modifier-style requiredWhen: chains with the builder-defined one above.\n // First truthy callback wins.\n this.form\n .field(\"seats\")\n .addRequiredWhen(\n ({ form }) => form.field(\"plan\").getValue() === \"enterprise\",\n \"Enterprise plan needs a seat count too\"\n );\n\n // Form-level Zod rule: confirm must match password.\n this.form.addRule(\n z\n .object({\n password: z.string().nullable(),\n confirm: z.string().nullable()\n })\n .refine(d => d.password === d.confirm \|\| (!d.password && !d.confirm), {\n message: \"Passwords must match\",\n path: [\"confirm\"]\n })\n );\n\n // Imperative form-level rule.\n this.form.addRule(f => {\n const slug = String(f.field(\"slug\").getValue() ?? \"\");\n if (slug.length > 0 && slug.length < 3) {\n return [{ path: \"slug\", message: \"Slug must be at least 3 characters\" }];\n }\n return [];\n });\n\n // setLayout — full replacement.\n this.form.setLayout(layout => [\n layout.row(\"first\", \"last\"),\n layout.row(\"fullName\"),\n layout.row(\"slug\"),\n layout.separator(),\n layout.row(\"plan\", \"seats\"),\n layout.separator(),\n layout.object(\"profile\", l => [l.row(\"title\"), l.row(\"company\"), l.row(\"bio\")]),\n layout.separator(),\n layout.row(\"password\", \"confirm\")\n ]);\n\n makeAutoObservable(this);\n }\n\n get vm(): FormModelPhase11VM {\n return {\n form: this.form.vm,\n data: toJS(this.form.getData()),\n lastSubmitted: this.lastSubmitted,\n isSubmitting: this.isSubmitting,\n formErrors: this.form.errors.map(e => ({\n path: e.path,\n message: e.message\n }))\n };\n }\n\n async submit(): Promise<void> {\n this.isSubmitting = true;\n try {\n const result = await this.form.submit<Record<string, unknown>>();\n if (result !== false) {\n this.lastSubmitted = toJS(result);\n }\n } finally {\n this.isSubmitting = false;\n }\n }\n\n reset(): void {\n this.form.reset();\n this.lastSubmitted = null;\n }\n}\n"],"names":["FormModelPhase11Presenter","formFactory","fields","form","full","f","z","d","slug","String","layout","l","makeAutoObservable","toJS","e","result"],"mappings":";;AAiBO,MAAMA;IAKT,YAAYC,WAA8B,CAAE;aAHpC,aAAa,GAAmC;aAChD,YAAY,GAAG;QAGnB,IAAI,CAAC,IAAI,GAAGA,YAAY,MAAM,CAAC;YAC3B,QAAQC,CAAAA,SAAW;oBACf,OAAOA,OAAO,IAAI,GAAG,KAAK,CAAC,cAAc,YAAY,CAAC;oBACtD,MAAMA,OAAO,IAAI,GAAG,KAAK,CAAC,aAAa,YAAY,CAAC;oBACpD,UAAUA,OACL,IAAI,GACJ,KAAK,CAAC,wBACN,QAAQ,CACL,CAAC,EAAEC,IAAI,EAAE,GACL,GAAGA,KAAK,KAAK,CAAC,SAAS,QAAQ,GAAG,CAAC,EAAEA,KAAK,KAAK,CAAC,QAAQ,QAAQ,IAAI;oBAEhF,MAAMD,OACD,IAAI,GACJ,KAAK,CAAC,qCACN,kBAAkB,CAAC,CAAC,EAAEC,IAAI,EAAE;wBACzB,MAAMC,OAAO,GAAGD,KAAK,KAAK,CAAC,SAAS,QAAQ,GAAG,CAAC,EAAEA,KAAK,KAAK,CAAC,QAAQ,QAAQ,IAAI;wBACjF,OAAOC,KAAK,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,QAAQ;oBACrD;oBACJ,MAAMF,OACD,IAAI,GACJ,KAAK,CAAC,QACN,YAAY,CAAC,QACb,OAAO,CAAC;wBACL;4BAAE,OAAO;4BAAQ,OAAO;wBAAO;wBAC/B;4BAAE,OAAO;4BAAO,OAAO;wBAAM;wBAC7B;4BAAE,OAAO;4BAAc,OAAO;wBAAa;qBAC9C;oBACL,OAAOA,OACF,IAAI,GACJ,KAAK,CAAC,mBACN,IAAI,CAAC,2CACL,YAAY,CACT,CAAC,EAAEC,IAAI,EAAE,GAAKA,AAAkC,UAAlCA,KAAK,KAAK,CAAC,QAAQ,QAAQ,IACzC;oBAER,SAASD,OACJ,MAAM,GACN,KAAK,CAAC,WACN,MAAM,CAACG,CAAAA,IAAM;4BACV,OAAOA,EAAE,IAAI,GAAG,KAAK,CAAC;wBAC1B;oBACJ,UAAUH,OAAO,IAAI,GAAG,KAAK,CAAC;oBAC9B,SAASA,OAAO,IAAI,GAAG,KAAK,CAAC;gBACjC;QACJ;QAGA,IAAI,CAAC,IAAI,CACJ,KAAK,CAAC,WACN,EAAE,CAAC,UACH,MAAM,CAACG,CAAAA,IAAM;gBACV,SAASA,EAAE,IAAI,GAAG,KAAK,CAAC;gBACxB,KAAKA,EAAE,IAAI,GAAG,KAAK,CAAC;YACxB;QAIJ,IAAI,CAAC,IAAI,CACJ,KAAK,CAAC,SACN,eAAe,CACZ,CAAC,EAAEF,IAAI,EAAE,GAAKA,AAAkC,iBAAlCA,KAAK,KAAK,CAAC,QAAQ,QAAQ,IACzC;QAIR,IAAI,CAAC,IAAI,CAAC,OAAO,CACbG,EAAAA,MACW,CAAC;YACJ,UAAUA,EAAE,MAAM,GAAG,QAAQ;YAC7B,SAASA,EAAE,MAAM,GAAG,QAAQ;QAChC,GACC,MAAM,CAACC,CAAAA,IAAKA,EAAE,QAAQ,KAAKA,EAAE,OAAO,IAAK,CAACA,EAAE,QAAQ,IAAI,CAACA,EAAE,OAAO,EAAG;YAClE,SAAS;YACT,MAAM;gBAAC;aAAU;QACrB;QAIR,IAAI,CAAC,IAAI,CAAC,OAAO,CAACF,CAAAA;YACd,MAAMG,OAAOC,OAAOJ,EAAE,KAAK,CAAC,QAAQ,QAAQ,MAAM;YAClD,IAAIG,KAAK,MAAM,GAAG,KAAKA,KAAK,MAAM,GAAG,GACjC,OAAO;gBAAC;oBAAE,MAAM;oBAAQ,SAAS;gBAAqC;aAAE;YAE5E,OAAO,EAAE;QACb;QAGA,IAAI,CAAC,IAAI,CAAC,SAAS,CAACE,CAAAA,SAAU;gBAC1BA,OAAO,GAAG,CAAC,SAAS;gBACpBA,OAAO,GAAG,CAAC;gBACXA,OAAO,GAAG,CAAC;gBACXA,OAAO,SAAS;gBAChBA,OAAO,GAAG,CAAC,QAAQ;gBACnBA,OAAO,SAAS;gBAChBA,OAAO,MAAM,CAAC,WAAWC,CAAAA,IAAK;wBAACA,EAAE,GAAG,CAAC;wBAAUA,EAAE,GAAG,CAAC;wBAAYA,EAAE,GAAG,CAAC;qBAAO;gBAC9ED,OAAO,SAAS;gBAChBA,OAAO,GAAG,CAAC,YAAY;aAC1B;QAEDE,mBAAmB,IAAI;IAC3B;IAEA,IAAI,KAAyB;QACzB,OAAO;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE;YAClB,MAAMC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO;YAC5B,eAAe,IAAI,CAAC,aAAa;YACjC,cAAc,IAAI,CAAC,YAAY;YAC/B,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAACC,CAAAA,IAAM;oBACnC,MAAMA,EAAE,IAAI;oBACZ,SAASA,EAAE,OAAO;gBACtB;QACJ;IACJ;IAEA,MAAM,SAAwB;QAC1B,IAAI,CAAC,YAAY,GAAG;QACpB,IAAI;YACA,MAAMC,SAAS,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YACrC,IAAIA,AAAW,UAAXA,QACA,IAAI,CAAC,aAAa,GAAGF,KAAKE;QAElC,SAAU;YACN,IAAI,CAAC,YAAY,GAAG;QACxB;IACJ;IAEA,QAAc;QACV,IAAI,CAAC,IAAI,CAAC,KAAK;QACf,IAAI,CAAC,aAAa,GAAG;IACzB;AACJ"}

package/features/formModel/feature.js CHANGED Viewed

@@ -3,7 +3,7 @@ import { FormModelFactory } from "./abstractions.js";
 import { FormModelFactory as external_FormModelFactory_js_FormModelFactory } from "./FormModelFactory.js";
 import { ConditionRuleEvaluator } from "./ConditionRuleEvaluator.js";
 import { FieldBuilderRegistry } from "./FieldBuilderRegistry.js";
-import { BooleanFieldType, DateTimeFieldType, FileFieldType, FileUrlFieldType, LexicalFieldType, NumberFieldType, ObjectFieldType, TextFieldType } from "./fieldTypes/index.js";
+import { BooleanFieldType, DateTimeFieldType, FileFieldType, FileUrlFieldType, LexicalFieldType, NumberFieldType, ObjectFieldType, PasswordFieldType, PermissionsFieldType, RolesMultiSelectFieldType, TextFieldType } from "./fieldTypes/index.js";
 const FormModelFeature = createFeature({
     name: "FormModel",
     register (container) {
@@ -15,6 +15,9 @@ const FormModelFeature = createFeature({
         container.register(FileUrlFieldType);
         container.register(ObjectFieldType);
         container.register(LexicalFieldType);
+        container.register(PasswordFieldType);
+        container.register(PermissionsFieldType);
+        container.register(RolesMultiSelectFieldType);
         container.register(FieldBuilderRegistry).inSingletonScope();
         container.register(ConditionRuleEvaluator).inSingletonScope();
         container.register(external_FormModelFactory_js_FormModelFactory).inSingletonScope();

package/features/formModel/feature.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"features/formModel/feature.js","sources":["../../../src/features/formModel/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/admin\";\nimport { FormModelFactory as Abstraction } from \"./abstractions.js\";\nimport { FormModelFactory } from \"./FormModelFactory.js\";\nimport { ConditionRuleEvaluator } from \"./ConditionRuleEvaluator.js\";\nimport { FieldBuilderRegistry } from \"./FieldBuilderRegistry.js\";\nimport {\n TextFieldType,\n NumberFieldType,\n BooleanFieldType,\n DateTimeFieldType,\n FileFieldType,\n FileUrlFieldType,\n ObjectFieldType,\n LexicalFieldType\n} from \"./fieldTypes/index.js\";\n\nexport const FormModelFeature = createFeature({\n name: \"FormModel\",\n register(container) {\n container.register(TextFieldType);\n container.register(NumberFieldType);\n container.register(BooleanFieldType);\n container.register(DateTimeFieldType);\n container.register(FileFieldType);\n container.register(FileUrlFieldType);\n container.register(ObjectFieldType);\n container.register(LexicalFieldType);\n\n container.register(FieldBuilderRegistry).inSingletonScope();\n container.register(ConditionRuleEvaluator).inSingletonScope();\n container.register(FormModelFactory).inSingletonScope();\n },\n resolve(container) {\n return {\n formModelFactory: container.resolve(Abstraction)\n };\n }\n});\n"],"names":["FormModelFeature","createFeature","container","TextFieldType","NumberFieldType","BooleanFieldType","DateTimeFieldType","FileFieldType","FileUrlFieldType","ObjectFieldType","LexicalFieldType","FieldBuilderRegistry","ConditionRuleEvaluator","FormModelFactory","Abstraction"],"mappings":";;;;;;~~AAgBO~~,MAAMA,mBAAmBC,cAAc;IAC1C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QACnBD,UAAU,QAAQ,CAACE;QACnBF,UAAU,QAAQ,CAACG;QACnBH,UAAU,QAAQ,CAACI;QACnBJ,UAAU,QAAQ,CAACK;QACnBL,UAAU,QAAQ,CAACM;QACnBN,UAAU,QAAQ,CAACO;QACnBP,UAAU,QAAQ,CAACQ;~~QAEnBR~~,UAAU,QAAQ,CAACS,sBAAsB,gBAAgB;~~QACzDT~~,UAAU,QAAQ,~~CAACU~~,wBAAwB,gBAAgB;~~QAC3DV~~,UAAU,QAAQ,~~CAACW~~,+CAAkB,gBAAgB;IACzD;IACA,~~SAAQX~~,SAAS;QACb,OAAO;YACH,kBAAkBA,UAAU,OAAO,~~CAACY~~;QACxC;IACJ;AACJ"}
1	+ {"version":3,"file":"features/formModel/feature.js","sources":["../../../src/features/formModel/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/admin\";\nimport { FormModelFactory as Abstraction } from \"./abstractions.js\";\nimport { FormModelFactory } from \"./FormModelFactory.js\";\nimport { ConditionRuleEvaluator } from \"./ConditionRuleEvaluator.js\";\nimport { FieldBuilderRegistry } from \"./FieldBuilderRegistry.js\";\nimport {\n TextFieldType,\n NumberFieldType,\n BooleanFieldType,\n DateTimeFieldType,\n FileFieldType,\n FileUrlFieldType,\n ObjectFieldType,\n LexicalFieldType,\n PasswordFieldType,\n PermissionsFieldType,\n RolesMultiSelectFieldType\n} from \"./fieldTypes/index.js\";\n\nexport const FormModelFeature = createFeature({\n name: \"FormModel\",\n register(container) {\n container.register(TextFieldType);\n container.register(NumberFieldType);\n container.register(BooleanFieldType);\n container.register(DateTimeFieldType);\n container.register(FileFieldType);\n container.register(FileUrlFieldType);\n container.register(ObjectFieldType);\n container.register(LexicalFieldType);\n container.register(PasswordFieldType);\n container.register(PermissionsFieldType);\n container.register(RolesMultiSelectFieldType);\n\n container.register(FieldBuilderRegistry).inSingletonScope();\n container.register(ConditionRuleEvaluator).inSingletonScope();\n container.register(FormModelFactory).inSingletonScope();\n },\n resolve(container) {\n return {\n formModelFactory: container.resolve(Abstraction)\n };\n }\n});\n"],"names":["FormModelFeature","createFeature","container","TextFieldType","NumberFieldType","BooleanFieldType","DateTimeFieldType","FileFieldType","FileUrlFieldType","ObjectFieldType","LexicalFieldType","PasswordFieldType","PermissionsFieldType","RolesMultiSelectFieldType","FieldBuilderRegistry","ConditionRuleEvaluator","FormModelFactory","Abstraction"],"mappings":";;;;;;AAmBO,MAAMA,mBAAmBC,cAAc;IAC1C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QACnBD,UAAU,QAAQ,CAACE;QACnBF,UAAU,QAAQ,CAACG;QACnBH,UAAU,QAAQ,CAACI;QACnBJ,UAAU,QAAQ,CAACK;QACnBL,UAAU,QAAQ,CAACM;QACnBN,UAAU,QAAQ,CAACO;QACnBP,UAAU,QAAQ,CAACQ;QACnBR,UAAU,QAAQ,CAACS;QACnBT,UAAU,QAAQ,CAACU;QACnBV,UAAU,QAAQ,CAACW;QAEnBX,UAAU,QAAQ,CAACY,sBAAsB,gBAAgB;QACzDZ,UAAU,QAAQ,CAACa,wBAAwB,gBAAgB;QAC3Db,UAAU,QAAQ,CAACc,+CAAkB,gBAAgB;IACzD;IACA,SAAQd,SAAS;QACb,OAAO;YACH,kBAAkBA,UAAU,OAAO,CAACe;QACxC;IACJ;AACJ"}

package/features/formModel/fieldTypes/ObjectFieldType.js CHANGED Viewed

@@ -25,6 +25,7 @@ function createTemplateBuilder() {
         _build (id, registry) {
             const childBuilders = fieldsFactory ? fieldsFactory(registry) : {};
             if ("_templateId" in childBuilders) throw new Error(`Template "${id}" defines a reserved field "_templateId". The discriminator is added automatically.`);
+            for (const [fieldName, builder] of Object.entries(childBuilders))if (builder) builder.build(fieldName);
             return {
                 id,
                 label,
@@ -67,10 +68,10 @@ class ObjectFieldBuilder extends FieldBuilder {
         return this;
     }
     build(name) {
+        this._config.name = name;
         if (this._templates && Object.keys(this._childBuilders).length > 0) throw new Error(`Object field "${name}" has both .fields() and .template() defined. Templates are mutually exclusive with .fields(); each template defines its own children.`);
         return {
             ...this._config,
-            name,
             childBuilders: this._childBuilders,
             isList: this._isList,
             listSchema: this._listSchema,