@nice2dev/ui-3d 1.3.14 → 1.3.16

package/dist/esm/collaborative/collaborativeScene.js

@@ -1,213 +1,171 @@
-/**
- * Collaborative 3D Scene — Multi-user 3D scene editing via Yjs CRDT + WebRTC data channel.
- *
- * Pattern follows collaborativeDiagram.ts / collaborativePresentation.ts:
- * - Yjs document with shared types (YMap, YArray)
- * - Awareness protocol for cursor/selection presence
- * - Provider abstraction (WebRTC, WebSocket, IndexedDB)
- * - UndoManager integration
- *
- * @module @nice2dev/ui-3d/collaborative
- */
-/* ================================================================
-   SYNC HELPERS
-   ================================================================ */
-/** Convert a Yjs objects map to SharedSceneObject[]. */
 function syncYjsToScene(objectsMap) {
-    const json = objectsMap.toJSON();
-    return Object.values(json);
+  const json = objectsMap.toJSON();
+  return Object.values(json);
 }
-/** Write SharedSceneObject[] into Yjs objects map. */
 function syncSceneToYjs(objects, objectsMap, doc) {
-    doc.transact(() => {
-        // Remove objects not in the new list
-        const newIds = new Set(objects.map((o) => o.id));
-        const existing = objectsMap.toJSON();
-        for (const key of Object.keys(existing)) {
-            if (!newIds.has(key)) {
-                objectsMap.delete(key);
-            }
-        }
-        // Upsert
-        for (const obj of objects) {
-            objectsMap.set(obj.id, obj);
-        }
-    });
+  doc.transact(() => {
+    const newIds = new Set(objects.map((o) => o.id));
+    const existing = objectsMap.toJSON();
+    for (const key of Object.keys(existing)) {
+      if (!newIds.has(key)) {
+        objectsMap.delete(key);
+      }
+    }
+    for (const obj of objects) {
+      objectsMap.set(obj.id, obj);
+    }
+  });
 }
