@scrawl-board/board 0.1.0-beta.0 → 0.1.0-beta.10

package/dist/core.d.ts

@@ -1,16 +1,78 @@
-declare const documentIdBrand: unique symbol;
-declare const strokeIdBrand: unique symbol;
-type DocumentId = string & {
-    readonly [documentIdBrand]: "DocumentId";
-};
-type StrokeId = string & {
-    readonly [strokeIdBrand]: "StrokeId";
-};
-declare function documentId(value: string): DocumentId;
-declare function strokeId(value: string): StrokeId;
-
 /** Wire grammar: `asset:<namespace>:<opaque-id>`. Interpreted only by the Host. */
 type AssetRef = string;
+declare const ASSET_REF_PATTERN: RegExp;
+/** Hard ceiling on a reference's own wire length — independent of any resource limit below. */
+declare const ASSET_REF_MAX_BYTES = 512;
+declare function isAssetRef(value: unknown): value is AssetRef;
+/** Throws on malformed input; use `isAssetRef` where a boolean is wanted instead. */
+declare function assetRef(value: string): AssetRef;
+type AssetKind = "image";
+type AssetPurpose = "render" | "thumbnail" | "export";
+interface AssetResolveRequest {
+    ref: AssetRef;
+    kind: AssetKind;
+    purpose: AssetPurpose;
+    signal: AbortSignal;
+}
+interface AssetResolveResult {
+    bytes: Uint8Array;
+    mediaType: string;
+}
+/**
+ * Host-owned lookup. Scrawl passes only the reference, kind, purpose, and
+ * signal — never Document contents, an Extension instance, or credentials.
+ * The returned bytes are copied into SDK-owned storage and independently
+ * validated before use; a resolver's claimed `mediaType` is never trusted
+ * on its own (see `assetValidation.ts`).
+ */
+interface AssetResolver {
+    resolve(request: AssetResolveRequest): Promise<AssetResolveResult>;
+}
+interface AssetIngestRequest {
+    bytes: Uint8Array;
+    mediaType: string;
+    name?: string;
+    signal: AbortSignal;
+}
+interface AssetIngestResult {
+    ref: AssetRef;
+}
+/**
+ * Host-owned upload/creation path. Scrawl validates the candidate against
+ * SDK limits before calling this, and validates the returned reference
+ * before it can enter any command. Cancellation or failure creates no
+ * Document object, Op, or history entry.
+ */
+interface AssetIngestor {
+    ingest(request: AssetIngestRequest): Promise<AssetIngestResult>;
+}
+type AssetResolutionErrorCode = "resolver-unavailable" | "not-found" | "forbidden" | "offline" | "unsupported-type" | "too-large" | "invalid-content" | "decode-failed" | "budget-exceeded" | "aborted" | "unknown";
+declare class AssetResolutionError extends Error {
+    readonly code: AssetResolutionErrorCode;
+    readonly retryable: boolean;
+    readonly ref?: AssetRef | undefined;
+    constructor(code: AssetResolutionErrorCode, retryable: boolean, message: string, ref?: AssetRef | undefined);
+}
+/** Runtime event for a resolution/ingestion failure — never carries credentials or a fetchable location. */
+interface AssetDiagnostic {
+    code: AssetResolutionErrorCode;
+    ref?: AssetRef;
+    objectId: string;
+    objectKind: "image" | "custom";
+    retryable: boolean;
+}
+declare const ASSET_MAX_ENCODED_BYTES: number;
+declare const ASSET_MAX_DIMENSION_PX = 8192;
+declare const ASSET_MAX_DECODED_MEGAPIXELS = 40;
+declare const ASSET_MAX_CONCURRENT_RESOLUTIONS = 6;
+declare const ASSET_CACHE_BYTES_DEFAULT: number;
+declare const ASSET_CACHE_BYTES_MIN: number;
+declare const ASSET_CACHE_BYTES_MAX: number;
+declare const ASSET_EXPORT_MAX_ENCODED_BYTES: number;
+declare const ASSET_EXPORT_MAX_DECODED_MEGAPIXELS = 100;
+declare const SUPPORTED_ASSET_MEDIA_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
+type SupportedAssetMediaType = (typeof SUPPORTED_ASSET_MEDIA_TYPES)[number];
+declare function clampAssetCacheBytes(value: number | undefined): number;
 
 type Mat2x3 = [number, number, number, number, number, number];
 declare const IDENTITY: Mat2x3;
@@ -69,6 +131,7 @@ interface CustomBoardObject {
     };
     props: JsonValue;
 }
+declare function cloneCustomObject(object: CustomBoardObject): CustomBoardObject;
 /**
  * The read-only view handed to `describe`. Deep-readonly by construction
  * (not derived via a shallow `Readonly<>`) because `describe` must treat its
@@ -106,7 +169,22 @@ interface CustomObjectDefinition<Props extends JsonValue = JsonValue> {
     parse(input: unknown, schemaVersion: number): Props;
     /** One pure, synchronous step per consecutive schema version. */
     migrate?: Readonly<Record<number, (oldProps: JsonValue) => JsonValue>>;
