@aura3d/engine 2.0.4 → 3.0.1

package/dist/scripting/VisualScriptingRoot.js

@@ -0,0 +1,150 @@
+/**
+ * muse3jsparity-PRD O2 — root `visualScripting` builder proposal (package side).
+ *
+ * This module owns everything the root builder needs WITHOUT touching
+ * `packages/engine/src/agent-api/index.ts`:
+ *
+ * - `createVisualScriptingGraph(nodes, edges)` — validate + retain a graph.
+ * - `attachVisualScriptingGraph(graph, context)` — execute against a
+ *   deterministic gameplay context (input must visibly change state: the
+ *   caller folds `game.*` side effects into `VisualGameplayState`).
+ * - `serialize`/`deserialize` round-trip with stability proof.
+ * - `applyVisualGameplaySideEffects(state, result)` — the unit-testable
+ *   "graph changes gameplay state" step (browser proof stays a K1 spec).
+ * - `listVisualScriptingNodeCatalog()` — node catalog grouped by category
+ *   with typed-backend evidence per node (O2 docs requirement, code side).
+ *
+ * Root wiring is a re-export hunk in agent-api (reported, not applied):
+ * `export const visualScripting = { graph, attach, catalog, gameplay }`.
+ */
+import { VisualGraphExecutor } from "./VisualGraphExecutor.js";
+import { deserializeGraph, serializeGraph, validateGraph } from "./VisualGraph.js";
+import { createVisualNode, listVisualNodeDefinitions } from "./VisualNodeCatalog.js";
+const GAMEPLAY_SIDE_EFFECT_PREFIXES = ["game.", "ai.", "combat.", "animation.", "camera.", "physics.", "runtime.", "evidence."];
+export function createVisualNodeForGraph(kind, id, data) {
+    return createVisualNode(kind, id, data);
+}
+export function createVisualScriptingGraph(spec) {
+    const graph = { nodes: [...spec.nodes], edges: [...(spec.edges ?? [])] };
+    const errors = validateGraph(graph);
+    if (errors.length > 0)
+        throw new Error(`Invalid visual scripting graph: ${errors.join("; ")}`);
+    return {
+        graph,
+        attach: (context = {}) => attachVisualScriptingGraph(graph, context),
+        roundTrip: () => roundTripVisualScriptingGraph(graph)
+    };
+}
+export function attachVisualScriptingGraph(graph, context = {}) {
+    return new VisualGraphExecutor(context).execute(graph, context);
+}
+export function roundTripVisualScriptingGraph(graph) {
+    const serialized = serializeGraph(graph);
+    const revived = deserializeGraph(JSON.parse(JSON.stringify(serialized)));
+    const reserialized = serializeGraph(revived);
+    return {
+        serialized,
+        stable: JSON.stringify(serialized) === JSON.stringify(reserialized)
+    };
+}
+export function createVisualGameplayState() {
+    return { scores: {}, objectives: {}, machines: {}, timers: {}, events: [] };
+}
+export function applyVisualGameplaySideEffects(state, result) {
+    let applied = 0;
+    for (const effect of result.sideEffects) {
+        const payload = (effect.payload ?? {});
+        switch (effect.kind) {
+            case "game.addScore": {
+                const player = String(payload.playerId ?? "");
+                const points = Number(payload.points ?? 0);
+                if (player.length > 0 && Number.isFinite(points)) {
+                    state.scores[player] = (state.scores[player] ?? 0) + points;
+                    applied += 1;
+                }
+                break;
+            }
+            case "game.setObjective": {
+                const id = String(payload.objectiveId ?? "");
+                const status = String(payload.status ?? "");
+                if (id.length > 0 && (status === "active" || status === "complete" || status === "failed")) {
+                    state.objectives[id] = status;
+                    applied += 1;
+                }
+                break;
+            }
+            case "game.setState": {
+                const id = String(payload.machineId ?? "");
+                const next = String(payload.state ?? "");
+                if (id.length > 0 && next.length > 0) {
+                    state.machines[id] = next;
+                    applied += 1;
+                }
+                break;
+            }
+            case "game.startTimer": {
+                const id = String(payload.timerId ?? "");
+                const duration = Number(payload.duration ?? 0);
+                if (id.length > 0 && Number.isFinite(duration) && duration >= 0) {
+                    state.timers[id] = { elapsed: 0, duration, running: true };
+                    applied += 1;
+                }
+                break;
+            }
+            default: {
+                if (GAMEPLAY_SIDE_EFFECT_PREFIXES.some((prefix) => effect.kind.startsWith(prefix))) {
+                    state.events.push(`${effect.kind}:${String(effect.target ?? effect.nodeId)}`);
+                    applied += 1;
+                }
+                break;
+            }
+        }
+    }
+    return applied;
+}
+/**
+ * Machine-readable node catalog with per-node evidence (O2 docs box, code side).
+ *
+ * Every entry carries its typed-backend evidence paths straight from
+ * `VisualNodeDefinition.oldBranchSource` — a node with no backend path is a
+ * catalog bug, not a silent omission. `docs/api/visual-scripting-catalog.json`
+ * is generated from this function and must never be hand-edited.
+ */
+export function serializeVisualNodeCatalog() {
+    const groups = listVisualScriptingNodeCatalog();
+    return {
+        generatedBy: "packages/scripting/scripts/generate-visual-node-catalog.ts — do not hand-edit; regenerate with pnpm exec tsx packages/scripting/scripts/generate-visual-node-catalog.ts",
+        nodeKindCount: groups.reduce((total, group) => total + group.kinds.length, 0),
+        categories: groups.map((group) => ({
+            category: group.category,
+            kinds: group.kinds.map((definition) => ({
+                kind: definition.kind,
+                category: definition.category,
+                title: definition.title,
+                description: definition.description,
+                inputs: definition.ports
+                    .filter((port) => port.direction === "input")
+                    .map((port) => ({ id: port.id, type: port.type, ...(port.optional === true ? { optional: true } : {}) })),
+                outputs: definition.ports
+                    .filter((port) => port.direction === "output")
+                    .map((port) => ({ id: port.id, type: port.type, ...(port.optional === true ? { optional: true } : {}) })),
+                evidence: [...definition.oldBranchSource]
+            }))
+        }))
+    };
+}
+export function listVisualScriptingNodeCatalog() {
+    const groups = new Map();
+    for (const definition of listVisualNodeDefinitions()) {
+        const group = groups.get(definition.category) ?? [];
+        group.push(definition);
+        groups.set(definition.category, group);
+    }
+    return [...groups.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([category, kinds]) => ({
+        category,
+        kinds: kinds.sort((a, b) => a.kind.localeCompare(b.kind))
+    }));
+}
+//# sourceMappingURL=VisualScriptingRoot.js.map

