@aura3d/scene 1.0.6

package/dist/SceneMetadata.d.ts

@@ -0,0 +1,79 @@
+export type SceneMetadataSeed = string | number;
+export type SceneMetadataPlanKind = "animation" | "camera" | "environment" | "interaction" | "lighting" | "physics" | "postprocess" | "rendering";
+export type SceneMetadataCapabilityStatus = "supported" | "unsupported" | "approximation" | "route-local";
+export interface SceneAssetProvenance {
+    readonly id: string;
+    readonly uri?: string;
+    readonly source?: string;
+    readonly loader?: string;
+    readonly version?: string;
+    readonly digest?: string;
+    readonly license?: string;
+    readonly nodeIds?: readonly string[];
+    readonly materialIds?: readonly string[];
+    readonly notes?: string;
+}
+export interface SceneMaterialAssignment {
+    readonly nodeId: string;
+    readonly materialId: string;
+    readonly slot?: string | number;
+    readonly sourceMaterialId?: string;
+    readonly fallback?: boolean;
+    readonly unsupportedFeatures?: readonly string[];
+}
+export interface ScenePlanMetadata {
+    readonly id: string;
+    readonly kind: SceneMetadataPlanKind;
+    readonly description: string;
+    readonly owner?: string;
+    readonly nodeIds?: readonly string[];
+    readonly deterministicSeed?: SceneMetadataSeed;
+    readonly unsupportedFeatures?: readonly string[];
+    readonly evidence?: readonly string[];
+}
+export interface SceneCapabilityDisclosure {
+    readonly feature: string;
+    readonly status: SceneMetadataCapabilityStatus;
+    readonly reason?: string;
+    readonly owner?: string;
+    readonly evidence?: readonly string[];
+}
+export interface SceneRevisionMetadata {
+    readonly id?: string;
+    readonly parentRevisionId?: string;
+    readonly summary: string;
+    readonly author?: string;
+    readonly timestamp?: string;
+    readonly deterministicSeed?: SceneMetadataSeed;
+}
+export type SceneRevisionRecord = Required<Pick<SceneRevisionMetadata, "id" | "summary">> & SceneRevisionMetadata;
+export interface SceneMetadataOptions {
+    readonly deterministicSeed?: SceneMetadataSeed;
+    readonly assets?: readonly SceneAssetProvenance[];
+    readonly materialAssignments?: readonly SceneMaterialAssignment[];
+    readonly plans?: readonly ScenePlanMetadata[];
+    readonly capabilities?: readonly SceneCapabilityDisclosure[];
+    readonly revisions?: readonly SceneRevisionMetadata[];
+}
+export type SerializedSceneMetadata = SceneMetadataOptions;
+export declare class SceneMetadata {
+    deterministicSeed?: SceneMetadataSeed;
+    readonly assets: SceneAssetProvenance[];
+    readonly materialAssignments: SceneMaterialAssignment[];
+    readonly plans: ScenePlanMetadata[];
+    readonly capabilities: SceneCapabilityDisclosure[];
+    readonly revisions: SceneRevisionRecord[];
+    constructor(options?: SceneMetadataOptions);
+    replace(options: SceneMetadataOptions | SceneMetadata): this;
+    clone(): SceneMetadata;
+    get isEmpty(): boolean;
+    registerAsset(asset: SceneAssetProvenance): this;
+    assignMaterial(assignment: SceneMaterialAssignment): this;
+    addPlan(plan: ScenePlanMetadata): this;
+    discloseCapability(disclosure: SceneCapabilityDisclosure): this;
+    discloseUnsupportedFeature(feature: string, reason: string, options?: Omit<SceneCapabilityDisclosure, "feature" | "reason" | "status">): this;
+    recordRevision(revision: SceneRevisionMetadata): this;
+    unsupportedFeatures(): readonly SceneCapabilityDisclosure[];
+    toJSON(): SerializedSceneMetadata;
+}
+//# sourceMappingURL=SceneMetadata.d.ts.map

package/dist/SceneMetadata.d.ts.map

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

package/dist/SceneMetadata.js

