@skenora/runtime 0.1.2

package/dist/core/runtime-events.d.ts

@@ -0,0 +1,43 @@
+import type { Node } from "@babylonjs/core/node";
+import type { Scene } from "@babylonjs/core/scene";
+import type { MaterialPreparationEvent, MaterialAnimationState, RuntimeQualityState, RuntimeProbeReport, GpuProgramPreparationReport } from "@skenora/contracts";
+export interface RuntimeEventMap {
+    "runtime.quality.changed": RuntimeQualityState;
+    "runtime.material.preparation": MaterialPreparationEvent;
+    "runtime.material.animation": MaterialAnimationState;
+    "runtime.probe.completed": RuntimeProbeReport;
+    "runtime.gpu-program.preparation": GpuProgramPreparationReport;
+    "runtime.ready": {
+        scene: Scene;
+    };
+    "runtime.loading": {
+        loading: boolean;
+    };
+    "runtime.loading.progress": {
+        loaded: number;
+        completed: number;
+        total: number;
+        entityId: string;
+        status: "loaded" | "failed";
+    };
+    "runtime.model.loaded": {
+        entityId: string;
+        roots: readonly Node[];
+    };
+    "runtime.model.failed": {
+        entityId: string;
+        error: unknown;
+    };
+    "runtime.camera.activated": {
+        entityId: string | null;
+        viewport: boolean;
+    };
+    "runtime.document.applied": {
+        documentId: string;
+    };
+    "runtime.error": {
+        error: unknown;
+        operation: string;
+    };
+}
+//# sourceMappingURL=runtime-events.d.ts.map

package/dist/core/runtime-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.d.ts","sourceRoot":"","sources":["../../src/core/runtime-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,yBAAyB,EAAE,mBAAmB,CAAC;IAC/C,8BAA8B,EAAE,wBAAwB,CAAC;IACzD,4BAA4B,EAAE,sBAAsB,CAAC;IACrD,yBAAyB,EAAE,kBAAkB,CAAC;IAC9C,iCAAiC,EAAE,2BAA2B,CAAC;IAC/D,eAAe,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAClC,iBAAiB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACxC,0BAA0B,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;KAC7B,CAAC;IACF,sBAAsB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;KAAE,CAAC;IACrE,sBAAsB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7D,0BAA0B,EAAE;QAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,0BAA0B,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,eAAe,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD"}

package/dist/core/runtime-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-events.js.map

package/dist/core/runtime-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.js","sourceRoot":"","sources":["../../src/core/runtime-events.ts"],"names":[],"mappings":""}

package/dist/core/runtime-session.d.ts