package/dist/scripting/VisualScriptingRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualScriptingRoot.js","sourceRoot":"","sources":["../../../../packages/scripting/src/VisualScriptingRoot.ts"],"names":[],"mappings":"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"}

package/dist/scripting/index.d.ts

@@ -27,9 +27,11 @@ export { deserializeGraph, serializeGraph, validateGraph } from "./VisualGraph.j
 export type { SerializedVisualGraph, VisualEdge, VisualGraph } from "./VisualGraph.js";
 export { VisualGraphExecutor } from "./VisualGraphExecutor.js";
 export type { VisualExecutionResult } from "./VisualGraphExecutor.js";
-export type { VisualAnimationControllerState, VisualAnimationEvent, VisualCameraState, VisualCollisionEvent, VisualCombatEvent, VisualGraphDiagnostic, VisualGraphExecutionContext, VisualGraphSideEffect, VisualGraphValidationOptions, VisualInputSet, VisualInputSnapshot, VisualOverlapResult, VisualPhysicsBodyState, VisualRaycastHit, VisualRuntimeNodeState, VisualStateCollection, VisualVector3 } from "./VisualGraphContext.js";
+export type { VisualAnimationControllerState, VisualAnimationEvent, VisualCameraState, VisualCollisionEvent, VisualCombatEvent, VisualAiPlanner, VisualAiSnapshot, VisualGameScoreState, VisualGraphDiagnostic, VisualGraphExecutionContext, VisualGraphSideEffect, VisualGraphValidationOptions, VisualObjectiveState, VisualStateMachineState, VisualTimerState, VisualInputSet, VisualInputSnapshot, VisualOverlapResult, VisualPhysicsBodyState, VisualRaycastHit, VisualRuntimeNodeState, VisualStateCollection, VisualVector3 } from "./VisualGraphContext.js";
 export { createVisualNode, getVisualNodeDefinition, listVisualNodeDefinitions } from "./VisualNodeCatalog.js";
 export type { VisualNodeCategory, VisualNodeDefinition } from "./VisualNodeCatalog.js";
