@things-factory/figure-ui 10.1.65 → 10.1.67

package/client/modeller/part-edits.ts

@@ -1,312 +0,0 @@
-import { EXTRUDE_PRIMITIVES, SEGMENTED_PRIMITIVES, SEGMENT_PRESETS, PART_LIMIT } from '@hatiolab/figure-model'
-import type { DetailLevel, PrimitiveKind } from '@hatiolab/figure-model'
-
-import { AXIS_KEYS, draftExtent } from './figure-source.js'
-import type { FigureDraft, PartModel, PlaneAxis } from './figure-source.js'
-
-/**
- * 부품 편집 규칙. **씬 모델의 용어로** 다룬다.
- *
- * 편집 중에 기준이 되는 데이터는 씬 모델이다 — 기준 상자 위에 부품 컴포넌트가 놓인 상태.
- * 그래서 편집도 씬의 용어(`left`·`top`·`zPos`·`width`·`height`·`depth`)로 한다.
- * FigureSource 의 좌표계로 바꾸는 변환은 `figure-source.ts` 한 곳에서만 한다.
- *
- * 사용자가 보는 축(X·Y·Z)이 씬의 어느 속성인지도 `figure-source.ts` 의 `AXIS_KEYS` 가 기준이다.
- * 여기서 다시 정의하지 않는다.
- *
- * 모든 함수가 **새 배열·새 객체를 반환한다** — 원본을 수정하지 않는다. Lit 이 변경을
- * 감지하려면 참조가 달라져야 하고, 실행 취소를 붙일 때도 이전 상태가 남아 있어야 한다.
- */
-
-/** 중복되지 않는 이름을 만든다. 부품 이름은 저장되는 식별자라 중복되면 검증에서 걸린다. */
-function freeName(taken: Set<string>, base: string): string {
-  if (!taken.has(base)) return base
-  for (let n = 2; ; n++) {
-    const candidate = `${base}-${n}`
-    if (!taken.has(candidate)) return candidate
-  }
-}
-
-const round = (value: number) => Math.round(value)
-
-/** 값을 두 끝 사이로 당긴다. 끝이 뒤집혀 있으면(부품이 상자보다 크다) 앞의 끝을 따른다. */
-function clamp(value: number, least: number, most: number): number {
-  return Math.max(least, Math.min(most, value))
-}
-
-/** 이 초안에 부품을 몇 개까지 넣을 수 있는지. 디테일 등급이 결정한다. */
-export function partLimit(draft: FigureDraft): number {
-  return PART_LIMIT[(draft.detailLevel ?? 'M') as DetailLevel]
-}
-
-/**
- * 새 부품 하나를 만든다.
- *
- * 기준 상자의 3분의 1 크기다. 추가하자마자 화면에 보여야 한다 — 크기 0 으로 놓으면
- * 사용자에게는 아무 일도 일어나지 않은 것으로 보인다.
- *
- * ## 어디에 놓나 — 고른 부품 **위**다
- *
- * 전에는 언제나 바닥 한가운데였다. 첫 부품은 그 자리가 맞지만 둘째부터는 **첫 부품 속에**
- * 들어간다 — 같은 자리에 같은 크기로 놓이니 화면에는 덩어리 하나뿐이고, 저작자는 무엇이
- * 늘었는지 못 본다. 「추가하자마자 보여야 한다」는 그때 이미 깨져 있었다.
- *
- * 그래서 고른 부품이 있으면 그 부품의 **윗면**에 얹고 발자국을 가운데로 맞춘다. 기계는
- * 대개 그렇게 쌓인다(받침 → 어깨 → 팔). 관절을 걸 때도 이 자리가 필요하다 — 맞닿는 면이
- * 실제로 있어야 `seamOrigin` 이 회전 중심을 그 면에서 잡는다.
- *
- * 위에 얹으면 기준 상자를 넘는 경우에는 바닥 한가운데로 간다. 넘은 채로 놓으면 발행이
- * 막히고(`part-outside-base`), 그것을 고치는 일이 「부품을 추가했다」의 대가가 된다.
- * 가로·세로는 상자 안으로 당긴다 — 고른 부품이 가장자리에 있으면 그 위가 상자 밖이다.
- */
-export function newPart(
-  draft: FigureDraft,
-  parts: PartModel[],
-  primitive: PrimitiveKind,
-  onTopOf?: PartModel
-): PartModel {
-  const taken = new Set(parts.map(part => part.name))
-
-  const width = Math.max(1, Math.round(draft.width / 3))
-  const height = Math.max(1, Math.round(draft.height / 3))
-  const depth = Math.max(1, Math.round(draft.depth / 3))
-
-  // 바닥 한가운데 — 고를 부품이 없을 때, 그리고 위가 상자 밖일 때의 자리.
-  const middle = {
-    left: Math.round((draft.width - width) / 2),
-    top: Math.round((draft.height - height) / 2),
-    // `zPos` 는 부피의 밑면이라 0 이 곧 상자 바닥이다.
-    zPos: 0
-  }
-  const above = onTopOf && {
-    left: clamp(Math.round(onTopOf.left + onTopOf.width / 2 - width / 2), 0, draft.width - width),
-    top: clamp(Math.round(onTopOf.top + onTopOf.height / 2 - height / 2), 0, draft.height - height),
-    zPos: Math.round(onTopOf.zPos + onTopOf.depth)
-  }
-  const at = above && above.zPos + depth <= draft.depth ? above : middle
-
-  const part: PartModel = {
-    type: 'figure-part',
-    name: freeName(taken, primitive),
-    primitive,
-    left: at.left,
-    top: at.top,
-    width,
-    height,
-    zPos: at.zPos,
-    depth,
-    // 팔레트 토큰은 기존 부품의 것을 물려받는다 — 토큰이 늘어날 때마다 재질 그룹이 하나씩 는다.
-    token: parts[0]?.token ?? 'palette.primary'
-  }
-
-  if (SEGMENTED_PRIMITIVES.includes(primitive)) {
-    part.segments = SEGMENT_PRESETS[1]
-  }
-  if (EXTRUDE_PRIMITIVES.includes(primitive)) {
-    part.round = 0
-  }
-  if (primitive === 'polygon') {
-    // polygon 은 점이 3개 이상이어야 한다. 없으면 검증에서 막히므로 삼각형으로 시작한다.
-    // 단면의 점은 부품 중심을 기준으로 적는다.
-    part.path = [
-      { x: -Math.round(width / 2), y: -Math.round(height / 2) },
-      { x: Math.round(width / 2), y: -Math.round(height / 2) },
-      { x: 0, y: Math.round(height / 2) }
-    ]
-  }
-
-  return part
-}
-
-/**
- * 씬에서 온 부품을 밀리미터로 맞춘다.
- *
- * 기즈모는 비율을 곱해서 크기를 낸다 — 420 에 1.72 를 곱하면 722.4180046035418 이고, 손대지
- * 않은 축도 384.99999999999994 처럼 흔들린다. 저작자가 끈 결과가 소수 넷째 자리까지 남을
- * 까닭이 없고, 칸에는 「722.4…」로 잘려 보인다. 이 편집기의 다른 길은 전부 정수 밀리미터로
- * 맞춘다(부품을 새로 놓을 때 · 가운데 맞추기 · 격자 맞추기).
- *
- * 크기는 1 밑으로 내려가지 않는다 — 0 이면 부피가 사라지고 배율이 0 으로 나뉜다.
- */
-export function roundPart(part: PartModel): PartModel {
-  return {
-    ...part,
-    left: round(part.left),
-    top: round(part.top),
-    zPos: round(part.zPos),
-    width: Math.max(1, round(part.width)),
-    height: Math.max(1, round(part.height)),
-    depth: Math.max(1, round(part.depth))
-  }
-}
-
-export function addPart(
-  draft: FigureDraft,
-  parts: PartModel[],
-  primitive: PrimitiveKind,
-  onTopOf?: PartModel
-): PartModel[] {
-  return [...parts, newPart(draft, parts, primitive, onTopOf)]
-}
-
-export function removePart(parts: PartModel[], index: number): PartModel[] {
-  return parts.filter((_, at) => at !== index)
-}
-
-/** 부품을 복제한다. 이름만 새로 붙인다 — 중복되면 검증에서 걸린다. */
-export function duplicatePart(parts: PartModel[], index: number): PartModel[] {
-  const origin = parts[index]
-  if (!origin) return parts
-
-  const copy: PartModel = JSON.parse(JSON.stringify(origin))
-  copy.name = freeName(new Set(parts.map(part => part.name)), `${origin.name}-copy`)
-
-  const next = [...parts]
-  next.splice(index + 1, 0, copy)
-  return next
-}
-
-/** 목록에서 순서를 바꾼다. 범위를 벗어나면 그대로 둔다. */
-export function movePart(parts: PartModel[], index: number, to: number): PartModel[] {
-  if (to < 0 || to >= parts.length || index === to) return parts
-
-  const next = [...parts]
-  const [moved] = next.splice(index, 1)
-  next.splice(to, 0, moved!)
-  return next
-}
-
-export function updatePart(parts: PartModel[], index: number, part: PartModel): PartModel[] {
-  return parts.map((old, at) => (at === index ? part : old))
-}
-
-/**
- * 정밀 배치 도구 — 좌표를 손으로 계산하지 않게 한다.
- *
- * 도면 편집기는 자산을 **배치**하는 도구라 대략적인 위치로도 충분하다. 여기는 자산을
- * **만드는** 도구라 다르다. 모터를 몸통 정중앙에 놓거나, 다리를 네 귀퉁이에 대칭으로
- * 놓거나, 부품을 바닥에 정확히 붙이는 작업은 손으로 계산하면 늘 조금씩 어긋난다.
- */
-
-function put(parts: PartModel[], index: number, fields: Partial<PartModel>): PartModel[] {
-  const part = parts[index]
-  if (!part) return parts
-  return updatePart(parts, index, { ...part, ...fields })
-}
-
-/** 위치의 한 축만 바꾼다. 어느 속성인지는 `AXIS_KEYS` 가 결정한다. */
-function putAt(parts: PartModel[], index: number, axis: PlaneAxis, value: number): PartModel[] {
-  return put(parts, index, { [AXIS_KEYS[axis].at]: value } as Partial<PartModel>)
-}
-
-/** 부품을 기준 상자의 해당 축 가운데로 옮긴다. */
-export function centerPart(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): PartModel[] {
-  const part = parts[index]
-  if (!part) return parts
-
-  return putAt(parts, index, axis, Math.round((draftExtent(draft, axis) - part[AXIS_KEYS[axis].size]) / 2))
-}
-
-/** 부품을 상자 바닥(또는 해당 축의 시작)에 붙인다. */
-export function alignPartToStart(parts: PartModel[], index: number, axis: PlaneAxis): PartModel[] {
-  return putAt(parts, index, axis, 0)
-}
-
-/** 부품을 상자의 끝에 붙인다. */
-export function alignPartToEnd(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): PartModel[] {
-  const part = parts[index]
-  if (!part) return parts
-
-  return putAt(parts, index, axis, Math.round(draftExtent(draft, axis) - part[AXIS_KEYS[axis].size]))
-}
-
-/**
- * 부품을 축 기준으로 대칭 복제한다.
- *
- * 다리 넷, 팔 둘 같은 형상을 이것 없이 만들면 고생한다. 이름은 **어느 쪽인지 알 수
- * 있게** 붙인다 — `leg` 를 x 축으로 대칭하면 `leg-x`.
- */
-export function mirrorPart(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): PartModel[] {
-  const part = parts[index]
-  if (!part || !canMirror(draft, parts, index, axis)) return parts
-
-  const copy = JSON.parse(JSON.stringify(part)) as PartModel
-  copy.name = freeName(new Set(parts.map(p => p.name)), `${part.name}-${axis}`)
-
-  const next = [...parts]
-  next.splice(index + 1, 0, copy)
-  return putAt(next, index + 1, axis, mirroredAt(draft, part, axis))
-}
-
-/** 대칭했을 때의 위치. 상자의 해당 축 안에서 뒤집는다. */
-function mirroredAt(draft: FigureDraft, part: PartModel, axis: PlaneAxis): number {
-  const { at, size } = AXIS_KEYS[axis]
-  return Math.round(draftExtent(draft, axis) - part[at] - part[size])
-}
-
-/**
- * 대칭이 의미가 있는지.
- *
- * 이미 그 축의 가운데에 있는 부품을 대칭하면 **같은 자리에 사본이 생긴다.** 화면에는
- * 아무 변화가 없어 보이는데 부품 수만 늘고, 겹친 면에서 z-fighting 이 일어난다.
- * 만들어 놓고 알리는 대신 미리 막는다.
- */
-export function canMirror(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): boolean {
-  const part = parts[index]
-  if (!part) return false
-
-  return mirroredAt(draft, part, axis) !== Math.round(part[AXIS_KEYS[axis].at])
-}
-
-/**
- * 부품의 위치와 크기를 격자에 맞춘다.
- *
- * 격자 간격은 상자 크기에서 계산한다 — 고정 값이면 작은 형상에서는 너무 크고 큰
- * 형상에서는 너무 잘다. 3D 바닥 격자와 같은 계산이라 화면에서 보이는 것과 일치한다.
- */
-export function snapPart(draft: FigureDraft, parts: PartModel[], index: number): PartModel[] {
-  const part = parts[index]
-  if (!part) return parts
-
-  const step = gridStep(draft)
-  const round = (value: number) => Math.round(value / step) * step
-
-  return put(parts, index, {
-    left: round(part.left),
-    top: round(part.top),
-    zPos: round(part.zPos),
-    // 크기는 0 이 되면 안 된다 — 부품이 사라진 것처럼 보인다
-    width: Math.max(step, round(part.width)),
-    height: Math.max(step, round(part.height)),
-    depth: Math.max(step, round(part.depth))
-  })
-}
-
-/**
- * 격자 간격. 3D 바닥에 그려지는 격자와 같은 값이다.
- *
- * **세 축을 다 본다.** 평면만 보면 키가 큰 모델에서 격자가 지나치게 잘아진다. 시그널타워
- * (바닥 160 x 160, 높이 1100)는 평면 기준으로 간격이 20 이 나와서, 옆에서 보면 높이가
- * 격자 55 칸이 된다. 격자는 크기를 가늠하는 자이므로 모델 전체에 대해 읽혀야 한다.
- */
-export function gridStep(draft: FigureDraft): number {
-  return niceStep(Math.max(draft.width, draft.height, draft.depth))
-}
-
-/**
- * 주어진 길이에 어울리는 **읽기 좋은** 격자 간격. 다섯 칸 정도가 되게 잡는다.
- *
- * 그냥 나누면 27·33 같은 값이 나온다. 그 격자에 맞추면 좌표가 54·81 이 되어 읽기
- * 어렵다. 1·2·5 배수로 올림한다 — 자와 차트 눈금이 쓰는 방식이다.
- *
- * 격자가 성겨야 형상이 눈에 먼저 들어온다. 열 칸으로 잡았더니 격자가 촘촘해 배경이
- * 먼저 보였다.
- */
-export function niceStep(span: number): number {
-  const raw = Math.max(span, 1) / 5
-  const magnitude = Math.pow(10, Math.floor(Math.log10(raw)))
-  const n = raw / magnitude
-
-  const multiple = n < 1.5 ? 1 : n < 3.5 ? 2 : n < 7.5 ? 5 : 10
-  return Math.max(1, multiple * magnitude)
-}

