@webiny/app-admin 0.0.0-unstable.b14eaecf38 → 0.0.0-unstable.b6d7105cee

package/features/formModel/Field.js

@@ -0,0 +1,414 @@
+import { computed, makeAutoObservable, runInAction } from "mobx";
+class FieldScope {
+    constructor(_form, _path){
+        this._form = _form;
+        this._path = _path;
+    }
+    field(name) {
+        const path = this._path ? `${this._path}.${name}` : name;
+        return this._form.field(path);
+    }
+    parent() {
+        if (!this._path) throw new Error("Cannot navigate above root level.");
+        const segments = this._path.split(".");
+        segments.pop();
+        return new FieldScope(this._form, segments.join("."));
+    }
+}
+class FieldNavigator {
+    constructor(_form, _qualifiedName){
+        this._form = _form;
+        this._qualifiedName = _qualifiedName;
+    }
+    parent() {
+        const segments = this._qualifiedName.split(".");
+        segments.pop();
+        return new FieldScope(this._form, segments.join("."));
+    }
+}
+class Field {
+    constructor(config){
+        this._validation = {
+            isValid: null
+        };
+        this._beforeChangeCallbacks = [];
+        this._afterChangeCallbacks = [];
+        this._afterSetValueCallbacks = [];
+        this._onBlurCallbacks = [];
+        this._requiredWhenCallbacks = [];
+        this._hiddenWhenCallbacks = [];
+        this._disabledWhenCallbacks = [];
+        this._computed = null;
+        this._computedUntilDirty = null;
+        this._computedOverridden = false;
+        this._validating = false;
+        this._validationCacheKey = void 0;
+        this._validationCache = void 0;
+        this._isUIChange = false;
+        this._focusRequested = false;
+        this._qualifiedName = "";
+        this._parentPath = "";
+        this._form = null;
+        this._ancestorRules = [];
+        this.config = config;
+        this._qualifiedName = config.name;
+        const defaultValue = "function" == typeof config.defaultValue ? config.defaultValue() : config.defaultValue;
+        this._value = defaultValue ?? (config.isList ? [] : null);
+        this._disabled = config.disabled;
+        this._hidden = config.hidden;
+        if (config.beforeChangeCallbacks) this._beforeChangeCallbacks = [
+            ...config.beforeChangeCallbacks
+        ];
+        if (config.afterChangeCallbacks) this._afterChangeCallbacks = [
+            ...config.afterChangeCallbacks
+        ];
+        if (config.afterSetValueCallbacks) this._afterSetValueCallbacks = [
+            ...config.afterSetValueCallbacks
+        ];
+        if (config.onBlurCallbacks) this._onBlurCallbacks = [
+            ...config.onBlurCallbacks
+        ];
+        if (config.requiredWhenCallbacks) this._requiredWhenCallbacks = [
+            ...config.requiredWhenCallbacks
+        ];
+        if (config.hiddenWhenCallbacks) this._hiddenWhenCallbacks = [
+            ...config.hiddenWhenCallbacks
+        ];
+        if (config.disabledWhenCallbacks) this._disabledWhenCallbacks = [
+            ...config.disabledWhenCallbacks
+        ];
+        if (config.computed) this._computed = config.computed;
+        else if (config.computedUntilDirty) this._computedUntilDirty = config.computedUntilDirty;
+        makeAutoObservable(this, {
+            config: false,
+            vm: computed
+        });
+    }
+    get name() {
+        return this.config.name;
+    }
+    get type() {
+        return this.config.type;
+    }
+    getValue() {
+        if (this._computed && this._form) return this._computed(this._callbackParams());
+        if (this._computedUntilDirty && !this._computedOverridden && this._form) return this._computedUntilDirty(this._callbackParams());
+        return this._value;
+    }
+    setValue(raw) {
+        let transformed = this.config.normalizeValue ? this._applyNormalizeValue(raw, this.config.normalizeValue) : raw;
+        for (const cb of this._beforeChangeCallbacks)transformed = cb(transformed, this._callbackParams());
+        if (transformed === this._value) return;
+        const wasComputed = this._computedUntilDirty && !this._computedOverridden && this._form;
+        const computedValue = wasComputed ? this._computedUntilDirty(this._callbackParams()) : void 0;
+        this._value = transformed;
+        if (this._computedUntilDirty && this._isUIChange) {
+            if (!wasComputed || transformed !== computedValue) this._computedOverridden = true;
+        }
+        for (const cb of this._afterChangeCallbacks)cb(transformed, this._callbackParams());
+        if (!this._isUIChange) for (const cb of this._afterSetValueCallbacks)cb(transformed, this._callbackParams());
+    }
+    setValueSilent(value) {
+        const parsed = this.config.normalizeValue ? this._applyNormalizeValue(value, this.config.normalizeValue) : value;
+        this._value = parsed;
+        if (this._computedUntilDirty) if (null == parsed) this._computedOverridden = false;
+        else if (this._form) {
+            const computedValue = this._computedUntilDirty(this._callbackParams());
+            this._computedOverridden = parsed !== computedValue;
+        } else this._computedOverridden = true;
+    }
+    setDisabled(value) {
+        this._disabled = value;
+    }
+    _evaluateRules() {
+        if (!this._form) return {
+            visible: true,
+            disabled: false
+        };
+        const own = this.config.rules ?? [];
+        const all = [
+            ...this._ancestorRules,
+            ...own
+        ];
+        if (0 === all.length) return {
+            visible: true,
+            disabled: false
+        };
+        if (this._parentPath) {
+            const resolved = all.map((rule)=>{
+                if (rule.target.startsWith("$.")) return {
+                    ...rule,
+                    target: `${this._parentPath}.${rule.target.slice(2)}`
+                };
+                return rule;
+            });
+            return this._form.evaluateRules(resolved);
+        }
+        return this._form.evaluateRules(all);
+    }
+    get visible() {
+        if (this._hidden) return false;
+        if (this._form && this._hiddenWhenCallbacks.length > 0) {
+            const scoped = this._callbackParams();
+            for (const cb of this._hiddenWhenCallbacks)if (cb(scoped)) return false;
+        }
+        return this._evaluateRules().visible;
+    }
+    get disabled() {
+        if (this._disabled) return true;
+        if (this._form && this._disabledWhenCallbacks.length > 0) {
+            const scoped = this._callbackParams();
+            for (const cb of this._disabledWhenCallbacks)if (cb(scoped)) return true;
+        }
+        return this._evaluateRules().disabled;
+    }
+    setVisible(value) {
+        this._hidden = !value;
+    }
+    setAncestorRules(rules) {
+        runInAction(()=>{
+            this._ancestorRules = rules;
+        });
+    }
+    setValidation(validation) {
+        this._validation = validation;
+    }
+    resetValidation() {
+        this._validation = {
+            isValid: null
+        };
+        this._validationCacheKey = void 0;
+        this._validationCache = void 0;
+    }
+    addBeforeChange(cb) {
+        this._beforeChangeCallbacks.push(cb);
+    }
+    addAfterChange(cb) {
+        this._afterChangeCallbacks.push(cb);
+    }
+    addAfterSetValue(cb) {
+        this._afterSetValueCallbacks.push(cb);
+    }
+    addOnBlur(cb) {
+        this._onBlurCallbacks.push(cb);
+    }
+    addRequiredWhen(fn, message) {
+        this._requiredWhenCallbacks.push({
+            fn,
+            message
+        });
+    }
+    setComputed(fn) {
+        this._computed = fn;
+        this._computedUntilDirty = null;
+        this._computedOverridden = false;
+    }
+    setComputedUntilDirty(fn) {
+        this._computedUntilDirty = fn;
+        this._computed = null;
+        this._computedOverridden = false;
+    }
+    resolveRequired() {
+        return this._resolveRequired();
+    }
+    _resolveRequired() {
+        if (this.config.required) return {
+            required: true,
+            message: this.config.requiredMessage
+        };
+        if (this._form && this._requiredWhenCallbacks.length > 0) {
+            const scoped = this._callbackParams();
+            for (const cb of this._requiredWhenCallbacks)if (cb.fn(scoped)) return {
+                required: true,
+                message: cb.message
+            };
+        }
+        return {
+            required: false
+        };
+    }
+    blur() {
+        for (const cb of this._onBlurCallbacks)cb(this._value, this._callbackParams());
+    }
+    setForm(form, parentPath) {
+        this._form = form;
+        this._parentPath = parentPath || "";
+        this._qualifiedName = parentPath ? `${parentPath}.${this.config.name}` : this.config.name;
+    }
+    _callbackParams() {
+        if (!this._form) throw new Error("Field not attached to a form.");
+        return {
+            field: new FieldNavigator(this._form, this._qualifiedName),
+            form: this._form
+        };
+    }
+    get qualifiedName() {
+        return this._qualifiedName;
+    }
+    focus() {
+        if (!this._form) throw new Error(`Field "${this.config.name}" is not attached to a form.`);
+        this._form.focusField(this._qualifiedName);
+    }
+    requestFocus() {
+        this._focusRequested = true;
+    }
+    clearFocusRequest() {
+        this._focusRequested = false;
+    }
+    as(type) {
+        if (this.config.type !== type) throw new Error(`Field "${this.config.name}" is type "${this.config.type}", not "${type}".`);
+        return this;
+    }
+    remove() {
+        if (!this._form) throw new Error(`Field "${this.config.name}" is not attached to a form.`);
+        this._form.removeField(this.config.name);
+    }
+    get vm() {
+        const options = this._resolveOptions();
+        const required = this._resolveRequired().required;
+        return {
+            name: this.config.name,
+            type: this.config.type,
+            label: this.config.label,
+            help: this.config.help,
+            description: this.config.description,
+            note: this.config.note,
+            placeholder: this.config.placeholder,
+            value: this.getValue(),
+            validation: this.visible ? this._validation : {
+                isValid: null
+            },
+            validating: this._validating,
+            required,
+            visible: this.visible,
+            disabled: this.disabled,
+            renderer: this.config.renderer,
+            rendererSettings: this.config.rendererSettings,
+            isList: !!this.config.isList,
+            options,
+            onChange: (value)=>this._setValueFromUI(value),
+            onBlur: ()=>{
+                if (this._form?.submitted) this.validate();
+                this.blur();
+            },
+            addItem: (value)=>this._addItem(value),
+            removeItem: (index)=>this._removeItem(index),
+            focusRequested: this._focusRequested,
+            clearFocusRequest: ()=>this.clearFocusRequest(),
+            context: this._resolveContext()
+        };
+    }
+    _setValueFromUI(value) {
+        this._isUIChange = true;
+        try {
+            this.setValue(value);
+        } finally{
+            this._isUIChange = false;
+        }
+    }
+    _applyNormalizeValue(value, normalizeValue) {
+        if (this.config.isList && Array.isArray(value)) return value.map((item)=>normalizeValue(item));
+        return normalizeValue(value);
+    }
+    _addItem(value) {
+        const current = Array.isArray(this._value) ? this._value : [];
+        this._setValueFromUI([
+            ...current,
+            value ?? null
+        ]);
+    }
+    _removeItem(index) {
+        const current = Array.isArray(this._value) ? this._value : [];
+        this._setValueFromUI(current.filter((_, i)=>i !== index));
+    }
+    _resolveOptions() {
+        if (!this.config.options) return;
+        if ("function" == typeof this.config.options) return this.config.options(this._callbackParams());
+        return this.config.options;
+    }
+    _resolveContext() {
+        if (!this.config.context || !this._form) return {};
+        return this.config.context(this._callbackParams());
+    }
+    async validate(options) {
+        if (!this.visible) {
+            runInAction(()=>{
+                this._validation = {
+                    isValid: null
+                };
+            });
+            return true;
+        }
+        const effectiveValue = this.getValue();
+        if (!options?.force && void 0 !== this._validationCache) {
+            const cacheKey = this._serializeValue(effectiveValue);
+            if (this._validationCacheKey === cacheKey) return this._validationCache;
+        }
+        runInAction(()=>{
+            this._validating = true;
+        });
+        try {
+            const requiredState = this._resolveRequired();
+            if (requiredState.required) {
+                const isEmpty = null == effectiveValue || "" === effectiveValue || this.config.isList && Array.isArray(effectiveValue) && 0 === effectiveValue.length;
+                if (isEmpty) {
+                    const cacheKey = this._serializeValue(effectiveValue);
+                    runInAction(()=>{
+                        this._validation = {
+                            isValid: false,
+                            message: requiredState.message || "This field is required."
+                        };
+                        this._validationCacheKey = cacheKey;
+                        this._validationCache = false;
+                    });
+                    return false;
+                }
+            }
+            if (this.config.schema) {
+                const result = await this.config.schema.safeParseAsync(effectiveValue);
+                if (!result.success) {
+                    const firstIssue = result.error.issues[0];
+                    const cacheKey = this._serializeValue(effectiveValue);
+                    runInAction(()=>{
+                        this._validation = {
+                            isValid: false,
+                            message: firstIssue?.message || "Invalid value."
+                        };
+                        this._validationCacheKey = cacheKey;
+                        this._validationCache = false;
+                    });
+                    return false;
+                }
+            }
+            const cacheKey = this._serializeValue(effectiveValue);
+            runInAction(()=>{
+                this._validation = {
+                    isValid: true
+                };
+                this._validationCacheKey = cacheKey;
+                this._validationCache = true;
+            });
+            return true;
+        } finally{
+            runInAction(()=>{
+                this._validating = false;
+            });
+        }
+    }
+    _serializeValue(value) {
+        try {
+            return JSON.stringify(value);
+        } catch  {
+            return String(Math.random());
+        }
+    }
+    get isComputed() {
+        return null !== this._computed || null !== this._computedUntilDirty;
+    }
+    get isComputedOverridden() {
+        return this._computedOverridden;
+    }
+}
+export { Field };
+
+//# sourceMappingURL=Field.js.map

