@things-factory/figure-library 10.1.223 → 10.1.224

package/dist-client/legend-looks/legend-looks-editor.js

@@ -0,0 +1,145 @@
+import { __decorate, __metadata } from "tslib";
+import '@material/web/icon/icon.js';
+import './ox-legend-looks.js';
+import { css, html, LitElement } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { OxGristEditor } from '@operato/data-grist';
+import { i18next } from '@operato/i18n';
+import { closePopup, openPopup } from '@operato/popup';
+import { CommonHeaderStyles, ScrollbarStyles } from '@operato/styles';
+import { legendLooksOf, legendOf } from './legend-looks.js';
+/**
+ * A legend theme's value, edited look by look (ADR-0166 11): the board's 「테마」 list opens this for its legend kinds --
+ * a code map (`color-map`, `animation-map`) or a range map (`color-ranges`) -- when this module is loaded. Each code's
+ * colour, effect, values for named state inputs, and a motion group's clip, speed and pause; what else an entry holds
+ * is kept. A look that is a colour alone is written as the colour, as a colour map keeps it.
+ */
+let LegendLooksEditor = class LegendLooksEditor extends OxGristEditor {
+    get editorTemplate() {
+        return html `<div tabindex="0">${i18next.t('figure.label.legend-count', { count: Object.keys(legendLooksOf(this.value)).length })}</div>`;
+    }
+    _onclick(e) {
+        e.stopPropagation();
+        this.openLooks();
+    }
+    _onkeydown(e) {
+        if (e.key == 'Enter') {
+            e.stopPropagation();
+            this.openLooks();
+        }
+    }
+    /** The value written back as it came -- an object, or text for a store that keeps text. */
+    openLooks() {
+        delete this.popup;
+        const asText = typeof this.value === 'string';
+        /* The popup is drawn again from its first binding when the layout redraws: the looks being edited live in `draft`. */
+        const draft = { looks: legendLooksOf(this.value) };
+        const confirmCallback = (looks) => {
+            const after = legendOf(looks);
+            this.dispatchEvent(new CustomEvent('field-change', {
+                bubbles: true,
+                composed: true,
+                detail: { before: this.value, after: asText ? JSON.stringify(after) : after, record: this.record, column: this.column, row: this.row }
+            }));
+        };
+        this.popup = openPopup(html `<legend-looks-popup .draft=${draft} .confirmCallback=${confirmCallback}></legend-looks-popup>`, {
+            backdrop: true,
+            size: 'large',
+            title: `${i18next.t('figure.label.legend-edit')} : ${this.record?.name ?? ''}`
+        });
+    }
+};
+LegendLooksEditor = __decorate([
+    customElement('legend-looks-editor')
+], LegendLooksEditor);
+export { LegendLooksEditor };
+let LegendLooksPopup = class LegendLooksPopup extends LitElement {
+    constructor() {
+        super(...arguments);
+        /** Inputs offered for a value, with name, unit and range (fmsim: those its carrier figures' tables set). */
+        this.addable = [];
+        /**
+         * Colour only: no effect, no values, no motion -- fmsim's carrier legend, whose figures take the thickness from their own
+         * fixed table (ADR-0167 12). What an entry already holds is kept.
+         */
+        this.colourOnly = false;
+    }
+    static { this.styles = [
+        CommonHeaderStyles,
+        ScrollbarStyles,
+        css `
+      :host {
+        display: flex;
+        flex-direction: column;
+        background-color: var(--md-sys-color-surface);
+        width: var(--overlay-center-normal-width, 50%);
+        height: var(--overlay-center-normal-height, 50%);
+      }
+
+      ox-legend-looks {
+        flex: 1;
+        overflow-y: auto;
+        padding: var(--spacing-medium, 8px);
+        align-content: start;
+      }
+    `
+    ]; }
+    render() {
+        return html `
+      <ox-legend-looks
+        .looks=${this.draft.looks}
+        .addable=${this.addable}
+        default-color=${this.defaultColor ?? ''}
+        show-given
+        ?name-inputs=${!this.addable.length}
+        ?no-values=${this.colourOnly}
+        ?effects=${!this.colourOnly}
+        ?motion=${!this.colourOnly}
+        ?color-optional=${!this.colourOnly}
+        @looks-change=${(e) => {
+            e.stopPropagation();
+            this.draft.looks = e.detail.looks;
+        }}
+      ></ox-legend-looks>
+
+      <div class="footer">
+        <div filler></div>
+        <button @click=${() => closePopup(this)} danger><md-icon>cancel</md-icon>${i18next.t('button.cancel')}</button>
+        <button
+          @click=${() => {
+            this.confirmCallback?.(this.draft.looks);
+            closePopup(this);
+        }}
+          done
+        >
+          <md-icon>done</md-icon>${i18next.t('button.confirm')}
+        </button>
+      </div>
+    `;
+    }
+};
+__decorate([
+    property({ type: Object }),
+    __metadata("design:type", Object)
+], LegendLooksPopup.prototype, "draft", void 0);
+__decorate([
+    property({ type: Object }),
+    __metadata("design:type", Function)
+], LegendLooksPopup.prototype, "confirmCallback", void 0);
+__decorate([
+    property({ type: Array }),
+    __metadata("design:type", Array)
+], LegendLooksPopup.prototype, "addable", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'colour-only' }),
+    __metadata("design:type", Object)
+], LegendLooksPopup.prototype, "colourOnly", void 0);
+__decorate([
+    property({ type: String, attribute: 'default-color' }),
+    __metadata("design:type", String)
+], LegendLooksPopup.prototype, "defaultColor", void 0);
+LegendLooksPopup = __decorate([
+    customElement('legend-looks-popup')
+], LegendLooksPopup);
+export { LegendLooksPopup };
+//# sourceMappingURL=legend-looks-editor.js.map

