@things-factory/figure-ui 10.1.43 → 10.1.45

package/client/modeller/figure-thumbnail.ts

@@ -1,123 +0,0 @@
-import './figure-canvas.js'
-
-import type { FigureDraft, PartModel } from './figure-source.js'
-
-/**
- * 카드에 쓸 그림을 찍는다 — **숨은 자리에 저작 캔버스를 하나 더 세워서.**
- *
- * ## 왜 보이는 캔버스를 찍지 않나
- *
- * 저작면의 캔버스는 저작자가 돌려 둔 각도와 확대로 서 있고, 칸의 비율도 창 크기와 접힌 패널에 따라
- * 다르다. 그것을 찍으면 카드마다 프레임이 달라지고, 방금 확대해 보던 나사 하나가 그 자산의 얼굴이
- * 된다. 목록은 견주는 자리이므로 그림은 **정해진 크기와 정해진 카메라**로 찍는다.
- *
- * ## 왜 씬을 여기서 세우지 않고 부품을 세우나
- *
- * 씬 값(환경 · 하늘 · 조명 · 픽셀 비율 · 좌표 바탕)은 `figure-canvas` 가 든다. 여기서 다시 적으면
- * 두 벌이 되고, 그러면 **카드에 보이는 그림과 저작면에서 보던 것이 아무 오류 없이 갈린다.** 그래서
- * 같은 부품을 `viewOnly` 로 하나 더 세워 그 부품이 자기 씬을 세우게 하고, 찍은 뒤 버린다.
- *
- * ## 왜 서버가 아니라 브라우저인가
- *
- * 도면은 저장할 때 서버가 찍는데, 백엔드에 GPU 가 없는 배포가 많아 헤드리스로 3D 를 찍는 것이 자주
- * 실패한다. 도형을 그릴 GPU 는 이미 보는 사람 손에 있다.
- */
-
-/** 카드는 4:3 이다. */
-const WIDTH = 480
-const HEIGHT = 360
-
-interface Shooter extends HTMLElement {
-  draft?: FigureDraft
-  parts?: PartModel[]
-  viewOnly?: boolean
-  snapshot?: (width?: number, height?: number) => Promise<string | undefined>
-}
-
-/**
- * 씬이 서고 카메라가 자리를 잡을 틈 — 프레임 두 장 뒤에 한 번 더 쉰다. 씬에 그 신호가 없다.
- *
- * **rAF 만 기다리면 안 된다.** 탭이 뒤로 가거나 창이 가려지면 브라우저가 rAF 를 멈추고, 그러면
- * 이 약속이 영원히 안 풀린다. 그 위에 저장이 얹혀 있어서 저장이 통째로 멈췄다 — 단추는 잠긴 채로,
- * 아무 말도 없이. [확인함] 2026-09-10 포커스 없는 탭에서 `saving: true` 로 고정.
- *
- * 그래서 시계와 함께 경주시킨다. 늦게 깨어난 쪽은 버려지고, 화면이 안 그려지는 상황이면 아래
- * `snapshot` 이 빈 것을 돌려주거나 시간이 다 된다 — 어느 쪽이든 **저장은 계속 간다.**
- */
-function settle(): Promise<void> {
-  const frames = new Promise<void>(resolve =>
-    requestAnimationFrame(() => requestAnimationFrame(() => setTimeout(resolve, 150)))
-  )
-
-  return Promise.race([frames, delay(600)])
-}
-
-function delay(ms: number): Promise<void> {
-  return new Promise(resolve => setTimeout(resolve, ms))
-}
-
-/**
- * 그림을 기다리는 시간의 한도.
- *
- * 3D 를 세워 한 장 찍는 데 걸리는 시간은 형상과 기계에 따라 다르지만, 이 한도의 목적은 빠르기가
- * 아니라 **저장이 멈추지 않는 것**이다. 넘으면 그림 없이 저장한다 — 정본이 그림보다 중하고,
- * 그림은 다음에 저작면을 열 때 다시 채운다(`figure-modeller-page` 의 fillThumbnail).
- */
-const PATIENCE = 5000
-
-/** 시간이 다 되면 없는 것으로 답한다. 던지지 않는다 — 그림이 없는 것은 실패가 아니다. */
-function within<T>(work: Promise<T>, ms: number): Promise<T | undefined> {
-  return Promise.race([work, delay(ms).then(() => undefined)])
-}
-
-export async function captureThumbnail(
-  draft: FigureDraft | undefined,
-  parts: PartModel[]
-): Promise<string | undefined> {
-  if (!draft || !parts.length) {
-    return undefined
-  }
-
-  /*
-    화면 밖에 둔다. `display: none` 이면 캔버스가 크기를 못 얻어 아무것도 그리지 못한다.
-    WebGL context 는 브라우저가 8~16개에서 끊으므로 찍은 뒤 반드시 버린다(아래 finally).
-  */
-  const host = document.createElement('div')
-  host.setAttribute('figure-thumbnail-stage', '')
-  host.style.cssText = `position: fixed; left: -10000px; top: 0; width: ${WIDTH}px; height: ${HEIGHT}px; pointer-events: none;`
-  document.body.appendChild(host)
-
-  const shooter = document.createElement('figure-canvas') as Shooter
-  shooter.viewOnly = true
-  shooter.draft = draft
-  shooter.parts = parts
-  shooter.style.cssText = 'display: block; width: 100%; height: 100%;'
-
-  try {
-    host.appendChild(shooter)
-
-    /*
-      **한도 안에 못 찍으면 그림 없이 간다.** 이 함수를 부르는 자리가 저장이고, 저장은 그림을
-      기다리다 멈춰서는 안 된다. 못 찍은 것은 조용히 넘기지 않고 콘솔에 남긴다 — 그림이 계속
-      안 생기면 그 줄이 단서가 된다.
-    */
-    const shot = await within(
-      (async () => {
-        await settle()
-        return shooter.snapshot ? await shooter.snapshot(WIDTH, HEIGHT) : undefined
-      })(),
-      PATIENCE
-    )
-
-    if (!shot) {
-      console.warn(`[thumbnail] ${PATIENCE}ms 안에 못 찍었습니다 — 그림 없이 저장합니다`)
-    }
-
-    return shot
-  } catch (e) {
-    console.warn(`[thumbnail] 세우지 못했습니다 — ${(e as Error).message}`)
-    return undefined
-  } finally {
-    host.remove()
-  }
-}

