@rasamjs/core 0.1.2 → 0.2.0

package/reports/svgjs-comparison.md

@@ -1,29 +1,29 @@
 # Rasam vs SVG.js
 
-SVG.js 3.2.8; Rasam 0.1.2 workspace. CPU: Intel(R) Core(TM) i7-10610U CPU @ 1.80GHz.
+SVG.js 3.2.8; Rasam 0.2.0 workspace. CPU: Intel(R) Core(TM) i7-10610U CPU @ 1.80GHz.
 
 All timings below are medians in milliseconds. Ratios above 1 mean Rasam took longer.
 
 | Browser | Workload | Nodes | Samples | Rasam | SVG.js | Rasam / SVG.js |
 | --- | --- | ---: | ---: | ---: | ---: | ---: |
-| chromium 156.0.8078.4 | creation | 2000 | 15 | 9.70 | 12.20 | 0.80 |
-| chromium 156.0.8078.4 | creation | 8000 | 15 | 36.50 | 45.10 | 0.81 |
-| chromium 156.0.8078.4 | fill | 1000 | 100 | 0.50 | 1.39 | 0.36 |
-| chromium 156.0.8078.4 | repeated-fill | 1000 | 100 | 0.71 | 4.23 | 0.17 |
-| chromium 156.0.8078.4 | pointer-one | 8000 | 40 | 4.00 | 3.82 | 1.05 |
-| chromium 156.0.8078.4 | pointer-all | 8000 | 40 | 4.02 | 3.80 | 1.06 |
-| firefox 157.0 | creation | 2000 | 15 | 23.00 | 25.00 | 0.92 |
-| firefox 157.0 | creation | 8000 | 15 | 93.00 | 85.00 | 1.09 |
-| firefox 157.0 | fill | 1000 | 100 | 1.20 | 1.60 | 0.75 |
-| firefox 157.0 | repeated-fill | 1000 | 100 | 1.70 | 5.00 | 0.34 |
-| firefox 157.0 | pointer-one | 8000 | 40 | 4.40 | 3.80 | 1.16 |
-| firefox 157.0 | pointer-all | 8000 | 40 | 4.60 | 3.80 | 1.21 |
-| webkit 27.2 | creation | 2000 | 15 | 15.00 | 20.00 | 0.75 |
-| webkit 27.2 | creation | 8000 | 15 | 56.00 | 73.00 | 0.77 |
-| webkit 27.2 | fill | 1000 | 100 | 0.70 | 1.80 | 0.39 |
-| webkit 27.2 | repeated-fill | 1000 | 100 | 1.35 | 6.85 | 0.20 |
-| webkit 27.2 | pointer-one | 8000 | 40 | 4.40 | 3.60 | 1.22 |
-| webkit 27.2 | pointer-all | 8000 | 40 | 4.20 | 3.60 | 1.17 |
+| chromium 156.0.8078.4 | creation | 2000 | 15 | 9.60 | 11.90 | 0.81 |
+| chromium 156.0.8078.4 | creation | 8000 | 15 | 33.80 | 38.70 | 0.87 |
+| chromium 156.0.8078.4 | fill | 1000 | 100 | 0.43 | 1.21 | 0.36 |
+| chromium 156.0.8078.4 | repeated-fill | 1000 | 100 | 0.66 | 3.53 | 0.19 |
+| chromium 156.0.8078.4 | pointer-one | 8000 | 40 | 3.73 | 3.56 | 1.05 |
+| chromium 156.0.8078.4 | pointer-all | 8000 | 40 | 3.82 | 3.66 | 1.04 |
+| firefox 157.0 | creation | 2000 | 15 | 20.00 | 23.00 | 0.87 |
+| firefox 157.0 | creation | 8000 | 15 | 75.00 | 80.00 | 0.94 |
+| firefox 157.0 | fill | 1000 | 100 | 1.20 | 1.55 | 0.77 |
+| firefox 157.0 | repeated-fill | 1000 | 100 | 1.60 | 4.70 | 0.34 |
+| firefox 157.0 | pointer-one | 8000 | 40 | 4.30 | 3.60 | 1.19 |
+| firefox 157.0 | pointer-all | 8000 | 40 | 4.20 | 3.60 | 1.17 |
+| webkit 27.2 | creation | 2000 | 15 | 14.00 | 18.00 | 0.78 |
+| webkit 27.2 | creation | 8000 | 15 | 55.00 | 69.00 | 0.80 |
+| webkit 27.2 | fill | 1000 | 100 | 0.60 | 1.60 | 0.37 |
+| webkit 27.2 | repeated-fill | 1000 | 100 | 0.90 | 4.90 | 0.18 |
+| webkit 27.2 | pointer-one | 8000 | 40 | 4.20 | 3.40 | 1.24 |
+| webkit 27.2 | pointer-all | 8000 | 40 | 4.20 | 3.40 | 1.24 |
 
 ## Methodology
 

