@vectoriox/iox-ui 4.27.0 → 4.29.0

package/forms-core/index.d.ts

@@ -202,5 +202,45 @@ declare function collectFormSpec(node: FormNodeLike | null | undefined): FormSpe
 /** Every Field in this subtree, in document order, not descending into a nested Form. */
 declare function collectFieldNodes(nodes: readonly FormNodeLike[]): FormNodeLike[];
 
-export { ControlType, DEFAULT_EN_MESSAGES, FIELD_NODE_TYPE, FORM_ERROR_KEYS, FORM_NODE_TYPE, FeedbackTiming, IMPLIED_PATTERN, MESSAGE_NAMESPACE, MULTI_VALUE_CONTROLS, PATTERN_MESSAGE_KEYS, PATTERN_PRESETS, PatternPreset, RULE_MESSAGE_KEYS, RuleName, STORE_ACTION, collectFieldNodes, collectFormSpec, deriveFieldName, firstInvalidField, uniqueFieldName, validateField, validateForm };
-export type { FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormResult, FormSpec, SubmitAction, ValidationRule };
+/** Everything the runtime needs to remember. Immutable — each transition returns a new state. */
+interface FormRuntimeState {
+    /** Field names the visitor has left (blurred) at least once. */
+    touched: ReadonlySet<string>;
+    /** True once a submit has been attempted — after that, every error is fair game. */
+    submitted: boolean;
+    /** The current errors, whether or not they are being shown. */
+    errors: Readonly<Record<string, FieldError>>;
+    /** In flight — the submit button shows its loading label and the form is aria-busy. */
+    submitting: boolean;
+}
+declare const INITIAL_FORM_STATE: FormRuntimeState;
+/**
+ * Should this field's error be on screen right now?
+ *
+ * - `Submit`  — only after a submit attempt. Quietest; nothing moves while typing.
+ * - `Live`    — as soon as it is invalid. Loudest; shouts at a half-typed email address.
+ * - `Smart`   — the default, and the reason the author gets one dropdown instead of a decision per
+ *               field: stay quiet until the visitor has either left the field or tried to submit.
+ *               After that, correct live, so fixing an error clears it as they type.
+ */
+declare function shouldShowError(fieldName: string, state: FormRuntimeState, timing?: FeedbackTiming | string): boolean;
+/**
+ * Re-validate one field after a change. Only that field is re-checked, EXCEPT that a `matches` rule
+ * makes another field's validity depend on this one — so a confirm-email field stops being wrong
+ * the moment you fix the address it points at, rather than waiting for its own blur.
+ */
+declare function onFieldChange(state: FormRuntimeState, fieldName: string, values: Record<string, unknown>, spec: FormSpec): FormRuntimeState;
+/** Mark a field touched (on blur) and re-check it, so Smart timing can start showing its error. */
+declare function onFieldBlur(state: FormRuntimeState, fieldName: string, values: Record<string, unknown>, spec: FormSpec): FormRuntimeState;
+/**
+ * A submit attempt. Validates everything and flips `submitted`, so from here on every error shows
+ * whatever the timing setting is — a visitor who pressed the button is owed the full picture.
+ */
+declare function onSubmitAttempt(state: FormRuntimeState, values: Record<string, unknown>, spec: FormSpec): FormRuntimeState;
+/** Server-side rejection: adopt the server's errors verbatim. It is the authority, not the client. */
+declare function applyServerErrors(state: FormRuntimeState, errors: Record<string, FieldError>): FormRuntimeState;
+/** A clean slate after a successful submit, for a form configured to clear itself. */
+declare function resetFormState(): FormRuntimeState;
+
+export { ControlType, DEFAULT_EN_MESSAGES, FIELD_NODE_TYPE, FORM_ERROR_KEYS, FORM_NODE_TYPE, FeedbackTiming, IMPLIED_PATTERN, INITIAL_FORM_STATE, MESSAGE_NAMESPACE, MULTI_VALUE_CONTROLS, PATTERN_MESSAGE_KEYS, PATTERN_PRESETS, PatternPreset, RULE_MESSAGE_KEYS, RuleName, STORE_ACTION, applyServerErrors, collectFieldNodes, collectFormSpec, deriveFieldName, firstInvalidField, onFieldBlur, onFieldChange, onSubmitAttempt, resetFormState, shouldShowError, uniqueFieldName, validateField, validateForm };
+export type { FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormResult, FormRuntimeState, FormSpec, SubmitAction, ValidationRule };

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { AfterViewInit, EventEmitter, ElementRef, SimpleChanges, OnDestroy, OnInit, Renderer2, ModuleWithProviders, InjectionToken, ChangeDetectorRef, ViewContainerRef, Type, ComponentRef } from '@angular/core';
+import { AfterViewInit, EventEmitter, ElementRef, SimpleChanges, OnDestroy, OnInit, Renderer2, ModuleWithProviders, InjectionToken, ChangeDetectorRef, ViewContainerRef, OnChanges, Type, ComponentRef } from '@angular/core';
 import { AnimationPlayer, AnimationBuilder } from '@angular/animations';
 import { Observable, Subject } from 'rxjs';
 import * as i3 from '@angular/platform-browser/animations';
