@skenora/runtime 0.1.2

package/README.md

@@ -0,0 +1,92 @@
+# @skenora/runtime
+
+Babylon.js presentation and projection for validated Skenora SceneDocuments.
+
+> This package is not currently published to npm; the install command below is
+> intended release syntax. The procedural V1 sections describe current
+> repository source and are not covered by the 2026-08-28 package/browser
+> evidence.
+
+```bash
+pnpm add @skenora/runtime
+```
+
+Entry points are intentionally separated:
+
+| Import                         | Purpose                                               |
+| ------------------------------ | ----------------------------------------------------- |
+| `@skenora/runtime`             | stable read-only `SceneRenderer` facade               |
+| `@skenora/runtime/projection`  | `RuntimeSession`, capabilities, plugins               |
+| `@skenora/runtime/editor`      | selection, gizmo, drawing, path, and inspection tools |
+| `@skenora/runtime/interaction` | third-person controllers                              |
+| `@skenora/runtime/simulation`  | optional owned WebGPU compute/fullscreen renderer     |
+
+Runtime state is a disposable projection. Persisted changes belong in
+SceneDocument commands, not Babylon nodes. Hosts must dispose sessions and any
+resource scopes they create. Runtime lifecycle additions use `RuntimePlugin`;
+`RuntimeExtension` remains as a compatibility alias. Domain contributions such
+as resource providers, entity projectors, and Flow nodes keep their specialized
+registries.
+
+glTF sidecar buffers and images normally use scoped Blob URLs. In an
+opaque-origin host where the browser creates `blob:null/...` URLs, Runtime
+converts only those dependencies to `data:` URLs so sandboxed directory imports
+remain loadable without network or XHR access. Data URL fallback increases the
+temporary encoded payload, so prefer GLB for large models used in opaque-origin
+hosts.
+
+Owned materials opt in through `creation: { version: 1, family: "pbr" }` and
+explicit entity/slot bindings. Runtime stages textures and surface programs,
+then activates replacements and restores borrowed assignments on unbind. Legacy
+overrides keep their existing path. Material policy limits instances, textures,
+preparation waiting and active parameter animation writers.
+
+The projection entry exports `RUNTIME_MATERIAL_ANIMATIONS_CAPABILITY`. Its
+`play(materialId, animationId, { signal })`, pause/resume/stop/reset and state
+operations address material-local typed tracks. Material and texture animations
+share active render time; material updates and document disposal cancel runs.
+The runtime publishes `runtime.material.preparation`,
+`runtime.material.animation` and `runtime.quality.changed` data events.
+
+Runtime also exposes `getBackendSnapshot()`, `probe()`, and
+`getGpuProgramCacheSnapshot()`. Probe returns healthy only after a real scene
+render and pixel readback. Material programs use a versioned trusted GLSL
+emitter, a bounded Runtime-owned structural cache, and
+`runtime.gpu-program.preparation` reports. The default scene path still runs
+Babylon WebGL.
+
+The separate `./simulation` entry owns a raw WebGPU adapter/device, Canvas
+context, pipelines, two stable storage buffers, fixed-step clock, explicit
+probe readback, resize/reset, device-loss handling, and disposal. It never
+exposes the device and never coexists with Babylon inside one Example load.
+
+```ts
+import { WebGpuSimulationRenderer } from "@skenora/runtime/simulation";
+
+const simulation = await WebGpuSimulationRenderer.create({ canvas, program });
+console.log(simulation.snapshot());
+const probe = await simulation.probe(); // explicit readback only
+simulation.dispose();
+```
+
+This entry is a Renderer Lab capability, not SceneDocument persistence. Hosts
+without WebGPU receive `WebGpuSimulationUnsupportedError` and must use the
+manifest fallback rather than claiming a WebGL compute equivalent.
+
+Bounded gradient, rim and dissolve effects keep shader source internal. Dissolve
+version 1 accepts opaque main-pass cutout only and rejects shadow/depth/glow
+auxiliary passes and runtime transparency/highlight overrides. Availability is
+not shader readiness, and readiness is not visual approval. Bounded lifecycle
+tests, development-package consumption and WebGL2 rendering passed on 2026-08-28.
+This is not a cross-device or arbitrary-asset guarantee.
+
+Procedural geometry and material programs are separate V1 capabilities.
+`procedural` entities compile through `@skenora/procedural` into session-owned
+meshes. An owned PBR `program` is lowered from typed intermediate data to
+trusted internal GLSL with uniform parameters. Capability availability reports
+their current graph and geometry limits. These additions are not covered by
+the 2026-08-28 verification snapshot until a new verification run is
+explicitly authorized and recorded.
+
+See the [repository](https://github.com/zhangjiadi225/skenora); the current
+working-tree guides are `docs/RUNTIME.md` and `docs/PROCEDURAL_AI.md`.

package/dist/core/built-in-runtime-capabilities.d.ts

@@ -0,0 +1,21 @@
+import type { Material } from "@babylonjs/core/Materials/material";
+import type { Node } from "@babylonjs/core/node";
+import type { MaterialRuntimeProperty } from "@skenora/contracts";
+import type { RuntimeNodeEffects } from "../inspection/node-tools.js";
+import type { AnimationController } from "../systems/animation-controller.js";
+import type { CameraPathController } from "../systems/camera-path-controller.js";
+import type { TextureAnimationController } from "../systems/texture-animation-controller.js";
+import type { RuntimeAnimationCapability, RuntimeCameraCapability, RuntimeMaterialCapability, RuntimeNodeCapability, RuntimeParticleCapability, RuntimeTextureAnimationCapability } from "./runtime-capability-registry.js";
+export declare function createRuntimeNodeCapability(resolveNode: (entityId: string) => Node | null, effects: RuntimeNodeEffects): RuntimeNodeCapability;
+export declare function createRuntimeMaterialCapability(getMaterial: (materialId: string) => Material | null, setProperty: (materialId: string, property: MaterialRuntimeProperty, value: unknown) => void): RuntimeMaterialCapability;
+export interface RuntimeCameraCapabilityHandlers {
+    frame(entityIds?: readonly string[]): void;
+    activateEntity(entityId: string, controls?: boolean): boolean;
+    restoreViewport(): void;
+    getPaths(): CameraPathController | null;
+}
+export declare function createRuntimeCameraCapability(handlers: RuntimeCameraCapabilityHandlers): RuntimeCameraCapability;
+export declare function createRuntimeAnimationCapability(animations: AnimationController, nodes: RuntimeNodeCapability): RuntimeAnimationCapability;
+export declare function createRuntimeParticleCapability(setRunning: (entityId: string, running: boolean) => boolean): RuntimeParticleCapability;
+export declare function createRuntimeTextureAnimationCapability(controller: TextureAnimationController): RuntimeTextureAnimationCapability;
+//# sourceMappingURL=built-in-runtime-capabilities.d.ts.map

package/dist/core/built-in-runtime-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-runtime-capabilities.d.ts","sourceRoot":"","sources":["../../src/core/built-in-runtime-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAKnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,EAC9C,OAAO,EAAE,kBAAkB,GAC1B,qBAAqB,CAyEvB;AAED,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,QAAQ,GAAG,IAAI,EACpD,WAAW,EAAE,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,OAAO,KACX,IAAI,GACR,yBAAyB,CAE3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9D,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,IAAI,oBAAoB,GAAG,IAAI,CAAC;CACzC;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,+BAA+B,GACxC,uBAAuB,CAkBzB;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,qBAAqB,GAC3B,0BAA0B,CA6B5B;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,GAC1D,yBAAyB,CAE3B;AAED,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,0BAA0B,GACrC,iCAAiC,CAKnC"}

package/dist/core/built-in-runtime-capabilities.js

@@ -0,0 +1,175 @@
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import { Quaternion } from "@babylonjs/core/Maths/math.vector";
+import { isTransformNode, readAuthoredGroupState, setNodeEnabled, setNodeVisible, } from "../projection/model-importer.js";
+export function createRuntimeNodeCapability(resolveNode, effects) {
+    const requireNode = (entityId) => {
+        const node = resolveNode(entityId);
+        if (!node)
+            throw new Error(`Entity not found: ${entityId}`);
+        return node;
+    };
+    return {
+        get: resolveNode,
+        require: requireNode,
+        getState: (entityId) => {
+            const node = resolveNode(entityId);
+            if (!node)
+                return null;
+            const transform = isTransformNode(node)
+                ? {
+                    position: toVectorValue(node.position),
+                    rotation: toVectorValue(node.rotation),
+                    scaling: toVectorValue(node.scaling),
+                    ...(node.rotationQuaternion
+                        ? {
+                            rotationQuaternion: {
+                                x: node.rotationQuaternion.x,
+                                y: node.rotationQuaternion.y,
+                                z: node.rotationQuaternion.z,
+                                w: node.rotationQuaternion.w,
+                            },
+                        }
+                        : {}),
+                }
+                : undefined;
+            return {
+                id: entityId,
+                enabled: readAuthoredGroupState(node)?.enabled ?? node.isEnabled(),
+                visible: readAuthoredGroupState(node)?.visible ??
+                    (isAbstractMesh(node)
+                        ? node.visibility > 0
+                        : node.getChildMeshes(false).some((mesh) => mesh.visibility > 0)),
+                ...(transform ? { transform } : {}),
+            };
+        },
+        setEnabled: (entityId, enabled) => {
+            setNodeEnabled(requireNode(entityId), enabled);
+        },
+        setVisible: (entityId, visible) => {
+            const node = requireNode(entityId);
+            if (readAuthoredGroupState(node)) {
+                setNodeVisible(node, visible);
+                return;
+            }
+            if (isAbstractMesh(node))
+                node.visibility = visible ? 1 : 0;
+            for (const mesh of node.getChildMeshes(false)) {
+                mesh.visibility = visible ? 1 : 0;
+            }
+        },
+        setTransform: (entityId, transform) => {
+            const node = resolveNode(entityId);
+            if (!isTransformNode(node)) {
+                throw new Error(`Transformable entity not found: ${entityId}`);
+            }
+            applyTransformUpdate(node, transform);
+        },
+        setTransparent: (entityId, alpha) => {
+            const node = requireNode(entityId);
+            if (alpha === null)
+                effects.clearTransparent(node);
+            else
+                effects.setTransparent(node, alpha);
+        },
+        setOutline: (entityId, color) => {
+            const node = requireNode(entityId);
+            if (color === null)
+                effects.clearOutline(node);
+            else
+                effects.setOutline(node, Color3.FromHexString(color));
+        },
+    };
+}
+export function createRuntimeMaterialCapability(getMaterial, setProperty) {
+    return { get: getMaterial, setProperty };
+}
+export function createRuntimeCameraCapability(handlers) {
+    const requirePaths = () => {
+        const paths = handlers.getPaths();
+        if (!paths)
+            throw new Error("Camera path controller is not ready");
+        return paths;
+    };
+    return {
+        frame: (entityIds) => handlers.frame(entityIds),
+        activateEntity: (entityId, controls) => handlers.activateEntity(entityId, controls),
+        restoreViewport: () => handlers.restoreViewport(),
+        playPath: (pathId, options) => requirePaths().play(pathId, options),
+        pausePath: () => requirePaths().pause(),
+        resumePath: () => requirePaths().resume(),
+        stopPath: () => requirePaths().stop(),
+        getPathState: () => requirePaths().state,
+        subscribePath: (listener) => requirePaths().subscribe(listener),
+    };
+}
+export function createRuntimeAnimationCapability(animations, nodes) {
+    return {
+        play: (entityId, animation, observer = {}) => {
+            const root = nodes.require(entityId);
+            const groups = animations
+                .list(root)
+                .filter((group) => !animation || group.name === animation);
+            if (animation && groups.length === 0) {
+                throw new Error(`Animation not found for entity ${entityId}: ${animation}`);
+            }
+            for (const group of groups) {
+                observer.started?.(group.name);
+                group.onAnimationGroupEndObservable.addOnce(() => observer.completed?.(group.name));
+                group.start(false);
+            }
+            return groups.map((group) => group.name);
+        },
+        stop: (entityId, animation) => {
+            const root = nodes.require(entityId);
+            animations.stop({
+                root,
+                ...(animation ? { name: animation } : {}),
+            });
+        },
+    };
+}
+export function createRuntimeParticleCapability(setRunning) {
+    return { setRunning };
+}
+export function createRuntimeTextureAnimationCapability(controller) {
+    return {
+        play: (animationId, options) => controller.play(animationId, options),
+        stop: (animationId) => controller.stop(animationId),
+    };
+}
+function applyTransformUpdate(node, update) {
+    assignVector(node.position, update.position, "position");
+    assignVector(node.scaling, update.scaling, "scaling");
+    if (update.rotation) {
+        node.rotationQuaternion = null;
+        assignVector(node.rotation, update.rotation, "rotation");
+    }
+    if (update.rotationQuaternion === null) {
+        node.rotationQuaternion = null;
+    }
+    else if (update.rotationQuaternion) {
+        const current = node.rotationQuaternion ?? Quaternion.Identity();
+        node.rotationQuaternion = new Quaternion(finiteOrCurrent(update.rotationQuaternion.x, current.x, "quaternion.x"), finiteOrCurrent(update.rotationQuaternion.y, current.y, "quaternion.y"), finiteOrCurrent(update.rotationQuaternion.z, current.z, "quaternion.z"), finiteOrCurrent(update.rotationQuaternion.w, current.w, "quaternion.w"));
+    }
+}
+function assignVector(target, update, label) {
+    if (!update)
+        return;
+    target.x = finiteOrCurrent(update.x, target.x, `${label}.x`);
+    target.y = finiteOrCurrent(update.y, target.y, `${label}.y`);
+    target.z = finiteOrCurrent(update.z, target.z, `${label}.z`);
+}
+function finiteOrCurrent(value, current, label) {
+    if (value === undefined)
+        return current;
+    if (!Number.isFinite(value))
+        throw new Error(`${label} must be finite`);
+    return value;
+}
+function isAbstractMesh(node) {
+    return "visibility" in node && "getBoundingInfo" in node;
+}
+function toVectorValue(value) {
+    return { x: value.x, y: value.y, z: value.z };
+}
+//# sourceMappingURL=built-in-runtime-capabilities.js.map

package/dist/core/built-in-runtime-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-runtime-capabilities.js","sourceRoot":"","sources":["../../src/core/built-in-runtime-capabilities.ts"],"names":[],"mappings":"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"}

package/dist/core/runtime-capability-registry.d.ts

@@ -0,0 +1,90 @@
+import type { Material } from "@babylonjs/core/Materials/material";
+import type { Node } from "@babylonjs/core/node";
+import type { MaterialRuntimeProperty, MaterialAnimationPlayOptions, MaterialAnimationResult, MaterialAnimationState, TransformUpdate } from "@skenora/contracts";
+import type { CameraPathPlaybackOptions, CameraPathPlaybackState } from "../systems/camera-path-controller.js";
+export declare const RUNTIME_NODES_CAPABILITY = "runtime.nodes";
+export declare const RUNTIME_MATERIALS_CAPABILITY = "runtime.materials";
+export declare const RUNTIME_MATERIAL_ANIMATIONS_CAPABILITY = "runtime.material-animations";
+export declare const RUNTIME_CAMERA_CAPABILITY = "runtime.camera";
+export declare const RUNTIME_ANIMATIONS_CAPABILITY = "runtime.animations";
+export declare const RUNTIME_PARTICLES_CAPABILITY = "runtime.particles";
+export declare const RUNTIME_TEXTURE_ANIMATIONS_CAPABILITY = "runtime.texture-animations";
+export interface RuntimeEntityState {
+    id: string;
+    enabled: boolean;
+    visible: boolean;
+    transform?: TransformUpdate;
+}
+export interface RuntimeNodeCapability {
+    get(entityId: string): Node | null;
+    require(entityId: string): Node;
+    getState(entityId: string): RuntimeEntityState | null;
+    setEnabled(entityId: string, enabled: boolean): void;
+    setVisible(entityId: string, visible: boolean): void;
+    setTransform(entityId: string, transform: TransformUpdate): void;
+    setTransparent(entityId: string, alpha: number | null): void;
+    setOutline(entityId: string, color: string | null): void;
+}
+export interface RuntimeMaterialCapability {
+    get(materialId: string): Material | null;
+    setProperty(materialId: string, property: MaterialRuntimeProperty, value: unknown): void;
+}
+export interface RuntimeMaterialAnimationCapability {
+    play(materialId: string, animationId: string, options?: MaterialAnimationPlayOptions): Promise<MaterialAnimationResult>;
+    pause(materialId: string, animationId: string): boolean;
+    resume(materialId: string, animationId: string): boolean;
+    stop(materialId: string, animationId: string): void;
+    reset(materialId: string, animationId: string): void;
+    getState(materialId: string, animationId: string): MaterialAnimationState | null;
+}
+export interface RuntimeCameraCapability {
+    frame(entityIds?: readonly string[]): void;
+    activateEntity(entityId: string, controls?: boolean): boolean;
+    restoreViewport(): void;
+    playPath(pathId: string, options?: CameraPathPlaybackOptions): Promise<void>;
+    pausePath(): boolean;
+    resumePath(): boolean;
+    stopPath(): void;
+    getPathState(): CameraPathPlaybackState;
+    subscribePath(listener: (state: CameraPathPlaybackState) => void): () => void;
+}
+export interface RuntimeAnimationObserver {
+    started?(animation: string): void;
+    completed?(animation: string): void;
+}
+export interface RuntimeAnimationCapability {
+    play(entityId: string, animation?: string | null, observer?: RuntimeAnimationObserver): readonly string[];
+    stop(entityId: string, animation?: string | null): void;
+}
+export interface RuntimeParticleCapability {
+    setRunning(entityId: string, running: boolean): boolean;
+}
+export interface RuntimeTextureAnimationCapability {
+    play(animationId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    stop(animationId: string): void;
+}
+/**
+ * Open capability map. Runtime extensions may augment this interface through
+ * TypeScript module augmentation and register their own named capabilities.
+ */
+export interface RuntimeCapabilityMap {
+    [RUNTIME_NODES_CAPABILITY]: RuntimeNodeCapability;
+    [RUNTIME_MATERIALS_CAPABILITY]: RuntimeMaterialCapability;
+    [RUNTIME_MATERIAL_ANIMATIONS_CAPABILITY]: RuntimeMaterialAnimationCapability;
+    [RUNTIME_CAMERA_CAPABILITY]: RuntimeCameraCapability;
+    [RUNTIME_ANIMATIONS_CAPABILITY]: RuntimeAnimationCapability;
+    [RUNTIME_PARTICLES_CAPABILITY]: RuntimeParticleCapability;
+    [RUNTIME_TEXTURE_ANIMATIONS_CAPABILITY]: RuntimeTextureAnimationCapability;
+}
+export declare class RuntimeCapabilityRegistry {
+    #private;
+    register<TKey extends keyof RuntimeCapabilityMap>(id: TKey, capability: RuntimeCapabilityMap[TKey]): () => void;
+    replace<TKey extends keyof RuntimeCapabilityMap>(id: TKey, capability: RuntimeCapabilityMap[TKey]): RuntimeCapabilityMap[TKey] | null;
+    get<TKey extends keyof RuntimeCapabilityMap>(id: TKey): RuntimeCapabilityMap[TKey] | null;
+    require<TKey extends keyof RuntimeCapabilityMap>(id: TKey): RuntimeCapabilityMap[TKey];
+    has(id: keyof RuntimeCapabilityMap): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=runtime-capability-registry.d.ts.map

package/dist/core/runtime-capability-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-capability-registry.d.ts","sourceRoot":"","sources":["../../src/core/runtime-capability-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AACxD,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,sCAAsC,gCACpB,CAAC;AAChC,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAC1D,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,qCAAqC,+BACpB,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IACtD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACrD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IACjE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IACzC,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,OAAO,GACb,IAAI,CAAC;CACT;AAED,MAAM,WAAW,kCAAkC;IACjD,IAAI,CACF,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACxD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,sBAAsB,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9D,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,SAAS,IAAI,OAAO,CAAC;IACrB,UAAU,IAAI,OAAO,CAAC;IACtB,QAAQ,IAAI,IAAI,CAAC;IACjB,YAAY,IAAI,uBAAuB,CAAC;IACxC,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/E;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,SAAS,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CACzD;AAED,MAAM,WAAW,iCAAiC;IAChD,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,wBAAwB,CAAC,EAAE,qBAAqB,CAAC;IAClD,CAAC,4BAA4B,CAAC,EAAE,yBAAyB,CAAC;IAC1D,CAAC,sCAAsC,CAAC,EAAE,kCAAkC,CAAC;IAC7E,CAAC,yBAAyB,CAAC,EAAE,uBAAuB,CAAC;IACrD,CAAC,6BAA6B,CAAC,EAAE,0BAA0B,CAAC;IAC5D,CAAC,4BAA4B,CAAC,EAAE,yBAAyB,CAAC;IAC1D,CAAC,qCAAqC,CAAC,EAAE,iCAAiC,CAAC;CAC5E;AAED,qBAAa,yBAAyB;;IAGpC,QAAQ,CAAC,IAAI,SAAS,MAAM,oBAAoB,EAC9C,EAAE,EAAE,IAAI,EACR,UAAU,EAAE,oBAAoB,CAAC,IAAI,CAAC,GACrC,MAAM,IAAI;IAYb,OAAO,CAAC,IAAI,SAAS,MAAM,oBAAoB,EAC7C,EAAE,EAAE,IAAI,EACR,UAAU,EAAE,oBAAoB,CAAC,IAAI,CAAC,GACrC,oBAAoB,CAAC,IAAI,CAAC,GAAG,IAAI;IAMpC,GAAG,CAAC,IAAI,SAAS,MAAM,oBAAoB,EACzC,EAAE,EAAE,IAAI,GACP,oBAAoB,CAAC,IAAI,CAAC,GAAG,IAAI;IAMpC,OAAO,CAAC,IAAI,SAAS,MAAM,oBAAoB,EAC7C,EAAE,EAAE,IAAI,GACP,oBAAoB,CAAC,IAAI,CAAC;IAQ7B,GAAG,CAAC,EAAE,EAAE,MAAM,oBAAoB,GAAG,OAAO;IAI5C,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/runtime-capability-registry.js

@@ -0,0 +1,42 @@
+export const RUNTIME_NODES_CAPABILITY = "runtime.nodes";
+export const RUNTIME_MATERIALS_CAPABILITY = "runtime.materials";
+export const RUNTIME_MATERIAL_ANIMATIONS_CAPABILITY = "runtime.material-animations";
+export const RUNTIME_CAMERA_CAPABILITY = "runtime.camera";
+export const RUNTIME_ANIMATIONS_CAPABILITY = "runtime.animations";
+export const RUNTIME_PARTICLES_CAPABILITY = "runtime.particles";
+export const RUNTIME_TEXTURE_ANIMATIONS_CAPABILITY = "runtime.texture-animations";
+export class RuntimeCapabilityRegistry {
+    #entries = new Map();
+    register(id, capability) {
+        if (this.#entries.has(id)) {
+            throw new Error(`Runtime capability is already registered: ${String(id)}`);
+        }
+        this.#entries.set(id, capability);
+        return () => {
+            if (this.#entries.get(id) === capability)
+                this.#entries.delete(id);
+        };
+    }
+    replace(id, capability) {
+        const previous = this.get(id);
+        this.#entries.set(id, capability);
+        return previous;
+    }
+    get(id) {
+        return (this.#entries.get(id) ?? null);
+    }
+    require(id) {
+        const capability = this.get(id);
+        if (!capability) {
+            throw new Error(`Runtime capability is unavailable: ${String(id)}`);
+        }
+        return capability;
+    }
+    has(id) {
+        return this.#entries.has(id);
+    }
+    clear() {
+        this.#entries.clear();
+    }
+}
+//# sourceMappingURL=runtime-capability-registry.js.map

package/dist/core/runtime-capability-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-capability-registry.js","sourceRoot":"","sources":["../../src/core/runtime-capability-registry.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AACxD,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAAC;AAChE,MAAM,CAAC,MAAM,sCAAsC,GACjD,6BAA6B,CAAC;AAChC,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AAC1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAClE,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAAC;AAChE,MAAM,CAAC,MAAM,qCAAqC,GAChD,4BAA4B,CAAC;AA8F/B,MAAM,OAAO,yBAAyB;IAC3B,QAAQ,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEnE,QAAQ,CACN,EAAQ,EACR,UAAsC;QAEtC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,EAAE,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,UAAU;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CACL,EAAQ,EACR,UAAsC;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,GAAG,CACD,EAAQ;QAER,OAAO,CACJ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAA4C,IAAI,IAAI,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,CACL,EAAQ;QAER,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,EAA8B;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/core/runtime-document-coordinator.d.ts

@@ -0,0 +1,28 @@
+import { type SceneDocumentData } from "@skenora/contracts";
+import type { EventPublisher } from "@skenora/events";
+import type { ResourceResolver } from "@skenora/resources";
+import type { RuntimeEventMap } from "./runtime-events.js";
+export interface LoadDocumentOptions {
+    signal?: AbortSignal;
+    /** Strict rolls the complete projection back; best-effort keeps valid models. */
+    modelLoadPolicy?: "strict" | "best-effort";
+}
+export interface RuntimeDocumentProjectionContext {
+    readonly signal?: AbortSignal;
+    readonly modelLoadPolicy: NonNullable<LoadDocumentOptions["modelLoadPolicy"]>;
+    isCurrent(): boolean;
+}
+export type RuntimeDocumentProjector = (document: Readonly<SceneDocumentData>, resources: ResourceResolver, context: RuntimeDocumentProjectionContext) => Promise<boolean>;
+/**
+ * Owns document load generations, validation, lifecycle events, and rollback.
+ * The injected projector owns only Babylon projection details.
+ */
+export declare class RuntimeDocumentCoordinator {
+    #private;
+    constructor(events: EventPublisher<RuntimeEventMap>, resetProjection: () => void, project: RuntimeDocumentProjector, preflight?: (document: Readonly<SceneDocumentData>) => void);
+    /** Advances only after valid input is accepted; invalid replacement leaves it unchanged. */
+    get generation(): number;
+    load(input: Readonly<SceneDocumentData>, resources: ResourceResolver, options?: LoadDocumentOptions): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=runtime-document-coordinator.d.ts.map

package/dist/core/runtime-document-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-document-coordinator.d.ts","sourceRoot":"","sources":["../../src/core/runtime-document-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,eAAe,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CAC5C;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9E,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACrC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,gCAAgC,KACtC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;GAGG;AACH,qBAAa,0BAA0B;;gBAYnC,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,EACvC,eAAe,EAAE,MAAM,IAAI,EAC3B,OAAO,EAAE,wBAAwB,EACjC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,KAAK,IAAI;IAQ7D,4FAA4F;IAC5F,IAAI,UAAU,IAAI,MAAM,CAEvB;IAEK,IAAI,CACR,KAAK,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAClC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC;IA6ChB,OAAO,IAAI,IAAI;CAsEhB"}

package/dist/core/runtime-document-coordinator.js

@@ -0,0 +1,124 @@
+import { assertSceneDocument, normalizeSceneDocument, } from "@skenora/contracts";
+/**
+ * Owns document load generations, validation, lifecycle events, and rollback.
+ * The injected projector owns only Babylon projection details.
+ */
+export class RuntimeDocumentCoordinator {
+    #events;
+    #resetProjection;
+    #project;
+    #preflight;
+    #tail = Promise.resolve();
+    #generation = 0;
+    #active = null;
+    #disposed = false;
+    constructor(events, resetProjection, project, preflight) {
+        this.#events = events;
+        this.#resetProjection = resetProjection;
+        this.#project = project;
+        this.#preflight = preflight;
+    }
+    /** Advances only after valid input is accepted; invalid replacement leaves it unchanged. */
+    get generation() {
+        return this.#generation;
+    }
+    async load(input, resources, options = {}) {
+        this.#assertActive();
+        throwIfAborted(options.signal);
+        let document;
+        try {
+            const normalized = normalizeSceneDocument(structuredClone(input));
+            assertSceneDocument(normalized);
+            this.#preflight?.(normalized);
+            document = normalized;
+        }
+        catch (error) {
+            this.#events.publish("runtime.error", { error, operation: "validateDocument" }, { source: "runtime" });
+            throw error;
+        }
+        const generation = ++this.#generation;
+        this.#active?.abort();
+        const lifetime = new AbortController();
+        this.#active = lifetime;
+        const abort = () => lifetime.abort();
+        options.signal?.addEventListener("abort", abort, { once: true });
+        if (options.signal?.aborted)
+            abort();
+        const operation = this.#tail
+            .catch(() => undefined)
+            .then(() => this.#run(document, resources, { ...options, signal: lifetime.signal }, generation));
+        this.#tail = operation;
+        try {
+            await operation;
+        }
+        finally {
+            options.signal?.removeEventListener("abort", abort);
+            if (this.#active === lifetime)
+                this.#active = null;
+        }
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#generation += 1;
+        this.#active?.abort();
+        this.#active = null;
+    }
+    async #run(document, resources, options, generation) {
+        const isCurrent = () => !this.#disposed && generation === this.#generation;
+        if (!isCurrent())
+            return;
+        this.#events.publish("runtime.loading", { loading: true }, { source: "runtime" });
+        try {
+            throwIfAborted(options.signal);
+            this.#resetProjection();
+            const completed = await this.#project(document, resources, {
+                ...(options.signal ? { signal: options.signal } : {}),
+                modelLoadPolicy: options.modelLoadPolicy ?? "strict",
+                isCurrent,
+            });
+            if (!completed || !isCurrent())
+                return;
+            this.#events.publish("runtime.document.applied", { documentId: document.id }, { source: "runtime" });
+        }
+        catch (error) {
+            if (!isCurrent())
+                return;
+            let failure = error;
+            try {
+                this.#resetProjection();
+            }
+            catch (cleanupError) {
+                failure = new AggregateError([error, cleanupError], "Runtime load failed and projection cleanup was incomplete");
+            }
+            if (isAbortError(error) && failure === error)
+                throw error;
+            this.#events.publish("runtime.error", { error: failure, operation: "loadDocument" }, { source: "runtime" });
+            throw failure;
+        }
+        finally {
+            if (isCurrent()) {
+                this.#events.publish("runtime.loading", { loading: false }, { source: "runtime" });
+            }
+        }
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("RuntimeDocumentCoordinator has been disposed");
+        }
+    }
+}
+function throwIfAborted(signal) {
+    if (!signal?.aborted)
+        return;
+    throw new DOMException("The runtime load was aborted", "AbortError");
+}
+function isAbortError(error) {
+    return ((error instanceof DOMException && error.name === "AbortError") ||
+        (!!error &&
+            typeof error === "object" &&
+            "name" in error &&
+            error.name === "AbortError"));
+}
+//# sourceMappingURL=runtime-document-coordinator.js.map

package/dist/core/runtime-document-coordinator.js.map

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