@things-factory/figure-ui 10.1.17 → 10.1.19

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

@@ -4,13 +4,41 @@ import { customElement, property, state } from 'lit/decorators.js';
 import { live } from 'lit/directives/live.js';
 import { i18next, localize } from '@operato/i18n';
 import { ScrollbarStyles } from '@operato/styles';
-import { AXES, CHANNEL_PATHS, CLIP_DRIVES, INTERPOLATIONS, LIMITS } from '@hatiolab/figure-model';
+import { AXES, CHANNEL_PATHS, INTERPOLATIONS, LIMITS } from '@hatiolab/figure-model';
+/*
+  레시피의 `end` 가 곧 그 범위의 끝 자세다 — 리프트가 100mm 올라가는 곡선이면 범위도
+  0~100mm 다. 둘이 어긋나면 저작자가 1200 을 주고도 100 만 올라가는 것을 보게 된다.
+*/
 const MOTION_RECIPES = [
-    { id: 'conveyor', name: 'conveyor-running', drive: 'loop', path: 'rotation', end: { x: 360, y: 0, z: 0 } },
-    { id: 'gate', name: 'gate-open', drive: 'hold', path: 'rotation', end: { x: 0, y: 90, z: 0 }, pivot: { x: 0, y: 0, z: 0 } },
-    { id: 'pusher', name: 'pusher-position', drive: 'hold', path: 'translation', end: { x: 100, y: 0, z: 0 } },
-    { id: 'lift', name: 'lift-height', drive: 'hold', path: 'translation', end: { x: 0, y: 100, z: 0 } }
+    { id: 'conveyor', name: 'conveyor-running', kind: 'clip', path: 'rotation', end: { x: 360, y: 0, z: 0 } },
+    {
+        id: 'gate',
+        name: 'gate-open',
+        kind: 'parameter',
+        path: 'rotation',
+        end: { x: 0, y: 90, z: 0 },
+        pivot: { x: 0, y: 0, z: 0 },
+        range: { unit: '%', min: 0, max: 100 }
+    },
+    {
+        id: 'pusher',
+        name: 'pusher-position',
+        kind: 'parameter',
+        path: 'translation',
+        end: { x: 100, y: 0, z: 0 },
+        range: { unit: 'mm', min: 0, max: 100 }
+    },
+    {
+        id: 'lift',
+        name: 'lift-height',
+        kind: 'parameter',
+        path: 'translation',
+        end: { x: 0, y: 100, z: 0 },
+        range: { unit: 'mm', min: 0, max: 100 }
+    }
 ];