package/dist-client/modeller/figure-source.d.ts

@@ -1,238 +0,0 @@
-import { type DetailLevel, type FigurePart, type FigurePlacement, type FigureSource, type Vec3 } from '@hatiolab/figure-model';
-/**
- * Scene model <-> `FigureSource`.
- *
- * ## Why this is the only place that converts
- *
- * While authoring, the source of truth is the **scene model** -- part
- * components sitting on a draft. `FigureSource` is produced from it when the
- * asset is saved or scored.
- *
- * The two use different vocabularies. The scene inherited 2D canvas terms
- * (`width`/`height` in plan, `depth` for height, `left`/`top`/`zPos` for
- * position); the format uses the axes 3D tools use (`x` right, `y` up, `z`
- * front, position at the part's **centre**).
- *
- * **Convert in one place.** Two places drift, and this format has already had
- * one incident caused by axes disagreeing.
- *
- * ## It was called `fold`, and that was wrong
- *
- * `fold` is an established term -- it reduces a structure to a summary, and
- * this repo already uses it correctly (`foldKpi`, `foldProbeResults`). Nothing
- * is reduced here: the same information comes out in a different shape, and it
- * goes back unchanged. A reader who learned `fold` from `foldKpi` reads this
- * one as reducing something, and the user did exactly that.
- *
- * ## The mapping
- *
- * The draft is the base box; its centre is the format's origin.
- *
- *     format            scene
- *     ────────────────  ──────────────────────────────
- *     base.x            draft width
- *     base.y            draft depth      <- height
- *     base.z            draft height
- *
- *     size.x            width
- *     size.y            depth
- *     size.z            height
- *
- *     position.x        left + width/2  - draft width/2
- *     position.y        zPos + depth/2                       <- both measured from the box bottom
- *     position.z        top  + height/2 - draft height/2
- *
- *     (Source edition 2 measures y from the bottom face of the base box, as the scene's zPos does, so
- *     that row needs no half-box shift. x and z are still measured from the box centre. ADR-0065.)
- *
- *     rotation.x        rotationX       (scene radians, format degrees)
- *     rotation.y        -rotation
- *     rotation.z        rotationY
- *
- * The rotation names are crossed because of the scene: `rotationY` becomes
- * three's z (`real-object.ts`, `get rotation()`). That stays inside this table.
- *
- * ## Fields nothing reads yet still travel
- *
- * `materialSlot`, `keepRound`, `sizing`, `anchor`, `repeat` and `label` exist in the format
- * and the editor ignores them. They still have to survive a round trip. When a
- * source proposed by AI is opened, edited and written back, a field that
- * disappears **without an error** is one the author cannot know about.
- *
- * **Five have gone that way here**: `ports`, `animations`, `anchor`,
- * `shape.hollow` and `keepRound`. The last one the test caught first, which
- * is the guard below actually earning its keep. The third showed up as a conveyor motor that stayed on the
- * floor no matter what the sample said; the fourth as a hollowed tray that
- * came out a solid block.
- *
- * All four passed the round-trip test, because the fixture it uses did not
- * carry the field. So the test now reads the **field list the format declares**
- * rather than trusting the fixture.
- *
- * `shape` is unpacked into `round`, `path` and `hollow` rather than carried
- * whole, because the editor holds those as separate state. Every field added
- * under `shape` costs a line here, and forgetting that line was the fourth
- * of the four.
- */
-/** 판 컴포넌트의 상태. 씬의 용어 그대로다. */
-export interface FigureDraft {
-    /** 형식 버전. */
-    version?: number;
-    /** 가로 너비 (mm) → `base.x`. */
-    width: number;
-    /** 앞뒤 깊이 (mm) → `base.z`. 저작자가 위에서 내려다볼 때의 세로다. */
-    height: number;
-    /** 높이 (mm) → `base.y`. 서 있는 방향이다. */
-    depth: number;
-    /** 컴포넌트 타입 이름. **저장되는 식별자다.** */
-    figureType?: string;
-    /** 3D 배치 기준면 ('floor' | 'ceiling' | 'center'). */
-    placement?: FigurePlacement;
-    detailLevel?: DetailLevel;
-    styleKit?: string;
-    /**
-     * 움직임. **부품 바깥에 있다** — clip 하나가 부품 여럿을 함께 움직이기 때문이다.
-     *
-     * 편집면이 아직 이것을 만지지 않는다. 그래도 여기 실어 두는 것은, 안 실으면 열었다
-     * 저장하는 것만으로 **조용히 지워지기** 때문이다.
-     */
-    animations?: FigureSource['animations'];
-    /**
-     * 값이 만드는 자세 — **애니메이션과 다른 칸이다.**
-     *
-     * 저것은 시각이 흘러 움직이는 것(도는 롤러)이고 이것은 인스턴스가 준 값이 그대로 자세가
-     * 되는 것(1200mm 내려온 호이스트)이다. 한동안 애니메이션 안에 `drive: 'hold'` 로 숨어
-     * 있었고, 그래서 「길이값을 변수로 노출하라」는 요청에 아무도 이것을 못 찾았다(ADR-0051).
-     */
-    parameters?: FigureSource['parameters'];
-    /**
-     * 이 도형이 지는 능력. 씬의 capability mixin 이름이다.
-     *
-     * **부품이 아니라 도형 전체의 것이다** — 「이 컨베이어는 흐름의 마디다」는 부품 하나가
-     * 아니라 도형이 지는 성질이다. 부품 쪽 `capability` 는 그 능력을 **어느 부품이 받쳐
-     * 주나**를 말하는 다른 칸이다.
-     */
-    capabilities?: FigureSource['capabilities'];
-    /**
-     * How parts move relative to their parents (ADR-0066). Kept in figure coordinates as stored, the same
-     * terms the inspector shows. Carried even when nothing edits them, so opening and saving never drops
-     * them.
-     */
-    joints?: FigureSource['joints'];
-}
-/** 부품 컴포넌트의 상태. 씬의 용어 그대로다. */
-export interface PartModel {
-    type: 'figure-part';
-    /** 부품 이름. **저장되는 식별자다.** 씬은 이 값을 검색에도 쓴다. */
-    name: string;
-    primitive: FigurePart['primitive'];
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-    /** 부피의 **밑면** 높이. 씬의 'floor' 배치에서 그렇게 정해져 있다. */
-    zPos: number;
-    depth: number;
-    /** 라디안. 씬이 그렇게 쓴다. */
-    rotationX?: number;
-    rotation?: number;
-    rotationY?: number;
-    segments?: number;
-    round?: number;
-    path?: {
-        x: number;
-        y: number;
-    }[];
-    /** 속을 판 단면. 편집면이 아직 안 만지지만 잃어버리면 통이 통짜 상자가 된다. */
-    hollow?: NonNullable<FigurePart['shape']>['hollow'];
-    /**
-     * 편집 중에만 쓰는 상태 — **저장 형식으로 넘어가지 않는다.**
-     *
-     * 씬이 이미 갖고 있는 속성이다. 편집 모드에서는 `faint`(반투명 + 색을 버리고 회색으로
-     * 수렴)로 보이고, 뷰 모드에서는 아예 안 그려진다. 판단은 씬의 `modeling-faint` 한 곳에
-     * 있고 2D 캔버스·3D 재질·DOM 세 채널이 같이 쓴다.
-     *
-     * 숨김은 "지금 이 뒤를 만지려고" 하는 것이지 그 부품의 성질이 아니다. 그래서
-     * `toFigureSource` 가 싣지 않고, 다시 열면 전부 보이는 상태로 돌아온다.
-     */
-    hidden?: boolean;
-    /**
-     * 씬이 이것을 **집지 않는다** — 클릭·마퀴·기즈모 어디에도 안 걸린다.
-     *
-     * 저작면에만 서는 것(관절 부채꼴)이 쓴다. 저장 형식에는 없는 칸이라 `toFigureSource` 가
-     * 싣지 않는다.
-     */
-    locked?: boolean;
-    /** 색 토큰 이름 (`palette.primary` 등). */
-    token?: string;
-    preset?: FigurePart['material']['preset'];
-    flatShading?: boolean;
-    transparent?: boolean;
-    /**
-     * 자체발광. 없으면 안 빛난다.
-     *
-     * 바깥의 `token` 이 **꺼진 모습**이고 이 안의 `token` 이 **켜진 모습**이다 — 꺼진
-     * 전구는 빨갛지 않고 어두운 플라스틱이다.
-     */
-    emissive?: FigurePart['material']['emissive'];
-    surface?: FigurePart['material']['surface'];
-    materialSlot?: FigurePart['materialSlot'];
-    /** 단면을 원으로 지킬까. 곡면만 뜻이 있고 기본은 지키는 것이다. */
-    keepRound?: FigurePart['keepRound'];
-    sizing?: FigurePart['sizing'];
-    /** 축마다 어느 면을 붙잡나. `sizing` 이 정한 것을 덮어쓴다. */
-    anchor?: FigurePart['anchor'];
-    repeat?: FigurePart['repeat'];
-    label?: FigurePart['label'];
-    /**
-     * 이 부품이 능력의 어느 자리인가 — 물건이 앉는 자리(slot)이거나 드나드는 문(port)이다.
-     *
-     * 이 칸이 있는 부품은 **그려지지 않는다.** 저작면에서는 어디인지 보여야 하니 그리지만,
-     * 청사진에서는 `groups` 가 아니라 `anchors` 로 간다.
-     */
-    capability?: FigurePart['capability'];
-    /** The part this one is attached to (ADR-0066). The one place a parent is written. */
-    parent?: FigurePart['parent'];
-}
-/** 소수점 넷째 자리까지. 라디안↔도를 오가며 생기는 꼬리를 자른다. */
-export declare function round4(value: number): number;
-/**
- * 판의 절반. 형식의 원점이 판 중심이라 이 값이 늘 함께 다닌다.
- *
- * 축 이름은 **형식의 것**이다 — x 가로 · y 높이 · z 세로.
- */
-export declare function halfOf(draft: FigureDraft): Vec3;
-/**
- * 저작자가 보는 축이 씬의 어느 용어인가.
- *
- * 씬은 2D 캔버스에서 온 용어를 쓰므로 축 이름이 그대로 없다. 이 표가 **유일한** 대응이다 —
- * 편집 규칙이 저마다 자기 표를 들면 한 곳을 고칠 때 다른 곳이 남는다.
- */
-export declare const AXIS_KEYS: {
-    readonly x: {
-        readonly at: "left";
-        readonly size: "width";
-    };
-    readonly y: {
-        readonly at: "zPos";
-        readonly size: "depth";
-    };
-    readonly z: {
-        readonly at: "top";
-        readonly size: "height";
-    };
-};
-export type PlaneAxis = keyof typeof AXIS_KEYS;
-/** 판이 그 축으로 얼마나 넓은가. */
-export declare function draftExtent(draft: FigureDraft, axis: PlaneAxis): number;
-/** 부품 하나를 저장 형식으로 변환한다. 저작 화면이 저작자의 어휘로 보일 때 쓴다. */
-export declare function partToFigure(part: PartModel, draft: FigureDraft): FigurePart;
-/** 부품 하나를 씬 용어로 되돌린다. */
-export declare function partFromFigure(part: FigurePart, draft: FigureDraft): PartModel;
-/** 씬 모델을 저장 형식으로 변환한다. */
-export declare function toFigureSource(draft: FigureDraft, parts: PartModel[]): FigureSource;
-/** 형식을 씬 모델로 편다. */
-export declare function fromFigureSource(source: FigureSource): {
-    draft: FigureDraft;
-    parts: PartModel[];
-};