@hatiolab/figure-model 0.1.76 → 0.1.78

package/docs/sizing.md

@@ -1,183 +0,0 @@
-# 크기 반응 — 인스턴스가 커질 때 부품이 어떻게 되나
-
-저작한 형상 하나가 도면에 여러 크기로 놓인다. 컨베이어를 2400 으로도, 7200 으로도
-놓는다. 그때 부품마다 다르게 반응해야 한다 — 프레임은 길어지고, 모터는 그대로이고,
-롤러는 개수가 늘고, 다리는 늘어나 프레임을 떠받친다.
-
-이 문서는 그 반응을 **빠짐없이** 적는다. 낱개 규칙을 모아 놓은 것이 아니라, 「인스턴스가
-축마다 다른 배율을 받을 때 부품 하나에 일어날 수 있는 일」의 전부다.
-
-## 물음은 축마다 둘이다
-
-인스턴스 배율은 축마다 다르다 — `sx` · `sy` · `sz`. 부품 하나에 대해 축마다 물을 것이
-둘 있다.
-
-```
-크기    이 축의 길이가 어떻게 되나
-자리    이 축의 중심이 어디로 가나
-```
-
-세 축 × 둘 = 여섯 가지 답이 부품 하나의 반응을 완전히 정한다. **`anchor` 의 한 값이 그
-축의 둘을 함께 정한다** — 갈라 놓으면 「크기는 지키고 자리는 비례」처럼 성립하지 않는
-조합이 생긴다. 실제로 그것 때문에 크레들의 V 패드 둘이 ±80 에서 ±240 으로 벌어졌다.
-
-## 값 여섯 개가 전부다
-
-| `anchor`   | 크기          | 자리                        | 붙잡는 자리 |
-| ---------- | ------------- | --------------------------- | ----------- |
-| `scale`    | `× s`         | `× s`                       | 없음        |
-| `min`      | 그대로        | 아래 면에서 잰 거리를 지킨다 | 한 곳       |
-| `center`   | 그대로        | 가운데에서 잰 거리를 지킨다  | 한 곳       |
-| `max`      | 그대로        | 위 면에서 잰 거리를 지킨다   | 한 곳       |
-| `span`     | 남는 만큼 채움 | 양쪽에서 잰 거리를 지킨다    | 두 곳       |
-| `aspect-x` `aspect-y` `aspect-z` | 가리킨 축의 배율 | 가리킨 축의 배율 | 다른 축     |
-
-「아래·위」는 축의 −·+ 쪽이다. x 는 왼쪽·오른쪽, y 는 밑·위, z 는 뒤·앞이다.
-
-### 이 여섯이 왜 전부인가
-
-크기가 될 수 있는 것은 넷뿐이다 — 배율을 그대로 받거나(`scale`), 지키거나(`min` ·
-`center` · `max`), 남는 만큼 채우거나(`span`), 다른 축을 따라가거나(`aspect-`). 자리는
-기준면이 어디냐로 갈리고 기준면은 셋뿐이다 — 아래 · 가운데 · 위.
-
-빠진 조합 둘을 굳이 확인해 두면 이렇다.
-
-- **크기는 배율, 자리는 붙잡기.** `scale` 이 이미 그것이다. 바닥에 붙여 놓은 부품은
-  `scale` 로 두면 바닥에 남는다 — 상자 바닥이 `−h·s` 로 가고 부품 밑면도 그리로 간다.
-- **크기는 그대로, 자리는 비례.** 한동안 `center` 가 이것이었고 **틀렸다.** 가운데
-  가까이 저작한 것이 상자가 커질 때마다 밖으로 밀려 이웃과 갈라진다.
-
-## `sizing` 은 축별 기본값을 채우는 짧은 표기다
-
-부품마다 세 축을 다 적게 하면 저작이 못 견딘다. `sizing` 한 낱말이 세 축을 채우고,
-`anchor` 가 축마다 그것을 덮는다.
-
-| `sizing`  | x · y · z 에 채워지는 것                                  |
-| --------- | --------------------------------------------------------- |
-| `scale`   | 세 축 다 `scale`                                           |
-| `fixed`   | 세 축 다 **가까운 면**                                     |
-| `stretch` | 가장 긴 축은 `span`, 나머지는 가까운 면                    |
-| `repeat`  | 늘어나는 축은 `center`, 나머지는 가까운 면                 |
-
-**가까운 면**은 부품의 면에서 상자의 면까지 재서 짧은 쪽이다. 중심에서 재지 않는다 —
-중심으로 재면 굵은 부품과 얇은 부품이 같은 자리에서 다른 답을 낸다. 양쪽이 같으면
-`center` 다.
-
-표본 열넷 중 대부분이 이 기본값만으로 제대로 선다. 그것이 이 기본값이 사람이 이미
-뜻하는 것이라는 증거다.
-
-## 축을 넘는 규칙 둘
-
-축마다 따로 정하는 것으로 안 되는 것이 둘 있다. 둘 다 **여러 축이 한 배율을 나눠
-받아야** 하는 경우다.
-
-### `keepRound` — 곡면의 단면은 원이다
-
-`cylinder` · `sphere` 는 단면이 원이다. 축마다 다른 배율을 받으면 타원이 된다 —
-원기둥이라고 적어 놓고 원기둥이 아닌 것을 그리는 것이다.
-
-그래서 단면의 두 축(구는 세 축)이 **기하평균**을 함께 받는다. 작은 쪽에 맞추면 한 축만
-늘인 인스턴스에서 지름이 묶여, 형태가 아니라 **크기**를 지키게 된다.
-
-기본이 켜짐이고 값을 치른다 — 합친 형상은 변환을 하나만 받으므로 원을 지키는 곡면 부품
-하나가 draw call 하나다. 표본 열넷에서 139 가 168 이 되었다. `keepRound: false` 로 끄면
-다시 합쳐진다.
-
-```
-켜 둔다    화면의 주역        롤 · 바퀴 · 탱크 · 기둥 · 파이프
-끈다       기계가 안 깎은 것   사람의 팔다리 · 머리
-끈다       찌그러져도 모를 것  볼트 머리 · 작은 스터드
-```
-
-사람에게는 기계가 깎은 원통이 없다. 작업자를 전부 끄면 16 부품이 13 call 에서 4 call 이
-되는데, 그 4 는 쓰는 재질 수이므로 더 내려갈 자리가 없다는 뜻이다.
-
-### `aspect-` — 비율을 지킨다
-
-두 부품이 같은 것을 반대 방향에서 요구했다.
-
-```
-드라이룸 출입구   높이가 비례하고 **폭이 높이를 따라간다**
-                  문은 방이 넓어졌다고 넓어지지 않는다. 높아져서 넓어진다
-
-전극 롤 크래들    지름이 **z 를 따라간다**
-                  z 가 기계의 깊이 900 이고 롤이 그 중 700 이다. 그 깊이가 지름의 자리다
-                  길이는 따로다 — x 가 웹 폭이다
-```
-
-축마다 제 배율을 받는 것으로는 둘 다 못 말한다. `aspect-y` 는 「이 축은 y 가 **끝낸**
-배율을 받는다」이고, 끝낸 배율은 그 축의 규칙이 정한다 — `scale` 이면 인스턴스 배율,
-붙잡은 축이면 1, `span` 이면 채운 만큼이다.
-
-자기 자신이나 또 다른 `aspect-` 를 가리킬 수는 없다(`bad-aspect-axis`). 따라갈 배율이
-정해지지 않는다.
-
-**상자로 자르지 않는다.** 자르면 크레들 롤이 막힌다 — 지름은 기준 상자의 높이를 넘어서
-자란다. 기준 상자는 배치 비율의 분모이고 담장이 아니다(컨베이어의 발판이 이미 상자보다
-넓다). 값은 이렇다: 이미 상자를 꽉 채운 부품은 한 축만 커진 상자에서 비율을 지킬 수 없다.
-그런 부품은 여유를 두고 저작하거나 `span` 으로 채운다.
-
-## `repeat` — 줄이 늘어나나 커지나
-
-같은 「반복」이 두 가지다. 그 갈림을 늘어나는 축의 `anchor` 가 말한다.
-
-```
-center   줄이 상자를 채운다   컨베이어 롤러 — 길어지면 개수가 늘고 한 칸은 그대로다
-scale    줄이 상자와 함께 큰다 셀트레이 셀 — 커지면 셀이 커지고 개수는 그대로다
-```
-
-셀 개수는 그 트레이가 몇 셀짜리냐이지 화면에 얼마나 크게 그렸느냐가 아니다.
-
-## 저작할 때 묻는 순서
-
-```
-1  이 부품은 상자와 함께 커지나
-      그렇다 → sizing: 'scale' · 끝
-2  어느 축이 상자를 채우나
-      길이 방향 하나 → sizing: 'stretch'
-      둘 이상       → sizing: 'fixed' + anchor 에 'span'
-3  채우지 않는 축은 무엇을 붙잡나
-      적지 않으면 가까운 면. 가까운 면이 틀리면 min · center · max 로 적는다
-4  다른 부품과 한 뭉치인가
-      **같은 면을 붙잡게 한다.** 서로 다른 면을 잡으면 배율마다 사이가 벌어진다
-5  비율을 지켜야 하나
-      aspect- 로 기준 축을 가리킨다
-6  곡면인데 찌그러져도 되나
-      되면 keepRound: false — draw call 하나를 아낀다
-```
-
-4 번이 가장 자주 틀린다. 롤프레스의 두 롤이 `min` 과 `max` 로 갈려 3 배에서 5200
-벌어졌고, 시그널 타워의 램프가 기둥과 다른 면을 잡아 공중으로 갔다.
-
-## 못 하는 말 하나 — 부품에 부모가 없다
-
-「선반에 달린 램프」 · 「하우징에 붙은 HMI」를 형식이 직접 말하지 못한다. 붙잡는 것은
-언제나 **기준 상자의 면**이고 다른 부품이 아니다.
-
-지금은 둘이 **같은 면을 붙잡게** 해서 우회한다. 상자의 같은 면에서 잰 거리를 둘 다
-지키면 서로의 거리도 지켜지기 때문이다. 그래서 롤프레스의 하우징이 `span` 으로 상자
-면까지 닿게 만들어 놓았다 — HMI 가 잡을 면과 하우징이 잡을 면을 같게 하려고.
-
-우회가 안 되는 자리도 있었다. 충방전기의 채널 램프는 선반과 같은 피치로 반복되는데, 두
-줄이 저마다 상자를 채우므로 줄 사이의 45 가 배율만큼 벌어졌다. 램프를 선반 앞턱에 물려
-같은 줄 중심을 쓰게 해서 넘겼다.
-
-부모가 생기면 이 우회들이 없어진다.
-
-## 무엇으로 확인하나
-
-```bash
-node test/browser/check-figure-scaling.mjs        # things-factory
-```
-
-보는 것 셋이다.
-
-- **한 덩어리로 남나.** 닿는 부품을 이어 덩어리를 만들고, 1 배에서 한 덩어리이던 것이
-  늘려도 한 덩어리인지 본다. 쌍으로 세면 안 된다 — AGV 바퀴가 차체 바닥과 26 벌어졌다고
-  네 건이 났는데 그 사이는 underbody 가 메우고 있었다.
-- **일곱 조합 전부.** x · y · z · x-y · x-z · y-z · x-y-z. 세 축을 같이 늘린 것만 보면
-  축마다 따로 걸리는 규칙을 못 본다. 오늘 잡은 결함 둘이 다 한 축만 늘렸을 때 드러났다.
-- **z-fighting.** 같은 평면 · **같은 법선** · 겹치는 발자국 셋이 다 맞을 때만이다. 맞대어
-  놓은 것은 서로 등을 져서 뒷면이 잘려 나가므로 멀쩡하다.
-
-미리보기도 여덟을 나란히 놓는다 — 저작한 크기와 일곱 조합이다.

