@things-factory/figure-ui 10.1.160 → 10.1.162

package/client/modeller/data-interface.ts

@@ -108,3 +108,20 @@ export function dataSampleOf(asset: FigureAsset, values: Record<string, FigureDa
   const issues = validateFigureDataValues(plan, values)
   return issues.length ? { issues } : { result: evaluateFigureDataInterface(plan, values) }
 }
+
+/**
+ * Which fields of each motion group the data interface writes: its clip (a lookup to `motion-clip`), its speed
+ * (`motion-speed`). The data always writes them -- from a live value, a saved one, or the property's default -- and
+ * wins over a group's own setting for that field (detail design §5.1), so a control for such a field moves nothing.
+ */
+export function motionWrittenByData(asset: FigureAsset): Record<string, { clip: boolean; speed: boolean }> {
+  const out: Record<string, { clip: boolean; speed: boolean }> = {}
+  for (const c of asset.dataInterface?.connections ?? []) {
+    if (c.target.kind !== 'motion-clip' && c.target.kind !== 'motion-speed') continue
+    const one = (out[c.target.group] ??= { clip: false, speed: false })
+    if (c.target.kind === 'motion-clip') one.clip = true
+    else one.speed = true
+  }
+  return out
+}
+

package/client/modeller/figure-preview.ts

@@ -3,11 +3,12 @@ import { customElement, property, query, state } from 'lit/decorators.js'
 
 import { i18next, localize } from '@operato/i18n'
 import { compileFigureAsset } from '@hatiolab/figure-model'
-import type { FigureAsset } from '@hatiolab/figure-model'
+import type { FigureAsset, FigureDataProperty, FigureDataValue } from '@hatiolab/figure-model'
 import { create, registerFigure, unregisterFigure } from '@hatiolab/things-scene'
 
 import { DEFAULT_VIEW, previewBoardDepth, sceneLook, WORKBENCH, type ViewSettings } from '@things-factory/figure-viewer/dist-client/figure-view.js'
 import { dialShape } from './angle-dial.js'
+import { domainOf, motionWrittenByData, sampleValueOf } from './data-interface.js'
 import { derivedOf, type FigureRevision } from './revision.js'
 import { authoredSizeOf, PREVIEW_FACTOR, PREVIEW_WAYS, previewClampsOf, previewInstances, previewTypeOf, setupPartOf } from '@things-factory/figure-viewer/dist-client/preview-model.js'
 
@@ -208,6 +209,8 @@ export class FigurePreview extends localize(i18next)(LitElement) {
   @state() private giving: Record<string, number> = {}
   /** Per motion group, the clip played here and how fast (ADR-0051 §3.2) -- the preview's, as a board's \`motion\`. */
   @state() private moving: Record<string, { clip: string; speed: number }> = {}
+  /** Data values given here, as a board's saved `figureValues`: what moves a group whose clip or speed the data writes. */
+  @state() private valuing: Record<string, FigureDataValue> = {}
   /** Data values tried in the data tab: the preview's figures run on them as a live snapshot; null when none are. */
   @property({ attribute: false }) sample: Record<string, unknown> | null = null
   /** The part chosen in the editor. The size help starts on it, so the help speaks of the part the author was working on. */
@@ -261,7 +264,7 @@ export class FigurePreview extends localize(i18next)(LitElement) {
               </select>
               <button @click=${() => this.dispatchEvent(new CustomEvent('configure-size', { detail: { part: setupPart }, bubbles: true, composed: true }))}>${i18next.t('figure.button.configure-size')}</button>
             </div>` : nothing}
-            ${controls.length + clips.length + (asset?.motionGroups?.length ?? 0) ? this.renderDrivers(asset!, controls, clips) : nothing}</div>`}`
+            ${controls.length + clips.length + (asset?.motionGroups?.length ?? 0) + (asset?.dataInterface?.properties.length ?? 0) ? this.renderDrivers(asset!, controls, clips) : nothing}</div>`}`
   }
 
   private renderDrivers(asset: FigureAsset, controls: FigureAsset['document']['model']['inputs'], clips: string[]) {
@@ -303,24 +306,56 @@ export class FigurePreview extends localize(i18next)(LitElement) {
           <output>${value.toFixed(2)}</output>
         </label>`
       })}
