@vectoriox/iox-builder 9.4.0 → 9.5.1

package/index.d.ts

@@ -935,7 +935,10 @@ declare enum PanelEventTypes {
      *  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"
+    NODE_STRUCTURE_CHANGED = "nodestructurechanged",
+    /** A Repeater's rows changed on the canvas (fetched, re-fetched, its source cleared). Carries `{ nodeId,
+     *  count }`. Not a page edit — never an undo step: the layer tree redraws its "N more rows" line. */
+    REPEATER_ROWS_CHANGED = "repeaterrowschanged"
 }
 interface PanelEvent {
     type: PanelEventTypes;
@@ -1336,6 +1339,9 @@ declare class StyleRegistryService {
     /** Node type per css id — the compiler strips the props a type's renderer owns (a Dialog's
      *  positioning, an Icon's line-height) from EVERY rule of that node, whoever upserts it. */
     private nodeTypes;
+    /** The section colour scheme each css id wears — a scheme'd node's `color: inherit` compiles to the
+     *  scheme's ink (`withSchemeInk`, iox-ui#15), exactly as both engine paths compile it. */
+    private nodeSchemes;
     private tokenCss;
     private tokenRows;
     private uploadedFamilies;
@@ -1379,9 +1385,10 @@ declare class StyleRegistryService {
      * @param triggerId  For TARGETED states only: the css id of the trigger node whose
      *                pseudo-class drives the state. Compiles a `:has()`-scoped selector.
      */
-    /** Record a node's type (RenderDirective, before its first upsert) and recompile nothing —
-     *  every later rule for the node is stripped of what the type's renderer owns. */
-    setNodeType(nodeId: string, type: string): void;
+    /** Record a node's type and the colour scheme it wears (RenderDirective and every re-registration,
+     *  before the upsert) and recompile nothing — every later rule for the node is stripped of what the
+     *  type's renderer owns, and a scheme'd node's inherited colour reads the scheme's ink. */
+    setNodeType(nodeId: string, type: string, colorScheme?: string | null): void;
     private ownProps;
     upsert(nodeId: string, styles: Record<string, any>, state?: ElementState, relativeToId?: string, triggerId?: string): void;
     /**
@@ -2902,6 +2909,8 @@ declare class BuilderRepeaterComponent implements OnInit, OnDestroy {
     /** Data comes from the SHARED resolver (public controllers + the source's own filters) — the
      *  same decision the SSR engine runs, so the canvas preview matches the published page. */
     private fetchData;
+    /** Tell the chrome (the layer tree's "N more rows" line) how many rows the canvas now repeats. */
+    private announceRows;
     private isInTemplate;
     private refreshPreviews;
     private applyFirstItemToTemplate;
@@ -3145,7 +3154,32 @@ declare class PanelComponent implements AfterContentInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<PanelComponent, "app-panel", never, {}, {}, ["panelChildren"], never, false, never>;
 }
 
-interface TreeNode {
+/**
+ * The layer tree's rows — one per node, plus what the shipped Repeater adds to them (complex-components
+ * boards 4 and 8, "Cards from content"): the Repeater's own sub-label (`projects × 6`), the `template` chip
+ * on each item of its template, a `← projects.cover` binding label on every bound part inside it, and ONE
+ * non-selectable "5 more rows from projects" line after the template — the rows from the source are not
+ * nodes, so the tree says so instead of listing them. Every Repeater gets them: a card grid is a Repeater
+ * whose template is a Card, nothing card-specific.
+ */
+declare const REPEATER_TYPE = "Repeater";
+/** The Repeater trait / binding prop naming the data source it repeats. */
+declare const REPEATER_SOURCE_PROP = "source";
+/** A bound part's glyph in the tree (board 8: a plug where the type icon was). */
+declare const BOUND_ICON = "ph-thin ph-plug";
+/** What a Repeater on the canvas repeats over, right now: its source alias and how many rows it fetched. */
+interface LayerRepeaterRows {
+    alias: string;
+    count: number;
+}
+/** The line drawn after a Repeater's template: the rows the source adds beyond the template row. */
+interface LayerMoreRows {
+    count: number;
+    alias: string;
+    /** The template items' depth — the line sits level with them, under the last row of the template. */
+    depth: number;
+}
+interface LayerTreeRow {
     node: ComponentNode;
     icon: string;
     label: string;
@@ -3160,7 +3194,33 @@ interface TreeNode {
     indexInParent: number;
     /** A composite's locked part (a card's Title / Content): a lock instead of Delete (board 3 / 8). */
     locked: boolean;
-}
+    /** An item of a sourced Repeater's template — the one every row wears. */
+    template: boolean;
+    /** After the name: a Repeater's `alias × N`, a bound part's `← alias.field`. */
+    sub: string | null;
+    /** A part inside a Repeater's template that reads the row (or any source): the plug glyph. */
+    bound: boolean;
+    /** Set on the LAST visible row of a Repeater's template: the "N more rows" line follows it. */
+    moreRows: LayerMoreRows | null;
+}
+interface LayerTreeContext {
+    iconOf(type: string): string | undefined;
+    isExpanded(node: ComponentNode): boolean;
+    /** The live Repeater's rows (its rendered component), or null when it has not rendered. */
+    repeaterRows(node: ComponentNode): LayerRepeaterRows | null;
+}
+/** The alias a Repeater repeats — its `source` binding (canonical), else its `source` trait. */
+declare function repeaterSourceAlias(node: ComponentNode): string;
+/** `← projects.cover` for a bound part (its first binding), `← projects` when the binding has no path. */
+declare function bindingLabel(binding: IoxBinding | null | undefined): string | null;
+/** Every binding of a node, as the tree's title lists them. */
+declare function bindingLabels(node: ComponentNode): string[];
+/** `projects × 6` — the Repeater's sub-label; the count once its rows arrived. */
+declare function repeaterSubLabel(rows: LayerRepeaterRows): string | null;
+/** Flatten `nodes` into rows, depth-first, honouring each node's expanded state. */
+declare function flattenLayerTree(nodes: ComponentNode[], ctx: LayerTreeContext): LayerTreeRow[];
+
+type TreeNode = LayerTreeRow;
 declare class LayerTreeComponent implements OnInit, OnDestroy {
     private registry;
     private overlayService;
@@ -3181,11 +3241,16 @@ declare class LayerTreeComponent implements OnInit, OnDestroy {
     editingValue: string;
     activeSection: 'page' | 'global';
     private readonly labels;
+    private readonly panelEvents;
     readonly lockedPartTitle: string;
     readonly roleTitle: string;
+    readonly templateLabel: string;
+    readonly templateTitle: string;
+    readonly moreRowsTitle: string;
     /** Cache: component type → icon class */
     private iconMap;
     private selectSub?;
+    private eventsSub?;
     /** Last-seen structural signature — used by ngDoCheck to skip no-op rebuilds. */
     private _layoutSig;
     private _globalSig;
@@ -3194,6 +3259,10 @@ declare class LayerTreeComponent implements OnInit, OnDestroy {
     constructor(registry: ComponentRegistryService, overlayService: OverlayService, dragEngine: DragEngineService);
     ngOnInit(): void;
     ngOnDestroy(): void;
+    /** "5 more rows from projects" — the line after a Repeater's template (boards 4 / 8). */
+    moreRowsText(more: LayerMoreRows): string;
+    /** The row's title: every binding a bound part holds. */
+    boundTitle(tn: TreeNode): string | null;
     ngDoCheck(): void;
     /** Cheap structural signature: node IDs + nesting depth only. */
     private sig;
@@ -3215,7 +3284,8 @@ declare class LayerTreeComponent implements OnInit, OnDestroy {
     private buildIconMap;
     private expandedState;
     private rebuild;
-    private flattenTree;
+    /** What the Repeater on the canvas holds — its rendered component is the source of truth (it fetched). */
+    private repeaterRows;
     static ɵfac: i0.ɵɵFactoryDeclaration<LayerTreeComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LayerTreeComponent, "app-layer-tree", never, { "layout": { "alias": "layout"; "required": false; }; "globalElements": { "alias": "globalElements"; "required": false; }; }, { "nodeSelect": "nodeSelect"; "nodeAction": "nodeAction"; "nodeMove": "nodeMove"; }, never, never, false, never>;
 }
@@ -3870,5 +3940,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, 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 };
+export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BODY_CRUMB_LABEL, BOUND_ICON, 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, REPEATER_SOURCE_PROP, REPEATER_TYPE, 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, bindingLabel, bindingLabels, buildCompositePreset, buildConsentPreset, buildElementStyleSpecimen, buildFieldKindPreset, buildFlavorSpecimen, buildFormPreset, buildFullStyleTraits, buildLayoutPreset, buildPalettePreset, buildPresetStyleTraits, builderCompositeFactory, canFluidise, canvasEmptyImageLabel, collapseColumnsProps, columnCountOf, defaultBuilderLabels, defaultPageSettings, dropTargetLabel, escapesRoot, essentialTraitsFor, findNodeLocation, findParentOf, flattenLayerTree, flattenSchemaFields, fluidiseProps, generateNodeId, insertRefusal, insertRefusalLabel, isHiddenAt, isHiddenAtRest, isSpecimen, markSpecimen, matchesControlSearch, nearestFormNode, nodeAncestorPath, nodeAncestorPathInEither, nodeStyleMap, pathToNode, refreshSubtree, removalRefusal, reorderProps, repeaterSourceAlias, repeaterSubLabel, 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, LayerMoreRows, LayerRepeaterRows, LayerTreeContext, LayerTreeRow, 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.4.0",
+  "version": "9.5.1",
   "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.33.0",
+    "@vectoriox/iox-ui": ">=5.34.0",
     "interactjs": "^1.10.27",
     "primeng": ">=20.0.0",
     "swiper": ">=12.0.0",