@rasamjs/core 0.2.0 → 0.3.0

package/API.md

@@ -14,9 +14,9 @@ Runtime exports (32):
 
 `BBox`, `Circle`, `ClipPath`, `Defs`, `Ellipse`, `Group`, `Line`, `LinearGradient`, `Marker`, `Matrix`, `Path`, `PathArray`, `PathBuilder`, `PointArray`, `Polygon`, `Polyline`, `RadialGradient`, `Rect`, `Renderer`, `SVG`, `Shape`, `Stop`, `Svg`, `SvgNode`, `SvgTemplate`, `SvgText`, `Use`, `Vec2`, `ViewBox`, `ViewportError`, `attr`, `svg`.
 
-Type-only exports (46):
+Type-only exports (48):
 
-`AnyNode`, `AttributeValue`, `Bounds`, `Box`, `CircleOptions`, `ClipPathOptions`, `CommonAttributes`, `Disposable`, `DrawingPointerEvent`, `EllipseOptions`, `GeometryChange`, `GradientStop`, `Length`, `LineOptions`, `LinearGradientOptions`, `MarkerOptions`, `MatrixDecomposition`, `MatrixValues`, `NestedSvgOptions`, `NodeEvents`, `PaintValue`, `PathAttributes`, `PathCommand`, `PathInput`, `PathOptions`, `PathSegment`, `Point`, `PointInput`, `PointerEventType`, `PolygonOptions`, `PolylineAttributes`, `PolylineOptions`, `RadialGradientOptions`, `RectOptions`, `ResourceReference`, `SVGOptions`, `StyleProperties`, `SvgAttributes`, `SvgOptions`, `TemplateInstance`, `TemplateValue`, `TextAttributes`, `TextMeasurementProvider`, `TextOptions`, `TransformState`, `UseOptions`.
+`AnyNode`, `AttributeValue`, `Bounds`, `Box`, `CircleOptions`, `ClipPathOptions`, `CommonAttributes`, `Disposable`, `DrawingPointerEvent`, `EditRules`, `EllipseOptions`, `GeometryChange`, `GradientStop`, `Length`, `LineOptions`, `LinearGradientOptions`, `MarkerOptions`, `MatrixDecomposition`, `MatrixValues`, `NestedSvgOptions`, `NodeEvents`, `PaintValue`, `PathAttributes`, `PathCommand`, `PathInput`, `PathOptions`, `PathSegment`, `Point`, `PointInput`, `PointerEventType`, `PolygonOptions`, `PolylineAttributes`, `PolylineOptions`, `PortDefinition`, `RadialGradientOptions`, `RectOptions`, `ResourceReference`, `SVGOptions`, `StyleProperties`, `SvgAttributes`, `SvgOptions`, `TemplateInstance`, `TemplateValue`, `TextAttributes`, `TextMeasurementProvider`, `TextOptions`, `TransformState`, `UseOptions`.
 
 ## @rasamjs/core/advanced
 
@@ -24,9 +24,9 @@ Runtime exports (57):
 
 `Attributes`, `BBox`, `BoundsService`, `Circle`, `ClipPath`, `Creatable`, `Defs`, `DefsManager`, `DomFactory`, `DrawingContext`, `Elements`, `Ellipse`, `Emitter`, `Gradient`, `Group`, `Guards`, `Line`, `LinearGradient`, `Marker`, `Matrix`, `Namespace`, `Parent`, `Path`, `PathArray`, `PathBuilder`, `PathGeometry`, `PointArray`, `PointerRouter`, `Polygon`, `Polyline`, `RadialGradient`, `Rect`, `Registry`, `Renderer`, `SVG`, `Scheduler`, `Shape`, `Sizable`, `Stop`, `Styleable`, `Svg`, `SvgNode`, `SvgTag`, `SvgTemplate`, `SvgText`, `Textual`, `Transformable`, `Use`, `Vec2`, `ViewBox`, `ViewportError`, `attr`, `isParent`, `isTextual`, `isTransformable`, `mix`, `svg`.
 
