@rasamjs/core 0.1.2 → 0.3.0

package/README.md

@@ -9,16 +9,19 @@ Start with the generated [public entry points](API.md) and the
 The [release procedure](RELEASING.md) describes reproducible acceptance checks;
 publishing remains separately authorized.
 
+For class-defined SVG nodes with saved props, live state and undoable actions, see
+the opt-in [`@rasamjs/core/components` guide](COMPONENTS.md).
+
 ## Start
 
 Install dependencies at the repository root, then run the remaining commands in
 this README from `packages/rasam`:
 
 ```sh
-npm ci
+bun install --frozen-lockfile
 cd packages/rasam
-npm run build
-npm run dev
+bun run build
+bun run dev
 ```
 
 Open `http://127.0.0.1:5173/playground/` for the LED demonstration. It includes
@@ -26,7 +29,7 @@ template updates, nested transforms, pointer capture, gradients, a marker, and a
 After building, you can also open `playground/index.html` directly in a browser.
 That route loads the standalone script in `preview/playground.js`; rebuild after
 changing the source. The Vite route loads TypeScript directly for live development.
-For the standalone rectangle example, run `npm run build` and open
+For the standalone rectangle example, run `bun run build` and open
 `http://127.0.0.1:5173/examples/rect.html` while the development server is running.
 
 ```ts
@@ -179,7 +182,7 @@ attributes, including pending writes, and do not resolve inherited or computed C
 
 ## Runnable examples
 
-Run `npm run build` and `npm run dev`, then open an example on the development
+Run `bun run build` and `bun run dev`, then open an example on the development
 server. Each phase example exercises its supported editing and lifecycle behavior.
 
 | Topic                                                             | Page                           | Optional module                                    |
@@ -437,20 +440,50 @@ instance.destroy();
 ```
 
 `Renderer.render(parent, template)` is also available. Each instance owns a host
-group and its mounted nodes. A different template literal identity destroys and
-replaces the prior instance. Compilation is cached by literal identity.
+group and its mounted nodes. A different template literal identity replaces the prior
+instance. Compilation is cached by literal identity.
+
+A hole between elements, or at the top level, renders nested templates. It takes a
+template, an array or other iterable of templates (nested arrays flatten), or `null`,
+`undefined`, a boolean or `''` for nothing, so it can draw lists and conditions:
+
+```ts
+const chip = (pins: number[], on: boolean) => svg`
+  <g>
+    <rect width="40" height="60"/>
+    ${pins.map((y) => svg`<line x1="0" y1="${y}" x2="-10" y2="${y}"/>`)}
+    ${on ? svg`<circle cx="20" cy="30" r="6" fill="lime"/>` : null}
+  </g>`;
+```
+
+On update, an item whose template literal matches the one at the same index updates
+in place; other items are rebuilt. An update validates every binding and builds new
+items off the drawing first, so a failed update changes nothing. Nested items follow
+their container's child rules, such as only `stop` inside a gradient. Removed items and
+replaced templates are disposed so that undo restores them without clearing history.
 
 Static markup is trusted application code. Dynamic primitives become text or
 attribute values, never markup. Whole quoted attribute holes remove the attribute
-for null/undefined; mixed attributes and text use empty segments. Tag names,
-attribute names, and child structure are static. Text holes belong inside `text`
-elements. Dynamic `on*` bindings, dynamic CSS strings, and external URL references
+for null/undefined; mixed attributes and text use empty segments. Tag names and
+attribute names are static. Text holes belong inside `text` elements and take only
+primitives. Dynamic `on*` bindings, dynamic CSS strings, and external URL references
 are rejected. Dynamic URLs are restricted to local `#id` and `url(#id)` references.
 
 Templates initialize shapes from their bindings and keep declared resources inside
 their template-owned containers. Resource IDs may be declared in markup and remain
 immutable after initialization.
 
