@things-factory/figure-ui 10.1.65 → 10.1.67

package/dist-client/modeller/figure-source.js

@@ -1,193 +0,0 @@
-import { FIGURE_SOURCE_VERSION } from '@hatiolab/figure-model';
-const RAD_TO_DEG = 180 / Math.PI;
-const DEG_TO_RAD = Math.PI / 180;
-/** 값이 있는 것만 남긴다. 없는 필드를 `undefined` 로 두면 접었다 편 것이 원본과 달라진다. */
-function withoutEmpty(value) {
-    const out = {};
-    for (const [key, item] of Object.entries(value)) {
-        if (item !== undefined)
-            out[key] = item;
-    }
-    return out;
-}
-/** 소수점 넷째 자리까지. 라디안↔도를 오가며 생기는 꼬리를 자른다. */
-export function round4(value) {
-    return Math.round(value * 1e4) / 1e4;
-}
-/**
- * 판의 절반. 형식의 원점이 판 중심이라 이 값이 늘 함께 다닌다.
- *
- * 축 이름은 **형식의 것**이다 — x 가로 · y 높이 · z 세로.
- */
-export function halfOf(draft) {
-    return { x: draft.width / 2, y: draft.depth / 2, z: draft.height / 2 };
-}
-/*
- * ── The placement is not in these numbers ────────────────────────────────────
- *
- * `placement` says which reference surface a figure of this kind attaches to — a conveyor stands
- * on the floor, an OHT hangs from the ceiling. That is a fact about the figure *type*, and the
- * scene acts on it when an instance is placed: `floor` puts the box on the ground, `ceiling` at
- * the ceiling height less the figure's own height. Nothing about the authored shape changes.
- *
- * So the conversion below does not read it, and the editing canvas does not either. The box is
- * always `0 … base.y` there and `zPos` is always the part's underside. Two figures with identical
- * parts and different placements have identical `parts` arrays, which is what the format says.
- *
- * This used to be wired the other way: the canvas fed the figure's placement to the model layer's
- * `state.placement`, which is a scene-wide coordinate mode ('floor' | 'space' | 'inverted') that
- * flips what `zPos` names for everything in that layer. It stood in for the archetype because the
- * modeller holds exactly one figure — and it cost a whole day of defects, because every number the
- * author typed then meant a different face depending on a dropdown. That coordinate mode is now
- * where it belongs: a workbench setting in `figure-view.ts`, applied to the preview alone.
- */
-/**
- * 저작자가 보는 축이 씬의 어느 용어인가.
- *
- * 씬은 2D 캔버스에서 온 용어를 쓰므로 축 이름이 그대로 없다. 이 표가 **유일한** 대응이다 —
- * 편집 규칙이 저마다 자기 표를 들면 한 곳을 고칠 때 다른 곳이 남는다.
- */
-export const AXIS_KEYS = {
-    x: { at: 'left', size: 'width' },
-    y: { at: 'zPos', size: 'depth' },
-    z: { at: 'top', size: 'height' }
-};
-/** 판이 그 축으로 얼마나 넓은가. */
-export function draftExtent(draft, axis) {
-    return axis === 'x' ? draft.width : axis === 'y' ? draft.depth : draft.height;
-}
-/** 부품 하나를 저장 형식으로 변환한다. 저작 화면이 저작자의 어휘로 보일 때 쓴다. */
-export function partToFigure(part, draft) {
-    return partTo(part, halfOf(draft));
-}
-/** 부품 하나를 씬 용어로 되돌린다. */
-export function partFromFigure(part, draft) {
-    return partFrom(part, halfOf(draft));
-}
-/** 씬 모델을 저장 형식으로 변환한다. */
-export function toFigureSource(draft, parts) {
-    const half = halfOf(draft);
-    return withoutEmpty({
-        version: draft.version ?? FIGURE_SOURCE_VERSION,
-        type: draft.figureType ?? '',
-        base: { x: draft.width, y: draft.depth, z: draft.height },
-        placement: draft.placement,
-        detailLevel: draft.detailLevel,
-        styleKit: draft.styleKit,
-        parts: parts.map(part => partTo(part, half)),
-        animations: draft.animations,
-        parameters: draft.parameters,
-        capabilities: draft.capabilities,
-        joints: draft.joints?.length ? draft.joints : undefined
-    });
-}
-function partTo(part, half) {
-    const rotation = withoutEmpty({
-        x: part.rotationX ? round4(part.rotationX * RAD_TO_DEG) : undefined,
-        y: part.rotation ? round4(-part.rotation * RAD_TO_DEG) : undefined,
-        z: part.rotationY ? round4(part.rotationY * RAD_TO_DEG) : undefined
-    });
-    const shape = withoutEmpty({ round: part.round, path: part.path, hollow: part.hollow });
-    /*
-      재질이 하나도 없으면 **칸 자체를 안 적는다.**
-  
-      빈 객체를 적으면 형식이 「재질은 있는데 무엇으로 칠할지 모른다」로 읽어
-      `material-unresolvable` 을 낸다. 그리지 않는 자리(`capability`)에는 재질이 없는 것이
-      정상이고, 그 부품이 조용히 오류를 달고 다니게 된다.
-    */
-    const material = withoutEmpty({
-        token: part.token,
-        preset: part.preset,
-        flatShading: part.flatShading,
-        transparent: part.transparent,
-        emissive: part.emissive,
-        surface: part.surface
-    });
-    return withoutEmpty({
-        name: part.name,
-        primitive: part.primitive,
-        transform: withoutEmpty({
-            position: {
-                x: round4(part.left + part.width / 2 - half.x),
-                y: round4(part.zPos + part.depth / 2),
-                z: round4(part.top + part.height / 2 - half.z)
-            },
-            size: { x: part.width, y: part.depth, z: part.height },
-            rotation: Object.keys(rotation).length > 0 ? rotation : undefined
-        }),
-        segments: part.segments,
-        shape: Object.keys(shape).length > 0 ? shape : undefined,
-        material: Object.keys(material).length > 0 ? material : undefined,
-        materialSlot: part.materialSlot,
-        keepRound: part.keepRound,
-        sizing: part.sizing,
-        anchor: part.anchor,
-        repeat: part.repeat,
-        label: part.label,
-        capability: part.capability,
-        parent: part.parent
-    });
-}
-/** 형식을 씬 모델로 편다. */
-export function fromFigureSource(source) {
-    const half = { x: source.base.x / 2, y: source.base.y / 2, z: source.base.z / 2 };
-    const draft = withoutEmpty({
-        version: source.version,
-        width: source.base.x,
-        height: source.base.z,
-        depth: source.base.y,
-        figureType: source.type,
-        placement: source.placement,
-        detailLevel: source.detailLevel,
-        styleKit: source.styleKit,
-        /* Opened as stored. A legacy `drive: 'hold'` clip is refused by the format now; stored ones were migrated. */
-        animations: source.animations?.length ? source.animations : undefined,
-        parameters: source.parameters?.length ? source.parameters : undefined,
-        capabilities: source.capabilities,
-        joints: source.joints?.length ? source.joints : undefined
-    });
-    return { draft, parts: source.parts.map(part => partFrom(part, half)) };
-}
-function partFrom(part, half) {
-    const { position, size, rotation } = part.transform;
-    const material = part.material ?? {};
-    return withoutEmpty({
-        type: 'figure-part',
-        name: part.name,
-        primitive: part.primitive,
-        left: round4(half.x + position.x - size.x / 2),
-        top: round4(half.z + position.z - size.z / 2),
-        width: size.x,
-        height: size.z,
-        zPos: round4(position.y - size.y / 2),
-        depth: size.y,
-        /*
-          라디안은 자르지 않는다.
-    
-          소수 넷째에서 잘랐더니 도로 되돌릴 때 57 배로 커져 45 도가 45.0001 이 됐다.
-          자르는 것은 **사람이 읽는 쪽**(도)에서만 한다.
-        */
-        rotationX: rotation?.x ? rotation.x * DEG_TO_RAD : undefined,
-        rotation: rotation?.y ? -rotation.y * DEG_TO_RAD : undefined,
-        rotationY: rotation?.z ? rotation.z * DEG_TO_RAD : undefined,
-        segments: part.segments,
-        round: part.shape?.round,
-        path: part.shape?.path,
-        hollow: part.shape?.hollow,
-        token: material.token,
-        preset: material.preset,
-        flatShading: material.flatShading,
-        transparent: material.transparent,
-        emissive: material.emissive,
-        surface: material.surface,
-        materialSlot: part.materialSlot,
-        keepRound: part.keepRound,
-        sizing: part.sizing,
-        anchor: part.anchor,
-        repeat: part.repeat,
-        label: part.label,
-        capability: part.capability,
-        parent: part.parent
-    });
-}
-//# sourceMappingURL=figure-source.js.map