+export { applyVisualGameplaySideEffects, attachVisualScriptingGraph, createVisualGameplayState, createVisualNodeForGraph, createVisualScriptingGraph, listVisualScriptingNodeCatalog, roundTripVisualScriptingGraph, serializeVisualNodeCatalog } from "./VisualScriptingRoot.js";
+export type { SerializedVisualNodeCatalog, SerializedVisualNodeCatalogEntry, VisualGameplayState, VisualGameplayTimer, VisualScriptingCatalogGroup, VisualScriptingGraphHandle, VisualScriptingGraphSpec, VisualScriptingRoundTrip } from "./VisualScriptingRoot.js";
 export { animationNodeCategories } from "./AnimationNodeCategories.js";
 export type { AnimationNodeCategory } from "./AnimationNodeCategories.js";
 export { animationVisualNodeDefinitions } from "./AnimationVisualNodes.js";

package/dist/scripting/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,2BAA2B,EAC3B,cAAc,EACd,YAAY,EACZ,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACtG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5C,YAAY,EAAE,sBAAsB,EAAE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpJ,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9K,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxL,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChF,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,YAAY,EACV,8BAA8B,EAC9B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC3G,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/index.ts"],"names":[],"mappings":"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"}

package/dist/scripting/index.js

@@ -13,6 +13,7 @@ export { ScriptContext } from "./ScriptContext.js";
 export { deserializeGraph, serializeGraph, validateGraph } from "./VisualGraph.js";
 export { VisualGraphExecutor } from "./VisualGraphExecutor.js";
 export { createVisualNode, getVisualNodeDefinition, listVisualNodeDefinitions } from "./VisualNodeCatalog.js";
+export { applyVisualGameplaySideEffects, attachVisualScriptingGraph, createVisualGameplayState, createVisualNodeForGraph, createVisualScriptingGraph, listVisualScriptingNodeCatalog, roundTripVisualScriptingGraph, serializeVisualNodeCatalog } from "./VisualScriptingRoot.js";
 export { animationNodeCategories } from "./AnimationNodeCategories.js";
 export { animationVisualNodeDefinitions } from "./AnimationVisualNodes.js";
 export { validateNode } from "./VisualNode.js";

