@nice2dev/ui-3d 1.2.1 → 1.2.2

package/dist/esm/model/useModelEditor.js

@@ -22,6 +22,7 @@ import { SVGLoader } from 'three/examples/jsm/loaders/SVGLoader.js';
 import { TDSLoader } from 'three/examples/jsm/loaders/TDSLoader.js';
 import { VTKLoader } from 'three/examples/jsm/loaders/VTKLoader.js';
 import { useEditorAsk } from '../core/editorAsk.js';
+import { useNiceTranslation } from '../core/i18n.js';
 import { createFrameClock, SOFT_SHADOW_MAP } from '../core/threeCompat.js';
 import { SUPPORTED_EXTENSIONS, pose3dToClip } from './modelEditorTypes.js';
 import { UndoRedoStack, createMaterialFromPreset, generateLOD, convertToInstanced, applyHDRIPreset, snapMulti, HDRI_PRESETS, PBR_PRESETS } from './modelEditorUtils.js';
@@ -55,6 +56,7 @@ function findNodeById(nodes, id) {
    ═══════════════════════════════════════════ */
 function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
     var _a;
+    const { t } = useNiceTranslation();
     const { pendingAsk, ask } = useEditorAsk();
     /* ── refs ── */
     const mountRef = useRef(null);
@@ -394,14 +396,16 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         }
         focusOnObjectRef.current(obj);
         rebuildTree();
-        setStatusText(`Loaded: ${filename} (${clips.length} animation(s))`);
-    }, [rebuildTree]);
+        setStatusText(t('useModelEditor.loadedAnimationS', 'Loaded: {filename} ({clips} animation(s))')
+            .replace('{filename}', String(filename))
+            .replace('{clips}', String(clips.length)));
+    }, [rebuildTree, t]);
     const loadFile = useCallback(async (file) => {
         var _a, _b, _c, _d, _e, _f;
         const name = file.name.toLowerCase();
         const ext = '.' + name.split('.').pop();
         const url = URL.createObjectURL(file);
-        setStatusText(`Loading ${file.name}...`);
+        setStatusText(t('useModelEditor.loading', 'Loading {name}...').replace('{name}', String(file.name)));
         try {
             if (ext === '.fbx') {
                 const loader = new FBXLoader();
@@ -525,32 +529,34 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
                 addObjectToScene(group, [], file.name);
             }
             else {
-                setStatusText(`Unsupported format: ${ext}`);
+                setStatusText(t('useModelEditor.unsupportedFormat', 'Unsupported format: {ext}').replace('{ext}', String(ext)));
             }
         }
         catch (err) {
             log.error('Load error:', err);
-            setStatusText(`Error loading ${file.name}: ${String(err)}`);
+            setStatusText(t('useModelEditor.errorLoading', 'Error loading {name}: {err}')
+                .replace('{name}', String(file.name))
+                .replace('{err}', String(String(err))));
         }
         finally {
             URL.revokeObjectURL(url);
         }
-    }, [addObjectToScene]);
+    }, [addObjectToScene, t]);
     const mergeAnimationFBX = useCallback(async (file) => {
         var _a;
         const url = URL.createObjectURL(file);
-        setStatusText(`Merging animations from ${file.name}...`);
+        setStatusText(t('useModelEditor.mergingAnimationsFrom', 'Merging animations from {name}...').replace('{name}', String(file.name)));
         try {
             const loader = new FBXLoader();
             const obj = await new Promise((res, rej) => loader.load(url, res, undefined, rej));
             const clips = (_a = obj.animations) !== null && _a !== void 0 ? _a : [];
             if (clips.length === 0) {
-                setStatusText(`No animations found in ${file.name}`);
+                setStatusText(t('useModelEditor.noAnimationsFoundIn', 'No animations found in {name}').replace('{name}', String(file.name)));
                 return;
             }
             const root = rootObjectRef.current;
             if (!root) {
-                setStatusText('No model loaded — load a base model first');
+                setStatusText(t('useModelEditor.noModelLoadedLoadA', 'No model loaded — load a base model first'));
                 return;
             }
             if (!mixerRef.current) {
@@ -564,16 +570,20 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             }));
             allClipsRef.current = [...allClipsRef.current, ...newAnims];
             setAnimations([...allClipsRef.current]);
-            setStatusText(`Merged ${clips.length} animation(s) from ${file.name}`);
+            setStatusText(t('useModelEditor.mergedAnimationSFrom', 'Merged {clips} animation(s) from {name}')
+                .replace('{clips}', String(clips.length))
+                .replace('{name}', String(file.name)));
         }
         catch (err) {
             log.error('Merge error:', err);
-            setStatusText(`Error merging ${file.name}: ${String(err)}`);
+            setStatusText(t('useModelEditor.errorMerging', 'Error merging {name}: {err}')
+                .replace('{name}', String(file.name))
+                .replace('{err}', String(String(err))));
         }
         finally {
             URL.revokeObjectURL(url);
         }
-    }, []);
+    }, [t]);
     /* ─────────────────────────────────────────
        Animation controls
        ───────────────────────────────────────── */
@@ -931,8 +941,8 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         clone.position.x += 1;
         sceneRef.current.add(clone);
         rebuildTree();
-        setStatusText(`Duplicated ${selectedNode.name}`);
-    }, [selectedNode, rebuildTree]);
+        setStatusText(t('useModelEditor.duplicated', 'Duplicated {name}').replace('{name}', String(selectedNode.name)));
+    }, [selectedNode, rebuildTree, t]);
     /* ─────────────────────────────────────────
        Keyboard shortcuts
        ───────────────────────────────────────── */
