@relu-interactives/spatial-ecs 0.2.2

package/dist/systems/index.d.cts

@@ -0,0 +1,200 @@
+import { E as EcsSystem, b as World } from '../System-rXAmagXA.cjs';
+export { h as ComponentFactory, l as EcsComponentFactoryKind, I as InputSystem, K as KeyboardKey, q as KeyboardKeys, M as MouseButton, O as ObjectManagementSystem, R as RenderSystem, u as TransformSyncSystem } from '../System-rXAmagXA.cjs';
+import * as THREE from 'three';
+import '@dimforge/rapier3d-compat';
+
+declare class AnimationSystem implements EcsSystem {
+    private readonly runtimeByEntity;
+    private readonly gltfLoader;
+    private readonly fbxLoader;
+    private loadClipsFromSource;
+    private refreshExternalClipSources;
+    private release;
+    update(world: World, deltaTime: number): void;
+    dispose(): void;
+}
+
+declare class CameraSyncSystem implements EcsSystem {
+    private readonly signatures;
+    update(world: World): void;
+}
+
+declare class ObjectVisibilitySystem implements EcsSystem {
+    update(world: World): void;
+}
+
+declare class EnvironmentSyncSystem implements EcsSystem {
+    private readonly scene;
+    private readonly textureLoader;
+    private signature;
+    private activeTexture;
+    private pendingImageUrl;
+    constructor(scene: THREE.Scene);
+    private disposeActiveTexture;
+    private applySkybox;
+    private applyFog;
+    update(world: World): void;
+    dispose(): void;
+}
+
+declare class PostprocessingSyncSystem implements EcsSystem {
+    private readonly renderer;
+    private readonly scene;
+    private readonly camera;
+    private signature;
+    private composer;
+    private composerEnabled;
+    constructor(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.PerspectiveCamera);
+    private setComposerEnabled;
+    private disposeComposer;
+    private buildComposer;
+    update(world: World): void;
+    dispose(): void;
+}
+
+declare class PhysicsSyncSystem implements EcsSystem {
+    private readonly rigidBodyHandles;
+    private readonly colliderHandles;
+    private readonly rigidBodySignatures;
+    private readonly colliderSignatures;
+    private readonly isEditorMode;
+    private rapier;
+    private isBootstrappingWorld;
+    private accumulator;
+    constructor(options?: {
+        isEditor?: boolean;
+    });
+    private ensurePhysicsWorld;
+    private removeEntityPhysics;
+    update(world: World, deltaTime: number): void;
+    dispose(world: World): void;
+}
+
+declare class LightSyncSystem implements EcsSystem {
+    private readonly signatures;
+    update(world: World): void;
+}
+
+declare class MaterialSyncSystem implements EcsSystem {
+    private readonly signatures;
+    private readonly textureCache;
+    update(world: World): void;
+    dispose(): void;
+}
+
+declare class MeshGeometrySystem implements EcsSystem {
+    private readonly geometrySignatures;
+    private readonly shadowSignatures;
+    update(world: World): void;
+}
+
+type ModuleLoader = (scriptUrl: string) => Promise<Record<string, unknown>>;
+/**
+ * Optional context that enables raycast-based onSelect / onDeselect dispatch.
+ * When provided, pointer/touch taps on the canvas fire a raycast against the
+ * scene. If the hit object (or any ancestor) carries userData.entityId, every
+ * Behaviour instance for that entity receives onSelect(); the previously
+ * selected entity's instances receive onDeselect().
+ */
+type SelectionContext = {
+    camera: THREE.Camera;
+    scene: THREE.Scene;
+    domElement: HTMLElement;
+};
+declare class ScriptBehaviourSystem implements EcsSystem {
+    private instances;
+    private loading;
+    private readonly moduleLoader;
+    private readonly selectionCtx;
+    private readonly raycaster;
+    private readonly ndcPointer;
+    private selectedEntityId;
+    private pendingEntityId;
+    private pointerDownPos;
+    private static readonly CLICK_THRESHOLD;
+    constructor(moduleLoader?: ModuleLoader, selectionContext?: SelectionContext);
+    /** Walk up the object hierarchy to find the nearest userData.entityId. */
+    private resolveEntityId;
+    /** Convert client (screen) coordinates to normalised device coordinates. */
+    private toNdc;
+    /** Fire raycast and queue the result to be dispatched in the next update(). */
+    private queueRaycast;
+    private onPointerDown;
+    private onPointerUp;
+    /**
+     * Apply a queued selection change.
+     * Calls onDeselect() on all behaviours of the previous entity and
+     * onSelect() on all behaviours of the newly selected entity.
+     */
+    private applySelection;
+    update(world: World, deltaTime: number): void;
+    dispose(world: World): void;
+    private loadBehaviour;
+}
+
+/**
+ * Reconciles `AudioComponent` state with the underlying THREE.js audio objects
+ * each frame.
+ *
+ * **Playback** — drives `play()`, `pause()`, and `stop()` on the THREE.js
+ * audio node based on the `isPlaying` / `isPaused` flags set by
+ * `AudioComponent.play()`, `.pause()`, and `.stop()`.
+ *
+ * **Option sync** — detects changes to `loop`, `pitch`, `volume`,
+ * `refDistance`, `distanceModel`, and `rolloffFactor` and applies them live.
+ * Changes take effect on the next frame, so scripts and inspector edits during
+ * runtime are reflected without reloading the scene.
+ *
+ * Only active in **preview** mode (`isEditor: true` makes every update a
+ * no-op so the editor is unaffected).
+ *
+ * @category Systems
+ */
+declare class AudioSystem implements EcsSystem {
+    private readonly isEditor;
+    /** THREE.js `isPlaying` state captured at the end of the previous frame. */
+    private readonly prevPlayingState;
+    /** Snapshot of options applied in the previous frame, for change detection. */
+    private readonly prevOptions;
+    constructor({ isEditor }?: {
+        isEditor?: boolean;
+    });
+    update(world: World, _deltaTime: number): void;
+    /** Apply any changed options from the component to the THREE.js audio node. */
+    private _syncOptions;
+    dispose(_world: World): void;
+}
+
+/**
+ * Reconciles `VideoComponent` state with the underlying HTML video element
+ * and THREE.js mesh/material each frame.
+ *
+ * **Playback** — drives `play()`, `pause()`, and stop (pause + seek to 0) on
+ * the HTML `<video>` element based on the `isPlaying` / `isPaused` flags set
+ * by `VideoComponent.play()`, `.pause()`, and `.stop()`.
+ *
+ * **Option sync** — detects changes to `loop`, `volume`, `width`, `height`,
+ * and green-screen shader uniforms (`backgroundColor`, `similarity`,
+ * `smoothness`, `spill`) and applies them live without a scene reload.
+ *
+ * Only active in **preview** mode (`isEditor: true` makes every update a
+ * no-op so the editor is unaffected).
+ *
+ * @category Systems
+ */
+declare class VideoSystem implements EcsSystem {
+    private readonly isEditor;
+    /** Playback intent captured at the end of the previous frame. */
+    private readonly prevIntent;
+    /** Snapshot of options applied in the previous frame, for change detection. */
+    private readonly prevOptions;
+    constructor({ isEditor }?: {
+        isEditor?: boolean;
+    });
+    update(world: World, _deltaTime: number): void;
+    /** Apply any changed options from the component to the video element and mesh. */
+    private _syncOptions;
+    dispose(_world: World): void;
+}
+
+export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, ScriptBehaviourSystem, type SelectionContext, VideoSystem };