package/client/modeller/figure-view.ts

@@ -1,152 +0,0 @@
-/**
- * 저작 화면의 **보기 설정**.
- *
- * ## 저장되지 않는다
- *
- * 이것은 자산이 아니라 **작업대**다. 조명을 밝게 하고 바닥을 켠 것은 그 사람이 지금
- * 보기 편한 상태일 뿐, 그 자산의 성질이 아니다. 그래서 `FigureSource` 에 안 들어간다 —
- * `toFigureSource` 는 판에서 `width` · `height` · `depth` 와 몇 가지만 집어 가고 나머지는
- * 버린다.
- *
- * 다른 사람이 같은 자산을 열면 자기 설정으로 본다. 그것이 맞다.
- *
- * ## 씬이 아는 이름을 그대로 쓴다
- *
- * 여기 이름은 전부 `model-layer` 의 상태 이름이다. 옮겨 적는 표를 두지 않는다 — 표를
- * 두면 씬이 새 설정을 받아도 이쪽이 모른다.
- *
- * 값이 바뀌면 씬이 스스로 반영한다(`three-capability` 의 `onchange`). 다만 `grid` 는
- * 한동안 3D 를 세울 때만 읽혔다 — things-scene 10.1.5 에서 고쳤다.
- */
-export interface ViewSettings {
-  /**
-   * 어떤 도면에 놓인 것으로 보나 — 씬 전체의 좌표 모드.
-   *
-   * **도형의 `placement` 와 다른 것이다.** 도형의 것은 「이 종류는 바닥에 서나, 천장에
-   * 매달리나」이고, 이것은 「지금 보고 있는 도면이 어느 쪽을 기준으로 재나」다. 바닥
-   * 기준 도면에 천정 기반 OHT 를 놓으면 도면은 안 뒤집히고 OHT 가 천장 높이에 매달린다.
-   *
-   * 한동안 도형의 `placement` 를 이 자리에 흘려 넣었다. 모델러에 도형이 하나뿐이라
-   * 그럴듯해 보였지만, 그러면 도형의 성질이 씬 전체를 뒤집는다 — 도면에서는 성립할 수가
-   * 없고(도면에는 도형이 여럿이다), 저작 중에는 배치를 고를 때마다 저작자가 적어 둔
-   * 높이가 전부 다른 숫자로 보였다.
-   *
-   * 씬의 낱말 그대로다: `floor` 바닥 기준 · `space` 중심 기준(바닥 없음) · `inverted`
-   * 천장 기준. **미리보기에만 먹인다** — 편집 캔버스의 `zPos` 는 저작자가 직접 적는
-   * 숫자라 그 뜻이 보기 설정에 따라 바뀌면 안 된다.
-   */
-  placement: 'floor' | 'space' | 'inverted'
-  /**
-   * 천장 높이 (mm). 천정 기반 도형을 미리보기에서 어디에 매달 것인가.
-   *
-   * 도형은 제가 놓일 방의 높이를 모른다. 도면은 알지만 미리보기에는 도면이 없으므로,
-   * 저작자가 가정할 값을 여기서 정한다.
-   */
-  ceilingHeight: number
-  /** 좌표 바탕(축 가이드). 원점과 눈금을 보인다. */
-  grid: boolean
-  /** 축 이름표(X · Y · Z). 눈금만 두고 글자를 끌 수 있다. */
-  gridLabels: boolean
-  /** 판의 바닥면. 좌표 바탕과 겹치므로 기본은 끈다. */
-  floor: boolean
-  /** Environment — 반사(IBL). 금속 재질이 무엇을 비출지 정한다. */
-  environment: EnvironmentName
-  /** Sky Color — 배경색. */
-  skyColor: string
-  /** Key Light Intensity. */
-  dirLightIntensity: number
-  /** Key Light — Follow Camera. 끄면 그림자 방향이 고정된다. */
-  dirLightFollowCamera: boolean
-  /** Key Light — Cast Shadow. */
-  dirShadowEnabled: boolean
-  /** Hemisphere Light Intensity — 그늘진 면을 들어올린다. */
-  hemiIntensity: number
-}
-
-/**
- * 환경 프리셋 — **`scene-manager` 의 `SkyPreset` 과 같은 여덟이다.**
- *
- * 한동안 다섯만 적었다. 씬은 여덟을 다 받는데 이쪽이 셋을 몰라서 고를 수 없었다.
- * operato-board 의 3D 씬 속성 패널도 같은 여덟을 보인다.
- */
-export const ENVIRONMENTS = [
-  'studio',
-  'warehouse',
-  'factory',
-  'office',
-  'home',
-  'sunny',
-  'cloudy',
-  'rainy'
-] as const
-export type EnvironmentName = (typeof ENVIRONMENTS)[number]
-
-/**
- * 씬에 그대로 넣는 보기 설정 — **좌표 기준과 천장 높이는 빼고.**
- *
- * 나머지는 전부 `model-layer` 의 상태 이름이라 그대로 넣으면 씬이 알아서 반응한다.
- * 그런데 `placement` 는 편집 캔버스에 들어가면 안 되고(거기는 늘 상자 기준이다),
- * `ceilingHeight` 는 씬이 모르는 이름이다.
- *
- * **rest spread 로 넘기지 않으려고 이 함수가 있다.** 캔버스가 한동안
- * `const { grid, ..., ...light } = view` 로 나머지를 통째로 넘겼는데, 그러면 설정을
- * 하나 더할 때마다 그것이 두 화면에 **말없이** 실린다. 새로 더한 좌표 기준이 바로
- * 그 길로 캔버스에 들어갈 뻔했다.
- */
-export function sceneLook(view: ViewSettings): Record<string, unknown> {
-  const { placement, ceilingHeight, ...look } = view
-  return look
-}
-
-/**
- * 씬의 좌표 기준 — **씬의 낱말 그대로 셋이다.**
- *
- * 형식의 `floor` · `center` · `ceiling` 과 짝이 맞지만 철자가 다르다. 옮겨 적는 표를 두지
- * 않는 것이 이 파일의 규칙이므로 씬 쪽을 쓴다. 화면에는 둘 다 보인다 — 「천장 기준
- * (inverted)」.
- */
-export const SCENE_REFERENCES = ['floor', 'space', 'inverted'] as const
-
-/** 배경색 기본값. 회색이라 부품 색이 제 색으로 보인다. */
-export const WORKBENCH = '#7c7c7c'
-
-/**
- * 처음 값.
- *
- * **지금 저작 화면이 실제로 쓰던 값 그대로다.** 설정을 만들면서 화면이 달라지면
- * 무엇이 설정 때문이고 무엇이 원래 그랬는지 갈리지 않는다.
- */
-export const DEFAULT_VIEW: ViewSettings = {
-  placement: 'floor',
-  /* 공장 천장의 흔한 높이. 반도체 fab 의 OHT 레일이 대체로 이 언저리다. */
-  ceilingHeight: 4000,
-  grid: true,
-  gridLabels: true,
-  floor: false,
-  environment: 'studio',
-  skyColor: WORKBENCH,
-  dirLightIntensity: 2.0,
-  dirLightFollowCamera: true,
-  dirShadowEnabled: true,
-  hemiIntensity: 4.0
-}
-
-/**
- * How tall the preview board is: enough room for the tallest instance where the figure actually stands.
- *
- * A floor or center figure stands on the floor, so the tallest instance is the whole height. Only a
- * ceiling figure needs the room up to the ceiling. The board used to reach the ceiling for every figure,
- * which made a 920 tall AGV preview 4400 tall.
- *
- * This is an envelope, not a placement rule: where each instance goes is still the scene's
- * (`FigureRealObject.effectiveZPos`), and the camera fits what the scene drew.
- */
-export function previewBoardDepth(
-  figure: { placement?: 'floor' | 'ceiling' | 'center'; base: { y: number } },
-  ceilingHeight: number,
-  factor: number
-): number {
-  const tallest = figure.base.y * factor
-  const reach = figure.placement === 'ceiling' ? Math.max(ceilingHeight, tallest) : tallest
-  return Math.round(reach * 1.1)
-}

