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

package/features/formModel/Field.js.map

@@ -1 +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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"}
+{"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 _scopePath: () => string = () => this._parentPath;\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, \"_scopePath\">(this, {\n            config: false,\n            vm: computed,\n            _scopePath: false\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    /**\n     * `form.field()` throws for a path it can't resolve, which happens while a form is\n     * still being assembled. Ancestor lookups treat that as \"no parent\" rather than\n     * failing the render.\n     */\n    private _safeGetField(name: string): IField | undefined {\n        try {\n            return this._form?.field(name);\n        } catch {\n            return undefined;\n        }\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        const scopePath = this._scopePath();\n        if (scopePath) {\n            const resolved = all.map(rule => {\n                if (rule.target.startsWith(\"$.\")) {\n                    return { ...rule, target: `${scopePath}.${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        /**\n         * Disabling a container disables everything inside it, the way a disabled\n         * fieldset does in HTML. Without this, marking an object field disabled would\n         * grey out the container while leaving every child editable.\n         */\n        if (this._parentPath && this._form) {\n            const parent = this._safeGetField(this._parentPath);\n            if (parent?.disabled) {\n                return true;\n            }\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    setValidationWithCache(validation: IFieldValidation, value: unknown, result: boolean): void {\n        this._validation = validation;\n        this._validationCacheKey = this._serializeValue(value);\n        this._validationCache = result;\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, scopePath?: () => string): void {\n        this._form = form;\n        this._parentPath = parentPath || \"\";\n        this._scopePath = scopePath ?? (() => this._parentPath);\n        this._qualifiedName = parentPath ? `${parentPath}.${this.config.name}` : this.config.name;\n    }\n\n    /**\n     * A path `form.field()` resolves to exactly this field. Same as `qualifiedName`,\n     * except inside list items, where it carries the item index (`blocks.2.title`).\n     */\n    get scopedName(): string {\n        const scopePath = this._scopePath();\n        return scopePath ? `${scopePath}.${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.scopedName),\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            qualifiedName: this._qualifiedName,\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            autoFocus: this.config.autoFocus,\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            if (\n                !requiredState.required &&\n                (effectiveValue === null || effectiveValue === undefined)\n            ) {\n                const cacheKey = this._serializeValue(effectiveValue);\n                runInAction(() => {\n                    this._validation = { isValid: null };\n                    this._validationCacheKey = cacheKey;\n                    this._validationCache = true;\n                });\n                return true;\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","scopePath","resolved","rule","scoped","parent","rules","runInAction","validation","result","fn","message","form","parentPath","type","options","required","index","normalizeValue","Array","item","current","_","i","effectiveValue","cacheKey","requiredState","isEmpty","firstIssue","JSON","String","Math"],"mappings":"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"}

package/features/formModel/FieldBuilder.d.ts

@@ -1,5 +1,5 @@
 import type { z } from "zod";
-import type { IFieldConfig, IValueOption, IFormModel, IFieldBuilder, IFieldBuilderRegistry, IFieldTypeFactory, IRule, BeforeChangeCallback, AfterChangeCallback, AfterSetValueCallback, ComputedFieldCallback, HiddenWhenCallback, OnBlurCallback, CloneValueCallback } from "./abstractions.js";
+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.
@@ -8,19 +8,23 @@ export declare class FieldBuilder<TType extends string = string> implements IFie
     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;
+    autoFocus(value?: boolean): 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: (form: IFormModel) => boolean, message?: string): this;
+    requiredWhen(fn: (params: IFieldCallbackParams) => boolean, message?: string): this;
     computed(fn: ComputedFieldCallback): this;
     computedUntilDirty(fn: ComputedFieldCallback): this;
     disabled(value?: boolean): this;
@@ -30,9 +34,10 @@ export declare class FieldBuilder<TType extends string = string> implements IFie
     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[] | ((form: IFormModel) => IValueOption[])): 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.

package/features/formModel/FieldBuilder.js