package/dist/scripting/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/scripting/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAShD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAS7E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA+BxL,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAqB5D,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/scripting/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAShD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAS7E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA+BxL,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AA2B5D,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/engine",
-  "version": "2.0.4",
+  "version": "3.0.1",
   "private": false,
   "type": "module",
   "files": [
@@ -26,6 +26,7 @@
     "dist/lean",
     "dist/materials",
     "dist/math",
+    "dist/navigation-recast",
     "dist/physics",
     "dist/physics-rapier",
     "dist/product-studio",
@@ -132,7 +133,7 @@
     "@babylonjs/core": "^7.16.1",
     "@babylonjs/loaders": "^7.16.1",
     "@dimforge/rapier3d-compat": "0.20.0",
-    "@playwright/test": "^1.52.0",
+    "@playwright/test": "1.59.1",
     "@react-three/drei": "10.7.8",
     "@react-three/fiber": "9.7.0",
     "@size-limit/file": "^12.1.0",
@@ -146,7 +147,7 @@
     "draco3d": "^1.5.7",
     "esbuild": "^0.28.0",
     "eslint": "^9.26.0",
-    "meshoptimizer": "^1.1.1",
+    "meshoptimizer": "1.2.0",
     "react": "^19.2.8",
     "react-dom": "19.2.8",
     "size-limit": "^12.1.0",
@@ -156,27 +157,27 @@
     "typescript": "^5.8.3",
     "vite": "^7.3.2",
     "vitest": "^3.1.3",
-    "@aura3d/audio": "2.0.4",
-    "@aura3d/core": "2.0.4",
-    "@aura3d/debug": "2.0.4",
-    "@aura3d/ecs": "2.0.4",
-    "@aura3d/editor": "2.0.4",
-    "@aura3d/input": "2.0.4",
+    "@aura3d/animation": "3.0.1",
+    "@aura3d/apps": "3.0.1",
+    "@aura3d/assets": "3.0.1",
+    "@aura3d/audio": "3.0.1",
+    "@aura3d/cli": "3.0.1",
+    "@aura3d/core": "3.0.1",
+    "@aura3d/debug": "3.0.1",
+    "@aura3d/editor": "3.0.1",
+    "@aura3d/ecs": "3.0.1",
+    "@aura3d/input": "3.0.1",
     "@aura3d/engine-runtime": "2.0.4",
-    "@aura3d/animation": "2.0.4",
-    "@aura3d/apps": "2.0.4",
-    "@aura3d/cli": "2.0.4",
-    "@aura3d/assets": "2.0.4",
-    "@aura3d/math": "2.0.4",
-    "@aura3d/react": "2.0.4",
-    "@aura3d/scene": "2.0.4",
-    "@aura3d/editor-runtime": "2.0.4",
-    "@aura3d/rendering": "2.0.4",
-    "@aura3d/physics": "2.0.4",
-    "create-aura3d": "2.0.4",
-    "@aura3d/scripting": "2.0.4",
-    "@aura3d/product-studio": "2.0.4",
-    "@aura3d/workflows": "2.0.4"
+    "@aura3d/math": "3.0.1",
+    "@aura3d/physics": "3.0.1",
+    "@aura3d/product-studio": "3.0.1",
+    "@aura3d/react": "3.0.1",
+    "@aura3d/rendering": "3.0.1",
+    "@aura3d/scene": "3.0.1",
+    "@aura3d/editor-runtime": "3.0.1",
+    "@aura3d/scripting": "3.0.1",
+    "@aura3d/workflows": "3.0.1",
+    "create-aura3d": "3.0.1"
   },
   "dependencies": {
     "@dimforge/rapier3d-compat": "0.20.0",
@@ -247,7 +248,11 @@
   "publishConfig": {
     "access": "public"
   },
+  "optionalDependencies": {
+    "recast-navigation": "0.43.1"
+  },
   "scripts": {
+    "typecheck:browser:301": "tsc --noEmit -p tsconfig.browser-301.json",
     "premium-indie:reference:brawlhalla-gameplay": "node tools/premium-indie-reference/extract-brawlhalla-gameplay.mjs",
     "premium-indie:reference:ballisticng-gameplay": "node tools/premium-indie-reference/extract-ballisticng-gameplay.mjs",
     "premium-indie:reference:demetrios-pinball": "node tools/premium-indie-reference/extract-demetrios-pinball.mjs",
@@ -633,6 +638,7 @@
     "check:templates:installed": "pnpm build:raw && node tools/release/publish-all.mjs --pack-only && A3D_TEMPLATE_TARBALL_DIR=tests/reports/release-tarballs pnpm exec tsx --tsconfig tsconfig.base.json tools/agent-templates/index.ts",
     "sync:template-asset-manifests": "pnpm exec tsx --tsconfig tsconfig.base.json tools/template-asset-manifest-sync/index.ts",
     "screen:assets": "node tools/asset-screening/screen.mjs",
+    "check:asset-screening": "node tools/asset-screening/gate.mjs",
     "explain:staleness": "node tools/evidence-freshness/explain-staleness.mjs --write",
     "report:replicability": "node tools/replicability-metrics/index.mjs --write",
     "report:replicability:write": "node tools/replicability-metrics/index.mjs --write",
@@ -716,6 +722,7 @@
     "check:bundle-scenarios": "pnpm exec tsx --tsconfig tsconfig.base.json tools/bundle-scenarios/index.ts",
     "check:bundle-size": "pnpm exec tsx --tsconfig tsconfig.base.json tools/bundle-size/index.ts",
     "check:installed-tree-shaking": "pnpm exec tsx --tsconfig tsconfig.base.json tools/installed-tree-shaking/index.ts",
+    "muse3jsparity:release": "pnpm exec tsx --tsconfig tsconfig.base.json tools/muse3jsparity-readiness/index.ts",
     "check:marketing-truth": "pnpm exec tsx --tsconfig tsconfig.base.json tools/marketing-truth/index.ts",
     "check:marketing-preview": "pnpm exec playwright test tests/browser/marketing-preview.spec.ts --reporter=line",
     "check:markdown-2.0": "node tools/markdown-2.0-audit/index.mjs",
@@ -734,7 +741,7 @@
     "audit:external-deployment-smoke": "pnpm exec tsx --tsconfig tsconfig.base.json tools/external-deployment-smoke/index.ts",
     "dogfood:templates": "pnpm run check:templates",
     "dogfood:agent": "pnpm exec tsx --tsconfig tsconfig.base.json tools/agent-dogfood/index.ts",
-    "check:release": "pnpm typecheck && pnpm lint && pnpm check:product-cutover && pnpm check:agent-api && pnpm check:public-api && pnpm check:public-surface-diff && pnpm check:assets-cli && pnpm check:asset-corpus && pnpm check:agent-docs && pnpm check:templates && pnpm check:template-source-audit && pnpm check:examples && pnpm check:devtools && pnpm check:deployment && pnpm check:docs-site && pnpm check:bundle-size && pnpm check:claim-lineage && pnpm check:package-graph && pnpm check:production-path-benchmark && pnpm check:marketing-truth && pnpm check:tarballs && pnpm check:clean-install && pnpm check:templates:installed && pnpm check:packed-migration-consumer && pnpm check:installed-tree-shaking && pnpm check:game-runtime && pnpm check:docs-codeblocks && pnpm check:marketing-links && pnpm check:error-quality && pnpm check:effects-vfx && pnpm check:no-three-runtime",
+    "check:release": "pnpm typecheck && pnpm lint && pnpm check:product-cutover && pnpm check:agent-api && pnpm check:public-api && pnpm check:public-surface-diff && pnpm check:assets-cli && pnpm check:asset-corpus && pnpm check:asset-screening && pnpm check:agent-docs && pnpm check:templates && pnpm check:template-source-audit && pnpm check:examples && pnpm check:devtools && pnpm check:deployment && pnpm check:docs-site && pnpm check:bundle-size && pnpm check:claim-lineage && pnpm check:package-graph && pnpm check:production-path-benchmark && pnpm check:marketing-truth && pnpm check:tarballs && pnpm check:clean-install && pnpm check:templates:installed && pnpm check:packed-migration-consumer && pnpm check:installed-tree-shaking && pnpm check:game-runtime && pnpm check:docs-codeblocks && pnpm check:marketing-links && pnpm check:error-quality && pnpm check:effects-vfx && pnpm check:no-three-runtime",
     "benchmark:scene-kits": "node benchmark/runner/scene-kit-snippet-smoke.mjs",
     "benchmark:contact-sheet": "node benchmark/runner/visual-qa-gates.mjs --mode=smoke --requireHumanReview=false",
     "benchmark:visual-qa": "node benchmark/runner/visual-qa-gates.mjs --mode=acceptance",
@@ -784,6 +791,14 @@
     "remediation:physics-audit": "node tools/product-remediation/build-physics-audit.mjs",
     "remediation:route-disposition": "node tools/product-remediation/build-route-disposition.mjs",
     "check:quality-gates": "node tools/product-remediation/check-quality-gates.mjs",
-    "remediation:reports": "pnpm remediation:inventory && pnpm remediation:parity && pnpm remediation:physics-audit && pnpm remediation:route-disposition && pnpm check:quality-gates"
+    "remediation:reports": "pnpm remediation:inventory && pnpm remediation:parity && pnpm remediation:physics-audit && pnpm remediation:route-disposition && pnpm check:quality-gates",
+    "release:prepare-version": "node tools/release/prepare-version.mjs",
+    "check:release-version": "node tools/release/prepare-version.mjs 3.0.1 --check",
+    "check:templates:exact": "node tools/release/publish-all.mjs --pack-only --from-plan tests/reports/release-tarballs/release-plan.json && A3D_TEMPLATE_TARBALL_DIR=tests/reports/release-tarballs pnpm exec tsx --tsconfig tsconfig.base.json tools/agent-templates/index.ts",
+    "check:patch-compatibility": "pnpm exec tsx --tsconfig tsconfig.base.json tools/public-surface-diff/index.ts --patch301",
+    "test:browser:route-primary:parallel": "tsx --tsconfig tsconfig.base.json tools/showcase-library/run-route-primary-parallel.ts",
+    "release:gallery-index": "node tools/release/build-final-visual-review-index.mjs --version 3.0.1",
+    "release:gallery-manifest": "node tools/release/build-final-visual-review-manifest.mjs --version 3.0.1",
+    "release:l02": "tsx --tsconfig tsconfig.base.json tools/release/l02-producer.ts"
   }
 }

