@hatiolab/figure-model 0.1.92 → 0.1.94

package/docs/prototypes/README.md

@@ -1,22 +1,22 @@
 # v3 레이아웃 설계 검증 예제
 
-`node --test docs/prototypes/v3-typed-repeat.test.mjs`: 단위/좌표계 그래프와 반복 조립체 통합.
-[배치 의도 변경과 검증 한계](../v3-typed-repeat-contracts.md)를 함께 확인한다.
+`node --test docs/prototypes/typed-repeat.test.mjs`: 단위/좌표계 그래프와 반복 조립체 통합.
+[배치 의도 변경과 검증 한계](../typed-repeat-contracts.md)를 함께 확인한다.
 
-`node --test docs/prototypes/v3-typed-plan.test.mjs`: 단위가 있는 scalar 컴파일러.
-[연산·형상 계약과 미지원 범위](../v3-operator-contracts.md)를 참조한다.
+`node --test docs/prototypes/typed-plan.test.mjs`: 단위가 있는 scalar 컴파일러.
+[연산·형상 계약과 미지원 범위](../operator-contracts.md)를 참조한다.
 
-현재 설계 방향: [r3 핵심 의미론](../v3-core-semantics.md).
-`node --test docs/prototypes/v3-semantics.test.mjs`는 부착식과 반복식을 독립 검사한다.
+현재 설계 방향: [r3 핵심 의미론](../core-semantics.md).
+`node --test docs/prototypes/semantics.test.mjs`는 부착식과 반복식을 독립 검사한다.
 기존 커널을 r3에 맞게 구현했다는 의미가 아니다.
 
 ## 공통 커널 실험
 
-`node --test docs/prototypes/v3-kernel.test.mjs`
+`node --test docs/prototypes/kernel.test.mjs`
 
 모델별 분기 없는 실행기와 실제 샘플에서 유도한 선언을 분리했다.
 범위·213개 크기/상태 조합·반례·미지원 항목은
-[공통 커널 실험 기록](../v3-common-kernel-experiment.md)을 따른다.
+[공통 커널 실험 기록](../common-kernel-experiment.md)을 따른다.
 제품 v3 구현이나 전체 샘플 변환 완료가 아니다.
 
 ## 외부 연구 구현 probe
@@ -24,7 +24,7 @@
 `shapeassembly-probe.py`는 제품 코드가 아니라 외부 고정 revision의 interpreter 호출기다.
 외부 소스/라이브러리를 이 저장소에 포함하지 않는다. 단독 실행에는 별도의 연구용 checkout과
 가상환경이 필요하다. 입력·출력은 `shapeassembly-probe-results.json`, 해석·라이선스 경계·
-재현 명령은 [실행 기록](../v3-shapeassembly-reproduction.md)을 따른다.
+재현 명령은 [실행 기록](../shapeassembly-reproduction.md)을 따른다.
 
 아래 내용은 그와 별개인 자체 r1 수치 예제다.
 
@@ -32,7 +32,7 @@
 package.json, 의존성, 서버, 소비자 runtime을 변경하지 않는다.
 
 ```sh
-node --test docs/prototypes/v3-layout.test.mjs
+node --test docs/prototypes/layout.test.mjs
 ```
 
 2026-09-20 실행 결과: 18개 테스트 통과.

package/docs/prototypes/{v3-asset-samples.mjs → asset-samples.mjs}