package/dist-client/legend-looks/legend-looks-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend-looks-editor.js","sourceRoot":"","sources":["../../client/legend-looks/legend-looks-editor.ts"],"names":[],"mappings":"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","sourcesContent":["import '@material/web/icon/icon.js'\nimport './ox-legend-looks.js'\n\nimport { css, html, LitElement } from 'lit'\nimport { customElement, property } from 'lit/decorators.js'\n\nimport { OxGristEditor } from '@operato/data-grist'\nimport { i18next } from '@operato/i18n'\nimport { closePopup, openPopup, type PopupHandle } from '@operato/popup'\nimport { CommonHeaderStyles, ScrollbarStyles } from '@operato/styles'\n\nimport { legendLooksOf, legendOf, type LegendLooks, type LookInput } from './legend-looks.js'\n\n/**\n * A legend theme's value, edited look by look (ADR-0166 11): the board's 「테마」 list opens this for its legend kinds --\n * a code map (`color-map`, `animation-map`) or a range map (`color-ranges`) -- when this module is loaded. Each code's\n * colour, effect, values for named state inputs, and a motion group's clip, speed and pause; what else an entry holds\n * is kept. A look that is a colour alone is written as the colour, as a colour map keeps it.\n */\n@customElement('legend-looks-editor')\nexport class LegendLooksEditor extends OxGristEditor {\n  private popup?: PopupHandle\n\n  get editorTemplate() {\n    return html`<div tabindex=\"0\">${i18next.t('figure.label.legend-count', { count: Object.keys(legendLooksOf(this.value)).length })}</div>`\n  }\n\n  _onclick(e: Event): void {\n    e.stopPropagation()\n    this.openLooks()\n  }\n\n  _onkeydown(e: KeyboardEvent): void {\n    if (e.key == 'Enter') {\n      e.stopPropagation()\n      this.openLooks()\n    }\n  }\n\n  /** The value written back as it came -- an object, or text for a store that keeps text. */\n  openLooks() {\n    delete this.popup\n    const asText = typeof this.value === 'string'\n    /* The popup is drawn again from its first binding when the layout redraws: the looks being edited live in `draft`. */\n    const draft = { looks: legendLooksOf(this.value) }\n    const confirmCallback = (looks: LegendLooks) => {\n      const after = legendOf(looks)\n      this.dispatchEvent(\n        new CustomEvent('field-change', {\n          bubbles: true,\n          composed: true,\n          detail: { before: this.value, after: asText ? JSON.stringify(after) : after, record: this.record, column: this.column, row: this.row }\n        })\n      )\n    }\n    this.popup = openPopup(html`<legend-looks-popup .draft=${draft} .confirmCallback=${confirmCallback}></legend-looks-popup>`, {\n      backdrop: true,\n      size: 'large',\n      title: `${i18next.t('figure.label.legend-edit')} : ${this.record?.name ?? ''}`\n    })\n  }\n}\n\n@customElement('legend-looks-popup')\nexport class LegendLooksPopup extends LitElement {\n  static styles = [\n    CommonHeaderStyles,\n    ScrollbarStyles,\n    css`\n      :host {\n        display: flex;\n        flex-direction: column;\n        background-color: var(--md-sys-color-surface);\n        width: var(--overlay-center-normal-width, 50%);\n        height: var(--overlay-center-normal-height, 50%);\n      }\n\n      ox-legend-looks {\n        flex: 1;\n        overflow-y: auto;\n        padding: var(--spacing-medium, 8px);\n        align-content: start;\n      }\n    `\n  ]\n\n  @property({ type: Object }) draft!: { looks: LegendLooks }\n  @property({ type: Object }) confirmCallback!: (looks: LegendLooks) => void\n  /** Inputs offered for a value, with name, unit and range (fmsim: those its carrier figures' tables set). */\n  @property({ type: Array }) addable: LookInput[] = []\n  /**\n   * Colour only: no effect, no values, no motion -- fmsim's carrier legend, whose figures take the thickness from their own\n   * fixed table (ADR-0167 12). What an entry already holds is kept.\n   */\n  @property({ type: Boolean, attribute: 'colour-only' }) colourOnly = false\n  /** The colour a new code starts with: a colour map's entries have one. */\n  @property({ type: String, attribute: 'default-color' }) defaultColor?: string\n\n  render() {\n    return html`\n      <ox-legend-looks\n        .looks=${this.draft.looks}\n        .addable=${this.addable}\n        default-color=${this.defaultColor ?? ''}\n        show-given\n        ?name-inputs=${!this.addable.length}\n        ?no-values=${this.colourOnly}\n        ?effects=${!this.colourOnly}\n        ?motion=${!this.colourOnly}\n        ?color-optional=${!this.colourOnly}\n        @looks-change=${(e: CustomEvent<{ looks: LegendLooks }>) => {\n          e.stopPropagation()\n          this.draft.looks = e.detail.looks\n        }}\n      ></ox-legend-looks>\n\n      <div class=\"footer\">\n        <div filler></div>\n        <button @click=${() => closePopup(this)} danger><md-icon>cancel</md-icon>${i18next.t('button.cancel')}</button>\n        <button\n          @click=${() => {\n            this.confirmCallback?.(this.draft.looks)\n            closePopup(this)\n          }}\n          done\n        >\n          <md-icon>done</md-icon>${i18next.t('button.confirm')}\n        </button>\n      </div>\n    `\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'legend-looks-editor': LegendLooksEditor\n    'legend-looks-popup': LegendLooksPopup\n  }\n}\n"]}