package/docs/validation.md

@@ -1,357 +0,0 @@
-# 검증 — 오류와 위반
-
-`validate(source)` 는 두 벌을 돌려준다.
-
-```ts
-const { errors, violations } = validate(source)
-```
-
-|              | 뜻                                                  | 컴파일      |
-| ------------ | --------------------------------------------------- | ----------- |
-| `errors`     | 형식·정합성이 깨졌다. 무엇을 세워야 할지 알 수 없다 | **막는다**  |
-| `violations` | 형식은 맞다. 정책을 넘었을 뿐이다                   | 막지 않는다 |
-
-가르는 기준은 **「이 상태로 세울 수 있나」** 하나다. `size.y` 가 없으면 세울 수 없다 —
-오류다. 재질이 넷이면 세울 수는 있고 다만 draw call 이 는다 — 위반이다.
-
-**정책은 형식이 성립할 때만 본다.** `errors` 가 하나라도 있으면 `violations` 는 비어
-있다. 망가진 입력에 대고 「재질이 많다」고 말해 봐야 도움이 안 되기 때문이다.
-
-## 코드는 목록으로 잠겨 있다
-
-`ERROR_CODES` · `VIOLATION_CODES` 가 기준이 되는 원본이고 `FigureError.code` · `Violation.code` 가
-그 값으로 좁혀져 있다. **목록에 없는 코드는 타입 검사가 막는다.** 이 문서와 목록이
-어긋나면 `src/docs.test.ts` 가 깨진다.
-
-소비처는 코드로 분기한다. 문구(`message`)는 사람이 읽는 것이라 바뀔 수 있으니
-코드에 의존한다.
-
----
-
-## 오류 (`errors`)
-
-`{ code, path, message }` — `path` 는 어디서 났는지 가리킨다. 예: `parts[2].transform.size.x`.
-
-### 형태
-
-| 코드           | 언제                                                                                                                          |
-| -------------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| `not-object`   | 객체여야 할 자리에 객체가 아닌 것이 왔다 (원본 데이터 자체, 부품, `transform.rotation`, `material`, `animation`, `label`, `Vec3`)    |
-| `not-finite`   | 수여야 할 자리가 수가 아니거나 `NaN`·`Infinity` 다                                                                            |
-| `not-positive` | 0 보다 커야 하는데 아니다 (`base` 의 세 변)                                                                                   |
-| `not-integer`  | `segments` 가 정수가 아니다                                                                                                   |
-| `out-of-range` | 아래위가 정해진 값이 그 밖이다 (`material.emissive.intensity` 는 0~1, `animation.turnsPerSecond` 는 0 이상)                          |
-| `not-boolean`  | `material.flatShading` · `material.transparent` · `material.emissive.on` 이 참·거짓이 아니다                                       |
-| `not-allowed`  | 열거 값이 목록 밖이다 (`primitive` · `preset` · `slot` · `sizing` · `axis` · `detailLevel` · `animation.kind` · `label.when`) |
-
-### 원본의 필수 항목
-
-| 코드            | 언제                                      | 왜                                                        |
-| --------------- | ----------------------------------------- | --------------------------------------------------------- |
-| `missing-type`  | `type` 이 없거나 빈 문자다                | **저장되는 식별자다.** 씬이 이 이름으로 청사진을 찾는다 |
-| `source-version-unsupported` | `version` 이 2 가 아니거나 없다 | 판 1 은 y 를 상자 중심에서 쟀다. 판을 적지 않은 원본도 판 1 이다. 옮긴 원본만 읽는다 |
-| `missing-base`  | `base` 가 없다                            | 배치 크기가 이 비율에서 나온다                            |
-| `missing-parts` | `parts` 가 없거나 비었다                  | 부품이 하나는 있어야 한다. 여기서 검사를 멈춘다           |
-| `bad-style-kit` | `styleKit` 이 빈 문자이거나 문자가 아니다 |                                                           |
-
-### 부품
-
-| 코드                | 언제                                           | 왜                                                                     |
-| ------------------- | ---------------------------------------------- | ---------------------------------------------------------------------- |
-| `missing-name`      | `name` 이 없거나 빈 문자다                     | **바인딩·애니메이션·슬롯이 이 이름을 가리킨다**                        |
-| `duplicate-name`    | 이름이 겹친다                                  | 겹치면 어느 부품을 가리키는지 정해지지 않는다                          |
-| `missing-transform` | `transform` 이 없다                            |                                                                        |
-| `missing-position`  | `transform.position` 이 없다                   |                                                                        |
-| `missing-size`      | `transform.size` 나 그 안의 `y` 가 없다        | **0 으로 갈음하지 않는다.** 두께를 모르는 것과 두께가 0 인 것은 다르다 |
-| `too-few-segments`  | `segments` 가 `LIMITS.minSegments`(3) 미만이다 | 2 이하는 면이 생기지 않는다                                            |
-
-### 단면
-
-| 코드                 | 언제                                                     |
-| -------------------- | -------------------------------------------------------- |
-| `missing-shape-path` | `polygon` 인데 `shape.path` 가 없거나 점이 3 개 미만이다 |
-| `hollow-too-thick`    | 벽이나 바닥이 치수를 다 먹는다 — 팔 안쪽이 남지 않는다                                |
-| `hollow-not-convex`   | 오목한 `polygon` 은 아직 못 판다 — 안쪽 테가 제 몸을 가로지른다                       |
-| `bad-aspect-axis`     | `aspect-` 가 자기 자신이나 또 다른 `aspect-` 축을 가리킨다 — 따라갈 배율이 정해지지 않는다 |
-| `bad-shape-point`    | `shape.path` 의 점이 `{ x, y }` 가 아니다                |
-
-### 재질
-
-| 코드                    | 언제                        | 왜                                     |
-| ----------------------- | --------------------------- | -------------------------------------- |
-| `missing-material`      | `material` 이 없다          |                                        |
-| `material-unresolvable` | `token` 도 `preset` 도 없다 | 무슨 색·무슨 질감인지 정할 근거가 없다 |
-
-### 크기 반응
-
-| 코드             | 언제                                         |
-| ---------------- | -------------------------------------------- |
-| `missing-repeat` | `sizing` 이 `'repeat'` 인데 `repeat` 가 없다 |
-
-### 움직임
-
-| 코드                     | 언제                                          | 왜                                                              |
-| ------------------------ | --------------------------------------------- | ---------------------------------------------------------------- |
-| `missing-channels`       | clip 에 `channels` 가 없거나 비었다           | 무엇을 움직이는지 모른다                                        |
-| `unknown-channel-target` | `channels[].target` 이 없는 부품을 가리킨다   | 조용히 아무것도 안 움직인다                                     |
-| `too-few-keys`           | `keys` 가 둘 미만이다                         | 하나짜리는 움직임이 아니라 자세 하나다. `transform` 이 그 자리다 |
-| `keys-out-of-order`      | 키의 시각이 앞의 것보다 크지 않다             | 표본추출이 뜻을 잃는다. 화면에서는 「이상하게 움직인다」로만 보인다 |
-
-clip 의 이름은 부품과 같은 코드를 쓴다 — 없으면 `missing-name`, 겹치면 `duplicate-name`.
-경로와 `interpolation` 이 목록 밖이면 `not-allowed`, 키의 시각이 음수면 `not-positive` 다.
-
-**같은 검사가 파라미터의 곡선에도 그대로 돈다.** 채널 모양은 어느 쪽이든 같아야 한다.
-
-### 예외 표면
-
-| 코드                  | 언제                                                |
-| --------------------- | --------------------------------------------------- |
-| `missing-surface-ref` | `material.surface.ref` 가 없다 — 무엇을 쓸지 모른다 |
-
-### 라벨
-
-| 코드                   | 언제                                          |
-| ---------------------- | --------------------------------------------- |
-| `missing-label-name`   | `label.name` 이 없다                          |
-| `missing-label-source` | `label.source` 가 없다 — 무엇을 보일지 모른다 |
-
-### 능력 (`capabilities`)
-
-배치된 도형이 씬 컴포넌트로서 부여받는 능력의 선언이다. **이름도 여기서 본다** — 한동안
-아니었다.
-
-목록이 things-scene 에만 있던 동안 이 검사가 이름을 못 봤고, AI 가 낸
-`capabilities: ['hoist']` 가 **검증을 지나고 발행을 지나** 렌더링에서 죽었다. 저작자는 자산을
-내보내고 나서야 그것이 안 선다는 것을 알았다. 게이트는 사실이 사는 곳에 있어야 한다 —
-`base` 상자 때와 같은 구멍이었다.
-
-쓸 수 있는 이름은 넷이다(`FIGURE_CAPABILITIES`). 자세한 것은 `docs/format.md`.
-
-| 코드                     | 뜻                                                            |
-| ------------------------ | -------------------------------------------------------------- |
-| `bad-capability`         | 배열이 아니거나, 이름이 비어 있거나, **목록 밖의 이름이거나**, 혼자 설 수 없는 것을 혼자 적었다 |
-| `duplicate-capability`   | 같은 능력을 두 번 선언했다                                     |
-| `bad-part-capability`    | 부품의 `capability` 모양이 틀렸다 — 역할·accepts·capacity      |
-
-거절할 때는 **쓸 수 있는 넷을 함께 말한다.** 「틀렸다」만으로는 AI 도 사람도 다음 수가 없다.
-
-`Transferable` 은 자리를 찾는 일을 `Capacity` 에게 맡기므로 혼자 못 선다. 씬이 조립할 때도
-같은 이유로 던지는데, **그때는 이미 발행된 뒤다** — 그래서 여기서 본다.
-
-### 부모와 관절 (`parent` · `joints`)
-
-> ADR-0066 (`operato-twin/design/04-decisions.md`)
-
-| 코드                  | 언제                                                         | 왜                                                                 |
-| --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------ |
-| `unknown-parent`      | `parent` 가 부품 이름이 아니거나 없는 부품을 가리킨다          | 붙을 자리가 없다                                                   |
-| `parent-cycle`        | 부모를 따라가면 제자리로 돌아온다                              | figure 의 틀에 닿지 않아 어느 틀에서 움직이는지 정할 수 없다        |
-| `unknown-joint-child` | 관절의 `child` 가 없는 부품이다                                | 움직일 것이 없다                                                   |
-| `joint-child-taken`   | 한 부품이 두 관절의 `child` 다                                 | 한 부품이 부모에 대해 움직이는 방법은 하나다                       |
-| `bad-joint-axis`      | `axis` 가 0 벡터다                                             | 어느 쪽으로 움직이는지 없다                                        |
-
-관절 이름이 없으면 `missing-name`, 다른 관절이나 **부품** 이름과 겹치면 `duplicate-name` 이다 — channel 의 `target` 이
-두 가지를 뜻하면 안 된다. `type` 이 목록 밖이면 `not-allowed`. `limits` 는 `max` 가 `min` 이하면 `bad-range`, **0 을
-품지 않으면 `out-of-range`** 다 — 그린 자세가 관절 값 0 이다. continuous 관절에 `limits` 를 적으면 `not-allowed`.
-
-**관절을 모는 channel** 은 `target` 이 관절 이름인 것이다. `path` 나 `pivot` 을 적으면 `not-allowed`(관절이 이미
-말했다), 키의 `value` 가 수가 아니면 `not-finite`, `limits` 밖이면 `out-of-range` 다. `target` 이 부품도 관절도 아니면
-`unknown-channel-target`.
-
-### 파라미터 (`parameters`)
-
-> ADR-0051 (`operato-twin/design/04-decisions.md`)
-
-값이 만드는 자세다 — 호이스트가 얼마나 내려왔나, 포크가 얼마나 올라갔나. **애니메이션이 아니다.**
-저것은 시각이 흐르는 것이고 이것은 지금 값이 그만큼인 것이다.
-
-두 층으로 되어 있다. `clip` 은 **glTF 애니메이션과 같은 모양**이라 내보내면 평범한 애니메이션이
-나가고, 그 위에 얹는 `range` 가 우리 것이다 — 「이 곡선은 값이 몬다」와 「그 값은 mm 로 몇부터
-몇까지다」. 못 받는 쪽은 선언만 잃고 형상은 잃지 않는다.
-
-곡선의 값 축은 0~1 이다(glTF morph target `weights` · Unity 파라미터와 같은 정규화). 저작자와
-인스턴스가 주고받는 것은 `range` 의 단위이고 런타임이 그 사이를 맵한다.
-
-| 코드            | 뜻                                                                 |
-| --------------- | ------------------------------------------------------------------ |
-| `missing-range` | `range` 나 `range.unit` 이 없다 — 인스턴스가 어느 값을 줄지 모른다     |
-| `bad-range`     | `max` 가 `min` 이하이거나, `default` 가 그 밖이다                  |
-| `out-of-range`  | `clip` 의 키 `at` 이 1 을 넘는다 — `at` 은 초가 아니라 값의 구간(0~1)이다 |
-| `not-positive`  | `clip.duration` 이 음수다 — 없거나 0 이면 즉시다                    |
-
-**키의 `at` 은 값의 구간에 앉는다.** 1 을 넘는 키는 어떤 값으로도 닿지 않는 자세라서 거절한다. 구간을
-다 덮을 필요는 없다 — 첫 키 앞과 마지막 키 뒤는 끝 키의 자세에 머문다. 전이 시간은 `clip.duration`
-(초, 0→1 전 구간)이 따로 말한다.
-
-이름은 `animations` 의 clip 이름과도 겹칠 수 없다. 인스턴스는 둘을 이름으로 부르므로 겹치면 어느 쪽에
-값을 준 것인지 알 수 없다.
-
-clip 에 `drive` 칸이 있으면 `not-allowed` 다. 값으로 움직이는 자세가 `drive: 'hold'` 로 애니메이션 안에 있던
-원본은 판 2 로 옮길 때 파라미터로 함께 옮겼다(키는 마지막 키의 시각으로 나눠 값의 구간에, `duration` 없음).
-형식은 옛 모양을 읽지 않는다.
-
-부품의 `capability` 는 **그 능력을 어느 부품이 받쳐 주나**를 말한다. 역할은 셋이다.
-
-| 역할     | 씬에서                       |
-| -------- | ---------------------------- |
-| slot     | `Capacity.slots` 의 한 자리  |
-| port-in  | `FlowNode.inboundPorts`      |
-| port-out | `FlowNode.outboundPorts`     |
-
-`roles` 는 **배열이다.** 한 부품이 여럿을 맡을 수 있다 — AGV 의 상판은 물건을 놓는 자리이면서
-그 자리로 물건이 들어오고 나간다. 하나만 받으면 저작자가 같은 위치에 부품을 두 개 만들게 되고,
-실물에 없는 구조를 형식이 만들어 낸다. 빈 배열은 막는다. 역할이 없으면 그냥 그리는 부품이므로
-`capability` 를 적지 않는 것이 맞다.
-
-```json
-{ "name": "deck", "capability": { "roles": ["slot", "port-in", "port-out"], "accepts": ["PALLET"] } }
-```
-
-닻은 **그려지지 않는다.** 삼각형·묶음·부품 수에 들어가지 않고, 그래서 `material` 도 요구하지 않는다.
-
-그리지 않는다고 안 재는 것은 아니다. 발행 게이트의 크기 검사는 **자리(slot)를 그리는 부품과
-함께 세운다** — 선반이 커질 때 자리가 따라가지 않으면 그 위의 재고가 허공에 뜨고, 자리는
-화면에 안 보이므로 저작자가 눈으로는 영영 못 찾는다. 문(port)은 몸 밖에 두는 것이 정상이라
-세지 않는다.
-
----
-
-## 위반 (`violations`)
-
-`{ code, message, actual?, limit? }` — 한도를 넘은 것은 `actual` 과 `limit` 을 함께
-낸다. 저작 화면이 「8 개 중 3 개 한도」처럼 보일 수 있게 하려는 것이다.
-
-### 쓰이지 않는 값
-
-| 코드                  | 언제                                                                                  |
-| --------------------- | ------------------------------------------------------------------------------------- |
-| `segments-off-preset` | `segments` 가 프리셋(8 · 12 · 16 · 24 · 32 · 48) 밖이다. 값은 쓰이지만 geometry 키가 그만큼 늘어난다 |
-| `segments-ignored`    | 곡면이 없는 프리미티브에 `segments` 를 주었다                                         |
-| `repeat-ignored`      | `sizing` 이 `'repeat'` 가 아닌데 `repeat` 를 주었다                                   |
-| `keep-round-ignored`  | 단면이 원이 아닌 프리미티브에 `keepRound` 를 주었다                                     |
-| `hollow-ignored`      | 밀어 만드는 것이 아닌 프리미티브에 `shape.hollow` 를 주었다                            |
-| `pivot-ignored`       | `rotation` 이 아닌 채널에 `pivot` 을 주었다 — 아무 일도 안 일어난다                   |
-
-### 예산
-
-| 코드                        | 한도                                         | 왜                                                                                            |
-| --------------------------- | -------------------------------------------- | --------------------------------------------------------------------------------------------- |
-| `detail-level-missing`      | —                                            | 등급이 없으면 부품 수 예산을 잡을 수 없다                                                     |
-| `too-many-parts`            | `PART_LIMIT[detailLevel]` (S 3 · M 8 · L 20) |                                                                                               |
-| `too-many-independent-parts` | `LIMITS.independentParts` (12)              | 따로 변환되는 부품마다 묶음이 하나 늘고, 그만큼 한 화면에 세울 대수가 준다. clip 과 parameter 가 움직이는 부품을 함께 센다 |
-| `too-many-material-groups`  | `LIMITS.materialGroups` (3)                  | **자산당 draw call 이 는다.** 세는 단위는 `groupKeyOf` — 컴파일러가 합치는 단위와 같은 식이다 |
-| `too-many-transparent`      | `LIMITS.transparentMaterials` (1)            | 투명 재질은 별도 정렬 경로를 탄다                                                             |
-| `too-many-always-labels`    | 1                                            | `'always'` 라벨은 대량 배치에서 DOM·텍스처를 늘린다                                           |
-| `too-many-surface-textures` | `LIMITS.surfaceTextures` (1)                 | 무늬·그라디언트는 **재질을 나눠 쓸 수 없다** — 인스턴스 수만큼 재질이 생긴다                  |
-| `capacity-with-repeat`      | —                                            | 반복하는 자리에 `capacity` 를 적었다 — 칸 수는 **인스턴스 크기**가 정하므로 쓰이지 않는다      |
-
-### 기준 상자
-
-> ADR-0044 (`operato-twin/design/04-decisions.md`)
-
-`base` 는 **저작자가 선언하는 점유 부피**다. 부품을 감싸는 최소 상자가 아니다 — 감싸는 상자면
-계산해서 나오는 값이라 저작자가 쓸 것이 아니고, 의도를 담을 자리가 없어진다. 컨베이어가 앞에
-두어야 하는 접근 공간, 랙의 칸 pitch 가 그 여백에 담긴다. **남는 여백은 선언이므로 보지 않는다.**
-
-넘치는 것과 기준면에 안 닿는 것은 **다른 결함이라 코드를 나눈다.** 하나로 뭉치면 저작자가 상자를
-키우는 쪽으로 고치는데, 뒤쪽이 필요로 하는 것은 부품을 제자리로 옮기는 것이다.
-
-| 코드                        | 언제                                                                     | 왜                                                                                              |
-| --------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
-| `part-outside-base`         | 부품이 상자 밖으로 나간다(x·z 는 중심에서 `±base/2`, y 는 밑면 0 에서 `base.y`). 회전을 포함한 실제 부피로 잰다 | `base` 는 **나누는 수**다(`instanceScale = width/base.x`). 넘치면 그 수가 거짓말을 하고 도면에서 크기와 높이가 둘 다 틀린다 |
-| `parts-off-placement-face`  | 바닥 기반인데 상자 밑면에 안 닿는다 · 천정 기반인데 윗면에 안 닿는다      | 「선다」·「매달린다」고 선언해 놓고 떠 있다. **원점 규약이 어긋난 것**이지 상자가 큰 것이 아니다 |
-
-허용 오차는 `SKIN`(0.5) 하나다 — 발행 관문이 「덩어리가 갈라졌나」를 재는 값과 같다. 오차 상수가
-둘이면 한쪽이 닿았다고 한 면을 다른 쪽이 떨어졌다고 한다.
-
-**중심 기반(`center`)에는 기준면 요구가 없다.** 떠 있는 것이 그 배치의 뜻이다.
-
-밑면 아래로 지나가는 것은 **닿은 것으로 본다.** 지나간 사실은 `part-outside-base` 가 이미
-말하므로, 같은 일을 두 코드가 두 번 말하지 않는다.
-
-**이 둘은 발행을 막는다.** 이미 발행된 것은 그대로 서 있고, 고치기 전에는 다시 발행하지 못한다.
-
-### type 이름
-
-`type` 은 도면이 `{ type, left, top, width, height }` 로 적는 **저장되는 식별자**다. 발행된 이름은 이미 놓인
-도면들과의 약속이라 바꿀 수 없다. 그래서 규칙은 **초안 저장이 아니라 발행을 막는다** — 이름을 정하기 전에
-만들어 보는 것은 막을 이유가 없다.
-
-| 코드                  | 언제                                                                   | 왜                                                                                      |
-| --------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
-| `type-not-identifier` | 대문자 `SCREAMING_SNAKE_CASE`(`TYPE_PATTERN`) 가 아니거나 3~32 자 밖이다 | 대문자가 figure 의 이름공간이다. 씬의 내장 컴포넌트는 소문자라, 이 모양이면 겹칠 수 없다 |
-| `type-is-placeholder` | 이름을 짓기 전의 임시 이름(`FIGURE_` + 8 자, `placeholderType()`)이다     | 모양은 맞아서 위 규칙으로는 안 걸린다. **아직 사람이 이름을 안 지은 것**이다               |
-
-임시 이름은 저작 화면이 만들고(`placeholderType`) 게이트와 AI 도구가 알아본다(`isPlaceholderType`). 만드는
-쪽과 알아보는 쪽이 같은 규칙을 쓰도록 형식이 갖는다. 범주 접두(`EQ_` · `VEH_` …)는 규칙으로 세우지 않는다.
-
-형식이 깨진 원본에서는 이름을 보지 않는다 — 다른 정책 위반과 같은 단계다.
-
-### draw call 을 세는 법
-
-```
-draw call = 합쳐진 묶음 하나당 1
-          + 단독으로 서는 부품 하나당 1
-          + repeat 부품은 사본 하나당 1
-```
-
-**단독으로 서는 것이 셋이다.**
-
-| 무엇 | 왜 |
-| --- | --- |
-| clip 이나 parameter 가 움직이는 부품 | 합치면 그 부품만 따로 움직일 수 없다 |
-| `sizing` 이 `scale` 이 아닌 부품 | 합친 geometry 는 변환을 하나만 받는다 |
-| `repeat` 부품 | 한 부품이 여러 mesh 다 |
-
-한동안 이 자리가 「재질·슬롯 조합 수」였다. 그 값은 컴파일이 실제로 만드는 묶음보다
-작아서, 저작자에게 자산이 싸다고 알려 주는 숫자만 비용을 안 재고 있었다.
-
-```
-컨베이어    3 으로 셌고 32 를 그렸다
-셀 트레이   2 로 셌고  9 를 그렸다
-```
-
-`repeat` 개수는 **저작한 크기(배율 1)** 기준이다. 줄은 인스턴스가 받은 상자를 채우므로
-크게 놓으면 더 그린다.
-
-
-`groupKeyOf` 에 드는 것 — `token` · `preset` · `flatShading` · `transparent` · `slot`.
-투명 여부와 flatShading 이 키에 드는 이유는 셰이더와 정렬 경로가 달라 실제로 합칠 수
-없기 때문이다.
-
-**검사와 컴파일이 같은 함수를 쓴다**(`src/keys.ts`). 다르면 「한도를 지켰다」는 말이
-실제 묶음 수와 어긋나고, 그 어긋남은 오류 없이 성능으로만 나타난다.
-
----
-
-## 컴파일
-
-```ts
-const blueprint = compile(source)
-```
-
-`errors` 가 있으면 `FigureCompileError` 를 던진다. 예외에 `errors` 목록이 담겨 있다.
-
-`violations` 는 던지지 않고 **청사진에 실려 나간다**(`blueprint.violations`). 저작
-화면이 그것을 보인다.
-
-## 문은 둘이다 — 저작할 때와 세울 때
-
-```ts
-validate(source)            // 저작 형식을 본다. 사람이 고치는 것
-blueprintProblems(blueprint) // 그 결과물을 본다. 씬이 등록할 때
-```
-
-`validate` 는 저작 중에 돌고, 무엇이 왜 틀렸는지 저작자에게 말하는 것이 일이다.
-
-`blueprintProblems` 는 **씬에 들어가기 직전**에 한 번 돈다. 서버나 파일에서 온 청사진이
-이 형식대로 생겼는지 묻는 자리다. 그리는 시점이 아니라 등록 시점에 보는 이유는, 잘못된
-청사진이 **프레임마다 조용히 실패하는 것**보다 등록에서 한 번 크게 실패하는 편이 낫기
-때문이다.
-
-여기서 특히 보는 것은 **그려지지 않는 것들**이다. 자리(`anchors`)와 파라미터가 그렇다 —
-틀려도 화면에는 아무 일도 안 일어난다. 물건을 앉히려는 순간, 값을 주는 순간에야 드러난다.
-
-`range` 를 여기서 한 번 더 보는 이유가 그것이다. 그 값이 **런타임의 나누는 수**라서
-(`(값 − min) / (max − min)`), `max` 가 `min` 이하면 mm 를 0~1 로 맵할 수 없고 **준 값이
-통째로 조용히 버려진다.**