-Type-only exports (52):
+Type-only exports (55):
 
-`AnyNode`, `AttributeValue`, `Bounds`, `Box`, `CircleOptions`, `ClipPathOptions`, `CommonAttributes`, `CreatableFeature`, `Ctor`, `Disposable`, `DrawingPointerEvent`, `ElementClass`, `EllipseOptions`, `GeometryChange`, `GradientStop`, `Length`, `LineOptions`, `LinearGradientOptions`, `MarkerOptions`, `MatrixDecomposition`, `MatrixValues`, `NestedSvgOptions`, `NodeEvents`, `PaintValue`, `ParentFeature`, `ParentNode`, `PathAttributes`, `PathCommand`, `PathInput`, `PathOptions`, `PathSegment`, `Point`, `PointInput`, `PointerEventType`, `PolygonOptions`, `PolylineAttributes`, `PolylineOptions`, `RadialGradientOptions`, `RectOptions`, `ResourceReference`, `SVGOptions`, `SizableFeature`, `StyleProperties`, `SvgAttributes`, `SvgOptions`, `TemplateInstance`, `TemplateValue`, `TextAttributes`, `TextMeasurementProvider`, `TextOptions`, `TransformState`, `UseOptions`.
+`AnyNode`, `AttributeValue`, `Bounds`, `Box`, `CircleOptions`, `ClipPathOptions`, `CommonAttributes`, `CreatableFeature`, `Ctor`, `Disposable`, `DrawingPointerEvent`, `EditRules`, `ElementClass`, `ElementVariant`, `EllipseOptions`, `GeometryChange`, `GradientStop`, `Length`, `LineOptions`, `LinearGradientOptions`, `MarkerOptions`, `MatrixDecomposition`, `MatrixValues`, `NestedSvgOptions`, `NodeEvents`, `PaintValue`, `ParentFeature`, `ParentNode`, `PathAttributes`, `PathCommand`, `PathInput`, `PathOptions`, `PathSegment`, `Point`, `PointInput`, `PointerEventType`, `PolygonOptions`, `PolylineAttributes`, `PolylineOptions`, `PortDefinition`, `RadialGradientOptions`, `RectOptions`, `ResourceReference`, `SVGOptions`, `SizableFeature`, `StyleProperties`, `SvgAttributes`, `SvgOptions`, `TemplateInstance`, `TemplateValue`, `TextAttributes`, `TextMeasurementProvider`, `TextOptions`, `TransformState`, `UseOptions`.
 
 ## @rasamjs/core/animation
 
@@ -58,6 +58,16 @@ Type-only exports (14):
 
 `ChangeBatch`, `ChangeDerivation`, `ChangeEvent`, `ChangeGroup`, `ChangeMetadata`, `ContentState`, `ModelChange`, `ModelFeatures`, `ModelSnapshot`, `NativeNodeState`, `NodeHandle`, `Placement`, `PropertyState`, `TextPolicies`.
 
+## @rasamjs/core/components
+
+Runtime exports (7):
+
+`Component`, `ComponentTypes`, `action`, `component`, `isComponentChild`, `prop`, `state`.
+
+Type-only exports (9):
+
+`ActionDefinition`, `ComponentClass`, `ComponentDefinition`, `ComponentFields`, `ComponentOptions`, `ComponentProps`, `PropDefinition`, `PropOptions`, `PropValue`.
+
 ## @rasamjs/core/data
 
 Runtime exports (5):

package/CHANGELOG.md

@@ -2,6 +2,65 @@
 
 ## Unreleased
 