package/dist/systems/index.d.ts

@@ -0,0 +1,200 @@
+import { E as EcsSystem, b as World } from '../System-rXAmagXA.js';
+export { h as ComponentFactory, l as EcsComponentFactoryKind, I as InputSystem, K as KeyboardKey, q as KeyboardKeys, M as MouseButton, O as ObjectManagementSystem, R as RenderSystem, u as TransformSyncSystem } from '../System-rXAmagXA.js';
+import * as THREE from 'three';
+import '@dimforge/rapier3d-compat';
+
+declare class AnimationSystem implements EcsSystem {
+    private readonly runtimeByEntity;
+    private readonly gltfLoader;
+    private readonly fbxLoader;
+    private loadClipsFromSource;
+    private refreshExternalClipSources;
+    private release;
+    update(world: World, deltaTime: number): void;
+    dispose(): void;
+}
+
+declare class CameraSyncSystem implements EcsSystem {
+    private readonly signatures;
+    update(world: World): void;
+}
+
+declare class ObjectVisibilitySystem implements EcsSystem {
+    update(world: World): void;
+}
+
+declare class EnvironmentSyncSystem implements EcsSystem {
+    private readonly scene;
+    private readonly textureLoader;
+    private signature;
+    private activeTexture;
+    private pendingImageUrl;
+    constructor(scene: THREE.Scene);
+    private disposeActiveTexture;
+    private applySkybox;
+    private applyFog;
+    update(world: World): void;
+    dispose(): void;
+}
+
+declare class PostprocessingSyncSystem implements EcsSystem {
+    private readonly renderer;
+    private readonly scene;
+    private readonly camera;
+    private signature;
+    private composer;
+    private composerEnabled;
+    constructor(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.PerspectiveCamera);
+    private setComposerEnabled;
+    private disposeComposer;
+    private buildComposer;
+    update(world: World): void;
+    dispose(): void;
+}
+
+declare class PhysicsSyncSystem implements EcsSystem {
+    private readonly rigidBodyHandles;
+    private readonly colliderHandles;
+    private readonly rigidBodySignatures;
+    private readonly colliderSignatures;
+    private readonly isEditorMode;
+    private rapier;
+    private isBootstrappingWorld;
+    private accumulator;
+    constructor(options?: {
+        isEditor?: boolean;
+    });
+    private ensurePhysicsWorld;
+    private removeEntityPhysics;
+    update(world: World, deltaTime: number): void;
+    dispose(world: World): void;
+}
+
+declare class LightSyncSystem implements EcsSystem {
+    private readonly signatures;
+    update(world: World): void;
+}
+
+declare class MaterialSyncSystem implements EcsSystem {
+    private readonly signatures;
+    private readonly textureCache;
+    update(world: World): void;
+    dispose(): void;
+}
+
+declare class MeshGeometrySystem implements EcsSystem {
+    private readonly geometrySignatures;
+    private readonly shadowSignatures;
+    update(world: World): void;
+}
+
+type ModuleLoader = (scriptUrl: string) => Promise<Record<string, unknown>>;
+/**
+ * Optional context that enables raycast-based onSelect / onDeselect dispatch.
+ * When provided, pointer/touch taps on the canvas fire a raycast against the
+ * scene. If the hit object (or any ancestor) carries userData.entityId, every
+ * Behaviour instance for that entity receives onSelect(); the previously
+ * selected entity's instances receive onDeselect().
+ */
+type SelectionContext = {
+    camera: THREE.Camera;
+    scene: THREE.Scene;
+    domElement: HTMLElement;
+};
+declare class ScriptBehaviourSystem implements EcsSystem {
+    private instances;
+    private loading;
+    private readonly moduleLoader;
+    private readonly selectionCtx;
+    private readonly raycaster;
+    private readonly ndcPointer;
+    private selectedEntityId;
+    private pendingEntityId;
+    private pointerDownPos;
+    private static readonly CLICK_THRESHOLD;
+    constructor(moduleLoader?: ModuleLoader, selectionContext?: SelectionContext);
+    /** Walk up the object hierarchy to find the nearest userData.entityId. */
+    private resolveEntityId;
+    /** Convert client (screen) coordinates to normalised device coordinates. */
+    private toNdc;
+    /** Fire raycast and queue the result to be dispatched in the next update(). */
+    private queueRaycast;
+    private onPointerDown;
+    private onPointerUp;
+    /**
+     * Apply a queued selection change.
+     * Calls onDeselect() on all behaviours of the previous entity and
+     * onSelect() on all behaviours of the newly selected entity.
+     */
+    private applySelection;
+    update(world: World, deltaTime: number): void;
+    dispose(world: World): void;
+    private loadBehaviour;
+}
+
+/**
+ * Reconciles `AudioComponent` state with the underlying THREE.js audio objects
+ * each frame.
+ *
+ * **Playback** — drives `play()`, `pause()`, and `stop()` on the THREE.js
+ * audio node based on the `isPlaying` / `isPaused` flags set by
+ * `AudioComponent.play()`, `.pause()`, and `.stop()`.
+ *
+ * **Option sync** — detects changes to `loop`, `pitch`, `volume`,
+ * `refDistance`, `distanceModel`, and `rolloffFactor` and applies them live.
+ * Changes take effect on the next frame, so scripts and inspector edits during
+ * runtime are reflected without reloading the scene.
+ *
+ * Only active in **preview** mode (`isEditor: true` makes every update a
+ * no-op so the editor is unaffected).
+ *
+ * @category Systems
+ */
+declare class AudioSystem implements EcsSystem {
+    private readonly isEditor;
+    /** THREE.js `isPlaying` state captured at the end of the previous frame. */
+    private readonly prevPlayingState;
+    /** Snapshot of options applied in the previous frame, for change detection. */
+    private readonly prevOptions;
+    constructor({ isEditor }?: {
+        isEditor?: boolean;
+    });
+    update(world: World, _deltaTime: number): void;
+    /** Apply any changed options from the component to the THREE.js audio node. */
+    private _syncOptions;
+    dispose(_world: World): void;
+}
+
+/**
+ * Reconciles `VideoComponent` state with the underlying HTML video element
+ * and THREE.js mesh/material each frame.
+ *
+ * **Playback** — drives `play()`, `pause()`, and stop (pause + seek to 0) on
+ * the HTML `<video>` element based on the `isPlaying` / `isPaused` flags set
+ * by `VideoComponent.play()`, `.pause()`, and `.stop()`.
+ *
+ * **Option sync** — detects changes to `loop`, `volume`, `width`, `height`,
+ * and green-screen shader uniforms (`backgroundColor`, `similarity`,
+ * `smoothness`, `spill`) and applies them live without a scene reload.
+ *
+ * Only active in **preview** mode (`isEditor: true` makes every update a
+ * no-op so the editor is unaffected).
+ *
+ * @category Systems
+ */
+declare class VideoSystem implements EcsSystem {
+    private readonly isEditor;
+    /** Playback intent captured at the end of the previous frame. */
+    private readonly prevIntent;
+    /** Snapshot of options applied in the previous frame, for change detection. */
+    private readonly prevOptions;
+    constructor({ isEditor }?: {
+        isEditor?: boolean;
+    });
+    update(world: World, _deltaTime: number): void;
+    /** Apply any changed options from the component to the video element and mesh. */
+    private _syncOptions;
+    dispose(_world: World): void;
+}
+
+export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, ScriptBehaviourSystem, type SelectionContext, VideoSystem };

