@webiny/app-admin 0.0.0-unstable.6f45466a1d → 0.0.0-unstable.7be00a75a9

package/features/formModel/Field.js

@@ -0,0 +1,347 @@
+import { computed, makeAutoObservable, runInAction } from "mobx";
+class Field {
+    constructor(config){
+        this._validation = {
+            isValid: null
+        };
+        this._beforeChangeCallbacks = [];
+        this._afterChangeCallbacks = [];
+        this._afterSetValueCallbacks = [];
+        this._onBlurCallbacks = [];
+        this._requiredWhenCallbacks = [];
+        this._hiddenWhenCallbacks = [];
+        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._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.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._form);
+        if (this._computedUntilDirty && !this._computedOverridden && this._form) return this._computedUntilDirty(this._form);
+        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._form);
+        if (transformed === this._value) return;
+        const wasComputed = this._computedUntilDirty && !this._computedOverridden && this._form;
+        const computedValue = wasComputed ? this._computedUntilDirty(this._form) : 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._form);
+        if (!this._isUIChange) for (const cb of this._afterSetValueCallbacks)cb(transformed, this._form);
+    }
+    setValueSilent(value) {
+        const parsed = this.config.normalizeValue ? this._applyNormalizeValue(value, this.config.normalizeValue) : value;
+        this._value = parsed;
+        if (this._computedUntilDirty) this._computedOverridden = null != parsed;
+    }
+    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
+        };
+        return this._form.evaluateRules(all);
+    }
+    get visible() {
+        if (this._hidden) return false;
+        if (this._form && this._hiddenWhenCallbacks.length > 0) {
+            for (const cb of this._hiddenWhenCallbacks)if (cb(this._form)) return false;
+        }
+        return this._evaluateRules().visible;
+    }
+    get disabled() {
+        if (this._disabled) 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) {
+            for (const cb of this._requiredWhenCallbacks)if (cb.fn(this._form)) return {
+                required: true,
+                message: cb.message
+            };
+        }
+        return {
+            required: false
+        };
+    }
+    blur() {
+        for (const cb of this._onBlurCallbacks)cb(this._value, this._form);
+    }
+    setForm(form, parentPath) {
+        this._form = form;
+        this._qualifiedName = parentPath ? `${parentPath}.${this.config.name}` : this.config.name;
+    }
+    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._validation,
+            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()
+        };
+    }
+    _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._form);
+        return this.config.options;
+    }
+    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    ComputedFieldCallback\n} from \"./abstractions.js\";\n\n/**\n * Runtime observable field. Holds value, validation state, and exposes a VM for renderers.\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 _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 _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.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._form) as T;\n        }\n        if (this._computedUntilDirty && !this._computedOverridden && this._form) {\n            return this._computedUntilDirty(this._form) 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._form!);\n        }\n\n        if (transformed === this._value) {\n            return;\n        }\n\n        const wasComputed = this._computedUntilDirty && !this._computedOverridden && this._form;\n        const computedValue = wasComputed ? this._computedUntilDirty!(this._form!) : 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._form!);\n        }\n\n        if (!this._isUIChange) {\n            for (const cb of this._afterSetValueCallbacks) {\n                cb(transformed, this._form!);\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            this._computedOverridden = parsed !== null && parsed !== undefined;\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        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            for (const cb of this._hiddenWhenCallbacks) {\n                if (cb(this._form)) {\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        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: (form: IFormModel) => 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            for (const cb of this._requiredWhenCallbacks) {\n                if (cb.fn(this._form)) {\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._form!);\n        }\n    }\n\n    setForm(form: IFormModel, parentPath?: string): void {\n        this._form = form;\n        this._qualifiedName = parentPath ? `${parentPath}.${this.config.name}` : this.config.name;\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._validation,\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        };\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._form!);\n        }\n        return this.config.options;\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":["Field","config","undefined","defaultValue","makeAutoObservable","computed","raw","transformed","cb","wasComputed","computedValue","value","parsed","own","all","rules","runInAction","validation","fn","message","form","parentPath","Error","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,44 @@
+import type { z } from "zod";
+import type { IFieldConfig, IValueOption, IFormModel, IFieldBuilder, IFieldBuilderRegistry, IFieldTypeFactory, IRule, BeforeChangeCallback, AfterChangeCallback, AfterSetValueCallback, ComputedFieldCallback, HiddenWhenCallback, OnBlurCallback, CloneValueCallback } 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;
+    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;
+    required(message?: string): this;
+    requiredWhen(fn: (form: IFormModel) => 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;
+    getTags(): string[];
+    tags(tags: string[]): this;
+    options(opts: IValueOption[] | ((form: IFormModel) => 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;

package/features/formModel/FieldBuilder.js

@@ -0,0 +1,152 @@
+class FieldBuilder {
+    constructor(type){
+        this._config = {
+            name: "",
+            type,
+            hidden: false,
+            required: false,
+            disabled: false
+        };
+    }
+    get fieldType() {
+        return this._config.type;
+    }
+    label(text) {
+        this._config.label = text;
+        return this;
+    }
+    help(text) {
+        this._config.help = text;
+        return this;
+    }
+    description(text) {
+        this._config.description = text;
+        return this;
+    }
+    note(text) {
+        this._config.note = text;
+        return this;
+    }
+    placeholder(text) {
+        this._config.placeholder = text;
+        return this;
+    }
+    schema(zodSchema) {
+        this._config.schema = zodSchema;
+        return this;
+    }
+    defaultValue(value) {
+        this._config.defaultValue = value;
+        return this;
+    }
+    renderer(name, settings) {
+        this._config.renderer = name;
+        this._config.rendererSettings = settings;
+        return this;
+    }
+    list() {
+        this._config.isList = true;
+        return this;
+    }
+    hidden() {
+        this._config.hidden = true;
+        return this;
+    }
+    hiddenWhen(fn) {
+        if (!this._config.hiddenWhenCallbacks) this._config.hiddenWhenCallbacks = [];
+        this._config.hiddenWhenCallbacks.push(fn);
+        return this;
+    }
+    required(message) {
+        this._config.required = true;
+        this._config.requiredMessage = message;
+        return this;
+    }
+    requiredWhen(fn, message) {
+        if (!this._config.requiredWhenCallbacks) this._config.requiredWhenCallbacks = [];
+        this._config.requiredWhenCallbacks.push({
+            fn,
+            message
+        });
+        return this;
+    }
+    computed(fn) {
+        this._config.computed = fn;
+        this._config.computedUntilDirty = void 0;
+        return this;
+    }
+    computedUntilDirty(fn) {
+        this._config.computedUntilDirty = fn;
+        this._config.computed = void 0;
+        return this;
+    }
+    disabled(value = true) {
+        this._config.disabled = value;
+        return this;
+    }
+    rules(rules) {
+        if (!this._config.rules) this._config.rules = [];
+        this._config.rules.push(...rules);
+        return this;
+    }
+    beforeChange(fn) {
+        if (!this._config.beforeChangeCallbacks) this._config.beforeChangeCallbacks = [];
+        this._config.beforeChangeCallbacks.push(fn);
+        return this;
+    }
+    afterChange(fn) {
+        if (!this._config.afterChangeCallbacks) this._config.afterChangeCallbacks = [];
+        this._config.afterChangeCallbacks.push(fn);
+        return this;
+    }
+    afterSetValue(fn) {
+        if (!this._config.afterSetValueCallbacks) this._config.afterSetValueCallbacks = [];
+        this._config.afterSetValueCallbacks.push(fn);
+        return this;
+    }
+    onBlur(fn) {
+        if (!this._config.onBlurCallbacks) this._config.onBlurCallbacks = [];
+        this._config.onBlurCallbacks.push(fn);
+        return this;
+    }
+    cloneValue(fn) {
+        this._config.cloneValue = fn;
+        return this;
+    }
+    getTags() {
+        return this._config.tags ?? [];
+    }
+    tags(tags) {
+        this._config.tags = tags;
+        return this;
+    }
+    options(opts) {
+        this._config.options = opts;
+        if ("textInput" === this._config.renderer || "numberInput" === this._config.renderer) this._config.renderer = "dropdown";
+        return this;
+    }
+    normalizeValue(value) {
+        return value;
+    }
+    build(name) {
+        return {
+            ...this._config,
+            name,
+            normalizeValue: (v)=>this.normalizeValue(v)
+        };
+    }
+}
+function createFieldBuilderRegistry(factories) {
+    const fieldTypes = new Map();
+    for (const factory of factories)fieldTypes.set(factory.type, factory);
+    const proxy = new Proxy({}, {
+        get (_target, prop) {
+            const factory = fieldTypes.get(prop);
+            if (factory) return ()=>factory.create(proxy);
+        }
+    });
+    return proxy;
+}
+export { FieldBuilder, createFieldBuilderRegistry };
+
+//# sourceMappingURL=FieldBuilder.js.map

package/features/formModel/FieldBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/formModel/FieldBuilder.js","sources":["../../../src/features/formModel/FieldBuilder.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport type {\n    IFieldConfig,\n    IValueOption,\n    IFormModel,\n    IFieldBuilder,\n    IFieldBuilderRegistry,\n    IFieldTypeFactory,\n    IRule,\n    BeforeChangeCallback,\n    AfterChangeCallback,\n    AfterSetValueCallback,\n    ComputedFieldCallback,\n    HiddenWhenCallback,\n    OnBlurCallback,\n    CloneValueCallback\n} from \"./abstractions.js\";\n\n/**\n * Base FieldBuilder with fluent API.\n * Each method mutates `this` and returns `this` for chaining.\n */\nexport class FieldBuilder<TType extends string = string> implements IFieldBuilder {\n    protected _config: IFieldConfig;\n\n    constructor(type: TType) {\n        this._config = {\n            name: \"\",\n            type,\n            hidden: false,\n            required: false,\n            disabled: false\n        };\n    }\n\n    get fieldType(): string {\n        return this._config.type;\n    }\n\n    label(text: string): this {\n        this._config.label = text;\n        return this;\n    }\n\n    help(text: string): this {\n        this._config.help = text;\n        return this;\n    }\n\n    description(text: string): this {\n        this._config.description = text;\n        return this;\n    }\n\n    note(text: string): this {\n        this._config.note = text;\n        return this;\n    }\n\n    placeholder(text: string): this {\n        this._config.placeholder = text;\n        return this;\n    }\n\n    schema(zodSchema: z.ZodTypeAny): this {\n        this._config.schema = zodSchema;\n        return this;\n    }\n\n    defaultValue(value: unknown): this {\n        this._config.defaultValue = value;\n        return this;\n    }\n\n    renderer(name: string, settings?: Record<string, unknown>): this {\n        this._config.renderer = name;\n        this._config.rendererSettings = settings;\n        return this;\n    }\n\n    list(): this {\n        this._config.isList = true;\n        return this;\n    }\n\n    hidden(): this {\n        this._config.hidden = true;\n        return this;\n    }\n\n    hiddenWhen(fn: HiddenWhenCallback): this {\n        if (!this._config.hiddenWhenCallbacks) {\n            this._config.hiddenWhenCallbacks = [];\n        }\n        this._config.hiddenWhenCallbacks.push(fn);\n        return this;\n    }\n\n    required(message?: string): this {\n        this._config.required = true;\n        this._config.requiredMessage = message;\n        return this;\n    }\n\n    requiredWhen(fn: (form: IFormModel) => boolean, message?: string): this {\n        if (!this._config.requiredWhenCallbacks) {\n            this._config.requiredWhenCallbacks = [];\n        }\n        this._config.requiredWhenCallbacks.push({ fn, message });\n        return this;\n    }\n\n    computed(fn: ComputedFieldCallback): this {\n        this._config.computed = fn;\n        this._config.computedUntilDirty = undefined;\n        return this;\n    }\n\n    computedUntilDirty(fn: ComputedFieldCallback): this {\n        this._config.computedUntilDirty = fn;\n        this._config.computed = undefined;\n        return this;\n    }\n\n    disabled(value = true): this {\n        this._config.disabled = value;\n        return this;\n    }\n\n    rules(rules: IRule[]): this {\n        if (!this._config.rules) {\n            this._config.rules = [];\n        }\n        this._config.rules.push(...rules);\n        return this;\n    }\n\n    beforeChange(fn: BeforeChangeCallback): this {\n        if (!this._config.beforeChangeCallbacks) {\n            this._config.beforeChangeCallbacks = [];\n        }\n        this._config.beforeChangeCallbacks.push(fn);\n        return this;\n    }\n\n    afterChange(fn: AfterChangeCallback): this {\n        if (!this._config.afterChangeCallbacks) {\n            this._config.afterChangeCallbacks = [];\n        }\n        this._config.afterChangeCallbacks.push(fn);\n        return this;\n    }\n\n    afterSetValue(fn: AfterSetValueCallback): this {\n        if (!this._config.afterSetValueCallbacks) {\n            this._config.afterSetValueCallbacks = [];\n        }\n        this._config.afterSetValueCallbacks.push(fn);\n        return this;\n    }\n\n    onBlur(fn: OnBlurCallback): this {\n        if (!this._config.onBlurCallbacks) {\n            this._config.onBlurCallbacks = [];\n        }\n        this._config.onBlurCallbacks.push(fn);\n        return this;\n    }\n\n    cloneValue(fn: CloneValueCallback): this {\n        this._config.cloneValue = fn;\n        return this;\n    }\n\n    getTags(): string[] {\n        return this._config.tags ?? [];\n    }\n\n    tags(tags: string[]): this {\n        this._config.tags = tags;\n        return this;\n    }\n\n    options(opts: IValueOption[] | ((form: IFormModel) => IValueOption[])): this {\n        this._config.options = opts;\n        if (this._config.renderer === \"textInput\" || this._config.renderer === \"numberInput\") {\n            this._config.renderer = \"dropdown\";\n        }\n        return this;\n    }\n\n    /**\n     * Normalize value before it's set. If field value is an array, this method runs on each individual value in the array.\n     * Useful for converting strings to numbers, ensuring specific date format, etc.\n     * @param value\n     */\n    normalizeValue(value: unknown): unknown {\n        return value;\n    }\n\n    build(name: string): IFieldConfig {\n        return { ...this._config, name, normalizeValue: (v: unknown) => this.normalizeValue(v) };\n    }\n}\n\nexport function createFieldBuilderRegistry(factories: IFieldTypeFactory[]): IFieldBuilderRegistry {\n    const fieldTypes = new Map<string, IFieldTypeFactory>();\n    for (const factory of factories) {\n        fieldTypes.set(factory.type, factory);\n    }\n\n    const proxy: IFieldBuilderRegistry = new Proxy({} as IFieldBuilderRegistry, {\n        get(_target, prop: string) {\n            const factory = fieldTypes.get(prop);\n            if (factory) {\n                return () => factory.create(proxy);\n            }\n            return undefined;\n        }\n    });\n    return proxy;\n}\n"],"names":["FieldBuilder","type","text","zodSchema","value","name","settings","fn","message","undefined","rules","tags","opts","v","createFieldBuilderRegistry","factories","fieldTypes","Map","factory","proxy","Proxy","_target","prop"],"mappings":"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"}

package/features/formModel/FieldBuilder.test.d.ts

@@ -0,0 +1 @@
+export {};