package/dist-client/modeller/figure-source.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"figure-source.js","sourceRoot":"","sources":["../../client/modeller/figure-source.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FIGURE_SOURCE_VERSION,\n  type DetailLevel,\n  type FigurePart,\n  type FigurePlacement,\n  type FigureSource,\n  type Vec3\n} from '@hatiolab/figure-model'\n\n/**\n * Scene model <-> `FigureSource`.\n *\n * ## Why this is the only place that converts\n *\n * While authoring, the source of truth is the **scene model** -- part\n * components sitting on a draft. `FigureSource` is produced from it when the\n * asset is saved or scored.\n *\n * The two use different vocabularies. The scene inherited 2D canvas terms\n * (`width`/`height` in plan, `depth` for height, `left`/`top`/`zPos` for\n * position); the format uses the axes 3D tools use (`x` right, `y` up, `z`\n * front, position at the part's **centre**).\n *\n * **Convert in one place.** Two places drift, and this format has already had\n * one incident caused by axes disagreeing.\n *\n * ## It was called `fold`, and that was wrong\n *\n * `fold` is an established term -- it reduces a structure to a summary, and\n * this repo already uses it correctly (`foldKpi`, `foldProbeResults`). Nothing\n * is reduced here: the same information comes out in a different shape, and it\n * goes back unchanged. A reader who learned `fold` from `foldKpi` reads this\n * one as reducing something, and the user did exactly that.\n *\n * ## The mapping\n *\n * The draft is the base box; its centre is the format's origin.\n *\n *     format            scene\n *     ────────────────  ──────────────────────────────\n *     base.x            draft width\n *     base.y            draft depth      <- height\n *     base.z            draft height\n *\n *     size.x            width\n *     size.y            depth\n *     size.z            height\n *\n *     position.x        left + width/2  - draft width/2\n *     position.y        zPos + depth/2                       <- both measured from the box bottom\n *     position.z        top  + height/2 - draft height/2\n *\n *     (Source edition 2 measures y from the bottom face of the base box, as the scene's zPos does, so\n *     that row needs no half-box shift. x and z are still measured from the box centre. ADR-0065.)\n *\n *     rotation.x        rotationX       (scene radians, format degrees)\n *     rotation.y        -rotation\n *     rotation.z        rotationY\n *\n * The rotation names are crossed because of the scene: `rotationY` becomes\n * three's z (`real-object.ts`, `get rotation()`). That stays inside this table.\n *\n * ## Fields nothing reads yet still travel\n *\n * `materialSlot`, `keepRound`, `sizing`, `anchor`, `repeat` and `label` exist in the format\n * and the editor ignores them. They still have to survive a round trip. When a\n * source proposed by AI is opened, edited and written back, a field that\n * disappears **without an error** is one the author cannot know about.\n *\n * **Five have gone that way here**: `ports`, `animations`, `anchor`,\n * `shape.hollow` and `keepRound`. The last one the test caught first, which\n * is the guard below actually earning its keep. The third showed up as a conveyor motor that stayed on the\n * floor no matter what the sample said; the fourth as a hollowed tray that\n * came out a solid block.\n *\n * All four passed the round-trip test, because the fixture it uses did not\n * carry the field. So the test now reads the **field list the format declares**\n * rather than trusting the fixture.\n *\n * `shape` is unpacked into `round`, `path` and `hollow` rather than carried\n * whole, because the editor holds those as separate state. Every field added\n * under `shape` costs a line here, and forgetting that line was the fourth\n * of the four.\n */\n/** 판 컴포넌트의 상태. 씬의 용어 그대로다. */\nexport interface FigureDraft {\n  /** 형식 버전. */\n  version?: number\n  /*\n    The three sizes keep the scene component's names, and the scene assigns its axes differently\n    from the format: here `depth` is the vertical one. Naming the axis alone (\"the y axis\") does\n    not say which of the two conventions is meant, and this interface sits on the boundary between\n    them — so each field names the `FigureSource` field it becomes. `toFigureSource` and\n    `fromFigureSource` below are the only places that may disagree with these three lines.\n  */\n  /** 가로 너비 (mm) → `base.x`. */\n  width: number\n  /** 앞뒤 깊이 (mm) → `base.z`. 저작자가 위에서 내려다볼 때의 세로다. */\n  height: number\n  /** 높이 (mm) → `base.y`. 서 있는 방향이다. */\n  depth: number\n  /** 컴포넌트 타입 이름. **저장되는 식별자다.** */\n  figureType?: string\n  /** 3D 배치 기준면 ('floor' | 'ceiling' | 'center'). */\n  placement?: FigurePlacement\n  detailLevel?: DetailLevel\n  styleKit?: string\n  /**\n   * 움직임. **부품 바깥에 있다** — clip 하나가 부품 여럿을 함께 움직이기 때문이다.\n   *\n   * 편집면이 아직 이것을 만지지 않는다. 그래도 여기 실어 두는 것은, 안 실으면 열었다\n   * 저장하는 것만으로 **조용히 지워지기** 때문이다.\n   */\n  animations?: FigureSource['animations']\n  /**\n   * 값이 만드는 자세 — **애니메이션과 다른 칸이다.**\n   *\n   * 저것은 시각이 흘러 움직이는 것(도는 롤러)이고 이것은 인스턴스가 준 값이 그대로 자세가\n   * 되는 것(1200mm 내려온 호이스트)이다. 한동안 애니메이션 안에 `drive: 'hold'` 로 숨어\n   * 있었고, 그래서 「길이값을 변수로 노출하라」는 요청에 아무도 이것을 못 찾았다(ADR-0051).\n   */\n  parameters?: FigureSource['parameters']\n  /**\n   * 이 도형이 지는 능력. 씬의 capability mixin 이름이다.\n   *\n   * **부품이 아니라 도형 전체의 것이다** — 「이 컨베이어는 흐름의 마디다」는 부품 하나가\n   * 아니라 도형이 지는 성질이다. 부품 쪽 `capability` 는 그 능력을 **어느 부품이 받쳐\n   * 주나**를 말하는 다른 칸이다.\n   */\n  capabilities?: FigureSource['capabilities']\n  /**\n   * How parts move relative to their parents (ADR-0066). Kept in figure coordinates as stored, the same\n   * terms the inspector shows. Carried even when nothing edits them, so opening and saving never drops\n   * them.\n   */\n  joints?: FigureSource['joints']\n}\n\n/** 부품 컴포넌트의 상태. 씬의 용어 그대로다. */\nexport interface PartModel {\n  type: 'figure-part'\n  /** 부품 이름. **저장되는 식별자다.** 씬은 이 값을 검색에도 쓴다. */\n  name: string\n  primitive: FigurePart['primitive']\n\n  left: number\n  top: number\n  width: number\n  height: number\n  /** 부피의 **밑면** 높이. 씬의 'floor' 배치에서 그렇게 정해져 있다. */\n  zPos: number\n  depth: number\n\n  /** 라디안. 씬이 그렇게 쓴다. */\n  rotationX?: number\n  rotation?: number\n  rotationY?: number\n\n  segments?: number\n  round?: number\n  path?: { x: number; y: number }[]\n  /** 속을 판 단면. 편집면이 아직 안 만지지만 잃어버리면 통이 통짜 상자가 된다. */\n  hollow?: NonNullable<FigurePart['shape']>['hollow']\n\n  /**\n   * 편집 중에만 쓰는 상태 — **저장 형식으로 넘어가지 않는다.**\n   *\n   * 씬이 이미 갖고 있는 속성이다. 편집 모드에서는 `faint`(반투명 + 색을 버리고 회색으로\n   * 수렴)로 보이고, 뷰 모드에서는 아예 안 그려진다. 판단은 씬의 `modeling-faint` 한 곳에\n   * 있고 2D 캔버스·3D 재질·DOM 세 채널이 같이 쓴다.\n   *\n   * 숨김은 \"지금 이 뒤를 만지려고\" 하는 것이지 그 부품의 성질이 아니다. 그래서\n   * `toFigureSource` 가 싣지 않고, 다시 열면 전부 보이는 상태로 돌아온다.\n   */\n  hidden?: boolean\n\n  /**\n   * 씬이 이것을 **집지 않는다** — 클릭·마퀴·기즈모 어디에도 안 걸린다.\n   *\n   * 저작면에만 서는 것(관절 부채꼴)이 쓴다. 저장 형식에는 없는 칸이라 `toFigureSource` 가\n   * 싣지 않는다.\n   */\n  locked?: boolean\n\n  /** 색 토큰 이름 (`palette.primary` 등). */\n  token?: string\n  /*\n    `FigurePart['material']` is required in the format, so these index into it directly. The\n    `NonNullable` on `shape` above is not the same case — `shape` is optional there.\n  */\n  preset?: FigurePart['material']['preset']\n  flatShading?: boolean\n  transparent?: boolean\n  /**\n   * 자체발광. 없으면 안 빛난다.\n   *\n   * 바깥의 `token` 이 **꺼진 모습**이고 이 안의 `token` 이 **켜진 모습**이다 — 꺼진\n   * 전구는 빨갛지 않고 어두운 플라스틱이다.\n   */\n  emissive?: FigurePart['material']['emissive']\n  surface?: FigurePart['material']['surface']\n\n  /* 아직 아무 일도 안 하지만 잃어버리지 않는다. */\n  materialSlot?: FigurePart['materialSlot']\n  /** 단면을 원으로 지킬까. 곡면만 뜻이 있고 기본은 지키는 것이다. */\n  keepRound?: FigurePart['keepRound']\n  sizing?: FigurePart['sizing']\n  /** 축마다 어느 면을 붙잡나. `sizing` 이 정한 것을 덮어쓴다. */\n  anchor?: FigurePart['anchor']\n  repeat?: FigurePart['repeat']\n  label?: FigurePart['label']\n  /**\n   * 이 부품이 능력의 어느 자리인가 — 물건이 앉는 자리(slot)이거나 드나드는 문(port)이다.\n   *\n   * 이 칸이 있는 부품은 **그려지지 않는다.** 저작면에서는 어디인지 보여야 하니 그리지만,\n   * 청사진에서는 `groups` 가 아니라 `anchors` 로 간다.\n   */\n  capability?: FigurePart['capability']\n  /** The part this one is attached to (ADR-0066). The one place a parent is written. */\n  parent?: FigurePart['parent']\n}\n\nconst RAD_TO_DEG = 180 / Math.PI\nconst DEG_TO_RAD = Math.PI / 180\n\n/** 값이 있는 것만 남긴다. 없는 필드를 `undefined` 로 두면 접었다 편 것이 원본과 달라진다. */\nfunction withoutEmpty<T extends object>(value: T): T {\n  const out = {} as Record<string, unknown>\n  for (const [key, item] of Object.entries(value)) {\n    if (item !== undefined) out[key] = item\n  }\n  return out as T\n}\n\n/** 소수점 넷째 자리까지. 라디안↔도를 오가며 생기는 꼬리를 자른다. */\nexport function round4(value: number): number {\n  return Math.round(value * 1e4) / 1e4\n}\n\n/**\n * 판의 절반. 형식의 원점이 판 중심이라 이 값이 늘 함께 다닌다.\n *\n * 축 이름은 **형식의 것**이다 — x 가로 · y 높이 · z 세로.\n */\nexport function halfOf(draft: FigureDraft): Vec3 {\n  return { x: draft.width / 2, y: draft.depth / 2, z: draft.height / 2 }\n}\n\n/*\n * ── The placement is not in these numbers ────────────────────────────────────\n *\n * `placement` says which reference surface a figure of this kind attaches to — a conveyor stands\n * on the floor, an OHT hangs from the ceiling. That is a fact about the figure *type*, and the\n * scene acts on it when an instance is placed: `floor` puts the box on the ground, `ceiling` at\n * the ceiling height less the figure's own height. Nothing about the authored shape changes.\n *\n * So the conversion below does not read it, and the editing canvas does not either. The box is\n * always `0 … base.y` there and `zPos` is always the part's underside. Two figures with identical\n * parts and different placements have identical `parts` arrays, which is what the format says.\n *\n * This used to be wired the other way: the canvas fed the figure's placement to the model layer's\n * `state.placement`, which is a scene-wide coordinate mode ('floor' | 'space' | 'inverted') that\n * flips what `zPos` names for everything in that layer. It stood in for the archetype because the\n * modeller holds exactly one figure — and it cost a whole day of defects, because every number the\n * author typed then meant a different face depending on a dropdown. That coordinate mode is now\n * where it belongs: a workbench setting in `figure-view.ts`, applied to the preview alone.\n */\n\n/**\n * 저작자가 보는 축이 씬의 어느 용어인가.\n *\n * 씬은 2D 캔버스에서 온 용어를 쓰므로 축 이름이 그대로 없다. 이 표가 **유일한** 대응이다 —\n * 편집 규칙이 저마다 자기 표를 들면 한 곳을 고칠 때 다른 곳이 남는다.\n */\nexport const AXIS_KEYS = {\n  x: { at: 'left', size: 'width' },\n  y: { at: 'zPos', size: 'depth' },\n  z: { at: 'top', size: 'height' }\n} as const\n\nexport type PlaneAxis = keyof typeof AXIS_KEYS\n\n/** 판이 그 축으로 얼마나 넓은가. */\nexport function draftExtent(draft: FigureDraft, axis: PlaneAxis): number {\n  return axis === 'x' ? draft.width : axis === 'y' ? draft.depth : draft.height\n}\n\n/** 부품 하나를 저장 형식으로 변환한다. 저작 화면이 저작자의 어휘로 보일 때 쓴다. */\nexport function partToFigure(part: PartModel, draft: FigureDraft): FigurePart {\n  return partTo(part, halfOf(draft))\n}\n\n/** 부품 하나를 씬 용어로 되돌린다. */\nexport function partFromFigure(part: FigurePart, draft: FigureDraft): PartModel {\n  return partFrom(part, halfOf(draft))\n}\n\n/** 씬 모델을 저장 형식으로 변환한다. */\nexport function toFigureSource(draft: FigureDraft, parts: PartModel[]): FigureSource {\n  const half = halfOf(draft)\n\n  return withoutEmpty({\n    version: draft.version ?? FIGURE_SOURCE_VERSION,\n    type: draft.figureType ?? '',\n    base: { x: draft.width, y: draft.depth, z: draft.height },\n    placement: draft.placement,\n    detailLevel: draft.detailLevel,\n    styleKit: draft.styleKit,\n    parts: parts.map(part => partTo(part, half)),\n    animations: draft.animations,\n    parameters: draft.parameters,\n    capabilities: draft.capabilities,\n    joints: draft.joints?.length ? draft.joints : undefined\n  }) as FigureSource\n}\n\nfunction partTo(part: PartModel, half: Vec3): FigurePart {\n  const rotation = withoutEmpty({\n    x: part.rotationX ? round4(part.rotationX * RAD_TO_DEG) : undefined,\n    y: part.rotation ? round4(-part.rotation * RAD_TO_DEG) : undefined,\n    z: part.rotationY ? round4(part.rotationY * RAD_TO_DEG) : undefined\n  })\n\n  const shape = withoutEmpty({ round: part.round, path: part.path, hollow: part.hollow })\n  /*\n    재질이 하나도 없으면 **칸 자체를 안 적는다.**\n\n    빈 객체를 적으면 형식이 「재질은 있는데 무엇으로 칠할지 모른다」로 읽어\n    `material-unresolvable` 을 낸다. 그리지 않는 자리(`capability`)에는 재질이 없는 것이\n    정상이고, 그 부품이 조용히 오류를 달고 다니게 된다.\n  */\n  const material = withoutEmpty({\n    token: part.token,\n    preset: part.preset,\n    flatShading: part.flatShading,\n    transparent: part.transparent,\n    emissive: part.emissive,\n    surface: part.surface\n  })\n\n  return withoutEmpty({\n    name: part.name,\n    primitive: part.primitive,\n    transform: withoutEmpty({\n      position: {\n        x: round4(part.left + part.width / 2 - half.x),\n        y: round4(part.zPos + part.depth / 2),\n        z: round4(part.top + part.height / 2 - half.z)\n      },\n      size: { x: part.width, y: part.depth, z: part.height },\n      rotation: Object.keys(rotation).length > 0 ? rotation : undefined\n    }),\n    segments: part.segments,\n    shape: Object.keys(shape).length > 0 ? shape : undefined,\n    material: Object.keys(material).length > 0 ? material : undefined,\n    materialSlot: part.materialSlot,\n    keepRound: part.keepRound,\n    sizing: part.sizing,\n    anchor: part.anchor,\n    repeat: part.repeat,\n    label: part.label,\n    capability: part.capability,\n    parent: part.parent\n  }) as FigurePart\n}\n\n/** 형식을 씬 모델로 편다. */\nexport function fromFigureSource(source: FigureSource): { draft: FigureDraft; parts: PartModel[] } {\n  const half: Vec3 = { x: source.base.x / 2, y: source.base.y / 2, z: source.base.z / 2 }\n\n  const draft = withoutEmpty({\n    version: source.version,\n    width: source.base.x,\n    height: source.base.z,\n    depth: source.base.y,\n    figureType: source.type,\n    placement: source.placement,\n    detailLevel: source.detailLevel,\n    styleKit: source.styleKit,\n    /* Opened as stored. A legacy `drive: 'hold'` clip is refused by the format now; stored ones were migrated. */\n    animations: source.animations?.length ? source.animations : undefined,\n    parameters: source.parameters?.length ? source.parameters : undefined,\n    capabilities: source.capabilities,\n    joints: source.joints?.length ? source.joints : undefined\n  }) as FigureDraft\n\n  return { draft, parts: source.parts.map(part => partFrom(part, half)) }\n}\n\nfunction partFrom(part: FigurePart, half: Vec3): PartModel {\n  const { position, size, rotation } = part.transform\n  const material = part.material ?? {}\n\n  return withoutEmpty({\n    type: 'figure-part',\n    name: part.name,\n    primitive: part.primitive,\n\n    left: round4(half.x + position.x - size.x / 2),\n    top: round4(half.z + position.z - size.z / 2),\n    width: size.x,\n    height: size.z,\n    zPos: round4(position.y - size.y / 2),\n    depth: size.y,\n\n    /*\n      라디안은 자르지 않는다.\n\n      소수 넷째에서 잘랐더니 도로 되돌릴 때 57 배로 커져 45 도가 45.0001 이 됐다.\n      자르는 것은 **사람이 읽는 쪽**(도)에서만 한다.\n    */\n    rotationX: rotation?.x ? rotation.x * DEG_TO_RAD : undefined,\n    rotation: rotation?.y ? -rotation.y * DEG_TO_RAD : undefined,\n    rotationY: rotation?.z ? rotation.z * DEG_TO_RAD : undefined,\n\n    segments: part.segments,\n    round: part.shape?.round,\n    path: part.shape?.path,\n    hollow: part.shape?.hollow,\n\n    token: material.token,\n    preset: material.preset,\n    flatShading: material.flatShading,\n    transparent: material.transparent,\n    emissive: material.emissive,\n    surface: material.surface,\n\n    materialSlot: part.materialSlot,\n    keepRound: part.keepRound,\n    sizing: part.sizing,\n    anchor: part.anchor,\n    repeat: part.repeat,\n    label: part.label,\n    capability: part.capability,\n    parent: part.parent\n  }) as PartModel\n}\n"]}