@@ -0,0 +1,93 @@
+import { Engine } from "@babylonjs/core/Engines/engine";
+import type { EngineOptions } from "@babylonjs/core/Engines/thinEngine";
+import { Scene } from "@babylonjs/core/scene";
+import { type EntityRecord, type MaterialOverride, type MaterialSlotDescriptor, type MaterialExecutionPolicy, type CapabilityAvailability, type RuntimeQualityPolicy, type RuntimeQualityState, type SceneDocumentData, type SourceNodeDescriptor, type RuntimeBackendSnapshot, type RuntimeProbeReport, type GpuProgramCacheSnapshot } from "@skenora/contracts";
+import { EventHub } from "@skenora/events";
+import { type SkenoraPlugin } from "@skenora/plugins";
+import type { ResourceResolver } from "@skenora/resources";
+import { CameraController } from "../systems/camera-controller.js";
+import { AnnotationProjector } from "../projection/annotation-projector.js";
+import type { RuntimeEntityProjectionChange } from "../projection/entity-projection-registry.js";
+import { ViewportController } from "../presentation/viewport-controller.js";
+import { type RuntimeNodeDescriptor, type RuntimeNodeFilter, type RuntimeNodeStatistics } from "../inspection/node-tools.js";
+import { RuntimeCapabilityRegistry } from "./runtime-capability-registry.js";
+import { type LoadDocumentOptions } from "./runtime-document-coordinator.js";
+import type { RuntimeEventMap } from "./runtime-events.js";
+export type { LoadDocumentOptions } from "./runtime-document-coordinator.js";
+export type { RuntimeEventMap } from "./runtime-events.js";
+export interface RuntimeSessionOptions {
+    antialias?: boolean;
+    engineOptions?: EngineOptions;
+    /** Whether render size follows the browser device pixel ratio. */
+    adaptToDeviceRatio?: boolean;
+    events?: EventHub<RuntimeEventMap>;
+    autoResize?: boolean;
+    /** Host-owned budgets and enablement for explicitly authored materials. */
+    materialPolicy?: MaterialExecutionPolicy;
+    /** Optional host limits; authored style remains unchanged in the document. */
+    qualityPolicy?: RuntimeQualityPolicy;
+    /** Authoring never auto-starts document behavior; playback honors autoStart. */
+    executionMode?: RuntimeExecutionMode;
+    plugins?: readonly RuntimePlugin[];
+    /** @deprecated Use plugins. */
+    extensions?: readonly RuntimeExtension[];
+}
+export type RuntimeExecutionMode = "authoring" | "playback";
+export type RuntimePlugin = SkenoraPlugin<RuntimeSession>;
+/** @deprecated Use {@link RuntimePlugin}. */
+export type RuntimeExtension = RuntimePlugin;
+export type RuntimeDocumentSetting = "camera" | "cameraPaths" | "environment" | "ground" | "fog" | "weather" | "lights" | "materials" | "textureAnimations" | "postProcess";
+export declare class RuntimeSession {
+    #private;
+    readonly canvas: HTMLCanvasElement;
+    readonly engine: Engine;
+    readonly scene: Scene;
+    readonly annotations: AnnotationProjector;
+    readonly viewport: ViewportController;
+    readonly events: EventHub<RuntimeEventMap>;
+    readonly capabilities: RuntimeCapabilityRegistry;
+    readonly executionMode: RuntimeExecutionMode;
+    readonly materialPolicy: Readonly<Required<MaterialExecutionPolicy>>;
+    readonly qualityPolicy: Readonly<RuntimeQualityPolicy>;
+    constructor(canvas: HTMLCanvasElement, options?: RuntimeSessionOptions);
+    get viewportCamera(): CameraController | null;
+    get rendering(): boolean;
+    /** Whether document-authored auto behaviors are currently running. */
+    get behaviorsRunning(): boolean;
+    getQualityState(): RuntimeQualityState | null;
+    /** Serializable observation of the active Babylon backend and device caps. */
+    getBackendSnapshot(): RuntimeBackendSnapshot;
+    getGpuProgramCacheSnapshot(): GpuProgramCacheSnapshot;
+    /**
+     * Exercises the live backend. A healthy verdict requires both a real scene
+     * render and a one-pixel GPU readback; construction alone is never proof.
+     */
+    probe(): Promise<RuntimeProbeReport>;
+    classifyEntityChange(entity: Readonly<EntityRecord>, path: readonly (string | number)[]): RuntimeEntityProjectionChange;
+    describeMaterialSlots(entityId: string): readonly MaterialSlotDescriptor[];
+    describeModelNodes(entityId: string): readonly SourceNodeDescriptor[];
+    describeModelNodeTree(entityId: string, filter?: RuntimeNodeFilter): readonly RuntimeNodeDescriptor[];
+    getModelStatistics(entityId: string): RuntimeNodeStatistics;
+    describeModelMaterials(entityId: string): readonly MaterialOverride[];
+    /** Captures document-owned runtime edits without serializing Babylon internals. */
+    captureDocument(source: Readonly<SceneDocumentData>): SceneDocumentData;
+    updateEntity(entity: Readonly<EntityRecord>): void;
+    applyDocumentSettings(document: Readonly<SceneDocumentData>, settings?: readonly RuntimeDocumentSetting[]): Promise<void>;
+    /** Data-only observation of this composition; does not load optional chunks. */
+    getCapabilityAvailability(): readonly CapabilityAvailability[];
+    loadDocument(document: Readonly<SceneDocumentData>, resources: ResourceResolver, options?: LoadDocumentOptions): Promise<void>;
+    /** Starts document-authored auto behaviors without enabling editor tools. */
+    startDocumentBehaviors(): void;
+    /** Stops document-authored auto behaviors while keeping the scene loaded. */
+    stopDocumentBehaviors(): void;
+    centerImportedModelsAtOrigin(): boolean;
+    resize(): void;
+    pause(): void;
+    resume(): void;
+    install(plugin: RuntimePlugin): () => void;
+    showGrid(visible: boolean): Promise<void>;
+    get backgroundVisible(): boolean;
+    setBackgroundVisible(visible: boolean): void;
+    dispose(): void;
+}
+//# sourceMappingURL=runtime-session.d.ts.map

package/dist/core/runtime-session.d.ts.map

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