@skenora/sdk 0.1.2

package/README.md

@@ -0,0 +1,167 @@
+# @skenora/sdk
+
+High-level, local-first, framework-neutral scene SDK over Skenora's headless
+packages.
+
+> Skenora is currently pre-1.0. Product boundaries are implemented, but public
+> APIs may still evolve.
+> The SDK 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/sdk
+```
+
+Choose one product-level entry point:
+
+| Product           |      Models | Editing | Behavior startup   |
+| ----------------- | ----------: | ------- | ------------------ |
+| Lightbox          | Exactly one | No      | Never              |
+| `SkenoraEditor`   | One or many | Yes     | Manual preview     |
+| `SkenoraRenderer` | One or many | No      | Automatic playback |
+
+```ts
+import { SkenoraEditor } from "@skenora/sdk/editor";
+
+const scene = await SkenoraEditor.create({
+  canvas: document.querySelector("canvas"),
+  id: "demo",
+  name: "Demo scene",
+});
+await scene.setEnvironment({ intensity: 1.2 });
+await scene.addProcedural({
+  id: "generated-stage",
+  program: geometryProgram,
+});
+
+// Declarative SceneBlueprint/ScenePatch execution for host or AI workflows.
+const summary = scene.scenePlan.inspectScene();
+sendToAi({
+  capabilities: summary.capabilities,
+  availability: summary.capabilityAvailability,
+  outline: summary.outline,
+});
+const result = await scene.scenePlan.applyPlan(blueprint, {
+  expectedRevisionToken: summary.revisionToken,
+  modelLoadPolicy: "strict",
+  idempotencyKey: "request-001",
+});
+
+// Optional: manually preview authored behavior without leaving the editor.
+await scene.startPreview();
+scene.stopPreview();
+```
+
+The package exposes explicit product subpaths so applications do not place
+unrelated product implementations in the same static module graph. The root
+entry remains an editor-focused compatibility alias.
+
+`SkenoraScene` remains available as a compatibility name for
+`SkenoraEditor`.
+
+For a read-only model viewer, `File` objects can be opened directly without
+constructing a workspace document or resource provider:
+
+```ts
+import { createLightbox } from "@skenora/sdk/lightbox";
+
+const viewer = await createLightbox({ canvas, model: modelFile });
+```
+
+Lightbox is a strict single-model viewer. Multi-model read-only playback uses
+`SkenoraRenderer`, which automatically runs enabled Flow graphs and configured
+camera-path or third-person behavior without exposing editor mutations.
+
+Read-only applications can use the dedicated lightweight export:
+
+```ts
+import { SkenoraRenderer } from "@skenora/sdk/renderer";
+```
+
+The renderer accepts a native scene document produced by
+`compileSceneBlueprint` from `@skenora/scene-plan`; it never contacts an AI.
+Use that package's `getScenePlanInformation()` for descriptions, schemas and
+complete input examples. The host supplies resource bindings/providers.
+
+Both Editor and Renderer subpaths re-export the pure
+`compileProceduralGeometry()` and `compileMaterialProgram()` helpers. Editor's
+`addProcedural()` stores the versioned geometry program through history;
+Renderer projects the validated program read-only. Lightbox remains a strict
+single-model product and does not accept procedural scene authoring.
+
+`renderer.getCapabilityAvailability()` reports the instance's built-in visual
+capabilities and host material limits. `renderer.describeMaterialSlots(entityId)`
+returns logical source-node/slot data after loading. Material preparation is
+observable through `material.preparation` (`unbound`, `preparing`, `ready`,
+`failed`). Pass `runtime.materialPolicy` to set material enablement, instance and
+texture limits, and preparation waiting time. These settings cannot be changed
+by scene JSON. Ready is not a visual-quality assertion.
+
+`renderer.getBackendSnapshot()` returns observed backend/device facts,
+`renderer.getGpuProgramCacheSnapshot()` returns bounded generated-program cache
+statistics, and `await renderer.probe()` requires a real render and pixel
+readback before reporting healthy. GPU-program preparation details are emitted
+through `gpu-program.preparation`.
+
+The Lightbox session exposes the same three observation methods after its
+single-model document is ready; it still excludes editing and behavior
+execution.
+
+For safe model-facing failures, `toPublicRendererDiagnostic(error)` from the
+renderer subpath omits arbitrary error messages, stacks, causes and resource
+locators. Keep original errors private to the host. Always dispose the renderer
+when its host view is removed; shared resource resolvers remain caller-owned.
+
+The bounded material/discovery paths passed tests, development-package consumption
+and WebGL2 rendering verification on 2026-08-28. The checks do not establish
+cross-device compatibility or arbitrary-asset visual quality, and they predate
+the procedural geometry/material-program V1 additions.
+
+Optional `runtime.qualityPolicy` caps render pixel ratio, explicit-light shadow
+resolution, pipeline samples and selected post-processing effects. Read
+`renderer.getQualityState()` or `quality.changed` for requested/effective settings
+and reductions. Authored JSON is not rewritten to fit the device.
+
+Owned materials may declare typed `effects` (`gradient`, `rim`, `dissolve`) and
+local `animations`. Renderer exposes `playMaterialAnimation`,
+`pauseMaterialAnimation`, `resumeMaterialAnimation`, `stopMaterialAnimation`,
+`resetMaterialAnimation`, `getMaterialAnimationState`, and `material.animation`
+events. Play takes material ID, local track ID and an optional AbortSignal;
+it returns completed/cancelled. These are transient operations. Material and
+texture motion follow paused render time, not a separate RAF per target.
+
+Dissolve version 1 supports opaque main-pass cutout only. It rejects shadows,
+SSAO, depth of field, glow, opacity/refraction and runtime transparency/highlight
+overrides. Remove the effect or explicitly disable the incompatible feature;
+there is no implicit fallback. Host material policy separately bounds active
+parameter animation writers and can disable individual effects.
+
+`renderer.projectAnnotations()` returns detached annotation positions, visibility
+and payload in render-pixel coordinates. The host owns text/UI layout and CSS/DPR
+conversion; the library does not create a framework component or page.
+
+Resource loading is local-only by default. Applications may add explicit
+workspace, HTTP, memory, catalog, or custom providers and use the SDK's
+resource search, description, attachment, and preflight methods.
+
+scene.scenePlan is the host-facing declarative gateway. It exposes
+inspectScene, searchResources, validatePlan, applyPlan, and waitOperation; it
+keeps resource locators and Babylon/Editor instances out of the plan DTO
+surface. The built-in gateway feeds its Runtime availability snapshot into
+validation and returns both static capability IDs/versions and observed
+installed/enabled/backend facts plus a paginated model-safe scene outline from
+`inspectScene()`.
+
+Repository guides cover the complete composition, model import, configuration,
+resource, JSON bundle, lifecycle, and ownership APIs:
+
+- [SDK overview](https://github.com/zhangjiadi225/skenora/blob/main/docs/SDK.md)
+- [Lightbox](https://github.com/zhangjiadi225/skenora/blob/main/docs/LIGHTBOX.md)
+- [Editor](https://github.com/zhangjiadi225/skenora/blob/main/docs/EDITOR.md)
+- [Renderer](https://github.com/zhangjiadi225/skenora/blob/main/docs/RENDERER.md)
+- [Runtime](https://github.com/zhangjiadi225/skenora/blob/main/docs/RUNTIME.md)
+- [Flow](https://github.com/zhangjiadi225/skenora/blob/main/docs/FLOW.md)
+- [SceneDocument](https://github.com/zhangjiadi225/skenora/blob/main/docs/SCENE_DOCUMENT.md)
+- Current working-tree procedural guide: `docs/PROCEDURAL_AI.md`

package/dist/editor.d.ts

@@ -0,0 +1,14 @@
+export * from "./scene-config.js";
+export * from "./playback-config.js";
+export * from "./skenora-scene.js";
+export { DEFAULT_SCENE_FILE, DirectoryWorkspaceSource, FileListWorkspaceSource, MemoryWorkspaceSource, WorkspaceConflictError, type DirectoryHandleLike, type WorkspaceEntry, type WorkspaceImportItem, type WorkspaceSource, } from "@skenora/workspace";
+export { createEmptySceneDocument, createIdentityTransform, getMaterialBindingsForEntity, type AssetReference, type EntityRecord, type MaterialBindingRecord, type MaterialOverride, type ModelAlignmentConfig, type ModelEntityProperties, type ResourceIntegrity, type ResourceLocator, type ResourceProvenance, type SceneDocumentData, type TransformValue, } from "@skenora/contracts";
+export { EditFacade, isMixedValue, type EditablePropertyDescriptor, type EditorSession, type MixedValue, type PropertyEditRequest, } from "@skenora/editor";
+export { EditorKeyboardController } from "@skenora/babylon-editor";
+export { assetReferenceFromDescriptor, ResourceManager, supportsResourceDiscovery, type ResolvedResource, type ResourceDescriptor, type ResourceDiscovery, type ResourcePolicy, type ResourcePreflightResult, type ResourceProvider, type ResourceResolver, type ResourceScope, type ResourceSearchQuery, type ResourceSearchPage, } from "@skenora/resources";
+export { WorkspaceResourceProvider } from "@skenora/resources/workspace";
+export { HttpResourceProvider, type HttpResourceProviderOptions, } from "@skenora/resources/http";
+export { MemoryResourceProvider, type MemoryResourceEntry, } from "@skenora/resources/memory";
+export * from "./scene-plan/index.js";
+export * from "@skenora/procedural";
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/editor.js

@@ -0,0 +1,14 @@
+export * from "./scene-config.js";
+export * from "./playback-config.js";
+export * from "./skenora-scene.js";
+export { DEFAULT_SCENE_FILE, DirectoryWorkspaceSource, FileListWorkspaceSource, MemoryWorkspaceSource, WorkspaceConflictError, } from "@skenora/workspace";
+export { createEmptySceneDocument, createIdentityTransform, getMaterialBindingsForEntity, } from "@skenora/contracts";
+export { EditFacade, isMixedValue, } from "@skenora/editor";
+export { EditorKeyboardController } from "@skenora/babylon-editor";
+export { assetReferenceFromDescriptor, ResourceManager, supportsResourceDiscovery, } from "@skenora/resources";
+export { WorkspaceResourceProvider } from "@skenora/resources/workspace";
+export { HttpResourceProvider, } from "@skenora/resources/http";
+export { MemoryResourceProvider, } from "@skenora/resources/memory";
+export * from "./scene-plan/index.js";
+export * from "@skenora/procedural";
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GAKvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,GAY7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,YAAY,GAKb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,yBAAyB,GAW1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,oBAAoB,GAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,GAEvB,MAAM,2BAA2B,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+/** Editor-focused compatibility entry. Prefer the explicit product subpaths. */
+export * from "./editor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+/** Editor-focused compatibility entry. Prefer the explicit product subpaths. */
+export * from "./editor.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,cAAc,UAAU,CAAC"}

package/dist/lightbox.d.ts

@@ -0,0 +1,3 @@
+export { createLightbox, createLightboxDocument, LightboxSession, type CreateLightboxOptions, type LightboxCameraView, type LightboxCaptureOptions, type LightboxControlsConfig, type LightboxDocumentInput, type LightboxFileDependency, type LightboxFileModelInput, type LightboxInitialView, type LightboxLoadOptions, type LightboxModelInput, type LightboxModelOrientation, type LightboxModelSource, type LightboxPreset, type LightboxSessionOptions, type LightboxStatus, type LightboxStatusListener, } from "@skenora/lightbox";
+export type { GpuProgramCacheSnapshot, RuntimeBackendSnapshot, RuntimeProbeReport, } from "@skenora/contracts";
+//# sourceMappingURL=lightbox.d.ts.map

package/dist/lightbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightbox.d.ts","sourceRoot":"","sources":["../src/lightbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/lightbox.js

@@ -0,0 +1,2 @@
+export { createLightbox, createLightboxDocument, LightboxSession, } from "@skenora/lightbox";
+//# sourceMappingURL=lightbox.js.map

package/dist/lightbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightbox.js","sourceRoot":"","sources":["../src/lightbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,eAAe,GAiBhB,MAAM,mBAAmB,CAAC"}

package/dist/playback-config.d.ts

@@ -0,0 +1,27 @@
+import type { CameraPathPlaybackOptions } from "@skenora/runtime/projection";
+import type { ThirdPersonControllerOptions } from "@skenora/runtime/interaction";
+import type { SceneDocumentData } from "@skenora/contracts";
+export declare const SKENORA_PLAYBACK_EXTENSION_ID = "skenora.playback";
+export type SkenoraCameraPathOptions = Omit<CameraPathPlaybackOptions, "signal">;
+export type SkenoraThirdPersonOptions = Omit<ThirdPersonControllerOptions, "onMove" | "onAnimationChange">;
+export interface SkenoraCameraPathPlaybackConfig extends SkenoraCameraPathOptions {
+    id: string;
+    /** Defaults to true when a path is configured. */
+    autoStart?: boolean;
+}
+export interface SkenoraThirdPersonPlaybackConfig {
+    entityId: string;
+    /** Defaults to true when third-person navigation is configured. */
+    enabled?: boolean;
+    options?: SkenoraThirdPersonOptions;
+}
+/** Serializable startup behavior designed in the editor and consumed by Renderer. */
+export interface SkenoraPlaybackConfig {
+    /** Renderer defaults to starting all enabled Flow graphs. */
+    autoStartFlows?: boolean;
+    cameraPath?: false | SkenoraCameraPathPlaybackConfig;
+    thirdPerson?: false | SkenoraThirdPersonPlaybackConfig;
+}
+export declare function getSkenoraPlaybackConfig(document: Readonly<SceneDocumentData>): SkenoraPlaybackConfig;
+export declare function normalizeSkenoraPlaybackConfig(value: unknown): SkenoraPlaybackConfig;
+//# sourceMappingURL=playback-config.d.ts.map

package/dist/playback-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playback-config.d.ts","sourceRoot":"","sources":["../src/playback-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAEhE,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,yBAAyB,EACzB,QAAQ,CACT,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,4BAA4B,EAC5B,QAAQ,GAAG,mBAAmB,CAC/B,CAAC;AAEF,MAAM,WAAW,+BAAgC,SAAQ,wBAAwB;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC;AAED,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,GAAG,+BAA+B,CAAC;IACrD,WAAW,CAAC,EAAE,KAAK,GAAG,gCAAgC,CAAC;CACxD;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACpC,qBAAqB,CAIvB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,qBAAqB,CAevB"}

package/dist/playback-config.js

@@ -0,0 +1,87 @@
+export const SKENORA_PLAYBACK_EXTENSION_ID = "skenora.playback";
+export function getSkenoraPlaybackConfig(document) {
+    const value = document.extensions[SKENORA_PLAYBACK_EXTENSION_ID];
+    if (value === undefined)
+        return {};
+    return normalizeSkenoraPlaybackConfig(value);
+}
+export function normalizeSkenoraPlaybackConfig(value) {
+    if (!isRecord(value)) {
+        throw new Error("Skenora playback configuration must be an object");
+    }
+    const autoStartFlows = optionalBoolean(value.autoStartFlows, "autoStartFlows");
+    const cameraPath = normalizeCameraPath(value.cameraPath);
+    const thirdPerson = normalizeThirdPerson(value.thirdPerson);
+    return {
+        ...(autoStartFlows === undefined ? {} : { autoStartFlows }),
+        ...(cameraPath === undefined ? {} : { cameraPath }),
+        ...(thirdPerson === undefined ? {} : { thirdPerson }),
+    };
+}
+function normalizeCameraPath(value) {
+    if (value === undefined || value === false)
+        return value;
+    if (!isRecord(value) || typeof value.id !== "string" || !value.id.trim()) {
+        throw new Error("Playback cameraPath requires a non-empty id");
+    }
+    const autoStart = optionalBoolean(value.autoStart, "cameraPath.autoStart");
+    const loop = optionalBoolean(value.loop, "cameraPath.loop");
+    const restoreCameraOnStop = optionalBoolean(value.restoreCameraOnStop, "cameraPath.restoreCameraOnStop");
+    const playbackRate = optionalFinite(value.playbackRate, "cameraPath.playbackRate");
+    if (playbackRate !== undefined && playbackRate <= 0) {
+        throw new Error("cameraPath.playbackRate must be positive");
+    }
+    const startProgress = optionalFinite(value.startProgress, "cameraPath.startProgress");
+    if (startProgress !== undefined && (startProgress < 0 || startProgress > 1)) {
+        throw new Error("cameraPath.startProgress must be in the 0..1 range");
+    }
+    return {
+        id: value.id,
+        ...(autoStart === undefined ? {} : { autoStart }),
+        ...(loop === undefined ? {} : { loop }),
+        ...(restoreCameraOnStop === undefined ? {} : { restoreCameraOnStop }),
+        ...(playbackRate === undefined ? {} : { playbackRate }),
+        ...(startProgress === undefined ? {} : { startProgress }),
+    };
+}
+function normalizeThirdPerson(value) {
+    if (value === undefined || value === false)
+        return value;
+    if (!isRecord(value) ||
+        typeof value.entityId !== "string" ||
+        !value.entityId.trim()) {
+        throw new Error("Playback thirdPerson requires a non-empty entityId");
+    }
+    const enabled = optionalBoolean(value.enabled, "thirdPerson.enabled");
+    if (value.options !== undefined && !isRecord(value.options)) {
+        throw new Error("Playback thirdPerson.options must be an object");
+    }
+    return {
+        entityId: value.entityId,
+        ...(enabled === undefined ? {} : { enabled }),
+        ...(value.options === undefined
+            ? {}
+            : {
+                options: structuredClone(value.options),
+            }),
+    };
+}
+function optionalBoolean(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "boolean")
+        throw new Error(`${path} must be a boolean`);
+    return value;
+}
+function optionalFinite(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new Error(`${path} must be finite`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=playback-config.js.map

package/dist/playback-config.js.map

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

package/dist/renderer-diagnostics.d.ts

@@ -0,0 +1,4 @@
+import { type SkenoraDiagnostic } from "@skenora/contracts";
+/** Public repair data. Host errors/cause/stack/URLs are deliberately never copied. */
+export declare function toPublicRendererDiagnostic(error: unknown): SkenoraDiagnostic;
+//# sourceMappingURL=renderer-diagnostics.d.ts.map

package/dist/renderer-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-diagnostics.d.ts","sourceRoot":"","sources":["../src/renderer-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,sFAAsF;AACtF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA4F5E"}

package/dist/renderer-diagnostics.js

@@ -0,0 +1,85 @@
+import { SceneCapabilityUnavailableError, SceneDocumentValidationError, MaterialAnimationError, createSkenoraDiagnostic, } from "@skenora/contracts";
+import { MaterialProjectionError } from "@skenora/runtime/projection";
+/** Public repair data. Host errors/cause/stack/URLs are deliberately never copied. */
+export function toPublicRendererDiagnostic(error) {
+    if (error instanceof MaterialAnimationError)
+        return createSkenoraDiagnostic({
+            code: error.code,
+            severity: "error",
+            stage: "playback",
+            message: error.message,
+            materialId: error.materialId,
+            animationId: error.animationId,
+            repair: "Check the animation capability description, the local animation ID, its bound material/effects, and cancellation state.",
+            recoverable: true,
+        });
+    if (error instanceof MaterialProjectionError) {
+        const { code, stage, message, materialId, bindingId, assetId } = error.diagnostic;
+        return createSkenoraDiagnostic({
+            code,
+            severity: "error",
+            stage,
+            message,
+            materialId,
+            ...(bindingId === undefined ? {} : { bindingId }),
+            ...(assetId === undefined ? {} : { assetId }),
+            repair: "Use the capability description for this diagnostic code; verify logical slots/resources and host material limits.",
+            recoverable: true,
+        });
+    }
+    if (error instanceof SceneCapabilityUnavailableError) {
+        return createSkenoraDiagnostic({
+            code: error.code,
+            severity: "error",
+            stage: "preflight",
+            message: error.message,
+            capabilityId: error.usage.id,
+            path: [...error.usage.path],
+            repair: "Replace the feature or ask the host for an enabled compatible capability. JSON cannot enable it.",
+            recoverable: true,
+            details: { capabilityVersion: error.usage.version },
+        });
+    }
+    if (error instanceof SceneDocumentValidationError &&
+        error.issues.some((issue) => issue.code === "material-effect-pass-unsupported"))
+        return createSkenoraDiagnostic({
+            code: "material-effect-pass-unsupported",
+            severity: "error",
+            stage: "preflight",
+            message: error.message,
+            repair: "Use opaque dissolve with shadows, SSAO, depth-of-field and glow disabled, or remove dissolve; no implicit fallback changes the authored scene.",
+            recoverable: true,
+            details: {
+                paths: error.issues
+                    .filter((issue) => issue.code === "material-effect-pass-unsupported")
+                    .map((issue) => [...issue.path]),
+            },
+        });
+    if (error instanceof SceneDocumentValidationError)
+        return createSkenoraDiagnostic({
+            code: "invalid-document",
+            severity: "error",
+            stage: "preflight",
+            message: error.message,
+            repair: "Compile the input against the current scene contract and repair its structured diagnostics.",
+            recoverable: true,
+        });
+    if (error instanceof Error && error.name === "AbortError")
+        return createSkenoraDiagnostic({
+            code: "load-cancelled",
+            severity: "info",
+            stage: "load",
+            message: error.message || "Scene load was cancelled",
+            repair: "The request was cancelled; only the current host request may continue.",
+            recoverable: true,
+        });
+    return createSkenoraDiagnostic({
+        code: "scene-load-failed",
+        severity: "error",
+        stage: "load",
+        message: error instanceof Error ? error.message : "Scene load failed",
+        repair: "Ask the host to inspect its private error and provide sanitized resource/device diagnostics. Do not invent replacement URLs or credentials.",
+        recoverable: true,
+    });
+}
+//# sourceMappingURL=renderer-diagnostics.js.map

package/dist/renderer-diagnostics.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,10 @@
+/** Lightweight read-only entry point without the editor facade exports. */
+export * from "./playback-config.js";
+export * from "./skenora-renderer.js";
+export * from "./renderer-diagnostics.js";
+export * from "@skenora/procedural";
+export { MaterialProjectionError } from "@skenora/runtime/projection";
+export type { AnnotationProjection } from "@skenora/runtime/projection";
+export { SceneCapabilityUnavailableError, MaterialAnimationError, } from "@skenora/contracts";
+export type { MaterialDiagnostic, MaterialSlotDescriptor, MaterialExecutionPolicy, MaterialPreparationEvent, MaterialParameterAnimation, MaterialAnimationState, MaterialAnimationResult, MaterialAnimationPlayOptions, CapabilityAvailability, RuntimeQualityPolicy, RuntimeQualityState, RuntimeBackendSnapshot, RuntimeProbeReport, RuntimeProbeVerdict, GpuProgramIdentity, GpuProgramPreparationReport, GpuProgramCacheSnapshot, SkenoraDiagnostic, } from "@skenora/contracts";
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,2BAA2B,EAC3B,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/renderer.js

@@ -0,0 +1,8 @@
+/** Lightweight read-only entry point without the editor facade exports. */
+export * from "./playback-config.js";
+export * from "./skenora-renderer.js";
+export * from "./renderer-diagnostics.js";
+export * from "@skenora/procedural";
+export { MaterialProjectionError } from "@skenora/runtime/projection";
+export { SceneCapabilityUnavailableError, MaterialAnimationError, } from "@skenora/contracts";
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/scene-config.d.ts

@@ -0,0 +1,58 @@
+import { type SceneDocumentData } from "@skenora/contracts";
+export declare const SCENE_CONFIG_SECTION_FILES: Readonly<{
+    readonly assets: "assets.json";
+    readonly entities: "entities.json";
+    readonly materials: "materials.json";
+    readonly environment: "environment.json";
+    readonly lighting: "lighting.json";
+    readonly camera: "camera.json";
+    readonly effects: "effects.json";
+    readonly flows: "flows.json";
+    readonly extensions: "extensions.json";
+}>;
+export type SceneConfigSection = keyof typeof SCENE_CONFIG_SECTION_FILES;
+export interface SceneConfigMap {
+    assets: Pick<SceneDocumentData, "assets">;
+    entities: Pick<SceneDocumentData, "entities" | "rootEntityIds">;
+    materials: Pick<SceneDocumentData, "materials" | "materialBindings" | "textureAnimations">;
+    environment: Pick<SceneDocumentData, "environment" | "ground" | "fog" | "weather">;
+    lighting: Pick<SceneDocumentData, "lights">;
+    camera: Pick<SceneDocumentData, "camera" | "cameraPaths">;
+    effects: Pick<SceneDocumentData, "postProcess">;
+    flows: Pick<SceneDocumentData, "flows" | "variables">;
+    extensions: Pick<SceneDocumentData, "extensions">;
+}
+export interface SceneJsonManifest {
+    schema: "skenora.scene.bundle";
+    version: 1;
+    scene: {
+        schema: SceneDocumentData["schema"];
+        version: SceneDocumentData["version"];
+        id: string;
+        name: string;
+    };
+    files: Record<SceneConfigSection, string>;
+}
+export interface SceneJsonSectionDocument<TSection extends SceneConfigSection = SceneConfigSection> {
+    schema: "skenora.scene.section";
+    version: 1;
+    section: TSection;
+    data: SceneConfigMap[TSection];
+}
+/** JSON file contents keyed by their path relative to the manifest. */
+export interface SceneJsonBundle {
+    manifest: string;
+    files: Readonly<Record<string, string>>;
+}
+export interface SceneJsonOptions {
+    space?: number;
+}
+export declare function getSceneConfig<TSection extends SceneConfigSection>(document: Readonly<SceneDocumentData>, section: TSection): SceneConfigMap[TSection];
+export declare function applySceneConfig<TSection extends SceneConfigSection>(document: Readonly<SceneDocumentData>, section: TSection, config: SceneConfigMap[TSection]): SceneDocumentData;
+export declare function serializeSceneConfig<TSection extends SceneConfigSection>(document: Readonly<SceneDocumentData>, section: TSection, options?: SceneJsonOptions): string;
+export declare function parseSceneConfig<TSection extends SceneConfigSection>(json: string, expectedSection: TSection): SceneConfigMap[TSection];
+export declare function exportSceneJsonBundle(document: Readonly<SceneDocumentData>, options?: SceneJsonOptions): SceneJsonBundle;
+export declare function parseSceneJsonBundle(bundle: SceneJsonBundle): SceneDocumentData;
+export declare function parseSceneJson(input: string | SceneJsonBundle): SceneDocumentData;
+export declare function serializeSceneJson(document: Readonly<SceneDocumentData>, options?: SceneJsonOptions): string;
+//# sourceMappingURL=scene-config.d.ts.map

package/dist/scene-config.d.ts.map

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