@skenora/runtime 0.1.2

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./presentation/scene-renderer.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inspection/node-tools.d.ts

@@ -0,0 +1,51 @@
+/** UI-neutral runtime inspection and transient visual effects. */
+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 interface RuntimeNodeFilter {
+    removeNamePatterns?: readonly string[];
+    flattenNamePatterns?: readonly string[];
+    excludeClassNames?: readonly string[];
+    excludeHelpers?: boolean;
+    includeDisabled?: boolean;
+}
+export interface RuntimeNodeDescriptor {
+    id: string;
+    uniqueId: number;
+    name: string;
+    className: string;
+    entityId: string | null;
+    enabled: boolean;
+    visible: boolean;
+    children: readonly RuntimeNodeDescriptor[];
+}
+export interface RuntimeNodeStatistics {
+    meshes: number;
+    transformNodes: number;
+    lights: number;
+    cameras: number;
+    bones: number;
+    other: number;
+    total: number;
+    triangles: number;
+    vertices: number;
+}
+/** Produces a UI-neutral tree without mutating imported Babylon nodes. */
+export declare function describeNodeTree(roots: readonly Node[], filter?: RuntimeNodeFilter): readonly RuntimeNodeDescriptor[];
+export declare function calculateNodeStatistics(roots: readonly Node[]): RuntimeNodeStatistics;
+/** Temporary editor-only effects that restore every material/visibility value. */
+export declare class RuntimeNodeEffects {
+    #private;
+    readonly scene: Scene;
+    constructor(scene: Scene);
+    setTransparent(node: Node, alpha?: number): void;
+    clearTransparent(node: Node): void;
+    setOutline(node: Node, color?: Color3): void;
+    clearOutline(node: Node): void;
+    isolate(node: Node | null): void;
+    clearIsolation(): void;
+    clear(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=node-tools.d.ts.map

package/dist/inspection/node-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-tools.d.ts","sourceRoot":"","sources":["../../src/inspection/node-tools.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,kDAAkD,CAAC;AAM1D,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAcD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,MAAM,GAAE,iBAAsB,GAC7B,SAAS,qBAAqB,EAAE,CAElC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,IAAI,EAAE,GACrB,qBAAqB,CAqBvB;AAUD,kFAAkF;AAClF,qBAAa,kBAAkB;;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAQV,KAAK,EAAE,KAAK;IAKxB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,SAAM,GAAG,IAAI;IAyB7C,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAiBlC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,SAA2B,GAAG,IAAI;IAS9D,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO9B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAYhC,cAAc,IAAI,IAAI;IAOtB,KAAK,IAAI,IAAI;IASb,OAAO,IAAI,IAAI;CAUhB"}

package/dist/inspection/node-tools.js

@@ -0,0 +1,282 @@
+/** UI-neutral runtime inspection and transient visual effects. */
+import "@babylonjs/core/Layers/effectLayerSceneComponent";
+import { HighlightLayer } from "@babylonjs/core/Layers/highlightLayer";
+import { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import { Material } from "@babylonjs/core/Materials/material";
+import { MultiMaterial } from "@babylonjs/core/Materials/multiMaterial";
+import { MaterialProjectionError } from "../systems/material-slots.js";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import { Mesh } from "@babylonjs/core/Meshes/mesh";
+const EMPTY_STATS = {
+    meshes: 0,
+    transformNodes: 0,
+    lights: 0,
+    cameras: 0,
+    bones: 0,
+    other: 0,
+    total: 0,
+    triangles: 0,
+    vertices: 0,
+};
+/** Produces a UI-neutral tree without mutating imported Babylon nodes. */
+export function describeNodeTree(roots, filter = {}) {
+    return roots.flatMap((root) => visitNode(root, filter));
+}
+export function calculateNodeStatistics(roots) {
+    const result = { ...EMPTY_STATS };
+    const visited = new Set();
+    const visit = (node) => {
+        if (visited.has(node.uniqueId))
+            return;
+        visited.add(node.uniqueId);
+        result.total += 1;
+        const className = node.getClassName();
+        if (isAbstractMesh(node)) {
+            result.meshes += 1;
+            result.vertices += node.getTotalVertices();
+            result.triangles += Math.floor(node.getTotalIndices() / 3);
+        }
+        else if (className.includes("TransformNode"))
+            result.transformNodes += 1;
+        else if (className.includes("Light"))
+            result.lights += 1;
+        else if (className.includes("Camera"))
+            result.cameras += 1;
+        else if (className.includes("Bone"))
+            result.bones += 1;
+        else
+            result.other += 1;
+        for (const child of node.getChildren())
+            visit(child);
+    };
+    for (const root of roots)
+        visit(root);
+    return result;
+}
+/** Temporary editor-only effects that restore every material/visibility value. */
+export class RuntimeNodeEffects {
+    scene;
+    #highlight;
+    #materials = new Map();
+    #nodeMaterials = new Map();
+    #outlined = new Map();
+    #isolation = new Map();
+    #disposed = false;
+    constructor(scene) {
+        this.scene = scene;
+        this.#highlight = new HighlightLayer("skenora-node-effects", scene);
+    }
+    setTransparent(node, alpha = 0.5) {
+        this.#assertActive();
+        assertNoCutoutAuxiliaryPass(node);
+        this.clearTransparent(node);
+        const materials = new Set();
+        for (const mesh of collectMeshes(node)) {
+            if (mesh.material)
+                materials.add(mesh.material);
+        }
+        for (const material of materials) {
+            const state = this.#materials.get(material) ?? {
+                material,
+                alpha: material.alpha,
+                transparencyMode: material instanceof PBRMaterial ? material.transparencyMode : null,
+                needDepthPrePass: material instanceof PBRMaterial ? material.needDepthPrePass : false,
+                owners: new Map(),
+            };
+            state.owners.set(node.uniqueId, clamp01(alpha));
+            this.#materials.set(material, state);
+            applyTransparency(state);
+        }
+        this.#nodeMaterials.set(node.uniqueId, materials);
+    }
+    clearTransparent(node) {
+        const materials = this.#nodeMaterials.get(node.uniqueId);
+        if (!materials)
+            return;
+        for (const material of materials) {
+            const state = this.#materials.get(material);
+            if (!state)
+                continue;
+            state.owners.delete(node.uniqueId);
+            if (state.owners.size > 0) {
+                applyTransparency(state);
+            }
+            else {
+                restoreMaterial(state);
+                this.#materials.delete(material);
+            }
+        }
+        this.#nodeMaterials.delete(node.uniqueId);
+    }
+    setOutline(node, color = new Color3(0.2, 0.65, 1)) {
+        this.#assertActive();
+        assertNoCutoutAuxiliaryPass(node);
+        this.clearOutline(node);
+        const meshes = collectHighlightMeshes(node);
+        for (const mesh of meshes)
+            this.#highlight.addMesh(mesh, color);
+        this.#outlined.set(node.uniqueId, meshes);
+    }
+    clearOutline(node) {
+        const meshes = this.#outlined.get(node.uniqueId);
+        if (!meshes)
+            return;
+        for (const mesh of meshes)
+            this.#highlight.removeMesh(mesh);
+        this.#outlined.delete(node.uniqueId);
+    }
+    isolate(node) {
+        this.#assertActive();
+        this.clearIsolation();
+        if (!node)
+            return;
+        const included = new Set(collectMeshes(node));
+        for (const mesh of this.scene.meshes) {
+            if (isHelper(mesh.metadata))
+                continue;
+            this.#isolation.set(mesh, mesh.visibility);
+            mesh.visibility = included.has(mesh) ? mesh.visibility : 0;
+        }
+    }
+    clearIsolation() {
+        for (const [mesh, visibility] of this.#isolation) {
+            if (!mesh.isDisposed())
+                mesh.visibility = visibility;
+        }
+        this.#isolation.clear();
+    }
+    clear() {
+        for (const state of this.#materials.values())
+            restoreMaterial(state);
+        this.#materials.clear();
+        this.#nodeMaterials.clear();
+        this.#highlight.removeAllMeshes();
+        this.#outlined.clear();
+        this.clearIsolation();
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.clear();
+        this.#highlight.dispose();
+    }
+    #assertActive() {
+        if (this.#disposed)
+            throw new Error("RuntimeNodeEffects has been disposed");
+    }
+}
+function visitNode(node, filter) {
+    if (!filter.includeDisabled && !node.isEnabled())
+        return [];
+    if (filter.excludeHelpers !== false && isHelper(node.metadata))
+        return [];
+    if (matchesAny(node.name, filter.removeNamePatterns))
+        return [];
+    if (filter.excludeClassNames?.includes(node.getClassName()))
+        return [];
+    const children = node
+        .getChildren()
+        .flatMap((child) => visitNode(child, filter));
+    if (matchesAny(node.name, filter.flattenNamePatterns))
+        return children;
+    return [
+        {
+            id: readSourceNodeId(node),
+            uniqueId: node.uniqueId,
+            name: node.name,
+            className: node.getClassName(),
+            entityId: readEntityId(node),
+            enabled: node.isEnabled(),
+            visible: isAbstractMesh(node) ? node.visibility > 0 : true,
+            children,
+        },
+    ];
+}
+function matchesAny(name, patterns) {
+    if (!patterns?.length)
+        return false;
+    const candidate = name.toLowerCase();
+    return patterns.some((pattern) => {
+        const normalized = pattern.toLowerCase();
+        if (normalized.startsWith("*") && normalized.endsWith("*")) {
+            return candidate.includes(normalized.slice(1, -1));
+        }
+        if (normalized.startsWith("*") || normalized.startsWith("_")) {
+            return candidate.endsWith(normalized.replace(/^\*/, ""));
+        }
+        if (normalized.endsWith("*") || normalized.endsWith("_")) {
+            return candidate.startsWith(normalized.replace(/\*$/, ""));
+        }
+        return candidate === normalized;
+    });
+}
+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 applyTransparency(state) {
+    state.material.alpha = Math.min(...state.owners.values());
+    if (state.material instanceof PBRMaterial) {
+        state.material.transparencyMode = Material.MATERIAL_ALPHABLEND;
+        state.material.needDepthPrePass = true;
+    }
+}
+function restoreMaterial(state) {
+    if (!state.material.getScene().materials.includes(state.material))
+        return;
+    state.material.alpha = state.alpha;
+    if (state.material instanceof PBRMaterial) {
+        state.material.transparencyMode = state.transparencyMode;
+        state.material.needDepthPrePass = state.needDepthPrePass;
+    }
+}
+function isAbstractMesh(node) {
+    return "getBoundingInfo" in node && "visibility" in node;
+}
+function isHelper(metadata) {
+    return Boolean(metadata &&
+        typeof metadata === "object" &&
+        metadata.skenora?.helper);
+}
+function readEntityId(node) {
+    const metadata = node.metadata;
+    return typeof metadata?.skenora?.entityId === "string"
+        ? metadata.skenora.entityId
+        : null;
+}
+function readSourceNodeId(node) {
+    const metadata = node.metadata;
+    return typeof metadata?.skenora?.sourceNodeId === "string"
+        ? metadata.skenora.sourceNodeId
+        : node.id;
+}
+function clamp01(value) {
+    return Math.max(0, Math.min(1, value));
+}
+function assertNoCutoutAuxiliaryPass(node) {
+    const visited = new Set();
+    const check = (material) => {
+        if (!material || visited.has(material))
+            return;
+        visited.add(material);
+        if (material instanceof MultiMaterial)
+            material.subMaterials.forEach(check);
+        const metadata = material.metadata;
+        if (metadata?.skenora?.cutoutSurface)
+            throw new MaterialProjectionError({
+                stage: "prepare",
+                code: "material-effect-pass-unsupported",
+                materialId: metadata.skenora.materialId ?? material.id,
+                message: "Dissolve version 1 does not support transient transparency or highlight passes.",
+            });
+    };
+    for (const mesh of collectMeshes(node))
+        check(mesh.material);
+}
+//# sourceMappingURL=node-tools.js.map

package/dist/inspection/node-tools.js.map

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

package/dist/interaction/runtime-third-person-controller.d.ts

@@ -0,0 +1,24 @@
+import type { RuntimeSession } from "../core/runtime-session.js";
+import { ThirdPersonController, type ThirdPersonAction, type ThirdPersonControllerOptions } from "./third-person-controller.js";
+export interface RuntimeThirdPersonControllerOptions extends ThirdPersonControllerOptions {
+    entityId: string;
+    enabled?: boolean;
+}
+/**
+ * Runtime-safe adapter that resolves the character, viewport camera and model
+ * animation groups from document/runtime identity instead of Babylon objects.
+ */
+export declare class RuntimeThirdPersonController {
+    #private;
+    readonly runtime: RuntimeSession;
+    readonly entityId: string;
+    readonly controller: ThirdPersonController;
+    constructor(runtime: RuntimeSession, options: RuntimeThirdPersonControllerOptions);
+    get enabled(): boolean;
+    enable(): void;
+    disable(): void;
+    setAction(action: ThirdPersonAction, active: boolean): void;
+    updateOptions(options: Partial<ThirdPersonControllerOptions>): void;
+    dispose(): void;
+}
+//# sourceMappingURL=runtime-third-person-controller.d.ts.map

package/dist/interaction/runtime-third-person-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-third-person-controller.d.ts","sourceRoot":"","sources":["../../src/interaction/runtime-third-person-controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EACL,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EAClC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mCAAoC,SAAQ,4BAA4B;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,4BAA4B;;IACvC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;gBAIzC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mCAAmC;IAmC9C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,MAAM,IAAI,IAAI;IAKd,OAAO,IAAI,IAAI;IAKf,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAK3D,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAAG,IAAI;IAKnE,OAAO,IAAI,IAAI;CAWhB"}

package/dist/interaction/runtime-third-person-controller.js

@@ -0,0 +1,71 @@
+/** Binds third-person interaction to one projected document entity. */
+import { TransformNode } from "@babylonjs/core/Meshes/transformNode";
+import { RUNTIME_NODES_CAPABILITY } from "../core/runtime-capability-registry.js";
+import { ThirdPersonController, } from "./third-person-controller.js";
+/**
+ * Runtime-safe adapter that resolves the character, viewport camera and model
+ * animation groups from document/runtime identity instead of Babylon objects.
+ */
+export class RuntimeThirdPersonController {
+    runtime;
+    entityId;
+    controller;
+    #disposed = false;
+    constructor(runtime, options) {
+        this.runtime = runtime;
+        this.entityId = options.entityId;
+        const character = runtime.capabilities
+            .require(RUNTIME_NODES_CAPABILITY)
+            .require(options.entityId);
+        if (!(character instanceof TransformNode)) {
+            throw new Error(`Third-person character must be transformable: ${options.entityId}`);
+        }
+        const camera = runtime.viewportCamera?.camera;
+        if (!camera)
+            throw new Error("Runtime viewport camera is not ready");
+        const targets = new Set([
+            character,
+            ...character.getDescendants(false),
+        ]);
+        const animationGroups = runtime.scene.animationGroups.filter((group) => group.targetedAnimations.some((animation) => targets.has(animation.target)));
+        const enabled = options.enabled ?? true;
+        const controllerOptions = { ...options };
+        delete controllerOptions.entityId;
+        delete controllerOptions.enabled;
+        this.controller = new ThirdPersonController(runtime.scene, controllerOptions);
+        this.controller.attach(character, camera, animationGroups);
+        if (!enabled)
+            this.controller.disable();
+    }
+    get enabled() {
+        return this.controller.enabled;
+    }
+    enable() {
+        this.#assertActive();
+        this.controller.enable();
+    }
+    disable() {
+        this.#assertActive();
+        this.controller.disable();
+    }
+    setAction(action, active) {
+        this.#assertActive();
+        this.controller.setAction(action, active);
+    }
+    updateOptions(options) {
+        this.#assertActive();
+        this.controller.updateOptions(options);
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.controller.dispose();
+        this.#disposed = true;
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("RuntimeThirdPersonController has been disposed");
+        }
+    }
+}
+//# sourceMappingURL=runtime-third-person-controller.js.map

package/dist/interaction/runtime-third-person-controller.js.map

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

package/dist/interaction/third-person-controller.d.ts

@@ -0,0 +1,61 @@
+/** Optional third-person runtime interaction; not part of the lightbox. */
+import type { AnimationGroup } from "@babylonjs/core/Animations/animationGroup";
+import type { ArcRotateCamera } from "@babylonjs/core/Cameras/arcRotateCamera";
+import { TransformNode } from "@babylonjs/core/Meshes/transformNode";
+import type { Scene } from "@babylonjs/core/scene";
+import type { Vector3Value } from "@skenora/contracts";
+export type ThirdPersonAction = "forward" | "backward" | "left" | "right";
+export interface ThirdPersonAnimationNames {
+    idle?: string;
+    forward?: string;
+    backward?: string;
+    left?: string;
+    right?: string;
+}
+export interface ThirdPersonControllerOptions {
+    cameraHeight?: number;
+    cameraDistance?: number;
+    minCameraDistance?: number;
+    maxCameraDistance?: number;
+    moveSpeed?: number;
+    turnSpeed?: number;
+    moveBoundsMin?: {
+        x: number;
+        z: number;
+    };
+    moveBoundsMax?: {
+        x: number;
+        z: number;
+    };
+    checkCollisions?: boolean;
+    ellipsoid?: Vector3Value;
+    ellipsoidOffset?: Vector3Value;
+    gravity?: boolean;
+    gravityAcceleration?: number;
+    maxFallSpeed?: number;
+    keyBindings?: Partial<Record<ThirdPersonAction, readonly string[]>>;
+    animations?: ThirdPersonAnimationNames;
+    onMove?: (position: Vector3Value, action: ThirdPersonAction | null) => void;
+    onAnimationChange?: (name: string | null) => void;
+}
+/**
+ * Orbit-camera third-person locomotion with injectable actions and callbacks.
+ * Keyboard input is optional; hosts may drive `setAction` directly.
+ */
+export declare class ThirdPersonController {
+    #private;
+    readonly scene: Scene;
+    constructor(scene: Scene, options?: ThirdPersonControllerOptions);
+    get enabled(): boolean;
+    get character(): TransformNode | null;
+    attach(character: TransformNode, camera: ArcRotateCamera, animationGroups?: readonly AnimationGroup[]): void;
+    detach(): void;
+    enable(): void;
+    disable(): void;
+    updateOptions(options: Partial<ThirdPersonControllerOptions>): void;
+    setAction(action: ThirdPersonAction, active: boolean): void;
+    resetInput(): void;
+    setCameraDistance(distance: number): void;
+    dispose(): void;
+}
+//# sourceMappingURL=third-person-controller.d.ts.map

package/dist/interaction/third-person-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"third-person-controller.d.ts","sourceRoot":"","sources":["../../src/interaction/third-person-controller.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAQ/E,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1E,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,aAAa,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACpE,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5E,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACnD;AAqCD;;;GAGG;AACH,qBAAa,qBAAqB;;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBA2BV,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,4BAAiC;IAMpE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,SAAS,IAAI,aAAa,GAAG,IAAI,CAEpC;IAED,MAAM,CACJ,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,eAAe,EACvB,eAAe,GAAE,SAAS,cAAc,EAAO,GAC9C,IAAI;IA4BP,MAAM,IAAI,IAAI;IAqBd,MAAM,IAAI,IAAI;IAed,OAAO,IAAI,IAAI;IAaf,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAAG,IAAI;IAiBnE,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAK3D,UAAU,IAAI,IAAI;IAMlB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWzC,OAAO,IAAI,IAAI;CA2MhB"}