@@ -0,0 +1,130 @@
+import { ValidationError } from "@aura3d/core";
+export class SceneMetadata {
+    deterministicSeed;
+    assets = [];
+    materialAssignments = [];
+    plans = [];
+    capabilities = [];
+    revisions = [];
+    constructor(options = {}) {
+        this.replace(options);
+    }
+    replace(options) {
+        this.deterministicSeed = options.deterministicSeed;
+        this.assets.length = 0;
+        this.materialAssignments.length = 0;
+        this.plans.length = 0;
+        this.capabilities.length = 0;
+        this.revisions.length = 0;
+        for (const asset of options.assets ?? [])
+            this.registerAsset(asset);
+        for (const assignment of options.materialAssignments ?? [])
+            this.assignMaterial(assignment);
+        for (const plan of options.plans ?? [])
+            this.addPlan(plan);
+        for (const capability of options.capabilities ?? [])
+            this.discloseCapability(capability);
+        for (const revision of options.revisions ?? [])
+            this.recordRevision(revision);
+        return this;
+    }
+    clone() {
+        return new SceneMetadata(this.toJSON());
+    }
+    get isEmpty() {
+        return this.deterministicSeed === undefined
+            && this.assets.length === 0
+            && this.materialAssignments.length === 0
+            && this.plans.length === 0
+            && this.capabilities.length === 0
+            && this.revisions.length === 0;
+    }
+    registerAsset(asset) {
+        requireNonEmpty(asset.id, "asset id");
+        upsertByKey(this.assets, cloneAsset(asset), (candidate) => candidate.id === asset.id);
+        return this;
+    }
+    assignMaterial(assignment) {
+        requireNonEmpty(assignment.nodeId, "material assignment nodeId");
+        requireNonEmpty(assignment.materialId, "material assignment materialId");
+        const cloned = cloneMaterialAssignment(assignment);
+        upsertByKey(this.materialAssignments, cloned, (candidate) => candidate.nodeId === cloned.nodeId && candidate.slot === cloned.slot);
+        return this;
+    }
+    addPlan(plan) {
+        requireNonEmpty(plan.id, "plan id");
+        requireNonEmpty(plan.description, "plan description");
+        upsertByKey(this.plans, clonePlan(plan), (candidate) => candidate.id === plan.id);
+        return this;
+    }
+    discloseCapability(disclosure) {
+        requireNonEmpty(disclosure.feature, "capability feature");
+        upsertByKey(this.capabilities, cloneCapability(disclosure), (candidate) => candidate.feature === disclosure.feature);
+        return this;
+    }
+    discloseUnsupportedFeature(feature, reason, options = {}) {
+        return this.discloseCapability({ ...options, feature, reason, status: "unsupported" });
+    }
+    recordRevision(revision) {
+        requireNonEmpty(revision.summary, "revision summary");
+        const id = revision.id ?? `revision-${this.revisions.length + 1}`;
+        upsertByKey(this.revisions, cloneRevision({ ...revision, id }), (candidate) => candidate.id === id);
+        return this;
+    }
+    unsupportedFeatures() {
+        return this.capabilities.filter((capability) => capability.status === "unsupported");
+    }
+    toJSON() {
+        return {
+            ...(this.deterministicSeed !== undefined ? { deterministicSeed: this.deterministicSeed } : {}),
+            ...(this.assets.length > 0 ? { assets: this.assets.map(cloneAsset) } : {}),
+            ...(this.materialAssignments.length > 0 ? { materialAssignments: this.materialAssignments.map(cloneMaterialAssignment) } : {}),
+            ...(this.plans.length > 0 ? { plans: this.plans.map(clonePlan) } : {}),
+            ...(this.capabilities.length > 0 ? { capabilities: this.capabilities.map(cloneCapability) } : {}),
+            ...(this.revisions.length > 0 ? { revisions: this.revisions.map(cloneRevision) } : {})
+        };
+    }
+}
+function requireNonEmpty(value, label) {
+    if (!value || value.trim().length === 0) {
+        throw new ValidationError("SCENE_METADATA", `Scene metadata ${label} must be a non-empty string.`);
+    }
+}
+function upsertByKey(items, value, matches) {
+    const index = items.findIndex(matches);
+    if (index >= 0)
+        items[index] = value;
+    else
+        items.push(value);
+}
+function cloneAsset(asset) {
+    return {
+        ...asset,
+        ...(asset.nodeIds ? { nodeIds: [...asset.nodeIds] } : {}),
+        ...(asset.materialIds ? { materialIds: [...asset.materialIds] } : {})
+    };
+}
+function cloneMaterialAssignment(assignment) {
+    return {
+        ...assignment,
+        ...(assignment.unsupportedFeatures ? { unsupportedFeatures: [...assignment.unsupportedFeatures] } : {})
+    };
+}
+function clonePlan(plan) {
+    return {
+        ...plan,
+        ...(plan.nodeIds ? { nodeIds: [...plan.nodeIds] } : {}),
+        ...(plan.unsupportedFeatures ? { unsupportedFeatures: [...plan.unsupportedFeatures] } : {}),
+        ...(plan.evidence ? { evidence: [...plan.evidence] } : {})
+    };
+}
+function cloneCapability(capability) {
+    return {
+        ...capability,
+        ...(capability.evidence ? { evidence: [...capability.evidence] } : {})
+    };
+}
+function cloneRevision(revision) {
+    return { ...revision, id: revision.id ?? "revision-1" };
+}
+//# sourceMappingURL=SceneMetadata.js.map

