@scrawl-board/board 0.1.0-beta.6 → 0.1.0-beta.8

package/dist/index.d.ts

@@ -184,6 +184,21 @@ interface CustomObjectDefinition<Props extends JsonValue = JsonValue> {
     /** One pure, synchronous step per consecutive schema version. */
     migrate?: Readonly<Record<number, (oldProps: JsonValue) => JsonValue>>;
     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;
@@ -217,6 +232,15 @@ interface SceneGroup extends SceneNodeBase {
     kind: "group";
     children: readonly BoardScene[];
 }
+/**
+ * **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. */
@@ -389,8 +413,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;
@@ -415,6 +454,160 @@ 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.12;
+};
+declare const SHAPE_DEFAULT_STROKE: "#1C1C1E";
+declare const SHAPE_DEFAULT_STROKE_WIDTH: 0.12;
+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;
+}
+interface ArrowObject extends Lockable, Hideable {
+    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;
@@ -435,7 +628,7 @@ interface StrokePoint extends BoardPoint {
  * geometric outline, not an expressive ink mark.
  */
 type StrokeTool = "marker" | "highlighter" | "shape";
-interface Stroke extends Lockable {
+interface Stroke extends Lockable, Hideable {
     id: string;
     color: string;
     baseWidth: number;
@@ -454,7 +647,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;
@@ -480,6 +673,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";
@@ -523,7 +741,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;
@@ -541,7 +759,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;
@@ -571,7 +789,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;
@@ -597,7 +815,7 @@ 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) —
@@ -647,6 +865,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;
@@ -731,6 +958,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 {
@@ -745,12 +1026,73 @@ 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.
+     */
+    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;
@@ -793,6 +1135,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;
@@ -800,18 +1190,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;
 }
 
@@ -847,6 +1288,21 @@ 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 {
@@ -911,6 +1367,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;
@@ -1032,8 +1522,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;
@@ -1050,7 +1745,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;
@@ -1094,10 +1789,10 @@ declare function ribbonEdges(points: StrokePoint[], baseWidth: number, handDrawn
 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;
@@ -1252,7 +1947,7 @@ interface BoardSnapshot {
  * here, matching the engine's own internal selection-badge behavior.
  */
 interface FocusedItem {
-    readonly type: "stroke" | "note" | "text" | "table" | "image" | "timer" | "custom";
+    readonly type: "stroke" | "note" | "text" | "table" | "image" | "timer" | "rectangle" | "ellipse" | "group" | "line" | "arrow" | "polygon" | "star" | "heart" | "custom";
     readonly id: string;
     readonly locked: boolean;
     readonly lockedBy?: string;
@@ -1333,6 +2028,8 @@ interface BoardEventMap {
     "asset-diagnostic": AssetDiagnostic;
     /** A batch of Ops was reconciled (not applied as-sent) by the persistence adapter (ticket #24). */
     "persistence-diagnostic": PersistenceDiagnostic;
+    /** The collaboration server has confirmed receipt of these op ids (Phase 7) — observability only; the Document was already correct via optimistic local apply before this ever fires. */
+    "collaboration-ops-acknowledged": CollaborationAckDiagnostic;
     audit: unknown;
     error: BoardControllerError;
     disposed: undefined;
@@ -1396,9 +2093,12 @@ interface PresenceView {
     readonly height: number;
 }
 /**
- * A Host-owned collaborator, synced in for cursor/roster rendering only.
- * Presence is ephemeral — it never touches the Document, Ops, undo/redo,
- * or persistence — so this is a read/query capability, not an adapter.
+ * A collaborator, synced in for cursor/roster rendering only. Presence is
+ * ephemeral — it never touches the Document, Ops, undo/redo, or persistence
+ * (ADR 0006/0007). Two ways a roster gets populated (`presence.sync`
+ * directly, or a `CollaborationAdapter`'s optional presence channel —
+ * Phase 6, ADR 0015) both feed the exact same read/query capability below;
+ * a Host picks one, not both, for a given controller.
  */
 interface PresenceUser {
     readonly id: string;
@@ -1407,6 +2107,14 @@ interface PresenceUser {
     readonly tool?: string;
     readonly cursor?: PresenceCursor;
     readonly view?: PresenceView;
+    /** Host-supplied extras (avatar URL, role, etc.) — opaque to Scrawl, never interpreted. */
+    readonly metadata?: Record<string, unknown>;
+}
+/** This client's own local presence, published via `presence.broadcast()` (Phase 6). */
+interface LocalPresence {
+    readonly cursor?: PresenceCursor | null;
+    readonly view?: PresenceView | null;
+    readonly tool?: string;
 }
 /**
  * The Custom arm wraps `CustomBoardObject` under the same `type` discriminant
@@ -1434,6 +2142,22 @@ type BoardObject = ({
 } & ImageBlock) | ({
     type: "timer";
 } & KitchenTimer) | ({
+    type: "rectangle";
+} & RectangleObject) | ({
+    type: "ellipse";
+} & EllipseObject) | ({
+    type: "group";
+} & GroupObject) | ({
+    type: "line";
+} & LineObject) | ({
+    type: "arrow";
+} & ArrowObject) | ({
+    type: "polygon";
+} & PolygonObject) | ({
+    type: "star";
+} & StarObject) | ({
+    type: "heart";
+} & HeartObject) | ({
     type: "custom";
     customType: ObjectType;
 } & Omit<CustomBoardObject, "type">);
@@ -1462,6 +2186,30 @@ type BoardObjectInput = {
     type: "timer";
     id?: string;
 } & Omit<KitchenTimer, "id">) | ({
+    type: "rectangle";
+    id?: string;
+} & Omit<RectangleObject, "id">) | ({
+    type: "ellipse";
+    id?: string;
+} & Omit<EllipseObject, "id">) | ({
+    type: "group";
+    id?: string;
+} & Omit<GroupObject, "id">) | ({
+    type: "line";
+    id?: string;
+} & Omit<LineObject, "id">) | ({
+    type: "arrow";
+    id?: string;
+} & Omit<ArrowObject, "id">) | ({
+    type: "polygon";
+    id?: string;
+} & Omit<PolygonObject, "id">) | ({
+    type: "star";
+    id?: string;
+} & Omit<StarObject, "id">) | ({
+    type: "heart";
+    id?: string;
+} & Omit<HeartObject, "id">) | ({
     type: "custom";
     id?: string;
     customType: ObjectType;
@@ -1492,10 +2240,34 @@ type LoadResult = {
 } | {
     state: "missing";
 };
+/**
+ * Result of a whole-document `PersistenceAdapter.replace()` call (ADR 0006:
+ * "Whole-document writes survive only for create, clear-board and import,
+ * where replacing everything is the actual intent"). Revision-gated, unlike
+ * `applyOps` — `conflict` means `baseRevision` was stale (someone else's
+ * write landed first); the caller must reload and never overwrites blind.
+ */
+type ReplaceResult = {
+    state: "applied";
+    revision: string;
+} | {
+    state: "conflict";
+    currentRevision: string;
+};
+/**
+ * The one sanctioned seam for persisting a Board's Document to a Host's own
+ * storage — implement this against a database, an HTTP API, IndexedDB
+ * (see `@scrawl-board/board/local`'s `createIndexedDBPersistence`), or
+ * anything else. `load()` fetches the current state on connect; `applyOps()`
+ * streams incremental Ops as edits happen; `replace()` is only for
+ * whole-document writes (create, clear-board, import — see ADR 0006) and is
+ * revision-gated so a stale write never silently clobbers a newer one.
+ * Passed via `createBoardController({ adapters: { persistence } })`.
+ */
 interface PersistenceAdapter {
     load(context: DocumentContext): Promise<LoadResult>;
     applyOps(context: DocumentContext, ops: readonly ControllerOp[]): Promise<ApplyOpsResult>;
-    replace(context: DocumentContext, document: CurrentSerializedDocument, baseRevision: string): Promise<unknown>;
+    replace(context: DocumentContext, document: CurrentSerializedDocument, baseRevision: string): Promise<ReplaceResult>;
 }
 /**
  * `"reconcile"` (ticket #24) means the server authoritatively resolved the
@@ -1519,14 +2291,59 @@ interface PersistenceDiagnostic {
     rejectedOpIds: readonly string[];
     revision: string;
 }
+/** Emitted as `"collaboration-ops-acknowledged"` (Phase 7) — the server has confirmed receipt of these op ids on the live pipe. */
+interface CollaborationAckDiagnostic {
+    opIds: readonly string[];
+}
 interface ControllerOp {
     id: string;
     schemaVersion: 1;
     kind: "upsert" | "restore" | "remove";
-    objectType: "stroke" | "note" | "text" | "table" | "image" | "timer" | "custom";
+    objectType: "stroke" | "note" | "text" | "table" | "image" | "timer" | "rectangle" | "ellipse" | "group" | "line" | "arrow" | "polygon" | "star" | "heart" | "custom"
+    /**
+     * A whole-document paint-order sync (Phase 3), not a per-object type —
+     * `objectId` is always the fixed sentinel `"order"` and `payload` is
+     * `{ order: string[] }`. The only `objectType` with no matching
+     * `BoardObject`/document collection; kept in this same union (rather
+     * than a separate wire message) so it flows through the existing
+     * `PersistenceAdapter`/`CollaborationAdapter` opaquely, unchanged.
+     */
+     | "order";
     objectId: string;
     payload?: unknown;
+    /**
+     * This op's position in its own originating client's local sequence
+     * (Phase 7) — 1, 2, 3, ... per controller instance, distinct from `id`
+     * (an opaque, globally-unique identifier used for dedup/ack, not
+     * ordering) and from a server's own authoritative ordering (e.g.
+     * `referenceCollaborationServer.ts`'s per-room `version` counter).
+     * Present on every op this SDK originates locally; a remote peer's op
+     * carries whatever its own origin set, unchanged — never renumbered in
+     * transit. Absent on an op minted by decoding the legacy wire envelope
+     * (`scrawlOpEnvelope.ts`), which predates this field and has no
+     * per-client sequence concept of its own.
+     */
+    clientSequence?: number;
+    /**
+     * The `CollaboratorIdentity.id` of this op's originating client (Phase
+     * 7) — set for every op this SDK originates locally when `identity` is
+     * configured, omitted entirely otherwise (never sent as `undefined`).
+     * The explicit foundation for a future per-author undo filter (a local
+     * user's own undo should only ever touch their own ops) — no undo-stack
+     * behavior itself changes this phase.
+     */
+    clientId?: string;
 }
+/**
+ * The one sanctioned seam for real-time multiplayer — implement this against
+ * a Host's own collaboration backend (WebSocket relay, CRDT server, etc.).
+ * `connect()` is called once per controller with the local user's
+ * `identity` and a `receive` callback the adapter invokes with incoming
+ * Ops, presence updates, acks, and connection status; it resolves with a
+ * `CollaborationSession` the controller uses to send local Ops and presence
+ * back out. Passed via `createBoardController({ adapters: { collaboration } })`;
+ * omit it entirely to run single-player.
+ */
 interface CollaborationAdapter {
     connect(options: DocumentContext & {
         identity: CollaboratorIdentity;
@@ -1537,14 +2354,72 @@ interface CollaboratorIdentity {
     id: string;
     name: string;
     color?: string;
+    /** Host-supplied extras (avatar URL, role, etc.) — opaque to Scrawl, forwarded into any resulting `PresenceUser` unread and never interpreted. */
+    metadata?: Record<string, unknown>;
 }
 interface CollaborationReceiver {
     ops(ops: readonly ControllerOp[]): void;
+    /**
+     * The current presence roster (Phase 6, ADR 0015) — always a full
+     * replacement, never a delta, matching `presence.sync`'s existing
+     * semantics exactly (an adapter that aggregates wire deltas into a full
+     * roster before calling this is the adapter's own job, not the
+     * controller's). Required on this interface (not optional) because a
+     * Host only ever *consumes* `CollaborationReceiver` — never implements
+     * it — so adding a required method here cannot break an existing custom
+     * `CollaborationAdapter`. An adapter with no presence support simply
+     * never calls it.
+     */
+    presence(users: readonly PresenceUser[]): void;
+    /**
+     * The server has confirmed receipt of these op ids (Phase 7) —
+     * distinguishes "sent" from "server accepted," which `sendOps` alone
+     * (fire-and-forget) cannot. Required for the same reason `presence` is:
+     * Hosts only ever consume this interface, never implement it, so this
+     * cannot break an existing custom `CollaborationAdapter`. An adapter with
+     * no ack support simply never calls it — the collaboration pipe still
+     * works exactly as it did before this existed, just without the
+     * bookkeeping/observability this enables.
+     */
+    acknowledged(opIds: readonly string[]): void;
     status(state: "online" | "reconnecting" | "offline"): void;
     error(cause: unknown): void;
 }
+/**
+ * Result of `CollaborationSession.requestSync()` (Phase 7). `"ops"` means
+ * the adapter's own live-pipe cache fully covered the gap since the
+ * caller's last known revision — apply `ops` and the client is caught up,
+ * no persistence reload needed. `"unavailable"` means it couldn't (gap too
+ * large, server restarted, or the adapter has no retained history at all)
+ * — the caller must fall back to a persistence-backed reload. This is a
+ * best-effort *liveness* cache, deliberately never a durable source of
+ * truth (ADR 0006's "collaboration is never a second source of document
+ * truth" — see ADR 0015's own extension of that principle to presence,
+ * now extended once more, the same way, to this).
+ */
+type CollaborationSyncResult = {
+    state: "ops";
+    ops: readonly ControllerOp[];
+    serverRevision: string;
+} | {
+    state: "unavailable";
+};
 interface CollaborationSession {
     sendOps(ops: readonly ControllerOp[]): void;
+    /**
+     * Publishes this client's own local presence (Phase 6, ADR 0015) —
+     * best-effort, unordered, never persisted, never an Op. Optional: an
+     * adapter that doesn't support presence simply omits this method, and
+     * `presence.broadcast()` becomes a silent no-op.
+     */
+    updatePresence?(presence: LocalPresence): void;
+    /**
+     * Requests an incremental catch-up after a reconnect (Phase 7) — optional;
+     * an adapter that doesn't support this simply omits the method, and the
+     * caller (`resyncAfterReconnect`) goes straight to its existing
+     * persistence-backed full reload, unchanged from Phase 6.
+     */
+    requestSync?(): Promise<CollaborationSyncResult>;
     close(): Promise<void>;
 }
 interface CreateBoardControllerOptions {
@@ -1584,6 +2459,87 @@ interface CreateBoardControllerOptions {
      * doesn't use the React theme system can set this directly instead.
      */
     boardTheme?: BoardThemeOptions;
+    /**
+     * Debounced auto-flush of pending persistence Ops after document changes
+     * settle (Phase 5). Enabled by default (1000ms debounce) whenever
+     * `adapters.persistence` is configured — today, without this, a Host must
+     * call `flush()` manually after every edit for anything to persist. Pass
+     * `false` to opt out entirely and drive `flush()` yourself, preserving
+     * prior behavior exactly. Never fires on a per-change basis — rapid edits
+     * coalesce into one flush of their final state (ADR 0006).
+     */
+    autosave?: boolean | {
+        debounceMs?: number;
+    };
+    /**
+     * Throttle for `presence.broadcast()` (Phase 6, ADR 0015) — the minimum
+     * interval between outgoing presence updates sent via the configured
+     * `CollaborationAdapter`. Defaults to 50ms. A trailing throttle: the
+     * latest value passed to `broadcast()` always eventually sends, even if
+     * calls arrive faster than this interval.
+     */
+    presenceThrottleMs?: number;
+    /**
+     * Caps how many `ControllerOp`s can sit queued, unsent, for the
+     * persistence pipe (`pendingOps`) or the collaboration pipe
+     * (`pendingCollaborationOps`) at once (Phase 7) — each pipe is capped
+     * independently. Prevents unbounded memory growth from a long-lived
+     * offline session or a stuck adapter. Exceeding it never fails or drops
+     * the local edit itself (the Document already applied it optimistically)
+     * — only queueing for that one pipe is skipped, and a
+     * `{code:"queue-overflow", retryable:false}` error is emitted so a Host
+     * can react. Defaults to 1000 — the Phase 9 collaboration coalescing
+     * above (`collaborationCoalesceMs`) already keeps a busy drag from
+     * approaching this on its own, so hitting it in practice means a pipe
+     * has been offline/stuck for a genuinely long editing session.
+     *
+     * **Recovery** (Phase 9): the dropped op itself is gone from that one
+     * pipe's queue — there is no automatic backfill, and the live
+     * controller keeps running with that pipe now silently missing one
+     * edit. Two things stay true regardless: (1) the in-memory Document is
+     * never affected — a queue-overflow can never corrupt or roll back a
+     * local edit, only skip sending it; (2) staleness is per-object, not
+     * permanent — any *later* edit to that same object produces a brand
+     * new, undropped Op carrying its full current state, which naturally
+     * supersedes the gap (the Op model is already last-write-wins/
+     * idempotent, so a superseding Op doesn't need the earlier one to have
+     * arrived). The real risk is an object that's dropped and never edited
+     * again before the controller is disposed or the page reloads — a Host
+     * that needs strict durability should treat `queue-overflow` as a
+     * signal to check `persistence.state`/`pendingOps` pressure (via
+     * `usePersistenceStatus`/`getSnapshot().connection.persistence`)
+     * before disposing, not assume disposing and reconnecting alone
+     * repairs the gap (a fresh `load()` only returns what the backend
+     * already has, which is exactly what's missing the dropped edit).
+     */
+    maxPendingOps?: number;
+    /**
+     * Coalescing window (ms) for outgoing collaboration Ops (Phase 9) — same
+     * trailing-throttle shape as `presenceThrottleMs`: the first Op after an
+     * idle period sends immediately, and subsequent Ops for the *same*
+     * object within this window replace each other (latest value wins,
+     * matching the already-idempotent Op model) rather than each triggering
+     * its own send. A multi-second drag that previously sent one full Op per
+     * pointer-move now sends at most one per window per touched object.
+     * Persistence (`pendingOps`) is unaffected — it already debounces via
+     * `autosave`, so this option only changes live collaboration traffic.
+     * Defaults to 50ms.
+     */
+    collaborationCoalesceMs?: number;
+    /**
+     * Caps how many resolved objects a single `content.copy`/`content.cut`
+     * (or their Cmd/Ctrl+C/X keyboard equivalents) will hold in the
+     * in-memory clipboard at once (Phase 9) — `expandSelection` recursively
+     * expands groups, so an unbounded selection (a huge group, or thousands
+     * of individually selected strokes) could otherwise clone and retain an
+     * arbitrarily large snapshot indefinitely, until the next copy/cut
+     * replaces it. Exceeding it rejects the whole copy/cut (nothing is
+     * cloned, and — for cut — nothing is removed from the Document either,
+     * never a partial copy of an arbitrary subset) and emits a
+     * `{code:"clipboard-overflow", retryable:false}` error. Defaults to
+     * 5000.
+     */
+    maxClipboardItems?: number;
 }
 interface BoardController {
     readonly document: ReadonlyBoardDocument;
@@ -1615,6 +2571,15 @@ interface BoardController {
     };
     readonly view: {
         fit(): void;
+        /**
+         * Frame the current selection (Phase 8), the same way `fit()` frames the
+         * whole board. A no-op with nothing selected — deliberately doesn't fall
+         * back to `fit()`'s "frame everything," which would be a surprising
+         * result for an empty selection. On a headless board this can only
+         * re-center the view (no viewport to compute a real zoom-to-fit from),
+         * matching `fit()`'s own headless limitation exactly.
+         */
+        zoomToSelection(): void;
         zoomTo(value: number): void;
         centerOn(point: BoardPoint): void;
         get(): BoardView;
@@ -1636,6 +2601,64 @@ interface BoardController {
          * Unknown ids are silently skipped, matching `remove`'s convention.
          */
         duplicate(ids: readonly string[]): readonly string[];
+        /**
+         * Creates a new Group referencing `ids` as its children and returns its
+         * id, as one undoable step. Unknown ids are silently skipped, matching
+         * `duplicate`/`remove`'s convention. A child id that's itself a group
+         * makes a nested group — expanding nested groups into their leaf
+         * members is always the caller's job, never assumed here (matches the
+         * document-model `GroupObject` itself).
+         */
+        group(ids: readonly string[]): string;
+        /**
+         * Dissolves one group, returning its immediate children's ids (a nested
+         * subgroup among them stays intact, itself still a group) — the group
+         * record itself is removed, the children are untouched. A no-op
+         * (returns `[]`) if `groupId` isn't a group.
+         */
+        ungroup(groupId: string): readonly string[];
+        /**
+         * Aligns every given object's matching edge/center to the corresponding
+         * edge/center of their combined bounding box, as one undoable step.
+         * `"top"`/`"bottom"` follow board space's Y-up convention (`"top"` is
+         * the larger Y). Ids that don't resolve, or resolve to a Group (which
+         * has no position of its own), are skipped. A no-op under 2 resolvable
+         * ids — there's nothing to align relative to.
+         */
+        align(ids: readonly string[], edge: "left" | "right" | "top" | "bottom" | "centerX" | "centerY"): void;
+        /**
+         * Spaces the middle objects' centers evenly between the first and last
+         * (sorted along `axis`), as one undoable step — the two endpoints don't
+         * move. Ids that don't resolve, or resolve to a Group, are skipped. A
+         * no-op under 3 resolvable ids — there's no "middle" to distribute.
+         */
+        distribute(ids: readonly string[], axis: "x" | "y"): void;
+        /**
+         * Snapshots `ids` (recursively expanded through any group, same as
+         * `duplicate`) into an internal in-memory clipboard — never
+         * `navigator.clipboard`, scoped to this one controller instance and
+         * replaced wholesale by the next `copy`/`cut`. Read-only; works even
+         * on a read-only board.
+         */
+        copy(ids: readonly string[]): void;
+        /** `copy`, then removes every resolved object (recursively through any group) as one undoable step. */
+        cut(ids: readonly string[]): void;
+        /**
+         * Clones the current clipboard contents onto the board as one undoable
+         * step, offset the same small cascade `duplicate` uses (no cursor
+         * position to paste relative to yet). Returns the new top-level ids —
+         * a pasted group's own id stands for its (also-pasted) children, which
+         * aren't listed separately. `[]` when the clipboard is empty.
+         */
+        paste(): readonly string[];
+        /**
+         * Select every top-level object (Phase 8) — a group's own id stands for
+         * its children, which aren't selected separately, matching `paste`'s own
+         * "what the user sees" id list. Hidden objects are excluded, consistent
+         * with them already being excluded from marquee selection. Works with
+         * no canvas/engine, same as {@link toggleSelectionVisibility}.
+         */
+        selectAll(): void;
         table: {
             addRow(tableId: string): void;
             addCol(tableId: string): void;
@@ -1646,6 +2669,29 @@ interface BoardController {
         };
         select(ids: readonly string[]): void;
         import(document: SerializedBoardDocument): readonly string[];
+        /**
+         * Toggle lock state for the current selection (or focused note/text/
+         * table/image/timer), matching whatever a single Host lock/unlock
+         * control already does per object type. A no-op with nothing selected,
+         * on a headless board, or when every actionable target is locked by
+         * another collaborator who isn't the current lock holder.
+         */
+        toggleSelectionLock(): void;
+        /**
+         * Toggle hidden state for the current selection, as one undo entry
+         * (Phase 8). If any selected object is hidden, shows every selected
+         * object; otherwise hides them all — same "any wins" semantics as
+         * {@link toggleSelectionLock}. Hidden objects stay fully present in the
+         * document (they still serialize, persist, sync, undo/redo) — they just
+         * stop rendering and stop being hit-testable/selectable via pointer
+         * interaction. Unlike `toggleSelectionLock`, this works on a headless
+         * board too: it only touches `selection`/the document, no canvas or
+         * engine involved. Custom objects have no visibility concept (no
+         * `Hideable` field) and are silently skipped, matching how
+         * `toggleSelectionLock` already excludes them. A no-op with nothing
+         * selected or when the selection is only custom objects.
+         */
+        toggleSelectionVisibility(): void;
     };
     readonly query: {
         get(id: string): DeepReadonly<BoardObject> | undefined;
@@ -1674,6 +2720,15 @@ interface BoardController {
         follow(view: PresenceView): void;
         /** Ease the camera to a peer's view; returns false (no-op) while mid-stroke. */
         gather(view: PresenceView): boolean;
+        /**
+         * Publishes this client's own cursor/tool/view for other collaborators
+         * (Phase 6, ADR 0015), via the configured `CollaborationAdapter` —
+         * throttled internally (`presenceThrottleMs` option, default 50ms) so
+         * a raw pointermove stream never becomes a message-per-event flood. A
+         * no-op if no collaboration adapter is configured, or if the
+         * configured one doesn't implement `updatePresence`.
+         */
+        broadcast(local: LocalPresence): void;
     };
     readonly export: {
         svg(): string;
@@ -1699,7 +2754,19 @@ interface BoardController {
     }>;
     dispose(): Promise<void>;
 }
+/**
+ * Creates a {@link BoardController} — the SDK's canonical, capability-grouped
+ * entry point (`content`, `tools`, `style`, `history`, `view`, `query`,
+ * `comments`, `presence`, `export`, `assets`, plus top-level `getSnapshot`/
+ * `subscribe`/`on`/`setReadOnly`/`flush`/`dispose`) for driving a Board
+ * imperatively from any JS/TS runtime. Supply a `canvas` to render, or omit
+ * it to run headless (SSR, tests, or a document/history-only integration).
+ * Persistence and Collaboration are opt-in via `options.adapters` — without
+ * them the controller runs entirely in memory. Call `dispose()` when done to
+ * release the renderer, adapters, and any pending timers.
+ */
 declare function createBoardController(options: CreateBoardControllerOptions): BoardController;
+/** @deprecated Use `BoardController.getSnapshot()`'s return type instead. */
 type LocalBoardSnapshot = {
     documentId: string;
     selectedStrokeId: string | null;
@@ -1708,10 +2775,12 @@ type LocalBoardSnapshot = {
     canRedo: boolean;
     disposed: boolean;
 };
+/** @deprecated Use `CreateBoardControllerOptions` with `createBoardController` instead. */
 type LocalBoardOptions = {
     documentId: string;
     initialDocument?: SerializedBoardDocument;
 };
+/** @deprecated Use `BoardController` (from `createBoardController`) instead — this stroke-only, single-tool surface predates the full capability-grouped controller. */
 type LocalBoard = {
     drawStroke(stroke: Stroke): void;
     selectAt(point: BoardPoint): string | null;
@@ -1722,8 +2791,21 @@ type LocalBoard = {
     subscribe(listener: () => void): () => void;
     dispose(): Promise<void>;
 };
+/** @deprecated Use `createBoardController` instead — this is a thin, stroke-only wrapper kept for the original Phase 1 tracer's compatibility. */
 declare function createLocalBoard(options: LocalBoardOptions): LocalBoard;
 
+interface CreateMemoryPersistenceOptions {
+    /** Pre-seeded documents, keyed by document id — as if a prior session had already saved them. Seeded documents start at revision "1". */
+    seed?: Record<string, CurrentSerializedDocument>;
+}
+/**
+ * Creates a real, in-memory `PersistenceAdapter`. One instance can back
+ * multiple documents (keyed by `DocumentContext.documentId`, like every
+ * other adapter in this package). State lives only in this instance —
+ * discarded on garbage collection, never written to disk.
+ */
+declare function createMemoryPersistence(options?: CreateMemoryPersistenceOptions): PersistenceAdapter;
+
 type ScrawlThemePreset = "light" | "dark";
 type ScrawlDensity = "comfortable" | "compact";
 type ScrawlGridMode = "none" | "line" | "dot";
@@ -1899,10 +2981,19 @@ interface FocusedItemToolbarProps {
     snapshot: BoardSnapshot;
 }
 /**
- * Floating toolbar above the focused note, shape, or text block — Colour,
- * Size (note/text) or Width (shape), Lock/Unlock, Duplicate, Delete.
- * Table/image/timer/custom objects and plain (non-shape) ink strokes never
- * get a toolbar here — out of scope for this destination.
+ * Floating toolbar above the focused note, shape, text block, or semantic
+ * Rectangle/Ellipse — Colour, Size (note/text) or Width (shape), Fill/Stroke
+ * (Rectangle/Ellipse), Lock/Unlock, Duplicate, Delete. Table/image/timer/
+ * custom objects and plain (non-shape) ink strokes never get a toolbar here
+ * — out of scope for this destination.
+ *
+ * Rectangle/Ellipse (Phase 2) are a second, parallel "shape" concept from
+ * the legacy ink-stroke shape below: both draw from the same toolbar
+ * buttons and look the same to a user, but a Rectangle/Ellipse is a real
+ * BoardObject with its own resize handles (independent width/height,
+ * `ShapeResizeHandle`), while a legacy shape-stroke keeps going through the
+ * native selection gizmo. This duality is deliberate and temporary — see
+ * docs/reports/phase-2-document-object-model.md.
  *
  * Lock/Unlock carries no per-user ownership gating: nothing else in this
  * SDK enforces lock ownership either (`content.update` never checks
@@ -1957,6 +3048,16 @@ interface ScrawlProviderProps {
     className?: string;
     style?: ThemeStyle;
 }
+/**
+ * Wraps a Board `controller` you created yourself (via `createBoardController`)
+ * so its descendants can use `useScrawlController`/`useScrawlSnapshot`/etc.
+ * and render its default UI pieces (`DefaultBoardChrome`, `StyleShelf`, ...).
+ * Prefer `Scrawl` unless you need to construct or own the controller's
+ * lifecycle yourself (e.g. you create it outside React, or need it before
+ * first render). Set `disposeOnUnmount` to have this provider call
+ * `controller.dispose()` on unmount; otherwise disposal remains your own
+ * responsibility.
+ */
 declare function ScrawlProvider({ controller, children, preset, theme, portalContainer: customPortal, disposeOnUnmount, onThemeDiagnostic, className, style }: ScrawlProviderProps): react.JSX.Element;
 interface ScrawlProps extends Omit<CreateBoardControllerOptions, "canvas"> {
     children?: ReactNode;
@@ -1977,6 +3078,17 @@ interface ScrawlProps extends Omit<CreateBoardControllerOptions, "canvas"> {
      */
     icons?: Partial<Record<BuiltInTool, ReactNode>>;
 }
+/**
+ * The fastest path to an embedded Board: creates and owns a
+ * `BoardController` for you (constructed once, disposed on unmount) and
+ * renders it into a canvas. Render with no `children` to get the SDK's
+ * default toolbar/UI chrome, or supply your own `children` (using the
+ * `useScrawlController`/`useScrawlSnapshot` hooks, or the exported
+ * `DefaultBoardChrome`/`StyleShelf`/etc. pieces) to build a custom UI on
+ * top of the same controller. Accepts every `CreateBoardControllerOptions`
+ * field except `canvas` (pass `canvas={null}` for a headless board, or an
+ * existing `<canvas>` element to control its identity yourself).
+ */
 declare function Scrawl({ children, preset, theme, portalContainer, className, style, onReady, onError, onThemeDiagnostic, canvas: suppliedCanvas, icons, ...options }: ScrawlProps): react.JSX.Element;
 interface ScrawlCanvasProps {
     element?: HTMLCanvasElement;
@@ -2002,6 +3114,38 @@ declare function ScrawlPortal({ children }: {
 declare function useScrawlController(): BoardController;
 declare function useScrawlTheme(): ScrawlResolvedTheme;
 declare function useScrawlSnapshot(): BoardSnapshot;
+/**
+ * A thin, purely-derived convenience over
+ * `useScrawlSnapshot().connection.persistence` (Phase 5) — for a Host
+ * component that only cares about save status (e.g. a
+ * "Saving…"/"Saved"/"Offline" indicator) and would otherwise re-derive
+ * this same field access itself. Adds no state and no behavior of its
+ * own: React still owns none of persistence, exactly as before — this
+ * hook only re-reads what the controller already tracks.
+ *
+ * Deliberately does *not* go through `useScrawlSnapshot()` (Phase 9):
+ * `changed()` rebuilds the whole `BoardSnapshot` — including a fresh
+ * `connection.persistence` object — on every document mutation, even ones
+ * that never touch persistence at all, so a component using only this
+ * hook would otherwise re-render on every stroke draw. `useSyncStatus`
+ * below memoizes on the value (`state`/`error`), not just the object
+ * reference, and returns the same cached value across renders where
+ * nothing relevant changed — the same shape `usePresence` already uses
+ * for its own independently-scoped store.
+ */
+declare function usePersistenceStatus(): PersistenceSnapshot;
+/** The `CollaborationSnapshot` equivalent of `usePersistenceStatus` (Phase 6) — same value-memoized convenience over `useScrawlSnapshot().connection.collaboration` (Phase 9: see `usePersistenceStatus`'s doc comment for why it doesn't derive from the full snapshot). */
+declare function useCollaborationStatus(): CollaborationSnapshot;
+/**
+ * The current presence roster (Phase 6), live-updating — wraps
+ * `controller.presence.list()`/`subscribe` the same way `useScrawlSnapshot`
+ * wraps the controller's main snapshot, via `useSyncExternalStore`. Does
+ * not re-render on every remote pointer move by itself; it re-renders
+ * whenever the roster the controller already tracks changes, at whatever
+ * rate that arrives at (throttled adapter-side, per `presenceThrottleMs`).
+ */
+declare function usePresence(): readonly PresenceUser[];
+/** @deprecated Use `Scrawl` instead — this predates the full capability-grouped `BoardController` and only exposes the stroke-only `LocalBoard` surface. */
 type ScrawlBoardProps = {
     documentId: string;
     initialDocument?: SerializedBoardDocument;
@@ -2009,7 +3153,8 @@ type ScrawlBoardProps = {
     className?: string;
     style?: CSSProperties;
 };
+/** @deprecated Use `Scrawl` instead — this predates the full capability-grouped `BoardController` and only exposes the stroke-only `LocalBoard` surface. */
 declare function ScrawlBoard({ documentId, initialDocument, onReady, className, style }: ScrawlBoardProps): react.JSX.Element;
 
-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, AddImageCommand, AddNoteCommand, AddStrokesCommand, AddTableCommand, AddTextCommand, AddTimerCommand, AssetResolutionError, BEACON_INSET, BoardDocument, CURRENT_DOCUMENT_SCHEMA_VERSION, ClusterStore, DefaultBoardChrome, DeleteImageCommand, DeleteNoteCommand, DeleteStrokesCommand, DeleteTableCommand, DeleteTextCommand, DeleteTimerCommand, DocumentRecoveryError, END_TAPER, ERASE_THRESHOLD, EraseCommand, FOG_COLOR, FocusedItemToolbar, HIGHLIGHT_COLORS, History, IDENTITY, INK_COLORS, InlineEditors, LockItemsCommand, MIN_WIDTH_FACTOR, MultiplayerCursors, 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, SUPPORTED_ASSET_MEDIA_TYPES, Scrawl, ScrawlBoard, ScrawlCanvas, ScrawlDefaultUI, ScrawlPortal, ScrawlProvider, SpatialIndex, StyleShelf, 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, assetRef, avgScale, canUnlockItem, changeToOps, clampAssetCacheBytes, cloneCustomObject, cloneImage, cloneNote, cloneStroke, cloneTable, cloneText, cloneTimer, createBoardController, createLocalBoard, documentId, documentToSVG, formatTimer, invert, isAssetRef, isIdentity, isStampKind, loadDocumentBytes, measureTable, measureTextBlock, migrateDocument, mul, pauseTimer, placePresenceBeacon, resolveScrawlTheme, ribbonEdges, rotationAbout, scalingAbout, scrawlThemePresets, searchBoard, serializeDocument, serializeLock, serializeStroke, setTimerDuration, stampDataUrl, startTimer, strokeId, timerExpired, timerRemaining, toggleTimer, translation, useScrawlController, useScrawlSnapshot, useScrawlTheme, validateScrawlTheme };
-export type { ApplyOpsResult, AssetDiagnostic, AssetIngestRequest, AssetIngestResult, AssetIngestor, AssetKind, AssetPurpose, AssetRef, AssetResolutionErrorCode, AssetResolveRequest, AssetResolveResult, AssetResolver, BBox, BoardController, BoardControllerError, BoardEventMap, BoardKeyInput, BoardObject, BoardObjectInput, BoardObjectPatch, BoardPoint, BoardPointerInput, BoardScene, BoardSlotProps, BoardSnapshot, BoardStroke, BoardStyle, BoardThemeOptions, BoardView, BuiltInTool, ClusterIdFactory, CollaborationAdapter, CollaborationReceiver, CollaborationSession, CollaborationSnapshot, CollaboratorIdentity, Command, CommandKind, CommentMarker, ControllerOp, CreateBoardControllerOptions, CurrentSerializedDocument, CurrentSerializedStroke, CustomBoardObject, CustomObjectAddInput, CustomObjectDefinition, CustomTool, CustomToolDefinition, DeepReadonly, DefaultBoardChromeProps, DefaultUIRegion, DefaultUISlot, DefaultUISlots, DialogSlotProps, DocumentChange, DocumentContext, DocumentId, DocumentLoadResult, DocumentRecoveryCode, ExtensionCommand, ExtensionDiagnostic, ExtensionHitResult, ExtensionId, ExtensionRequirement, FocusedItem, FocusedItemToolbarProps, ImageBlock, InlineEditorsProps, InputModifiers, JsonObject, JsonValue, KitchenTimer, LoadResult, LocalBoard, LocalBoardOptions, LocalBoardSnapshot, LockHolder, LockTarget, Lockable, Mat2x3, MultiplayerCursorsProps, NoteVote, ObjectDescribeContext, ObjectIntent, ObjectType, Op, OpCollection, PersistenceAdapter, PersistenceDiagnostic, PersistenceSnapshot, PresenceCursor, PresencePlacement, PresenceUser, PresenceView, QueryableBoardObject, ReadonlyBoardDocument, ReadonlyCustomObject, ReadonlyDocumentChange, RibbonEdgePoint, SceneEllipse, SceneGroup, SceneImage, ScenePath, SceneRect, SceneText, ScrawlBoardProps, ScrawlCanvasProps, ScrawlDefaultUIProps, ScrawlDensity, ScrawlExtension, ScrawlGridMode, ScrawlProps, ScrawlProviderProps, ScrawlResolvedTheme, ScrawlSurfaceTexture, ScrawlTheme, ScrawlThemeDiagnostic, ScrawlThemePreset, ScreenPoint, ScreenRect, SearchHit, SearchHitKind, SearchableBoard, SearchableComment, SerializedBoardDocument, SerializedBoardStroke, SerializedPoint, SerializedStroke, StampKind, StickyNote, Stroke, StrokeId, StrokePoint, StrokeTool, StyleShelfProps, SupportedAssetMediaType, TableBlock, TextBlock, ToolCancelReason, ToolCapabilities, ToolCursor, ToolId, 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, DefaultBoardChrome, DeleteArrowCommand, DeleteEllipseCommand, DeleteGroupCommand, DeleteHeartCommand, DeleteImageCommand, DeleteLineCommand, DeleteNoteCommand, DeletePolygonCommand, DeleteRectangleCommand, DeleteStarCommand, DeleteStrokesCommand, DeleteTableCommand, DeleteTextCommand, DeleteTimerCommand, DocumentRecoveryError, END_TAPER, ERASE_THRESHOLD, EraseCommand, FOG_COLOR, FocusedItemToolbar, HIGHLIGHT_COLORS, History, IDENTITY, INK_COLORS, InlineEditors, LockItemsCommand, MIN_WIDTH_FACTOR, MultiplayerCursors, 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, Scrawl, ScrawlBoard, ScrawlCanvas, ScrawlDefaultUI, ScrawlPortal, ScrawlProvider, SpatialIndex, StyleShelf, 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, createBoardController, createLocalBoard, createMemoryPersistence, documentId, documentSize, documentToSVG, formatTimer, invert, isAssetRef, isIdentity, isStampKind, loadDocumentBytes, measureTable, measureTextBlock, migrateDocument, mul, pauseTimer, placePresenceBeacon, resolveScrawlTheme, ribbonEdges, rotationAbout, scalingAbout, scrawlThemePresets, searchBoard, serializeDocument, serializeLock, serializeStroke, setTimerDuration, stampDataUrl, startTimer, strokeId, timerExpired, timerRemaining, toggleTimer, translation, useCollaborationStatus, usePersistenceStatus, usePresence, useScrawlController, useScrawlSnapshot, useScrawlTheme, validateScrawlTheme };
+export type { ApplyOpsResult, ArrowHeadStyle, ArrowObject, AssetDiagnostic, AssetExportFailure, AssetIngestRequest, AssetIngestResult, AssetIngestor, AssetKind, AssetPurpose, AssetRef, AssetResolutionErrorCode, AssetResolveRequest, AssetResolveResult, AssetResolver, BBox, BoardController, BoardControllerError, BoardEventMap, BoardKeyInput, BoardObject, BoardObjectInput, BoardObjectPatch, BoardPoint, BoardPointerInput, BoardScene, BoardSlotProps, BoardSnapshot, BoardStroke, BoardStyle, BoardThemeOptions, BoardView, BuiltInTool, ClusterIdFactory, CollaborationAckDiagnostic, CollaborationAdapter, CollaborationReceiver, CollaborationSession, CollaborationSnapshot, CollaborationSyncResult, CollaboratorIdentity, Command, CommandKind, CommentMarker, ControllerOp, CreateBoardControllerOptions, CreateMemoryPersistenceOptions, CurrentSerializedDocument, CurrentSerializedStroke, CustomBoardObject, CustomObjectAddInput, CustomObjectDefinition, CustomTool, CustomToolDefinition, DeepReadonly, DefaultBoardChromeProps, DefaultUIRegion, DefaultUISlot, DefaultUISlots, DialogSlotProps, DocumentChange, DocumentContext, DocumentId, DocumentLoadResult, DocumentRecoveryCode, EllipseObject, ExportDocumentSVGOptions, ExportDocumentSVGResult, ExtensionCommand, ExtensionDiagnostic, ExtensionHitResult, ExtensionId, ExtensionRequirement, FocusedItem, FocusedItemToolbarProps, GroupObject, HeartObject, ImageBlock, InlineEditorsProps, InputModifiers, JsonObject, JsonValue, KitchenTimer, LineObject, LoadResult, LocalBoard, LocalBoardOptions, LocalBoardSnapshot, LocalPresence, LockHolder, LockTarget, Lockable, Mat2x3, MultiplayerCursorsProps, NoteVote, ObjectDescribeContext, ObjectIntent, ObjectType, Op, OpCollection, PersistenceAdapter, PersistenceDiagnostic, PersistenceSnapshot, PolygonObject, PresenceCursor, PresencePlacement, PresenceUser, PresenceView, QueryableBoardObject, ReadonlyBoardDocument, ReadonlyCustomObject, ReadonlyDocumentChange, RectangleObject, ReorderDirection, ReplaceResult, RibbonEdgePoint, SceneEllipse, SceneGroup, SceneImage, ScenePath, SceneRect, SceneText, ScrawlBoardProps, ScrawlCanvasProps, ScrawlDefaultUIProps, ScrawlDensity, ScrawlExtension, ScrawlGridMode, ScrawlProps, ScrawlProviderProps, ScrawlResolvedTheme, ScrawlSurfaceTexture, ScrawlTheme, ScrawlThemeDiagnostic, ScrawlThemePreset, ScreenPoint, ScreenRect, SearchHit, SearchHitKind, SearchableBoard, SearchableComment, SerializedBoardDocument, SerializedBoardStroke, SerializedPoint, SerializedStroke, StampKind, StarObject, StickyNote, Stroke, StrokeId, StrokePoint, StrokeTool, StyleShelfProps, SupportedAssetMediaType, TableBlock, TextBlock, ToolCancelReason, ToolCapabilities, ToolCursor, ToolId, ViewportInset };