package/reports/svgjs-parity-current.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-11-02T00:13:40.368Z",
-  "revision": "cf520e325957ab98952540b7234db122a672d9ed",
+  "generatedAt": "2026-11-06T20:46:53.699Z",
+  "revision": "a802f04c6f0965cedbd4c469fad996a445c6f878",
   "dirtyTree": [
     "M packages/rasam/reports/adoption.json",
     " M packages/rasam/reports/creation.json",
@@ -77,7 +77,7 @@
     },
     {
       "path": "src/changes.ts",
-      "sha256": "ad8d700a86ca9417e551b6062f470c25cfa20dd445d9712cd9850c5129b3e29e"
+      "sha256": "3c1270b193852d88350c84c66453bba1601a4ec6da8263c20e7a4a482982738b"
     },
     {
       "path": "src/changes/mutation.ts",
@@ -89,7 +89,7 @@
     },
     {
       "path": "src/changes/service.ts",
-      "sha256": "53369e7383275c12d3237ea5ce5939c1c072aa7bd870753971e14fd96f17b64d"
+      "sha256": "75d5347a4bce501bd2d691a1ead98767d9a8e7d9bb116777107689ee52abdc54"
     },
     {
       "path": "src/changes/state.ts",
@@ -97,7 +97,7 @@
     },
     {
       "path": "src/changes/types.ts",
-      "sha256": "e951337de9f07ea31cdee2d34b4aa85f7b124545f0d53675d453f52d5798b224"
+      "sha256": "1158dc5615c62c5647cfbf3609ea7df1466819fa200b368e48a70259a30eec33"
     },
     {
       "path": "src/core/attribute-validation.ts",
@@ -157,7 +157,7 @@
     },
     {
       "path": "src/dom/images.ts",
-      "sha256": "68f52ee7f43c78804c3dc4d66f0db9f1720ded54e3c51276359280c90ed615b3"
+      "sha256": "fb10a82529a22d639cc0422bc92b399c21545d8be622265515a76c89fa0f53f8"
     },
     {
       "path": "src/dom/namespace.ts",
@@ -217,7 +217,7 @@
     },
     {
       "path": "src/elements/image.ts",
-      "sha256": "d5b5c79568d4fd60a81a3abed776f6a667fb61f4c04ae0aa4bd9905eedfef26f"
+      "sha256": "d9c96803619761a338365ced07720f1de77d02f1b64ddd4e8823d346cc766bb4"
     },
     {
       "path": "src/elements/index.ts",
@@ -365,19 +365,19 @@
     },
     {
       "path": "src/interchange/clone.ts",
-      "sha256": "79c49807076752601058320ae20fe91c7d50037ee1d407bf999d4ed234a1f5b7"
+      "sha256": "ac5b0422f99912bd75117f6d25789ae7e86b858dee6662881a714be3aa1e21ad"
     },
     {
       "path": "src/interchange/dom.ts",
-      "sha256": "3fe2ccf29a81f9ed29f4c960fce9d82e83b3d85297889fd0c755adc30a9cc8b0"
+      "sha256": "ca1eb93f3ed4466b941ce6f93e4ed8de30416674c5f3909c665b17c737432df4"
     },
     {
       "path": "src/interchange/markup.ts",
-      "sha256": "cac5f9280764053e78964a7440fdee4c36dea7cef85e9d1fff5e86ef09cbe959"
+      "sha256": "18671962651a97a1f97188006dcb8e1df16aa1e02e39166459a59d6a3ec5a0fd"
     },
     {
       "path": "src/interchange/policy.ts",
-      "sha256": "f6a50a9c7f292a08710e2d5416be741756be01397d7b79bc2af4f1d1339abe16"
+      "sha256": "917bc9b3476afe360ddceebbc467046538d80be9c3ba59f5bdabff97691b9445"
     },
     {
       "path": "src/interchange/reconstruct.ts",
@@ -393,7 +393,7 @@
     },
     {
       "path": "src/interchange/types.ts",
-      "sha256": "59c02542c545be86a79b3352f2fb6d59ba28ebe4dc9b451d3bb641eaf3ffb157"
+      "sha256": "28745d333c1b7bb44414a305864d64fa252984f083efdaaa5f12eaa572120751"
     },
     {
       "path": "src/masks.ts",
@@ -485,7 +485,7 @@
     },
     {
       "path": "src/mixins/transformable.ts",
-      "sha256": "958e6496e0e9de7ebc01da259ff1dbd1bb0e269550e055511390bbd3f7fb8f4c"
+      "sha256": "35d445e5069257ecd38551c6a468806875d862e61ac55d3f560df8079e84ab6b"
     },
     {
       "path": "src/mixins/types.ts",
@@ -511,6 +511,26 @@
       "path": "src/query.ts",
       "sha256": "d537a78cd1fa6668074a44eb7c41afb55b51986702a44b58c9e1ff9f1226ef57"
     },
