@pixerate/editor 0.32.0 → 0.33.0

package/dist/vector/index.d.cts

@@ -5,6 +5,8 @@ import { C as CommandSpec } from '../registry-D0GADKc7.cjs';
 import '../types-DsiXGmjo.cjs';
 import '../schema-DYDGdYL9.cjs';
 
+/** An affine matrix `[a, b, c, d, e, f]`: `x' = a·x + c·y + e`, `y' = b·x + d·y + f` (SVG order). */
+type VectorMatrix = readonly [number, number, number, number, number, number];
 /** A point in document coordinates. */
 interface Vec2 {
     x: number;
@@ -63,6 +65,13 @@ interface VectorNodeBase {
     locked?: boolean;
     /** 0–1, default 1. */
     opacity?: number;
+    /**
+     * Placement in the parent's space: a rigid matrix (rotation + translation). Anchors and
+     * children are in the node's own space. Omitted for unrotated nodes, whose positions are
+     * stored directly. Scale and skew are never stored here — `transformVectorNode` bakes
+     * them into the geometry, so stroke widths and the rotated selection box stay exact.
+     */
+    transform?: VectorMatrix;
 }
 /** A shape made of one or more subpaths (holes and compound shapes included). */
 interface VectorPathNode extends VectorNodeBase, VectorStyle {
@@ -178,8 +187,16 @@ declare function locateVectorNode(nodes: VectorNode[], id: string): {
 } | null;
 /** Every path node in the subtree (a path node itself, or a group's descendants). */
 declare function collectPathNodes(node: VectorNode): VectorPathNode[];
-/** Geometric bounds of a node (stroke width not included), or null when it has no points. */
-declare function vectorNodeBounds(node: VectorNode): VectorBounds | null;
+/** The node's local → parent matrix (identity when it has no `transform`). */
+declare function nodeMatrix(node: VectorNode): AffineMatrix;
+/** A path node's outline in the space `parent` maps to (default: its parent's space). */
+declare function vectorPathWorldBezier(node: VectorPathNode, parent?: AffineMatrix): BezierPath;
+/**
+ * Geometric bounds of a node (stroke width not included) in the space `parent` maps to —
+ * by default the node's parent space, which for top-level nodes is the document. Null when
+ * the node has no points.
+ */
+declare function vectorNodeBounds(node: VectorNode, parent?: AffineMatrix): VectorBounds | null;
 /** The smallest box around all non-null boxes, or null. */
 declare function unionBounds(list: readonly (VectorBounds | null | undefined)[]): VectorBounds | null;
 /** True when two boxes overlap (touching counts). */
@@ -190,7 +207,7 @@ declare function boundsFromPoints(a: Vec2, b: Vec2): VectorBounds;
  * Whether `p` hits a node: inside its fill (when it has one) or within half its stroke
  * width plus `tolerance` of its outline. A group is hit when any visible child is.
  */
-declare function hitTestVectorNode(node: VectorNode, p: Vec2, tolerance?: number): boolean;
+declare function hitTestVectorNode(node: VectorNode, p: Vec2, tolerance?: number, parent?: AffineMatrix): boolean;
 /** The topmost node hit by `p` (skipping hidden and locked ones), or null. */
 declare function hitTestVectorNodes(nodes: readonly VectorNode[], p: Vec2, tolerance?: number): VectorNode | null;
 interface NearestSegment {
@@ -201,7 +218,7 @@ interface NearestSegment {
     point: Vec2;
     distance: number;
 }
-/** The closest point on any segment of a path node. */
+/** The closest point on any segment of a path node (`p` and the result are in the node's own space). */
 declare function nearestSegment(node: VectorPathNode, p: Vec2): NearestSegment | null;
 declare const IDENTITY_MATRIX: AffineMatrix;
 /** `a` then `b` (apply `a` first). */
@@ -211,8 +228,38 @@ declare function scaleMatrix(sx: number, sy: number, origin?: Vec2): AffineMatri
 /** Rotation by `degrees` clockwise (y points down) around `origin`. */
 declare function rotateMatrix(degrees: number, origin?: Vec2): AffineMatrix;
 declare function applyMatrix(m: AffineMatrix, p: Vec2): Vec2;
-/** A copy of the node with every anchor and handle transformed. Stroke widths are kept. */
+declare function isIdentityMatrix(m: AffineMatrix, eps?: number): boolean;
+/** The inverse matrix (the identity for a singular one). */
+declare function invertMatrix(m: AffineMatrix): AffineMatrix;
+/** Applies only the linear part (for directions and offsets). */
+declare function applyMatrixLinear(m: AffineMatrix, v: Vec2): Vec2;
+/**
+ * The rotation of a matrix in degrees, clockwise (y down), in (−180, 180]. For a mirrored
+ * matrix it is the rotation left after undoing a horizontal flip, so a flipped rotated shape
+ * keeps its angle.
+ */
+declare function matrixRotation(m: AffineMatrix): number;
+/**
+ * Splits `m` into `residual` then `rigid` (`m = residual × rigid` in apply order): `rigid` is
+ * the nearest rotation plus the translation, `residual` the linear rest (scale, skew,
+ * reflection). An unrotated `m` gives an identity `rigid` and everything in `residual`.
+ */
+declare function decomposeRigid(m: AffineMatrix): {
+    rigid: AffineMatrix;
+    residual: AffineMatrix;
+};
+/**
+ * A copy of the node moved by `m`, given in its parent's space. The node's rotation and
+ * translation go to its rigid `transform`; scale and skew are baked into its anchors (or its
+ * children), so the result draws exactly as `m` says. Stroke widths are kept.
+ */
 declare function transformVectorNode<T extends VectorNode>(node: T, m: AffineMatrix): T;
+/** The node's rotation in degrees (from its `transform` and its ancestors' when `parent` is given). */
+declare function vectorNodeRotation(node: VectorNode, parent?: AffineMatrix): number;
+/** The local → document matrix of node `id` (ancestors' transforms included), or null. */
+declare function vectorWorldMatrix(nodes: readonly VectorNode[], id: string): AffineMatrix | null;
+/** The parent space → document matrix of node `id` (identity for top-level nodes), or null. */
+declare function vectorParentMatrix(nodes: readonly VectorNode[], id: string): AffineMatrix | null;
 /** Moves an anchor and its handles by (dx, dy). */
 declare function translateAnchor(a: VectorAnchor, dx: number, dy: number): VectorAnchor;
 /**
@@ -381,8 +428,10 @@ interface VectorEditorState {
     selectedAnchors: readonly VectorAnchorRef[];
     /** The path whose anchors are being edited, if any. */
     editingId: string | null;
-    /** Bounds of the selected nodes in document units. */
+    /** Axis-aligned bounds of the selected nodes in document units. */
     selectionBounds: VectorBounds | null;
+    /** The selection box, rotated with the selection when its nodes share a rotation. */
+    selectionFrame: VectorSelectionFrame | null;
     viewport: VectorViewport;
     defaults: Readonly<Required<Pick<VectorDefaults, 'polygonSides' | 'starPoints' | 'starInnerRatio' | 'cornerRadius'>> & VectorStyle>;
     snap: VectorSnapOptions;
@@ -447,14 +496,57 @@ declare function getVisibleAnchors(state: Pick<VectorEditorState, 'document' | '
  * (direct tool), or of the last anchor of the pen path.
  */
 declare function getVisibleHandles(state: Pick<VectorEditorState, 'document' | 'selection' | 'editingId' | 'tool' | 'pen' | 'selectedAnchors'>): VectorHandleRef[];
-/** Looks up an anchor. */
+/** Looks up an anchor (positions in its node's own space). */
 declare function getAnchor(doc: VectorDocument, ref: VectorAnchorRef): VectorAnchor | undefined;
+/** An anchor with its position and handles in document space (its node's transforms applied). */
+declare function getAnchorWorld(doc: VectorDocument, ref: VectorAnchorRef): {
+    x: number;
+    y: number;
+    in?: Vec2;
+    out?: Vec2;
+    type?: VectorAnchorType;
+} | undefined;
+/**
+ * The selection box: `angle` is the shared rotation of the selected nodes (0 when they
+ * differ), `x / y / width / height` the bounds in the box's own frame (document space
+ * rotated by −angle). A frame point `q` is at `rotateMatrix(angle)` applied to `q`.
+ */
+interface VectorSelectionFrame {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    angle: number;
+}
+/** The selection frame of nodes `ids` (see `VectorSelectionFrame`), or null when they have no points. */
+declare function getVectorSelectionFrame(doc: VectorDocument, ids: readonly string[]): VectorSelectionFrame | null;
 /** Screen positions of the selection box handles for a box given in screen pixels. */
 declare function getTransformHandlePositions(box: VectorBounds): {
     handle: VectorTransformHandle;
     x: number;
     y: number;
 }[];
+/**
+ * Screen geometry of a selection box. `box` and each handle's `x / y` are the unrotated box
+ * in screen pixels; draw them inside a group with `transform` (a `rotate(angle cx cy)`),
+ * or use `screen` for the true on-screen positions (hit-testing).
+ */
+interface VectorSelectionBoxGeometry {
+    box: VectorBounds;
+    angle: number;
+    transform: string;
+    handles: {
+        handle: VectorTransformHandle;
+        x: number;
+        y: number;
+        screen: Vec2;
+    }[];
+    /** The four corners on screen, clockwise from the top left. */
+    corners: Vec2[];
+}
+declare function getVectorSelectionBoxGeometry(frame: VectorSelectionFrame, viewport: VectorViewport): VectorSelectionBoxGeometry;
+/** The resize cursor for a handle of a box rotated by `angle` degrees. */
+declare function vectorResizeCursor(handle: VectorTransformHandle, angle?: number): string;
 declare function vectorToolLabel(tool: VectorTool): string;
 /** Keyboard shortcut of each tool (single letters, no modifiers). */
 declare const VECTOR_TOOL_SHORTCUTS: Readonly<Record<VectorTool, string>>;
@@ -506,6 +598,11 @@ declare class VectorEditorController {
     private computeState;
     private notify;
     private boundsOf;
+    private frameOf;
+    /** Local → document matrix of a node in `doc` (default: the current document). */
+    private worldOf;
+    /** A document point in node `id`'s own space. */
+    private toLocal;
     private cursorFor;
     private snapshot;
     private restore;
@@ -595,16 +692,24 @@ declare class VectorEditorController {
     }): void;
     /** Top-level ids of the selection (members of selected groups are covered by the group). */
     private selectedRoots;
+    /** `m`, given in a frame rotated by `angle`, as a document-space matrix. */
+    private inFrame;
     /** Applies a matrix to the selected (or given) nodes as one undo step. */
     transform(matrix: AffineMatrix, options?: {
         ids?: readonly string[];
         label?: string;
     }): VectorActionResult;
+    /** `doc` with nodes `ids` moved by `m`, given in document space. */
     private transformed;
     translate(dx: number, dy: number, options?: {
         ids?: readonly string[];
     }): VectorActionResult;
-    /** Scales around `origin` (default: the selection centre). */
+    /** The selection frame's centre in document space. */
+    private frameCenter;
+    /**
+     * Scales along the selection box's own axes (rotated with the selection when its nodes
+     * share a rotation) around `origin` (default: the box centre, in document space).
+     */
     scale(sx: number, sy?: number, options?: {
         ids?: readonly string[];
         origin?: Vec2;
@@ -614,6 +719,11 @@ declare class VectorEditorController {
         ids?: readonly string[];
         origin?: Vec2;
     }): VectorActionResult;
+    /** Sets each selected (or given) node's rotation to `degrees`, turning it around its own centre. */
+    setRotation(degrees: number, options?: {
+        ids?: readonly string[];
+    }): VectorActionResult;
+    /** Mirrors along the selection box's own axes. */
     flip(axis: 'horizontal' | 'vertical', options?: {
         ids?: readonly string[];
     }): VectorActionResult;
@@ -660,21 +770,24 @@ declare class VectorEditorController {
     combine(options?: {
         ids?: readonly string[];
     }): string | null;
+    /** A document-space path mapped into the parent space of node `id`. */
+    private intoParentSpace;
     /** Splits selected compound paths into one path per subpath. */
     breakApart(options?: {
         ids?: readonly string[];
     }): VectorActionResult;
     private updateAnchors;
+    /** Moves anchors by a document-space offset (converted into each node's own space). */
     private movedAnchors;
-    /** Moves one anchor to a position (handles follow). */
+    /** Moves one anchor to a document position (handles follow). */
     moveAnchor(ref: VectorAnchorRef, to: Vec2): VectorActionResult;
-    /** Moves one handle (see `moveAnchorHandle` for how the opposite handle follows). */
+    /** Moves one handle to a document position (see `moveAnchorHandle` for how the opposite handle follows). */
     moveHandle(ref: VectorHandleRef, to: Vec2, options?: {
         breakHandles?: boolean;
     }): VectorActionResult;
     /** Converts the selected (or given) anchors between corner, smooth and symmetric. */
     convertAnchors(type: VectorAnchorType, refs?: readonly VectorAnchorRef[]): VectorActionResult;
-    /** Adds an anchor on the nearest segment of `nodeId` to `point` (shape unchanged). */
+    /** Adds an anchor on the nearest segment of `nodeId` to document point `point` (shape unchanged). */
     insertAnchorAt(nodeId: string, point: Vec2): VectorAnchorRef | null;
     /** Deletes the selected anchors; empty subpaths and paths go too. */
     deleteAnchors(refs?: readonly VectorAnchorRef[]): VectorActionResult;
@@ -744,6 +857,8 @@ declare function scaleFor(handle: VectorTransformHandle, b: VectorBounds, p: Vec
 interface VectorRenderPath {
     kind: 'path';
     id: string;
+    /** SVG `transform` (`matrix(…)`) for a rotated node. */
+    transform?: string;
     d: string;
     /** `none`, a colour, or `url(#id)` of a gradient in `defs`. */
     fill: string;
@@ -758,6 +873,8 @@ interface VectorRenderPath {
 interface VectorRenderGroup {
     kind: 'group';
     id: string;
+    /** SVG `transform` (`matrix(…)`) for a rotated group. */
+    transform?: string;
     opacity: number;
     children: VectorRenderNode[];
 }
@@ -800,18 +917,17 @@ interface VectorOverlayRenderData {
         d: string;
         selected: boolean;
     }[];
-    /** Selection box with resize and rotate handles (select tool), screen space. */
-    selectionBox: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-        handles: {
-            handle: VectorTransformHandle;
-            x: number;
-            y: number;
-        }[];
-    } | null;
+    /**
+     * Selection box with resize and rotate handles (select tool). `x / y / width / height` and
+     * each handle's `x / y` are the unrotated box in screen pixels: draw them inside
+     * `<g transform={transform}>`. `corners` and each handle's `screen` are true positions.
+     */
+    selectionBox: (VectorBounds & {
+        angle: number;
+        transform: string;
+        corners: Vec2[];
+        handles: VectorSelectionBoxGeometry['handles'];
+    }) | null;
     anchors: VectorRenderAnchor[];
     handles: VectorRenderHandle[];
     /** Marquee rectangle, screen space. */
@@ -906,12 +1022,15 @@ interface VectorNodeListing {
     type: 'path' | 'group';
     name?: string;
     depth: number;
+    /** Axis-aligned bounds in document units. */
     bounds: {
         x: number;
         y: number;
         width: number;
         height: number;
     } | null;
+    /** Rotation in degrees, clockwise (ancestors' rotations included). */
+    rotation: number;
     visible: boolean;
     locked: boolean;
     selected: boolean;
@@ -930,4 +1049,4 @@ interface VectorNodeListing {
  */
 declare function createVectorCommands(controller: VectorEditorController, options?: VectorCommandOptions): CommandSpec[];
 
-export { type AddVectorNodeOptions, AffineMatrix, IDENTITY_MATRIX, KAPPA, type NearestSegment, SvgGradientDef, VECTOR_CLIPBOARD_TYPE, VECTOR_OVERLAY_THEME, VECTOR_ROTATE_HANDLE_OFFSET, VECTOR_TOOLS, VECTOR_TOOL_GLYPHS, VECTOR_TOOL_SHORTCUTS, VECTOR_TRANSFORM_HANDLES, type Vec2, type VectorActionResult, type VectorAlign, type VectorAnchor, type VectorAnchorRef, type VectorAnchorType, type VectorArrange, type VectorBooleanOperation, type VectorBounds, type VectorCommandOptions, type VectorDefaults, type VectorDistribute, type VectorDocument, VectorEditorController, type VectorEditorOptions, type VectorEditorState, type VectorFillRule, type VectorGroupNode, type VectorHandleRef, type VectorHover, type VectorInteraction, type VectorKeyInput, type VectorLineCap, type VectorLineJoin, type VectorModifiers, type VectorNode, type VectorNodeListing, type VectorOverlayRenderData, type VectorPaint, type VectorPathNode, type VectorPointerInput, type VectorRenderAnchor, type VectorRenderGroup, type VectorRenderHandle, type VectorRenderNode, type VectorRenderPath, type VectorSceneRenderData, type VectorSelectionStyle, type VectorShapeInput, type VectorSnapOptions, type VectorStyle, type VectorSubpath, type VectorSvgExportOptions, type VectorSvgImportOptions, type VectorTool, type VectorTransformHandle, type VectorViewport, applyMatrix, bezierToSubpaths, boundsFromPoints, boundsIntersect, cloneAnchor, cloneSubpath, cloneVectorDocument, cloneVectorNode, collectPathNodes, convertAnchor, createVectorCommands, ellipseSubpath, findVectorNode, getAnchor, getEditablePathIds, getTransformHandlePositions, getVectorOverlayRenderData, getVectorSceneRenderData, getVectorSelectionStyle, getVisibleAnchors, getVisibleHandles, hasPaint, hitTestVectorNode, hitTestVectorNodes, inferAnchorType, insertAnchor, isVectorTextTarget, lineSubpath, locateVectorNode, moveAnchorHandle, multiplyMatrices, nearestSegment, parseSvgTransform, parseVectorSvg, polygonSubpath, rectSubpath, removeAnchors, reverseSubpath, rotateMatrix, roundSubpaths, scaleFor, scaleMatrix, starSubpath, subpathSegment, subpathSegmentCount, subpathsToBezier, toVectorKeyInput, toVectorModifiers, toVectorPointerInput, transformVectorNode, translateAnchor, translateMatrix, unionBounds, vectorDocumentToSvg, vectorNodeBounds, vectorNodeToBezier, vectorPaintToHex, vectorPaintToSvg, vectorPathData, vectorToolLabel, walkVectorNodes };
+export { type AddVectorNodeOptions, AffineMatrix, IDENTITY_MATRIX, KAPPA, type NearestSegment, SvgGradientDef, VECTOR_CLIPBOARD_TYPE, VECTOR_OVERLAY_THEME, VECTOR_ROTATE_HANDLE_OFFSET, VECTOR_TOOLS, VECTOR_TOOL_GLYPHS, VECTOR_TOOL_SHORTCUTS, VECTOR_TRANSFORM_HANDLES, type Vec2, type VectorActionResult, type VectorAlign, type VectorAnchor, type VectorAnchorRef, type VectorAnchorType, type VectorArrange, type VectorBooleanOperation, type VectorBounds, type VectorCommandOptions, type VectorDefaults, type VectorDistribute, type VectorDocument, VectorEditorController, type VectorEditorOptions, type VectorEditorState, type VectorFillRule, type VectorGroupNode, type VectorHandleRef, type VectorHover, type VectorInteraction, type VectorKeyInput, type VectorLineCap, type VectorLineJoin, type VectorMatrix, type VectorModifiers, type VectorNode, type VectorNodeListing, type VectorOverlayRenderData, type VectorPaint, type VectorPathNode, type VectorPointerInput, type VectorRenderAnchor, type VectorRenderGroup, type VectorRenderHandle, type VectorRenderNode, type VectorRenderPath, type VectorSceneRenderData, type VectorSelectionBoxGeometry, type VectorSelectionFrame, type VectorSelectionStyle, type VectorShapeInput, type VectorSnapOptions, type VectorStyle, type VectorSubpath, type VectorSvgExportOptions, type VectorSvgImportOptions, type VectorTool, type VectorTransformHandle, type VectorViewport, applyMatrix, applyMatrixLinear, bezierToSubpaths, boundsFromPoints, boundsIntersect, cloneAnchor, cloneSubpath, cloneVectorDocument, cloneVectorNode, collectPathNodes, convertAnchor, createVectorCommands, decomposeRigid, ellipseSubpath, findVectorNode, getAnchor, getAnchorWorld, getEditablePathIds, getTransformHandlePositions, getVectorOverlayRenderData, getVectorSceneRenderData, getVectorSelectionBoxGeometry, getVectorSelectionFrame, getVectorSelectionStyle, getVisibleAnchors, getVisibleHandles, hasPaint, hitTestVectorNode, hitTestVectorNodes, inferAnchorType, insertAnchor, invertMatrix, isIdentityMatrix, isVectorTextTarget, lineSubpath, locateVectorNode, matrixRotation, moveAnchorHandle, multiplyMatrices, nearestSegment, nodeMatrix, parseSvgTransform, parseVectorSvg, polygonSubpath, rectSubpath, removeAnchors, reverseSubpath, rotateMatrix, roundSubpaths, scaleFor, scaleMatrix, starSubpath, subpathSegment, subpathSegmentCount, subpathsToBezier, toVectorKeyInput, toVectorModifiers, toVectorPointerInput, transformVectorNode, translateAnchor, translateMatrix, unionBounds, vectorDocumentToSvg, vectorNodeBounds, vectorNodeRotation, vectorNodeToBezier, vectorPaintToHex, vectorPaintToSvg, vectorParentMatrix, vectorPathData, vectorPathWorldBezier, vectorResizeCursor, vectorToolLabel, vectorWorldMatrix, walkVectorNodes };

package/dist/vector/index.d.ts

@@ -5,6 +5,8 @@ import { C as CommandSpec } from '../registry-DhVUZioj.js';
 import '../types-DsiXGmjo.js';
 import '../schema-DYDGdYL9.js';
 
+/** An affine matrix `[a, b, c, d, e, f]`: `x' = a·x + c·y + e`, `y' = b·x + d·y + f` (SVG order). */
+type VectorMatrix = readonly [number, number, number, number, number, number];
 /** A point in document coordinates. */
 interface Vec2 {
     x: number;
@@ -63,6 +65,13 @@ interface VectorNodeBase {
     locked?: boolean;
     /** 0–1, default 1. */
     opacity?: number;
+    /**
+     * Placement in the parent's space: a rigid matrix (rotation + translation). Anchors and
+     * children are in the node's own space. Omitted for unrotated nodes, whose positions are
+     * stored directly. Scale and skew are never stored here — `transformVectorNode` bakes
+     * them into the geometry, so stroke widths and the rotated selection box stay exact.
+     */
+    transform?: VectorMatrix;
 }
 /** A shape made of one or more subpaths (holes and compound shapes included). */
 interface VectorPathNode extends VectorNodeBase, VectorStyle {
@@ -178,8 +187,16 @@ declare function locateVectorNode(nodes: VectorNode[], id: string): {
 } | null;
 /** Every path node in the subtree (a path node itself, or a group's descendants). */
 declare function collectPathNodes(node: VectorNode): VectorPathNode[];
-/** Geometric bounds of a node (stroke width not included), or null when it has no points. */
-declare function vectorNodeBounds(node: VectorNode): VectorBounds | null;
+/** The node's local → parent matrix (identity when it has no `transform`). */
+declare function nodeMatrix(node: VectorNode): AffineMatrix;
+/** A path node's outline in the space `parent` maps to (default: its parent's space). */
+declare function vectorPathWorldBezier(node: VectorPathNode, parent?: AffineMatrix): BezierPath;
+/**
+ * Geometric bounds of a node (stroke width not included) in the space `parent` maps to —
+ * by default the node's parent space, which for top-level nodes is the document. Null when
+ * the node has no points.
+ */
+declare function vectorNodeBounds(node: VectorNode, parent?: AffineMatrix): VectorBounds | null;
 /** The smallest box around all non-null boxes, or null. */
 declare function unionBounds(list: readonly (VectorBounds | null | undefined)[]): VectorBounds | null;
 /** True when two boxes overlap (touching counts). */
@@ -190,7 +207,7 @@ declare function boundsFromPoints(a: Vec2, b: Vec2): VectorBounds;
  * Whether `p` hits a node: inside its fill (when it has one) or within half its stroke
  * width plus `tolerance` of its outline. A group is hit when any visible child is.
  */
-declare function hitTestVectorNode(node: VectorNode, p: Vec2, tolerance?: number): boolean;
+declare function hitTestVectorNode(node: VectorNode, p: Vec2, tolerance?: number, parent?: AffineMatrix): boolean;
 /** The topmost node hit by `p` (skipping hidden and locked ones), or null. */
 declare function hitTestVectorNodes(nodes: readonly VectorNode[], p: Vec2, tolerance?: number): VectorNode | null;
 interface NearestSegment {
@@ -201,7 +218,7 @@ interface NearestSegment {
     point: Vec2;
     distance: number;
 }
-/** The closest point on any segment of a path node. */
+/** The closest point on any segment of a path node (`p` and the result are in the node's own space). */
 declare function nearestSegment(node: VectorPathNode, p: Vec2): NearestSegment | null;
 declare const IDENTITY_MATRIX: AffineMatrix;
 /** `a` then `b` (apply `a` first). */
@@ -211,8 +228,38 @@ declare function scaleMatrix(sx: number, sy: number, origin?: Vec2): AffineMatri
 /** Rotation by `degrees` clockwise (y points down) around `origin`. */
 declare function rotateMatrix(degrees: number, origin?: Vec2): AffineMatrix;
 declare function applyMatrix(m: AffineMatrix, p: Vec2): Vec2;
-/** A copy of the node with every anchor and handle transformed. Stroke widths are kept. */
+declare function isIdentityMatrix(m: AffineMatrix, eps?: number): boolean;
+/** The inverse matrix (the identity for a singular one). */
+declare function invertMatrix(m: AffineMatrix): AffineMatrix;
+/** Applies only the linear part (for directions and offsets). */
+declare function applyMatrixLinear(m: AffineMatrix, v: Vec2): Vec2;
+/**
+ * The rotation of a matrix in degrees, clockwise (y down), in (−180, 180]. For a mirrored
+ * matrix it is the rotation left after undoing a horizontal flip, so a flipped rotated shape
+ * keeps its angle.
+ */
+declare function matrixRotation(m: AffineMatrix): number;
+/**
+ * Splits `m` into `residual` then `rigid` (`m = residual × rigid` in apply order): `rigid` is
+ * the nearest rotation plus the translation, `residual` the linear rest (scale, skew,
+ * reflection). An unrotated `m` gives an identity `rigid` and everything in `residual`.
+ */
+declare function decomposeRigid(m: AffineMatrix): {
+    rigid: AffineMatrix;
+    residual: AffineMatrix;
+};
+/**
+ * A copy of the node moved by `m`, given in its parent's space. The node's rotation and
+ * translation go to its rigid `transform`; scale and skew are baked into its anchors (or its
+ * children), so the result draws exactly as `m` says. Stroke widths are kept.
+ */
 declare function transformVectorNode<T extends VectorNode>(node: T, m: AffineMatrix): T;
+/** The node's rotation in degrees (from its `transform` and its ancestors' when `parent` is given). */
+declare function vectorNodeRotation(node: VectorNode, parent?: AffineMatrix): number;
+/** The local → document matrix of node `id` (ancestors' transforms included), or null. */
+declare function vectorWorldMatrix(nodes: readonly VectorNode[], id: string): AffineMatrix | null;
+/** The parent space → document matrix of node `id` (identity for top-level nodes), or null. */
+declare function vectorParentMatrix(nodes: readonly VectorNode[], id: string): AffineMatrix | null;
 /** Moves an anchor and its handles by (dx, dy). */
 declare function translateAnchor(a: VectorAnchor, dx: number, dy: number): VectorAnchor;
 /**
@@ -381,8 +428,10 @@ interface VectorEditorState {
     selectedAnchors: readonly VectorAnchorRef[];
     /** The path whose anchors are being edited, if any. */
     editingId: string | null;
-    /** Bounds of the selected nodes in document units. */
+    /** Axis-aligned bounds of the selected nodes in document units. */
     selectionBounds: VectorBounds | null;
+    /** The selection box, rotated with the selection when its nodes share a rotation. */
+    selectionFrame: VectorSelectionFrame | null;
     viewport: VectorViewport;
     defaults: Readonly<Required<Pick<VectorDefaults, 'polygonSides' | 'starPoints' | 'starInnerRatio' | 'cornerRadius'>> & VectorStyle>;
     snap: VectorSnapOptions;
@@ -447,14 +496,57 @@ declare function getVisibleAnchors(state: Pick<VectorEditorState, 'document' | '
  * (direct tool), or of the last anchor of the pen path.
  */
 declare function getVisibleHandles(state: Pick<VectorEditorState, 'document' | 'selection' | 'editingId' | 'tool' | 'pen' | 'selectedAnchors'>): VectorHandleRef[];
-/** Looks up an anchor. */
+/** Looks up an anchor (positions in its node's own space). */
 declare function getAnchor(doc: VectorDocument, ref: VectorAnchorRef): VectorAnchor | undefined;
+/** An anchor with its position and handles in document space (its node's transforms applied). */
+declare function getAnchorWorld(doc: VectorDocument, ref: VectorAnchorRef): {
+    x: number;
+    y: number;
+    in?: Vec2;
+    out?: Vec2;
+    type?: VectorAnchorType;
+} | undefined;
+/**
+ * The selection box: `angle` is the shared rotation of the selected nodes (0 when they
+ * differ), `x / y / width / height` the bounds in the box's own frame (document space
+ * rotated by −angle). A frame point `q` is at `rotateMatrix(angle)` applied to `q`.
+ */
+interface VectorSelectionFrame {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    angle: number;
+}
+/** The selection frame of nodes `ids` (see `VectorSelectionFrame`), or null when they have no points. */
+declare function getVectorSelectionFrame(doc: VectorDocument, ids: readonly string[]): VectorSelectionFrame | null;
 /** Screen positions of the selection box handles for a box given in screen pixels. */
 declare function getTransformHandlePositions(box: VectorBounds): {
     handle: VectorTransformHandle;
     x: number;
     y: number;
 }[];
+/**
+ * Screen geometry of a selection box. `box` and each handle's `x / y` are the unrotated box
+ * in screen pixels; draw them inside a group with `transform` (a `rotate(angle cx cy)`),
+ * or use `screen` for the true on-screen positions (hit-testing).
+ */
+interface VectorSelectionBoxGeometry {
+    box: VectorBounds;
+    angle: number;
+    transform: string;
+    handles: {
+        handle: VectorTransformHandle;
+        x: number;
+        y: number;
+        screen: Vec2;
+    }[];
+    /** The four corners on screen, clockwise from the top left. */
+    corners: Vec2[];
+}
+declare function getVectorSelectionBoxGeometry(frame: VectorSelectionFrame, viewport: VectorViewport): VectorSelectionBoxGeometry;
+/** The resize cursor for a handle of a box rotated by `angle` degrees. */
+declare function vectorResizeCursor(handle: VectorTransformHandle, angle?: number): string;
 declare function vectorToolLabel(tool: VectorTool): string;
 /** Keyboard shortcut of each tool (single letters, no modifiers). */
 declare const VECTOR_TOOL_SHORTCUTS: Readonly<Record<VectorTool, string>>;
@@ -506,6 +598,11 @@ declare class VectorEditorController {
     private computeState;
     private notify;
     private boundsOf;
+    private frameOf;
+    /** Local → document matrix of a node in `doc` (default: the current document). */
+    private worldOf;
+    /** A document point in node `id`'s own space. */
+    private toLocal;
     private cursorFor;
     private snapshot;
     private restore;
@@ -595,16 +692,24 @@ declare class VectorEditorController {
     }): void;
     /** Top-level ids of the selection (members of selected groups are covered by the group). */
     private selectedRoots;
+    /** `m`, given in a frame rotated by `angle`, as a document-space matrix. */
+    private inFrame;
     /** Applies a matrix to the selected (or given) nodes as one undo step. */
     transform(matrix: AffineMatrix, options?: {
         ids?: readonly string[];
         label?: string;
     }): VectorActionResult;
+    /** `doc` with nodes `ids` moved by `m`, given in document space. */
     private transformed;
     translate(dx: number, dy: number, options?: {
         ids?: readonly string[];
     }): VectorActionResult;
-    /** Scales around `origin` (default: the selection centre). */
+    /** The selection frame's centre in document space. */
+    private frameCenter;
+    /**
+     * Scales along the selection box's own axes (rotated with the selection when its nodes
+     * share a rotation) around `origin` (default: the box centre, in document space).
+     */
     scale(sx: number, sy?: number, options?: {
         ids?: readonly string[];
         origin?: Vec2;
@@ -614,6 +719,11 @@ declare class VectorEditorController {
         ids?: readonly string[];
         origin?: Vec2;
     }): VectorActionResult;
+    /** Sets each selected (or given) node's rotation to `degrees`, turning it around its own centre. */
+    setRotation(degrees: number, options?: {
+        ids?: readonly string[];
+    }): VectorActionResult;
+    /** Mirrors along the selection box's own axes. */
     flip(axis: 'horizontal' | 'vertical', options?: {
         ids?: readonly string[];
     }): VectorActionResult;
@@ -660,21 +770,24 @@ declare class VectorEditorController {
     combine(options?: {
         ids?: readonly string[];
     }): string | null;
+    /** A document-space path mapped into the parent space of node `id`. */
+    private intoParentSpace;
     /** Splits selected compound paths into one path per subpath. */
     breakApart(options?: {
         ids?: readonly string[];
     }): VectorActionResult;
     private updateAnchors;
+    /** Moves anchors by a document-space offset (converted into each node's own space). */
     private movedAnchors;
-    /** Moves one anchor to a position (handles follow). */
+    /** Moves one anchor to a document position (handles follow). */
     moveAnchor(ref: VectorAnchorRef, to: Vec2): VectorActionResult;
-    /** Moves one handle (see `moveAnchorHandle` for how the opposite handle follows). */
+    /** Moves one handle to a document position (see `moveAnchorHandle` for how the opposite handle follows). */
     moveHandle(ref: VectorHandleRef, to: Vec2, options?: {
         breakHandles?: boolean;
     }): VectorActionResult;
     /** Converts the selected (or given) anchors between corner, smooth and symmetric. */
     convertAnchors(type: VectorAnchorType, refs?: readonly VectorAnchorRef[]): VectorActionResult;
-    /** Adds an anchor on the nearest segment of `nodeId` to `point` (shape unchanged). */
+    /** Adds an anchor on the nearest segment of `nodeId` to document point `point` (shape unchanged). */
     insertAnchorAt(nodeId: string, point: Vec2): VectorAnchorRef | null;
     /** Deletes the selected anchors; empty subpaths and paths go too. */
     deleteAnchors(refs?: readonly VectorAnchorRef[]): VectorActionResult;
@@ -744,6 +857,8 @@ declare function scaleFor(handle: VectorTransformHandle, b: VectorBounds, p: Vec
 interface VectorRenderPath {
     kind: 'path';
     id: string;
+    /** SVG `transform` (`matrix(…)`) for a rotated node. */
+    transform?: string;
     d: string;
     /** `none`, a colour, or `url(#id)` of a gradient in `defs`. */
     fill: string;
@@ -758,6 +873,8 @@ interface VectorRenderPath {
 interface VectorRenderGroup {
     kind: 'group';
     id: string;
+    /** SVG `transform` (`matrix(…)`) for a rotated group. */
+    transform?: string;
     opacity: number;
     children: VectorRenderNode[];
 }
@@ -800,18 +917,17 @@ interface VectorOverlayRenderData {
         d: string;
         selected: boolean;
     }[];
-    /** Selection box with resize and rotate handles (select tool), screen space. */
-    selectionBox: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-        handles: {
-            handle: VectorTransformHandle;
-            x: number;
-            y: number;
-        }[];
-    } | null;
+    /**
+     * Selection box with resize and rotate handles (select tool). `x / y / width / height` and
+     * each handle's `x / y` are the unrotated box in screen pixels: draw them inside
+     * `<g transform={transform}>`. `corners` and each handle's `screen` are true positions.
+     */
+    selectionBox: (VectorBounds & {
+        angle: number;
+        transform: string;
+        corners: Vec2[];
+        handles: VectorSelectionBoxGeometry['handles'];
+    }) | null;
     anchors: VectorRenderAnchor[];
     handles: VectorRenderHandle[];
     /** Marquee rectangle, screen space. */
@@ -906,12 +1022,15 @@ interface VectorNodeListing {
     type: 'path' | 'group';
     name?: string;
     depth: number;
+    /** Axis-aligned bounds in document units. */
     bounds: {
         x: number;
         y: number;
         width: number;
         height: number;
     } | null;
+    /** Rotation in degrees, clockwise (ancestors' rotations included). */
+    rotation: number;
     visible: boolean;
     locked: boolean;
     selected: boolean;
@@ -930,4 +1049,4 @@ interface VectorNodeListing {
  */
 declare function createVectorCommands(controller: VectorEditorController, options?: VectorCommandOptions): CommandSpec[];
 
-export { type AddVectorNodeOptions, AffineMatrix, IDENTITY_MATRIX, KAPPA, type NearestSegment, SvgGradientDef, VECTOR_CLIPBOARD_TYPE, VECTOR_OVERLAY_THEME, VECTOR_ROTATE_HANDLE_OFFSET, VECTOR_TOOLS, VECTOR_TOOL_GLYPHS, VECTOR_TOOL_SHORTCUTS, VECTOR_TRANSFORM_HANDLES, type Vec2, type VectorActionResult, type VectorAlign, type VectorAnchor, type VectorAnchorRef, type VectorAnchorType, type VectorArrange, type VectorBooleanOperation, type VectorBounds, type VectorCommandOptions, type VectorDefaults, type VectorDistribute, type VectorDocument, VectorEditorController, type VectorEditorOptions, type VectorEditorState, type VectorFillRule, type VectorGroupNode, type VectorHandleRef, type VectorHover, type VectorInteraction, type VectorKeyInput, type VectorLineCap, type VectorLineJoin, type VectorModifiers, type VectorNode, type VectorNodeListing, type VectorOverlayRenderData, type VectorPaint, type VectorPathNode, type VectorPointerInput, type VectorRenderAnchor, type VectorRenderGroup, type VectorRenderHandle, type VectorRenderNode, type VectorRenderPath, type VectorSceneRenderData, type VectorSelectionStyle, type VectorShapeInput, type VectorSnapOptions, type VectorStyle, type VectorSubpath, type VectorSvgExportOptions, type VectorSvgImportOptions, type VectorTool, type VectorTransformHandle, type VectorViewport, applyMatrix, bezierToSubpaths, boundsFromPoints, boundsIntersect, cloneAnchor, cloneSubpath, cloneVectorDocument, cloneVectorNode, collectPathNodes, convertAnchor, createVectorCommands, ellipseSubpath, findVectorNode, getAnchor, getEditablePathIds, getTransformHandlePositions, getVectorOverlayRenderData, getVectorSceneRenderData, getVectorSelectionStyle, getVisibleAnchors, getVisibleHandles, hasPaint, hitTestVectorNode, hitTestVectorNodes, inferAnchorType, insertAnchor, isVectorTextTarget, lineSubpath, locateVectorNode, moveAnchorHandle, multiplyMatrices, nearestSegment, parseSvgTransform, parseVectorSvg, polygonSubpath, rectSubpath, removeAnchors, reverseSubpath, rotateMatrix, roundSubpaths, scaleFor, scaleMatrix, starSubpath, subpathSegment, subpathSegmentCount, subpathsToBezier, toVectorKeyInput, toVectorModifiers, toVectorPointerInput, transformVectorNode, translateAnchor, translateMatrix, unionBounds, vectorDocumentToSvg, vectorNodeBounds, vectorNodeToBezier, vectorPaintToHex, vectorPaintToSvg, vectorPathData, vectorToolLabel, walkVectorNodes };
+export { type AddVectorNodeOptions, AffineMatrix, IDENTITY_MATRIX, KAPPA, type NearestSegment, SvgGradientDef, VECTOR_CLIPBOARD_TYPE, VECTOR_OVERLAY_THEME, VECTOR_ROTATE_HANDLE_OFFSET, VECTOR_TOOLS, VECTOR_TOOL_GLYPHS, VECTOR_TOOL_SHORTCUTS, VECTOR_TRANSFORM_HANDLES, type Vec2, type VectorActionResult, type VectorAlign, type VectorAnchor, type VectorAnchorRef, type VectorAnchorType, type VectorArrange, type VectorBooleanOperation, type VectorBounds, type VectorCommandOptions, type VectorDefaults, type VectorDistribute, type VectorDocument, VectorEditorController, type VectorEditorOptions, type VectorEditorState, type VectorFillRule, type VectorGroupNode, type VectorHandleRef, type VectorHover, type VectorInteraction, type VectorKeyInput, type VectorLineCap, type VectorLineJoin, type VectorMatrix, type VectorModifiers, type VectorNode, type VectorNodeListing, type VectorOverlayRenderData, type VectorPaint, type VectorPathNode, type VectorPointerInput, type VectorRenderAnchor, type VectorRenderGroup, type VectorRenderHandle, type VectorRenderNode, type VectorRenderPath, type VectorSceneRenderData, type VectorSelectionBoxGeometry, type VectorSelectionFrame, type VectorSelectionStyle, type VectorShapeInput, type VectorSnapOptions, type VectorStyle, type VectorSubpath, type VectorSvgExportOptions, type VectorSvgImportOptions, type VectorTool, type VectorTransformHandle, type VectorViewport, applyMatrix, applyMatrixLinear, bezierToSubpaths, boundsFromPoints, boundsIntersect, cloneAnchor, cloneSubpath, cloneVectorDocument, cloneVectorNode, collectPathNodes, convertAnchor, createVectorCommands, decomposeRigid, ellipseSubpath, findVectorNode, getAnchor, getAnchorWorld, getEditablePathIds, getTransformHandlePositions, getVectorOverlayRenderData, getVectorSceneRenderData, getVectorSelectionBoxGeometry, getVectorSelectionFrame, getVectorSelectionStyle, getVisibleAnchors, getVisibleHandles, hasPaint, hitTestVectorNode, hitTestVectorNodes, inferAnchorType, insertAnchor, invertMatrix, isIdentityMatrix, isVectorTextTarget, lineSubpath, locateVectorNode, matrixRotation, moveAnchorHandle, multiplyMatrices, nearestSegment, nodeMatrix, parseSvgTransform, parseVectorSvg, polygonSubpath, rectSubpath, removeAnchors, reverseSubpath, rotateMatrix, roundSubpaths, scaleFor, scaleMatrix, starSubpath, subpathSegment, subpathSegmentCount, subpathsToBezier, toVectorKeyInput, toVectorModifiers, toVectorPointerInput, transformVectorNode, translateAnchor, translateMatrix, unionBounds, vectorDocumentToSvg, vectorNodeBounds, vectorNodeRotation, vectorNodeToBezier, vectorPaintToHex, vectorPaintToSvg, vectorParentMatrix, vectorPathData, vectorPathWorldBezier, vectorResizeCursor, vectorToolLabel, vectorWorldMatrix, walkVectorNodes };