@rasamjs/core 0.1.2 → 0.2.0

package/reports/benchmark.json

@@ -1,6 +1,6 @@
 {
   "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",
@@ -9,26 +9,12 @@
   "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,
@@ -65,25 +51,13 @@
     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.5999999046325684,
+    0.5999999046325684,
+    0.5999999046325684,
+    0.5999999046325684,
+    0.5999999046325684,
+    0.6000000238418579,
+    0.6000000238418579,
     0.6000000238418579,
     0.6000000238418579,
     0.6000000238418579,
@@ -104,15 +78,41 @@
     0.6000000238418579,
     0.6000000238418579,
     0.6000000238418579,
-    0.699999988079071,
-    0.699999988079071,
-    0.699999988079071,
-    0.699999988079071,
-    0.699999988079071,
+    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.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.800000011920929,
-    1.0999999642372131,
-    1.399999976158142
+    0.7999999523162842,
+    0.7999999523162842,
+    0.8000000715255737,
+    0.8000000715255737,
+    0.8999999761581421,
+    1,
+    1,
+    1
   ]
 }

package/reports/creation.json

@@ -1,6 +1,6 @@
 {
   "fixture": "scripts/benchmark-creation.mjs",
-  "date": "2026-11-02T00:13:22.779Z",
+  "date": "2026-11-06T20:46:39.500Z",
   "node": "v24.21.0",
   "os": "win32 10.0.26200",
   "cpu": "Intel(R) Core(TM) i7-10610U CPU @ 1.80GHz",
@@ -9,60 +9,60 @@
   "results": [
     {
       "count": 2000,
-      "medianCreationMs": 26.705100000000016,
-      "medianPointerMovesMs": 8.671500000000037,
+      "medianCreationMs": 22.994300000000067,
+      "medianPointerMovesMs": 7.282600000000002,
       "samples": [
         {
-          "creationMs": 33.11779999999999,
-          "pointerMovesMs": 15.405399999999986
+          "creationMs": 31.776499999999942,
+          "pointerMovesMs": 8.679300000000012
         },
         {
-          "creationMs": 26.705100000000016,
-          "pointerMovesMs": 8.671500000000037
+          "creationMs": 26.4683,
+          "pointerMovesMs": 7.282600000000002
         },
         {
-          "creationMs": 28.883399999999938,
-          "pointerMovesMs": 12.037599999999998
+          "creationMs": 22.994300000000067,
+          "pointerMovesMs": 7.207400000000007
         },
         {
-          "creationMs": 24.3522999999999,
-          "pointerMovesMs": 8.336500000000001
+          "creationMs": 21.127500000000055,
+          "pointerMovesMs": 7.402299999999968
         },
         {
-          "creationMs": 24.069499999999948,
-          "pointerMovesMs": 7.400499999999965
+          "creationMs": 19.99980000000005,
+          "pointerMovesMs": 6.323700000000031
         }
       ]
     },
     {
       "count": 8000,
-      "medianCreationMs": 78.9511,
-      "medianPointerMovesMs": 6.612600000000157,
+      "medianCreationMs": 58.684099999999944,
+      "medianPointerMovesMs": 5.811899999999923,
       "samples": [
         {
-          "creationMs": 96.93219999999985,
-          "pointerMovesMs": 7.832300000000032
+          "creationMs": 97.0326,
+          "pointerMovesMs": 6.8799999999999955
         },
         {
-          "creationMs": 81.06889999999999,
-          "pointerMovesMs": 6.612600000000157
+          "creationMs": 57.53489999999988,
+          "pointerMovesMs": 6.402499999999918
         },
         {
-          "creationMs": 61.077400000000125,
-          "pointerMovesMs": 6.204999999999927
+          "creationMs": 58.684099999999944,
+          "pointerMovesMs": 5.383299999999963
         },
         {
-          "creationMs": 78.9511,
-          "pointerMovesMs": 6.264099999999871
+          "creationMs": 46.910699999999906,
+          "pointerMovesMs": 5.320499999999811
         },
         {
-          "creationMs": 70.96590000000015,
-          "pointerMovesMs": 6.688599999999951
+          "creationMs": 67.3143,
+          "pointerMovesMs": 5.811899999999923
         }
       ]
     }
   ],
-  "creationGrowth": 2.956405330816958,
+  "creationGrowth": 2.552115089391709,
   "maxCreationGrowth": 8,
   "includes": "logical creation and native append; excludes final frame commit, paint and destruction"
 }

