@vectoriox/iox-builder 2.0.2 → 2.0.4

package/package.json

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

package/types/vectoriox-iox-builder.d.ts

@@ -852,6 +852,9 @@ declare class MoveableCanvasService {
     private target;
     private node;
     private sourceId;
+    /** A rubber-band multi-select group is active; `groupAt` guards the immediate follow-up click. */
+    private groupActive;
+    private groupAt;
     /** Called after a successful reorder so the host can emit LAYOUT_CHANGED / refresh selection. */
     onReorder: (() => void) | null;
     /** Called after a geometry commit (resize) so the host can emit LAYOUT_CHANGED (undo/save). */
@@ -867,6 +870,13 @@ declare class MoveableCanvasService {
     }): void;
     /** Point Moveable at the selected element (skips inline-edit + preview-clone targets). */
     select(element: HTMLElement | null, node: ComponentNode | null): void;
+    /**
+     * Multi-select group (Selecto rubber-band → group move). With 2+ targets Moveable shows its
+     * bounding box + handles for the whole group; with ≤1 it defers to the normal single-select
+     * path (select()), which keeps the OverlayService as the sole owner of single-selection visuals.
+     * Returns true when a group is active so the host can skip the single-select wiring.
+     */
+    selectGroup(elements: HTMLElement[]): boolean;
     /** Recompute the control-box position (call on scroll/zoom/layout changes). */
     refresh(): void;
     /** Snap guideline elements for `target`: every node host except itself, its ancestors, and its
@@ -897,6 +907,44 @@ declare class MoveableCanvasService {
     static ɵprov: i0.ɵɵInjectableDeclaration<MoveableCanvasService>;
 }
 
+/**
+ * SelectoCanvasService — Phase 1 of the Moveable + Selecto migration
+ * (see iox-ai-guidance/architecture/builder/moveable-migration.md).
+ *
+ * Rubber-band MULTI-select on the canvas. Runs ONLY when `moveableMode` is on; interact.js is
+ * untouched, so the flag-off path is byte-identical to today.
+ *
+ *   - `selectFromInside: false` — a drag that STARTS on a node moves it (Moveable); the rubber band
+ *     only starts from empty canvas space, so single-element drag/select is unaffected.
+ *   - `selectByClick: false`    — a plain click still flows through the existing single-select path
+ *     (OverlayService), so nothing about clicking changes.
+ *   - `rootContainer` is the UNtransformed `.preview` (Selecto explicitly wants a non-transformed
+ *     root): the rubber band and the targets' client rects are then in the same viewport space, so
+ *     hit-testing is correct even though the canvas content is `transform: scale()`d.
+ *
+ * On a rubber-band release it emits the selected node host elements; the host maps them to nodes and
+ * drives Moveable with the group (see MoveableCanvasService.selectGroup).
+ */
+declare class SelectoCanvasService {
+    private selecto;
+    /** Called on rubber-band release with the selected `.iox-node-*` host elements (may be empty). */
+    onSelect: ((elements: HTMLElement[]) => void) | null;
+    /** Count from the last rubber-band release (state/telemetry). */
+    lastSelectedCount: number;
+    /**
+     * Wire Selecto onto the canvas.
+     * @param container       untransformed element the rubber band renders into (`.preview`).
+     * @param dragContainer   element the drag is listened on (the same `.preview`).
+     * @param selectableRoot  the node container whose `.iox-node-*` descendants are selectable.
+     */
+    init(container: HTMLElement, dragContainer: HTMLElement, selectableRoot: HTMLElement): void;
+    /** Keep Selecto's selectable set fresh after layout changes (nodes added/removed/reordered). */
+    refresh(): void;
+    destroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SelectoCanvasService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SelectoCanvasService>;
+}
+
 /**
  * Page-scoped registry that holds the current page's data sources.
  * Scoped to PageUiComponent.providers[] so every builder service
@@ -1119,6 +1167,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private cdr;
     private appRef;
     private moveableCanvas;
+    private selectoCanvas;
     layout: ComponentNode[];
     dataSources: IoxDataSource[];
     orgId: string;
@@ -1215,7 +1264,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, interactionEngine: InteractionEngineService, interactionPresetRegistry: InteractionPresetRegistryService, clipboard: BuilderClipboardService, symbolRegistry: SymbolRegistryService, cdr: ChangeDetectorRef, appRef: ApplicationRef, moveableCanvas: MoveableCanvasService);
+    constructor(registry: ComponentRegistryService, overlayService: OverlayService, panelEventService: PanelEventService, dragEngine: DragEngineService, dsRegistry: DataSourceRegistryService, viewportService: ViewportService, interactionEngine: InteractionEngineService, interactionPresetRegistry: InteractionPresetRegistryService, clipboard: BuilderClipboardService, symbolRegistry: SymbolRegistryService, cdr: ChangeDetectorRef, appRef: ApplicationRef, moveableCanvas: MoveableCanvasService, selectoCanvas: SelectoCanvasService);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;