@vectoriox/iox-builder 4.8.0 → 4.10.0

package/index.d.ts

@@ -1440,7 +1440,11 @@ declare enum AuditCode {
     FixedWidth = "fixed-width",
     TapTarget = "tap-target",
     TinyText = "tiny-text",
-    UnboundedImage = "unbounded-image"
+    UnboundedImage = "unbounded-image",
+    /** A slider showing more slides than the width can carry — each one unreadably narrow. */
+    SlidesOverflow = "slides-overflow",
+    /** An out-of-flow node whose box lands outside the frame, so it is unreachable at this width. */
+    OffscreenAbsolute = "offscreen-absolute"
 }
 declare enum AuditSeverity {
     Error = "error",
@@ -1454,9 +1458,15 @@ interface AuditNode {
     label?: string;
     /** Styles RESOLVED at this breakpoint (base + every wider layer + this one). */
     styleProps: StyleMap;
+    /** Component TRAITS resolved at this breakpoint — the per-width values a media query cannot
+     *  express (a slider's `slidesPerView`). Absent for nodes with no traits worth auditing. */
+    inputs?: Record<string, any>;
     /** Laid-out size in CSS px at this width. */
     width: number;
     height: number;
+    /** Laid-out position in CSS px, relative to the canvas frame. Absent when not measured. */
+    left?: number;
+    top?: number;
 }
 interface AuditFinding {
     nodeId: string;
@@ -1467,6 +1477,9 @@ interface AuditFinding {
     message: string;
     /** Props to write into this breakpoint's layer to repair it; absent when no safe auto-fix. */
     fix?: StyleMap;
+    /** TRAIT values to write into this breakpoint's layer — some failures are not fixable with CSS.
+     *  Applied through `setInputOverride`, the trait twin of `setOverride`. */
+    inputFix?: Record<string, any>;
 }
 /**
  * Audit nodes laid out at `viewportWidth`. Returns findings ordered by severity (errors first),
@@ -1648,6 +1661,8 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
      * `utils/responsive-audit.util.ts`.
      */
     runAudit(): void;
+    /** The node's OWN trait values — the Base layer the responsive `inputs` cascade sits on top of. */
+    private baseInputMapOf;
     /** Apply one finding's fix into the current breakpoint's layer (or the base styles at Base). */
     applyAuditFix(finding: AuditFinding): void;
     /** Apply every fixable finding, then re-measure. */
@@ -2884,6 +2899,48 @@ declare class GalleryConfig extends ComponentConfig {
     constructor();
 }
 
+/**
+ * Form — the container that scopes its fields by ANCESTRY (decision D1).
+ *
+ * The destination config ("After submit") is an ordered action list edited in the Bindings panel as
+ * a property group, not here as flat traits — see forms-and-inputs-plan.md §4b. What lives here is
+ * the handful of settings that ARE single values.
+ *
+ * Auto-creates a working contact form: two fields, a submit button, and the two non-deletable state
+ * blocks. Dropping a Form therefore gives a form that already validates and already stores.
+ */
+declare class FormComponentConfig extends ComponentConfig {
+    constructor();
+}
+/**
+ * Field — ONE component for every control type (decision D4).
+ *
+ * `Required` is its own switch because it is the rule every form needs; the rest are added from a
+ * menu, so an unused rule is invisible rather than an empty control (the Effects-group pattern).
+ */
+declare class FieldComponentConfig extends ComponentConfig {
+    constructor();
+}
+/** A plain layout row so two fields can sit side by side. Config-only, like List/ListItem. */
+declare class FieldGroupComponentConfig extends ComponentConfig {
+    constructor();
+}
+/** The submit button. Carries no destination — that lives on the Form (decision D9). */
+declare class SubmitButtonComponentConfig extends ComponentConfig {
+    constructor();
+}
+/**
+ * The Success block. `hidden` keeps it out of the Components panel: it is auto-created by the Form
+ * and reached through the canvas state switcher, never dropped on its own.
+ */
+declare class FormSuccessComponentConfig extends ComponentConfig {
+    constructor();
+}
+/** The Error block. One design, five reasons — the renderer writes the resolved reason in. */
+declare class FormErrorComponentConfig extends ComponentConfig {
+    constructor();
+}
+
 declare class BuilderHeadingComponentConfig extends ComponentConfig {
     constructor();
 }
@@ -2937,5 +2994,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DataSourceRegistryService, DataSourceType, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, GalleryConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SymbolRegistryService, TARGETED_STATES, TARGETED_STATE_BASE, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildFullStyleTraits, buildLayoutPreset, buildPresetStyleTraits, canFluidise, collapseColumnsProps, columnCountOf, defaultPageSettings, dropTargetLabel, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, isHiddenAt, matchesControlSearch, nodeAncestorPath, nodeAncestorPathInEither, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, setStyleTrait, stackChildrenProps, summarise, visibilityProps, wrapNode };
+export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DataSourceRegistryService, DataSourceType, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, FieldComponentConfig, FieldGroupComponentConfig, FormComponentConfig, FormErrorComponentConfig, FormSuccessComponentConfig, GalleryConfig, GroupStyleConfig, INTERACTION_STATES, INVERSE_ACTION, IOX_DATA_SOURCE_ENDPOINTS, IOX_FONT_MANAGER, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SubmitButtonComponentConfig, SymbolRegistryService, TARGETED_STATES, TARGETED_STATE_BASE, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildFullStyleTraits, buildLayoutPreset, buildPresetStyleTraits, canFluidise, collapseColumnsProps, columnCountOf, defaultPageSettings, dropTargetLabel, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, isHiddenAt, matchesControlSearch, nodeAncestorPath, nodeAncestorPathInEither, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, setStyleTrait, stackChildrenProps, summarise, visibilityProps, wrapNode };
 export type { AuditFinding, AuditNode, BreakpointPresentation, BuilderClipboard, ComponentEventDef, ComponentMethodDef, ComponentNode, ComponentTrait, Crumb, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, HistoryEntry, InsertTarget, InteractionAction, InteractionActionType, InteractionPreset, InteractionTrigger, IoxBinding, IoxDataSource, IoxDropEvent, IoxFontManager, IoxInteraction, IoxSymbol, LayoutPresetChildStyles, LayoutPresetDef, NodeRef, OverlayBoxModel, OverlayBoxSpacing, OverlayEntry, PageRouteAnimationSettings, PageScrollSettings, PageSettings, PageStyleSettings, PanelEvent, QuadSizeSegment, RouteAnimationPreset, ScreenWidthOption, SelectionBadge, StyleMap, StylePreset, StyleTrait, StyleTraitGroup, TraitOptionMap, TraitSelectOption, TraitShowCondition, TreePathNode, ViewportState, ZoomOption };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-builder",
-  "version": "4.8.0",
+  "version": "4.10.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",