+    {
+      "path": "src/raster.ts",
+      "sha256": "46df66cb6c18a66c892f82a46304ef6cb8cc144100766bb4e8eb34f6aa91f204"
+    },
+    {
+      "path": "src/raster/frame.ts",
+      "sha256": "908222caf5c93ee704fe078d39315177c4c635dc8f2cb39c2258f28f18bf2c15"
+    },
+    {
+      "path": "src/raster/images.ts",
+      "sha256": "417c5e907c6e223c6ee7c517850aa77c94173608acbae9d71ed798308b1ff5ee"
+    },
+    {
+      "path": "src/raster/render.ts",
+      "sha256": "ccc3cf1dbbecce83c3982b6fd59620a62ed422e6c2df6644af91959b2938b93f"
+    },
+    {
+      "path": "src/raster/types.ts",
+      "sha256": "60c9cb9ac8ed335c460434581411aa513bb9c10f8005e4ab20bc1bf721766b94"
+    },
     {
       "path": "src/resources.ts",
       "sha256": "9660bf7b369cb915521bd184f548ead723f9c0baa5243ea57d0d8a8993ab9f50"
@@ -521,7 +541,7 @@
     },
     {
       "path": "src/resources/references.ts",
-      "sha256": "06c49b60b86254e3f8dbcda8d9ff4428e2bfd37c91bbde44cfaa621bc48647b2"
+      "sha256": "49a3aaba63aee99a725b67a85849a0f071c07e7f4d3b7458aa8cfc8409298895"
     },
     {
       "path": "src/resources/validation.ts",
@@ -565,7 +585,7 @@
     },
     {
       "path": "src/services/viewport.ts",
-      "sha256": "f9297df66650cbc940c628c518072cc449e11594e9ea4c50ed27f700c32a8447"
+      "sha256": "b33adea566823e5afb7df79bc7d2eb1c074443422a1e1d8acecda64c956a455b"
     },
     {
       "path": "src/svg.ts",
@@ -589,7 +609,7 @@
     },
     {
       "path": "src/text/content.ts",
-      "sha256": "ded249e165d537773cb1b91638feba3748e1f224779403f73be96bff053b2139"
+      "sha256": "99e3d11eec709b19b71ba7cf5ad720b60b317bd24b1272b404442e4597f6bb88"
     },
     {
       "path": "src/text/internals.ts",
@@ -599,6 +619,10 @@
       "path": "src/text/measure.ts",
       "sha256": "db023fce1361e9547adbc18040c87f5c524164fc97318322cf77d3c364ef78d2"
     },
+    {
+      "path": "src/text/policies.ts",
+      "sha256": "488f691c4047d53b05284c5224c501296c864a741e91aeedefdd5115a0f12b8e"
+    },
     {
       "path": "src/text/rich-textual.ts",
       "sha256": "52dce3a3bb91da57261dec67b8682c020bbe1ea0f22eea7aa1c02e386eb610d2"
@@ -652,8 +676,8 @@
       "sha256": "f14d89cb0695dc1c2958e831dd99b0e36cb103b0746af7bdec48c180bddf6a35"
     },
     {
-      "path": "../../package-lock.json",
-      "sha256": "a9244a1f25a62dc4fd328605dbb09b0639edaaa42939757fdfbccc7cdea963f6"
+      "path": "../../bun.lock",
+      "sha256": "d38780d5a3180ba7ee8c2cc6f6ff28c0065bb650496d78f55a3db94d5ce1800f"
     }
   ],
   "svgjs": "3.2.8",