-    describe(object: ReadonlyCustomObject<Props>, context: ObjectDescribeContext): BoardScene$1;
+    describe(object: ReadonlyCustomObject<Props>, context: ObjectDescribeContext): BoardScene;
+    /**
+     * Optional point-level hit-test precision (Phase 8). Every custom object
+     * hit-tests against its bounding box (`fallback.bounds`) by default — this
+     * lets a non-rectangular shape (e.g. a circular card, an L-shaped region)
+     * reject a point that's inside that box but outside its actual visible
+     * silhouette, tightening a click/marquee/raycast hit to the shape's real
+     * outline. `point` is in this object's own local space — the same
+     * untransformed space `describe`'s returned geometry already lives in
+     * (the caller inverse-transforms the pointer's board point through
+     * `object.transform` before calling this). Absent means every point
+     * inside the bounding box hits, matching pre-Phase-8 behavior exactly.
+     * Rejecting a point here does not fall through to whatever's underneath —
+     * the gesture simply misses this object, same as clicking empty space.
+     */
+    hitTest?(object: ReadonlyCustomObject<Props>, point: BoardPoint): boolean;
 }
 interface SceneNodeBase {
     key: string;
@@ -138,9 +216,18 @@ interface SceneText extends SceneNodeBase {
 }
 interface SceneGroup extends SceneNodeBase {
     kind: "group";
-    children: readonly BoardScene$1[];
+    children: readonly BoardScene[];
 }
-interface ScenePath$1 extends SceneNodeBase {
+/**
+ * **No renderer or SVG-export interpreter exists for this node kind yet**
+ * (tracked as deferred work — see `renderer/shapes/customObjects.ts`'s
+ * `"path"` case). Returning a `ScenePath` from `describe()` renders nothing,
+ * exports nothing, and contributes no hit-test bounds — it neither errors
+ * nor emits a diagnostic. Until an interpreter ships, build custom shapes
+ * from `SceneRect`/`SceneEllipse`/`SceneGroup`/`SceneText`/`SceneImage`
+ * instead.
+ */
+interface ScenePath extends SceneNodeBase {
     kind: "path";
     /** SVG-style path data, board-local coordinates. */
     d: string;
@@ -173,7 +260,7 @@ interface SceneEllipse extends SceneNodeBase {
     stroke?: string;
     strokeWidth?: number;
 }
-type BoardScene$1 = SceneGroup | ScenePath$1 | SceneText | SceneImage | SceneRect | SceneEllipse;
+type BoardScene = SceneGroup | ScenePath | SceneText | SceneImage | SceneRect | SceneEllipse;
 type ToolCursor = "default" | "crosshair" | "pointer" | "grab" | "grabbing" | "text";
 type ToolCancelReason = "escape-key" | "tool-switched" | "pointer-lost" | "error";
 interface InputModifiers {
@@ -269,7 +356,7 @@ interface ToolCapabilities {
     };
     /** Session-only geometry — never enters Document/history/persistence/collaboration. */
     preview: {
-        set(scene: BoardScene$1): void;
+        set(scene: BoardScene): void;
         clear(): void;
     };
     /** Constructs, validates, and commits one atomic command; controller derives Ops. */
@@ -279,6 +366,15 @@ interface ToolCapabilities {
         cancel(): void;
     };
 }
+interface ExtensionDiagnostic {
+    extensionId: ExtensionId;
+    phase: "parse" | "migrate" | "describe" | "tool-lifecycle" | "react-companion" | "asset-resolution";
+    toolId?: ToolId;
+    objectId?: string;
+    objectType?: ObjectType;
+    recoverable: boolean;
+    cause: unknown;
+}
 
 /** Who holds a lock. Stored on the item so only they can take it off. */
 interface LockHolder {
@@ -303,8 +399,23 @@ declare function canUnlockItem(item: Lockable | undefined, userId: string | unde
 /** Wire fields for a locked item; omitted entirely when unlocked. */
 declare function serializeLock(item: Lockable): Lockable;
 
+/**
+ * Per-object visibility (Phase 8) — mirrors `itemLock.ts`'s `Lockable`
+ * pattern exactly, but simpler: unlike a lock, hidden state carries no
+ * holder/ownership concept, so there's no analogue to `LockHolder`/
+ * `canUnlockItem`. A hidden object stays fully present in the Document
+ * (still serializes, persists, syncs, undoes/redoes) — it just skips
+ * rendering and hit-testing/selection candidacy. `hidden` absent or
+ * `false` means visible; this keeps every pre-Phase-8 document (which has
+ * no `hidden` field on any object at all) implicitly fully visible with
+ * zero migration needed.
+ */
+interface Hideable {
+    hidden?: boolean;
+}
+
 /** A kitchen timer sitting on the board. Remaining time is derived, not ticked. */
-interface KitchenTimer extends Lockable {
+interface KitchenTimer extends Lockable, Hideable {
     id: string;
     x: number;
     y: number;
@@ -329,6 +440,173 @@ declare function toggleTimer(timer: KitchenTimer, now: number): KitchenTimer;
 declare function setTimerDuration(timer: KitchenTimer, durationMs: number): KitchenTimer;
 declare function formatTimer(ms: number): string;
 
+declare const SHAPE_MIN_SIZE = 0.5;
+/**
+ * Centralized shape style defaults (Phase 8) — one object a Host can read
+ * to know (or, by not relying on the standalone constants below, override
+ * via its own UI state) what a newly drawn Rectangle/Ellipse/Line/Arrow/
+ * Polygon/Star/Heart starts with when the user hasn't picked a stroke/width
+ * yet. `shapeTool.ts` (commit-time), `renderer/shapes/lines.ts` (render-time
+ * fallback for an object missing these fields), and
+ * `persistence/serialization/svg.ts` (export-time fallback) all read from
+ * here — the two standalone constants below are kept for source
+ * compatibility and simply mirror this object's values, not a second
+ * source of truth.
+ */
+declare const SHAPE_STYLE_DEFAULTS: {
+    readonly stroke: "#1C1C1E";
+    readonly strokeWidth: 0.3;
+};
+declare const SHAPE_DEFAULT_STROKE: "#1C1C1E";
+declare const SHAPE_DEFAULT_STROKE_WIDTH: 0.3;
+interface RectangleObject extends Lockable, Hideable {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    /** Corner radius in board units; clamped to at most half the shorter side at render time. */
+    cornerRadius?: number;
+    /** `[0, 1]`; undefined means fully opaque (Phase 4). */
+    opacity?: number;
+    /**
+     * Radians, about the shape's own center `(x + width/2, y - height/2)`.
+     * Undefined means 0 (Phase 3). `x`/`y`/`width`/`height` stay in the
+     * shape's own unrotated local frame — rotation is a separate, applied-last
+     * transform, not baked into them, matching how Stroke/CustomBoardObject
+     * keep geometry and placement independent via their own `matrix`.
+     */
+    rotation?: number;
+}
+interface EllipseObject extends Lockable, Hideable {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    /** `[0, 1]`; undefined means fully opaque (Phase 4). */
+    opacity?: number;
+    /** Radians, about the shape's own center — see RectangleObject's `rotation` doc. */
+    rotation?: number;
+}
+declare function cloneRectangle(rect: RectangleObject): RectangleObject;
+declare function cloneEllipse(ellipse: EllipseObject): EllipseObject;
+/** `"none"` is a plain line with no arrowhead; today's only real head shape is `"triangle"`. New head shapes extend this union without touching `ArrowObject`'s own fields. */
+type ArrowHeadStyle = "triangle" | "none";
+interface LineObject extends Lockable, Hideable {
+    id: string;
+    start: BoardPoint;
+    end: BoardPoint;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}
+/** An endpoint anchored to a normalized position on another object's bounds. */
+interface ConnectorBinding {
+    objectId: string;
+    /** Horizontal and vertical fractions of the target's axis-aligned bounds. */
+    x: number;
+    y: number;
+}
+interface ArrowObject extends Lockable, Hideable {
+    /** Omitted for legacy arrows. Connectors share Arrow's persistence/history contract. */
+    routing?: "straight" | "curved" | "polyline";
+    /** Intermediate board-space vertices for a multi-point connector. */
+    waypoints?: BoardPoint[];
+    startBinding?: ConnectorBinding;
+    endBinding?: ConnectorBinding;
+    id: string;
+    start: BoardPoint;
+    end: BoardPoint;
+    head?: ArrowHeadStyle;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}
+/**
+ * Triangle(3)/Diamond(4)/Pentagon(5)/Hexagon(6)/Octagon(8) as one shared
+ * type instead of five near-duplicate interfaces — a regular N-gon
+ * inscribed in the same `x`/`y`/`width`/`height`/`rotation` bounding box
+ * Rectangle already uses, parameterized by `sides`. Diamond is exactly a
+ * 4-sided regular polygon with vertex 0 pointing right (not up, like
+ * Triangle/Pentagon/Hexagon) — see `polygonGeometry.ts`'s
+ * `polygonStartAngle`, which encodes each side count's own vertex
+ * orientation so the outline always matches the legacy drag-preview shape.
+ */
+interface PolygonObject extends Lockable, Hideable {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    sides: 3 | 4 | 5 | 6 | 8;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    /** Radians, about the shape's own center — see RectangleObject's `rotation` doc. */
+    rotation?: number;
+}
+declare function clonePolygon(polygon: PolygonObject): PolygonObject;
+/** Same bounding-box/rotation convention as Rectangle; a 5-pointed star with a tuned inner-radius ratio, matching the legacy tool's own default (see `polygonGeometry.ts`'s `starPoints`). */
+interface StarObject extends Lockable, Hideable {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Vertex count; today's only shipped preset is 5, matching the legacy tool. */
+    points: number;
+    /** `(0, 1)` — inner vertex radius as a fraction of the outer radius. */
+    innerRadiusRatio: number;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    rotation?: number;
+}
+declare function cloneStar(star: StarObject): StarObject;
+/** Same bounding-box/rotation convention as Rectangle; the standard parametric heart curve (see `polygonGeometry.ts`'s `heartPoints`), no extra parameters beyond the shared shape fields. */
+interface HeartObject extends Lockable, Hideable {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    rotation?: number;
+}
+declare function cloneHeart(heart: HeartObject): HeartObject;
+declare function cloneLine(line: LineObject): LineObject;
+declare function cloneArrow(arrow: ArrowObject): ArrowObject;
+/**
+ * A logical grouping of other board objects (Phase 3 — Selection,
+ * Transformation & Grouping). Deliberately has no `x`/`y`/`transform` of its
+ * own — a group's bounds are always derived on demand from its (recursively
+ * resolved) children, and "moving/rotating/scaling the group" is exactly a
+ * multi-object transform applied to those children, nothing more. A group
+ * has no renderer/mesh of its own; its only visual presence is the
+ * selection gizmo's bounding box while it's the current selection.
+ *
+ * `children` may itself contain other group ids (nested groups) — expanding
+ * a group into its leaf members is always done by the caller (recursively,
+ * with cycle protection), never assumed here.
+ */
+interface GroupObject extends Lockable, Hideable {
+    id: string;
+    children: string[];
+}
+declare function cloneGroup(group: GroupObject): GroupObject;
+
 interface BoardPoint {
     x: number;
     y: number;
@@ -342,9 +620,14 @@ interface StrokePoint extends BoardPoint {
      */
     erase?: number;
 }
-/** Which drawing tool made a stroke; undefined means marker (back-compat). */
-type StrokeTool = "marker" | "highlighter";
-interface Stroke extends Lockable {
+/**
+ * Which drawing tool made a stroke; undefined means marker (back-compat).
+ * `"shape"` (rect/ellipse/line/arrow/polygon/star/heart) renders at its
+ * exact configured width with no pressure variance or end taper — a
+ * geometric outline, not an expressive ink mark.
+ */
+type StrokeTool = "marker" | "highlighter" | "shape";
+interface Stroke extends Lockable, Hideable {
     id: string;
     color: string;
     baseWidth: number;
@@ -363,7 +646,7 @@ interface Stroke extends Lockable {
 declare const ERASE_THRESHOLD = 0.95;
 declare function cloneStroke(stroke: Stroke): Stroke;
 type SerializedPoint = [number, number, number, number];
-interface SerializedStroke extends Lockable {
+interface SerializedStroke extends Lockable, Hideable {
     id: string;
     color: string;
     baseWidth: number;
@@ -373,7 +656,36 @@ interface SerializedStroke extends Lockable {
     matrix?: [number, number, number, number, number, number];
     clusterId?: string;
 }
+/** A named notebook containing sections. */
+interface BoardNotebook {
+    readonly id: string;
+    readonly name: string;
+    readonly color: string;
+}
+/** A named section containing pages. */
+interface BoardSection {
+    readonly id: string;
+    readonly notebookId: string;
+    readonly name: string;
+    readonly color: string;
+}
+/** An additional page. The first page remains in the document's top-level collections. */
+interface SerializedBoardPage {
+    id: string;
+    sectionId?: string;
+    name: string;
+    content: SerializedDocument;
+}
 interface SerializedDocument {
+    /** Notebook and section metadata. Older boards use an implicit default of each. */
+    notebooks?: BoardNotebook[];
+    sections?: BoardSection[];
+    /** Section of the original first page; defaults to `default`. */
+    pageSectionId?: string;
+    /** Display name of the first page (id `default`). */
+    pageName?: string;
+    /** Additional pages, in sidebar order. Nested pages are not allowed. */
+    pages?: SerializedBoardPage[];
     /** Absent in every historical document; current saves always write 1. */
     schemaVersion?: 1;
     strokes: SerializedStroke[];
@@ -389,6 +701,31 @@ interface SerializedDocument {
     timers?: KitchenTimer[];
     /** Absent in documents saved before Custom board objects existed (ticket #22). */
     customObjects?: CustomBoardObject[];
+    /** Absent in documents saved before semantic Rectangle objects existed (Phase 2). */
+    rectangles?: RectangleObject[];
+    /** Absent in documents saved before semantic Ellipse objects existed (Phase 2). */
+    ellipses?: EllipseObject[];
+    /** Absent in documents saved before Groups existed (Phase 3). */
+    groups?: GroupObject[];
+    /** Absent in documents saved before semantic Line objects existed (Phase 4). */
+    lines?: LineObject[];
+    /** Absent in documents saved before semantic Arrow objects existed (Phase 4). */
+    arrows?: ArrowObject[];
+    /** Absent in documents saved before semantic Polygon objects existed (Phase 4). */
+    polygons?: PolygonObject[];
+    /** Absent in documents saved before semantic Star objects existed (Phase 4). */
+    stars?: StarObject[];
+    /** Absent in documents saved before semantic Heart objects existed (Phase 4). */
+    hearts?: HeartObject[];
+    /**
+     * Every content-object id (every type above except comments, which are
+     * host-synced and never enter this schema) in paint order, back to front.
+     * Absent in documents saved before per-object z-order existed (Phase 3) —
+     * migration synthesizes a default order preserving the old fixed-Z-band
+     * visual stacking exactly, so an existing document never visibly changes
+     * on load; only an explicit reorder action touches this from then on.
+     */
+    objectOrder?: string[];
 }
 declare const INK_COLORS: {
     readonly black: "#1C1C1E";
@@ -397,16 +734,28 @@ declare const INK_COLORS: {
     readonly green: "#16A34A";
 };
 declare const HIGHLIGHT_COLORS: {
+    readonly yellow: "#FACC15";
+    readonly green: "#4ADE80";
+    readonly pink: "#F472B6";
+    readonly blue: "#60A5FA";
+};
+declare const NOTE_COLORS: {
     readonly yellow: "#FDE047";
-    readonly green: "#86EFAC";
+    readonly amber: "#FACC15";
+    readonly orange: "#FB923C";
+    readonly peach: "#FDBA74";
+    readonly red: "#FB7185";
+    readonly rose: "#FDA4AF";
     readonly pink: "#F9A8D4";
+    readonly magenta: "#F472B6";
+    readonly purple: "#C084FC";
+    readonly lavender: "#C4B5FD";
     readonly blue: "#93C5FD";
-};
-declare const NOTE_COLORS: {
-    readonly yellow: "#FDE68A";
-    readonly pink: "#FBCFE8";
-    readonly blue: "#BFDBFE";
-    readonly green: "#BBF7D0";
+    readonly cornflower: "#60A5FA";
+    readonly sky: "#38BDF8";
+    readonly cyan: "#67E8F9";
+    readonly green: "#86EFAC";
+    readonly mint: "#4ADE80";
 };
 /**
  * One collaborator's vote on a note. One per person; toggling removes it.
@@ -420,7 +769,7 @@ interface NoteVote {
  * A sticky note: content floating above the board at a z-offset (pillar 3 —
  * depth as an organizational axis). Center position in board space.
  */
-interface StickyNote extends Lockable {
+interface StickyNote extends Lockable, Hideable {
     id: string;
     x: number;
     y: number;
@@ -438,7 +787,7 @@ interface StickyNote extends Lockable {
  * top-left corner; lines flow downward (-y). Text joins the clustering
  * system like handwriting (build prompt §6.4).
  */
-interface TextBlock extends Lockable {
+interface TextBlock extends Lockable, Hideable {
     id: string;
     x: number;
     y: number;
@@ -468,7 +817,7 @@ declare function cloneNote(note: StickyNote): StickyNote;
  * Interactive structured table on the board. Position (x, y) is top-left in board units.
  * Cells are indexed as `${row},${col}` keys mapping to cell text content.
  */
-interface TableBlock extends Lockable {
+interface TableBlock extends Lockable, Hideable {
     id: string;
     x: number;
     y: number;
@@ -489,13 +838,12 @@ declare function measureTable(table: TableBlock): {
     width: number;
     height: number;
 };
-declare const BOARD_COLOR = "#FFFFFF";
 declare const FOG_COLOR = "#FFFFFF";
 /**
  * An imported image block on the board plane.
  * Coordinates (x, y) represent the center of the image in board space.
  */
-interface ImageBlock extends Lockable {
+interface ImageBlock extends Lockable, Hideable {
     id: string;
     /**
      * A legacy, read-only data URL (or, historically, an arbitrary string) —
@@ -519,13 +867,29 @@ interface ImageBlock extends Lockable {
 }
 declare function cloneImage(img: ImageBlock): ImageBlock;
 
+declare const documentIdBrand: unique symbol;
+declare const strokeIdBrand: unique symbol;
+type DocumentId = string & {
+    readonly [documentIdBrand]: "DocumentId";
+};
+type StrokeId = string & {
+    readonly [strokeIdBrand]: "StrokeId";
+};
+declare function documentId(value: string): DocumentId;
+declare function strokeId(value: string): StrokeId;
+
 declare const CURRENT_DOCUMENT_SCHEMA_VERSION: 1;
 type CurrentSerializedStroke = Omit<SerializedStroke, "id"> & {
     id: StrokeId;
 };
-interface CurrentSerializedDocument extends Required<SerializedDocument> {
+interface CurrentSerializedDocument extends Required<Omit<SerializedDocument, "pages" | "pageName" | "notebooks" | "sections" | "pageSectionId">> {
     schemaVersion: typeof CURRENT_DOCUMENT_SCHEMA_VERSION;
     strokes: CurrentSerializedStroke[];
+    pageName?: string;
+    notebooks?: BoardNotebook[];
+    sections?: BoardSection[];
+    pageSectionId?: string;
+    pages?: SerializedBoardPage[];
 }
 type DocumentRecoveryCode = "DOCUMENT_JSON_INVALID" | "DOCUMENT_VALIDATION_FAILED" | "DOCUMENT_VERSION_UNSUPPORTED";
 declare class DocumentRecoveryError extends Error {
@@ -545,6 +909,15 @@ type DocumentLoadResult = {
 declare function loadDocumentBytes(originalBytes: string): DocumentLoadResult;
 declare function migrateDocument(raw: unknown): DocumentLoadResult;
 declare function serializeDocument(document: unknown): string;
+/**
+ * A Document's serialized size in bytes (Phase 5) — UTF-8, not UTF-16
+ * `string.length`, since a Document with non-ASCII note/text content (most
+ * of them, eventually) would otherwise under-report. Useful for a Host
+ * deciding when to warn about an unusually large board, or for logging/
+ * telemetry around save size — not consulted by anything inside this
+ * package itself, which has no size limit of its own.
+ */
+declare function documentSize(document: CurrentSerializedDocument): number;
 
 interface SearchableComment {
     id: string;
@@ -579,6 +952,18 @@ interface SearchableBoard {
  */
 declare function searchBoard(query: string, board: SearchableBoard): SearchHit[];
 
+interface ConnectorBox {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/** A bindable object's footprint: its bounds and whether its outline is the box or the ellipse inside it. */
+interface ConnectorTarget {
+    box: ConnectorBox;
+    outline: "box" | "ellipse";
+}
+
 /**
  * The one place a live Stroke becomes its wire representation — in
  * particular, points collapse from {x,y,pressure,erase?} objects into
@@ -629,6 +1014,60 @@ interface DocumentChange {
     /** Ids of removed custom objects. */
     customObjectsRemoved: string[];
     customObjectsUpdated: CustomBoardObject[];
+    /** Semantic Rectangle objects (Phase 2). */
+    rectanglesAdded: RectangleObject[];
+    /** Ids of removed rectangles. */
+    rectanglesRemoved: string[];
+    rectanglesUpdated: RectangleObject[];
+    /** Semantic Ellipse objects (Phase 2). */
+    ellipsesAdded: EllipseObject[];
+    /** Ids of removed ellipses. */
+    ellipsesRemoved: string[];
+    ellipsesUpdated: EllipseObject[];
+    /** Groups (Phase 3). */
+    groupsAdded: GroupObject[];
+    /** Ids of removed groups (ungrouping, or deleting a group). */
+    groupsRemoved: string[];
+    groupsUpdated: GroupObject[];
+    /** Semantic Line objects (Phase 4). */
+    linesAdded: LineObject[];
+    /** Ids of removed lines. */
+    linesRemoved: string[];
+    linesUpdated: LineObject[];
+    /** Semantic Arrow objects (Phase 4). */
+    arrowsAdded: ArrowObject[];
+    /** Ids of removed arrows. */
+    arrowsRemoved: string[];
+    arrowsUpdated: ArrowObject[];
+    /** Semantic Polygon objects (Phase 4) — Triangle/Diamond/Pentagon/Hexagon/Octagon. */
+    polygonsAdded: PolygonObject[];
+    /** Ids of removed polygons. */
+    polygonsRemoved: string[];
+    polygonsUpdated: PolygonObject[];
+    /** Semantic Star objects (Phase 4). */
+    starsAdded: StarObject[];
+    /** Ids of removed stars. */
+    starsRemoved: string[];
+    starsUpdated: StarObject[];
+    /** Semantic Heart objects (Phase 4). */
+    heartsAdded: HeartObject[];
+    /** Ids of removed hearts. */
+    heartsRemoved: string[];
+    heartsUpdated: HeartObject[];
+    /**
+     * The full current paint order (back to front) of every flat content
+     * object — strokes, texts, tables, images, rectangles, ellipses, lines,
+     * arrows, custom objects, and groups. Populated whenever `objectOrder`
+     * actually changed:
+     * an explicit reorder (`bringForward` etc.), or any add/remove that
+     * touches it — a removal shifts every id after it down one rank, not
+     * just the removed one, so renderers need this to resync everyone, not
+     * only the ids the same change's own `*Added`/`*Removed`/`*Updated`
+     * fields name. Notes (their own `zOffset` peel depth) and Kitchen Timers
+     * (genuine 3D objects, not a flat layer) are intentionally not part of
+     * this order at all.
+     */
+    orderChanged: readonly string[];
 }
 type Listener = (change: DocumentChange) => void;
 declare class BoardDocument {
@@ -643,12 +1082,78 @@ declare class BoardDocument {
     private readonly timers;
     /** All Custom board object types share one map, keyed by id — the envelope is already uniform. */
     private readonly customObjects;
+    private readonly rectangles;
+    private readonly ellipses;
+    private readonly groups;
+    private readonly lines;
+    private readonly arrows;
+    private readonly polygons;
+    private readonly stars;
+    private readonly hearts;
     private readonly bboxes;
     private readonly listeners;
+    /** Paint order (back to front) of every flat content object — see `DocumentChange.orderChanged`'s doc comment. */
+    private objectOrder;
+    private orderIndex;
     constructor(id: DocumentId);
+    private reindexOrder;
+    /** The full current paint order, back to front. */
+    order(): readonly string[];
+    /** This object's rank in the paint order, or -1 if it doesn't participate (unknown id, a note, or a timer). */
+    orderRank(id: string): number;
+    private bringForward;
+    private sendBackward;
+    private bringToFront;
+    private sendToBack;
+    /** Reorders `id` relative to its current neighbors. A no-op for an id that doesn't participate in paint order (see `orderRank`). */
+    reorder(id: string, direction: "forward" | "backward" | "front" | "back"): void;
+    /**
+     * Overwrites the paint order directly — used only when loading a document
+     * that already carries a persisted `objectOrder`; every other order
+     * mutation goes through `reorder`/the automatic append-on-add tracking in
+     * `emit`. Ids not present in the document are dropped; ids present in the
+     * document but missing from `order` are appended at the back, so a
+     * partially-stale order (e.g. from a schema migration) never silently
+     * drops an object from paint order entirely.
+     */
+    private setOrder;
     get(id: string): Stroke | undefined;
     all(): IterableIterator<Stroke>;
-    bbox(id: string): BBox | undefined;
+    /**
+     * World-space bounds for any content object, of any type. Strokes hit
+     * their cached-on-mutation fast path (`bboxes`, populated by
+     * `addStrokes`/`transformStrokes` — many points, worth caching); every
+     * other type computes on demand via `objectBounds.ts` (cheap arithmetic,
+     * no caching needed). A group's bounds are the union of its (recursively
+     * resolved) children — `seen` guards against a cycle in nested groups.
+     */
+    /**
+     * What a connector can attach to at `id`: its bounds and outline shape.
+     * Connectors, lines and groups aren't targets (that would allow cycles).
+     */
+    connectorTarget(id: string): ConnectorTarget | undefined;
+    bbox(id: string, seen?: Set<string>): BBox | undefined;
+    /**
+     * True if `id` exists and is locked, for any type — the same per-type
+     * probe pattern as `bbox`, for interactive gestures (drag/transform) that
+     * need to gate on lock state regardless of what's selected. Custom
+     * objects are deliberately excluded: their `lock` field is a different
+     * shape (`{holderId, acquiredAt}`, no display name) with no interactive
+     * lock UI yet, matching the existing, deliberate "always unlockable,
+     * never gates a drag" treatment already established elsewhere (e.g.
+     * `getSelectedItemInfo`'s custom branch hardcodes `isLocked: false`).
+     */
+    isLocked(id: string): boolean;
+    /**
+     * True if `id` exists and is hidden, for any type — the same per-type
+     * probe pattern as {@link isLocked} (Phase 8). Custom objects are
+     * excluded for the same reason `isLocked` excludes them: they have no
+     * `Hideable` field at all, so "hidden" isn't a concept that applies to
+     * them yet. Used by marquee selection (`selectTool.ts`) to keep a hidden
+     * object out of a rubber-band selection even for object types whose own
+     * renderer doesn't yet suppress click-based hit-testing.
+     */
+    isHidden(id: string): boolean;
     subscribe(listener: Listener): () => void;
     addStrokes(strokes: Stroke[]): void;
     removeStrokes(ids: string[]): void;
@@ -691,6 +1196,54 @@ declare class BoardDocument {
     removeCustomObjects(ids: string[]): void;
     /** Replace a custom object's contents under the same id. */
     setCustomObject(object: CustomBoardObject): void;
+    getRectangle(id: string): RectangleObject | undefined;
+    allRectangles(): IterableIterator<RectangleObject>;
+    addRectangles(rectangles: RectangleObject[]): void;
+    removeRectangles(ids: string[]): void;
+    /** Replace a rectangle's contents (move, resize, restyle) under the same id. */
+    setRectangle(rect: RectangleObject): void;
+    getEllipse(id: string): EllipseObject | undefined;
+    allEllipses(): IterableIterator<EllipseObject>;
+    addEllipses(ellipses: EllipseObject[]): void;
+    removeEllipses(ids: string[]): void;
+    /** Replace an ellipse's contents (move, resize, restyle) under the same id. */
+    setEllipse(ellipse: EllipseObject): void;
+    getGroup(id: string): GroupObject | undefined;
+    allGroups(): IterableIterator<GroupObject>;
+    addGroups(groups: GroupObject[]): void;
+    removeGroups(ids: string[]): void;
+    /** Replace a group's contents (its children list) under the same id. */
+    setGroup(group: GroupObject): void;
+    getLine(id: string): LineObject | undefined;
+    allLines(): IterableIterator<LineObject>;
+    addLines(lines: LineObject[]): void;
+    removeLines(ids: string[]): void;
+    /** Replace a line's contents (move, restyle) under the same id. */
+    setLine(line: LineObject): void;
+    getArrow(id: string): ArrowObject | undefined;
+    allArrows(): IterableIterator<ArrowObject>;
+    addArrows(arrows: ArrowObject[]): void;
+    removeArrows(ids: string[]): void;
+    /** Replace an arrow's contents (move, restyle, change head) under the same id. */
+    setArrow(arrow: ArrowObject): void;
+    getPolygon(id: string): PolygonObject | undefined;
+    allPolygons(): IterableIterator<PolygonObject>;
+    addPolygons(polygons: PolygonObject[]): void;
+    removePolygons(ids: string[]): void;
+    /** Replace a polygon's contents (move, resize, rotate, restyle) under the same id. */
+    setPolygon(polygon: PolygonObject): void;
+    getStar(id: string): StarObject | undefined;
+    allStars(): IterableIterator<StarObject>;
+    addStars(stars: StarObject[]): void;
+    removeStars(ids: string[]): void;
+    /** Replace a star's contents (move, resize, rotate, restyle) under the same id. */
+    setStar(star: StarObject): void;
+    getHeart(id: string): HeartObject | undefined;
+    allHearts(): IterableIterator<HeartObject>;
+    addHearts(hearts: HeartObject[]): void;
+    removeHearts(ids: string[]): void;
+    /** Replace a heart's contents (move, resize, rotate, restyle) under the same id. */
+    setHeart(heart: HeartObject): void;
     setStrokeLocked(id: string, locked: boolean, by?: LockHolder | null): void;
     setStrokesLocked(ids: string[], locked: boolean, by?: LockHolder | null): void;
     setNoteLocked(id: string, locked: boolean, by?: LockHolder | null): void;
@@ -698,18 +1251,69 @@ declare class BoardDocument {
     setTableLocked(id: string, locked: boolean, by?: LockHolder | null): void;
     setImageLocked(id: string, locked: boolean, by?: LockHolder | null): void;
     setTimerLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setRectangleLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setEllipseLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setGroupLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setLineLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setArrowLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setPolygonLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setStarLocked(id: string, locked: boolean, by?: LockHolder | null): void;
+    setHeartLocked(id: string, locked: boolean, by?: LockHolder | null): void;
     /** Replace all content (initial load). Does not touch `version`. */
-    replaceAll(strokes: Stroke[], notes: StickyNote[], texts: TextBlock[], tables?: TableBlock[], images?: ImageBlock[], timers?: KitchenTimer[], customObjects?: CustomBoardObject[]): void;
+    replaceAll(strokes: Stroke[], notes: StickyNote[], texts: TextBlock[], tables?: TableBlock[], images?: ImageBlock[], timers?: KitchenTimer[], customObjects?: CustomBoardObject[], rectangles?: RectangleObject[], ellipses?: EllipseObject[], groups?: GroupObject[], lines?: LineObject[], arrows?: ArrowObject[], polygons?: PolygonObject[], stars?: StarObject[], hearts?: HeartObject[], 
+    /** Persisted paint order; absent for a document saved before Phase 3, in which case one is synthesized (see `ORDERED_ADDED_FIELDS`'s doc comment). */
+    objectOrder?: readonly string[]): void;
     /** Apply incremental real-time change received from a remote collaborator over WebSocket. */
     applyRemoteChange(change: Partial<DocumentChange>): void;
     toJSON(): SerializedDocument;
+    static deserializeGroups(data: SerializedDocument): GroupObject[];
+    static deserializeLines(data: SerializedDocument): LineObject[];
+    static deserializeArrows(data: SerializedDocument): ArrowObject[];
+    static deserializePolygons(data: SerializedDocument): PolygonObject[];
+    static deserializeStars(data: SerializedDocument): StarObject[];
+    static deserializeHearts(data: SerializedDocument): HeartObject[];
     static deserializeCustomObjects(data: SerializedDocument): CustomBoardObject[];
+    static deserializeRectangles(data: SerializedDocument): RectangleObject[];
+    static deserializeEllipses(data: SerializedDocument): EllipseObject[];
     static deserializeImages(data: SerializedDocument): ImageBlock[];
     static deserializeTimers(data: SerializedDocument): KitchenTimer[];
     static deserializeNotes(data: SerializedDocument): StickyNote[];
     static deserializeTexts(data: SerializedDocument): TextBlock[];
     static deserializeTables(data: SerializedDocument): TableBlock[];
-    static deserializeStrokes(data: SerializedDocument): Stroke[];
+    /**
+     * `onSkip` (Phase 9) replaces an unconditional `console.error` — `core`
+     * must never do raw console I/O (no dev-gate, no way for a Host to
+     * suppress or redirect it), so a skipped stroke is now reported only if
+     * the caller asks for it, via whatever diagnostic channel it already
+     * has (e.g. `controller-internal.ts` routes this into the same typed
+     * `"error"` event every other diagnostic already uses). Silent by
+     * default, matching how every other `deserialize*` method here already
+     * behaves (no diagnostics at all).
+     */
+    static deserializeStrokes(data: SerializedDocument, onSkip?: (id: string, cause: unknown) => void): Stroke[];
+    /**
+     * Every mutation funnels through here, so paint-order tracking lives in
+     * exactly one place rather than at every individual add/remove call site
+     * (18 of them, times `replaceAll`/`applyRemoteChange`) — new ids are
+     * appended to the back (front-most) of `objectOrder`, removed ids are
+     * spliced out. An explicit reorder (`reorder`/`setOrder`) updates
+     * `objectOrder` itself before calling this, so this step is a no-op for
+     * ids already tracked (idempotent by construction: `orderIndex.has` gates
+     * every append).
+     *
+     * `orderChanged` (Phase 9) reports exactly the ids whose rank actually
+     * changed, using `orderIndex` throughout instead of `indexOf` — a pure
+     * append never shifts any existing id's rank (new ids land at the tail,
+     * already covered by this same change's own `Added` field, so
+     * `orderChanged` stays unset), while a removal shifts every id at-or-
+     * after the lowest removed rank down by one, computed in a single O(n)
+     * filter pass (not one `indexOf`+`splice` per removed id) regardless of
+     * how many ids this one change removes. Every renderer's `onChange` now
+     * looks up only the ids actually in `orderChanged` instead of walking
+     * its entire mesh map on any order-touching change — a broad, unfiltered
+     * `orderChanged` here would silently defeat that fix, not just waste
+     * cycles here.
+     */
     private emit;
 }
 
@@ -745,12 +1349,33 @@ interface Command {
     apply(doc: BoardDocument): void;
     revert(doc: BoardDocument): void;
 }
+/**
+ * Several commands applied/reverted together as one undo step (Phase 3
+ * consolidation — this exact class used to be hand-duplicated as a private
+ * `CommandBatch` in `controller-internal.ts` and an exported
+ * `ExtensionCommandBatch` in `interaction/tools/customTool.ts`; both now
+ * import this one instead). Revert runs in reverse order, so a batch that
+ * depends on ordering (e.g. add-then-reference) undoes cleanly.
+ */
+declare class CommandBatch implements Command {
+    readonly label: string;
+    private readonly commands;
+    constructor(label: string, commands: readonly Command[]);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
 /** How a command reached the document — undo/redo are audited distinctly. */
 type CommandKind = "do" | "undo" | "redo";
 declare class History {
     private readonly doc;
     private readonly undoStack;
     private readonly redoStack;
+    private scope;
+    private readonly scopes;
+    /** Switch independent page histories while retaining the same document instance. */
+    setScope(id: string): void;
+    /** Discard all page histories after replacing a saved document. */
+    clearScopes(): void;
     /**
      * Observer for every mutation, in one place: all board edits funnel
      * through record/undo/redo. The audit trail listens here.
@@ -809,6 +1434,40 @@ declare class TransformCommand implements Command {
     revert(doc: BoardDocument): void;
     private compose;
 }
+/**
+ * One move gesture over a mixed-type selection (Phase 3) — the general
+ * successor to `TransformCommand` for translation. `TransformCommand`
+ * itself stays as-is (still used for scale/rotate, which remain stroke-only
+ * this phase — see `interaction/tools/selectTool.ts`'s `TransformState`):
+ * its own per-id `doc.get(id)` check already no-ops safely for any id that
+ * isn't a stroke, so it doesn't need touching for that narrower case.
+ *
+ * `delta` here is always a pure translation (never scale/rotate), so
+ * `apply(delta, point)` is a safe, uniform way to move every position-only
+ * type's `x`/`y` — translating commutes trivially regardless of a shape's
+ * own rotation. Matrix-carrying types (stroke, Custom) instead compose
+ * `delta` onto their existing matrix/transform, matching `TransformCommand`.
+ *
+ * A group id in `ids` is expanded into its (recursively resolved, cycle-
+ * safe) children every time `compose` runs — deterministic, since group
+ * membership never changes mid-command — so moving a selected group means
+ * moving every one of its members by the same delta. This expansion is
+ * `TransformObjectsCommand`'s own responsibility precisely so a caller that
+ * doesn't itself expand groups (e.g. `ScrawlEngine.nudgeSelection`) still
+ * gets correct behavior; `interaction/tools/selectTool.ts`'s `TransformState`
+ * separately expands for its own reason (live per-child drag preview), which
+ * makes this a no-op re-expansion for that caller, not a conflict.
+ */
+declare class TransformObjectsCommand implements Command {
+    private readonly ids;
+    private readonly delta;
+    readonly label = "move selection";
+    private readonly inverse;
+    constructor(ids: readonly string[], delta: Mat2x3);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+    private compose;
+}
 declare class AddNoteCommand implements Command {
     readonly label = "add note";
     private readonly note;
@@ -930,8 +1589,213 @@ declare class DeleteTimerCommand implements Command {
     apply(doc: BoardDocument): void;
     revert(doc: BoardDocument): void;
 }
+/** Add/update/delete for semantic Rectangle objects (Phase 2). */
+declare class AddRectangleCommand implements Command {
+    readonly label = "add rectangle";
+    private readonly rect;
+    constructor(rect: RectangleObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdateRectangleCommand implements Command {
+    readonly label = "update rectangle";
+    private readonly before;
+    private readonly after;
+    constructor(before: RectangleObject, after: RectangleObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeleteRectangleCommand implements Command {
+    readonly label = "delete rectangle";
+    private readonly rect;
+    constructor(rect: RectangleObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+/** Add/update/delete for semantic Ellipse objects (Phase 2). */
+declare class AddEllipseCommand implements Command {
+    readonly label = "add ellipse";
+    private readonly ellipse;
+    constructor(ellipse: EllipseObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdateEllipseCommand implements Command {
+    readonly label = "update ellipse";
+    private readonly before;
+    private readonly after;
+    constructor(before: EllipseObject, after: EllipseObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeleteEllipseCommand implements Command {
+    readonly label = "delete ellipse";
+    private readonly ellipse;
+    constructor(ellipse: EllipseObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+/** Add/update/delete for semantic Line objects (Phase 4). */
+declare class AddLineCommand implements Command {
+    readonly label = "add line";
+    private readonly line;
+    constructor(line: LineObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdateLineCommand implements Command {
+    readonly label = "update line";
+    private readonly before;
+    private readonly after;
+    constructor(before: LineObject, after: LineObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeleteLineCommand implements Command {
+    readonly label = "delete line";
+    private readonly line;
+    constructor(line: LineObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+/** Add/update/delete for semantic Arrow objects (Phase 4). */
+declare class AddArrowCommand implements Command {
+    readonly label = "add arrow";
+    private readonly arrow;
+    constructor(arrow: ArrowObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdateArrowCommand implements Command {
+    readonly label = "update arrow";
+    private readonly before;
+    private readonly after;
+    constructor(before: ArrowObject, after: ArrowObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeleteArrowCommand implements Command {
+    readonly label = "delete arrow";
+    private readonly arrow;
+    constructor(arrow: ArrowObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+/** Add/update/delete for semantic Polygon objects (Phase 4) — Triangle/Diamond/Pentagon/Hexagon/Octagon. */
+declare class AddPolygonCommand implements Command {
+    readonly label = "add polygon";
+    private readonly polygon;
+    constructor(polygon: PolygonObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdatePolygonCommand implements Command {
+    readonly label = "update polygon";
+    private readonly before;
+    private readonly after;
+    constructor(before: PolygonObject, after: PolygonObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeletePolygonCommand implements Command {
+    readonly label = "delete polygon";
+    private readonly polygon;
+    constructor(polygon: PolygonObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+/** Add/update/delete for semantic Star objects (Phase 4). */
+declare class AddStarCommand implements Command {
+    readonly label = "add star";
+    private readonly star;
+    constructor(star: StarObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdateStarCommand implements Command {
+    readonly label = "update star";
+    private readonly before;
+    private readonly after;
+    constructor(before: StarObject, after: StarObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeleteStarCommand implements Command {
+    readonly label = "delete star";
+    private readonly star;
+    constructor(star: StarObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+/** Add/update/delete for semantic Heart objects (Phase 4). */
+declare class AddHeartCommand implements Command {
+    readonly label = "add heart";
+    private readonly heart;
+    constructor(heart: HeartObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdateHeartCommand implements Command {
+    readonly label = "update heart";
+    private readonly before;
+    private readonly after;
+    constructor(before: HeartObject, after: HeartObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeleteHeartCommand implements Command {
+    readonly label = "delete heart";
+    private readonly heart;
+    constructor(heart: HeartObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+/** Add/update/delete for Groups (Phase 3). */
+declare class AddGroupCommand implements Command {
+    readonly label = "group";
+    private readonly group;
+    constructor(group: GroupObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class UpdateGroupCommand implements Command {
+    readonly label = "update group";
+    private readonly before;
+    private readonly after;
+    constructor(before: GroupObject, after: GroupObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+declare class DeleteGroupCommand implements Command {
+    readonly label = "ungroup";
+    private readonly group;
+    constructor(group: GroupObject);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
+type ReorderDirection = "forward" | "backward" | "front" | "back";
+/**
+ * Bring-forward / send-backward / bring-to-front / send-to-back (Phase 3) —
+ * one command family covering all four directions rather than four
+ * near-identical classes, since the only difference between them is which
+ * `BoardDocument.reorder` direction to replay. Captures the full paint order
+ * on first `apply` rather than in the constructor — `BoardDocument.order()`
+ * needs the doc, which a `Command` only ever receives via `apply`/`revert` —
+ * so `revert` can restore it exactly; redo re-runs the same `reorder` call,
+ * which is deterministic because `revert` always restores the identical
+ * starting order first.
+ */
+declare class ReorderObjectCommand implements Command {
+    private readonly id;
+    private readonly direction;
+    readonly label: string;
+    private before;
+    constructor(id: string, direction: ReorderDirection);
+    apply(doc: BoardDocument): void;
+    revert(doc: BoardDocument): void;
+}
 interface LockTarget {
-    type: "stroke" | "note" | "text" | "table" | "image" | "timer";
+    type: "stroke" | "note" | "text" | "table" | "image" | "timer" | "rectangle" | "ellipse" | "group" | "line" | "arrow" | "polygon" | "star" | "heart";
     id: string;
     locked: boolean;
     lockedBy?: string;
@@ -948,7 +1812,7 @@ declare class LockItemsCommand implements Command {
     private applyLock;
 }
 
-type OpCollection = "strokes" | "notes" | "textBlocks" | "tables" | "images" | "timers" | "customObjects";
+type OpCollection = "strokes" | "notes" | "textBlocks" | "tables" | "images" | "timers" | "rectangles" | "ellipses" | "groups" | "lines" | "arrows" | "polygons" | "stars" | "hearts" | "customObjects";
 type Op = {
     kind: "upsert";
     collection: OpCollection;
@@ -979,15 +1843,23 @@ interface RibbonEdgePoint {
     /** 1 = intact ink, 0 = fully erased (from the erasure channel). */
     alpha: number;
 }
-declare function ribbonEdges(points: StrokePoint[], baseWidth: number): RibbonEdgePoint[];
+/**
+ * @param handDrawn Default `true`: ink's organic feel — width follows
+ * per-point pressure, and both ends taper. Pass `false` for a geometric
+ * shape outline, which has no real pressure signal and isn't a pen stroke
+ * with a lift-off: it renders at the exact `baseWidth`, uniformly, with no
+ * taper at its start/end (which, for a closed shape, is the same point —
+ * tapering it would visibly pinch just that one corner).
+ */
+declare function ribbonEdges(points: StrokePoint[], baseWidth: number, handDrawn?: boolean): RibbonEdgePoint[];
 
 declare class SpatialIndex {
     private readonly doc;
     private readonly cells;
-    private readonly strokeCells;
+    private readonly objectCells;
     private readonly unsubscribe;
     constructor(doc: BoardDocument);
-    /** Ids of strokes whose bbox may overlap the query rect. */
+    /** Ids of content objects (any type except groups) whose bbox may overlap the query rect. */
     query(minX: number, minY: number, maxX: number, maxY: number): Set<string>;
     dispose(): void;
     private insert;
@@ -1036,6 +1908,539 @@ declare function placePresenceBeacon(screen: {
     height: number;
 }, inset?: ViewportInset): PresencePlacement;
 
+interface IconDefinition {
+    /** Stable, set-prefixed id (`lucide:rocket`), also what an ImageBlock stores in its `stamp` field. */
+    readonly name: string;
+    readonly label: string;
+    readonly category: string;
+    /** Inner SVG markup for a 24x24 viewBox; strokes use `currentColor`. */
+    readonly body: string;
+}
+declare const ICON_LIBRARY: readonly [{
+    readonly name: "lucide:check";
+    readonly label: "Check";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M20 6L9 17l-5-5\"/>";
+}, {
+    readonly name: "lucide:x";
+    readonly label: "Cross";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M18 6L6 18M6 6l12 12\"/>";
+}, {
+    readonly name: "lucide:star";
+    readonly label: "Star";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M11.525 2.295a.53.53 0 0 1 .95 0l2.31 4.679a2.12 2.12 0 0 0 1.595 1.16l5.166.756a.53.53 0 0 1 .294.904l-3.736 3.638a2.12 2.12 0 0 0-.611 1.878l.882 5.14a.53.53 0 0 1-.771.56l-4.618-2.428a2.12 2.12 0 0 0-1.973 0L6.396 21.01a.53.53 0 0 1-.77-.56l.881-5.139a2.12 2.12 0 0 0-.611-1.879L2.16 9.795a.53.53 0 0 1 .294-.906l5.165-.755a2.12 2.12 0 0 0 1.597-1.16z\"/>";
+}, {
+    readonly name: "lucide:heart";
+    readonly label: "Heart";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M2 9.5a5.5 5.5 0 0 1 9.591-3.676a.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5c0 2.29-1.5 4-3 5.5l-5.492 5.313a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5\"/>";
+}, {
+    readonly name: "lucide:flag";
+    readonly label: "Flag";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 22V4a1 1 0 0 1 .4-.8A6 6 0 0 1 8 2c3 0 5 2 7.333 2q2 0 3.067-.8A1 1 0 0 1 20 4v10a1 1 0 0 1-.4.8A6 6 0 0 1 16 16c-3 0-5-2-8-2a6 6 0 0 0-4 1.528\"/>";
+}, {
+    readonly name: "lucide:bookmark";
+    readonly label: "Bookmark";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M17 3a2 2 0 0 1 2 2v15a1 1 0 0 1-1.496.868l-4.512-2.578a2 2 0 0 0-1.984 0l-4.512 2.578A1 1 0 0 1 5 20V5a2 2 0 0 1 2-2z\"/>";
+}, {
+    readonly name: "lucide:bell";
+    readonly label: "Bell";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M10.268 21a2 2 0 0 0 3.464 0m-10.47-5.674A1 1 0 0 0 4 17h16a1 1 0 0 0 .74-1.673C19.41 13.956 18 12.499 18 8A6 6 0 0 0 6 8c0 4.499-1.411 5.956-2.738 7.326\"/>";
+}, {
+    readonly name: "lucide:info";
+    readonly label: "Info";
+    readonly category: "Status";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><path d=\"M12 16v-4m0-4h.01\"/></g>";
+}, {
+    readonly name: "lucide:circle-alert";
+    readonly label: "Alert";
+    readonly category: "Status";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><path d=\"M12 8v4m0 4h.01\"/></g>";
+}, {
+    readonly name: "lucide:circle-question-mark";
+    readonly label: "Question";
+    readonly category: "Status";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><path d=\"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3m.08 4h.01\"/></g>";
+}, {
+    readonly name: "lucide:thumbs-up";
+    readonly label: "Thumbs up";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M15 5.88L14 10h5.83a2 2 0 0 1 1.92 2.56l-2.33 8A2 2 0 0 1 17.5 22H4a2 2 0 0 1-2-2v-8a2 2 0 0 1 2-2h2.76a2 2 0 0 0 1.79-1.11L12 2a3.13 3.13 0 0 1 3 3.88M7 10v12\"/>";
+}, {
+    readonly name: "lucide:thumbs-down";
+    readonly label: "Thumbs down";
+    readonly category: "Status";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M9 18.12L10 14H4.17a2 2 0 0 1-1.92-2.56l2.33-8A2 2 0 0 1 6.5 2H20a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-2.76a2 2 0 0 0-1.79 1.11L12 22a3.13 3.13 0 0 1-3-3.88M17 14V2\"/>";
+}, {
+    readonly name: "lucide:arrow-up";
+    readonly label: "Arrow up";
+    readonly category: "Arrows";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m5 12l7-7l7 7m-7 7V5\"/>";
+}, {
+    readonly name: "lucide:arrow-down";
+    readonly label: "Arrow down";
+    readonly category: "Arrows";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 5v14m7-7l-7 7l-7-7\"/>";
+}, {
+    readonly name: "lucide:arrow-left";
+    readonly label: "Arrow left";
+    readonly category: "Arrows";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m12 19l-7-7l7-7m7 7H5\"/>";
+}, {
+    readonly name: "lucide:arrow-right";
+    readonly label: "Arrow right";
+    readonly category: "Arrows";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M5 12h14m-7-7l7 7l-7 7\"/>";
+}, {
+    readonly name: "lucide:arrow-up-right";
+    readonly label: "Arrow up-right";
+    readonly category: "Arrows";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M7 7h10v10M7 17L17 7\"/>";
+}, {
+    readonly name: "lucide:refresh-cw";
+    readonly label: "Refresh";
+    readonly category: "Arrows";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M3 12a9 9 0 0 1 9-9a9.75 9.75 0 0 1 6.74 2.74L21 8\"/><path d=\"M21 3v5h-5m5 4a9 9 0 0 1-9 9a9.75 9.75 0 0 1-6.74-2.74L3 16\"/><path d=\"M8 16H3v5\"/></g>";
+}, {
+    readonly name: "lucide:move";
+    readonly label: "Move";
+    readonly category: "Arrows";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 2v20m3-3l-3 3l-3-3M19 9l3 3l-3 3M2 12h20M5 9l-3 3l3 3M9 5l3-3l3 3\"/>";
+}, {
+    readonly name: "lucide:shuffle";
+    readonly label: "Shuffle";
+    readonly category: "Arrows";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"m18 14l4 4l-4 4m0-20l4 4l-4 4\"/><path d=\"M2 18h1.973a4 4 0 0 0 3.3-1.7l5.454-8.6a4 4 0 0 1 3.3-1.7H22M2 6h1.972a4 4 0 0 1 3.6 2.2M22 18h-6.041a4 4 0 0 1-3.3-1.8l-.359-.45\"/></g>";
+}, {
+    readonly name: "lucide:user";
+    readonly label: "User";
+    readonly category: "People";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2\"/><circle cx=\"12\" cy=\"7\" r=\"4\"/></g>";
+}, {
+    readonly name: "lucide:users";
+    readonly label: "Users";
+    readonly category: "People";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2M16 3.128a4 4 0 0 1 0 7.744M22 21v-2a4 4 0 0 0-3-3.87\"/><circle cx=\"9\" cy=\"7\" r=\"4\"/></g>";
+}, {
+    readonly name: "lucide:briefcase";
+    readonly label: "Briefcase";
+    readonly category: "People";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M16 20V4a2 2 0 0 0-2-2h-4a2 2 0 0 0-2 2v16\"/><rect width=\"20\" height=\"14\" x=\"2\" y=\"6\" rx=\"2\"/></g>";
+}, {
+    readonly name: "lucide:building";
+    readonly label: "Building";
+    readonly category: "People";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M12 10h.01M12 14h.01M12 6h.01M16 10h.01M16 14h.01M16 6h.01M8 10h.01M8 14h.01M8 6h.01M9 22v-3a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1v3\"/><rect width=\"16\" height=\"20\" x=\"4\" y=\"2\" rx=\"2\"/></g>";
+}, {
+    readonly name: "lucide:calendar";
+    readonly label: "Calendar";
+    readonly category: "People";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M8 2v3m8-3v3\"/><rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\"/><path d=\"M3 9h18\"/></g>";
+}, {
+    readonly name: "lucide:clock";
+    readonly label: "Clock";
+    readonly category: "People";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><path d=\"M12 6v6l4 2\"/></g>";
+}, {
+    readonly name: "lucide:mail";
+    readonly label: "Mail";
+    readonly category: "People";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"m22 7l-8.991 5.727a2 2 0 0 1-2.009 0L2 7\"/><rect width=\"20\" height=\"16\" x=\"2\" y=\"4\" rx=\"2\"/></g>";
+}, {
+    readonly name: "lucide:message-circle";
+    readonly label: "Message";
+    readonly category: "People";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092a10 10 0 1 0-4.777-4.719\"/>";
+}, {
+    readonly name: "lucide:file";
+    readonly label: "File";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z\"/><path d=\"M14 2v5a1 1 0 0 0 1 1h5\"/></g>";
+}, {
+    readonly name: "lucide:folder";
+    readonly label: "Folder";
+    readonly category: "Objects";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z\"/>";
+}, {
+    readonly name: "lucide:image";
+    readonly label: "Image";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\" ry=\"2\"/><circle cx=\"9\" cy=\"9\" r=\"2\"/><path d=\"m21 15l-3.086-3.086a2 2 0 0 0-2.828 0L6 21\"/></g>";
+}, {
+    readonly name: "lucide:link";
+    readonly label: "Link";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71\"/><path d=\"M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71\"/></g>";
+}, {
+    readonly name: "lucide:paperclip";
+    readonly label: "Paperclip";
+    readonly category: "Objects";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m16 6l-8.414 8.586a2 2 0 0 0 2.829 2.829l8.414-8.586a4 4 0 1 0-5.657-5.657l-8.379 8.551a6 6 0 1 0 8.485 8.485l8.379-8.551\"/>";
+}, {
+    readonly name: "lucide:pin";
+    readonly label: "Pin";
+    readonly category: "Objects";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 17v5M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7a1 1 0 0 1 1-1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4a1 1 0 0 1 1 1z\"/>";
+}, {
+    readonly name: "lucide:map-pin";
+    readonly label: "Map pin";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0\"/><circle cx=\"12\" cy=\"10\" r=\"3\"/></g>";
+}, {
+    readonly name: "lucide:search";
+    readonly label: "Search";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"m21 21l-4.34-4.34\"/><circle cx=\"11\" cy=\"11\" r=\"8\"/></g>";
+}, {
+    readonly name: "lucide:settings";
+    readonly label: "Settings";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M9.671 4.136a2.34 2.34 0 0 1 4.659 0a2.34 2.34 0 0 0 3.319 1.915a2.34 2.34 0 0 1 2.33 4.033a2.34 2.34 0 0 0 0 3.831a2.34 2.34 0 0 1-2.33 4.033a2.34 2.34 0 0 0-3.319 1.915a2.34 2.34 0 0 1-4.659 0a2.34 2.34 0 0 0-3.32-1.915a2.34 2.34 0 0 1-2.33-4.033a2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915\"/><circle cx=\"12\" cy=\"12\" r=\"3\"/></g>";
+}, {
+    readonly name: "lucide:trash-2";
+    readonly label: "Trash";
+    readonly category: "Objects";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M10 11v6m4-6v6m5-11v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6M3 6h18M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2\"/>";
+}, {
+    readonly name: "lucide:lock";
+    readonly label: "Lock";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><rect width=\"18\" height=\"11\" x=\"3\" y=\"11\" rx=\"2\" ry=\"2\"/><path d=\"M7 11V7a5 5 0 0 1 10 0v4\"/></g>";
+}, {
+    readonly name: "lucide:key";
+    readonly label: "Key";
+    readonly category: "Objects";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"m15.5 7.5l2.3 2.3a1 1 0 0 0 1.4 0l2.1-2.1a1 1 0 0 0 0-1.4L19 4m2-2l-9.6 9.6\"/><circle cx=\"7.5\" cy=\"15.5\" r=\"5.5\"/></g>";
+}, {
+    readonly name: "lucide:code";
+    readonly label: "Code";
+    readonly category: "Tech";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m16 18l6-6l-6-6M8 6l-6 6l6 6\"/>";
+}, {
+    readonly name: "lucide:database";
+    readonly label: "Database";
+    readonly category: "Tech";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><ellipse cx=\"12\" cy=\"5\" rx=\"9\" ry=\"3\"/><path d=\"M3 5v14a9 3 0 0 0 18 0V5\"/><path d=\"M3 12a9 3 0 0 0 18 0\"/></g>";
+}, {
+    readonly name: "lucide:server";
+    readonly label: "Server";
+    readonly category: "Tech";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><rect width=\"20\" height=\"8\" x=\"2\" y=\"2\" rx=\"2\" ry=\"2\"/><rect width=\"20\" height=\"8\" x=\"2\" y=\"14\" rx=\"2\" ry=\"2\"/><path d=\"M6 6h.01M6 18h.01\"/></g>";
+}, {
+    readonly name: "lucide:cloud";
+    readonly label: "Cloud";
+    readonly category: "Tech";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M17.5 19H9a7 7 0 1 1 6.71-9h1.79a4.5 4.5 0 1 1 0 9\"/>";
+}, {
+    readonly name: "lucide:git-branch";
+    readonly label: "Branch";
+    readonly category: "Tech";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M15 6a9 9 0 0 0-9 9V3\"/><circle cx=\"18\" cy=\"6\" r=\"3\"/><circle cx=\"6\" cy=\"18\" r=\"3\"/></g>";
+}, {
+    readonly name: "lucide:terminal";
+    readonly label: "Terminal";
+    readonly category: "Tech";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 19h8M4 17l6-6l-6-6\"/>";
+}, {
+    readonly name: "lucide:cpu";
+    readonly label: "CPU";
+    readonly category: "Tech";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M12 20v2m0-20v2m5 16v2m0-20v2M2 12h2m-2 5h2M2 7h2m16 5h2m-2 5h2M20 7h2M7 20v2M7 2v2\"/><rect width=\"16\" height=\"16\" x=\"4\" y=\"4\" rx=\"2\"/><rect width=\"8\" height=\"8\" x=\"8\" y=\"8\" rx=\"1\"/></g>";
+}, {
+    readonly name: "lucide:bug";
+    readonly label: "Bug";
+    readonly category: "Tech";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M12 20v-9m2-4a4 4 0 0 1 4 4v3a6 6 0 0 1-12 0v-3a4 4 0 0 1 4-4zm.12-3.12L16 2\"/><path d=\"M21 21a4 4 0 0 0-3.81-4M21 5a4 4 0 0 1-3.55 3.97M22 13h-4M3 21a4 4 0 0 1 3.81-4M3 5a4 4 0 0 0 3.55 3.97M6 13H2M8 2l1.88 1.88M9 7.13V6a3 3 0 1 1 6 0v1.13\"/></g>";
+}, {
+    readonly name: "lucide:lightbulb";
+    readonly label: "Idea";
+    readonly category: "Ideas";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M15 14c.2-1 .7-1.7 1.5-2.5c1-.9 1.5-2.2 1.5-3.5A6 6 0 0 0 6 8c0 1 .2 2.2 1.5 3.5c.7.7 1.3 1.5 1.5 2.5m0 4h6m-5 4h4\"/>";
+}, {
+    readonly name: "lucide:zap";
+    readonly label: "Zap";
+    readonly category: "Ideas";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M15.914 4a1.5 1.5 0 0 0-2.474-1.561l-9 9A1.5 1.5 0 0 0 5.5 14h4.002a.5.5 0 0 1 .471.666L8.086 20a1.5 1.5 0 0 0 2.475 1.56l9-9A1.5 1.5 0 0 0 18.5 10h-3.997a.5.5 0 0 1-.472-.667z\"/>";
+}, {
+    readonly name: "lucide:target";
+    readonly label: "Target";
+    readonly category: "Ideas";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><circle cx=\"12\" cy=\"12\" r=\"6\"/><circle cx=\"12\" cy=\"12\" r=\"2\"/></g>";
+}, {
+    readonly name: "lucide:rocket";
+    readonly label: "Rocket";
+    readonly category: "Ideas";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09\"/><path d=\"M9 12a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.4 22.4 0 0 1-4 2z\"/><path d=\"M9 12H4s.55-3.03 2-4c1.62-1.08 5 .05 5 .05\"/></g>";
+}, {
+    readonly name: "lucide:trophy";
+    readonly label: "Trophy";
+    readonly category: "Ideas";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M10 14.66V17a1 1 0 0 1-1 1a2 2 0 0 0-2 2v2m7-7.34V17a1 1 0 0 0 1 1a2 2 0 0 1 2 2v2m.916-12H19.5A2.5 2.5 0 0 0 22 7.5V5a1 1 0 0 0-1-1h-3M4 22h16\"/><path d=\"M6 9a6 6 0 0 0 12 0V3a1 1 0 0 0-1-1H7a1 1 0 0 0-1 1z\"/><path d=\"M6.084 10H4.5A2.5 2.5 0 0 1 2 7.5V5a1 1 0 0 1 1-1h3\"/></g>";
+}, {
+    readonly name: "lucide:gift";
+    readonly label: "Gift";
+    readonly category: "Ideas";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><path d=\"M12 7v14m8-10v8a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-8m3.5-4a1 1 0 0 1 0-5A4.8 8 0 0 1 12 7a4.8 8 0 0 1 4.5-5a1 1 0 0 1 0 5\"/><rect width=\"18\" height=\"4\" x=\"3\" y=\"7\" rx=\"1\"/></g>";
+}, {
+    readonly name: "lucide:coffee";
+    readonly label: "Coffee";
+    readonly category: "Ideas";
+    readonly body: "<path fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M10 2v2m4-2v2m2 4a1 1 0 0 1 1 1v8a4 4 0 0 1-4 4H7a4 4 0 0 1-4-4V9a1 1 0 0 1 1-1h14a4 4 0 1 1 0 8h-1M6 2v2\"/>";
+}, {
+    readonly name: "lucide:smile";
+    readonly label: "Smile";
+    readonly category: "Ideas";
+    readonly body: "<g fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><path d=\"M8 14s1.5 2 4 2s4-2 4-2M9 9h.01M15 9h.01\"/></g>";
+}];
+/** Every vendored icon's id, as a literal union. */
+type IconName = (typeof ICON_LIBRARY)[number]["name"];
+
+/**
+ * Emoji stickers. Unlike the icon library there's no artwork to vendor: each
+ * is a Unicode character, drawn by the platform's own colour-emoji font when
+ * its SVG is rasterised — so an emoji looks native to each viewer's OS
+ * (Apple, Segoe, Noto), the same way it would in a chat app.
+ */
+interface EmojiDefinition {
+    /** Stable, set-prefixed id (`emoji:fire`), also what an ImageBlock stores in its `stamp` field. */
+    readonly name: string;
+    readonly label: string;
+    readonly category: string;
+    readonly char: string;
+}
+declare const EMOJI_LIBRARY: readonly [{
+    readonly name: "emoji:grinning";
+    readonly label: "Grinning face";
+    readonly category: "Smileys";
+    readonly char: "😀";
+}, {
+    readonly name: "emoji:joy";
+    readonly label: "Tears of joy";
+    readonly category: "Smileys";
+    readonly char: "😂";
+}, {
+    readonly name: "emoji:smiling";
+    readonly label: "Smiling face";
+    readonly category: "Smileys";
+    readonly char: "😊";
+}, {
+    readonly name: "emoji:heart-eyes";
+    readonly label: "Heart eyes";
+    readonly category: "Smileys";
+    readonly char: "😍";
+}, {
+    readonly name: "emoji:thinking";
+    readonly label: "Thinking face";
+    readonly category: "Smileys";
+    readonly char: "🤔";
+}, {
+    readonly name: "emoji:sunglasses";
+    readonly label: "Sunglasses";
+    readonly category: "Smileys";
+    readonly char: "😎";
+}, {
+    readonly name: "emoji:crying";
+    readonly label: "Crying face";
+    readonly category: "Smileys";
+    readonly char: "😢";
+}, {
+    readonly name: "emoji:angry";
+    readonly label: "Angry face";
+    readonly category: "Smileys";
+    readonly char: "😡";
+}, {
+    readonly name: "emoji:sleeping";
+    readonly label: "Sleeping face";
+    readonly category: "Smileys";
+    readonly char: "😴";
+}, {
+    readonly name: "emoji:mind-blown";
+    readonly label: "Mind blown";
+    readonly category: "Smileys";
+    readonly char: "🤯";
+}, {
+    readonly name: "emoji:grimacing";
+    readonly label: "Grimacing face";
+    readonly category: "Smileys";
+    readonly char: "😬";
+}, {
+    readonly name: "emoji:partying";
+    readonly label: "Partying face";
+    readonly category: "Smileys";
+    readonly char: "🥳";
+}, {
+    readonly name: "emoji:thumbs-up";
+    readonly label: "Thumbs up emoji";
+    readonly category: "Gestures";
+    readonly char: "👍";
+}, {
+    readonly name: "emoji:thumbs-down";
+    readonly label: "Thumbs down emoji";
+    readonly category: "Gestures";
+    readonly char: "👎";
+}, {
+    readonly name: "emoji:clap";
+    readonly label: "Clapping hands";
+    readonly category: "Gestures";
+    readonly char: "👏";
+}, {
+    readonly name: "emoji:raised-hands";
+    readonly label: "Raised hands";
+    readonly category: "Gestures";
+    readonly char: "🙌";
+}, {
+    readonly name: "emoji:folded-hands";
+    readonly label: "Folded hands";
+    readonly category: "Gestures";
+    readonly char: "🙏";
+}, {
+    readonly name: "emoji:eyes";
+    readonly label: "Eyes";
+    readonly category: "Gestures";
+    readonly char: "👀";
+}, {
+    readonly name: "emoji:muscle";
+    readonly label: "Flexed biceps";
+    readonly category: "Gestures";
+    readonly char: "💪";
+}, {
+    readonly name: "emoji:wave";
+    readonly label: "Waving hand";
+    readonly category: "Gestures";
+    readonly char: "👋";
+}, {
+    readonly name: "emoji:red-heart";
+    readonly label: "Red heart";
+    readonly category: "Symbols";
+    readonly char: "❤️";
+}, {
+    readonly name: "emoji:fire";
+    readonly label: "Flame";
+    readonly category: "Symbols";
+    readonly char: "🔥";
+}, {
+    readonly name: "emoji:star";
+    readonly label: "Medium star";
+    readonly category: "Symbols";
+    readonly char: "⭐";
+}, {
+    readonly name: "emoji:check";
+    readonly label: "Check mark button";
+    readonly category: "Symbols";
+    readonly char: "✅";
+}, {
+    readonly name: "emoji:cross";
+    readonly label: "Cross mark";
+    readonly category: "Symbols";
+    readonly char: "❌";
+}, {
+    readonly name: "emoji:warning";
+    readonly label: "Warning sign";
+    readonly category: "Symbols";
+    readonly char: "⚠️";
+}, {
+    readonly name: "emoji:question";
+    readonly label: "Red question mark";
+    readonly category: "Symbols";
+    readonly char: "❓";
+}, {
+    readonly name: "emoji:hundred";
+    readonly label: "Hundred points";
+    readonly category: "Symbols";
+    readonly char: "💯";
+}, {
+    readonly name: "emoji:light-bulb";
+    readonly label: "Light bulb";
+    readonly category: "Symbols";
+    readonly char: "💡";
+}, {
+    readonly name: "emoji:bullseye";
+    readonly label: "Bullseye";
+    readonly category: "Symbols";
+    readonly char: "🎯";
+}, {
+    readonly name: "emoji:party-popper";
+    readonly label: "Party popper";
+    readonly category: "Objects";
+    readonly char: "🎉";
+}, {
+    readonly name: "emoji:rocket";
+    readonly label: "Rocket emoji";
+    readonly category: "Objects";
+    readonly char: "🚀";
+}, {
+    readonly name: "emoji:trophy";
+    readonly label: "Trophy emoji";
+    readonly category: "Objects";
+    readonly char: "🏆";
+}, {
+    readonly name: "emoji:pushpin";
+    readonly label: "Pushpin";
+    readonly category: "Objects";
+    readonly char: "📌";
+}, {
+    readonly name: "emoji:memo";
+    readonly label: "Memo";
+    readonly category: "Objects";
+    readonly char: "📝";
+}, {
+    readonly name: "emoji:calendar";
+    readonly label: "Tear-off calendar";
+    readonly category: "Objects";
+    readonly char: "📅";
+}, {
+    readonly name: "emoji:alarm-clock";
+    readonly label: "Alarm clock";
+    readonly category: "Objects";
+    readonly char: "⏰";
+}, {
+    readonly name: "emoji:speech-balloon";
+    readonly label: "Speech balloon";
+    readonly category: "Objects";
+    readonly char: "💬";
+}];
+type EmojiName = (typeof EMOJI_LIBRARY)[number]["name"];
+declare function isEmojiName(value: unknown): value is EmojiName;
+declare function emojiDefinition(name: string): EmojiDefinition | undefined;
+/** An emoji as a standalone SVG data URL, sized to rasterise sharply (see icons.ts). */
+declare function emojiDataUrl(name: string): string;
+
+/**
+ * What the stamp tool will drop next: one of the six built-in stamp-pad
+ * stickers, an emoji, or any vendored icon. All land on the board the same way
+ * — as an image whose `stamp` field records which one it was (see `placeStamp`).
+ */
+type StickerKind = StampKind | EmojiName | IconName;
+declare function isIconName(value: unknown): value is IconName;
+declare function iconDefinition(name: string): IconDefinition | undefined;
+/** The vendored icons grouped for a picker, in the order they were vendored. */
+declare function iconCategories(): {
+    category: string;
+    icons: readonly IconDefinition[];
+}[];
+/**
+ * An icon as a standalone SVG data URL, drawn in `color`.
+ *
+ * The library's art strokes in `currentColor`, which has no meaning once the
+ * markup is detached into a data URL — an `<img>`/texture has no inherited
+ * colour to resolve it against — so the colour is substituted in rather than
+ * inherited.
+ */
+declare function iconDataUrl(name: string, color: string): string;
+declare function isStickerKind(value: unknown): value is StickerKind;
+/** Human-readable name for any sticker kind — what a placed sticker is called and searched by. */
+declare function stickerLabel(kind: StickerKind): string;
+/**
+ * The image `src` for whichever sticker kind is selected. Stamp-pad stamps
+ * and emoji carry their own colours, so only icons take the Host's colour.
+ */
+declare function stickerDataUrl(kind: StickerKind, color: string): string;
+
 interface ExtensionRegistry {
     readonly extensions: readonly ScrawlExtension[];
     tool(id: ToolId): CustomToolDefinition | undefined;
@@ -1048,6 +2453,11 @@ interface ExtensionRegistry {
  * isn't in it), Custom objects still export via the standard fallback
  * placeholder (`fallback.bounds`/`label`), never silently dropped.
  *
+ * `backgroundColor` should be the Host's actual resolved `boardTheme.surface`
+ * so an export matches what was on screen; defaults to the theme system's
+ * own light-preset default when the caller doesn't have one on hand. The
+ * board's reference grid, if any, is a screen-only aid and never exported.
+ *
  * `resolvedAssets` (ticket #23) maps an Asset reference to an already-
  * resolved `data:` URI — see `assetExport.ts`'s `exportDocumentSVGWithAssets`,
  * which is the only intended caller that ever passes one. Without it, every
@@ -1055,30 +2465,14 @@ interface ExtensionRegistry {
  * placeholder instead of guessing at a URL; a legacy `src`-backed image is
  * unaffected either way.
  */
-declare function documentToSVG(doc: SerializedDocument, now?: number, registry?: ExtensionRegistry, resolvedAssets?: ReadonlyMap<AssetRef, string>): string;
+declare function documentToSVG(doc: SerializedDocument, now?: number, registry?: ExtensionRegistry, backgroundColor?: string, resolvedAssets?: ReadonlyMap<AssetRef, string>): string;
 
 declare const SDK_PACKAGE_NAME = "@scrawl-board/board";
 declare const SDK_DEVELOPMENT_VERSION = "0.0.0-development";
 
-type BoardBounds = {
-    minX: number;
-    minY: number;
-    maxX: number;
-    maxY: number;
-};
-type ScenePath = {
-    id: string;
-    color: string;
-    width: number;
-    points: readonly BoardPoint[];
-};
-type BoardScene = {
-    bounds: BoardBounds;
-    paths: readonly ScenePath[];
-};
 type BoardStroke = Stroke;
 type SerializedBoardStroke = SerializedStroke;
 type SerializedBoardDocument = CurrentSerializedDocument;
 
-export { AddImageCommand, AddNoteCommand, AddStrokesCommand, AddTableCommand, AddTextCommand, AddTimerCommand, BEACON_INSET, BOARD_COLOR, BoardDocument, CURRENT_DOCUMENT_SCHEMA_VERSION, ClusterStore, DeleteImageCommand, DeleteNoteCommand, DeleteStrokesCommand, DeleteTableCommand, DeleteTextCommand, DeleteTimerCommand, DocumentRecoveryError, END_TAPER, ERASE_THRESHOLD, EraseCommand, FOG_COLOR, HIGHLIGHT_COLORS, History, IDENTITY, INK_COLORS, LockItemsCommand, MIN_WIDTH_FACTOR, NOTE_COLORS, NOTE_DEFAULT_SIZE, NOTE_DEFAULT_Z, NOTE_MAX_Z, NOTE_MIN_Z, NOTE_PEEL_STEP, SDK_DEVELOPMENT_VERSION, SDK_PACKAGE_NAME, STAMPS, STAMP_SIZE, SpatialIndex, TABLE_DEFAULT_CELL_HEIGHT, TABLE_DEFAULT_CELL_WIDTH, TABLE_DEFAULT_FONT_SIZE, TEXT_DEFAULT_SIZE, TIMER_DEFAULT_DURATION_MS, TIMER_DEFAULT_SIZE, TIMER_PRESETS_MS, TransformCommand, UpdateImageCommand, UpdateNoteCommand, UpdateTableCommand, UpdateTextCommand, UpdateTimerCommand, apply, applyItemLock, avgScale, canUnlockItem, changeToOps, cloneImage, cloneNote, cloneStroke, cloneTable, cloneText, cloneTimer, documentId, documentToSVG, formatTimer, invert, isIdentity, isStampKind, loadDocumentBytes, measureTable, measureTextBlock, migrateDocument, mul, pauseTimer, placePresenceBeacon, ribbonEdges, rotationAbout, scalingAbout, searchBoard, serializeDocument, serializeLock, serializeStroke, setTimerDuration, stampDataUrl, startTimer, strokeId, timerExpired, timerRemaining, toggleTimer, translation };
-export type { BBox, BoardBounds, BoardPoint, BoardScene, BoardStroke, ClusterIdFactory, Command, CommandKind, CurrentSerializedDocument, CurrentSerializedStroke, DocumentChange, DocumentId, DocumentLoadResult, DocumentRecoveryCode, ImageBlock, KitchenTimer, LockHolder, LockTarget, Lockable, Mat2x3, NoteVote, Op, OpCollection, PresencePlacement, RibbonEdgePoint, ScenePath, SearchHit, SearchHitKind, SearchableBoard, SearchableComment, SerializedBoardDocument, SerializedBoardStroke, SerializedPoint, SerializedStroke, StampKind, StickyNote, Stroke, StrokeId, StrokePoint, StrokeTool, TableBlock, TextBlock, ViewportInset };
+export { ASSET_CACHE_BYTES_DEFAULT, ASSET_CACHE_BYTES_MAX, ASSET_CACHE_BYTES_MIN, ASSET_EXPORT_MAX_DECODED_MEGAPIXELS, ASSET_EXPORT_MAX_ENCODED_BYTES, ASSET_MAX_CONCURRENT_RESOLUTIONS, ASSET_MAX_DECODED_MEGAPIXELS, ASSET_MAX_DIMENSION_PX, ASSET_MAX_ENCODED_BYTES, ASSET_REF_MAX_BYTES, ASSET_REF_PATTERN, AddArrowCommand, AddEllipseCommand, AddGroupCommand, AddHeartCommand, AddImageCommand, AddLineCommand, AddNoteCommand, AddPolygonCommand, AddRectangleCommand, AddStarCommand, AddStrokesCommand, AddTableCommand, AddTextCommand, AddTimerCommand, AssetResolutionError, BEACON_INSET, BoardDocument, CURRENT_DOCUMENT_SCHEMA_VERSION, ClusterStore, CommandBatch, DeleteArrowCommand, DeleteEllipseCommand, DeleteGroupCommand, DeleteHeartCommand, DeleteImageCommand, DeleteLineCommand, DeleteNoteCommand, DeletePolygonCommand, DeleteRectangleCommand, DeleteStarCommand, DeleteStrokesCommand, DeleteTableCommand, DeleteTextCommand, DeleteTimerCommand, DocumentRecoveryError, EMOJI_LIBRARY, END_TAPER, ERASE_THRESHOLD, EraseCommand, FOG_COLOR, HIGHLIGHT_COLORS, History, ICON_LIBRARY, IDENTITY, INK_COLORS, LockItemsCommand, MIN_WIDTH_FACTOR, NOTE_COLORS, NOTE_DEFAULT_SIZE, NOTE_DEFAULT_Z, NOTE_MAX_Z, NOTE_MIN_Z, NOTE_PEEL_STEP, ReorderObjectCommand, SDK_DEVELOPMENT_VERSION, SDK_PACKAGE_NAME, SHAPE_DEFAULT_STROKE, SHAPE_DEFAULT_STROKE_WIDTH, SHAPE_MIN_SIZE, SHAPE_STYLE_DEFAULTS, STAMPS, STAMP_SIZE, SUPPORTED_ASSET_MEDIA_TYPES, SpatialIndex, TABLE_DEFAULT_CELL_HEIGHT, TABLE_DEFAULT_CELL_WIDTH, TABLE_DEFAULT_FONT_SIZE, TEXT_DEFAULT_SIZE, TIMER_DEFAULT_DURATION_MS, TIMER_DEFAULT_SIZE, TIMER_PRESETS_MS, TransformCommand, TransformObjectsCommand, UpdateArrowCommand, UpdateEllipseCommand, UpdateGroupCommand, UpdateHeartCommand, UpdateImageCommand, UpdateLineCommand, UpdateNoteCommand, UpdatePolygonCommand, UpdateRectangleCommand, UpdateStarCommand, UpdateTableCommand, UpdateTextCommand, UpdateTimerCommand, apply, applyItemLock, assetRef, avgScale, canUnlockItem, changeToOps, clampAssetCacheBytes, cloneArrow, cloneCustomObject, cloneEllipse, cloneGroup, cloneHeart, cloneImage, cloneLine, cloneNote, clonePolygon, cloneRectangle, cloneStar, cloneStroke, cloneTable, cloneText, cloneTimer, documentId, documentSize, documentToSVG, emojiDataUrl, emojiDefinition, formatTimer, iconCategories, iconDataUrl, iconDefinition, invert, isAssetRef, isEmojiName, isIconName, isIdentity, isStampKind, isStickerKind, loadDocumentBytes, measureTable, measureTextBlock, migrateDocument, mul, pauseTimer, placePresenceBeacon, ribbonEdges, rotationAbout, scalingAbout, searchBoard, serializeDocument, serializeLock, serializeStroke, setTimerDuration, stampDataUrl, startTimer, stickerDataUrl, stickerLabel, strokeId, timerExpired, timerRemaining, toggleTimer, translation };
+export type { ArrowHeadStyle, ArrowObject, AssetDiagnostic, AssetIngestRequest, AssetIngestResult, AssetIngestor, AssetKind, AssetPurpose, AssetRef, AssetResolutionErrorCode, AssetResolveRequest, AssetResolveResult, AssetResolver, BBox, BoardKeyInput, BoardNotebook, BoardPoint, BoardPointerInput, BoardScene, BoardSection, BoardStroke, ClusterIdFactory, Command, CommandKind, ConnectorBinding, ConnectorBox, ConnectorTarget, CurrentSerializedDocument, CurrentSerializedStroke, CustomBoardObject, CustomObjectAddInput, CustomObjectDefinition, CustomTool, CustomToolDefinition, DocumentChange, DocumentId, DocumentLoadResult, DocumentRecoveryCode, EllipseObject, EmojiDefinition, EmojiName, ExtensionCommand, ExtensionDiagnostic, ExtensionHitResult, ExtensionId, ExtensionRequirement, GroupObject, HeartObject, IconDefinition, IconName, ImageBlock, InputModifiers, JsonObject, JsonValue, KitchenTimer, LineObject, LockHolder, LockTarget, Lockable, Mat2x3, NoteVote, ObjectDescribeContext, ObjectIntent, ObjectType, Op, OpCollection, PolygonObject, PresencePlacement, QueryableBoardObject, ReadonlyCustomObject, RectangleObject, ReorderDirection, RibbonEdgePoint, SceneEllipse, SceneGroup, SceneImage, ScenePath, SceneRect, SceneText, ScrawlExtension, SearchHit, SearchHitKind, SearchableBoard, SearchableComment, SerializedBoardDocument, SerializedBoardPage, SerializedBoardStroke, SerializedPoint, SerializedStroke, StampKind, StarObject, StickerKind, StickyNote, Stroke, StrokeId, StrokePoint, StrokeTool, SupportedAssetMediaType, TableBlock, TextBlock, ToolCancelReason, ToolCapabilities, ToolCursor, ToolId, ViewportInset };