@hatiolab/figure-model 0.1.92 → 0.1.94

package/CHANGELOG.md

@@ -8,30 +8,30 @@
 
 ### 속 빈 상자를 부품으로 (2026-09-26, G4)
 
-`addV3Primitive` · `add-part` 가 `hollow-box`(윗면이 열린 통: 폭 · 높이 · 깊이 · 모서리 · 벽 두께 · 바닥 두께, `hollow-box@2`)를 만든다.
+`addFigurePrimitive` · `add-part` 가 `hollow-box`(윗면이 열린 통: 폭 · 높이 · 깊이 · 모서리 · 벽 두께 · 바닥 두께, `hollow-box@2`)를 만든다.
 안쪽 면(`inside-bottom` · `inside-left` · `inside-right` · `inside-back` · `inside-front`)도 붙이는 면이라 칸막이를 세울 수 있다.
 크기를 따를 때와 공간을 잴 때는 바깥이 치수다. 벽과 바닥은 두께를 지킨다. `set-joint` 도 `narrowRange` 를 받는다.
 
 ### 모델로 먼저 만든 템플릿을 레시피로 (2026-09-26, ADR-0095 고침)
 
-`buildV3Recipe(spec, models)`: 템플릿을 선택지 조합마다 도형(모델: `host` 상자와 거기에 붙은 부품)으로 만들고, 그 모델들을 레시피
+`buildFigureRecipe(spec, models)`: 템플릿을 선택지 조합마다 도형(모델: `host` 상자와 거기에 붙은 부품)으로 만들고, 그 모델들을 레시피
 하나로 합친다. 모든 모델에 있는 명령은 그대로, 일부에만 있는 명령은 그것을 가르는 선택 하나의 `when` 을 붙인다. 사람이 정하는 수는
 명세가 가리키는 명령의 값에 매개변수로 건다(기본값에 대한 배율). 모델이 빠진 조합 · 어느 선택으로도 말할 수 없는 명령 · 걸 수가
-없는 수는 까닭과 함께 거절한다. `v3RecipeFromParts` 를 되살렸다(재질의 색은 부품마다 제 것만 적는다 — 선택지마다 같게).
+없는 수는 까닭과 함께 거절한다. `figureRecipeFromParts` 를 되살렸다(재질의 색은 부품마다 제 것만 적는다 — 선택지마다 같게).
 
 ### 조각 템플릿은 figure-service 의 정적 파일로 · 카탈로그용 설명 (2026-09-26, ADR-0095 고침)
 
 0.1.82 가 패키지의 `recipes/*.json` 으로 싣던 조각 셋은 figure-service 의 `recipes/<name>/` 로 옮겼다(백엔드가 정적 파일로 제공한다).
 figure-model 에는 적용과 검사만 남는다. `recipes/` 폴더와 `./recipes/*` export 는 없앴다. 매개변수는 짧은 설명 `hint`(언어별)를 가질 수