package/dist/SceneMetadata.js.map

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

package/dist/SceneNode.d.ts

@@ -0,0 +1,42 @@
+import { Bounds3 } from "./Bounds.js";
+import type { Renderable } from "./Renderable.js";
+import { TransformNode } from "./TransformNode.js";
+export interface SceneNodeOptions {
+    id?: string;
+    name?: string;
+}
+export interface AddChildOptions {
+    preserveWorldTransform?: boolean;
+}
+export interface DisposeNodeOptions {
+    recursive?: boolean;
+}
+export declare class SceneNode {
+    readonly id: string;
+    name: string;
+    visible: boolean;
+    layerMask: number;
+    renderOrder: number;
+    disposed: boolean;
+    userData: Record<string, unknown>;
+    renderable?: Renderable;
+    readonly transform: TransformNode;
+    localBounds: Bounds3 | null;
+    worldBounds: Bounds3;
+    readonly children: SceneNode[];
+    parent: SceneNode | null;
+    constructor(options?: SceneNodeOptions);
+    addChild(child: SceneNode, options?: AddChildOptions): this;
+    removeChild(child: SceneNode): boolean;
+    removeFromParent(): boolean;
+    isAncestorOf(candidate: SceneNode): boolean;
+    traverse(visitor: (node: SceneNode) => void): void;
+    updateWorldTransform(force?: boolean): void;
+    updateWorldBounds(): Bounds3;
+    setLocalBounds(bounds: Bounds3 | null): this;
+    dispose(options?: DisposeNodeOptions): void;
+    markWorldDirty(): void;
+    protected assertAlive(): void;
+}
+export declare function assertCanParent(parent: SceneNode, child: SceneNode): void;
+//# sourceMappingURL=SceneNode.d.ts.map

package/dist/SceneNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneNode.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/SceneNode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,UAAQ;IACf,SAAS,SAAK;IACd,WAAW,SAAK;IAChB,QAAQ,UAAS;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACvC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,SAAS,gBAAuB;IACzC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAQ;IACnC,WAAW,UAAiB;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAM;IACpC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAEpB,OAAO,GAAE,gBAAqB;IAM1C,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAe/D,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAUtC,gBAAgB,IAAI,OAAO;IAI3B,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAS3C,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAKlD,oBAAoB,CAAC,KAAK,UAAQ,GAAG,IAAI;IAKzC,iBAAiB,IAAI,OAAO;IAO5B,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAO5C,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,IAAI;IAmB/C,cAAc,IAAI,IAAI;IAOtB,SAAS,CAAC,WAAW,IAAI,IAAI;CAG9B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAGzE"}

package/dist/SceneNode.js

