@things-factory/figure-ui 10.1.25 → 10.1.27

package/client/modeller/figure-source.ts

@@ -1,4 +1,11 @@
-import { FIGURE_SOURCE_VERSION, type DetailLevel, type FigurePart, type FigurePlacement, type FigureSource, type Vec3 } from '@hatiolab/figure-model'
+import {
+  FIGURE_SOURCE_VERSION,
+  type DetailLevel,
+  type FigurePart,
+  type FigurePlacement,
+  type FigureSource,
+  type Vec3
+} from '@hatiolab/figure-model'
 
 /**
  * Scene model <-> `FigureSource`.
@@ -40,9 +47,12 @@ import { FIGURE_SOURCE_VERSION, type DetailLevel, type FigurePart, type FigurePl
  *     size.z            height
  *
  *     position.x        left + width/2  - draft width/2
- *     position.y        zPos + depth/2  - draft depth/2      <- zPos is the underside
+ *     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
@@ -118,6 +128,12 @@ export interface FigureDraft {
    * 주나**를 말하는 다른 칸이다.
    */
   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']
 }
 
 /** 부품 컴포넌트의 상태. 씬의 용어 그대로다. */
@@ -192,6 +208,8 @@ export interface PartModel {
    * 청사진에서는 `groups` 가 아니라 `anchors` 로 간다.
    */
   capability?: FigurePart['capability']
+  /** The part this one is attached to (ADR-0066). The one place a parent is written. */
+  parent?: FigurePart['parent']
 }
 
 const RAD_TO_DEG = 180 / Math.PI
@@ -283,7 +301,8 @@ export function toFigureSource(draft: FigureDraft, parts: PartModel[]): FigureSo
     parts: parts.map(part => partTo(part, half)),
     animations: draft.animations,
     parameters: draft.parameters,
-    capabilities: draft.capabilities
+    capabilities: draft.capabilities,
+    joints: draft.joints?.length ? draft.joints : undefined
   }) as FigureSource
 }
 
