@things-factory/figure-ui 10.1.66 → 10.1.67

package/client/graphql/index.ts

@@ -57,7 +57,6 @@ const FIGURE_LIST_FIELDS = `
   score
   triangles
   groups
-  format
   thumbnailUpdatedAt
   updatedAt
   updater { id name }
@@ -244,28 +243,6 @@ export async function inspectFigure(id: string): Promise<FigureInspection> {
             why
             how
             at
-            fixes {
-              findingWay
-              part
-              axis
-              from
-              to
-              resolved
-              safe
-            }
-            fixPlan {
-              resolved
-              safe
-              fixes {
-                findingWay
-                part
-                axis
-                from
-                to
-                resolved
-                safe
-              }
-            }
             blocking
           }
         }
@@ -297,28 +274,6 @@ export async function inspectFigureDraft(source: string, id?: string): Promise<F
             why
             how
             at
-            fixes {
-              findingWay
-              part
-              axis
-              from
-              to
-              resolved
-              safe
-            }
-            fixPlan {
-              resolved
-              safe
-              fixes {
-                findingWay
-                part
-                axis
-                from
-                to
-                resolved
-                safe
-              }
-            }
             blocking
           }
         }

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

@@ -8,7 +8,7 @@ import { i18next, localize } from '@operato/i18n'
 import { ScrollbarStyles } from '@operato/styles'
 
 import { fetchFigureVersions, inspectFigure, releaseFigure, revertFigureVersion } from '../graphql/index.js'
-import type { FigureGateFinding, FigureGateFix, FigureGateFixPlan, FigureInspection, FigureVersion } from '../types.js'
+import type { FigureGateFinding, FigureInspection, FigureVersion } from '../types.js'
 import { OxPrompt } from '@operato/popup'
 
 /**
@@ -195,55 +195,6 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
       「이 중 어느 것이 발행을 막았나」를 사람이 다시 세어야 한다.
     */
 
-    /* 설명으로 끝내지 않는다. 이 단추는 원본을 바꾸지 않고 모델러에 후보만 연다. */
-    li[finding] button[preview-fix] {
-      margin-top: 3px;
-      padding: 4px 7px;
-      font-weight: 700;
-      color: var(--md-sys-color-on-primary-container, var(--md-sys-color-on-surface));
-      background-color: var(--md-sys-color-primary-container, transparent);
-      border: 0;
-      border-radius: 5px;
-      cursor: pointer;
-    }
-
-    li[finding] button[preview-fix]:hover {
-      filter: brightness(1.08);
-    }
-
-    li[finding] button[apply-fix] {
-      margin-top: 3px;
-      padding: 4px 7px;
-      font-weight: 700;
-      color: var(--ui-on-accent, #fff);
-      background-color: var(--md-sys-color-primary);
-      border: 0;
-      border-radius: 5px;
-      cursor: pointer;
-    }
-
-    div[ratio-choice] {
-      display: flex;
-      flex-wrap: wrap;
-      gap: 6px;
-      margin-top: 4px;
-    }
-
-    div[ratio-choice] button:not([apply-fix]) {
-      padding: 4px 7px;
-      color: var(--md-sys-color-on-surface);
-      background: transparent;
-      border: 1px solid var(--md-sys-color-outline-variant);
-      border-radius: 5px;
-      cursor: pointer;
-    }
-
-    div[ratio-choice] button[selected] {
-      color: var(--md-sys-color-on-primary-container);
-      background: var(--md-sys-color-primary-container);
-      border-color: transparent;
-    }
-
     p[quiet] {
       margin: 0;
       line-height: 1.6;
@@ -258,25 +209,16 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
   @property({ type: Number }) figureVersion = 0
   /** 저장하지 않은 것이 있나 — 있으면 발행을 막는다. */
   @property({ type: Boolean }) dirty = false
-  /**
-   * 열린 도형의 형식. 발행 · 판본 · 복원은 figure id 로만 서버를 묻고 서버의 한 문이 두 형식을 다 읽으므로 두 화면이
-   * 이 패널을 함께 쓴다. 갈리는 것은 조치 단추 하나다 — 부품을 옮기는 두 조치는 형식마다 다른 편집이라, 받는
-   * 화면이 없는 단추를 그리면 눌러도 아무 일이 없다.
-   */
-  @property({ type: String }) format: 'v2' | 'v3' = 'v2'
   /**
    * 행의 타입. 판정 하나(`type-is-placeholder`)가 이것을 본다 — V3 자산은 타입을 원본에 적지 않아서, 타입을 바꾸면
    * 원본도 dirty 도 그대로다. 그래서 이 값이 바뀌면 판정을 다시 묻는다. 안 그러면 타입을 정한 뒤에도 「임시 타입」
    * 판정이 남아 발행 단추가 잠긴 채다.
    */
   @property({ type: String }) figureType?: string
-  /** 직전 발행판의 기준 상자. 외형 변화 안내에서 X·Z 복원 선택지에만 쓴다. */
-  @property({ attribute: false }) releasedBase?: { x: number; y: number; z: number }
 
   @state() private versions: FigureVersion[] = []
   @state() private busy = false
   @state() private failure = ''
-  @state() private keepChangedAppearance = false
   /**
    * 발행 판정. **저장된 정본에 대한 것**이라 저장할 때마다 다시 묻는다(`figureVersion` 이 아니라
    * `dirty` 가 풀리는 순간이 그때다).
@@ -298,7 +240,6 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
   }
 
   private async inspect() {
-    this.keepChangedAppearance = false
     if (!this.figureId || this.dirty) {
       this.inspection = undefined
       return
@@ -354,7 +295,6 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
     */
     const blocking = (this.inspection?.findings ?? []).filter(finding => finding.blocking)
     const advisory = (this.inspection?.findings ?? []).filter(finding => !finding.blocking)
-    const appearanceChoiceNeeded = advisory.some(finding => finding.code === 'base-ratio-changed') && !this.keepChangedAppearance
 
     /*
       ── 「발행되나」에 **한 번만** 답한다 ─────────────────────────────────────
@@ -369,8 +309,6 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
       ? i18next.t('figure.text.release-needs-a-save-first')
       : released
         ? i18next.t('figure.text.already-released-edit-to-release-again')
-        : appearanceChoiceNeeded
-          ? i18next.t('figure.text.choose-appearance-change')
         : blocking.length
           ? i18next.t('figure.text.cannot-release-now')
           : ''
@@ -418,61 +356,9 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
               ${i18next.t('figure.button.fit-base-to-parts')}
             </button>`
           : nothing}