+/** 새 파라미터의 범위. 단위는 저작자가 고쳐 쓴다 — 형식은 단위를 해석하지 않는다. */
+const NEW_RANGE = { unit: 'mm', min: 0, max: 1000 };
 /** 새 clip 의 키 둘. **하나로 만들지 않는다** — 키 하나는 움직임이 아니라 자세다. */
 const NEW_KEYS = [
     { at: 0, value: { x: 0, y: 0, z: 0 } },
@@ -23,29 +51,30 @@ function startValue(path) {
 function keysFor(path) {
     return NEW_KEYS.map(key => ({ at: key.at, value: startValue(path) }));
 }
-/** 이미 쓴 이름을 비켜 간다. `type` 처럼 저장되는 식별자는 아니지만 인스턴스가 이 이름으로 구동한다. */
-function freeName(taken) {
-    const used = new Set(taken.map(clip => clip.name));
-    for (let n = 1;; n++) {
-        const name = `clip-${n}`;
-        if (!used.has(name))
-            return name;
-    }
-}
-function freeRecipeName(taken, base) {
-    const used = new Set(taken.map(clip => clip.name));
-    if (!used.has(base))
-        return base;
+/**
+ * 이미 쓴 이름을 비켜 간다.
+ *
+ * **두 목록을 함께 본다.** 인스턴스는 이름 하나로 값을 주므로 애니메이션과 파라미터가
+ * 같은 이름을 가지면 어느 쪽에 준 것인지 알 수 없고, 형식이 그것을 오류로 막는다.
+ */
+function freeName(taken, stem) {
+    const used = new Set(taken.map(one => one.name));
+    if (!used.has(stem))
+        return stem;
     for (let n = 2;; n++)
-        if (!used.has(`${base}-${n}`))
-            return `${base}-${n}`;
+        if (!used.has(`${stem}-${n}`))
+            return `${stem}-${n}`;
 }
 let FigureAnimations = class FigureAnimations extends localize(i18next)(LitElement) {
     constructor() {
         super(...arguments);
         this.parts = [];
-        /** 펼쳐 둔 clip. 이름이 아니라 자리로 잡는다 — 이름은 편집 중에 바뀐다. */
-        this.open = 0;
+        /**
+         * 펼쳐 둔 것. 이름이 아니라 **목록과 자리**로 잡는다 — 이름은 편집 중에 바뀐다.
+         *
+         * 목록이 둘이므로 자리 하나로는 모자란다. `clip:0` 과 `parameter:0` 은 다른 것이다.
+         */
+        this.open = '';
         this.recipeTarget = '';
     }
     static { this.styles = [
@@ -248,6 +277,16 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
     get clips() {
         return this.draft?.animations ?? [];
     }
+    get parameters() {
+        return this.draft?.parameters ?? [];
+    }
+    /** 두 목록의 이름을 한자리에서 본다 — 인스턴스가 이름 하나로 값을 준다. */
+    get allNames() {
+        return [...this.clips, ...this.parameters];
+    }
+    channelsOf(kind, at) {
+        return (kind === 'clip' ? this.clips[at]?.channels : this.parameters[at]?.clip?.channels) ?? [];
+    }
     /** 부품 이름 — 채널이 이것을 가리킨다. */
     get partNames() {
         return this.parts.map(part => part.name).filter(name => !!name);
@@ -263,11 +302,16 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
         for (const clip of this.clips)
             for (const channel of clip.channels)
                 moving.add(channel.target);
+        for (const parameter of this.parameters) {
+            for (const channel of parameter.clip?.channels ?? [])
+                moving.add(channel.target);
+        }
         return moving.size;
     }
     render() {
         if (!this.draft)
             return html ``;
+        const nameless = this.partNames.length === 0;
         return html `
       <section>
         <h3>${i18next.t('figure.label.animation')}</h3>
@@ -275,18 +319,27 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
       </section>
 
       ${this.renderRecipes()}
-      ${this.clips.length === 0 ? nothing : this.renderClips()}
 
       <section>
-        <button @click=${() => this.addClip()} ?disabled=${this.partNames.length === 0}>
+        <h3>${i18next.t('figure.label.parameters')}</h3>
+        <p quiet>${i18next.t('figure.text.parameter-is-a-value-not-a-timeline')}</p>
+        ${this.parameters.map((parameter, at) => this.renderParameter(parameter, at))}
+        <button @click=${() => this.addParameter()} ?disabled=${nameless}>
+          <md-icon>add</md-icon>${i18next.t('figure.button.add-parameter')}
+        </button>
+      </section>
+
+      <section>
+        <h3>${i18next.t('figure.label.clips')}</h3>
+        <p quiet>${i18next.t('figure.text.clip-is-time-running')}</p>
+        ${this.clips.map((clip, at) => this.renderClip(clip, at))}
+        <button @click=${() => this.addClip()} ?disabled=${nameless}>
           <md-icon>add</md-icon>${i18next.t('figure.button.add-clip')}
         </button>
-        ${this.partNames.length === 0
-            ? html `<p quiet>${i18next.t('figure.text.animation-needs-a-named-part')}</p>`
-            : nothing}
+        ${nameless ? html `<p quiet>${i18next.t('figure.text.animation-needs-a-named-part')}</p>` : nothing}
       </section>
 
-      ${this.clips.length === 0 ? nothing : this.renderBudget()}
+      ${this.movingParts === 0 ? nothing : this.renderBudget()}
     `;
     }
     /**
@@ -316,21 +369,20 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
       </section>
     `;
     }
-    renderClips() {
-        return html `
-      <section>
-        ${this.clips.map((clip, at) => this.renderClip(clip, at))}
-      </section>
-    `;
+    /** 이름이 다른 것과 겹치나. 두 목록을 함께 본다 — 인스턴스는 이름 하나로 값을 준다. */
+    taken(kind, at, name) {
+        const mine = kind === 'clip' ? this.clips[at] : this.parameters[at];
+        return this.allNames.some(one => one !== mine && one.name === name);
     }
     renderClip(clip, at) {
-        const on = this.open === at;
-        const duplicate = this.clips.some((other, i) => i !== at && other.name === clip.name);
+        const key = `clip:${at}`;
+        const on = this.open === key;
+        const duplicate = this.taken('clip', at, clip.name);
         const nameless = !clip.name?.trim();
         return html `
       <div clip ?on=${on}>
         <div head>
-          <button plain @click=${() => (this.open = on ? -1 : at)} title=${i18next.t('figure.label.channels')}>
+          <button plain @click=${() => (this.open = on ? '' : key)} title=${i18next.t('figure.label.channels')}>
             <md-icon>${on ? 'expand_more' : 'chevron_right'}</md-icon>
           </button>
           <input
@@ -341,13 +393,6 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
             title=${duplicate ? i18next.t('figure.text.clip-name-taken') : i18next.t('figure.text.clip-name-is-how-it-is-driven')}
             @change=${(e) => this.renameClip(at, e.target.value)}
           />
-          <select
-            .value=${live(clip.drive ?? 'loop')}
-            title=${i18next.t('figure.text.drive-explained')}
-            @change=${(e) => this.setDrive(at, e.target.value)}
-          >
-            ${CLIP_DRIVES.map(drive => html `<option value=${drive}>${i18next.t('figure.label.drive-' + drive)}</option>`)}
-          </select>
           <button plain @click=${() => this.removeClip(at)} title=${i18next.t('figure.button.remove')}>
             <md-icon>close</md-icon>
           </button>
@@ -355,18 +400,100 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
 
         ${duplicate ? html `<p warn>${i18next.t('figure.text.clip-name-taken')}</p>` : nothing}
         ${nameless ? html `<p warn>${i18next.t('figure.text.clip-needs-a-name')}</p>` : nothing}
-        ${on ? this.renderChannels(clip, at) : nothing}
+        ${on ? this.renderChannels('clip', at) : nothing}
+      </div>
+    `;
+    }
+    /**
+     * 파라미터 하나 — **이름·범위·자세.**
+     *
+     * 범위가 화면에 있어야 하는 이유는 그것이 **인스턴스와 주고받는 말**이기 때문이다.
+     * 곡선은 0~1 이고 인스턴스는 mm 로 준다. 그 사이를 런타임이 맵하는데, 무엇부터 무엇
+     * 까지인지 저작자가 정하지 않으면 값을 줄 수가 없다.
+     */
+    renderParameter(parameter, at) {
+        const key = `parameter:${at}`;
+        const on = this.open === key;
+        const duplicate = this.taken('parameter', at, parameter.name);
+        const nameless = !parameter.name?.trim();
+        const range = parameter.range ?? NEW_RANGE;
+        const backwards = !(range.max > range.min);
+        return html `
+      <div clip ?on=${on}>
+        <div head>
+          <button plain @click=${() => (this.open = on ? '' : key)} title=${i18next.t('figure.label.channels')}>
+            <md-icon>${on ? 'expand_more' : 'chevron_right'}</md-icon>
+          </button>
+          <input
+            name
+            .value=${live(parameter.name ?? '')}
+            ?bad=${duplicate || nameless}
+            placeholder=${i18next.t('figure.label.parameter-name')}
+            title=${duplicate
+            ? i18next.t('figure.text.clip-name-taken')
+            : i18next.t('figure.text.parameter-name-is-how-a-value-arrives')}
+            @change=${(e) => this.renameParameter(at, e.target.value)}
+          />
+          <button plain @click=${() => this.removeParameter(at)} title=${i18next.t('figure.button.remove')}>
+            <md-icon>close</md-icon>
+          </button>
+        </div>
+
+        ${duplicate ? html `<p warn>${i18next.t('figure.text.clip-name-taken')}</p>` : nothing}
+        ${nameless ? html `<p warn>${i18next.t('figure.text.parameter-needs-a-name')}</p>` : nothing}
+
+        <div row>
+          <label>${i18next.t('figure.label.parameter-range')}</label>
+          <input
+            type="number"
+            step="1"
+            ?bad=${backwards}
+            .value=${live(String(range.min))}
+            aria-label="min"
+            @change=${(e) => this.setRange(at, { min: Number(e.target.value) || 0 })}
+          />
+          <input
+            type="number"
+            step="1"
+            ?bad=${backwards}
+            .value=${live(String(range.max))}
+            aria-label="max"
+            @change=${(e) => this.setRange(at, { max: Number(e.target.value) || 0 })}
+          />
+          <input
+            unit
+            .value=${live(range.unit ?? '')}
+            placeholder="mm"
+            aria-label="unit"
+            title=${i18next.t('figure.text.unit-is-a-word-not-a-rule')}
+            @change=${(e) => this.setRange(at, { unit: e.target.value.trim() })}
+          />
+        </div>
+        ${backwards ? html `<p warn>${i18next.t('figure.text.range-needs-room')}</p>` : nothing}
+
+        <div row>
+          <label>${i18next.t('figure.label.parameter-default')}</label>
+          <input
+            type="number"
+            step="1"
+            .value=${live(String(parameter.default ?? range.min))}
+            @change=${(e) => this.setDefault(at, Number(e.target.value) || 0)}
+          />
+        </div>
+
+        ${on ? this.renderChannels('parameter', at) : nothing}
       </div>
     `;
     }
-    renderChannels(clip, at) {
+    renderChannels(kind, at) {
+        const channels = this.channelsOf(kind, at);
         return html `
-      <p quiet>${i18next.t('figure.text.drive-' + (clip.drive ?? 'loop') + '-note')}</p>
+      <p quiet>${i18next.t(kind === 'clip' ? 'figure.text.clip-is-time-running' : 'figure.text.parameter-curve-is-the-value-axis')}</p>
 
-      ${clip.channels.length === 0 ? html `<p warn>${i18next.t('figure.text.clip-needs-a-channel')}</p>` : nothing}
-      ${clip.channels.map((channel, j) => this.renderChannel(channel, at, j))}
+      ${channels.length === 0 ? html `<p warn>${i18next.t('figure.text.clip-needs-a-channel')}</p>` : nothing}
+      ${channels.map((channel, j) => this.renderChannel(kind, channel, at, j))}
 
-      <button @click=${() => this.addChannel(at)}>
+      <button @click=${() => this.addChannel(kind, at)}>
         <md-icon>add</md-icon>${i18next.t('figure.button.add-channel')}
       </button>
     `;
@@ -377,7 +504,7 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
      * 없는 부품을 가리키는 채널은 붉게 낸다. 부품 이름을 바꾸면 그 순간 이렇게 되는데,
      * 검증은 저장할 때 말하고 여기서는 **그 자리에서** 보여 준다.
      */
-    renderChannel(channel, at, j) {
+    renderChannel(kind, channel, at, j) {
         const orphan = !this.partNames.includes(channel.target);
         const turning = channel.path === 'rotation';
         return html `
@@ -386,12 +513,12 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
           <label>${i18next.t('figure.label.channel-target')}</label>
           <select
             .value=${live(channel.target ?? '')}
-            @change=${(e) => this.setChannel(at, j, { target: e.target.value })}
+            @change=${(e) => this.setChannel(kind, at, j, { target: e.target.value })}
           >
             ${orphan ? html `<option value=${channel.target}>${channel.target}</option>` : nothing}
             ${this.partNames.map(name => html `<option value=${name}>${name}</option>`)}
           </select>
-          <button plain @click=${() => this.removeChannel(at, j)} title=${i18next.t('figure.button.remove')}>
+          <button plain @click=${() => this.removeChannel(kind, at, j)} title=${i18next.t('figure.button.remove')}>
             <md-icon>close</md-icon>
           </button>
         </div>
@@ -402,14 +529,14 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
           <label>${i18next.t('figure.label.channel-path')}</label>
           <select
             .value=${live(channel.path)}
-            @change=${(e) => this.setPath(at, j, e.target.value)}
+            @change=${(e) => this.setPath(kind, at, j, e.target.value)}
           >
             ${CHANNEL_PATHS.map(path => html `<option value=${path}>${i18next.t('figure.label.path-' + path)}</option>`)}
           </select>
           <select
             .value=${live(channel.interpolation ?? 'linear')}
             title=${i18next.t('figure.text.interpolation-explained')}
-            @change=${(e) => this.setChannel(at, j, { interpolation: e.target.value })}
+            @change=${(e) => this.setChannel(kind, at, j, { interpolation: e.target.value })}
           >
             ${INTERPOLATIONS.map(one => html `<option value=${one}>${i18next.t('figure.label.interpolation-' + one)}</option>`)}
           </select>
@@ -417,8 +544,8 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
 
         <p quiet>${i18next.t('figure.text.path-' + channel.path + '-unit')}</p>
 
-        ${turning ? this.renderPivot(channel, at, j) : nothing}
-        ${this.renderKeys(channel, at, j)}
+        ${turning ? this.renderPivot(kind, channel, at, j) : nothing}
+        ${this.renderKeys(kind, channel, at, j)}
       </div>
     `;
     }
@@ -428,14 +555,14 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
      * 그래서 경로가 rotation 일 때만 낸다. 언제나 내면 저작자가 옮김·배율에도 적고, 검증이
      * 저장할 때 「쓰이지 않는다」고 알린다. 안 보이면 적을 일이 없다.
      */
-    renderPivot(channel, at, j) {
+    renderPivot(kind, channel, at, j) {
         const pivot = channel.pivot;
         const on = pivot !== undefined;
         return html `
       <div row>
         <label>${i18next.t('figure.label.channel-pivot')}</label>
         <button
-          @click=${() => this.setChannel(at, j, { pivot: on ? undefined : { x: 0, y: 0, z: 0 } })}
+          @click=${() => this.setChannel(kind, at, j, { pivot: on ? undefined : { x: 0, y: 0, z: 0 } })}
           title=${i18next.t('figure.text.pivot-defaults-to-the-part-centre')}
         >
           ${i18next.t(on ? 'figure.button.pivot-clear' : 'figure.button.pivot-set')}
@@ -447,7 +574,7 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
                   step="1"
                   .value=${live(String(pivot[axis]))}
                   aria-label=${axis}
-                  @change=${(e) => this.setChannel(at, j, {
+                  @change=${(e) => this.setChannel(kind, at, j, {
                 pivot: { ...pivot, [axis]: Number(e.target.value) || 0 }
             })}
                 />
@@ -465,7 +592,7 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
      * 시각이 오름차순이어야 하는 것도 형식의 규칙이다. 여기서는 어긋난 줄을 붉게 내고 값을
      * 고치지는 않는다 — 저작자가 3 을 1 로 고치던 중일 수 있다.
      */
-    renderKeys(channel, at, j) {
+    renderKeys(kind, channel, at, j) {
         const keys = channel.keys ?? [];
         return html `
       <table keys>
@@ -486,7 +613,7 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
                   ?bad=${backwards || key.at < 0}
                   .value=${live(String(key.at))}
                   title=${backwards ? i18next.t('figure.text.keys-must-rise') : ''}
-                  @change=${(e) => this.setKey(at, j, k, { at: Math.max(0, Number(e.target.value) || 0) })}
+                  @change=${(e) => this.setKey(kind, at, j, k, { at: Math.max(0, Number(e.target.value) || 0) })}
                 />
               </td>
               ${AXES.map(axis => html `
@@ -496,7 +623,7 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
                       step=${channel.path === 'scale' ? '0.1' : '1'}
                       .value=${live(String(key.value[axis]))}
                       aria-label=${axis}
-                      @change=${(e) => this.setKey(at, j, k, {
+                      @change=${(e) => this.setKey(kind, at, j, k, {
                 value: { ...key.value, [axis]: Number(e.target.value) || 0 }
             })}
                     />
@@ -507,7 +634,7 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
                   plain
                   ?disabled=${keys.length <= 2}
                   title=${keys.length <= 2 ? i18next.t('figure.text.two-keys-at-least') : i18next.t('figure.button.remove')}
-                  @click=${() => this.removeKey(at, j, k)}
+                  @click=${() => this.removeKey(kind, at, j, k)}
                 >
                   <md-icon>close</md-icon>
                 </button>
@@ -521,7 +648,7 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
             ? html `<p warn>${i18next.t('figure.text.keys-must-rise')}</p>`
             : nothing}
 
-      <button @click=${() => this.addKey(at, j)}>
+      <button @click=${() => this.addKey(kind, at, j)}>
         <md-icon>add</md-icon>${i18next.t('figure.button.add-key')}
       </button>
     `;
@@ -555,38 +682,65 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
      * `animations` 는 도형 전체의 것이므로 부품 편집(`update-part`)이 아니라 `update-draft` 로
      * 간다. 빈 배열은 칸을 지운다 — clip 을 다 지운 도형은 `animations: []` 가 아니라 없는 것이다.
      */
-    tell(animations) {
+    tell(over) {
         if (!this.draft)
             return;
-        const draft = { ...this.draft };
-        if (animations.length === 0)
+        const draft = { ...this.draft, ...over };
+        if (!draft.animations?.length)
             delete draft.animations;
-        else
-            draft.animations = animations;
+        if (!draft.parameters?.length)
+            delete draft.parameters;
         this.dispatchEvent(new CustomEvent('update-draft', { detail: { draft }, bubbles: true, composed: true }));
     }
     patchClip(at, patch) {
-        this.tell(this.clips.map((clip, i) => (i === at ? { ...clip, ...patch } : clip)));
+        this.tell({ animations: this.clips.map((clip, i) => (i === at ? { ...clip, ...patch } : clip)) });
     }
-    patchChannel(at, j, next) {
-        const clip = this.clips[at];
-        if (!clip)
-            return;
-        this.patchClip(at, { channels: clip.channels.map((channel, i) => (i === j ? next : channel)) });
+    patchParameter(at, patch) {
+        this.tell({ parameters: this.parameters.map((one, i) => (i === at ? { ...one, ...patch } : one)) });
+    }
+    /** 채널 묶음을 통째로 얹는다. **어느 목록이든 같은 자리에 닿는다.** */
+    setChannels(kind, at, channels) {
+        if (kind === 'clip')
+            this.patchClip(at, { channels });
+        else {
+            const parameter = this.parameters[at];
+            if (!parameter)
+                return;
+            this.patchParameter(at, { clip: { ...parameter.clip, channels } });
+        }
+    }
+    patchChannel(kind, at, j, next) {
+        this.setChannels(kind, at, this.channelsOf(kind, at).map((channel, i) => (i === j ? next : channel)));
     }
     addClip() {
         const target = this.partNames[0];
         if (!target)
             return;
         const clip = {
-            name: freeName(this.clips),
-            drive: 'loop',
+            name: freeName(this.allNames, 'clip-1'),
             channels: [{ target, path: 'translation', keys: keysFor('translation') }]
         };
-        this.open = this.clips.length;
-        this.tell([...this.clips, clip]);
+        this.open = `clip:${this.clips.length}`;
+        this.tell({ animations: [...this.clips, clip] });
+    }
+    addParameter() {
+        const target = this.partNames[0];
+        if (!target)
+            return;
+        const parameter = {
+            name: freeName(this.allNames, 'parameter-1'),
+            range: { ...NEW_RANGE },
+            clip: { channels: [{ target, path: 'translation', keys: keysFor('translation') }] }
+        };
+        this.open = `parameter:${this.parameters.length}`;
+        this.tell({ parameters: [...this.parameters, parameter] });
     }
-    /** Recipe creates a valid, editable two-pose clip; it never saves or publishes the Figure. */
+    /**
+     * Recipe creates a valid, editable two-pose motion; it never saves or publishes the Figure.
+     *
+     * 어느 목록으로 가는지는 레시피가 안다 — 도는 롤러는 애니메이션이고 열리는 문은
+     * 파라미터다. 저작자에게 그 갈래를 먼저 고르게 하지 않는 이유가 이것이다.
+     */
     addRecipe(recipe) {
         const target = this.recipeTarget || this.partNames[0];
         if (!target)
@@ -598,38 +752,58 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
         };
         if (recipe.pivot)
             channel.pivot = { ...recipe.pivot };
-        this.open = this.clips.length;
-        this.tell([...this.clips, { name: freeRecipeName(this.clips, recipe.name), drive: recipe.drive, channels: [channel] }]);
+        const name = freeName(this.allNames, recipe.name);
+        if (recipe.kind === 'clip') {
+            this.open = `clip:${this.clips.length}`;
+            this.tell({ animations: [...this.clips, { name, channels: [channel] }] });
+            return;
+        }
+        this.open = `parameter:${this.parameters.length}`;
+        this.tell({
+            parameters: [...this.parameters, { name, range: { ...(recipe.range ?? NEW_RANGE) }, clip: { channels: [channel] } }]
+        });
     }
     renameClip(at, name) {
         this.patchClip(at, { name: name.trim() });
     }
-    setDrive(at, drive) {
-        this.patchClip(at, { drive });
+    renameParameter(at, name) {
+        this.patchParameter(at, { name: name.trim() });
+    }
+    setRange(at, patch) {
+        const parameter = this.parameters[at];
+        if (!parameter)
+            return;
+        this.patchParameter(at, { range: { ...(parameter.range ?? NEW_RANGE), ...patch } });
+    }
+    setDefault(at, value) {
+        this.patchParameter(at, { default: value });
     }
     removeClip(at) {
-        if (this.open >= at)
-            this.open = Math.max(0, this.open - 1);
-        this.tell(this.clips.filter((_, i) => i !== at));
+        this.open = '';
+        this.tell({ animations: this.clips.filter((_, i) => i !== at) });
     }
-    addChannel(at) {
-        const clip = this.clips[at];
+    removeParameter(at) {
+        this.open = '';
+        this.tell({ parameters: this.parameters.filter((_, i) => i !== at) });
+    }
+    addChannel(kind, at) {
         const target = this.partNames[0];
-        if (!clip || !target)
+        if (!target)
             return;
-        this.patchClip(at, {
-            channels: [...clip.channels, { target, path: 'translation', keys: keysFor('translation') }]
-        });
+        this.setChannels(kind, at, [
+            ...this.channelsOf(kind, at),
+            { target, path: 'translation', keys: keysFor('translation') }
+        ]);
     }
-    setChannel(at, j, patch) {
-        const channel = this.clips[at]?.channels[j];
+    setChannel(kind, at, j, patch) {
+        const channel = this.channelsOf(kind, at)[j];
         if (!channel)
             return;
         const next = { ...channel, ...patch };
         /* `undefined` 를 얹는 것은 지우는 뜻이다. 남겨 두면 저장 형식에 빈 칸이 실린다. */
         if ('pivot' in patch && patch.pivot === undefined)
             delete next.pivot;
-        this.patchChannel(at, j, next);
+        this.patchChannel(kind, at, j, next);
     }
     /**
      * 경로를 바꾼다 — **값까지 함께 옮긴다.**
@@ -638,8 +812,8 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
      * 두면 저작자는 부품이 사라진 것을 보고 도구가 고장 난 줄 안다. 그래서 옮김·회전 ↔ 배율을
      * 건널 때 시작값을 그 경로의 제자리로 되돌린다. 시각은 지킨다 — 저작자가 짠 박자다.
      */
-    setPath(at, j, path) {
-        const channel = this.clips[at]?.channels[j];
+    setPath(kind, at, j, path) {
+        const channel = this.channelsOf(kind, at)[j];
         if (!channel)
             return;
         const crossing = (channel.path === 'scale') !== (path === 'scale');
@@ -651,38 +825,35 @@ let FigureAnimations = class FigureAnimations extends localize(i18next)(LitEleme
         /* 회전이 아니면 회전 중심은 쓰이지 않는다. 남겨 두면 검증이 「쓰이지 않는다」고 알린다. */
         if (path !== 'rotation')
             delete next.pivot;
-        this.patchChannel(at, j, next);
+        this.patchChannel(kind, at, j, next);
     }
-    removeChannel(at, j) {
-        const clip = this.clips[at];
-        if (!clip)
-            return;
-        this.patchClip(at, { channels: clip.channels.filter((_, i) => i !== j) });
+    removeChannel(kind, at, j) {
+        this.setChannels(kind, at, this.channelsOf(kind, at).filter((_, i) => i !== j));
     }
     /** 마지막 키에서 1 초 뒤. 값은 그 키를 그대로 받는다 — 붙여 놓고 고치는 것이 짜기 쉽다. */
-    addKey(at, j) {
-        const channel = this.clips[at]?.channels[j];
+    addKey(kind, at, j) {
+        const channel = this.channelsOf(kind, at)[j];
         if (!channel)
             return;
         const last = channel.keys[channel.keys.length - 1];
         const key = { at: (last?.at ?? 0) + 1, value: { ...(last?.value ?? startValue(channel.path)) } };
-        this.patchChannel(at, j, { ...channel, keys: [...channel.keys, key] });
+        this.patchChannel(kind, at, j, { ...channel, keys: [...channel.keys, key] });
     }
-    setKey(at, j, k, patch) {
-        const channel = this.clips[at]?.channels[j];
+    setKey(kind, at, j, k, patch) {
+        const channel = this.channelsOf(kind, at)[j];
         if (!channel)
             return;
-        this.patchChannel(at, j, {
+        this.patchChannel(kind, at, j, {
             ...channel,
             keys: channel.keys.map((key, i) => (i === k ? { ...key, ...patch } : key))
         });
     }
     /** 둘 미만으로 내려가지 않는다 — 단추가 이미 죽어 있지만 밖에서 불릴 수 있다. */
-    removeKey(at, j, k) {
-        const channel = this.clips[at]?.channels[j];
+    removeKey(kind, at, j, k) {
+        const channel = this.channelsOf(kind, at)[j];
         if (!channel || channel.keys.length <= 2)
             return;
-        this.patchChannel(at, j, { ...channel, keys: channel.keys.filter((_, i) => i !== k) });
+        this.patchChannel(kind, at, j, { ...channel, keys: channel.keys.filter((_, i) => i !== k) });
     }
 };
 __decorate([