+## [0.3.0] - 2026-11-07
+
+- Add `DefsManager.consumersOf(target)`, the nodes holding a typed reference to a target,
+  read from the reference index instead of scanning the drawing.
+- Treat connector ends (`data-rasam-connector-start` and `-end`) as links, not
+  resources: exporting or copying a connector no longer copies its targets into
+  `<defs>`, and importing one whose target was left out drops that link instead of
+  throwing.
+- Add component ports: override `ports()` to declare named connection points from
+  props and the saved size, in local coordinates with an optional side. The frozen,
+  validated `portDefinitions` getter is computed again only when saved props change,
+  and core exports the structural `PortDefinition` type that connectors read.
+- Add `actionDefinitions` to components: their `@action` methods with undo labels.
+- Add `resize: 'props'` components and edit rules: the size is saved as built-in
+  `width` and `height` props that `render()` reads through `width()` and `height()`,
+  `size()` changes them as one undo step and redraws at once, and the transformer
+  resizes such a component through `size()` instead of scaling it.
+- Add the `notation: 'si'` prop option, so editors accept and show engineering
+  notation such as `4.7k`, `4k7` or `4.7 kΩ`.
+- Render `@state` changes for every component in one shared frame per drawing, as one
+  temporary change. History now restores a component's props, position and existence
+  but not its rendered children; after undo, redo or a cancelled group the component
+  redraws them from restored props and current live state. Live renders that add or
+  remove nodes no longer make undo fail, recreated instances start from state
+  defaults, and the conflict exception for live-painted holes is removed.
+- Preserve restored props and redo when `created()` writes defaults; the hook still
+  runs on every copy. Isolate internal edits from application `edit()` methods,
+  validate raw props JSON before mutation, and rebuild saved views with extra attrs.
+- Share component change routing per drawing, discover only added subtrees, and cache
+  sibling order between structural edits so moves do not scale with drawing size.
+- Rename the type registry to `ComponentTypes` and infer `create()` option names and
+  value types from public primitive fields. Record delegated 34 KiB catalog, 41 KiB
+  components and 20.5 KiB root gzip caps, with a reproducible component benchmark.
+- Add the opt-in `@rasamjs/core/components` entry: class components, `@component`,
+  `@prop`, `@state`, `@action`, per-drawing type registries, metadata and icons.
+  Preserve classes and props through migration, native adoption, import, clone,
+  clipboard and replay; bind saved children before subsequent updates. Batch live
+  state per frame as temporary changes and reject inherited-member field collisions.
+
+- Compare template bindings with current model values so rendering after undo or
+  cancellation restores attributes and text without replacing element nodes.
+- Add element variants: a class with `static variant` registers for one `data-*`
+  attribute value of its tag, next to the tag's base class. Creation, adoption, import,
+  clone and change replay resolve it, and the identifying value is fixed and reserved.
+  The registry adds `resolve(element)`, `registered(Constructor)` and `variant()`.
+- Templates render nested templates in holes between elements or at the top level:
+  a template, an iterable of templates, or `null`/`undefined`/booleans/`''` for
+  nothing. Items whose literal matches by index update in place; updates validate and
+  build new items off the drawing before changing it. Replacing a template, or removing
+  nested items, now disposes them semantically, so undo restores them and no longer
+  clears history.
+- Add the structural `EditRules` type that editing tools read from `node.editRules`
+  to limit rotation, resizing and flips per node.
+- Add `static ownsChildren` for containers whose class owns its children. Outside
+  structural edits throw before allocating or moving anything; the class edits them
+  through `withOwnChildren()`, and core's adoption, replay and owner destruction pass.
+
+## [0.2.0] - 2026-11-06
+
 - Add `document: 'presentation'` imports to retain scoped root styles and compositing
   while omitting the viewport envelope. Validate document envelopes before unwrapping.
   Add `document: 'replace'` for empty drawings so full-document restoration does not

package/COMPONENTS.md