package/dist/systems/index.js

@@ -0,0 +1,6 @@
+export { AnimationSystem, AudioSystem, CameraSyncSystem, EnvironmentSyncSystem, InputSystem, KeyboardKeys, LightSyncSystem, MaterialSyncSystem, MeshGeometrySystem, ObjectVisibilitySystem, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, ScriptBehaviourSystem, TransformSyncSystem, VideoSystem } from '../chunk-P2YDX5DB.js';
+export { ObjectManagementSystem } from '../chunk-AYEF3X2P.js';
+import '../chunk-MAWBTMCG.js';
+import '../chunk-OY7ZODZP.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/systems/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/types.d.cts

@@ -0,0 +1,3 @@
+import 'three';
+export { A as AssetInput, f as CheckboxInput, g as ColorInput, i as ComponentInput, j as ComponentKind, D as DropdownInput, k as DropdownOption, m as EcsEntityEditorKind, e as EcsEntityKind, n as EntityId, o as EntityInput, F as FloatInput, p as IntersectionResult, d as ParentLookup, S as SelectionListener, r as SliderInput, s as TextInput, t as ToggleInput, v as Vec3, w as Vector2Input, x as Vector3Input, W as WorldEntityView } from './System-rXAmagXA.cjs';
+import '@dimforge/rapier3d-compat';

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+import 'three';
+export { A as AssetInput, f as CheckboxInput, g as ColorInput, i as ComponentInput, j as ComponentKind, D as DropdownInput, k as DropdownOption, m as EcsEntityEditorKind, e as EcsEntityKind, n as EntityId, o as EntityInput, F as FloatInput, p as IntersectionResult, d as ParentLookup, S as SelectionListener, r as SliderInput, s as TextInput, t as ToggleInput, v as Vec3, w as Vector2Input, x as Vector3Input, W as WorldEntityView } from './System-rXAmagXA.js';
+import '@dimforge/rapier3d-compat';

package/dist/types.js

@@ -0,0 +1,3 @@
+import './chunk-QHILSPT4.js';
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}