package/reports/interchange-benchmark.json

@@ -1,6 +1,6 @@
 {
   "fixture": "scripts/benchmark-interchange.mjs",
-  "date": "2026-11-02T00:13:31.392Z",
+  "date": "2026-11-06T20:46:45.233Z",
   "node": "v24.21.0",
   "os": "win32 10.0.26200",
   "cpu": "Intel(R) Core(TM) i7-10610U CPU @ 1.80GHz",
@@ -13,134 +13,134 @@
     {
       "count": 250,
       "clone": {
-        "medianMs": 23.380999999999972,
-        "p95Ms": 38.50459999999998,
+        "medianMs": 14.36850000000004,
+        "p95Ms": 25.575800000000072,
         "samples": [
-          23.380999999999972,
-          20.48440000000005,
-          26.748000000000047,
-          36.8599999999999,
-          18.861400000000003,
-          22.280199999999923,
-          38.50459999999998
+          17.1789,
+          14.36850000000004,
+          12.423800000000028,
+          23.65319999999997,
+          12.553499999999985,
+          11.732599999999934,
+          25.575800000000072
         ]
       },
       "export": {
-        "medianMs": 11.591599999999971,
-        "p95Ms": 94.22260000000006,
+        "medianMs": 6.32000000000005,
+        "p95Ms": 58.25649999999996,
         "samples": [
-          23.898900000000026,
-          94.22260000000006,
-          7.6426000000001295,
-          14.268799999999828,
-          9.160500000000184,
-          11.591599999999971,
-          8.695199999999886
+          20.354299999999967,
+          58.25649999999996,
+          5.651700000000005,
+          6.599199999999996,
+          6.32000000000005,
+          5.825900000000047,
+          5.610500000000002
         ]
       },
       "import": {
-        "medianMs": 32.36749999999995,
-        "p95Ms": 61.8922,
+        "medianMs": 22.17560000000003,
+        "p95Ms": 40.97770000000003,
         "samples": [
-          32.36749999999995,
-          38.87099999999987,
-          32.03800000000001,
-          61.8922,
-          31.651000000000067,
-          37.60699999999997,
-          28.491300000000138
+          24.787900000000036,
+          22.17560000000003,
+          20.307199999999966,
+          40.97770000000003,
+          34.016200000000026,
+          21.543699999999944,
+          19.876000000000204
         ]
       }
     },
     {
       "count": 500,
       "clone": {
-        "medianMs": 31.575600000000122,
-        "p95Ms": 84.21369999999979,
+        "medianMs": 36.39790000000016,
+        "p95Ms": 67.91699999999992,
         "samples": [
-          31.575600000000122,
-          29.292899999999918,
-          84.21369999999979,
-          30.08069999999998,
-          28.73829999999998,
-          43.51350000000002,
-          44.92489999999998
+          36.39790000000016,
+          21.91450000000009,
+          67.91699999999992,
+          37.66339999999991,
+          36.05690000000004,
+          21.885700000000043,
+          38.212999999999965
         ]
       },
       "export": {
-        "medianMs": 29.19920000000002,
-        "p95Ms": 48.35719999999992,
+        "medianMs": 12.001600000000053,
+        "p95Ms": 26.850000000000136,
         "samples": [
-          13.85089999999991,
-          32.823199999999815,
-          48.35719999999992,
-          28.33600000000024,
-          29.19920000000002,
-          34.56640000000016,
-          12.802100000000337
+          11.47589999999991,
+          25.010999999999967,
+          12.001600000000053,
+          11.017700000000104,
+          10.565200000000004,
+          26.850000000000136,
+          26.13059999999996
         ]
       },
       "import": {
-        "medianMs": 53.96369999999979,
-        "p95Ms": 76.07709999999997,
+        "medianMs": 40.34269999999992,
+        "p95Ms": 58.42690000000016,
         "samples": [
-          53.96369999999979,
-          49.51159999999982,
-          52.294200000000274,
-          76.07709999999997,
-          66.52050000000008,
-          51.23730000000023,
-          63.930199999999786
+          53.97910000000002,
+          37.91249999999991,
+          40.34269999999992,
+          58.42690000000016,
+          53.251900000000205,
+          37.406600000000026,
+          37.35789999999997
         ]
       }
     },
     {
       "count": 1000,
       "clone": {
-        "medianMs": 92.53090000000066,
-        "p95Ms": 107.92509999999993,
+        "medianMs": 60.02669999999989,
+        "p95Ms": 103.83410000000003,
         "samples": [
-          107.92509999999993,
-          105.73300000000017,
-          89.36130000000048,
-          92.53090000000066,
-          79.21529999999984,
-          90.03070000000025,
-          94.65950000000066
+          61.13799999999992,
+          60.02669999999989,
+          103.83410000000003,
+          59.36310000000003,
+          44.89000000000033,
+          60.998499999999694,
+          57.07690000000002
         ]
       },
       "export": {
-        "medianMs": 53.40429999999924,
-        "p95Ms": 99.54770000000008,
+        "medianMs": 33.539800000000014,
+        "p95Ms": 36.14080000000013,
         "samples": [
-          43.141299999999774,
-          53.40429999999924,
-          99.54770000000008,
-          49.497699999999895,
-          40.45460000000003,
-          55.76590000000033,
-          54.46190000000024
+          34.11229999999978,
+          21.14890000000014,
+          22.764500000000226,
+          36.14080000000013,
+          32.53719999999976,
+          34.116799999999785,
+          33.539800000000014
         ]
       },
       "import": {
-        "medianMs": 159.21590000000015,
-        "p95Ms": 175.88940000000002,
+        "medianMs": 108.88810000000012,
+        "p95Ms": 136.57619999999997,
         "samples": [
-          175.88940000000002,
-          164.67600000000039,
-          139.2474000000002,
-          136.66079999999965,
-          137.1938,
-          166.03060000000005,
-          159.21590000000015
+          108.88810000000012,
+          136.57619999999997,
+          123.6588999999999,
+          117.4067,
+          104.08899999999994,
+          88.07529999999997,
+          100.63900000000012
         ]
       }
     }
   ],
   "growth": {
-    "clone": 3.9575253410889513,
-    "export": 4.607155181338157,
-    "import": 4.919005174944014
+    "clone": 4.1776594634095225,
+    "export": 5.306930379746795,
+    "import": 4.910266238568515
   },
   "maxGrowth": 8
 }