@@ -1,15 +1,15 @@
-import * as dryroom from './v3-full-dryroom.mjs'
-import * as conveyor from './v3-full-conveyor.mjs'
-import * as robot from './v3-full-robot.mjs'
-import * as forklift from './v3-full-forklift.mjs'
-import {robotBinding,forkliftBindings} from './v3-capability-samples.mjs'
+import * as dryroom from './full-dryroom.mjs'
+import * as conveyor from './full-conveyor.mjs'
+import * as robot from './full-robot.mjs'
+import * as forklift from './full-forklift.mjs'
+import {robotBinding,forkliftBindings} from './capability-samples.mjs'
 export function sampleAsset(kind){
  const modules={dryroom,conveyor,robot,forklift},sample=modules[kind]
  if(!sample)throw Error('unknown sample')
  const pair=kind==='robot'?robotBinding():kind==='forklift'?forkliftBindings():{model:sample.fullModel(),declaration:{version:'r3-capability-3',assetFrame:'world',bindings:[]}}
  const designInputs={},stateDefaults={}
  for(const i of pair.model.inputs)(i.role==='state'?stateDefaults:designInputs)[i.id]=sample.defaults[i.id]
- return {version:'figure-v3-asset-1',name:sample.seed.type,document:{version:'figure-v3-prototype-1',model:pair.model,capabilities:pair.declaration},designInputs,stateDefaults,
+ return {version:'figure-asset-1',name:sample.seed.type,document:{version:'figure-prototype-1',model:pair.model,capabilities:pair.declaration},designInputs,stateDefaults,
   palette:{'palette.primary':'#154473','palette.accent':'#f79c40','palette.neutral':'#96989b','palette.dark':'#27292c','palette.light':'#d6d7d9','palette.surface':'#56585b','palette.status-danger':'#f61b30','palette.status-warning':'#e68d1a','palette.status-info':'#158bde','palette.status-success':'#1cb648'},
   appearance:sample.seed.parts.map(p=>({target:p.name,material:structuredClone(p.material??{token:'palette.neutral'}),...(p.primitive==='cylinder'?{segments:p.segments??8}:{}),...(p.capability?{legacyCapability:structuredClone(p.capability)}:{})}))}
 }

package/docs/prototypes/{v3-asset-store.mjs → asset-store.mjs}

@@ -2,7 +2,7 @@
 import {readFile, open, rename, unlink} from 'node:fs/promises'
 import {join, resolve} from 'node:path'
 import {randomUUID, createHash} from 'node:crypto'
-import {parseAsset, serializeAsset} from './v3-asset.mjs'
+import {parseAsset, serializeAsset} from './asset.mjs'
 
 export class StoreError extends Error {
  constructor(code,message){super(message);this.code=code}
@@ -24,7 +24,7 @@ export function createAssetStore(directory){
  async function load(path,scope,id){
   let raw;try{raw=await readFile(path,'utf8')}catch(e){if(e.code==='ENOENT')return null;throw e}
   let record;try{record=JSON.parse(raw)}catch{fail('CORRUPT','stored record is not JSON')}
-  if(record?.format!=='v3-store-experiment-1'||record.scope!==scope||record.id!==id||typeof record.revision!=='string'||!record.revision)fail('CORRUPT','stored record identity or revision invalid')
+  if(record?.format!=='store-experiment-1'||record.scope!==scope||record.id!==id||typeof record.revision!=='string'||!record.revision)fail('CORRUPT','stored record identity or revision invalid')
   // Stored content must pass the same semantic validation as incoming content.
   parseAsset(record.text)
   return record
@@ -37,7 +37,7 @@ export function createAssetStore(directory){
    return exclusive(path,async()=>{
     const current=await load(path,scope,id)
     if((current?.revision??null)!==expectedRevision)fail('CONFLICT','asset changed; reload before saving')
-    const record={format:'v3-store-experiment-1',scope,id,revision:randomUUID(),text:canonical}
+    const record={format:'store-experiment-1',scope,id,revision:randomUUID(),text:canonical}
     const temporary=path+'.'+randomUUID()+'.tmp';let handle
     try{
      handle=await open(temporary,'wx',0o600);await handle.writeFile(JSON.stringify(record));await handle.sync();await handle.close();handle=null

package/docs/prototypes/{v3-asset-store.test.mjs → asset-store.test.mjs}

@@ -5,11 +5,11 @@ import {tmpdir} from 'node:os'
 import {join} from 'node:path'
 import {execFile} from 'node:child_process'
 import {promisify} from 'node:util'
-import {createAssetStore} from './v3-asset-store.mjs'
-import {sampleAsset} from './v3-asset-samples.mjs'
-import {serializeAsset,parseAsset} from './v3-asset.mjs'
-import {createEditorWorkspace} from './v3-editor-workspace.mjs'
-async function fixture(t){const dir=await mkdtemp(join(tmpdir(),'v3-store-'));t.after(()=>rm(dir,{recursive:true,force:true}));return {dir,store:createAssetStore(dir)}}
+import {createAssetStore} from './asset-store.mjs'
+import {sampleAsset} from './asset-samples.mjs'
+import {serializeAsset,parseAsset} from './asset.mjs'
+import {createEditorWorkspace} from './editor-workspace.mjs'
+async function fixture(t){const dir=await mkdtemp(join(tmpdir(),'store-'));t.after(()=>rm(dir,{recursive:true,force:true}));return {dir,store:createAssetStore(dir)}}
 const body=()=>serializeAsset(sampleAsset('forklift'))
 const key={scope:'test-domain',id:'forklift'}
 test('disk save survives independent store handle; explicit create and scoped identity',async t=>{
@@ -51,7 +51,7 @@ test('failed persistence does not clear editor dirty state',async t=>{
 test('a separate Node process can restore the saved asset without editor memory',async t=>{
  const {dir,store}=await fixture(t),asset=parseAsset(body());asset.designInputs.forkLength=1275
  const saved=await store.save({...key,expectedRevision:null,text:serializeAsset(asset)})
- const script=`import {createAssetStore} from ${JSON.stringify(new URL('./v3-asset-store.mjs',import.meta.url).href)};
+ const script=`import {createAssetStore} from ${JSON.stringify(new URL('./asset-store.mjs',import.meta.url).href)};
  const record=await createAssetStore(process.argv[1]).read(${JSON.stringify(key)});
  console.log(JSON.stringify({revision:record.revision,length:JSON.parse(record.text).designInputs.forkLength}));`
  const {stdout}=await promisify(execFile)(process.execPath,['--input-type=module','-e',script,dir])

package/docs/prototypes/asset.mjs

@@ -0,0 +1 @@
+export {compileFigureAsset as compileAsset,parseFigureAsset as parseAsset,serializeFigureAsset as serializeAsset,captureFigureAuthoredInputs as captureAuthoredInputs} from '../../src/asset.ts'

package/docs/prototypes/{v3-asset.schema.json → asset.schema.json}

@@ -4,9 +4,9 @@
   "type": "object", "additionalProperties": false,
   "required": ["version", "name", "document", "designInputs", "stateDefaults", "palette", "appearance"],
   "properties": {
-    "version": {"const": "figure-v3-asset-1"},
+    "version": {"const": "figure-asset-1"},
     "name": {"type": "string", "minLength": 1},
-    "document": {"$ref": "v3-document.schema.json"},
+    "document": {"$ref": "document.schema.json"},
     "designInputs": {"type": "object", "additionalProperties": {"type": "number"}},
     "stateDefaults": {"type": "object", "additionalProperties": {"type": "number"}},
     "palette": {"type": "object", "additionalProperties": {"type": "string", "pattern": "^#[0-9a-fA-F]{6}$"}},

package/docs/prototypes/{v3-asset.test.mjs → asset.test.mjs}

@@ -1,12 +1,12 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {compileAsset,serializeAsset,parseAsset,captureAuthoredInputs} from './v3-asset.mjs'
-import {sampleAsset} from './v3-asset-samples.mjs'
-import {createAuthoringSession} from './v3-authoring-session.mjs'
-import * as dryroom from './v3-full-dryroom.mjs'
-import * as conveyor from './v3-full-conveyor.mjs'
-import * as robot from './v3-full-robot.mjs'
-import * as forklift from './v3-full-forklift.mjs'
+import {compileAsset,serializeAsset,parseAsset,captureAuthoredInputs} from './asset.mjs'
+import {sampleAsset} from './asset-samples.mjs'
+import {createAuthoringSession} from './authoring-session.mjs'
+import * as dryroom from './full-dryroom.mjs'
+import * as conveyor from './full-conveyor.mjs'
+import * as robot from './full-robot.mjs'
+import * as forklift from './full-forklift.mjs'
 import fs from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
@@ -55,9 +55,9 @@ test('asset parser retains duplicate-key and invalid JSON protections',()=>{
  const a=sampleAsset('forklift');a.stateDefaults.lift=NaN;assert.throws(()=>serializeAsset(a),e=>e.code==='JSON_VALUE')
 })
 test('schema validation and real temporary JSON file round-trip, without seed lookups on reload',async()=>{
- const ajv=new Ajv({allErrors:true});ajv.addSchema(JSON.parse(await fs.readFile(new URL('./v3-document.schema.json',import.meta.url))),'v3-document.schema.json')
- const validate=ajv.compile(JSON.parse(await fs.readFile(new URL('./v3-asset.schema.json',import.meta.url))))
- const directory=await fs.mkdtemp(path.join(os.tmpdir(),'figure-v3-asset-'))
+ const ajv=new Ajv({allErrors:true});ajv.addSchema(JSON.parse(await fs.readFile(new URL('./document.schema.json',import.meta.url))),'document.schema.json')
+ const validate=ajv.compile(JSON.parse(await fs.readFile(new URL('./asset.schema.json',import.meta.url))))
+ const directory=await fs.mkdtemp(path.join(os.tmpdir(),'figure-asset-'))
  try{
   for(const kind of Object.keys(samples)){
    const asset=sampleAsset(kind);assert.ok(validate(asset),JSON.stringify(validate.errors))

package/docs/prototypes/authoring-session.mjs

@@ -0,0 +1 @@
+export {createFigureAuthoringSession as createAuthoringSession} from '../../src/authoring-session.ts'

package/docs/prototypes/{v3-authoring-session.test.mjs → authoring-session.test.mjs}

@@ -1,11 +1,11 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {createAuthoringSession} from './v3-authoring-session.mjs'
-import {repeatedBinding} from './v3-repeated-binding.mjs'
-import {forkliftBindings} from './v3-capability-samples.mjs'
-import {defaults as conveyorDefaults} from './v3-full-conveyor.mjs'
-import {defaults as forkliftDefaults} from './v3-full-forklift.mjs'
-const doc=s=>({version:'figure-v3-prototype-1',model:s.model,capabilities:s.declaration})
+import {createAuthoringSession} from './authoring-session.mjs'
+import {repeatedBinding} from './repeated-binding.mjs'
+import {forkliftBindings} from './capability-samples.mjs'
+import {defaults as conveyorDefaults} from './full-conveyor.mjs'
+import {defaults as forkliftDefaults} from './full-forklift.mjs'
+const doc=s=>({version:'figure-prototype-1',model:s.model,capabilities:s.declaration})
 const edit=(input,value,unit='mm',kind='set-design')=>({kind,input,value,unit})
 const request=(changes,expectedRevision=0,origin='ui')=>({origin,expectedRevision,changes})
 const session=()=>createAuthoringSession(doc(repeatedBinding()),{...conveyorDefaults,selectedIndex:13})

package/docs/prototypes/capability-plan.mjs

@@ -0,0 +1 @@
+export {compileFigureCapabilities as compileCapabilities} from '../../src/capabilities.ts'

package/docs/prototypes/{v3-capability-plan.test.mjs → capability-plan.test.mjs}

@@ -1,10 +1,10 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {compileCapabilities} from './v3-capability-plan.mjs'
-import {robotBinding,forkliftBindings} from './v3-capability-samples.mjs'
-import {defaults as robotDefaults} from './v3-full-robot.mjs'
-import {defaults as forkDefaults} from './v3-full-forklift.mjs'
-import {compile} from './v3-typed-plan.mjs'
+import {compileCapabilities} from './capability-plan.mjs'
+import {robotBinding,forkliftBindings} from './capability-samples.mjs'
+import {defaults as robotDefaults} from './full-robot.mjs'
+import {defaults as forkDefaults} from './full-forklift.mjs'
+import {compile} from './typed-plan.mjs'
 const near=(a,b)=>assert.ok(Math.abs(a-b)<1e-7)
 const run=s=>compileCapabilities(s.model,s.declaration)
 test('robot grip follows changing links and six joints without creating or hiding solids',()=>{

package/docs/prototypes/{v3-capability-samples.mjs → capability-samples.mjs}

@@ -1,5 +1,5 @@
-import {fullModel as robotModel} from './v3-full-robot.mjs'
-import {fullModel as forkliftModel} from './v3-full-forklift.mjs'
+import {fullModel as robotModel} from './full-robot.mjs'
+import {fullModel as forkliftModel} from './full-forklift.mjs'
 export function robotBinding(){
  const model=robotModel()
  // Explicit experimental grip reference. Original tool-seat solid is NOT removed.

package/docs/prototypes/document.mjs

@@ -0,0 +1,2 @@
+export {compileFigureDocument as compileDocument,parseFigureDocument as parseDocument,serializeFigureDocument as serializeDocument} from '../../src/document.ts'
+export {assertFigureJson as jsonOnly,parseFigureJson as parseStrictJson,FIGURE_JSON_MAX_BYTES as MAX_BYTES,figureUtf8ByteLength} from '../../src/json.ts'

package/docs/prototypes/{v3-document.schema.json → document.schema.json}

@@ -5,7 +5,7 @@
   "additionalProperties": false,
   "required": ["version", "model", "capabilities"],
   "properties": {
-    "version": {"const": "figure-v3-prototype-1"},
+    "version": {"const": "figure-prototype-1"},
     "model": {"$ref": "#/$defs/model"},
     "capabilities": {"$ref": "#/$defs/capabilities"}
   },

package/docs/prototypes/{v3-document.test.mjs → document.test.mjs}

@@ -2,13 +2,13 @@ import {test} from 'node:test'
 import assert from 'node:assert/strict'
 import fs from 'node:fs'
 import Ajv from '../../../things-factory/node_modules/ajv/lib/ajv.js'
-import {compileDocument,serializeDocument,parseDocument,MAX_BYTES} from './v3-document.mjs'
-import {compileCapabilities} from './v3-capability-plan.mjs'
-import {forkliftBindings,robotBinding} from './v3-capability-samples.mjs'
-import {defaults as forkDefaults} from './v3-full-forklift.mjs'
-import {defaults as robotDefaults} from './v3-full-robot.mjs'
-const envelope=s=>({version:'figure-v3-prototype-1',model:s.model,capabilities:s.declaration})
-const schema=JSON.parse(fs.readFileSync(new URL('./v3-document.schema.json',import.meta.url)))
+import {compileDocument,serializeDocument,parseDocument,MAX_BYTES} from './document.mjs'
+import {compileCapabilities} from './capability-plan.mjs'
+import {forkliftBindings,robotBinding} from './capability-samples.mjs'
+import {defaults as forkDefaults} from './full-forklift.mjs'
+import {defaults as robotDefaults} from './full-robot.mjs'
+const envelope=s=>({version:'figure-prototype-1',model:s.model,capabilities:s.declaration})
+const schema=JSON.parse(fs.readFileSync(new URL('./document.schema.json',import.meta.url)))
 const validate=new Ajv({allErrors:true}).compile(schema)
 test('JSON Schema and semantic compiler: serialize/parse/recompile both complete models',()=>{
  for(const [sample,args] of [[forkliftBindings(),{...forkDefaults,lift:1000,reach:200}],[robotBinding(),{...robotDefaults,'shoulder-lift':40}]]){

package/docs/prototypes/{v3-dryroom-mesh.mjs → dryroom-mesh.mjs}

@@ -2,7 +2,7 @@
 import fs from 'node:fs'
 import {fileURLToPath} from 'node:url'
 import * as THREE from '../../../things-scene/node_modules/three/build/three.module.js'
-import {compile} from './v3-typed-plan.mjs'
+import {compile} from './typed-plan.mjs'
 export const seed=JSON.parse(fs.readFileSync(new URL('../../../operato-application/packages/operato-figure/server/seed/figure-samples.json',import.meta.url))).find(s=>s.type==='DRY_ROOM').source
 const c=(id,value,unit='mm')=>({id,value,unit})
 const n=(id,op,args,outputs,params)=>({id,op,args,outputs,...(params?{params}:{})})

package/docs/prototypes/{v3-dryroom-mesh.test.mjs → dryroom-mesh.test.mjs}

@@ -1,6 +1,6 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {evaluatePortal,meshOf,meshAudit,rayHit,seed} from './v3-dryroom-mesh.mjs'
+import {evaluatePortal,meshOf,meshAudit,rayHit,seed} from './dryroom-mesh.mjs'
 const near=(a,b)=>assert.ok(Math.abs(a-b)<1e-5,`${a} != ${b}`)
 test('both actual portal profiles: baseline matches seed, bottom trim preserves top/opening/lamp',()=>{
   for(const name of ['portal-in','portal-out']){

package/docs/prototypes/{v3-editor-browser.mjs → editor-browser.mjs}

@@ -6,14 +6,14 @@ import {join} from 'node:path'
 import {randomUUID} from 'node:crypto'
 import {chromium} from '/Users/super/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/node_modules/playwright/index.mjs'
 import assert from 'node:assert/strict'
-import {createEditorWorkspace} from './v3-editor-workspace.mjs'
-import {sampleAsset} from './v3-asset-samples.mjs'
-import {serializeAsset} from './v3-asset.mjs'
-import {createV3Asset} from '../../src/v3-create.ts'
-import {createAssetStore} from './v3-asset-store.mjs'
-import {geometryOf as ordinary} from './v3-full-conveyor.mjs'
-import {geometryOf as portal} from './v3-full-dryroom.mjs'
-const directory=await mkdtemp(join(tmpdir(),'v3-editor-store-'))
+import {createEditorWorkspace} from './editor-workspace.mjs'
+import {sampleAsset} from './asset-samples.mjs'
+import {serializeAsset} from './asset.mjs'
+import {createFigureAsset} from '../../src/create.ts'
+import {createAssetStore} from './asset-store.mjs'
+import {geometryOf as ordinary} from './full-conveyor.mjs'
+import {geometryOf as portal} from './full-dryroom.mjs'
+const directory=await mkdtemp(join(tmpdir(),'editor-store-'))
 const store=createAssetStore(directory),workspace=createEditorWorkspace();let saved=null,storage=null
 const view=()=>{const v=workspace.read();return {...v,render:v.geometry.map(g=>{const mesh=(g.shape.provider==='portal'?portal:ordinary)(g);const json=mesh.toJSON();mesh.dispose();return {id:g.id,geometry:json,material:g.material}})}}
 const html=`<!doctype html><meta charset="utf-8"><title>V3 편집 연결 검증</title>
@@ -49,7 +49,7 @@ const server=createServer(async(req,res)=>{try{
  let body='';for await(const chunk of req){body+=chunk;if(body.length>20000)throw Error('request too large')}
  const q=JSON.parse(body)
  if(q.action==='open'){workspace.open(serializeAsset(sampleAsset(q.kind)));storage={scope:'isolated-browser',id:randomUUID(),expectedRevision:null}}
- else if(q.action==='new'){workspace.open(serializeAsset(createV3Asset('새 Figure')));storage={scope:'isolated-browser',id:randomUUID(),expectedRevision:null}}
+ else if(q.action==='new'){workspace.open(serializeAsset(createFigureAsset('새 Figure')));storage={scope:'isolated-browser',id:randomUUID(),expectedRevision:null}}
  else if(q.action==='add'){const id='box'+(workspace.read().revision+1);workspace.addBox({context:q.context,origin:'ui',expectedRevision:q.revision,box:{id,size:{x:800,y:1000,z:600},position:{x:0,y:500,z:0}}})}
  else if(q.action==='redo')workspace.redo({context:q.context,origin:'ui',expectedRevision:q.revision})
  else if(q.action==='apply')workspace.apply(q.request)
@@ -74,12 +74,12 @@ try{
  await page.locator('#forkLength').fill('1275');await page.locator('button[data-input="forkLength"]').click();await page.waitForFunction(()=>lastView.revision===1)
  assert.equal(await page.evaluate(()=>lastView.geometry.find(g=>g.id==='fork-low-left').shape.dimensions.depth),1275)
  await page.locator('#save').click();await page.waitForFunction(()=>!lastView.dirty)
- await page.screenshot({path:'/private/tmp/figure-v3-editor.png',fullPage:true})
+ await page.screenshot({path:'/private/tmp/figure-editor.png',fullPage:true})
  await page.locator('#model').selectOption('robot');await page.locator('#open').click();await page.waitForFunction(()=>window.meshCount===10)
  const stale=await page.evaluate(async old=>{const r=await fetch('/api',{method:'POST',body:JSON.stringify({action:'apply',request:{context:old.context,expectedRevision:0,origin:'ai',changes:[{kind:'set-design',input:'forkLength',unit:'mm',value:1500}]}})});return r.json()},old);assert.match(stale.error,/CONTEXT_CONFLICT/)
  await page.locator('#reload').click();await page.waitForFunction(()=>window.meshCount===20);assert.equal(await page.locator('#forkLength').inputValue(),'1275')
  await page.locator('#close').click();await page.waitForFunction(()=>window.meshCount===0);assert.equal(await page.locator('#fields input').count(),0)
- await page.screenshot({path:'/private/tmp/figure-v3-editor-empty.png',fullPage:true})
+ await page.screenshot({path:'/private/tmp/figure-editor-empty.png',fullPage:true})
  await page.locator('#new').click();await page.waitForFunction(()=>lastView.name==='새 Figure'&&meshCount===0)
  await page.locator('#add').click();await page.waitForFunction(()=>meshCount===1&&lastView.dirty)
  await page.locator('[id="box1.size.y"]').fill('1500');await page.locator('button[data-input="box1.size.y"]').click();await page.waitForFunction(()=>lastView.revision===2)
@@ -91,7 +91,7 @@ try{
  await page.locator('#save').click();await page.waitForFunction(()=>!lastView.dirty)
  await page.locator('#reload').click();await page.waitForFunction(()=>lastView.revision===0)
  assert.equal(await page.locator('[id="box1.size.y"]').inputValue(),'1500')
- await page.screenshot({path:'/private/tmp/figure-v3-new-authoring.png',fullPage:true})
+ await page.screenshot({path:'/private/tmp/figure-new-authoring.png',fullPage:true})
  console.log('new empty asset -> add box -> edit -> undo edit -> undo creation -> redo both -> disk save/reload: passed')
- assert.deepEqual(errors,[]);console.log(JSON.stringify({checks:['open asset','edit changes actual rendered geometry','save through HTTP to disk','switch 20 meshes to 10 without leftovers','reject stale AI context','reload edited design from independent disk store handle','close clears meshes and fields'],pageErrors:errors,screenshot:'/private/tmp/figure-v3-editor.png'},null,2))
+ assert.deepEqual(errors,[]);console.log(JSON.stringify({checks:['open asset','edit changes actual rendered geometry','save through HTTP to disk','switch 20 meshes to 10 without leftovers','reject stale AI context','reload edited design from independent disk store handle','close clears meshes and fields'],pageErrors:errors,screenshot:'/private/tmp/figure-editor.png'},null,2))
 }finally{await browser?.close();await new Promise(r=>server.close(r));await rm(directory,{recursive:true,force:true})}

package/docs/prototypes/editor-workspace.mjs

@@ -0,0 +1 @@
+export {createFigureEditorWorkspace as createEditorWorkspace} from '../../src/editor-workspace.ts'

package/docs/prototypes/{v3-editor-workspace.test.mjs → editor-workspace.test.mjs}

@@ -1,8 +1,8 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {createEditorWorkspace} from './v3-editor-workspace.mjs'
-import {sampleAsset} from './v3-asset-samples.mjs'
-import {serializeAsset} from './v3-asset.mjs'
+import {createEditorWorkspace} from './editor-workspace.mjs'
+import {sampleAsset} from './asset-samples.mjs'
+import {serializeAsset} from './asset.mjs'
 const text=kind=>serializeAsset(sampleAsset(kind))
 const edit=(view,id,value,kind='set-design')=>({context:view.context,origin:'ui',expectedRevision:view.revision,changes:[{kind,input:id,value,unit:'mm'}]})
 test('saved asset opens with fields/render appearance; edits and undo share the same session',()=>{

package/docs/prototypes/{v3-feature-pattern.test.mjs → feature-pattern.test.mjs}

@@ -1,7 +1,7 @@
 import fs from 'node:fs'
 import assert from 'node:assert/strict'
 import {test} from 'node:test'
-import {resolve,point,DesignError} from './v3-kernel.mjs'
+import {resolve,point,DesignError} from './kernel.mjs'
 
 const seeds=JSON.parse(fs.readFileSync(new URL('../../../operato-application/packages/operato-figure/server/seed/figure-samples.json',import.meta.url)))
 const src=t=>seeds.find(s=>s.type===t).source

package/docs/prototypes/{v3-full-conveyor.mjs → full-conveyor.mjs}

@@ -1,6 +1,6 @@
 import fs from 'node:fs'
-import {compile} from './v3-typed-plan.mjs'
-import {THREE,rounded} from './v3-full-dryroom.mjs'
+import {compile} from './typed-plan.mjs'
+import {THREE,rounded} from './full-dryroom.mjs'
 export const seed=JSON.parse(fs.readFileSync(new URL('../../../operato-application/packages/operato-figure/server/seed/figure-samples.json',import.meta.url))).find(s=>s.type==='CONVEYOR').source
 export const defaults={length:2400,width:600,rollerHeight:500,angle:0}
 export function fullModel(){

package/docs/prototypes/{v3-full-conveyor.test.mjs → full-conveyor.test.mjs}

@@ -1,8 +1,8 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {seed,defaults,fullModel,evaluateFull,geometryOf,sourceGeometry} from './v3-full-conveyor.mjs'
-import {compile} from './v3-typed-plan.mjs'
-import {meshAudit} from './v3-dryroom-mesh.mjs'
+import {seed,defaults,fullModel,evaluateFull,geometryOf,sourceGeometry} from './full-conveyor.mjs'
+import {compile} from './typed-plan.mjs'
+import {meshAudit} from './dryroom-mesh.mjs'
 const near=(a,b)=>assert.ok(Math.abs(a-b)<.001,`${a} != ${b}`)
 const vertices=g=>{const a=g.attributes.position;return Array.from({length:a.count},(_,i)=>[a.getX(i),a.getY(i),a.getZ(i)])}
 const deviation=(a,b)=>Math.max(...a.map(p=>Math.min(...b.map(q=>Math.hypot(...p.map((v,i)=>v-q[i]))))))

package/docs/prototypes/{v3-full-dryroom.mjs → full-dryroom.mjs}

@@ -1,6 +1,6 @@
 import * as THREE from '../../../things-scene/node_modules/three/build/three.module.js'
-import {seed} from './v3-dryroom-mesh.mjs'
-import {compile} from './v3-typed-plan.mjs'
+import {seed} from './dryroom-mesh.mjs'
+import {compile} from './typed-plan.mjs'
 export {seed,THREE}
 const c=(id,value,unit='mm')=>({id,value,unit})
 const n=(id,op,args,outputs,params)=>({id,op,args,outputs,...(params?{params}:{})})

package/docs/prototypes/{v3-full-dryroom.test.mjs → full-dryroom.test.mjs}

@@ -1,9 +1,9 @@
 import assert from 'node:assert/strict'
 import {test} from 'node:test'
 import {performance} from 'node:perf_hooks'
-import {fullModel,evaluateFull,geometryOf,sourceGeometry,seed,defaults} from './v3-full-dryroom.mjs'
-import {compile} from './v3-typed-plan.mjs'
-import {meshAudit} from './v3-dryroom-mesh.mjs'
+import {fullModel,evaluateFull,geometryOf,sourceGeometry,seed,defaults} from './full-dryroom.mjs'
+import {compile} from './typed-plan.mjs'
+import {meshAudit} from './dryroom-mesh.mjs'
 const near=(a,b,tol=1e-3)=>assert.ok(Math.abs(a-b)<tol,`${a} != ${b}`)
 const vertices=g=>{const a=g.attributes.position;return Array.from({length:a.count},(_,i)=>[a.getX(i),a.getY(i),a.getZ(i)])}
 function deviation(a,b){return Math.max(...a.map(p=>Math.min(...b.map(q=>Math.hypot(...p.map((x,i)=>x-q[i]))))))}

package/docs/prototypes/{v3-full-forklift.mjs → full-forklift.mjs}

@@ -1,6 +1,6 @@
 import fs from 'node:fs'
-import {compile} from './v3-typed-plan.mjs'
-import {geometryOf,sourceGeometry as primitiveGeometry} from './v3-full-conveyor.mjs'
+import {compile} from './typed-plan.mjs'
+import {geometryOf,sourceGeometry as primitiveGeometry} from './full-conveyor.mjs'
 export {geometryOf}
 export const seed=JSON.parse(fs.readFileSync(new URL('../../../operato-application/packages/operato-figure/server/seed/figure-samples.json',import.meta.url))).find(s=>s.type==='FORKLIFT').source
 export const defaults={forkLength:850,lift:0,reach:0,drive:0}

package/docs/prototypes/{v3-full-forklift.test.mjs → full-forklift.test.mjs}

@@ -1,8 +1,8 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {seed,defaults,fullModel,evaluateFull,geometryOf,sourceGeometry} from './v3-full-forklift.mjs'
-import {compile} from './v3-typed-plan.mjs'
-import {meshAudit} from './v3-dryroom-mesh.mjs'
+import {seed,defaults,fullModel,evaluateFull,geometryOf,sourceGeometry} from './full-forklift.mjs'
+import {compile} from './typed-plan.mjs'
+import {meshAudit} from './dryroom-mesh.mjs'
 const near=(a,b,tol=1e-6)=>assert.ok(Math.abs(a-b)<tol,`${a} != ${b}`)
 const vertices=g=>{const a=g.attributes.position;return Array.from({length:a.count},(_,i)=>[a.getX(i),a.getY(i),a.getZ(i)])}
 const deviation=(a,b)=>Math.max(...a.map(p=>Math.min(...b.map(q=>Math.hypot(...p.map((v,i)=>v-q[i]))))))

package/docs/prototypes/{v3-full-robot.mjs → full-robot.mjs}

@@ -1,6 +1,6 @@
 import fs from 'node:fs'
-import {compile} from './v3-typed-plan.mjs'
-import {geometryOf,sourceGeometry as primitiveGeometry} from './v3-full-conveyor.mjs'
+import {compile} from './typed-plan.mjs'
+import {geometryOf,sourceGeometry as primitiveGeometry} from './full-conveyor.mjs'
 export {geometryOf}
 export const seed=JSON.parse(fs.readFileSync(new URL('../../src/fixtures/robot-arm-6dof.json',import.meta.url)))
 export const defaults={upperLength:420,foreLength:380,gripper:0,...Object.fromEntries(seed.joints.map(j=>[j.name,0]))}

package/docs/prototypes/{v3-full-robot.test.mjs → full-robot.test.mjs}

@@ -1,9 +1,9 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {seed,defaults,fullModel,evaluateFull,geometryOf,sourceGeometry} from './v3-full-robot.mjs'
-import {THREE} from './v3-full-dryroom.mjs'
-import {compile} from './v3-typed-plan.mjs'
-import {meshAudit} from './v3-dryroom-mesh.mjs'
+import {seed,defaults,fullModel,evaluateFull,geometryOf,sourceGeometry} from './full-robot.mjs'
+import {THREE} from './full-dryroom.mjs'
+import {compile} from './typed-plan.mjs'
+import {meshAudit} from './dryroom-mesh.mjs'
 const near=(a,b,tol=1e-7)=>assert.ok(Math.abs(a-b)<tol,`${a} != ${b}`)
 const vec=(a,b)=>a.forEach((v,i)=>near(v,b[i]))
 const vertices=g=>{const a=g.attributes.position;return Array.from({length:a.count},(_,i)=>[a.getX(i),a.getY(i),a.getZ(i)])}

package/docs/prototypes/{v3-kernel.test.mjs → kernel.test.mjs}

@@ -1,7 +1,7 @@
 import fs from 'node:fs'
 import assert from 'node:assert/strict'
 import {test} from 'node:test'
-import {resolve,point,DesignError} from './v3-kernel.mjs'
+import {resolve,point,DesignError} from './kernel.mjs'
 
 const seeds=JSON.parse(fs.readFileSync(new URL('../../../operato-application/packages/operato-figure/server/seed/figure-samples.json',import.meta.url)))
 const robot=JSON.parse(fs.readFileSync(new URL('../../src/fixtures/robot-arm-6dof.json',import.meta.url)))

package/docs/prototypes/{v3-layout.test.mjs → layout.test.mjs}

@@ -1,4 +1,4 @@
-// Design witnesses only. Not imported by production; not a complete v3 evaluator.
+// Design witnesses only. Not imported by production; not a complete evaluator.
 import test from 'node:test'
 import assert from 'node:assert/strict'
 

package/docs/prototypes/{v3-more-samples.test.mjs → more-samples.test.mjs}

@@ -1,4 +1,4 @@
-// Design probes, not a v3 implementation. No source assets are modified.
+// Design probes, not a implementation. No source assets are modified.
 import fs from 'node:fs'
 import assert from 'node:assert/strict'
 import { test } from 'node:test'
@@ -106,7 +106,7 @@ for(const type of ['CELL_TRAY','FORMATION_TRAY'])test(`${type}: fixed count, wal
     const plan=repeatPlanOfPart(cell,{x:scale,y:1,z:1},s.base)
     assert.equal(plan.count,8)
     const edge=(repeatOffset(plan.count-1,plan.count,plan.pitch)+cell.transform.size.x/2)*scale
-    // Explicit v3 candidate: wall thickness remains 30mm. Geometry fits only above a bound.
+    // Explicit candidate: wall thickness remains 30mm. Geometry fits only above a bound.
     const clearance=s.base.x*scale/2-tub.shape.hollow.wall-edge
     near(clearance,36*scale-30)
     if(type==='FORMATION_TRAY') {

package/docs/prototypes/{v3-payload-collision.mjs → payload-collision.mjs}

@@ -1,5 +1,5 @@
-import {compilePayloadInspection} from './v3-payload-fit.mjs'
-import {ContractError} from './v3-typed-plan.mjs'
+import {compilePayloadInspection} from './payload-fit.mjs'
+import {ContractError} from './typed-plan.mjs'
 const dot=(a,b)=>a.reduce((s,v,i)=>s+v*b[i],0)
 const cross=(a,b)=>[a[1]*b[2]-a[2]*b[1],a[2]*b[0]-a[0]*b[2],a[0]*b[1]-a[1]*b[0]]
 const columns=r=>[0,1,2].map(i=>r.map(row=>row[i]))

package/docs/prototypes/{v3-payload-collision.test.mjs → payload-collision.test.mjs}

@@ -1,8 +1,8 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {boxRelation,compileCollisionInspection} from './v3-payload-collision.mjs'
-import {forkliftBindings} from './v3-capability-samples.mjs'
-import {defaults} from './v3-full-forklift.mjs'
+import {boxRelation,compileCollisionInspection} from './payload-collision.mjs'
+import {forkliftBindings} from './capability-samples.mjs'
+import {defaults} from './full-forklift.mjs'
 import {OBB} from '../../../things-scene/node_modules/three/examples/jsm/math/OBB.js'
 import * as THREE from '../../../things-scene/node_modules/three/build/three.module.js'
 const identity=[[1,0,0],[0,1,0],[0,0,1]],box=(center,half=[1,1,1],axes=identity)=>({center,half,axes})

package/docs/prototypes/{v3-payload-fit.mjs → payload-fit.mjs}

@@ -1,6 +1,6 @@
 // Bounded geometric inspection, not a load-bearing or collision-safety certificate.
-import {compileCapabilities} from './v3-capability-plan.mjs'
-import {ContractError} from './v3-typed-plan.mjs'
+import {compileCapabilities} from './capability-plan.mjs'
+import {ContractError} from './typed-plan.mjs'
 const fail=(code,message)=>{throw new ContractError(code,'payload',message)}
 const dot=(a,b)=>a.reduce((s,v,i)=>s+v*b[i],0)
 const mv=(r,v)=>r.map(row=>dot(row,v))

package/docs/prototypes/{v3-payload-fit.test.mjs → payload-fit.test.mjs}

@@ -1,9 +1,9 @@
 import {test} from 'node:test'
 import assert from 'node:assert/strict'
-import {compilePayloadInspection} from './v3-payload-fit.mjs'
-import {forkliftBindings,robotBinding} from './v3-capability-samples.mjs'
-import {defaults} from './v3-full-forklift.mjs'
-import {defaults as robotDefaults} from './v3-full-robot.mjs'
+import {compilePayloadInspection} from './payload-fit.mjs'
+import {forkliftBindings,robotBinding} from './capability-samples.mjs'
+import {defaults} from './full-forklift.mjs'
+import {defaults as robotDefaults} from './full-robot.mjs'
 const payload={bindingId:'load-low',type:'PALLET',occupied:0,dimensions:[620,100,850],center:[260,50,0],yawDeg:0}
 const plan=s=>compilePayloadInspection(s.model,s.declaration)
 const near=(a,b)=>assert.ok(Math.abs(a-b)<1e-5,`${a} != ${b}`)