@hatiolab/figure-model 0.1.92 → 0.1.93

package/docs/{v3-operator-contracts.md → operator-contracts.md}

@@ -1,18 +1,18 @@
 # V3 연산·형상 계약 — 첫 실행 가능한 subset
 
-> 현재 구현·검증·제품 연결 상태는 [V3 통합 현황](v3-status.md)을 따른다. 본문의 단계별 연구/검증 기록은 제품 전체 완료 선언이 아니다.
+> 현재 구현·검증·제품 연결 상태는 [구현·검증 현황](status.md)을 따른다. 본문의 단계별 연구/검증 기록은 제품 전체 완료 선언이 아니다.
 
-후속: [좌표계 타입과 공간 의존 그래프 통합](v3-spatial-contracts.md).
+후속: [좌표계 타입과 공간 의존 그래프 통합](spatial-contracts.md).
 아래는 최초 scalar 단계의 기록이며, 현재 확장 범위는 후속 문서를 따른다.
 
-[r3 핵심 의미론](v3-core-semantics.md)을 구현하는 첫 단계다.
+[r3 핵심 의미론](core-semantics.md)을 구현하는 첫 단계다.
 상태: scalar 컴파일러 실험. 정식 V3 전체 schema나 제품 runtime이 아니다.
 시스템 설계 절차에 따라 정적 오류, 입력 의존 오류, 미지원 기능을 구분했다.
 
 ## 1. 실행 구조
 
-`docs/prototypes/v3-typed-plan.mjs`는 `compile(source)`와 그 결과의 `evaluate(inputs)`를 제공한다.
-기존 무단위 `v3-kernel.mjs`와 독립이다. 아직 두 엔진을 연결하지 않았다.
+`docs/prototypes/typed-plan.mjs`는 `compile(source)`와 그 결과의 `evaluate(inputs)`를 제공한다.
+기존 무단위 `kernel.mjs`와 독립이다. 아직 두 엔진을 연결하지 않았다.
 
 ```text
 저작 선언 → 구조/단위/출력 소유권/참조/cycle 검사 → 불변 snapshot 실행 계획
@@ -152,7 +152,7 @@ UI에서는 연산 id를 부품/의도 이름으로 연결하고 수정할 입
 ## 7. 실행 증거
 
 ```sh