package/reports/public-api-contract.json

@@ -7759,6 +7759,7 @@
         "changeKey",
         "claimRecorder",
         "combineChanges",
+        "deriveChanges",
         "observeChanges",
         "restoreChanges",
         "restoreModelState",
@@ -7788,6 +7789,7 @@
       },
       "typeExports": [
         "ChangeBatch",
+        "ChangeDerivation",
         "ChangeEvent",
         "ChangeGroup",
         "ChangeMetadata",
@@ -8936,6 +8938,11 @@
       "constructors": {},
       "typeExports": ["NodePredicate"]
     },
+    "./raster": {
+      "runtimeExports": ["exportImage"],
+      "constructors": {},
+      "typeExports": ["RasterOptions"]
+    },
     "./resources": {
       "runtimeExports": ["classifyReference", "consumers", "resolveReference", "unbindConsumers"],
       "constructors": {},
@@ -9353,10 +9360,10 @@
     "catalog.d.ts": "bc06549507eb428e0b1976ef41dba3b2e9ffbb600790e834d576c09a65e2ff17",
     "changes/mutation.d.ts": "cd991dbe82484b064999b5550b8b61065d93d8ce52e7f2af5304bd8ee21c5266",
     "changes/restore.d.ts": "6e491519aedde32d0212824b28220453e6154b5a68dfda6376450bfd28fb0a21",
-    "changes/service.d.ts": "f4372c953b6af797291b26f608fab5511b15a988025e83de797f92710edc7251",
+    "changes/service.d.ts": "dc7f6e0855e75d21fa931236ebc836d6a8ee792d2791b54fbe44b8cfda4a6842",
     "changes/state.d.ts": "3cda6b0aefa9195df654d7640b20767825063245954b1efb651f959dea3977d6",
-    "changes/types.d.ts": "bc89ca5295ce9452d9aa82b0393ad237dcf6dca2299d3fdd65cfd4b1891e4c72",
-    "changes.d.ts": "ac80323ba0a1f13a6285cb9c345f5b5709323cced8c86e5cfc2ff933283daeee",
+    "changes/types.d.ts": "98627f8d2e451de4a60aff3cfd4f060f4bf705d741b7292dce731a76e4c7551f",
+    "changes.d.ts": "7c05ff496cca33e70c09cbb2e57033f13c60800bf413965792609d0a68f5f46f",
     "core/attribute-validation.d.ts": "0b71aa592f9ddc43e813fd0c3afc637234c94ba1d04faf8316d5a8b9da1b7b9e",
     "core/destruction.d.ts": "f8c3b53b71ec426b1db15483f1963c9e1033b714bb3e28f95f24b5bcf9428f30",
     "core/mix.d.ts": "a535f1c9515e144c1adbd0117329954ad326d2ad83fef0ed66aa5a9a2a2ef120",
@@ -9423,13 +9430,13 @@
     "geometry/point-list.d.ts": "2de99bb471c47b87ae7117fe069a18975a5d5ffee1c127f0c3de72406fc67fc4",
     "index.d.ts": "5f43de5a9e02bd0fd3131e732e9fabce3a428d63834ef8808c1123a79d09cb4c",
     "interchange/clone.d.ts": "66872445bfb16c22ebce7e859c066df8e4a33e09e1e06cf30349895cf1854c61",
-    "interchange/dom.d.ts": "e6d0ed419d60f1e5238524df9aca6b72d8bfc4f328c095d6f77c23503a32d38d",
+    "interchange/dom.d.ts": "ab644b639bc06c70651e28aeaf51d7a7cc0b3b9aa2e4c061292b1f0fc3ccc738",
     "interchange/markup.d.ts": "50e565c1cde341c988f3665954877dcddad379ad29ea451ac45d8f5a816f387f",
     "interchange/policy.d.ts": "734f40462862daa6e75cb5cb2779765717c68f96c239813da6c7072a379639ae",
     "interchange/reconstruct.d.ts": "7ab7e8c489ec2fd064aa8299c4bd4684404bd679bfc8992e13cc0d1fb874cf63",
     "interchange/references.d.ts": "3d477867846c20a4e61463cbe9f0a4d020e35918719a7bcb16b9bd7c47b8ec96",
     "interchange/snapshot.d.ts": "7539f476b1ec0fe5dc37337067171a1255f3b0f40d99593225d1cc82e54fe1d1",
-    "interchange/types.d.ts": "7c48a11ed300def0d2604a42bf155bd5934429030b6fbcc38b2d2040496c77b9",
+    "interchange/types.d.ts": "51d5a52ed967e5696e91055a6d26347d1a9ab9798b4ea946ac2fc9eb33301299",
     "interchange.d.ts": "95a22e27571dcf7b81290a429b2361dca77f619c4b9239a60647a1779dd43d66",
     "masks.d.ts": "c474634ef9476f86d89e656629aad72ac09623fa84884809d945b69ebe74c7fe",
     "math/bbox.d.ts": "fafa245e13885cce7eca458086b45c6bdb946fe0e3ac1816bab54c437b629d7a",
@@ -9460,6 +9467,11 @@
     "path/transform-arc.d.ts": "4e9c17fa3d8a813d75911d8d3a562a35b61d36ea86b69cc03c77c7d9bb0d7d95",
     "patterns.d.ts": "69e63ebf3c054d4629b768280c65278f8c9f1199f1a655316226c58b30bf9d5f",
     "query.d.ts": "ae0a1ed8a258b84d274fa86846f178c25249b06cda3a3953ea8b5e018d432532",
+    "raster/frame.d.ts": "0cd983a4babb9972516c4df15d55919671ed19a9151a392a175408244bb3b9af",
+    "raster/images.d.ts": "fc1e95921726bf57b582a9006f9935509c8749509177718722d3ca8f0b1ca75a",
+    "raster/render.d.ts": "fbb5687f5611486d6bab07deb93793a75e4b0c3eedf0a74197c41b88eced79e7",
+    "raster/types.d.ts": "c2b078976875b8865a50931bfd97c363b516ca96d7bf7cf2666cf7ae6fb32b43",
+    "raster.d.ts": "e5b66a567c809f05b097a020273d0b021ed4cb4a4f5cf9484df7c7cb78293f46",
     "resources/content.d.ts": "3a8587867cc13f2562e80029b9f34e35203ff41632626e780c2358604314d670",
     "resources/references.d.ts": "eccfc09bdaa82d9bdd0a6043a5e39e054016a9d44674610e0bbe62c667da9ae5",
     "resources/validation.d.ts": "e3b341076369fa10c53d06225d21760a90ccc98bb44ab433396d1f8cf45cd192",
@@ -9473,14 +9485,15 @@
     "services/registry.d.ts": "dbca30ef26360d1de89eadea11d2507dc1bde7fcf40b25fbcbca7a472894b4c4",
     "services/scheduler.d.ts": "82d56d64434a02b548c94df3a90c7f1b37fcdf8c56caf077048a884de2e6b541",
     "services/types.d.ts": "da38dc8f9e82c170999a6fd2da8ab0327f9457da1fd1b1b2352905805c398023",
-    "services/viewport.d.ts": "899dd9a6f96922940247c51f9b9ae82cac1621dc89a9051f2caa4da4941746ca",
+    "services/viewport.d.ts": "62fee85c15795d443d22fb1524417e6c707812dd6a3ff0003b26758d9475f61b",
     "svg.d.ts": "cfc13ecfa09cc5f6774f70e8625d01c3495d4a1d96357da7773a6a3fafdb698d",
     "template/parts.d.ts": "dfebe5a32b964b594aaaf9e9622739accb644f0fa6f53329648f732f3b542c5e",
     "template/render.d.ts": "c5a22fbef5dd52005098d5e808e85ef92d7c6efde14778c9f47b54643948578a",
     "template/svg-tag.d.ts": "d5b07bde53a6d75ff8ca0b7e139e62362f55e2d530d8ea1578d9b8bbc0a6aedd",
-    "text/content.d.ts": "a25b631c4ccb24e912dc95f3562e2a5c441a52c2c3147c74a7583e0c59d1e6f5",
+    "text/content.d.ts": "2beb6d185d30453dfcfbbc64139bf7cdb90170b9c55b5fb2596937bf2d6c8bff",
     "text/internals.d.ts": "08e768cca8c679ca8f591575aa956bd577ac195582c24d61813b49be9f617e46",
     "text/measure.d.ts": "3a35c2c6840fd6584023bd408c1bf94210be01b4dc9913e03ab053d5f5f50ea6",
+    "text/policies.d.ts": "80e82e6a329ae4d85b5a0d11afe675659f0fc8f3a2448743f0f632f11ed2f402",
     "text/rich-textual.d.ts": "9b70abd855cb7dc33e899cd62b5dc66da73778f301737f724e383f8d68998fc1",
     "text/types.d.ts": "62d9deea62e470bde960189c2b88efee6eb58a78c5b3c71f3ef1fdb571f4812b",
     "text/validation.d.ts": "9b460cb33cc9754b09860b5f21ad3995f1a5460d545b80b8c7b076881f3f1d2e",

package/reports/public-api-review.md

@@ -1,5 +1,28 @@
 # Public API review
 
+Phase 8 (2026-11-03) adds only the optional `./raster` public module:
+`exportImage` and type `RasterOptions`, with five new declaration files. Existing
+entry exports, prototypes and declaration hashes remain unchanged. The raster
+fixture measures 9,688/12,288 B gzip and is excluded from existing entry bundles.
+The packed consumer verifies typed usage and document-free imports. Raster pixels,
+resource failures, format negotiation and source preservation have native browser
+coverage; web-font/style embedding is explicitly outside this first version.
+
+## Editor foundations (2026-11-03)
+
+Phase 1 adds `ChangeMetadata.label`, its optional `groupstart` event field,
+`ChangeGroup.cancel()` and the optional restored-cancellation event flag. History remains
+an independent consumer. Cancellation recording and restoration stay in the opt-in changes
+entry; the root only transports metadata and the completion flag. Conflicts leave an active
+group available for retry, and permanent disposal invalidates cancellation. Observer failures
+after restoration are reported after ending the group.
+
+`ExportOptions.frame: 'content'` and `padding` frame geometric root-space content on the
+detached export. `ImportOptions.document` unwraps one outer SVG document and accepts its
+XML declaration; fragment mode and passive import validation remain available. Parse errors
+now use `SyntaxError` with the first parser error line. No new runtime exports or peers are
+introduced. The existing `BBox.union()` covers the bounds-union requirement.
+
 P11 adds only opt-in `@rasamjs/core/query` (`query`, `queryFirst`, `matches`, `queryNative`,
 type `NodePredicate`) and `@rasamjs/core/interchange` (`cloneNode`, `exportSvg`, `importSvg`
 and their option types). Constructors remain drawing-registered; queries do not