@vectoriox/iox-builder 4.7.0 → 4.9.0

package/index.d.ts

@@ -386,6 +386,8 @@ interface ComponentTrait {
     inline?: boolean;
     /** When set, this trait is hidden unless the named sibling trait has one of the specified values. */
     showWhen?: TraitShowCondition;
+    /** OPT-IN: may hold a different value per breakpoint (`responsive[bp].inputs`). See TraitConfig. */
+    responsive?: boolean;
 }
 type StyleTrait = ComponentTrait;
 interface StyleTraitGroup {
@@ -427,7 +429,17 @@ declare class TraitConfig {
     default?: any;
     inline?: boolean;
     showWhen?: TraitShowCondition;
-    constructor(name: string, label: string, type: TraitInputType, options?: string[] | TraitSelectOption[] | TraitOptionMap, defaultValue?: any, inline?: boolean, showWhen?: TraitShowCondition);
+    /**
+     * OPT-IN: this trait can hold a different value per breakpoint, stored in
+     * `ComponentNode.responsive[bp].inputs` and resolved by the shared `resolveInputs`.
+     *
+     * Opt-in rather than universal because most traits are not layout decisions — a slider's
+     * `loop` or a link's `target` has one answer at every width, and offering a breakpoint control
+     * on all 30 slider traits would bury the three that matter. Set it only where the value is
+     * genuinely a per-width layout choice (slidesPerView, limit, …).
+     */
+    responsive?: boolean;
+    constructor(name: string, label: string, type: TraitInputType, options?: string[] | TraitSelectOption[] | TraitOptionMap, defaultValue?: any, inline?: boolean, showWhen?: TraitShowCondition, responsive?: boolean);
 }
 
 declare class GroupStyleConfig {
@@ -1428,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",
@@ -1442,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;
@@ -1455,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),
@@ -1636,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. */

package/package.json

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