@skenora/runtime 0.1.2

package/dist/presentation/scene-renderer.js

@@ -0,0 +1,324 @@
+import { assertSceneDocument, normalizeSceneDocument, } from "@skenora/contracts";
+import { RuntimeSession, } from "../core/runtime-session.js";
+import { RUNTIME_CAMERA_CAPABILITY } from "../core/runtime-capability-registry.js";
+/**
+ * Read-only presentation facade over RuntimeSession.
+ *
+ * It intentionally does not expose the Babylon scene, nodes, document
+ * projection methods, extensions, or any document capture operation.
+ */
+export class SceneRenderer {
+    #runtime;
+    #statusListeners = new Set();
+    #statusUnsubscribers = new Set();
+    #onStatusListenerError;
+    #modelFailures = [];
+    #viewerControls = {};
+    #captureTail = Promise.resolve();
+    #documentId = null;
+    #status = "idle";
+    #error = null;
+    #loadGeneration = 0;
+    #disposed = false;
+    constructor(canvas, options = {}) {
+        this.#runtime = new RuntimeSession(canvas, {
+            ...(options.antialias === undefined
+                ? {}
+                : { antialias: options.antialias }),
+            ...(options.engineOptions === undefined
+                ? {}
+                : { engineOptions: options.engineOptions }),
+            adaptToDeviceRatio: options.adaptToDeviceRatio ?? true,
+            executionMode: options.executionMode ?? "authoring",
+            ...(options.autoResize === undefined
+                ? {}
+                : { autoResize: options.autoResize }),
+        });
+        this.#onStatusListenerError =
+            options.onStatusListenerError ?? (() => undefined);
+        this.#runtime.events.subscribe("runtime.model.failed", ({ entityId, error }) => this.#modelFailures.push({ entityId, error }));
+    }
+    get canvas() {
+        return this.#runtime.canvas;
+    }
+    get rendering() {
+        return this.#runtime.rendering;
+    }
+    get documentId() {
+        return this.#documentId;
+    }
+    get status() {
+        return this.#status;
+    }
+    get error() {
+        return this.#error;
+    }
+    get modelFailures() {
+        return Object.freeze(this.#modelFailures.map((item) => ({ ...item })));
+    }
+    getBackendSnapshot() {
+        return this.#runtime.getBackendSnapshot();
+    }
+    getGpuProgramCacheSnapshot() {
+        return this.#runtime.getGpuProgramCacheSnapshot();
+    }
+    /** Serializes with capture so render/readback operations never overlap. */
+    probe() {
+        this.#assertActive();
+        const probe = this.#captureTail.then(() => this.#runtime.probe());
+        this.#captureTail = probe.then(() => undefined, () => undefined);
+        return probe;
+    }
+    subscribeStatus(listener, options = {}) {
+        this.#assertActive();
+        if (options.signal?.aborted)
+            return () => undefined;
+        this.#statusListeners.add(listener);
+        if (options.immediate ?? true) {
+            this.#notifyStatusListener(listener);
+        }
+        const unsubscribe = () => {
+            this.#statusListeners.delete(listener);
+            options.signal?.removeEventListener("abort", unsubscribe);
+            this.#statusUnsubscribers.delete(unsubscribe);
+        };
+        this.#statusUnsubscribers.add(unsubscribe);
+        options.signal?.addEventListener("abort", unsubscribe, { once: true });
+        return unsubscribe;
+    }
+    async load(document, resources, options = {}) {
+        this.#assertActive();
+        let ownedDocument;
+        try {
+            const candidate = normalizeSceneDocument(structuredClone(document));
+            assertSceneDocument(candidate);
+            ownedDocument = candidate;
+        }
+        catch (error) {
+            if (this.#status !== "ready")
+                this.#setStatus("error", error);
+            throw error;
+        }
+        const generation = ++this.#loadGeneration;
+        this.#modelFailures.length = 0;
+        const documentId = ownedDocument.id;
+        this.#documentId = null;
+        this.#setStatus("loading");
+        try {
+            await this.#captureTail;
+            if (generation !== this.#loadGeneration)
+                return;
+            await this.#runtime.loadDocument(ownedDocument, resources, options);
+            if (generation !== this.#loadGeneration)
+                return;
+            this.#documentId = documentId;
+            this.#setStatus("ready");
+        }
+        catch (error) {
+            if (generation === this.#loadGeneration) {
+                const aborted = isAbortError(error);
+                this.#setStatus(aborted ? "idle" : "error", aborted ? null : error);
+            }
+            throw error;
+        }
+    }
+    frame() {
+        this.#assertActive();
+        this.#runtime.capabilities.require(RUNTIME_CAMERA_CAPABILITY).frame();
+        this.#runtime.viewportCamera?.configureModelViewerControls(this.#viewerControls);
+    }
+    setView(view) {
+        this.#assertActive();
+        this.#runtime.viewportCamera?.setView(view);
+        this.#runtime.viewportCamera?.configureModelViewerControls(this.#viewerControls);
+    }
+    resetView(view = "front") {
+        this.#assertActive();
+        this.#runtime.resize();
+        this.#runtime.capabilities.require(RUNTIME_CAMERA_CAPABILITY).frame();
+        this.#runtime.viewportCamera?.setView(view);
+        this.#runtime.viewportCamera?.configureModelViewerControls(this.#viewerControls);
+    }
+    configureViewerControls(options = {}) {
+        this.#assertActive();
+        this.#viewerControls = { ...options };
+        this.#runtime.viewportCamera?.configureModelViewerControls(this.#viewerControls);
+    }
+    normalizeModelView(view = "front") {
+        this.#assertActive();
+        this.#runtime.centerImportedModelsAtOrigin();
+        this.resetView(view);
+    }
+    resize() {
+        this.#assertActive();
+        this.#runtime.resize();
+    }
+    pause() {
+        this.#assertActive();
+        this.#runtime.pause();
+    }
+    resume() {
+        this.#assertActive();
+        this.#runtime.resume();
+    }
+    setAutoRotate(enabled, speed = 0.15) {
+        this.#assertActive();
+        if (!Number.isFinite(speed)) {
+            throw new Error("Auto-rotation speed must be finite");
+        }
+        const camera = this.#runtime.viewportCamera?.camera;
+        if (!camera)
+            return;
+        camera.useAutoRotationBehavior = enabled;
+        if (!camera.autoRotationBehavior)
+            return;
+        camera.autoRotationBehavior.idleRotationSpeed = speed;
+        camera.autoRotationBehavior.idleRotationWaitTime = 0;
+        camera.autoRotationBehavior.idleRotationSpinupTime = 0;
+    }
+    capture(options = {}) {
+        this.#assertActive();
+        if (this.#status !== "ready") {
+            return Promise.reject(new Error("A scene document must be ready before capture"));
+        }
+        const request = structuredClone(options);
+        validateCaptureOptions(request);
+        const capture = this.#captureTail.then(() => this.#capture(request));
+        this.#captureTail = capture.then(() => undefined, () => undefined);
+        return capture;
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#loadGeneration += 1;
+        this.#documentId = null;
+        this.#setStatus("disposed");
+        this.#disposed = true;
+        try {
+            this.#runtime.dispose();
+        }
+        finally {
+            for (const unsubscribe of [...this.#statusUnsubscribers])
+                unsubscribe();
+            this.#statusUnsubscribers.clear();
+            this.#statusListeners.clear();
+        }
+    }
+    async #capture(options) {
+        this.#assertActive();
+        const engine = this.#runtime.engine;
+        const scene = this.#runtime.scene;
+        const previousWidth = engine.getRenderWidth();
+        const previousHeight = engine.getRenderHeight();
+        const previousClear = scene.clearColor.clone();
+        const previousBackground = this.#runtime.backgroundVisible;
+        try {
+            if (options.width !== undefined && options.height !== undefined) {
+                engine.setSize(Math.round(options.width), Math.round(options.height));
+            }
+            if (options.transparent) {
+                scene.clearColor.a = 0;
+                this.#runtime.setBackgroundVisible(false);
+            }
+            scene.render();
+            return options.crop
+                ? await captureRegion(this.canvas, options.crop, options.type ?? "image/png", options.quality)
+                : await canvasToBlob(this.canvas, options.type ?? "image/png", options.quality);
+        }
+        finally {
+            scene.clearColor.copyFrom(previousClear);
+            this.#runtime.setBackgroundVisible(previousBackground);
+            if (options.width !== undefined && options.height !== undefined) {
+                engine.setSize(previousWidth, previousHeight);
+            }
+            scene.render();
+        }
+    }
+    #assertActive() {
+        if (this.#disposed)
+            throw new Error("SceneRenderer has been disposed");
+    }
+    #setStatus(status, error = null) {
+        this.#status = status;
+        this.#error = error;
+        for (const listener of [...this.#statusListeners]) {
+            this.#notifyStatusListener(listener);
+        }
+    }
+    #notifyStatusListener(listener) {
+        try {
+            listener(this.#status, this.#error);
+        }
+        catch (error) {
+            try {
+                this.#onStatusListenerError(error);
+            }
+            catch {
+                // Status diagnostics must not interrupt renderer lifecycle changes.
+            }
+        }
+    }
+}
+function isAbortError(error) {
+    return error?.name === "AbortError";
+}
+function validateCaptureOptions(options) {
+    const hasWidth = options.width !== undefined;
+    const hasHeight = options.height !== undefined;
+    if (hasWidth !== hasHeight) {
+        throw new Error("Capture width and height must be provided together");
+    }
+    if ((hasWidth &&
+        (!Number.isFinite(options.width) ||
+            Math.round(options.width ?? 0) < 1)) ||
+        (hasHeight &&
+            (!Number.isFinite(options.height) || Math.round(options.height ?? 0) < 1))) {
+        throw new Error("Capture dimensions must be positive finite numbers");
+    }
+    if (options.quality !== undefined &&
+        (!Number.isFinite(options.quality) ||
+            options.quality < 0 ||
+            options.quality > 1)) {
+        throw new Error("Capture quality must be in the 0..1 range");
+    }
+}
+async function captureRegion(source, requested, type, quality) {
+    const region = normalizeRegion(requested, source.width, source.height);
+    const target = source.ownerDocument.createElement("canvas");
+    target.width = region.width;
+    target.height = region.height;
+    const context = target.getContext("2d");
+    if (!context)
+        throw new Error("A 2D canvas context is required for cropping");
+    context.drawImage(source, region.x, region.y, region.width, region.height, 0, 0, region.width, region.height);
+    return canvasToBlob(target, type, quality);
+}
+function normalizeRegion(region, width, height) {
+    if (!Number.isFinite(region.x) ||
+        !Number.isFinite(region.y) ||
+        !Number.isFinite(region.width) ||
+        !Number.isFinite(region.height) ||
+        region.width <= 0 ||
+        region.height <= 0) {
+        throw new Error("Capture crop must overlap the rendered canvas");
+    }
+    const x = Math.max(0, Math.floor(region.x));
+    const y = Math.max(0, Math.floor(region.y));
+    const right = Math.min(width, Math.ceil(region.x + region.width));
+    const bottom = Math.min(height, Math.ceil(region.y + region.height));
+    if (right <= x || bottom <= y) {
+        throw new Error("Capture crop must overlap the rendered canvas");
+    }
+    return { x, y, width: right - x, height: bottom - y };
+}
+function canvasToBlob(canvas, type, quality) {
+    return new Promise((resolve, reject) => {
+        canvas.toBlob((blob) => {
+            if (blob)
+                resolve(blob);
+            else
+                reject(new Error("The rendered canvas could not be captured"));
+        }, type, quality);
+    });
+}
+//# sourceMappingURL=scene-renderer.js.map

package/dist/presentation/scene-renderer.js.map

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

package/dist/presentation/viewport-controller.d.ts

@@ -0,0 +1,13 @@
+import type { Scene } from "@babylonjs/core/scene";
+export type ViewportTextureChannel = "baseColor" | "reflectivity" | "microSurface" | "reflectance" | "normal" | "metallicRoughness" | "ambientOcclusion" | "emissive" | "lightmap" | "opacity" | "reflection" | "refraction" | "clearCoat" | "clearCoatRoughness" | "clearCoatNormal" | "sheen" | "sheenRoughness" | "thickness" | "subSurfaceRefraction" | "refractionIntensity";
+export type ViewportMode = "normal" | "unlit" | "wireframe" | "white" | ViewportTextureChannel;
+export declare class ViewportController {
+    #private;
+    readonly scene: Scene;
+    constructor(scene: Scene);
+    get mode(): ViewportMode;
+    listTextureChannels(): readonly ViewportTextureChannel[];
+    setMode(mode: ViewportMode): void;
+    dispose(): void;
+}
+//# sourceMappingURL=viewport-controller.d.ts.map

package/dist/presentation/viewport-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-controller.d.ts","sourceRoot":"","sources":["../../src/presentation/viewport-controller.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,cAAc,GACd,cAAc,GACd,aAAa,GACb,QAAQ,GACR,mBAAmB,GACnB,kBAAkB,GAClB,UAAU,GACV,UAAU,GACV,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,oBAAoB,GACpB,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,WAAW,GACX,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,YAAY,GACtB,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,sBAAsB,CAAC;AAOtE,qBAAa,kBAAkB;;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAOV,KAAK,EAAE,KAAK;IAIxB,IAAI,IAAI,IAAI,YAAY,CAEvB;IAED,mBAAmB,IAAI,SAAS,sBAAsB,EAAE;IAgBxD,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAkDjC,OAAO,IAAI,IAAI;CAgChB"}

package/dist/presentation/viewport-controller.js

@@ -0,0 +1,186 @@
+/** Read-only presentation helpers for viewport inspection modes. */
+import { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import { StandardMaterial } from "@babylonjs/core/Materials/standardMaterial";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+export class ViewportController {
+    scene;
+    #states = new Map();
+    #meshMaterials = new Map();
+    #debugMaterials = new Set();
+    #whiteMaterial = null;
+    #mode = "normal";
+    constructor(scene) {
+        this.scene = scene;
+    }
+    get mode() {
+        return this.#mode;
+    }
+    listTextureChannels() {
+        const channels = [];
+        for (const channel of TEXTURE_CHANNELS) {
+            if (this.scene.materials.some((material) => material instanceof PBRMaterial &&
+                textureForChannel(material, channel) !== null)) {
+                channels.push(channel);
+            }
+        }
+        return channels;
+    }
+    setMode(mode) {
+        this.#restore();
+        this.#mode = mode;
+        if (mode === "normal")
+            return;
+        if (mode === "white") {
+            this.#whiteMaterial ??= this.#createWhiteMaterial();
+            for (const mesh of this.scene.meshes) {
+                if (isHelper(mesh.metadata))
+                    continue;
+                this.#meshMaterials.set(mesh.uniqueId, mesh.material);
+                mesh.material = this.#whiteMaterial;
+            }
+            return;
+        }
+        if (isTextureChannel(mode)) {
+            for (const mesh of this.scene.meshes) {
+                if (isHelper(mesh.metadata))
+                    continue;
+                const source = mesh.material;
+                if (!(source instanceof PBRMaterial))
+                    continue;
+                this.#meshMaterials.set(mesh.uniqueId, source);
+                const debug = new StandardMaterial(`skenora-${mode}-${mesh.uniqueId}`, this.scene);
+                debug.disableLighting = true;
+                debug.diffuseColor = Color3.Black();
+                const texture = textureForChannel(source, mode);
+                debug.emissiveColor = texture ? Color3.White() : Color3.Black();
+                debug.emissiveTexture = texture;
+                debug.backFaceCulling = source.backFaceCulling;
+                mesh.material = debug;
+                this.#debugMaterials.add(debug);
+            }
+            return;
+        }
+        for (const material of this.scene.materials) {
+            const state = { wireframe: material.wireframe };
+            if (hasDisableLighting(material)) {
+                state.disableLighting = material.disableLighting;
+            }
+            this.#states.set(material, state);
+            if (mode === "wireframe")
+                material.wireframe = true;
+            if (mode === "unlit" && hasDisableLighting(material)) {
+                material.disableLighting = true;
+            }
+        }
+    }
+    dispose() {
+        this.#restore();
+        this.#whiteMaterial?.dispose();
+        this.#whiteMaterial = null;
+    }
+    #restore() {
+        for (const [material, state] of this.#states) {
+            if (!this.scene.materials.includes(material))
+                continue;
+            material.wireframe = state.wireframe;
+            if (state.disableLighting !== undefined && hasDisableLighting(material)) {
+                material.disableLighting = state.disableLighting;
+            }
+        }
+        this.#states.clear();
+        for (const mesh of this.scene.meshes) {
+            if (!this.#meshMaterials.has(mesh.uniqueId))
+                continue;
+            const material = this.#meshMaterials.get(mesh.uniqueId) ?? null;
+            mesh.material =
+                material && this.scene.materials.includes(material) ? material : null;
+        }
+        this.#meshMaterials.clear();
+        for (const material of this.#debugMaterials)
+            material.dispose();
+        this.#debugMaterials.clear();
+    }
+    #createWhiteMaterial() {
+        const material = new StandardMaterial("skenora-white-viewport", this.scene);
+        material.diffuseColor = new Color3(0.82, 0.82, 0.82);
+        material.specularColor = new Color3(0.05, 0.05, 0.05);
+        return material;
+    }
+}
+const TEXTURE_CHANNELS = [
+    "baseColor",
+    "reflectivity",
+    "microSurface",
+    "reflectance",
+    "normal",
+    "metallicRoughness",
+    "ambientOcclusion",
+    "emissive",
+    "lightmap",
+    "opacity",
+    "reflection",
+    "refraction",
+    "clearCoat",
+    "clearCoatRoughness",
+    "clearCoatNormal",
+    "sheen",
+    "sheenRoughness",
+    "thickness",
+    "subSurfaceRefraction",
+    "refractionIntensity",
+];
+function isTextureChannel(mode) {
+    return TEXTURE_CHANNELS.includes(mode);
+}
+function textureForChannel(material, channel) {
+    if (channel === "baseColor")
+        return material.albedoTexture;
+    if (channel === "reflectivity")
+        return material.reflectivityTexture;
+    if (channel === "microSurface")
+        return material.microSurfaceTexture;
+    if (channel === "reflectance")
+        return material.reflectanceTexture;
+    if (channel === "normal")
+        return material.bumpTexture;
+    if (channel === "metallicRoughness")
+        return material.metallicTexture;
+    if (channel === "ambientOcclusion")
+        return material.ambientTexture;
+    if (channel === "emissive")
+        return material.emissiveTexture;
+    if (channel === "lightmap")
+        return material.lightmapTexture;
+    if (channel === "opacity")
+        return material.opacityTexture;
+    if (channel === "reflection")
+        return material.reflectionTexture;
+    if (channel === "refraction")
+        return material.refractionTexture;
+    if (channel === "clearCoat")
+        return material.clearCoat.texture;
+    if (channel === "clearCoatRoughness") {
+        return material.clearCoat.textureRoughness;
+    }
+    if (channel === "clearCoatNormal")
+        return material.clearCoat.bumpTexture;
+    if (channel === "sheen")
+        return material.sheen.texture;
+    if (channel === "sheenRoughness")
+        return material.sheen.textureRoughness;
+    if (channel === "thickness")
+        return material.subSurface.thicknessTexture;
+    if (channel === "subSurfaceRefraction") {
+        return material.subSurface.refractionTexture;
+    }
+    return material.subSurface.refractionIntensityTexture;
+}
+function hasDisableLighting(material) {
+    return "disableLighting" in material;
+}
+function isHelper(metadata) {
+    return Boolean(metadata &&
+        typeof metadata === "object" &&
+        metadata.skenora?.helper);
+}
+//# sourceMappingURL=viewport-controller.js.map

package/dist/presentation/viewport-controller.js.map

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

package/dist/projection/annotation-projector.d.ts

@@ -0,0 +1,28 @@
+import { TransformNode } from "@babylonjs/core/Meshes/transformNode";
+import type { Scene } from "@babylonjs/core/scene";
+import type { EntityRecord, SceneDocumentData } from "@skenora/contracts";
+export interface AnnotationProjection {
+    entityId: string;
+    text: string;
+    color: string;
+    x: number;
+    y: number;
+    depth: number;
+    distance: number;
+    world: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    visible: boolean;
+    priority: number;
+    payload?: Readonly<Record<string, unknown>>;
+}
+export declare class AnnotationProjector {
+    #private;
+    readonly scene: Scene;
+    constructor(scene: Scene, resolveNode: (entityId: string) => TransformNode | null);
+    project(document: Readonly<SceneDocumentData>): readonly AnnotationProjection[];
+}
+export declare function createAnnotationEntity(scene: Scene, entity: Readonly<EntityRecord>): TransformNode;
+//# sourceMappingURL=annotation-projector.d.ts.map

package/dist/projection/annotation-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-projector.d.ts","sourceRoot":"","sources":["../../src/projection/annotation-projector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAEV,YAAY,EACZ,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7C;AAED,qBAAa,mBAAmB;;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAIpB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI;IAMzD,OAAO,CACL,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACpC,SAAS,oBAAoB,EAAE;CA0EnC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC7B,aAAa,CAQf"}