@@ -11,6 +11,12 @@ class FieldBuilder {
     get fieldType() {
         return this._config.type;
     }
+    getName() {
+        return this._config.name;
+    }
+    getType() {
+        return this._config.type;
+    }
     label(text) {
         this._config.label = text;
         return this;
@@ -31,6 +37,10 @@ class FieldBuilder {
         this._config.placeholder = text;
         return this;
     }
+    autoFocus(value = true) {
+        this._config.autoFocus = value;
+        return this;
+    }
     schema(zodSchema) {
         this._config.schema = zodSchema;
         return this;
@@ -57,6 +67,11 @@ class FieldBuilder {
         this._config.hiddenWhenCallbacks.push(fn);
         return this;
     }
+    disabledWhen(fn) {
+        if (!this._config.disabledWhenCallbacks) this._config.disabledWhenCallbacks = [];
+        this._config.disabledWhenCallbacks.push(fn);
+        return this;
+    }
     required(message) {
         this._config.required = true;
         this._config.requiredMessage = message;
@@ -113,6 +128,10 @@ class FieldBuilder {
         this._config.cloneValue = fn;
         return this;
     }
+    context(fn) {
+        this._config.context = fn;
+        return this;
+    }
     getTags() {
         return this._config.tags ?? [];
     }
@@ -122,16 +141,16 @@ class FieldBuilder {
     }
     options(opts) {
         this._config.options = opts;
-        if ("textInput" === this._config.renderer || "numberInput" === this._config.renderer) this._config.renderer = "dropdown";
+        if ("textInput" === this._config.renderer || "numberInput" === this._config.renderer) this._config.renderer = "select";
         return this;
     }
     normalizeValue(value) {
         return value;
     }
     build(name) {
+        this._config.name = name;
         return {
             ...this._config,
-            name,
             normalizeValue: (v)=>this.normalizeValue(v)
         };
     }

package/features/formModel/FieldBuilder.js.map

@@ -1 +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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"}
+{"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    IFieldCallbackParams,\n    IFieldBuilder,\n    IFieldBuilderRegistry,\n    IFieldTypeFactory,\n    IRule,\n    BeforeChangeCallback,\n    AfterChangeCallback,\n    AfterSetValueCallback,\n    ComputedFieldCallback,\n    HiddenWhenCallback,\n    DisabledWhenCallback,\n    OnBlurCallback,\n    CloneValueCallback,\n    FieldContextCallback\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    getName(): string {\n        return this._config.name;\n    }\n\n    getType(): 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    autoFocus(value = true): this {\n        this._config.autoFocus = value;\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    disabledWhen(fn: DisabledWhenCallback): this {\n        if (!this._config.disabledWhenCallbacks) {\n            this._config.disabledWhenCallbacks = [];\n        }\n        this._config.disabledWhenCallbacks.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: (params: IFieldCallbackParams) => 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    context(fn: FieldContextCallback): this {\n        this._config.context = 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[] | ((params: IFieldCallbackParams) => IValueOption[])): this {\n        this._config.options = opts;\n        if (this._config.renderer === \"textInput\" || this._config.renderer === \"numberInput\") {\n            this._config.renderer = \"select\";\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        this._config.name = name;\n        return { ...this._config, 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","value","zodSchema","name","settings","fn","message","undefined","rules","tags","opts","v","createFieldBuilderRegistry","factories","fieldTypes","Map","factory","proxy","Proxy","_target","prop"],"mappings":"AAwBO,MAAMA;IAGT,YAAYC,IAAW,CAAE;QACrB,IAAI,CAAC,OAAO,GAAG;YACX,MAAM;YACNA;YACA,QAAQ;YACR,UAAU;YACV,UAAU;QACd;IACJ;IAEA,IAAI,YAAoB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI;IAC5B;IAEA,UAAkB;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI;IAC5B;IAEA,UAAkB;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI;IAC5B;IAEA,MAAMC,IAAY,EAAQ;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,GAAGA;QACrB,OAAO,IAAI;IACf;IAEA,KAAKA,IAAY,EAAQ;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAGA;QACpB,OAAO,IAAI;IACf;IAEA,YAAYA,IAAY,EAAQ;QAC5B,IAAI,CAAC,OAAO,CAAC,WAAW,GAAGA;QAC3B,OAAO,IAAI;IACf;IAEA,KAAKA,IAAY,EAAQ;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAGA;QACpB,OAAO,IAAI;IACf;IAEA,YAAYA,IAAY,EAAQ;QAC5B,IAAI,CAAC,OAAO,CAAC,WAAW,GAAGA;QAC3B,OAAO,IAAI;IACf;IAEA,UAAUC,QAAQ,IAAI,EAAQ;QAC1B,IAAI,CAAC,OAAO,CAAC,SAAS,GAAGA;QACzB,OAAO,IAAI;IACf;IAEA,OAAOC,SAAuB,EAAQ;QAClC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAGA;QACtB,OAAO,IAAI;IACf;IAEA,aAAaD,KAAc,EAAQ;QAC/B,IAAI,CAAC,OAAO,CAAC,YAAY,GAAGA;QAC5B,OAAO,IAAI;IACf;IAEA,SAASE,IAAY,EAAEC,QAAkC,EAAQ;QAC7D,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAGD;QACxB,IAAI,CAAC,OAAO,CAAC,gBAAgB,GAAGC;QAChC,OAAO,IAAI;IACf;IAEA,OAAa;QACT,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG;QACtB,OAAO,IAAI;IACf;IAEA,SAAe;QACX,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG;QACtB,OAAO,IAAI;IACf;IAEA,WAAWC,EAAsB,EAAQ;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EACjC,IAAI,CAAC,OAAO,CAAC,mBAAmB,GAAG,EAAE;QAEzC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAACA;QACtC,OAAO,IAAI;IACf;IAEA,aAAaA,EAAwB,EAAQ;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EACnC,IAAI,CAAC,OAAO,CAAC,qBAAqB,GAAG,EAAE;QAE3C,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAACA;QACxC,OAAO,IAAI;IACf;IAEA,SAASC,OAAgB,EAAQ;QAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG;QACxB,IAAI,CAAC,OAAO,CAAC,eAAe,GAAGA;QAC/B,OAAO,IAAI;IACf;IAEA,aAAaD,EAA6C,EAAEC,OAAgB,EAAQ;QAChF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EACnC,IAAI,CAAC,OAAO,CAAC,qBAAqB,GAAG,EAAE;QAE3C,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC;YAAED;YAAIC;QAAQ;QACtD,OAAO,IAAI;IACf;IAEA,SAASD,EAAyB,EAAQ;QACtC,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAGA;QACxB,IAAI,CAAC,OAAO,CAAC,kBAAkB,GAAGE;QAClC,OAAO,IAAI;IACf;IAEA,mBAAmBF,EAAyB,EAAQ;QAChD,IAAI,CAAC,OAAO,CAAC,kBAAkB,GAAGA;QAClC,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAGE;QACxB,OAAO,IAAI;IACf;IAEA,SAASN,QAAQ,IAAI,EAAQ;QACzB,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAGA;QACxB,OAAO,IAAI;IACf;IAEA,MAAMO,KAAc,EAAQ;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EACnB,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE;QAE3B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAIA;QAC3B,OAAO,IAAI;IACf;IAEA,aAAaH,EAAwB,EAAQ;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EACnC,IAAI,CAAC,OAAO,CAAC,qBAAqB,GAAG,EAAE;QAE3C,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAACA;QACxC,OAAO,IAAI;IACf;IAEA,YAAYA,EAAuB,EAAQ;QACvC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAClC,IAAI,CAAC,OAAO,CAAC,oBAAoB,GAAG,EAAE;QAE1C,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAACA;QACvC,OAAO,IAAI;IACf;IAEA,cAAcA,EAAyB,EAAQ;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,EACpC,IAAI,CAAC,OAAO,CAAC,sBAAsB,GAAG,EAAE;QAE5C,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAACA;QACzC,OAAO,IAAI;IACf;IAEA,OAAOA,EAAkB,EAAQ;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAC7B,IAAI,CAAC,OAAO,CAAC,eAAe,GAAG,EAAE;QAErC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAACA;QAClC,OAAO,IAAI;IACf;IAEA,WAAWA,EAAsB,EAAQ;QACrC,IAAI,CAAC,OAAO,CAAC,UAAU,GAAGA;QAC1B,OAAO,IAAI;IACf;IAEA,QAAQA,EAAwB,EAAQ;QACpC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAGA;QACvB,OAAO,IAAI;IACf;IAEA,UAAoB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE;IAClC;IAEA,KAAKI,IAAc,EAAQ;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAGA;QACpB,OAAO,IAAI;IACf;IAEA,QAAQC,IAAyE,EAAQ;QACrF,IAAI,CAAC,OAAO,CAAC,OAAO,GAAGA;QACvB,IAAI,AAA0B,gBAA1B,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAoB,AAA0B,kBAA1B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAC9D,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG;QAE5B,OAAO,IAAI;IACf;IAOA,eAAeT,KAAc,EAAW;QACpC,OAAOA;IACX;IAEA,MAAME,IAAY,EAAgB;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,GAAGA;QACpB,OAAO;YAAE,GAAG,IAAI,CAAC,OAAO;YAAE,gBAAgB,CAACQ,IAAe,IAAI,CAAC,cAAc,CAACA;QAAG;IACrF;AACJ;AAEO,SAASC,2BAA2BC,SAA8B;IACrE,MAAMC,aAAa,IAAIC;IACvB,KAAK,MAAMC,WAAWH,UAClBC,WAAW,GAAG,CAACE,QAAQ,IAAI,EAAEA;IAGjC,MAAMC,QAA+B,IAAIC,MAAM,CAAC,GAA4B;QACxE,KAAIC,OAAO,EAAEC,IAAY;YACrB,MAAMJ,UAAUF,WAAW,GAAG,CAACM;YAC/B,IAAIJ,SACA,OAAO,IAAMA,QAAQ,MAAM,CAACC;QAGpC;IACJ;IACA,OAAOA;AACX"}

package/features/formModel/FieldBuilder.test.js

@@ -1,14 +1,17 @@
-import { describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vitest";
 import { z } from "zod";
 import { Container } from "@webiny/di";
 import { FormModelFeature } from "./feature.js";
+import { IdentityContextFeature } from "../security/IdentityContext/feature.js";
 import { FieldBuilderRegistry } from "./abstractions.js";
 import { TextFieldBuilder } from "./fieldTypes/TextFieldType.js";
 import { NumberFieldBuilder } from "./fieldTypes/NumberFieldType.js";
 import { BooleanFieldBuilder } from "./fieldTypes/BooleanFieldType.js";
 import { DateTimeFieldBuilder } from "./fieldTypes/DateTimeFieldType.js";
+import { DateFormatter } from "../dateFormatter/abstractions.js";
 function createRegistry() {
     const container = new Container();
+    IdentityContextFeature.register(container);
     FormModelFeature.register(container);
     return container.resolve(FieldBuilderRegistry);
 }
@@ -87,7 +90,7 @@ describe("TextFieldBuilder - options", ()=>{
         expect(config.label).toBe("Language");
         expect(config.required).toBe(true);
         expect(config.options).toEqual(options);
-        expect(config.renderer).toBe("dropdown");
+        expect(config.renderer).toBe("select");
     });
     it("should support reactive options function", ()=>{
         const optionsFn = ()=>[
@@ -106,7 +109,7 @@ describe("TextFieldBuilder - options", ()=>{
                 value: "a"
             }
         ]).build("field");
-        expect(config.renderer).toBe("dropdown");
+        expect(config.renderer).toBe("select");
     });
     it("should not override an explicitly set renderer", ()=>{
         const config = new TextFieldBuilder().renderer("radioButtons").options([
@@ -133,7 +136,7 @@ describe("NumberFieldBuilder - options", ()=>{
         const config = new NumberFieldBuilder().label("Count").options(options).build("count");
         expect(config.type).toBe("number");
         expect(config.options).toEqual(options);
-        expect(config.renderer).toBe("dropdown");
+        expect(config.renderer).toBe("select");
     });
     it("should not override an explicitly set renderer", ()=>{
         const config = new NumberFieldBuilder().renderer("radioButtons").options([
@@ -152,6 +155,155 @@ describe("DateTimeFieldBuilder", ()=>{
         expect(config.renderer).toBe("dateTimeInput");
         expect(config.label).toBe("Created");
     });
+    it("keeps the list renderer when a subtype is set after list()", ()=>{
+        const subtypes = [
+            (b)=>b.dateOnly(),
+            (b)=>b.timeOnly(),
+            (b)=>b.withTimezone(),
+            (b)=>b.withoutTimezone()
+        ];
+        for (const subtype of subtypes){
+            expect(subtype(new DateTimeFieldBuilder().list()).build("d").renderer).toBe("dateTimeInputs");
+            expect(subtype(new DateTimeFieldBuilder()).build("d").renderer).toBe("dateTimeInput");
+        }
+    });
+    it("renders a date-only field with the birthday picker", ()=>{
+        const config = new DateTimeFieldBuilder().dateOnly().renderer("birthdayInput").build("dob");
+        expect(config.renderer).toBe("birthdayInput");
+        expect(config.rendererSettings).toBeUndefined();
+    });
+    it("keeps a birthday picker set before dateOnly() and drops it for other subtypes", ()=>{
+        const birthday = ()=>new DateTimeFieldBuilder().renderer("birthdayInput");
+        const dateOnly = birthday().dateOnly().build("dob");
+        expect(dateOnly.renderer).toBe("birthdayInput");
+        expect(dateOnly.rendererSettings).toEqual({
+            type: "date"
+        });
+        expect(birthday().timeOnly().build("t").renderer).toBe("dateTimeInput");
+    });
+    describe("date limits", ()=>{
+        afterEach(()=>{
+            vi.useRealTimers();
+        });
+        const isValid = async (config, value)=>(await config.schema.safeParseAsync(value)).success;
+        it("hands fixed and relative limits to the renderer, whatever the call order", ()=>{
+            const config = new DateTimeFieldBuilder().dateOnly().dateGte("1900-01-01").dateLte({
+                expression: "today-18y"
+            }).renderer("birthdayInput").build("dob");
+            expect(config.rendererSettings).toEqual({
+                dateLimits: {
+                    gte: [
+                        "1900-01-01"
+                    ],
+                    lte: [
+                        {
+                            expression: "today-18y"
+                        }
+                    ]
+                }
+            });
+        });
+        it("checks a value against fixed limits with their messages", async ()=>{
+            const config = new DateTimeFieldBuilder().dateOnly().dateGte("1950-01-01", "Too early.").dateLte("2000-12-31", "Too late.").build("d");
+            expect(await isValid(config, "1975-06-15")).toBe(true);
+            expect(await isValid(config, "1950-01-01")).toBe(true);
+            expect(await isValid(config, "2000-12-31")).toBe(true);
+            const late = await config.schema.safeParseAsync("2005-01-01");
+            expect(late.success).toBe(false);
+            expect(late.error?.issues[0].message).toBe("Too late.");
+            const early = await config.schema.safeParseAsync("1949-12-31");
+            expect(early.error?.issues[0].message).toBe("Too early.");
+        });
+        it("works out an expression against the local date at the moment of the check", async ()=>{
+            vi.useFakeTimers();
+            vi.setSystemTime(new Date(2026, 9, 19, 12));
+            const config = new DateTimeFieldBuilder().dateOnly().dateLte({
+                expression: "today-18y"
+            }).build("dob");
+            expect(await isValid(config, "2008-10-19")).toBe(true);
+            expect(await isValid(config, "2008-10-20")).toBe(false);
+            const message = (await config.schema.safeParseAsync("2008-10-20")).error?.issues[0].message;
+            expect(message).toBe("Must be on or before 2008-10-19.");
+            vi.setSystemTime(new Date(2026, 9, 20, 12));
+            expect(await isValid(config, "2008-10-20")).toBe(true);
+        });
+        it("puts the limit into a message's {date} in the admin's date format", async ()=>{
+            vi.useFakeTimers();
+            vi.setSystemTime(new Date(2026, 9, 19, 12));
+            const formatter = {
+                format: vi.fn((date)=>`formatted ${date}`)
+            };
+            const message = async (builder, value)=>(await builder.build("d").schema.safeParseAsync(value)).error?.issues[0].message;
+            expect(await message(new DateTimeFieldBuilder(formatter).dateOnly().dateLte({
+                expression: "today-18y"
+            }, "Born on or before {date}, please."), "2010-01-01")).toBe("Born on or before formatted 2008-10-19, please.");
+            expect(formatter.format).toHaveBeenLastCalledWith("2008-10-19", {
+                hour: void 0,
+                minute: void 0,
+                timeZone: "UTC"
+            });
+            expect(await message(new DateTimeFieldBuilder(formatter).dateOnly().dateGte("1950-01-01"), "1949-12-31")).toBe("Must be on or after formatted 1950-01-01.");
+            expect(await message(new DateTimeFieldBuilder(formatter).timeOnly().dateLte("12:00:00"), "13:00:00")).toBe("Must be on or before 12:00:00.");
+        });
+        it("formats {date} with the registered DateFormatter", async ()=>{
+            const container = new Container();
+            container.registerInstance(DateFormatter, {
+                format: (date)=>`formatted ${date}`
+            });
+            IdentityContextFeature.register(container);
+            FormModelFeature.register(container);
+            const registry = container.resolve(FieldBuilderRegistry);
+            const config = registry.datetime().dateOnly().dateLte("2000-12-31").build("d");
+            const result = await config.schema.safeParseAsync("2005-01-01");
+            expect(result.error?.issues[0].message).toBe("Must be on or before formatted 2000-12-31.");
+        });
+        it("keeps the field's own schema", async ()=>{
+            const config = new DateTimeFieldBuilder().dateOnly().dateLte("2000-12-31").schema(z.string().regex(/^19/, "Must be in the 1900s.")).build("d");
+            expect(await isValid(config, "1990-01-01")).toBe(true);
+            const result = await config.schema.safeParseAsync("2000-01-01");
+            expect(result.error?.issues[0].message).toBe("Must be in the 1900s.");
+            expect(await isValid(config, "2005-01-01")).toBe(false);
+        });
+        it("checks every value of a list and lets an empty value through", async ()=>{
+            const config = new DateTimeFieldBuilder().list().dateOnly().dateGte("2000-01-01").build("d");
+            expect(await isValid(config, [
+                "2001-01-01",
+                "2002-01-01"
+            ])).toBe(true);
+            expect(await isValid(config, [
+                "2001-01-01",
+                "1999-01-01"
+            ])).toBe(false);
+            expect(await isValid(config, "")).toBe(true);
+        });
+        it("fails a value checked against an expression it can't read", async ()=>{
+            const config = new DateTimeFieldBuilder().dateOnly().dateLte({
+                expression: "now-18y"
+            }).build("d");
+            const result = await config.schema.safeParseAsync("2000-01-01");
+            expect(result.error?.issues[0].message).toBe('Invalid date limit "now-18y".');
+        });
+        it("leaves a field without limits as it was", ()=>{
+            const config = new DateTimeFieldBuilder().dateOnly().build("d");
+            expect(config.schema).toBeUndefined();
+            expect(config.rendererSettings).toEqual({
+                type: "date"
+            });
+        });
+    });
+    it("normalizes withTimezone values", ()=>{
+        const builder = new DateTimeFieldBuilder().withTimezone();
+        expect(builder.normalizeValue("2026-05-01T14:30:00+02:00")).toBe("2026-05-01T14:30:00+02:00");
+        expect(builder.normalizeValue("2026-05-01T14:30-05:30")).toBe("2026-05-01T14:30:00-05:30");
+        expect(builder.normalizeValue("2026-05-01T09:00:00.000Z")).toBe("2026-05-01T09:00:00.000+00:00");
+        expect(builder.normalizeValue("2026-05-01T14:30:00")).toBe("2026-05-01T14:30:00");
+    });
+    it("normalizes withoutTimezone values to a stable UTC instant", ()=>{
+        const builder = new DateTimeFieldBuilder().withoutTimezone();
+        const value = "2026-05-01T12:30:00.000Z";
+        expect(builder.normalizeValue(value)).toBe(value);
+        expect(builder.normalizeValue(builder.normalizeValue(value))).toBe(value);
+    });
 });
 describe("FieldBuilderRegistry", ()=>{
     it("should create text builders via registry.text()", ()=>{
@@ -189,7 +341,7 @@ describe("FieldBuilderRegistry", ()=>{
             }
         ]).build("field");
         expect(config.options).toHaveLength(1);
-        expect(config.renderer).toBe("dropdown");
+        expect(config.renderer).toBe("select");
     });
 });
 describe("normalizeValue", ()=>{