@@ -0,0 +1,126 @@
+import { ValidationError } from "@aura3d/core";
+import { Bounds3 } from "./Bounds.js";
+import { cloneMat4, invertMat4, multiplyMat4 } from "./MathTypes.js";
+import { TransformNode } from "./TransformNode.js";
+let nextSceneNodeId = 1;
+export class SceneNode {
+    id;
+    name;
+    visible = true;
+    layerMask = 1;
+    renderOrder = 0;
+    disposed = false;
+    userData = {};
+    renderable;
+    transform = new TransformNode();
+    localBounds = null;
+    worldBounds = new Bounds3();
+    children = [];
+    parent = null;
+    constructor(options = {}) {
+        this.id = options.id ?? `node-${nextSceneNodeId++}`;
+        this.name = options.name ?? this.id;
+        this.transform.onDirty(() => this.markWorldDirty());
+    }
+    addChild(child, options = {}) {
+        this.assertAlive();
+        child.assertAlive();
+        assertCanParent(this, child);
+        if (child.parent === this)
+            return this;
+        const preservedWorld = options.preserveWorldTransform ? cloneMat4(child.transform.worldMatrix) : undefined;
+        if (preservedWorld)
+            this.updateWorldTransform();
+        child.parent?.removeChild(child);
+        this.children.push(child);
+        child.parent = this;
+        if (preservedWorld)
+            child.transform.setFromLocalMatrix(multiplyMat4(invertMat4(this.transform.worldMatrix), preservedWorld));
+        child.markWorldDirty();
+        return this;
+    }
+    removeChild(child) {
+        this.assertAlive();
+        const index = this.children.indexOf(child);
+        if (index < 0)
+            return false;
+        this.children.splice(index, 1);
+        child.parent = null;
+        child.markWorldDirty();
+        return true;
+    }
+    removeFromParent() {
+        return this.parent?.removeChild(this) ?? false;
+    }
+    isAncestorOf(candidate) {
+        let current = candidate.parent;
+        while (current) {
+            if (current === this)
+                return true;
+            current = current.parent;
+        }
+        return false;
+    }
+    traverse(visitor) {
+        visitor(this);
+        for (const child of [...this.children])
+            child.traverse(visitor);
+    }
+    updateWorldTransform(force = false) {
+        const changed = this.transform.updateWorld(this.parent?.transform.worldMatrix, force);
+        for (const child of this.children)
+            child.updateWorldTransform(force || changed);
+    }
+    updateWorldBounds() {
+        let bounds = this.localBounds ? this.localBounds.transform(this.transform.worldMatrix) : new Bounds3();
+        for (const child of this.children)
+            bounds = bounds.union(child.updateWorldBounds());
+        this.worldBounds = bounds;
+        return this.worldBounds;
+    }
+    setLocalBounds(bounds) {
+        this.assertAlive();
+        this.localBounds = bounds?.clone() ?? null;
+        this.worldBounds = this.localBounds ? this.localBounds.transform(this.transform.worldMatrix) : new Bounds3();
+        return this;
+    }
+    dispose(options = {}) {
+        if (this.disposed)
+            return;
+        const recursive = options.recursive ?? true;
+        const children = [...this.children];
+        if (recursive) {
+            for (const child of children)
+                child.dispose(options);
+        }
+        else {
+            for (const child of children)
+                child.parent = null;
+        }
+        this.children.length = 0;
+        this.parent?.removeChild(this);
+        this.parent = null;
+        this.renderable = undefined;
+        this.localBounds = null;
+        this.userData = {};
+        this.visible = false;
+        this.disposed = true;
+    }
+    markWorldDirty() {
+        for (const child of this.children) {
+            child.transform.markDirty();
+            child.markWorldDirty();
+        }
+    }
+    assertAlive() {
+        if (this.disposed)
+            throw new ValidationError("DISPOSED_SCENE_NODE", `Scene node ${this.name} is disposed.`);
+    }
+}
+export function assertCanParent(parent, child) {
+    if (parent === child)
+        throw new ValidationError("SCENE_SELF_PARENT", "A scene node cannot be parented to itself.");
+    if (child.isAncestorOf(parent))
+        throw new ValidationError("SCENE_HIERARCHY_CYCLE", "Scene hierarchy cycle rejected.");
+}
+//# sourceMappingURL=SceneNode.js.map

package/dist/SceneNode.js.map

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

package/dist/SceneQuery.d.ts

@@ -0,0 +1,16 @@
+import { Bounds3 } from "./Bounds.js";
+import { Renderable } from "./Renderable.js";
+import { SceneNode } from "./SceneNode.js";
+export interface SceneQueryOptions {
+    name?: string | RegExp;
+    visible?: boolean;
+    layerMask?: number;
+    type?: "camera" | "light" | "node";
+    bounds?: Bounds3;
+}
+export declare function queryScene(root: SceneNode, options: SceneQueryOptions): SceneNode[];
+export declare function collectRenderables(root: SceneNode): {
+    node: SceneNode;
+    renderable: Renderable;
+}[];
+//# sourceMappingURL=SceneQuery.d.ts.map

