@vectoriox/iox-builder 4.5.0 → 4.6.0

package/index.d.ts

@@ -1464,6 +1464,45 @@ declare function auditNodes(nodes: readonly AuditNode[], viewportWidth: number):
 /** Counts per severity — the per-breakpoint summary strip. */
 declare function summarise(findings: readonly AuditFinding[]): Record<AuditSeverity, number>;
 
+/**
+ * LAYOUT PRESETS (B4) — the structures people build over and over, as one insert that is ALREADY
+ * responsive. A preset is a container plus children (Webflow's Quick Stack idea), not a new
+ * component type: what it inserts is ordinary nodes you can edit or take apart afterwards.
+ *
+ * The point is the `responsive` layers: a beginner gets a working phone layout without knowing what
+ * a breakpoint is, and an expert gets the boring part typed for them.
+ */
+interface LayoutPresetChildStyles {
+    [prop: string]: string;
+}
+interface LayoutPresetDef {
+    id: string;
+    name: string;
+    icon: string;
+    /** One line in the panel — what it is and what it does when it gets narrow. */
+    description: string;
+    /** Styles for the container itself, at base. */
+    container: LayoutPresetChildStyles;
+    /** Per-breakpoint container overrides — this is what makes the preset responsive. */
+    containerResponsive?: Partial<Record<Breakpoint, LayoutPresetChildStyles>>;
+    /** How many child containers to create. */
+    childCount: number;
+    /** Styles applied to every child at base. */
+    child?: LayoutPresetChildStyles;
+    /** Per-child, per-breakpoint overrides, by child index (e.g. reordering a split hero). */
+    childResponsive?: Array<Partial<Record<Breakpoint, LayoutPresetChildStyles>>>;
+}
+declare const LAYOUT_PRESETS: readonly LayoutPresetDef[];
+/** Set a style trait's value on a node built from a component config. */
+declare function setStyleTrait(node: ComponentNode, name: string, value: any): void;
+/**
+ * Build a preset's node tree. `createNode` makes an empty node of a type (the component registry in
+ * the builder) — passed in so this stays pure and testable.
+ *
+ * @returns the container node, or `null` when the container type can't be created.
+ */
+declare function buildLayoutPreset(def: LayoutPresetDef, createNode: (type: string) => ComponentNode | null): ComponentNode | null;
+
 interface BuilderClipboard {
     node?: ComponentNode;
     presetId?: string;
@@ -1576,6 +1615,14 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     breakpointCounts: BreakpointCounts;
     /** Deadline for swallowing the canvas click that completes an overlay action. */
     private _ignoreCanvasClickUntil;
+    /** The starting points offered on a blank page — the responsive layout presets. */
+    readonly starterLayouts: readonly LayoutPresetDef[];
+    /** A page with nothing on it yet: offer a structure instead of a blank canvas. */
+    get isPageEmpty(): boolean;
+    /** Insert a starter layout at the end of the page and select it. */
+    startWithLayout(def: LayoutPresetDef): void;
+    /** Open the components panel from the empty state. */
+    browseComponents(): void;
     /** Findings for the width being edited; the panel is open while `auditOpen`. */
     auditFindings: AuditFinding[];
     auditOpen: boolean;
@@ -2778,45 +2825,6 @@ declare function essentialTraitsFor(type: string | null | undefined): readonly s
  */
 declare function matchesControlSearch(name: string, label: string, term: string): boolean;
 
-/**
- * LAYOUT PRESETS (B4) — the structures people build over and over, as one insert that is ALREADY
- * responsive. A preset is a container plus children (Webflow's Quick Stack idea), not a new
- * component type: what it inserts is ordinary nodes you can edit or take apart afterwards.
- *
- * The point is the `responsive` layers: a beginner gets a working phone layout without knowing what
- * a breakpoint is, and an expert gets the boring part typed for them.
- */
-interface LayoutPresetChildStyles {
-    [prop: string]: string;
-}
-interface LayoutPresetDef {
-    id: string;
-    name: string;
-    icon: string;
-    /** One line in the panel — what it is and what it does when it gets narrow. */
-    description: string;
-    /** Styles for the container itself, at base. */
-    container: LayoutPresetChildStyles;
-    /** Per-breakpoint container overrides — this is what makes the preset responsive. */
-    containerResponsive?: Partial<Record<Breakpoint, LayoutPresetChildStyles>>;
-    /** How many child containers to create. */
-    childCount: number;
-    /** Styles applied to every child at base. */
-    child?: LayoutPresetChildStyles;
-    /** Per-child, per-breakpoint overrides, by child index (e.g. reordering a split hero). */
-    childResponsive?: Array<Partial<Record<Breakpoint, LayoutPresetChildStyles>>>;
-}
-declare const LAYOUT_PRESETS: readonly LayoutPresetDef[];
-/** Set a style trait's value on a node built from a component config. */
-declare function setStyleTrait(node: ComponentNode, name: string, value: any): void;
-/**
- * Build a preset's node tree. `createNode` makes an empty node of a type (the component registry in
- * the builder) — passed in so this stays pure and testable.
- *
- * @returns the container node, or `null` when the container type can't be created.
- */
-declare function buildLayoutPreset(def: LayoutPresetDef, createNode: (type: string) => ComponentNode | null): ComponentNode | null;
-
 /**
  * The text on the drop indicator's chip — "into Card grid · position 2 of 3" (B2).
  *

package/package.json

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