@@ -875,9 +875,377 @@ declare class ClientGalleryComponent implements AfterViewInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<ClientGalleryComponent, "iox-gallery", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "effect": { "alias": "effect"; "required": false; }; "autoStart": { "alias": "autoStart"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "images": { "alias": "images"; "required": false; }; "showDuration": { "alias": "showDuration"; "required": false; }; "fadeDuration": { "alias": "fadeDuration"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+/** What the visitor actually types into. Chosen by a trait; it also implies a validation rule. */
+declare enum ControlType {
+    Text = "text",
+    Email = "email",
+    Tel = "tel",
+    Url = "url",
+    Number = "number",
+    Password = "password",
+    Textarea = "textarea",
+    Select = "select",
+    Checkbox = "checkbox",
+    Radio = "radio",
+    Date = "date",
+    Time = "time",
+    File = "file",
+    /** Not shown; carries a constant or a bound value (campaign, source page, …). */
+    Hidden = "hidden"
+}
+/** The v1 rule grammar. Phase 3's conditional logic reuses these same names for its conditions. */
+declare enum RuleName {
+    Required = "required",
+    MinLength = "minLength",
+    MaxLength = "maxLength",
+    Min = "min",
+    Max = "max",
+    Pattern = "pattern",
+    /** Cross-field: this value must equal another field's (confirm email / password). */
+    Matches = "matches",
+    /** A checkbox that must be ticked — terms, consent. */
+    Accepted = "accepted",
+    FileType = "fileType",
+    FileSize = "fileSize"
+}
+interface ValidationRule {
+    name: RuleName;
+    /** `{ n }` for lengths/bounds · `{ preset } | { regex }` for pattern · `{ field }` for matches. */
+    params?: Record<string, any>;
+    /** Author's override. Absent → the shared message catalog supplies a translated key. */
+    message?: string;
+}
+interface FieldOption {
+    label: string;
+    value: string;
+}
+/** Options pulled from a data source instead of typed by hand (a Select of CMS categories). */
+interface FieldOptionSource {
+    source: string;
+    sourcePath?: string;
+    valuePath: string;
+    labelPath: string;
+}
+interface FieldSpec {
+    /** The submitted key. Derived from the label, unique within the form, editable. */
+    name: string;
+    control: ControlType;
+    label: string;
+    /** Surfaced as its own switch in the panel rather than buried in the rule list. */
+    required?: boolean;
+    rules?: ValidationRule[];
+    options?: FieldOption[];
+    optionsSource?: FieldOptionSource;
+    defaultValue?: any;
+}
+/** When a field is validated, once the author has stopped deciding it per field. */
+declare enum FeedbackTiming {
+    /** Validate on submit, then live per-field once that field has been touched or has failed. */
+    Smart = "smart",
+    Submit = "submit",
+    Live = "live"
+}
+/** What happens to a submission, in order. Card #1 (`store`) is always present. */
+interface SubmitAction {
+    type: string;
+    config?: Record<string, any>;
+    /** `retry` (default) · `fail` · `ignore`. */
+    onFailure?: 'retry' | 'fail' | 'ignore';
+}
+interface FormSpec {
+    formId: string;
+    /** Author-facing name — the submissions inbox groups by it. */
+    name: string;
+    feedback: FeedbackTiming;
+    fields: FieldSpec[];
+    actions: SubmitAction[];
+    antiSpam: {
+        honeypot: boolean;
+        minFillMs: number;
+        turnstile?: boolean;
+    };
+    retention?: {
+        days: number;
+    };
+}
+
+interface FieldError {
+    /** i18n key, or the author's own override string when they set one. */
+    messageKey: string;
+    /** Interpolation values (`{ n: 8 }`, `{ field: 'Email' }`). */
+    params?: Record<string, any>;
+}
+
+/** Everything the runtime needs to remember. Immutable — each transition returns a new state. */
+interface FormRuntimeState {
+    /** Field names the visitor has left (blurred) at least once. */
+    touched: ReadonlySet<string>;
+    /** True once a submit has been attempted — after that, every error is fair game. */
+    submitted: boolean;
+    /** The current errors, whether or not they are being shown. */
+    errors: Readonly<Record<string, FieldError>>;
+    /** In flight — the submit button shows its loading label and the form is aria-busy. */
+    submitting: boolean;
+}
+
+/**
+ * How a message KEY becomes text a visitor reads.
+ *
+ * Translation belongs to the consumer, not the library: the CMS client has ngx-translate, the SSR
+ * engine has the page's locale bundle. Providing this token is how each one plugs its own in. The
+ * default below interpolates the built-in English strings, so a consumer that provides nothing
+ * still shows real sentences rather than raw keys.
+ */
+type FormMessageResolver = (key: string, params?: Record<string, any>) => string;
+/**
+ * Per-form runtime. **Provided by `IoxFormComponent`**, so every Field created into that form's
+ * `childrenHost` resolves THIS instance through its element injector — which is exactly how a field
+ * finds its form without a form-id, matching the ancestry rule (decision D1). A Field outside any
+ * form injects nothing and simply renders.
+ *
+ * All the decisions live in the pure `forms-core` runtime; this class only holds the mutable state,
+ * the registered fields and the Angular-shaped API. Nothing here decides *when* an error shows.
+ */
+declare class FormRuntimeService {
+    /** Registered fields, in DOM order — the order the spec and focus-first-invalid depend on. */
+    private readonly fields;
+    private _state;
+    private _spec;
+    private _timing;
+    get state(): FormRuntimeState;
+    get submitting(): boolean;
+    /** Set by the Form from its own traits. */
+    configure(spec: FormSpec, timing: FeedbackTiming | string): void;
+    /**
+     * A Field announces itself here on init. It passes FUNCTIONS rather than values so the runtime
+     * always reads the field's current spec and value — a trait edited on the canvas takes effect
+     * without re-registering anything.
+     */
+    register(field: {
+        spec: () => FieldSpec;
+        getValue: () => any;
+    }): () => void;
+    /** The live spec, derived from what is registered right now. */
+    specNow(): FormSpec;
+    /** Current values, keyed by submitted field name. */
+    values(): Record<string, any>;
+    onChange(name: string): void;
+    onBlur(name: string): void;
+    /** Validate everything. Returns whether the submission may proceed. */
+    validateAll(): boolean;
+    setSubmitting(submitting: boolean): void;
+    /** The server rejected it — its verdict replaces ours. */
+    applyErrors(errors: Record<string, FieldError>): void;
+    reset(): void;
+    /** Whether this field's error is allowed on screen right now. */
+    showsError(name: string): boolean;
+    errorFor(name: string): FieldError | undefined;
+    /** The first invalid field in registration (DOM) order — what submit should focus. */
+    firstInvalidName(): string | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormRuntimeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FormRuntimeService>;
+}
+
+/** Which of the form's four states the canvas / runtime is showing. */
+declare enum FormRenderState {
+    Idle = "idle",
+    Submitting = "submitting",
+    Success = "success",
+    Error = "error"
+}
+/**
+ * Directive-host Form: the real `<form>` IS the host — no wrapper, no inner/outer split. Children
+ * (fields, layout, the submit button, and the two state blocks) render into it via `childrenHost`.
+ *
+ * Scope is ANCESTRY, not naming (decision D1): a Field belongs to its nearest ancestor Form, so
+ * there is no form-id to pick and nothing to mis-wire. The runtime finds its fields by walking the
+ * DOM it owns.
+ *
+ * `renderState` drives which children are visible. In the builder it is set by the canvas state
+ * switcher so an author can DESIGN the success and error blocks; at runtime the same input is
+ * driven by the submit lifecycle. One mechanism, two drivers — the author designs exactly what a
+ * visitor will see.
+ *
+ * ⚠️ `novalidate` is deliberate: the browser's native bubbles would pre-empt our own messages,
+ * which are styleable, translated and announced. Validation still runs — ours does it.
+ */
+declare class IoxFormComponent implements OnChanges {
+    private readonly runtime;
+    private readonly host;
+    nodeId: string;
+    /** Stable id the submit endpoint resolves the saved spec by. */
+    formId: string;
+    /** Author-facing name — what the submissions inbox groups by. */
+    name: string;
+    renderState: FormRenderState | string;
+    feedback: FeedbackTiming | string;
+    /**
+     * Emitted ONLY when client-side validation passes, carrying the collected values. The host
+     * (builder canvas or engine runtime) owns the transport — posting, retries and the server's
+     * verdict — so the same component serves both renderers.
+     */
+    formSubmit: EventEmitter<{
+        values: Record<string, any>;
+        event: Event;
+    }>;
+    /** Emitted when a submit attempt was refused locally, so a host can react (analytics, focus). */
+    validationFailed: EventEmitter<Record<string, any>>;
+    childrenHost: ViewContainerRef;
+    /**
+     * Constructor injection rather than `inject()`, for the same reason as Field: this library's
+     * specs construct components directly. `runtime` is provided by THIS component (see
+     * `providers`), so every Field created into `childrenHost` resolves this instance by ancestry.
+     */
+    constructor(runtime: FormRuntimeService, host: ElementRef<HTMLElement>);
+    ngOnChanges(): void;
+    onSubmit(event: Event): void;
+    private focusFirstInvalid;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IoxFormComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFormComponent, "form[iox-form]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "renderState": { "alias": "renderState"; "required": false; }; "feedback": { "alias": "feedback"; "required": false; }; }, { "formSubmit": "formSubmit"; "validationFailed": "validationFailed"; }, never, never, false, never>;
+}
+
+/**
+ * The compound Field: label + control + help + error + required mark, as ONE node (decision D2).
+ *
+ * This is the biggest divergence from Webflow, and it is deliberate. There, a form field is four
+ * loose elements an author can delete — and they do delete the label, which breaks the
+ * `for`/`id` pairing and with it screen-reader support. Here the structure is fixed and
+ * accessibility is guaranteed by construction: the label can be visually hidden, never removed.
+ *
+ * The PARTS are styled through the virtual-trait mechanism (`__labelStyles`, `__errorStyles`, …)
+ * that already compiles `::marker` rules for List — so per-part styling invents no new concept in
+ * the style engine. Each part carries a stable class the compiler targets.
+ *
+ * ⚠️ Control type is a TRAIT, not a component per type (decision D4) — one component, one config,
+ * and choosing `email` also chooses email validation.
+ */
+declare class IoxFieldComponent implements OnInit, OnDestroy {
+    private readonly runtime;
+    private readonly resolveMessage;
+    nodeId: string;
+    /** The submitted key. Blank means "derive it from the label" — authors never invent keys. */
+    name: string;
+    label: string;
+    control: ControlType | string;
+    placeholder: string;
+    help: string;
+    required: boolean;
+    disabled: boolean;
+    labelHidden: boolean;
+    requiredMark: string;
+    rows: number;
+    accept: string;
+    options: FieldOption[];
+    value: any;
+    /** Rules beyond `required` — carried on the node, interpreted by forms-core. */
+    rules: ValidationRule[];
+    /**
+     * Forces the error appearance without a real failure — how the builder lets an author DESIGN
+     * the error state (decision D5). At runtime the state comes from the runtime service instead.
+     */
+    forceInvalid: boolean;
+    /** Placeholder shown while designing the error state, so the block has something to style. */
+    designErrorText: string;
+    /** Only after a successful check — never on an untouched field. */
+    showValid: boolean;
+    valueChange: EventEmitter<any>;
+    touched: EventEmitter<void>;
+    /** Stable per instance so `for`/`id` and `aria-describedby` always pair up. */
+    readonly controlId: string;
+    private unregister?;
+    /**
+     * Classic constructor injection, not `inject()`: this library's specs construct components
+     * directly (its vitest setup cannot run `TestBed.createComponent`), and a field initializer
+     * calling `inject()` throws NG0203 outside an injection context.
+     *
+     * `runtime` is optional because a Field dropped OUTSIDE any Form must still render — it simply
+     * has nothing to submit to. That is the same ancestry rule from the other side.
+     */
+    constructor(runtime: FormRuntimeService | null, resolveMessage: FormMessageResolver);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** The submitted key: the author's override, else derived from the label. */
+    get fieldName(): string;
+    /** Failing AND allowed to say so — or forced, while an author designs the state. */
+    get invalid(): boolean;
+    /** The message a visitor reads. Translation is the consumer's, via IOX_FORM_MESSAGES. */
+    get errorText(): string;
+    private toSpec;
+    /** `file`, `date`, `number`… map straight through; everything else is a text input. */
+    get inputType(): string;
+    /** Help and error are BOTH announced, in that order, when both are present. */
+    get describedBy(): string | null;
+    emit(value: any): void;
+    touch(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IoxFieldComponent, [{ optional: true; }, null]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFieldComponent, "div[iox-field]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "label": { "alias": "label"; "required": false; }; "control": { "alias": "control"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "help": { "alias": "help"; "required": false; }; "required": { "alias": "required"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "labelHidden": { "alias": "labelHidden"; "required": false; }; "requiredMark": { "alias": "requiredMark"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "options": { "alias": "options"; "required": false; }; "value": { "alias": "value"; "required": false; }; "rules": { "alias": "rules"; "required": false; }; "forceInvalid": { "alias": "forceInvalid"; "required": false; }; "designErrorText": { "alias": "designErrorText"; "required": false; }; "showValid": { "alias": "showValid"; "required": false; }; }, { "valueChange": "valueChange"; "touched": "touched"; }, never, never, false, never>;
+}
+
+/**
+ * Directive-host SubmitButton: the real `<button type="submit">` IS the host.
+ *
+ * It carries no destination configuration of its own — "what happens with the data" is an ordered
+ * action list on the FORM (decision D9), so there is nothing here to wire and nothing to get out of
+ * sync. The button owns only its own appearance and its busy state.
+ *
+ * While submitting it shows `loadingLabel` and is disabled, which is the whole double-submit
+ * defence on the client side (the server's rate limit is the real one).
+ */
+declare class IoxSubmitButtonComponent {
+    nodeId: string;
+    label: string;
+    loadingLabel: string;
+    disableWhileSubmitting: boolean;
+    /** Driven by the form's lifecycle, not by the author. */
+    submitting: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IoxSubmitButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxSubmitButtonComponent, "button[iox-submit]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "label": { "alias": "label"; "required": false; }; "loadingLabel": { "alias": "loadingLabel"; "required": false; }; "disableWhileSubmitting": { "alias": "disableWhileSubmitting"; "required": false; }; "submitting": { "alias": "submitting"; "required": false; }; }, {}, never, never, false, never>;
+}
+
+/**
+ * The Success and Error blocks — real, fully styleable container nodes that the Form auto-creates
+ * and the author cannot delete (decision D7). Hiding one is allowed; removing it is not, because
+ * "the author deleted the success block and the form went quiet" is Webflow's commonest form
+ * failure and we designed it out.
+ *
+ * ⚠️ VISIBILITY IS NOT AN INPUT. Which block shows is decided by CSS keyed on the parent form's
+ * `data-iox-state` attribute (see `iox-form-states.css` / the engine's `styles.scss`):
+ *
+ *     .iox-form-success { display: none }
+ *     .iox-form[data-iox-state="success"] .iox-form-success { display: block }
+ *
+ * That is deliberate. It means the builder's state switcher and the runtime's submit lifecycle
+ * drive the SAME mechanism through one attribute, with no input plumbing down the tree and no
+ * chance of the canvas and the live site disagreeing about what a visitor sees. The selector
+ * out-specifies `.iox-node-{id}`, so the state machine owns visibility and the author owns
+ * everything else about the block.
+ */
+declare class IoxFormSuccessComponent {
+    nodeId: string;
+    childrenHost: ViewContainerRef;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IoxFormSuccessComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFormSuccessComponent, "div[iox-form-success]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; }, {}, never, never, false, never>;
+}
+/**
+ * The Error block. One design, five reasons: the renderer writes the resolved reason text into
+ * `message`, so an author designs the block once and every failure mode (network, rejected, spam,
+ * rate-limited, server) renders through it.
+ *
+ * `role="alert"` rather than `status`: a failed submit must interrupt, because the visitor is
+ * about to walk away believing they sent it.
+ */
+declare class IoxFormErrorComponent {
+    nodeId: string;
+    /** Already-translated reason. Resolving the key is the host's job. */
+    message: string;
+    childrenHost: ViewContainerRef;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IoxFormErrorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFormErrorComponent, "div[iox-form-error]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "message": { "alias": "message"; "required": false; }; }, {}, never, never, false, never>;
+}
+
 declare class IoxBuilderComponentsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<IoxBuilderComponentsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<IoxBuilderComponentsModule, [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent], [typeof i2.CommonModule], [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<IoxBuilderComponentsModule, [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent, typeof IoxFormComponent, typeof IoxFieldComponent, typeof IoxSubmitButtonComponent, typeof IoxFormSuccessComponent, typeof IoxFormErrorComponent], [typeof i2.CommonModule], [typeof BuilderImageComponent, typeof BuilderSpacerComponent, typeof CardComponent, typeof BuilderDividerComponent, typeof BuilderIconComponent, typeof BuilderLinkComponent, typeof BuilderButtonComponent, typeof BuilderHeadingComponent, typeof TextBlockComponent, typeof SectionComponent, typeof ContainerComponent, typeof LinkedContainerComponent, typeof ClientRepeaterComponent, typeof ButtonBlockComponent, typeof ClientSliderContainerComponent, typeof ClientSliderSlideComponent, typeof ClientListComponent, typeof ClientListItemComponent, typeof ClientGalleryComponent, typeof IoxFormComponent, typeof IoxFieldComponent, typeof IoxSubmitButtonComponent, typeof IoxFormSuccessComponent, typeof IoxFormErrorComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<IoxBuilderComponentsModule>;
 }
 
@@ -2002,5 +2370,5 @@ declare class GalleryLoop {
     private emit;
 }
 
-export { AOSService, AnalyticsService, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, ContextStore, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, DeclarationContext, ENVIRONMENT, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxPageComponent, IoxPageModule, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_RESPONSIVE_TRAITS, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, effectiveTransitionId, excludeSelf, feelFor, getByPath, initialSlotValues, isActionEnabled, isContextAction, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, normalizeGalleryImage, parentBreakpoint, parseUrlList, planDataSource, planResponsiveRules, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveValueChain, rewriteViewportUnits, safeSetInput, setInputOverride, setOverride, stateNamesIn, stripSuppressedProps, styleKeyToKebab, variableAliases, variableItemsFrom, withContextSlots, wrapInBreakpointQuery, wrapInMediaQuery };
+export { AOSService, AnalyticsService, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CMSClientInfraModule, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ConsentService, ContainerComponent, ContentService, ContextStore, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_WIDTH_BY_TYPE, DeclarationContext, ENVIRONMENT, FormRenderState, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PrivacyModalComponent, PrivacyModalService, PrivacyModelEvent, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_RESPONSIVE_TRAITS, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, WebSettingsService, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, effectiveTransitionId, excludeSelf, feelFor, getByPath, initialSlotValues, isActionEnabled, isContextAction, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, normalizeGalleryImage, parentBreakpoint, parseUrlList, planDataSource, planResponsiveRules, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveValueChain, rewriteViewportUnits, safeSetInput, setInputOverride, setOverride, stateNamesIn, stripSuppressedProps, styleKeyToKebab, variableAliases, variableItemsFrom, withContextSlots, wrapInBreakpointQuery, wrapInMediaQuery };
 export type { BreakpointDef, BuildRelatedFilterOptions, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSpec, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, IoxContextSlot, IoxPipe, OverrideBreakpoint, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, RelativeInputs, RelativeSourceKind, RelativeSourceSpec, ResolveSiblingsOptions, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteContext, SetContextParams, SiblingsResult, StateStyleMap, StyleMap, StyleTreeNode, SwiperBreakpointMap, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, ValueSource, VirtualTraitGroup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "4.27.0",
+  "version": "4.29.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",