@@ -0,0 +1,229 @@
+# Class components
+
+Import the opt-in `@rasamjs/core/components` entry. Components are trusted application
+classes extending `Component`, which is a closed `Group`. Position, rotation and scale
+belong to that group; transforming it never calls `render()`.
+
+```ts
+import { SVG, svg } from '@rasamjs/core';
+import {
+  Component,
+  ComponentTypes,
+  component,
+  prop,
+  state,
+  action,
+} from '@rasamjs/core/components';
+
+@component({ type: 'status', name: 'Status', category: 'Indicators', version: 1 })
+class Status extends Component {
+  @prop({ label: 'Caption' }) caption = 'Ready';
+  @prop() active = false;
+  @state() brightness = 1;
+
+  @action('Toggle status')
+  toggle() {
+    this.active = !this.active;
+  }
+
+  override render() {
+    return svg`<circle r="15" fill="${this.active ? 'lime' : 'gray'}" opacity="${this.brightness}"/><text y="35">${this.caption}</text>`;
+  }
+}
+
+const drawing = SVG(document.querySelector<HTMLElement>('#canvas')!, { elements: [Status] });
+const types = new ComponentTypes(drawing, [Status]);
+const status = drawing.create(Status, { caption: 'Connected' });
+status.translate(100, 80);
+status.toggle();
+```
+
+Use standard TypeScript decorators with `useDefineForClassFields` (the default for
+ES2022). Do not enable legacy `experimentalDecorators`. The playground's Vite transform
+handles these decorators. Each concrete type needs its own `@component` decorator.
+Application classes declare no static fields: the decorator supplies core's variant
+registration, and the base class supplies owned-child behavior.
+
+`@prop()` supports strings, finite numbers, booleans and null. Defaults come from field
+initializers. Its options are `label`, `unit`, `min`, `max`, `step`, `options`,
+`type: 'color'` and `notation: 'si'` for property-panel metadata. With `notation: 'si'`,
+editors accept `4.7k`, `4k7` or `100n` and show values as `4.7 kΩ`. Numeric limits and choice lists are checked
+on construction, loading and assignment. Unknown props and fields colliding with
+rasam's inherited members are rejected. Use names such as `active` and `renderedFill`:
+`on` and `fill` already name rasam methods. `propDefinitions` exposes frozen metadata.
+The same validation applies to direct `data-rasam-props` writes, before any model
+or rendered value changes.
+
+`create(Type, options)` infers field names and value types from the concrete class,
+so misspelled keys and wrong value types are TypeScript errors. Standard decorators
+cannot distinguish `@prop` from state, helpers or getters in TypeScript's type system:
+the inferred `ComponentFields<Type>` includes public primitive values. Runtime
+validation still rejects every creation option that is not a decorated prop.
+
+Every changed prop creates one labelled edit. Rendering runs synchronously as a
+derived change in that edit, updating existing template holes. An enclosing core
+change group or `@action('Label')` groups several writes into one undo step. Actions
+must be synchronous. Failed actions roll back saved props and rendered children;
+live state remains outside history. `actionDefinitions` lists an instance's `@action`
+methods as frozen `{ name, label }` entries, inherited ones first; an overriding
+`@action` keeps its place and takes the new label. Editors use it for action buttons. Plain helper fields do not trigger rendering.
+
+`@state()` keeps values in memory. Assignments coalesce into one shared animation
+frame per drawing: every changed instance renders once, together, as one temporary
+`components` change, so a thousand animated instances cost one change event per frame.
+They never create undo steps or dirty the editor's document autosave. Live state may
+change structure too, for example a glow drawn only while `on` is true, or a row of
+pins whose length is a state value.
+
+If one instance's render throws, the others still render and the error surfaces from
+that frame. `resetState()` restores the instance's
+initial state; `types.resetState()` resets its drawing. Object state defaults must be
+structured-cloneable; nested mutations do not trigger a render, so assign a new value.
+
+Subclasses inherit decorated fields, ordinary methods and edit rules, and can add
+fields or override `render()`. Redeclaring an inherited decorated field is rejected.
+`created()` runs synchronously after initialization for every instance, including
+load, clone, paste and history reconstruction. It may initialize props for a brand-new
+instance. On restored instances (`this.adopting`), prop assignments in this hook are
+ignored, including raw props-attribute writes, so saved values and redo remain intact.
+Use the hook for per-instance state and subscriptions; use `migrate` to update saved
+props. `destroyed()` runs on disposal and `changed(name)` for decorated-field changes,
+including replayed prop changes.
+
+Rendered children are derived from props and live state. History restores a
+component's props, position and existence, never its children: right after undo,
+redo or a cancelled group, each restored or recreated component redraws, as one
+temporary change, from its restored props and its current live state. A recreated
+instance starts from its state defaults. So live renders that add or remove nodes
+never break undo, and an outside write to a rendered child lasts only until the next
+render.
+
+`@component` takes a stable lowercase hyphenated `type`, a display `name`, optional
+`category` (default `General`), `version` (default 1), and editing rules. `rotate` is
+`'free'`, `false`, or a positive degree step dividing 360; `flip` defaults to true;
+`resize` defaults to `'scale'` and can be false or `'props'`. The read-only `editRules`
+getter lets the existing transformer and flip commands enforce them without importing
+this entry.
+
+With `resize: 'props'`, a resize changes the component's size instead of scaling it,
+so strokes and text keep their size. The size is saved as built-in `width` and `height`
+props, with defaults from `@component({ resize: 'props', width, height })` (100 when
+left out). Read them in `render()` with `this.width()` and `this.height()`; set them
+with `size(width, height)`, `width(value)`, `height(value)` or `create(Type, { width })`.
+Each change is one undo step and redraws at once. Sizes are at least 1 user unit. The
+transformer resizes such a component through `size()` when it is selected alone; a
+multi-selection that contains one cannot resize. Draw the component inside the box
+from (0, 0) to its width and height, so resize handles follow the pointer exactly.
+
+```ts
+@component({ type: 'panel', name: 'Panel', resize: 'props', width: 150, height: 90 })
+class Panel extends Component {
+  @prop() title = 'Notes';
+  override render() {
+    return svg`<g><rect width="${this.width()}" height="${this.height()}" fill="white" stroke="black"/><text x="10" y="17">${this.title}</text></g>`;
+  }
+}
+```
+
+Multi-selections use the strictest permissions and the smallest rotation step shared
+by all members. The editor's geometry properties follow the same rules. Application
+commands can use `combineEditRules` from `@rasamjs/transformer` before making edits;
+core setters remain available for programmatic transforms.
+
+Outside structural child edits throw before allocating or moving anything. Components
+can themselves be moved, removed, cloned and edited as normal nodes. Compose
+`!isComponentChild(node)` with a selection filter to prevent drilling into their
+rendered children. The editor playground demonstrates that composition.
+`@rasamjs/editor/components` adds editor registration, palette placement tools and a
+properties service built from `@prop` metadata.
+
+## Ports
+
+Ports are named points where links attach, such as the two ends of a resistor or the
+pins of a chip. Override `ports()` to declare them. Like `render()`, it reads `this`:
+use props and, with `resize: 'props'`, the saved size. Points are in the component's
+local coordinates at 0°, so moves, rotations and flips carry them along. The optional
+`side` (`'left'`, `'right'`, `'top'` or `'bottom'`) is the direction a link leaves in.
+
+```ts
+@component({ type: 'chip', name: 'Chip' })
+class Chip extends Component {
+  @prop({ min: 2, max: 16, step: 2 }) pins = 4;
+
+  override ports(): PortDefinition[] {
+    const half = this.pins / 2;
+    return Array.from({ length: this.pins }, (_, index) => ({
+      name: `p${index + 1}`,
+      x: index < half ? 0 : 60,
+      y: 10 + (index % half) * 20,
+      side: index < half ? 'left' : 'right',
+    }));
+  }
+
+  override render() {
+    return svg`<rect width="60" height="${(this.pins / 2) * 20}"/>`;
+  }
+}
+```
+
+`portDefinitions` returns them validated and frozen. It calls `ports()` again only when
+the saved props change, including after undo, redo or a raw props write. Names must be
+unique, non-empty strings, `x` and `y` finite numbers, and `side` one of the four
+names; anything else throws a clear error. Live state never moves a port: reading a
+`@state` field inside `ports()` throws. Subclasses inherit ports and can extend them
+with `super.ports()`. Components have no ports by default. `PortDefinition` comes from
+`@rasamjs/core`, so other packages can read `node.portDefinitions` without importing
+this entry, the way tools read `editRules`. `@rasamjs/connectors` attaches link ends
+to them with `{ target, port }`.
+
+## Save, load and migrate
+
+Saved SVG contains the rendered children and three attributes on the component group:
+
+```xml
+<g data-rasam-component="status" data-rasam-version="1"
+   data-rasam-props='{"caption":"Connected","active":false}'>…</g>
+```
+
+Register constructors through `SVG(..., { elements: [Status] })` before loading, or
+`new ComponentTypes(drawing, [Status])` before import. Core's `parent.create()` also
+registers the constructor for that drawing. Loads, clones, clipboard operations and
+history retain the class. Reconstruction finishes after references and model features
+are copied; the engine then binds matching saved wrappers or replaces the saved tree
+when the template structure changed. Later rendering never appends a second copy.
+Saved hosts or descendants with attributes absent from the template are rebuilt,
+including unmanaged native attributes, so loading cannot retain stale styling.
+
+For a new saved version, provide `migrate(props, oldVersion)` returning props for the
+current version. It is called once on older saved input. Missing props use current
+field defaults. Future versions, missing migrations for old versions, malformed JSON
+and invalid props throw. Migration code should be synchronous and free of external
+side effects. Unknown types remain plain groups with their saved appearance; a
+`ComponentTypes` service reports each unknown type once through `console.warn`.
+
+State fields are absent from saved props. Explicit SVG export includes their current
+appearance, so passive viewers see the current drawing. Loading recomputes the look
+from saved props and fresh state defaults.
+
+## Type registry and icons
+
+`ComponentTypes.register(Type)` registers another type locally. `list(category?)` returns
+sorted frozen definitions; `get(type)` returns the constructor. `icon(type, parent)`
+renders a default instance through the same class into a supplied drawing or group.
+Use a separate small drawing for palette icons. `destroy()` stops the service's
+observer; drawing disposal also cleans it up.
+
+The engine shares one change observer and one derivation callback per drawing.
+Dispatch targets changed components, and type discovery visits only newly added
+subtrees or a node whose type attribute changed. Movement does not scan the drawing.
+
+The Phase 1 demos use primitive template bindings. Core's separately developed
+template-power work controls nested templates and arrays; component definitions
+do not require those features. Filters, embedded HTML and component nesting are not
+part of this phase.
+
+Validate the entry with `bun run check:size:components` (42 KiB gzip cap).
+`bun run api:check`, `bun run check:consumer`
+and `bun run check:docs` also cover the new public entry.
+Use `bun run bench:components` for the 2,000-object/200-move benchmark, or
+`bun run bench:components --revision=07a1160` to reproduce the reviewed version.

package/README.md

@@ -9,6 +9,9 @@ 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
@@ -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
@@ -744,7 +777,7 @@ URLs still require `externalUrls: 'http'`. Register the media catalog before imp
 
 ## Release status and license
 
-`@rasamjs/core@0.1.2` 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.

package/RELEASING.md

@@ -1,7 +1,9 @@
 # Release preparation
 
-The source manifest is `@rasamjs/core@0.1.2`, ESM-only, MIT-licensed and kept
-`private: true` between releases. It has no runtime dependencies. Core 0.1.2 was
+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

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":"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"}

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