@mindees/renderer 0.8.0 → 0.10.0

package/dist/canvas.d.ts

@@ -0,0 +1,53 @@
+import { HostBackend } from "./backend.js";
+
+//#region src/canvas.d.ts
+/** The subset of `CanvasRenderingContext2D` the painter uses (so a WebGPU/mock backend can satisfy it). */
+interface Scene2DContext {
+  fillStyle: string;
+  strokeStyle: string;
+  lineWidth: number;
+  globalAlpha: number;
+  font: string;
+  textBaseline: string;
+  save(): void;
+  restore(): void;
+  clearRect(x: number, y: number, w: number, h: number): void;
+  fillRect(x: number, y: number, w: number, h: number): void;
+  strokeRect(x: number, y: number, w: number, h: number): void;
+  beginPath(): void;
+  moveTo(x: number, y: number): void;
+  lineTo(x: number, y: number): void;
+  arc(x: number, y: number, r: number, start: number, end: number): void;
+  closePath(): void;
+  fill(): void;
+  stroke(): void;
+  fillText(text: string, x: number, y: number): void;
+}
+/** A node in the canvas scene graph. */
+interface SceneNode {
+  type: string;
+  readonly props: Record<string, unknown>;
+  text: string;
+  readonly isTextNode: boolean;
+  parent: SceneNode | null;
+  readonly children: SceneNode[];
+}
+/** A Canvas2D backend: the reconciler builds the scene; `paint(ctx)` rasterizes it. */
+interface Canvas2DBackend extends HostBackend<SceneNode> {
+  /** The scene root (pass to `render(tree, backend, root)`). */
+  readonly root: SceneNode;
+  /** Rasterize the whole scene to `ctx` (clears `[0,0,width,height]` first). */
+  paint(ctx: Scene2DContext, width: number, height: number): void;
+}
+/**
+ * Create a Canvas2D scene backend. Drive it with the reconciler
+ * (`render(scene, backend, backend.root)`), then call `backend.paint(ctx, w, h)` to rasterize — on a
+ * frame loop for animations, or once for static art. `onDirty` fires after any mutation so a host can
+ * schedule a repaint.
+ */
+declare function createCanvas2DBackend(options?: {
+  onDirty?: () => void;
+}): Canvas2DBackend;
+//#endregion
+export { Canvas2DBackend, Scene2DContext, SceneNode, createCanvas2DBackend };
+//# sourceMappingURL=canvas.d.ts.map

package/dist/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","names":[],"sources":["../src/canvas.ts"],"mappings":";;;;UAciB,cAAA;EACf,SAAA;EACA,WAAA;EACA,SAAA;EACA,WAAA;EACA,IAAA;EACA,YAAA;EACA,IAAA;EACA,OAAA;EACA,SAAA,CAAU,CAAA,UAAW,CAAA,UAAW,CAAA,UAAW,CAAA;EAC3C,QAAA,CAAS,CAAA,UAAW,CAAA,UAAW,CAAA,UAAW,CAAA;EAC1C,UAAA,CAAW,CAAA,UAAW,CAAA,UAAW,CAAA,UAAW,CAAA;EAC5C,SAAA;EACA,MAAA,CAAO,CAAA,UAAW,CAAA;EAClB,MAAA,CAAO,CAAA,UAAW,CAAA;EAClB,GAAA,CAAI,CAAA,UAAW,CAAA,UAAW,CAAA,UAAW,KAAA,UAAe,GAAA;EACpD,SAAA;EACA,IAAA;EACA,MAAA;EACA,QAAA,CAAS,IAAA,UAAc,CAAA,UAAW,CAAA;AAAA;;UAInB,SAAA;EACf,IAAA;EAAA,SACS,KAAA,EAAO,MAAA;EAChB,IAAA;EAAA,SACS,UAAA;EACT,MAAA,EAAQ,SAAA;EAAA,SACC,QAAA,EAAU,SAAA;AAAA;;UAIJ,eAAA,SAAwB,WAAA,CAAY,SAAA;EAhBnD;EAAA,SAkBS,IAAA,EAAM,SAAA;EAhBf;EAkBA,KAAA,CAAM,GAAA,EAAK,cAAA,EAAgB,KAAA,UAAe,MAAA;AAAA;;;AAlBC;AAI7C;;;iBAkHgB,qBAAA,CAAsB,OAAA;EAAW,OAAA;AAAA,IAA8B,eAAe"}