+      ${(asset.dataInterface?.properties ?? []).map(property => this.renderDataValue(property))}
       ${(asset.motionGroups ?? []).map(group => {
         const playing = this.moving[group.id] ?? { clip: group.defaultClip, speed: 0 }
-        return html`<label>
-            <span>${group.label} <span drive>${i18next.t('figure.label.clip')}</span></span>
-            <select aria-label=${group.label} @change=${(e: Event) => this.move(group.id, { ...playing, clip: (e.target as HTMLSelectElement).value })}>
-              ${group.clips.map(c => html`<option value=${c} ?selected=${c === playing.clip}>${c}</option>`)}
-            </select>
-          </label>
-          <label>
-            <span>${group.label} <span drive>${i18next.t('figure.label.playback-speed')}</span></span>
-            <span></span>
-            <input type="range" min="0" max="3" step="0.05" .value=${String(playing.speed)} @input=${(e: Event) => this.move(group.id, { ...playing, speed: Number((e.target as HTMLInputElement).value) })} />
-            <output>${playing.speed.toFixed(2)}</output>
-          </label>`
+        /* A field the data writes wins over the group's own setting, here as on a board: it is moved by the data values above. */
+        const byData = motionWrittenByData(asset)[group.id] ?? { clip: false, speed: false }
+        return html`${byData.clip
+            ? nothing
+            : html`<label>
+                <span>${group.label} <span drive>${i18next.t('figure.label.clip')}</span></span>
+                <select aria-label=${group.label} @change=${(e: Event) => this.move(group.id, { ...playing, clip: (e.target as HTMLSelectElement).value })}>
+                  ${group.clips.map(c => html`<option value=${c} ?selected=${c === playing.clip}>${c}</option>`)}
+                </select>
+              </label>`}
+          ${byData.speed
+            ? nothing
+            : html`<label>
+                <span>${group.label} <span drive>${i18next.t('figure.label.playback-speed')}</span></span>
+                <span></span>
+                <input type="range" min="0" max="3" step="0.05" .value=${String(playing.speed)} @input=${(e: Event) => this.move(group.id, { ...playing, speed: Number((e.target as HTMLInputElement).value) })} />
+                <output>${playing.speed.toFixed(2)}</output>
+              </label>`}`
       })}
     </div>`
   }
 
+  /** A data property's value, as the board's data values give it: a number on a slider, a boolean or an enum chosen. */
+  private renderDataValue(property: FigureDataProperty) {
+    const value = this.valuing[property.id] ?? property.default
+    if (property.kind === 'number') {
+      const step = Math.max((property.max - property.min) / 100, 0.01)
+      return html`<label>
+        <span>${property.label} <span drive>${property.unit}</span></span>
+        <span></span>
+        <input type="range" min=${property.min} max=${property.max} step=${step} .value=${String(value)} @input=${(e: Event) => this.value(property, (e.target as HTMLInputElement).value)} />
+        <output>${Number(value).toFixed(2)}</output>
+      </label>`
+    }
+    return html`<label>
+      <span>${property.label}</span>
+      <select aria-label=${property.label} @change=${(e: Event) => this.value(property, (e.target as HTMLSelectElement).value)}>
+        ${domainOf(property).map(v => html`<option value=${String(v)} ?selected=${v === value}>${typeof v === 'boolean' ? i18next.t(v ? 'figure.label.data-true' : 'figure.label.data-false') : v}</option>`)}
+      </select>
+    </label>`
+  }
+
+  private value(property: FigureDataProperty, typed: string) {
+    this.valuing = { ...this.valuing, [property.id]: sampleValueOf(property, typed) }
+    this.tellInstances('figureValues', this.valuing)
+  }
+
   private move(group: string, playing: { clip: string; speed: number }) {
     this.moving = { ...this.moving, [group]: playing }
     this.tellInstances('motion', Object.fromEntries(Object.entries(this.moving).map(([id, m]) => [id, { ...m, paused: false }])))
@@ -352,7 +387,7 @@ export class FigurePreview extends localize(i18next)(LitElement) {
     this.giving = {}
   }
 
-  private tellInstances(key: 'clips' | 'parameters' | 'motion' | 'figureData', values: Record<string, unknown> | null) {
+  private tellInstances(key: 'clips' | 'parameters' | 'motion' | 'figureData' | 'figureValues', values: Record<string, unknown> | null) {
     for (const component of this.scene?.root?.components ?? []) {
       const value = values === null ? null : { ...values }
       /* A live snapshot is transient on the figure (its \`figureData\` accessor), never written into the saved model. */
@@ -436,6 +471,7 @@ export class FigurePreview extends localize(i18next)(LitElement) {
       if (!again) this.teardown()
       this.driving = {}
       this.moving = {}
+      this.valuing = {}
       registerFigure(type, asset)
       this.registered = type
       const { components, board } = previewInstances(type, size)

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

@@ -10,7 +10,7 @@ import { i18next, localize } from '@operato/i18n'
 import { p13n } from '@operato/p13n'
 import { auth } from '@things-factory/auth-base/dist-client'
 import { navigate, PageView } from '@operato/shell'
-import { CommonGristStyles, CommonHeaderStyles, ScrollbarStyles, WorkSurfacePageStyles } from '@operato/styles'
+import { CardCatalogStyles, CommonGristStyles, CommonHeaderStyles, ScrollbarStyles, WorkSurfacePageStyles } from '@operato/styles'
 
 import { capacityFrom } from '../modeller/scene-budget.js'
 import { deleteFigure, fetchFigureList } from '../graphql/index.js'
@@ -84,88 +84,21 @@ export class FigureListPage extends FigureListPageBase {
     ScrollbarStyles,
     CommonGristStyles,
     CommonHeaderStyles,
+    CardCatalogStyles,
     css`
       :host {
         background-color: var(--md-sys-color-surface);
         color: var(--md-sys-color-on-surface);
-        /* 떠 있는 단추의 기준 상자 */
-        position: relative;
       }
 
       /*
-        ── 만들기 단추 ────────────────────────────────────────────────────────
-        이 화면의 주된 동작 하나. 목록 위에 떠 있고 자리를 먹지 않는다.
-
-        글자를 함께 둔다(extended FAB). 아이콘만 두면 처음 온 사람은 + 표가 무엇을 만드는지
-        모른다 — 이 화면에서 만들 수 있는 것이 무엇인지가 그 글자다.
-      */
-      button[fab] {
-        position: absolute;
-        right: var(--spacing-large, 12px);
-        bottom: var(--spacing-large, 12px);
-        z-index: 10;
-
-        display: flex;
-        align-items: center;
-        gap: 6px;
-        padding: 10px 18px 10px 14px;
-        font: var(--label-font, inherit);
-        font-size: 0.82rem;
-        font-weight: 600;
-        color: var(--md-sys-color-on-primary-container);
-        background-color: var(--md-sys-color-primary-container);
-        border: none;
-        /* 떠 있는 것의 모서리는 알약이다 — 담는 면(6px)을 따르지 않는다 */
-        border-radius: var(--md-sys-shape-corner-full, 999px);
-        box-shadow: 0 2px 6px rgba(0, 0, 0, 0.18);
-        cursor: pointer;
-      }
-      button[fab]:hover {
-        color: var(--md-sys-color-on-primary, #fff);
-        background-color: var(--md-sys-color-primary);
-      }
-      button[fab] md-icon {
-        --md-icon-size: 20px;
-      }
-
-      /* 격자가 바깥에 요구하는 것은 확정된 높이 하나뿐이다 — 스크롤은 격자가 안에서 한다 */
-      /*
-        ── 그림이 주인공인 카탈로그 ────────────────────────────────────────
-        카드 기본값은 글이 많은 목록(직원·결재함)에 맞춰져 있다. 여기서는 사람이 먼저 보는 것이
-        형상 그림이므로, 그림 칸을 비율로 잡아 카드 폭이 달라져도 그림이 나란히 읽히게 한다.
-
-        그림은 카드 끝까지 닿는다 — 위쪽 모서리만 카드와 같은 6px 로 깎아 한 장처럼 보이게 하고,
-        그림 안에 얹히는 초안 표시·삭제는 figure-thumb 이 그린다.
+        카드 · 그림 칸 · 만들기 FAB 는 모든 카드 카탈로그와 같다(@operato/styles CardCatalogStyles,
+        ADR-0117 개정 2026-10-13). 여기에는 이 화면에만 있는 것만 둔다.
       */
       ox-grist {
-        --data-card-min-width: 240px;
-        --data-card-record-card-border-radius: 6px;
-        --data-card-record-card-padding: 0;
-        --data-card-thumbnail-height: auto;
-        --data-card-thumbnail-aspect: 4 / 3;
-        --data-card-thumbnail-padding: 0;
-        --data-card-thumbnail-radius: 6px 6px 0 0;
-        --data-card-thumbnail-background: var(--md-sys-color-surface-container);
-
-        /*
-          카드 기본 글꼴은 굵다(제목 bold 1.1em). 글이 정보를 나르는 목록에서는 맞지만, 여기서
-          정보를 나르는 것은 그림이다. 굵은 제목이 카드마다 서면 그림보다 글이 먼저 읽힌다 —
-          이름은 알아볼 정도로만, 타입은 곁글로 둔다.
-        */
-        --data-card-item-name-font: 500 0.9rem/1.35 var(--theme-font, 'Roboto');
-        --data-card-item-name-color: var(--md-sys-color-on-surface);
-        --data-card-item-disc-font: normal 0.72rem/1.2 var(--theme-font, 'Roboto');
-        --data-card-item-disc-color: var(--md-sys-color-on-surface-variant, var(--md-sys-color-on-surface));
-        --data-card-item-etc-font: normal 0.72rem/1.2 var(--theme-font, 'Roboto');
-
         /* 상태와 성숙도는 짧은 표식이다 — 두 줄로 세우지 않고 한 줄에 뉜다 */
         --data-card-detail-direction: row;
-
-        /*
-          맨 위로 가는 화살표를 만들기 단추 **위로** 올린다. 둘 다 오른쪽 아래에 떠 있으므로
-          그냥 두면 겹친다 — 단추(36px + 아래 여백 12px) 위에 12px 을 띄운 자리다.
-        */
-        --data-card-fab-position-vertical: 64px;
+        /* 표 모드의 맨 위로 단추도 만들기 단추 위로 비킨다 */
         --data-list-fab-position-vertical: 64px;
       }
     `

package/client/setting-let/figure-namespace-setting-let.ts

@@ -17,9 +17,11 @@ import { fetchFigureNamespace, setFigureNamespace, type FigureNamespaceState } f
 export class FigureNamespaceSettingLet extends localize(i18next)(LitElement) {
   static styles = [
     css`
+      /* A namespace is lower-case by rule: the card's capitalised words must not reach it, nor what is typed. */
       div[slot='content'] {
         display: grid;
         gap: var(--spacing-small, 4px);
+        text-transform: none;
       }
       md-filled-text-field {
         width: 100%;
@@ -32,7 +34,6 @@ export class FigureNamespaceSettingLet extends localize(i18next)(LitElement) {
         margin: 0;
         font-size: 0.8rem;
         color: var(--md-sys-color-on-surface-variant);
-        text-transform: none;
       }
     `
   ]

package/client/viewparts/figure-thumb.ts

@@ -4,6 +4,7 @@ import { css, html, LitElement } from 'lit'
 import { customElement, property } from 'lit/decorators.js'
 
 import { i18next, localize } from '@operato/i18n'
+import '@operato/data-grist/ox-card-thumb.js'
 import '@things-factory/figure-viewer/dist-client/figure-thumb-mark.js'
 import { getPathInfo } from '@operato/utils'
 
@@ -31,7 +32,8 @@ function thumbnailSrc(figure: Figure): string | undefined {
 }
 
 /**
- * 카드의 그림 칸.
+ * 카드의 그림 칸. 그림 · 그림 없음 · 초안 표시는 모든 카드 카탈로그의 `ox-card-thumb`(@operato/data-grist)가
+ * 그리고, 여기서는 그 위에 이 카탈로그의 것(태그 · 삭제)만 얹는다(ADR-0117 개정 2026-10-13).
  *
  * ## 왜 컴포넌트인가
  *
@@ -53,39 +55,9 @@ function thumbnailSrc(figure: Figure): string | undefined {
 export class FigureThumb extends localize(i18next)(LitElement) {
   static styles = css`
     :host {
-      position: relative;
       display: block;
       width: 100%;
       height: 100%;
-      overflow: hidden;
-    }
-
-    img {
-      display: block;
-      width: 100%;
-      height: 100%;
-      /* 형상을 자르지 않는다 — 긴 것(컨베이어)과 높은 것(시그널타워)이 한 줄에 선다 */
-      object-fit: contain;
-    }
-
-    /*
-      초안 표시.
-
-      발행된 것에는 아무 말도 하지 않는다 — 카탈로그에 있는 것은 대개 발행된 것이라, 카드마다
-      「발행됨」이 붙으면 아무것도 가르지 않고 자리만 먹는다. 초안만 말하면 이 표시가 있는 카드가
-      곧 「아직 쓰면 안 되는 것」이 된다.
-    */
-    span[draft] {
-      position: absolute;
-      top: 6px;
-      left: 6px;
-      padding: 1px 7px;
-      font: var(--label-font, inherit);
-      font-size: 0.68rem;
-      line-height: 1.5;
-      color: var(--md-sys-color-on-secondary-container);
-      background-color: var(--md-sys-color-secondary-container);
-      border-radius: 4px;
     }
 
     /*
@@ -188,12 +160,12 @@ export class FigureThumb extends localize(i18next)(LitElement) {
     const src = thumbnailSrc(figure)
 
     return html`
-      ${src
-        ? html`<img src=${src} alt=${figure.name || ''} loading="lazy" />`
-        : html`
-            <figure-thumb-mark .label=${i18next.t('figure.text.thumbnail-not-made-yet')}></figure-thumb-mark>
-          `}
-      ${figure.state === 'released' ? '' : html`<span draft>${i18next.t('figure.label.draft')}</span>`}
+      <ox-card-thumb
+        src=${src || ''}
+        alt=${figure.name || ''}
+        badge=${figure.state === 'released' ? '' : i18next.t('figure.label.draft')}
+      >
+        <figure-thumb-mark slot="empty" .label=${i18next.t('figure.text.thumbnail-not-made-yet')}></figure-thumb-mark>
       ${figure.tags?.length
         ? html`<div tags>
             ${figure.tags.map(
@@ -225,6 +197,7 @@ export class FigureThumb extends localize(i18next)(LitElement) {
       >
         <md-icon>delete</md-icon>
       </button>
+      </ox-card-thumb>
     `
   }
 }

package/dist-client/modeller/data-interface.d.ts

@@ -40,3 +40,12 @@ export declare function dataSampleOf(asset: FigureAsset, values: Record<string,
 } | {
     issues: FigureDataValueIssue[];
 };
+/**
+ * Which fields of each motion group the data interface writes: its clip (a lookup to `motion-clip`), its speed
+ * (`motion-speed`). The data always writes them -- from a live value, a saved one, or the property's default -- and
+ * wins over a group's own setting for that field (detail design §5.1), so a control for such a field moves nothing.
+ */
+export declare function motionWrittenByData(asset: FigureAsset): Record<string, {
+    clip: boolean;
+    speed: boolean;
+}>;

package/dist-client/modeller/data-interface.js

@@ -92,4 +92,22 @@ export function dataSampleOf(asset, values) {
     const issues = validateFigureDataValues(plan, values);
     return issues.length ? { issues } : { result: evaluateFigureDataInterface(plan, values) };
 }
+/**
+ * Which fields of each motion group the data interface writes: its clip (a lookup to `motion-clip`), its speed
+ * (`motion-speed`). The data always writes them -- from a live value, a saved one, or the property's default -- and
+ * wins over a group's own setting for that field (detail design §5.1), so a control for such a field moves nothing.
+ */
+export function motionWrittenByData(asset) {
+    const out = {};
+    for (const c of asset.dataInterface?.connections ?? []) {
+        if (c.target.kind !== 'motion-clip' && c.target.kind !== 'motion-speed')
+            continue;
+        const one = (out[c.target.group] ??= { clip: false, speed: false });
+        if (c.target.kind === 'motion-clip')
+            one.clip = true;
+        else
+            one.speed = true;
+    }
+    return out;
+}
 //# sourceMappingURL=data-interface.js.map

package/dist-client/modeller/data-interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-interface.js","sourceRoot":"","sources":["../../client/modeller/data-interface.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The figure's public data properties and what each moves (ADR-0051 §2.2): what the data tab offers and shows. Every\n * rule is figure-model's -- which transform a property may take, whether a connection holds, what a sample moves; this\n * only lists what there is to choose and drafts a first connection the kernel then checks. Kept apart from the element so\n * it is tested without a browser.\n */\nimport { compileFigureDataInterface, evaluateFigureDataInterface, validateFigureDataValues, FIGURE_PART_ID } from '@hatiolab/figure-model'\nimport type { FigureAsset, FigureDataConnection, FigureDataProperty, FigureDataResult, FigureDataTarget, FigureDataValue, FigureDataValueIssue } from '@hatiolab/figure-model'\n\n/** Something a connection can write, with what the screen shows of it. */\nexport interface DataTargetChoice {\n  /** One string per target, for a select's value. */\n  key: string\n  target: FigureDataTarget\n  /** The control's label, the colour token, or the group's label. */\n  name: string\n  unit?: string\n  min?: number\n  max?: number\n}\n\nexport const targetKeyOf = (t: FigureDataTarget): string =>\n  t.kind === 'state' ? `state:${t.input}` : t.kind === 'palette' ? `palette:${t.token}` : `${t.kind}:${t.group}`\n\n/**\n * What a property of this kind can be connected to: a number moves a control or a group's speed; an enum or a boolean\n * moves a control, a colour or which clip of a group plays (through a case per value). A control is offered observed: a\n * value read from the machine applies as it comes.\n */\nexport function dataTargetsOf(asset: FigureAsset, kind: FigureDataProperty['kind']): DataTargetChoice[] {\n  const out: DataTargetChoice[] = []\n  for (const input of asset.document.model.inputs) {\n    if (input.role !== 'state') continue\n    const target: FigureDataTarget = { kind: 'state', input: input.id, sourceMode: 'observed' }\n    out.push({ key: targetKeyOf(target), target, name: asset.stateInputs?.[input.id]?.label ?? input.id, unit: input.unit, min: input.min, max: input.max })\n  }\n  if (kind !== 'number')\n    for (const token of Object.keys(asset.palette)) {\n      const target: FigureDataTarget = { kind: 'palette', token }\n      out.push({ key: targetKeyOf(target), target, name: token })\n    }\n  for (const group of asset.motionGroups ?? []) {\n    const target: FigureDataTarget = kind === 'number' ? { kind: 'motion-speed', group: group.id } : { kind: 'motion-clip', group: group.id }\n    out.push({ key: targetKeyOf(target), target, name: group.label })\n  }\n  return out\n}\n\n/** The values a lookup has a case for: an enum's values, or both booleans. Nothing for a number. */\nexport const domainOf = (property: FigureDataProperty): FigureDataValue[] =>\n  property.kind === 'enum' ? [...property.values] : property.kind === 'boolean' ? [false, true] : []\n\n/** An id not taken among `taken`: `base`, then `base-2`, `base-3`, … made into the kernel's id shape. */\nexport function freeDataIdOf(taken: Iterable<string>, base: string): string {\n  const used = new Set(taken)\n  const cleaned = base.replace(/[^a-zA-Z0-9_-]+/g, '-').replace(/^[^a-zA-Z]+/, '').replace(/-+$/, '') || 'data'\n  const id = FIGURE_PART_ID.test(cleaned) ? cleaned : 'data'\n  if (!used.has(id)) return id\n  let n = 2\n  while (used.has(`${id}-${n}`)) n++\n  return `${id}-${n}`\n}\n\n/**\n * A first connection of a property to a target, for the author to adjust: a number as it is in the control's own unit,\n * or scaled from another; an enum or a boolean case by case, each case at what the target shows now -- the control's\n * rest value, the colour, the group's first clip. The kernel says whether it holds.\n */\nexport function connectionDraftOf(asset: FigureAsset, property: FigureDataProperty, choice: DataTargetChoice): FigureDataConnection {\n  const taken = (asset.dataInterface?.connections ?? []).map(c => c.id)\n  const id = freeDataIdOf(taken, `${property.id}-${choice.target.kind === 'state' ? choice.target.input : choice.target.kind === 'palette' ? 'colour' : choice.target.group}`)\n  const target = choice.target\n  if (property.kind === 'number') {\n    const same = target.kind === 'motion-speed' || (target.kind === 'state' && choice.unit === property.unit)\n    return { id, property: property.id, transform: same ? { kind: 'identity' } : { kind: 'affine', scale: 1, offset: 0 }, target }\n  }\n  const now: FigureDataValue =\n    target.kind === 'state'\n      ? (asset.stateDefaults[target.input] ?? 0)\n      : target.kind === 'palette'\n        ? (asset.palette[target.token] ?? '#000000')\n        : ((asset.motionGroups ?? []).find(g => g.id === target.group)?.defaultClip ?? '')\n  return { id, property: property.id, transform: { kind: 'lookup', cases: domainOf(property).map(when => ({ when, value: now })) }, target }\n}\n\n/** What a property looks like when first made: a number 0 to 1, a boolean off, an enum of two values. */\nexport function propertyDraftOf(asset: FigureAsset, label: string, kind: FigureDataProperty['kind']): FigureDataProperty {\n  const id = freeDataIdOf((asset.dataInterface?.properties ?? []).map(p => p.id), label)\n  if (kind === 'number') return { id, label, kind, unit: 'ratio', min: 0, max: 1, default: 0 }\n  if (kind === 'boolean') return { id, label, kind, default: false }\n  return { id, label, kind, values: ['off', 'on'], default: 'off' }\n}\n\n/** A value typed in a sample field, as the property takes it: a number, true or false, or the enum value. */\nexport function sampleValueOf(property: FigureDataProperty, typed: string): FigureDataValue {\n  if (property.kind === 'number') return typed.trim() === '' ? Number.NaN : Number(typed)\n  if (property.kind === 'boolean') return typed === 'true'\n  return typed\n}\n\n/**\n * What a sample of values would move, as the figure would run it: the kernel's check and evaluation of the interface.\n * Refused whole when one value cannot be taken, with each one's reason, as a live snapshot is.\n */\nexport function dataSampleOf(asset: FigureAsset, values: Record<string, FigureDataValue>): { result: FigureDataResult } | { issues: FigureDataValueIssue[] } {\n  const plan = compileFigureDataInterface(asset)\n  if (!plan) return { issues: [] }\n  const issues = validateFigureDataValues(plan, values)\n  return issues.length ? { issues } : { result: evaluateFigureDataInterface(plan, values) }\n}\n"]}
+{"version":3,"file":"data-interface.js","sourceRoot":"","sources":["../../client/modeller/data-interface.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The figure's public data properties and what each moves (ADR-0051 §2.2): what the data tab offers and shows. Every\n * rule is figure-model's -- which transform a property may take, whether a connection holds, what a sample moves; this\n * only lists what there is to choose and drafts a first connection the kernel then checks. Kept apart from the element so\n * it is tested without a browser.\n */\nimport { compileFigureDataInterface, evaluateFigureDataInterface, validateFigureDataValues, FIGURE_PART_ID } from '@hatiolab/figure-model'\nimport type { FigureAsset, FigureDataConnection, FigureDataProperty, FigureDataResult, FigureDataTarget, FigureDataValue, FigureDataValueIssue } from '@hatiolab/figure-model'\n\n/** Something a connection can write, with what the screen shows of it. */\nexport interface DataTargetChoice {\n  /** One string per target, for a select's value. */\n  key: string\n  target: FigureDataTarget\n  /** The control's label, the colour token, or the group's label. */\n  name: string\n  unit?: string\n  min?: number\n  max?: number\n}\n\nexport const targetKeyOf = (t: FigureDataTarget): string =>\n  t.kind === 'state' ? `state:${t.input}` : t.kind === 'palette' ? `palette:${t.token}` : `${t.kind}:${t.group}`\n\n/**\n * What a property of this kind can be connected to: a number moves a control or a group's speed; an enum or a boolean\n * moves a control, a colour or which clip of a group plays (through a case per value). A control is offered observed: a\n * value read from the machine applies as it comes.\n */\nexport function dataTargetsOf(asset: FigureAsset, kind: FigureDataProperty['kind']): DataTargetChoice[] {\n  const out: DataTargetChoice[] = []\n  for (const input of asset.document.model.inputs) {\n    if (input.role !== 'state') continue\n    const target: FigureDataTarget = { kind: 'state', input: input.id, sourceMode: 'observed' }\n    out.push({ key: targetKeyOf(target), target, name: asset.stateInputs?.[input.id]?.label ?? input.id, unit: input.unit, min: input.min, max: input.max })\n  }\n  if (kind !== 'number')\n    for (const token of Object.keys(asset.palette)) {\n      const target: FigureDataTarget = { kind: 'palette', token }\n      out.push({ key: targetKeyOf(target), target, name: token })\n    }\n  for (const group of asset.motionGroups ?? []) {\n    const target: FigureDataTarget = kind === 'number' ? { kind: 'motion-speed', group: group.id } : { kind: 'motion-clip', group: group.id }\n    out.push({ key: targetKeyOf(target), target, name: group.label })\n  }\n  return out\n}\n\n/** The values a lookup has a case for: an enum's values, or both booleans. Nothing for a number. */\nexport const domainOf = (property: FigureDataProperty): FigureDataValue[] =>\n  property.kind === 'enum' ? [...property.values] : property.kind === 'boolean' ? [false, true] : []\n\n/** An id not taken among `taken`: `base`, then `base-2`, `base-3`, … made into the kernel's id shape. */\nexport function freeDataIdOf(taken: Iterable<string>, base: string): string {\n  const used = new Set(taken)\n  const cleaned = base.replace(/[^a-zA-Z0-9_-]+/g, '-').replace(/^[^a-zA-Z]+/, '').replace(/-+$/, '') || 'data'\n  const id = FIGURE_PART_ID.test(cleaned) ? cleaned : 'data'\n  if (!used.has(id)) return id\n  let n = 2\n  while (used.has(`${id}-${n}`)) n++\n  return `${id}-${n}`\n}\n\n/**\n * A first connection of a property to a target, for the author to adjust: a number as it is in the control's own unit,\n * or scaled from another; an enum or a boolean case by case, each case at what the target shows now -- the control's\n * rest value, the colour, the group's first clip. The kernel says whether it holds.\n */\nexport function connectionDraftOf(asset: FigureAsset, property: FigureDataProperty, choice: DataTargetChoice): FigureDataConnection {\n  const taken = (asset.dataInterface?.connections ?? []).map(c => c.id)\n  const id = freeDataIdOf(taken, `${property.id}-${choice.target.kind === 'state' ? choice.target.input : choice.target.kind === 'palette' ? 'colour' : choice.target.group}`)\n  const target = choice.target\n  if (property.kind === 'number') {\n    const same = target.kind === 'motion-speed' || (target.kind === 'state' && choice.unit === property.unit)\n    return { id, property: property.id, transform: same ? { kind: 'identity' } : { kind: 'affine', scale: 1, offset: 0 }, target }\n  }\n  const now: FigureDataValue =\n    target.kind === 'state'\n      ? (asset.stateDefaults[target.input] ?? 0)\n      : target.kind === 'palette'\n        ? (asset.palette[target.token] ?? '#000000')\n        : ((asset.motionGroups ?? []).find(g => g.id === target.group)?.defaultClip ?? '')\n  return { id, property: property.id, transform: { kind: 'lookup', cases: domainOf(property).map(when => ({ when, value: now })) }, target }\n}\n\n/** What a property looks like when first made: a number 0 to 1, a boolean off, an enum of two values. */\nexport function propertyDraftOf(asset: FigureAsset, label: string, kind: FigureDataProperty['kind']): FigureDataProperty {\n  const id = freeDataIdOf((asset.dataInterface?.properties ?? []).map(p => p.id), label)\n  if (kind === 'number') return { id, label, kind, unit: 'ratio', min: 0, max: 1, default: 0 }\n  if (kind === 'boolean') return { id, label, kind, default: false }\n  return { id, label, kind, values: ['off', 'on'], default: 'off' }\n}\n\n/** A value typed in a sample field, as the property takes it: a number, true or false, or the enum value. */\nexport function sampleValueOf(property: FigureDataProperty, typed: string): FigureDataValue {\n  if (property.kind === 'number') return typed.trim() === '' ? Number.NaN : Number(typed)\n  if (property.kind === 'boolean') return typed === 'true'\n  return typed\n}\n\n/**\n * What a sample of values would move, as the figure would run it: the kernel's check and evaluation of the interface.\n * Refused whole when one value cannot be taken, with each one's reason, as a live snapshot is.\n */\nexport function dataSampleOf(asset: FigureAsset, values: Record<string, FigureDataValue>): { result: FigureDataResult } | { issues: FigureDataValueIssue[] } {\n  const plan = compileFigureDataInterface(asset)\n  if (!plan) return { issues: [] }\n  const issues = validateFigureDataValues(plan, values)\n  return issues.length ? { issues } : { result: evaluateFigureDataInterface(plan, values) }\n}\n\n/**\n * Which fields of each motion group the data interface writes: its clip (a lookup to `motion-clip`), its speed\n * (`motion-speed`). The data always writes them -- from a live value, a saved one, or the property's default -- and\n * wins over a group's own setting for that field (detail design §5.1), so a control for such a field moves nothing.\n */\nexport function motionWrittenByData(asset: FigureAsset): Record<string, { clip: boolean; speed: boolean }> {\n  const out: Record<string, { clip: boolean; speed: boolean }> = {}\n  for (const c of asset.dataInterface?.connections ?? []) {\n    if (c.target.kind !== 'motion-clip' && c.target.kind !== 'motion-speed') continue\n    const one = (out[c.target.group] ??= { clip: false, speed: false })\n    if (c.target.kind === 'motion-clip') one.clip = true\n    else one.speed = true\n  }\n  return out\n}\n\n"]}

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

@@ -26,6 +26,8 @@ export declare class FigurePreview extends FigurePreview_base {
     private giving;
     /** Per motion group, the clip played here and how fast (ADR-0051 §3.2) -- the preview's, as a board's \`motion\`. */
     private moving;
+    /** Data values given here, as a board's saved `figureValues`: what moves a group whose clip or speed the data writes. */
+    private valuing;
     /** Data values tried in the data tab: the preview's figures run on them as a live snapshot; null when none are. */
     sample: Record<string, unknown> | null;
     /** The part chosen in the editor. The size help starts on it, so the help speaks of the part the author was working on. */
@@ -42,6 +44,9 @@ export declare class FigurePreview extends FigurePreview_base {
     private watcher?;
     render(): import("lit-html").TemplateResult<1>;
     private renderDrivers;
+    /** A data property's value, as the board's data values give it: a number on a slider, a boolean or an enum chosen. */
+    private renderDataValue;
+    private value;
     private move;
     private renderDial;
     private drive;

package/dist-client/modeller/figure-preview.js

@@ -6,6 +6,7 @@ import { compileFigureAsset } from '@hatiolab/figure-model';
 import { create, registerFigure, unregisterFigure } from '@hatiolab/things-scene';
 import { DEFAULT_VIEW, previewBoardDepth, sceneLook, WORKBENCH } from '@things-factory/figure-viewer/dist-client/figure-view.js';
 import { dialShape } from './angle-dial.js';
+import { domainOf, motionWrittenByData, sampleValueOf } from './data-interface.js';
 import { derivedOf } from './revision.js';
 import { authoredSizeOf, PREVIEW_FACTOR, PREVIEW_WAYS, previewClampsOf, previewInstances, previewTypeOf, setupPartOf } from '@things-factory/figure-viewer/dist-client/preview-model.js';
 let FigurePreview = class FigurePreview extends localize(i18next)(LitElement) {
@@ -27,6 +28,8 @@ let FigurePreview = class FigurePreview extends localize(i18next)(LitElement) {
         this.giving = {};
         /** Per motion group, the clip played here and how fast (ADR-0051 §3.2) -- the preview's, as a board's \`motion\`. */
         this.moving = {};
+        /** Data values given here, as a board's saved `figureValues`: what moves a group whose clip or speed the data writes. */
+        this.valuing = {};
         /** Data values tried in the data tab: the preview's figures run on them as a live snapshot; null when none are. */
         this.sample = null;
         /** The part chosen in the editor. The size help starts on it, so the help speaks of the part the author was working on. */
@@ -223,7 +226,7 @@ let FigurePreview = class FigurePreview extends localize(i18next)(LitElement) {
               </select>
               <button @click=${() => this.dispatchEvent(new CustomEvent('configure-size', { detail: { part: setupPart }, bubbles: true, composed: true }))}>${i18next.t('figure.button.configure-size')}</button>
             </div>` : nothing}
-            ${controls.length + clips.length + (asset?.motionGroups?.length ?? 0) ? this.renderDrivers(asset, controls, clips) : nothing}</div>`}`;
+            ${controls.length + clips.length + (asset?.motionGroups?.length ?? 0) + (asset?.dataInterface?.properties.length ?? 0) ? this.renderDrivers(asset, controls, clips) : nothing}</div>`}`;
     }
     renderDrivers(asset, controls, clips) {
         const changed = controls.filter(c => this.giving[c.id] !== undefined && this.giving[c.id] !== asset.stateDefaults[c.id]);
@@ -264,23 +267,53 @@ let FigurePreview = class FigurePreview extends localize(i18next)(LitElement) {
           <output>${value.toFixed(2)}</output>
         </label>`;
         })}
+      ${(asset.dataInterface?.properties ?? []).map(property => this.renderDataValue(property))}
       ${(asset.motionGroups ?? []).map(group => {
             const playing = this.moving[group.id] ?? { clip: group.defaultClip, speed: 0 };
-            return html `<label>
-            <span>${group.label} <span drive>${i18next.t('figure.label.clip')}</span></span>
-            <select aria-label=${group.label} @change=${(e) => this.move(group.id, { ...playing, clip: e.target.value })}>
-              ${group.clips.map(c => html `<option value=${c} ?selected=${c === playing.clip}>${c}</option>`)}
-            </select>
-          </label>
-          <label>
-            <span>${group.label} <span drive>${i18next.t('figure.label.playback-speed')}</span></span>
-            <span></span>
-            <input type="range" min="0" max="3" step="0.05" .value=${String(playing.speed)} @input=${(e) => this.move(group.id, { ...playing, speed: Number(e.target.value) })} />
-            <output>${playing.speed.toFixed(2)}</output>
-          </label>`;
+            /* A field the data writes wins over the group's own setting, here as on a board: it is moved by the data values above. */
+            const byData = motionWrittenByData(asset)[group.id] ?? { clip: false, speed: false };
+            return html `${byData.clip
+                ? nothing
+                : html `<label>
+                <span>${group.label} <span drive>${i18next.t('figure.label.clip')}</span></span>
+                <select aria-label=${group.label} @change=${(e) => this.move(group.id, { ...playing, clip: e.target.value })}>
+                  ${group.clips.map(c => html `<option value=${c} ?selected=${c === playing.clip}>${c}</option>`)}
+                </select>
+              </label>`}
+          ${byData.speed
+                ? nothing
+                : html `<label>
+                <span>${group.label} <span drive>${i18next.t('figure.label.playback-speed')}</span></span>
+                <span></span>
+                <input type="range" min="0" max="3" step="0.05" .value=${String(playing.speed)} @input=${(e) => this.move(group.id, { ...playing, speed: Number(e.target.value) })} />
+                <output>${playing.speed.toFixed(2)}</output>
+              </label>`}`;
         })}
     </div>`;
     }
+    /** A data property's value, as the board's data values give it: a number on a slider, a boolean or an enum chosen. */
+    renderDataValue(property) {
+        const value = this.valuing[property.id] ?? property.default;
+        if (property.kind === 'number') {
+            const step = Math.max((property.max - property.min) / 100, 0.01);
+            return html `<label>
+        <span>${property.label} <span drive>${property.unit}</span></span>
+        <span></span>
+        <input type="range" min=${property.min} max=${property.max} step=${step} .value=${String(value)} @input=${(e) => this.value(property, e.target.value)} />
+        <output>${Number(value).toFixed(2)}</output>
+      </label>`;
+        }
+        return html `<label>
+      <span>${property.label}</span>
+      <select aria-label=${property.label} @change=${(e) => this.value(property, e.target.value)}>
+        ${domainOf(property).map(v => html `<option value=${String(v)} ?selected=${v === value}>${typeof v === 'boolean' ? i18next.t(v ? 'figure.label.data-true' : 'figure.label.data-false') : v}</option>`)}
+      </select>
+    </label>`;
+    }
+    value(property, typed) {
+        this.valuing = { ...this.valuing, [property.id]: sampleValueOf(property, typed) };
+        this.tellInstances('figureValues', this.valuing);
+    }
     move(group, playing) {
         this.moving = { ...this.moving, [group]: playing };
         this.tellInstances('motion', Object.fromEntries(Object.entries(this.moving).map(([id, m]) => [id, { ...m, paused: false }])));
@@ -398,6 +431,7 @@ let FigurePreview = class FigurePreview extends localize(i18next)(LitElement) {
                 this.teardown();
             this.driving = {};
             this.moving = {};
+            this.valuing = {};
             registerFigure(type, asset);
             this.registered = type;
             const { components, board } = previewInstances(type, size);
@@ -489,6 +523,10 @@ __decorate([
     state(),
     __metadata("design:type", Object)
 ], FigurePreview.prototype, "moving", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], FigurePreview.prototype, "valuing", void 0);
 __decorate([
     property({ attribute: false }),
     __metadata("design:type", Object)