-        ${finding.code === 'parts-off-placement-face' && this.format === 'v2'
-          ? html`<button fit-base @click=${() => this.settleOnFloor()}>
-              ${i18next.t('figure.button.settle-on-floor')}
-            </button>`
-          : nothing}
-        ${finding.code === 'base-ratio-changed' && this.releasedBase
-          ? html`<div ratio-choice>
-              <button apply-fix @click=${() => this.restoreReleasedFootprint()}>
-                ${i18next.t('figure.button.restore-released-base')}
-              </button>
-              <button ?selected=${this.keepChangedAppearance} @click=${() => this.keepChangedFootprint()}>
-                ${i18next.t('figure.button.keep-changed-appearance')}
-              </button>
-            </div>
-            <span how-line><md-icon>info</md-icon>${i18next.t('figure.text.appearance-choice-explained')}</span>`
-          : nothing}
-        ${(finding.fixes ?? []).map(fix => html`
-          ${fix.safe ? html`
-            <button apply-fix @click=${() => this.applyFix(fix)}>
-              ${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)}>
-            ${i18next.t('figure.button.preview-fix', { part: fix.part, axis: fix.axis.toUpperCase(), from: fix.from ?? 'auto', to: fix.to })}
-          </button>
-        `)}
-        ${finding.fixPlan?.safe ? html`
-          <span how-line><md-icon>auto_fix_high</md-icon>${i18next.t('figure.text.recommended-fix-explained', { n: finding.fixPlan.fixes.length })}</span>
-          <button apply-fix @click=${() => this.applyFixPlan(finding.fixPlan!)}>
-            ${i18next.t('figure.button.apply-recommended-fix')}
-          </button>
-        ` : nothing}
     `)
   }
 