package/dist/canvas.js

@@ -0,0 +1,143 @@
+//#region src/canvas.ts
+const num = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
+const str = (v) => typeof v === "string" ? v : void 0;
+function makeNode(type, isTextNode, text = "") {
+	return {
+		type,
+		props: {},
+		text,
+		isTextNode,
+		parent: null,
+		children: []
+	};
+}
+/** Concatenate the immediate text-node children of `node` (how a `canvas-text`'s string content arrives). */
+function textOf(node) {
+	let out = "";
+	for (const c of node.children) if (c.isTextNode) out += c.text;
+	return out;
+}
+/** Draw one scene node (and recurse). Coordinates are absolute (no transform stack in v1). */
+function drawNode(ctx, node) {
+	if (node.isTextNode) return;
+	const p = node.props;
+	const opacity = p.opacity === void 0 ? 1 : num(p.opacity, 1);
+	const needsAlpha = opacity !== 1;
+	if (needsAlpha) {
+		ctx.save();
+		ctx.globalAlpha *= opacity;
+	}
+	const fill = str(p.fill);
+	const stroke = str(p.stroke);
+	const strokeWidth = num(p.strokeWidth, 1);
+	switch (node.type) {
+		case "canvas-rect": {
+			const x = num(p.x);
+			const y = num(p.y);
+			const w = num(p.width);
+			const h = num(p.height);
+			if (fill) {
+				ctx.fillStyle = fill;
+				ctx.fillRect(x, y, w, h);
+			}
+			if (stroke) {
+				ctx.strokeStyle = stroke;
+				ctx.lineWidth = strokeWidth;
+				ctx.strokeRect(x, y, w, h);
+			}
+			break;
+		}
+		case "canvas-circle": {
+			const cx = num(p.x);
+			const cy = num(p.y);
+			const r = num(p.radius);
+			ctx.beginPath();
+			ctx.arc(cx, cy, r, 0, Math.PI * 2);
+			ctx.closePath();
+			if (fill) {
+				ctx.fillStyle = fill;
+				ctx.fill();
+			}
+			if (stroke) {
+				ctx.strokeStyle = stroke;
+				ctx.lineWidth = strokeWidth;
+				ctx.stroke();
+			}
+			break;
+		}
+		case "canvas-line":
+			ctx.beginPath();
+			ctx.moveTo(num(p.x1), num(p.y1));
+			ctx.lineTo(num(p.x2), num(p.y2));
+			ctx.strokeStyle = stroke ?? fill ?? "#000";
+			ctx.lineWidth = strokeWidth;
+			ctx.stroke();
+			break;
+		case "canvas-text": {
+			const content = textOf(node);
+			if (content) {
+				ctx.font = str(p.font) ?? "16px sans-serif";
+				ctx.textBaseline = str(p.baseline) ?? "top";
+				ctx.fillStyle = fill ?? "#000";
+				ctx.fillText(content, num(p.x), num(p.y));
+			}
+			break;
+		}
+		default: break;
+	}
+	for (const child of node.children) drawNode(ctx, child);
+	if (needsAlpha) ctx.restore();
+}
+/**
+* Create a Canvas2D scene backend. Drive it with the reconciler
+* (`render(scene, backend, backend.root)`), then call `backend.paint(ctx, w, h)` to rasterize — on a
+* frame loop for animations, or once for static art. `onDirty` fires after any mutation so a host can
+* schedule a repaint.
+*/
+function createCanvas2DBackend(options = {}) {
+	const root = makeNode("canvas", false);
+	const markDirty = () => options.onDirty?.();
+	return {
+		root,
+		createElement: (type) => makeNode(type, false),
+		createText: (value) => makeNode("#text", true, value),
+		setText(node, value) {
+			node.text = value;
+			markDirty();
+		},
+		setProp(node, key, value) {
+			if (value === void 0) delete node.props[key];
+			else node.props[key] = value;
+			markDirty();
+		},
+		insert(parent, node, anchor) {
+			node.parent = parent;
+			const idx = anchor ? parent.children.indexOf(anchor) : -1;
+			if (idx >= 0) parent.children.splice(idx, 0, node);
+			else parent.children.push(node);
+			markDirty();
+		},
+		remove(parent, node) {
+			const idx = parent.children.indexOf(node);
+			if (idx >= 0) parent.children.splice(idx, 1);
+			node.parent = null;
+			markDirty();
+		},
+		parentOf: (node) => node.parent,
+		nextSibling(node) {
+			const siblings = node.parent?.children;
+			if (!siblings) return null;
+			const idx = siblings.indexOf(node);
+			return idx >= 0 && idx + 1 < siblings.length ? siblings[idx + 1] : null;
+		},
+		isText: (node) => node.isTextNode,
+		paint(ctx, width, height) {
+			ctx.clearRect(0, 0, width, height);
+			for (const child of root.children) drawNode(ctx, child);
+		}
+	};
+}
+//#endregion
+export { createCanvas2DBackend };
+
+//# sourceMappingURL=canvas.js.map