@@ -1076,7 +1086,7 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
     const exportGLTF = useCallback((binary) => {
         const root = rootObjectRef.current;
         if (!root) {
-            setStatusText('Nothing to export');
+            setStatusText(t('useModelEditor.nothingToExport', 'Nothing to export'));
             return;
         }
         const exporter = new GLTFExporter();
@@ -1097,16 +1107,16 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             a.download = `export.${binary ? 'glb' : 'gltf'}`;
             a.click();
             URL.revokeObjectURL(a.href);
-            setStatusText(`Exported ${binary ? 'GLB' : 'GLTF'} successfully`);
+            setStatusText(t('useModelEditor.exportedFormat', 'Exported {format} successfully').replace('{format}', binary ? 'GLB' : 'GLTF'));
         }, (err) => {
             log.error('Export error:', err);
-            setStatusText(`Export error: ${String(err)}`);
+            setStatusText(t('useModelEditor.exportError', 'Export error: {err}').replace('{err}', String(String(err))));
         }, options);
-    }, []);
+    }, [t]);
     const exportOBJ = useCallback(() => {
         const root = rootObjectRef.current;
         if (!root) {
-            setStatusText('Nothing to export');
+            setStatusText(t('useModelEditor.nothingToExport', 'Nothing to export'));
             return;
         }
         const exporter = new OBJExporter();
@@ -1117,12 +1127,12 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         a.download = 'export.obj';
         a.click();
         URL.revokeObjectURL(a.href);
-        setStatusText('Exported OBJ successfully');
-    }, []);
+        setStatusText(t('useModelEditor.exportedFormat', 'Exported {format} successfully').replace('{format}', 'OBJ'));
+    }, [t]);
     const exportSTL = useCallback((binary) => {
         const root = rootObjectRef.current;
         if (!root) {
-            setStatusText('Nothing to export');
+            setStatusText(t('useModelEditor.nothingToExport', 'Nothing to export'));
             return;
         }
         const exporter = new STLExporter();
@@ -1139,12 +1149,12 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         a.download = 'export.stl';
         a.click();
         URL.revokeObjectURL(a.href);
-        setStatusText(`Exported STL${binary ? ' (binary)' : ''} successfully`);
-    }, []);
+        setStatusText(t('useModelEditor.exportedFormat', 'Exported {format} successfully').replace('{format}', binary ? t('useModelEditor.stlBinary', 'STL (binary)') : 'STL'));
+    }, [t]);
     const exportPLY = useCallback((binary) => {
         const root = rootObjectRef.current;
         if (!root) {
-            setStatusText('Nothing to export');
+            setStatusText(t('useModelEditor.nothingToExport', 'Nothing to export'));
             return;
         }
         const exporter = new PLYExporter();
@@ -1162,13 +1172,13 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             a.download = 'export.ply';
             a.click();
             URL.revokeObjectURL(a.href);
-            setStatusText(`Exported PLY${binary ? ' (binary)' : ''} successfully`);
+            setStatusText(t('useModelEditor.exportedFormat', 'Exported {format} successfully').replace('{format}', binary ? t('useModelEditor.plyBinary', 'PLY (binary)') : 'PLY'));
         }, { binary });
-    }, []);
+    }, [t]);
     const exportUSDZ = useCallback(async () => {
         const root = rootObjectRef.current;
         if (!root) {
-            setStatusText('Nothing to export');
+            setStatusText(t('useModelEditor.nothingToExport', 'Nothing to export'));
             return;
         }
         try {
@@ -1183,13 +1193,13 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             a.download = 'export.usdz';
             a.click();
             URL.revokeObjectURL(a.href);
-            setStatusText('Exported USDZ successfully');
+            setStatusText(t('useModelEditor.exportedFormat', 'Exported {format} successfully').replace('{format}', 'USDZ'));
         }
         catch (err) {
             log.error('USDZ export error:', err);
-            setStatusText(`USDZ export error: ${String(err)}`);
+            setStatusText(t('useModelEditor.usdzExportError', 'USDZ export error: {err}').replace('{err}', String(String(err))));
         }
-    }, []);
+    }, [t]);
     /* ─────────────────────────────────────────
        Dispose & clear
        ───────────────────────────────────────── */
@@ -1258,8 +1268,8 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         setAnimDuration(0);
         setSelectedId(null);
         rebuildTree();
-        setStatusText('Scene cleared');
-    }, [rebuildTree, disposeObject]);
+        setStatusText(t('useModelEditor.sceneCleared', 'Scene cleared'));
+    }, [rebuildTree, disposeObject, t]);
     // asks first: clearing cannot be undone
     const clearScene = useCallback(() => {
         void ask('confirm', 'Clear the entire scene? This cannot be undone.').then((answer) => {
@@ -1277,7 +1287,7 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         }
         const root = rootObjectRef.current;
         if (!root) {
-            setStatusText('Nothing to save');
+            setStatusText(t('useModelEditor.nothingToSave', 'Nothing to save'));
             return;
         }
         const exporter = new GLTFExporter();
@@ -1295,9 +1305,9 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             reader.readAsDataURL(blob);
         }, (err) => {
             log.error('Save to library error:', err);
-            setStatusText(`Save error: ${String(err)}`);
+            setStatusText(t('useModelEditor.saveError', 'Save error: {err}').replace('{err}', String(String(err))));
         }, { binary: true, animations: allClipsRef.current.map((a) => a.clip) });
-    }, [onSaveToLibrary, ask]);
+    }, [onSaveToLibrary, ask, t]);
     /* ─────────────────────────────────────────
        Add Mesh / Light / Camera / Empty
        ───────────────────────────────────────── */