package/features/formModel/Field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/formModel/Field.js","sources":["../../../src/features/formModel/Field.ts"],"sourcesContent":["import { makeAutoObservable, computed, runInAction } from \"mobx\";\nimport type {\n    IFieldConfig,\n    IFieldVM,\n    IFieldValidation,\n    IValueOption,\n    IFormModel,\n    IField,\n    IRule,\n    FieldTypeMap,\n    BeforeChangeCallback,\n    AfterChangeCallback,\n    AfterSetValueCallback,\n    OnBlurCallback,\n    RequiredWhenCallback,\n    HiddenWhenCallback,\n    DisabledWhenCallback,\n    ComputedFieldCallback,\n    IFieldCallbackParams,\n    IFieldNavigator,\n    IFieldScope\n} from \"./abstractions.js\";\n\n/**\n * Runtime observable field. Holds value, validation state, and exposes a VM for renderers.\n */\nclass FieldScope implements IFieldScope {\n    constructor(\n        private _form: IFormModel,\n        private _path: string\n    ) {}\n\n    field(name: string): IField {\n        const path = this._path ? `${this._path}.${name}` : name;\n        return this._form.field(path);\n    }\n\n    parent(): IFieldScope {\n        if (!this._path) {\n            throw new Error(\"Cannot navigate above root level.\");\n        }\n        const segments = this._path.split(\".\");\n        segments.pop();\n        return new FieldScope(this._form, segments.join(\".\"));\n    }\n}\n\nclass FieldNavigator implements IFieldNavigator {\n    constructor(\n        private _form: IFormModel,\n        private _qualifiedName: string\n    ) {}\n\n    parent(): IFieldScope {\n        const segments = this._qualifiedName.split(\".\");\n        segments.pop();\n        return new FieldScope(this._form, segments.join(\".\"));\n    }\n}\n\nexport class Field implements IField {\n    private _value: unknown;\n    private _validation: IFieldValidation = { isValid: null };\n    private _disabled: boolean;\n    private _hidden: boolean;\n    private _beforeChangeCallbacks: BeforeChangeCallback[] = [];\n    private _afterChangeCallbacks: AfterChangeCallback[] = [];\n    private _afterSetValueCallbacks: AfterSetValueCallback[] = [];\n    private _onBlurCallbacks: OnBlurCallback[] = [];\n    private _requiredWhenCallbacks: RequiredWhenCallback[] = [];\n    private _hiddenWhenCallbacks: HiddenWhenCallback[] = [];\n    private _disabledWhenCallbacks: DisabledWhenCallback[] = [];\n    private _computed: ComputedFieldCallback | null = null;\n    private _computedUntilDirty: ComputedFieldCallback | null = null;\n    /** Set once a computedUntilDirty field receives its first user edit. */\n    private _computedOverridden = false;\n    private _validating = false;\n    private _validationCacheKey: string | undefined = undefined;\n    private _validationCache: boolean | undefined = undefined;\n    private _isUIChange = false;\n    private _focusRequested = false;\n    private _qualifiedName: string = \"\";\n    private _parentPath: string = \"\";\n    private _form: IFormModel | null = null;\n    private _ancestorRules: IRule[] = [];\n\n    readonly config: IFieldConfig;\n\n    constructor(config: IFieldConfig) {\n        this.config = config;\n        this._qualifiedName = config.name;\n        const defaultValue =\n            typeof config.defaultValue === \"function\"\n                ? (config.defaultValue as () => unknown)()\n                : config.defaultValue;\n        this._value = defaultValue ?? (config.isList ? [] : null);\n        this._disabled = config.disabled;\n        this._hidden = config.hidden;\n\n        if (config.beforeChangeCallbacks) {\n            this._beforeChangeCallbacks = [...config.beforeChangeCallbacks];\n        }\n        if (config.afterChangeCallbacks) {\n            this._afterChangeCallbacks = [...config.afterChangeCallbacks];\n        }\n        if (config.afterSetValueCallbacks) {\n            this._afterSetValueCallbacks = [...config.afterSetValueCallbacks];\n        }\n        if (config.onBlurCallbacks) {\n            this._onBlurCallbacks = [...config.onBlurCallbacks];\n        }\n        if (config.requiredWhenCallbacks) {\n            this._requiredWhenCallbacks = [...config.requiredWhenCallbacks];\n        }\n        if (config.hiddenWhenCallbacks) {\n            this._hiddenWhenCallbacks = [...config.hiddenWhenCallbacks];\n        }\n        if (config.disabledWhenCallbacks) {\n            this._disabledWhenCallbacks = [...config.disabledWhenCallbacks];\n        }\n        if (config.computed) {\n            this._computed = config.computed;\n        } else if (config.computedUntilDirty) {\n            this._computedUntilDirty = config.computedUntilDirty;\n        }\n\n        makeAutoObservable(this, {\n            config: false,\n            vm: computed\n        });\n    }\n\n    get name(): string {\n        return this.config.name;\n    }\n\n    get type(): string {\n        return this.config.type;\n    }\n\n    getValue<T = unknown>(): T {\n        if (this._computed && this._form) {\n            return this._computed(this._callbackParams()) as T;\n        }\n        if (this._computedUntilDirty && !this._computedOverridden && this._form) {\n            return this._computedUntilDirty(this._callbackParams()) as T;\n        }\n        return this._value as T;\n    }\n\n    /**\n     * Set value with beforeChange/afterChange pipeline.\n     * beforeChange always runs (pure transform).\n     * afterChange only fires when value actually changed.\n     */\n    setValue(raw: unknown): void {\n        let transformed = this.config.normalizeValue\n            ? this._applyNormalizeValue(raw, this.config.normalizeValue)\n            : raw;\n        for (const cb of this._beforeChangeCallbacks) {\n            transformed = cb(transformed, this._callbackParams());\n        }\n\n        if (transformed === this._value) {\n            return;\n        }\n\n        const wasComputed = this._computedUntilDirty && !this._computedOverridden && this._form;\n        const computedValue = wasComputed\n            ? this._computedUntilDirty!(this._callbackParams())\n            : undefined;\n\n        this._value = transformed;\n        if (this._computedUntilDirty && this._isUIChange) {\n            if (!wasComputed || transformed !== computedValue) {\n                this._computedOverridden = true;\n            }\n        }\n\n        for (const cb of this._afterChangeCallbacks) {\n            cb(transformed, this._callbackParams());\n        }\n\n        if (!this._isUIChange) {\n            for (const cb of this._afterSetValueCallbacks) {\n                cb(transformed, this._callbackParams());\n            }\n        }\n    }\n\n    /**\n     * Set value directly without running pipelines. Used by setData() and reset().\n     */\n    setValueSilent(value: unknown): void {\n        const parsed = this.config.normalizeValue\n            ? this._applyNormalizeValue(value, this.config.normalizeValue)\n            : value;\n        this._value = parsed;\n        if (this._computedUntilDirty) {\n            if (parsed === null || parsed === undefined) {\n                this._computedOverridden = false;\n            } else if (this._form) {\n                const computedValue = this._computedUntilDirty(this._callbackParams());\n                this._computedOverridden = parsed !== computedValue;\n            } else {\n                this._computedOverridden = true;\n            }\n        }\n    }\n\n    setDisabled(value: boolean): void {\n        this._disabled = value;\n    }\n\n    private _evaluateRules(): { visible: boolean; disabled: boolean } {\n        if (!this._form) {\n            return { visible: true, disabled: false };\n        }\n        const own = this.config.rules ?? [];\n        const all = [...this._ancestorRules, ...own];\n        if (all.length === 0) {\n            return { visible: true, disabled: false };\n        }\n        if (this._parentPath) {\n            const resolved = all.map(rule => {\n                if (rule.target.startsWith(\"$.\")) {\n                    return { ...rule, target: `${this._parentPath}.${rule.target.slice(2)}` };\n                }\n                return rule;\n            });\n            return this._form.evaluateRules(resolved);\n        }\n        return this._form.evaluateRules(all);\n    }\n\n    get visible(): boolean {\n        if (this._hidden) {\n            return false;\n        }\n        if (this._form && this._hiddenWhenCallbacks.length > 0) {\n            const scoped = this._callbackParams();\n            for (const cb of this._hiddenWhenCallbacks) {\n                if (cb(scoped)) {\n                    return false;\n                }\n            }\n        }\n        return this._evaluateRules().visible;\n    }\n\n    get disabled(): boolean {\n        if (this._disabled) {\n            return true;\n        }\n        if (this._form && this._disabledWhenCallbacks.length > 0) {\n            const scoped = this._callbackParams();\n            for (const cb of this._disabledWhenCallbacks) {\n                if (cb(scoped)) {\n                    return true;\n                }\n            }\n        }\n        return this._evaluateRules().disabled;\n    }\n\n    setVisible(value: boolean): void {\n        this._hidden = !value;\n    }\n\n    setAncestorRules(rules: IRule[]): void {\n        runInAction(() => {\n            this._ancestorRules = rules;\n        });\n    }\n\n    setValidation(validation: IFieldValidation): void {\n        this._validation = validation;\n    }\n\n    resetValidation(): void {\n        this._validation = { isValid: null };\n        this._validationCacheKey = undefined;\n        this._validationCache = undefined;\n    }\n\n    addBeforeChange(cb: BeforeChangeCallback): void {\n        this._beforeChangeCallbacks.push(cb);\n    }\n\n    addAfterChange(cb: AfterChangeCallback): void {\n        this._afterChangeCallbacks.push(cb);\n    }\n\n    addAfterSetValue(cb: AfterSetValueCallback): void {\n        this._afterSetValueCallbacks.push(cb);\n    }\n\n    addOnBlur(cb: OnBlurCallback): void {\n        this._onBlurCallbacks.push(cb);\n    }\n\n    addRequiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): void {\n        this._requiredWhenCallbacks.push({ fn, message });\n    }\n\n    setComputed(fn: ComputedFieldCallback): void {\n        this._computed = fn;\n        this._computedUntilDirty = null;\n        this._computedOverridden = false;\n    }\n\n    setComputedUntilDirty(fn: ComputedFieldCallback): void {\n        this._computedUntilDirty = fn;\n        this._computed = null;\n        this._computedOverridden = false;\n    }\n\n    /**\n     * Effective `required` state — true if the built-in `.required()` flag is\n     * set, or if any `requiredWhen()` callback returns `true` for the current\n     * form state. The first truthy callback wins; its message is used.\n     */\n    resolveRequired(): { required: boolean; message?: string } {\n        return this._resolveRequired();\n    }\n\n    private _resolveRequired(): { required: boolean; message?: string } {\n        if (this.config.required) {\n            return { required: true, message: this.config.requiredMessage };\n        }\n        if (this._form && this._requiredWhenCallbacks.length > 0) {\n            const scoped = this._callbackParams();\n            for (const cb of this._requiredWhenCallbacks) {\n                if (cb.fn(scoped)) {\n                    return { required: true, message: cb.message };\n                }\n            }\n        }\n        return { required: false };\n    }\n\n    blur(): void {\n        for (const cb of this._onBlurCallbacks) {\n            cb(this._value, this._callbackParams());\n        }\n    }\n\n    setForm(form: IFormModel, parentPath?: string): void {\n        this._form = form;\n        this._parentPath = parentPath || \"\";\n        this._qualifiedName = parentPath ? `${parentPath}.${this.config.name}` : this.config.name;\n    }\n\n    private _callbackParams(): IFieldCallbackParams {\n        if (!this._form) {\n            throw new Error(\"Field not attached to a form.\");\n        }\n        return {\n            field: new FieldNavigator(this._form, this._qualifiedName),\n            form: this._form\n        };\n    }\n\n    get qualifiedName(): string {\n        return this._qualifiedName;\n    }\n\n    focus(): void {\n        if (!this._form) {\n            throw new Error(`Field \"${this.config.name}\" is not attached to a form.`);\n        }\n        this._form.focusField(this._qualifiedName);\n    }\n\n    requestFocus(): void {\n        this._focusRequested = true;\n    }\n\n    clearFocusRequest(): void {\n        this._focusRequested = false;\n    }\n\n    as<T extends keyof FieldTypeMap>(type: T): FieldTypeMap[T] {\n        if (this.config.type !== type) {\n            throw new Error(\n                `Field \"${this.config.name}\" is type \"${this.config.type}\", not \"${type}\".`\n            );\n        }\n        return this as unknown as FieldTypeMap[T];\n    }\n\n    remove(): void {\n        if (!this._form) {\n            throw new Error(`Field \"${this.config.name}\" is not attached to a form.`);\n        }\n        (this._form as any).removeField(this.config.name);\n    }\n\n    get vm(): IFieldVM {\n        const options = this._resolveOptions();\n        const required = this._resolveRequired().required;\n\n        return {\n            name: this.config.name,\n            type: this.config.type,\n            label: this.config.label,\n            help: this.config.help,\n            description: this.config.description,\n            note: this.config.note,\n            placeholder: this.config.placeholder,\n            value: this.getValue(),\n            validation: this.visible ? this._validation : { isValid: null },\n            validating: this._validating,\n            required,\n            visible: this.visible,\n            disabled: this.disabled,\n            renderer: this.config.renderer,\n            rendererSettings: this.config.rendererSettings,\n            isList: !!this.config.isList,\n            options,\n            onChange: (value: unknown) => this._setValueFromUI(value),\n            onBlur: () => {\n                if (this._form?.submitted) {\n                    void this.validate();\n                }\n                this.blur();\n            },\n            addItem: (value?: unknown) => this._addItem(value),\n            removeItem: (index: number) => this._removeItem(index),\n            focusRequested: this._focusRequested,\n            clearFocusRequest: () => this.clearFocusRequest(),\n            context: this._resolveContext()\n        };\n    }\n\n    private _setValueFromUI(value: unknown): void {\n        this._isUIChange = true;\n        try {\n            this.setValue(value);\n        } finally {\n            this._isUIChange = false;\n        }\n    }\n\n    private _applyNormalizeValue(value: unknown, normalizeValue: (v: unknown) => unknown): unknown {\n        if (this.config.isList && Array.isArray(value)) {\n            return value.map(item => normalizeValue(item));\n        }\n        return normalizeValue(value);\n    }\n\n    private _addItem(value?: unknown): void {\n        const current = Array.isArray(this._value) ? this._value : [];\n        this._setValueFromUI([...current, value ?? null]);\n    }\n\n    private _removeItem(index: number): void {\n        const current = Array.isArray(this._value) ? this._value : [];\n        this._setValueFromUI(current.filter((_: unknown, i: number) => i !== index));\n    }\n\n    private _resolveOptions(): IValueOption[] | undefined {\n        if (!this.config.options) {\n            return undefined;\n        }\n        if (typeof this.config.options === \"function\") {\n            return this.config.options(this._callbackParams());\n        }\n        return this.config.options;\n    }\n\n    private _resolveContext(): Record<string, unknown> {\n        if (!this.config.context || !this._form) {\n            return {};\n        }\n        return this.config.context(this._callbackParams());\n    }\n\n    /**\n     * Validate this field. Returns true if valid.\n     * Validation order: required check → zod schema.\n     * Hidden fields are excluded from validation.\n     *\n     * Pass `{ force: true }` to bypass the memoization cache (used by\n     * `form.validate()` / `form.submit()`). Blur-triggered validation\n     * omits the flag so unchanged values return the cached result.\n     */\n    async validate(options?: { force?: boolean }): Promise<boolean> {\n        if (!this.visible) {\n            runInAction(() => {\n                this._validation = { isValid: null };\n            });\n            return true;\n        }\n\n        const effectiveValue = this.getValue();\n\n        // Memoization: return cached result when value hasn't changed.\n        if (!options?.force && this._validationCache !== undefined) {\n            const cacheKey = this._serializeValue(effectiveValue);\n            if (this._validationCacheKey === cacheKey) {\n                return this._validationCache;\n            }\n        }\n\n        runInAction(() => {\n            this._validating = true;\n        });\n\n        try {\n            const requiredState = this._resolveRequired();\n\n            // Required check\n            if (requiredState.required) {\n                const isEmpty =\n                    effectiveValue === null ||\n                    effectiveValue === undefined ||\n                    effectiveValue === \"\" ||\n                    (this.config.isList &&\n                        Array.isArray(effectiveValue) &&\n                        effectiveValue.length === 0);\n\n                if (isEmpty) {\n                    const cacheKey = this._serializeValue(effectiveValue);\n                    runInAction(() => {\n                        this._validation = {\n                            isValid: false,\n                            message: requiredState.message || \"This field is required.\"\n                        };\n                        this._validationCacheKey = cacheKey;\n                        this._validationCache = false;\n                    });\n                    return false;\n                }\n            }\n\n            // Zod schema check\n            if (this.config.schema) {\n                const result = await this.config.schema.safeParseAsync(effectiveValue);\n                if (!result.success) {\n                    const firstIssue = result.error.issues[0];\n                    const cacheKey = this._serializeValue(effectiveValue);\n                    runInAction(() => {\n                        this._validation = {\n                            isValid: false,\n                            message: firstIssue?.message || \"Invalid value.\"\n                        };\n                        this._validationCacheKey = cacheKey;\n                        this._validationCache = false;\n                    });\n                    return false;\n                }\n            }\n\n            const cacheKey = this._serializeValue(effectiveValue);\n            runInAction(() => {\n                this._validation = { isValid: true };\n                this._validationCacheKey = cacheKey;\n                this._validationCache = true;\n            });\n            return true;\n        } finally {\n            runInAction(() => {\n                this._validating = false;\n            });\n        }\n    }\n\n    private _serializeValue(value: unknown): string {\n        try {\n            return JSON.stringify(value);\n        } catch {\n            return String(Math.random());\n        }\n    }\n\n    /** True if this field has any computed callback configured. */\n    get isComputed(): boolean {\n        return this._computed !== null || this._computedUntilDirty !== null;\n    }\n\n    /** True if a computedUntilDirty field has been overridden by user edit. */\n    get isComputedOverridden(): boolean {\n        return this._computedOverridden;\n    }\n}\n"],"names":["FieldScope","_form","_path","name","path","Error","segments","FieldNavigator","_qualifiedName","Field","config","undefined","defaultValue","makeAutoObservable","computed","raw","transformed","cb","wasComputed","computedValue","value","parsed","own","all","resolved","rule","scoped","rules","runInAction","validation","fn","message","form","parentPath","type","options","required","index","normalizeValue","Array","item","current","_","i","effectiveValue","cacheKey","requiredState","isEmpty","result","firstIssue","JSON","String","Math"],"mappings":"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"}

