@ng-forge/dynamic-forms 1.3.0-next.4 → 1.3.0

package/fesm2022/ng-forge-dynamic-forms.mjs

@@ -1,5 +1,5 @@
 import { d as FieldViewportObserver, f as resolveFieldParking, h as FIELD_WINDOWING, i as initializationComponentKey, m as clampWindowSize, n as collectInitializingContainerKeys, p as resolveFieldWindowing, t as DfFieldOutlet, u as resolveWrappers } from "./ng-forge-dynamic-forms-df-field-outlet.directive-CQsDMV-s.mjs";
-import { a as walkAndValidateAddons, n as FormStateManager, o as normalizeSimplifiedArrays, r as VALUE_EXCLUSION_DEFAULTS, s as FormSubmitEvent, t as FORM_STATE_DEPS } from "./ng-forge-dynamic-forms-form-state-manager-BJKBX4FL.mjs";
+import { a as walkAndValidateAddons, n as FormStateManager, o as normalizeSimplifiedArrays, r as VALUE_EXCLUSION_DEFAULTS, s as FormSubmitEvent, t as FORM_STATE_DEPS } from "./ng-forge-dynamic-forms-form-state-manager-3Ng7d_U2.mjs";
 import { c as PROPERTY_OVERRIDE_STORE, l as createPropertyOverrideStore, u as injectFieldRegistry } from "./ng-forge-dynamic-forms-resolve-field-ByGa5cpo.mjs";
 import { a as resolveDefaultExport, n as loadWrapperComponent } from "./ng-forge-dynamic-forms-wrapper-chain-BnntfNU1.mjs";
 import { n as getNormalizedArrayMetadata } from "./ng-forge-dynamic-forms-default-value-D5M4MNE-.mjs";
