@things-factory/figure-ui 10.1.24 → 10.1.26

package/client/graphql/index.ts

@@ -1,4 +1,5 @@
 import gql from 'graphql-tag'
+import { i18next } from '@operato/i18n'
 import { client } from '@operato/graphql'
 
 import type {
@@ -29,7 +30,9 @@ function unwrap<T>(response: { data?: Record<string, unknown>; errors?: readonly
   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] as T

package/client/modeller/figure-animations.ts

@@ -380,7 +380,6 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
     return html`
       <section>
         <h3>${i18next.t('figure.label.animation')}</h3>
-        <p quiet>${i18next.t('figure.text.animation-is-driven-by-a-fact')}</p>
       </section>
 
       ${this.renderRecipes()}
@@ -488,6 +487,7 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
     const nameless = !parameter.name?.trim()
     const range = parameter.range ?? NEW_RANGE
     const backwards = !(range.max > range.min)
+    const slowness = parameter.clip?.duration ?? 0
 
     return html`
       <div clip ?on=${on}>
@@ -552,6 +552,21 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
           />
         </div>
 
+        <div row>
+          <label>${i18next.t('figure.label.parameter-duration')}</label>
+          <input
+            type="number"
+            step="0.1"
+            min="0"
+            ?bad=${slowness < 0}
+            .value=${live(parameter.clip?.duration === undefined ? '' : String(parameter.clip.duration))}
+            placeholder="0"
+            aria-label="duration"
+            @change=${(e: Event) => this.setDuration(at, (e.target as HTMLInputElement).value)}
+          />
+        </div>
+        <p quiet>${i18next.t('figure.text.parameter-duration-empty-is-instant')}</p>
+
         ${on ? this.renderChannels('parameter', at) : nothing}
       </div>
     `
@@ -678,11 +693,18 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
    */
   private renderKeys(kind: MotionKind, channel: Channel, at: number, j: number): TemplateResult {
     const keys = channel.keys ?? []
+    /*
+      Keys on a parameter curve sit on the 0..1 value span (ADR-0051). A key above 1 is unreachable and
+      the format refuses it. The screen marks it and leaves the number alone: rewriting what the author
+      typed would hide what they wrote.
+    */
+    const onValues = kind === 'parameter'
+    const outside = (key: Keyframe) => onValues && key.at > 1
 
     return html`
       <table keys>
         <tr>
-          <th>${i18next.t('figure.label.key-at')}</th>
+          <th>${i18next.t(onValues ? 'figure.label.key-at-value' : 'figure.label.key-at')}</th>
           ${AXES.map(axis => html`<th>${axis}</th>`)}
           <th></th>
         </tr>
@@ -693,11 +715,16 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
               <td>
                 <input
                   type="number"
-                  step="0.1"
+                  step=${onValues ? '0.05' : '0.1'}
                   min="0"
-                  ?bad=${backwards || key.at < 0}
+                  max=${onValues ? '1' : nothing}
+                  ?bad=${backwards || key.at < 0 || outside(key)}
                   .value=${live(String(key.at))}
-                  title=${backwards ? i18next.t('figure.text.keys-must-rise') : ''}
+                  title=${backwards
+                    ? i18next.t('figure.text.keys-must-rise')
+                    : outside(key)
+                      ? i18next.t('figure.text.parameter-key-within-span')
+                      : ''}
                   @change=${(e: Event) =>
                     this.setKey(kind, at, j, k, { at: Math.max(0, Number((e.target as HTMLInputElement).value) || 0) })}
                 />
@@ -736,6 +763,7 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
       ${keys.some((key, k) => k > 0 && key.at <= (keys[k - 1]!.at ?? 0))
         ? html`<p warn>${i18next.t('figure.text.keys-must-rise')}</p>`
         : nothing}
+      ${keys.some(outside) ? html`<p warn>${i18next.t('figure.text.parameter-key-within-span')}</p>` : nothing}
 
       <button @click=${() => this.addKey(kind, at, j)}>
         <md-icon>add</md-icon>${i18next.t('figure.button.add-key')}
@@ -883,6 +911,19 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
     this.patchParameter(at, { range: { ...(parameter.range ?? NEW_RANGE), ...patch } })
   }
 
+  /**
+   * Transition time. Clearing the input removes the field, which means instant. 0 is instant too, but
+   * a stored 0 and a missing field are different sources, so an empty input is never saved as 0.
+   */
+  private setDuration(at: number, raw: string): void {
+    const parameter = this.parameters[at]
+    if (!parameter) return
+    const { duration: _dropped, ...rest } = parameter.clip
+    const text = raw.trim()
+    const clip = text === '' || !Number.isFinite(Number(text)) ? rest : { ...rest, duration: Number(text) }
+    this.patchParameter(at, { clip })
+  }
+
   private setDefault(at: number, value: number): void {
     this.patchParameter(at, { default: value })
   }
@@ -954,6 +995,17 @@ export class FigureAnimations extends localize(i18next)(LitElement) {
     if (!channel) return
 
     const last = channel.keys[channel.keys.length - 1]
+
+    /*
+      A parameter curve ends at 1, so appending a key would make it unreachable. Insert it between the last two keys.
+    */
+    if (kind === 'parameter' && channel.keys.length >= 2) {
+      const before = channel.keys[channel.keys.length - 2]!
+      const middle: Keyframe = { at: (before.at + last!.at) / 2, value: { ...before.value } }
+      this.patchChannel(kind, at, j, { ...channel, keys: [...channel.keys.slice(0, -1), middle, last!] })
+      return
+    }
+
     const key: Keyframe = { at: (last?.at ?? 0) + 1, value: { ...(last?.value ?? startValue(channel.path)) } }
     this.patchChannel(kind, at, j, { ...channel, keys: [...channel.keys, key] })
   }

package/client/modeller/figure-history-panel.ts

@@ -438,11 +438,11 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
         ${(finding.fixes ?? []).map(fix => html`
           ${fix.safe ? html`
             <button apply-fix @click=${() => this.applyFix(fix)}>
-              안전하게 수정 적용 · ${fix.part}.anchor.${fix.axis}: ${fix.from ?? 'auto'} → ${fix.to}
+              ${i18next.t('figure.button.apply-fix', { part: fix.part, axis: fix.axis.toUpperCase(), from: fix.from ?? 'auto', to: fix.to })}
             </button>
           ` : nothing}
           <button preview-fix @click=${() => this.previewFix(fix)}>
-            수정안 미리보기 · ${fix.part}.anchor.${fix.axis}: ${fix.from ?? 'auto'} → ${fix.to}
+            ${i18next.t('figure.button.preview-fix', { part: fix.part, axis: fix.axis.toUpperCase(), from: fix.from ?? 'auto', to: fix.to })}
           </button>
         `)}
       </li>

package/client/modeller/figure-inspector.ts

@@ -1704,8 +1704,14 @@ export class FigureInspector extends localize(i18next)(LitElement) {
   }
 
   private renderAnchors(part: FigurePart) {
+    /*
+      The scene draft stores the box height as depth, so format y is draft.depth and z is draft.height.
+      This used to pass them swapped, and every automatic anchor still came out the same: the
+      nearest-face rule reads the sign of a centred position, which does not depend on the box size.
+      It is fixed so the next rule that does read the box does not inherit the mistake.
+    */
     const base = this.draft
-      ? { x: this.draft.width, y: this.draft.height, z: this.draft.depth }
+      ? { x: this.draft.width, y: this.draft.depth, z: this.draft.height }
       : { x: 0, y: 0, z: 0 }
     const nameOf = (rule: string, axis: Axis) =>
       `${i18next.t(rule === 'min' || rule === 'max' ? `figure.label.anchor-${rule}-${axis}` : `figure.label.anchor-${rule}`)} (${rule})`
@@ -1748,7 +1754,7 @@ export class FigureInspector extends localize(i18next)(LitElement) {
           */
           return html`
             <div anchor-row>
-              <label>${axis.toUpperCase()}축</label>
+              <label>${i18next.t('figure.label.axis-name', { axis: axis.toUpperCase() })}</label>
               <div anchor-options>
                 ${(['auto', 'scale', 'min', 'center', 'max', 'span'] as const).map(rule => {
                   const selected = rule === 'auto' ? !said : rule === said

package/client/modeller/figure-preview.ts

@@ -47,7 +47,7 @@ export const PREVIEW_FACTOR = 2
  * 안 담겨서 **네 칸씩 두 줄**로 놓는다.
  */
 export const PREVIEW_WAYS: readonly { name: string; axes: readonly ('x' | 'y' | 'z')[] }[] = [
-  { name: '기준', axes: [] },
+  { name: 'base', axes: [] },
   { name: 'x', axes: ['x'] },
   { name: 'y', axes: ['y'] },
   { name: 'z', axes: ['z'] },
@@ -208,7 +208,7 @@ export class FigurePreview extends localize(i18next)(LitElement) {
       ${this.cannot
         ? html`<div cannot>${this.cannot}</div>`
         : html`<div legend>
-              ${PREVIEW_WAYS.map(way => html`<span>${way.name}</span>`)}
+              ${PREVIEW_WAYS.map(way => html`<span>${way.axes.length === 0 ? i18next.t('figure.label.preview-base') : way.name}</span>`)}
             </div>
             ${clips.length + parameters.length > 0 ? this.renderDrivers(clips, parameters) : ''}`}
     `
@@ -253,7 +253,7 @@ export class FigurePreview extends localize(i18next)(LitElement) {
 
           return html`
             <label>
-              <span>${clip.name} <span drive>배속</span></span>
+              <span>${clip.name} <span drive>${i18next.t('figure.label.playback-speed')}</span></span>
               <input
                 type="range"
                 min="0"

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
@@ -317,7 +327,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 },
@@ -336,44 +346,9 @@ function partTo(part: PartModel, half: Vec3): FigurePart {
   }) 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,8 +359,9 @@ export function fromFigureSource(source: FigureSource): { draft: FigureDraft; pa
     placement: source.placement,
     detailLevel: source.detailLevel,
     styleKit: source.styleKit,
-    animations: motion.animations,
-    parameters: motion.parameters,
+    /* 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
   }) as FigureDraft
 
@@ -405,7 +381,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,
 
     /*

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"]}

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

@@ -102,6 +102,11 @@ export declare class FigureAnimations extends FigureAnimations_base {
     private renameClip;
     private renameParameter;
     private setRange;
+    /**
+     * Transition time. Clearing the input removes the field, which means instant. 0 is instant too, but
+     * a stored 0 and a missing field are different sources, so an empty input is never saved as 0.
+     */
+    private setDuration;
     private setDefault;
     private removeClip;
     private removeParameter;