package/dist-client/legend-looks/legend-looks.d.ts

@@ -0,0 +1,55 @@
+import type { FigureAsset, FigureDataTableBinding } from '@hatiolab/figure-model';
+export interface LegendLookEffect {
+    kind: 'blink' | 'glow';
+    hz?: number;
+}
+/** One code's look. Any part may be missing; a value is in its input's own unit. Other fields of an entry ride along. */
+export interface LegendLook {
+    color?: string;
+    effect?: LegendLookEffect | null;
+    values?: Record<string, number>;
+    clip?: string;
+    speed?: number;
+    paused?: boolean;
+    [other: string]: unknown;
+}
+/** A legend's looks: code → look, `default` for a code it does not name. */
+export type LegendLooks = Record<string, LegendLook>;
+/** A state input a legend may give a value to: the input, its name, unit and range, and the figures' tables that take it. */
+export interface LookInput {
+    input: string;
+    label: string;
+    unit?: string;
+    min?: number;
+    max?: number;
+    /** What gives it, as the choice says it: the figures and the tables. */
+    givenBy?: string;
+}
+/** A legend's value as looks: an entry that is a colour is that colour; one that is a record is itself; anything else reads as none. */
+export declare function legendLooksOf(value: unknown): LegendLooks;
+/** Looks as a legend keeps them: a look that is a colour alone is the colour, as a colour map has it; the rest whole. */
+export declare function legendOf(looks: LegendLooks): Record<string, unknown>;
+/**
+ * One code's look with some parts changed: a part given as undefined is taken away, so the legend no longer gives it.
+ * A look left with nothing stays, as a code the legend names.
+ */
+export declare function withLook(looks: LegendLooks, code: string, patch: Partial<LegendLook>): LegendLooks;
+/** One value of one code's look: a number sets it, undefined takes it away. Other inputs' values stay as they were. */
+export declare function withLookValue(looks: LegendLooks, code: string, input: string, value: number | undefined): LegendLooks;
+export declare function withCode(looks: LegendLooks, code: string): LegendLooks;
+export declare function withoutCode(looks: LegendLooks, code: string): LegendLooks;
+/** The inputs some look gives a value to, in the order first met. */
+export declare function inputsGivenIn(looks: LegendLooks): string[];
+/** The tables of a figure a legend may take the place of: those naming a legend role, each with its role. */
+export declare const legendTablesOf: (asset: FigureAsset) => FigureDataTableBinding[];
+/**
+ * The state inputs a legend of a role may give values to on this figure: each input a table of that role sets, with its
+ * name, unit and range. `role` left out: every table that names a role.
+ */
+export declare function legendInputsOf(asset: FigureAsset, role?: string): LookInput[];
+/**
+ * Which kind of legend fits a table (ADR-0166 7): a code table takes a code map (`color-map`, `animation-map`), a range
+ * table a range map (`color-ranges`). A legend whose kind the scene does not say is told by its keys: every key but
+ * `default` an interval `from~to` is a range map.
+ */
+export declare function legendFits(lookup: 'code' | 'ranges', legend: unknown): boolean;

