@skenora/runtime 0.1.2

package/dist/editor-tools/node-operations.js

@@ -0,0 +1,182 @@
+import { Vector3 } from "@babylonjs/core/Maths/math.vector";
+/**
+ * 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 function duplicateNodeHierarchy(source, options = {}) {
+    const mode = options.mode ?? "clone";
+    const pairs = new Map();
+    let root = null;
+    if (mode === "instance") {
+        root = source.instantiateHierarchy(options.parent ?? null, {
+            doNotInstantiate: options.doNotInstantiate
+                ? (node) => options.doNotInstantiate?.(node) ?? false
+                : false,
+        }, (original, duplicate) => pairs.set(original, duplicate));
+    }
+    else {
+        root = source.clone(options.name ?? source.name, options.parent ?? null, false);
+        if (root)
+            pairHierarchies(source, root, pairs);
+    }
+    if (!root)
+        throw new Error(`Unable to ${mode} node hierarchy: ${source.name}`);
+    if (!pairs.has(source))
+        pairs.set(source, root);
+    const ownedMaterials = new Set();
+    const disposedMaterials = new WeakSet();
+    const materialCopies = new Map();
+    let index = 0;
+    for (const [original, duplicate] of pairs) {
+        duplicate.id =
+            options.idFactory?.(original, index) ?? createDuplicateId(original.id);
+        duplicate.name =
+            index === 0 && options.name
+                ? options.name
+                : (options.nameFactory?.(original, index) ??
+                    (index === 0 ? `${original.name} copy` : original.name));
+        applyMetadata(original, duplicate, options.metadata ?? "clone");
+        if (mode === "clone" &&
+            options.cloneMaterials &&
+            isAbstractMesh(original) &&
+            isAbstractMesh(duplicate) &&
+            original.material) {
+            let material = materialCopies.get(original.material);
+            if (!material) {
+                material =
+                    original.material.clone(`${original.material.name} ${duplicate.id}`) ?? undefined;
+                if (material) {
+                    const ownedMaterial = material;
+                    materialCopies.set(original.material, ownedMaterial);
+                    ownedMaterials.add(ownedMaterial);
+                    ownedMaterial.onDisposeObservable.addOnce(() => {
+                        disposedMaterials.add(ownedMaterial);
+                    });
+                }
+            }
+            if (material)
+                duplicate.material = material;
+        }
+        options.onNodeCreated?.(original, duplicate);
+        index += 1;
+    }
+    if (options.positionOffset) {
+        root.position.addInPlaceFromFloats(options.positionOffset.x, options.positionOffset.y, options.positionOffset.z);
+    }
+    let disposed = false;
+    return {
+        mode,
+        source,
+        root,
+        nodes: [...pairs.values()],
+        sourceToDuplicate: pairs,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            root.dispose(false, false);
+            for (const material of ownedMaterials) {
+                if (!disposedMaterials.has(material)) {
+                    // Cloned Babylon materials still share source textures by default.
+                    material.dispose(false, false);
+                }
+            }
+        },
+    };
+}
+/**
+ * Creates a reversible removal handle. The node is disabled immediately and
+ * can be restored until commit performs the irreversible Babylon disposal.
+ */
+export function stageNodeRemoval(node) {
+    const wasEnabled = node.isEnabled(false);
+    let hidden = false;
+    let committed = false;
+    const handle = {
+        node,
+        get hidden() {
+            return hidden;
+        },
+        get committed() {
+            return committed;
+        },
+        hide() {
+            assertNotCommitted(committed);
+            if (hidden)
+                return;
+            node.setEnabled(false);
+            hidden = true;
+        },
+        restore() {
+            assertNotCommitted(committed);
+            if (!hidden)
+                return;
+            node.setEnabled(wasEnabled);
+            hidden = false;
+        },
+        commit(options = {}) {
+            assertNotCommitted(committed);
+            committed = true;
+            hidden = true;
+            node.dispose(false, options.disposeMaterialsAndTextures ?? false);
+        },
+    };
+    handle.hide();
+    return handle;
+}
+function pairHierarchies(source, duplicate, pairs) {
+    pairs.set(source, duplicate);
+    const sourceChildren = source
+        .getChildren(undefined, true)
+        .filter(isTransformNode);
+    const duplicateChildren = duplicate
+        .getChildren(undefined, true)
+        .filter(isTransformNode);
+    const length = Math.min(sourceChildren.length, duplicateChildren.length);
+    for (let index = 0; index < length; index += 1) {
+        pairHierarchies(sourceChildren[index], duplicateChildren[index], pairs);
+    }
+}
+function applyMetadata(source, duplicate, mode) {
+    if (mode === "omit") {
+        duplicate.metadata = null;
+        return;
+    }
+    if (mode === "share") {
+        duplicate.metadata = source.metadata;
+        return;
+    }
+    duplicate.metadata = cloneMetadata(source.metadata);
+}
+function cloneMetadata(metadata) {
+    if (metadata === undefined || metadata === null)
+        return metadata;
+    try {
+        return structuredClone(metadata);
+    }
+    catch {
+        if (Array.isArray(metadata))
+            return [...metadata];
+        if (typeof metadata === "object")
+            return { ...metadata };
+        return metadata;
+    }
+}
+function createDuplicateId(sourceId) {
+    const suffix = typeof globalThis.crypto?.randomUUID === "function"
+        ? globalThis.crypto.randomUUID()
+        : `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    return `${sourceId || "node"}-${suffix}`;
+}
+function isTransformNode(node) {
+    return "position" in node && node.position instanceof Vector3;
+}
+function isAbstractMesh(node) {
+    return "getBoundingInfo" in node && "material" in node;
+}
+function assertNotCommitted(committed) {
+    if (committed)
+        throw new Error("Node removal has already been committed");
+}
+//# sourceMappingURL=node-operations.js.map

package/dist/editor-tools/node-operations.js.map

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

package/dist/editor-tools/selection-controller.d.ts

@@ -0,0 +1,44 @@
+import { GizmoManager } from "@babylonjs/core/Gizmos/gizmoManager";
+import "@babylonjs/core/Layers/effectLayerSceneComponent";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import type { Node } from "@babylonjs/core/node";
+import type { Scene } from "@babylonjs/core/scene";
+export type GizmoMode = "none" | "position" | "rotation" | "scale";
+export type GizmoCoordinateMode = "local" | "world";
+export interface GizmoSnapConfig {
+    position?: number;
+    rotationDegrees?: number;
+    scale?: number;
+    ground?: number | false;
+}
+export interface RuntimeSelectionOptions {
+    onSelectionChange?: (entityId: string | null, additive: boolean) => void;
+    onTransformStart?: (entityId: string, node: Node) => void;
+    onTransformPreview?: (entityId: string, node: Node) => void;
+    onTransformCommit?: (entityId: string, node: Node) => void;
+    canSelect?: (node: Node) => boolean;
+    highlightColor?: Color3;
+    axisGuideLength?: number;
+}
+/** Selection/highlight/gizmo behavior with no dependency on a panel or store. */
+export declare class RuntimeSelectionController {
+    #private;
+    readonly scene: Scene;
+    readonly gizmos: GizmoManager;
+    constructor(scene: Scene, options?: RuntimeSelectionOptions);
+    get selected(): Node | null;
+    get selectedNodes(): readonly Node[];
+    get mode(): GizmoMode;
+    get coordinateMode(): GizmoCoordinateMode;
+    select(node: Node | null, additive?: boolean): void;
+    selectMany(nodes: readonly Node[]): void;
+    clear(): void;
+    setMode(mode: GizmoMode): void;
+    setCoordinateMode(mode: GizmoCoordinateMode): void;
+    setSnapping(config: GizmoSnapConfig): void;
+    setGizmoScale(scaleRatio: number): void;
+    snapSelectedToGround(height?: number): boolean;
+    dispose(): void;
+}
+export declare function getRuntimeEntityId(node: Node | null): string | null;
+//# sourceMappingURL=selection-controller.d.ts.map

package/dist/editor-tools/selection-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-controller.d.ts","sourceRoot":"","sources":["../../src/editor-tools/selection-controller.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,kDAAkD,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAO1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACzE,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC1D,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC5D,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC3D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,iFAAiF;AACjF,qBAAa,0BAA0B;;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;gBAWlB,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,uBAA4B;IAc/D,IAAI,QAAQ,IAAI,IAAI,GAAG,IAAI,CAE1B;IAED,IAAI,aAAa,IAAI,SAAS,IAAI,EAAE,CAEnC;IAED,IAAI,IAAI,IAAI,SAAS,CAEpB;IAED,IAAI,cAAc,IAAI,mBAAmB,CAExC;IAED,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,QAAQ,UAAQ,GAAG,IAAI;IAkBjD,UAAU,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,IAAI;IAaxC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAW9B,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAMlD,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAM1C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASvC,oBAAoB,CAAC,MAAM,SAAI,GAAG,OAAO;IAkBzC,OAAO,IAAI,IAAI;CAkHhB;AAoED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEnE"}

package/dist/editor-tools/selection-controller.js

@@ -0,0 +1,299 @@
+/** Editor-only selection, highlight, and gizmo controller. */
+import { PointerEventTypes, } from "@babylonjs/core/Events/pointerEvents";
+import { GizmoManager } from "@babylonjs/core/Gizmos/gizmoManager";
+import "@babylonjs/core/Layers/effectLayerSceneComponent";
+import { HighlightLayer } from "@babylonjs/core/Layers/highlightLayer";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import { Vector3 } from "@babylonjs/core/Maths/math.vector";
+import { Mesh } from "@babylonjs/core/Meshes/mesh";
+import { MeshBuilder } from "@babylonjs/core/Meshes/meshBuilder";
+/** Selection/highlight/gizmo behavior with no dependency on a panel or store. */
+export class RuntimeSelectionController {
+    scene;
+    gizmos;
+    #highlight;
+    #options;
+    #boundGizmos = new WeakSet();
+    #axisGuides;
+    #selectedNodes = [];
+    #mode = "position";
+    #coordinateMode = "world";
+    #snap = {};
+    #disposed = false;
+    constructor(scene, options = {}) {
+        this.scene = scene;
+        this.#options = options;
+        this.#highlight = new HighlightLayer("skenora-selection", scene);
+        this.gizmos = new GizmoManager(scene);
+        this.gizmos.usePointerToAttachGizmos = false;
+        this.#axisGuides = createAxisGuides(scene, options.axisGuideLength ?? 10_000);
+        this.setMode(this.#mode);
+        scene.onPointerObservable.add(this.#onPointer);
+    }
+    get selected() {
+        return this.#selectedNodes.at(-1) ?? null;
+    }
+    get selectedNodes() {
+        return this.#selectedNodes;
+    }
+    get mode() {
+        return this.#mode;
+    }
+    get coordinateMode() {
+        return this.#coordinateMode;
+    }
+    select(node, additive = false) {
+        this.#assertActive();
+        const candidate = findEntityRoot(node);
+        const selectable = candidate && (this.#options.canSelect?.(candidate) ?? true)
+            ? candidate
+            : null;
+        if (additive && selectable) {
+            this.#selectedNodes = this.#selectedNodes.includes(selectable)
+                ? this.#selectedNodes.filter((item) => item !== selectable)
+                : [...this.#selectedNodes, selectable];
+        }
+        else {
+            this.#selectedNodes = selectable ? [selectable] : [];
+        }
+        this.#renderSelection();
+        this.#options.onSelectionChange?.(getEntityId(selectable), additive);
+    }
+    selectMany(nodes) {
+        this.#assertActive();
+        this.#selectedNodes = [
+            ...new Set(nodes
+                .map(findEntityRoot)
+                .filter(isNode)
+                .filter((node) => this.#options.canSelect?.(node) ?? true)),
+        ];
+        this.#renderSelection();
+    }
+    clear() {
+        this.select(null);
+    }
+    setMode(mode) {
+        this.#assertActive();
+        this.#mode = mode;
+        this.gizmos.positionGizmoEnabled = mode === "position";
+        this.gizmos.rotationGizmoEnabled = mode === "rotation";
+        this.gizmos.scaleGizmoEnabled = mode === "scale";
+        if (mode === "none")
+            this.gizmos.attachToNode(null);
+        else if (this.selected)
+            this.gizmos.attachToNode(this.selected);
+        this.#configureActiveGizmo();
+    }
+    setCoordinateMode(mode) {
+        this.#assertActive();
+        this.#coordinateMode = mode;
+        this.#configureActiveGizmo();
+    }
+    setSnapping(config) {
+        this.#assertActive();
+        this.#snap = { ...config };
+        this.#configureActiveGizmo();
+    }
+    setGizmoScale(scaleRatio) {
+        this.#assertActive();
+        const ratio = Math.max(0.01, scaleRatio);
+        const { positionGizmo, rotationGizmo, scaleGizmo } = this.gizmos.gizmos;
+        if (positionGizmo)
+            positionGizmo.scaleRatio = ratio;
+        if (rotationGizmo)
+            rotationGizmo.scaleRatio = ratio;
+        if (scaleGizmo)
+            scaleGizmo.scaleRatio = ratio;
+    }
+    snapSelectedToGround(height = 0) {
+        const node = this.selected;
+        if (!node || !("position" in node))
+            return false;
+        const meshes = collectMeshes(node);
+        if (meshes.length === 0)
+            return 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))
+            return false;
+        const transform = node;
+        transform.position.y += height - minimumY;
+        transform.computeWorldMatrix(true);
+        return true;
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.scene.onPointerObservable.removeCallback(this.#onPointer);
+        this.#highlight.dispose();
+        this.gizmos.dispose();
+        for (const line of this.#axisGuides)
+            line.dispose();
+        this.#selectedNodes = [];
+    }
+    #onPointer = (pointer) => {
+        if (pointer.type !== PointerEventTypes.POINTERPICK)
+            return;
+        const picked = pointer.pickInfo?.pickedMesh ?? null;
+        if (picked && isHelper(picked.metadata))
+            return;
+        this.select(picked, Boolean(pointer.event?.shiftKey));
+    };
+    #renderSelection() {
+        this.#highlight.removeAllMeshes();
+        const primary = this.selected;
+        this.gizmos.attachToNode(this.#mode === "none" ? null : primary);
+        const color = this.#options.highlightColor ?? new Color3(0.2, 0.65, 1);
+        for (const selected of this.#selectedNodes) {
+            for (const mesh of collectHighlightMeshes(selected)) {
+                this.#highlight.addMesh(mesh, color);
+            }
+        }
+    }
+    #configureActiveGizmo() {
+        const local = this.#coordinateMode === "local";
+        const position = this.gizmos.gizmos.positionGizmo;
+        const rotation = this.gizmos.gizmos.rotationGizmo;
+        const scale = this.gizmos.gizmos.scaleGizmo;
+        if (position) {
+            position.updateGizmoRotationToMatchAttachedMesh = local;
+            position.snapDistance = this.#snap.position ?? 0;
+            this.#bindGizmo(position, true);
+        }
+        if (rotation) {
+            rotation.updateGizmoRotationToMatchAttachedMesh = local;
+            rotation.snapDistance =
+                this.#snap.rotationDegrees === undefined
+                    ? 0
+                    : (this.#snap.rotationDegrees * Math.PI) / 180;
+            this.#bindGizmo(rotation, false);
+        }
+        if (scale) {
+            scale.updateGizmoRotationToMatchAttachedMesh = local;
+            scale.snapDistance = this.#snap.scale ?? 0;
+            this.#bindGizmo(scale, false);
+        }
+    }
+    #bindGizmo(gizmo, position) {
+        if (this.#boundGizmos.has(gizmo))
+            return;
+        this.#boundGizmos.add(gizmo);
+        gizmo.onDragStartObservable.add(() => {
+            const selected = this.selected;
+            const entityId = getEntityId(selected);
+            if (!selected || !entityId)
+                return;
+            this.#positionAxisGuides(selected);
+            this.#setAxisGuidesEnabled(true);
+            this.#options.onTransformStart?.(entityId, selected);
+        });
+        gizmo.onDragObservable.add(() => {
+            const selected = this.selected;
+            const entityId = getEntityId(selected);
+            if (selected && entityId) {
+                this.#options.onTransformPreview?.(entityId, selected);
+            }
+        });
+        gizmo.onDragEndObservable.add(() => {
+            const selected = this.selected;
+            const entityId = getEntityId(selected);
+            this.#setAxisGuidesEnabled(false);
+            if (!selected || !entityId)
+                return;
+            if (position &&
+                this.#snap.ground !== false &&
+                this.#snap.ground !== undefined) {
+                this.snapSelectedToGround(this.#snap.ground);
+            }
+            this.#options.onTransformCommit?.(entityId, selected);
+        });
+    }
+    #positionAxisGuides(node) {
+        const origin = isTransformNode(node)
+            ? node.getAbsolutePosition()
+            : Vector3.Zero();
+        for (const line of this.#axisGuides)
+            line.position.copyFrom(origin);
+    }
+    #setAxisGuidesEnabled(enabled) {
+        for (const line of this.#axisGuides)
+            line.setEnabled(enabled);
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("RuntimeSelectionController has been disposed");
+        }
+    }
+}
+function createAxisGuides(scene, length) {
+    const lines = [
+        {
+            name: "x",
+            axis: new Vector3(length, 0, 0),
+            color: new Color3(1, 0.2, 0.2),
+        },
+        {
+            name: "y",
+            axis: new Vector3(0, length, 0),
+            color: new Color3(0.2, 1, 0.2),
+        },
+        {
+            name: "z",
+            axis: new Vector3(0, 0, length),
+            color: new Color3(0.2, 0.5, 1),
+        },
+    ].map(({ name, axis, color }) => {
+        const line = MeshBuilder.CreateLines(`skenora-gizmo-guide-${name}`, { points: [axis.scale(-1), axis] }, scene);
+        line.color = color;
+        line.alpha = 0.65;
+        line.isPickable = false;
+        line.metadata = { skenora: { helper: "gizmo-axis-guide" } };
+        line.setEnabled(false);
+        return line;
+    });
+    return lines;
+}
+function isNode(value) {
+    return value !== null;
+}
+function isAbstractMesh(node) {
+    return "getBoundingInfo" in node && "visibility" in node;
+}
+function isTransformNode(node) {
+    return "position" in node && "getAbsolutePosition" in node;
+}
+function collectMeshes(node) {
+    const meshes = node.getChildMeshes(false);
+    if (isAbstractMesh(node))
+        meshes.unshift(node);
+    return [...new Set(meshes)].filter((mesh) => !isHelper(mesh.metadata));
+}
+function collectHighlightMeshes(node) {
+    return collectMeshes(node).filter((mesh) => mesh instanceof Mesh);
+}
+function findEntityRoot(node) {
+    let current = node;
+    while (current) {
+        if (getEntityId(current))
+            return current;
+        current = current.parent;
+    }
+    return null;
+}
+export function getRuntimeEntityId(node) {
+    return getEntityId(node);
+}
+function getEntityId(node) {
+    const metadata = node?.metadata;
+    return typeof metadata?.skenora?.entityId === "string"
+        ? metadata.skenora.entityId
+        : null;
+}
+function isHelper(metadata) {
+    return Boolean(metadata &&
+        typeof metadata === "object" &&
+        metadata.skenora?.helper);
+}
+//# sourceMappingURL=selection-controller.js.map

package/dist/editor-tools/selection-controller.js.map

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

package/dist/editor-tools/shape-drawing-controller.d.ts

@@ -0,0 +1,45 @@
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import type { Scene } from "@babylonjs/core/scene";
+import type { Vector3Value } from "@skenora/contracts";
+export type DrawingPlane = "xy" | "xz" | "yz";
+export type DrawingAxisConstraint = "none" | "x" | "y" | "z";
+export interface ShapeDrawingOptions {
+    plane?: DrawingPlane;
+    planeOffset?: number;
+    closed?: boolean;
+    snap?: number;
+    axisConstraint?: DrawingAxisConstraint;
+    closeDistance?: number;
+    strokeColor?: Color3;
+    onPreview?: (points: readonly Vector3Value[]) => void;
+    onComplete?: (result: ShapeDrawingResult) => void;
+    onCancel?: () => void;
+}
+export interface ShapeDrawingResult {
+    points: readonly Vector3Value[];
+    closed: boolean;
+}
+/** Pointer-driven polygon/polyline capture independent of React and editor state. */
+export declare class ShapeDrawingController {
+    #private;
+    readonly scene: Scene;
+    constructor(scene: Scene);
+    get active(): boolean;
+    get points(): readonly Vector3Value[];
+    begin(options?: ShapeDrawingOptions): void;
+    addPoint(point: {
+        x: number;
+        y: number;
+        z: number;
+    }): void;
+    setCursor(point: {
+        x: number;
+        y: number;
+        z: number;
+    }): void;
+    undoPoint(): boolean;
+    complete(): ShapeDrawingResult | null;
+    cancel(notify?: boolean): void;
+    dispose(): void;
+}
+//# sourceMappingURL=shape-drawing-controller.d.ts.map

package/dist/editor-tools/shape-drawing-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-drawing-controller.d.ts","sourceRoot":"","sources":["../../src/editor-tools/shape-drawing-controller.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAK1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9C,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,KAAK,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qFAAqF;AACrF,qBAAa,sBAAsB;;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAQV,KAAK,EAAE,KAAK;IAIxB,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,IAAI,SAAS,YAAY,EAAE,CAEpC;IAED,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI;IAQ9C,QAAQ,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAY1D,SAAS,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAQ3D,SAAS,IAAI,OAAO;IAQpB,QAAQ,IAAI,kBAAkB,GAAG,IAAI;IAerC,MAAM,CAAC,MAAM,UAAO,GAAG,IAAI;IAO3B,OAAO,IAAI,IAAI;CAyHhB"}