@things-factory/figure-ui 10.1.116 → 10.1.121

package/client/graphql/index.ts

@@ -49,6 +49,7 @@ function unwrap<T>(response: { data?: Record<string, unknown>; errors?: readonly
  */
 const FIGURE_LIST_FIELDS = `
   id
+  namespace
   type
   name
   description

package/client/modeller/editor.ts

@@ -46,7 +46,7 @@ import { roomRefitRowsOf } from './occupancy.js'
 import { editRefusalOf, inDeclaredRoom, inputRangeRefusalOf, narrowingRetryOf, partRefusalOf, placementRefusalOf, recipeRefusalOf, removalNoticeOf, sizeRangeRefusalOf } from './refusals.js'
 import type { FigureRenderPart } from './renderer.js'
 import type { FigureBudgetLine } from './maturity.js'
-import { fieldWordsOf, followOf, measureNow, partSummaryOf, instanceRangeOf, instanceRangeToDeclare, proportionToFollow, rangeDiffers, rangeWith, turnsAboutAJoint, valueNow } from './links.js'
+import { endPlaceKeyOf, fieldWordsOf, followOf, measureNow, partSummaryOf, instanceRangeOf, instanceRangeToDeclare, proportionToFollow, rangeDiffers, rangeWith, turnsAboutAJoint, valueNow } from './links.js'
 import { jointFanOf } from './joint-fan.js'
 import { jointDragOf } from './joint-drag.js'
 import type { FirstSave } from './first-save.js'
@@ -1386,7 +1386,7 @@ export class FigureEditor extends LitElement {
     const fastened = new Map(
       (asset?.joints ?? []).map(j => [
         j.body1.part,
-        'plane' in j.body0 ? i18next.t('figure.label.mounting-plane') : `${partLabelOf(j.body0.part)} · ${i18next.t(`figure.label.face-${j.body0.face}`)}`
+        'plane' in j.body0 ? i18next.t('figure.label.mounting-plane') : `${partLabelOf(j.body0.part)} · ${i18next.t(endPlaceKeyOf(j.body0))}`
       ])
     )
     const rows = new Map<string, FigurePartRow>()

package/client/modeller/fasten-geometry.ts

@@ -139,7 +139,7 @@ export function overhangOf(view: FaceView, at: Record<Axis, number>): { touching
 }
 
 /** Whether the part turns about a joint: then 가운데를 면에 is offered -- a roller spinning in place. */
-export const turnsInPlace = (asset: FigureAsset, part: string) => (asset.joints ?? []).some(j => j.body1.part === part && (j.type === 'revolute' || j.body1.face === 'centre'))
+export const turnsInPlace = (asset: FigureAsset, part: string) => (asset.joints ?? []).some(j => j.body1.part === part && (j.type === 'revolute' || ('face' in j.body1 && j.body1.face === 'centre')))
 
 /**
  * How the face lies on the screen: X across when it is one of the face's axes, else Z; the other down the screen -- up

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

@@ -14,7 +14,7 @@ import { firstSaveRefusalOf, releasableType, suggestTypeOf, typeOf, type FirstSa
  * Closes with the answer, or with nothing when cancelled -- then nothing is saved.
  */
 /** The shape of an identifier the modeller offers (`suggestTypeOf`'s random form). */
-const OFFERED = /^FIG_[0-9A-Z]{6}$/
+const OFFERED = /^fig-[0-9a-z]{6}$/
 
 @customElement('figure-first-save')
 export class FigureFirstSave extends LitElement {

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

@@ -10,6 +10,7 @@ import { customElement, property, state } from 'lit/decorators.js'
 import { i18next, localize } from '@operato/i18n'
 import { ScrollbarStyles } from '@operato/styles'
 
+import { getPathInfo } from '@operato/utils'
 import { fetchFigureVersions, fetchReplacedDrafts, inspectFigure, releaseFigure, revertFigureVersion, undoFigureRevert } from '../graphql/index.js'
 import type { KeptDraft } from '../graphql/index.js'
 import { afterRevertAnswer, revertOutcomeUnknown, revertRequestFor } from './revert-request.js'
@@ -194,6 +195,14 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
       cursor: pointer;
     }
 
+    li a[package] {
+      padding: 2px 8px;
+      color: var(--md-sys-color-on-surface);
+      border: 1px solid var(--md-sys-color-outline-variant);
+      border-radius: 6px;
+      text-decoration: none;
+    }
+
     li button[revert]:hover {
       color: var(--md-sys-color-on-primary-container);
       background-color: var(--md-sys-color-primary-container);
@@ -229,6 +238,8 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
    * 판정이 남아 발행 단추가 잠긴 채다.
    */
   @property({ type: String }) figureType?: string
+  /** The namespace of the full name: with it a released version can be downloaded as a package (ADR-0114). */
+  @property({ type: String }) figureNamespace?: string
 
   @state() private versions: FigureVersion[] = []
   /** Drafts reverts kept, newest first -- apart from the released versions. */
@@ -420,6 +431,13 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
     this.dispatchEvent(new CustomEvent('fit-base-to-parts', { bubbles: true, composed: true }))
   }
 
+  /** Where one released version downloads as a package file, or undefined before the figure has a full name. */
+  private packageHref(version: number): string | undefined {
+    if (!this.figureNamespace || !this.figureType) return undefined
+    const { contextPath } = getPathInfo(location.pathname)
+    return `${contextPath}/figure-package?refs=${encodeURIComponent(`${this.figureNamespace}/${this.figureType}@${version}`)}`
+  }
+
   private renderVersion(version: FigureVersion) {
     return html`
       <li>
@@ -431,6 +449,9 @@ export class FigureHistoryPanel extends localize(i18next)(LitElement) {
         <button revert ?disabled=${this.busy} @click=${() => this.revert(version.version)}>
           ${i18next.t('figure.button.revert')}
         </button>
+        ${this.packageHref(version.version)
+          ? html`<a package download href=${this.packageHref(version.version)!}>${i18next.t('figure.button.download-package')}</a>`
+          : nothing}
         ${version.comment ? html`<span comment>${version.comment}</span>` : nothing}
       </li>
     `

package/client/modeller/figure-links.ts

@@ -33,6 +33,8 @@ import {
   leadersFor,
   motionOf,
   motionFormOf,
+  motionFormRefusalOf,
+  endPlaceKeyOf,
   motionJoint,
   placeFacesOf,
   placeIdFor,
@@ -54,6 +56,7 @@ import './figure-fasten-drawing.js'
 import type { FastenChange } from './figure-fasten-drawing.js'
 import { faceViewOf, modeOf, myFaceFor, turnsInPlace, type FastenMode } from './fasten-geometry.js'
 import { HelpToggles } from './help.js'
+import { jointAxisWord } from './joint-axis.js'
 
 const FACES = Object.keys(FIGURE_FACES) as FigureFace[]
 /** The target list's entry for the plane the figure stands by. */
@@ -434,17 +437,22 @@ export class FigureLinks extends localize(i18next)(LitElement) {
    * What holds the part, said as its state -- 「아랫면을 바닥에 유지 중」 -- with the ways to change it: open the fastening,
    * or take it off. Right after "follow size, attached" this is the result, not a refusal (designer 2026-09-27).
    */
-  private renderHeld(asset: FigureAsset) {
+  private heldWords(asset: FigureAsset) {
     const joint = (asset.joints ?? []).find(j => j.body1.part === this.partId)
-    const face = joint ? i18next.t(`figure.label.face-${joint.body1.face}`) : ''
+    const face = joint ? i18next.t(endPlaceKeyOf(joint.body1)) : ''
     const gap = typeof joint?.origin?.gap === 'number' ? joint.origin.gap : 0
     const where = !joint
       ? i18next.t('figure.text.held-by-rule')
       : 'plane' in joint.body0
         ? i18next.t('figure.text.held-on-plane', { face, place: i18next.t(`figure.label.resize-place-${asset.placement ?? 'floor'}`), gap: String(gap) })
-        : i18next.t('figure.text.held-on-part', { face, other: joint.body0.part, otherFace: i18next.t(`figure.label.face-${joint.body0.face}`) })
+        : i18next.t('figure.text.held-on-part', { face, other: joint.body0.part, otherFace: i18next.t(endPlaceKeyOf(joint.body0)) })
+    return where
+  }
+
+  private renderHeld(asset: FigureAsset) {
+    const joint = (asset.joints ?? []).find(j => j.body1.part === this.partId)
     return html`<div resize-held>
-      <p><md-icon>link</md-icon> ${where}</p>
+      <p><md-icon>link</md-icon> ${this.heldWords(asset)}</p>
       <button act open-fastening @click=${() => this.openFastening(asset)}>
         <md-icon>link</md-icon>${i18next.t('figure.button.open-fastening')}
       </button>
@@ -521,6 +529,17 @@ export class FigureLinks extends localize(i18next)(LitElement) {
 
   private renderFastening(asset: FigureAsset) {
     const held = heldBy(asset, this.partId)
+    /* Placed by an origin (ADR-0107 decision 4): attach writes faces, so the form would move it off its origin. Said, and taken off only. */
+    if (fasteningOf(asset, this.partId)?.atOrigin) {
+      this.fastenCandidate = undefined
+      return html`<div fastened fasten-at-origin>
+        <p>${this.heldWords(asset)}</p>
+        <button act ?disabled=${this.locked} @click=${() => this.command({ kind: 'detach', part: this.partId })}>
+          <md-icon>link_off</md-icon>${i18next.t('figure.button.detach')}
+        </button>
+        ${this.renderDetachWords()}
+      </div>`
+    }
     const f = this.fasten
     /* Not a part that hangs from this one: fastening a frame to its own roller would close a loop. */
     const targets = asset.appearance.map(look => look.target).filter(one => one !== this.partId && canFasten(asset, one))
@@ -852,7 +871,7 @@ export class FigureLinks extends localize(i18next)(LitElement) {
             part: this.partId,
             against,
             kind: i18next.t('figure.label.motion-' + now.kind),
-            axis: String(now.axis).toUpperCase()
+            axis: now.vector ? jointAxisWord(now.vector) : String(now.axis).toUpperCase()
           })}
         </p>
         ${ends
@@ -860,7 +879,7 @@ export class FigureLinks extends localize(i18next)(LitElement) {
           : nothing}
         <div pair>
         <span>
-          ${i18next.t('figure.label.motion-' + now.kind)} · ${String(now.axis).toUpperCase()}
+          ${i18next.t('figure.label.motion-' + now.kind)} · ${now.vector ? jointAxisWord(now.vector) : String(now.axis).toUpperCase()}
           ${now.travel
             ? html`<small>${i18next.t('figure.label.motion-travel-is', { part: now.travel.part, axis: now.travel.axis.toUpperCase(), plus: now.travel.plus ?? 0 })}</small>`
             : nothing}
@@ -903,6 +922,7 @@ export class FigureLinks extends localize(i18next)(LitElement) {
     /* A follower follows a joint that moves the same way; a choice the kind no longer allows is dropped. */
     const leaders = leadersFor(asset, this.partId, m.kind)
     const follow = leaders.some(j => j.id === m.follow) ? m.follow : ''
+    const refusal = motionFormRefusalOf(m, follow)
     return html`
       <div pair>
         <select @change=${(e: Event) => this.setKind((e.target as HTMLSelectElement).value as 'slide' | 'turn' | 'continuous')}>
@@ -910,9 +930,11 @@ export class FigureLinks extends localize(i18next)(LitElement) {
           <option value="turn" ?selected=${m.kind === 'turn'}>${i18next.t('figure.label.motion-turn')}</option>
           <option value="continuous" ?selected=${m.kind === 'continuous'}>${i18next.t('figure.label.motion-continuous')}</option>
         </select>
-        <select @change=${(e: Event) => (this.motion = { ...m, axis: (e.target as HTMLSelectElement).value as Axis })}>
-          ${AXES.map(a => html`<option value=${a} ?selected=${a === m.axis}>${i18next.t('figure.label.motion-axis')} ${a.toUpperCase()}</option>`)}
-        </select>
+        ${m.axisVector
+          ? html`<span motion-axis-vector>${i18next.t('figure.label.motion-axis')} ${jointAxisWord(m.axisVector)}</span>`
+          : html`<select @change=${(e: Event) => (this.motion = { ...m, axis: (e.target as HTMLSelectElement).value as Axis })}>
+              ${AXES.map(a => html`<option value=${a} ?selected=${a === m.axis}>${i18next.t('figure.label.motion-axis')} ${a.toUpperCase()}</option>`)}
+            </select>`}
       </div>
       ${m.followSum
         ? html`<div form>
@@ -968,8 +990,8 @@ export class FigureLinks extends localize(i18next)(LitElement) {
           </div>`}
       <button
         act
-        ?disabled=${this.locked || (m.followSum ? false : follow ? !(Number.isFinite(m.multiplier) && m.multiplier !== 0) : m.kind !== 'continuous' && !(m.kind === 'slide' && (m.travel || m.travelSum)) && !(m.max > m.min && m.min <= 0 && 0 <= m.max))}
-        title=${!follow && m.kind !== 'continuous' && !(m.min <= 0 && 0 <= m.max) ? i18next.t('figure.text.joint-range-holds-zero') : ''}
+        ?disabled=${this.locked || !!refusal}
+        title=${refusal === 'range' ? i18next.t('figure.text.range-needs-room') : ''}
         @click=${() => {
           this.command({ kind: 'set-joint', joint: motionJoint(joint, { ...m, follow }, this.partId) })
           this.editingMotion = false

package/client/modeller/first-save.ts

@@ -6,9 +6,9 @@ import { isPlaceholderType, TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-m
  * under a temporary machine name and asked nothing -- the author had to find the field afterwards (user, 2026-09-25).
  */
 
-/** A type as typed, made into the shape a type has: letters, digits and underscores, upper case. */
+/** A type as typed, made into the shape a type has: lower-case letters and digits joined by single hyphens. */
 export function typeOf(raw: string): string {
-  return raw.trim().replace(/[^A-Za-z0-9_]/g, '_').toUpperCase()
+  return raw.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')
 }
 
 /**
@@ -23,14 +23,14 @@ export function releasableType(type: string): boolean {
  * An identifier offered for a new figure, so the first save asks for a name and has a valid identifier ready (designer
  * 2026-09-27, Q-D3). A name in plain letters is used as it is when it makes a free, releasable identifier; any other
  * name -- Korean, say -- gets a valid prefix and a random part: no transliteration is guessed. Never the temporary
- * shape (`FIGURE_` and eight), which the release gate refuses; never one this domain already uses.
+ * shape (`figure-` and eight), which the release gate refuses; never one this domain already uses.
  */
 export function suggestTypeOf(name: string, taken: readonly string[], random: () => number = Math.random): string {
-  const fromName = /^[A-Za-z][A-Za-z0-9 _-]*$/.test(name.trim()) ? typeOf(name).replace(/_+/g, '_').replace(/_$/, '') : ''
+  const fromName = /^[A-Za-z][A-Za-z0-9 _-]*$/.test(name.trim()) ? typeOf(name) : ''
   if (fromName && releasableType(fromName) && !taken.includes(fromName)) return fromName
-  const alphabet = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+  const alphabet = '0123456789abcdefghijklmnopqrstuvwxyz'
   for (;;) {
-    const made = `FIG_${Array.from({ length: 6 }, () => alphabet[Math.floor(random() * alphabet.length)]).join('')}`
+    const made = `fig-${Array.from({ length: 6 }, () => alphabet[Math.floor(random() * alphabet.length)]).join('')}`
     if (releasableType(made) && !taken.includes(made)) return made
   }
 }

package/client/modeller/joint-axis.ts

@@ -0,0 +1,36 @@
+/*
+ * A joint's axis as the record keeps it (ADR-0107 decision 1): one of USD's tokens, or any vector in the joint frame
+ * (URDF's `axis xyz`). One reader for every place that turns it into a direction or says it.
+ */
+
+export type JointAxisVector = { x: number; y: number; z: number }
+
+const isVector = (axis: unknown): axis is JointAxisVector =>
+  !!axis && typeof axis === 'object' && ['x', 'y', 'z'].every(k => typeof (axis as Record<string, unknown>)[k] === 'number' && Number.isFinite((axis as Record<string, number>)[k]))
+
+/** The axis as a unit vector in the joint frame: a token's own axis, a vector divided by its length. Nothing for none. */
+export function jointAxisUnit(axis: unknown): [number, number, number] | undefined {
+  if (typeof axis === 'string') {
+    const k = ['x', 'y', 'z'].indexOf(axis.toLowerCase())
+    return k < 0 ? undefined : ([0, 1, 2].map(i => (i === k ? 1 : 0)) as [number, number, number])
+  }
+  if (!isVector(axis)) return undefined
+  const n = Math.hypot(axis.x, axis.y, axis.z)
+  return n > 1e-9 ? [axis.x / n, axis.y / n, axis.z / n] : undefined
+}
+
+/** The token, lowercase, when the axis is one; nothing for a vector. */
+export function jointAxisToken(axis: unknown): 'x' | 'y' | 'z' | undefined {
+  const k = typeof axis === 'string' ? axis.toLowerCase() : ''
+  return k === 'x' || k === 'y' || k === 'z' ? k : undefined
+}
+
+/** The vector, as written, when the axis is one. */
+export const jointAxisVectorOf = (axis: unknown): JointAxisVector | undefined => (isVector(axis) ? { x: axis.x, y: axis.y, z: axis.z } : undefined)
+
+/** The axis said: `X` for a token, `(1, 1, 0)` for a vector as written. */
+export function jointAxisWord(axis: unknown): string {
+  const token = jointAxisToken(axis)
+  if (token) return token.toUpperCase()
+  return isVector(axis) ? `(${axis.x}, ${axis.y}, ${axis.z})` : '?'
+}

package/client/modeller/joint-drag.ts

@@ -3,6 +3,7 @@ import { compileFigureAsset, figureMimicTermsOf } from '@hatiolab/figure-model'
 import type { FigureAsset, FigureJoint } from '@hatiolab/figure-model'
 
 import type { GizmoResult } from './gizmo.js'
+import { jointAxisUnit, jointAxisWord } from './joint-axis.js'
 import type { FigureRenderPart } from './renderer.js'
 
 /*
@@ -11,7 +12,8 @@ import type { FigureRenderPart } from './renderer.js'
  *
  *   - turning a part on a revolute or continuous joint sets the joint's value -- the turn about the joint's axis;
  *   - sliding a part on a prismatic joint along its axis sets its value;
- *   - moving a part any other way moves the joint's origin: the gap along the face it sits on, the offset across it.
+ *   - moving a part any other way moves the joint's origin: the gap along the face it sits on, the offset across it;
+ *     at a parent's origin (ADR-0107 decision 4), its `origin.offset` in the parent's frame.
  *
  * What would break a relation is refused and said: an origin that follows another part's size, a joint that mimics
  * another, a turn on a joint that does not turn.
@@ -30,9 +32,15 @@ const FACE_SIGN: Record<string, number> = { left: -1, right: 1, bottom: -1, top:
 
 const matrixOf = (r: number[][]) => new THREE.Matrix4().set(r[0]![0]!, r[0]![1]!, r[0]![2]!, 0, r[1]![0]!, r[1]![1]!, r[1]![2]!, 0, r[2]![0]!, r[2]![1]!, r[2]![2]!, 0, 0, 0, 0, 1)
 const eulerMatrix = (deg: number[]) => new THREE.Matrix4().makeRotationFromEuler(new THREE.Euler(...(deg.map(THREE.MathUtils.degToRad) as [number, number, number]), 'XYZ'))
-const unit = (axis: string) => new THREE.Vector3(/x/i.test(axis) ? 1 : 0, /y/i.test(axis) ? 1 : 0, /z/i.test(axis) ? 1 : 0)
+const unit = (axis: unknown) => new THREE.Vector3(...(jointAxisUnit(axis) ?? [0, 0, 0]))
 const round = (v: number, step: number) => Number((Math.round(v / step) * step).toFixed(Math.max(0, -Math.floor(Math.log10(step)))))
 
+/** The joint frame's words of ADR-0107, read without the kernel's types (an older kernel has none). */
+const framesOf = (j: FigureJoint) => (j.origin ?? {}) as { offset?: Partial<Record<Axis, unknown>>; rotate?: Partial<Record<Axis, number>> }
+/** `origin.rotate`, URDF's rpy: Rz·Ry·Rx about the fixed axes. */
+const rotateMatrix = (j: FigureJoint) => eulerMatrixOrder(AXES.map(a => framesOf(j).rotate?.[a] ?? 0), 'ZYX')
+const eulerMatrixOrder = (deg: number[], order: THREE.EulerOrder) => new THREE.Matrix4().makeRotationFromEuler(new THREE.Euler(...(deg.map(THREE.MathUtils.degToRad) as [number, number, number]), order))
+
 /** The part's own quarter turn in the joint frame, as the record says it. */
 const turnMatrix = (j: FigureJoint) => eulerMatrix(AXES.map(a => j.origin?.turn?.[a] ?? 0))
 
@@ -65,7 +73,7 @@ export function jointDragOf(asset: FigureAsset, id: string, part: FigureRenderPa
     const twist = 2 * Math.atan2(change.x * axis.x + change.y * axis.y + change.z * axis.z, change.w)
     /* Turned about another axis: the joint cannot make that turn, and nothing is written for it. */
     const whole = 2 * Math.acos(Math.min(1, Math.abs(change.w)))
-    if (Math.abs(twist) < whole * 0.5) return { kind: 'refused', reason: 'off-axis', joint: j.id, axis: j.axis! }
+    if (Math.abs(twist) < whole * 0.5) return { kind: 'refused', reason: 'off-axis', joint: j.id, axis: jointAxisWord(j.axis) }
     let value = now + THREE.MathUtils.radToDeg(twist)
     if (endless) value = ((((value + 180) % 360) + 360) % 360) - 180
     else value = Math.min(Math.max(value, j.lowerLimit!), j.upperLimit!)
@@ -92,12 +100,24 @@ export function jointDragOf(asset: FigureAsset, id: string, part: FigureRenderPa
     }
   }
 
-  /* Moving the joint's origin: the change in the frame the joint sits in. */
-  const local = moved.clone().applyMatrix4(frame.clone().invert())
+  /* Moving the joint's origin: the change in the frame it is placed in, before `origin.rotate` turns the joint frame. */
+  const local = moved.clone().applyMatrix4(frame.clone().multiply(rotateMatrix(j).invert()).invert())
+  const origin: NonNullable<FigureJoint['origin']> = { ...(j.origin ?? {}) }
+  if (!('plane' in j.body0) && !('face' in j.body0)) {
+    /* At the parent's origin there is no face: the frame moves by its offset, along the parent's axes. */
+    const offset = { ...(framesOf(j).offset ?? {}) }
+    for (const axis of AXES) {
+      const d = local[axis]
+      if (Math.abs(d) < 0.5) continue
+      const was = offset[axis] ?? 0
+      if (typeof was !== 'number') return { kind: 'refused', reason: 'origin-follows', joint: j.id }
+      offset[axis] = round(was + d, 1)
+    }
+    return { kind: 'joint', joint: { ...j, origin: { ...origin, offset } } as FigureJoint }
+  }
   const normal: Axis = 'plane' in j.body0 ? 'y' : FACE_AXIS[j.body0.face]!
   /* Which way a larger gap moves the part: out of the face it meets (on the plane: up when it stands, down when it hangs). */
-  const outward = 'plane' in j.body0 ? (j.body1.face === 'bottom' ? 1 : -1) : ((j.origin?.facing ?? 'meet') === 'meet' ? 1 : -1) * FACE_SIGN[j.body0.face]!
-  const origin: NonNullable<FigureJoint['origin']> = { ...(j.origin ?? {}) }
+  const outward = 'plane' in j.body0 ? ('face' in j.body1 && j.body1.face === 'bottom' ? 1 : -1) : ((j.origin?.facing ?? 'meet') === 'meet' ? 1 : -1) * FACE_SIGN[j.body0.face]!
   const along = local[normal]
   if (Math.abs(along) >= 0.5) {
     const gap = origin.gap ?? 0

package/client/modeller/joint-fan.ts

@@ -3,6 +3,7 @@ import type { FigureAsset } from '@hatiolab/figure-model'
 
 import type { FigureRenderPart } from './renderer.js'
 import { sectionShape } from './drawn-shapes.js'
+import { jointAxisUnit } from './joint-axis.js'
 
 /*
  * Where the selected part turns, and how far -- a translucent fan on the editing board. An axis name says nothing about which way a part swings; on a six-axis arm the author went to the preview and
@@ -111,7 +112,7 @@ function turnOf(asset: FigureAsset, part: string, values: Record<string, unknown
     /* In the child's own frame: the joint is where its pose puts the seat's origin, the axis turned back by its pose. */
     const back = (v: number[]) => [0, 1, 2].map(i => pose.r[0]![i]! * v[0]! + pose.r[1]![i]! * v[1]! + pose.r[2]![i]! * v[2]!)
     const pivot = back(pose.t.map(v => -v))
-    const axis = norm(back(AXIS_NAMES.map(a => (a.toUpperCase() === record.axis ? 1 : 0))))
+    const axis = norm(back(jointAxisUnit(record.axis) ?? [0, 0, 0]))
     if (!axis) return null
     return { carrier, pivot, axis, toward: [0, 0, 0], control, turnedPart: child }
   }

package/client/modeller/links.ts

@@ -2,6 +2,7 @@ import { FIGURE_FACES, figureShapeFaces, figurePartsExtentOf, compileFigureAsset
 import type { FigureFollow, FigureSizeRange } from '@hatiolab/figure-model'
 import type { FigureAsset, FigureBindingPlace, FigureFace, FigureJoint } from '@hatiolab/figure-model'
 import { startingShapeKindOf } from './starting-shape.js'
+import { jointAxisToken, jointAxisVectorOf, type JointAxisVector } from './joint-axis.js'
 
 /*
  * What a part is tied to — the readers behind the parts' size response, fastening and motion sections. Kept apart from the element so they can be tested without a browser.
@@ -52,6 +53,9 @@ export function heldBy(asset: FigureAsset, part: string): { part: string } | { p
   return to ? { part: to } : null
 }
 
+/** The word for where a joint end sits: its face's, or the part's origin for an end placed by it (ADR-0107 decision 4). */
+export const endPlaceKeyOf = (end: object) => ('face' in end ? `figure.label.face-${(end as { face: string }).face}` : 'figure.label.joint-origin')
+
 /** Whether a dimension of this part can follow something — box-shaped, whose three sizes are X, Y and Z. */
 export function canFollow(asset: FigureAsset, part: string): boolean {
   return followableAxes(asset, part).length > 0
@@ -231,20 +235,24 @@ export function rowAxesOf(asset: FigureAsset, part: string): Axis[] {
   /* A part that moves may be a row too: every copy on the one control, from its own place (designer 2026-09-27). */
   if (!j || 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 !== FIGURE_FACES[j.body1.face])
+  /* Placed by an origin: no face to lay the row across, and the kernel refuses it. */
+  const by = j.body1
+  if (!('face' in j.body0) || !('face' in by)) return []
+  return AXES.filter(axis => axis !== FIGURE_FACES[by.face])
 }
 
 /**
  * Why a part cannot be made into a row here, in the terms `rowAxesOf` refuses it: said, not hidden (ADR-0097 §5.5).
  * Nothing when it can, or when it already is a row (that row is shown where it stands).
  */
-export function rowBlockOf(asset: FigureAsset, part: string): 'unfastened' | 'on-plane' | 'holds-parts' | undefined {
+export function rowBlockOf(asset: FigureAsset, part: string): 'unfastened' | 'on-plane' | 'holds-parts' | 'at-origin' | undefined {
   const joints = asset.joints ?? []
   const j = joints.find(o => o.body1.part === part)
   if (!j) return 'unfastened'
   if (j.repeat) return undefined
   if (!('part' in j.body0)) return 'on-plane'
   if (joints.some(o => 'part' in o.body0 && o.body0.part === part)) return 'holds-parts'
+  if (!('face' in j.body0) || !('face' in j.body1)) return 'at-origin'
   return undefined
 }
 
@@ -332,12 +340,15 @@ export function fasteningOf(
   twist: number
   align: Partial<Record<Axis, Alignment>>
   alignMm: Partial<Record<Axis, number>>
+  /** Placed by a part's origin (ADR-0107 decision 4): no face to fasten by, and the form does not write it. */
+  atOrigin?: true
 } | null {
   const record = asset.joints?.find(j => j.body1.part === part)
   if (!record) return null
   const toPlane = 'plane' in record.body0
   const target = 'part' in record.body0 ? record.body0.part : ''
-  const targetFace = 'part' in record.body0 ? record.body0.face : 'top'
+  const targetFace = 'face' in record.body0 ? record.body0.face : 'top'
+  const atOrigin = !('plane' in record.body0) && (!('face' in record.body0) || !('face' in record.body1))
   const twist = record.origin?.twist ?? 0
   /* Where across the face: as the record says it, and where it says nothing, where the part stands now. */
   const kept = placeKeptOf(asset, part, toPlane ? 'plane' : { part: target, face: targetFace }, !!twist)
@@ -357,14 +368,15 @@ export function fasteningOf(
   }
   const gap = record.origin?.gap
   return {
-    face: record.body1.face,
+    face: 'face' in record.body1 ? record.body1.face : 'centre',
     toPlane,
     target,
     targetFace,
     facing: record.origin?.facing ?? 'meet',
     gap: typeof gap === 'number' ? gap : 0,
     twist,
-    ...kept
+    ...kept,
+    ...(atOrigin ? { atOrigin: true as const } : {})
   }
 }
 
@@ -456,6 +468,8 @@ export function positionIsShare(asset: FigureAsset, part: string, axis: Axis): b
 export interface Motion {
   kind: 'slide' | 'turn' | 'continuous'
   axis: Axis | '?'
+  /** The record's axis when it is a vector, as written (the graph holds it turned into the parent's frame). */
+  vector?: JointAxisVector
   control?: { id: string; unit?: string; min?: number; max?: number }
   /** A joint that moves with another (URDF's mimic): the leader's value times `multiplier`, plus `offset`. */
   /** What it follows, as a sum of leaders each with its multiplier, plus an offset (one leader is a sum of one). */
@@ -469,7 +483,9 @@ export function motionOf(asset: FigureAsset, part: string): Motion | undefined {
   const node = m.nodes.find(n => n.id === `${part}.motion`)
   if (!node) return undefined
   const record = asset.joints?.find(j => j.body1.part === part)
-  const endless = record?.type === 'revolute' && record.lowerLimit === undefined && record.upperLimit === undefined
+  /* A follower has no limits of its own: its range is its leaders', not a turn without end. */
+  const endless = record?.type === 'revolute' && record.lowerLimit === undefined && record.upperLimit === undefined && !record.mimic
+  const vector = jointAxisVectorOf(record?.axis)
   const kind = endless ? 'continuous' : node.op === 'axis-turn@1' ? 'turn' : 'slide'
   const unit = node.args.slice(0, 3).map(ref => m.constants.find(c => c.id === ref)?.value)
   const axis = AXES[unit.findIndex(v => v !== undefined && v !== 0)] ?? '?'
@@ -490,13 +506,15 @@ export function motionOf(asset: FigureAsset, part: string): Motion | undefined {
   }
   const one = record?.travel && 'source' in record.travel ? record.travel : undefined
   const travel = one?.source && 'part' in one.source ? { part: one.source.part, axis: one.source.axis, ...(one.plus ? { plus: one.plus } : {}) } : undefined
-  return { kind, axis, control: control(quantity), ...(record?.mimic ? { follows: figureMimicTermsOf(record.mimic)! } : {}), ...(travel ? { travel } : {}) }
+  return { kind, axis, ...(vector ? { vector } : {}), control: control(quantity), ...(record?.mimic ? { follows: figureMimicTermsOf(record.mimic)! } : {}), ...(travel ? { travel } : {}) }
 }
 
 /** What the motion form holds: how the part moves, and either its own control or the joint it moves with. */
 export interface MotionForm {
   kind: 'slide' | 'turn' | 'continuous'
   axis: Axis
+  /** An axis that is a vector (ADR-0107): said, not chosen here, and written back unchanged. */
+  axisVector?: JointAxisVector
   id: string
   min: number
   max: number
@@ -531,10 +549,13 @@ export function motionFormOf(joint: FigureJoint): MotionForm {
   const travelSum = joint.travel && 'sum' in joint.travel ? joint.travel : undefined
   const terms = figureMimicTermsOf(joint.mimic)
   const single = terms?.sum.length === 1 ? terms.sum[0] : undefined
+  const axisVector = jointAxisVectorOf(joint.axis)
   return {
     kind,
-    axis: (joint.axis ?? 'X').toLowerCase() as Axis,
-    id: joint.state?.id ?? '',
+    axis: jointAxisToken(joint.axis) ?? 'x',
+    ...(axisVector ? { axisVector } : {}),
+    /* A moving joint with no state record is driven by the input named after it (figure-model `stateIdOf`): keep that name, so an edit does not rename the control a board or a controller writes to. */
+    id: joint.state?.id ?? (joint.type !== 'fixed' && !joint.mimic ? joint.id : ''),
     min: travel || travelSum ? 0 : (joint.lowerLimit ?? (kind === 'slide' ? 0 : -90)),
     max: travel || travelSum ? 500 : (joint.upperLimit ?? (kind === 'slide' ? 500 : 90)),
     follow: single?.joint ?? '',
@@ -569,7 +590,7 @@ export function motionJoint(joint: FigureJoint, m: MotionForm, part: string): Fi
     /* A row keeps being a row when it is given a motion: dropped here, the row went with it (designer 2026-09-27). */
     ...(joint.repeat ? { repeat: joint.repeat } : {}),
     type: m.kind === 'slide' ? ('prismatic' as const) : ('revolute' as const),
-    axis: m.axis.toUpperCase() as 'X' | 'Y' | 'Z'
+    axis: (m.axisVector ?? m.axis.toUpperCase()) as FigureJoint['axis']
   }
   if (m.follow) return { ...moving, mimic: { joint: m.follow, multiplier: m.multiplier, ...(m.offset ? { offset: m.offset } : {}) } }
   if (m.followSum) return { ...moving, mimic: { sum: m.followSum, ...(m.offset ? { offset: m.offset } : {}) } }
@@ -581,6 +602,18 @@ export function motionJoint(joint: FigureJoint, m: MotionForm, part: string): Fi
   return { ...moving, ...(m.kind === 'continuous' ? {} : { lowerLimit: m.min, upperLimit: m.max }), state: { id: m.id || `${part}-${m.kind}` } }
 }
 
+/**
+ * Why the motion form cannot be saved as it stands, as the kernel would refuse it: a follower's multiplier that is not
+ * a number or is 0, or a range whose most is not above its least. A range need not hold 0 -- the control starts at the
+ * nearest end (a lift that rests at 200 mm).
+ */
+export function motionFormRefusalOf(m: MotionForm, follow: string): 'multiplier' | 'range' | undefined {
+  if (m.followSum) return undefined
+  if (follow) return Number.isFinite(m.multiplier) && m.multiplier !== 0 ? undefined : 'multiplier'
+  if (m.kind === 'continuous' || (m.kind === 'slide' && (m.travel || m.travelSum))) return undefined
+  return Number.isFinite(m.min) && Number.isFinite(m.max) && m.max > m.min ? undefined : 'range'
+}
+
 /** The select's value for what a dimension follows now. */
 export function choiceOf(follow: Follow): string {
   switch (follow.of) {

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

@@ -317,7 +317,9 @@ export class FigureListPage extends FigureListPageBase {
           header: i18next.t('figure.label.figure-type'),
           record: {
             editable: false,
-            renderer: (value: string) => html`<code>${value}</code>`
+            /* The full name a board stores: {namespace}/{type} (ADR-0114). */
+            renderer: (value: string, column: unknown, record: { namespace?: string }) =>
+              html`<code>${record?.namespace ? `${record.namespace}/${value}` : value}</code>`
           },
           filter: 'search',
           sortable: true,

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

@@ -28,6 +28,7 @@ import {
   provideAssistantSurface
 } from '@things-factory/ai-assistant/dist-client/index.js'
 import type { FirstSave } from '../modeller/first-save.js'
+import { typeOf } from '../modeller/first-save.js'
 import { placementRefusalOf } from '../modeller/refusals.js'
 import { proposalOutcomeFrom, takeFigureOffer, takePendingNewFigure } from '../modeller/ai-proposal.js'
 
@@ -111,7 +112,7 @@ export class FigureModellerPage extends PageView {
    * `figure-modeller` 가 이 화면으로 바뀌면 저작자는 발행을 할 수 없었다. 새 도형은 공간을 선언하기 전에는 전부
    * 발행 판정에 막히는데 그 선언을 할 단추도 없었다(2026-09-24 확인). 그래서 발행 패널을 건다.
    */
-  @state() private row: { state?: 'draft' | 'released'; version: number; type?: string; category?: string; tags?: string[] } = {
+  @state() private row: { state?: 'draft' | 'released'; version: number; namespace?: string; type?: string; category?: string; tags?: string[] } = {
     version: 0
   }
   @state() private typeError = ''
@@ -235,6 +236,7 @@ export class FigureModellerPage extends PageView {
         this.row = {
           state: figure.state as 'draft' | 'released',
           version: figure.version ?? 0,
+          namespace: figure.namespace ?? undefined,
           type: figure.type,
           category: figure.category ?? undefined,
           tags: figure.tags ?? undefined
@@ -253,7 +255,7 @@ export class FigureModellerPage extends PageView {
   private renameType = async (event: Event) => {
     const input = event.target as HTMLInputElement
     const id = this.session.read().id
-    const wanted = input.value.trim().replace(/[^A-Za-z0-9_]/g, '_').toUpperCase()
+    const wanted = typeOf(input.value)
     input.value = wanted
     /*
       A figure not saved yet has no row to rename: the type is held here and the first save's question opens with it.
@@ -533,6 +535,7 @@ export class FigureModellerPage extends PageView {
         .figureState=${this.row.state}
         .figureVersion=${this.row.version}
         .figureType=${this.row.type}
+        .figureNamespace=${this.row.namespace}
         .dirty=${!!view.dirty}
         .saveFirst=${this.saveBeforeRevert}
         .serverSource=${() => this.session.confirmedSource()}

package/client/types.ts

@@ -7,6 +7,8 @@ export interface Figure {
   id: string
   /** 컴포넌트 타입 이름. **만든 뒤에 고칠 수 없다.** */
   type: string
+  /** Namespace of the full name {namespace}/{type} (ADR-0114). */
+  namespace?: string | null
   name: string
   description?: string
   /** 분류 하나 — 팔레트에서 묶어 보이는 기준. */

package/dist-client/graphql/index.js

@@ -34,6 +34,7 @@ function unwrap(response, field) {
  */
 const FIGURE_LIST_FIELDS = `
   id
+  namespace
   type
   name
   description