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

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.3",
+  "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 */
@@ -2672,6 +2716,7 @@ export declare enum TokenType {
   LESS_EQUAL = "LESS_EQUAL",
   AND = "AND",
   OR = "OR",
+  NULLISH = "NULLISH",
   NOT = "NOT",
   DOT = "DOT",
   COMMA = "COMMA",
@@ -2785,6 +2830,29 @@ export declare class ExpressionParser {
     maxSize: number;
   };
 }
+/** 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[];
 /** TTL cache for HTTP condition responses with max entries eviction. */
 export declare class HttpConditionCache {
   private readonly cache;

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

@@ -106,6 +106,58 @@ export declare class ActivePageInitializedEvent implements FormEvent$1 {
   readonly type: "active-page-initialized";
   constructor(pageIndex: number, pageKey: string);
 }
+/**
+ * Field metadata handed to a projected placeholder template as its context —
+ * both `$implicit` (for `let-field`) and the named `field`. Deliberately narrow
+ * and stable: it is NOT the internal `ResolvedField`.
+ */
+interface FieldPlaceholderInfo {
+  /** The field's key. */
+  readonly key: string;
+  /** The field's type (e.g. `input`, `textarea`, `select`). */
+  readonly type: string;
+  /** The field's label when it is a plain string; translated (Observable or Signal) labels are not resolved. */
+  readonly label?: string;
+  /** The field's grid column span, if any. */
+  readonly col?: number;
+}
+/** Template context for a projected `dfPlaceholder`. */
+interface FieldPlaceholderContext {
+  readonly $implicit: FieldPlaceholderInfo;
+  readonly field: FieldPlaceholderInfo;
+}
+/**
+ * Marks an `<ng-template>` projected into `<form dynamic-form>` content as a
+ * field-windowing placeholder. Mirrors {@link DfTemplate}: the template is
+ * captured by `DynamicForm` via `contentChildren` and published through
+ * {@link DF_FIELD_PLACEHOLDERS} so dynamically-rendered pages can resolve it.
+ *
+ * - `<ng-template dfPlaceholder let-field>` — default, used for any field
+ * - `<ng-template dfPlaceholder="textarea">` — matched by field type
+ * - `<ng-template dfPlaceholderKey="username">` — matched by a specific field key
+ */
+export declare class DfPlaceholder {
+  /** Field-type match, or empty for the default placeholder. */
+  readonly dfPlaceholder: import("@angular/core").InputSignal<string>;
+  /** Field-key match (escape hatch); wins over a type match. */
+  readonly dfPlaceholderKey: import("@angular/core").InputSignal<string>;
+  readonly templateRef: TemplateRef<FieldPlaceholderContext>;
+  /** Types `let-field` in `<ng-template dfPlaceholder let-field>`. */
+  static ngTemplateContextGuard(_dir: DfPlaceholder, ctx: unknown): ctx is FieldPlaceholderContext;
+  static ɵfac: i0.ɵɵFactoryDeclaration<DfPlaceholder, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<DfPlaceholder, "ng-template[dfPlaceholder], ng-template[dfPlaceholderKey]", ["dfPlaceholder"], {
+    "dfPlaceholder": {
+      "alias": "dfPlaceholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "dfPlaceholderKey": {
+      "alias": "dfPlaceholderKey";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 /** Resolved field ready for rendering with ngComponentOutlet / DfFieldOutlet. */
 interface ResolvedField {
   key: string;
@@ -176,9 +228,14 @@ export declare class DynamicForm<TFields extends RegisteredFieldTypes$1[] = Regi
   private logger;
   private dispatcher;
   private templateRegistry;
+  private placeholderRegistry;
+  private fieldPlaceholders;
   private globalFieldWindowing;
   /** All `<ng-template dfTemplate="...">` instances projected into this form. */
   private readonly _projectedTemplates;
+  /** All `<ng-template dfPlaceholder>` instances projected into this form. */
+  private readonly _projectedPlaceholders;
+  private readonly placeholderContextFor;
   private readonly stateManager;
   /**
    * Owns this form's DOM-id prefix and registers the instance with the root
@@ -324,6 +381,10 @@ export declare class DynamicForm<TFields extends RegisteredFieldTypes$1[] = Regi
   protected windowsField(field: ResolvedField, index: number): boolean;
   /** Class string for a windowed field's placeholder — matches the real field's grid column. */
   protected placeholderGridClass(field: ResolvedField): string;
+  /** Projected placeholder template for a windowed field, or null for the built-in bare div. */
+  protected placeholderTemplate(field: ResolvedField): TemplateRef<FieldPlaceholderContext> | null;
+  /** Memoised template context for a windowed field's projected placeholder. */
+  protected placeholderContext(field: ResolvedField): FieldPlaceholderContext;
   private setupEffects;
   /**
    * Populates FORM_STATE_DEPS with this component's input signals, then injects
@@ -367,7 +428,7 @@ export declare class DynamicForm<TFields extends RegisteredFieldTypes$1[] = Regi
     "activePageInitialized": "activePageInitialized";
     "onPageChange": "onPageChange";
     "onPageNavigationStateChange": "onPageNavigationStateChange";
-  }, ["_projectedTemplates"], never, true, never>;
+  }, ["_projectedTemplates", "_projectedPlaceholders"], never, true, never>;
 }
 /**
  * Injectable service for dispatching events into a DynamicForm from outside the form.
@@ -1246,4 +1307,4 @@ interface ArrayItemContext {
   /** Form value for token resolution */
   formValue?: unknown;
 }
-export { type AddonActionContext, type AddonActionPreset, type AddonActionsFeature, type AddonSlot, type AddonTypeDefinition, type AddonWarning, type AnyAddon, type ArrayAllowedChildren, type ArrayButtonConfig, type ArrayField, type ArrayItemContext, type ArrayItemDefinitionTemplate, type ArrayItemTemplate, type AsyncCondition, type AsyncConditionFunction, type AsyncCustomValidator, type AsyncDerivationFunction, type AsyncValidatorConfig, type AvailableFieldTypes, type BaseAddon, type BaseCheckedField, type BaseValidatorConfig, type BaseValueField, type BuiltInValidatorConfig, type CheckedFieldComponent, type CommonAddonActionPreset, type CommonAddonSlot, type ComponentAddon, type ConditionalExpression, type ContainerAllowedChildren, type ContainerField, type ContainerFieldTypes, type CssWrapper, type CustomFnConfig, type CustomFunction, type CustomValidator, type CustomValidatorConfig, DF_FIELD_TEMPLATES, type DeclarativeHttpValidatorConfig, type DynamicFormActionRegistry, type DynamicFormAddonActionPresetRegistry, type DynamicFormAddonRegistry, type DynamicFormAddonSlotRegistry, DynamicFormError, type DynamicFormFieldRegistry, DynamicFormLogger, type DynamicText, type DynamicValue, type EvaluationContext, type ExtractField, type ExtractFieldDefs, type ExtractFormValue, type FieldBoundAddonActionContext, type FieldComponent, type FieldDef, type FieldMeta, type FieldOption, type FieldParkingOption, type FieldPathAccess, type FieldRegistryContainers, type FieldRegistryLeaves, type FieldRegistryWrappers, type FieldWithValidation, type FieldWrapper, type FormConfig, type FormEvent, type FormEventConstructor, type FormMode, type FormModeDetectionResult, type FormOptions, type FormStateCondition, type GroupAllowedChildren, type GroupField, type HiddenField, type HiddenScalar, type HiddenValue, type HttpCondition, type HttpCustomValidator, type HttpRequestConfig, type HttpValidationResponseMapping, type InferFormValue, type InferWrapperRegistry, type InitialPageConfig, type LeafFieldTypes, type Logger, type LogicConfig, type NarrowField, type NarrowFields, type NextButtonOptions, NoopLogger, type OrphanAddonActionContext, type PageAllowedChildren, type PageField, type PageNavigationOptions, type PagerState, type RegisteredActionRef, type RegisteredFieldTypes, type ResolvedValidationExecutionConfig, type ResolvedValueExclusionConfig, type RowAllowedChildren, type RowErrorSpec, type RowField, type SanitizeFormConfigOptions, type SanitizedFormConfig, type SchemaApplicationConfig, type SchemaDefinition, type SimplifiedArrayField, type StateLogicConfig, type SubmissionActionResult, type SubmissionConfig, type SubmissionOutcome, type SubmissionReply, type SubmitButtonOptions, type TemplateAddon, type TextAddon, type TextElementType, type TextField, type TextProps, type TokenContext, type ValidationError, type ValidationExecutionConfig, type ValidationMessage, type ValidationMessageResolver, type ValidationMessages, type ValidatorConfig, type ValueExclusionConfig, type ValueFieldComponent, type ValueType, type WebMcpStatus, type WebMcpToolOptions, type WithInputSignals, type WrapperConfig, type WrapperRegistration, type WrapperTypeDefinition, type WrappersBundle, hasFormValue, isArrayField, isContainerField, isDisplayOnlyField, isFieldBoundContext, isFormStateCondition, isGroupField, isHiddenField, isLeafField, isPageField, isRowField, isSimplifiedArrayField, isValueBearingField, isWrapperTypeDefinition, resolveDynamicValue, rowError };
+export { type AddonActionContext, type AddonActionPreset, type AddonActionsFeature, type AddonSlot, type AddonTypeDefinition, type AddonWarning, type AnyAddon, type ArrayAllowedChildren, type ArrayButtonConfig, type ArrayField, type ArrayItemContext, type ArrayItemDefinitionTemplate, type ArrayItemTemplate, type AsyncCondition, type AsyncConditionFunction, type AsyncCustomValidator, type AsyncDerivationFunction, type AsyncValidatorConfig, type AvailableFieldTypes, type BaseAddon, type BaseCheckedField, type BaseValidatorConfig, type BaseValueField, type BuiltInValidatorConfig, type CheckedFieldComponent, type CommonAddonActionPreset, type CommonAddonSlot, type ComponentAddon, type ConditionalExpression, type ContainerAllowedChildren, type ContainerField, type ContainerFieldTypes, type CssWrapper, type CustomFnConfig, type CustomFunction, type CustomValidator, type CustomValidatorConfig, DF_FIELD_TEMPLATES, type DeclarativeHttpValidatorConfig, type DynamicFormActionRegistry, type DynamicFormAddonActionPresetRegistry, type DynamicFormAddonRegistry, type DynamicFormAddonSlotRegistry, DynamicFormError, type DynamicFormFieldRegistry, DynamicFormLogger, type DynamicText, type DynamicValue, type EvaluationContext, type ExtractField, type ExtractFieldDefs, type ExtractFormValue, type FieldBoundAddonActionContext, type FieldComponent, type FieldDef, type FieldMeta, type FieldOption, type FieldParkingOption, type FieldPathAccess, type FieldPlaceholderContext, type FieldPlaceholderInfo, type FieldRegistryContainers, type FieldRegistryLeaves, type FieldRegistryWrappers, type FieldWithValidation, type FieldWrapper, type FormConfig, type FormEvent, type FormEventConstructor, type FormMode, type FormModeDetectionResult, type FormOptions, type FormStateCondition, type GroupAllowedChildren, type GroupField, type HiddenField, type HiddenScalar, type HiddenValue, type HttpCondition, type HttpCustomValidator, type HttpRequestConfig, type HttpValidationResponseMapping, type InferFormValue, type InferWrapperRegistry, type InitialPageConfig, type LeafFieldTypes, type Logger, type LogicConfig, type NarrowField, type NarrowFields, type NextButtonOptions, NoopLogger, type OrphanAddonActionContext, type PageAllowedChildren, type PageField, type PageNavigationOptions, type PagerState, type RegisteredActionRef, type RegisteredFieldTypes, type ResolvedValidationExecutionConfig, type ResolvedValueExclusionConfig, type RowAllowedChildren, type RowErrorSpec, type RowField, type SanitizeFormConfigOptions, type SanitizedFormConfig, type SchemaApplicationConfig, type SchemaDefinition, type SimplifiedArrayField, type StateLogicConfig, type SubmissionActionResult, type SubmissionConfig, type SubmissionOutcome, type SubmissionReply, type SubmitButtonOptions, type TemplateAddon, type TextAddon, type TextElementType, type TextField, type TextProps, type TokenContext, type ValidationError, type ValidationExecutionConfig, type ValidationMessage, type ValidationMessageResolver, type ValidationMessages, type ValidatorConfig, type ValueExclusionConfig, type ValueFieldComponent, type ValueType, type WebMcpStatus, type WebMcpToolOptions, type WithInputSignals, type WrapperConfig, type WrapperRegistration, type WrapperTypeDefinition, type WrappersBundle, hasFormValue, isArrayField, isContainerField, isDisplayOnlyField, isFieldBoundContext, isFormStateCondition, isGroupField, isHiddenField, isLeafField, isPageField, isRowField, isSimplifiedArrayField, isValueBearingField, isWrapperTypeDefinition, resolveDynamicValue, rowError };

package/fesm2022/ng-forge-dynamic-forms-active-page-initialized.event-CiKN-mcc.mjs

@@ -1,12 +0,0 @@
-var ActivePageInitializedEvent = class {
-	pageIndex;
-	pageKey;
-	type = "active-page-initialized";
-	constructor(pageIndex, pageKey) {
-		this.pageIndex = pageIndex;
-		this.pageKey = pageKey;
-	}
-};
-export { ActivePageInitializedEvent as t };
-
-//# sourceMappingURL=ng-forge-dynamic-forms-active-page-initialized.event-CiKN-mcc.mjs.map

package/fesm2022/ng-forge-dynamic-forms-active-page-initialized.event-CiKN-mcc.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ng-forge-dynamic-forms-active-page-initialized.event-CiKN-mcc.mjs","names":[],"sources":["../../../../packages/dynamic-forms/src/lib/events/constants/active-page-initialized.event.ts"],"sourcesContent":["import { FormEvent } from '@ng-forge/dynamic-forms/internal';\n\n/** Emitted after the active page and all of its visible fields have rendered. */\nexport class ActivePageInitializedEvent implements FormEvent {\n  readonly type = 'active-page-initialized' as const;\n\n  constructor(\n    public readonly pageIndex: number,\n    public readonly pageKey: string,\n  ) {}\n}\n"],"mappings":"AAGA,IAAa,6BAAb,MAAuC;CAInB;CACA;CAJT,OAAO;CAEhB,YACkB,WACA,SAAe;EADf,KAAA,YAAA;EACA,KAAA,UAAA;CACf;AACJ"}