@vectojs/core 1.40.0 → 1.40.1

package/dist/index.js

@@ -3819,6 +3819,8 @@ var SCENE_OPTION_KEYS = [
   "maxFPS",
   "particleBackend",
   "pointBackend",
+  "projectionAutoDomBudget",
+  "projectionHysteresisFrames",
   "readingDirection",
   "renderer",
   "renderMode",
@@ -5803,6 +5805,15 @@ var Scene = (_class15 = class _Scene {
     while (this.overlayRoot.children.length > 0) {
       this.destroyEntitySubtree(this.overlayRoot.children.at(-1));
     }
+    for (const node of this.domSeenNodes.values()) {
+      for (const backend of this.projectionBackends) backend.unmount(node);
+    }
+    this.domSeenNodes.clear();
+    this.domSeenThisFrame.clear();
+    this.domSeenPrevFrame.clear();
+    this.projectionResolutions.clear();
+    this.projectionHysteresis.clear();
+    this.projectionGesturePins.clear();
     if (typeof window !== "undefined" && !this.disableWindowResize) {
       window.removeEventListener("resize", this.resizeHandler);
     }
@@ -6301,7 +6312,7 @@ var Scene = (_class15 = class _Scene {
   shouldProjectA11y(node) {
     if (!node.interactive) return false;
     if (!(node.width > 0 || node.a11yFullViewport)) return false;
-    if (node.domPolicy === "dom" || this.resolveProjectionFor(node) === "dom") return false;
+    if (this.resolveProjectionFor(node) === "dom") return false;
     switch (node.a11yProjection) {
       case "never":
         return false;
@@ -7754,7 +7765,8 @@ var Scene = (_class15 = class _Scene {
    * the per-frame materialization of scene semantics into pixels through the
    * backend-agnostic `IRenderer` contract. (The `A11yProjection` /
    * `ContentProjection` rows run on the same cadence via {@link Scene.syncA11y}
-   * below; the `DOMProjection` row does not exist yet — RFC2/CTX-0598.)
+   * below; the `DOMProjection` row lives in `@vectojs/dom` and is driven from
+   * the render walk further below.)
    *
    * Main-frame causal order is a correctness contract:
    *

package/dist/index.mjs

@@ -3818,6 +3818,8 @@ var SCENE_OPTION_KEYS = [
   "maxFPS",
   "particleBackend",
   "pointBackend",
+  "projectionAutoDomBudget",
+  "projectionHysteresisFrames",
   "readingDirection",
   "renderer",
   "renderMode",
@@ -5802,6 +5804,15 @@ var Scene = class _Scene {
     while (this.overlayRoot.children.length > 0) {
       this.destroyEntitySubtree(this.overlayRoot.children.at(-1));
     }
+    for (const node of this.domSeenNodes.values()) {
+      for (const backend of this.projectionBackends) backend.unmount(node);
+    }
+    this.domSeenNodes.clear();
+    this.domSeenThisFrame.clear();
+    this.domSeenPrevFrame.clear();
+    this.projectionResolutions.clear();
+    this.projectionHysteresis.clear();
+    this.projectionGesturePins.clear();
     if (typeof window !== "undefined" && !this.disableWindowResize) {
       window.removeEventListener("resize", this.resizeHandler);
     }
@@ -6300,7 +6311,7 @@ var Scene = class _Scene {
   shouldProjectA11y(node) {
     if (!node.interactive) return false;
     if (!(node.width > 0 || node.a11yFullViewport)) return false;
-    if (node.domPolicy === "dom" || this.resolveProjectionFor(node) === "dom") return false;
+    if (this.resolveProjectionFor(node) === "dom") return false;
     switch (node.a11yProjection) {
       case "never":
         return false;
@@ -7753,7 +7764,8 @@ var Scene = class _Scene {
    * the per-frame materialization of scene semantics into pixels through the
    * backend-agnostic `IRenderer` contract. (The `A11yProjection` /
    * `ContentProjection` rows run on the same cadence via {@link Scene.syncA11y}
-   * below; the `DOMProjection` row does not exist yet — RFC2/CTX-0598.)
+   * below; the `DOMProjection` row lives in `@vectojs/dom` and is driven from
+   * the render walk further below.)
    *
    * Main-frame causal order is a correctness contract:
    *

package/dist/tree/Scene.d.ts

@@ -287,7 +287,7 @@ export interface SceneOptions {
  * against. A new option must be added here too — the test suite asserts the two
  * stay in sync.
  */
-export declare const SCENE_OPTION_KEYS: readonly ['a11ySyncInterval', 'autoThrottle', 'contentProjection', 'contentProjectionMargin', 'contentSemanticBudget', 'contentSemanticMargin', 'debugA11y', 'disableWindowResize', 'idleFPS', 'maxDPR', 'maxFPS', 'particleBackend', 'pointBackend', 'readingDirection', 'renderer', 'renderMode', 'respectReducedMotion', 'semanticProjectionPolicy', 'userTiming'];
+export declare const SCENE_OPTION_KEYS: readonly ['a11ySyncInterval', 'autoThrottle', 'contentProjection', 'contentProjectionMargin', 'contentSemanticBudget', 'contentSemanticMargin', 'debugA11y', 'disableWindowResize', 'idleFPS', 'maxDPR', 'maxFPS', 'particleBackend', 'pointBackend', 'projectionAutoDomBudget', 'projectionHysteresisFrames', 'readingDirection', 'renderer', 'renderMode', 'respectReducedMotion', 'semanticProjectionPolicy', 'userTiming'];
 /** Frame-rate the loop is capped to when the OS requests reduced motion. */
 export declare const REDUCED_MOTION_FPS = 30;
 export type { AcceleratorReason, AcceleratorStatus, AcceleratorReport };
@@ -1812,7 +1812,8 @@ export declare class Scene {
      * the per-frame materialization of scene semantics into pixels through the
      * backend-agnostic `IRenderer` contract. (The `A11yProjection` /
      * `ContentProjection` rows run on the same cadence via {@link Scene.syncA11y}
-     * below; the `DOMProjection` row does not exist yet — RFC2/CTX-0598.)
+     * below; the `DOMProjection` row lives in `@vectojs/dom` and is driven from
+     * the render walk further below.)
      *
      * Main-frame causal order is a correctness contract:
      *

package/dist/tree/scene/ProjectionBackend.d.ts

@@ -18,8 +18,8 @@ export type ProjectionBackendKind = 'canvas' | 'dom' | 'a11y' | 'content' | (str
  * mount/update/unmount shape the existing projections already follow so
  * RFC2 (DOM projection), RFC3 (semantic/a11y projection), and RFC4
  * (projection policy) can each name which row they implement or consume.
- * Nothing implements this interface yet — the rows below map each proposed
- * backend onto the code that performs its role today, with the invariant
+ * `@vectojs/dom` implements the `'dom'` row (`DOMProjection`); the rows below
+ * map each backend onto the code that performs its role, with the invariant
  * from RFC1 §2: two projections of the same node must agree on geometry
  * (world matrix), visibility, and lifecycle state, while each keeps its own
  * medium-specific representation.
@@ -29,7 +29,7 @@ export type ProjectionBackendKind = 'canvas' | 'dom' | 'a11y' | 'content' | (str
  * | `CanvasProjection` (`'canvas'`) | the main render pass via `IRenderer` | `Scene.render(renderer)` (`tree/Scene.ts`) → per-entity `Entity.render` (`tree/Entity.ts`) |
  * | `A11yProjection` (`'a11y'`) | `A11yProjectionManager` + `a11yRoot` mirrors | mirror creation in the `Scene.syncA11y` walk (`tree/Scene.ts`); ordering in `A11yProjectionManager` |
  * | `ContentProjection` (`'content'`) | `ContentProjectionManager` + `Entity.getContentProjection` | `Scene.syncContentProjection`, driven on the a11y sync cadence (`tree/Scene.ts`) |
- * | `DOMProjection` (`'dom'`) | **does not exist** — RFC2's work item (CTX-0598) | — (`DOMPortalEntity` is the pilot consumer, not the backend) |
+ * | `DOMProjection` (`'dom'`) | `@vectojs/dom` (`DOMProjection`, driven from the render walk) | `Scene.addProjectionBackend` + walk hook (`tree/Scene.ts`) |
  *
  * Open points deliberately left to RFC2/RFC4 (RFC1 §5): whether `update`
  * receives the full matrix or a decomposed transform, how z-order/layering

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/core",
-  "version": "1.40.0",
+  "version": "1.40.1",
   "publishConfig": {
     "access": "public"
   },