@things-factory/figure-ui 10.1.65 → 10.1.67

package/test/part-edits.test.ts

@@ -1,350 +0,0 @@
-import assert from 'node:assert/strict'
-import { describe, it, test } from 'node:test'
-import { readFileSync } from 'node:fs'
-import { fileURLToPath } from 'node:url'
-
-import { expect } from './expect.ts'
-
-import {
-  addPart,
-  alignPartToEnd,
-  alignPartToStart,
-  canMirror,
-  centerPart,
-  duplicatePart,
-  gridStep,
-  mirrorPart,
-  movePart,
-  newPart,
-  niceStep,
-  partLimit,
-  removePart,
-  roundPart,
-  snapPart,
-  updatePart
-} from '../client/modeller/part-edits.ts'
-import { toFigureSource } from '../dist-client/modeller/figure-source.js'
-import type { FigureDraft, PartModel } from '../dist-client/modeller/figure-source.js'
-import { validate } from '@hatiolab/figure-model'
-
-/**
- * 씬 모델 용어로 부품을 편집하는 규칙.
- *
- * 편집 중의 기준 데이터는 씬 모델이므로 편집도 씬의 용어로 한다. 그런데 저장되는 것은
- * FigureSource 다. 그래서 두 가지를 확인한다 — **씬 용어에서 규칙이 맞는지**, 그리고
- * **변환했을 때 검증을 통과하는지**. 앞의 것만 보면 화면에서는 멀쩡한데 저장이 거부되는
- * 상황이 생긴다.
- */
-
-/** 기준 상자 3000 x 2000 x 800 — 세 축이 모두 달라야 축을 바꿔 써도 테스트가 잡아낸다. */
-const DRAFT: FigureDraft = {
-  width: 3000,
-  height: 2000,
-  depth: 800,
-  figureType: 'AGV',
-  detailLevel: 'L'
-}
-
-const DECK: PartModel = {
-  type: 'figure-part',
-  name: 'deck',
-  primitive: 'cube',
-  left: 1200,
-  top: 900,
-  width: 800,
-  height: 600,
-  zPos: 500,
-  depth: 200,
-  token: 'palette.primary'
-}
-
-/*
- * 기즈모에서 온 숫자.
- *
- * 화면에서 끌면 씬이 비율을 곱한 값을 돌려준다. 그 값이 그대로 부품에 들어가면 저장 형식에
- * 소수 넷째 자리가 남고, 크기 칸은 잘려서 보인다.
- */
-describe('씬에서 온 부품을 밀리미터로 맞춘다', () => {
-  const part = (over: Partial<PartModel> = {}): PartModel => ({ ...DECK, ...over })
-
-  it('끈 크기와 자리를 정수로 맞춘다', () => {
-    const dragged = part({ left: 384.99999999999994, top: 380, zPos: 930, width: 368.98743869823886, height: 140, depth: 722.4180046035418 })
-    const fixed = roundPart(dragged)
-
-    expect(fixed.left).toBe(385)
-    expect(fixed.width).toBe(369)
-    expect(fixed.depth).toBe(722)
-    expect(fixed.top).toBe(380)
-  })
-
-  it('크기는 1 밑으로 안 내려간다 — 0 이면 부피가 사라지고 배율이 0 으로 나뉜다', () => {
-    const tiny = roundPart(part({ width: 0.2, height: 0.4, depth: 0 }))
-    expect(tiny.width).toBe(1)
-    expect(tiny.height).toBe(1)
-    expect(tiny.depth).toBe(1)
-  })
-
-  it('맞춘 값을 다시 맞춰도 같다', () => {
-    const once = roundPart(part({ left: 12.5, width: 7.5 }))
-    expect(roundPart(once)).toEqual(once)
-  })
-
-  it('크기·자리 밖의 값은 건드리지 않는다', () => {
-    const kept = roundPart(part({ name: 'arm', token: 'palette.dark', segments: 12, zPos: 3.4 }))
-    expect(kept.name).toBe('arm')
-    expect(kept.token).toBe('palette.dark')
-    expect(kept.segments).toBe(12)
-    expect(kept.zPos).toBe(3)
-  })
-})
-
-describe('부품 생성', () => {
-  it('기준 상자의 3분의 1 크기로 생성된다 — 추가하자마자 보여야 한다', () => {
-    const part = newPart(DRAFT, [], 'cube')
-
-    expect(part.width).toBe(1000)
-    expect(part.height).toBe(667)
-    expect(part.depth).toBe(267)
-  })
-
-  it('바닥 가운데에 놓인다', () => {
-    const part = newPart(DRAFT, [], 'cube')
-
-    expect(part.zPos).toBe(0)
-    // 위치도 크기도 정수로 맞추므로 0.5 까지는 어긋난다
-    expect(Math.abs(part.left + part.width / 2 - DRAFT.width / 2)).toBeLessThanOrEqual(0.5)
-    expect(Math.abs(part.top + part.height / 2 - DRAFT.height / 2)).toBeLessThanOrEqual(0.5)
-  })
-
-  it('편집 캔버스에 그대로 놓을 수 있는 씬 컴포넌트 타입을 갖는다', () => {
-    expect(newPart(DRAFT, [], 'cube').type).toBe('figure-part')
-  })
-
-  it('이름이 중복되지 않는다 — 저장되는 식별자다', () => {
-    let parts: PartModel[] = []
-    for (let i = 0; i < 3; i++) parts = addPart(DRAFT, parts, 'cube')
-
-    expect(parts.map(part => part.name)).toEqual(['cube', 'cube-2', 'cube-3'])
-  })
-
-  it('팔레트 토큰을 기존 부품에서 물려받는다 — 토큰이 늘면 재질 그룹이 하나씩 는다', () => {
-    const parts = addPart(DRAFT, [{ ...DECK, token: 'palette.dark' }], 'sphere')
-    expect(parts[1].token).toBe('palette.dark')
-  })
-
-  it('곡면 도형은 분할 수를 갖고 생성된다', () => {
-    expect(newPart(DRAFT, [], 'cylinder').segments).toBe(12)
-    expect(newPart(DRAFT, [], 'cube').segments).toBeUndefined()
-  })
-
-  it('polygon 은 삼각형으로 생성된다 — 점이 3개보다 적으면 검증에서 막힌다', () => {
-    expect(newPart(DRAFT, [], 'polygon').path).toHaveLength(3)
-  })
-
-  /*
-   * 둘째 부품이 어디에 서는가.
-   *
-   * 언제나 바닥 한가운데였을 때, 둘째 부품은 첫 부품 **속에** 들어갔다 — 같은 자리에 같은
-   * 크기라 화면에는 덩어리 하나뿐이고 저작자는 무엇이 늘었는지 못 봤다.
-   */
-  describe('고른 부품 위에 얹는다', () => {
-    /* 갑판을 바닥에 내려 둔다 — 그 위에 3분의 1 짜리가 들어가야 얹는 갈래를 볼 수 있다. */
-    const FLOOR_DECK = { ...DECK, zPos: 0 }
-
-    it('윗면에 서고 발자국이 가운데로 맞는다', () => {
-      const part = newPart(DRAFT, [FLOOR_DECK], 'cube', FLOOR_DECK)
-
-      expect(part.zPos).toBe(FLOOR_DECK.zPos + FLOOR_DECK.depth)
-      // 자리도 크기도 정수로 맞추므로 0.5 까지는 어긋난다
-      const middle = { x: FLOOR_DECK.left + FLOOR_DECK.width / 2, y: FLOOR_DECK.top + FLOOR_DECK.height / 2 }
-      expect(Math.abs(part.left + part.width / 2 - middle.x)).toBeLessThanOrEqual(0.5)
-      expect(Math.abs(part.top + part.height / 2 - middle.y)).toBeLessThanOrEqual(0.5)
-    })
-
-    it('얹으면 상자를 넘을 때는 바닥 한가운데로 간다 — 추가가 발행을 막지 않는다', () => {
-      /* 갑판이 이미 높다: 500 + 200 위에 267 을 더 쌓으면 상자 높이 800 을 넘는다. */
-      const part = newPart(DRAFT, [DECK], 'cube', DECK)
-
-      expect(part.zPos).toBe(0)
-      expect(Math.abs(part.left + part.width / 2 - DRAFT.width / 2)).toBeLessThanOrEqual(0.5)
-    })
-
-    it('가장자리 부품 위에서도 상자 안에 남는다', () => {
-      const corner = { ...DECK, left: 0, top: 0, width: 200, height: 200, zPos: 0, depth: 100 }
-      const part = newPart(DRAFT, [corner], 'cube', corner)
-
-      expect(part.left).toBe(0)
-      expect(part.top).toBe(0)
-      expect(part.left + part.width).toBeLessThanOrEqual(DRAFT.width)
-      expect(part.top + part.height).toBeLessThanOrEqual(DRAFT.height)
-    })
-
-    it('고른 것이 없으면 전과 같이 바닥 한가운데다', () => {
-      const alone = newPart(DRAFT, [DECK], 'cube')
-      expect(alone.zPos).toBe(0)
-      expect(Math.abs(alone.left + alone.width / 2 - DRAFT.width / 2)).toBeLessThanOrEqual(0.5)
-    })
-
-    it('쌓은 둘이 서로 겹치지 않는다 — 이 규칙이 지키는 것이 그것이다', () => {
-      const [, stacked] = addPart(DRAFT, [FLOOR_DECK], 'cylinder', FLOOR_DECK)
-      expect(stacked!.zPos).toBeGreaterThanOrEqual(FLOOR_DECK.zPos + FLOOR_DECK.depth)
-    })
-  })
-
-  /*
-    화면에서 멀쩡해 보여도 저장이 거부되면 사용자는 이유를 알 수 없다. 새로 만든 부품은
-    손대지 않은 상태로도 검증을 통과해야 한다.
-  */
-  it('새로 만든 부품만으로도 검증을 통과한다', () => {
-    for (const kind of ['cube', 'wall', 'cylinder', 'sphere', 'rect', 'polygon'] as const) {
-      const source = toFigureSource(DRAFT, [newPart(DRAFT, [], kind)])
-      expect(validate(source).errors).toEqual([])
-    }
-  })
-})
-
-describe('목록 편집', () => {
-  const PARTS = [DECK, { ...DECK, name: 'mast' }, { ...DECK, name: 'wheel' }]
-
-  it('삭제한 것만 빠진다', () => {
-    expect(removePart(PARTS, 1).map(part => part.name)).toEqual(['deck', 'wheel'])
-  })
-
-  it('복제본이 바로 뒤에 오고 이름이 새로 붙는다', () => {
-    const next = duplicatePart(PARTS, 0)
-    expect(next.map(part => part.name)).toEqual(['deck', 'deck-copy', 'mast', 'wheel'])
-  })
-
-  it('복제본이 원본과 객체를 공유하지 않는다 — 수정하면 따로 움직여야 한다', () => {
-    const next = duplicatePart([{ ...DECK, path: [{ x: 0, y: 0 }] }], 0)
-    next[1].path![0].x = 99
-
-    expect(next[0].path![0].x).toBe(0)
-  })
-
-  it('순서를 바꾼다', () => {
-    expect(movePart(PARTS, 2, 0).map(part => part.name)).toEqual(['wheel', 'deck', 'mast'])
-  })
-
-  it('범위를 벗어나면 그대로 둔다', () => {
-    expect(movePart(PARTS, 0, -1)).toBe(PARTS)
-    expect(movePart(PARTS, 2, 3)).toBe(PARTS)
-  })
-
-  it('원본을 수정하지 않는다', () => {
-    const before = JSON.stringify(PARTS)
-    removePart(PARTS, 0)
-    duplicatePart(PARTS, 0)
-    updatePart(PARTS, 0, { ...DECK, left: 0 })
-
-    expect(JSON.stringify(PARTS)).toBe(before)
-  })
-
-  it('부품 수 한도는 디테일 등급이 결정한다', () => {
-    expect(partLimit({ ...DRAFT, detailLevel: 'S' })).toBeLessThan(partLimit({ ...DRAFT, detailLevel: 'L' }))
-  })
-})
-
-/*
-  정밀 배치 도구.
-
-  씬 모델은 원점이 **모서리**다(left·top 이 0 에서 시작하고 zPos 는 밑면이다).
-  FigureSource 는 원점이 중심이다. 이전 구현은 FigureSource 기준이라 '가운데로'가 곧
-  '0 으로'였는데, 씬 용어에서는 그렇지 않다 — 이 절이 그 차이를 확인한다.
-*/
-describe('정밀 배치 도구', () => {
-  it('가운데로 옮기면 변환했을 때 원점에 온다', () => {
-    const moved = centerPart(DRAFT, [{ ...DECK, left: 0 }], 0, 'x')
-
-    expect(moved[0].left).toBe(1100)
-    expect(toFigureSource(DRAFT, moved).parts[0].transform.position.x).toBe(0)
-  })
-
-  it('축마다 다른 속성을 바꾼다 — z 는 top 이고 y 는 zPos 다', () => {
-    expect(centerPart(DRAFT, [DECK], 0, 'z')[0].top).toBe(700)
-    expect(centerPart(DRAFT, [DECK], 0, 'y')[0].zPos).toBe(300)
-  })
-
-  it('바닥에 붙이면 zPos 가 0 이다 — 밑면이 곧 상자 바닥이다', () => {
-    expect(alignPartToStart([DECK], 0, 'y')[0].zPos).toBe(0)
-  })
-
-  it('끝에 붙이면 부품의 끝이 상자의 끝과 만난다', () => {
-    const moved = alignPartToEnd(DRAFT, [DECK], 0, 'x')
-    expect(moved[0].left + moved[0].width).toBe(DRAFT.width)
-  })
-
-  it('대칭 복제가 상자 안에서 반대쪽으로 간다', () => {
-    const parts = mirrorPart(DRAFT, [{ ...DECK, left: 200 }], 0, 'x')
-
-    expect(parts).toHaveLength(2)
-    // 왼쪽 여백 200 → 오른쪽 여백도 200 이어야 한다
-    expect(parts[1].left).toBe(DRAFT.width - 200 - DECK.width)
-  })
-
-  it('대칭 복제본이 어느 쪽인지 이름에 드러난다', () => {
-    expect(mirrorPart(DRAFT, [{ ...DECK, left: 200 }], 0, 'x')[1].name).toBe('deck-x')
-  })
-
-  it('대칭 복제가 원본을 건드리지 않는다', () => {
-    const parts = mirrorPart(DRAFT, [{ ...DECK, left: 200 }], 0, 'x')
-    expect(parts[0].left).toBe(200)
-  })
-
-  /*
-    이미 가운데면 사본이 같은 자리에 생긴다. 화면에는 아무 변화가 없어 보이는데 부품 수만
-    늘고 겹친 면에서 z-fighting 이 일어난다.
-  */
-  it('이미 가운데면 대칭 복제를 막는다', () => {
-    const centered = centerPart(DRAFT, [DECK], 0, 'x')
-
-    expect(canMirror(DRAFT, centered, 0, 'x')).toBe(false)
-    expect(mirrorPart(DRAFT, centered, 0, 'x')).toHaveLength(1)
-  })
-
-  it('가운데가 아니면 대칭 복제할 수 있다', () => {
-    expect(canMirror(DRAFT, [{ ...DECK, left: 200 }], 0, 'x')).toBe(true)
-  })
-
-  it('격자에 맞추면 위치와 크기가 격자 배수가 된다', () => {
-    const step = gridStep(DRAFT)
-    const snapped = snapPart(DRAFT, [{ ...DECK, left: 1213, width: 787 }], 0)
-
-    expect(snapped[0].left % step).toBe(0)
-    expect(snapped[0].width % step).toBe(0)
-  })
-
-  it('격자에 맞춰도 크기가 0 이 되지 않는다 — 사라진 것처럼 보인다', () => {
-    const snapped = snapPart(DRAFT, [{ ...DECK, width: 1, height: 1, depth: 1 }], 0)
-
-    expect(snapped[0].width).toBeGreaterThan(0)
-    expect(snapped[0].height).toBeGreaterThan(0)
-    expect(snapped[0].depth).toBeGreaterThan(0)
-  })
-
-  it('없는 인덱스를 주면 목록을 그대로 반환한다', () => {
-    const parts = [DECK]
-    expect(centerPart(DRAFT, parts, 7, 'x')).toBe(parts)
-    expect(snapPart(DRAFT, parts, 7)).toBe(parts)
-    expect(mirrorPart(DRAFT, parts, 7, 'x')).toBe(parts)
-    expect(canMirror(DRAFT, parts, 7, 'x')).toBe(false)
-  })
-})
-
-describe('격자 간격', () => {
-  it('읽기 좋은 값이 나온다 — 27·33 같은 간격은 좌표를 읽을 수 없게 만든다', () => {
-    expect(niceStep(3000)).toBe(500)
-    expect(niceStep(1000)).toBe(200)
-    expect(niceStep(137)).toBe(20)
-    expect(niceStep(4)).toBe(1)
-  })
-
-  it('아무리 작아도 0 이 되지 않는다 — 0 으로 나누면 NaN 이 된다', () => {
-    expect(niceStep(0)).toBeGreaterThan(0)
-    expect(niceStep(-100)).toBeGreaterThan(0)
-  })
-
-  it('기준 상자의 긴 쪽을 기준으로 잡는다 — 3D 바닥 격자와 같아야 한다', () => {
-    expect(gridStep(DRAFT)).toBe(niceStep(3000))
-  })
-})