@skenora/runtime 0.1.2

package/dist/editor-tools/drop-preview-controller.js

@@ -0,0 +1,209 @@
+import { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import { Material } from "@babylonjs/core/Materials/material";
+import { StandardMaterial } from "@babylonjs/core/Materials/standardMaterial";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import { Vector3 } from "@babylonjs/core/Maths/math.vector";
+import { MeshBuilder } from "@babylonjs/core/Meshes/meshBuilder";
+import { createIdentityTransform, } from "@skenora/contracts";
+import { importModelEntity, } from "../projection/model-importer.js";
+/** Local model placement preview. Committing returns data; it never edits a store. */
+export class DropPreviewController {
+    scene;
+    resources;
+    #options;
+    #imported = null;
+    #root = null;
+    #placeholder = null;
+    #asset = null;
+    #state = "idle";
+    #generation = 0;
+    #disposed = false;
+    constructor(scene, resources, options = {}) {
+        this.scene = scene;
+        this.resources = resources;
+        this.#options = options;
+    }
+    get state() {
+        return this.#state;
+    }
+    get asset() {
+        return this.#asset;
+    }
+    async show(asset) {
+        this.#assertActive();
+        if (asset.kind !== "model") {
+            throw new Error(`Drop preview requires a model asset: ${asset.id}`);
+        }
+        const generation = ++this.#generation;
+        this.#release();
+        this.#asset = asset;
+        this.#setState("loading");
+        this.#placeholder = createPlaceholder(this.scene);
+        const entity = {
+            id: `skenora-drop-preview:${asset.id}`,
+            name: asset.label ?? "Drop preview",
+            type: "model",
+            parentId: null,
+            enabled: true,
+            visible: true,
+            transform: createIdentityTransform(),
+            assetId: asset.id,
+            properties: {
+                alignment: {
+                    pivot: "bounds-center",
+                    placement: "preserve",
+                    embeddedLights: "remove",
+                    materialCompatibility: "presentation",
+                },
+            },
+        };
+        try {
+            const imported = await importModelEntity(this.scene, this.resources, asset, entity);
+            if (generation !== this.#generation || this.#disposed) {
+                imported.container.dispose();
+                return;
+            }
+            this.#placeholder?.dispose(false, true);
+            this.#placeholder = null;
+            const root = imported.root;
+            root.metadata = withHelperMetadata(root.metadata, "drop-preview");
+            for (const node of imported.nodes) {
+                node.metadata = withHelperMetadata(node.metadata, "drop-preview");
+            }
+            makePreviewMaterials(imported, this.#options.opacity ?? 0.45);
+            this.#imported = imported;
+            this.#root = root;
+            this.#setState("ready");
+        }
+        catch (error) {
+            if (generation === this.#generation) {
+                this.#release();
+                this.#setState("idle");
+            }
+            throw error;
+        }
+    }
+    pick(x, y, predicate = defaultGroundPredicate) {
+        this.#assertActive();
+        return this.scene.pick(x, y, predicate, false);
+    }
+    moveFromPointer(x, y, predicate) {
+        const result = this.pick(x, y, predicate);
+        if (!result?.pickedPoint)
+            return false;
+        this.setPosition(result.pickedPoint);
+        return true;
+    }
+    setPosition(position) {
+        this.#assertActive();
+        const target = this.#root ?? this.#placeholder;
+        if (!target)
+            return;
+        target.position.set(position.x, position.y, position.z);
+        if (!this.#root)
+            return;
+        const meshes = this.#root.getChildMeshes(false);
+        for (const mesh of meshes)
+            mesh.computeWorldMatrix(true);
+        const minimumY = Math.min(...meshes.map((mesh) => mesh.getBoundingInfo().boundingBox.minimumWorld.y));
+        if (Number.isFinite(minimumY)) {
+            this.#root.position.y += position.y - minimumY;
+        }
+    }
+    commit() {
+        this.#assertActive();
+        if (!this.#asset || !this.#root)
+            return null;
+        const result = {
+            asset: this.#asset,
+            transform: captureTransform(this.#root),
+        };
+        this.clear();
+        return result;
+    }
+    clear() {
+        this.#assertActive();
+        this.#generation += 1;
+        this.#release();
+        this.#asset = null;
+        this.#setState("idle");
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#generation += 1;
+        this.#release();
+        this.#asset = null;
+        this.#setState("idle");
+    }
+    #release() {
+        this.#imported?.container.dispose();
+        this.#imported = null;
+        this.#root = null;
+        this.#placeholder?.dispose(false, true);
+        this.#placeholder = null;
+    }
+    #setState(state) {
+        if (this.#state === state)
+            return;
+        this.#state = state;
+        this.#options.onStateChange?.(state);
+    }
+    #assertActive() {
+        if (this.#disposed)
+            throw new Error("DropPreviewController has been disposed");
+    }
+}
+function createPlaceholder(scene) {
+    const placeholder = MeshBuilder.CreateBox("skenora-drop-preview-placeholder", { size: 1 }, scene);
+    const material = new StandardMaterial("skenora-drop-preview-placeholder-material", scene);
+    material.diffuseColor = new Color3(0.2, 0.65, 1);
+    material.alpha = 0.25;
+    material.wireframe = true;
+    placeholder.material = material;
+    placeholder.isPickable = false;
+    placeholder.metadata = { skenora: { helper: "drop-preview-placeholder" } };
+    return placeholder;
+}
+function makePreviewMaterials(imported, opacity) {
+    for (const material of imported.container.materials) {
+        material.alpha = Math.max(0, Math.min(1, opacity));
+        if (material instanceof PBRMaterial) {
+            material.transparencyMode = Material.MATERIAL_ALPHABLEND;
+            material.needDepthPrePass = true;
+        }
+    }
+    for (const mesh of imported.container.meshes)
+        mesh.isPickable = false;
+}
+function withHelperMetadata(metadata, helper) {
+    const record = isRecord(metadata) ? metadata : {};
+    const skenora = isRecord(record.skenora) ? record.skenora : {};
+    return { ...record, skenora: { ...skenora, helper } };
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function defaultGroundPredicate(mesh) {
+    const metadata = mesh.metadata;
+    return metadata?.skenora?.helper === "ground" || mesh.receiveShadows;
+}
+function captureTransform(node) {
+    return {
+        position: { x: node.position.x, y: node.position.y, z: node.position.z },
+        rotation: { x: node.rotation.x, y: node.rotation.y, z: node.rotation.z },
+        scaling: { x: node.scaling.x, y: node.scaling.y, z: node.scaling.z },
+        ...(node.rotationQuaternion
+            ? {
+                rotationQuaternion: {
+                    x: node.rotationQuaternion.x,
+                    y: node.rotationQuaternion.y,
+                    z: node.rotationQuaternion.z,
+                    w: node.rotationQuaternion.w,
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=drop-preview-controller.js.map

package/dist/editor-tools/drop-preview-controller.js.map

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

package/dist/editor-tools/grid-helper.d.ts

@@ -0,0 +1,18 @@
+/** Editor-only grid helper. */
+import type { Mesh } from "@babylonjs/core/Meshes/mesh";
+import type { Scene } from "@babylonjs/core/scene";
+import { GridMaterial } from "@babylonjs/materials/grid";
+export interface GridHelperOptions {
+    size?: number;
+    subdivisions?: number;
+    majorUnitFrequency?: number;
+    opacity?: number;
+}
+export declare class GridHelper {
+    readonly mesh: Mesh;
+    readonly material: GridMaterial;
+    constructor(scene: Scene, options?: GridHelperOptions);
+    setEnabled(enabled: boolean): void;
+    dispose(): void;
+}
+//# sourceMappingURL=grid-helper.d.ts.map

package/dist/editor-tools/grid-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-helper.d.ts","sourceRoot":"","sources":["../../src/editor-tools/grid-helper.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;gBAEpB,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,iBAAsB;IAkBzD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,OAAO,IAAI,IAAI;CAIhB"}

package/dist/editor-tools/grid-helper.js

@@ -0,0 +1,27 @@
+import { MeshBuilder } from "@babylonjs/core/Meshes/meshBuilder";
+import { GridMaterial } from "@babylonjs/materials/grid";
+export class GridHelper {
+    mesh;
+    material;
+    constructor(scene, options = {}) {
+        const size = options.size ?? 20;
+        this.mesh = MeshBuilder.CreateGround("skenora-grid", { width: size, height: size, subdivisions: options.subdivisions ?? 2 }, scene);
+        this.mesh.isPickable = false;
+        this.mesh.metadata = { skenora: { helper: "grid" } };
+        this.material = new GridMaterial("skenora-grid-material", scene);
+        this.material.majorUnitFrequency = options.majorUnitFrequency ?? 10;
+        this.material.minorUnitVisibility = 0.35;
+        this.material.gridRatio = 1;
+        this.material.opacity = options.opacity ?? 0.55;
+        this.material.backFaceCulling = false;
+        this.mesh.material = this.material;
+    }
+    setEnabled(enabled) {
+        this.mesh.setEnabled(enabled);
+    }
+    dispose() {
+        this.mesh.dispose();
+        this.material.dispose();
+    }
+}
+//# sourceMappingURL=grid-helper.js.map

package/dist/editor-tools/grid-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-helper.js","sourceRoot":"","sources":["../../src/editor-tools/grid-helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AASzD,MAAM,OAAO,UAAU;IACZ,IAAI,CAAO;IACX,QAAQ,CAAe;IAEhC,YAAY,KAAY,EAAE,UAA6B,EAAE;QACvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,YAAY,CAClC,cAAc,EACd,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,EAAE,EACtE,KAAK,CACN,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,mBAAmB,GAAG,IAAI,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/editor-tools/light-editing-controller.d.ts

@@ -0,0 +1,25 @@
+import { GizmoManager } from "@babylonjs/core/Gizmos/gizmoManager";
+import type { Scene } from "@babylonjs/core/scene";
+import type { LightConfig } from "@skenora/contracts";
+import type { LightingController } from "../systems/lighting-controller.js";
+export interface LightEditingOptions {
+    helperSize?: number;
+    pointerSelection?: boolean;
+    onSelect?: (lightId: string | null) => void;
+    onChange?: (config: LightConfig) => void;
+}
+/** Optional light helpers and gizmos; LightingController remains headless. */
+export declare class LightEditingController {
+    #private;
+    readonly scene: Scene;
+    readonly lighting: LightingController;
+    readonly gizmos: GizmoManager;
+    constructor(scene: Scene, lighting: LightingController, options?: LightEditingOptions);
+    get selectedLightId(): string | null;
+    refresh(): void;
+    select(lightId: string | null): void;
+    setMode(mode: "position" | "rotation"): void;
+    setVisible(visible: boolean): void;
+    dispose(): void;
+}
+//# sourceMappingURL=light-editing-controller.d.ts.map

package/dist/editor-tools/light-editing-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-editing-controller.d.ts","sourceRoot":"","sources":["../../src/editor-tools/light-editing-controller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAWnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAC1C;AAQD,8EAA8E;AAC9E,qBAAa,sBAAsB;;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;gBAW5B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,mBAAwB;IAqBnC,IAAI,eAAe,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED,OAAO,IAAI,IAAI;IAsCf,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IASpC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAM5C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAWlC,OAAO,IAAI,IAAI;CAkIhB"}

package/dist/editor-tools/light-editing-controller.js

@@ -0,0 +1,207 @@
+import { PointerEventTypes, } from "@babylonjs/core/Events/pointerEvents";
+import { GizmoManager } from "@babylonjs/core/Gizmos/gizmoManager";
+import { DirectionalLight } from "@babylonjs/core/Lights/directionalLight";
+import { PointLight } from "@babylonjs/core/Lights/pointLight";
+import { SpotLight } from "@babylonjs/core/Lights/spotLight";
+import { StandardMaterial } from "@babylonjs/core/Materials/standardMaterial";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import { Matrix, Vector3 } from "@babylonjs/core/Maths/math.vector";
+import { MeshBuilder } from "@babylonjs/core/Meshes/meshBuilder";
+import { TransformNode } from "@babylonjs/core/Meshes/transformNode";
+/** Optional light helpers and gizmos; LightingController remains headless. */
+export class LightEditingController {
+    scene;
+    lighting;
+    gizmos;
+    #options;
+    #proxies = new Map();
+    #material;
+    #boundGizmos = new WeakSet();
+    #selectedId = null;
+    #mode = "position";
+    #observer = null;
+    #disposed = false;
+    constructor(scene, lighting, options = {}) {
+        this.scene = scene;
+        this.lighting = lighting;
+        this.#options = options;
+        this.#material = new StandardMaterial("skenora-light-helper-material", scene);
+        this.#material.disableLighting = true;
+        this.#material.emissiveColor = new Color3(1, 0.72, 0.2);
+        this.gizmos = new GizmoManager(scene);
+        this.gizmos.usePointerToAttachGizmos = false;
+        this.gizmos.positionGizmoEnabled = true;
+        if (options.pointerSelection ?? true) {
+            scene.onPointerObservable.add(this.#onPointer);
+        }
+        this.#observer = scene.onBeforeRenderObservable.add(() => this.#sync());
+        this.refresh();
+    }
+    get selectedLightId() {
+        return this.#selectedId;
+    }
+    refresh() {
+        this.#assertActive();
+        const selected = this.#selectedId;
+        for (const proxy of this.#proxies.values())
+            proxy.node.dispose(false, false);
+        this.#proxies.clear();
+        for (const config of this.lighting.capture()) {
+            const light = this.lighting.getLight(config.id);
+            if (!light)
+                continue;
+            const node = new TransformNode(`skenora-light-helper:${config.id}`, this.scene);
+            node.position.copyFrom(config.position
+                ? new Vector3(config.position.x, config.position.y, config.position.z)
+                : light instanceof PointLight ||
+                    light instanceof SpotLight ||
+                    light instanceof DirectionalLight
+                    ? light.position
+                    : Vector3.Zero());
+            if (config.rotation) {
+                node.rotation.set(config.rotation.x, config.rotation.y, config.rotation.z);
+            }
+            node.metadata = {
+                skenora: { helper: "light-editor", lightId: config.id },
+            };
+            this.#createHelperGeometry(node, config);
+            this.#proxies.set(config.id, { id: config.id, node, type: config.type });
+        }
+        this.select(selected && this.#proxies.has(selected) ? selected : null);
+    }
+    select(lightId) {
+        this.#assertActive();
+        this.#selectedId = lightId && this.#proxies.has(lightId) ? lightId : null;
+        const proxy = this.#selectedId ? this.#proxies.get(this.#selectedId) : null;
+        this.gizmos.attachToNode(proxy?.node ?? null);
+        this.#configureGizmos();
+        this.#options.onSelect?.(this.#selectedId);
+    }
+    setMode(mode) {
+        this.#assertActive();
+        this.#mode = mode;
+        this.#configureGizmos();
+    }
+    setVisible(visible) {
+        this.#assertActive();
+        for (const proxy of this.#proxies.values())
+            proxy.node.setEnabled(visible);
+        if (!visible)
+            this.gizmos.attachToNode(null);
+        else if (this.#selectedId) {
+            this.gizmos.attachToNode(this.#proxies.get(this.#selectedId)?.node ?? null);
+        }
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.scene.onPointerObservable.removeCallback(this.#onPointer);
+        if (this.#observer) {
+            this.scene.onBeforeRenderObservable.remove(this.#observer);
+            this.#observer = null;
+        }
+        this.gizmos.dispose();
+        for (const proxy of this.#proxies.values())
+            proxy.node.dispose(false, false);
+        this.#proxies.clear();
+        this.#material.dispose();
+    }
+    #onPointer = (pointer) => {
+        if (pointer.type !== PointerEventTypes.POINTERPICK)
+            return;
+        let node = pointer.pickInfo?.pickedMesh ?? null;
+        while (node) {
+            const metadata = node.metadata;
+            if (typeof metadata?.skenora?.lightId === "string") {
+                this.select(metadata.skenora.lightId);
+                return;
+            }
+            node = node.parent;
+        }
+    };
+    #createHelperGeometry(node, config) {
+        const size = this.#options.helperSize ?? 0.25;
+        const icon = MeshBuilder.CreateSphere(`${node.name}:icon`, { diameter: size, segments: 8 }, this.scene);
+        icon.parent = node;
+        icon.material = this.#material;
+        icon.metadata = {
+            skenora: { helper: "light-editor", lightId: config.id },
+        };
+        if (config.type === "point" || config.type === "hemispheric")
+            return;
+        const line = MeshBuilder.CreateLines(`${node.name}:direction`, {
+            points: [Vector3.Zero(), new Vector3(0, 0, size * 4)],
+        }, this.scene);
+        line.color = this.#material.emissiveColor;
+        line.parent = node;
+        line.isPickable = false;
+        line.metadata = { skenora: { helper: "light-editor" } };
+    }
+    #configureGizmos() {
+        const proxy = this.#selectedId ? this.#proxies.get(this.#selectedId) : null;
+        const canRotate = proxy?.type === "directional" || proxy?.type === "spot";
+        this.gizmos.positionGizmoEnabled = this.#mode === "position";
+        this.gizmos.rotationGizmoEnabled = this.#mode === "rotation" && canRotate;
+        const position = this.gizmos.gizmos.positionGizmo;
+        const rotation = this.gizmos.gizmos.rotationGizmo;
+        if (position)
+            this.#bindCommit(position);
+        if (rotation)
+            this.#bindCommit(rotation);
+    }
+    #bindCommit(gizmo) {
+        if (this.#boundGizmos.has(gizmo))
+            return;
+        this.#boundGizmos.add(gizmo);
+        gizmo.onDragEndObservable.add(() => {
+            const config = this.#captureSelected();
+            if (config)
+                this.#options.onChange?.(config);
+        });
+    }
+    #captureSelected() {
+        if (!this.#selectedId)
+            return null;
+        const proxy = this.#proxies.get(this.#selectedId);
+        const runtime = this.lighting
+            .capture()
+            .find((config) => config.id === this.#selectedId);
+        if (!proxy || !runtime)
+            return null;
+        return {
+            ...runtime,
+            position: {
+                x: proxy.node.position.x,
+                y: proxy.node.position.y,
+                z: proxy.node.position.z,
+            },
+            rotation: {
+                x: proxy.node.rotation.x,
+                y: proxy.node.rotation.y,
+                z: proxy.node.rotation.z,
+            },
+        };
+    }
+    #sync() {
+        for (const proxy of this.#proxies.values()) {
+            const light = this.lighting.getLight(proxy.id);
+            if (!light)
+                continue;
+            if (light instanceof PointLight ||
+                light instanceof SpotLight ||
+                light instanceof DirectionalLight) {
+                light.position.copyFrom(proxy.node.position);
+            }
+            if (light instanceof SpotLight || light instanceof DirectionalLight) {
+                light.direction.copyFrom(Vector3.TransformNormal(new Vector3(0, 0, 1), Matrix.RotationYawPitchRoll(proxy.node.rotation.y, proxy.node.rotation.x, proxy.node.rotation.z)).normalize());
+            }
+        }
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("LightEditingController has been disposed");
+        }
+    }
+}
+//# sourceMappingURL=light-editing-controller.js.map

package/dist/editor-tools/light-editing-controller.js.map

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

package/dist/editor-tools/node-operations.d.ts

@@ -0,0 +1,51 @@
+import type { TransformNode } from "@babylonjs/core/Meshes/transformNode";
+import type { Node } from "@babylonjs/core/node";
+export type NodeDuplicationMode = "clone" | "instance";
+export type MetadataCopyMode = "clone" | "share" | "omit";
+export interface DuplicateNodeOptions {
+    mode?: NodeDuplicationMode;
+    name?: string;
+    parent?: TransformNode | null;
+    positionOffset?: Readonly<{
+        x: number;
+        y: number;
+        z: number;
+    }>;
+    cloneMaterials?: boolean;
+    metadata?: MetadataCopyMode;
+    /** Clone selected hierarchy nodes instead of creating geometry instances. */
+    doNotInstantiate?: (node: TransformNode) => boolean;
+    idFactory?: (source: TransformNode, index: number) => string;
+    nameFactory?: (source: TransformNode, index: number) => string;
+    onNodeCreated?: (source: TransformNode, duplicate: TransformNode) => void;
+}
+export interface DuplicateNodeResult {
+    readonly mode: NodeDuplicationMode;
+    readonly source: TransformNode;
+    readonly root: TransformNode;
+    readonly nodes: readonly TransformNode[];
+    readonly sourceToDuplicate: ReadonlyMap<TransformNode, TransformNode>;
+    dispose(): void;
+}
+export interface StagedNodeRemoval {
+    readonly node: Node;
+    readonly hidden: boolean;
+    readonly committed: boolean;
+    hide(): void;
+    restore(): void;
+    commit(options?: {
+        disposeMaterialsAndTextures?: boolean;
+    }): void;
+}
+/**
+ * Duplicates a Babylon hierarchy without touching editor state, DOM, or a data
+ * source. Clone mode owns optional cloned materials; instance mode shares
+ * geometry and materials with the source hierarchy.
+ */
+export declare function duplicateNodeHierarchy(source: TransformNode, options?: DuplicateNodeOptions): DuplicateNodeResult;
+/**
+ * Creates a reversible removal handle. The node is disabled immediately and
+ * can be restored until commit performs the irreversible Babylon disposal.
+ */
+export declare function stageNodeRemoval(node: Node): StagedNodeRemoval;
+//# sourceMappingURL=node-operations.d.ts.map

package/dist/editor-tools/node-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-operations.d.ts","sourceRoot":"","sources":["../../src/editor-tools/node-operations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,UAAU,CAAC;AACvD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,QAAQ,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;IACpD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;CAC3E;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACtE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,2BAA2B,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAiGrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,CAkC9D"}