package/dist/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","names":[],"sources":["../src/canvas.ts"],"sourcesContent":["/**\n * The **Helix Canvas strand** (spec §6.2) — a retained-mode 2D scene graph driven by the SAME\n * reconciler as the native/DOM strands, painting to a 2D context. You get Flutter-grade pixel control\n * *exactly where you want it*: a `<canvas-rect>`/`<canvas-text>`/… subtree is built + diffed by Helix,\n * and `paint(ctx)` rasterizes it. The 2D context is an interface ({@link Scene2DContext}) — a real\n * `CanvasRenderingContext2D` satisfies it on web today, and a WebGPU rasterizer can drive the same\n * scene graph later without touching app code.\n *\n * @module\n */\n\nimport type { HostBackend } from './backend'\n\n/** The subset of `CanvasRenderingContext2D` the painter uses (so a WebGPU/mock backend can satisfy it). */\nexport interface Scene2DContext {\n  fillStyle: string\n  strokeStyle: string\n  lineWidth: number\n  globalAlpha: number\n  font: string\n  textBaseline: string\n  save(): void\n  restore(): void\n  clearRect(x: number, y: number, w: number, h: number): void\n  fillRect(x: number, y: number, w: number, h: number): void\n  strokeRect(x: number, y: number, w: number, h: number): void\n  beginPath(): void\n  moveTo(x: number, y: number): void\n  lineTo(x: number, y: number): void\n  arc(x: number, y: number, r: number, start: number, end: number): void\n  closePath(): void\n  fill(): void\n  stroke(): void\n  fillText(text: string, x: number, y: number): void\n}\n\n/** A node in the canvas scene graph. */\nexport interface SceneNode {\n  type: string\n  readonly props: Record<string, unknown>\n  text: string\n  readonly isTextNode: boolean\n  parent: SceneNode | null\n  readonly children: SceneNode[]\n}\n\n/** A Canvas2D backend: the reconciler builds the scene; `paint(ctx)` rasterizes it. */\nexport interface Canvas2DBackend extends HostBackend<SceneNode> {\n  /** The scene root (pass to `render(tree, backend, root)`). */\n  readonly root: SceneNode\n  /** Rasterize the whole scene to `ctx` (clears `[0,0,width,height]` first). */\n  paint(ctx: Scene2DContext, width: number, height: number): void\n}\n\nconst num = (v: unknown, fallback = 0): number =>\n  typeof v === 'number' && Number.isFinite(v) ? v : fallback\nconst str = (v: unknown): string | undefined => (typeof v === 'string' ? v : undefined)\n\nfunction makeNode(type: string, isTextNode: boolean, text = ''): SceneNode {\n  return { type, props: {}, text, isTextNode, parent: null, children: [] }\n}\n\n/** Concatenate the immediate text-node children of `node` (how a `canvas-text`'s string content arrives). */\nfunction textOf(node: SceneNode): string {\n  let out = ''\n  for (const c of node.children) if (c.isTextNode) out += c.text\n  return out\n}\n\n/** Draw one scene node (and recurse). Coordinates are absolute (no transform stack in v1). */\nfunction drawNode(ctx: Scene2DContext, node: SceneNode): void {\n  if (node.isTextNode) return\n  const p = node.props\n  const opacity = p.opacity === undefined ? 1 : num(p.opacity, 1)\n  const needsAlpha = opacity !== 1\n  if (needsAlpha) {\n    ctx.save()\n    ctx.globalAlpha *= opacity\n  }\n  const fill = str(p.fill)\n  const stroke = str(p.stroke)\n  const strokeWidth = num(p.strokeWidth, 1)\n\n  switch (node.type) {\n    case 'canvas-rect': {\n      const x = num(p.x)\n      const y = num(p.y)\n      const w = num(p.width)\n      const h = num(p.height)\n      if (fill) {\n        ctx.fillStyle = fill\n        ctx.fillRect(x, y, w, h)\n      }\n      if (stroke) {\n        ctx.strokeStyle = stroke\n        ctx.lineWidth = strokeWidth\n        ctx.strokeRect(x, y, w, h)\n      }\n      break\n    }\n    case 'canvas-circle': {\n      const cx = num(p.x)\n      const cy = num(p.y)\n      const r = num(p.radius)\n      ctx.beginPath()\n      ctx.arc(cx, cy, r, 0, Math.PI * 2)\n      ctx.closePath()\n      if (fill) {\n        ctx.fillStyle = fill\n        ctx.fill()\n      }\n      if (stroke) {\n        ctx.strokeStyle = stroke\n        ctx.lineWidth = strokeWidth\n        ctx.stroke()\n      }\n      break\n    }\n    case 'canvas-line': {\n      ctx.beginPath()\n      ctx.moveTo(num(p.x1), num(p.y1))\n      ctx.lineTo(num(p.x2), num(p.y2))\n      ctx.strokeStyle = stroke ?? fill ?? '#000'\n      ctx.lineWidth = strokeWidth\n      ctx.stroke()\n      break\n    }\n    case 'canvas-text': {\n      const content = textOf(node)\n      if (content) {\n        ctx.font = str(p.font) ?? '16px sans-serif'\n        ctx.textBaseline = str(p.baseline) ?? 'top'\n        ctx.fillStyle = fill ?? '#000'\n        ctx.fillText(content, num(p.x), num(p.y))\n      }\n      break\n    }\n    // 'canvas' (root) and 'canvas-group' just composite their children.\n    default:\n      break\n  }\n  for (const child of node.children) drawNode(ctx, child)\n  if (needsAlpha) ctx.restore()\n}\n\n/**\n * Create a Canvas2D scene backend. Drive it with the reconciler\n * (`render(scene, backend, backend.root)`), then call `backend.paint(ctx, w, h)` to rasterize — on a\n * frame loop for animations, or once for static art. `onDirty` fires after any mutation so a host can\n * schedule a repaint.\n */\nexport function createCanvas2DBackend(options: { onDirty?: () => void } = {}): Canvas2DBackend {\n  const root = makeNode('canvas', false)\n  const markDirty = (): void => options.onDirty?.()\n\n  return {\n    root,\n    createElement: (type) => makeNode(type, false),\n    createText: (value) => makeNode('#text', true, value),\n    setText(node, value) {\n      node.text = value\n      markDirty()\n    },\n    setProp(node, key, value) {\n      if (value === undefined) delete node.props[key]\n      else node.props[key] = value\n      markDirty()\n    },\n    insert(parent, node, anchor) {\n      node.parent = parent\n      const idx = anchor ? parent.children.indexOf(anchor) : -1\n      if (idx >= 0) parent.children.splice(idx, 0, node)\n      else parent.children.push(node)\n      markDirty()\n    },\n    remove(parent, node) {\n      const idx = parent.children.indexOf(node)\n      if (idx >= 0) parent.children.splice(idx, 1)\n      node.parent = null\n      markDirty()\n    },\n    parentOf: (node) => node.parent,\n    nextSibling(node) {\n      const siblings = node.parent?.children\n      if (!siblings) return null\n      const idx = siblings.indexOf(node)\n      return idx >= 0 && idx + 1 < siblings.length ? (siblings[idx + 1] as SceneNode) : null\n    },\n    isText: (node) => node.isTextNode,\n    paint(ctx, width, height) {\n      ctx.clearRect(0, 0, width, height)\n      for (const child of root.children) drawNode(ctx, child)\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { HostBackend, SerializableBackend, isSerializable } from "./backend.js";
+import { Canvas2DBackend, Scene2DContext, SceneNode, createCanvas2DBackend } from "./canvas.js";
 import { DomDocument, DomElement, DomNode, DomText, createDomBackend, domTagFor } from "./dom.js";
 import { bindKeyedChild } from "./for.js";
 import { HeadlessNode, createHeadlessBackend, createHeadlessRoot, isEventProp } from "./headless.js";
@@ -16,7 +17,7 @@ import { Maturity, NotImplementedError, PackageInfo, notImplemented } from "@min
 /** The npm package name. */
 declare const name = "@mindees/renderer";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-declare const VERSION = "0.8.0";
+declare const VERSION = "0.10.0";
 /**
  * Current maturity. The Helix **web/DOM** renderer (reconciler, DOM backend,
  * headless backend, SSR + hydration) is implemented and tested. Native
@@ -31,5 +32,5 @@ declare const maturity: Maturity;
  */
 declare const info: PackageInfo;
 //#endregion
-export { type CanvasBackend, type CreateNativeAppOptions, type CreateNodeCommand, type CreateTextCommand, type DisposeNodeCommand, type DomDocument, type DomElement, type DomNode, type DomText, type HeadlessNode, type HostBackend, type InsertChildCommand, type Maturity, type Mounted, type NativeApp, type NativeBackend, type NativeCommand, type NativeCommandBackend, type NativeCommandBackendOptions, type NativeCommandNode, NativeHostError, type NativeNodeId, type NativePropValue, NotImplementedError, type PackageInfo, type ReferenceHost, type ReferenceHostNode, type RegisterEventCommand, type RemoveChildCommand, type RemovePropCommand, type SerializableBackend, type SetPropCommand, type UnregisterEventCommand, type UpdateTextCommand, VERSION, bindKeyedChild, bindPortalChild, createCanvasBackend, createDomBackend, createHeadlessBackend, createHeadlessRoot, createNativeApp, createNativeBackend, createNativeCommandBackend, createNativeNodeIdFactory, createReferenceHost, domTagFor, hydrate, info, isEventProp, isNativeCommand, isNativePropValue, isSerializable, maturity, mountNode, name, normalizeNativeProp, notImplemented, render, renderToString };
+export { type Canvas2DBackend, type CanvasBackend, type CreateNativeAppOptions, type CreateNodeCommand, type CreateTextCommand, type DisposeNodeCommand, type DomDocument, type DomElement, type DomNode, type DomText, type HeadlessNode, type HostBackend, type InsertChildCommand, type Maturity, type Mounted, type NativeApp, type NativeBackend, type NativeCommand, type NativeCommandBackend, type NativeCommandBackendOptions, type NativeCommandNode, NativeHostError, type NativeNodeId, type NativePropValue, NotImplementedError, type PackageInfo, type ReferenceHost, type ReferenceHostNode, type RegisterEventCommand, type RemoveChildCommand, type RemovePropCommand, type Scene2DContext, type SceneNode, type SerializableBackend, type SetPropCommand, type UnregisterEventCommand, type UpdateTextCommand, VERSION, bindKeyedChild, bindPortalChild, createCanvas2DBackend, createCanvasBackend, createDomBackend, createHeadlessBackend, createHeadlessRoot, createNativeApp, createNativeBackend, createNativeCommandBackend, createNativeNodeIdFactory, createReferenceHost, domTagFor, hydrate, info, isEventProp, isNativeCommand, isNativePropValue, isSerializable, maturity, mountNode, name, normalizeNativeProp, notImplemented, render, renderToString };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;cAsFa,IAAA;;cAGA,OAAA;;;;;;;cAQA,QAAA,EAAU,QAAyB;;;;;;cAOnC,IAAA,EAAM,WAAiE"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;cA6Fa,IAAA;AAkBuE;AAAA,cAfvE,OAAA;;;;;;;cAQA,QAAA,EAAU,QAAyB;;;;;;cAOnC,IAAA,EAAM,WAAiE"}

package/dist/index.js

@@ -1,4 +1,5 @@
 import { isSerializable } from "./backend.js";
+import { createCanvas2DBackend } from "./canvas.js";
 import { createDomBackend, domTagFor } from "./dom.js";
 import { bindPortalChild } from "./portal.js";
 import { mountNode, render } from "./render.js";
@@ -15,7 +16,7 @@ import { NotImplementedError, notImplemented } from "@mindees/core";
 /** The npm package name. */
 const name = "@mindees/renderer";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-const VERSION = "0.8.0";
+const VERSION = "0.10.0";
 /**
 * Current maturity. The Helix **web/DOM** renderer (reconciler, DOM backend,
 * headless backend, SSR + hydration) is implemented and tested. Native
@@ -34,6 +35,6 @@ const info = Object.freeze({
 	maturity
 });
 //#endregion
-export { NativeHostError, NotImplementedError, VERSION, bindKeyedChild, bindPortalChild, createCanvasBackend, createDomBackend, createHeadlessBackend, createHeadlessRoot, createNativeApp, createNativeBackend, createNativeCommandBackend, createNativeNodeIdFactory, createReferenceHost, domTagFor, hydrate, info, isEventProp, isNativeCommand, isNativePropValue, isSerializable, maturity, mountNode, name, normalizeNativeProp, notImplemented, render, renderToString };
+export { NativeHostError, NotImplementedError, VERSION, bindKeyedChild, bindPortalChild, createCanvas2DBackend, createCanvasBackend, createDomBackend, createHeadlessBackend, createHeadlessRoot, createNativeApp, createNativeBackend, createNativeCommandBackend, createNativeNodeIdFactory, createReferenceHost, domTagFor, hydrate, info, isEventProp, isNativeCommand, isNativePropValue, isSerializable, maturity, mountNode, name, normalizeNativeProp, notImplemented, render, renderToString };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Maturity, PackageInfo } from '@mindees/core'\nimport { NotImplementedError, notImplemented } from '@mindees/core'\n\n/** Host-backend contract + capability detection. */\nexport {\n  type HostBackend,\n  isSerializable,\n  type SerializableBackend,\n} from './backend'\n/** DOM (web) backend. */\nexport {\n  createDomBackend,\n  type DomDocument,\n  type DomElement,\n  type DomNode,\n  type DomText,\n  domTagFor,\n} from './dom'\n/** Keyed list reconciliation (the renderer side of core's KeyedRegion). */\nexport { bindKeyedChild } from './for'\n/** Headless (in-memory) backend — the reference/test target. */\nexport {\n  createHeadlessBackend,\n  createHeadlessRoot,\n  type HeadlessNode,\n  isEventProp,\n} from './headless'\n/**\n * Native backends. `createNativeCommandBackend` is implemented (emits a native\n * command stream); `createNativeBackend`/`createCanvasBackend` are research\n * tracks that throw `NotImplementedError`.\n */\nexport {\n  type CanvasBackend,\n  createCanvasBackend,\n  createNativeBackend,\n  createNativeCommandBackend,\n  type NativeBackend,\n  type NativeCommandBackend,\n  type NativeCommandBackendOptions,\n  type NativeCommandNode,\n} from './native'\n/** One-call native app entry — wires the command backend + host contract. */\nexport {\n  type CreateNativeAppOptions,\n  createNativeApp,\n  type NativeApp,\n} from './native-app'\n/**\n * The strict reference native host — applies a command stream to a model tree and\n * validates it (the executable conformance contract real native hosts implement).\n */\nexport {\n  createReferenceHost,\n  NativeHostError,\n  type ReferenceHost,\n  type ReferenceHostNode,\n} from './native-host'\n/** The native command protocol: command types + serialization-safe helpers. */\nexport {\n  type CreateNodeCommand,\n  type CreateTextCommand,\n  createNativeNodeIdFactory,\n  type DisposeNodeCommand,\n  type InsertChildCommand,\n  isNativeCommand,\n  isNativePropValue,\n  type NativeCommand,\n  type NativeNodeId,\n  type NativePropValue,\n  normalizeNativeProp,\n  type RegisterEventCommand,\n  type RemoveChildCommand,\n  type RemovePropCommand,\n  type SetPropCommand,\n  type UnregisterEventCommand,\n  type UpdateTextCommand,\n} from './native-protocol'\n/** Portal reconciliation (the renderer side of core's PortalRegion). */\nexport { bindPortalChild } from './portal'\n/** The fine-grained reactive reconciler. */\nexport { type Mounted, mountNode, render } from './render'\n/** Server-side rendering + hydration (web). */\nexport { hydrate, renderToString } from './ssr'\n\n/** The npm package name. */\nexport const name = '@mindees/renderer'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.8.0'\n\n/**\n * Current maturity. The Helix **web/DOM** renderer (reconciler, DOM backend,\n * headless backend, SSR + hydration) is implemented and tested. Native\n * (iOS/Android) and the GPU canvas are research tracks (throw\n * `NotImplementedError`). See the repository `STATUS.md`.\n */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n\nexport type { Maturity, PackageInfo }\nexport { NotImplementedError, notImplemented }\n"],"mappings":";;;;;;;;;;;;;;;AAsFA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;;;;;;AAQvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Maturity, PackageInfo } from '@mindees/core'\nimport { NotImplementedError, notImplemented } from '@mindees/core'\n\n/** Host-backend contract + capability detection. */\nexport {\n  type HostBackend,\n  isSerializable,\n  type SerializableBackend,\n} from './backend'\n/** Helix Canvas strand — a 2D scene graph driven by the reconciler, painted to a 2D context (§6.2). */\nexport {\n  type Canvas2DBackend,\n  createCanvas2DBackend,\n  type Scene2DContext,\n  type SceneNode,\n} from './canvas'\n/** DOM (web) backend. */\nexport {\n  createDomBackend,\n  type DomDocument,\n  type DomElement,\n  type DomNode,\n  type DomText,\n  domTagFor,\n} from './dom'\n/** Keyed list reconciliation (the renderer side of core's KeyedRegion). */\nexport { bindKeyedChild } from './for'\n/** Headless (in-memory) backend — the reference/test target. */\nexport {\n  createHeadlessBackend,\n  createHeadlessRoot,\n  type HeadlessNode,\n  isEventProp,\n} from './headless'\n/**\n * Native backends. `createNativeCommandBackend` is implemented (emits a native\n * command stream); `createNativeBackend`/`createCanvasBackend` are research\n * tracks that throw `NotImplementedError`.\n */\nexport {\n  type CanvasBackend,\n  createCanvasBackend,\n  createNativeBackend,\n  createNativeCommandBackend,\n  type NativeBackend,\n  type NativeCommandBackend,\n  type NativeCommandBackendOptions,\n  type NativeCommandNode,\n} from './native'\n/** One-call native app entry — wires the command backend + host contract. */\nexport {\n  type CreateNativeAppOptions,\n  createNativeApp,\n  type NativeApp,\n} from './native-app'\n/**\n * The strict reference native host — applies a command stream to a model tree and\n * validates it (the executable conformance contract real native hosts implement).\n */\nexport {\n  createReferenceHost,\n  NativeHostError,\n  type ReferenceHost,\n  type ReferenceHostNode,\n} from './native-host'\n/** The native command protocol: command types + serialization-safe helpers. */\nexport {\n  type CreateNodeCommand,\n  type CreateTextCommand,\n  createNativeNodeIdFactory,\n  type DisposeNodeCommand,\n  type InsertChildCommand,\n  isNativeCommand,\n  isNativePropValue,\n  type NativeCommand,\n  type NativeNodeId,\n  type NativePropValue,\n  normalizeNativeProp,\n  type RegisterEventCommand,\n  type RemoveChildCommand,\n  type RemovePropCommand,\n  type SetPropCommand,\n  type UnregisterEventCommand,\n  type UpdateTextCommand,\n} from './native-protocol'\n/** Portal reconciliation (the renderer side of core's PortalRegion). */\nexport { bindPortalChild } from './portal'\n/** The fine-grained reactive reconciler. */\nexport { type Mounted, mountNode, render } from './render'\n/** Server-side rendering + hydration (web). */\nexport { hydrate, renderToString } from './ssr'\n\n/** The npm package name. */\nexport const name = '@mindees/renderer'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.10.0'\n\n/**\n * Current maturity. The Helix **web/DOM** renderer (reconciler, DOM backend,\n * headless backend, SSR + hydration) is implemented and tested. Native\n * (iOS/Android) and the GPU canvas are research tracks (throw\n * `NotImplementedError`). See the repository `STATUS.md`.\n */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n\nexport type { Maturity, PackageInfo }\nexport { NotImplementedError, notImplemented }\n"],"mappings":";;;;;;;;;;;;;;;;AA6FA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;;;;;;AAQvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindees/renderer",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "MindeesNative Helix — fine-grained reactive renderer with a web/DOM backend, SSR + hydration, and a headless test backend. Native and GPU-canvas backends are research tracks.",
   "license": "MIT OR Apache-2.0",
   "type": "module",
@@ -23,7 +23,7 @@
     "directory": "packages/renderer"
   },
   "dependencies": {
-    "@mindees/core": "0.8.0"
+    "@mindees/core": "0.10.0"
   },
   "devDependencies": {
     "happy-dom": "20.9.0"