package/dist-client/modeller/part-edits.d.ts

@@ -1,89 +0,0 @@
-import type { PrimitiveKind } from '@hatiolab/figure-model';
-import type { FigureDraft, PartModel, PlaneAxis } from './figure-source.js';
-/** 이 초안에 부품을 몇 개까지 넣을 수 있는지. 디테일 등급이 결정한다. */
-export declare function partLimit(draft: FigureDraft): number;
-/**
- * 새 부품 하나를 만든다.
- *
- * 기준 상자의 3분의 1 크기다. 추가하자마자 화면에 보여야 한다 — 크기 0 으로 놓으면
- * 사용자에게는 아무 일도 일어나지 않은 것으로 보인다.
- *
- * ## 어디에 놓나 — 고른 부품 **위**다
- *
- * 전에는 언제나 바닥 한가운데였다. 첫 부품은 그 자리가 맞지만 둘째부터는 **첫 부품 속에**
- * 들어간다 — 같은 자리에 같은 크기로 놓이니 화면에는 덩어리 하나뿐이고, 저작자는 무엇이
- * 늘었는지 못 본다. 「추가하자마자 보여야 한다」는 그때 이미 깨져 있었다.
- *
- * 그래서 고른 부품이 있으면 그 부품의 **윗면**에 얹고 발자국을 가운데로 맞춘다. 기계는
- * 대개 그렇게 쌓인다(받침 → 어깨 → 팔). 관절을 걸 때도 이 자리가 필요하다 — 맞닿는 면이
- * 실제로 있어야 `seamOrigin` 이 회전 중심을 그 면에서 잡는다.
- *
- * 위에 얹으면 기준 상자를 넘는 경우에는 바닥 한가운데로 간다. 넘은 채로 놓으면 발행이
- * 막히고(`part-outside-base`), 그것을 고치는 일이 「부품을 추가했다」의 대가가 된다.
- * 가로·세로는 상자 안으로 당긴다 — 고른 부품이 가장자리에 있으면 그 위가 상자 밖이다.
- */
-export declare function newPart(draft: FigureDraft, parts: PartModel[], primitive: PrimitiveKind, onTopOf?: PartModel): PartModel;
-/**
- * 씬에서 온 부품을 밀리미터로 맞춘다.
- *
- * 기즈모는 비율을 곱해서 크기를 낸다 — 420 에 1.72 를 곱하면 722.4180046035418 이고, 손대지
- * 않은 축도 384.99999999999994 처럼 흔들린다. 저작자가 끈 결과가 소수 넷째 자리까지 남을
- * 까닭이 없고, 칸에는 「722.4…」로 잘려 보인다. 이 편집기의 다른 길은 전부 정수 밀리미터로
- * 맞춘다(부품을 새로 놓을 때 · 가운데 맞추기 · 격자 맞추기).
- *
- * 크기는 1 밑으로 내려가지 않는다 — 0 이면 부피가 사라지고 배율이 0 으로 나뉜다.
- */
-export declare function roundPart(part: PartModel): PartModel;
-export declare function addPart(draft: FigureDraft, parts: PartModel[], primitive: PrimitiveKind, onTopOf?: PartModel): PartModel[];
-export declare function removePart(parts: PartModel[], index: number): PartModel[];
-/** 부품을 복제한다. 이름만 새로 붙인다 — 중복되면 검증에서 걸린다. */
-export declare function duplicatePart(parts: PartModel[], index: number): PartModel[];
-/** 목록에서 순서를 바꾼다. 범위를 벗어나면 그대로 둔다. */
-export declare function movePart(parts: PartModel[], index: number, to: number): PartModel[];
-export declare function updatePart(parts: PartModel[], index: number, part: PartModel): PartModel[];
-/** 부품을 기준 상자의 해당 축 가운데로 옮긴다. */
-export declare function centerPart(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): PartModel[];
-/** 부품을 상자 바닥(또는 해당 축의 시작)에 붙인다. */
-export declare function alignPartToStart(parts: PartModel[], index: number, axis: PlaneAxis): PartModel[];
-/** 부품을 상자의 끝에 붙인다. */
-export declare function alignPartToEnd(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): PartModel[];
-/**
- * 부품을 축 기준으로 대칭 복제한다.
- *
- * 다리 넷, 팔 둘 같은 형상을 이것 없이 만들면 고생한다. 이름은 **어느 쪽인지 알 수
- * 있게** 붙인다 — `leg` 를 x 축으로 대칭하면 `leg-x`.
- */
-export declare function mirrorPart(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): PartModel[];
-/**
- * 대칭이 의미가 있는지.
- *
- * 이미 그 축의 가운데에 있는 부품을 대칭하면 **같은 자리에 사본이 생긴다.** 화면에는
- * 아무 변화가 없어 보이는데 부품 수만 늘고, 겹친 면에서 z-fighting 이 일어난다.
- * 만들어 놓고 알리는 대신 미리 막는다.
- */
-export declare function canMirror(draft: FigureDraft, parts: PartModel[], index: number, axis: PlaneAxis): boolean;
-/**
- * 부품의 위치와 크기를 격자에 맞춘다.
- *
- * 격자 간격은 상자 크기에서 계산한다 — 고정 값이면 작은 형상에서는 너무 크고 큰
- * 형상에서는 너무 잘다. 3D 바닥 격자와 같은 계산이라 화면에서 보이는 것과 일치한다.
- */
-export declare function snapPart(draft: FigureDraft, parts: PartModel[], index: number): PartModel[];
-/**
- * 격자 간격. 3D 바닥에 그려지는 격자와 같은 값이다.
- *
- * **세 축을 다 본다.** 평면만 보면 키가 큰 모델에서 격자가 지나치게 잘아진다. 시그널타워
- * (바닥 160 x 160, 높이 1100)는 평면 기준으로 간격이 20 이 나와서, 옆에서 보면 높이가
- * 격자 55 칸이 된다. 격자는 크기를 가늠하는 자이므로 모델 전체에 대해 읽혀야 한다.
- */
-export declare function gridStep(draft: FigureDraft): number;
-/**
- * 주어진 길이에 어울리는 **읽기 좋은** 격자 간격. 다섯 칸 정도가 되게 잡는다.
- *
- * 그냥 나누면 27·33 같은 값이 나온다. 그 격자에 맞추면 좌표가 54·81 이 되어 읽기
- * 어렵다. 1·2·5 배수로 올림한다 — 자와 차트 눈금이 쓰는 방식이다.
- *
- * 격자가 성겨야 형상이 눈에 먼저 들어온다. 열 칸으로 잡았더니 격자가 촘촘해 배경이
- * 먼저 보였다.
- */
-export declare function niceStep(span: number): number;

