@rasamjs/core 0.1.2 → 0.3.0

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

package/reports/size-components.json

@@ -0,0 +1,102 @@
+{
+  "fixture": "fixtures/size-components.ts",
+  "rawBytes": 142569,
+  "gzipBytes": 42890,
+  "budgetBytes": 43008,
+  "included": [
+    "src/changes/mutation.ts",
+    "src/dom/attributes.ts",
+    "src/decorators/attrs.ts",
+    "src/events/emitter.ts",
+    "src/math/vec2.ts",
+    "src/math/matrix.ts",
+    "src/core/destruction.ts",
+    "src/mixins/parent-internals.ts",
+    "src/core/attribute-validation.ts",
+    "src/changes/types.ts",
+    "src/core/node.ts",
+    "src/dom/namespace.ts",
+    "src/dom/create.ts",
+    "src/core/mix.ts",
+    "src/mixins/styleable.ts",
+    "src/math/bbox.ts",
+    "src/math/viewport.ts",
+    "src/services/viewport.ts",
+    "src/mixins/placement.ts",
+    "src/mixins/transform-state.ts",
+    "src/mixins/transformable.ts",
+    "src/math/length.ts",
+    "src/mixins/sizing-internals.ts",
+    "src/mixins/sizable.ts",
+    "src/core/shape.ts",
+    "src/geometry/bake-ellipse.ts",
+    "src/elements/circle.ts",
+    "src/mixins/parent.ts",
+    "src/mixins/creatable.ts",
+    "src/elements/group.ts",
+    "src/elements/defs.ts",
+    "src/mixins/guards.ts",
+    "src/services/reference-value.ts",
+    "src/mixins/resourceful.ts",
+    "src/resources/content.ts",
+    "src/elements/clip-path.ts",
+    "src/elements/ellipse.ts",
+    "src/elements/stop.ts",
+    "src/elements/gradient.ts",
+    "src/geometry/point-list.ts",
+    "src/geometry/point-array.ts",
+    "src/elements/line.ts",
+    "src/math/viewbox.ts",
+    "src/elements/marker.ts",
+    "src/path/path-builder.ts",
+    "src/path/transform-arc.ts",
+    "src/path/path-array.ts",
+    "src/elements/path.ts",
+    "src/elements/point-shape.ts",
+    "src/elements/polygon.ts",
+    "src/elements/polyline.ts",
+    "src/elements/rect.ts",
+    "src/dom/text.ts",
+    "src/text/policies.ts",
+    "src/text/content.ts",
+    "src/text/internals.ts",
+    "src/text/measure.ts",
+    "src/text/rich-textual.ts",
+    "src/text/validation.ts",
+    "src/elements/text.ts",
+    "src/media/length.ts",
+    "src/elements/use-geometry.ts",
+    "src/elements/instance-hit.ts",
+    "src/elements/use.ts",
+    "src/elements/index.ts",
+    "src/services/bounds.ts",
+    "src/services/defs-manager.ts",
+    "src/core/native-validation.ts",
+    "src/services/element-key.ts",
+    "src/services/initialization.ts",
+    "src/services/registry.ts",
+    "src/services/scheduler.ts",
+    "src/changes/service.ts",
+    "src/services/context.ts",
+    "src/events/pointer.ts",
+    "src/services/mount.ts",
+    "src/elements/svg.ts",
+    "src/services/catalog.ts",
+    "src/svg.ts",
+    "src/template/svg-tag.ts",
+    "src/resources/references.ts",
+    "src/template/parts.ts",
+    "src/template/render.ts",
+    "src/changes/state.ts",
+    "src/changes/derived.ts",
+    "src/changes/restore.ts",
+    "src/changes.ts",
+    "src/components/metadata.ts",
+    "src/components/view.ts",
+    "src/components/changes.ts",
+    "src/components/component.ts",
+    "src/components/decorators.ts",
+    "src/components/registry.ts",
+    "fixtures/size-components.ts"
+  ]
+}

package/reports/size-parity.json