@@ -9609,8 +9633,8 @@
   },
   "size": {
     "fixture": "fixtures/size.ts",
-    "rawBytes": 65967,
-    "gzipBytes": 19758,
+    "rawBytes": 66378,
+    "gzipBytes": 19897,
     "budgetBytes": 20480,
     "included": [
       "src/changes/mutation.ts",
@@ -9660,7 +9684,7 @@
   },
   "performance": {
     "fixture": "scripts/benchmark.mjs",
-    "date": "2026-11-02T00:13:34.754Z",
+    "date": "2026-11-06T20:46:47.900Z",
     "browser": "Chromium 156.0.8078.4",
     "node": "v24.21.0",
     "os": "win32 10.0.26200",
@@ -9669,28 +9693,28 @@
     "count": 1000,
     "warmup": 20,
     "iterations": 100,
-    "medianMs": 0.5,
-    "p95Ms": 0.699999988079071,
+    "medianMs": 0.6000000238418579,
+    "p95Ms": 0.8000000715255737,
     "targetMedianMs": 16,
     "includes": "logical mutations and synchronous DOM commit; excludes paint",
     "timings": [
-      0.3999999761581421, 0.3999999761581421, 0.3999999761581421, 0.3999999761581421,
-      0.3999999761581421, 0.3999999761581421, 0.3999999761581421, 0.3999999761581421,
-      0.3999999761581421, 0.3999999761581421, 0.40000003576278687, 0.40000003576278687,
-      0.40000003576278687, 0.40000003576278687, 0.40000003576278687, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5,
+      0.3999999761581421, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5,
       0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5,
-      0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5,
-      0.5999999642372131, 0.5999999642372131, 0.5999999642372131, 0.5999999642372131,
-      0.5999999642372131, 0.5999999642372131, 0.5999999642372131, 0.5999999642372131,
-      0.5999999642372131, 0.5999999642372131, 0.5999999642372131, 0.5999999642372131,
+      0.5, 0.5, 0.5999999046325684, 0.5999999046325684, 0.5999999046325684, 0.5999999046325684,
+      0.5999999046325684, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
+      0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
+      0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
       0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
       0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
       0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
       0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
       0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6000000238418579,
-      0.699999988079071, 0.699999988079071, 0.699999988079071, 0.699999988079071, 0.699999988079071,
-      0.7000000476837158, 0.7000000476837158, 0.800000011920929, 1.0999999642372131,
-      1.399999976158142
+      0.6000000238418579, 0.6000000238418579, 0.6000000238418579, 0.6999999284744263,
+      0.6999999284744263, 0.6999999284744263, 0.6999999284744263, 0.6999999284744263,
+      0.6999999284744263, 0.6999999284744263, 0.6999999284744263, 0.7000000476837158,
+      0.7000000476837158, 0.7000000476837158, 0.7000000476837158, 0.7000000476837158,
+      0.7000000476837158, 0.7000000476837158, 0.7000000476837158, 0.7999999523162842,
+      0.7999999523162842, 0.8000000715255737, 0.8000000715255737, 0.8999999761581421, 1, 1, 1
     ]
   }
 }

package/src/changes/service.ts