-node --test docs/prototypes/v3-typed-plan.test.mjs
+node --test docs/prototypes/typed-plan.test.mjs
 ```
 
 9개 검사 통과:

package/docs/{v3-payload-collision-validation.md → payload-collision-validation.md}

@@ -1,10 +1,10 @@
 # 적재물 대 모델 전체 부품 충돌 검사 — 실험 v1
 
-> 현재 구현·검증·제품 연결 상태는 [V3 통합 현황](v3-status.md)을 따른다. 본문의 단계별 연구/검증 기록은 제품 전체 완료 선언이 아니다.
+> 현재 구현·검증·제품 연결 상태는 [구현·검증 현황](status.md)을 따른다. 본문의 단계별 연구/검증 기록은 제품 전체 완료 선언이 아니다.
 
 ## 범위
 
-[실행 코드](prototypes/v3-payload-collision.mjs)는 공간/접촉 검사 결과에 별도 collision 판정을 더한다. **현재 상태의 payload 대 모든 모델 부품**을 검사한다. 모델 부품 상호 간 충돌, 다른 외부 자산, 움직이는 경로 전체의 연속 충돌, 물리 안정성은 범위 밖이다. 따라서 '전역 충돌 완성'이라고 부르지 않는다.
+[실행 코드](prototypes/payload-collision.mjs)는 공간/접촉 검사 결과에 별도 collision 판정을 더한다. **현재 상태의 payload 대 모든 모델 부품**을 검사한다. 모델 부품 상호 간 충돌, 다른 외부 자산, 움직이는 경로 전체의 연속 충돌, 물리 안정성은 범위 밖이다. 따라서 '전역 충돌 완성'이라고 부르지 않는다.
 
 접촉 대상으로 선언된 포크도 충돌 검사에서 제외하지 않는다. 면 접촉과 내부 관통을 구분한다. 기존 geometry·capability 선언·제품 서버는 바꾸지 않는다.
 
@@ -26,7 +26,7 @@ OBB(회전 상자) 간 정적 분리축 검사(SAT)를 사용한다. 양쪽 상
 
 ## 검증
 
-[테스트](prototypes/v3-payload-collision.test.mjs):
+[테스트](prototypes/payload-collision.test.mjs):
 
 - 분리/접촉/관통/완전 포함, 허용 오차 경계, AABB가 겹치지만 OBB는 분리된 경우.
 - 일반적인 3D 회전의 결정적 난수 **1,000쌍**을 기존 Three.js OBB 구현과 대조: 교차174·분리826, 전부 일치. 두 구현은 같은 SAT 원리를 사용하므로 수학적 전 범위 증명이 아니다.
@@ -35,7 +35,7 @@ OBB(회전 상자) 간 정적 분리축 검사(SAT)를 사용한다. 양쪽 상
 - 둥근 본체의 경계 내부에 들어가는 작은 payload는 자동 통과하지 않고 미검증.
 - 잘못된 OBB·정규직교 위반과 거의 평행한 축의 수치 불확실성을 검증.
 
-Chrome에서 `--collision` 실험 화면으로 정상 배치·상단 포크 관통·공중 부유·둥근 본체 내부 배치를 직접 확인했다. 접촉과 충돌 결과를 따로 표시하며 관통한 box 부품을 붉게 표시한다. 작은 적재물이 불투명 본체 안에 가려지는 사례도 있으므로 스크린샷만으로 비충돌을 판정하지 않는다. 임시 이미지: `/private/tmp/figure-v3-full-collision.png`.
+Chrome에서 `--collision` 실험 화면으로 정상 배치·상단 포크 관통·공중 부유·둥근 본체 내부 배치를 직접 확인했다. 접촉과 충돌 결과를 따로 표시하며 관통한 box 부품을 붉게 표시한다. 작은 적재물이 불투명 본체 안에 가려지는 사례도 있으므로 스크린샷만으로 비충돌을 판정하지 않는다. 임시 이미지: `/private/tmp/figure-full-collision.png`.
 
 ## 남은 구현
 

package/docs/{v3-payload-contact-validation.md → payload-contact-validation.md}

@@ -1,10 +1,10 @@
 # 적재물 공간·평면 접촉 검사 — 실험 v1
 
-> 현재 구현·검증·제품 연결 상태는 [V3 통합 현황](v3-status.md)을 따른다. 본문의 단계별 연구/검증 기록은 제품 전체 완료 선언이 아니다.
+> 현재 구현·검증·제품 연결 상태는 [구현·검증 현황](status.md)을 따른다. 본문의 단계별 연구/검증 기록은 제품 전체 완료 선언이 아니다.
 
 ## 구현 범위
 
-[검사 코드](prototypes/v3-payload-fit.mjs)는 기존 capability compiler를 내부에서 실행한다. 외부에서 조작한 표면 결과를 받아 인증하지 않는다. 이번 단계에서 지원하는 것은 **상자 적재물 바닥과 box 부품의 top 평면**이다. 전체 물리·충돌·안전성 solver는 아니다.
+[검사 코드](prototypes/payload-fit.mjs)는 기존 capability compiler를 내부에서 실행한다. 외부에서 조작한 표면 결과를 받아 인증하지 않는다. 이번 단계에서 지원하는 것은 **상자 적재물 바닥과 box 부품의 top 평면**이다. 전체 물리·충돌·안전성 solver는 아니다.
 
 입력은 binding ID, 물체 종류와 점유 snapshot, 양의 상자 치수(mm), binding 좌표계 기준 중심(mm), Y축 회전각(deg)이다. 기울어진 적재물, 임의 메시, 곡면 받침, 파지 접촉은 이 검사 범위 밖이다. 모든 추가 필드와 잘못된 값은 거부한다.
 
@@ -37,7 +37,7 @@ binding의 centered-box region이 있을 때만 검사한다. 회전된 payload
 
 ## 검증 결과
 
-[테스트](prototypes/v3-payload-fit.test.mjs):
+[테스트](prototypes/payload-fit.test.mjs):
 
 - 포크 길이3 × 상승3 × 내밈3 × 적재물 yaw3 = **81개 상태**의 양쪽 포크 접촉.
 - 회전0에서는 포크 하나당 교차 면적 `90 × forkLength`mm²와 일치.
@@ -47,10 +47,10 @@ binding의 centered-box region이 있을 때만 검사한다. 회전된 payload
 - 충돌 가능성이 있는 높은 물체에서도 충돌/안전성은 미검증을 유지.
 - 입력 오류·모델 불변성·오류 후 재평가 검사.
 
-`node docs/prototypes/render-full-dryroom.mjs --payload`로 네 상태(정상 접촉·150mm 부유·20mm 관통·포크 사이)를 Chrome에서 렌더링하고 직접 확인했다. 임시 이미지: `/private/tmp/figure-v3-full-payload.png`. 제품 서버/DB의 실제 자산을 편집하지 않았다.
+`node docs/prototypes/render-full-dryroom.mjs --payload`로 네 상태(정상 접촉·150mm 부유·20mm 관통·포크 사이)를 Chrome에서 렌더링하고 직접 확인했다. 임시 이미지: `/private/tmp/figure-full-payload.png`. 제품 서버/DB의 실제 자산을 편집하지 않았다.
 
 ## 다음 게이트
 
 이 접촉 검사기는 사각 평면과 상자만 대상으로 한다. 반복 요소의 표면 참조는 별도 모듈에서 구현했다. 곡면·rounded profile·임의 메시 및 부분 접촉 정책, 일반적인 전역 충돌·안정성, 제품 UI·AI·저장 통합은 남아 있다. 이 검사 결과만으로 '적재 가능'이나 '안전'으로 표시하면 안 된다.
 
-후속 단계로 [payload 대 모든 부품의 충돌 검사](v3-payload-collision-validation.md)를 별도 추가했다. 상자 쌍은 정밀 OBB 검사, 곡면은 보수적 경계 검사 후 미검증으로 분리한다. 기존 접촉 검사기만 호출하면 충돌은 여전히 미검증이다.
+후속 단계로 [payload 대 모든 부품의 충돌 검사](payload-collision-validation.md)를 별도 추가했다. 상자 쌍은 정밀 OBB 검사, 곡면은 보수적 경계 검사 후 미검증으로 분리한다. 기존 접촉 검사기만 호출하면 충돌은 여전히 미검증이다.

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'