package/features/formModel/FieldBuilder.d.ts

@@ -0,0 +1,48 @@
+import type { z } from "zod";
+import type { IFieldConfig, IValueOption, IFieldCallbackParams, IFieldBuilder, IFieldBuilderRegistry, IFieldTypeFactory, IRule, BeforeChangeCallback, AfterChangeCallback, AfterSetValueCallback, ComputedFieldCallback, HiddenWhenCallback, DisabledWhenCallback, OnBlurCallback, CloneValueCallback, FieldContextCallback } from "./abstractions.js";
+/**
+ * Base FieldBuilder with fluent API.
+ * Each method mutates `this` and returns `this` for chaining.
+ */
+export declare class FieldBuilder<TType extends string = string> implements IFieldBuilder {
+    protected _config: IFieldConfig;
+    constructor(type: TType);
+    get fieldType(): string;
+    getName(): string;
+    getType(): string;
+    label(text: string): this;
+    help(text: string): this;
+    description(text: string): this;
+    note(text: string): this;
+    placeholder(text: string): this;
+    schema(zodSchema: z.ZodTypeAny): this;
+    defaultValue(value: unknown): this;
+    renderer(name: string, settings?: Record<string, unknown>): this;
+    list(): this;
+    hidden(): this;
+    hiddenWhen(fn: HiddenWhenCallback): this;
+    disabledWhen(fn: DisabledWhenCallback): this;
+    required(message?: string): this;
+    requiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): this;
+    computed(fn: ComputedFieldCallback): this;
+    computedUntilDirty(fn: ComputedFieldCallback): this;
+    disabled(value?: boolean): this;
+    rules(rules: IRule[]): this;
+    beforeChange(fn: BeforeChangeCallback): this;
+    afterChange(fn: AfterChangeCallback): this;
+    afterSetValue(fn: AfterSetValueCallback): this;
+    onBlur(fn: OnBlurCallback): this;
+    cloneValue(fn: CloneValueCallback): this;
+    context(fn: FieldContextCallback): this;
+    getTags(): string[];
+    tags(tags: string[]): this;
+    options(opts: IValueOption[] | ((params: IFieldCallbackParams) => IValueOption[])): this;
+    /**
+     * Normalize value before it's set. If field value is an array, this method runs on each individual value in the array.
+     * Useful for converting strings to numbers, ensuring specific date format, etc.
+     * @param value
+     */
+    normalizeValue(value: unknown): unknown;
+    build(name: string): IFieldConfig;
+}
+export declare function createFieldBuilderRegistry(factories: IFieldTypeFactory[]): IFieldBuilderRegistry;