-  /**
-   * 게이트는 수정을 저장하지 않는다. 부모 모델러가 현재 정본과 이 한 수정안을 나란히 렌더하고,
-   * 저작자가 '변경 받기'를 눌렀을 때에만 자기 작업 사본에 적용한다.
-   */
-  private previewFix(fix: FigureGateFix) {
-    this.dispatchEvent(new CustomEvent('preview-sizing-fix', { detail: fix, bubbles: true, composed: true }))
-  }
-
-  /** 서버가 전수 재검사해 모든 차단 split이 사라진 후보만 작업 사본에 원클릭 적용한다. 저장은 하지 않는다. */
-  private applyFix(fix: FigureGateFix) {
-    if (!fix.safe) return
-    this.dispatchEvent(new CustomEvent('apply-sizing-fix', { detail: fix, bubbles: true, composed: true }))
-  }
-
-  /** Apply the server-remeasured coordinated repair to the draft only; save remains explicit. */
-  private applyFixPlan(plan: FigureGateFixPlan) {
-    if (!plan.safe || plan.fixes.length === 0) return
-    this.dispatchEvent(new CustomEvent('apply-sizing-fix-plan', { detail: plan, bubbles: true, composed: true }))
-  }
-
   /**
    * 넘친 것을 담는 길 하나를 여기서도 내민다 — **같은 동작이 속성 패널에도 있다**(「부품에 맞추기」).
    *
@@ -482,44 +368,19 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
    * 여전히 저작자가 따로 한다.
    */
   /**
-   * 「부품에 맞추기」를 내미는 판정. V2 는 기준 상자를 부품에 맞추고, V3 는 공간을 부품에서 다시 선언한다
-   * (`declare-occupancy`) — 둘 다 부품은 그대로 두고 선언만 바꾼다. V3 에서 공간을 아직 선언하지 않은 도형도
-   * 같은 단추로 선언한다: 새로 만든 V3 도형은 전부 그 판정으로 막히고, 화면에 다른 길이 없다.
-   *
-   * V3 의 장착면이 떠 있는 것은 여기 없다. 부품 하나를 평면에 붙이면 그 부품에 붙지 않은 것은 따라오지 않아
-   * V2 의 「바닥에 앉히기」와 뜻이 다르다. 판정의 「어떻게」가 할 일을 말한다.
+   * 「부품에 맞추기」를 내미는 판정: 공간을 부품에서 다시 선언한다(`declare-occupancy`) — 부품은 그대로 두고 선언만
+   * 바꾼다. 공간을 아직 선언하지 않은 도형도 같은 단추로 선언한다: 새로 만든 도형은 전부 그 판정으로 막히고, 화면에
+   * 다른 길이 없다. 장착면이 떠 있는 것은 여기 없다 — 부품 하나를 평면에 붙여도 거기 붙지 않은 것은 따라오지 않는다.
+   * 판정의 「어떻게」가 할 일을 말한다.
    */
   private offersFit(code: string): boolean {
-    return this.format === 'v3'
-      ? code === 'part-outside-occupancy' || code === 'occupancy-undeclared'
-      : code === 'part-outside-base'
+    return code === 'part-outside-occupancy' || code === 'occupancy-undeclared'
   }
 
   private fitBase() {
     this.dispatchEvent(new CustomEvent('fit-base-to-parts', { bubbles: true, composed: true }))
   }
 