@@ -1364,9 +1374,9 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         }
         sceneRef.current.add(mesh);
         rebuildTree();
-        setStatusText(`Added ${mesh.name}`);
+        setStatusText(t('useModelEditor.added', 'Added {name}').replace('{name}', String(mesh.name)));
         setAddMenuOpen(null);
-    }, [rebuildTree]);
+    }, [rebuildTree, t]);
     const addSceneLight = useCallback((type) => {
         let light;
         switch (type) {
@@ -1418,9 +1428,9 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             sceneRef.current.add(helper);
         }
         rebuildTree();
-        setStatusText(`Added ${light.name}`);
+        setStatusText(t('useModelEditor.added', 'Added {name}').replace('{name}', String(light.name)));
         setAddMenuOpen(null);
-    }, [rebuildTree]);
+    }, [rebuildTree, t]);
     const addCameraObject = useCallback(() => {
         const cam = new THREE.PerspectiveCamera(50, 16 / 9, 0.1, 1000);
         cam.name = 'Camera';
@@ -1431,9 +1441,9 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         helper.name = '__helper_Camera';
         sceneRef.current.add(helper);
         rebuildTree();
-        setStatusText('Added Camera');
+        setStatusText(t('useModelEditor.addedCamera', 'Added Camera'));
         setAddMenuOpen(null);
-    }, [rebuildTree]);
+    }, [rebuildTree, t]);
     const addEmpty = useCallback((type) => {
         const obj = new THREE.Object3D();
         obj.name =
@@ -1445,9 +1455,9 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             obj.add(h);
         }
         rebuildTree();
-        setStatusText(`Added ${obj.name}`);
+        setStatusText(t('useModelEditor.added', 'Added {name}').replace('{name}', String(obj.name)));
         setAddMenuOpen(null);
-    }, [rebuildTree]);
+    }, [rebuildTree, t]);
     /* ─────────────────────────────────────────
        Raycaster click-to-select
        ───────────────────────────────────────── */
@@ -1515,14 +1525,16 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         }
         e.target.value = '';
         if (!onAIPoseVideo) {
-            setAiStatus('AI pose callback not configured.');
+            setAiStatus(t('useModelEditor.aiPoseCallbackNotConfigured', 'AI pose callback not configured.'));
             return;
         }
         setAiBusy(true);
-        setAiStatus('Uploading video for AI pose estimation...');
+        setAiStatus(t('useModelEditor.uploadingVideoForAiPose', 'Uploading video for AI pose estimation...'));
         try {
             const result = await onAIPoseVideo(file);
-            setAiStatus(`Got ${result.frame_count} frames at ${result.fps} fps. Creating animation clip...`);
+            setAiStatus(t('useModelEditor.gotFramesAtFpsCreating', 'Got {frame_count} frames at {fps} fps. Creating animation clip...')
+                .replace('{frame_count}', String(result.frame_count))
+                .replace('{fps}', String(result.fps)));
             const clip = pose3dToClip(result);
             if (clip && rootObjectRef.current) {
                 if (!mixerRef.current) {
@@ -1537,20 +1549,20 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
                 allClipsRef.current = [...allClipsRef.current, newAnim];
                 setAnimations([...allClipsRef.current]);
                 playClip(allClipsRef.current.length - 1);
-                setAiStatus('Animation created successfully!');
+                setAiStatus(t('useModelEditor.animationCreatedSuccessfully', 'Animation created successfully!'));
             }
             else {
-                setAiStatus('Could not create animation — load a rigged model first.');
+                setAiStatus(t('useModelEditor.couldNotCreateAnimationLoad', 'Could not create animation — load a rigged model first.'));
             }
         }
         catch (err) {
             log.error('AI pose error:', err);
-            setAiStatus(`Error: ${String(err)}`);
+            setAiStatus(t('useModelEditor.error', 'Error: {err}').replace('{err}', String(String(err))));
         }
         finally {
             setAiBusy(false);
         }
-    }, [playClip, onAIPoseVideo]);
+    }, [playClip, onAIPoseVideo, t]);
     /* ─────────────────────────────────────────
        Node helpers
        ───────────────────────────────────────── */
@@ -1574,19 +1586,19 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
     const undo = useCallback(() => {
         const label = undoRedoRef.current.undo();
         if (label) {
-            setStatusText(`Undo: ${label}`);
+            setStatusText(t('useModelEditor.undo', 'Undo: {label}').replace('{label}', String(label)));
             rebuildTree();
         }
         setUndoRedoVer((v) => v + 1);
-    }, [rebuildTree]);
+    }, [rebuildTree, t]);
     const redo = useCallback(() => {
         const label = undoRedoRef.current.redo();
         if (label) {
-            setStatusText(`Redo: ${label}`);
+            setStatusText(t('useModelEditor.redo', 'Redo: {label}').replace('{label}', String(label)));
             rebuildTree();
         }
         setUndoRedoVer((v) => v + 1);
-    }, [rebuildTree]);
+    }, [rebuildTree, t]);
     const canUndo = undoRedoRef.current.canUndo();
     const canRedo = undoRedoRef.current.canRedo();
     const undoLabel = undoRedoRef.current.undoLabel;
@@ -1615,30 +1627,35 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             return SUPPORTED_EXTENSIONS.includes(ext);
         });
         if (fileArray.length === 0) {
-            setStatusText('No supported files found');
+            setStatusText(t('useModelEditor.noSupportedFilesFound', 'No supported files found'));
             return;
         }
