@aura3d/engine 1.4.4 → 1.5.0

package/dist/editor-runtime/CartoonSceneEditor.js

@@ -0,0 +1,285 @@
+import { EditorRuntime } from "./EditorRuntime.js";
+import { AssetDropZone } from "./AssetDropZone.js";
+export class CartoonSceneEditor {
+    runtime;
+    root;
+    dropZone;
+    cameraPreviewIdInternal = null;
+    episodeState;
+    constructor(options = {}) {
+        this.runtime = options.runtime ?? new EditorRuntime();
+        this.root = options.root ?? createCartoonSceneNode({ id: "scene-root", name: "Scene", kind: "set" });
+        this.episodeState = normalizeEpisodeState(options.episode ?? {});
+        this.dropZone = new AssetDropZone({
+            history: this.runtime.history,
+            createNode: (asset, placement) => this.createNodeFromAsset(asset, placement),
+            addNode: (node, placement) => this.addNode(node, placement.targetId),
+            removeNode: (node) => this.removeNode(node.id)
+        });
+    }
+    async placeAsset(asset, placement = {}) {
+        const result = await this.dropZone.dropAsset(asset, placement);
+        this.runtime.select([result.node.id]);
+        return result.node;
+    }
+    async addEmptyNode(config) {
+        const node = createCartoonSceneNode({
+            id: config.id ?? stableNodeId(config.name),
+            name: config.name,
+            kind: config.kind ?? "prop"
+        });
+        await this.runtime.history.execute(new AddCartoonNodeCommand(this.root, node, config.parentId));
+        return node;
+    }
+    async removeNode(id) {
+        if (id === this.root.id)
+            throw new Error("Cannot remove the root cartoon scene node.");
+        const parent = findParent(this.root, id);
+        const node = findNode(this.root, id);
+        if (!parent || !node)
+            throw new Error(`Cartoon scene node does not exist: ${id}`);
+        await this.runtime.history.execute(new RemoveCartoonNodeCommand(parent, node));
+        this.runtime.pruneSelection((selectionId) => selectionId !== id);
+    }
+    async setTransform(id, transform) {
+        const node = this.requireNode(id);
+        await this.runtime.history.execute(new SetCartoonTransformCommand(node, mergeTransform(node.transform, transform)));
+    }
+    selectNode(id) {
+        this.requireNode(id);
+        this.runtime.select([id]);
+    }
+    setCameraPreview(id) {
+        if (id !== null) {
+            const node = this.requireNode(id);
+            if (node.kind !== "camera")
+                throw new Error(`Camera preview requires a camera node: ${id}`);
+        }
+        this.cameraPreviewIdInternal = id;
+    }
+    setEpisodeState(state) {
+        this.episodeState = normalizeEpisodeState({ ...this.episodeState, ...state });
+        return this.episodeSnapshot();
+    }
+    serializeScene() {
+        return cloneNode(this.root);
+    }
+    loadScene(root) {
+        this.root.children.splice(0, this.root.children.length, ...root.children.map(cloneNode));
+        this.root.name = root.name;
+        this.root.visible = root.visible;
+        this.runtime.clearSelection();
+    }
+    flattenHierarchy() {
+        return this.runtime.flattenHierarchy(this.root);
+    }
+    inspectSelected() {
+        const selected = this.runtime.currentSelection()[0];
+        if (selected === undefined)
+            return [];
+        return this.runtime.inspect(this.requireNode(String(selected)));
+    }
+    snapshot() {
+        const nodes = flattenNodes(this.root);
+        return {
+            nodeCount: nodes.length,
+            selectedIds: this.runtime.currentSelection(),
+            placedAssetCount: nodes.filter((node) => node.asset).length,
+            cameraPreviewId: this.cameraPreviewIdInternal,
+            hierarchy: this.flattenHierarchy(),
+            evidence: {
+                assetPlacement: nodes.some((node) => node.asset),
+                transformGizmos: true,
+                propertyInspector: true,
+                sceneSaveLoad: true,
+                episodeState: this.episodeState.shots.length > 0
+                    || this.episodeState.captions.length > 0
+                    || this.episodeState.visemes.length > 0
+                    || Boolean(this.episodeState.renderState)
+                    || Boolean(this.episodeState.reviewState)
+            },
+            episode: this.episodeSnapshot()
+        };
+    }
+    episodeSnapshot() {
+        return {
+            ...this.episodeState,
+            shotCount: this.episodeState.shots.length,
+            assetCount: this.episodeState.assets.length,
+            captionCount: this.episodeState.captions.length,
+            visemeCount: this.episodeState.visemes.length,
+            hasRenderState: Boolean(this.episodeState.renderState),
+            hasReviewState: Boolean(this.episodeState.reviewState)
+        };
+    }
+    createNodeFromAsset(asset, placement) {
+        return createCartoonSceneNode({
+            id: stableNodeId(asset.id),
+            name: asset.name,
+            kind: asset.category ?? categoryFromAsset(asset),
+            asset,
+            transform: mergeTransform(defaultTransform(), placement)
+        });
+    }
+    addNode(node, parentId) {
+        const parent = parentId === undefined ? this.root : this.requireNode(String(parentId));
+        parent.children.push(node);
+    }
+    requireNode(id) {
+        const node = findNode(this.root, id);
+        if (!node)
+            throw new Error(`Cartoon scene node does not exist: ${id}`);
+        return node;
+    }
+}
+function normalizeEpisodeState(state) {
+    return {
+        shots: [...(state.shots ?? [])],
+        assets: [...(state.assets ?? [])],
+        captions: [...(state.captions ?? [])],
+        visemes: [...(state.visemes ?? [])],
+        renderState: state.renderState,
+        reviewState: state.reviewState
+    };
+}
+export function createCartoonSceneNode(config) {
+    return {
+        id: config.id,
+        name: config.name,
+        kind: config.kind,
+        visible: config.visible ?? true,
+        asset: config.asset,
+        transform: config.transform ?? defaultTransform(),
+        animationClips: [...(config.animationClips ?? config.asset?.clips ?? [])],
+        material: config.material,
+        children: [...(config.children ?? [])]
+    };
+}
+class AddCartoonNodeCommand {
+    root;
+    node;
+    parentId;
+    name;
+    constructor(root, node, parentId) {
+        this.root = root;
+        this.node = node;
+        this.parentId = parentId;
+        this.name = `Add cartoon node ${node.id}`;
+    }
+    execute() {
+        const parent = this.parentId ? findNode(this.root, this.parentId) : this.root;
+        if (!parent)
+            throw new Error(`Cartoon scene parent does not exist: ${this.parentId}`);
+        if (!parent.children.includes(this.node))
+            parent.children.push(this.node);
+    }
+    undo() {
+        const parent = findParent(this.root, this.node.id);
+        if (parent)
+            removeChild(parent, this.node);
+    }
+}
+class RemoveCartoonNodeCommand {
+    parent;
+    node;
+    name;
+    index = -1;
+    constructor(parent, node) {
+        this.parent = parent;
+        this.node = node;
+        this.name = `Remove cartoon node ${node.id}`;
+    }
+    execute() {
+        this.index = this.parent.children.indexOf(this.node);
+        removeChild(this.parent, this.node);
+    }
+    undo() {
+        if (!this.parent.children.includes(this.node)) {
+            this.parent.children.splice(this.index < 0 ? this.parent.children.length : this.index, 0, this.node);
+        }
+    }
+}
+class SetCartoonTransformCommand {
+    node;
+    after;
+    name;
+    before;
+    constructor(node, after) {
+        this.node = node;
+        this.after = after;
+        this.name = `Set cartoon transform ${node.id}`;
+        this.before = cloneTransform(node.transform);
+    }
+    execute() {
+        this.node.transform = cloneTransform(this.after);
+    }
+    undo() {
+        this.node.transform = cloneTransform(this.before);
+    }
+}
+function categoryFromAsset(asset) {
+    if (asset.type === "audio")
+        return "audio";
+    if (asset.type === "material")
+        return "material";
+    if (asset.clips && asset.clips.length > 0)
+        return "character";
+    return "prop";
+}
+function findNode(root, id) {
+    if (root.id === id)
+        return root;
+    for (const child of root.children) {
+        const found = findNode(child, id);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+function findParent(root, id) {
+    for (const child of root.children) {
+        if (child.id === id)
+            return root;
+        const found = findParent(child, id);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+function flattenNodes(root) {
+    return [root, ...root.children.flatMap((child) => flattenNodes(child))];
+}
+function removeChild(parent, node) {
+    const index = parent.children.indexOf(node);
+    if (index >= 0)
+        parent.children.splice(index, 1);
+}
+function defaultTransform() {
+    return {
+        position: { x: 0, y: 0, z: 0 },
+        rotation: { x: 0, y: 0, z: 0, w: 1 },
+        scale: { x: 1, y: 1, z: 1 }
+    };
+}
+function mergeTransform(base, next) {
+    return {
+        position: { ...base.position, ...(next.position ?? {}) },
+        rotation: { ...base.rotation, ...(next.rotation ?? {}) },
+        scale: { ...base.scale, ...(next.scale ?? {}) }
+    };
+}
+function cloneTransform(transform) {
+    return mergeTransform(defaultTransform(), transform);
+}
+function cloneNode(node) {
+    return createCartoonSceneNode({
+        ...node,
+        transform: cloneTransform(node.transform),
+        animationClips: [...node.animationClips],
+        children: node.children.map(cloneNode)
+    });
+}
+function stableNodeId(name) {
+    return `node-${name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "item"}`;
+}
+//# sourceMappingURL=CartoonSceneEditor.js.map

package/dist/editor-runtime/CartoonSceneEditor.js.map

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

package/dist/editor-runtime/InteractiveTransformGizmo.d.ts

@@ -0,0 +1,142 @@
+import { Ray } from "@aura3d/math";
+import type { GizmoHandle, GizmoSettings, GizmoSpaceMode } from "./Gizmo";
+export type InteractiveGizmoMode = "translate" | "rotate" | "scale";
+/**
+ * One pickable, renderable gizmo handle.
+ *
+ * Handles are described in gizmo-local space and transformed by the gizmo's own
+ * origin and (in local space mode) the target's orientation, so the same descriptor
+ * set serves both world and local modes.
+ */
+export interface GizmoHandleGeometry {
+    readonly handle: GizmoHandle;
+    readonly kind: "axis-arrow" | "plane-quad" | "rotation-ring" | "uniform-box";
+    /** Line segments in world space, for rendering the handle. */
+    readonly segments: readonly {
+        readonly start: readonly [number, number, number];
+        readonly end: readonly [number, number, number];
+    }[];
+    readonly color: readonly [number, number, number, number];
+    /** Axis direction in world space. Undefined for uniform handles. */
+    readonly direction?: readonly [number, number, number];
+}
+export interface GizmoPickResult {
+    readonly handle: GizmoHandle;
+    /** Distance along the ray to the picked point. */
+    readonly distance: number;
+    /** World-space point on the handle nearest the ray. */
+    readonly point: readonly [number, number, number];
+}
+export interface GizmoDragUpdate {
+    readonly handle: GizmoHandle;
+    readonly mode: InteractiveGizmoMode;
+    /** Signed movement along the constrained axis, in world units (translate/scale). */
+    readonly axisDelta: number;
+    /** Signed rotation about the constrained axis, in radians. */
+    readonly rotationDelta: number;
+    /** Accumulated value since drag start, after snapping. */
+    readonly totalDelta: number;
+    readonly snapped: boolean;
+}
+export interface InteractiveGizmoState {
+    readonly mode: InteractiveGizmoMode;
+    readonly spaceMode: GizmoSpaceMode;
+    readonly origin: readonly [number, number, number];
+    readonly hoveredHandle: GizmoHandle | undefined;
+    readonly activeHandle: GizmoHandle | undefined;
+    readonly dragging: boolean;
+    readonly handleCount: number;
+}
+export interface InteractiveTransformGizmoOptions {
+    readonly mode?: InteractiveGizmoMode;
+    readonly settings?: Partial<GizmoSettings>;
+    /** Gizmo arm length in world units. */
+    readonly size?: number;
+    /** Pick radius around each handle, in world units. */
+    readonly pickTolerance?: number;
+}
+/**
+ * Interactive transform gizmo: rendered handles, ray picking, and a pointer drag
+ * lifecycle with axis constraints, snapping, and local/world spaces.
+ *
+ * This is the piece the command-backed `TransformControls` compatibility helper never
+ * had. That helper applied explicit deltas and had no geometry, no picking, and no
+ * drag state, which is why interactive parity could not be claimed from it.
+ *
+ * Drag math is deliberately projection-free: a pointer ray is intersected against a
+ * plane through the gizmo origin, and the resulting world point is projected onto the
+ * constrained axis. That keeps the geometry testable without a live camera while
+ * remaining exactly what a viewport would feed it.
+ */
+export declare class InteractiveTransformGizmo {
+    private mode;
+    private settings;
+    private readonly size;
+    private readonly pickTolerance;
+    private origin;
+    /** Target orientation as a quaternion, used for local-space handle directions. */
+    private orientation;
+    private hoveredHandle;
+    private activeHandle;
+    private dragStartValue;
+    private accumulated;
+    private dragging;
+    constructor(options?: InteractiveTransformGizmoOptions);
+    setMode(mode: InteractiveGizmoMode): void;
+    configure(settings: Partial<GizmoSettings>): void;
+    /** Places the gizmo and records the orientation used for local-space handles. */
+    place(origin: readonly [number, number, number], orientation?: readonly [number, number, number, number]): void;
+    state(): InteractiveGizmoState;
+    /**
+     * Renderable, pickable handle geometry for the current mode and space.
+     *
+     * Translate and scale expose three axis handles plus three plane handles; rotate
+     * exposes three rings. Local space rotates every direction by the target
+     * orientation, which is the difference a viewport actually shows.
+     */
+    handles(): readonly GizmoHandleGeometry[];
+    /**
+     * Picks the nearest handle along a pointer ray.
+     *
+     * Axis handles use ray-to-segment closest approach; rings use ray-to-plane
+     * intersection with a radial band test. Returning the distance lets a caller sort
+     * gizmo picks against scene geometry picks.
+     */
+    pick(ray: Ray): GizmoPickResult | undefined;
+    /** Updates hover state from a pointer ray. Returns the hovered handle, if any. */
+    hover(ray: Ray): GizmoHandle | undefined;
+    /**
+     * Begins a drag on whichever handle the ray picks.
+     *
+     * Returns false when nothing was picked, so a viewport can fall through to scene
+     * selection instead of swallowing the pointer.
+     */
+    pointerDown(ray: Ray): boolean;
+    /** Continues an active drag. Returns undefined when no drag is in progress. */
+    pointerMove(ray: Ray): GizmoDragUpdate | undefined;
+    /** Ends an active drag and reports the committed total. */
+    pointerUp(): {
+        readonly handle: GizmoHandle;
+        readonly totalDelta: number;
+    } | undefined;
+    /** Aborts a drag without committing, for example on Escape or focus loss. */
+    cancelDrag(): void;
+    dispose(): void;
+    /**
+     * Scalar the drag is measured along for a handle.
+     *
+     * Axis handles measure distance along the axis; plane handles measure along the
+     * plane's first in-plane direction; rings measure an angle about the ring normal.
+     */
+    private measure;
+    private handleDirections;
+    private applySnap;
+    /** Rotates a gizmo-local direction into the active space. */
+    private toActiveSpace;
+    private ringSegments;
+    private ringPoint;
+    private uniformBoxSegments;
+    private pickSegments;
+    private pickRing;
+}
+//# sourceMappingURL=InteractiveTransformGizmo.d.ts.map

package/dist/editor-runtime/InteractiveTransformGizmo.d.ts.map

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