@@ -1,9 +1,9 @@
 [
   {
     "fixture": "fixtures/size-catalog.ts",
-    "rawBytes": 109089,
-    "gzipBytes": 32518,
-    "budgetBytes": 32768,
+    "rawBytes": 114375,
+    "gzipBytes": 34248,
+    "budgetBytes": 34816,
     "included": [
       "src/changes/mutation.ts",
       "src/dom/attributes.ts",
@@ -12,6 +12,7 @@
       "src/math/vec2.ts",
       "src/math/matrix.ts",
       "src/core/destruction.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
@@ -31,7 +32,6 @@
       "src/core/shape.ts",
       "src/geometry/bake-ellipse.ts",
       "src/elements/circle.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/parent.ts",
       "src/mixins/creatable.ts",
       "src/elements/group.ts",
@@ -58,6 +58,7 @@
       "src/elements/polyline.ts",
       "src/elements/rect.ts",
       "src/dom/text.ts",
+      "src/text/policies.ts",
       "src/text/content.ts",
       "src/text/internals.ts",
       "src/text/measure.ts",
@@ -72,6 +73,8 @@
       "src/services/bounds.ts",
       "src/services/defs-manager.ts",
       "src/core/native-validation.ts",
+      "src/services/element-key.ts",
+      "src/services/initialization.ts",
       "src/services/registry.ts",
       "src/services/scheduler.ts",
       "src/changes/service.ts",
@@ -108,8 +111,8 @@
   },
   {
     "fixture": "fixtures/size-tree.ts",
-    "rawBytes": 21933,
-    "gzipBytes": 7082,
+    "rawBytes": 22620,
+    "gzipBytes": 7315,
     "budgetBytes": 8192,
     "included": [
       "src/tree/traversal.ts",
@@ -122,11 +125,11 @@
       "src/events/emitter.ts",
       "src/math/vec2.ts",
       "src/math/matrix.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
       "src/mixins/guards.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/placement.ts",
       "src/tree/reparent.ts",
       "src/tree/structure.ts"
@@ -149,16 +152,16 @@
   },
   {
     "fixture": "fixtures/size-resources.ts",
-    "rawBytes": 5662,
-    "gzipBytes": 2178,
+    "rawBytes": 5742,
+    "gzipBytes": 2211,
     "budgetBytes": 4096,
     "included": ["src/dom/attributes.ts", "src/core/destruction.ts", "src/resources/references.ts"],
     "unrelated": []
   },
   {
     "fixture": "fixtures/size-text.ts",
-    "rawBytes": 36832,
-    "gzipBytes": 11727,
+    "rawBytes": 37898,
+    "gzipBytes": 12107,
     "budgetBytes": 12288,
     "included": [
       "src/changes/mutation.ts",
@@ -168,15 +171,16 @@
       "src/math/vec2.ts",
       "src/math/matrix.ts",
       "src/core/destruction.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
       "src/core/mix.ts",
       "src/math/bbox.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/parent.ts",
       "src/mixins/styleable.ts",
       "src/dom/text.ts",
+      "src/text/policies.ts",
       "src/text/content.ts",
       "src/text/internals.ts",
       "src/text/measure.ts",
@@ -185,6 +189,7 @@
       "src/text/validation.ts",
       "src/elements/tspan.ts",
       "src/elements/text-path.ts",
+      "src/services/element-key.ts",
       "src/services/catalog.ts",
       "src/mixins/guards.ts",
       "src/text.ts"
@@ -209,9 +214,9 @@
   },
   {
     "fixture": "fixtures/size-media.ts",
-    "rawBytes": 53363,
-    "gzipBytes": 16087,
-    "budgetBytes": 16384,
+    "rawBytes": 54452,
+    "gzipBytes": 16484,
+    "budgetBytes": 16896,
     "included": [
       "src/core/destruction.ts",
       "src/changes/mutation.ts",
@@ -220,6 +225,7 @@
       "src/events/emitter.ts",
       "src/math/vec2.ts",
       "src/math/matrix.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
@@ -239,7 +245,6 @@
       "src/media/length.ts",
       "src/media/validation.ts",
       "src/elements/image.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/parent.ts",
       "src/mixins/creatable.ts",
       "src/elements/group.ts",
@@ -253,6 +258,7 @@
       "src/math/viewbox.ts",
       "src/elements/symbol.ts",
       "src/elements/link.ts",
+      "src/services/element-key.ts",
       "src/services/catalog.ts",
       "src/tree/traversal.ts",
       "src/tree/reparent.ts",
@@ -263,9 +269,9 @@
   },
   {
     "fixture": "fixtures/size-content.ts",
-    "rawBytes": 56649,
-    "gzipBytes": 17018,
-    "budgetBytes": 17408,
+    "rawBytes": 58413,
+    "gzipBytes": 17605,
+    "budgetBytes": 17920,
     "included": [
       "src/changes/mutation.ts",
       "src/dom/attributes.ts",
@@ -274,6 +280,7 @@
       "src/math/vec2.ts",
       "src/math/matrix.ts",
       "src/core/destruction.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
@@ -281,6 +288,8 @@
       "src/mixins/textual.ts",
       "src/core/native-validation.ts",
       "src/dom/namespaced-attributes.ts",
+      "src/services/element-key.ts",
+      "src/services/initialization.ts",
       "src/services/registry.ts",
       "src/catalog/namespaces.ts",
       "src/dom/content.ts",
@@ -303,7 +312,6 @@
       "src/media/length.ts",
       "src/elements/foreign-object.ts",
       "src/services/catalog.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/parent.ts",
       "src/mixins/creatable.ts",
       "src/elements/generic.ts",
@@ -316,8 +324,8 @@
   },
   {
     "fixture": "fixtures/size-query.ts",
-    "rawBytes": 11266,
-    "gzipBytes": 4069,
+    "rawBytes": 12229,
+    "gzipBytes": 4418,
     "budgetBytes": 5120,
     "included": [
       "src/dom/attributes.ts",
@@ -325,6 +333,9 @@
       "src/math/matrix.ts",
       "src/core/attribute-validation.ts",
       "src/core/native-validation.ts",
+      "src/mixins/parent-internals.ts",
+      "src/services/element-key.ts",
+      "src/services/initialization.ts",
       "src/services/registry.ts",
       "src/query.ts"
     ],
@@ -332,8 +343,8 @@
   },
   {
     "fixture": "fixtures/size-interchange.ts",
-    "rawBytes": 58750,
-    "gzipBytes": 17853,
+    "rawBytes": 57154,
+    "gzipBytes": 17519,
     "budgetBytes": 18432,
     "included": [
       "src/changes/mutation.ts",
@@ -343,12 +354,12 @@
       "src/math/vec2.ts",
       "src/math/matrix.ts",
       "src/core/destruction.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
       "src/core/mix.ts",
       "src/math/bbox.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/parent.ts",
       "src/mixins/creatable.ts",
       "src/mixins/styleable.ts",
@@ -371,20 +382,55 @@
       "src/interchange/dom.ts",
       "src/interchange/references.ts",
       "src/core/native-validation.ts",
+      "src/services/initialization.ts",
       "src/interchange/reconstruct.ts",
-      "src/dom/text.ts",
-      "src/text/content.ts",
+      "src/text/policies.ts",
       "src/interchange/clone.ts",
       "src/interchange/policy.ts",
       "src/interchange/markup.ts"
     ],
     "unrelated": []
   },
+  {
+    "fixture": "fixtures/size-raster.ts",
+    "rawBytes": 31457,
+    "gzipBytes": 10524,
+    "budgetBytes": 12288,
+    "included": [
+      "src/catalog/namespaces.ts",
+      "src/core/destruction.ts",
+      "src/mixins/parent-internals.ts",
+      "src/dom/namespaced-attributes.ts",
+      "src/changes/mutation.ts",
+      "src/dom/attributes.ts",
+      "src/decorators/attrs.ts",
+      "src/events/emitter.ts",
+      "src/math/vec2.ts",
+      "src/math/matrix.ts",
+      "src/core/attribute-validation.ts",
+      "src/changes/types.ts",
+      "src/core/node.ts",
+      "src/mixins/guards.ts",
+      "src/interchange/snapshot.ts",
+      "src/resources/references.ts",
+      "src/interchange/dom.ts",
+      "src/interchange/references.ts",
+      "src/math/bbox.ts",
+      "src/math/viewport.ts",
+      "src/services/viewport.ts",
+      "src/interchange/markup.ts",
+      "src/raster/frame.ts",
+      "src/raster/images.ts",
+      "src/raster/render.ts",
+      "src/raster.ts"
+    ],
+    "unrelated": []
+  },
   {
     "fixture": "fixtures/size-masks.ts",
-    "rawBytes": 43460,
-    "gzipBytes": 13066,
-    "budgetBytes": 13312,
+    "rawBytes": 44581,
+    "gzipBytes": 13478,
+    "budgetBytes": 13824,
     "included": [
       "src/changes/mutation.ts",
       "src/dom/attributes.ts",
@@ -393,12 +439,12 @@
       "src/math/vec2.ts",
       "src/math/matrix.ts",
       "src/core/destruction.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
       "src/core/mix.ts",
       "src/math/bbox.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/parent.ts",
       "src/mixins/creatable.ts",
       "src/mixins/styleable.ts",
@@ -419,6 +465,7 @@
       "src/math/viewbox.ts",
       "src/resources/validation.ts",
       "src/elements/mask.ts",
+      "src/services/element-key.ts",
       "src/services/catalog.ts",
       "src/resources/references.ts",
       "src/masks.ts"
@@ -427,8 +474,8 @@
   },
   {
     "fixture": "fixtures/size-patterns.ts",
-    "rawBytes": 42320,
-    "gzipBytes": 12606,
+    "rawBytes": 43359,
+    "gzipBytes": 12991,
     "budgetBytes": 13312,
     "included": [
       "src/changes/mutation.ts",
@@ -438,12 +485,12 @@
       "src/math/vec2.ts",
       "src/math/matrix.ts",
       "src/core/destruction.ts",
+      "src/mixins/parent-internals.ts",
       "src/core/attribute-validation.ts",
       "src/changes/types.ts",
       "src/core/node.ts",
       "src/core/mix.ts",
       "src/math/bbox.ts",
-      "src/mixins/parent-internals.ts",
       "src/mixins/parent.ts",
       "src/mixins/creatable.ts",
       "src/mixins/styleable.ts",
@@ -464,6 +511,7 @@
       "src/resources/content.ts",
       "src/resources/validation.ts",
       "src/elements/pattern.ts",
+      "src/services/element-key.ts",
       "src/services/catalog.ts",
       "src/patterns.ts"
     ],

package/reports/size.json

@@ -1,8 +1,8 @@
 {
   "fixture": "fixtures/size.ts",
-  "rawBytes": 65967,
-  "gzipBytes": 19758,
-  "budgetBytes": 20480,
+  "rawBytes": 68399,
+  "gzipBytes": 20540,
+  "budgetBytes": 20992,
   "included": [
     "src/changes/mutation.ts",
     "src/dom/attributes.ts",
@@ -11,6 +11,7 @@
     "src/math/vec2.ts",
     "src/math/matrix.ts",
     "src/core/destruction.ts",
+    "src/mixins/parent-internals.ts",
     "src/core/attribute-validation.ts",
     "src/changes/types.ts",
     "src/core/node.ts",
@@ -28,7 +29,6 @@
     "src/mixins/sizing-internals.ts",
     "src/mixins/sizable.ts",
     "src/core/shape.ts",
-    "src/mixins/parent-internals.ts",
     "src/mixins/parent.ts",
     "src/mixins/creatable.ts",
     "src/elements/group.ts",
@@ -38,6 +38,8 @@
     "src/services/bounds.ts",
     "src/services/defs-manager.ts",
     "src/core/native-validation.ts",
+    "src/services/element-key.ts",
+    "src/services/initialization.ts",
     "src/services/registry.ts",
     "src/services/scheduler.ts",
     "src/changes/service.ts",