package/dist-client/modeller/part-edits.js

@@ -1,270 +0,0 @@
-import { EXTRUDE_PRIMITIVES, SEGMENTED_PRIMITIVES, SEGMENT_PRESETS, PART_LIMIT } from '@hatiolab/figure-model';
-import { AXIS_KEYS, draftExtent } 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, base) {
-    if (!taken.has(base))
-        return base;
-    for (let n = 2;; n++) {
-        const candidate = `${base}-${n}`;
-        if (!taken.has(candidate))
-            return candidate;
-    }
-}
-const round = (value) => Math.round(value);
-/** 값을 두 끝 사이로 당긴다. 끝이 뒤집혀 있으면(부품이 상자보다 크다) 앞의 끝을 따른다. */
-function clamp(value, least, most) {
-    return Math.max(least, Math.min(most, value));
-}
-/** 이 초안에 부품을 몇 개까지 넣을 수 있는지. 디테일 등급이 결정한다. */
-export function partLimit(draft) {
-    return PART_LIMIT[(draft.detailLevel ?? 'M')];
-}
-/**
- * 새 부품 하나를 만든다.
- *
- * 기준 상자의 3분의 1 크기다. 추가하자마자 화면에 보여야 한다 — 크기 0 으로 놓으면
- * 사용자에게는 아무 일도 일어나지 않은 것으로 보인다.
- *
- * ## 어디에 놓나 — 고른 부품 **위**다
- *
- * 전에는 언제나 바닥 한가운데였다. 첫 부품은 그 자리가 맞지만 둘째부터는 **첫 부품 속에**
- * 들어간다 — 같은 자리에 같은 크기로 놓이니 화면에는 덩어리 하나뿐이고, 저작자는 무엇이
- * 늘었는지 못 본다. 「추가하자마자 보여야 한다」는 그때 이미 깨져 있었다.
- *
- * 그래서 고른 부품이 있으면 그 부품의 **윗면**에 얹고 발자국을 가운데로 맞춘다. 기계는
- * 대개 그렇게 쌓인다(받침 → 어깨 → 팔). 관절을 걸 때도 이 자리가 필요하다 — 맞닿는 면이
- * 실제로 있어야 `seamOrigin` 이 회전 중심을 그 면에서 잡는다.
- *
- * 위에 얹으면 기준 상자를 넘는 경우에는 바닥 한가운데로 간다. 넘은 채로 놓으면 발행이
- * 막히고(`part-outside-base`), 그것을 고치는 일이 「부품을 추가했다」의 대가가 된다.
- * 가로·세로는 상자 안으로 당긴다 — 고른 부품이 가장자리에 있으면 그 위가 상자 밖이다.
- */
-export function newPart(draft, parts, primitive, onTopOf) {
-    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 = {
-        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) {
-    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, parts, primitive, onTopOf) {
-    return [...parts, newPart(draft, parts, primitive, onTopOf)];
-}
-export function removePart(parts, index) {
-    return parts.filter((_, at) => at !== index);
-}
-/** 부품을 복제한다. 이름만 새로 붙인다 — 중복되면 검증에서 걸린다. */
-export function duplicatePart(parts, index) {
-    const origin = parts[index];
-    if (!origin)
-        return parts;
-    const copy = 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, index, to) {
-    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, index, part) {
-    return parts.map((old, at) => (at === index ? part : old));
-}
-/**
- * 정밀 배치 도구 — 좌표를 손으로 계산하지 않게 한다.
- *
- * 도면 편집기는 자산을 **배치**하는 도구라 대략적인 위치로도 충분하다. 여기는 자산을
- * **만드는** 도구라 다르다. 모터를 몸통 정중앙에 놓거나, 다리를 네 귀퉁이에 대칭으로
- * 놓거나, 부품을 바닥에 정확히 붙이는 작업은 손으로 계산하면 늘 조금씩 어긋난다.
- */
-function put(parts, index, fields) {
-    const part = parts[index];
-    if (!part)
-        return parts;
-    return updatePart(parts, index, { ...part, ...fields });
-}
-/** 위치의 한 축만 바꾼다. 어느 속성인지는 `AXIS_KEYS` 가 결정한다. */
-function putAt(parts, index, axis, value) {
-    return put(parts, index, { [AXIS_KEYS[axis].at]: value });
-}
-/** 부품을 기준 상자의 해당 축 가운데로 옮긴다. */
-export function centerPart(draft, parts, index, axis) {
-    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, index, axis) {
-    return putAt(parts, index, axis, 0);
-}
-/** 부품을 상자의 끝에 붙인다. */
-export function alignPartToEnd(draft, parts, index, axis) {
-    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, parts, index, axis) {
-    const part = parts[index];
-    if (!part || !canMirror(draft, parts, index, axis))
-        return parts;
-    const copy = JSON.parse(JSON.stringify(part));
-    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, part, axis) {
-    const { at, size } = AXIS_KEYS[axis];
-    return Math.round(draftExtent(draft, axis) - part[at] - part[size]);
-}
-/**
- * 대칭이 의미가 있는지.
- *
- * 이미 그 축의 가운데에 있는 부품을 대칭하면 **같은 자리에 사본이 생긴다.** 화면에는
- * 아무 변화가 없어 보이는데 부품 수만 늘고, 겹친 면에서 z-fighting 이 일어난다.
- * 만들어 놓고 알리는 대신 미리 막는다.
- */
-export function canMirror(draft, parts, index, axis) {
-    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, parts, index) {
-    const part = parts[index];
-    if (!part)
-        return parts;
-    const step = gridStep(draft);
-    const round = (value) => 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) {
-    return niceStep(Math.max(draft.width, draft.height, draft.depth));
-}
-/**
- * 주어진 길이에 어울리는 **읽기 좋은** 격자 간격. 다섯 칸 정도가 되게 잡는다.
- *
- * 그냥 나누면 27·33 같은 값이 나온다. 그 격자에 맞추면 좌표가 54·81 이 되어 읽기
- * 어렵다. 1·2·5 배수로 올림한다 — 자와 차트 눈금이 쓰는 방식이다.
- *
- * 격자가 성겨야 형상이 눈에 먼저 들어온다. 열 칸으로 잡았더니 격자가 촘촘해 배경이
- * 먼저 보였다.
- */
-export function niceStep(span) {
-    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);
-}
-//# sourceMappingURL=part-edits.js.map