+A custom class can share a tag with a built-in class. A `Group` subclass with
+`static variant = { attribute: 'data-type', value: 'led' }` registers for
+`<g data-type="led">` only. Creation writes that attribute, it can't change, and other
+classes can't use its value. Once the class is registered in a drawing, adoption,
+import, clone and undo/redo rebuild it instead of a plain group; `registry.resolve(element)`
+returns the class an element would get. `static ownsChildren = true` reserves a
+container's children for its class: outside builders, `add()`, moves, reordering,
+removal and templates throw before changing anything. The class edits them inside
+`this.withOwnChildren(callback)`, and adoption, clone, undo/redo and destroying the
+owner keep working.
+
 Registration is local to each drawing. `SVG()` registers the full built-in catalog;
 `create(Constructor, options)` registers a custom constructor as it creates the node.
 With the lower-level `Svg` constructor, `Elements.register(registry)` can register
@@ -554,26 +587,26 @@ appropriate owner document/browser APIs.
 
 ## Verification
 
-`npm run release:check` runs the complete acceptance pipeline and records source
+`bun run release:check` runs the complete acceptance pipeline and records source
 consistency, individual results and candidate readiness. `release:assess` does not
 run validation. Review public API changes with `api:check` before `api:update`.
 
 ```sh
-npm run typecheck
-npm test
-npm run build
+bun run typecheck
+bun run test
+bun run build
 npx playwright install chromium firefox webkit
-npm run test:browser
-npm run check:consumer
-npm run check:size
-npm run bench
-npm run bench:create
-npm run bench:adopt
-npm run bench:svgjs
-npm run bench:svgjs -- --browser=all
-npm run bench:svgjs -- --browser=chromium --gc --output=reports/svgjs-comparison-gc
+bun run test:browser
+bun run check:consumer
+bun run check:size
+bun run bench
+bun run bench:create
+bun run bench:adopt
+bun run bench:svgjs
+bun run bench:svgjs -- --browser=all
+bun run bench:svgjs -- --browser=chromium --gc --output=reports/svgjs-comparison-gc
 node scripts/profile-svgjs-creation.mjs
-npm run format:check
+bun run format:check
 ```
 
 The packed consumer fixture verifies declarations, public runtime exports, typed
@@ -663,9 +696,88 @@ external subscriptions and application state are not revived. See the
 [history package](../history/README.md) for transactions, limits, conflict handling,
 and the precise supported-state contract.
 