@@ -624,7 +624,7 @@ function createDerivationRenderGate() {
 	explicitEffect([hasDerivations], ([has]) => {
 		if (!has || engine() !== "idle") return;
 		engine.set("loading");
-		pendingTasks.run(() => import("./ng-forge-dynamic-forms-bootstrap-derivation-orchestrator-B6WH0Etk.mjs").then(({ bootstrapDerivationOrchestrator }) => {
+		pendingTasks.run(() => import("./ng-forge-dynamic-forms-bootstrap-derivation-orchestrator-DJinfAnV.mjs").then(({ bootstrapDerivationOrchestrator }) => {
 			runInInjectionContext(injector, () => bootstrapDerivationOrchestrator());
 			engine.set("wired");
 		}).catch((error) => {
@@ -677,7 +677,7 @@ function createWebMcpGate() {
 		const controller = new AbortController();
 		epoch = controller;
 		status.set("registering");
-		import("./ng-forge-dynamic-forms-bootstrap-web-mcp-VjJn-JeD.mjs").then(({ bootstrapWebMcp }) => {
+		import("./ng-forge-dynamic-forms-bootstrap-web-mcp-Ce93FPLR.mjs").then(({ bootstrapWebMcp }) => {
 			if (thisEpoch !== epochId || controller.signal.aborted) return;
 			return runInInjectionContext(injector, () => bootstrapWebMcp(input.options, controller.signal));
 		}).then((result) => {

package/internal/src/lib/core/expressions/parser/evaluator.d.ts

@@ -0,0 +1,26 @@
+import { ASTNode } from './types';
+/** Evaluation context for safe expression evaluation */
+export interface EvaluationScope {
+    [key: string]: unknown;
+}
+/** Every method name callable on some receiver type. A name outside this set can never be called. */
+export declare const ALLOWED_METHOD_NAMES: ReadonlySet<string>;
+/** Safely evaluates an AST node with a given context */
+export declare class Evaluator {
+    private readonly scope;
+    private readonly expression;
+    constructor(scope: EvaluationScope, expression: string);
+    /** Evaluate an AST node */
+    evaluate(node: ASTNode): unknown;
+    private evaluateIdentifier;
+    private evaluateMemberAccess;
+    private evaluateComputedMemberAccess;
+    private evaluateBinaryOp;
+    private evaluateUnaryOp;
+    private evaluateCallExpression;
+    private evaluateArrayLiteral;
+    private evaluateObjectLiteral;
+    private evaluateArrowFunction;
+    private isMethodSafe;
+}
+//# sourceMappingURL=evaluator.d.ts.map

package/internal/src/lib/core/expressions/parser/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/dynamic-forms/internal/src/lib/core/expressions/parser/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAyB,MAAM,SAAS,CAAC;AAEzD,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiGD,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAA2E,CAAC;AAgBjI,wDAAwD;AACxD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM;IAKtD,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAwChC,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,4BAA4B;IA0BpC,OAAO,CAAC,gBAAgB;IAyDxB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,sBAAsB;IA4C9B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,YAAY;CAcrB"}

package/internal/src/lib/core/expressions/parser/expression-parser.d.ts

@@ -0,0 +1,20 @@
+import { EvaluationScope } from './evaluator';
+import { ASTNode } from './types';
+/** Secure expression parser that uses AST-based evaluation */
+export declare class ExpressionParser {
+    /**
+     * Parse an expression string into an AST
+     * Results are cached for performance using LRU eviction
+     */
+    static parse(expression: string): ASTNode;
+    /** Evaluate an expression with a given scope */
+    static evaluate(expression: string, scope: EvaluationScope): unknown;
+    /** Clear the AST cache */
+    static clearCache(): void;
+    /** Get cache statistics */
+    static getCacheStats(): {
+        size: number;
+        maxSize: number;
+    };
+}
+//# sourceMappingURL=expression-parser.d.ts.map

package/internal/src/lib/core/expressions/parser/expression-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-parser.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/dynamic-forms/internal/src/lib/core/expressions/parser/expression-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAyB,MAAM,SAAS,CAAC;AAyDzD,8DAA8D;AAC9D,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAiBzC,gDAAgD;IAChD,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO;IAkBpE,0BAA0B;IAC1B,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB,2BAA2B;IAC3B,MAAM,CAAC,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAM1D"}

package/internal/src/lib/core/expressions/parser/parser.d.ts

@@ -0,0 +1,51 @@
+import { ASTNode } from './types';
+/**
+ * Parses tokens into an Abstract Syntax Tree (AST)
+ * Uses recursive descent parsing with operator precedence
+ */
+export declare class Parser {
+    private tokens;
+    private current;
+    private readonly expression;
+    constructor(expression: string);
+    /** Parse the expression into an AST */
+    parse(): ASTNode;
+    private parseExpression;
+    /**
+     * Ternary `test ? consequent : alternate` — right-associative, sits between
+     * the arrow-function check and logical-or in precedence.
+     */
+    private parseConditional;
+    /**
+     * Attempts to parse an arrow function. Returns null and leaves position
+     * unchanged if the next tokens don't form an arrow function head.
+     */
+    private tryParseArrowFunction;
+    private checkAt;
+    /**
+     * `a ?? b` or an `||`/`&&` chain. As in JavaScript, `??` can't be mixed with
+     * `&&` or `||` without parentheses.
+     */
+    private parseShortCircuit;
+    private throwMixedNullish;
+    private parseLogicalOr;
+    private parseLogicalAnd;
+    private parseEquality;
+    private parseComparison;
+    private parseAddition;
+    private parseMultiplication;
+    private parseUnary;
+    private parsePostfix;
+    private parsePrimary;
+    private parseArgumentList;
+    private parseArrayElements;
+    private parseObjectProperties;
+    private match;
+    private check;
+    private advance;
+    private isAtEnd;
+    private peek;
+    private previous;
+    private consume;
+}
+//# sourceMappingURL=parser.d.ts.map

package/internal/src/lib/core/expressions/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/dynamic-forms/internal/src/lib/core/expressions/parser/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,OAAO,EAAyB,MAAM,SAAS,CAAC;AAG3E;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,MAAM;IAI9B,uCAAuC;IACvC,KAAK,IAAI,OAAO;IAuBhB,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAmD7B,OAAO,CAAC,OAAO;IAKf;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,YAAY;IAuDpB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;CAKhB"}

package/internal/src/lib/core/expressions/parser/static-check.d.ts

@@ -0,0 +1,25 @@
+import { ASTNode } from './types';
+/** Variables a condition expression can read (the keys of `EvaluationContext`). */
+export declare const CONDITION_SCOPE_VARIABLES: ReadonlySet<string>;
+/**
+ * Finds constructs that parse but can never work at runtime: a direct function call
+ * (`String(x)`), a method outside the allow-list, or a name that isn't in scope (`Math`),
+ * which reads as `undefined` and makes the expression quietly wrong.
+ */
+export declare function findStaticExpressionProblems(ast: ASTNode, scope: ReadonlySet<string>): string[];
+/** An expression in a field's own config that can never work. */
+export interface FieldExpressionProblem {
+    /** Where in the field's config, e.g. `logic[0].condition`. */
+    path: string;
+    /** The expression, absent for an empty and/or group. */
+    expression?: string;
+    /** What is wrong, e.g. `'Math' is not available in expressions`. */
+    message: string;
+}
+/**
+ * Checks the expressions in one field's own config: javascript conditions, derivation
+ * expressions (`logic` entries and the `derivation` shorthand) and empty and/or groups.
+ * Child `fields` are skipped, so callers walking the field tree see each one once.
+ */
+export declare function findFieldExpressionProblems(field: unknown): FieldExpressionProblem[];
+//# sourceMappingURL=static-check.d.ts.map

package/internal/src/lib/core/expressions/parser/static-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-check.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/dynamic-forms/internal/src/lib/core/expressions/parser/static-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAYxD,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAoD/F;AAMD,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,EAAE,CAyCpF"}

package/internal/src/lib/core/expressions/parser/tokenizer.d.ts

@@ -0,0 +1,19 @@
+import { Token } from './types';
+/** Tokenizes an expression string into tokens */
+export declare class Tokenizer {
+    private position;
+    private readonly expression;
+    constructor(expression: string);
+    /** Tokenize the entire expression */
+    tokenize(): Token[];
+    private skipWhitespace;
+    private nextToken;
+    private readString;
+    private readNumber;
+    private readIdentifierOrKeyword;
+    /** Reads the whole code point at `position`, keeping surrogate pairs intact. */
+    private codePointAt;
+    private getKeywordType;
+    private readOperatorOrPunctuation;
+}
+//# sourceMappingURL=tokenizer.d.ts.map

package/internal/src/lib/core/expressions/parser/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/dynamic-forms/internal/src/lib/core/expressions/parser/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAoC,MAAM,SAAS,CAAC;AAQlE,iDAAiD;AACjD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,MAAM;IAI9B,qCAAqC;IACrC,QAAQ,IAAI,KAAK,EAAE;IAkBnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,UAAU;IA8ClB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,uBAAuB;IAkB/B,gFAAgF;IAChF,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,yBAAyB;CA4FlC"}

package/internal/src/lib/core/expressions/parser/types.d.ts

@@ -0,0 +1,117 @@
+import { DynamicFormError } from '../../../errors/dynamic-form-error';
+/** Token types for expression parsing */
+export declare enum TokenType {
+    NUMBER = "NUMBER",
+    STRING = "STRING",
+    TRUE = "TRUE",
+    FALSE = "FALSE",
+    NULL = "NULL",
+    UNDEFINED = "UNDEFINED",
+    IDENTIFIER = "IDENTIFIER",
+    PLUS = "PLUS",
+    MINUS = "MINUS",
+    MULTIPLY = "MULTIPLY",
+    DIVIDE = "DIVIDE",
+    MODULO = "MODULO",
+    EQUAL = "EQUAL",
+    NOT_EQUAL = "NOT_EQUAL",
+    GREATER = "GREATER",
+    LESS = "LESS",
+    GREATER_EQUAL = "GREATER_EQUAL",
+    LESS_EQUAL = "LESS_EQUAL",
+    AND = "AND",
+    OR = "OR",
+    NULLISH = "NULLISH",
+    NOT = "NOT",
+    DOT = "DOT",
+    COMMA = "COMMA",
+    COLON = "COLON",
+    LPAREN = "LPAREN",
+    RPAREN = "RPAREN",
+    LBRACKET = "LBRACKET",
+    RBRACKET = "RBRACKET",
+    LBRACE = "LBRACE",
+    RBRACE = "RBRACE",
+    ARROW = "ARROW",
+    QUESTION = "QUESTION",
+    OPTIONAL_DOT = "OPTIONAL_DOT",
+    EOF = "EOF"
+}
+/** Token with type, value, and position */
+export interface Token {
+    type: TokenType;
+    value: string;
+    position: number;
+}
+/** AST Node types */
+export type ASTNode = LiteralNode | IdentifierNode | MemberAccessNode | ComputedMemberAccessNode | BinaryOpNode | UnaryOpNode | CallExpressionNode | ConditionalNode | ArrayLiteralNode | ObjectLiteralNode | ArrowFunctionNode;
+export interface LiteralNode {
+    type: 'Literal';
+    value: string | number | boolean | null | undefined;
+}
+export interface IdentifierNode {
+    type: 'Identifier';
+    name: string;
+}
+export interface MemberAccessNode {
+    type: 'MemberAccess';
+    object: ASTNode;
+    property: string;
+    /** True when this access used `?.` (optional chaining). */
+    optional?: boolean;
+}
+export interface ComputedMemberAccessNode {
+    type: 'ComputedMemberAccess';
+    object: ASTNode;
+    /** Expression evaluated at runtime to produce the property key. */
+    property: ASTNode;
+    /** True when this access used `?.[ ... ]` (optional chaining). */
+    optional?: boolean;
+}
+export interface ConditionalNode {
+    type: 'Conditional';
+    test: ASTNode;
+    consequent: ASTNode;
+    alternate: ASTNode;
+}
+export interface BinaryOpNode {
+    type: 'BinaryOp';
+    operator: string;
+    left: ASTNode;
+    right: ASTNode;
+}
+export interface UnaryOpNode {
+    type: 'UnaryOp';
+    operator: string;
+    operand: ASTNode;
+}
+export interface CallExpressionNode {
+    type: 'CallExpression';
+    callee: ASTNode;
+    arguments: ASTNode[];
+    /** True when this call used `?.( ... )` (optional chaining). */
+    optional?: boolean;
+}
+export interface ArrayLiteralNode {
+    type: 'ArrayLiteral';
+    elements: ASTNode[];
+}
+export interface ObjectLiteralNode {
+    type: 'ObjectLiteral';
+    properties: Array<{
+        key: string;
+        value: ASTNode;
+    }>;
+}
+export interface ArrowFunctionNode {
+    type: 'ArrowFunction';
+    params: string[];
+    body: ASTNode;
+}
+/** Parser error with position information */
+export declare class ExpressionParserError extends DynamicFormError {
+    position: number;
+    expression: string;
+    constructor(message: string, position: number, expression: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/internal/src/lib/core/expressions/parser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/dynamic-forms/internal/src/lib/core/expressions/parser/types.ts"],"names":[],"mappings":"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"}

package/internal/src/lib/errors/dynamic-form-error.d.ts

@@ -0,0 +1,6 @@
+/** Base error class for all Dynamic Forms errors. */
+export declare class DynamicFormError extends Error {
+    private static readonly PREFIX;
+    constructor(message: string);
+}
+//# sourceMappingURL=dynamic-form-error.d.ts.map

package/internal/src/lib/errors/dynamic-form-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-form-error.d.ts","sourceRoot":"","sources":["../../../../../../../packages/dynamic-forms/internal/src/lib/errors/dynamic-form-error.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAEvC,OAAO,EAAE,MAAM;CAI5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-forge/dynamic-forms",
-  "version": "1.3.0-next.4",
+  "version": "1.3.0",
   "description": "Type-safe, signal-powered dynamic forms for Angular. Build complex forms from configuration with full TypeScript inference.",
   "type": "module",
   "license": "MIT",

package/types/ng-forge-dynamic-forms-integration.d.ts

@@ -34,7 +34,7 @@ interface CheckboxField<TProps, TNullable extends boolean = boolean> extends Bas
  * extend this with adapter-specific options (startView, appearance, hint, etc.).
  */
 type DatepickerProps = object;
-interface DatepickerField<TProps, TNullable extends boolean = boolean> extends BaseValueField<TProps, Date | string, FieldMeta, TNullable> {
+interface DatepickerField<TProps, TNullable extends boolean = boolean> extends BaseValueField<TProps, Date | string | readonly (Date | string)[], FieldMeta, TNullable> {
   type: 'datepicker';
   minDate?: Date | string | null;
   maxDate?: Date | string | null;
@@ -189,7 +189,15 @@ interface SelectField<T, TProps = SelectProps, TNullable extends boolean = boole
   type: 'select';
   readonly options: readonly FieldOption<T>[];
 }
-interface SliderField<TProps, TNullable extends boolean = boolean> extends BaseValueField<TProps, number, FieldMeta, TNullable> {
+/**
+ * A number, or a range from kits that have one: PrimeNG `range` gives `number[]`, Ionic
+ * `dualKnobs` gives `{ lower, upper }`. The inferred form value follows the props.
+ */
+type SliderValue = number | readonly number[] | {
+  lower: number;
+  upper: number;
+};
+interface SliderField<TProps, TNullable extends boolean = boolean> extends BaseValueField<TProps, SliderValue, FieldMeta, TNullable> {
   type: 'slider';
   minValue?: number;
   maxValue?: number;

package/types/ng-forge-dynamic-forms-internal.d.ts

@@ -986,13 +986,53 @@ type Depth = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
  * This prevents `as const` from over-narrowing types like `''` to literal `''` instead of `string`.
  */
 type Widen<T, D extends number = 5> = [D] extends [never] ? T : T extends string ? string : T extends number ? number : T extends boolean ? boolean : T extends readonly (infer U)[] ? Widen<U, Depth[D]>[] : T extends Record<string, unknown> ? { -readonly [K in keyof T]: Widen<T[K], Depth[D]>; } : T;
+/**
+ * An explicit non-empty array `value` keeps its widened item type. An empty one (`[]`, whose
+ * items are `never`) or no array at all falls back to the kit's default item type.
+ */
+type MultiItems<V, TItem> = V extends readonly unknown[] ? ([V[number]] extends [never] ? TItem[] : Widen<V>) : TItem[];
+/**
+ * Value shape for fields whose props switch them to several values: `select` / `datepicker` with
+ * `multiple`, a PrimeNG datepicker in `multiple`/`range` mode (ISO strings), a PrimeNG `range`
+ * slider (number[]) and an Ionic `dualKnobs` slider ({ lower, upper }). `never` for single-value fields.
+ */
+type MultiValueType<T, V> = T extends {
+  type: 'select';
+  props: {
+    multiple: true;
+  };
+} ? MultiItems<V, string> : T extends {
+  type: 'datepicker';
+  props: {
+    multiple: true;
+  };
+} ? MultiItems<V, Date> : T extends {
+  type: 'datepicker';
+  props: {
+    selectionMode: 'multiple' | 'range';
+  };
+} ? MultiItems<V, string> : T extends {
+  type: 'slider';
+  props: {
+    range: true;
+  };
+} ? number[] : T extends {
+  type: 'slider';
+  props: {
+    dualKnobs: true;
+  };
+} ? {
+  lower: number;
+  upper: number;
+} : never;
 /**
  * Resolves the "underlying" non-null value type for a field, based on its `type`
  * discriminator and (where it matters) its `value` literal. Used when we need a
  * base type independent of whether the literal happens to be `null` — i.e., when
  * computing the nullable widening for `value: null, nullable: true`.
  */
-type ResolveBaseValueType<T, V> = T extends {
+type ResolveBaseValueType<T, V> = [MultiValueType<T, V>] extends [never] ? ResolveSingleValueType<T, V> : MultiValueType<T, V>;
+type ResolveSingleValueType<T, V> = T extends {
   type: 'slider';
 } ? number : T extends {
   type: 'input';
@@ -1089,9 +1129,13 @@ type ProcessField<T, D extends number = 5> = [D] extends [never] ? Record<string
   value: infer V;
 } ? K extends string ? { [P in K]: MaybeOptional<T, InferValueType<T, V>>; } : never : T extends {
   key: infer K;
-} ? K extends string ? { [P in K]: MaybeOptional<T, T extends {
+} ? K extends string ? { [P in K]: MaybeOptional<T, InferUnvaluedType<T>>; } : never : never;
+/** Value fields without `value`: string, unless props switch the field to several values. */
+type InferUnvaluedType<T> = [MultiValueType<T, null>] extends [never] ? T extends {
+  nullable: true;
+} ? string | null : string : T extends {
   nullable: true;
-} ? string | null : string>; } : never : never;
+} ? MultiValueType<T, null> | null : MultiValueType<T, null>;
 /** Internal helper with depth tracking */
 type InferFormValueWithDepth<T extends RegisteredFieldTypes[], D extends number = 5> = UnionToIntersection<ProcessField<T[number], D>>;
 /** Helper to extract fields from either fields array or FormConfig */
@@ -2794,6 +2838,21 @@ export declare const CONDITION_SCOPE_VARIABLES: ReadonlySet<string>;
  * which reads as `undefined` and makes the expression quietly wrong.
  */
 export declare function findStaticExpressionProblems(ast: ASTNode, scope: ReadonlySet<string>): string[];
+/** An expression in a field's own config that can never work. */
+export interface FieldExpressionProblem {
+  /** Where in the field's config, e.g. `logic[0].condition`. */
+  path: string;
+  /** The expression, absent for an empty and/or group. */
+  expression?: string;
+  /** What is wrong, e.g. `'Math' is not available in expressions`. */
+  message: string;
+}
+/**
+ * Checks the expressions in one field's own config: javascript conditions, derivation
+ * expressions (`logic` entries and the `derivation` shorthand) and empty and/or groups.
+ * Child `fields` are skipped, so callers walking the field tree see each one once.
+ */
+export declare function findFieldExpressionProblems(field: unknown): FieldExpressionProblem[];
 /** TTL cache for HTTP condition responses with max entries eviction. */
 export declare class HttpConditionCache {
   private readonly cache;