package/dist/SceneQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneQuery.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/SceneQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,SAAS,EAAE,CAenF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,EAAE,CAOjG"}

package/dist/SceneQuery.js

@@ -0,0 +1,37 @@
+import { Bounds3 } from "./Bounds.js";
+import { Camera } from "./Camera.js";
+import { Light } from "./Light.js";
+import { Renderable } from "./Renderable.js";
+import { SceneNode } from "./SceneNode.js";
+export function queryScene(root, options) {
+    const result = [];
+    root.traverse((node) => {
+        if (options.visible !== undefined && node.visible !== options.visible)
+            return;
+        if (options.layerMask !== undefined && (node.layerMask & options.layerMask) === 0)
+            return;
+        if (options.name !== undefined) {
+            const matches = typeof options.name === "string" ? node.name === options.name : options.name.test(node.name);
+            if (!matches)
+                return;
+        }
+        if (options.type === "camera" && !(node instanceof Camera))
+            return;
+        if (options.type === "light" && !(node instanceof Light))
+            return;
+        if (options.bounds && !node.worldBounds.intersects(options.bounds))
+            return;
+        result.push(node);
+    });
+    return result;
+}
+export function collectRenderables(root) {
+    const result = [];
+    root.traverse((node) => {
+        const maybe = node.renderable;
+        if (maybe && node.visible)
+            result.push({ node, renderable: maybe });
+    });
+    return result;
+}
+//# sourceMappingURL=SceneQuery.js.map

package/dist/SceneQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneQuery.js","sourceRoot":"","sources":["../../../../packages/scene/src/SceneQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAU3C,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,OAA0B;IACpE,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;YAAE,OAAO;QAC9E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QAC1F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7G,IAAI,CAAC,OAAO;gBAAE,OAAO;QACvB,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,YAAY,MAAM,CAAC;YAAE,OAAO;QACnE,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC;YAAE,OAAO;QACjE,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO;QAC3E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,MAAM,MAAM,GAAkD,EAAE,CAAC;IACjE,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/SceneSerializer.d.ts

@@ -0,0 +1,59 @@
+import { Scene } from "./Scene.js";
+import type { SerializedSceneMetadata } from "./SceneMetadata.js";
+export interface SerializedSceneNode {
+    id: string;
+    name: string;
+    visible: boolean;
+    layerMask: number;
+    kind: "node" | "perspectiveCamera" | "orthographicCamera" | "directionalLight" | "pointLight" | "spotLight";
+    transform: {
+        position: [number, number, number];
+        rotation: [number, number, number, number];
+        scale: [number, number, number];
+    };
+    renderable?: {
+        geometry: string;
+        material: string;
+        layerMask: number;
+        castShadow: boolean;
+        receiveShadow: boolean;
+        morphWeights?: readonly number[];
+        instanceTransforms?: readonly number[];
+        instanceColors?: readonly number[];
+    };
+    camera?: {
+        fovYRadians?: number;
+        aspect?: number;
+        left?: number;
+        right?: number;
+        bottom?: number;
+        top?: number;
+        near: number;
+        far: number;
+        zoom?: number;
+        resizeMode?: "fit-vertical" | "fit-horizontal" | "preserve-frustum";
+        viewport: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    };
+    light?: {
+        color: [number, number, number];
+        intensity: number;
+        castsShadow: boolean;
+        range?: number;
+        angle?: number;
+        penumbra?: number;
+    };
+    children: SerializedSceneNode[];
+}
+export interface SerializedScene {
+    version: 1;
+    metadata?: SerializedSceneMetadata;
+    root: SerializedSceneNode;
+}
+export declare function serializeScene(scene: Scene): SerializedScene;
+export declare function deserializeScene(serialized: SerializedScene): Scene;
+//# sourceMappingURL=SceneSerializer.d.ts.map

package/dist/SceneSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneSerializer.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/SceneSerializer.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAIlE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,YAAY,GAAG,WAAW,CAAC;IAC5G,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACjC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;QACpE,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACnE,CAAC;IACF,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAM5D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,GAAG,KAAK,CAUnE"}