microboard-temp 0.14.14 → 0.14.16

package/dist/types/Events/Transform/transformTransformationOperation.d.ts

@@ -0,0 +1,2 @@
+import { TransformationOperation } from '../../Geometry/Transformation/TransformationOperations';
+export declare function transformTransformationOperation(confirmed: TransformationOperation, toTransform: TransformationOperation): TransformationOperation | undefined;

package/dist/types/{Items → Geometry}/Geometry.d.ts

@@ -3,7 +3,7 @@ import { Point } from "./Point";
 import { Line } from "./Line";
 import { DrawingContext } from "./DrawingContext";
 import { GeometricNormal } from "./GeometricNormal";
-import type { RichText } from "./RichText";
+import type { RichText } from "../Items/RichText/RichText";
 /**
  * Methods that define the geometry of an item.
  */

package/dist/types/{Items → Geometry}/Mbr/Mbr.d.ts

@@ -6,7 +6,7 @@ import { DrawingContext } from "../DrawingContext";
 import { Geometry } from "../Geometry";
 import { GeometricNormal } from "../GeometricNormal";
 import type { BorderStyle } from "../Path/Path";
-import type { RichText } from "../RichText/RichText";
+import type { RichText } from "../../Items/RichText/RichText";
 /**
  * The minimum bounding rectangle (MBR), also known as bounding box (BBOX) or envelope.
  * https://en.wikipedia.org/wiki/Minimum_bounding_rectangle
@@ -21,6 +21,7 @@ export declare class Mbr implements Geometry {
     strokeWidth: number;
     borderStyle: BorderStyle;
     static fromDomRect(rect: DOMRect): Mbr;
+    static unionOf(mbrs: Mbr[]): Mbr;
     constructor(left?: number, top?: number, right?: number, bottom?: number, borderColor?: string | import("../../Color/ColorValue").ColorValue, backgroundColor?: string | import("../../Color/ColorValue").ColorValue, strokeWidth?: number, borderStyle?: BorderStyle);
     getWidth(): number;
     getHeight(): number;

package/dist/types/{Items → Geometry}/Path/Paths.d.ts

@@ -6,7 +6,7 @@ import { Point } from '../Point';
 import { BorderStyle, BorderWidth, Path, PathStylize } from './Path';
 import { Matrix } from '../Transformation';
 import { GeometricNormal } from '../GeometricNormal';
-import { RichText } from '../RichText/RichText';
+import { RichText } from '../../Items/RichText/RichText';
 export declare class Paths implements Geometry {
     private paths;
     private backgroundColor;

package/dist/types/{Items → Geometry}/Transformation/Matrix.d.ts

@@ -7,6 +7,14 @@ export declare class Matrix {
     shearX: number;
     shearY: number;
     constructor(translateX?: number, translateY?: number, scaleX?: number, scaleY?: number, shearX?: number, shearY?: number);
+    static fromData(data: {
+        translateX: number;
+        translateY: number;
+        scaleX: number;
+        scaleY: number;
+        shearX: number;
+        shearY: number;
+    }): Matrix;
     translate(x: number, y: number): void;
     scale(x: number, y: number): void;
     multiplyByMatrix(matrix: Matrix): this;
@@ -61,4 +69,12 @@ export declare class Matrix {
         x: number;
         y: number;
     };
+    getMatrixData(): {
+        translateX: number;
+        translateY: number;
+        scaleX: number;
+        scaleY: number;
+        shearX: number;
+        shearY: number;
+    };
 }

package/dist/types/{Items → Geometry}/Transformation/TransformationData.d.ts

@@ -3,6 +3,8 @@ export interface TransformationData {
     translateY: number;
     scaleX: number;
     scaleY: number;
+    shearX: number;
+    shearY: number;
     rotate: number;
     isLocked: boolean;
 }
@@ -11,7 +13,9 @@ export declare class DefaultTransformationData implements TransformationData {
     translateY: number;
     scaleX: number;
     scaleY: number;
+    shearX: number;
+    shearY: number;
     rotate: number;
     isLocked: boolean;
-    constructor(translateX?: number, translateY?: number, scaleX?: number, scaleY?: number, rotate?: number, isLocked?: boolean);
+    constructor(translateX?: number, translateY?: number, scaleX?: number, scaleY?: number, shearX?: number, shearY?: number, rotate?: number, isLocked?: boolean);
 }

package/dist/types/{Items → Geometry}/Transformation/TransformationOperations.d.ts

@@ -64,6 +64,7 @@ export interface ApplyMatrixItem {
     id: string;
     matrix: MatrixData;
 }
+/** @deprecated Use MoveOperation or SetPlacementOperation instead */
 export interface ApplyMatrixOperation {
     class: "Transformation";
     method: "applyMatrix";
@@ -71,6 +72,31 @@ export interface ApplyMatrixOperation {
     timeStamp?: number;
     silent?: boolean;
 }
+export interface MoveItem {
+    id: string;
+    worldMatrix: MatrixData;
+    prevWorldMatrix: MatrixData;
+}
+export interface MoveOperation {
+    class: "Transformation";
+    method: "move";
+    items: MoveItem[];
+    timeStamp?: number;
+}
+export interface SetPlacementItem {
+    id: string;
+    parentId: string;
+    zOrderIndex: number;
+    worldMatrix: MatrixData;
+    prevParentId: string;
+    prevWorldMatrix: MatrixData;
+}
+export interface SetPlacementOperation {
+    class: "Transformation";
+    method: "setPlacement";
+    items: SetPlacementItem[];
+    timeStamp?: number;
+}
 export interface TransformManyItems {
     [key: string]: ApplyMatrixOperation | ScaleByTranslateByOperation | ScaleOperation | TranslateOperation;
 }
@@ -80,5 +106,5 @@ export interface TransformMany {
     items: TransformManyItems;
     timeStamp?: number;
 }
-export type TransformationOperation = ApplyMatrixOperation | RotateOperation | DeserializeOperation | TransformMany | Locked | Unlocked | TranslateOperation | ScaleOperation | ScaleByTranslateByOperation;
+export type TransformationOperation = ApplyMatrixOperation | MoveOperation | SetPlacementOperation | RotateOperation | DeserializeOperation | TransformMany | Locked | Unlocked | TranslateOperation | ScaleOperation | ScaleByTranslateByOperation;
 export {};

package/dist/types/{Items → Geometry}/Transformation/transformOps.d.ts

@@ -1,4 +1,4 @@
-import { MatrixData, TransformationOperation } from "./TransformationOperations";
+import { MatrixData, TransformationOperation, MoveOperation, SetPlacementOperation } from "./TransformationOperations";
 interface ItemLike {
     getId(): string;
     transformation: {
@@ -31,5 +31,7 @@ export declare const transformOps: {
     }, timeStamp?: number): TransformationOperation;
     setLocal(item: ItemOrId, data: Partial<MatrixData>): TransformationOperation;
     lock(items: readonly ItemOrId[] | ItemOrId, locked: boolean): TransformationOperation;
+    move(items: MoveOperation["items"], timeStamp?: number): TransformationOperation;
+    setPlacement(items: SetPlacementOperation["items"], timeStamp?: number): TransformationOperation;
 };
 export {};

package/dist/types/Geometry/index.d.ts

@@ -0,0 +1,12 @@
+export { Point } from "./Point";
+export { Line } from "./Line";
+export { CubicBezier, QuadraticBezier } from "./Curve";
+export { Arc } from "./Arc";
+export { Mbr } from "./Mbr";
+export { Anchor } from "./Anchor";
+export { DrawingContext } from "./DrawingContext";
+export * from "./Path";
+export * from "./Transformation";
+export * from "./Geometry";
+export * from "./GeometricNormal";
+export * from "./Alignment";

package/dist/types/HTMLAdapter/BoardHTMLAdapter.d.ts

@@ -0,0 +1,15 @@
+import { Board } from "../Board";
+import { BaseItemData } from "../Items/BaseItem/BaseItem";
+import { ItemDataWithId } from "../Items/Item";
+export declare function parseHTML(el: HTMLElement): ItemDataWithId | {
+    data: BaseItemData & {
+        id: string;
+    };
+    childrenMap: {
+        [id: string]: ItemDataWithId;
+    };
+};
+export declare function serializeBoardToHTML(board: Board): string;
+/** @returns ids of added items */
+export declare function deserializeHTMLAndEmitToBoard(board: Board, stringedHTML: string): string[];
+export declare function deserializeHTMLToBoard(board: Board, stringedHTML: string): void;

package/dist/types/{parserHTML.d.ts → HTMLAdapter/Parser.d.ts}

@@ -1,5 +1,5 @@
-import { ItemType, ItemDataWithId } from "./Items/Item";
-import { BaseItemData } from "./Items/BaseItem/BaseItem";
+import { ItemType, ItemDataWithId } from "../Items/Item";
+import { BaseItemData } from "../Items/BaseItem/BaseItem";
 type MapTagByType = Partial<Record<ItemType, string>>;
 export declare const tagByType: MapTagByType;
 type TagFactories = {

package/dist/types/{Items → HTMLAdapter}/Renderers/AINodeHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class AINodeHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/AudioHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class AudioHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/CommentHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class CommentHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/ConnectorHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class ConnectorHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/DrawingHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class DrawingHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/FrameHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class FrameHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/GroupHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class GroupHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/HTMLItemRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 export interface IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;
 }

package/dist/types/{Items → HTMLAdapter}/Renderers/ImageHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class ImageHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/PlaceholderHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class PlaceholderHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/RichTextHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class RichTextHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/ShapeHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class ShapeHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/StickerHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare class StickerHTMLRenderer implements IItemHTMLRenderer {
     render(item: BaseItem, documentFactory: DocumentFactory): HTMLElement;

package/dist/types/{Items → HTMLAdapter}/Renderers/VideoHTMLRenderer.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../../api/DocumentFactory";
-import { BaseItem } from "../BaseItem/BaseItem";
+import { BaseItem } from "../../Items/BaseItem/BaseItem";
 import { IItemHTMLRenderer } from "./HTMLItemRenderer";
 export declare const createPlaceholderImage: (documentFactory: DocumentFactory, width: number, height: number) => HTMLImageElement;
 export declare class VideoHTMLRenderer implements IItemHTMLRenderer {

package/dist/types/{HTMLRender/HTMLRender.d.ts → HTMLAdapter/Utils.d.ts}

@@ -1,5 +1,5 @@
 import { DocumentFactory } from "../api/DocumentFactory";
-import { Path, Paths } from "../Items/Path";
+import { Path, Paths } from "../Geometry/Path";
 import { LinkTo } from "../Items/LinkTo/LinkTo";
 export declare function getTranslationFromHTML(el: HTMLElement): [number, number];
 export declare function getScaleFromHTML(el: HTMLElement): [number, number];

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

@@ -1,13 +1,11 @@
 import { Board } from "../../Board";
 import { Operation } from "../../Events/EventsOperations";
 import { AINodeData } from "./AINodeData";
-import { DrawingContext } from "../DrawingContext";
-import { GeometricNormal } from "../GeometricNormal";
-import { Line } from "../Line/Line";
-import { Mbr } from "../Mbr/Mbr";
-import { Path } from "../Path/Path";
-import { Paths } from "../Path/Paths";
-import { Point } from "../Point/Point";
+import { DrawingContext } from "../../Geometry/DrawingContext";
+import { Mbr } from "../../Geometry/Mbr/Mbr";
+import { Path } from "../../Geometry/Path/Path";
+import { Paths } from "../../Geometry/Path/Paths";
+import { Point } from "../../Geometry/Point/Point";
 import { RichText } from "../RichText/RichText";
 import { Subject } from "../../Subject";
 import { BaseItem, SerializedItemData } from "../BaseItem/BaseItem";
@@ -45,19 +43,6 @@ export declare class AINode extends BaseItem<AINode> {
     isClosed(): boolean;
     getPath(): Path | Paths;
     apply(op: Operation): void;
-    getSnapAnchorPoints(): Point[];
-    getButtonMbr(): Mbr;
-    getDistanceToPoint(point: Point): number;
-    getIntersectionPoints(segment: Line): Point[];
-    getMbr(): Mbr;
-    getNearestEdgePointTo(point: Point): Point;
-    getNormal(point: Point): GeometricNormal;
-    isEnclosedBy(rect: Mbr): boolean;
-    isEnclosedOrCrossedBy(rect: Mbr): boolean;
-    isInView(rect: Mbr): boolean;
-    isNearPoint(point: Point, distance: number): boolean;
-    isUnderPoint(point: Point, tolerance?: number): boolean;
-    getRichText(): RichText;
     getLinkTo(): string | undefined;
     renderButton(context: DrawingContext): void;
     render(context: DrawingContext): void;

package/dist/types/Items/AINode/AINodeData.d.ts

@@ -1,9 +1,9 @@
-import { TransformationData } from '../Transformation/TransformationData';
+import { TransformationData } from '../../Geometry/Transformation/TransformationData';
 import { RichTextData } from '../RichText/RichTextData';
 import { ThreadDirection } from '../AINode/AINode';
-import { Mbr } from '../Mbr/Mbr';
-import { Path } from '../Path/Path';
-import { Matrix } from '../Transformation/Matrix';
+import { Mbr } from '../../Geometry/Mbr/Mbr';
+import { Path } from '../../Geometry/Path/Path';
+import { Matrix } from '../../Geometry/Transformation/Matrix';
 export interface AINodeData {
     readonly itemType: 'AINode';
     transformation: TransformationData;

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

@@ -1,11 +1,12 @@
 import type { Operation } from "../../Events";
 import { Subject } from "../../Subject";
-import { DrawingContext } from "../DrawingContext";
-import { TransformationData } from "../Transformation/TransformationData";
+import { DrawingContext } from "../../Geometry/DrawingContext";
+import { TransformationData } from "../../Geometry/Transformation/TransformationData";
 import { Board } from "../../Board";
-import { Path } from "../Path/Path";
-import { Point } from "../Point/Point";
+import { Path } from "../../Geometry/Path/Path";
+import { Point } from "../../Geometry/Point/Point";
 import { BaseItem, SerializedItemData } from "../BaseItem/BaseItem";
+import { UpdateHint } from "../BaseItem/UpdateHint";
 export interface AudioItemData {
     itemType: "Audio";
     url: string;
@@ -39,7 +40,9 @@ export declare class AudioItem extends BaseItem<AudioItem> {
     render(context: DrawingContext): void;
     serialize(): SerializedItemData<AudioItemData>;
     deserialize(data: SerializedItemData<AudioItemData> | AudioItemData): this;
-    apply(op: Operation): void;
+    apply(opIn: Operation): void;
+    protected updateVisuals(_op: Operation, hint: UpdateHint): void;
+    protected getPropertyUpdateHint(property: string): UpdateHint;
     emit(operation: Operation): void;
     setId(id: string): this;
     getId(): string;

package/dist/types/Items/Audio/AudioHelpers.d.ts

@@ -1,5 +1,5 @@
 import { Board } from '../../Board';
 import { AudioItem } from '../Audio/Audio';
-import { Matrix } from '../Transformation/Matrix';
+import { Matrix } from '../../Geometry/Transformation/Matrix';
 export declare const prepareAudio: (file: File, boardId: string, baseUrl?: string) => Promise<string>;
 export declare const calculateAudioPosition: (board: Board, audioItem: AudioItem) => Matrix;

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

@@ -1,30 +1,34 @@
-import { Mbr } from "../Mbr/Mbr";
-import { Line } from "../Line/Line";
+import { Mbr } from "../../Geometry/Mbr/Mbr";
+import { Line } from "../../Geometry/Line/Line";
 import { Item } from "../Item";
-import { Geometry } from "../Geometry";
+import { Geometry } from "../../Geometry/Geometry";
 import type { RichText } from "../RichText/RichText";
 import { LinkTo } from "../LinkTo/LinkTo";
-import { Transformation } from "../Transformation/Transformation";
+import { Transformation } from "../../Geometry/Transformation/Transformation";
 import { Board } from "../../Board";
-import { DrawingContext } from "../DrawingContext";
+import { DrawingContext } from "../../Geometry/DrawingContext";
 import { BaseOperation, Operation } from "../../Events/EventsOperations";
 import { Command } from "../../Events/Command";
-import { TransformationData } from "../Transformation/TransformationData";
+import { TransformationData } from "../../Geometry/Transformation/TransformationData";
 import { Subject } from "../../Subject";
-import { Path, Paths } from "../Path/index";
+import { Path, Paths } from "../../Geometry/Path/index";
 import { BaseItemOperation } from "./BaseItemOperation";
 import { SimpleSpatialIndex } from "../../SpatialIndex/SimpleSpatialIndex";
-import { Point } from "../Point";
-import { Matrix } from "../Transformation/Matrix";
+import { Point } from "../../Geometry/Point";
+import { Matrix } from "../../Geometry/Transformation/Matrix";
+import { MoveItem, SetPlacementItem } from "../../Geometry/Transformation/TransformationOperations";
 import { TransformParams, TransformResult } from "./TransformContext";
-import { GeometricNormal } from "../GeometricNormal";
+import { GeometricNormal } from "../../Geometry/GeometricNormal";
 import { ResizeType } from "../../Selection/Transformer/TransformerHelpers/getResizeType";
 import type { ItemType } from "../Item";
+import type { ItemOverlayDefinition } from "../../Overlay";
+import { UpdateHint } from "./UpdateHint";
 export interface BaseItemData {
     itemType: string;
     transformation?: TransformationData;
     linkTo?: string;
     childIds?: string[];
+    parent?: string;
     [key: string]: unknown;
 }
 export type SerializedItemData<T extends BaseItemData = BaseItemData> = T & {
@@ -34,14 +38,14 @@ export type SerializedItemData<T extends BaseItemData = BaseItemData> = T & {
 export declare class BaseItem<T extends BaseItem<any> = any> implements Geometry {
     static createCommand?: (board: Board, operation: Operation) => Command;
     protected mbr: Mbr;
-    transformation: Transformation;
-    linkTo: LinkTo;
+    id: string;
+    readonly linkTo: LinkTo;
+    readonly transformation: Transformation;
     parent: string;
     canBeNested: boolean;
     transformationRenderBlock?: boolean;
     index: SimpleSpatialIndex | null;
     board: Board;
-    id: string;
     subject: Subject<T>;
     onRemoveCallbacks: (() => void)[];
     shouldUseCustomRender: boolean;
@@ -66,28 +70,39 @@ export declare class BaseItem<T extends BaseItem<any> = any> implements Geometry
      */
     protected onParentChanged(_newParent: string): void;
     getId(): string;
+    getOverlay(): ItemOverlayDefinition | undefined;
     /**
-     * Returns the parent's world matrix. For Frames, only the translation component
-     * is returned to ensure children are not affected by frame scaling.
+     * Updates the local axis-aligned bounding box.
      */
-    getParentWorldMatrix(): Matrix;
+    updateMbr(): void;
+    /**
+     * Returns whether this item should scale its children when it is resized.
+     * Frames/Decks/Screens are typically non-scaling containers.
+     */
+    getIsScalingContainer(): boolean;
     /**
-     * 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 parentTransform × localMatrix.
-     * Note: Frames act as non-scaling containers.
+     * Returns the world matrix for this item by composing its local matrix with its parent's
+     * nesting matrix recursively. Calculates on-the-fly to ensure it is always up-to-date.
      */
     getWorldMatrix(): Matrix;
     /**
-     * Returns the matrix used for nesting children. For Frames, this is only
-     * the translation part. For other items it is the full world matrix.
+     * Returns the matrix used for nesting children. For non-scaling containers,
+     * this is only the translation portion of the world matrix.
      */
     getNestingMatrix(): Matrix;
+    /**
+     * Returns the parent's nesting matrix. If at top-level, returns an identity matrix.
+     */
+    getParentWorldMatrix(): Matrix;
     setId(id: string): this;
     getChildrenIds(): string[] | null;
+    /** @deprecated Use transformOps.setPlacement instead */
     addChildItems(children: BaseItem[]): void;
+    /** @deprecated Use transformOps.setPlacement instead */
     removeChildItems(children: BaseItem[] | BaseItem): void;
     rotate(degree: number): void;
+    applySetPlacement(op: SetPlacementItem): void;
+    applyMove(op: MoveItem): void;
     emitNesting(children: BaseItem[]): void;
     handleNesting(item: BaseItem | Mbr, options?: {
         onlyForOut?: boolean;
@@ -101,9 +116,9 @@ export declare class BaseItem<T extends BaseItem<any> = any> implements Geometry
     getCenter(): Point;
     /**
      * 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.
+     * Since this.mbr always represents bounds in parent-space (with the item's local
+     * transformation already baked in), we only need to transform it through its
+     * parent's world matrix. Calculates on-the-fly to ensure it is always fresh.
      */
     getWorldMbr(): Mbr;
     getIntersectionPoints(segment: Line): Point[];
@@ -111,9 +126,10 @@ export declare class BaseItem<T extends BaseItem<any> = any> implements Geometry
     isInView(rect: Mbr): boolean;
     getNormal(point: Point): GeometricNormal;
     private hasAncestor;
+    /** @deprecated Use applySetPlacement instead */
     applyAddChildren(childIds: string[]): void;
+    /** @deprecated Use applySetPlacement instead */
     applyRemoveChildren(childIds: string[]): void;
-    updateMbr(): void;
     getLinkTo(): string | undefined;
     getRichText(): RichText | null;
     deserialize(data: SerializedItemData | BaseItemData): this;
@@ -123,7 +139,7 @@ export declare class BaseItem<T extends BaseItem<any> = any> implements Geometry
     emitForManyItems(operation: Operation | BaseOperation): void;
     disableResize(items: BaseItem[]): void;
     enableResize(items: BaseItem[]): void;
-    apply(op: Operation | BaseItemOperation | BaseOperation): void;
+    apply(opIn: Operation | BaseItemOperation | BaseOperation): void;
     protected onPropertyUpdated(property: string, value: any, prevValue: any): void;
     addOnRemoveCallback(cb: () => void): void;
     onRemove(): void;
@@ -140,7 +156,6 @@ export declare class BaseItem<T extends BaseItem<any> = any> implements Geometry
     clearHighlightMbr(): void;
     renderHoverHighlight(context: DrawingContext): void;
     render(context: DrawingContext): void;
-    getIsScalingContainer(): boolean;
     getSnapAnchorPoints(): Point[];
     getPointOnEdge(point: Point, _edge?: string): Point;
     handleTransform(params: TransformParams): TransformResult;
@@ -149,6 +164,13 @@ export declare class BaseItem<T extends BaseItem<any> = any> implements Geometry
     shouldFollowItems(): boolean;
     isAlignmentSource(): boolean;
     isReady(): boolean;
+    protected calculateUpdateHint(op: Operation): UpdateHint;
+    /**
+     * Determines the update requirement for a specific property change.
+     * Concrete items should override this to provide hints for their own properties.
+     */
+    protected getPropertyUpdateHint(property: string): UpdateHint;
+    protected updateVisuals(_op: Operation, _hint: UpdateHint): void;
     onSelectEnd(_topItem?: Item): void;
     canBeInteractedWithWhileLocked(_isAiGenerating: boolean): boolean;
 }

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

@@ -2,13 +2,13 @@ import { Board } from "../../Board";
 import { Mbr, Point } from "../../Items";
 import { ResizeType } from "../../Selection/Transformer/TransformerHelpers/getResizeType";
 import { Comment } from "../Comment/Comment";
-import { ApplyMatrixItem } from "../Transformation/TransformationOperations";
+import { MoveItem } from "../../Geometry/Transformation/TransformationOperations";
 /** Minimal interface for BoardSelection to avoid circular dependencies */
 export interface ISelection {
     items: {
         list(): any[];
     };
-    transformMany(translations: ApplyMatrixItem[], timeStamp: number): void;
+    moveMany(items: MoveItem[], timeStamp: number): void;
     shouldRenderItemsMbr: boolean;
 }
 /** Minimal interface for tools used during transformation */
@@ -35,6 +35,6 @@ export type TransformParams = {
 };
 export type TransformResult = {
     resizedMbr: Mbr | null;
-    translation?: ApplyMatrixItem[] | null;
+    translation?: MoveItem[] | null;
     onPointerUpCb?: () => void;
 };

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

@@ -0,0 +1,12 @@
+export declare enum UpdateHint {
+    /** Only position changed. No geometry or layout recalculation needed. */
+    TranslateOnly = "TranslateOnly",
+    /** Size, rotation, or shear changed. Geometery (paths, vectors) must be recalculated, but text layout can often be skipped. */
+    TransformGeometry = "TransformGeometry",
+    /** Only non-geometric styling properties (colors, opacity) changed. */
+    VisualOnly = "VisualOnly",
+    /** Structural change affecting text flow, wrapping, or container bounds. Full layout recalculation needed. */
+    LayoutAffecting = "LayoutAffecting",
+    /** Everything changed or fallback for unknown operations. Recalculate all state. */
+    FullRebuild = "FullRebuild"
+}