microboard-temp 0.10.2 → 0.11.0

package/dist/types/Board.d.ts

@@ -15,6 +15,7 @@ import { SpatialIndex } from "./SpatialIndex";
 import { Subject } from "./Subject";
 import { Tools } from "./Tools";
 import { ItemsMap } from "./Validators";
+import { BaseItem } from "./Items/BaseItem";
 import { ItemDataWithId } from "./Items/Item";
 import { Account } from "./types/Account";
 export type InterfaceType = "edit" | "view" | "loading";
@@ -79,6 +80,16 @@ export declare class Board {
     addLockedGroup(item: Group): Item;
     remove(item: Item, withConnectors?: boolean): void;
     removeLockedGroup(item: Group): void;
+    /**
+     * Creates a Group containing the given items.
+     * Items are moved from the board into the group's local coordinate space.
+     * Returns the newly created Group.
+     */
+    group(items: BaseItem[]): Group;
+    /**
+     * Dissolves a Group, returning its children to the board with world-space transforms.
+     */
+    ungroup(group: Group): void;
     getByZIndex(index: number): Item;
     getZIndex(item: Item): number;
     getLastZIndex(): number;

package/dist/types/Items/BaseItem/BaseItem.d.ts

@@ -14,6 +14,7 @@ import { Path, Paths } from "../Path";
 import { BaseItemOperation } from "./BaseItemOperation";
 import { SimpleSpatialIndex } from "../../SpatialIndex/SimpleSpatialIndex";
 import { Point } from "../Point";
+import { Matrix } from "../Transformation/Matrix";
 export type BaseItemData = {
     itemType: string;
 } & Record<string, any>;
@@ -46,6 +47,12 @@ export declare class BaseItem extends Mbr implements Geometry {
     constructor(board: Board, id?: string, defaultItemData?: BaseItemData | undefined, isGroupItem?: boolean);
     updateChildrenIds(): void;
     getId(): string;
+    /**
+     * Returns the full world-space matrix by walking up the parent chain.
+     * For top-level items (parent === "Board") this is identical to the item's
+     * own transformation matrix. For nested items it is parentWorld × localMatrix.
+     */
+    getWorldMatrix(): Matrix;
     setId(id: string): this;
     getChildrenIds(): string[] | null;
     addChildItems(children: BaseItem[]): void;
@@ -57,6 +64,13 @@ export declare class BaseItem extends Mbr implements Geometry {
         cancelIfChild?: boolean;
     }): boolean;
     getMbr(): Mbr;
+    /**
+     * Returns the world-space axis-aligned bounding box.
+     * For top-level items this is identical to getMbr().
+     * For nested items (parent !== "Board") it transforms the local Mbr corners
+     * through the world matrix to produce the correct world-space bounds.
+     */
+    getWorldMbr(): Mbr;
     applyAddChildren(childIds: string[]): void;
     applyRemoveChildren(childIds: string[]): void;
     updateMbr(): void;

package/dist/types/Items/Group/Group.d.ts

@@ -15,37 +15,27 @@ export interface GroupData {
 }
 export declare class Group extends BaseItem {
     private events?;
-    private children;
     readonly linkTo: LinkTo;
     readonly itemType = "Group";
     parent: string;
     readonly transformation: Transformation;
     readonly subject: Subject<Group>;
-    private mbr;
     transformationRenderBlock?: boolean;
     constructor(board: Board, events?: Events | undefined, children?: string[], id?: string);
     isClosed(): boolean;
     getRichText(): null;
-    addChild(childId: string): void;
-    private applyAddChild;
-    private applyRemoveChild;
-    removeChild(childId: string): void;
-    emitRemoveChild(child: Item): void;
     apply(op: Operation): void;
     emit(operation: GroupOperation): void;
     setId(id: string): this;
-    serialize(): GroupData;
-    deserialize(data: GroupData): this;
-    getId(): string;
-    getIntersectionPoints(segment: Line): Point[];
     getMbr(): Mbr;
+    updateMbr(): void;
     getChildrenIds(): string[];
     getChildren(): Item[];
-    updateMbr(): void;
-    setBoard(board: Board): void;
-    setChildren(items: string[]): void;
-    removeChildren(): void;
     getLinkTo(): string | undefined;
+    serialize(): GroupData;
+    deserialize(data: GroupData): this;
+    getId(): string;
+    getIntersectionPoints(segment: Line): Point[];
     render(context: DrawingContext): void;
     renderHTML(documentFactory: DocumentFactory): HTMLElement;
 }

package/dist/types/Items/Transformation/Matrix.d.ts

@@ -42,4 +42,23 @@ export declare class Matrix {
     mirrorX(): Matrix;
     mirrorY(): Matrix;
     compare(matrix: Matrix): boolean;
+    /**
+     * Returns parent × this (local → world).
+     * Use when `this` is a local matrix and you need the world matrix.
+     */
+    composeWith(parent: Matrix): Matrix;
+    /**
+     * Returns parent⁻¹ × this (world → local).
+     * Use when `this` is a world matrix and you need the local matrix relative to `parent`.
+     */
+    toLocalOf(parent: Matrix): Matrix;
+    /**
+     * Applies the inverse of the linear (rotation/scale) part of this matrix to a 2D delta vector.
+     * Used to convert a world-space translation delta to the equivalent local-space delta.
+     * Does not involve the translation component of the matrix.
+     */
+    applyInverseLinear(dx: number, dy: number): {
+        x: number;
+        y: number;
+    };
 }

package/dist/types/Items/Transformation/Transformation.d.ts

@@ -26,6 +26,11 @@ export declare class Transformation {
         y: number;
     };
     getRotation(): number;
+    /**
+     * Replaces the internal matrix entirely with `matrix` without emitting an operation.
+     * Used by the nesting system to convert between world and local coordinate spaces.
+     */
+    setLocalMatrix(matrix: Matrix): void;
     setLocal(x: number, y: number, scaleX?: number, scaleY?: number): void;
     setLocal(data: Partial<MatrixData>): void;
     serialize(): TransformationData;

package/dist/types/Selection/Selection.d.ts

@@ -112,7 +112,7 @@ export declare class BoardSelection {
     nestSelectedItems(unselectedItem?: Item | null, checkFrames?: boolean): void;
     /** Emits applyMatrix with multiple items */
     transformMany(items: ApplyMatrixItem[], timeStamp?: number): void;
-    /** transforms selected items with frames' children */
+    /** transforms selected items (container children follow via local transform hierarchy) */
     getManyItemsTranslation(x: number, y: number, unselectedItem?: Item): ApplyMatrixItem[];
     setStrokeStyle(borderStyle: BorderStyle): void;
     setStrokeColor(borderColor: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microboard-temp",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "description": "A flexible interactive whiteboard library",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",