-        setStatusText(`Importing ${fileArray.length} file(s)...`);
+        setStatusText(t('useModelEditor.importingFileS', 'Importing {fileArray} file(s)...').replace('{fileArray}', String(fileArray.length)));
         let loaded = 0;
         for (const file of fileArray) {
             try {
                 await loadFile(file);
                 loaded++;
-                setStatusText(`Imported ${loaded}/${fileArray.length}: ${file.name}`);
+                setStatusText(t('useModelEditor.imported', 'Imported {loaded}/{fileArray}: {name}')
+                    .replace('{loaded}', String(loaded))
+                    .replace('{fileArray}', String(fileArray.length))
+                    .replace('{name}', String(file.name)));
             }
             catch (err) {
                 log.error(`Failed to import ${file.name}:`, err);
             }
         }
-        setStatusText(`Batch import complete: ${loaded}/${fileArray.length} files loaded`);
-    }, [loadFile]);
+        setStatusText(t('useModelEditor.batchImportCompleteFilesLoaded', 'Batch import complete: {loaded}/{fileArray} files loaded')
+            .replace('{loaded}', String(loaded))
+            .replace('{fileArray}', String(fileArray.length)));
+    }, [loadFile, t]);
     /* ─────────────────────────────────────────
        PBR Presets
        ───────────────────────────────────────── */
     const applyPreset = useCallback((preset) => {
         const node = selectedNode;
         if (!node || !(node.object instanceof THREE.Mesh)) {
-            setStatusText('Select a mesh to apply material preset');
+            setStatusText(t('useModelEditor.selectAMeshToApply', 'Select a mesh to apply material preset'));
             return;
         }
         const mesh = node.object;
@@ -1671,7 +1688,7 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             mesh.material = newMaterial;
         }
         pushUndo({
-            label: `Apply ${preset.name} preset`,
+            label: t('useModelEditor.applyPreset', 'Apply {name} preset').replace('{name}', String(preset.name)),
             undo: () => {
                 if (Array.isArray(mesh.material)) {
                     mesh.material[materialIdx] = oldClone;
@@ -1690,15 +1707,15 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             },
         });
         setMatRefresh((v) => v + 1);
-        setStatusText(`Applied ${preset.name} preset`);
-    }, [selectedNode, selMaterialIdx, pushUndo]);
+        setStatusText(t('useModelEditor.appliedPreset', 'Applied {name} preset').replace('{name}', String(preset.name)));
+    }, [selectedNode, selMaterialIdx, pushUndo, t]);
     /* ─────────────────────────────────────────
        LOD Generation
        ───────────────────────────────────────── */
     const generateSelectedLOD = useCallback(() => {
         const node = selectedNode;
         if (!node || !(node.object instanceof THREE.Mesh)) {
-            setStatusText('Select a mesh to generate LOD');
+            setStatusText(t('useModelEditor.selectAMeshToGenerate', 'Select a mesh to generate LOD'));
             return;
         }
         const mesh = node.object;
@@ -1707,7 +1724,7 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         parent.remove(mesh);
         parent.add(lod);
         pushUndo({
-            label: `Generate LOD for ${mesh.name}`,
+            label: t('useModelEditor.generateLodFor', 'Generate LOD for {name}').replace('{name}', String(mesh.name)),
             undo: () => {
                 parent.remove(lod);
                 parent.add(mesh);
@@ -1718,8 +1735,8 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
             },
         });
         rebuildTree();
-        setStatusText(`Generated LOD for ${mesh.name} (4 levels)`);
-    }, [selectedNode, pushUndo, rebuildTree]);
+        setStatusText(t('useModelEditor.generatedLodFor4Levels', 'Generated LOD for {name} (4 levels)').replace('{name}', String(mesh.name)));
+    }, [selectedNode, pushUndo, rebuildTree, t]);
     /* ─────────────────────────────────────────
        Instancing
        ───────────────────────────────────────── */
@@ -1727,12 +1744,14 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         const root = rootObjectRef.current || sceneRef.current;
         const result = convertToInstanced(root);
         if (result.created === 0) {
-            setStatusText('No duplicate meshes found to instance');
+            setStatusText(t('useModelEditor.noDuplicateMeshesFoundTo', 'No duplicate meshes found to instance'));
             return;
         }
         rebuildTree();
