@vectoriox/iox-builder 9.1.0 → 9.3.0

package/index.d.ts

@@ -20,6 +20,7 @@ import * as i27 from 'primeng/select';
 import * as i28 from 'primeng/tooltip';
 import * as i29 from 'primeng/dialog';
 import { FormPresetDef } from '@vectoriox/iox-ui/forms-core';
+import { CompositeNodeFactory, CompositeNode } from '@vectoriox/iox-ui/composite-core';
 
 declare enum StyleCategory {
     Layout = "Layout",
@@ -240,7 +241,7 @@ interface InteractionPreset {
     name: string;
     interactions: IoxInteraction[];
 }
-type ElementState = 'hover' | 'active' | 'focus' | 'first-child' | 'last-child' | 'nth-child(odd)' | 'nth-child(even)' | 'parent-hover' | 'trigger-hover' | 'wrong' | 'accepted';
+type ElementState = 'hover' | 'active' | 'focus' | 'first-child' | 'last-child' | 'nth-child(odd)' | 'nth-child(even)' | 'parent-hover' | 'trigger-hover' | 'wrong' | 'accepted' | 'current';
 /** Interaction pseudo-classes — compiled to .iox-node-{id}:state */
 declare const INTERACTION_STATES: ElementState[];
 /** Structural pseudo-classes — compiled to .iox-outer-{id}:state */
@@ -364,6 +365,13 @@ interface ComponentNode {
      * (DS7) and the AI composer.
      */
     elementStyle?: string;
+    /**
+     * The part this node plays in a composite (`card.title`, `nav.drawer` — composite-components plan §3;
+     * composite-core in `@vectoriox/iox-ui`). Saved; read by the shared CSS (`iox-role-<role>` through
+     * `nodeDesignClasses`), the structure guard (a locked part is never deleted or moved out) and the
+     * composite's editors. A navigation's roles are written by the composer and `planNavShape` (CC1).
+     */
+    role?: string;
 }
 /**
  * Build a full StyleTraitGroup[] schema populated with values from a flat
@@ -827,6 +835,56 @@ declare class FormStateService {
     static ɵprov: i0.ɵɵInjectableDeclaration<FormStateService>;
 }
 
+/** What a hidden-at-rest part shows on the canvas when the author picks it in "Showing on canvas". */
+declare enum CanvasShowState {
+    Closed = "closed",
+    Open = "open"
+}
+interface CanvasDesignSnapshot {
+    /** Hidden-at-rest parts the current SELECTION sits in (or is): shown while selected. */
+    revealed: ReadonlySet<string>;
+    /** "Showing on canvas" choices, by the part's node id. */
+    shown: ReadonlyMap<string, CanvasShowState>;
+}
+/**
+ * The canvas's DESIGN state (complex-components R2; composite plan §5a's CompositeDesignStateService,
+ * started here for the navigation and reused by Accordion in CC2): which parts that are hidden at rest
+ * — a closed drawer today, a collapsed panel or an inactive tab next — the canvas shows right now.
+ *
+ * Two sources, the Dialog's "selection is the reveal" and the Form's switcher, generalised:
+ * - **the selection** — selecting anything inside a hidden part (tree, breadcrumb, an Items row,
+ *   SELECT_NODE) shows it; deselecting hides it again (`setSelectionPath`);
+ * - **"Showing on canvas"** — the Bindings panel's switcher, for the one case a selection cannot express:
+ *   the page with the menu open while a part OUTSIDE it is selected (`setShown`).
+ *
+ * Canvas-only: never saved, never a history step. Also carries the canvas page's path, so a link to the
+ * page being edited renders as the current page (N2) — the same decision the live site makes.
+ */
+declare class CanvasDesignStateService {
+    private readonly _state$;
+    readonly state$: rxjs.Observable<CanvasDesignSnapshot>;
+    private readonly _pagePath$;
+    /** The app path of the page on the canvas (`/work`), or null when unknown. */
+    readonly pagePath$: rxjs.Observable<string | null>;
+    get snapshot(): CanvasDesignSnapshot;
+    get pagePath(): string | null;
+    setPagePath(path: string | null | undefined): void;
+    /** The selection moved: the hidden-at-rest parts on its path are revealed, every other one is not. */
+    setSelectionPath(path: ReadonlyArray<ComponentNode>): void;
+    /** The switcher's choice for one part (null = back to the saved default). */
+    setShown(nodeId: string, state: CanvasShowState | null): void;
+    /** The switcher's current choice for one part. */
+    shownState(nodeId: string | null | undefined): CanvasShowState;
+    /** True when the canvas shows the part: selected into, or switched open. */
+    isShown(nodeId: string | null | undefined): boolean;
+    /** True when the part is shown only because the selection is inside it (the switcher's hint line). */
+    isRevealedBySelection(nodeId: string | null | undefined): boolean;
+    /** A new page on the canvas: nothing is revealed or switched open. */
+    reset(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CanvasDesignStateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CanvasDesignStateService>;
+}
+
 declare enum PanelEventTypes {
     ELEMENT_SELECT = "elementselect",
     ELEMENT_DESELECT = "elementdeselect",
@@ -872,7 +930,12 @@ declare enum PanelEventTypes {
      *  "what's selected" stay stale unless the SAME `_emitElementSelect` a real canvas click goes
      *  through also runs. This event is that path for code outside `BuilderComponent` itself,
      *  mirroring what `onTreeNodeSelect`/`onCrumbSelect` already do internally. */
-    SELECT_NODE = "selectnode"
+    SELECT_NODE = "selectnode",
+    /** A panel rewrote a node's SUBTREE in place — its children (a Card's Parts), its layout styles (Card ▸
+     *  Layout), a part's element style or scheme. Carries `{ node }`. The builder re-renders the subtree,
+     *  re-registers every node's rules and design classes, refreshes a Repeater holding it, and records ONE
+     *  undo step (LAYOUT_CHANGED). */
+    NODE_STRUCTURE_CHANGED = "nodestructurechanged"
 }
 interface PanelEvent {
     type: PanelEventTypes;
@@ -958,6 +1021,8 @@ declare const defaultBuilderLabels: BuilderLabelResolver;
  * in one go rather than discovering keys one missing label at a time.
  */
 declare const BUILDER_CHROME_EN: Readonly<Record<string, string>>;
+/** The layer tree's eye-slash title on a part hidden at rest (a closed drawer, R2). */
+declare const HIDDEN_AT_REST_LABEL_KEY = "builder.chrome.hiddenAtRest";
 declare const CANVAS_EMPTY_IMAGE_LABEL_KEY = "builder.chrome.addImage";
 declare const CANVAS_EMPTY_IMAGE_LABEL_EN: string;
 /**
@@ -979,7 +1044,12 @@ declare enum InsertRefusal {
     StateBlockAlone = "stateBlockAlone",
     /** Form content inside a link or a button (Doron, 2026-10-20) — HTML forbids interactive content in
      *  `<a>`/`<button>`, and a click in a field would follow the link. The table is forms-core's. */
-    FormInInteractive = "formInInteractive"
+    FormInInteractive = "formInInteractive",
+    /** A composite's LOCKED part (a card's Title or Content column) moved out of its own parent — the
+     *  structure guard (composite-core `structureRefusal`). Reordering inside the parent never asks. */
+    LockedPartMove = "lockedPartMove",
+    /** A composite's LOCKED part deleted (Delete key, toolbar, layer tree, Make global): refused. */
+    LockedPart = "lockedPart"
 }
 declare const FORM_STATE_BLOCK_TYPES: ReadonlySet<string>;
 /** The builder-chrome label that says each refusal on screen (English in `BUILDER_CHROME_EN`). */
@@ -988,6 +1058,7 @@ declare const INSERT_REFUSAL_LABEL_KEYS: Readonly<Record<InsertRefusal, string>>
 declare function insertRefusalLabel(reason: InsertRefusal, labels?: BuilderLabelResolver): string;
 interface TypedNode {
     type?: string;
+    role?: string | null;
     children?: TypedNode[] | null;
 }
 /**
@@ -997,6 +1068,9 @@ interface TypedNode {
  * never asks.
  */
 declare function insertRefusal(node: TypedNode | null | undefined, ancestors: readonly TypedNode[]): InsertRefusal | null;
+/** Why `node` may not be REMOVED from where it is (deleted, cut, made global), or null when it may: a
+ *  composite's locked part stays — its Parts switch or deleting the whole composite are the ways out. */
+declare function removalRefusal(node: TypedNode | null | undefined): InsertRefusal | null;
 
 /**
  * SymbolRegistryService — in-memory store for org-level symbols.
@@ -1043,7 +1117,7 @@ interface InsertRefusedEvent {
     message: string;
 }
 /** The node a drop target names: canvas-root ancestors outermost first, the dropzone's own node last. */
-type AncestorNode = Pick<ComponentNode, 'type' | 'children'>;
+type AncestorNode = Pick<ComponentNode, 'type' | 'children' | 'role'>;
 /** On the drop-target overlay while the target refuses the dragged payload (styled by the host). */
 declare const DROP_REFUSED_CLASS = "iox-drop-target-overlay--refused";
 declare class DragEngineService {
@@ -1059,6 +1133,11 @@ declare class DragEngineService {
      * under `ancestors`; otherwise the refusal, already announced on `insertRefused$`.
      */
     refuseInsert(data: unknown, ancestors: readonly AncestorNode[]): InsertRefusal | null;
+    /**
+     * The ONE check every REMOVAL asks (Delete key, toolbar, layer tree, Make global): null when `node` may
+     * leave its place; otherwise the refusal, announced on `insertRefused$` like any other.
+     */
+    refuseRemoval(node: unknown): InsertRefusal | null;
     /** The node a payload WOULD insert, without building it: a type string, a block/symbol, or a node. */
     private payloadNode;
     /** The nodes a dropzone sits in, outermost first, its own node last — read from the DOM, which is
@@ -1546,9 +1625,9 @@ declare class InteractionEngineService {
      * element's own attach() fires.
      */
     private pendingPreStates;
-    /** Action types that animate an element from hidden → visible. */
+    /** Action types that animate an element from hidden → visible / visible → hidden — the SHARED sets
+     *  (@vectoriox/iox-ui), the same ones the live site's runtime reads. */
     private readonly ENTRANCE_TYPES;
-    /** Action types that animate an element from visible → hidden. */
     private readonly EXIT_TYPES;
     private readonly SWIPER_ACTIONS;
     private instanceRegistry;
@@ -1615,6 +1694,10 @@ declare class InteractionEngineService {
     private executeSwiperAction;
     private resolveTarget;
     private executeAction;
+    /** What an element is left as once an action is done: a revealed one interactive, a hidden one inert. */
+    private settleAfter;
+    /** Write a frame inline. On the canvas never a transform: one inside the scaled page breaks Lenis. */
+    private applyFrame;
     /**
      * Freeze an element at the animation's starting frame immediately, before any
      * trigger fires. Called for ALL entrance-type actions regardless of trigger so
@@ -1628,7 +1711,8 @@ declare class InteractionEngineService {
     private applyPreState;
     private clearInlineAnimationStyles;
     private reverseAction;
-    private buildAnimation;
+    /** The action's keyframes from the ONE shared table both runtimes animate from (composite T2). */
+    private keyframesFor;
     static ɵfac: i0.ɵɵFactoryDeclaration<InteractionEngineService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<InteractionEngineService>;
 }
@@ -1784,7 +1868,9 @@ declare enum AuditCode {
     /** An out-of-flow node whose box lands outside the frame, so it is unreachable at this width. */
     OffscreenAbsolute = "offscreen-absolute",
     /** Form content inside a link or a button — a STRUCTURE finding, true at every width (form-nesting-audit.util). */
-    FormInLink = "form-in-link"
+    FormInLink = "form-in-link",
+    /** An icon-only button or link with no Accessible name — announced as an unnamed control (CC1 N6). */
+    UnnamedControl = "unnamed-control"
 }
 /** A fix that changes the tree, not a style or a trait — applied as one page-history step. */
 declare enum StructureFix {
@@ -1812,6 +1898,8 @@ interface AuditNode {
     /** Laid-out position in CSS px, relative to the canvas frame. Absent when not measured. */
     left?: number;
     top?: number;
+    /** It shows only an icon and has no Accessible name (the shared `needsAccessibleName`). */
+    unnamedControl?: boolean;
 }
 interface AuditFinding {
     nodeId: string;
@@ -1927,6 +2015,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private dsRegistry;
     private viewportService;
     private formStateService;
+    private canvasDesignState;
     private interactionEngine;
     private interactionPresetRegistry;
     private clipboard;
@@ -1955,6 +2044,8 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     pageStatus: string;
     pageSettings: PageSettings | null;
     globalElements: ComponentNode[];
+    /** The app path of the page on the canvas (`/work`): its links render as the current page (CC1 N2). */
+    pagePath: string;
     canUndo: boolean;
     canRedo: boolean;
     /** Feature flag: drive drag/select/resize via Moveable + Selecto instead of interact.js.
@@ -2024,8 +2115,17 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     applyAuditFix(finding: AuditFinding): void;
     /** Apply every fixable finding, then re-measure. */
     applyAllAuditFixes(): void;
+    /** The canvas reserve for a bottom bar among the globals (the same class the live site keys on). */
+    refreshCanvasBarReserve(): void;
     /** Select the node a finding is about. */
     selectAuditNode(finding: AuditFinding): void;
+    /**
+     * Run `select` with the node's rendered ref — at once when it is on the canvas, else after REVEALING
+     * the part hidden at rest it sits in (R2, CC1: a link inside the closed drawer, picked from the layer
+     * tree, the breadcrumb or an Items row). The selection path is set first, which shows the drawer
+     * through the canvas design state; its children render on the next pass, and the selection lands.
+     */
+    private _withNodeRef;
     /** A node's full base style map, flattened from its styleTraits. */
     private baseStyleMapOf;
     private findNodeById;
@@ -2059,6 +2159,9 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
      *  the site global elements sit inside <body> and inherit it; on the canvas they are a sibling
      *  layer of the page, so they get it explicitly. Never the background (it would cover the page). */
     globalLayerCss: Record<string, string>;
+    /** The page reserves a bottom bar's height on the canvas where the bar shows (CC1 R1) — design-core's
+     *  `barReserveClass` of the bar among the globals, or null. A field, recomputed when globals change. */
+    canvasBarReserve: string | null;
     /** Canvas frame height in canvas-space pixels (= previewScroll.clientHeight / scale).
      *  Used as iox-page-component's height so position:fixed top:0;bottom:0 fills the
      *  same area as height:100vh (both resolve to this value). */
@@ -2101,7 +2204,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     get canvasMinHeight(): number;
     private sub?;
     private registrySub?;
-    constructor(registry: ComponentRegistryService, overlayService: OverlayService, panelEventService: PanelEventService, dragEngine: DragEngineService, dsRegistry: DataSourceRegistryService, viewportService: ViewportService, formStateService: FormStateService, interactionEngine: InteractionEngineService, interactionPresetRegistry: InteractionPresetRegistryService, clipboard: BuilderClipboardService, symbolRegistry: SymbolRegistryService, cdr: ChangeDetectorRef, appRef: ApplicationRef, moveableCanvas: MoveableCanvasService, selectoCanvas: SelectoCanvasService, styleRegistry: StyleRegistryService);
+    constructor(registry: ComponentRegistryService, overlayService: OverlayService, panelEventService: PanelEventService, dragEngine: DragEngineService, dsRegistry: DataSourceRegistryService, viewportService: ViewportService, formStateService: FormStateService, canvasDesignState: CanvasDesignStateService, interactionEngine: InteractionEngineService, interactionPresetRegistry: InteractionPresetRegistryService, clipboard: BuilderClipboardService, symbolRegistry: SymbolRegistryService, cdr: ChangeDetectorRef, appRef: ApplicationRef, moveableCanvas: MoveableCanvasService, selectoCanvas: SelectoCanvasService, styleRegistry: StyleRegistryService);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
@@ -2217,6 +2320,9 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     /** If `node` lives inside a Repeater template, tell that repeater to rebuild its preview rows so
      *  a structural change (e.g. wrapping a template child) propagates to every repeated row. No-op
      *  when the node is not inside a repeater. */
+    /** NODE_STRUCTURE_CHANGED: the subtree's children render (CD), then every node's rules, classes and
+     *  inputs are re-applied (a moved node's rule may have been dropped by its old host's teardown). */
+    private applyStructureChange;
     private _refreshRepeaterFor;
     /**
      * Emit ELEMENT_SELECT with the ancestors the panels need (symbol + repeater item scope).
@@ -2238,7 +2344,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private readNodeDisplay;
     private handlePanelEvents;
     static ɵfac: i0.ɵɵFactoryDeclaration<BuilderComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BuilderComponent, "app-builder", never, { "layout": { "alias": "layout"; "required": false; }; "dataSources": { "alias": "dataSources"; "required": false; }; "orgId": { "alias": "orgId"; "required": false; }; "routeParams": { "alias": "routeParams"; "required": false; }; "pageName": { "alias": "pageName"; "required": false; }; "isSaving": { "alias": "isSaving"; "required": false; }; "pageStatus": { "alias": "pageStatus"; "required": false; }; "pageSettings": { "alias": "pageSettings"; "required": false; }; "globalElements": { "alias": "globalElements"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "moveableMode": { "alias": "moveableMode"; "required": false; }; }, { "save": "save"; "undo": "undo"; "redo": "redo"; "back": "back"; "preview": "preview"; "publishToggle": "publishToggle"; "pageSettingsChange": "pageSettingsChange"; "applyAnimationToAll": "applyAnimationToAll"; "saveBlock": "saveBlock"; "globalElementsChange": "globalElementsChange"; }, never, ["[builderPages]", "[builderComponents]", "[builderTokens]", "[builderToolbarActions]", "[builderPanel]"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BuilderComponent, "app-builder", never, { "layout": { "alias": "layout"; "required": false; }; "dataSources": { "alias": "dataSources"; "required": false; }; "orgId": { "alias": "orgId"; "required": false; }; "routeParams": { "alias": "routeParams"; "required": false; }; "pageName": { "alias": "pageName"; "required": false; }; "isSaving": { "alias": "isSaving"; "required": false; }; "pageStatus": { "alias": "pageStatus"; "required": false; }; "pageSettings": { "alias": "pageSettings"; "required": false; }; "globalElements": { "alias": "globalElements"; "required": false; }; "pagePath": { "alias": "pagePath"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "moveableMode": { "alias": "moveableMode"; "required": false; }; }, { "save": "save"; "undo": "undo"; "redo": "redo"; "back": "back"; "preview": "preview"; "publishToggle": "publishToggle"; "pageSettingsChange": "pageSettingsChange"; "applyAnimationToAll": "applyAnimationToAll"; "saveBlock": "saveBlock"; "globalElementsChange": "globalElementsChange"; }, never, ["[builderPages]", "[builderComponents]", "[builderTokens]", "[builderToolbarActions]", "[builderPanel]"], false, never>;
 }
 
 /**
@@ -2283,6 +2389,7 @@ declare class RenderDirective implements OnInit, OnDestroy {
     private childSubs;
     private readonly onCanvas;
     private readonly labels;
+    private readonly designState;
     /** Host element drag was registered on (collapsed path) — unregistered on destroy. */
     private hostDragEl;
     constructor(vcr: ViewContainerRef, injector: Injector, envInjector: EnvironmentInjector, doc: Document, registryService: ComponentRegistryService, overlayService: OverlayService, styleRegistry: StyleRegistryService, interactionEngine: InteractionEngineService, cdr: ChangeDetectorRef, panelEventService: PanelEventService, dragEngine: DragEngineService);
@@ -2311,6 +2418,9 @@ declare class RenderDirective implements OnInit, OnDestroy {
      *  isn't in the DOM yet (caller then skips rather than clobbering the existing rule). */
     private resolveTargetedScopeId;
     private findParentNodeElement;
+    /** A link's target as the canvas shows it: the page route, else its URL. */
+    private canvasHref;
+    private syncA11y;
     private render;
     static ɵfac: i0.ɵɵFactoryDeclaration<RenderDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<RenderDirective, "[ioxRender]", never, { "ioxRender": { "alias": "ioxRender"; "required": false; }; "ioxDragSourceId": { "alias": "ioxDragSourceId"; "required": false; }; }, { "onClick": "onClick"; "onMouseEnter": "onMouseEnter"; "onMouseLeave": "onMouseLeave"; }, never, never, false, never>;
@@ -2436,7 +2546,7 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     private boundUpdate;
     private boundScrollUpdate;
     private activeScrollContainer;
-    constructor(elRef: ElementRef<HTMLElement>, instanceRegistry: ComponentInstanceRegistryService, overlayService: OverlayService, viewportService: ViewportService, presetRegistry: PresetRegistryService, symbolRegistry: SymbolRegistryService, interactionPresetRegistry: InteractionPresetRegistryService, interactionEngine: InteractionEngineService, clipboard: BuilderClipboardService, styleRegistry: StyleRegistryService, panelEventService: PanelEventService, cdr: ChangeDetectorRef, dragEngine: DragEngineService);
+    constructor(elRef: ElementRef<HTMLElement>, instanceRegistry: ComponentInstanceRegistryService, overlayService: OverlayService, viewportService: ViewportService, presetRegistry: PresetRegistryService, symbolRegistry: SymbolRegistryService, interactionPresetRegistry: InteractionPresetRegistryService, interactionEngine: InteractionEngineService, clipboard: BuilderClipboardService, styleRegistry: StyleRegistryService, panelEventService: PanelEventService, cdr: ChangeDetectorRef, dragEngine: DragEngineService, labels?: BuilderLabelResolver | null);
     /** Resolves the selected node's OWNING dropzone id dynamically — the drag-handle isn't
      *  rendered inside any container (it's overlay chrome), so it has no source id of its own. */
     get dragHandleSourceId(): string | null;
@@ -2460,6 +2570,9 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     onRemoveGlobal(event: MouseEvent): void;
     get hasInteractions(): boolean;
     get selectedNodeIsGlobal(): boolean;
+    private readonly builderLabels;
+    /** A composite part's kind + role under the selection (board 3/8 "Selection kind badge"), or null. */
+    get selectedRoleBadge(): string | null;
     get selectedPresetName(): string | null;
     get isLinkedSymbol(): boolean;
     get isDetachedSymbol(): boolean;
@@ -2508,7 +2621,7 @@ declare class OverlayComponent implements OnInit, OnDestroy {
     /** Build position/size styles for a position:fixed overlay box. */
     private createBoxStyle;
     private createRingClipPath;
-    static ɵfac: i0.ɵɵFactoryDeclaration<OverlayComponent, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<OverlayComponent, [null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<OverlayComponent, "app-overlay", never, {}, { "toolbarAction": "toolbarAction"; }, never, never, false, never>;
 }
 
@@ -2862,6 +2975,7 @@ declare class BuilderDialogComponent implements OnInit, OnDestroy {
     private instanceRegistry;
     private overlayService;
     private cdr;
+    private designState;
     children: ComponentNode[];
     nodeId: string;
     dropListId: string;
@@ -2873,9 +2987,18 @@ declare class BuilderDialogComponent implements OnInit, OnDestroy {
     childMouseLeave: EventEmitter<void>;
     /** Canvas-only visibility. Never serialised; the live site always starts closed. */
     designOpen: boolean;
+    /** Opened by an action on the canvas (the canvas is a live runtime): stays until something closes it. */
+    private runtimeOpen;
+    /** Closed by its X / backdrop while the selection or the switcher still shows it: hidden until either changes. */
+    private dismissed;
     get placementValue(): string;
     private selectSub?;
-    constructor(dragEngine: DragEngineService, instanceRegistry: ComponentInstanceRegistryService, overlayService: OverlayService, cdr: ChangeDetectorRef);
+    private stateSub?;
+    constructor(dragEngine: DragEngineService, instanceRegistry: ComponentInstanceRegistryService, overlayService: OverlayService, cdr: ChangeDetectorRef, designState: CanvasDesignStateService | null);
+    /** Shown when an action opened it, or the canvas design state shows it (selection inside / switched open). */
+    private recompute;
+    private openRuntime;
+    private closeRuntime;
     ngOnInit(): void;
     ngOnDestroy(): void;
     /** A click on the stage ITSELF is the backdrop click — children swallow everything else.
@@ -2886,7 +3009,7 @@ declare class BuilderDialogComponent implements OnInit, OnDestroy {
     onCloseClick(event: MouseEvent): void;
     onBackdrop(): void;
     onDrop(event: IoxDropEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderDialogComponent, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderDialogComponent, [null, null, null, null, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BuilderDialogComponent, "app-builder-dialog", never, { "children": { "alias": "children"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "dropListId": { "alias": "dropListId"; "required": false; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; }, { "childClick": "childClick"; "childMouseEnter": "childMouseEnter"; "childMouseLeave": "childMouseLeave"; }, never, never, false, never>;
 }
 
@@ -3026,6 +3149,8 @@ interface TreeNode {
     node: ComponentNode;
     icon: string;
     label: string;
+    /** Hidden at rest on the live site (a closed drawer): the eye-slash glyph — select it to show it (R2). */
+    hiddenAtRest: boolean;
     depth: number;
     expanded: boolean;
     hasChildren: boolean;
@@ -3033,6 +3158,8 @@ interface TreeNode {
     parentArray: ComponentNode[];
     /** Index of this node inside parentArray. */
     indexInParent: number;
+    /** A composite's locked part (a card's Title / Content): a lock instead of Delete (board 3 / 8). */
+    locked: boolean;
 }
 declare class LayerTreeComponent implements OnInit, OnDestroy {
     private registry;
@@ -3053,12 +3180,17 @@ declare class LayerTreeComponent implements OnInit, OnDestroy {
     editingNodeId: string | null;
     editingValue: string;
     activeSection: 'page' | 'global';
+    private readonly labels;
+    readonly lockedPartTitle: string;
+    readonly roleTitle: string;
     /** Cache: component type → icon class */
     private iconMap;
     private selectSub?;
     /** Last-seen structural signature — used by ngDoCheck to skip no-op rebuilds. */
     private _layoutSig;
     private _globalSig;
+    /** The eye-slash glyph's title, through the host's i18n (builder.chrome.*). */
+    readonly hiddenAtRestTitle: string;
     constructor(registry: ComponentRegistryService, overlayService: OverlayService, dragEngine: DragEngineService);
     ngOnInit(): void;
     ngOnDestroy(): void;
@@ -3252,6 +3384,21 @@ declare class BuilderHistoryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<BuilderHistoryService>;
 }
 
+/**
+ * Parts that are HIDDEN AT REST (complex-components R2, board 3): on the live site they are not on
+ * screen until something opens them, so on the canvas they show only while selected into or switched
+ * open ("Showing on canvas"). The layer tree marks them with the eye-slash glyph. Today: a Dialog (the
+ * mobile menu's drawer, a consent banner). CC2 adds a collapsed Accordion panel and an inactive tab.
+ */
+declare const HIDDEN_AT_REST_TYPES: ReadonlyArray<string>;
+declare function isHiddenAtRest(node: {
+    type?: string;
+} | null | undefined): boolean;
+/** Root → `target`, inclusive, across `roots` (page layout and globals), or [] when it is not there. */
+declare function pathToNode<T extends {
+    children?: T[];
+}>(roots: ReadonlyArray<T>, target: T): T[];
+
 /**
  * node-path — pure ancestor-chain helpers for the builder's node tree.
  *
@@ -3409,6 +3556,33 @@ declare const PALETTE_PRESET_DEFS: readonly PalettePresetDef[];
  */
 declare function buildPalettePreset(def: PalettePresetDef, createConfig: (type: string) => ComponentNode | null): ComponentNode | null;
 
+/**
+ * CONTENT BLOCKS (complex-components board 8, composite T23 / T25) — Card, Badge, Chip. Not component
+ * types: each is a composite-core recipe of ordinary nodes (the Card's parts carry roles), stamped here
+ * with the builder's own node factory — the same recipe generation-core's composer stamps with its own.
+ */
+declare enum CompositePresetId {
+    Card = "card",
+    Badge = "badge",
+    Chip = "chip"
+}
+interface CompositePresetDef {
+    id: CompositePresetId;
+    name: string;
+    icon: string;
+    description: string;
+    build: (create: CompositeNodeFactory) => CompositeNode;
+}
+declare const COMPOSITE_PRESETS: readonly CompositePresetDef[];
+/**
+ * The builder's node factory for composite-core recipes: a NEW node as the palette creates one
+ * (`createConfig`, already wearing its type's default style), the recipe's props written into its traits,
+ * then moved onto the asked element style (`switchElementStyle`, so nothing of the default style lingers).
+ */
+declare function builderCompositeFactory(createConfig: (type: string) => ComponentNode | null, baselineStyles: (type: string) => Readonly<Record<string, unknown>>): CompositeNodeFactory;
+/** A fresh content block for the palette (click or drag). */
+declare function buildCompositePreset(def: CompositePresetDef, createConfig: (type: string) => ComponentNode | null, baselineStyles: (type: string) => Readonly<Record<string, unknown>>): ComponentNode;
+
 interface ConsentPreset {
     banner: ComponentNode;
     preferences: ComponentNode;
@@ -3528,6 +3702,25 @@ declare function syncEmptyImagePlaceholder(ref: ComponentRef<unknown> | null | u
  */
 declare function syncNodeDesign(ref: ComponentRef<unknown> | null | undefined, node: NodeDesign, emptyLabel: string | null): void;
 
+/** A node's base style map, from its style traits (the live values the Style panel edits). */
+declare function nodeStyleMap(node: ComponentNode): Record<string, any>;
+/**
+ * Re-register a node's compiled rules from its CURRENT style values — the base rule (with the default
+ * hover transition), its self-scoped state rules and its breakpoint layers — exactly as the
+ * RenderDirective registers them at render. For edits that rewrite a node's styles from outside the Style
+ * panel (a Card's layout preset, a reset to defaults).
+ */
+declare function upsertNodeStyles(styleRegistry: StyleRegistryService, node: ComponentNode): void;
+/** Push every content trait of a node to its rendered component (a Card title's link switched on). */
+declare function syncNodeInputs(ref: ComponentRef<unknown> | null | undefined, node: ComponentNode): void;
+/** Visit a node and every descendant. */
+declare function walkNodes(node: ComponentNode, visit: (n: ComponentNode) => void): void;
+/**
+ * After a subtree was rewritten in place (PanelEventTypes.NODE_STRUCTURE_CHANGED): every node's rules,
+ * design classes (marker, scheme, role) and inputs re-applied. `refOf` finds a node's rendered component.
+ */
+declare function refreshSubtree(node: ComponentNode, styleRegistry: StyleRegistryService, refOf: (n: ComponentNode) => ComponentRef<unknown> | null | undefined, emptyImageLabel: string | null): void;
+
 /**
  * Dialog (actions plan A1b) — an ordinary container whose children are normal nodes, rendered
  * on the live site as a real `<dialog>` (top layer, free focus trap/Esc) and in the CANVAS as a
@@ -3677,5 +3870,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BODY_CRUMB_LABEL, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BUILDER_CHROME_EN, BUILDER_FONT_LINK_ATTR, BUILDER_TOKEN_SCOPE_CLASS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDialogComponent, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CANVAS_EMPTY_IMAGE_LABEL_EN, CANVAS_EMPTY_IMAGE_LABEL_KEY, CANVAS_ROOT_RESET_CSS, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DROP_REFUSED_CLASS, DataSourceRegistryService, DataSourceType, DialogComponentConfig, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EDITOR_CHROME_ATTRIBUTE, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, FIELD_KIND_PRESETS, FIELD_PARTS, FORM_STATE_BLOCK_TYPES, FORM_TYPE, FieldComponentConfig, FieldGroupComponentConfig, FormComponentConfig, FormErrorComponentConfig, FormStateService, FormSuccessComponentConfig, GalleryConfig, GroupStyleConfig, INSERT_REFUSAL_LABEL_KEYS, INTERACTION_STATES, INVERSE_ACTION, IOX_BUILDER_CANVAS, IOX_BUILDER_LABELS, IOX_DATA_SOURCE_ENDPOINTS, InsertRefusal, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PALETTE_PRESET_DEFS, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROOT_ESCAPE_PX, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, RootZone, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StructureFix, 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, VALIDATION_STATES, VALIDATION_STATE_CLASS, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildConsentPreset, buildElementStyleSpecimen, buildFieldKindPreset, buildFlavorSpecimen, buildFormPreset, buildFullStyleTraits, buildLayoutPreset, buildPalettePreset, buildPresetStyleTraits, canFluidise, canvasEmptyImageLabel, collapseColumnsProps, columnCountOf, defaultBuilderLabels, defaultPageSettings, dropTargetLabel, escapesRoot, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, insertRefusal, insertRefusalLabel, isHiddenAt, isSpecimen, markSpecimen, matchesControlSearch, nearestFormNode, nodeAncestorPath, nodeAncestorPathInEither, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, rootEscapeBand, rootZone, setStyleTrait, setTrait, stackChildrenProps, summarise, syncEmptyImagePlaceholder, syncNodeDesign, textNode, visibilityProps, wrapNode };
-export type { AuditFinding, AuditNode, BreakpointPresentation, BuilderClipboard, BuilderLabelResolver, ComponentEventDef, ComponentMethodDef, ComponentNode, ComponentTrait, ConsentPreset, CreateConfig, Crumb, DesignSpecimenCopy, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, FieldKindDef, FormStateSnapshot, HistoryChange, HistoryEntry, HistoryStep, InsertRefusedEvent, InsertTarget, InteractionAction, InteractionActionType, InteractionPreset, InteractionTrigger, IoxBinding, IoxDataSource, IoxDropEvent, IoxInteraction, IoxSymbol, LayoutPresetChildStyles, LayoutPresetDef, NodeRef, OverlayBoxModel, OverlayBoxSpacing, OverlayEntry, PageRouteAnimationSettings, PageScrollSettings, PageSettings, PalettePresetDef, PanelEvent, QuadSizeSegment, RootEscapeMemory, RouteAnimationPreset, ScreenWidthOption, SelectionBadge, StyleMap, StylePart, StylePreset, StyleTrait, StyleTraitGroup, TraitOptionMap, TraitSelectOption, TraitShowCondition, TreePathNode, UpsertTokensOptions, ViewportState, ZoomOption };
+export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BODY_CRUMB_LABEL, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BUILDER_CHROME_EN, BUILDER_FONT_LINK_ATTR, BUILDER_TOKEN_SCOPE_CLASS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDialogComponent, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CANVAS_EMPTY_IMAGE_LABEL_EN, CANVAS_EMPTY_IMAGE_LABEL_KEY, CANVAS_ROOT_RESET_CSS, COMPOSITE_PRESETS, CanvasDesignStateService, CanvasShowState, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, CompositePresetId, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DROP_REFUSED_CLASS, DataSourceRegistryService, DataSourceType, DialogComponentConfig, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EDITOR_CHROME_ATTRIBUTE, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, FIELD_KIND_PRESETS, FIELD_PARTS, FORM_STATE_BLOCK_TYPES, FORM_TYPE, FieldComponentConfig, FieldGroupComponentConfig, FormComponentConfig, FormErrorComponentConfig, FormStateService, FormSuccessComponentConfig, GalleryConfig, GroupStyleConfig, HIDDEN_AT_REST_LABEL_KEY, HIDDEN_AT_REST_TYPES, INSERT_REFUSAL_LABEL_KEYS, INTERACTION_STATES, INVERSE_ACTION, IOX_BUILDER_CANVAS, IOX_BUILDER_LABELS, IOX_DATA_SOURCE_ENDPOINTS, InsertRefusal, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PALETTE_PRESET_DEFS, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROOT_ESCAPE_PX, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, RootZone, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StructureFix, 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, VALIDATION_STATES, VALIDATION_STATE_CLASS, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildCompositePreset, buildConsentPreset, buildElementStyleSpecimen, buildFieldKindPreset, buildFlavorSpecimen, buildFormPreset, buildFullStyleTraits, buildLayoutPreset, buildPalettePreset, buildPresetStyleTraits, builderCompositeFactory, canFluidise, canvasEmptyImageLabel, collapseColumnsProps, columnCountOf, defaultBuilderLabels, defaultPageSettings, dropTargetLabel, escapesRoot, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, insertRefusal, insertRefusalLabel, isHiddenAt, isHiddenAtRest, isSpecimen, markSpecimen, matchesControlSearch, nearestFormNode, nodeAncestorPath, nodeAncestorPathInEither, nodeStyleMap, pathToNode, refreshSubtree, removalRefusal, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, rootEscapeBand, rootZone, setStyleTrait, setTrait, stackChildrenProps, summarise, syncEmptyImagePlaceholder, syncNodeDesign, syncNodeInputs, textNode, upsertNodeStyles, visibilityProps, walkNodes, wrapNode };
+export type { AuditFinding, AuditNode, BreakpointPresentation, BuilderClipboard, BuilderLabelResolver, CanvasDesignSnapshot, ComponentEventDef, ComponentMethodDef, ComponentNode, ComponentTrait, CompositePresetDef, ConsentPreset, CreateConfig, Crumb, DesignSpecimenCopy, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, FieldKindDef, FormStateSnapshot, HistoryChange, HistoryEntry, HistoryStep, InsertRefusedEvent, InsertTarget, InteractionAction, InteractionActionType, InteractionPreset, InteractionTrigger, IoxBinding, IoxDataSource, IoxDropEvent, IoxInteraction, IoxSymbol, LayoutPresetChildStyles, LayoutPresetDef, NodeRef, OverlayBoxModel, OverlayBoxSpacing, OverlayEntry, PageRouteAnimationSettings, PageScrollSettings, PageSettings, PalettePresetDef, PanelEvent, QuadSizeSegment, RootEscapeMemory, RouteAnimationPreset, ScreenWidthOption, SelectionBadge, StyleMap, StylePart, StylePreset, StyleTrait, StyleTraitGroup, TraitOptionMap, TraitSelectOption, TraitShowCondition, TreePathNode, UpsertTokensOptions, ViewportState, ZoomOption };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@vectoriox/iox-builder",
-  "version": "9.1.0",
+  "version": "9.3.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",
     "@angular/animations": ">=20.0.0",
     "@angular/cdk": ">=20.0.0",
-    "@vectoriox/iox-ui": ">=5.30.0",
+    "@vectoriox/iox-ui": ">=5.31.0",
     "interactjs": "^1.10.27",
     "primeng": ">=20.0.0",
     "swiper": ">=12.0.0",