react-three-game 0.0.41 → 0.0.42

package/README.md

@@ -6,23 +6,6 @@ JSON-first 3D game engine. React Three Fiber + WebGPU + Rapier Physics.
 npm i react-three-game @react-three/fiber @react-three/rapier three
 ```
 
-### CDN / UMD Build
-
-For use with script tags (no build tools):
-
-```html
-<script src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
-<script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
-<script src="https://unpkg.com/react-three-game@0.0.41/dist/index.umd.js"></script>
-
-<script>
-  const { ModelListViewer, SharedCanvas, TextureListViewer } = window.ReactThreeGame;
-  // Use components...
-</script>
-```
-
-See [docs/public/test-umd.html](docs/public/test-umd.html) for a complete example.
-
 ![Prefab Editor](assets/editor.gif)
 ![Architecture](assets/architecture.png)
 

package/dist/helpers/SoundManager.d.ts

@@ -0,0 +1,35 @@
+declare class SoundManager {
+    private static _instance;
+    context: AudioContext;
+    private buffers;
+    private masterGain;
+    private sfxGain;
+    private musicGain;
+    private constructor();
+    /** Singleton accessor */
+    static get instance(): SoundManager;
+    /** Required once after user gesture (browser) */
+    resume(): void;
+    /** Preload a sound from URL */
+    load(path: string, url: string): Promise<void>;
+    /** Play from already-loaded buffer (fails silently if not loaded) */
+    playSync(path: string, { volume, playbackRate, detune, pitch, }?: {
+        volume?: number;
+        playbackRate?: number;
+        detune?: number;
+        pitch?: number;
+    }): void;
+    /** Load and play SFX - accepts file path directly */
+    play(path: string, options?: {
+        volume?: number;
+        playbackRate?: number;
+        detune?: number;
+        pitch?: number;
+    }): Promise<void>;
+    /** Volume controls */
+    setMasterVolume(v: number): void;
+    setSfxVolume(v: number): void;
+    setMusicVolume(v: number): void;
+}
+export declare const sound: SoundManager;
+export {};

package/dist/helpers/SoundManager.js

@@ -0,0 +1,93 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+class SoundManager {
+    constructor() {
+        this.buffers = new Map();
+        const AudioCtx = window.AudioContext || window.webkitAudioContext;
+        this.context = new AudioCtx();
+        this.masterGain = this.context.createGain();
+        this.sfxGain = this.context.createGain();
+        this.musicGain = this.context.createGain();
+        this.sfxGain.connect(this.masterGain);
+        this.musicGain.connect(this.masterGain);
+        this.masterGain.connect(this.context.destination);
+        this.masterGain.gain.value = 1;
+        this.sfxGain.gain.value = 1;
+        this.musicGain.gain.value = 1;
+    }
+    /** Singleton accessor */
+    static get instance() {
+        if (typeof window === 'undefined') {
+            // Return a dummy instance for SSR
+            return new Proxy({}, {
+                get: () => () => { }
+            });
+        }
+        if (!SoundManager._instance) {
+            SoundManager._instance = new SoundManager();
+        }
+        return SoundManager._instance;
+    }
+    /** Required once after user gesture (browser) */
+    resume() {
+        if (this.context.state !== "running") {
+            this.context.resume();
+        }
+    }
+    /** Preload a sound from URL */
+    load(path, url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.buffers.has(path))
+                return;
+            const res = yield fetch(url);
+            const arrayBuffer = yield res.arrayBuffer();
+            const buffer = yield this.context.decodeAudioData(arrayBuffer);
+            this.buffers.set(path, buffer);
+        });
+    }
+    /** Play from already-loaded buffer (fails silently if not loaded) */
+    playSync(path, { volume = 1, playbackRate = 1, detune = 0, pitch = 1, } = {}) {
+        this.resume();
+        const buffer = this.buffers.get(path);
+        if (!buffer)
+            return;
+        const src = this.context.createBufferSource();
+        const gain = this.context.createGain();
+        src.buffer = buffer;
+        src.playbackRate.value = playbackRate * pitch;
+        src.detune.value = detune;
+        gain.gain.value = volume;
+        src.connect(gain);
+        gain.connect(this.sfxGain);
+        src.start();
+    }
+    /** Load and play SFX - accepts file path directly */
+    play(path, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Auto-load from path if not already loaded
+            if (!this.buffers.has(path)) {
+                yield this.load(path, path);
+            }
+            this.playSync(path, options);
+        });
+    }
+    /** Volume controls */
+    setMasterVolume(v) {
+        this.masterGain.gain.value = v;
+    }
+    setSfxVolume(v) {
+        this.sfxGain.gain.value = v;
+    }
+    setMusicVolume(v) {
+        this.musicGain.gain.value = v;
+    }
+}
+SoundManager._instance = null;
+export const sound = SoundManager.instance;

package/dist/helpers/index.d.ts

@@ -0,0 +1,35 @@
+import type { GameObject } from "../tools/prefabeditor/types";
+export type Vec3 = [number, number, number];
+export interface GroundOptions {
+    /** GameObject id. Defaults to "ground". */
+    id?: string;
+    /** Plane size. Defaults to 50. */
+    size?: number;
+    /** Transform overrides. */
+    position?: Vec3;
+    rotation?: Vec3;
+    scale?: Vec3;
+    /** Material overrides. */
+    color?: string;
+    texture?: string;
+    /** When true, set repeat wrapping. Defaults to true if texture is provided. */
+    repeat?: boolean;
+    /** Texture repeat counts when repeat=true. Defaults to [25,25]. */
+    repeatCount?: [number, number];
+    /** Physics body type. Defaults to "fixed". */
+    physicsType?: "fixed" | "dynamic" | "kinematic";
+    /** Set true to hide the node. */
+    hidden?: boolean;
+    /** Set true to disable the node. */
+    disabled?: boolean;
+}
+/**
+ * Create a ready-to-use plane ground GameObject.
+ *
+ * Designed to reduce prefab boilerplate:
+ * - Transform (rotated to lie flat)
+ * - Geometry (plane)
+ * - Material (optional texture + repeat)
+ * - Physics (fixed by default)
+ */
+export declare function ground(options?: GroundOptions): GameObject;

package/dist/helpers/index.js

@@ -0,0 +1,44 @@
+/**
+ * Create a ready-to-use plane ground GameObject.
+ *
+ * Designed to reduce prefab boilerplate:
+ * - Transform (rotated to lie flat)
+ * - Geometry (plane)
+ * - Material (optional texture + repeat)
+ * - Physics (fixed by default)
+ */
+export function ground(options = {}) {
+    const { id = "ground", size = 50, position = [0, 0, 0], rotation = [-Math.PI / 2, 0, 0], scale = [1, 1, 1], color = "white", texture, repeat = texture ? true : false, repeatCount = [25, 25], physicsType = "fixed", hidden = false, disabled = false, } = options;
+    return {
+        id,
+        disabled,
+        hidden,
+        components: {
+            transform: {
+                type: "Transform",
+                properties: {
+                    position,
+                    rotation,
+                    scale,
+                },
+            },
+            geometry: {
+                type: "Geometry",
+                properties: {
+                    geometryType: "plane",
+                    args: [size, size],
+                },
+            },
+            material: {
+                type: "Material",
+                properties: Object.assign(Object.assign({ color }, (texture ? { texture } : {})), (repeat ? { repeat: true, repeatCount } : {})),
+            },
+            physics: {
+                type: "Physics",
+                properties: {
+                    type: physicsType,
+                },
+            },
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { default as GameCanvas } from './shared/GameCanvas';
+export { default as PrefabEditor } from './tools/prefabeditor/PrefabEditor';
+export type { PrefabEditorRef } from './tools/prefabeditor/PrefabEditor';
+export { default as PrefabRoot } from './tools/prefabeditor/PrefabRoot';
+export type { PrefabRootRef } from './tools/prefabeditor/PrefabRoot';
+export { registerComponent } from './tools/prefabeditor/components/ComponentRegistry';
+export type { Component } from './tools/prefabeditor/components/ComponentRegistry';
+export type { Prefab, GameObject, ComponentData } from './tools/prefabeditor/types';
+export * as editorStyles from './tools/prefabeditor/styles';
+export * from './tools/prefabeditor/utils';
+export { DragDropLoader } from './tools/dragdrop/DragDropLoader';
+export { TextureListViewer, ModelListViewer, SoundListViewer, SharedCanvas, } from './tools/assetviewer/page';
+export { sound as soundManager } from './helpers/SoundManager';
+export * from './helpers';

package/dist/index.js

@@ -0,0 +1,14 @@
+// Core Components
+export { default as GameCanvas } from './shared/GameCanvas';
+// Prefab Editor
+export { default as PrefabEditor } from './tools/prefabeditor/PrefabEditor';
+export { default as PrefabRoot } from './tools/prefabeditor/PrefabRoot';
+export { registerComponent } from './tools/prefabeditor/components/ComponentRegistry';
+export * as editorStyles from './tools/prefabeditor/styles';
+export * from './tools/prefabeditor/utils';
+// Asset Tools
+export { DragDropLoader } from './tools/dragdrop/DragDropLoader';
+export { TextureListViewer, ModelListViewer, SoundListViewer, SharedCanvas, } from './tools/assetviewer/page';
+export { sound as soundManager } from './helpers/SoundManager';
+// Helpers
+export * from './helpers';