@@ -4,6 +4,7 @@ import type {
   ChangeEvent,
   ChangeGroup,
   ChangeMetadata,
+  ChangeDerivation,
   ModelChange,
   ModelSnapshot,
   NodeHandle,
@@ -18,6 +19,7 @@ interface ChangeAdapter {
 
 export class ChangeService {
   private readonly listeners = new Set<(event: ChangeEvent) => void>();
+  readonly derivations = new Set<(event: ChangeDerivation) => void>();
   private readonly identities = new WeakMap<AnyNode, NodeHandle>();
   private readonly retained = new WeakSet<AnyNode>();
   private readonly queue: ChangeEvent[] = [];
@@ -47,7 +49,7 @@ export class ChangeService {
   constructor(private readonly context: DrawingContext) {}
 
   get observed(): boolean {
-    return this.listeners.size > 0;
+    return this.listeners.size > 0 || this.derivations.size > 0;
   }
   get replaying(): boolean {
     return this.replayDepth > 0;
@@ -194,6 +196,20 @@ export class ChangeService {
     try {
       if (node) this.touch(node);
       result = callback();
+      if (this.before.size && this.derivations.size) {
+        const nodes = [...this.before]
+          .filter(
+            ([target, previous]) =>
+              target.node.isDestroyed ||
+              this.adapter!.diff(target, previous, this.adapter!.capture(target.node)).length,
+          )
+          .map(([target]) => target.node);
+        if (nodes.length) {
+          const event = { ...this.metadata, nodes };
+          for (const derive of [...this.derivations])
+            if (this.derivations.has(derive)) derive(event);
+        }
+      }
     } catch (error) {
       failure = { error };
     }
@@ -266,13 +282,22 @@ export class ChangeService {
     }
   }
 
-  group(metadata: ChangeMetadata = {}): ChangeGroup {
+  group(metadata: ChangeMetadata = {}): Omit<ChangeGroup, 'cancel'> & {
+    end(cancelled?: boolean, restored?: boolean): void;
+  } {
     const id = ++this.nextGroup,
       source = metadata.source ?? 'application';
     let active = true;
     this.groups.add(id);
     try {
-      this.publish(Object.freeze({ type: 'groupstart', group: id, source }));
+      this.publish(
+        Object.freeze({
+          type: 'groupstart',
+          group: id,
+          source,
+          ...(metadata.label === undefined ? {} : { label: metadata.label }),
+        }),
+      );
     } catch (error) {
       this.groups.delete(id);
       this.publish(Object.freeze({ type: 'groupend', group: id, source, cancelled: true }));
@@ -284,11 +309,19 @@ export class ChangeService {
         if (!active) throw new Error('Change group has ended');
         return this.scope({ ...metadata, group: id }, callback, null);
       },
-      end: (cancelled = false) => {
+      end: (cancelled = false, restored = false) => {
         if (!active) return;
         active = false;
         this.groups.delete(id);
-        this.publish(Object.freeze({ type: 'groupend', group: id, source, cancelled }));
+        this.publish(
+          Object.freeze({
+            type: 'groupend',
+            group: id,
+            source,
+            cancelled,
+            ...(restored ? { restored: true } : {}),
+          }),
+        );
       },
     });
   }
@@ -378,6 +411,7 @@ export class ChangeService {
 
   destroy(): void {
     this.listeners.clear();
+    this.derivations.clear();
     this.queue.length = 0;
     this.notifications.length = 0;
     this.replacements.length = 0;

package/src/changes/types.ts

@@ -104,9 +104,14 @@ export type ModelChange =
 
 export interface ChangeMetadata {
   readonly source?: string;
+  readonly label?: string;
   readonly temporary?: boolean;
   readonly group?: number;
 }
+/** Runs synchronously after an operation's writes, before its final change snapshot. */
+export interface ChangeDerivation extends ChangeMetadata {
+  readonly nodes: readonly AnyNode[];
+}
 export interface ChangeBatch {
   readonly type: 'change';
   readonly id: number;
@@ -126,7 +131,9 @@ export type ChangeEvent =
       readonly type: 'groupstart' | 'groupend';
       readonly group: number;
       readonly source: string;
+      readonly label?: string;
       readonly cancelled?: boolean;
+      readonly restored?: boolean;
     }
   | {
       readonly type: 'dispose' | 'willdispose';
@@ -136,6 +143,8 @@ export interface ChangeGroup {
   readonly id: number;
   run<Result>(callback: () => Result): Result;
   end(cancelled?: boolean): void;
+  /** Restore this group's own non-temporary changes, then end it as cancelled. */
+  cancel(): void;
 }
 
 export class ChangeConflictError extends Error {

package/src/changes.ts

@@ -1,12 +1,15 @@
 import type { AnyNode } from './core/types.js';
-import type { ChangeEvent, ChangeMetadata } from './changes/types.js';
-import { stateAdapter } from './changes/state.js';
+import type { ChangeEvent, ChangeGroup, ChangeMetadata, ModelChange } from './changes/types.js';
+import { ChangeConflictError, ChangeObserverError } from './changes/types.js';
+import { combineChanges, stateAdapter } from './changes/state.js';
+import { restoreChanges } from './changes/restore.js';
 
 export type {
   ChangeBatch,
   ChangeEvent,
   ChangeGroup,
   ChangeMetadata,
+  ChangeDerivation,
   ModelChange,
   ModelSnapshot,
   ModelFeatures,
@@ -35,6 +38,20 @@ export function observeChanges(
   drawing.assertLive();
   return drawing.context.changes.observe(listener, stateAdapter);
 }
+/** Derived writes join the same operation and group. Callbacks never run during restoration. */
+export function deriveChanges(
+  drawing: AnyNode,
+  derive: (event: import('./changes/types.js').ChangeDerivation) => void,
+): () => void {
+  drawing.assertLive();
+  if (typeof derive !== 'function') throw new TypeError('Change derivation must be a function');
+  drawing.context.changes.configure(stateAdapter);
+  const callbacks = drawing.context.changes.derivations;
+  callbacks.add(derive);
+  return () => {
+    callbacks.delete(derive);
+  };
+}
 export function withChanges<Result>(
   drawing: AnyNode,
   metadata: ChangeMetadata,
@@ -43,9 +60,81 @@ export function withChanges<Result>(
   drawing.assertLive();
   return drawing.context.changes.scope(metadata, callback, drawing);
 }
-export function beginChangeGroup(drawing: AnyNode, metadata: ChangeMetadata = {}) {
+export function beginChangeGroup(drawing: AnyNode, metadata: ChangeMetadata = {}): ChangeGroup {
   drawing.assertLive();
-  return drawing.context.changes.group(metadata);
+  const owner = drawing.context.root!;
+  let id: number | undefined;
+  let changes: readonly ModelChange[] = [];
+  let invalidated = false;
+  // Subscribe before groupstart so edits made by start observers are captured too.
+  const unsubscribe = observeChanges(drawing, (event) => {
+    if (event.type === 'dispose') invalidated = true;
+    if (id === undefined && event.type === 'groupstart') id = event.group;
+    if (event.type === 'change' && event.group === id && !event.temporary)
+      changes = combineChanges([...changes, ...event.changes]);
+  });
+  let group: ReturnType<typeof drawing.context.changes.group>;
+  try {
+    group = drawing.context.changes.group(metadata);
+    id = group.id;
+  } catch (error) {
+    unsubscribe();
+    throw error;
+  }
+  let active = true;
+  let cancelling = false;
+  let depth = 0;
+  const assertNotDisposed = () => {
+    if (invalidated)
+      throw new ChangeConflictError('Permanent disposal invalidated the change group');
+  };
+  const finish = (cancelled: boolean, restored = false) => {
+    active = false;
+    changes = [];
+    unsubscribe();
+    group.end(cancelled, restored);
+  };
+  return Object.freeze({
+    id: group.id,
+    run<Result>(callback: () => Result): Result {
+      if (!active || cancelling) throw new Error('Change group has ended or is cancelling');
+      assertNotDisposed();
+      depth++;
+      try {
+        return group.run(callback);
+      } finally {
+        depth--;
+      }
+    },
+    end(cancelled = false) {
+      if (active && !cancelling) finish(cancelled);
+    },
+    cancel() {
+      if (!active || cancelling) return;
+      if (depth) throw new Error('Finish the change callback before cancelling its group');
+      assertNotDisposed();
+      cancelling = true;
+      const failures: unknown[] = [];
+      try {
+        try {
+          if (changes.length) restoreChanges(owner, changes, 'undo');
+        } catch (error) {
+          if (error instanceof ChangeObserverError) failures.push(error);
+          else throw error;
+        }
+        try {
+          finish(true, true);
+        } catch (error) {
+          failures.push(error);
+        }
+      } finally {
+        cancelling = false;
+      }
+      if (failures.length === 1) throw failures[0];
+      if (failures.length)
+        throw new AggregateError(failures, 'Change group cancellation observers failed');
+    },
+  });
 }
 
 /** One recorder per context; ordinary change observers are unrestricted. */

package/src/dom/images.ts

@@ -20,7 +20,8 @@ export class ImageLoader {
     return () => {
       probe.removeEventListener('load', loaded);
       probe.removeEventListener('error', failed);
-      probe.removeAttribute('src');
+      // Resetting an already completed source starts a second native error request.
+      if (!probe.complete) probe.removeAttribute('src');
     };
   }
 }

package/src/elements/image.ts

@@ -44,7 +44,10 @@ export class SvgImage extends Shape<SVGImageElement, ImageOptions> {
 
   constructor(context: DrawingContext, options: ImageOptions = {}, existing?: SVGImageElement) {
     super(context, options, existing);
-    this.onDispose(() => this.cancelRequest());
+    this.onDispose(() => {
+      this.cancelRequest();
+      this.el.removeAttribute('href');
+    });
     if (this.source) this.context.scheduler.enqueue(this, '#image');
   }
 

package/src/interchange/clone.ts

@@ -7,7 +7,7 @@ import { dependencyRoots, remapIds } from './references.js';
 import { classifyReference } from '../resources/references.js';
 import { preflight, reconstruct, validateCloneContent } from './reconstruct.js';
 import type { CloneOptions } from './types.js';
-import { copyTextPolicies } from '../text/content.js';
+import { copyTextPolicies } from '../text/policies.js';
 
 export function cloneNode<Node extends AnyNode>(source: Node, options: CloneOptions = {}): Node {
   return source.context.changes.run(source, () => {

package/src/interchange/dom.ts

@@ -2,19 +2,29 @@ import { SVG_NAMESPACE, XLINK_NAMESPACE } from '../catalog/namespaces.js';
 
 /** Parsing and serialization operate on detached nodes in the destination document. */
 export class InterchangeDom {
-  static parse(owner: SVGElement, source: string): SVGElement[] {
+  static parse(owner: SVGElement, source: string, document = false): SVGElement[] {
     if (typeof source !== 'string' || source.length > 1_000_000)
       throw new TypeError('SVG import requires at most 1,000,000 characters');
-    if (/<!\s*(?:DOCTYPE|ENTITY)|<\?/i.test(source))
+    // A document prolog may hold an XML declaration and a DOCTYPE without an internal subset.
+    const prolog = document
+      ? /^\s*(?:<\?xml\s[^?]*\?>)?(?:\s|<!--(?:[^-]|-(?!->))*-->)*(?:<!DOCTYPE\s+svg\b[^[>]*>)?/i.exec(
+          source,
+        )![0]
+      : '';
+    const body = source.slice(prolog.length);
+    if (/<!\s*(?:DOCTYPE|ENTITY)|<\?/i.test(body))
       throw new TypeError('SVG import rejects declarations, entities and processing instructions');
     const Parser = owner.ownerDocument.defaultView?.DOMParser ?? globalThis.DOMParser;
     if (!Parser) throw new Error('SVG import requires DOMParser');
     const parsed = new Parser().parseFromString(
-      `<svg xmlns="${SVG_NAMESPACE}" xmlns:xlink="${XLINK_NAMESPACE}">${source}</svg>`,
+      `<svg xmlns="${SVG_NAMESPACE}" xmlns:xlink="${XLINK_NAMESPACE}">${body}</svg>`,
       'image/svg+xml',
     );
-    if (parsed.getElementsByTagName('parsererror').length)
-      throw new TypeError('Invalid SVG markup');
+    const failure = parsed.getElementsByTagName('parsererror')[0];
+    if (failure)
+      throw new SyntaxError(
+        `Not valid SVG: ${failure.textContent?.trim().split(/\r?\n/)[0] || 'Invalid SVG markup'}`,
+      );
     const roots: SVGElement[] = [];
     for (const node of parsed.documentElement.childNodes) {
       if (node.nodeType === 8 || (node.nodeType === 3 && !node.textContent.trim())) continue;
@@ -27,6 +37,25 @@ export class InterchangeDom {
           element.replaceChild(owner.ownerDocument.createTextNode(child.textContent), child);
     return roots;
   }
+  /** Called after passive validation so even discarded envelope attributes are checked. */
+  static unwrap(roots: SVGElement[], presentation: boolean): SVGElement[] {
+    const root = roots[0];
+    if (roots.length !== 1 || root.localName !== 'svg') return roots;
+    const children = [...root.children] as SVGElement[];
+    if (!presentation) return children;
+    const group = root.ownerDocument.createElementNS(SVG_NAMESPACE, 'g');
+    for (const attribute of [...root.attributes])
+      if (
+        !['x', 'y', 'width', 'height', 'viewBox', 'preserveAspectRatio', 'version'].includes(
+          attribute.name,
+        ) &&
+        attribute.namespaceURI !== 'http://www.w3.org/2000/xmlns/'
+      )
+        group.setAttributeNS(attribute.namespaceURI, attribute.name, attribute.value);
+    if (!group.attributes.length) return children;
+    group.append(...root.childNodes);
+    return [group];
+  }
   static serialize(element: SVGElement): string {
     const Serializer = element.ownerDocument.defaultView?.XMLSerializer ?? globalThis.XMLSerializer;
     if (!Serializer) throw new Error('SVG export requires XMLSerializer');