-있다. `describeV3Recipe`: 카탈로그가 보일 것 — 선택에 따라 더해지는 부품 수(가장 적게 · 많게), 움직이는 부품과 방식(미끄러짐 ·
+있다. `describeFigureRecipe`: 카탈로그가 보일 것 — 선택에 따라 더해지는 부품 수(가장 적게 · 많게), 움직이는 부품과 방식(미끄러짐 ·
 회전 · 따라 움직임), 더해지는 조작값, 조작값에 따라 보이는 부품, 되풀이 줄. 글로 따로 적지 않고 명령에서 셈한다.
-`v3FollowOf`(치수가 무엇을 따르나, 거꾸로 읽기)를 figure-ui 에서 옮겨 왔다.
+`figureFollowOf`(치수가 무엇을 따르나, 거꾸로 읽기)를 figure-ui 에서 옮겨 왔다.
 
 ### 조각(recipe) (2026-09-26, ADR-0095)
 
-조각은 매개변수가 붙은 제안 명령 목록이다. `parseV3Recipe` · `resolveV3Recipe` · `applyV3Recipe`: 자리 채우기 셋(`{id}` ·
+조각은 매개변수가 붙은 제안 명령 목록이다. `parseFigureRecipe` · `resolveFigureRecipe` · `applyFigureRecipe`: 자리 채우기 셋(`{id}` ·
 `{target}` · `{매개변수}`), 한 매개변수의 일차식(`{ param, times?, plus? }`), 명령마다 `when` 하나. 식 언어는 없다. 값은 커널보다
-먼저 범위와 선택지로 거르고, 풀린 목록은 `applyV3Proposal` 로 적용한다. 넣은 뒤에는 보통 부품이다. 기본 조각 셋을 패키지의
+먼저 범위와 선택지로 거르고, 풀린 목록은 `applyFigureProposal` 로 적용한다. 넣은 뒤에는 보통 부품이다. 기본 조각 셋을 패키지의
 `recipes/`(미닫이 문 · 여닫이 문 · 롤러 줄)에 싣는다. `make-repeat` 도 `narrowRange` 를 받는다 — 한 줄이 채우는 복제는
 REPEAT_LIMIT 개까지라, 크기를 따르는 도형에 가장 큰 크기가 생긴다.
 
@@ -45,7 +45,7 @@ REPEAT_LIMIT 개까지라, 크기를 따르는 도형에 가장 큰 크기가
 
 `portal-profile@1`(부호 있는 좌표 여덟)을 `portal-profile@2`로 바꿨다. 입력은 폭 · 높이 · 깊이 · 기둥 두께(`jamb`) · 인방 두께(`head`)이고,
 좌우로 가운데, 바닥에 서고, 깊이로 가운데다. 앞 셋이 상자와 같은 자리라 `link-dimension` 과 크기 따르기가 상자처럼 먹는다
-(이전에는 거절했다). 기둥과 인방은 크기를 따라도 두께를 지킨다. `addV3Primitive` 의 `portal` 치수도 이 다섯이다.
+(이전에는 거절했다). 기둥과 인방은 크기를 따라도 두께를 지킨다. `addFigurePrimitive` 의 `portal` 치수도 이 다섯이다.
 @1 은 지웠다 — 저장된 도형 가운데 쓰는 것이 없었다.
 
 ### 자기 숫자로 놓인 부품 위의 되풀이 (2026-09-26)
@@ -63,12 +63,12 @@ REPEAT_LIMIT 개까지라, 크기를 따르는 도형에 가장 큰 크기가
 
 ### V1 · V2 형식을 지웠다 (2026-09-26)
 
-남은 형식은 `figure-v3-asset-1` 하나다. `FigureSource` · `compile` · `validate` · `costOf` · `scoreOf` ·
-크기 반응(`sizing`) · 발행 관문(`gate`) · `contractChanges` · V2→V3 변환기(`convertV2ToV3` 와 그 짝)와
+남은 형식은 `figure-asset-1` 하나다. `FigureSource` · `compile` · `validate` · `costOf` · `scoreOf` ·
+크기 반응(`sizing`) · 발행 관문(`gate`) · `contractChanges` · V2→V3 변환기(`convertV2ToFigure` 와 그 짝)와
 `./types` · `./validate` · `./blueprint` · `./cost` 하위 경로를 지웠다. V3 가 함께 쓰던 낱말(`AXES` ·
 `FIGURE_CAPABILITIES` · `CAPABILITY_NEEDS` · `MATERIAL_PRESETS` · `REPEAT_LIMIT` · `DETAIL_LEVELS` · `PART_LIMIT` ·
-`SKIN` · `LIMITS` · `SEGMENT_PRESETS` · `V3_SIZE_INPUTS` · `FigureGrade` · `TYPE_PATTERN` · `TYPE_LENGTH` ·
-`placeholderType` · `isPlaceholderType`)은 `v3-words.ts` 로 옮겨 그대로 내보낸다.
+`SKIN` · `LIMITS` · `SEGMENT_PRESETS` · `FIGURE_SIZE_INPUTS` · `FigureGrade` · `TYPE_PATTERN` · `TYPE_LENGTH` ·
+`placeholderType` · `isPlaceholderType`)은 `words.ts` 로 옮겨 그대로 내보낸다.
 V3 컴파일이 혼자 설 수 없는 능력(`Transferable`)을 거절한다 — V2 의 `validate` 가 하던 검사다.
 
 아래는 V2 시절의 기록이다.

package/README.md

@@ -1,8 +1,8 @@
 # @hatiolab/figure-model
 
-> Implementation and verification status: [docs/v3-status.md](docs/v3-status.md).
+> Implementation and verification status: [docs/status.md](docs/status.md).
 
-The figure format, `figure-v3-asset-1`: its kernel, authoring commands, release gate, score and AI proposal
+The figure format, `figure-asset-1`: its kernel, authoring commands, release gate, score and AI proposal
 grammar. No runtime dependencies.
 
 The package contains no renderer. The modeller authors with it, the server judges and stores with it, and the scene
@@ -31,26 +31,26 @@ npm install @hatiolab/figure-model
 Everything is exported from the package root.
 
 ```ts
-import { parseV3Asset, compileV3Asset, inspectV3Asset, v3ScoreOf } from '@hatiolab/figure-model'
+import { parseFigureAsset, compileFigureAsset, inspectFigureAsset, figureScoreOf } from '@hatiolab/figure-model'
 ```
 
 ## Main exports
 
 | Area | Exports |
 | --- | --- |
-| Asset document | `parseV3Asset`, `serializeV3Asset`, `compileV3Asset`, `captureV3AuthoredInputs`; types from `v3-asset-types.ts`, `V3_PLACEMENTS` |
-| Kernel (typed graph) | `compileV3Graph`, `V3_OPERATORS`, `V3_NON_AFFINE_OPERATORS`, `V3_STATE_NON_AFFINE_OPERATORS`, `V3_OPERATOR_STATE_POLICY`, `v3ShapeFaces`, `V3_KERNEL_VERSION`, `V3_FACE_NORMALS`; graph types (`V3Graph`, `V3CompiledGraph`, …) |
-| Instance size | `V3_INSTANCE_SIZE_INPUTS`, `V3_INSTANCE_SIZE_DEFAULT`, `defaultInstanceSizeRange`, `foldInstanceSizeRange`, `v3InstanceSizeLimitsOf` |
-| Motion and state | `driverValue`, `driverStates`, `normalisePhase`, `validateV3Drivers`, `validateV3StateInputs`, `advanceStateValue`, `stateInputPolicy` |
-| Authoring commands | `createV3Asset`, `addV3Box`, `addV3Primitive`, `editV3Part`, `applyV3Authoring`, `proposeV3Occupancy`, `proposeV3Proportion`, `checkV3Joints`, `v3AttachmentsOf`, `v3BindingsOf` |
-| Authoring session | `createV3AuthoringSession`, `createV3EditorWorkspace` |
-| Release gate | `inspectV3Asset`, `v3WorldBoxesOf`, `v3OccupiedBoxesOf`, `v3WritersOf`, `v3PartsExtentOf`, `v3ContractChanges` |
-| Score and cost | `v3ScoreOf`, `v3GradeOf`, `v3PartCountOf`, `v3PartBudgetOf`, `v3CostOf`, `v3TrianglesOf` |
-| AI proposal grammar | `applyV3Proposal`, `V3_PROPOSAL_GRAMMAR`, `V3_PROPOSAL_KINDS` |
-| Capabilities and documents | `compileV3Capabilities`, `compileV3Document`, `parseV3Document`, `serializeV3Document` |
-| JSON input boundary | `parseV3Json`, `assertV3Json`, `V3_JSON_MAX_BYTES`, `V3_JSON_MAX_DEPTH`, `V3ContractError` |
-| Shared words | `AXES`, `FIGURE_CAPABILITIES`, `MATERIAL_PRESETS`, `SEGMENT_PRESETS`, `DETAIL_LEVELS`, `PART_LIMIT`, `LIMITS`, … (`v3-words.ts`) |
-| Example | `robotArmV3`, `ROBOT_ARM_CHAIN` |
+| Asset document | `parseFigureAsset`, `serializeFigureAsset`, `compileFigureAsset`, `captureFigureAuthoredInputs`; types from `asset-types.ts`, `FIGURE_PLACEMENTS` |
+| Kernel (typed graph) | `compileFigureGraph`, `FIGURE_OPERATORS`, `FIGURE_NON_AFFINE_OPERATORS`, `FIGURE_STATE_NON_AFFINE_OPERATORS`, `FIGURE_OPERATOR_STATE_POLICY`, `figureShapeFaces`, `FIGURE_KERNEL_VERSION`, `FIGURE_FACE_NORMALS`; graph types (`FigureGraph`, `FigureCompiledGraph`, …) |
+| Instance size | `FIGURE_INSTANCE_SIZE_INPUTS`, `FIGURE_INSTANCE_SIZE_DEFAULT`, `defaultInstanceSizeRange`, `foldInstanceSizeRange`, `figureInstanceSizeLimitsOf` |
+| Motion and state | `driverValue`, `driverStates`, `normalisePhase`, `validateFigureDrivers`, `validateFigureStateInputs`, `advanceStateValue`, `stateInputPolicy` |
+| Authoring commands | `createFigureAsset`, `addFigureBox`, `addFigurePrimitive`, `editFigurePart`, `applyFigureAuthoring`, `proposeFigureOccupancy`, `proposeFigureProportion`, `checkFigureJoints`, `figureAttachmentsOf`, `figureBindingsOf` |
+| Authoring session | `createFigureAuthoringSession`, `createFigureEditorWorkspace` |
+| Release gate | `inspectFigureAsset`, `figureWorldBoxesOf`, `figureOccupiedBoxesOf`, `figureWritersOf`, `figurePartsExtentOf`, `figureContractChanges` |
+| Score and cost | `figureScoreOf`, `figureGradeOf`, `figurePartCountOf`, `figurePartBudgetOf`, `figureCostOf`, `figureTrianglesOf` |
+| AI proposal grammar | `applyFigureProposal`, `FIGURE_PROPOSAL_GRAMMAR`, `FIGURE_PROPOSAL_KINDS` |
+| Capabilities and documents | `compileFigureCapabilities`, `compileFigureDocument`, `parseFigureDocument`, `serializeFigureDocument` |
+| JSON input boundary | `parseFigureJson`, `assertFigureJson`, `FIGURE_JSON_MAX_BYTES`, `FIGURE_JSON_MAX_DEPTH`, `FigureContractError` |
+| Shared words | `AXES`, `FIGURE_CAPABILITIES`, `MATERIAL_PRESETS`, `SEGMENT_PRESETS`, `DETAIL_LEVELS`, `PART_LIMIT`, `LIMITS`, … (`words.ts`) |
+| Example | `robotArmFigure`, `ROBOT_ARM_CHAIN` |
 
 ## Commands
 
@@ -76,12 +76,12 @@ No runtime dependencies; it runs unchanged in the browser. The three devDependen
 
 ## Documents
 
-- [v3-design.md](docs/v3-design.md) — the design and its reasons
-- [v3-core-semantics.md](docs/v3-core-semantics.md) — core semantics of the kernel
-- [v3-shape-dimension-contract.md](docs/v3-shape-dimension-contract.md) — shape dimensions and how they respond to size
-- [v3-spatial-contracts.md](docs/v3-spatial-contracts.md) — spatial contracts
-- [v3-motion-contract.md](docs/v3-motion-contract.md) — joints, state inputs and drivers
-- [v3-asset-persistence.md](docs/v3-asset-persistence.md) — the stored asset document
-- [v3-authoring-transactions.md](docs/v3-authoring-transactions.md) — authoring commands
-- [v3-capability-bindings.md](docs/v3-capability-bindings.md) — capability bindings
-- [v3-status.md](docs/v3-status.md) — implementation and verification status
+- [design.md](docs/design.md) — the design and its reasons
+- [core-semantics.md](docs/core-semantics.md) — core semantics of the kernel
+- [shape-dimension-contract.md](docs/shape-dimension-contract.md) — shape dimensions and how they respond to size
+- [spatial-contracts.md](docs/spatial-contracts.md) — spatial contracts
+- [motion-contract.md](docs/motion-contract.md) — joints, state inputs and drivers
+- [asset-persistence.md](docs/asset-persistence.md) — the stored asset document
+- [authoring-transactions.md](docs/authoring-transactions.md) — authoring commands
+- [capability-bindings.md](docs/capability-bindings.md) — capability bindings
+- [status.md](docs/status.md) — implementation and verification status

package/dist/{v3-asset-types.d.ts → asset-types.d.ts}

@@ -1,27 +1,27 @@
-import type { V3Joint } from './v3-authoring-actions.ts';
-import type { V3Graph, V3Geometry, V3Pose, V3RuntimeValue, V3ValueType } from './v3-graph-types.ts';
-export interface V3SurfaceReference {
+import type { FigureJoint } from './authoring-actions.ts';
+import type { FigureGraph, FigureGeometry, FigurePose, FigureRuntimeValue, FigureValueType } from './graph-types.ts';
+export interface FigureSurfaceReference {
     placement: string;
     feature: string;
 }
-export interface V3BindingDeclaration {
+export interface FigureBindingDeclaration {
     id: string;
     label: string;
     role: 'seat' | 'grip';
     frame: string;
-    pose: string | V3SurfaceReference;
+    pose: string | FigureSurfaceReference;
     accepts: string[];
     capacity: number;
     region?: {
         kind: 'centered-box';
         dimensions: [string, string, string];
     };
-    contacts?: V3SurfaceReference[];
+    contacts?: FigureSurfaceReference[];
 }
-export interface V3Capabilities {
+export interface FigureCapabilities {
     version: 'r3-capability-3';
     assetFrame: string;
-    bindings: V3BindingDeclaration[];
+    bindings: FigureBindingDeclaration[];
     /**
      * What the figure can do, by name, for the scene to attach behaviour (ADR-0051 ④, ADR-0087 decision 3).
      * Every name must be in `FIGURE_CAPABILITIES`; the check reads that list, it does not copy it.
@@ -32,7 +32,7 @@ export interface V3Capabilities {
  * The volume the author declares the figure occupies, and the face it is mounted on (ADR-0044, ADR-0045,
  * ADR-0087 decision 3).
  *
- * **The reach on each side of the asset origin, not an extent rising from it** (V3 designer's ruling
+ * **The reach on each side of the asset origin, not an extent rising from it** (designer's ruling
  * 2026-09-23). The origin is where the figure is mounted; it is a coordinate reference, not a surface nothing
  * may pass. A robot arm bolted to a bench reaches below the bench, and that is the machine working, not a
  * fault. An extent could only grow upward and outward from the centre, so it could say neither that, nor a
@@ -40,7 +40,7 @@ export interface V3Capabilities {
  *
  * Each of the six names a length value in the graph; `min` is normally negative below or left of the origin.
  * A part outside the declared volume, or a floor figure whose parts do not reach the plane it is mounted on,
- * is a release violation reported by `inspectV3Asset`.
+ * is a release violation reported by `inspectFigureAsset`.
  *
  * What this is not: a rule about what the figure may do. It describes the room the figure takes up. Whether
  * that room is free is the scene's question, against the real obstacles it has placed.
@@ -50,9 +50,9 @@ export interface V3Capabilities {
  * plane Y = 0 -- a part stands on it by its bottom or hangs from it by its top; a wall is the plane Z = 0, the figure
  * coming out of it along +Z, a part fastened to it by its back; `center` has no plane of its own.
  */
-export type V3Placement = 'floor' | 'ceiling' | 'center' | 'wall';
-export declare const V3_PLACEMENTS: readonly V3Placement[];
-export interface V3Occupancy {
+export type FigurePlacement = 'floor' | 'ceiling' | 'center' | 'wall';
+export declare const FIGURE_PLACEMENTS: readonly FigurePlacement[];
+export interface FigureOccupancy {
     bounds: {
         x: {
             min: string;
@@ -67,9 +67,8 @@ export interface V3Occupancy {
             max: string;
         };
     };
-    placement: V3Placement;
     /**
-     * The face of the figure that lies on the plane it is mounted on (V3 designer's ruling 2026-09-23).
+     * The face of the figure that lies on the plane it is mounted on (designer's ruling 2026-09-23).
      *
      * Absent means the figure is not asked to touch anything. The origin is a coordinate reference, not a surface
      * the drawing must reach: a figure may be fastened through a bracket nobody drew, or by a mounting structure
@@ -80,75 +79,75 @@ export interface V3Occupancy {
      * asking for it is a one-sided position test, which passes a body that hangs entirely below the plane and fails
      * a design that reaches under it on purpose. It is also the smallest gap over the parts, which folds, so it
      * could not be settled over a state range. One named face is a single equality and settles both
-     * (V3 designer's ruling 2026-09-23, after two counterexamples).
+     * (designer's ruling 2026-09-23, after two counterexamples).
      */
     contact?: {
         plane: 'mounting-plane';
-        surface: V3SurfaceReference;
+        surface: FigureSurfaceReference;
     };
 }
-export interface V3Document {
-    version: 'figure-v3-prototype-1';
-    model: V3Graph;
-    capabilities: V3Capabilities;
+export interface FigureDocument {
+    version: 'figure-prototype-1';
+    model: FigureGraph;
+    capabilities: FigureCapabilities;
 }
-export interface V3BindingRequest {
+export interface FigureBindingRequest {
     type: string;
     occupied: number;
 }
-export type V3Check = {
+export type FigureCheck = {
     status: 'unverified';
     reason: string;
 } | {
     status: 'satisfied' | 'failed';
     reasons?: string[];
 };
-export interface V3EvaluatedSurface extends V3SurfaceReference {
+export interface FigureEvaluatedSurface extends FigureSurfaceReference {
     geometryId: string;
     provider: string;
     face: string;
-    pose: V3Pose;
+    pose: FigurePose;
     normal: number[];
     provenance: 'verified-planar-surface';
 }
-export interface V3EvaluatedBinding {
+export interface FigureEvaluatedBinding {
     id: string;
     label: string;
     role: 'seat' | 'grip';
     frame: string;
-    pose: V3Pose;
+    pose: FigurePose;
     targetGeometryId?: string;
     region: {
         kind: 'centered-box';
         dimensions: number[];
     } | null;
-    contacts: V3EvaluatedSurface[];
+    contacts: FigureEvaluatedSurface[];
     checks: {
-        declaration: V3Check;
-        eligibility: V3Check;
-        spatial: V3Check;
-        collision: V3Check;
-        safety: V3Check;
+        declaration: FigureCheck;
+        eligibility: FigureCheck;
+        spatial: FigureCheck;
+        collision: FigureCheck;
+        safety: FigureCheck;
     };
 }
-export interface V3CapabilityEvaluation {
-    geometry: V3Geometry[];
-    bindings: V3EvaluatedBinding[];
+export interface FigureCapabilityEvaluation {
+    geometry: FigureGeometry[];
+    bindings: FigureEvaluatedBinding[];
     /** Every value the graph produced, so a reader can resolve a reference it declared (such as a visibility flag). */
-    values: Record<string, V3RuntimeValue>;
+    values: Record<string, FigureRuntimeValue>;
 }
-export interface V3CompiledCapabilities {
+export interface FigureCompiledCapabilities {
     /** The compiled graph's value types, so a reader can check what a reference names before evaluating. */
-    outputTypes: Record<string, V3ValueType>;
+    outputTypes: Record<string, FigureValueType>;
     /** Which state inputs each value depends on (shape-dimension contract §2). */
     dependence: Record<string, string[]>;
-    evaluate(inputs: Record<string, number>, requests?: Record<string, V3BindingRequest>): V3CapabilityEvaluation;
+    evaluate(inputs: Record<string, number>, requests?: Record<string, FigureBindingRequest>): FigureCapabilityEvaluation;
     /** An evaluator for one instance: it keeps its last evaluation and runs again only what changed since. */
     evaluator(): {
-        evaluate(inputs: Record<string, number>, requests?: Record<string, V3BindingRequest>): V3CapabilityEvaluation;
+        evaluate(inputs: Record<string, number>, requests?: Record<string, FigureBindingRequest>): FigureCapabilityEvaluation;
     };
 }
-export interface V3Material {
+export interface FigureMaterial {
     token: string;
     preset?: 'default' | 'metal' | 'glass' | 'plastic' | 'wood' | 'ceramic' | 'rubber';
     transparent?: boolean;
@@ -158,12 +157,12 @@ export interface V3Material {
         on: boolean;
     };
 }
-export interface V3Appearance {
+export interface FigureAppearance {
     target: string;
-    material: V3Material;
+    material: FigureMaterial;
     segments?: number;
     /**
-     * A `flag` value in the graph saying whether this part is shown (V3 designer's ruling 2026-09-22).
+     * A `flag` value in the graph saying whether this part is shown (designer's ruling 2026-09-22).
      * Absent means always shown.
      *
      * The evaluation contract for a hidden part:
@@ -176,10 +175,10 @@ export interface V3Appearance {
     visibility?: string;
 }
 /**
- * A driver computes one state input from time (docs/v3-motion-contract.md). The kernel never sees time; the
+ * A driver computes one state input from time (docs/motion-contract.md). The kernel never sees time; the
  * consumer that owns time calls `driverValue` and writes the result into the state input it names.
  */
-export interface V3Driver {
+export interface FigureDriver {
     /** An opaque identifier, unique among the asset's drivers. Nothing is read out of its spelling. */
     id: string;
     /**
@@ -206,9 +205,9 @@ export interface V3Driver {
 }
 /**
  * What a person sees for a state input, and how the figure moves toward a new value for it
- * (V3 designer's ruling 2026-09-22). Keyed by the input's id, which stays the stable identifier.
+ * (designer's ruling 2026-09-22). Keyed by the input's id, which stays the stable identifier.
  */
-export interface V3StateInputPolicy {
+export interface FigureStateInputPolicy {
     /** The name shown to a person. Kept apart from the id so renaming the label never renames the input. */
     label?: string;
     /**
@@ -220,18 +219,25 @@ export interface V3StateInputPolicy {
      */
     sweep?: number;
 }
-export interface V3Asset {
-    version: 'figure-v3-asset-1';
+export interface FigureAsset {
+    version: 'figure-asset-1';
     name: string;
-    document: V3Document;
+    document: FigureDocument;
     designInputs: Record<string, number>;
     stateDefaults: Record<string, number>;
     palette: Record<string, string>;
-    appearance: V3Appearance[];
-    occupancy?: V3Occupancy;
-    drivers?: V3Driver[];
+    appearance: FigureAppearance[];
+    occupancy?: FigureOccupancy;
+    /**
+     * Where the figure is authored from -- the floor, the ceiling, a wall or its centre (ADR-0097, designer 2026-09-27).
+     * The figure's own setting, apart from the room it declares: it can be chosen before there is a part to measure.
+     * Left out, the figure stands on the floor. An asset written before stored it in `occupancy.placement`;
+     * `upgradeFigurePlacement` moves it here when the asset is read.
+     */
+    placement?: FigurePlacement;
+    drivers?: FigureDriver[];
     /** Per state input: its display label and its transition time. Inputs absent here have neither. */
-    stateInputs?: Record<string, V3StateInputPolicy>;
+    stateInputs?: Record<string, FigureStateInputPolicy>;
     /**
      * How the figure grows when a board gives it another size. Absent: each part follows its own rules. `uniform`:
      * the whole figure by one ratio, the geometric mean of the three axes' -- a mechanism does not shear (chief
@@ -245,18 +251,18 @@ export interface V3Asset {
      */
     detailLevel?: 'S' | 'M' | 'L';
     /**
-     * The joints, URDF's records with V3 values (ADR-0093): the canon of how parts hang together and move. Their graph
+     * The joints, URDF's records with values (ADR-0093): the canon of how parts hang together and move. Their graph
      * nodes are made from them; an asset whose nodes disagree with them is refused on reading.
      */
-    joints?: V3Joint[];
+    joints?: FigureJoint[];
     /**
      * The design inputs a board may set per instance, chosen by the figure's author (ADR-0096): a roller row's pitch.
      * Each points at an input of the model; its unit, default and range are the input's own. Not the size inputs (a
      * board sets the size from its bounds), not state inputs, and only inputs with a finite range.
      */
-    publicInputs?: V3PublicInput[];
+    publicInputs?: FigurePublicInput[];
 }
-export interface V3PublicInput {
+export interface FigurePublicInput {
     /** The design input's id. */
     input: string;
     /** The name shown to a person on a board. */
@@ -264,17 +270,17 @@ export interface V3PublicInput {
     /** One line on what it sets. */
     hint?: string;
 }
-export type V3AssetGeometry = V3Geometry & Omit<V3Appearance, 'target' | 'visibility'> & {
+export type FigureAssetGeometry = FigureGeometry & Omit<FigureAppearance, 'target' | 'visibility'> & {
     /** Whether the consumer draws this body. False bodies are still evaluated, placed and gated. */
     visible: boolean;
 };
-export interface V3AssetEvaluation {
-    geometry: V3AssetGeometry[];
-    bindings: V3EvaluatedBinding[];
+export interface FigureAssetEvaluation {
+    geometry: FigureAssetGeometry[];
+    bindings: FigureEvaluatedBinding[];
     inputs: Record<string, number>;
     palette: Record<string, string>;
 }
-export interface V3CompiledAsset {
-    evaluate(stateOverrides?: Record<string, number>): V3AssetEvaluation;
+export interface FigureCompiledAsset {
+    evaluate(stateOverrides?: Record<string, number>): FigureAssetEvaluation;
 }
-//# sourceMappingURL=v3-asset-types.d.ts.map
+//# sourceMappingURL=asset-types.d.ts.map

package/dist/asset-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-types.d.ts","sourceRoot":"","sources":["../src/asset-types.ts"],"names":[],"mappings":"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"}

package/dist/asset-types.js

@@ -0,0 +1,2 @@
+export const FIGURE_PLACEMENTS = ['floor', 'ceiling', 'center', 'wall'];
+//# sourceMappingURL=asset-types.js.map

package/dist/asset-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-types.js","sourceRoot":"","sources":["../src/asset-types.ts"],"names":[],"mappings":"AAoDA,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA"}

package/dist/asset.d.ts

@@ -0,0 +1,20 @@
+import type { FigureAsset, FigureCompiledAsset } from './asset-types.ts';
+import { type FigurePlacement } from './asset-types.ts';
+export declare function compileFigureAsset(source: unknown): FigureCompiledAsset;
+/**
+ * An asset written before the placement was its own setting kept it in the room it declared (`occupancy.placement`).
+ * Read, it is moved to `placement` -- the one place it is kept now (ADR-0097, designer 2026-09-27: 「두 곳에 서로 다른
+ * 배치 값을 유지하지 않는다」). Released snapshots are not rewritten; they are read this way. An asset holding both,
+ * differently, is refused: which one was meant cannot be told. Returns the asset itself when there is nothing to move.
+ */
+export declare function upgradeFigurePlacement<T>(source: T): T;
+/** Where the figure is authored from: its own setting, or the floor when it names none. */
+export declare function figurePlacementOf(asset: {
+    placement?: FigurePlacement;
+}): FigurePlacement;
+export declare function serializeFigureAsset(asset: unknown): string;
+export declare function parseFigureAsset(text: string): FigureAsset;
+export declare function captureFigureAuthoredInputs(asset: FigureAsset, inputs: Record<string, number>, options?: {
+    captureStateDefaults?: boolean;
+}): FigureAsset;
+//# sourceMappingURL=asset.d.ts.map

package/dist/asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../src/asset.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAyB,MAAM,kBAAkB,CAAA;AAC/F,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAc1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAQtD;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,eAAe,CAAA;CAAE,GAAG,eAAe,CAEzF;AA4JD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,UAGlD;AACD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAO1D;AACD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,WAAW,CAeb"}

package/dist/{v3-asset.js → asset.js}

@@ -1,12 +1,12 @@
 // Self-contained experimental asset envelope; no product DB/file writes.
-import { checkV3Joints } from "./v3-authoring-actions.js";
-import { compileV3Document as compileDocument } from "./v3-document.js";
-import { checkPublicInput } from "./v3-public-inputs.js";
-import { assertV3Json as jsonOnly, parseV3Json as parseStrictJson, V3_JSON_MAX_BYTES as MAX_BYTES, v3Utf8ByteLength } from "./v3-json.js";
-import { V3_PLACEMENTS } from "./v3-asset-types.js";
-import { V3ContractError as ContractError } from "./v3-contract.js";
-import { validateV3Drivers, validateV3StateInputs } from "./v3-driver.js";
-import { resolveV3Surface } from "./v3-surface.js";
+import { checkFigureJoints } from "./authoring-actions.js";
+import { compileFigureDocument as compileDocument } from "./document.js";
+import { checkPublicInput } from "./public-inputs.js";
+import { assertFigureJson as jsonOnly, parseFigureJson as parseStrictJson, FIGURE_JSON_MAX_BYTES as MAX_BYTES, figureUtf8ByteLength } from "./json.js";
+import { FIGURE_PLACEMENTS } from "./asset-types.js";
+import { FigureContractError as ContractError } from "./contract.js";
+import { validateFigureDrivers, validateFigureStateInputs } from "./driver.js";
+import { resolveFigureSurface } from "./surface.js";
 const fail = (code, path, message) => {
     throw new ContractError(code, path, message);
 };
@@ -20,15 +20,38 @@ function fields(o, required, optional, path) {
         if (![...required, ...optional].includes(k))
             fail('ASSET_SCHEMA', path, `unknown ${k}`);
 }
-export function compileV3Asset(source) {
+export function compileFigureAsset(source) {
     return compileAsset(source);
 }
-function compileAsset(source) {
-    jsonOnly(source);
-    if (v3Utf8ByteLength(JSON.stringify(source)) > MAX_BYTES)
+/**
+ * An asset written before the placement was its own setting kept it in the room it declared (`occupancy.placement`).
+ * Read, it is moved to `placement` -- the one place it is kept now (ADR-0097, designer 2026-09-27: 「두 곳에 서로 다른
+ * 배치 값을 유지하지 않는다」). Released snapshots are not rewritten; they are read this way. An asset holding both,
+ * differently, is refused: which one was meant cannot be told. Returns the asset itself when there is nothing to move.
+ */
+export function upgradeFigurePlacement(source) {
+    const asset = source;
+    const old = asset?.occupancy && typeof asset.occupancy === 'object' ? asset.occupancy.placement : undefined;
+    if (old === undefined)
+        return source;
+    if (asset.placement !== undefined && asset.placement !== old)
+        fail('PLACEMENT_CONFLICT', 'placement', `the asset says ${String(asset.placement)} and its room says ${String(old)}; keep one`);
+    const { placement: _moved, ...occupancy } = asset.occupancy;
+    return { ...asset, placement: old, occupancy };
+}
+/** Where the figure is authored from: its own setting, or the floor when it names none. */
+export function figurePlacementOf(asset) {
+    return asset.placement ?? 'floor';
+}
+function compileAsset(given) {
+    jsonOnly(given);
+    const source = upgradeFigurePlacement(given);
+    if (figureUtf8ByteLength(JSON.stringify(source)) > MAX_BYTES)
         fail('DOCUMENT_LIMIT', 'asset', 'over 1 MiB');
-    fields(source, ['version', 'name', 'document', 'designInputs', 'stateDefaults', 'palette', 'appearance'], ['occupancy', 'drivers', 'stateInputs', 'sizing', 'detailLevel', 'joints', 'publicInputs'], 'asset');
-    if (source.version !== 'figure-v3-asset-1')
+    fields(source, ['version', 'name', 'document', 'designInputs', 'stateDefaults', 'palette', 'appearance'], ['occupancy', 'placement', 'drivers', 'stateInputs', 'sizing', 'detailLevel', 'joints', 'publicInputs'], 'asset');
+    if (source.placement !== undefined && !FIGURE_PLACEMENTS.includes(source.placement))
+        fail('ASSET_SCHEMA', 'placement', `one of ${FIGURE_PLACEMENTS.join(', ')} required`);
+    if (source.version !== 'figure-asset-1')
         fail('VERSION', 'asset', source.version);
     if (typeof source.name !== 'string' || !source.name.trim())
         fail('ASSET_SCHEMA', 'name', 'nonempty name required');
@@ -114,15 +137,15 @@ function compileAsset(source) {
     if (looks.size !== placements.size)
         fail('APPEARANCE_MISSING', 'appearance', 'every source placement/member requires appearance');
     if (asset.occupancy !== undefined) {
-        // ADR-0044 · ADR-0045 in V3: the declared volume names three length values; the placement is one of the declared placements.
-        fields(asset.occupancy, ['bounds', 'placement'], ['contact'], 'occupancy');
+        // ADR-0044 · ADR-0045: the declared volume names three length values. The placement is the asset's own (ADR-0097).
+        fields(asset.occupancy, ['bounds'], ['contact'], 'occupancy');
         if (asset.occupancy.contact !== undefined) {
             const contact = asset.occupancy.contact;
             fields(contact, ['plane', 'surface'], [], 'occupancy.contact');
             if (contact.plane !== 'mounting-plane')
                 fail('OCCUPANCY', 'occupancy.contact', `${String(contact.plane)} is not a plane the figure can be mounted on`);
             // The same reader the capability contacts use, so a mounting face is a real planar face of a drawn body.
-            resolveV3Surface({ types: plan.outputTypes, writers, model, assetFrame: asset.document.capabilities.assetFrame }, contact.surface, 'occupancy.contact.surface');
+            resolveFigureSurface({ types: plan.outputTypes, writers, model, assetFrame: asset.document.capabilities.assetFrame }, contact.surface, 'occupancy.contact.surface');
         }
         fields(asset.occupancy.bounds, ['x', 'y', 'z'], [], 'occupancy.bounds');
         const lengthType = JSON.stringify([1, 0, 0]);
@@ -138,18 +161,16 @@ function compileAsset(source) {
                     fail('OCCUPANCY_STATE', path, `${ref} depends on state input ${plan.dependence[ref].join(', ')}; the occupancy is state-independent`);
             }
         }
-        if (!V3_PLACEMENTS.includes(asset.occupancy.placement))
-            fail('OCCUPANCY', 'occupancy.placement', `one of ${V3_PLACEMENTS.join(', ')} required`);
     }
-    validateV3Drivers(asset);
-    validateV3StateInputs(asset);
+    validateFigureDrivers(asset);
+    validateFigureStateInputs(asset);
     function evaluate(stateOverrides = {}) {
         fields(stateOverrides, [], state, 'state overrides');
         const inputs = { ...asset.designInputs, ...asset.stateDefaults, ...stateOverrides }, r = plan.evaluate(inputs);
         const targetOf = (g) => (g.key ? writers.get(g.key)?.id : g.id);
         /*
           Bodies come back in the appearance order — the parts list's order, and the order they are drawn in. The graph
-          lists nodes in whatever order they were written, so a list that followed it could not be reordered (the V3
+          lists nodes in whatever order they were written, so a list that followed it could not be reordered (the
           modeller's 「위로」 did nothing, 2026-09-24). The sort is stable: a repeated template's members keep their order.
         */
         const rank = new Map(asset.appearance.map((look, i) => [look.target, i]));
@@ -173,20 +194,20 @@ function compileAsset(source) {
     evaluate(); // Stored design and state defaults must themselves be executable.
     return { evaluate };
 }
-export function serializeV3Asset(asset) {
+export function serializeFigureAsset(asset) {
     compileAsset(asset);
     return JSON.stringify(asset);
 }
-export function parseV3Asset(text) {
-    const asset = parseStrictJson(text);
+export function parseFigureAsset(text) {
+    const asset = upgradeFigurePlacement(parseStrictJson(text));
     compileAsset(asset);
     if (asset.joints !== undefined && !Array.isArray(asset.joints))
         fail('ASSET_SCHEMA', 'joints', 'joints is a list');
     // The joint records are the canon; nodes edited apart from them are refused (ADR-0093).
-    checkV3Joints(asset);
+    checkFigureJoints(asset);
     return asset;
 }
-export function captureV3AuthoredInputs(asset, inputs, options = {}) {
+export function captureFigureAuthoredInputs(asset, inputs, options = {}) {
     fields(options, [], ['captureStateDefaults'], 'capture options');
     const captureStateDefaults = options.captureStateDefaults ?? false;
     if (typeof captureStateDefaults !== 'boolean')
@@ -205,4 +226,4 @@ export function captureV3AuthoredInputs(asset, inputs, options = {}) {
     compileAsset(next);
     return next;
 }
-//# sourceMappingURL=v3-asset.js.map
+//# sourceMappingURL=asset.js.map