package/dist-client/legend-looks/legend-looks.js

@@ -0,0 +1,110 @@
+const isRecord = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+const isColour = (v) => typeof v === 'string' && /^#[0-9a-f]{6}$/i.test(v);
+/** A legend's value as looks: an entry that is a colour is that colour; one that is a record is itself; anything else reads as none. */
+export function legendLooksOf(value) {
+    let v = value;
+    if (typeof v === 'string') {
+        try {
+            v = JSON.parse(v);
+        }
+        catch {
+            return {};
+        }
+    }
+    if (!isRecord(v))
+        return {};
+    const out = {};
+    for (const [code, entry] of Object.entries(v)) {
+        if (isColour(entry))
+            out[code] = { color: entry };
+        else if (isRecord(entry))
+            out[code] = { ...entry };
+    }
+    return out;
+}
+/** Looks as a legend keeps them: a look that is a colour alone is the colour, as a colour map has it; the rest whole. */
+export function legendOf(looks) {
+    return Object.fromEntries(Object.entries(looks).map(([code, look]) => [code, Object.keys(look).length === 1 && isColour(look.color) ? look.color : look]));
+}
+/**
+ * One code's look with some parts changed: a part given as undefined is taken away, so the legend no longer gives it.
+ * A look left with nothing stays, as a code the legend names.
+ */
+export function withLook(looks, code, patch) {
+    const look = { ...(looks[code] ?? {}) };
+    for (const [part, value] of Object.entries(patch)) {
+        if (value === undefined)
+            delete look[part];
+        else
+            look[part] = value;
+    }
+    return { ...looks, [code]: look };
+}
+/** One value of one code's look: a number sets it, undefined takes it away. Other inputs' values stay as they were. */
+export function withLookValue(looks, code, input, value) {
+    const held = looks[code]?.values;
+    const values = isRecord(held) ? { ...held } : {};
+    if (value === undefined)
+        delete values[input];
+    else
+        values[input] = value;
+    return withLook(looks, code, { values: Object.keys(values).length ? values : undefined });
+}
+export function withCode(looks, code) {
+    return code in looks ? looks : { ...looks, [code]: {} };
+}
+export function withoutCode(looks, code) {
+    const { [code]: _gone, ...rest } = looks;
+    return rest;
+}
+/** The inputs some look gives a value to, in the order first met. */
+export function inputsGivenIn(looks) {
+    const seen = new Set();
+    for (const look of Object.values(looks))
+        if (isRecord(look.values))
+            for (const input of Object.keys(look.values))
+                seen.add(input);
+    return [...seen];
+}
+/** The tables of a figure a legend may take the place of: those naming a legend role, each with its role. */
+export const legendTablesOf = (asset) => (asset.dataInterface?.bindings ?? []).filter((b) => b.rule === 'table' && !!b.legend);
+/**
+ * The state inputs a legend of a role may give values to on this figure: each input a table of that role sets, with its
+ * name, unit and range. `role` left out: every table that names a role.
+ */
+export function legendInputsOf(asset, role) {
+    const declared = new Map(asset.document.model.inputs.map(i => [i.id, i]));
+    const out = [];
+    for (const b of legendTablesOf(asset)) {
+        if (role !== undefined && b.legend.role !== role)
+            continue;
+        for (const input of b.targets.inputs ?? []) {
+            if (out.some(o => o.input === input))
+                continue;
+            const d = declared.get(input);
+            out.push({
+                input,
+                label: asset.stateInputs?.[input]?.label ?? input,
+                ...(d?.unit !== undefined ? { unit: d.unit } : {}),
+                ...(d?.min !== undefined ? { min: d.min } : {}),
+                ...(d?.max !== undefined ? { max: d.max } : {}),
+                givenBy: b.label ?? b.accessor
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Which kind of legend fits a table (ADR-0166 7): a code table takes a code map (`color-map`, `animation-map`), a range
+ * table a range map (`color-ranges`). A legend whose kind the scene does not say is told by its keys: every key but
+ * `default` an interval `from~to` is a range map.
+ */
+export function legendFits(lookup, legend) {
+    const looks = legendLooksOf(legend);
+    const keys = Object.keys(looks).filter(k => k !== 'default');
+    if (!Object.keys(looks).length)
+        return false;
+    const ranged = keys.length > 0 && keys.every(k => /^-?[\d.]*~-?[\d.]*$/.test(k));
+    return lookup === 'ranges' ? ranged || keys.length === 0 : !ranged;
+}
+//# sourceMappingURL=legend-looks.js.map

package/dist-client/legend-looks/legend-looks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend-looks.js","sourceRoot":"","sources":["../../client/legend-looks/legend-looks.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * A legend as a person reads and writes it (ADR-0166 7, 11): a board-service theme record -- code (or interval) → look --\n * that a consumer may give a figure's table of the same role in its place. A look holds the columns of a table's\n * entries: a colour, an effect, a value per state input, a clip, a speed, a pause. A colour map keeps a look that is a\n * colour alone as the colour itself, so a 2D reader of the map reads it as before; what else an entry holds (fmsim's 2D\n * animation) is kept as it is.\n *\n * Nothing here decides how a look is taken: things-scene looks a code up (`resolveLegend`, `resolveLegendEntries`) and\n * says what it did not take on the figure's inputs. Kept apart from the elements so it is tested without a board.\n */\nimport type { FigureAsset, FigureDataTableBinding } from '@hatiolab/figure-model'\n\nexport interface LegendLookEffect {\n  kind: 'blink' | 'glow'\n  hz?: number\n}\n\n/** One code's look. Any part may be missing; a value is in its input's own unit. Other fields of an entry ride along. */\nexport interface LegendLook {\n  color?: string\n  effect?: LegendLookEffect | null\n  values?: Record<string, number>\n  clip?: string\n  speed?: number\n  paused?: boolean\n  [other: string]: unknown\n}\n\n/** A legend's looks: code → look, `default` for a code it does not name. */\nexport type LegendLooks = Record<string, LegendLook>\n\n/** A state input a legend may give a value to: the input, its name, unit and range, and the figures' tables that take it. */\nexport interface LookInput {\n  input: string\n  label: string\n  unit?: string\n  min?: number\n  max?: number\n  /** What gives it, as the choice says it: the figures and the tables. */\n  givenBy?: string\n}\n\nconst isRecord = (v: unknown): v is Record<string, unknown> => !!v && typeof v === 'object' && !Array.isArray(v)\nconst isColour = (v: unknown): v is string => typeof v === 'string' && /^#[0-9a-f]{6}$/i.test(v)\n\n/** A legend's value as looks: an entry that is a colour is that colour; one that is a record is itself; anything else reads as none. */\nexport function legendLooksOf(value: unknown): LegendLooks {\n  let v = value\n  if (typeof v === 'string') {\n    try {\n      v = JSON.parse(v)\n    } catch {\n      return {}\n    }\n  }\n  if (!isRecord(v)) return {}\n  const out: LegendLooks = {}\n  for (const [code, entry] of Object.entries(v)) {\n    if (isColour(entry)) out[code] = { color: entry }\n    else if (isRecord(entry)) out[code] = { ...entry }\n  }\n  return out\n}\n\n/** Looks as a legend keeps them: a look that is a colour alone is the colour, as a colour map has it; the rest whole. */\nexport function legendOf(looks: LegendLooks): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(looks).map(([code, look]) => [code, Object.keys(look).length === 1 && isColour(look.color) ? look.color : look]))\n}\n\n/**\n * One code's look with some parts changed: a part given as undefined is taken away, so the legend no longer gives it.\n * A look left with nothing stays, as a code the legend names.\n */\nexport function withLook(looks: LegendLooks, code: string, patch: Partial<LegendLook>): LegendLooks {\n  const look: LegendLook = { ...(looks[code] ?? {}) }\n  for (const [part, value] of Object.entries(patch)) {\n    if (value === undefined) delete look[part]\n    else look[part] = value\n  }\n  return { ...looks, [code]: look }\n}\n\n/** One value of one code's look: a number sets it, undefined takes it away. Other inputs' values stay as they were. */\nexport function withLookValue(looks: LegendLooks, code: string, input: string, value: number | undefined): LegendLooks {\n  const held = looks[code]?.values\n  const values: Record<string, unknown> = isRecord(held) ? { ...held } : {}\n  if (value === undefined) delete values[input]\n  else values[input] = value\n  return withLook(looks, code, { values: Object.keys(values).length ? (values as Record<string, number>) : undefined })\n}\n\nexport function withCode(looks: LegendLooks, code: string): LegendLooks {\n  return code in looks ? looks : { ...looks, [code]: {} }\n}\n\nexport function withoutCode(looks: LegendLooks, code: string): LegendLooks {\n  const { [code]: _gone, ...rest } = looks\n  return rest\n}\n\n/** The inputs some look gives a value to, in the order first met. */\nexport function inputsGivenIn(looks: LegendLooks): string[] {\n  const seen = new Set<string>()\n  for (const look of Object.values(looks)) if (isRecord(look.values)) for (const input of Object.keys(look.values)) seen.add(input)\n  return [...seen]\n}\n\n/** The tables of a figure a legend may take the place of: those naming a legend role, each with its role. */\nexport const legendTablesOf = (asset: FigureAsset): FigureDataTableBinding[] =>\n  (asset.dataInterface?.bindings ?? []).filter((b): b is FigureDataTableBinding => b.rule === 'table' && !!b.legend)\n\n/**\n * The state inputs a legend of a role may give values to on this figure: each input a table of that role sets, with its\n * name, unit and range. `role` left out: every table that names a role.\n */\nexport function legendInputsOf(asset: FigureAsset, role?: string): LookInput[] {\n  const declared = new Map(asset.document.model.inputs.map(i => [i.id, i] as const))\n  const out: LookInput[] = []\n  for (const b of legendTablesOf(asset)) {\n    if (role !== undefined && b.legend!.role !== role) continue\n    for (const input of b.targets.inputs ?? []) {\n      if (out.some(o => o.input === input)) continue\n      const d = declared.get(input)\n      out.push({\n        input,\n        label: asset.stateInputs?.[input]?.label ?? input,\n        ...(d?.unit !== undefined ? { unit: d.unit } : {}),\n        ...(d?.min !== undefined ? { min: d.min } : {}),\n        ...(d?.max !== undefined ? { max: d.max } : {}),\n        givenBy: b.label ?? b.accessor\n      })\n    }\n  }\n  return out\n}\n\n/**\n * Which kind of legend fits a table (ADR-0166 7): a code table takes a code map (`color-map`, `animation-map`), a range\n * table a range map (`color-ranges`). A legend whose kind the scene does not say is told by its keys: every key but\n * `default` an interval `from~to` is a range map.\n */\nexport function legendFits(lookup: 'code' | 'ranges', legend: unknown): boolean {\n  const looks = legendLooksOf(legend)\n  const keys = Object.keys(looks).filter(k => k !== 'default')\n  if (!Object.keys(looks).length) return false\n  const ranged = keys.length > 0 && keys.every(k => /^-?[\\d.]*~-?[\\d.]*$/.test(k))\n  return lookup === 'ranges' ? ranged || keys.length === 0 : !ranged\n}\n"]}

package/dist-client/legend-looks/ox-legend-looks.d.ts

@@ -0,0 +1,57 @@
+import { LitElement } from 'lit';
+import { type LegendLooks, type LookInput } from './legend-looks.js';
+/**
+ * A legend's looks, one card per code (ADR-0166 7, 11): its colour, its effect, a value for each state input the
+ * figures' tables of its role set -- with the input's name, unit and range -- and a clip, speed and pause for a motion
+ * group. Every change sends `looks-change` with the whole looks; the host writes them where the legend lives.
+ *
+ * A value outside its input's range is not taken from the field (as the property panel's number maps). Values for
+ * inputs not shown -- another figure's, in a legend shared by many -- are kept as they are, and so is whatever else an
+ * entry holds (fmsim's 2D animation).
+ *
+ * The one legend editor: the board's legend themes (「테마」) and fmsim's legend editor both write looks through it.
+ */
+export declare class OxLegendLooks extends LitElement {
+    static styles: import("lit").CSSResult;
+    looks: LegendLooks;
+    /** The state inputs shown, one field each. */
+    inputs: LookInput[];
+    /** Inputs that can be added as a field: those the figures' tables of the legend's role set. */
+    addable: LookInput[];
+    /** Whether every input a look gives a value to has a field, offered or not: a legend, which no one figure reads. */
+    showGiven: boolean;
+    /** Whether an input can be added by its name typed, when no figure says which there are. */
+    nameInputs: boolean;
+    /** The clips a look may choose; none, no clip field. */
+    clips: string[];
+    effects: boolean;
+    /** Whether a look may give a motion group's speed and pause. */
+    motion: boolean;
+    /** Whether a look may give no colour; a colour map's entry has one. */
+    colorOptional: boolean;
+    /** The colour a new code starts with. */
+    defaultColor?: string;
+    /** Whether looks give values at all: a legend whose consumer takes colour and effect only (fmsim's carrier legends) gives none. */
+    noValues: boolean;
+    disabled: boolean;
+    private added;
+    private newCode;
+    private newInput;
+    render(): import("lit-html").TemplateResult<1>;
+    /** The inputs shown: those given, those added here, and, with `showGiven`, any a look gives a value to. */
+    private shownInputs;
+    private renderCard;
+    private addCode;
+    /** A number in range is taken; an empty field takes the value away (the next source gives it); anything else is not taken. */
+    private changeValue;
+    /** An input named by hand: a field for it on every card, its values the looks' own. */
+    private addInput;
+    private change;
+}
+/** An input as the choice and the tooltip say it: its name, unit and range, and the tables that set it. */
+export declare function describeInput(input: LookInput): string;
+declare global {
+    interface HTMLElementTagNameMap {
+        'ox-legend-looks': OxLegendLooks;
+    }
+}