+Neutral groups can carry an undo label without importing history:
+
+```ts
+import { beginChangeGroup } from '@rasamjs/core/changes';
+
+const edit = beginChangeGroup(drawing, { label: 'Add text' });
+edit.run(() => drawing.text({ text: 'Draft' }));
+edit.cancel(); // Restores only this group's edits, then ends it.
+```
+
+`cancel()` records and restores the group's non-temporary changes even when no history
+is attached. Observers receive the restoration, followed by `groupend` with `cancelled`
+and `restored` set to true. Finish the synchronous `run()` callback before cancelling.
+Repeated `end()` or `cancel()` calls after completion do nothing. A conflicting external
+edit leaves the group open and the model unchanged by the rejected cancellation, so the
+application can resolve the conflict and retry. Permanent `destroy()` invalidates active
+groups; further `run()` and `cancel()` calls throw `ChangeConflictError`. Close an invalidated
+group with `end()`. Use `remove()` for reversible work.
+Notification failures are reported after a successful restore and completion; multiple
+failures are retained in an `AggregateError`. `end(true)` alone still performs no rollback.
+
+## Derived model changes
+
+`deriveChanges(drawing, callback)` from `@rasamjs/core/changes` registers a synchronous
+dependent edit before an operation's final snapshot. Its event contains changed nodes
+and current source/group/label/temporary metadata. Callback writes join the same
+operation and group, so one undo step can contain a shape and attached connectors.
+Getter-only calls, no-op writes and restoration do not invoke derivations. Callbacks
+run once in registration order and must not start another attribution scope/group.
+The returned unsubscribe removes the callback; context destruction clears it. Caller
+transactions own failure rollback.
+
+Core reserves `data-rasam-connector-start` and `data-rasam-connector-end` as typed local
+href references so endpoints follow ID remapping through cloning and SVG import/export.
+
+## Document framing and import
+
+```ts
+import { exportSvg, importSvg } from '@rasamjs/core/interchange';
+
+const svg = exportSvg(drawing, { frame: 'content', padding: 16 });
+const nodes = importSvg(drawing, svg, { document: true });
+```
+
+Content framing sets the exported document's `viewBox`, width and height from geometric
+bounds in root coordinates. Padding defaults to zero and must be finite and nonnegative.
+It excludes stroke and marker extents, and throws when content bounds are unavailable.
+An empty drawing uses its numeric document dimensions, with 800 by 600 as the fallback
+for unresolved dimensions. Export does not change the live drawing or camera. Framing
+requires document output; the default export continues to preserve existing dimensions.
+Framing a nested shape carries its omitted ancestors' transforms into the export;
+framing a nested SVG preserves its own viewport inside the exported document.
+Nested viewport percentages retain their original bases when the outer frame changes.
+Use `BBox.union(nodes.map(node => node.bounds('root')))` to union several root-space bounds.
+
+`document: true` imports the children of a single outer SVG, preserving the destination's
+camera and dimensions and discarding root presentation. Use `document: 'presentation'`
+to retain root paint, text styles, opacity, transforms and references in a scoped `<g>`.
+This mode omits the root viewport attributes (`x`, `y`, `width`, `height`, `viewBox`,
+`preserveAspectRatio`) and does not add a group for an envelope with no remaining
+attributes. Existing destination content keeps its presentation; repeated exports and
+imports do not add redundant groups. Both document modes validate the complete passive
+envelope before discarding attributes. They also accept fragments and a full document's prolog: an XML
+declaration, comments and a DOCTYPE without an internal subset, such as the public SVG 1.1
+DOCTYPE that drawing applications write. Internal subsets, entities and later processing
+instructions are still rejected. Malformed XML throws `SyntaxError` containing the parser's first error line.
+Existing passive-content, namespace, resource and URL validation still applies. Without
+the option, importing an SVG creates a nested viewport as before.
+
+`document: 'replace'` requires an empty owning drawing. For a full SVG document it
+also clears configured root presentation (retaining root ID/class and viewport settings),
+so the incoming document owns its paint, styles and compositing. This prevents configured
+root opacity from applying again to restored content. Fragments retain root defaults.
+
+Embedded PNG, JPEG, GIF, WebP, AVIF and SVG data URLs are accepted by `importSvg()`
+on `<image>` elements, allowing exported images to be restored. Other data-URL
+positions and MIME types remain unsupported. Absolute HTTP(S) images, links and Use
+URLs still require `externalUrls: 'http'`. Register the media catalog before importing images.
+
 ## Release status and license
 
-`@rasamjs/core@0.1.1` is published,
+`@rasamjs/core@0.2.0` is published,
 licensed under [MIT](./LICENSE). The name is not reserved by these checks. Recheck the intended registry at the
 time of a separately authorized publication.
 The package remains `private: true` until publication is separately authorized.
