feat(rover): add live scene and material editing with environment migration

apps/control-station/test/roverScene.test.mjs

@@ -0,0 +1,65 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import {build} from 'esbuild';
+const result=await build({entryPoints:[new URL('../src/core/roverScene/sceneDocument.ts',import.meta.url).pathname],bundle:true,write:false,platform:'node',format:'esm'});
+const {defaultScene,environmentFields,changeField,fieldDisabled,parseScene,createMaterial,assignMaterial}=await import('data:text/javascript;base64,'+Buffer.from(result.outputFiles[0].contents).toString('base64'));
+test('all donor camera and environment fields remain exposed, frame styling excluded',t=>{
+ const source=new URL('../../../../NODEDC_ENGINE_INFRA/nodedc-source/src/driveinspector/nodes/ThreeDAsset.definition.ts',import.meta.url);
+ if(!fs.existsSync(source)){t.skip('Donor checkout not installed; pinned catalog remains in repo');return;}
+ const donor=fs.readFileSync(source,'utf8');
+ const keys=[...donor.matchAll(/key: '(postFx\.[^']+|cameraZoomStrength|cameraAutoRotate|cameraResetTs)'/g)].map(m=>m[1]);
+ assert.equal(keys.length,109);
+ for(const key of keys)assert.ok(environmentFields.some(f=>f.key===key),key);
+ assert.ok(!environmentFields.some(f=>f.key==='nodeName'));
+});
+test('documents are independent, scene edits preserve material texture references',()=>{
+ const a=defaultScene(),b=defaultScene();a.materials['rover/body'].color='#123456';assert.notEqual(a.materials['rover/body'].color,b.materials['rover/body'].color);
+ const edited=changeField(a,'postFx.lighting.exposure',1.5);assert.equal(edited.postFx.lighting.exposure,1.5);assert.equal(a.postFx.lighting.exposure,defaultScene().postFx.lighting.exposure);assert.equal(edited.materials,a.materials);
+});
+test('numeric enums, bounds, invalid color and unknown paths are validated',()=>{
+ const a=defaultScene();assert.equal(changeField(a,'postFx.rendering.toneMapping','3').postFx.rendering.toneMapping,3);
+ assert.equal(changeField(a,'postFx.grid.step',0).postFx.grid.step,.01);
+ for(const [key,value] of [['__proto__.x',1],['postFx.grid.step',NaN],['postFx.grid.colorMain','red'],['postFx.rendering.fog','invalid']])assert.equal(changeField(a,key,value),a);
+});
+test('fog interval, atlas/skybox exclusion and field availability stay coherent',()=>{
+ let a=changeField(defaultScene(),'postFx.rendering.fogRange',[18,3]);assert.deepEqual(a.postFx.rendering.fogRange,[3,18]);assert.equal(a.postFx.rendering.fogStart,3);assert.equal(a.postFx.rendering.fogEnd,18);
+ a=changeField(a,'postFx.skybox.enabled',true);assert.equal(a.postFx.envAtlas.enabled,false);
+ assert.equal(fieldDisabled(a,environmentFields.find(f=>f.key==='postFx.envAtlas.enabled')),true);
+});
+test('scene JSON round trips materials, texture data and environment without authority',()=>{
+ const a=defaultScene();a.materials['rover/box'].textures.diffuse={name:'test.png',data:'data:image/png;base64,YWJj'};a.materials['rover/box'].roughness=.28;
+ assert.deepEqual(parseScene(JSON.parse(JSON.stringify(a))),a);
+ assert.throws(()=>parseScene({schema:'other'}));
+ assert.throws(()=>parseScene({...a,model:'wrong'}));
+ assert.equal('armed' in a,false);
+});
+test('import rejects texture URLs and normalizes out-of-range PBR values',()=>{
+ const a=defaultScene();a.materials['rover/box'].roughness=20;assert.equal(parseScene(a).materials['rover/box'].roughness,1);
+ a.materials['rover/box'].textures.normal={name:'remote',data:'https://unknown/texture'};assert.throws(()=>parseScene(a));
+});
+test('editing excludes drive bindings and key controls without changing arm authority',()=>{
+ const view=fs.readFileSync(new URL('../src/components/rover/RoverView.tsx',import.meta.url),'utf8');
+ assert.match(view,/if\(!c.ready\|\|!active\|\|open\|\|editing/);assert.match(view,/c.ready&&!editing/);assert.match(view,/c.pauseInput\(\);setHeld/);
+ const editor=fs.readFileSync(new URL('../src/components/rover/editor/RoverScene.tsx',import.meta.url),'utf8');assert.doesNotMatch(editor,/\.arm\(|setDemand|\/api\/v1\/fleet/);
+});
+test('export manifest retains complete geometry and all editable material groups',()=>{
+ const manifest=JSON.parse(fs.readFileSync(new URL('../public/rover-scene/dcd006-v020.json',import.meta.url),'utf8'));
+ assert.equal(manifest.source_object_count,1426);assert.equal(manifest.render_mesh_count,9);assert.equal(manifest.source_saved,false);assert.match(manifest.uv,/cube/);
+ assert.deepEqual(Object.keys(manifest.materials).sort(),Object.keys(defaultScene().materials).map(k=>k.replace('rover/','')).sort());
+});
+
+test('named custom materials and assignments survive JSON and reject unknown groups',()=>{
+ let a=createMaterial(defaultScene(),'custom/example');
+ a.materials['custom/example'].name='Мой металл';a=assignMaterial(a,'rover/body','custom/example');
+ assert.deepEqual(parseScene(JSON.parse(JSON.stringify(a))),a);
+ assert.equal(assignMaterial(a,'unknown','custom/example'),a);
+ assert.equal(assignMaterial(a,'rover/body','missing'),a);
+ assert.equal(createMaterial(a,'__proto__'),a);
+ const legacy=defaultScene();delete legacy.assignments;assert.deepEqual(parseScene(legacy).assignments,{});
+});
+test('default environment is the original NodeDC preset without neutral overrides',()=>{
+ const a=defaultScene();assert.equal(a.postFx.chromaticAberration.enabled,true);
+ assert.equal(a.postFx.rendering.backgroundColor,'#111113');
+ assert.equal(a.postFx.lighting.ambientIntensity,0);
+});