-        setStatusText(`Created ${result.created} instanced meshes, removed ${result.removed} duplicates`);
-    }, [rebuildTree]);
+        setStatusText(t('useModelEditor.createdInstancedMeshesRemovedDuplicates', 'Created {created} instanced meshes, removed {removed} duplicates')
+            .replace('{created}', String(result.created))
+            .replace('{removed}', String(result.removed)));
+    }, [rebuildTree, t]);
     /* ── HDRI Environment ── */
     const applyHDRI = useCallback((preset) => {
         const renderer = rendererRef.current;
@@ -1750,8 +1769,8 @@ function useModelEditor({ onSaveToLibrary, onAIPoseVideo, }) {
         else {
             setFogEnabled(false);
         }
-        setStatusText(`Environment: ${preset.name}`);
-    }, []);
+        setStatusText(t('useModelEditor.environment', 'Environment: {name}').replace('{name}', String(preset.name)));
+    }, [t]);
     /* ── Snap ── */
     const snapPoint = useCallback((point) => {
         const root = rootObjectRef.current || sceneRef.current;

package/dist/esm/model/useModelViewer.js

@@ -8,6 +8,7 @@ import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { OBJLoader } from 'three/examples/jsm/loaders/OBJLoader.js';
 import { PLYLoader } from 'three/examples/jsm/loaders/PLYLoader.js';
 import { STLLoader } from 'three/examples/jsm/loaders/STLLoader.js';
+import { useNiceTranslation } from '../core/i18n.js';
 import { createFrameClock, SOFT_SHADOW_MAP } from '../core/threeCompat.js';
 
 /**
@@ -41,6 +42,7 @@ const TONE_MAP = {
    ═══════════════════════════════════════════ */
 function useModelViewer(props = {}) {
     var _a;
+    const { t } = useNiceTranslation();
     const { src, format, navigationMode: initNavMode = 'orbit', quality = 'high', autoRotateSpeed: initAutoRotate = 0, backgroundColor = 'var(--nice-bg, #1a1a2e)', showGrid: initShowGrid = true, shadows = true, gamepad = false, cameraPresets: _cameraPresets = [], annotations: _annotations = [], hotspots: _hotspots = [], floorPlans: _floorPlans = [], onHotspotClick: _onHotspotClick, onAnnotationClick: _onAnnotationClick, onLoadProgress, onLoad, onError, clippingPlanes = [], measureMode: initMeasureMode = false, measurements: _measurements = [], onMeasure: _onMeasure, minDistance = 0.1, maxDistance = 1000, fov = 50, vr: _vr = false, walkSpeed = 5, ambientIntensity = 0.5, directionalIntensity = 0.8, antiAlias = true, toneMapping = 'aces', exposure = 1, } = props;
     /* ── refs ── */
     const mountRef = useRef(null);
@@ -328,7 +330,7 @@ function useModelViewer(props = {}) {
         setLoading(true);
         setLoadProgress(0);
         setError(null);
-        setStatusText('Loading…');
+        setStatusText(t('useModelViewer.loading', 'Loading…'));
         const detectedFmt = detectFormat(url, fmt);
         const onProgress = (e) => {
             if (e.lengthComputable) {
@@ -436,21 +438,23 @@ function useModelViewer(props = {}) {
                     mixerRef.current = mixer;
                 }
                 countScene();
-                setStatusText(`Loaded – ${polyCount} tris, ${meshCount} meshes`);
+                setStatusText(t('useModelViewer.loadedTrisMeshes', 'Loaded – {polyCount} tris, {meshCount} meshes')
+                    .replace('{polyCount}', String(polyCount))
+                    .replace('{meshCount}', String(meshCount)));
                 onLoad === null || onLoad === void 0 ? void 0 : onLoad();
             }
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
             setError(msg);
-            setStatusText(`Error: ${msg}`);
+            setStatusText(t('useModelViewer.error', 'Error: {msg}').replace('{msg}', String(msg)));
             onError === null || onError === void 0 ? void 0 : onError(err instanceof Error ? err : new Error(msg));
         }
         finally {
             setLoading(false);
             setLoadProgress(1);
         }
-    }, [countScene, detectFormat, onLoad, onError, onLoadProgress, polyCount, meshCount]);
+    }, [countScene, detectFormat, onLoad, onError, onLoadProgress, polyCount, meshCount, t]);
     /* ── auto-load from src ── */
     useEffect(() => {
         if (src) {
@@ -591,9 +595,12 @@ function useModelViewer(props = {}) {
     /* ── finalise status text ── */
     useEffect(() => {
         if (!loading && !error && polyCount > 0) {
-            setStatusText(`${polyCount.toLocaleString()} triangles · ${meshCount} meshes · ${animNames.length} animation(s)`);
+            setStatusText(t('useModelViewer.trianglesMeshesAnimationS', '{polyCount} triangles · {meshCount} meshes · {animNames} animation(s)')
+                .replace('{polyCount}', String(polyCount.toLocaleString()))
+                .replace('{meshCount}', String(meshCount))
+                .replace('{animNames}', String(animNames.length)));
         }
-    }, [loading, error, polyCount, meshCount, animNames.length]);
+    }, [loading, error, polyCount, meshCount, animNames.length, t]);
     return {
         mountRef,
         loading,

package/dist/esm/particle/NiceParticleEditor.js

@@ -295,7 +295,7 @@ function SystemListPanel({ systems, selectedId, onSelect, onAdd, onRemove, onDup
         }
         setEditingId(null);
     };
-    return (jsxs("div", { className: styles.systemList, children: [jsxs("div", { className: styles.systemListHeader, children: [jsxs("span", { children: ["Systems (", systems.length, ")"] }), jsxs("div", { className: styles.systemListActions, children: [jsx("button", { onClick: onAdd, title: t('particleEditor.newSystem', 'New System'), "aria-label": t('particleEditor.newSystem', 'New System'), children: jsx(NiceIcon, { name: "plus", size: 14 }) }), jsx("button", { onClick: () => setShowPresets(!showPresets), title: t('particleEditor.addPreset', 'Add Preset'), "aria-label": t('particleEditor.addPreset', 'Add Preset'), children: jsx(NiceIcon, { name: "clipboard", size: 14 }) })] })] }), showPresets && (jsx("div", { className: styles.presetMenu, children: Object.keys(PARTICLE_PRESETS).map((preset) => (jsx("button", { className: styles.presetItem, onClick: () => {
+    return (jsxs("div", { className: styles.systemList, children: [jsxs("div", { className: styles.systemListHeader, children: [jsx("span", { children: t('particleEditor.systems', 'Systems ({systems})').replace('{systems}', String(systems.length)) }), jsxs("div", { className: styles.systemListActions, children: [jsx("button", { onClick: onAdd, title: t('particleEditor.newSystem', 'New System'), "aria-label": t('particleEditor.newSystem', 'New System'), children: jsx(NiceIcon, { name: "plus", size: 14 }) }), jsx("button", { onClick: () => setShowPresets(!showPresets), title: t('particleEditor.addPreset', 'Add Preset'), "aria-label": t('particleEditor.addPreset', 'Add Preset'), children: jsx(NiceIcon, { name: "clipboard", size: 14 }) })] })] }), showPresets && (jsx("div", { className: styles.presetMenu, children: Object.keys(PARTICLE_PRESETS).map((preset) => (jsx("button", { className: styles.presetItem, onClick: () => {
                         onAddPreset(preset);
                         setShowPresets(false);
                     }, children: preset.charAt(0).toUpperCase() + preset.slice(1) }, preset))) })), jsx("div", { className: styles.systemItems, children: systems.map((system) => (jsx("div", { className: `${styles.systemItem} ${selectedId === system.id ? styles.selected : ''}`, onClick: () => onSelect(system.id), children: editingId === system.id ? (jsx("input", { type: "text", value: editName, onChange: (e) => setEditName(e.target.value), onBlur: handleFinishRename, onKeyDown: (e) => e.key === 'Enter' && handleFinishRename(), autoFocus: true, className: styles.renameInput })) : (jsxs(Fragment, { children: [jsx("span", { className: styles.systemName, onDoubleClick: () => handleStartRename(system), children: system.name }), jsxs("div", { className: styles.systemItemActions, children: [jsx("button", { onClick: (e) => {
@@ -383,7 +383,7 @@ function ModuleEditor({ system, moduleKey, onUpdate }) {
                         step: 0.1,
                     }), renderToggle('Looping', system.looping, (v) => onUpdate({ looping: v })), renderToggle('Prewarm', system.prewarm, (v) => onUpdate({ prewarm: v })), renderDistributionInput('Start Delay', system.startDelay, (v) => onUpdate({ startDelay: v })), renderDistributionInput('Start Lifetime', system.startLifetime, (v) => onUpdate({ startLifetime: v })), renderDistributionInput('Start Speed', system.startSpeed, (v) => onUpdate({ startSpeed: v })), renderDistributionInput('Start Size', system.startSize, (v) => onUpdate({ startSize: v })), renderDistributionInput('Start Rotation', system.startRotation, (v) => onUpdate({ startRotation: v })), renderDistributionInput('Gravity Modifier', system.gravityModifier, (v) => onUpdate({ gravityModifier: v })), renderSelect('Simulation Space', system.simulationSpace, { local: 'Local', world: 'World', custom: 'Custom' }, (v) => onUpdate({ simulationSpace: v })), renderNumberInput('Simulation Speed', system.simulationSpeed, (v) => onUpdate({ simulationSpeed: v }), { min: 0, step: 0.1 }), renderNumberInput('Max Particles', system.maxParticles, (v) => onUpdate({ maxParticles: v }), { min: 1, step: 1 })] }));
         case 'emission':
-            return (jsxs(Fragment, { children: [renderDistributionInput('Rate over Time', system.emission.rateOverTime, (v) => onUpdate({ emission: { ...system.emission, rateOverTime: v } })), renderDistributionInput('Rate over Distance', system.emission.rateOverDistance, (v) => onUpdate({ emission: { ...system.emission, rateOverDistance: v } })), jsxs("div", { className: styles.propertyRow, children: [jsxs("label", { children: ["Bursts (", system.emission.bursts.length, ")"] }), jsx("button", { className: styles.addButton, onClick: () => onUpdate({
+            return (jsxs(Fragment, { children: [renderDistributionInput('Rate over Time', system.emission.rateOverTime, (v) => onUpdate({ emission: { ...system.emission, rateOverTime: v } })), renderDistributionInput('Rate over Distance', system.emission.rateOverDistance, (v) => onUpdate({ emission: { ...system.emission, rateOverDistance: v } })), jsxs("div", { className: styles.propertyRow, children: [jsx("label", { children: t('particleEditor.bursts', 'Bursts ({bursts})').replace('{bursts}', String(system.emission.bursts.length)) }), jsx("button", { className: styles.addButton, onClick: () => onUpdate({
                                     emission: {
                                         ...system.emission,
                                         bursts: [
@@ -544,7 +544,14 @@ function NiceParticleEditor({ systems: initialSystems, onSystemsChange, onPlay,
                 cancelAnimationFrame(animationFrameRef.current);
             }
         };
-    }, [state.isPlaying, state.isPaused, state.playbackSpeed, state.currentTime, selectedSystem]);
+    }, [
+        state.isPlaying,
+        state.isPaused,
+        state.playbackSpeed,
+        state.currentTime,
+        selectedSystem,
+        dispatch,
+    ]);
     // Export/Import handlers
     const handleExport = () => {
         const json = exportSystemsToJSON(state.systems);

package/dist/esm/rendering/NiceCascadedShadows.js

@@ -253,7 +253,7 @@ const NiceCascadedShadows = ({ scene, camera, config: configProp, showDebug: ini
             setShowDebug(initialDebug);
         }
     }, [initialDebug, setShowDebug]);
-    return (jsxs("div", { className: `nice-cascaded-shadows ${className}`, style: { display: 'grid', gap: 8, fontSize: 13 }, children: [jsxs("strong", { children: [jsx(NiceIcon, { name: "lightbulb", size: 14 }), ' ', t('cascadedShadows.cascadedShadowMaps', 'Cascaded Shadow Maps')] }), jsxs("label", { children: ["Cascades: ", config.cascadeCount, jsx("input", { type: "range", min: 1, max: 5, value: config.cascadeCount, onChange: (e) => setConfig({ cascadeCount: parseInt(e.target.value, 10) }), style: { width: '100%' } })] }), jsxs("label", { children: ["Max Distance: ", config.maxFar, jsx("input", { type: "range", min: 50, max: 1000, step: 10, value: config.maxFar, onChange: (e) => setConfig({ maxFar: parseInt(e.target.value, 10) }), style: { width: '100%' } })] }), jsxs("label", { children: ["Split Mode:", jsxs("select", { value: config.splitMode, onChange: (e) => setConfig({ splitMode: e.target.value }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: "practical", children: t('cascadedShadows.practical', 'Practical') }), jsx("option", { value: "logarithmic", children: t('cascadedShadows.logarithmic', 'Logarithmic') }), jsx("option", { value: "linear", children: t('cascadedShadows.linear', 'Linear') })] })] }), config.splitMode === 'practical' && (jsxs("label", { children: ["Lambda: ", config.practicalSplitLambda.toFixed(2), jsx("input", { type: "range", min: 0, max: 1, step: 0.05, value: config.practicalSplitLambda, onChange: (e) => setConfig({ practicalSplitLambda: parseFloat(e.target.value) }), style: { width: '100%' } })] })), jsxs("label", { children: ["Shadow Map Size: ", config.shadowMapSize, jsxs("select", { value: config.shadowMapSize, onChange: (e) => setConfig({ shadowMapSize: parseInt(e.target.value, 10) }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: 512, children: "512" }), jsx("option", { value: 1024, children: "1024" }), jsx("option", { value: 2048, children: "2048" }), jsx("option", { value: 4096, children: "4096" })] })] }), jsxs("div", { style: { fontSize: 10, opacity: 0.7 }, children: ["Cascade splits: ", cascadeSplits.map((s) => s.toFixed(1)).join(' | ')] }), jsxs("label", { style: { display: 'flex', alignItems: 'center', gap: 6 }, children: [jsx("input", { type: "checkbox", checked: showDebug, onChange: (e) => setShowDebug(e.target.checked) }), t('cascadedShadows.showCascadeFrustums', 'Show cascade frustums')] })] }));
+    return (jsxs("div", { className: `nice-cascaded-shadows ${className}`, style: { display: 'grid', gap: 8, fontSize: 13 }, children: [jsxs("strong", { children: [jsx(NiceIcon, { name: "lightbulb", size: 14 }), ' ', t('cascadedShadows.cascadedShadowMaps', 'Cascaded Shadow Maps')] }), jsxs("label", { children: [t('cascadedShadows.cascades', 'Cascades: {cascadeCount}').replace('{cascadeCount}', String(config.cascadeCount)), jsx("input", { type: "range", min: 1, max: 5, value: config.cascadeCount, onChange: (e) => setConfig({ cascadeCount: parseInt(e.target.value, 10) }), style: { width: '100%' } })] }), jsxs("label", { children: [t('cascadedShadows.maxDistance', 'Max Distance: {maxFar}').replace('{maxFar}', String(config.maxFar)), jsx("input", { type: "range", min: 50, max: 1000, step: 10, value: config.maxFar, onChange: (e) => setConfig({ maxFar: parseInt(e.target.value, 10) }), style: { width: '100%' } })] }), jsxs("label", { children: [t('cascadedShadows.splitMode', 'Split Mode:'), jsxs("select", { value: config.splitMode, onChange: (e) => setConfig({ splitMode: e.target.value }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: "practical", children: t('cascadedShadows.practical', 'Practical') }), jsx("option", { value: "logarithmic", children: t('cascadedShadows.logarithmic', 'Logarithmic') }), jsx("option", { value: "linear", children: t('cascadedShadows.linear', 'Linear') })] })] }), config.splitMode === 'practical' && (jsxs("label", { children: [t('cascadedShadows.lambda', 'Lambda: {practicalSplitLambda}').replace('{practicalSplitLambda}', String(config.practicalSplitLambda.toFixed(2))), jsx("input", { type: "range", min: 0, max: 1, step: 0.05, value: config.practicalSplitLambda, onChange: (e) => setConfig({ practicalSplitLambda: parseFloat(e.target.value) }), style: { width: '100%' } })] })), jsxs("label", { children: [t('cascadedShadows.shadowMapSize', 'Shadow Map Size: {shadowMapSize}').replace('{shadowMapSize}', String(config.shadowMapSize)), jsxs("select", { value: config.shadowMapSize, onChange: (e) => setConfig({ shadowMapSize: parseInt(e.target.value, 10) }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: 512, children: "512" }), jsx("option", { value: 1024, children: "1024" }), jsx("option", { value: 2048, children: "2048" }), jsx("option", { value: 4096, children: "4096" })] })] }), jsx("div", { style: { fontSize: 10, opacity: 0.7 }, children: t('cascadedShadows.cascadeSplits', 'Cascade splits: {cascadeSplits}').replace('{cascadeSplits}', String(cascadeSplits.map((s) => s.toFixed(1)).join(' | '))) }), jsxs("label", { style: { display: 'flex', alignItems: 'center', gap: 6 }, children: [jsx("input", { type: "checkbox", checked: showDebug, onChange: (e) => setShowDebug(e.target.checked) }), t('cascadedShadows.showCascadeFrustums', 'Show cascade frustums')] })] }));
 };
 
 export { NiceCascadedShadows, useCSM };

package/dist/esm/rendering/NiceRenderExport.js

@@ -325,7 +325,7 @@ const NiceRenderExport = ({ renderer, scene, camera, className = '', }) => {
                         color: config.width === p.width && config.height === p.height
                             ? 'var(--nice-color-white, #fff)'
                             : 'inherit',
-                    }, children: p.label }, p.label))) }), jsxs("div", { style: { display: 'flex', gap: 4, alignItems: 'center' }, children: [jsx("input", { type: "number", value: config.width, min: 1, max: 8192, onChange: (e) => setConfig({ width: parseInt(e.target.value, 10) || 1 }), style: { width: 70, padding: '3px 6px' } }), jsx("span", { children: "\u00D7" }), jsx("input", { type: "number", value: config.height, min: 1, max: 8192, onChange: (e) => setConfig({ height: parseInt(e.target.value, 10) || 1 }), style: { width: 70, padding: '3px 6px' } })] }), jsxs("label", { children: ["Format:", jsxs("select", { value: config.format, onChange: (e) => setConfig({ format: e.target.value }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: "png", children: "PNG (lossless + alpha)" }), jsx("option", { value: "jpeg", children: "JPEG (lossy, no alpha)" }), jsx("option", { value: "exr", children: "EXR (HDR float)" })] })] }), jsxs("label", { children: ["Background:", jsxs("select", { value: config.backgroundMode, onChange: (e) => setConfig({ backgroundMode: e.target.value }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: "transparent", children: t('renderExport.transparent', 'Transparent') }), jsx("option", { value: "color", children: t('renderExport.solidColor', 'Solid Color') }), jsx("option", { value: "scene", children: t('renderExport.sceneBackground', 'Scene Background') })] })] }), config.backgroundMode === 'color' && (jsxs("label", { style: { display: 'flex', alignItems: 'center', gap: 6 }, children: ["Color:", jsx("input", { type: "color", value: config.backgroundColor, onChange: (e) => setConfig({ backgroundColor: e.target.value }) })] })), jsxs("label", { children: ["Supersampling: ", config.samples, "x", jsxs("select", { value: config.samples, onChange: (e) => setConfig({ samples: parseInt(e.target.value, 10) }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: 1, children: "1x (none)" }), jsx("option", { value: 2, children: "2x" }), jsx("option", { value: 4, children: "4x (best quality)" })] })] }), jsx("button", { type: "button", onClick: handleRender, disabled: isRendering, style: {
+                    }, children: p.label }, p.label))) }), jsxs("div", { style: { display: 'flex', gap: 4, alignItems: 'center' }, children: [jsx("input", { type: "number", value: config.width, min: 1, max: 8192, onChange: (e) => setConfig({ width: parseInt(e.target.value, 10) || 1 }), style: { width: 70, padding: '3px 6px' } }), jsx("span", { children: "\u00D7" }), jsx("input", { type: "number", value: config.height, min: 1, max: 8192, onChange: (e) => setConfig({ height: parseInt(e.target.value, 10) || 1 }), style: { width: 70, padding: '3px 6px' } })] }), jsxs("label", { children: [t('renderExport.format', 'Format:'), jsxs("select", { value: config.format, onChange: (e) => setConfig({ format: e.target.value }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: "png", children: t('renderExport.pngLosslessAlpha', 'PNG (lossless + alpha)') }), jsx("option", { value: "jpeg", children: t('renderExport.jpegLossyNoAlpha', 'JPEG (lossy, no alpha)') }), jsx("option", { value: "exr", children: t('renderExport.exrHdrFloat', 'EXR (HDR float)') })] })] }), jsxs("label", { children: [t('renderExport.background', 'Background:'), jsxs("select", { value: config.backgroundMode, onChange: (e) => setConfig({ backgroundMode: e.target.value }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: "transparent", children: t('renderExport.transparent', 'Transparent') }), jsx("option", { value: "color", children: t('renderExport.solidColor', 'Solid Color') }), jsx("option", { value: "scene", children: t('renderExport.sceneBackground', 'Scene Background') })] })] }), config.backgroundMode === 'color' && (jsxs("label", { style: { display: 'flex', alignItems: 'center', gap: 6 }, children: [t('renderExport.color', 'Color:'), jsx("input", { type: "color", value: config.backgroundColor, onChange: (e) => setConfig({ backgroundColor: e.target.value }) })] })), jsxs("label", { children: [t('renderExport.supersamplingX', 'Supersampling: {samples}x').replace('{samples}', String(config.samples)), jsxs("select", { value: config.samples, onChange: (e) => setConfig({ samples: parseInt(e.target.value, 10) }), style: { width: '100%', marginTop: 2 }, children: [jsx("option", { value: 1, children: t('renderExport.n1xNone', '1x (none)') }), jsx("option", { value: 2, children: "2x" }), jsx("option", { value: 4, children: t('renderExport.n4xBestQuality', '4x (best quality)') })] })] }), jsx("button", { type: "button", onClick: handleRender, disabled: isRendering, style: {
                     background: isRendering
                         ? 'var(--nice-bg-tertiary, #94a3b8)'
                         : 'var(--nice-color-accent, #6366f1)',
@@ -334,7 +334,7 @@ const NiceRenderExport = ({ renderer, scene, camera, className = '', }) => {
                     borderRadius: 4,
                     padding: '8px 12px',
                     cursor: isRendering ? 'wait' : 'pointer',
-                }, children: isRendering ? (jsxs(Fragment, { children: [jsx(NiceIcon, { name: "clock", size: 14 }), " Rendering\u2026"] })) : (jsxs(Fragment, { children: [jsx(NiceIcon, { name: "camera", size: 14 }), ' ', t('renderExport.render', 'Render {width}×{height} {format}')
+                }, children: isRendering ? (jsxs(Fragment, { children: [jsx(NiceIcon, { name: "clock", size: 14 }), " ", t('renderExport.rendering', 'Rendering…')] })) : (jsxs(Fragment, { children: [jsx(NiceIcon, { name: "camera", size: 14 }), ' ', t('renderExport.render', 'Render {width}×{height} {format}')
                             .replace('{width}', String(config.width))
                             .replace('{height}', String(config.height))
                             .replace('{format}', config.format.toUpperCase())] })) })] }));