-  /**
-   * 떠 있는 것을 앉힌다. 부품 하나를 고르고 「바닥에」를 누르는 길은 전부터 있었으나, 그 길은
-   * 고른 것 하나만 옮기고 **여기서는 닿지 않는다.** 막혔다는 말을 읽은 자리에서 조치가 되게 한다.
-   */
-  private settleOnFloor() {
-    this.dispatchEvent(new CustomEvent('settle-parts-on-floor', { bubbles: true, composed: true }))
-  }
-
-  /** 기준 상자의 X·Z만 직전 발행값으로 되돌린다. Y와 부품 편집은 보존한다. */
-  private restoreReleasedFootprint() {
-    if (!this.releasedBase) return
-    this.dispatchEvent(new CustomEvent('restore-released-footprint', {
-      detail: { x: this.releasedBase.x, z: this.releasedBase.z }, bubbles: true, composed: true
-    }))
-  }
-
-  /** 현재 외형으로 발행하겠다는 명시적 선택이다. 저장·발행은 이어서 따로 한다. */
-  private keepChangedFootprint() {
-    this.keepChangedAppearance = true
-  }
-
   private renderVersion(version: FigureVersion) {
     return html`
       <li>

package/client/modeller/figure-v3-capability.ts

@@ -9,7 +9,7 @@ import { SidePanelStyles } from './side-panel-styles.js'
 
 /*
   One rung per set of the format's capability names. Typed as the format's names, so a misspelt rung does not pass
-  (ADR-0051 ④, the V2 ladder's lesson).
+  (ADR-0051 ④).
 */
 type Rung = 'none' | 'hold' | 'flow'
 const RUNGS: Readonly<Record<Rung, readonly FigureCapability[]>> = Object.freeze({
@@ -28,7 +28,7 @@ export function rungOf(names: readonly string[] | undefined): Rung | null {
 }
 
 /**
- * 자리·능력 — what the figure does on a board (V2's 「능력」 tab, parity row ⑤): the ladder from drawing only, to
+ * 자리·능력 — what the figure does on a board: the ladder from drawing only, to
  * holding things, to passing them on, and every place things are held, whatever part it is on. A place is not drawn,
  * so the list is the only way to find one; choosing a row selects its part, where the place is edited.
  */

package/client/modeller/figure-v3-clips.ts

@@ -11,10 +11,10 @@ import { SidePanelStyles } from './side-panel-styles.js'
 import { HelpToggles } from './v3-help.js'
 
 /**
- * 클립 — V2's animations (parity row ⑥): controls played by keys over time. A clip is one clock; each track plays one
+ * 클립 — controls played by keys over time. A clip is one clock; each track plays one
  * control. Scrubbing a clip shows its pose at that moment (one batch of input changes, not saved as the default); a key
  * is added at the scrubbed moment with the control's value there, so a pose is made with the controls' sliders and
- * then kept as a key -- the way V2's recorder worked. Every change is one part edit.
+ * then kept as a key. Every change is one part edit.
  */
 @customElement('figure-v3-clips')
 export class FigureV3Clips extends localize(i18next)(LitElement) {

package/client/modeller/figure-v3-controls.ts

@@ -11,7 +11,7 @@ import { dialShape } from './angle-dial.js'
 import { SidePanelStyles } from './side-panel-styles.js'
 
 /**
- * The figure's controls (parity row ⑥, V2's parameters and its pose tools): each value a board sets to pose the figure,
+ * The figure's controls and its pose tools: each value a board sets to pose the figure,
  * with a slider to try it, its name, range and travel time, and a button that keeps the pose being looked at as the
  * pose it stands in when placed.
  *
@@ -25,7 +25,7 @@ export class FigureV3Controls extends localize(i18next)(LitElement) {
     :host {
       display: block;
     }
-    /* One control, one line: its name, a dial for an angle, a thin slider, the value (V2's preview row). */
+    /* One control, one line: its name, a dial for an angle, a thin slider, the value. */
     div[control] {
       display: grid;
       grid-template-columns: minmax(0, 1fr) 18px minmax(64px, 1.2fr) 58px 22px;

package/client/modeller/figure-v3-first-save.ts

@@ -10,7 +10,7 @@ import '@material/web/button/text-button.js'
 import { firstSaveRefusalOf, releasableType, typeOf, type FirstSave } from './v3-first-save.js'
 
 /**
- * The first save of a new figure: its type and its name, asked once (V2's save dialog, in the suite's popup look).
+ * The first save of a new figure: its type and its name, asked once, in the suite's popup look.
  * Closes with the answer, or with nothing when cancelled -- then nothing is saved.
  */
 @customElement('figure-v3-first-save')

package/client/modeller/figure-v3-links.ts

@@ -60,14 +60,14 @@ const freshRow = () => ({ axis: '' as Axis | '', pitch: 200, fills: true, count:
 const freshPlace = () => ({ role: 'grip' as 'seat' | 'grip', face: 'top' as V3Face, label: '', accepts: '', capacity: 1 })
 
 /**
- * What a part is tied to — its size response, what it is fastened to, how it moves (parity rows ④ ⑤ ⑥).
+ * What a part is tied to — its size response, what it is fastened to, how it moves.
  *
  * 「Build Once, Fit Anywhere」 lives here: a dimension that follows the instance size or another part is what lets
  * a figure be placed at any size, and a part fastened to the face it rests on is what keeps it there when that
  * happens. The release gate refuses a figure that falls apart when resized, and tells the author to fasten the
- * parts that come away — this is where they do it. Motion is the V2 joint: a slide or a turn driven by a control.
+ * parts that come away — this is where they do it. Motion is a joint: a slide or a turn driven by a control.
  *
- * The V2 inspector has these as its dimensions, placement and joint sections, in that order; so does this. Every
+ * The sections are dimensions, placement and joint, in that order. Every
  * change is one figure-model authoring command, sent as `v3-command` and run by the editor through the session — one
  * step of the undo history. Choices the command would refuse (a round body fastened, a size following an instance
  * size the figure does not declare) are not offered, so the author is not sent into a refusal.
@@ -158,7 +158,7 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
     `
   }
 