-/**
- * useCollaborativeScene — Yjs-powered multi-user 3D scene editing.
- *
- * Usage:
- * ```ts
- * const { state, actions } = useCollaborativeScene({
- *   createYDoc: () => new Y.Doc(),
- *   createProvider: (doc, cfg) => new WebrtcProvider(cfg.room, doc),
- *   createUndoManager: (scope) => new Y.UndoManager(scope),
- *   providerConfig: { type: 'webrtc', room: 'scene-1' },
- *   user: { id: 'u1', name: 'Alice', color: 'var(--nice-danger, #e74c3c)' },
- * });
- * ```
- */
 function useCollaborativeScene(options) {
-    // This follows the exact same architecture as useCollaborativePresentation.
-    // Implementation uses React refs for YDoc/provider and useState for reactive state.
-    // All mutations go through doc.transact() for atomicity.
-    const { createYDoc, createProvider, createUndoManager, providerConfig, user, initialObjects } = options;
-    // Lazy-init refs (avoid re-creation on re-render)
-    let docRef = null;
-    let providerRef = null;
-    let undoRef = null;
-    // State (would use useState in real React hook — simplified for pure TS export)
-    const stateSnapshot = {
-        objects: initialObjects !== null && initialObjects !== void 0 ? initialObjects : [],
-        collaborators: [],
-        collaboratorSelections: new Map(),
-        collaboratorTransforming: new Map(),
-        collaboratorCameras: new Map(),
-        connected: false,
-        synced: false,
-    };
-    function getDoc() {
-        if (!docRef) {
-            docRef = createYDoc();
-        }
-        return docRef;
-    }
-    function getObjectsMap() {
-        return getDoc().getMap('objects');
+  const { createYDoc, createProvider, createUndoManager, providerConfig, user, initialObjects } = options;
+  let docRef = null;
+  let providerRef = null;
+  let undoRef = null;
+  const stateSnapshot = {
+    objects: initialObjects ?? [],
+    collaborators: [],
+    collaboratorSelections: /* @__PURE__ */ new Map(),
+    collaboratorTransforming: /* @__PURE__ */ new Map(),
+    collaboratorCameras: /* @__PURE__ */ new Map(),
+    connected: false,
+    synced: false
+  };
+  function getDoc() {
+    if (!docRef) {
+      docRef = createYDoc();
     }
-    // ── Actions ─────────────────────────────────────────────
-    function generateId() {
-        return `obj_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+    return docRef;
+  }
+  function getObjectsMap() {
+    return getDoc().getMap("objects");
+  }
+  function generateId() {
+    return `obj_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+  }
+  const actions = {
+    addObject(obj) {
+      const id = generateId();
+      const full = { ...obj, id };
+      getDoc().transact(() => {
+        getObjectsMap().set(id, full);
+      });
+      return id;
+    },
+    updateObject(id, patch) {
+      const map = getObjectsMap();
+      const existing = map.get(id);
+      if (!existing) {
+        return;
+      }
+      getDoc().transact(() => {
+        map.set(id, { ...existing, ...patch, id });
+      });
+    },
+    deleteObject(id) {
+      getDoc().transact(() => {
+        getObjectsMap().delete(id);
+      });
+    },
+    reparentObject(id, newParentId) {
+      actions.updateObject(id, { parentId: newParentId });
+    },
+    setTransform(id, transform) {
+      actions.updateObject(id, { transform });
+    },
+    setVisibility(id, visible) {
+      actions.updateObject(id, { visible });
+    },
+    setMaterial(id, material) {
+      actions.updateObject(id, { material });
+    },
+    setSelectedObjects(ids) {
+      providerRef?.awareness.setLocalStateField("selectedObjects", ids);
+    },
+    setTransformingObject(id) {
+      providerRef?.awareness.setLocalStateField("transformingObject", id);
+    },
+    setCamera(cam) {
+      providerRef?.awareness.setLocalStateField("camera", cam);
+    },
+    undo() {
+      undoRef?.undo();
+    },
+    redo() {
+      undoRef?.redo();
+    },
+    get canUndo() {
+      return undoRef?.canUndo() ?? false;
+    },
+    get canRedo() {
+      return undoRef?.canRedo() ?? false;
+    },
+    async connect() {
+      const doc = getDoc();
+      const objectsMap = getObjectsMap();
+      if (initialObjects && objectsMap.toJSON() && Object.keys(objectsMap.toJSON()).length === 0) {
+        syncSceneToYjs(initialObjects, objectsMap, doc);
+      }
+      providerRef = createProvider(doc, providerConfig);
+      providerRef.awareness.setLocalState({
+        user,
+        selectedObjects: [],
+        transformingObject: null,
+        camera: null
+      });
+      undoRef = createUndoManager([objectsMap]);
+      objectsMap.observe(() => {
+        stateSnapshot.objects = syncYjsToScene(objectsMap);
+      });
+      providerRef.awareness.on("change", () => {
+        const states = providerRef.awareness.getStates();
+        const collabs = [];
+        const selections = /* @__PURE__ */ new Map();
+        const transforming = /* @__PURE__ */ new Map();
+        const cameras = /* @__PURE__ */ new Map();
+        states.forEach((s, clientId) => {
+          if (clientId === providerRef.awareness.clientID) {
+            return;
+          }
+          const state = s;
+          if (state.user) {
+            collabs.push(state.user);
+          }
+          if (state.selectedObjects) {
+            selections.set(clientId, state.selectedObjects);
+          }
+          if (state.transformingObject !== void 0) {
+            transforming.set(clientId, state.transformingObject);
+          }
+          if (state.camera) {
+            cameras.set(clientId, state.camera);
+          }
+        });
+        stateSnapshot.collaborators = collabs;
+        stateSnapshot.collaboratorSelections = selections;
+        stateSnapshot.collaboratorTransforming = transforming;
+        stateSnapshot.collaboratorCameras = cameras;
+      });
+      providerRef.on("synced", () => {
+        stateSnapshot.synced = true;
+      });
+      await providerRef.connect();
+      stateSnapshot.connected = true;
+    },
+    disconnect() {
+      providerRef?.disconnect();
+      providerRef?.destroy();
+      providerRef = null;
+      undoRef = null;
+      docRef?.destroy();
+      docRef = null;
+      stateSnapshot.connected = false;
+      stateSnapshot.synced = false;
     }
-    const actions = {
-        addObject(obj) {
-            const id = generateId();
-            const full = { ...obj, id };
-            getDoc().transact(() => {
-                getObjectsMap().set(id, full);
-            });
-            return id;
-        },
-        updateObject(id, patch) {
-            const map = getObjectsMap();
-            const existing = map.get(id);
-            if (!existing) {
-                return;
-            }
-            getDoc().transact(() => {
-                map.set(id, { ...existing, ...patch, id });
-            });
-        },
-        deleteObject(id) {
-            getDoc().transact(() => {
-                getObjectsMap().delete(id);
-            });
-        },
-        reparentObject(id, newParentId) {
-            actions.updateObject(id, { parentId: newParentId });
-        },
-        setTransform(id, transform) {
-            actions.updateObject(id, { transform });
-        },
-        setVisibility(id, visible) {
-            actions.updateObject(id, { visible });
-        },
-        setMaterial(id, material) {
-            actions.updateObject(id, { material });
-        },
-        setSelectedObjects(ids) {
-            providerRef === null || providerRef === void 0 ? void 0 : providerRef.awareness.setLocalStateField('selectedObjects', ids);
-        },
-        setTransformingObject(id) {
-            providerRef === null || providerRef === void 0 ? void 0 : providerRef.awareness.setLocalStateField('transformingObject', id);
-        },
-        setCamera(cam) {
-            providerRef === null || providerRef === void 0 ? void 0 : providerRef.awareness.setLocalStateField('camera', cam);
-        },
-        undo() {
-            undoRef === null || undoRef === void 0 ? void 0 : undoRef.undo();
-        },
-        redo() {
-            undoRef === null || undoRef === void 0 ? void 0 : undoRef.redo();
-        },
-        get canUndo() {
-            var _a;
-            return (_a = undoRef === null || undoRef === void 0 ? void 0 : undoRef.canUndo()) !== null && _a !== void 0 ? _a : false;
-        },
-        get canRedo() {
-            var _a;
-            return (_a = undoRef === null || undoRef === void 0 ? void 0 : undoRef.canRedo()) !== null && _a !== void 0 ? _a : false;
-        },
-        async connect() {
-            const doc = getDoc();
-            const objectsMap = getObjectsMap();
-            // Seed initial objects
-            if (initialObjects && objectsMap.toJSON() && Object.keys(objectsMap.toJSON()).length === 0) {
-                syncSceneToYjs(initialObjects, objectsMap, doc);
-            }
-            // Create provider
-            providerRef = createProvider(doc, providerConfig);
-            // Set awareness
-            providerRef.awareness.setLocalState({
-                user,
-                selectedObjects: [],
-                transformingObject: null,
-                camera: null,
-            });
-            // Create undo manager
-            undoRef = createUndoManager([objectsMap]);
-            // Listen for changes
-            objectsMap.observe(() => {
-                stateSnapshot.objects = syncYjsToScene(objectsMap);
-            });
-            providerRef.awareness.on('change', () => {
-                const states = providerRef.awareness.getStates();
-                const collabs = [];
-                const selections = new Map();
-                const transforming = new Map();
-                const cameras = new Map();
-                states.forEach((s, clientId) => {
-                    if (clientId === providerRef.awareness.clientID) {
-                        return;
-                    }
-                    const state = s;
-                    if (state.user) {
-                        collabs.push(state.user);
-                    }
-                    if (state.selectedObjects) {
-                        selections.set(clientId, state.selectedObjects);
-                    }
-                    if (state.transformingObject !== undefined) {
-                        transforming.set(clientId, state.transformingObject);
-                    }
-                    if (state.camera) {
-                        cameras.set(clientId, state.camera);
-                    }
-                });
-                stateSnapshot.collaborators = collabs;
-                stateSnapshot.collaboratorSelections = selections;
-                stateSnapshot.collaboratorTransforming = transforming;
-                stateSnapshot.collaboratorCameras = cameras;
-            });
-            providerRef.on('synced', () => {
-                stateSnapshot.synced = true;
-            });
-            await providerRef.connect();
-            stateSnapshot.connected = true;
-        },
-        disconnect() {
-            providerRef === null || providerRef === void 0 ? void 0 : providerRef.disconnect();
-            providerRef === null || providerRef === void 0 ? void 0 : providerRef.destroy();
-            providerRef = null;
-            undoRef = null;
-            docRef === null || docRef === void 0 ? void 0 : docRef.destroy();
-            docRef = null;
-            stateSnapshot.connected = false;
-            stateSnapshot.synced = false;
-        },
-    };
-    return { state: stateSnapshot, actions };
+  };
+  return { state: stateSnapshot, actions };
 }
-
-export { syncSceneToYjs, syncYjsToScene, useCollaborativeScene };
+export {
+  syncSceneToYjs,
+  syncYjsToScene,
+  useCollaborativeScene
+};

package/dist/esm/core/editorAsk.js

@@ -1,45 +1,58 @@
-import { jsx } from 'react/jsx-runtime';
-import { NiceConfirmDialog, NicePromptDialog } from '@nice2dev/ui';
-import { useState, useRef, useCallback } from 'react';
-
-/**
- * The library's dialogs in place of `window.prompt` / `window.confirm` for the editor hooks,
- * which hold state but render nothing: `ask` resolves with the answer (`null` when cancelled)
- * and `pendingAsk` is the open question, for the editor component to pass to
- * {@link EditorAskDialog}. One question at a time: a new one settles the open one as cancelled.
- */
+import { jsx } from "react/jsx-runtime";
+import { NiceConfirmDialog, NicePromptDialog } from "@nice2dev/ui";
+import { useState, useRef, useCallback } from "react";
 function useEditorAsk() {
-    const [pendingAsk, setPendingAsk] = useState(null);
-    const pendingRef = useRef(null);
-    const ask = useCallback((kind, text, defaultValue) => new Promise((resolve) => {
-        var _a;
-        (_a = pendingRef.current) === null || _a === void 0 ? void 0 : _a.answer(null);
-        const next = {
-            kind,
-            text,
-            defaultValue,
-            answer: (value) => {
-                if (pendingRef.current === next) {
-                    pendingRef.current = null;
-                    setPendingAsk(null);
-                }
-                resolve(value);
-            },
-        };
-        pendingRef.current = next;
-        setPendingAsk(next);
-    }), []);
-    return { pendingAsk, ask };
+  const [pendingAsk, setPendingAsk] = useState(null);
+  const pendingRef = useRef(null);
+  const ask = useCallback(
+    (kind, text, defaultValue) => new Promise((resolve) => {
+      pendingRef.current?.answer(null);
+      const next = {
+        kind,
+        text,
+        defaultValue,
+        answer: (value) => {
+          if (pendingRef.current === next) {
+            pendingRef.current = null;
+            setPendingAsk(null);
+          }
+          resolve(value);
+        }
+      };
+      pendingRef.current = next;
+      setPendingAsk(next);
+    }),
+    []
+  );
+  return { pendingAsk, ask };
 }
-/** Shows the question {@link useEditorAsk} is waiting on, if any. */
 const EditorAskDialog = ({ ask }) => {
-    if (!ask) {
-        return null;
+  if (!ask) {
+    return null;
+  }
+  if (ask.kind === "confirm") {
+    return /* @__PURE__ */ jsx(
+      NiceConfirmDialog,
+      {
+        visible: true,
+        message: ask.text,
+        onAccept: () => ask.answer(""),
+        onReject: () => ask.answer(null)
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    NicePromptDialog,
+    {
+      open: true,
+      title: ask.text,
+      defaultValue: ask.defaultValue,
+      onSubmit: (value) => ask.answer(value),
+      onCancel: () => ask.answer(null)
     }
-    if (ask.kind === 'confirm') {
-        return (jsx(NiceConfirmDialog, { visible: true, message: ask.text, onAccept: () => ask.answer(''), onReject: () => ask.answer(null) }));
-    }
-    return (jsx(NicePromptDialog, { open: true, title: ask.text, defaultValue: ask.defaultValue, onSubmit: (value) => ask.answer(value), onCancel: () => ask.answer(null) }));
+  );
+};
+export {
+  EditorAskDialog,
+  useEditorAsk
 };
-
-export { EditorAskDialog, useEditorAsk };

package/dist/esm/core/i18n.js

@@ -1,16 +1,18 @@
-import { jsx } from 'react/jsx-runtime';
-import { useNiceTranslation as useNiceTranslation$1 } from '@nice2dev/ui';
-import { useContext, useMemo, createContext } from 'react';
-
-/** `null` outside this package's provider: the global translator applies. */
+import { jsx } from "react/jsx-runtime";
+import { useNiceTranslation as useNiceTranslation$1 } from "@nice2dev/ui";
+import { useContext, useMemo, createContext } from "react";
 const NiceI18nContext = /* @__PURE__ */ createContext(null);
-/** Overrides the app's global translator for the 3D controls below it. */
-const NiceI18nProvider = ({ t, children }) => (jsx(NiceI18nContext.Provider, { value: t, children: children }));
+const NiceI18nProvider = ({ t, children }) => /* @__PURE__ */ jsx(NiceI18nContext.Provider, { value: t, children });
 function useNiceTranslation() {
-    const own = useContext(NiceI18nContext);
-    const { t: global } = useNiceTranslation$1();
-    const t = useMemo(() => own !== null && own !== void 0 ? own : ((key, defaultValue) => global(key, defaultValue)), [own, global]);
-    return { t };
+  const own = useContext(NiceI18nContext);
+  const { t: global } = useNiceTranslation$1();
+  const t = useMemo(
+    () => own ?? ((key, defaultValue) => global(key, defaultValue)),
+    [own, global]
+  );
+  return { t };
 }
-
-export { NiceI18nProvider, useNiceTranslation };
+export {
+  NiceI18nProvider,
+  useNiceTranslation
+};

package/dist/esm/core/threeCompat.js

@@ -1,30 +1,22 @@
-import * as THREE from 'three';
-
-/**
- * three.js r183 deprecated `Clock` (for `Timer`) and folds `PCFSoftShadowMap` into
- * `PCFShadowMap`; both log a console warning there. The peer range starts at r150, which has
- * neither `Timer` in its core nor the softer `PCFShadowMap`, so the choice follows the revision.
- */
+import * as THREE from "three";
 const REVISION = Number.parseInt(THREE.REVISION, 10);
 const MODERN = REVISION >= 183;
-/** Soft shadows without the r183 deprecation warning; older three keeps `PCFSoftShadowMap`. */
-const SOFT_SHADOW_MAP = MODERN
-    ? THREE.PCFShadowMap
-    : THREE.PCFSoftShadowMap;
-/** `Timer` where three has deprecated `Clock`, `Clock` before. */
+const SOFT_SHADOW_MAP = MODERN ? THREE.PCFShadowMap : THREE.PCFSoftShadowMap;
 function createFrameClock() {
-    const TimerCtor = THREE.Timer;
-    if (MODERN && TimerCtor) {
-        const timer = new TimerCtor();
-        return {
-            getDelta: () => {
-                timer.update();
-                return timer.getDelta();
-            },
-        };
-    }
-    const clock = new THREE.Clock();
-    return { getDelta: () => clock.getDelta() };
+  const TimerCtor = THREE.Timer;
+  if (MODERN && TimerCtor) {
+    const timer = new TimerCtor();
+    return {
+      getDelta: () => {
+        timer.update();
+        return timer.getDelta();
+      }
+    };
+  }
+  const clock = new THREE.Clock();
+  return { getDelta: () => clock.getDelta() };
 }
-
-export { SOFT_SHADOW_MAP, createFrameClock };
+export {
+  SOFT_SHADOW_MAP,
+  createFrameClock
+};