@things-factory/figure-ui 10.1.50 → 10.1.52

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

@@ -13,6 +13,7 @@ import {
   alignOf,
   AXES,
   canFasten,
+  facesOf,
   canFollow,
   dimensionNow,
   followableAxes,
@@ -28,6 +29,7 @@ import {
   placeFacesOf,
   placeIdFor,
   placesOn,
+  rowAxesOf,
   positionsWorkedOut,
   type Alignment,
   type Axis,
@@ -39,6 +41,21 @@ import { HelpToggles } from './v3-help.js'
 
 const FACES = Object.keys(V3_FACES) as V3Face[]
 
+const freshFasten = () => ({
+  face: 'bottom' as V3Face,
+  toPlane: false,
+  target: '',
+  targetFace: 'top' as V3Face,
+  facing: 'meet' as 'meet' | 'flush',
+  gap: 0,
+  twist: 0,
+  align: {} as Partial<Record<Axis, Alignment>>,
+  alignMm: {} as Partial<Record<Axis, number>>
+})
+const freshMotion = (): MotionForm => ({ kind: 'slide', axis: 'x', id: '', min: 0, max: 500, follow: '', multiplier: 1, offset: 0 })
+const freshRow = () => ({ axis: '' as Axis | '', pitch: 200, fills: true, count: 5 })
+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 ④ ⑤ ⑥).
  *
@@ -84,9 +101,23 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
   /** Which ties this shows: the part's shape (size and placement, in 속성), its places (자리·능력) or its motion (움직임). */
   @property() section: 'shape' | 'places' | 'motion' = 'shape'
 
-  @state() private fasten = { face: 'bottom' as V3Face, toPlane: false, target: '', targetFace: 'top' as V3Face, facing: 'meet' as 'meet' | 'flush', gap: 0, align: {} as Partial<Record<Axis, Alignment>>, alignMm: {} as Partial<Record<Axis, number>> }
-  @state() private motion: MotionForm = { kind: 'slide', axis: 'x', id: '', min: 0, max: 500, follow: '', multiplier: 1, offset: 0 }
-  @state() private place = { role: 'grip' as 'seat' | 'grip', face: 'top' as V3Face, label: '', accepts: '', capacity: 1 }
+  @state() private fasten = freshFasten()
+  @state() private motion: MotionForm = freshMotion()
+  @state() private place = freshPlace()
+  @state() private row = freshRow()
+
+  /*
+    The forms describe the next command for the selected part, so another part starts from the defaults: carrying the
+    last part's choices over fastened a shutter curtain level with a right edge nobody chose for it (2026-09-25).
+  */
+  willUpdate(changed: Map<string, unknown>) {
+    if (changed.has('partId') && changed.get('partId') !== undefined) {
+      this.fasten = freshFasten()
+      this.motion = freshMotion()
+      this.place = freshPlace()
+      this.row = freshRow()
+    }
+  }
 
   render() {
     const asset = this.asset
@@ -107,6 +138,7 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
         ${this.renderPositions(asset)}
         ${canFasten(asset, this.partId) ? this.renderFastening(asset) : html`<p hint>${i18next.t('figure.text.links-need-a-box')}</p>`}
       </section>
+      ${this.renderRow(asset)}
     `
   }
 
@@ -259,6 +291,13 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
     const to = fastenedTo(asset, this.partId)
     const f = this.fasten
     const targets = asset.appearance.map(look => look.target).filter(one => one !== this.partId && canFasten(asset, one))
+    /* The faces are the ones each shape declares: a part is fastened by one of its outer faces, to any face of the target. */
+    const mineFaces = facesOf(asset, this.partId).filter(face => FACES.includes(face as V3Face))
+    const myFace = mineFaces.includes(f.face) ? f.face : (mineFaces[0] as V3Face)
+    const theirFaces = f.target ? facesOf(asset, f.target) : FACES
+    const targetFace = theirFaces.includes(f.targetFace) ? f.targetFace : theirFaces[0]!
+    const aim = f.toPlane ? ('plane' as const) : { part: f.target, face: targetFace }
+    const align = f.target || f.toPlane ? alignOf(asset, this.partId, aim, f.align, f.alignMm, !!f.twist) : undefined
     return html`
       ${to
         ? html`<div pair>
@@ -271,7 +310,7 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
       <div form>
         <span>${i18next.t('figure.label.my-face')}</span>
         <select @change=${(e: Event) => (this.fasten = { ...f, face: (e.target as HTMLSelectElement).value as V3Face })}>
-          ${FACES.map(face => html`<option value=${face} ?selected=${face === f.face}>${i18next.t('figure.label.face-' + face)}</option>`)}
+          ${mineFaces.map(face => html`<option value=${face} ?selected=${face === myFace}>${i18next.t('figure.label.face-' + face)}</option>`)}
         </select>
       </div>
       <label toggle>
@@ -288,7 +327,7 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
             </select>
             <span>${i18next.t('figure.label.target-face')}</span>
             <select @change=${(e: Event) => (this.fasten = { ...f, targetFace: (e.target as HTMLSelectElement).value as V3Face })}>
-              ${FACES.map(face => html`<option value=${face} ?selected=${face === f.targetFace}>${i18next.t('figure.label.face-' + face)}</option>`)}
+              ${theirFaces.map(face => html`<option value=${face} ?selected=${face === targetFace}>${i18next.t('figure.label.face-' + face)}</option>`)}
             </select>
             <span>${i18next.t('figure.label.facing-meet')}</span>
             <select @change=${(e: Event) => (this.fasten = { ...f, facing: (e.target as HTMLSelectElement).value as 'meet' | 'flush' })}>
@@ -296,10 +335,12 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
               <option value="flush" ?selected=${f.facing === 'flush'}>${i18next.t('figure.label.facing-flush')}</option>
             </select>
           </div>`}
-      ${this.renderAlignment()}
+      ${this.renderAlignment(f.toPlane || f.target ? alignAxesOf(asset, this.partId, aim, !!f.twist) : [])}
       <div form>
         <span>${i18next.t('figure.label.gap')}</span>
         <input type="number" step="any" .value=${String(f.gap)} @change=${(e: Event) => (this.fasten = { ...f, gap: Number((e.target as HTMLInputElement).value) || 0 })} />
+        <span>${i18next.t('figure.label.twist')}</span>
+        <input type="number" step="any" .value=${String(f.twist)} @change=${(e: Event) => (this.fasten = { ...f, twist: Number((e.target as HTMLInputElement).value) || 0 })} />
       </div>
       <button
         act
@@ -308,11 +349,12 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
           this.command({
             kind: 'attach',
             part: this.partId,
-            face: f.face,
-            to: f.toPlane ? { plane: 'mounting-plane' } : { part: f.target, face: f.targetFace },
+            face: myFace,
+            to: f.toPlane ? { plane: 'mounting-plane' } : { part: f.target, face: targetFace },
             ...(f.toPlane ? {} : { facing: f.facing }),
             ...(f.gap ? { gap: f.gap } : {}),
-            ...(alignOf(f.toPlane ? 'plane' : f.targetFace, f.align, f.alignMm) ? { align: alignOf(f.toPlane ? 'plane' : f.targetFace, f.align, f.alignMm) } : {}),
+            twist: f.twist,
+            ...(align ? { align } : {}),
             replace: !!to
           } as V3AuthoringAction)}
       >
@@ -325,12 +367,12 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
    * Where on the target face the part sits, on the two axes across it: centred, level with the target's edge on
    * either side, or a distance off centre. A door hung level with the frame's front edge turns about that edge.
    */
-  private renderAlignment() {
+  private renderAlignment(axes: { axis: Axis; edges: boolean }[]) {
     const f = this.fasten
     const set = (axis: Axis, how: Alignment) => (this.fasten = { ...f, align: { ...f.align, [axis]: how } })
     const setMm = (axis: Axis, mm: number) => (this.fasten = { ...f, alignMm: { ...f.alignMm, [axis]: mm } })
     return html`<div form>
-      ${alignAxesOf(f.toPlane ? 'plane' : f.targetFace).map(({ axis, edges }) => {
+      ${axes.map(({ axis, edges }) => {
         const how = f.align[axis] === 'min' || f.align[axis] === 'max' ? (edges ? f.align[axis]! : 'centre') : (f.align[axis] ?? 'centre')
         return html`<span>${i18next.t('figure.label.align-' + axis)}</span>
           <select @change=${(e: Event) => set(axis, (e.target as HTMLSelectElement).value as Alignment)}>
@@ -348,6 +390,47 @@ export class FigureV3Links extends localize(i18next)(LitElement) {
     </div>`
   }
 
+  /**
+   * Making the part a row across what it is fastened to (figure-model `make-repeat`): along one of the axes across its
+   * face, copies a pitch apart filling the parent's length, or a count spread over it. Once made, the row's own section
+   * (the editor's) shows it and takes it away.
+   */
+  private renderRow(asset: V3Asset) {
+    const axes = rowAxesOf(asset, this.partId)
+    if (!axes.length) return nothing
+    const r = this.row
+    const axis = axes.includes(r.axis as Axis) ? (r.axis as Axis) : axes[0]!
+    const ok = r.pitch > 0 && (r.fills || (Number.isSafeInteger(r.count) && r.count >= 1))
+    return html`<section>
+      <h3>${i18next.t('figure.label.repeat')}</h3>
+      <div form>
+        <span>${i18next.t('figure.label.repeat-axis')}</span>
+        <select @change=${(e: Event) => (this.row = { ...r, axis: (e.target as HTMLSelectElement).value as Axis })}>
+          ${axes.map(a => html`<option value=${a} ?selected=${a === axis}>${a.toUpperCase()}</option>`)}
+        </select>
+        <span>${i18next.t('figure.label.repeat-pitch')} (mm)</span>
+        <input type="number" step="any" min="0" .value=${String(r.pitch)} @change=${(e: Event) => (this.row = { ...r, pitch: Number((e.target as HTMLInputElement).value) })} />
+      </div>
+      <label toggle>
+        <input type="checkbox" .checked=${r.fills} @change=${(e: Event) => (this.row = { ...r, fills: (e.target as HTMLInputElement).checked })} />
+        ${i18next.t('figure.label.repeat-fills')}
+      </label>
+      ${r.fills
+        ? nothing
+        : html`<div form>
+            <span>${i18next.t('figure.label.repeat-count')}</span>
+            <input type="number" step="1" min="1" .value=${String(r.count)} @change=${(e: Event) => (this.row = { ...r, count: Number((e.target as HTMLInputElement).value) })} />
+          </div>`}
+      <button
+        act
+        ?disabled=${this.locked || !ok}
+        @click=${() => this.command({ kind: 'make-repeat', part: this.partId, axis, pitch: r.pitch, ...(r.fills ? {} : { count: r.count }) } as V3AuthoringAction)}
+      >
+        <md-icon>view_week</md-icon>${i18next.t('figure.button.make-repeat')}
+      </button>
+    </section>`
+  }
+
   private renderMotion(asset: V3Asset) {
     const now = motionOf(asset, this.partId)
     const joint = asset.joints?.find(j => j.body1.part === this.partId)

package/client/modeller/v3-editor.ts

@@ -31,7 +31,7 @@ import { nudgeOf } from './v3-stage-model.js'
 import { sizeRangeRefusalOf } from './v3-refusals.js'
 import type { V3RenderPart } from './v3-renderer.js'
 import type { V3BudgetLine } from './v3-maturity.js'
-import { instanceRangeOf, rangeDiffers, turnsAboutAJoint } from './v3-links.js'
+import { instanceRangeOf, instanceRangeToDeclare, rangeDiffers, turnsAboutAJoint } from './v3-links.js'
 import { jointFanOf } from './v3-joint-fan.js'
 import { jointDragOf } from './v3-joint-drag.js'
 import type { FirstSave } from './v3-first-save.js'
@@ -721,7 +721,7 @@ export class FigureV3Editor extends LitElement {
     label.addEventListener('pointercancel', up)
   }
   /** The measured range, kept for the revision it was measured at: measuring evaluates the figure at its edges. */
-  private range?: { at: string; of: ReturnType<typeof instanceRangeOf> }
+  private range?: { at: string; of: ReturnType<typeof instanceRangeOf>; toDeclare?: ReturnType<typeof instanceRangeToDeclare> }
   /** The sizes a board may give the figure, and the way to measure them again after its parts changed. */
   private renderInstanceRange(asset: V3Asset | undefined, unavailable: boolean) {
     if (!asset) return nothing
@@ -729,14 +729,30 @@ export class FigureV3Editor extends LitElement {
     const at = `${this.session?.read().context ?? ''}:${this.revision}`
     if (this.range?.at !== at) {
       let of: ReturnType<typeof instanceRangeOf>
+      let toDeclare: ReturnType<typeof instanceRangeToDeclare>
       try {
         of = instanceRangeOf(asset)
       } catch {
         of = undefined
       }
-      this.range = { at, of }
+      try {
+        toDeclare = of ? undefined : instanceRangeToDeclare(asset)
+      } catch {
+        toDeclare = undefined
+      }
+      this.range = { at, of, toDeclare }
     }
     const range = this.range.of
+    /* No size yet: the figure is declared its size from its parts, so a board can resize it and parts can follow it. */
+    const toDeclare = this.range.toDeclare
+    if (!range && toDeclare)
+      return html`<section>
+        <h3>${i18next.t('figure.label.instance-range')}</h3>
+        <p hint>${i18next.t('figure.text.instance-size-undeclared')}</p>
+        <button act ?disabled=${unavailable} @click=${() => this.linkCommand({ kind: 'declare-instance-size', range: toDeclare.range, at: toDeclare.at })}>
+          <md-icon>straighten</md-icon>${i18next.t('figure.button.declare-instance-size')}
+        </button>
+      </section>`
     if (!range) return nothing
     const mm = (v: number) => Math.round(v).toLocaleString()
     const differs = rangeDiffers(range.declared, range.measured)
@@ -855,6 +871,11 @@ export class FigureV3Editor extends LitElement {
             })
           : i18next.t(fits ? 'figure.text.repeat-fits-length' : 'figure.text.repeat-fixed-count')}
       </p>
+      ${asset.joints?.some(j => j.body1.part === this.selected && j.repeat)
+        ? html`<button act ?disabled=${unavailable} @click=${() => this.run(() => this.session!.command({ kind: 'remove-repeat', part: this.selected }))}>
+            <md-icon>close</md-icon>${i18next.t('figure.button.remove-repeat')}
+          </button>`
+        : nothing}
     </section>`
   }
   /**

package/client/modeller/v3-links.ts

@@ -1,4 +1,4 @@
-import { V3_FACES, compileV3Graph, defaultInstanceSizeRange, foldInstanceSizeRange, v3AttachmentsOf, v3BindingsOf, v3InstanceSizeLimitsOf } from '@hatiolab/figure-model'
+import { V3_FACES, v3ShapeFaces, proposeV3Occupancy, compileV3Graph, defaultInstanceSizeRange, foldInstanceSizeRange, v3AttachmentsOf, v3BindingsOf, v3InstanceSizeLimitsOf } from '@hatiolab/figure-model'
 import type { V3SizeRange } from '@hatiolab/figure-model'
 import type { V3Asset, V3BindingPlace, V3Face, V3Joint } from '@hatiolab/figure-model'
 
@@ -115,29 +115,73 @@ export function dimensionNow(asset: V3Asset, part: string, axis: Axis): number |
   }
 }
 
-/** Whether `attach` can take this part: a box, or a cylinder (figure-model measures its faces since 0.1.47). */
-export function canFasten(asset: V3Asset, part: string): boolean {
+/**
+ * The flat faces a part's shape declares, by name -- figure-model's shape definitions are the one place they are
+ * written (a portal's opening sides as well as its outer faces). A sphere has none.
+ */
+export function facesOf(asset: V3Asset, part: string): string[] {
+  const shape = modelOf(asset).nodes.find(n => n.id === `${part}.shape`)
+  return Object.keys((shape && v3ShapeFaces(shape.op)) ?? {})
+}
+
+/** The axis a face of a part faces along, from the same definitions. */
+export function faceAxisOf(asset: V3Asset, part: string, face: string): Axis | undefined {
   const shape = modelOf(asset).nodes.find(n => n.id === `${part}.shape`)
-  return canFollow(asset, part) || shape?.op === 'cylinder-shape@1'
+  return (shape && v3ShapeFaces(shape.op)?.[face]?.axis) as Axis | undefined
 }
 
+/** Whether `attach` can take this part: any part whose shape has a flat face. */
+export function canFasten(asset: V3Asset, part: string): boolean {
+  return facesOf(asset, part).length > 0
+}
+
+const OUTER: Record<Axis, [string, string]> = { x: ['left', 'right'], y: ['bottom', 'top'], z: ['back', 'front'] }
+
+/**
+ * The axes a part can be made a row along (r3 §8, figure-model `make-repeat`): across the face it is fastened by, when
+ * it is fastened fixed to another part and holds nothing. None for a part that is loose, moves, stands on the floor or
+ * already repeats -- the command would refuse those, so they are not offered.
+ */
+export function rowAxesOf(asset: V3Asset, part: string): Axis[] {
+  const joints = asset.joints ?? []
+  const j = joints.find(o => o.body1.part === part)
+  if (!j || j.type !== 'fixed' || j.repeat || !('part' in j.body0)) return []
+  if (joints.some(o => 'part' in o.body0 && o.body0.part === part)) return []
+  return AXES.filter(axis => axis !== V3_FACES[j.body1.face])
+}
+
+/** The row a part is made into, as its fastening's record keeps it. */
+export const rowOf = (asset: V3Asset, part: string) => asset.joints?.find(o => o.body1.part === part)?.repeat
+
 /** Where a part sits across the face it is fastened to, on one axis: centred, level with an edge, or a distance off centre. */
 export type Alignment = 'centre' | 'min' | 'max' | 'mm'
 
 /**
- * The axes across the face a part is fastened to — the two a fastening does not set by itself. On the plane the figure is
- * mounted on these are X and Z, and the plane has no edges, so only centred or a distance is offered there.
+ * The axes across the face a part is fastened to — the two a fastening does not set by itself. Edges to line up with
+ * are offered where both parts have their two outer faces on that axis; the plane the figure is mounted on has none,
+ * so on it (X and Z) only centred or a distance is offered.
  */
-export function alignAxesOf(target: V3Face | 'plane'): { axis: Axis; edges: boolean }[] {
+export function alignAxesOf(asset: V3Asset, part: string, target: { part: string; face: string } | 'plane', twisted = false): { axis: Axis; edges: boolean }[] {
   if (target === 'plane') return (['x', 'z'] as Axis[]).map(axis => ({ axis, edges: false }))
-  const along = V3_FACES[target] as Axis
-  return AXES.filter(axis => axis !== along).map(axis => ({ axis, edges: true }))
+  const along = faceAxisOf(asset, target.part, target.face)
+  if (!along) return []
+  const theirs = new Set(facesOf(asset, target.part)),
+    mine = new Set(facesOf(asset, part))
+  /* A part twisted about the face's normal has no side level with the target's edges. */
+  return AXES.filter(axis => axis !== along).map(axis => ({ axis, edges: !twisted && OUTER[axis].every(f => theirs.has(f) && mine.has(f)) }))
 }
 
 /** The `align` of an attach command from the form's choices: only the axes across that face, and centred ones left out. */
-export function alignOf(target: V3Face | 'plane', how: Partial<Record<Axis, Alignment>>, mm: Partial<Record<Axis, number>>) {
+export function alignOf(
+  asset: V3Asset,
+  part: string,
+  target: { part: string; face: string } | 'plane',
+  how: Partial<Record<Axis, Alignment>>,
+  mm: Partial<Record<Axis, number>>,
+  twisted = false
+) {
   const align: Partial<Record<Axis, 'min' | 'max' | { mm: number }>> = {}
-  for (const { axis, edges } of alignAxesOf(target)) {
+  for (const { axis, edges } of alignAxesOf(asset, part, target, twisted)) {
     const one = how[axis] ?? 'centre'
     if (one === 'mm' && mm[axis]) align[axis] = { mm: mm[axis]! }
     else if ((one === 'min' || one === 'max') && edges) align[axis] = one
@@ -314,6 +358,21 @@ export function instanceRangeOf(asset: V3Asset): { declared: V3SizeRange; measur
   return { declared, measured }
 }
 
+/**
+ * The size range to declare for a figure that has none yet: its parts' extent now as the size it is authored at, and
+ * as wide as its parts allow around it (the same measure 「다시 재기」 uses). Undefined when the figure already has a
+ * size or has nothing to measure. Without a declared size a board cannot resize the figure, and no part is offered
+ * to follow its size -- every figure made in the modeller was left there (user, 2026-09-25).
+ */
+export function instanceRangeToDeclare(asset: V3Asset): { range: V3SizeRange; at: Record<Axis, number> } | undefined {
+  if (instanceRangeOf(asset) || !asset.appearance.length) return undefined
+  const proposal = proposeV3Occupancy(asset, { over: 'rest' })
+  const at = Object.fromEntries(AXES.map(axis => [axis, Math.round((proposal.at[axis].max - proposal.at[axis].min) * 1e6) / 1e6])) as Record<Axis, number>
+  if (AXES.some(axis => !(at[axis] > 0))) return undefined
+  const start = defaultInstanceSizeRange(at)
+  return { range: foldInstanceSizeRange(start, v3InstanceSizeLimitsOf(asset, start)).range, at }
+}
+
 /** Whether measuring again would change the declared range (to a micrometre). */
 export function rangeDiffers(a: V3SizeRange, b: V3SizeRange): boolean {
   return AXES.some(axis => Math.abs(a[axis].min - b[axis].min) > 1e-3 || Math.abs(a[axis].max - b[axis].max) > 1e-3)

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

@@ -1,6 +1,7 @@
 import { html, css } from 'lit'
 import { customElement, state } from 'lit/decorators.js'
-import { PageView } from '@operato/shell'
+import { navigate, PageView } from '@operato/shell'
+import { modellerPathOf } from '../modeller/modeller-route.js'
 import { createV3ProductSession } from '../modeller/v3-product-session.js'
 import { v3ProductStore } from '../graphql/v3-store.js'
 import { i18next } from '@operato/i18n'
@@ -144,6 +145,15 @@ export class FigureV3ModellerPage extends PageView {
       this.updateContext()
     }
     if (!view.saving) this.announce()
+    /*
+      A new figure's first save gives it an id: the address becomes the figure's own, in place of the history entry.
+      Left at the bare modeller address, opening the modeller again from the menu was taken for the same page and kept
+      the saved figure -- its type showing where a new figure's was expected (2026-09-25).
+    */
+    if (view.id && !this.routeId && !view.saving) {
+      this.routeId = view.id
+      navigate(modellerPathOf({ id: view.id }), true)
+    }
     /* 저장이 끝난 순간 행을 다시 읽는다 — 발행된 도형을 고쳐 저장하면 서버가 초안으로 내린다. */
     if (this.wasDirty && !view.dirty && !view.saving && view.id) this.readRow(view.id)
     this.wasDirty = !!view.dirty

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

@@ -15,7 +15,7 @@ export declare class FigureV3Capability extends FigureV3Capability_base {
     /** The selected part, whose places are marked. */
     selected: string;
     locked: boolean;
-    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+    render(): typeof nothing | import("lit-html").TemplateResult<1>;
     private setRung;
     private pick;
 }

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

@@ -18,7 +18,7 @@ export declare class FigureV3Clips extends FigureV3Clips_base {
     /** Where each clip is scrubbed to, in seconds. */
     private at;
     private adding;
-    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+    render(): typeof nothing | import("lit-html").TemplateResult<1>;
     private renderClip;
     private renderTrack;
     private renderAdd;

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

@@ -22,7 +22,7 @@ export declare class FigureV3Controls extends FigureV3Controls_base {
     private open;
     /** Values in hand while a slider is dragged: the dial and the number follow them before the release commits. */
     private live;
-    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+    render(): typeof nothing | import("lit-html").TemplateResult<1>;
     private renderControl;
     private renderDial;
     private renderSettings;

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

@@ -30,6 +30,8 @@ export declare class FigureV3Links extends FigureV3Links_base {
     private fasten;
     private motion;
     private place;
+    private row;
+    willUpdate(changed: Map<string, unknown>): void;
     render(): import("lit-html").TemplateResult<1> | typeof nothing;
     /** Where things are held on this part: a seat things rest on, or a grip things are held in (parity row ⑤). */
     private renderPlaces;
@@ -48,6 +50,12 @@ export declare class FigureV3Links extends FigureV3Links_base {
      * either side, or a distance off centre. A door hung level with the frame's front edge turns about that edge.
      */
     private renderAlignment;
+    /**
+     * Making the part a row across what it is fastened to (figure-model `make-repeat`): along one of the axes across its
+     * face, copies a pitch apart filling the parent's length, or a count spread over it. Once made, the row's own section
+     * (the editor's) shows it and takes it away.
+     */
+    private renderRow;
     private renderMotion;
     private setKind;
     private command;

package/dist-client/modeller/figure-v3-links.js

@@ -4,10 +4,24 @@ import { css, html, LitElement, nothing } from 'lit';
 import { customElement, property, state } from 'lit/decorators.js';
 import { i18next, localize } from '@operato/i18n';
 import { V3_FACES } from '@hatiolab/figure-model';
-import { acceptsOf, alignAxesOf, alignOf, AXES, canFasten, canFollow, dimensionNow, followableAxes, positionIsShare, choiceOf, fastenedTo, followOf, hasInstanceSize, holdsThings, leadersFor, motionOf, motionJoint, placeFacesOf, placeIdFor, placesOn, positionsWorkedOut } from './v3-links.js';
+import { acceptsOf, alignAxesOf, alignOf, AXES, canFasten, facesOf, canFollow, dimensionNow, followableAxes, positionIsShare, choiceOf, fastenedTo, followOf, hasInstanceSize, holdsThings, leadersFor, motionOf, motionJoint, placeFacesOf, placeIdFor, placesOn, rowAxesOf, positionsWorkedOut } from './v3-links.js';
 import { SidePanelStyles } from './side-panel-styles.js';
 import { HelpToggles } from './v3-help.js';
 const FACES = Object.keys(V3_FACES);
+const freshFasten = () => ({
+    face: 'bottom',
+    toPlane: false,
+    target: '',
+    targetFace: 'top',
+    facing: 'meet',
+    gap: 0,
+    twist: 0,
+    align: {},
+    alignMm: {}
+});
+const freshMotion = () => ({ kind: 'slide', axis: 'x', id: '', min: 0, max: 500, follow: '', multiplier: 1, offset: 0 });
+const freshRow = () => ({ axis: '', pitch: 200, fills: true, count: 5 });
+const freshPlace = () => ({ role: 'grip', face: 'top', label: '', accepts: '', capacity: 1 });
 /**
  * What a part is tied to — its size response, what it is fastened to, how it moves (parity rows ④ ⑤ ⑥).
  *
@@ -30,9 +44,10 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
         this.locked = false;
         /** Which ties this shows: the part's shape (size and placement, in 속성), its places (자리·능력) or its motion (움직임). */
         this.section = 'shape';
-        this.fasten = { face: 'bottom', toPlane: false, target: '', targetFace: 'top', facing: 'meet', gap: 0, align: {}, alignMm: {} };
-        this.motion = { kind: 'slide', axis: 'x', id: '', min: 0, max: 500, follow: '', multiplier: 1, offset: 0 };
-        this.place = { role: 'grip', face: 'top', label: '', accepts: '', capacity: 1 };
+        this.fasten = freshFasten();
+        this.motion = freshMotion();
+        this.place = freshPlace();
+        this.row = freshRow();
     }
     static { this.styles = [SidePanelStyles, css `
     :host {
@@ -52,6 +67,18 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
       font-weight: 600;
     }
   `]; }
+    /*
+      The forms describe the next command for the selected part, so another part starts from the defaults: carrying the
+      last part's choices over fastened a shutter curtain level with a right edge nobody chose for it (2026-09-25).
+    */
+    willUpdate(changed) {
+        if (changed.has('partId') && changed.get('partId') !== undefined) {
+            this.fasten = freshFasten();
+            this.motion = freshMotion();
+            this.place = freshPlace();
+            this.row = freshRow();
+        }
+    }
     render() {
         const asset = this.asset;
         if (!asset || !this.partId)
@@ -72,6 +99,7 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
         ${this.renderPositions(asset)}
         ${canFasten(asset, this.partId) ? this.renderFastening(asset) : html `<p hint>${i18next.t('figure.text.links-need-a-box')}</p>`}
       </section>
+      ${this.renderRow(asset)}
     `;
     }
     /** Where things are held on this part: a seat things rest on, or a grip things are held in (parity row ⑤). */
@@ -209,6 +237,13 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
         const to = fastenedTo(asset, this.partId);
         const f = this.fasten;
         const targets = asset.appearance.map(look => look.target).filter(one => one !== this.partId && canFasten(asset, one));
+        /* The faces are the ones each shape declares: a part is fastened by one of its outer faces, to any face of the target. */
+        const mineFaces = facesOf(asset, this.partId).filter(face => FACES.includes(face));
+        const myFace = mineFaces.includes(f.face) ? f.face : mineFaces[0];
+        const theirFaces = f.target ? facesOf(asset, f.target) : FACES;
+        const targetFace = theirFaces.includes(f.targetFace) ? f.targetFace : theirFaces[0];
+        const aim = f.toPlane ? 'plane' : { part: f.target, face: targetFace };
+        const align = f.target || f.toPlane ? alignOf(asset, this.partId, aim, f.align, f.alignMm, !!f.twist) : undefined;
         return html `
       ${to
             ? html `<div pair>
@@ -221,7 +256,7 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
       <div form>
         <span>${i18next.t('figure.label.my-face')}</span>
         <select @change=${(e) => (this.fasten = { ...f, face: e.target.value })}>
-          ${FACES.map(face => html `<option value=${face} ?selected=${face === f.face}>${i18next.t('figure.label.face-' + face)}</option>`)}
+          ${mineFaces.map(face => html `<option value=${face} ?selected=${face === myFace}>${i18next.t('figure.label.face-' + face)}</option>`)}
         </select>
       </div>
       <label toggle>
@@ -238,7 +273,7 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
             </select>
             <span>${i18next.t('figure.label.target-face')}</span>
             <select @change=${(e) => (this.fasten = { ...f, targetFace: e.target.value })}>
-              ${FACES.map(face => html `<option value=${face} ?selected=${face === f.targetFace}>${i18next.t('figure.label.face-' + face)}</option>`)}
+              ${theirFaces.map(face => html `<option value=${face} ?selected=${face === targetFace}>${i18next.t('figure.label.face-' + face)}</option>`)}
             </select>
             <span>${i18next.t('figure.label.facing-meet')}</span>
             <select @change=${(e) => (this.fasten = { ...f, facing: e.target.value })}>
@@ -246,10 +281,12 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
               <option value="flush" ?selected=${f.facing === 'flush'}>${i18next.t('figure.label.facing-flush')}</option>
             </select>
           </div>`}
-      ${this.renderAlignment()}
+      ${this.renderAlignment(f.toPlane || f.target ? alignAxesOf(asset, this.partId, aim, !!f.twist) : [])}
       <div form>
         <span>${i18next.t('figure.label.gap')}</span>
         <input type="number" step="any" .value=${String(f.gap)} @change=${(e) => (this.fasten = { ...f, gap: Number(e.target.value) || 0 })} />
+        <span>${i18next.t('figure.label.twist')}</span>
+        <input type="number" step="any" .value=${String(f.twist)} @change=${(e) => (this.fasten = { ...f, twist: Number(e.target.value) || 0 })} />
       </div>
       <button
         act
@@ -257,11 +294,12 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
         @click=${() => this.command({
             kind: 'attach',
             part: this.partId,
-            face: f.face,
-            to: f.toPlane ? { plane: 'mounting-plane' } : { part: f.target, face: f.targetFace },
+            face: myFace,
+            to: f.toPlane ? { plane: 'mounting-plane' } : { part: f.target, face: targetFace },
             ...(f.toPlane ? {} : { facing: f.facing }),
             ...(f.gap ? { gap: f.gap } : {}),
-            ...(alignOf(f.toPlane ? 'plane' : f.targetFace, f.align, f.alignMm) ? { align: alignOf(f.toPlane ? 'plane' : f.targetFace, f.align, f.alignMm) } : {}),
+            twist: f.twist,
+            ...(align ? { align } : {}),
             replace: !!to
         })}
       >
@@ -273,12 +311,12 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
      * Where on the target face the part sits, on the two axes across it: centred, level with the target's edge on
      * either side, or a distance off centre. A door hung level with the frame's front edge turns about that edge.
      */
-    renderAlignment() {
+    renderAlignment(axes) {
         const f = this.fasten;
         const set = (axis, how) => (this.fasten = { ...f, align: { ...f.align, [axis]: how } });
         const setMm = (axis, mm) => (this.fasten = { ...f, alignMm: { ...f.alignMm, [axis]: mm } });
         return html `<div form>
-      ${alignAxesOf(f.toPlane ? 'plane' : f.targetFace).map(({ axis, edges }) => {
+      ${axes.map(({ axis, edges }) => {
             const how = f.align[axis] === 'min' || f.align[axis] === 'max' ? (edges ? f.align[axis] : 'centre') : (f.align[axis] ?? 'centre');
             return html `<span>${i18next.t('figure.label.align-' + axis)}</span>
           <select @change=${(e) => set(axis, e.target.value)}>
@@ -295,6 +333,47 @@ let FigureV3Links = class FigureV3Links extends localize(i18next)(LitElement) {
         })}
     </div>`;
     }
+    /**
+     * Making the part a row across what it is fastened to (figure-model `make-repeat`): along one of the axes across its
+     * face, copies a pitch apart filling the parent's length, or a count spread over it. Once made, the row's own section
+     * (the editor's) shows it and takes it away.
+     */
+    renderRow(asset) {
+        const axes = rowAxesOf(asset, this.partId);
+        if (!axes.length)
+            return nothing;
+        const r = this.row;
+        const axis = axes.includes(r.axis) ? r.axis : axes[0];
+        const ok = r.pitch > 0 && (r.fills || (Number.isSafeInteger(r.count) && r.count >= 1));
+        return html `<section>
+      <h3>${i18next.t('figure.label.repeat')}</h3>
+      <div form>
+        <span>${i18next.t('figure.label.repeat-axis')}</span>
+        <select @change=${(e) => (this.row = { ...r, axis: e.target.value })}>
+          ${axes.map(a => html `<option value=${a} ?selected=${a === axis}>${a.toUpperCase()}</option>`)}
+        </select>
+        <span>${i18next.t('figure.label.repeat-pitch')} (mm)</span>
+        <input type="number" step="any" min="0" .value=${String(r.pitch)} @change=${(e) => (this.row = { ...r, pitch: Number(e.target.value) })} />
+      </div>
+      <label toggle>
+        <input type="checkbox" .checked=${r.fills} @change=${(e) => (this.row = { ...r, fills: e.target.checked })} />
+        ${i18next.t('figure.label.repeat-fills')}
+      </label>
+      ${r.fills
+            ? nothing
+            : html `<div form>
+            <span>${i18next.t('figure.label.repeat-count')}</span>
+            <input type="number" step="1" min="1" .value=${String(r.count)} @change=${(e) => (this.row = { ...r, count: Number(e.target.value) })} />
+          </div>`}
+      <button
+        act
+        ?disabled=${this.locked || !ok}
+        @click=${() => this.command({ kind: 'make-repeat', part: this.partId, axis, pitch: r.pitch, ...(r.fills ? {} : { count: r.count }) })}
+      >
+        <md-icon>view_week</md-icon>${i18next.t('figure.button.make-repeat')}
+      </button>
+    </section>`;
+    }
     renderMotion(asset) {
         const now = motionOf(asset, this.partId);
         const joint = asset.joints?.find(j => j.body1.part === this.partId);
@@ -412,6 +491,10 @@ __decorate([
     state(),
     __metadata("design:type", Object)
 ], FigureV3Links.prototype, "place", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], FigureV3Links.prototype, "row", void 0);
 FigureV3Links = __decorate([
     customElement('figure-v3-links')
 ], FigureV3Links);