@@ -317,7 +336,7 @@ function partTo(part: PartModel, half: Vec3): FigurePart {
     transform: withoutEmpty({
       position: {
         x: round4(part.left + part.width / 2 - half.x),
-        y: round4(part.zPos + part.depth / 2 - half.y),
+        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 },
@@ -332,48 +351,14 @@ function partTo(part: PartModel, half: Vec3): FigurePart {
     anchor: part.anchor,
     repeat: part.repeat,
     label: part.label,
-    capability: part.capability
+    capability: part.capability,
+    parent: part.parent
   }) as FigurePart
 }
 
-/**
- * 옛 `drive: 'hold'` clip 을 파라미터로 옮긴다 — **여는 순간에.**
- *
- * 형식은 값이 만드는 자세를 `parameters` 로 옮겼고(ADR-0051 ①), `compile()` 이 옛 원본을
- * 청사진으로 만들 때 같은 이전을 한다. **거기서만 하면 저작 화면이 어긋난다** — 씬은
- * 파라미터로 세우는데 저작 화면은 원본을 그대로 읽어 애니메이션 칸에 놓는다.
- *
- * 실제로 그랬다. 카탈로그의 리프터를 열면 `lift-height` 가 애니메이션 목록에 앉고,
- * 미리보기는 그것에 **배속 손잡이**를 붙인다. 손잡이를 끝까지 밀어도 아무 일도 안 난다 —
- * 청사진에는 그 이름의 clip 이 없고 파라미터로 가 있기 때문이다. 저작자가 보는 것은
- * 「움직이지 않는 리프터」다.
- *
- * 범위는 `%` 0~100 이다. 옛 clip 은 제 수가 무엇인지 말한 적이 없으므로 **지어내지
- * 않는다** — 저작자가 mm 로 고쳐 쓸 자리를 열어 줄 뿐이다.
- */
-function partedMotion(source: FigureSource): Pick<FigureDraft, 'animations' | 'parameters'> {
-  const animations: NonNullable<FigureDraft['animations']> = []
-  const parameters: NonNullable<FigureDraft['parameters']> = [...(source.parameters ?? [])]
-
-  for (const clip of source.animations ?? []) {
-    const { drive, ...rest } = clip as typeof clip & { drive?: string }
-    if (drive !== 'hold') {
-      animations.push(rest)
-      continue
-    }
-    parameters.push({ name: clip.name, range: { unit: '%', min: 0, max: 100 }, clip: { channels: clip.channels } })
-  }
-
-  return {
-    animations: animations.length > 0 ? animations : undefined,
-    parameters: parameters.length > 0 ? parameters : undefined
-  }
-}
-
 /** 형식을 씬 모델로 편다. */
 export function fromFigureSource(source: FigureSource): { draft: FigureDraft; parts: PartModel[] } {
   const half: Vec3 = { x: source.base.x / 2, y: source.base.y / 2, z: source.base.z / 2 }
-  const motion = partedMotion(source)
 
   const draft = withoutEmpty({
     version: source.version,
@@ -384,9 +369,11 @@ export function fromFigureSource(source: FigureSource): { draft: FigureDraft; pa
     placement: source.placement,
     detailLevel: source.detailLevel,
     styleKit: source.styleKit,
-    animations: motion.animations,
-    parameters: motion.parameters,
-    capabilities: source.capabilities
+    /* 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
   }) as FigureDraft
 
   return { draft, parts: source.parts.map(part => partFrom(part, half)) }
@@ -405,7 +392,7 @@ function partFrom(part: FigurePart, half: Vec3): PartModel {
     top: round4(half.z + position.z - size.z / 2),
     width: size.x,
     height: size.z,
-    zPos: round4(half.y + position.y - size.y / 2),
+    zPos: round4(position.y - size.y / 2),
     depth: size.y,
 
     /*
@@ -436,6 +423,7 @@ function partFrom(part: FigurePart, half: Vec3): PartModel {
     anchor: part.anchor,
     repeat: part.repeat,
     label: part.label,
-    capability: part.capability
+    capability: part.capability,
+    parent: part.parent
   }) as PartModel
 }

package/client/modeller/figure-view.ts

@@ -130,3 +130,23 @@ export const DEFAULT_VIEW: ViewSettings = {
   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

@@ -0,0 +1,201 @@
+/*
+ * 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))
+}
+
+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 whose origin is the centre of the part's bottom face, 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): 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 { position, size } = part.transform
+    const joint: FigureJoint = {
+      name: freeName([...joints.map(one => one.name)], `${part.name}-joint`),
+      child: part.name,
+      type,
+      origin: { x: position.x, y: position.y - size.y / 2, z: position.z },
+      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
+}

package/client/modeller/proposal-session.ts

@@ -15,6 +15,11 @@ export interface ProposalSession {
   picked: Set<string>
   note: string
   metrics?: Pick<FigureProposal, 'grade' | 'triangles' | 'groups' | 'attempts' | 'quality'>
+  /**
+   * The release-check fix this session was opened from, if any. The page translates the title from it;
+   * this module stays free of i18n because node tests import it directly.
+   */
+  fix?: FigureGateFix
 }
 
 function selectedKeys(current: FigureSource | undefined, source: FigureSource): Set<string> {
@@ -25,7 +30,7 @@ function selectedKeys(current: FigureSource | undefined, source: FigureSource):
 export function openAiProposal(current: FigureSource | undefined, proposal: FigureProposal): ProposalSession {
   const source = JSON.parse(proposal.source) as FigureSource
   if (!source || !Array.isArray(source.parts)) {
-    throw new Error('AI 후보의 Figure 형식이 올바르지 않습니다.')
+    throw new Error('the AI candidate is not a figure source: parts is missing or not an array')
   }
 
   return {
@@ -56,7 +61,8 @@ export function openSizingFix(current: FigureSource, fix: FigureGateFix): Propos
 
   return {
     source,
-    title: `발행 검사 수정안 · ${fix.part}.anchor.${fix.axis}: ${fix.from ?? 'auto'} → ${fix.to}`,
+    title: '',
+    fix,
     picked: selectedKeys(current, source),
     note: ''
   }

package/client/pages/figure-modeller-page.ts

@@ -14,7 +14,7 @@ import { i18next, localize } from '@operato/i18n'
 import { navigate, PageView } from '@operato/shell'
 import { openOverlay } from '@operato/layout'
 import { requestFigureAI, consumePendingFigureProposal } from '../modeller/figure-ai-target.js'
-import { validate } from '@hatiolab/figure-model'
+import { isPlaceholderType, placeholderType, TYPE_LENGTH, TYPE_PATTERN, validate } from '@hatiolab/figure-model'
 import type { DetailLevel, FigureSource, PrimitiveKind } from '@hatiolab/figure-model'
 
 import * as edits from '../modeller/part-edits.js'
@@ -114,6 +114,20 @@ function startingModel(type: string): { draft: FigureDraft; parts: PartModel[] }
  * 바꾸는 것은 이 페이지다. 두 곳에서 고치면 실행 취소도 저장도 어느 쪽이 맞는지 알 수
  * 없게 된다.
  */
+/**
+ * Whether this name could be released, by the format's own rules (`type-not-identifier`,
+ * `type-is-placeholder`). Saving is not blocked, but the type cannot change after creation, so the
+ * author has to hear it now to avoid a draft that can never be released.
+ */
+function releasableType(type: string): boolean {
+  return (
+    !isPlaceholderType(type) &&
+    TYPE_PATTERN.test(type) &&
+    type.length >= TYPE_LENGTH.min &&
+    type.length <= TYPE_LENGTH.max
+  )
+}
+
 @customElement('figure-modeller-page')
 export class FigureModellerPage extends FigureModellerPageBase {
   static styles = css`
@@ -1112,10 +1126,10 @@ export class FigureModellerPage extends FigureModellerPageBase {
 
     return html`
       <div decide>
-        <span>${this.proposalSession.title || i18next.t('figure.text.assistant-proposed-a-figure')}</span>
+        <span>${this.proposalTitle(this.proposalSession)}</span>
         <div spacer></div>
         <button drop @click=${() => this.discard()}>${i18next.t('figure.button.discard')}</button>
-        ${stale ? html`<span role="alert">원본이 변경되었습니다. 후보를 취소하고 AI 지원에서 다시 요청하세요.</span>` : ''}
+        ${stale ? html`<span role="alert">${i18next.t('figure.text.source-changed-ask-again')}</span>` : ''}
         <button take ?disabled=${stale || errors.length > 0 || this.proposalSession.picked.size === 0} @click=${() => this.take()}>
           ${i18next.t('figure.button.take-n-changes', { n: this.proposalSession.picked.size })}
         </button>
@@ -1434,7 +1448,7 @@ export class FigureModellerPage extends FigureModellerPageBase {
     this.proposalFeedback = []
     this.mode = 'edit'
     // 타입 이름을 사람이 정하기 전까지는 임시 이름을 쓴다. 저장할 때 확정한다.
-    const draftType = `FIGURE_${Date.now().toString(36).toUpperCase()}`
+    const draftType = placeholderType()
     const { draft, parts } = startingModel(draftType)
 
     this.figure = { id: '', type: draftType, name: '' } as Figure
@@ -1719,8 +1733,12 @@ export class FigureModellerPage extends FigureModellerPageBase {
     if (!this.figure.id) {
       // 신규 저장: 타입 코드와 표시 이름을 명확히 팝업으로 확인/입력받음
       let defaultType = this.draft?.figureType || this.figure.type || ''
-      if (!defaultType || defaultType.startsWith('FIGURE_')) {
-        defaultType = 'FIGURE'
+      /*
+        A placeholder is not prefilled. This used to prefill 'FIGURE', inviting the author to confirm a
+        meaningless name that cannot change later and that the release gate refuses.
+      */
+      if (!defaultType || isPlaceholderType(defaultType)) {
+        defaultType = ''
       }
       this.saveModalType = defaultType
       this.saveModalName = this.figure.name || ''
@@ -1745,7 +1763,7 @@ export class FigureModellerPage extends FigureModellerPageBase {
         const nameToSave = (this.saveModalName || this.figure.name || typeToSave).trim()
 
         if (!typeToSave) {
-          throw new Error('타입 이름을 입력하세요.')
+          throw new Error(i18next.t('figure.text.enter-a-type-name'))
         }
 
         const taken = await fetchFigureTypeNames()
@@ -1803,29 +1821,46 @@ export class FigureModellerPage extends FigureModellerPageBase {
     }
   }
 
+  /** Title of the candidate bar. A candidate opened from a release-check fix is described by translating that fix here. */
+  private proposalTitle(session: proposalSessions.ProposalSession): string {
+    const fix = session.fix
+    if (fix) {
+      return i18next.t('figure.text.release-check-fix', {
+        part: fix.part,
+        axis: fix.axis.toUpperCase(),
+        from: fix.from ?? 'auto',
+        to: fix.to
+      })
+    }
+    return session.title || i18next.t('figure.text.assistant-proposed-a-figure')
+  }
+
   private renderSaveModal() {
     if (!this.showSaveModal) return nothing
 
     return html`
       <div class="save-modal-backdrop" @click=${(e: Event) => { if (e.target === e.currentTarget) this.showSaveModal = false }}>
         <div class="save-modal-card" role="dialog" aria-modal="true">
-          <h3 class="save-modal-title">${i18next.t('figure.title.save-new-figure', { defaultValue: '도형 초안 저장' })}</h3>
-          <p class="save-modal-desc">${i18next.t('figure.text.save-new-figure-desc', { defaultValue: '도면과 캔버스에서 식별할 고유 타입 코드와 이름을 정합니다.' })}</p>
+          <h3 class="save-modal-title">${i18next.t('figure.title.save-new-figure')}</h3>
+          <p class="save-modal-desc">${i18next.t('figure.text.save-new-figure-desc')}</p>
 
           <div class="save-modal-field">
-            <label>${i18next.t('figure.label.figure-type', { defaultValue: '타입 코드 (영문 대문자)' })}</label>
+            <label>${i18next.t('figure.label.figure-type')}</label>
             <input
               .value=${this.saveModalType}
-              placeholder="예: OHT, AGV_LIFTER"
+              placeholder=${i18next.t('figure.text.figure-type-example')}
               @input=${(e: Event) => (this.saveModalType = (e.target as HTMLInputElement).value.trim().toUpperCase())}
             />
+            ${this.saveModalType && !releasableType(this.saveModalType)
+              ? html`<div class="save-modal-error">${i18next.t('figure.text.type-name-will-not-release')}</div>`
+              : nothing}
           </div>
 
           <div class="save-modal-field">
-            <label>${i18next.t('figure.label.name', { defaultValue: '도형 이름' })}</label>
+            <label>${i18next.t('figure.label.name')}</label>
             <input
               .value=${this.saveModalName}
-              placeholder="예: 오버헤드 호이스트 트랜스포트"
+              placeholder=${i18next.t('figure.text.figure-name-example')}
               @input=${(e: Event) => (this.saveModalName = (e.target as HTMLInputElement).value)}
             />
           </div>
@@ -1834,10 +1869,10 @@ export class FigureModellerPage extends FigureModellerPageBase {
 
           <div class="save-modal-actions">
             <button class="btn-cancel" @click=${() => (this.showSaveModal = false)}>
-              ${i18next.t('figure.button.cancel', { defaultValue: '취소' })}
+              ${i18next.t('figure.button.cancel')}
             </button>
             <button class="btn-confirm" ?disabled=${this.saving || !this.saveModalType} @click=${() => this.doSave()}>
-              ${this.saving ? i18next.t('figure.text.saving-figure', { defaultValue: '저장 중...' }) : i18next.t('figure.button.save', { defaultValue: '저장' })}
+              ${this.saving ? i18next.t('figure.text.saving-figure') : i18next.t('figure.button.save')}
             </button>
           </div>
         </div>

package/dist-client/graphql/index.js

@@ -1,4 +1,5 @@
 import gql from 'graphql-tag';
+import { i18next } from '@operato/i18n';
 import { client } from '@operato/graphql';
 /**
  * 응답에서 값을 꺼낸다. **서버가 말한 사유를 그대로 올린다.**
@@ -16,7 +17,9 @@ function unwrap(response, field) {
     if (said)
         throw new Error(said);
     if (!response.data) {
-        throw new Error(`서버가 ${field} 를 돌려주지 않았습니다.`);
+        /* The field name stays off the screen because the user cannot act on it; it goes to the console. */
+        console.error(`[figure-ui] the server returned no data for ${field}`);
+        throw new Error(i18next.t('figure.text.server-returned-no-data'));
     }
     return response.data[field];
 }

package/dist-client/graphql/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/graphql/index.ts"],"names":[],"mappings":"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","sourcesContent":["import gql from 'graphql-tag'\nimport { client } from '@operato/graphql'\n\nimport type {\n  Figure,\n  FigureFinding,\n  FigureInspection,\n  FigureListResult,\n  FigurePatch,\n  FigureProposal,\n  ProposalFeedback,\n  FigureVersion,\n  NewFigure\n} from '../types.js'\n\n/**\n * 응답에서 값을 꺼낸다. **서버가 말한 사유를 그대로 올린다.**\n *\n * 전에는 `response.data.figures` 처럼 바로 꺼냈다. 서버가 오류를 돌려주면 `data` 가\n * 없으므로 `Cannot read properties of undefined (reading 'figures')` 가 났고, 화면에는\n * 그 문장이 그대로 떴다. 사용자는 자기가 무엇을 잘못했는지 알 수 없다 — 실제로 AI\n * 요청에서 그렇게 났다.\n *\n * 값이 `null` 인 것은 오류가 아니다. 지운 것을 물었을 때처럼 없는 것이 답인 경우가 있다.\n * 여기서 막는 것은 **`data` 자체가 없는 것**이다.\n */\nfunction unwrap<T>(response: { data?: Record<string, unknown>; errors?: readonly { message: string }[] }, field: string): T {\n  const said = response.errors?.[0]?.message\n  if (said) throw new Error(said)\n\n  if (!response.data) {\n    throw new Error(`서버가 ${field} 를 돌려주지 않았습니다.`)\n  }\n\n  return response.data[field] as T\n}\n\n\n/**\n * 목록에 필요한 필드만 가져온다 — `source` 는 무겁고 목록에서 쓰지 않는다.\n *\n * **`thumbnail` 도 여기 없다.** base64 문자열이라 목록 응답에 실으면 카탈로그를 열 때마다 그림\n * 전부가 다시 오고(표본 14개 227KB), data URL 은 브라우저가 캐시하지 못한다. 그림은 주소로\n * 부른다(`figure-thumbnail` 라우트). 대신 `thumbnailUpdatedAt` 을 받는다 — 그림이 있나 없나를\n * 그것으로 알고, 판을 가리는 값으로도 쓴다.\n */\nconst FIGURE_LIST_FIELDS = `\n  id\n  type\n  name\n  description\n  category\n  tags\n  state\n  version\n  score\n  triangles\n  groups\n  thumbnailUpdatedAt\n  updatedAt\n  updater { id name }\n`\n\n/**\n * 목록을 가져온다.\n *\n * 걸러 보기·정렬·쪽 나누기를 **그대로 넘긴다.** 화면이 `search`·`state` 같은 이름을 따로 만들어\n * filter 로 옮기던 것을 그만두었다 — 그 이름들은 격자(ox-grist)가 이미 컬럼 설정에서 만들어 주고,\n * 중간에 한 벌 더 두면 격자가 아는 조건과 서버에 가는 조건이 어긋난다.\n */\nexport async function fetchFigureList(params: {\n  page?: number\n  limit?: number\n  filters?: unknown[]\n  sortings?: { name: string; desc?: boolean }[]\n}): Promise<FigureListResult> {\n  const response = await client.query({\n    query: gql`\n      query ($filters: [Filter!], $pagination: Pagination, $sortings: [Sorting!]) {\n        figures(filters: $filters, pagination: $pagination, sortings: $sortings) {\n          items { ${FIGURE_LIST_FIELDS} }\n          total\n        }\n      }\n    `,\n    variables: {\n      filters: params.filters ?? [],\n      pagination: { page: params.page ?? 1, limit: params.limit ?? 30 },\n      sortings: params.sortings?.length ? params.sortings : [{ name: 'updatedAt', desc: true }]\n    },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<FigureListResult>(response, 'figures')\n}\n\n/** 저작면에 필요한 전부 — `source` 를 포함한다. */\nexport async function fetchFigure(id: string): Promise<Figure> {\n  const response = await client.query({\n    query: gql`\n      query ($id: String!) {\n        figure(id: $id) {\n          ${FIGURE_LIST_FIELDS}\n          source\n          properties\n        }\n      }\n    `,\n    variables: { id },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<Figure>(response, 'figure')\n}\n\n/**\n * 이미 쓰이고 있는 타입 이름.\n *\n * `type` 은 만든 뒤에 고칠 수 없으므로 **만들기 전에** 알려 줘야 한다. 저장을 눌러\n * 거절당하고 나서 아는 것은 늦다.\n */\nexport async function fetchFigureTypeNames(): Promise<string[]> {\n  const response = await client.query({\n    query: gql`\n      query {\n        figureTypeNames\n      }\n    `,\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<string[] | null>(response, 'figureTypeNames') ?? []\n}\n\nexport interface SaveResult {\n  figure: Figure\n  /** 막지 않는 발견. 저장은 됐지만 화면이 보여 줘야 한다. */\n  violations: FigureFinding[]\n}\n\nexport async function createFigure(figure: NewFigure): Promise<SaveResult> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ($figure: NewFigure!) {\n        createFigure(figure: $figure) {\n          figure { ${FIGURE_LIST_FIELDS} source }\n          violations { code message at }\n        }\n      }\n    `,\n    variables: { figure }\n  })\n\n  return unwrap<SaveResult>(response, 'createFigure')\n}\n\nexport async function updateFigure(id: string, patch: FigurePatch): Promise<SaveResult> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ($id: String!, $patch: FigurePatch!) {\n        updateFigure(id: $id, patch: $patch) {\n          figure { ${FIGURE_LIST_FIELDS} source }\n          violations { code message at }\n        }\n      }\n    `,\n    variables: { id, patch }\n  })\n\n  return unwrap<SaveResult>(response, 'updateFigure')\n}\n\nexport async function deleteFigure(id: string): Promise<boolean> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ($id: String!) {\n        deleteFigure(id: $id)\n      }\n    `,\n    variables: { id }\n  })\n\n  return unwrap<boolean>(response, 'deleteFigure')\n}\n\n/**\n * 저작 보조에게 후보를 시킨다.\n *\n * 팔레트를 **클라이언트가 보낸다.** 서버는 팔레트를 모른다 — things-scene 이 갖고\n * 있는데 그 패키지의 node 조건은 팔레트가 없는 번들로 간다. 그리는 쪽이 어떤 토큰을\n * 풀 수 있는지 아는 유일한 자리이므로 그쪽이 보낸다.\n *\n * 돌아오는 것은 **후보**다. 저장되지 않았다 — 저작자가 받아야 정본이 된다.\n */\nexport async function proposeFigure(request: {\n  prompt: string\n  base?: string\n  type?: string\n  palette: string[]\n  refine?: boolean\n  feedback?: ProposalFeedback[]\n  image?: File\n}): Promise<FigureProposal> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ProposeFigure($request: ProposeRequest!) {\n        proposeFigure(request: $request) {\n          source\n          score\n          grade\n          triangles\n          groups\n          quality {\n            status\n            summary\n            findings {\n              dimension\n              code\n              message\n            }\n            visualRegions\n            visualCoverage\n            visualReadability\n          }\n          attempts\n          violations {\n            code\n            message\n          }\n        }\n      }\n    `,\n    variables: { request },\n    // @operato/graphql 는 이 신호가 있을 때만 Upload가 포함된 변수를 multipart로 인코딩한다.\n    // 없으면 브라우저 File은 JSON에서 {}가 되어 서버 Upload scalar가 요청 자체를 거절한다.\n    context: { hasUpload: !!request.image }\n  })\n\n  return unwrap<FigureProposal>(response, 'proposeFigure')\n}\n\n/**\n * 발행한다 — 판 번호가 오르고, 그 순간이 판본으로 남는다.\n *\n * 이미 발행된 것을 다시 발행하면 서버가 거절한다. 고쳐서 다시 내려면 저장이 먼저이고, 저장은\n * 발행을 푼다(초안으로 돌아온다).\n */\nexport async function releaseFigure(id: string, comment?: string): Promise<Figure> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ReleaseFigure($id: String!, $comment: String) {\n        releaseFigure(id: $id, comment: $comment) {\n          id\n          version\n          state\n          updatedAt\n        }\n      }\n    `,\n    variables: { id, comment }\n  })\n\n  return unwrap<Figure>(response, 'releaseFigure')\n}\n\n/** 옛 판을 초안으로 되살린다. 정본·속성·그림이 돌아오고 이름·설명은 그대로다. */\nexport async function revertFigureVersion(id: string, version: number): Promise<SaveResult> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation RevertFigureVersion($id: String!, $version: Float!) {\n        revertFigureVersion(id: $id, version: $version) {\n          figure { ${FIGURE_LIST_FIELDS} source }\n          violations { code message at }\n        }\n      }\n    `,\n    variables: { id, version }\n  })\n\n  return unwrap<SaveResult>(response, 'revertFigureVersion')\n}\n\n/**\n * 발행해도 되나 — **누르기 전에** 묻는다.\n *\n * 막는 것은 서버의 `releaseFigure` 이고 이것은 이유를 미리 보여 주기 위한 것이다. 허가증이\n * 아니므로 이 답이 통과라 해도 발행은 다시 판정을 받는다.\n */\nexport async function inspectFigure(id: string): Promise<FigureInspection> {\n  const response = await client.query({\n    query: gql`\n      query InspectFigure($id: String!) {\n        inspectFigure(id: $id) {\n          blocked\n          findings {\n            code\n            message\n            why\n            how\n            at\n            fixes {\n              findingWay\n              part\n              axis\n              from\n              to\n              resolved\n              safe\n            }\n            blocking\n          }\n        }\n      }\n    `,\n    variables: { id },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<FigureInspection>(response, 'inspectFigure')\n}\n\n/** 발행된 판들 — 최근 것부터 열 개. */\nexport async function fetchFigureVersions(id: string): Promise<FigureVersion[]> {\n  const response = await client.query({\n    query: gql`\n      query FigureVersions($id: String!) {\n        figureVersions(id: $id) {\n          version\n          comment\n          state\n          updatedAt\n          updater { id name }\n          score\n          triangles\n          groups\n        }\n      }\n    `,\n    variables: { id },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<FigureVersion[]>(response, 'figureVersions') ?? []\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/graphql/index.ts"],"names":[],"mappings":"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","sourcesContent":["import gql from 'graphql-tag'\nimport { i18next } from '@operato/i18n'\nimport { client } from '@operato/graphql'\n\nimport type {\n  Figure,\n  FigureFinding,\n  FigureInspection,\n  FigureListResult,\n  FigurePatch,\n  FigureProposal,\n  ProposalFeedback,\n  FigureVersion,\n  NewFigure\n} from '../types.js'\n\n/**\n * 응답에서 값을 꺼낸다. **서버가 말한 사유를 그대로 올린다.**\n *\n * 전에는 `response.data.figures` 처럼 바로 꺼냈다. 서버가 오류를 돌려주면 `data` 가\n * 없으므로 `Cannot read properties of undefined (reading 'figures')` 가 났고, 화면에는\n * 그 문장이 그대로 떴다. 사용자는 자기가 무엇을 잘못했는지 알 수 없다 — 실제로 AI\n * 요청에서 그렇게 났다.\n *\n * 값이 `null` 인 것은 오류가 아니다. 지운 것을 물었을 때처럼 없는 것이 답인 경우가 있다.\n * 여기서 막는 것은 **`data` 자체가 없는 것**이다.\n */\nfunction unwrap<T>(response: { data?: Record<string, unknown>; errors?: readonly { message: string }[] }, field: string): T {\n  const said = response.errors?.[0]?.message\n  if (said) throw new Error(said)\n\n  if (!response.data) {\n    /* The field name stays off the screen because the user cannot act on it; it goes to the console. */\n    console.error(`[figure-ui] the server returned no data for ${field}`)\n    throw new Error(i18next.t('figure.text.server-returned-no-data'))\n  }\n\n  return response.data[field] as T\n}\n\n\n/**\n * 목록에 필요한 필드만 가져온다 — `source` 는 무겁고 목록에서 쓰지 않는다.\n *\n * **`thumbnail` 도 여기 없다.** base64 문자열이라 목록 응답에 실으면 카탈로그를 열 때마다 그림\n * 전부가 다시 오고(표본 14개 227KB), data URL 은 브라우저가 캐시하지 못한다. 그림은 주소로\n * 부른다(`figure-thumbnail` 라우트). 대신 `thumbnailUpdatedAt` 을 받는다 — 그림이 있나 없나를\n * 그것으로 알고, 판을 가리는 값으로도 쓴다.\n */\nconst FIGURE_LIST_FIELDS = `\n  id\n  type\n  name\n  description\n  category\n  tags\n  state\n  version\n  score\n  triangles\n  groups\n  thumbnailUpdatedAt\n  updatedAt\n  updater { id name }\n`\n\n/**\n * 목록을 가져온다.\n *\n * 걸러 보기·정렬·쪽 나누기를 **그대로 넘긴다.** 화면이 `search`·`state` 같은 이름을 따로 만들어\n * filter 로 옮기던 것을 그만두었다 — 그 이름들은 격자(ox-grist)가 이미 컬럼 설정에서 만들어 주고,\n * 중간에 한 벌 더 두면 격자가 아는 조건과 서버에 가는 조건이 어긋난다.\n */\nexport async function fetchFigureList(params: {\n  page?: number\n  limit?: number\n  filters?: unknown[]\n  sortings?: { name: string; desc?: boolean }[]\n}): Promise<FigureListResult> {\n  const response = await client.query({\n    query: gql`\n      query ($filters: [Filter!], $pagination: Pagination, $sortings: [Sorting!]) {\n        figures(filters: $filters, pagination: $pagination, sortings: $sortings) {\n          items { ${FIGURE_LIST_FIELDS} }\n          total\n        }\n      }\n    `,\n    variables: {\n      filters: params.filters ?? [],\n      pagination: { page: params.page ?? 1, limit: params.limit ?? 30 },\n      sortings: params.sortings?.length ? params.sortings : [{ name: 'updatedAt', desc: true }]\n    },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<FigureListResult>(response, 'figures')\n}\n\n/** 저작면에 필요한 전부 — `source` 를 포함한다. */\nexport async function fetchFigure(id: string): Promise<Figure> {\n  const response = await client.query({\n    query: gql`\n      query ($id: String!) {\n        figure(id: $id) {\n          ${FIGURE_LIST_FIELDS}\n          source\n          properties\n        }\n      }\n    `,\n    variables: { id },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<Figure>(response, 'figure')\n}\n\n/**\n * 이미 쓰이고 있는 타입 이름.\n *\n * `type` 은 만든 뒤에 고칠 수 없으므로 **만들기 전에** 알려 줘야 한다. 저장을 눌러\n * 거절당하고 나서 아는 것은 늦다.\n */\nexport async function fetchFigureTypeNames(): Promise<string[]> {\n  const response = await client.query({\n    query: gql`\n      query {\n        figureTypeNames\n      }\n    `,\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<string[] | null>(response, 'figureTypeNames') ?? []\n}\n\nexport interface SaveResult {\n  figure: Figure\n  /** 막지 않는 발견. 저장은 됐지만 화면이 보여 줘야 한다. */\n  violations: FigureFinding[]\n}\n\nexport async function createFigure(figure: NewFigure): Promise<SaveResult> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ($figure: NewFigure!) {\n        createFigure(figure: $figure) {\n          figure { ${FIGURE_LIST_FIELDS} source }\n          violations { code message at }\n        }\n      }\n    `,\n    variables: { figure }\n  })\n\n  return unwrap<SaveResult>(response, 'createFigure')\n}\n\nexport async function updateFigure(id: string, patch: FigurePatch): Promise<SaveResult> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ($id: String!, $patch: FigurePatch!) {\n        updateFigure(id: $id, patch: $patch) {\n          figure { ${FIGURE_LIST_FIELDS} source }\n          violations { code message at }\n        }\n      }\n    `,\n    variables: { id, patch }\n  })\n\n  return unwrap<SaveResult>(response, 'updateFigure')\n}\n\nexport async function deleteFigure(id: string): Promise<boolean> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ($id: String!) {\n        deleteFigure(id: $id)\n      }\n    `,\n    variables: { id }\n  })\n\n  return unwrap<boolean>(response, 'deleteFigure')\n}\n\n/**\n * 저작 보조에게 후보를 시킨다.\n *\n * 팔레트를 **클라이언트가 보낸다.** 서버는 팔레트를 모른다 — things-scene 이 갖고\n * 있는데 그 패키지의 node 조건은 팔레트가 없는 번들로 간다. 그리는 쪽이 어떤 토큰을\n * 풀 수 있는지 아는 유일한 자리이므로 그쪽이 보낸다.\n *\n * 돌아오는 것은 **후보**다. 저장되지 않았다 — 저작자가 받아야 정본이 된다.\n */\nexport async function proposeFigure(request: {\n  prompt: string\n  base?: string\n  type?: string\n  palette: string[]\n  refine?: boolean\n  feedback?: ProposalFeedback[]\n  image?: File\n}): Promise<FigureProposal> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ProposeFigure($request: ProposeRequest!) {\n        proposeFigure(request: $request) {\n          source\n          score\n          grade\n          triangles\n          groups\n          quality {\n            status\n            summary\n            findings {\n              dimension\n              code\n              message\n            }\n            visualRegions\n            visualCoverage\n            visualReadability\n          }\n          attempts\n          violations {\n            code\n            message\n          }\n        }\n      }\n    `,\n    variables: { request },\n    // @operato/graphql 는 이 신호가 있을 때만 Upload가 포함된 변수를 multipart로 인코딩한다.\n    // 없으면 브라우저 File은 JSON에서 {}가 되어 서버 Upload scalar가 요청 자체를 거절한다.\n    context: { hasUpload: !!request.image }\n  })\n\n  return unwrap<FigureProposal>(response, 'proposeFigure')\n}\n\n/**\n * 발행한다 — 판 번호가 오르고, 그 순간이 판본으로 남는다.\n *\n * 이미 발행된 것을 다시 발행하면 서버가 거절한다. 고쳐서 다시 내려면 저장이 먼저이고, 저장은\n * 발행을 푼다(초안으로 돌아온다).\n */\nexport async function releaseFigure(id: string, comment?: string): Promise<Figure> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation ReleaseFigure($id: String!, $comment: String) {\n        releaseFigure(id: $id, comment: $comment) {\n          id\n          version\n          state\n          updatedAt\n        }\n      }\n    `,\n    variables: { id, comment }\n  })\n\n  return unwrap<Figure>(response, 'releaseFigure')\n}\n\n/** 옛 판을 초안으로 되살린다. 정본·속성·그림이 돌아오고 이름·설명은 그대로다. */\nexport async function revertFigureVersion(id: string, version: number): Promise<SaveResult> {\n  const response = await client.mutate({\n    mutation: gql`\n      mutation RevertFigureVersion($id: String!, $version: Float!) {\n        revertFigureVersion(id: $id, version: $version) {\n          figure { ${FIGURE_LIST_FIELDS} source }\n          violations { code message at }\n        }\n      }\n    `,\n    variables: { id, version }\n  })\n\n  return unwrap<SaveResult>(response, 'revertFigureVersion')\n}\n\n/**\n * 발행해도 되나 — **누르기 전에** 묻는다.\n *\n * 막는 것은 서버의 `releaseFigure` 이고 이것은 이유를 미리 보여 주기 위한 것이다. 허가증이\n * 아니므로 이 답이 통과라 해도 발행은 다시 판정을 받는다.\n */\nexport async function inspectFigure(id: string): Promise<FigureInspection> {\n  const response = await client.query({\n    query: gql`\n      query InspectFigure($id: String!) {\n        inspectFigure(id: $id) {\n          blocked\n          findings {\n            code\n            message\n            why\n            how\n            at\n            fixes {\n              findingWay\n              part\n              axis\n              from\n              to\n              resolved\n              safe\n            }\n            blocking\n          }\n        }\n      }\n    `,\n    variables: { id },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<FigureInspection>(response, 'inspectFigure')\n}\n\n/** 발행된 판들 — 최근 것부터 열 개. */\nexport async function fetchFigureVersions(id: string): Promise<FigureVersion[]> {\n  const response = await client.query({\n    query: gql`\n      query FigureVersions($id: String!) {\n        figureVersions(id: $id) {\n          version\n          comment\n          state\n          updatedAt\n          updater { id name }\n          score\n          triangles\n          groups\n        }\n      }\n    `,\n    variables: { id },\n    fetchPolicy: 'network-only'\n  })\n\n  return unwrap<FigureVersion[]>(response, 'figureVersions') ?? []\n}\n"]}