-  /** Where things are held on this part: a seat things rest on, or a grip things are held in (parity row ⑤). */
+  /** Where things are held on this part: a seat things rest on, or a grip things are held in. */
   private renderPlaces(asset: V3Asset) {
     const faces = placeFacesOf(asset, this.partId)
     const p = this.place
@@ -294,7 +294,7 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
     }
     const [of, a, b] = choice.split(':')
     if (of === 'share') {
-      /* V2's proportional rule: this measure is the share of the instance size it is now, so it grows with the figure. */
+      /* A proportional rule: this measure is the share of the instance size it is now, so it grows with the figure. */
       const size = asset.designInputs[`size.${a}`]
       if (!size) return
       const times = Math.round((current / size) * 1e6) / 1e6
@@ -306,7 +306,7 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
   }
 
   /**
-   * Positions worked out from other values — V2's anchor rules, as the converter wrote them — each with the way to
+   * Positions worked out from other values, each with the way to
    * keep it where it is. This is the way out the release gate names when a resize leaves a part in the air.
    */
   private renderPositions(asset: V3Asset) {

package/client/modeller/figure-v3-material.ts

@@ -7,7 +7,7 @@ import { activePalette } from '@hatiolab/things-scene'
 import type { V3AssetGeometry, V3Material, V3PartEdit } from '@hatiolab/figure-model'
 import { SidePanelStyles } from './side-panel-styles.js'
 
-/** The purpose each palette role is for, by its token — the V2 inspector's words for the same roles. */
+/** The purpose each palette role is for, by its token. */
 const PURPOSE: Record<string, string> = {
   'palette.primary': 'primary',
   'palette.accent': 'accent',
@@ -27,15 +27,15 @@ const ROUND = new Set(['cylinder', 'ellipticCylinder', 'sphere', 'frustum'])
 const DEFAULT_SEGMENTS = 12
 
 /**
- * 재질 — a V3 part's material, drawn as the V2 inspector draws it (V3 parity row ③).
+ * 재질 — a V3 part's material.
  *
- * The V3 editor showed the colour role as a raw token (`palette.dark`) in a select and nothing else. The V3 material
+ * An earlier editor showed the colour role as a raw token (`palette.dark`) in a select and nothing else. The V3 material
  * holds the colour role, a preset, transparency and a glow; a round body also has how finely its rim is drawn. This
- * shows those, with the V2 words: painted colours and lit colours as two groups of swatches, each named for what it
+ * shows those: painted colours and lit colours as two groups of swatches, each named for what it
  * is for.
  *
- * Not here, because a V3 material has no place for them: flat shading and casting shadows (V2 fields the converter
- * does not carry). The glow's colour comes from the lit colours, as in V2.
+ * Not here, because a V3 material has no place for them: flat shading and casting
+ * shadows. The glow's colour comes from the lit colours.
  *
  * Every change leaves as one `v3-part-edit`; the editor runs it through the session, one step of the undo history.
  */
@@ -75,7 +75,7 @@ export class FigureV3Material extends localize(i18next)(LitElement) {
       font: inherit;
       min-width: 0;
     }
-    /* V2's segment picker: the four common counts as their silhouettes with their triangle cost, the rest folded. */
+    /* The segment picker: the four common counts as their silhouettes with their triangle cost, the rest folded. */
     div[segments] {
       display: grid;
       grid-template-columns: repeat(4, 1fr);
@@ -102,7 +102,7 @@ export class FigureV3Material extends localize(i18next)(LitElement) {
       background-color: var(--md-sys-color-primary-container);
       border-color: transparent;
     }
-    /* Small, and 12 and 16 both read as circles: large enough for the corners to show (V2). */
+    /* Small, and 12 and 16 both read as circles: large enough for the corners to show. */
     button[seg] svg {
       display: block;
       width: 32px;
@@ -166,7 +166,7 @@ export class FigureV3Material extends localize(i18next)(LitElement) {
     if (!part) return nothing
     const material = part.material
     /*
-      The roles offered are the app's palette, as in V2, with any the asset carries beyond it. A new asset carries
+      The roles offered are the app's palette, with any the asset carries beyond it. A new asset carries
       only its primary colour; a role it lacks is sent with its colour and added in the same edit (`put`).
     */
     const entries = Object.entries(this.offered())
@@ -282,7 +282,7 @@ export class FigureV3Material extends localize(i18next)(LitElement) {
     return { ...(activePalette() as Record<string, string>), ...this.palette }
   }
 
-  /** Intensity 0 is no glow at all, as in V2; a new glow takes the part's own colour until another is picked. */
+  /** Intensity 0 is no glow at all; a new glow takes the part's own colour until another is picked. */
   private glow(intensity: number, live = false) {
     const material = this.body!.material
     this.glowing = live ? intensity : undefined
@@ -310,7 +310,7 @@ export class FigureV3Material extends localize(i18next)(LitElement) {
   }
 }
 
-/** A regular polygon of this many sides -- how round a body with this rim count looks from its end (V2). */
+/** A regular polygon of this many sides -- how round a body with this rim count looks from its end. */
 function silhouette(segments: number) {
   const points: string[] = []
   for (let i = 0; i < segments; i++) {

package/client/modeller/figure-v3-parts.ts

@@ -11,14 +11,12 @@ import { partLabelOf } from './v3-fields.js'
 /**
  * 도형 팔레트와 부품 목록 — V3 자산의 것.
  *
- * `figure-parts`(V2) 와 **같은 자리, 같은 조작, 같은 낱말**이다. 저작자가 V2 에서 익힌 손이 그대로
- * 가야 한다: 팔레트는 목록 위에, 눈 단추는 늘 자리를 차지하고, 조작은 고른 줄에서만 보인다.
+ * 팔레트는 목록 위에, 눈 단추는 늘 자리를 차지하고, 조작은 고른 줄에서만 보인다.
  *
- * 다른 것은 읽는 대상뿐이다. V2 는 부품의 `primitive` 를 읽었고 여기서는 V3 평가가 준 `provider` 를
- * 읽는다. 「숨김」은 여기서도 **작업대의 것**이다 — 저장되지 않고, 자산의 `visibility`(상태에 따라
+ * 부품의 도형은 V3 평가가 준 `provider` 로 읽는다. 「숨김」은 여기서도 **작업대의 것**이다 — 저장되지 않고, 자산의 `visibility`(상태에 따라
  * 보이고 안 보이는 것)와는 다른 것이다. 그것은 속성 패널의 몫이다.
  *
- * 이 컴포넌트는 정본을 만지지 않는다. 무엇을 하겠다는 것만 알린다 — V2 와 같은 규칙, 같은 사건 이름.
+ * 이 컴포넌트는 정본을 만지지 않는다. 무엇을 하겠다는 것만 알린다.
  */
 
 /** 한 줄 — V3 평가에서 이 패널이 읽는 것만. */
@@ -50,8 +48,7 @@ const PROVIDER_ICON: Record<string, string> = {
 
 /** 팔레트 — 저작 API 가 만들 수 있는 것만 보인다. */
 /*
-  The palette: V2's shapes. A plate and a wall are boxes of a shape a person reaches for (V2 drew both as boxes), so
-  they are starting sizes, not kinds of their own.
+  The palette. A plate and a wall are boxes of a shape a person reaches for, so they are starting sizes, not kinds of their own.
 */
 export type V3PaletteKind = V3PrimitiveCreation['kind'] | 'plate' | 'wall'
 const RECIPES: Array<{ kind: V3PaletteKind; icon: string; label: string }> = [
@@ -359,11 +356,11 @@ export class FigureV3Parts extends localize(i18next)(LitElement) {
   @property({ type: Boolean }) locked = false
   /**
    * 이 도형이 치르는 값 — 삼각형 · 묶음 · 한 화면에 몇 대 · 등급. 부품을 더하는 바로 그 자리에서 보여야 로우폴리의
-   * 기준이 저작을 이끈다(V2 모델러의 정체성). 등급이 D 면 무엇이 넘쳤는지를 적는다. 누르면 성숙도 탭이 열린다.
+   * 기준이 저작을 이끈다. 등급이 D 면 무엇이 넘쳤는지를 적는다. 누르면 성숙도 탭이 열린다.
    */
   @property({ attribute: false }) budget?: V3BudgetLine
   /**
-   * 디테일 등급의 부품 한도 — V2 의 S/M/L(사용자 2026-09-24). 부품을 넣기 **전에** 몇 개 남았는지 보이고, 다 차면 팔레트가
+   * 디테일 등급(S/M/L)의 부품 한도(사용자 2026-09-24). 부품을 넣기 **전에** 몇 개 남았는지 보이고, 다 차면 팔레트가
    * 잠긴다. 되풀이는 한 부품으로 센다. 등급을 안 정했으면 한도는 없다.
    */
   @property({ attribute: false }) partBudget?: { level: 'S' | 'M' | 'L' | null; used: number; limit: number | null }
@@ -411,7 +408,7 @@ export class FigureV3Parts extends localize(i18next)(LitElement) {
     `
   }
 
-  /** 디테일 등급 — 고르면 한도가 바뀐다. V2 의 자리 그대로, 목록 머리 아래. */
+  /** 디테일 등급 — 고르면 한도가 바뀐다. 목록 머리 아래. */
   private renderLevel() {
     const b = this.partBudget
     if (!b) return nothing

package/client/modeller/figure-v3-preview.ts

@@ -11,15 +11,15 @@ import { dialShape } from './angle-dial.js'
 import { authoredSizeOf, PREVIEW_FACTOR, PREVIEW_WAYS, previewClampsOf, previewInstances } from './v3-preview-model.js'
 
 /**
- * The figure placed on a board -- V2's preview, for a V3 figure.
+ * The figure placed on a board.
  *
  * The editing canvas shows the figure at the size it was made. Half of what a figure is lies in how it answers a
  * different size, so here the figure being authored is registered as a board registers it and placed as
  * `FigureInstance`s: the size it was made, and each of the seven ways of growing one, two or three axes twice as
- * large, side by side at one scale, four to a row (V2's eight). The board draws them as it will on a real board --
+ * large, side by side at one scale, four to a row. The board draws them as it will on a real board --
  * placement, lights, environment, the same V3 renderer.
  *
- * The controls are V2's too: each value that poses the figure with a slider (and a dial for an angle), each clip's
+ * The controls: each value that poses the figure with a slider (and a dial for an angle), each clip's
  * speed, and 「이 자세를 기본으로」 to keep the pose as the one it stands in. Nothing here is edited; the canvas edits.
  */
 

package/client/modeller/figure-v3-properties.ts

@@ -17,11 +17,10 @@ const PLACEMENTS: Placement[] = ['floor', 'ceiling', 'center', 'wall']
 const FACES = Object.keys(V3_FACES) as V3Face[]
 
 /**
- * 속성 — the V3 modeller's figure properties (parity row ②).
+ * 속성 — the modeller's figure properties.
  *
- * The V2 inspector opens with what the figure is: its name, the face it is placed by, the room it takes up, where
- * the catalogue files it. The V3 page had only the type. The same rows, in the same order, drawn the way the V2
- * inspector draws them.
+ * The tab opens with what the figure is: its name, the face it is placed by, the room it takes up, where the
+ * catalogue files it.
  *
  * Two kinds of change leave this tab, and it does neither itself:
  *  - `v3-command` carries an authoring command (rename, declare the room, the mounting face). The page runs it
@@ -30,7 +29,7 @@ const FACES = Object.keys(V3_FACES) as V3Face[]
  *    to the saved row at once, so they need a saved figure.
  *
  * Not here yet, because V3 has no place for them: editing the declared room by hand (V3 declares it from the
- * parts, as graph expressions), and the detail level (the converter records it as lost). Both wait on a V3 ruling.
+ * parts, as graph expressions), and the detail level. Both wait on a V3 ruling.
  */
 @customElement('figure-v3-properties')
 export class FigureV3Properties extends localize(i18next)(LitElement) {
@@ -81,7 +80,7 @@ export class FigureV3Properties extends localize(i18next)(LitElement) {
   render() {
     const facts = this.facts()
     if (!facts) return nothing
-    /* The figure's type is the page's (it lives on the row); it is slotted into the first section, as V2 had it. */
+    /* The figure's type is the page's (it lives on the row); it is slotted into the first section. */
     return html`<section>
         <h3>${i18next.t('figure.label.group-figure')}</h3>
         <slot name="type"></slot>

package/client/modeller/figure-v3-verdict.ts

@@ -19,12 +19,12 @@ import type { V3BudgetUse, V3MaturityAxis, V3Report } from './v3-maturity.js'
 export const VERDICT_SETTLE_MS = 400
 
 /**
- * 성숙도 — the V3 modeller's verdict while editing (parity row ①), laid out as V2's report (`figure-report.ts`).
+ * 성숙도 — the modeller's verdict while editing.
  *
- * V2's report showed, as the author edits: how many fit on one screen with the grade beside it and the budget that
+ * It shows, as the author edits: how many fit on one screen with the grade beside it and the budget that
  * decided the grade, the grade scale, six maturity axes as a radar and a list, the budget bars, the drawing cost,
- * the reuse trend, and the findings. The first V3 tab kept only the count and the findings (user, 2026-09-24:
- * 「분석부분도 많이 부족하고, 왜 이렇게 너프되었는지」). This is V2's report again, over V3 numbers.
+ * the reuse trend, and the findings. An earlier tab kept only the count and the findings (user, 2026-09-24:
+ * 「분석부분도 많이 부족하고, 왜 이렇게 너프되었는지」).
  *
  * ## What is computed where
  *
@@ -34,15 +34,14 @@ export const VERDICT_SETTLE_MS = 400
  *
  * The findings do not come from here: they come from the server's release door (`inspectFigureDraft`), the same
  * door and the same sentences as the release panel. A second judgement on the screen would say something different
- * the first time either changed. V2's report drew its findings from `validate`; V3's release judgement is the
- * server's, so that section is the server's answer.
+ * the first time either changed. The release judgement is the server's, so that section is the server's answer.
  *
  * ## The grade
  *
  * figure-model's `v3ScoreOf`, which the catalogue uses too: headroom against placing `LIMITS.screenInstances` of the
  * figure on one screen (chief architect, 2026-09-24) -- the screen's measured groups and its triangle target shared
- * per instance -- and V2's rule limits for independently moved parts and transparent materials, decided by the
- * tightest, on V2's scale. The two V2 budgets V3 has no field for are left out and the tab says so.
+ * per instance -- and the rule limits for independently moved parts and transparent materials, decided by the
+ * tightest. The two budgets V3 has no field for are left out and the tab says so.
  */
 /** A per-instance share of the screen is not a whole number; what an instance may draw is the whole part of it. */
 const limitOf = (use: V3BudgetUse) => Math.floor(use.limit).toLocaleString()
@@ -566,7 +565,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
     `
   }
 
-  /** V2's radar: rings at a third, two thirds and full, short names so the left edge is not cut. */
+  /** The radar: rings at a third, two thirds and full, short names so the left edge is not cut. */
   private renderRadar(axes: V3MaturityAxis[]) {
     const cx = 60
     const cy = 46
@@ -671,7 +670,7 @@ export class FigureV3Verdict extends localize(i18next)(LitElement) {
   }
 
   /**
-   * The trend at its own size — V2's chart: both axes logarithmic, the growing lines against the flat ones, and a
+   * The trend at its own size: both axes logarithmic, the growing lines against the flat ones, and a
    * legend with each line's value at the last count.
    */
   private renderSheet(report: V3Report) {

package/client/modeller/figure-view.ts

@@ -4,9 +4,8 @@
  * ## 저장되지 않는다
  *
  * 이것은 자산이 아니라 **작업대**다. 조명을 밝게 하고 바닥을 켠 것은 그 사람이 지금
- * 보기 편한 상태일 뿐, 그 자산의 성질이 아니다. 그래서 `FigureSource` 에 안 들어간다 —
- * `toFigureSource` 는 판에서 `width` · `height` · `depth` 와 몇 가지만 집어 가고 나머지는
- * 버린다.
+ * 보기 편한 상태일 뿐, 그 자산의 성질이 아니다. 그래서 자산에 안 들어가고, 보는 사람의
+ * 브라우저에 남는다.
  *
  * 다른 사람이 같은 자산을 열면 자기 설정으로 본다. 그것이 맞다.
  *