@@ -674,3 +786,44 @@ See [CHANGELOG.md](./CHANGELOG.md) and the [public API review](./reports/public-
 `release:check` verifies CI wiring for the configured GitHub remote, `hdevlop/rasam`.
 The [CI workflow](../../.github/workflows/ci.yml) runs the full gate on pushes to `main`
 and pull requests once committed and pushed. See [RELEASING.md](RELEASING.md).
+
+## Raster image export
+
+The optional `@rasamjs/core/raster` entry exports
+`exportImage(root, options): Promise<Blob>` and `RasterOptions`. Importing needs no
+DOM; rendering needs a browser.
+
+```ts
+import { exportImage } from '@rasamjs/core/raster';
+const png = await exportImage(drawing, {
+  type: 'image/png',
+  scale: 2,
+  frame: 'content',
+  padding: 16,
+});
+```
+
+PNG is the default; `image/jpeg` and `image/webp` request the browser's native
+encoder. Unsupported encoders reject clearly instead of returning a different
+format. `frame: 'content'` (default) uses geometric content bounds in drawing units,
+independently of the camera, with zero padding by default. `frame: 'viewBox'` uses
+the current document view and ignores padding. Positive finite scale rounds output
+dimensions up to pixels. No export changes the source model or camera; snapshots
+are taken before asynchronous resource loading. Add padding for strokes, markers
+and filters, which can extend beyond geometric bounds.
+
+`background` accepts a CSS color. PNG/WebP default to transparent; JPEG defaults to
+white. Zero-size content needs positive padding. Output is limited to 32,767 pixels
+per axis and 16,777,216 total pixels; reduce scale for larger documents.
+
+Images must be data URLs or direct same-origin HTTP(S) resources. Resources are
+fetched, validated and embedded, including images inside nested SVG image files.
+Redirects, other protocols, cross-origin resources, corrupt images and cyclic or
+overly nested resources reject. Tainted canvases produce a clear error; temporary
+object URLs are released on success and failure.
+
+**Web fonts are not embedded.** External stylesheets, computed page styles and
+external SVG/CSS references are not embedded either. Rendering uses authored SVG
+attributes and browser SVG-as-image rules; fallback fonts can differ from the live
+editor. See [SVG processing modes](https://www.w3.org/TR/SVG2/conform.html) and
+[canvas encoding rules](https://html.spec.whatwg.org/multipage/canvas.html).

package/RELEASING.md

@@ -1,19 +1,29 @@
 # Release preparation
 
-The source manifest is the `@rasamjs/core@0.1.2` candidate, ESM-only, MIT-licensed and
-kept `private: true` between releases. It has no runtime dependencies. Core 0.1.1 is
-published; 0.1.2 is a patch release with no public API change. It gives replay observers
-the restored sibling order and keeps text reads out of change tracking, so observers that
-measure or edit during structural undo no longer record stray history entries. It pairs
-with the editor candidates `@rasamjs/transformer@0.4.0`, `@rasamjs/selection@0.3.0`,
-`@rasamjs/tools@0.2.0` and the first `@rasamjs/viewport@0.1.0`, whose core peer range
-stays `^0.1.0`. History 0.1.0 is unchanged and needs no republishing. Clipboard stays
-private until its real-Safari check. A published version
+The source manifest is `@rasamjs/core@0.3.0`, ESM-only, MIT-licensed and kept
+`private: true` between releases. It has no runtime dependencies. The 0.3.0 release
+adds class components, named ports, nested templates and the reference-index APIs
+used by connectors 0.2.0. The owner authorized publication on 2026-11-07. Core 0.1.2 was
+published on 2026-11-02 with transformer 0.4.0, selection 0.3.0, tools 0.2.0 and the first
+viewport 0.1.0 in the [editor release](https://github.com/hdevlop/rasam/releases/tag/viewport-v0.1.0);
+it gives replay observers the restored sibling order and keeps text reads out of change
+tracking, with no public API change. History 0.1.0 is unchanged. The first
+`@rasamjs/clipboard@0.1.0` followed on 2026-11-02 in the
+[clipboard release](https://github.com/hdevlop/rasam/releases/tag/clipboard-v0.1.0),
+after its real-Safari check, with core peer range `^0.1.0`. A published version
 must never be overwritten. Select subsequent versions from the actual public API
 changes and record migration notes before a later release.
 
 ## Local acceptance gate
 
+Editor Phase 16 performance work keeps transform snapshot/matrix reads outside
+change transactions and releases image resources during disposal. Completed
+metadata probes retain their source until collection, avoiding a second native
+missing-source request. Scoped regression and benchmark evidence is recorded in
+the [integrated performance report](../../apps/playground/reports/editor-performance.md).
+Existing entry budgets, peers and the public API remain unchanged. The editor
+plan's scoped-check policy applies to this work; no publication is authorized.
+
 Install dependencies at the repository root, which holds the only lockfile. The
 root builds rasam, then `@rasamjs/history` and `@rasamjs/transformer`, runs all packages
 for `test`, `test:browser`, `typecheck`, `format` and `format:check`, and runs all release gates
@@ -21,11 +31,11 @@ serially for `release:check`. Run other package scripts from the root with
 `-w @rasamjs/core`, or run them directly inside `packages/rasam`.
 
 ```sh
-npm ci
+bun install --frozen-lockfile
 npx playwright install chromium firefox webkit
-npm run build
-npm run api:check -w @rasamjs/core
-npm run release:check
+bun run build
+bun run --filter @rasamjs/core api:check
+bun run release:check
 ```
 
 The rasam release gate runs checks serially: formatting, coverage freshness, typecheck,
@@ -70,10 +80,10 @@ methods and symbol hooks. Review changed exports, return types,
 declarations and prototype reachability before updating that inventory:
 
 ```sh
-npm run build
-npm run api:check -w @rasamjs/core
+bun run build
+bun run --filter @rasamjs/core api:check
 # After reviewing the actual change:
-npm run api:update -w @rasamjs/core
+bun run --filter @rasamjs/core api:update
 ```
 
 The packed-consumer fixture checks positive and negative type examples, every
@@ -91,7 +101,7 @@ stable-v1 application contract.
 The configured GitHub remote is `hdevlop/rasam`. The
 [CI workflow](../../.github/workflows/ci.yml) runs on pushes to `main` and pull requests.
 It uses Node.js 24, installs locked dependencies and Chromium, Firefox and WebKit,
-runs `npm run release:check` from the root, and uploads
+runs `bun run release:check` from the root, and uploads
 `packages/rasam/reports/release-readiness.json`,
 `packages/history/reports/release-readiness.json`, and
 `packages/transformer/reports/release-readiness.json` even when validation fails.
@@ -115,14 +125,14 @@ validation script removes `private: true`, sends messages, creates a tag, upload
 artifacts or invokes `npm publish`.
 
 The public names are `@rasamjs/core`, `@rasamjs/history`, `@rasamjs/transformer`,
-`@rasamjs/selection`, `@rasamjs/tools` and `@rasamjs/viewport`.
+`@rasamjs/selection`, `@rasamjs/tools`, `@rasamjs/viewport` and `@rasamjs/clipboard`.
 Keep the source manifests guarded for candidate validation. After authorization,
 extract each validated tarball into an isolated publication directory, remove only
 the manifest's `private` field, and repack it. Verify that every other packed file
 and manifest value matches the validated candidate, then test the exact public
 tarballs together as installed consumers. Record their new integrity values and
 publish new versions in dependency order: rasam, history, transformer, selection,
-tools, viewport. For the current editor candidate, publish core 0.1.2, then transformer
-0.4.0, selection 0.3.0, tools 0.2.0 and viewport 0.1.0. History 0.1.0 stays as published.
-Verify the new registry
+tools, viewport, clipboard. Verify the new registry
 versions and integrity values before publishing the GitHub release.
+
+The optional raster entry has a 12 KiB gzip budget and must stay outside existing bundles. Raster acceptance covers decoded pixels, formats, same-origin/data resources, corrupt images, camera/model preservation and tainted-canvas errors. Browser font/style embedding is not provided.

package/dist/advanced.d.ts

@@ -7,7 +7,7 @@ export { Namespace } from './dom/namespace.js';
 export { DrawingContext } from './services/context.js';
 export { Scheduler } from './services/scheduler.js';
 export { Registry } from './services/registry.js';
-export type { ElementClass } from './services/types.js';
+export type { ElementClass, ElementVariant } from './services/types.js';
 export { BoundsService } from './services/bounds.js';
 export { DefsManager } from './services/defs-manager.js';
 export { Transformable } from './mixins/transformable.js';

package/dist/advanced.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../src/advanced.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../src/advanced.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/catalog/fragment.d.ts

@@ -1,5 +1,5 @@
 import type { AnyNode } from '../core/types.js';
-import type { ElementClass } from '../services/types.js';
+import type { ElementClass, CreationOptions } from '../services/types.js';
 import type { ParentNode } from '../mixins/types.js';
 /** A detached managed forest. Insertion moves its nodes and leaves this reusable value empty. */
 export declare class SvgFragment {
@@ -8,7 +8,7 @@ export declare class SvgFragment {
     get isDestroyed(): boolean;
     get nodes(): readonly AnyNode[];
     add<Node extends AnyNode>(node: Node, index?: number): Node;
-    create<Options, Child extends AnyNode>(Constructor: ElementClass<Options, Child>, options: Options): Child;
+    create<Options, Child extends AnyNode>(Constructor: ElementClass<Options, Child>, options: NoInfer<CreationOptions<Options, Child>>): Child;
     insertInto(parent: ParentNode, index?: number): readonly AnyNode[];
     detachChildren(): readonly AnyNode[];
     clear(): this;

package/dist/catalog/fragment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fragment.d.ts","sourceRoot":"","sources":["../../src/catalog/fragment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,iGAAiG;AACjG,qBAAa,WAAW;;IAEtB,YAAY,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,SAAS,OAAO,EAAO,EAUzD;IACD,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,KAAK,IAAI,SAAS,OAAO,EAAE,CAG9B;IAED,GAAG,CAAC,IAAI,SAAS,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAE1D;IACD,MAAM,CAAC,OAAO,EAAE,KAAK,SAAS,OAAO,EACnC,WAAW,EAAE,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,EACzC,OAAO,EAAE,OAAO,GACf,KAAK,CAEP;IACD,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,SAAyB,GAAG,SAAS,OAAO,EAAE,CAsBjF;IACD,cAAc,IAAI,SAAS,OAAO,EAAE,CAMnC;IACD,KAAK,IAAI,IAAI,CAKZ;IACD,OAAO,IAAI,IAAI,CAEd;IAED,OAAO,CAAC,SAAS;CA2BlB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,SAAS,OAAO,EAAO,GAAG,WAAW,CAEpF"}
+{"version":3,"file":"fragment.d.ts","sourceRoot":"","sources":["../../src/catalog/fragment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,iGAAiG;AACjG,qBAAa,WAAW;;IAEtB,YAAY,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,SAAS,OAAO,EAAO,EAUzD;IACD,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,KAAK,IAAI,SAAS,OAAO,EAAE,CAG9B;IAED,GAAG,CAAC,IAAI,SAAS,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAE1D;IACD,MAAM,CAAC,OAAO,EAAE,KAAK,SAAS,OAAO,EACnC,WAAW,EAAE,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,EACzC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,GAChD,KAAK,CAEP;IACD,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,SAAyB,GAAG,SAAS,OAAO,EAAE,CAsBjF;IACD,cAAc,IAAI,SAAS,OAAO,EAAE,CAMnC;IACD,KAAK,IAAI,IAAI,CAKZ;IACD,OAAO,IAAI,IAAI,CAEd;IAED,OAAO,CAAC,SAAS;CA2BlB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,SAAS,OAAO,EAAO,GAAG,WAAW,CAEpF"}

package/dist/catalog/fragment.js.map

@@ -1 +1 @@
-{"version":3,"file":"fragment.js","sourceRoot":"","sources":["../../src/catalog/fragment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fragment.js","sourceRoot":"","sources":["../../src/catalog/fragment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,iGAAiG;AACjG,MAAM,OAAO,WAAW;IACb,KAAK,CAAQ;IACtB,YAAY,KAAc,EAAE,KAAK,GAAuB,EAAE;QACxD,KAAK,CAAC,UAAU,EAAE,CAAC;QACnB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;IAClE,CAAC;IACD,IAAI,KAAK;QACP,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,GAAG,CAAuB,IAAU,EAAE,KAAc;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,CACJ,WAAyC,EACzC,OAAiD;QAEjD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,UAAU,CAAC,MAAkB,EAAE,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE;YAC7C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO;gBACvC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,QAAQ,GAAc,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAC1C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE;oBAC3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAC/C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IACD,cAAc;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE;YACrD,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAEO,SAAS,CAAC,KAAyB;QACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC;YAChC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5C,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;oBAC1B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBACpE,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI;YACJ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;SAC3C,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC;YACH,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAC1C,EAAE,CAAC;gBACF,IAAI,MAAM;oBAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;;oBAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACrB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,KAAK,GAAuB,EAAE;IACrE,OAAO,IAAI,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/changes/derived.d.ts

@@ -0,0 +1,10 @@
+import type { AnyNode } from '../core/types.js';
+import type { ModelChange } from './types.js';
+/** Marks a class whose children are drawn from its own state, such as a component. */
+export declare const derivesChildren: unique symbol;
+export declare const ownsDerived: (Constructor: unknown) => boolean;
+/** Records the owner's current descendants as derived. The owner redraws them after replay. */
+export declare function markDerived(owner: AnyNode): void;
+/** Replay skips derived nodes and their owners' child lists. */
+export declare const isDerivedChange: (change: ModelChange) => boolean;
+//# sourceMappingURL=derived.d.ts.map

package/dist/changes/derived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived.d.ts","sourceRoot":"","sources":["../../src/changes/derived.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,sFAAsF;AACtF,eAAO,MAAM,eAAe,eAA4B,CAAC;AAGzD,eAAO,MAAM,WAAW,gBAAiB,OAAO,KAAG,OACgC,CAAC;AAEpF,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEhD;AAED,gEAAgE;AAChE,eAAO,MAAM,eAAe,WAAY,WAAW,KAAG,OAEyB,CAAC"}

package/dist/changes/derived.js

@@ -0,0 +1,14 @@
+/** Marks a class whose children are drawn from its own state, such as a component. */
+export const derivesChildren = Symbol('derivesChildren');
+const derived = new WeakSet();
+export const ownsDerived = (Constructor) => !!Constructor?.[derivesChildren];
+/** Records the owner's current descendants as derived. The owner redraws them after replay. */
+export function markDerived(owner) {
+    for (const node of owner.descendants())
+        if (node !== owner)
+            derived.add(node);
+}
+/** Replay skips derived nodes and their owners' child lists. */
+export const isDerivedChange = (change) => derived.has(change.target.node) ||
+    (change.domain === 'children' && ownsDerived(change.target.node.constructor));
+//# sourceMappingURL=derived.js.map

package/dist/changes/derived.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived.js","sourceRoot":"","sources":["../../src/changes/derived.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAW,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAoB,EAAW,EAAE,CAC3D,CAAC,CAAE,WAA2D,EAAE,CAAC,eAAe,CAAC,CAAC;AAEpF,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE;QAAE,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAmB,EAAW,EAAE,CAC9D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IAC/B,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC"}

package/dist/changes/restore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/changes/restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAahD,OAAO,KAAK,EAEV,WAAW,EAIZ,MAAM,YAAY,CAAC;AA6CpB,qFAAqF;AACrF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,IAAI,CAKN"}
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/changes/restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAehD,OAAO,KAAK,EAEV,WAAW,EAIZ,MAAM,YAAY,CAAC;AAqDpB,qFAAqF;AACrF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,IAAI,CAKN"}

package/dist/changes/restore.js

@@ -1,7 +1,9 @@
 import { destroySubtrees } from '../core/destruction.js';
-import { validateChild } from '../mixins/parent-internals.js';
+import { validateChild, withInternalStructure } from '../mixins/parent-internals.js';
 import { readTransformState } from '../mixins/transform-state.js';
 import { referenceValue } from '../services/reference-value.js';
+import { initializeNode } from '../services/initialization.js';
+import { isDerivedChange, ownsDerived } from './derived.js';
 import { captureState, sameState, stateAdapter, combineChanges } from './state.js';
 import { ChangeConflictError, ChangeRollbackError, restoreModelState, validateModelState, } from './types.js';
 function currentValue(snapshot, change) {
@@ -15,6 +17,13 @@ function currentValue(snapshot, change) {
         return snapshot.contributesToBounds;
     return snapshot[change.domain];
 }
+/** An owner's derived child list is redrawn, not restored, so conflicts ignore it. */
+function comparable(value, change) {
+    const snapshot = value;
+    return change.domain === 'existence' && snapshot && ownsDerived(snapshot.constructor)
+        ? { ...snapshot, children: undefined }
+        : value;
+}
 function contentFeatures(content) {
     return {
         parts: content.parts.map((part) => (typeof part === 'string' ? part : part.node)),
@@ -56,7 +65,8 @@ export function restoreChanges(owner, changes, direction) {
 }
 function applyChanges(owner, changes, direction) {
     const service = owner.context.changes;
-    changes = combineChanges(changes);
+    // An owner redraws its derived children after replay, from the state replay restored.
+    changes = combineChanges(changes).filter((change) => !isDerivedChange(change));
     service.resetOrders();
     service.configure(stateAdapter);
     try {
@@ -73,7 +83,8 @@ function applyChanges(owner, changes, direction) {
                 domains.set(change.target, new Set());
             }
             const expected = direction === 'undo' ? change.after : change.before;
-            if (!sameState(currentValue(before.get(change.target), change), expected))
+            const current = currentValue(before.get(change.target), change);
+            if (!sameState(comparable(current, change), comparable(expected, change)))
                 throw new ChangeConflictError(`Conflicting ${change.domain} state on node ${change.target.id}`);
             desired.set(change.target, applyStateChange(desired.get(change.target), change, direction === 'undo' ? change.before : change.after));
             domains
@@ -136,7 +147,7 @@ function validateGraph(owner, states, counts) {
     for (const [target, state] of states) {
         if (!state)
             continue;
-        if (context.registry.get(state.constructor.tag) !== state.constructor)
+        if (context.registry.registered(state.constructor) !== state.constructor)
             throw new ChangeConflictError(`Constructor is not registered: ${state.constructor.tag}`);
         const id = state.properties.id?.value;
         if (id !== undefined &&
@@ -203,7 +214,11 @@ function validateGraph(owner, states, counts) {
         if (counts.get(node) > 0)
             throw new ChangeConflictError('A removed node would retain live typed references');
 }
+/** Replay restores exact prior trees, including children that their class owns. */
 function applyPrepared(owner, states, domains) {
+    withInternalStructure(() => applyStates(owner, states, domains));
+}
+function applyStates(owner, states, domains) {
     const context = owner.context;
     const recreated = new Set();
     // Allocate all nodes before restoring any reference or content edge.
@@ -285,6 +300,7 @@ function applyPrepared(owner, states, domains) {
     // Parent order is authoritative across compound edits and separate edit callbacks.
     for (const [target, state] of states)
         if (state?.children &&
+            !ownsDerived(state.constructor) &&
             (recreated.has(target) ||
                 domains.get(target).has('children') ||
                 domains.get(target).has('existence'))) {
@@ -312,6 +328,8 @@ function applyPrepared(owner, states, domains) {
     const roots = [...retired].filter((node) => !node.parent || !retired.has(node.parent));
     if (roots.length)
         owner[destroySubtrees](roots);
+    for (const target of recreated)
+        initializeNode(target.node);
     context.bounds.invalidate();
 }
 //# sourceMappingURL=restore.js.map