package/templates/cinematic-scene/package.json

@@ -11,10 +11,10 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "2.0.4"
+    "@aura3d/engine": "3.0.1"
   },
   "devDependencies": {
-    "@playwright/test": "^1.52.0",
+    "@playwright/test": "1.59.1",
     "typescript": "^5.8.3",
     "vite": "^7.3.2"
   }

package/templates/cinematic-scene/src/main.ts

@@ -21,7 +21,19 @@ const plan = definePromptPlan({
   ]
 } as const);
 
-createAuraApp("#app", {
-  diagnostics: { overlay: true, assetPanel: true, performancePanel: true },
+const evidenceMode = navigator.webdriver;
+const app = createAuraApp("#app", {
+  autoStart: !evidenceMode,
   scene: promptPlanToScene(plan)
 });
+
+// Browser evidence needs one completed production frame, then a stable GPU.
+// A generated app outside WebDriver keeps the normal continuous render loop.
+if (evidenceMode) {
+  // Keep module evaluation complete while the production renderer loads its
+  // typed-GLB chunk. A top-level await here can deadlock the bundled module
+  // graph because that dynamic chunk imports engine modules from this graph.
+  void app.ready().then(() => app.step(0)).catch((error: unknown) => {
+    document.body.dataset.aura3dError = error instanceof Error ? error.message : String(error);
+  });
+}

package/templates/mini-game/package.json

@@ -11,10 +11,10 @@
     "test": "playwright test tests/route-health.spec.ts tests/playable.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/lean": "2.0.4"
+    "@aura3d/lean": "3.0.1"
   },
   "devDependencies": {
-    "@playwright/test": "^1.52.0",
+    "@playwright/test": "1.59.1",
     "typescript": "^5.8.3",
     "vite": "^7.3.2"
   }

package/templates/product-viewer/package.json

@@ -11,10 +11,10 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/lean": "2.0.4"
+    "@aura3d/lean": "3.0.1"
   },
   "devDependencies": {
-    "@playwright/test": "^1.52.0",
+    "@playwright/test": "1.59.1",
     "typescript": "^5.8.3",
     "vite": "^7.3.2"
   }

package/templates/production-asset-inspector/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "0.1.0-alpha.0"
+    "@aura3d/engine": "3.0.1"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/templates/production-material-studio/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "0.1.0-alpha.0"
+    "@aura3d/engine": "3.0.1"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/templates/production-product-configurator/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "0.1.0-alpha.0"
+    "@aura3d/engine": "3.0.1"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/templates/production-product-viewer/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "0.1.0-alpha.0"
+    "@aura3d/engine": "3.0.1"
   },
   "devDependencies": {
     "typescript": "^5.9.3",