@svgsketch/core 2.0.0 → 2.2.0

package/dist/index.d.mts

@@ -604,9 +604,10 @@ declare enum PathPointType {
  * History: this union previously existed twice — a strong form in the
  * editor's `connection-manager.ts` and a `Record<string, unknown>`-typed
  * mirror in the worker's `collab/types.ts`. Both now alias this one.
- * The `*Operation` sub-unions re-declare, in instantiated form, the
- * generic op shapes from `@svgsketch/shared` — core has zero
- * dependencies, so it cannot import them.
+ * `@svgsketch/shared` also carried generic versions of the `*Operation`
+ * sub-unions; they had drifted (no `animationKeyframe:*`, no
+ * guide/measurement `:move`) because nothing imported the drifted
+ * members, and they are deleted — this file is the only declaration.
  *
  * **Extra-quarantine contract (schema v5):** op state is always FLAT.
  * `shape:add` / `shape:update` payloads carry unknown keys at the top
@@ -624,6 +625,29 @@ interface CollabClock {
     updatedAt?: number;
     clientId?: string;
 }
+/** A resolved last-writer-wins clock stored beside collaborative state. */
+interface CollaborationStamp {
+    updatedAt: number;
+    clientId: string;
+}
+/**
+ * Operational conflict metadata for a collaborative document.
+ *
+ * This is deliberately separate from authored `HistorySnapshot` state.
+ * It travels with and is persisted beside the room snapshot so a restart
+ * cannot forget which write won, but document serializers do not write it
+ * into `.svgs` files.
+ */
+interface CollaborationState {
+    /** Per-shape, per-property clocks, including tombstones for removed props. */
+    shapeProps?: Record<string, Record<string, CollaborationStamp>>;
+    /** Clocks for id-keyed document resources and whole-value deltas. */
+    resources?: Record<string, CollaborationStamp>;
+}
+/** The collaboration wire/storage snapshot: authored state plus CRDT metadata. */
+interface CollaborationSnapshot extends HistorySnapshot {
+    collaborationState?: CollaborationState;
+}
 /**
  * The shape state a `shape:update` carries.
  *
@@ -777,6 +801,44 @@ type MetadataDeltaOperation = {
     patch: OpMetadataPatch;
     removeKeys?: string[];
 } & CollabClock;
+/**
+ * Template variables (protocol v6).
+ *
+ * Keyed by `name`, not `id`: the name IS the CSS custom property
+ * (`--name`) and the `{{name}}` substitution token, so a synthetic id
+ * would be a second identity for one thing. `upsertResourceByName` /
+ * `removeResourceByName` in `model/resource-delta.ts` address that key.
+ *
+ * These carry a `TemplateVariable` verbatim rather than a patch: the
+ * record is four small fields and a whole-value upsert is what makes two
+ * clients editing DIFFERENT variables both survive.
+ */
+type TemplateVariableOperation = ({
+    type: 'templateVariables:set';
+    templateVariables: NonNullable<HistorySnapshot['templateVariables']>;
+} & CollabClock) | ({
+    type: 'templateVariable:upsert';
+    templateVariable: TemplateVariable;
+    index?: number;
+} & CollabClock) | ({
+    type: 'templateVariable:remove';
+    name: string;
+} & CollabClock);
+/**
+ * Export profile items (protocol v6). Id-keyed like every other document
+ * collection.
+ */
+type ExportItemOperation = ({
+    type: 'exportItems:set';
+    exportItems: NonNullable<HistorySnapshot['exportItems']>;
+} & CollabClock) | ({
+    type: 'exportItem:upsert';
+    exportItem: SerializedExportItem;
+    index?: number;
+} & CollabClock) | ({
+    type: 'exportItem:remove';
+    id: string;
+} & CollabClock);
 type ClipMaskOperation = ({
     type: 'clipMask:upsert';
     clipMaskGroup: SerializedClipMaskGroup;
@@ -908,7 +970,18 @@ type Operation = {
 } | {
     type: 'documentStyles:set';
     documentStyles: NonNullable<HistorySnapshot['documentStyles']>;
-} | {
+} | TemplateVariableOperation | ExportItemOperation
+/**
+ * Authored color glyphs (protocol v6). Whole-value, unlike the two
+ * collections above: the library is a VERSIONED envelope
+ * (`{ version: 1, entries }`), so a granular entry op would have to
+ * carry the envelope version too and could interleave entries from two
+ * versions into one library. `null` clears it.
+ */
+ | ({
+    type: 'colorGlyphLibrary:set';
+    colorGlyphLibrary: HistorySnapshot['colorGlyphLibrary'] | null;
+} & CollabClock) | {
     type: 'animation:set';
     animationTimeline: HistorySnapshot['animationTimeline'];
 } | AnimationOperation
@@ -1135,8 +1208,19 @@ interface RichTextLineSpan {
     start: number;
     end: number;
 }
-/** The style every rich-text document starts from (mirrors the editor's
- *  DEFAULT_TEXT_STYLE). Also the source of `RICH_TEXT_STYLE_KEYS`. */
+/**
+ * The style every rich-text document starts from, and the source of
+ * `RICH_TEXT_STYLE_KEYS`.
+ *
+ * FROZEN, nested objects included. This object is the single default for
+ * every replica: core resolves against it, and the editor's
+ * `DEFAULT_TEXT_STYLE` (apps/editor/src/typography/text-style.ts) IS this
+ * object rather than a second copy of it, so a mutation here would reach
+ * every consumer at once. Callers spread it (`createDefaultTextStyle`
+ * deep-copies `textDecoration` for exactly this reason); nothing writes
+ * through it, and the freeze makes that a guarantee rather than a
+ * convention.
+ */
 declare const DEFAULT_RICH_TEXT_STYLE: RichTextResolvedStyle;
 /** Every field of a resolved rich-text style, in declaration order. */
 declare const RICH_TEXT_STYLE_KEYS: readonly (keyof RichTextResolvedStyle)[];
@@ -1147,14 +1231,19 @@ declare const RICH_TEXT_STYLE_KEYS: readonly (keyof RichTextResolvedStyle)[];
  */
 declare function mergeRichTextStyle(base: RichTextResolvedStyle, delta: RichTextStyleDelta): RichTextResolvedStyle;
 /**
- * FIELD-COMPLETE style equality.
+ * FIELD-COMPLETE style equality — the ONE implementation.
  *
- * Deliberately diverges from the editor's `areTextStylesEqual`
- * (apps/editor/src/typography/text-style.ts), which omits `writingMode` and
- * `fontVariationSettings` and therefore silently merges segments that differ
- * in them. Comparing every field is required here: a run whose only override
- * is a variation axis must survive derivation, and the delta form makes the
- * difference observable rather than absorbing it.
+ * Iterates `RICH_TEXT_STYLE_KEYS` rather than listing fields, so a field
+ * added to `RichTextResolvedStyle` is compared without anyone remembering
+ * to update this function. The editor's `areTextStylesEqual`
+ * (apps/editor/src/typography/text-style.ts) is a re-export of this.
+ *
+ * It used to be a separate hand-written chain of `===` comparisons that
+ * omitted `writingMode` and `fontVariationSettings`, so two styles
+ * differing only in those compared EQUAL. That silently merged adjacent
+ * layout segments and made an imported `<tspan>` override look like no
+ * override at all. Comparing every field is required: a run whose only
+ * override is a variation axis must survive derivation.
  */
 declare function richTextStylesEqual(a: RichTextResolvedStyle, b: RichTextResolvedStyle): boolean;
 /** Structural equality of two style deltas (same declared fields, same
@@ -2695,6 +2784,13 @@ interface CommonNodeProps extends CommonTransformNodeProps {
     requiredExtensions?: string;
     /** Passthrough inline CSS declarations the editor doesn't model. */
     inlineStyle?: Record<string, string>;
+    /**
+     * XML attributes authored through the inspector that have no typed model
+     * property. String values project the attribute verbatim; `null` is a
+     * model-backed removal tombstone for attributes present at an ingest
+     * boundary but not otherwise represented by the editor.
+     */
+    authoredAttributes?: Record<string, string | null>;
     /** Template-variable bindings: property name → variable name. */
     bindings?: Record<string, string>;
     /** Shape-scoped `<script>` elements (SVG 2 §15.9). Stored inert. */
@@ -2785,7 +2881,21 @@ interface TextNodeProps extends CommonNodeProps {
     fontSize: number;
     text: string;
     fontFamily: string;
-    fontWeight: string;
+    /**
+     * CSS Fonts 4 §2.2: a keyword or a `<number>`. Declared as the parsed
+     * form, matching `RichTextResolvedStyle.fontWeight` and the `Text`
+     * accessor, both of which already said `number | 'normal' | 'bold'`.
+     *
+     * This said `string` while numbers flowed through it anyway — the
+     * accessor cast the mismatch away. The cost was real: one import path
+     * stored the raw attribute string and another the parsed number, so
+     * `font-weight="400"` round-tripped as `400` on one generation and
+     * `"400"` on the next, and `richTextStylesEqual` (which compares with
+     * `!==`) read those as DIFFERENT styles — merging layout segments it
+     * should have split and emitting `text:format` deltas for a change
+     * nobody made.
+     */
+    fontWeight: number | 'normal' | 'bold';
     fontStyle: string;
     fontVariant: string;
     fontVariantLigatures: string;
@@ -3339,7 +3449,7 @@ interface SerializedShape {
     type: string;
     state: SerializedShapeState;
 }
-declare const SERIALIZED_SHAPE_STATE_KEYS: readonly ["transformMatrix", "scaleX", "scaleY", "translateX", "translateY", "rotation", "skewX", "skewY", "customPivot", "rawTransform", "ancestorTransform", "layerName", "fillColor", "borderColor", "borderWidth", "opacity", "fillOpacity", "strokeOpacity", "locked", "visible", "fillType", "fillGradient", "strokeType", "strokeGradient", "fillRule", "strokeLinejoin", "strokeLinecap", "strokeMiterlimit", "lineStyle", "dashLength", "gapLength", "dashOffset", "strokeDasharray", "colorInterpolation", "filters", "filterColorInterpolation", "filterUnits", "primitiveUnits", "filterX", "filterY", "filterWidth", "filterHeight", "metadata", "cssClipPath", "cssMaskProperties", "groupId", "structural", "displayMode", "display", "visibility", "inheritFill", "inheritStroke", "preserveFillOpacity", "preserveStrokeOpacity", "fillLibraryId", "strokeLibraryId", "filterLibraryIds", "fillRuleExplicit", "paintOrder", "vectorEffect", "transformBox", "pathLength", "markerStart", "markerMid", "markerEnd", "blendMode", "shapeRendering", "textRendering", "imageRendering", "colorRendering", "systemLanguage", "requiredExtensions", "inlineStyle", "bindings", "scripts", "lastSolidFillColor", "lastSolidStrokeColor", "connectionPoints", "isRootSvg", "x", "y", "width", "height", "rx", "ry", "cornerRadius", "cornerShape", "cornerMode", "cornerRadiusTL", "cornerRadiusTR", "cornerRadiusBL", "cornerRadiusBR", "cornerShapeTL", "cornerShapeTR", "cornerShapeBL", "cornerShapeBR", "size", "radius", "cx", "cy", "shiftAngle", "x1", "y1", "x2", "y2", "startEndpoint", "endEndpoint", "routingMode", "sourceRef", "targetRef", "sourcePoint", "targetPoint", "waypoints", "label", "labelPosition", "labelOffset", "mermaidEdgeStyle", "textX", "textY", "fontSize", "text", "fontFamily", "fontWeight", "fontStyle", "fontVariant", "fontVariantLigatures", "fontVariantPosition", "fontVariantCaps", "fontVariantNumeric", "fontVariantEastAsian", "textDecoration", "textTransform", "baselineShift", "dominantBaseline", "writingMode", "textAnchor", "letterSpacing", "wordSpacing", "lineHeight", "inlineSize", "overflowWrap", "whiteSpace", "textDirection", "unicodeBidi", "useRichText", "richTextRuns", "richTextData", "charOffsets", "fontVariationSettings", "linePositions", "textLength", "lengthAdjust", "shapeInsideRef", "shapePadding", "isTextPath", "textPathPoints", "textPathStartOffset", "textPathStartOffsetUnit", "textPathSide", "textPathMethod", "textPathSpacing", "textPathLengthAdjust", "textPathLength", "textPathLengthUnit", "textPathPathLength", "textPathCurveType", "textPathInlineFormat", "textPathRefShapeId", "textPathImportRefId", "href", "originalWidth", "originalHeight", "preserveAspectRatio", "specPreserveAspectRatio", "imageOpacity", "pathPoints", "pathArcParams", "pathControlBounds", "pathCurveType", "pathClosed", "pathTension", "polylinePoints", "polylineClosed", "sides", "arms", "innerRadiusPercent", "armWidthPercent", "turns", "thicknessPercent", "spiralDirection", "teeth", "toothDepthPercent", "holeRadiusPercent", "headWidthPercent", "headLengthPercent", "shaftWidthPercent", "tailAngleDeg", "tailLengthPercent", "tailWidthPercent", "lobeRadiusPercent", "cleftDepthPercent", "boltSegments", "boltJaggednessPercent", "boltWidthPercent", "cloudBumps", "cloudPuffinessPercent", "slantPercent", "topWidthPercent", "capHeightPercent", "waveAmplitudePercent", "symbolId", "symbolOverrides", "variantKey", "instancePresentation", "scaleContentToViewport", "groupData", "mediaKind", "mediaMimeType", "naturalDuration", "begin", "trimStart", "trimEnd", "volume", "muted", "loop", "playbackRate", "mediaOpacity", "fadeInDuration", "fadeOutDuration", "posterHref", "sourceRect", "hrefXlink", "linkTarget", "linkRel", "linkDownload", "linkPing", "linkHreflang", "linkType", "linkReferrerPolicy", "targetShapeId", "offsetX", "offsetY", "targetWidth", "targetHeight", "broken", "switchSystemLanguage", "switchRequiredExtensions", "svgX", "svgY", "svgWidth", "svgHeight", "svgViewBoxX", "svgViewBoxY", "svgViewBoxWidth", "svgViewBoxHeight", "svgPreserveAspectRatio", "viewBoxX", "viewBoxY", "viewBoxWidth", "viewBoxHeight", "viewName", "viewPreserveAspectRatio", "viewZoomAndPan", "viewTarget", "isHomeView", "children", "viewLinkedSvgId"];
+declare const SERIALIZED_SHAPE_STATE_KEYS: readonly ["transformMatrix", "scaleX", "scaleY", "translateX", "translateY", "rotation", "skewX", "skewY", "customPivot", "rawTransform", "ancestorTransform", "layerName", "fillColor", "borderColor", "borderWidth", "opacity", "fillOpacity", "strokeOpacity", "locked", "visible", "fillType", "fillGradient", "strokeType", "strokeGradient", "fillRule", "strokeLinejoin", "strokeLinecap", "strokeMiterlimit", "lineStyle", "dashLength", "gapLength", "dashOffset", "strokeDasharray", "colorInterpolation", "filters", "filterColorInterpolation", "filterUnits", "primitiveUnits", "filterX", "filterY", "filterWidth", "filterHeight", "metadata", "cssClipPath", "cssMaskProperties", "groupId", "structural", "displayMode", "display", "visibility", "inheritFill", "inheritStroke", "preserveFillOpacity", "preserveStrokeOpacity", "fillLibraryId", "strokeLibraryId", "filterLibraryIds", "fillRuleExplicit", "paintOrder", "vectorEffect", "transformBox", "pathLength", "markerStart", "markerMid", "markerEnd", "blendMode", "shapeRendering", "textRendering", "imageRendering", "colorRendering", "systemLanguage", "requiredExtensions", "inlineStyle", "authoredAttributes", "bindings", "scripts", "lastSolidFillColor", "lastSolidStrokeColor", "connectionPoints", "isRootSvg", "x", "y", "width", "height", "rx", "ry", "cornerRadius", "cornerShape", "cornerMode", "cornerRadiusTL", "cornerRadiusTR", "cornerRadiusBL", "cornerRadiusBR", "cornerShapeTL", "cornerShapeTR", "cornerShapeBL", "cornerShapeBR", "size", "radius", "cx", "cy", "shiftAngle", "x1", "y1", "x2", "y2", "startEndpoint", "endEndpoint", "routingMode", "sourceRef", "targetRef", "sourcePoint", "targetPoint", "waypoints", "label", "labelPosition", "labelOffset", "mermaidEdgeStyle", "textX", "textY", "fontSize", "text", "fontFamily", "fontWeight", "fontStyle", "fontVariant", "fontVariantLigatures", "fontVariantPosition", "fontVariantCaps", "fontVariantNumeric", "fontVariantEastAsian", "textDecoration", "textTransform", "baselineShift", "dominantBaseline", "writingMode", "textAnchor", "letterSpacing", "wordSpacing", "lineHeight", "inlineSize", "overflowWrap", "whiteSpace", "textDirection", "unicodeBidi", "useRichText", "richTextRuns", "richTextData", "charOffsets", "fontVariationSettings", "linePositions", "textLength", "lengthAdjust", "shapeInsideRef", "shapePadding", "isTextPath", "textPathPoints", "textPathStartOffset", "textPathStartOffsetUnit", "textPathSide", "textPathMethod", "textPathSpacing", "textPathLengthAdjust", "textPathLength", "textPathLengthUnit", "textPathPathLength", "textPathCurveType", "textPathInlineFormat", "textPathRefShapeId", "textPathImportRefId", "href", "originalWidth", "originalHeight", "preserveAspectRatio", "specPreserveAspectRatio", "imageOpacity", "pathPoints", "pathArcParams", "pathControlBounds", "pathCurveType", "pathClosed", "pathTension", "polylinePoints", "polylineClosed", "sides", "arms", "innerRadiusPercent", "armWidthPercent", "turns", "thicknessPercent", "spiralDirection", "teeth", "toothDepthPercent", "holeRadiusPercent", "headWidthPercent", "headLengthPercent", "shaftWidthPercent", "tailAngleDeg", "tailLengthPercent", "tailWidthPercent", "lobeRadiusPercent", "cleftDepthPercent", "boltSegments", "boltJaggednessPercent", "boltWidthPercent", "cloudBumps", "cloudPuffinessPercent", "slantPercent", "topWidthPercent", "capHeightPercent", "waveAmplitudePercent", "symbolId", "symbolOverrides", "variantKey", "instancePresentation", "scaleContentToViewport", "groupData", "mediaKind", "mediaMimeType", "naturalDuration", "begin", "trimStart", "trimEnd", "volume", "muted", "loop", "playbackRate", "mediaOpacity", "fadeInDuration", "fadeOutDuration", "posterHref", "sourceRect", "hrefXlink", "linkTarget", "linkRel", "linkDownload", "linkPing", "linkHreflang", "linkType", "linkReferrerPolicy", "targetShapeId", "offsetX", "offsetY", "targetWidth", "targetHeight", "broken", "switchSystemLanguage", "switchRequiredExtensions", "svgX", "svgY", "svgWidth", "svgHeight", "svgViewBoxX", "svgViewBoxY", "svgViewBoxWidth", "svgViewBoxHeight", "svgPreserveAspectRatio", "viewBoxX", "viewBoxY", "viewBoxWidth", "viewBoxHeight", "viewName", "viewPreserveAspectRatio", "viewZoomAndPan", "viewTarget", "isHomeView", "children", "viewLinkedSvgId"];
 type SerializedStateKeyListEntry = (typeof SERIALIZED_SHAPE_STATE_KEYS)[number];
 type SerializedStateKey = Exclude<keyof SerializedShapeState, 'extra'>;
 type StateKeyGate<T extends never> = T;
@@ -4034,7 +4144,11 @@ declare class SceneNode<P = Record<string, unknown>> {
      * see the animated world, while `_props` always holds base values.
      */
     private _overlay;
-    /** Per-property Lamport timestamps for CRDT conflict resolution. */
+    /**
+     * Optional ephemeral stamps for low-level consumers.
+     * SVGSketch collaboration arbitration is owned by the persisted
+     * `CollaborationSnapshot.collaborationState`, not this node-local map.
+     */
     private _propTimestamps;
     /**
      * Raw constructor — stores `initialProps` exactly as given (no schema
@@ -4055,6 +4169,8 @@ declare class SceneNode<P = Record<string, unknown>> {
     getBaseProp<T = unknown>(key: string): T;
     /** Untyped property write — for use when the node's type parameter is unknown. */
     setProp(key: string, value: unknown): void;
+    /** Remove an untyped property while preserving write/dirty notifications. */
+    deleteProp(key: string): void;
     setMany(props: Partial<P>): void;
     /**
      * Write an animated overlay value for a prop. Purely ephemeral: no
@@ -4090,13 +4206,15 @@ declare class SceneNode<P = Record<string, unknown>> {
     /** Get timestamps for specific keys (for inclusion in outgoing ops). */
     getPropStampsForKeys(keys: string[]): Record<string, number>;
     /**
-     * CRDT conflict resolution: set a property only if the remote
-     * timestamp wins over the local one.
+     * Low-level helper that sets a property only if a supplied timestamp
+     * wins over this node's optional ephemeral stamp.
      *
      * Comparison: higher timestamp wins. Equal timestamps: higher
      * clientId wins (deterministic tie-breaking).
      *
      * @returns true if the remote value was accepted, false if rejected.
+     * @deprecated Replica arbitration belongs in `applyOpToSnapshot` so it
+     * survives serialization and is identical on every replica.
      */
     setPropIfWins(key: string, value: unknown, remoteTs: number, remoteClientId: string): boolean;
     /** Snapshot all property timestamps (for undo capture). */
@@ -4365,8 +4483,8 @@ declare class SceneGraph {
     dispose(): void;
     /**
      * Inject a property-change notification for keys written WITHOUT
-     * firing `onChange` (CRDT `setPropIfWins` writes silently so remote
-     * apply can filter per-key). Batch-aware: defers during an open
+     * firing `onChange` (for example, low-level bulk import code).
+     * Batch-aware: defers during an open
      * batch, fires listeners immediately otherwise — either way the
      * change flows through the same listener pipeline as local writes.
      */
@@ -4525,6 +4643,46 @@ declare function flattenShapeStateTree(shape: SerializedShape): SerializedShape;
  */
 declare function flattenStateExtra(state: Record<string, unknown>): Record<string, unknown>;
 
+/**
+ * Runtime validation for the collaboration operation protocol.
+ *
+ * `Operation` is the compile-time authority and this module is its runtime
+ * boundary companion. The validator map is compile-gated against every
+ * discriminant in the union, so adding an operation without defining its
+ * wire requirements is a type error.
+ */
+
+interface OperationValidationIssue {
+    path: string;
+    message: string;
+}
+type OperationValidationResult<T> = {
+    valid: true;
+    value: T;
+} | {
+    valid: false;
+    issues: OperationValidationIssue[];
+};
+declare function validateOperation(value: unknown, path?: string): OperationValidationResult<Operation>;
+declare function validateDocumentOperations(value: unknown, options?: {
+    minItems?: number;
+    maxItems?: number;
+}): OperationValidationResult<Operation[]>;
+declare function validatePresenceOperation(value: unknown): OperationValidationResult<Extract<Operation, {
+    type: `presence:${string}`;
+}>>;
+declare function formatOperationValidationIssues(issues: readonly OperationValidationIssue[]): string;
+
+type SceneTreeEntry$1 = NonNullable<HistorySnapshot['sceneTree']>[number];
+/**
+ * Resolve the canonical order of one scene-tree sibling set.
+ *
+ * All-unkeyed parents use integer indexes. Once any sibling carries a
+ * fractional key, unkeyed siblings receive deterministic effective keys and
+ * the stable `(orderKey, id)` order becomes authoritative.
+ */
+declare function orderSiblings(siblings: SceneTreeEntry$1[]): SceneTreeEntry$1[];
+
 /**
  * Pure reducer applying collab `Operation`s to a `HistorySnapshot`.
  *
@@ -4548,22 +4706,13 @@ declare function flattenStateExtra(state: Record<string, unknown>): Record<strin
  * persisted blob was stale.
  *
  * `applyOpToSnapshot` mutates the passed snapshot in place (same
- * contract as the original private method in `DocumentRoom`). Return
- * type is `void` so callers don't rely on a fresh object reference.
+ * contract as the original private method in `DocumentRoom`) and returns
+ * the accepted operation, or `null` when its collaboration clock lost.
+ * Clock filtering therefore happens at the same commit point as the
+ * authored-state mutation and can be shared by server and live clients.
  */
 
 type SceneTreeEntry = NonNullable<HistorySnapshot['sceneTree']>[number];
-/**
- * Sibling order for one parent. All-unkeyed parents keep integer-index
- * order (v2 behavior, byte-identical). Once ANY sibling carries a
- * fractional `orderKey`, the parent switches to effective-(key, id)
- * ordering: unkeyed siblings are assigned deterministic canonical-append
- * keys by their current index position (a placement FREEZES real keys
- * onto its siblings first — see freezeSiblingOrderKeys — so this
- * position-derived fallback only covers entries later re-unkeyed by a v2
- * `scene:move`).
- */
-declare function orderSiblings(siblings: SceneTreeEntry[]): SceneTreeEntry[];
 /**
  * Materialize fractional keys onto every unkeyed sibling of `parentId`,
  * preserving the current visual order (runs of unkeyed entries get
@@ -4618,9 +4767,8 @@ declare function removeTrackKeyframe(track: SerializedAnimationTrack, keyframeId
  *   serializer writes them too;
  * - a shape the scene tree never mentions, or one the walk cannot reach,
  *   keeps its current inline placement, appended after the placed
- *   siblings. That is how a container that arrived whole through
- *   `shape:add` (one scene entry, descendants carried inline) keeps its
- *   subtree;
+ *   siblings. This preserves incomplete snapshots from older or drifted
+ *   writers without letting them override placements the tree does carry;
  * - the walk does not descend past a shape whose type is not a known
  *   container, so its scene descendants fall to that keep-what-you-have
  *   rule. A replica running older code than the client that authored the
@@ -4661,20 +4809,88 @@ declare function projectSceneTreeOntoShapes(snapshot: HistorySnapshot): void;
  * from, and its stored lists are the only membership record it has.
  */
 declare function projectSceneTreeOntoClipMaskGroups(snapshot: HistorySnapshot): void;
-/**
- * Depth-first lookup of a serialized shape by id, descending container
- * `state.children` trees. Exported for the DocumentRoom's text-splice
- * rebase slot, which needs the shape's CURRENT authoritative `state.text`
- * before the reducer folds an incoming op in.
- */
 declare function findShapeById(shapes: SerializedShape[], id: string): SerializedShape | null;
-declare function applyOpToSnapshot(snapshot: HistorySnapshot, op: Operation): void;
 /**
- * Fold `ops` into a deep clone of `snapshot` and return it — the
- * receiving-side contract of the editor's collab manager (the original
- * is never mutated). Semantically `ops.reduce(applyOpToSnapshot, clone)`.
- */
-declare function applyOpsToSnapshot(snapshot: HistorySnapshot, ops: readonly Operation[]): HistorySnapshot;
+ * THE CORRECTION A SENDER IS OWED.
+ *
+ * A client applies its own operation locally before sending it, then gets
+ * an acknowledgement. The ack says the batch was processed; the client
+ * reads it as "this is server state now" and drops the ops from the buffer
+ * that exists to replay them. Those claims coincide only when the server's
+ * projection of an operation matches what the sender applied — and it does
+ * not always, because the sender's baseline can be missing a concurrent
+ * edit the server already reduced.
+ *
+ * Most disagreements are self-healing: the operation that beat the sender
+ * was itself accepted, so it is broadcast to the sender and the sender
+ * adopts it. Deterministic rejections (a malformed order key, an unknown
+ * op type, an absent target) heal too, because the sender's own copy of
+ * this reducer reaches the same verdict. `replica-convergence.test.ts`
+ * holds both classes down with running replicas.
+ *
+ * What does NOT heal is a projection the sender cannot derive:
+ *
+ *   - a `shape:update` whose per-property clock lost, in whole or in part.
+ *     The sender keeps the value it wrote for every property that lost.
+ *   - a `text:format` whose clock the reducer PROMOTED past everything it
+ *     merged. Peers receive the promoted stamp; the sender is excluded
+ *     from its own broadcast, so it keeps the stamp it sent — and because
+ *     the run list is append-ordered, applying the two formats in the
+ *     opposite order leaves it holding a differently-ordered list.
+ *
+ * For those, the server states the answer: a `shape:update` carrying the
+ * authoritative VALUE and the authoritative CLOCK for the affected keys.
+ * Clocked, so it cannot clobber a newer edit the sender made in the
+ * meantime, and idempotent, so it costs nothing if the broadcast that
+ * would have healed it arrives first.
+ *
+ * Grouped by the clock's `clientId`, because one operation carries one
+ * `clientId` for all of its `propTimestamps` — two keys last written by
+ * different clients need two corrections to reproduce both stamps
+ * exactly, and an inexact stamp is a future arbitration decided
+ * differently on the two replicas.
+ */
+declare function senderCorrectionsForOp(snapshot: CollaborationSnapshot, sent: Operation, accepted: Operation | null): Operation[];
+/**
+ * Reduce one operation onto `snapshot`, MUTATING it, and return the
+ * projected operation or `null`.
+ *
+ * A single-op batch: the batch context is created and settled around this
+ * one call, so the inline projection runs exactly once, as it always did.
+ * A caller folding several operations should reach for `applyOpsInPlace`
+ * instead — that shares one index and one projection across the batch.
+ */
+declare function applyOpToSnapshot(snapshot: HistorySnapshot, incomingOp: Operation): Operation | null;
+/**
+ * Fold `ops` into `snapshot`, MUTATING it, and return what was accepted.
+ *
+ * The in-place form. One `ReduceContext` spans the batch, so the shape
+ * index is built once and the inline projection is re-derived once at the
+ * end rather than once per operation.
+ *
+ * Callers that need the input left intact — because something after the
+ * reduce can throw and the snapshot has to survive it — want
+ * `applyOpsToSnapshotWithAccepted`, which clones first. That clone is the
+ * single most expensive thing in the reduce path (measured at ~99% of a
+ * one-op batch on a 5,000-shape document), so it is charged only to the
+ * callers that actually need the rollback.
+ */
+declare function applyOpsInPlace(snapshot: CollaborationSnapshot, ops: readonly Operation[]): Operation[];
+/**
+ * Fold `ops` into a deep CLONE of `snapshot` and return it — the original
+ * is never mutated.
+ *
+ * The clone is not defensive housekeeping, it is the caller's rollback:
+ * `CollabManager.handleRemoteOpsFlush` reduces, hands the result to the
+ * canvas projector, and only then adopts it as the new baseline. If the
+ * projection throws, the baseline has to be exactly what it was. Removing
+ * the clone would turn that into a half-applied batch.
+ */
+declare function applyOpsToSnapshotWithAccepted(snapshot: HistorySnapshot, ops: readonly Operation[]): {
+    snapshot: CollaborationSnapshot;
+    acceptedOps: Operation[];
+};
+declare function applyOpsToSnapshot(snapshot: HistorySnapshot, ops: readonly Operation[]): CollaborationSnapshot;
 /**
  * Materialize fractional keys onto every unkeyed sceneTree entry,
  * preserving the current order (per-parent freeze). Runs once at room
@@ -4743,6 +4959,104 @@ declare function downTranslateTextFormatOps(ops: Operation[], shapes: Serialized
  * unchanged (same reference) when nothing needs translation.
  */
 declare function downTranslateCollectionMoveOps(ops: Operation[], collections: Pick<HistorySnapshot, 'guides' | 'measurements'>): Operation[];
+/**
+ * The current op-vocabulary version — ONE declaration, shared by both
+ * ends of the wire.
+ *
+ * The editor's `COLLAB_PROTOCOL_VERSION` and the DocumentRoom's
+ * `CURRENT_PROTOCOL_VERSION` used to be independent literals, each with
+ * its own copy of the version history, kept in step by a source-text
+ * regex in a worker test. The justification was that the worker cannot
+ * import the editor, which is true and beside the point: both already
+ * depend on this package, which owns the `Operation` union and the
+ * per-version down-translators the number selects between. It belongs
+ * here, next to the vocabulary it versions.
+ *
+ * The prose had already drifted where the digits had not — the worker's
+ * copy stopped describing at v5 and never mentioned v6.
+ *
+ * Bump when the vocabulary gains op types older clients cannot apply,
+ * and add the matching down-translation guard in the DocumentRoom.
+ */
+declare const COLLAB_PROTOCOL_VERSION = 6;
+/**
+ * Drop the protocol-v6 document-field ops for pv<6 sessions.
+ *
+ * Unlike the other down-translators there is nothing to translate INTO: a
+ * pre-v6 client has no representation for these facts at all, so the
+ * honest degradation is for it to keep what it has and pick the field up
+ * on its next full snapshot. Dropping is inert; the alternative - letting
+ * an unknown op reach an old client - is also inert (both the reducer's
+ * switch and the editor's live handler ignore unknown types), so this
+ * exists to make the boundary explicit rather than incidental, and to
+ * keep the broadcast payload for old sessions free of ops they cannot
+ * act on.
+ *
+ * Pure; returns `ops` unchanged (same reference) when nothing needs
+ * translation - callers rely on that to skip re-serialization.
+ */
+declare function downTranslateDocumentFieldOps(ops: Operation[]): Operation[];
+
+/**
+ * Persisted collaboration-clock state and arbitration.
+ *
+ * Authored document values remain in `HistorySnapshot`.
+ * This module owns the operational sidecar that makes LWW decisions survive
+ * client refreshes, Durable Object hibernation, and D1 rehydration.
+ * The reducer calls it before mutating authored state and returns the exact
+ * accepted payload for live projection.
+ */
+
+/**
+ * Stable identity used by every granular document-resource LWW decision.
+ * Returning `null` means the operation is unclocked, a composable delta,
+ * or a compatibility whole-value op whose arrival-order behavior remains
+ * unchanged.
+ */
+declare function collaborationResourceKey(op: Operation): string | null;
+/** Highest persisted collaboration timestamp in a snapshot. */
+declare function maxCollaborationTimestamp(snapshot: CollaborationSnapshot): number;
+/**
+ * Give a server-rebased whole-value shape update a clock newer than every
+ * value it merged.
+ * The operation is mutated intentionally so persistence and broadcast use
+ * the same promoted payload that the reducer accepts.
+ */
+declare function promoteRebasedShapeUpdateClock(snapshot: CollaborationSnapshot, op: Extract<Operation, {
+    type: 'shape:update';
+}>): void;
+
+/**
+ * Keyed resource upsert / remove — the primitive under every granular
+ * `*:upsert` / `*:remove` collab op.
+ *
+ * Most document collections identify their members by `id`, so
+ * `upsertResourceById` / `removeResourceById` are the common entry points.
+ * Template variables identify by `name` instead (the name IS the CSS
+ * custom property and the `{{placeholder}}` token, so it cannot also carry
+ * a synthetic id without two identities for one thing), which is why the
+ * key is a parameter of the underlying implementation rather than a
+ * hard-coded `'id'`.
+ *
+ * Deliberately duplicated from `@svgsketch/shared`: core has zero
+ * dependencies, and the shared package keeps its own copy for consumers
+ * that don't pull core. The two copies are held byte-identical below the
+ * header comment by `packages/core/tests/model/resource-delta-parity.test.ts`
+ * — a semantic change to one fails that gate until it lands in both.
+ */
+type ResourceKey = 'id' | 'name';
+interface IndexedResource {
+    id?: unknown;
+}
+interface NamedResource {
+    name?: unknown;
+}
+declare function upsertResourceByKey<T extends IndexedResource | NamedResource>(items: readonly T[] | undefined, item: T, key: ResourceKey, index?: number): T[];
+declare function removeResourceByKey<T extends IndexedResource | NamedResource>(items: readonly T[] | undefined, key: ResourceKey, identity: string): T[];
+declare function upsertResourceById<T extends IndexedResource>(items: readonly T[] | undefined, item: T, index?: number): T[];
+declare function removeResourceById<T extends IndexedResource>(items: readonly T[] | undefined, id: string): T[];
+declare function upsertResourceByName<T extends NamedResource>(items: readonly T[] | undefined, item: T, index?: number): T[];
+declare function removeResourceByName<T extends NamedResource>(items: readonly T[] | undefined, name: string): T[];
 
 /**
  * @svgsketch/core — Schema migrations.
@@ -4846,6 +5160,47 @@ declare function patternTileSize(pattern: Omit<PatternFill, 'id' | 'sourceId' |
  */
 declare function patternLibraryDefToCustomPatternDef(def: PatternLibraryDef): CustomPatternDef | null;
 
+/**
+ * What kind of string a payload slot holds.
+ *
+ * - `href` — the WHOLE value is a URI (a `data:` URI or an already
+ *   externalized asset URL). The rewriter decides whether to touch it.
+ * - `svgMarkup` — SVG source that may EMBED URIs in `href` / `xlink:href`
+ *   attributes. The rewriter is handed the whole markup string and returns
+ *   the rewritten markup.
+ */
+type EmbeddedPayloadSlotKind = 'href' | 'svgMarkup';
+/**
+ * Rewrites one slot's value. Returning the input unchanged is how a
+ * rewriter declines a slot (too small to externalize, not an asset URL,
+ * upload failed), so callers need no separate predicate hook.
+ */
+type EmbeddedPayloadRewriter = (value: string, kind: EmbeddedPayloadSlotKind) => Promise<string>;
+/**
+ * Rewrite every payload slot in ONE serialized shape state, recursing into
+ * inline `state.children`.
+ *
+ * Exported because the collab op paths rewrite a bare state object rather
+ * than a document: `shape:add` carries `shape.state` and `shape:update`
+ * carries a partial `state`, and both must cover the same slots as a save
+ * or a peer receives a payload the document channel would have externalized.
+ */
+declare function rewriteShapeStateEmbeddedPayloads(state: unknown, rewrite: EmbeddedPayloadRewriter): Promise<void>;
+/**
+ * Rewrite every payload slot in a whole serialized document, in place.
+ *
+ * Channels, in the order they are visited:
+ *   1. `shapes[].state` — hrefs and paint-server markup, recursively
+ *      through inline `state.children`;
+ *   2. `library[kind: 'pattern'].pattern.svgContent` — where user pattern
+ *      tiles live since they consolidated onto `LibraryRegistry`;
+ *   3. `customPatterns[].svgContent` — the deprecated v1 tile channel.
+ *      `DocumentSerializer` no longer writes it, but the v1→v2 migration
+ *      still reads it, so a document written before the consolidation
+ *      round-trips.
+ */
+declare function rewriteDocumentEmbeddedPayloads(document: unknown, rewrite: EmbeddedPayloadRewriter): Promise<void>;
+
 /**
  * @svgsketch/core — Document validation.
  *
@@ -8421,4 +8776,4 @@ declare function lintWordSearchOptions(options: WordSearchOptions): WordSearchLi
 declare function generateWordSearch(options: WordSearchOptions): GeneratedWordSearch;
 declare function createWordSearchPrimitiveMask(width: number, height: number, primitive: WordSearchPrimitiveMask): boolean[][];
 
-export { type Affine2D, type AffineTransformMatrix, type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationOperation, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcCenterParameterization, type ArcParams, type AriaRole, Arrow, type ArrowNodeProps, Audio, BUILTIN_MARKER_ID_MAP, type BaseFilter, type BaseFilterPrimitive, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, COMMON_PROP_DEFAULTS, COMMON_TRANSFORM_NODE_DEFAULTS, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, type ClipMaskOperation, Cloud, type CloudNodeProps, type CodeFormat, type CodegenOptions, type CollabClock, type CommonNodeProps, type CommonTransformNodeProps, type ConnectionDirection, type ConnectionDirectionValue, type ConnectionPoint, type ConnectionPointValue, type ConnectorEndpointRefValue, type ConnectorRoutingModeValue, Container, ContainerShapeBuilder, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, type CylinderNodeProps, DEFAULT_COORDINATE_PRECISION, DEFAULT_RICH_TEXT_STYLE, type DiamondNodeProps, type DiffuseLightingFilter, DocumentBuilder as Document, DocumentBuilder, type DocumentBuilderOptions, type DocumentMetadata, type DocumentNodeProps, type DocumentBuilderOptions as DocumentOptions, type DocumentResourceOperation, type DocumentScript, type DocumentShapeNodeProps, type DocumentStyle, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EasingType, Ellipse, type EllipseNodeProps, type EmbossFilter, type Extent1D, type ExtractedVariables, type FeBlendPrimitive, type FeColorMatrixPrimitive, type FeComponentTransferPrimitive, type FeCompositePrimitive, type FeConvolveMatrixPrimitive, type FeDiffuseLightingPrimitive, type FeDisplacementMapPrimitive, type FeDropShadowPrimitive, type FeFloodPrimitive, type FeGaussianBlurPrimitive, type FeImagePrimitive, type FeMergePrimitive, type FeMorphologyPrimitive, type FeOffsetPrimitive, type FeSpecularLightingPrimitive, type FeTilePrimitive, type FeTurbulencePrimitive, type FillType, type FilmGrainFilter, type FilterBlendMode, type FilterLibraryDef, type FilterLightSource, type FilterPrimitive, type FilterPrimitiveType, type FilterType, type FlowchartBoxNodeProps, type FlowchartBoxParams, type FlowchartBoxType, type FontVariantCssInput, type FusableTrack, type GaussianBlurFilter, Gear, type GearNodeProps, type GenerateSudokuOptions, type GeneratedSudokuPuzzle, type GeneratedWordSearch, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GradientUnits, type GraphChangeListener, type GrayscaleFilter, type GroupNodeProps, type GroupPresentationData, type Guide, type GuideDeltaOperation, Heart, type HeartNodeProps, type HistorySnapshot, type HueRotateFilter, Hyperlink, type HyperlinkNodeProps, IDENTITY_AFFINE, type ImageAttribution, type ImageNodeProps, ImageShape, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, type JsonObject, type JsonPrimitive, type JsonValue, KNOWN_STATE_KEYS, type KeyedSerializedAnimationKeyframe, LIBRARY_EMIT_ORDER, type LibraryDef, type LibraryDefBase, type LibraryDefOfKind, type LibraryIndex, type LibraryKind, type LibrarySource, type LicenseType, type LightSource, Lightning, type LightningNodeProps, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinearGradientLibraryDef, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MAX_COORDINATE_PRECISION, MIGRATIONS, type MarkerDescriptor, type MarkerLibraryDef, type MarkerReferenceSets, type MatrixDecomposition2D, type Measurement, type MeasurementDeltaOperation, type MediaNodeProps, type MetadataDeltaOperation, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, NON_WIRE_PROP_KEYS, NUMERIC_SHAPE_TRANSFORM_STATE_KEYS, NestedSvg, type NodeChangeListener, type NodeFactoryMode, NodeSchemaRegistry, type NodeTypePropsMap, type NodeTypeSchema, type NoiseFilter, type OpMetadataPatch, type OpShapeState, type OpacityFilter, type Operation, type OutlineFilter, type OutlinePosition, PUZZLE_DEFAULTS, type ParallelogramNodeProps, type ParseOptions, Path, type PathBoundsRect, PathCurveType, type PathNodeProps, type PathPoint, PathPointType, PatternBuilder, type PatternElement, type PatternFill, type PatternLibraryDef, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type PreviousPlacement, type PropDef, type PropStamp, type PuzzleBounds, type PuzzleOptions, type PuzzlePiece, type PuzzleStyle, type PuzzleTabPattern, RICH_TEXT_STYLE_KEYS, type RadialGradient, RadialGradientBuilder, type RadialGradientLibraryDef, type RawSvgFilter, Rectangle, type RectangleNodeProps, type RejectedWordSearchWord, type RenderOptions, type RichTextData, type RichTextDecoration, type RichTextFormatRange, type RichTextLine, type RichTextLineSpan, type RichTextResolvedData, type RichTextResolvedLine, type RichTextResolvedSegment, type RichTextResolvedStyle, type RichTextRun, type RichTextRuns, type RichTextSegment, type RichTextSegmentStyle, type RichTextSegmentsInput, type RichTextStyleDelta, type RichTextTspanAttribute, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, SERIALIZED_SHAPE_STATE_KEYS, SHAPE_TRANSFORM_STATE_KEYS, type SaturateFilter, SceneGraph, SceneNode, type SegmentCurveType, type SepiaFilter, type SerializedAnimationKeyframe, type SerializedAnimationTimeline, type SerializedAnimationTrack, type SerializedClipMaskGroup, type SerializedColorGlyph, type SerializedColorGlyphLibrary, type SerializedExportItem, type SerializedGroup, type SerializedMarkerDef, type SerializedPaintServerDef, type SerializedSceneNodePlacement, type SerializedShape, type SerializedShapeState, type SerializedShapeStateKeyGates, type SerializedShapeTransformState, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, ShapeReference, type ShapeReferenceNodeProps, type ShapeTransformState, type SharpenFilter, type SmilCalcMode, type SmilKeyframeAttributes, type SmilKeyframeData, type SmilTimingTrack, type SmilValue, type SolveSudokuOptions, type SpecularLightingFilter, SpeechBubble, type SpeechBubbleNodeProps, Spiral, type SpiralNodeProps, type SplinePointInput, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StepPosition, type StepsParams, type StringifyOptions, type StrokeType, type StructureChangeListener, type SudokuDifficulty, type SudokuGrid, type SudokuRating, type SudokuValidationResult, type SvgNodeProps, type SvgPrimitiveChainFilter, Switch, type SwitchNodeProps, type SymbolInstanceNodeProps, type SymbolLibraryDef, type TemplateVariable, type TemplateVariableMode, type TemplateVariableSource, type TemplateVariableType, type TerminatorNodeProps, Text, type TextFormatOperation, type TextNodeProps, type TextSplice, Timeline, Track, type TransferFunc, type TransformFusionPlan, type TransformStateLike, type TrapezoidNodeProps, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, Video, View, type ViewNodeProps, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type WireAliasShapeStateFields, type WireOnlyShapeStateFields, type WordSearchAxes, type WordSearchCellPath, type WordSearchDirection, type WordSearchLintResult, type WordSearchOptions, type WordSearchPlacement, type WordSearchPrimitiveMask, type XrayFilter, affine, affineFromArray, affineToArray, almostEqualAffine, applyAffineToPoint, applyAffineToVector, applyOpToSnapshot, applyOpsToSnapshot, applyRichTextFormat, applyTextSplice, applyTextTransform, arcEndpointToCenter, areTracksTimingEquivalent, around, buildCompoundTransformValues, buildSmilKeyframeData, canonicalPolygonTransformString, canonicalTransformString, collectMarkerReferences, collectReferencedLibraryDefs, collectReferencedMarkerIds, compareOrderKeys, composeLegacyTransformMatrix, computeArrowVertices, computeCloudPath, computeCrossVertices, computeDashArray, computeFlowchartBoxPath, computeGearPath, computeGearVertices, computeHeartPath, computeLightningVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpeechBubbleVertices, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createSceneNode, createShape, createViewbox, createWordSearchPrimitiveMask, cubicBezierExtent1D, customPatternDefToLibraryDef, declaredRichTextDeltaKeys, decomposeAffine2D, defaultVariableMode, deriveRichTextFormatRanges, deriveSegments, deriveTextSplice, downTranslateAnimationKeyframeOps, downTranslateCollectionMoveOps, downTranslateScenePlaceOps, downTranslateTextFormatOps, ellipticalArcBounds, escXml, extractVariables, filterAttr, findShapeById, flattenShapeStateTree, flattenStateExtra, foldLegacyAncestorTransformIntoMatrix, forEachLibraryRefInState, forEachMarkerRefInState, forEachReachableShape, forEachShapeInLibraryDefs, formatSmilKeySpline, formatSmilKeyTime, freezeSiblingOrderKeys, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generatePuzzlePieces, generateReactCode, generateSudokuPuzzle, generateSvgCode, generateVueCode, generateWordSearch, getBuiltInMarkerDefs, getEasingCubicBezier, getEffectivePrecision, getKeyframeCubicBezier, getMarkerDescriptors, getPatternElements, getSmilAdditive, getSmilBeginValue, getSmilFillMode, getSmilMotionKeyPoints, getSmilRepeatCount, getSmilSetBeginValue, getSmilTrackDuration, getWordSearchDirections, initialOrderKeys, invertAffine, isDefaultKeyPoints, isDefaultKeyTimes, isFiniteAffineArray, isIdentityAffine, isIdentityLinearSplines, isIndefiniteSetTrack, isReusablePatternTile, isSetSequenceTrack, isValidOrderKey, keyBetween, keysBetween, legacyEndpointMarkerId, linearGradient, lintWordSearchOptions, materializeSceneTreeOrderKeys, matrixTransformPart, mergeRichTextStyle, migrateSnapshot, moveResourceById, multiplyAffine, nodeSchemas, normalizeRichTextRuns, normalizeRichTextStyle, normalizeRichTextStyleDelta, orderSiblings, parseDocument, parseSvgTransformList, parseVariableArgs, parseWordSearchWords, partitionShapeStateTree, partitionStateExtra, pathDataBounds, pattern, patternLibraryDefToCustomPatternDef, patternTileSize, planTransformFusion, projectSceneTreeOntoClipMaskGroups, projectSceneTreeOntoShapes, quadraticBezierExtent1D, radialGradient, rebaseRichTextFormatRanges, rebaseRichTextRuns, reflectCubicBezier, removeTrackKeyframe, renderAnimationElements, renderBuiltinMarkerDefs, renderCircle, renderEllipse, renderFilterDefs, renderFilterLibraryDef, renderFilterPrimitive, renderFilterPrimitivesForType, renderFlowchartBox, renderImage, renderLibraryDef, renderLibraryDefs, renderLine, renderLinearGradientLibraryDef, renderMarkerLibraryDef, renderPatternLibraryDef, renderPolygonShape, renderPolyline, renderRadialGradientLibraryDef, renderRectangle, renderReferencedLibraryDefs, renderShape, renderSpline, renderSvgPrimitiveChainFilter, renderSymbolInstance, renderSymbolLibraryDef, renderText, renderToSvg, resolveRichTextStyleAt, resolveSymbolInstanceShapes, richTextFontVariantCss, richTextLineSpans, richTextRunsFromState, richTextStyleDelta, richTextStyleDeltasEqual, richTextStylesEqual, richTextTspanAttributes, rotateAffine, roundCoord, roundNumberString, roundSerializedShape, roundSnapshot, runsFromSegments, sanitizeRichTextFormatRanges, scaleAffine, skewXAffine, skewYAffine, smilKeyframeAttributes, solveCubicBezier, solveSudoku, splinePathBounds, stringifyDocument, substituteString, substituteVariables, symbolInstanceTargetId, transformSplice, translateAffine, tryParseSvgTransformList, upsertTrackKeyframe, validateSnapshot, validateSudokuPuzzle, verticesToPath };
+export { type Affine2D, type AffineTransformMatrix, type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationOperation, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcCenterParameterization, type ArcParams, type AriaRole, Arrow, type ArrowNodeProps, Audio, BUILTIN_MARKER_ID_MAP, type BaseFilter, type BaseFilterPrimitive, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, COLLAB_PROTOCOL_VERSION, COMMON_PROP_DEFAULTS, COMMON_TRANSFORM_NODE_DEFAULTS, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, type ClipMaskOperation, Cloud, type CloudNodeProps, type CodeFormat, type CodegenOptions, type CollabClock, type CollaborationSnapshot, type CollaborationStamp, type CollaborationState, type CommonNodeProps, type CommonTransformNodeProps, type ConnectionDirection, type ConnectionDirectionValue, type ConnectionPoint, type ConnectionPointValue, type ConnectorEndpointRefValue, type ConnectorRoutingModeValue, Container, ContainerShapeBuilder, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, type CylinderNodeProps, DEFAULT_COORDINATE_PRECISION, DEFAULT_RICH_TEXT_STYLE, type DiamondNodeProps, type DiffuseLightingFilter, DocumentBuilder as Document, DocumentBuilder, type DocumentBuilderOptions, type DocumentMetadata, type DocumentNodeProps, type DocumentBuilderOptions as DocumentOptions, type DocumentResourceOperation, type DocumentScript, type DocumentShapeNodeProps, type DocumentStyle, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EasingType, Ellipse, type EllipseNodeProps, type EmbeddedPayloadRewriter, type EmbeddedPayloadSlotKind, type EmbossFilter, type ExportItemOperation, type Extent1D, type ExtractedVariables, type FeBlendPrimitive, type FeColorMatrixPrimitive, type FeComponentTransferPrimitive, type FeCompositePrimitive, type FeConvolveMatrixPrimitive, type FeDiffuseLightingPrimitive, type FeDisplacementMapPrimitive, type FeDropShadowPrimitive, type FeFloodPrimitive, type FeGaussianBlurPrimitive, type FeImagePrimitive, type FeMergePrimitive, type FeMorphologyPrimitive, type FeOffsetPrimitive, type FeSpecularLightingPrimitive, type FeTilePrimitive, type FeTurbulencePrimitive, type FillType, type FilmGrainFilter, type FilterBlendMode, type FilterLibraryDef, type FilterLightSource, type FilterPrimitive, type FilterPrimitiveType, type FilterType, type FlowchartBoxNodeProps, type FlowchartBoxParams, type FlowchartBoxType, type FontVariantCssInput, type FusableTrack, type GaussianBlurFilter, Gear, type GearNodeProps, type GenerateSudokuOptions, type GeneratedSudokuPuzzle, type GeneratedWordSearch, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GradientUnits, type GraphChangeListener, type GrayscaleFilter, type GroupNodeProps, type GroupPresentationData, type Guide, type GuideDeltaOperation, Heart, type HeartNodeProps, type HistorySnapshot, type HueRotateFilter, Hyperlink, type HyperlinkNodeProps, IDENTITY_AFFINE, type ImageAttribution, type ImageNodeProps, ImageShape, type IndexedResource, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, type JsonObject, type JsonPrimitive, type JsonValue, KNOWN_STATE_KEYS, type KeyedSerializedAnimationKeyframe, LIBRARY_EMIT_ORDER, type LibraryDef, type LibraryDefBase, type LibraryDefOfKind, type LibraryIndex, type LibraryKind, type LibrarySource, type LicenseType, type LightSource, Lightning, type LightningNodeProps, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinearGradientLibraryDef, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MAX_COORDINATE_PRECISION, MIGRATIONS, type MarkerDescriptor, type MarkerLibraryDef, type MarkerReferenceSets, type MatrixDecomposition2D, type Measurement, type MeasurementDeltaOperation, type MediaNodeProps, type MetadataDeltaOperation, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, NON_WIRE_PROP_KEYS, NUMERIC_SHAPE_TRANSFORM_STATE_KEYS, type NamedResource, NestedSvg, type NodeChangeListener, type NodeFactoryMode, NodeSchemaRegistry, type NodeTypePropsMap, type NodeTypeSchema, type NoiseFilter, type OpMetadataPatch, type OpShapeState, type OpacityFilter, type Operation, type OperationValidationIssue, type OperationValidationResult, type OutlineFilter, type OutlinePosition, PUZZLE_DEFAULTS, type ParallelogramNodeProps, type ParseOptions, Path, type PathBoundsRect, PathCurveType, type PathNodeProps, type PathPoint, PathPointType, PatternBuilder, type PatternElement, type PatternFill, type PatternLibraryDef, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type PreviousPlacement, type PropDef, type PropStamp, type PuzzleBounds, type PuzzleOptions, type PuzzlePiece, type PuzzleStyle, type PuzzleTabPattern, RICH_TEXT_STYLE_KEYS, type RadialGradient, RadialGradientBuilder, type RadialGradientLibraryDef, type RawSvgFilter, Rectangle, type RectangleNodeProps, type RejectedWordSearchWord, type RenderOptions, type ResourceKey, type RichTextData, type RichTextDecoration, type RichTextFormatRange, type RichTextLine, type RichTextLineSpan, type RichTextResolvedData, type RichTextResolvedLine, type RichTextResolvedSegment, type RichTextResolvedStyle, type RichTextRun, type RichTextRuns, type RichTextSegment, type RichTextSegmentStyle, type RichTextSegmentsInput, type RichTextStyleDelta, type RichTextTspanAttribute, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, SERIALIZED_SHAPE_STATE_KEYS, SHAPE_TRANSFORM_STATE_KEYS, type SaturateFilter, SceneGraph, SceneNode, type SegmentCurveType, type SepiaFilter, type SerializedAnimationKeyframe, type SerializedAnimationTimeline, type SerializedAnimationTrack, type SerializedClipMaskGroup, type SerializedColorGlyph, type SerializedColorGlyphLibrary, type SerializedExportItem, type SerializedGroup, type SerializedMarkerDef, type SerializedPaintServerDef, type SerializedSceneNodePlacement, type SerializedShape, type SerializedShapeState, type SerializedShapeStateKeyGates, type SerializedShapeTransformState, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, ShapeReference, type ShapeReferenceNodeProps, type ShapeTransformState, type SharpenFilter, type SmilCalcMode, type SmilKeyframeAttributes, type SmilKeyframeData, type SmilTimingTrack, type SmilValue, type SolveSudokuOptions, type SpecularLightingFilter, SpeechBubble, type SpeechBubbleNodeProps, Spiral, type SpiralNodeProps, type SplinePointInput, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StepPosition, type StepsParams, type StringifyOptions, type StrokeType, type StructureChangeListener, type SudokuDifficulty, type SudokuGrid, type SudokuRating, type SudokuValidationResult, type SvgNodeProps, type SvgPrimitiveChainFilter, Switch, type SwitchNodeProps, type SymbolInstanceNodeProps, type SymbolLibraryDef, type TemplateVariable, type TemplateVariableMode, type TemplateVariableOperation, type TemplateVariableSource, type TemplateVariableType, type TerminatorNodeProps, Text, type TextFormatOperation, type TextNodeProps, type TextSplice, Timeline, Track, type TransferFunc, type TransformFusionPlan, type TransformStateLike, type TrapezoidNodeProps, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, Video, View, type ViewNodeProps, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type WireAliasShapeStateFields, type WireOnlyShapeStateFields, type WordSearchAxes, type WordSearchCellPath, type WordSearchDirection, type WordSearchLintResult, type WordSearchOptions, type WordSearchPlacement, type WordSearchPrimitiveMask, type XrayFilter, affine, affineFromArray, affineToArray, almostEqualAffine, applyAffineToPoint, applyAffineToVector, applyOpToSnapshot, applyOpsInPlace, applyOpsToSnapshot, applyOpsToSnapshotWithAccepted, applyRichTextFormat, applyTextSplice, applyTextTransform, arcEndpointToCenter, areTracksTimingEquivalent, around, buildCompoundTransformValues, buildSmilKeyframeData, canonicalPolygonTransformString, canonicalTransformString, collaborationResourceKey, collectMarkerReferences, collectReferencedLibraryDefs, collectReferencedMarkerIds, compareOrderKeys, composeLegacyTransformMatrix, computeArrowVertices, computeCloudPath, computeCrossVertices, computeDashArray, computeFlowchartBoxPath, computeGearPath, computeGearVertices, computeHeartPath, computeLightningVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpeechBubbleVertices, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createSceneNode, createShape, createViewbox, createWordSearchPrimitiveMask, cubicBezierExtent1D, customPatternDefToLibraryDef, declaredRichTextDeltaKeys, decomposeAffine2D, defaultVariableMode, deriveRichTextFormatRanges, deriveSegments, deriveTextSplice, downTranslateAnimationKeyframeOps, downTranslateCollectionMoveOps, downTranslateDocumentFieldOps, downTranslateScenePlaceOps, downTranslateTextFormatOps, ellipticalArcBounds, escXml, extractVariables, filterAttr, findShapeById, flattenShapeStateTree, flattenStateExtra, foldLegacyAncestorTransformIntoMatrix, forEachLibraryRefInState, forEachMarkerRefInState, forEachReachableShape, forEachShapeInLibraryDefs, formatOperationValidationIssues, formatSmilKeySpline, formatSmilKeyTime, freezeSiblingOrderKeys, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generatePuzzlePieces, generateReactCode, generateSudokuPuzzle, generateSvgCode, generateVueCode, generateWordSearch, getBuiltInMarkerDefs, getEasingCubicBezier, getEffectivePrecision, getKeyframeCubicBezier, getMarkerDescriptors, getPatternElements, getSmilAdditive, getSmilBeginValue, getSmilFillMode, getSmilMotionKeyPoints, getSmilRepeatCount, getSmilSetBeginValue, getSmilTrackDuration, getWordSearchDirections, initialOrderKeys, invertAffine, isDefaultKeyPoints, isDefaultKeyTimes, isFiniteAffineArray, isIdentityAffine, isIdentityLinearSplines, isIndefiniteSetTrack, isReusablePatternTile, isSetSequenceTrack, isValidOrderKey, keyBetween, keysBetween, legacyEndpointMarkerId, linearGradient, lintWordSearchOptions, materializeSceneTreeOrderKeys, matrixTransformPart, maxCollaborationTimestamp, mergeRichTextStyle, migrateSnapshot, moveResourceById, multiplyAffine, nodeSchemas, normalizeRichTextRuns, normalizeRichTextStyle, normalizeRichTextStyleDelta, orderSiblings, parseDocument, parseSvgTransformList, parseVariableArgs, parseWordSearchWords, partitionShapeStateTree, partitionStateExtra, pathDataBounds, pattern, patternLibraryDefToCustomPatternDef, patternTileSize, planTransformFusion, projectSceneTreeOntoClipMaskGroups, projectSceneTreeOntoShapes, promoteRebasedShapeUpdateClock, quadraticBezierExtent1D, radialGradient, rebaseRichTextFormatRanges, rebaseRichTextRuns, reflectCubicBezier, removeResourceById, removeResourceByKey, removeResourceByName, removeTrackKeyframe, renderAnimationElements, renderBuiltinMarkerDefs, renderCircle, renderEllipse, renderFilterDefs, renderFilterLibraryDef, renderFilterPrimitive, renderFilterPrimitivesForType, renderFlowchartBox, renderImage, renderLibraryDef, renderLibraryDefs, renderLine, renderLinearGradientLibraryDef, renderMarkerLibraryDef, renderPatternLibraryDef, renderPolygonShape, renderPolyline, renderRadialGradientLibraryDef, renderRectangle, renderReferencedLibraryDefs, renderShape, renderSpline, renderSvgPrimitiveChainFilter, renderSymbolInstance, renderSymbolLibraryDef, renderText, renderToSvg, resolveRichTextStyleAt, resolveSymbolInstanceShapes, rewriteDocumentEmbeddedPayloads, rewriteShapeStateEmbeddedPayloads, richTextFontVariantCss, richTextLineSpans, richTextRunsFromState, richTextStyleDelta, richTextStyleDeltasEqual, richTextStylesEqual, richTextTspanAttributes, rotateAffine, roundCoord, roundNumberString, roundSerializedShape, roundSnapshot, runsFromSegments, sanitizeRichTextFormatRanges, scaleAffine, senderCorrectionsForOp, skewXAffine, skewYAffine, smilKeyframeAttributes, solveCubicBezier, solveSudoku, splinePathBounds, stringifyDocument, substituteString, substituteVariables, symbolInstanceTargetId, transformSplice, translateAffine, tryParseSvgTransformList, upsertResourceById, upsertResourceByKey, upsertResourceByName, upsertTrackKeyframe, validateDocumentOperations, validateOperation, validatePresenceOperation, validateSnapshot, validateSudokuPuzzle, verticesToPath };