package/client/modeller/joint-edits.ts

@@ -1,262 +0,0 @@
-/*
- * Copyright © HatioLab Inc. All rights reserved.
- */
-
-import type { FigureJoint, FigurePart, JointType, Vec3 } from '@hatiolab/figure-model'
-
-import type { FigureDraft, PartModel } from './figure-source.js'
-
-/**
- * Editing joints and parents (ADR-0066). Pure functions over the draft and the part list, so the inspector
- * only renders and dispatches.
- *
- * A joint is always created together with the parameter that drives it. Values reach a joint only through
- * `parameters`, and the preview draws a slider per parameter, so a joint without one could be defined but
- * never seen moving.
- */
-
-type Parameter = NonNullable<FigureDraft['parameters']>[number]
-
-/** The limits a new joint starts with. Revolute in degrees, prismatic in millimetres. */
-const NEW_LIMITS: Record<Exclude<JointType, 'continuous'>, { min: number; max: number }> = {
-  revolute: { min: -90, max: 90 },
-  prismatic: { min: 0, max: 500 }
-}
-
-/** The span a parameter driving a continuous joint offers: one turn either way. */
-const CONTINUOUS_SPAN = { min: -360, max: 360 }
-
-/** The joint whose child is this part, if any. */
-export function jointOf(draft: FigureDraft | undefined, part: string): FigureJoint | undefined {
-  return draft?.joints?.find(joint => joint.child === part)
-}
-
-/**
- * Parts a part may be attached to: every other part except itself and anything attached below it, since
- * either would close a loop the format refuses (`parent-cycle`).
- */
-export function parentChoices(parts: readonly PartModel[], part: string): string[] {
-  const below = new Set<string>([part])
-  let grew = true
-  while (grew) {
-    grew = false
-    for (const one of parts) {
-      if (one.parent !== undefined && below.has(one.parent) && !below.has(one.name)) {
-        below.add(one.name)
-        grew = true
-      }
-    }
-  }
-  return parts.map(one => one.name).filter(name => !!name && !below.has(name))
-}
-
-type Span = { min: number; max: number }
-
-/** 한 축에서 부품이 차지하는 구간. */
-const reachOf = (part: FigurePart, axis: 'x' | 'y' | 'z'): Span => ({
-  min: part.transform.position[axis] - part.transform.size[axis] / 2,
-  max: part.transform.position[axis] + part.transform.size[axis] / 2
-})
-
-/**
- * 새 관절이 설 자리 — **부품이 붙은 부품과 맞닿는 면의 한가운데.**
- *
- * 경첩은 두 부품이 닿는 자리에 있다. 팔꿈치는 윗팔과 앞팔이 만나는 곳이고, 문은 문틀에 닿는
- * 모서리에 있다. 그래서 처음 값은 그 자리여야 한다.
- *
- * 한동안 **부품 아랫면 한가운데**를 썼다. 위로 쌓는 부품에는 맞는 자리인데(로봇 팔이 그렇다),
- * 옆에 달린 부품에는 틀린다 — 캐비닛 옆에 달린 문의 축이 문 바닥에 생긴다. 저작자는 그것을
- * 화면에서 보고 손으로 옮겨야 했고, 어디로 옮길지는 두 부품의 치수를 머릿속에서 빼야 나왔다.
- *
- * **가장 벌어진 축이 맞닿는 축이다.** 두 상자가 겹치는 축에서는 뺀 값이 음수이고, 마주 보는
- * 축에서만 0 이나 양수가 된다. 나머지 두 축은 겹치는 구간의 한가운데를 쓴다 — 문의 축은 문
- * 높이의 한가운데에 있지 위아래 끝에 있지 않다.
- *
- * 붙은 부품이 없으면(Figure 틀에 직접 붙는다) 아랫면 한가운데다. 그때 맞닿는 것은 바닥이다.
- *
- * ⚠ 부품의 제 회전은 보지 않는다. 비스듬히 세운 부품에서는 축에 나란한 상자로 셈한 자리가
- * 나오고, 그것은 **처음 값**이다 — 저작자가 옮길 수 있고, 화면의 부채꼴이 어디인지 보여 준다.
- */
-export function seamOrigin(part: FigurePart, parent?: FigurePart): Vec3 {
-  const { position, size } = part.transform
-  if (!parent) return { x: position.x, y: position.y - size.y / 2, z: position.z }
-
-  const axes = ['x', 'y', 'z'] as const
-  const gaps = axes.map(axis => {
-    const mine = reachOf(part, axis)
-    const theirs = reachOf(parent, axis)
-    return { axis, gap: Math.max(mine.min - theirs.max, theirs.min - mine.max), mine, theirs }
-  })
-
-  const meeting = gaps.reduce((widest, one) => (one.gap > widest.gap ? one : widest))
-  const origin = { x: position.x, y: position.y, z: position.z }
-
-  for (const { axis, mine, theirs } of gaps) {
-    if (axis === meeting.axis) {
-      /* 맞닿는 면은 **내 면**이다. 부모 쪽 면을 쓰면 둘 사이가 벌어져 있을 때 축이 허공에 선다. */
-      origin[axis] = mine.min >= theirs.max ? mine.min : mine.max
-      continue
-    }
-    const from = Math.max(mine.min, theirs.min)
-    const to = Math.min(mine.max, theirs.max)
-    origin[axis] = from <= to ? (from + to) / 2 : position[axis]
-  }
-
-  return { x: round4(origin.x), y: round4(origin.y), z: round4(origin.z) }
-}
-
-const round4 = (value: number) => Math.round(value * 10000) / 10000
-
-function freeName(taken: Iterable<string>, stem: string): string {
-  const used = new Set(taken)
-  if (!used.has(stem)) return stem
-  for (let n = 2; ; n++) if (!used.has(`${stem}-${n}`)) return `${stem}-${n}`
-}
-
-/** The span the driving parameter offers for a joint: its limits, or one turn either way when it has none. */
-function spanOf(joint: FigureJoint): { min: number; max: number } {
-  return joint.limits ?? CONTINUOUS_SPAN
-}
-
-function drivingParameter(joint: FigureJoint): Parameter {
-  const span = spanOf(joint)
-  return {
-    name: joint.name,
-    range: { unit: joint.type === 'prismatic' ? 'mm' : 'deg', min: span.min, max: span.max },
-    default: 0,
-    clip: {
-      channels: [
-        {
-          target: joint.name,
-          keys: [
-            { at: 0, value: span.min },
-            { at: 1, value: span.max }
-          ]
-        }
-      ]
-    }
-  }
-}
-
-/**
- * Whether a parameter is the plain one `setJointType` made for a joint: one channel on that joint, keys at
- * 0 and 1 spanning the given limits. Only such a parameter follows the joint when its limits or type change;
- * one the author reshaped is left as written.
- */
-function isPlainDriver(parameter: Parameter, joint: FigureJoint, span: { min: number; max: number }): boolean {
-  const channels = parameter.clip?.channels ?? []
-  if (channels.length !== 1) return false
-  const [channel] = channels
-  if (channel!.target !== joint.name || channel!.path !== undefined) return false
-  const keys = channel!.keys as { at: number; value: number }[]
-  return (
-    keys.length === 2 &&
-    keys[0]!.at === 0 &&
-    keys[1]!.at === 1 &&
-    keys[0]!.value === span.min &&
-    keys[1]!.value === span.max &&
-    parameter.range?.min === span.min &&
-    parameter.range?.max === span.max
-  )
-}
-
-/**
- * Sets how a part moves relative to its parent, or clears the joint with `undefined`.
- *
- * - From none: adds a joint at the seam with the parent (`seamOrigin`), with a vertical axis and starting
- *   limits, and a parameter that drives it over those limits.
- * - To none: removes the joint and every channel that drove it; a parameter or clip left with no channel
- *   is removed too, because the format refuses an empty one.
- * - Between types: keeps the origin and axis, sets limits for the new type (none for continuous), and
- *   moves a plain driving parameter along with them.
- */
-export function setJointType(
-  draft: FigureDraft,
-  part: FigurePart,
-  type: JointType | undefined,
-  parent?: FigurePart
-): FigureDraft {
-  const joints = draft.joints ?? []
-  const existing = joints.find(joint => joint.child === part.name)
-
-  if (type === undefined) {
-    if (!existing) return draft
-    return withoutJoint(draft, existing.name)
-  }
-
-  if (!existing) {
-    const joint: FigureJoint = {
-      name: freeName([...joints.map(one => one.name)], `${part.name}-joint`),
-      child: part.name,
-      type,
-      origin: seamOrigin(part, parent),
-      axis: { x: 0, y: 1, z: 0 }
-    }
-    if (type !== 'continuous') joint.limits = { ...NEW_LIMITS[type] }
-
-    const parameters = draft.parameters ?? []
-    const taken = [...parameters.map(one => one.name), ...(draft.animations ?? []).map(one => one.name)]
-    const driver = drivingParameter(joint)
-    driver.name = freeName(taken, joint.name)
-
-    return { ...draft, joints: [...joints, joint], parameters: [...parameters, driver] }
-  }
-
-  if (existing.type === type) return draft
-
-  const next: FigureJoint = { ...existing, type }
-  if (type === 'continuous') delete next.limits
-  else if (existing.type === 'continuous' || (existing.type === 'prismatic') !== (type === 'prismatic')) {
-    next.limits = { ...NEW_LIMITS[type] }
-  }
-
-  return replaceJoint(draft, existing, next)
-}
-
-/** Changes a joint's origin, axis or limits. A plain driving parameter follows new limits. */
-export function patchJoint(
-  draft: FigureDraft,
-  name: string,
-  patch: { origin?: Vec3; axis?: Vec3; limits?: { min: number; max: number } }
-): FigureDraft {
-  const existing = draft.joints?.find(joint => joint.name === name)
-  if (!existing) return draft
-  const next: FigureJoint = { ...existing, ...patch }
-  if (existing.type === 'continuous') delete next.limits
-  return replaceJoint(draft, existing, next)
-}
-
-function replaceJoint(draft: FigureDraft, before: FigureJoint, after: FigureJoint): FigureDraft {
-  const joints = (draft.joints ?? []).map(joint => (joint === before ? after : joint))
-  const was = spanOf(before)
-  const unitChanged = (before.type === 'prismatic') !== (after.type === 'prismatic')
-  const spanChanged = was.min !== spanOf(after).min || was.max !== spanOf(after).max
-
-  if (!unitChanged && !spanChanged) return { ...draft, joints }
-
-  const parameters = (draft.parameters ?? []).map(parameter => {
-    if (!isPlainDriver(parameter, before, was)) return parameter
-    const driver = drivingParameter(after)
-    return { ...parameter, range: driver.range, clip: { ...parameter.clip, channels: driver.clip.channels } }
-  })
-  return { ...draft, joints, parameters }
-}
-
-function withoutJoint(draft: FigureDraft, name: string): FigureDraft {
-  const keep = <T extends { channels?: { target: string }[] }>(one: T) => (one.channels ?? []).filter(channel => channel.target !== name)
-
-  const parameters = (draft.parameters ?? [])
-    .map(parameter => ({ ...parameter, clip: { ...parameter.clip, channels: keep(parameter.clip) } }) as Parameter)
-    .filter(parameter => parameter.clip.channels.length > 0)
-  const animations = (draft.animations ?? [])
-    .map(clip => ({ ...clip, channels: keep(clip) }) as NonNullable<FigureDraft['animations']>[number])
-    .filter(clip => clip.channels.length > 0)
-  const joints = (draft.joints ?? []).filter(joint => joint.name !== name)
-
-  const next: FigureDraft = { ...draft }
-  if (joints.length > 0) next.joints = joints
-  else delete next.joints
-  if (draft.parameters !== undefined) next.parameters = parameters
-  if (draft.animations !== undefined) next.animations = animations
-  return next
-}