@things-factory/figure-ui 10.1.75 → 10.1.76

package/dist-client/modeller/recipe-source.d.ts

@@ -0,0 +1,8 @@
+import { type RecipeTemplate } from './recipes.js';
+/**
+ * Where the modeller gets its recipe templates: the server's static files (ADR-0095, amended 2026-09-26). The one place
+ * they are read -- the rules in `recipes.ts` stay free of the network so they are tested without it.
+ */
+export declare function availableRecipes(lang: string): Promise<RecipeTemplate[]>;
+/** One template's guide, or '' while none is written -- the screen then shows no guide and no word about one. */
+export declare function recipeGuide(name: string, lang: string): Promise<string>;

package/dist-client/modeller/recipe-source.js

@@ -0,0 +1,14 @@
+import { fetchRecipeGuide, fetchRecipeTemplates } from '../graphql/index.js';
+import { templatesOf } from './recipes.js';
+/**
+ * Where the modeller gets its recipe templates: the server's static files (ADR-0095, amended 2026-09-26). The one place
+ * they are read -- the rules in `recipes.ts` stay free of the network so they are tested without it.
+ */
+export async function availableRecipes(lang) {
+    return templatesOf(await fetchRecipeTemplates(lang));
+}
+/** One template's guide, or '' while none is written -- the screen then shows no guide and no word about one. */
+export function recipeGuide(name, lang) {
+    return fetchRecipeGuide(name, lang);
+}
+//# sourceMappingURL=recipe-source.js.map

package/dist-client/modeller/recipe-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-source.js","sourceRoot":"","sources":["../../client/modeller/recipe-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC5E,OAAO,EAAE,WAAW,EAAuB,MAAM,cAAc,CAAA;AAE/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,OAAO,WAAW,CAAC,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AACrC,CAAC","sourcesContent":["import { fetchRecipeGuide, fetchRecipeTemplates } from '../graphql/index.js'\nimport { templatesOf, type RecipeTemplate } from './recipes.js'\n\n/**\n * Where the modeller gets its recipe templates: the server's static files (ADR-0095, amended 2026-09-26). The one place\n * they are read -- the rules in `recipes.ts` stay free of the network so they are tested without it.\n */\nexport async function availableRecipes(lang: string): Promise<RecipeTemplate[]> {\n  return templatesOf(await fetchRecipeTemplates(lang))\n}\n\n/** One template's guide, or '' while none is written -- the screen then shows no guide and no word about one. */\nexport function recipeGuide(name: string, lang: string): Promise<string> {\n  return fetchRecipeGuide(name, lang)\n}\n"]}

package/dist-client/modeller/recipes.d.ts

@@ -0,0 +1,37 @@
+import type { FigureRecipe, FigureRecipeParam, FigureRecipeValue } from '@hatiolab/figure-model';
+import type { RecipeTemplateRow } from '../graphql/index.js';
+/** A template in the catalog: the server's row, its recipe parsed. */
+export interface RecipeTemplate extends Omit<RecipeTemplateRow, 'source'> {
+    recipe: FigureRecipe;
+}
+/** The server's rows as templates. A row that is not a recipe is left out rather than breaking the catalog. */
+export declare function templatesOf(rows: ReadonlyArray<RecipeTemplateRow>): RecipeTemplate[];
+/** A part the recipe makes, as the catalog names it: its own name, the placeholder left off. */
+export declare const recipePartName: (part: string) => string;
+/**
+ * How a template works, in lines the catalog shows -- worked out from its steps (figure-model `describeFigureRecipe`), each
+ * a translation key and its words.
+ */
+export declare function recipeWorkings(recipe: FigureRecipe): Array<{
+    key: string;
+    words: Record<string, string | number>;
+}>;
+/** A recipe's words in the language on screen: that language, else English, else the first it has. */
+export declare function recipeWord(words: Record<string, string> | undefined, language: string): string;
+/** Whether a recipe can be put in now: one for a part needs a part chosen. */
+export declare function recipeReady(recipe: Pick<FigureRecipe, 'target'>, selected: string): boolean;
+/**
+ * A field's value as the recipe takes it. A ratio is shown and typed as a percentage (35 for 0.35), since that is how a
+ * person says a share; the rest are taken as they are. A number field left empty or not a number keeps the default.
+ */
+export declare function recipeValueOf(param: FigureRecipeParam, typed: string | boolean): FigureRecipeValue;
+/** What a field shows for a value: a ratio as a percentage. */
+export declare function recipeFieldOf(param: FigureRecipeParam, value: FigureRecipeValue): string;
+/** The templates a category and words find: a word matches the title, the description, the name or a tag. */
+export declare function recipesMatching<T extends {
+    category: string;
+    title: string;
+    description: string;
+    name: string;
+    tags: string[];
+}>(templates: readonly T[], category: string, query: string): T[];

package/dist-client/modeller/recipes.js

@@ -0,0 +1,103 @@
+import { describeFigureRecipe } from '@hatiolab/figure-model';
+/*
+ * The recipe section's rules (ADR-0095), kept apart from the element so they can be tested without a browser.
+ */
+/** The server's rows as templates. A row that is not a recipe is left out rather than breaking the catalog. */
+export function templatesOf(rows) {
+    const out = [];
+    for (const { source, ...row } of rows) {
+        try {
+            const recipe = JSON.parse(source);
+            if (recipe && typeof recipe.name === 'string' && Array.isArray(recipe.steps))
+                out.push({ ...row, recipe });
+        }
+        catch {
+            /* not a recipe */
+        }
+    }
+    return out;
+}
+/** A part the recipe makes, as the catalog names it: its own name, the placeholder left off. */
+export const recipePartName = (part) => part.replace(/^\{id\}-/, '');
+/**
+ * How a template works, in lines the catalog shows -- worked out from its steps (figure-model `describeFigureRecipe`), each
+ * a translation key and its words.
+ */
+export function recipeWorkings(recipe) {
+    const d = describeFigureRecipe(recipe);
+    const lines = [];
+    for (const m of d.moves)
+        lines.push(m.follows
+            ? { key: 'figure.text.recipe-moves-with', words: { part: recipePartName(m.part), leader: recipePartName(m.follows) } }
+            : { key: m.kind === 'slide' ? 'figure.text.recipe-slides' : 'figure.text.recipe-turns', words: { part: recipePartName(m.part) } });
+    if (d.controls.length)
+        lines.push({ key: 'figure.text.recipe-controls', words: { count: d.controls.length } });
+    if (d.shownByControl.length)
+        lines.push({ key: 'figure.text.recipe-shown-by-control', words: { parts: d.shownByControl.map(recipePartName).join(', ') } });
+    for (const row of d.rows)
+        lines.push({ key: 'figure.text.recipe-row', words: { part: recipePartName(row) } });
+    return lines;
+}
+/** A recipe's words in the language on screen: that language, else English, else the first it has. */
+export function recipeWord(words, language) {
+    if (!words)
+        return '';
+    return words[language] ?? words[language.split('-')[0]] ?? words.en ?? Object.values(words)[0] ?? '';
+}
+/** Whether a recipe can be put in now: one for a part needs a part chosen. */
+export function recipeReady(recipe, selected) {
+    return recipe.target === 'figure' || !!selected;
+}
+/**
+ * A field's value as the recipe takes it. A ratio is shown and typed as a percentage (35 for 0.35), since that is how a
+ * person says a share; the rest are taken as they are. A number field left empty or not a number keeps the default.
+ */
+export function recipeValueOf(param, typed) {
+    if (param.kind === 'flag')
+        return typed === true || typed === 'true';
+    if (param.kind === 'ratio' || param.kind === 'mm') {
+        const n = typeof typed === 'string' && typed.trim() !== '' ? Number(typed) : NaN;
+        if (!Number.isFinite(n))
+            return param.default;
+        return param.kind === 'ratio' ? Math.round(n * 1e4) / 1e6 : n;
+    }
+    const option = (param.options ?? []).find(o => String(o) === String(typed));
+    return option ?? param.default;
+}
+/** What a field shows for a value: a ratio as a percentage. */
+export function recipeFieldOf(param, value) {
+    if (param.kind === 'ratio' && typeof value === 'number')
+        return String(Math.round(value * 1e6) / 1e4);
+    return String(value);
+}
+/** The templates a category and words find: a word matches the title, the description, the name or a tag. */
+export function recipesMatching(templates, category, query) {
+    const words = query.trim().toLowerCase().split(/\s+/).filter(Boolean);
+    const found = templates.filter(t => {
+        if (category && t.category !== category)
+            return false;
+        const text = [t.title, t.description, t.name, ...t.tags].join(' ').toLowerCase();
+        return words.every(w => text.includes(w));
+    });
+    if (!words.length)
+        return found;
+    /*
+      What the search names comes first: a title that is the words, then one that starts with them, then a title word that
+      does, then the rest in their order. 「다리」 listed 사다리 before 다리 넷 (walk 1, 2026-09-26).
+    */
+    const rank = (t) => {
+        const title = t.title.toLowerCase();
+        const query = words.join(' ');
+        if (title === query)
+            return 0;
+        if (title.startsWith(query))
+            return 1;
+        if (words.every(w => title.split(/\s+/).some(part => part.startsWith(w))))
+            return 2;
+        if (words.every(w => title.includes(w)))
+            return 3;
+        return 4;
+    };
+    return found.map((t, i) => ({ t, i, r: rank(t) })).sort((a, b) => a.r - b.r || a.i - b.i).map(x => x.t);
+}
+//# sourceMappingURL=recipes.js.map

package/dist-client/modeller/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../client/modeller/recipes.ts"],"names":[],"mappings":"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","sourcesContent":["import { describeFigureRecipe } from '@hatiolab/figure-model'\nimport type { FigureRecipe, FigureRecipeParam, FigureRecipeValue } from '@hatiolab/figure-model'\n\nimport type { RecipeTemplateRow } from '../graphql/index.js'\n\n/** A template in the catalog: the server's row, its recipe parsed. */\nexport interface RecipeTemplate extends Omit<RecipeTemplateRow, 'source'> {\n  recipe: FigureRecipe\n}\n\n/*\n * The recipe section's rules (ADR-0095), kept apart from the element so they can be tested without a browser.\n */\n\n/** The server's rows as templates. A row that is not a recipe is left out rather than breaking the catalog. */\nexport function templatesOf(rows: ReadonlyArray<RecipeTemplateRow>): RecipeTemplate[] {\n  const out: RecipeTemplate[] = []\n  for (const { source, ...row } of rows) {\n    try {\n      const recipe = JSON.parse(source)\n      if (recipe && typeof recipe.name === 'string' && Array.isArray(recipe.steps)) out.push({ ...row, recipe })\n    } catch {\n      /* not a recipe */\n    }\n  }\n  return out\n}\n\n/** A part the recipe makes, as the catalog names it: its own name, the placeholder left off. */\nexport const recipePartName = (part: string) => part.replace(/^\\{id\\}-/, '')\n\n/**\n * How a template works, in lines the catalog shows -- worked out from its steps (figure-model `describeFigureRecipe`), each\n * a translation key and its words.\n */\nexport function recipeWorkings(recipe: FigureRecipe): Array<{ key: string; words: Record<string, string | number> }> {\n  const d = describeFigureRecipe(recipe)\n  const lines: Array<{ key: string; words: Record<string, string | number> }> = []\n  for (const m of d.moves)\n    lines.push(\n      m.follows\n        ? { key: 'figure.text.recipe-moves-with', words: { part: recipePartName(m.part), leader: recipePartName(m.follows) } }\n        : { key: m.kind === 'slide' ? 'figure.text.recipe-slides' : 'figure.text.recipe-turns', words: { part: recipePartName(m.part) } }\n    )\n  if (d.controls.length) lines.push({ key: 'figure.text.recipe-controls', words: { count: d.controls.length } })\n  if (d.shownByControl.length) lines.push({ key: 'figure.text.recipe-shown-by-control', words: { parts: d.shownByControl.map(recipePartName).join(', ') } })\n  for (const row of d.rows) lines.push({ key: 'figure.text.recipe-row', words: { part: recipePartName(row) } })\n  return lines\n}\n\n/** A recipe's words in the language on screen: that language, else English, else the first it has. */\nexport function recipeWord(words: Record<string, string> | undefined, language: string): string {\n  if (!words) return ''\n  return words[language] ?? words[language.split('-')[0]!] ?? words.en ?? Object.values(words)[0] ?? ''\n}\n\n/** Whether a recipe can be put in now: one for a part needs a part chosen. */\nexport function recipeReady(recipe: Pick<FigureRecipe, 'target'>, selected: string): boolean {\n  return recipe.target === 'figure' || !!selected\n}\n\n/**\n * A field's value as the recipe takes it. A ratio is shown and typed as a percentage (35 for 0.35), since that is how a\n * person says a share; the rest are taken as they are. A number field left empty or not a number keeps the default.\n */\nexport function recipeValueOf(param: FigureRecipeParam, typed: string | boolean): FigureRecipeValue {\n  if (param.kind === 'flag') return typed === true || typed === 'true'\n  if (param.kind === 'ratio' || param.kind === 'mm') {\n    const n = typeof typed === 'string' && typed.trim() !== '' ? Number(typed) : NaN\n    if (!Number.isFinite(n)) return param.default\n    return param.kind === 'ratio' ? Math.round(n * 1e4) / 1e6 : n\n  }\n  const option = (param.options ?? []).find(o => String(o) === String(typed))\n  return option ?? param.default\n}\n\n/** What a field shows for a value: a ratio as a percentage. */\nexport function recipeFieldOf(param: FigureRecipeParam, value: FigureRecipeValue): string {\n  if (param.kind === 'ratio' && typeof value === 'number') return String(Math.round(value * 1e6) / 1e4)\n  return String(value)\n}\n\n\n/** The templates a category and words find: a word matches the title, the description, the name or a tag. */\nexport function recipesMatching<T extends { category: string; title: string; description: string; name: string; tags: string[] }>(templates: readonly T[], category: string, query: string): T[] {\n  const words = query.trim().toLowerCase().split(/\\s+/).filter(Boolean)\n  const found = templates.filter(t => {\n    if (category && t.category !== category) return false\n    const text = [t.title, t.description, t.name, ...t.tags].join(' ').toLowerCase()\n    return words.every(w => text.includes(w))\n  })\n  if (!words.length) return found\n  /*\n    What the search names comes first: a title that is the words, then one that starts with them, then a title word that\n    does, then the rest in their order. 「다리」 listed 사다리 before 다리 넷 (walk 1, 2026-09-26).\n  */\n  const rank = (t: T) => {\n    const title = t.title.toLowerCase()\n    const query = words.join(' ')\n    if (title === query) return 0\n    if (title.startsWith(query)) return 1\n    if (words.every(w => title.split(/\\s+/).some(part => part.startsWith(w)))) return 2\n    if (words.every(w => title.includes(w))) return 3\n    return 4\n  }\n  return found.map((t, i) => ({ t, i, r: rank(t) })).sort((a, b) => a.r - b.r || a.i - b.i).map(x => x.t)\n}\n"]}

package/dist-client/modeller/refusals.d.ts

@@ -0,0 +1,68 @@
+type Say = (key: string, params: Record<string, string>) => string;
+/** The refusal in words, or nothing for any other refusal. */
+export declare function sizeRangeRefusalOf(error: unknown, say: Say): string | null;
+/**
+ * A link refused because the size range it would leave cannot hold: measuring again cannot help (the link is not there
+ * to measure), so the author is offered the same link that narrows the range to what the figure then allows.
+ */
+export declare function narrowingRetryOf<A extends {
+    kind: string;
+}>(action: A, error: unknown, say: Say): {
+    message: string;
+    label: string;
+    retry: A & {
+        narrowRange: true;
+    };
+} | null;
+/**
+ * A placement refused because a part is fastened to the mounting plane by a face the new plane does not take (a bottom
+ * on the floor, when the figure is to hang on a wall), said in the author's words with the parts it names.
+ */
+export declare function placementRefusalOf(error: unknown, say: Say): string | null;
+/** A part refused because the declared room reads it -- the one refusal deleting it with the room refitted answers. */
+export declare function inDeclaredRoom(error: unknown): boolean;
+/**
+ * Why a part cannot be deleted, in the author's words. Since the chief architect's ruling of 2026-09-27 a part that
+ * holds others, leads a motion or is followed goes, and what depended on it is let go of (`removalNoticeOf`); what is
+ * left is the declared space (with a way on: fit it again) and a row -- one laid along the part, or hanging in its row.
+ */
+export declare function partRefusalOf(error: unknown, part: string, say: Say): string | null;
+/** What removing a part let go of (figure-model's `RemovalNotice`), said in one line, or nothing when it let go of nothing. */
+export declare function removalNoticeOf(notice: {
+    released: Array<{
+        part: string;
+        control?: string;
+    }>;
+    fixed: Array<{
+        part: string;
+    }>;
+    controls: Array<{
+        part: string;
+        control: string;
+        min: number;
+        max: number;
+    }>;
+    mountingFace?: boolean;
+    bindings?: Array<{
+        id: string;
+        label?: string;
+    }>;
+} | undefined, say: Say): string | null;
+/**
+ * A recipe refused at one of its steps: which step, and why -- the particular sentence when there is one (a size
+ * range, a value's range, a placement), otherwise the kernel's code. The kernel says 「steps[2]: attach: …」.
+ */
+export declare function recipeRefusalOf(error: unknown, say: Say): string | null;
+/**
+ * A refusal no sentence above knows, said as a refusal with its code -- never the kernel's English on the screen (the
+ * duplicate of a row's part showed 「EDIT_TARGET: … not a repeated template」, 2026-09-27). The figure's node limit
+ * is said with its number.
+ */
+export declare function editRefusalOf(error: unknown, say: Say): string;
+/**
+ * A value outside the range its input declares, with the range and the value given -- the kernel says
+ * 「size.x: 6021100 outside [300,1200]」. The figure's own size is named by its axis; any other input by its range only.
+ * The repeat pitch's refusal shares the code and has its own words (`figure.text.repeat-pitch-too-small`).
+ */
+export declare function inputRangeRefusalOf(error: unknown, say: Say): string | null;
+export {};

package/dist-client/modeller/refusals.js

@@ -0,0 +1,142 @@
+/*
+ * A command refused because the figure could not be drawn at an end of its declared size range, in the author's words
+ * with the numbers and where to put it right -- not the kernel's English (user, 2026-09-24: 「what is this warning
+ * message means?」). Kept apart from the element so it is tested without a browser.
+ */
+/** The refusal in words, or nothing for any other refusal. */
+export function sizeRangeRefusalOf(error, say) {
+    if (error?.code !== 'INSTANCE_SIZE_RANGE')
+        return null;
+    const message = error instanceof Error ? error.message : String(error);
+    const found = /size\.([xyz]):\s*(below|above) ([\d.]+) mm [^(;]*(?:\(([^)]+)\))?;/.exec(message);
+    if (!found)
+        return null;
+    const [, axis, side, mm, part] = found;
+    return say(side === 'below' ? 'figure.text.size-range-too-small' : 'figure.text.size-range-too-large', {
+        axis: axis.toUpperCase(),
+        mm: Number(mm).toLocaleString(undefined, { maximumFractionDigits: 1 }),
+        part: part ?? ''
+    });
+}
+/**
+ * A link refused because the size range it would leave cannot hold: measuring again cannot help (the link is not there
+ * to measure), so the author is offered the same link that narrows the range to what the figure then allows.
+ */
+export function narrowingRetryOf(action, error, say) {
+    if (action.kind !== 'link-dimension' || error?.code !== 'INSTANCE_SIZE_RANGE')
+        return null;
+    const message = error instanceof Error ? error.message : String(error);
+    const found = /size\.([xyz]):\s*(below|above) ([\d.]+) mm [^(;]*(?:\(([^)]+)\))?;/.exec(message);
+    if (!found)
+        return null;
+    const [, axis, side, raw, part] = found;
+    const mm = Number(raw).toLocaleString(undefined, { maximumFractionDigits: 1 });
+    const words = { axis: axis.toUpperCase(), mm, part: part ?? '' };
+    return {
+        message: say(side === 'below' ? 'figure.text.link-needs-smaller-range' : 'figure.text.link-needs-larger-range', words),
+        label: say(side === 'below' ? 'figure.button.narrow-range-from' : 'figure.button.narrow-range-to', words),
+        retry: { ...action, narrowRange: true }
+    };
+}
+/**
+ * A placement refused because a part is fastened to the mounting plane by a face the new plane does not take (a bottom
+ * on the floor, when the figure is to hang on a wall), said in the author's words with the parts it names.
+ */
+export function placementRefusalOf(error, say) {
+    if (error?.code !== 'PLACEMENT_PLANE')
+        return null;
+    const message = error instanceof Error ? error.message : String(error);
+    const found = /: (.+?) (?:is|are) fastened to the mounting plane by a face an? (\w+) does not take \(([^)]+)\)/.exec(message);
+    if (!found)
+        return null;
+    return say('figure.text.placement-plane-refused', { parts: found[1], placement: say('figure.label.placement-' + found[2], {}), faces: found[3] });
+}
+/** A part refused because the declared room reads it -- the one refusal deleting it with the room refitted answers. */
+export function inDeclaredRoom(error) {
+    return error?.code === 'PART_REFERENCED' && /is in the space the figure declares/.test(error instanceof Error ? error.message : String(error));
+}
+/**
+ * Why a part cannot be deleted, in the author's words. Since the chief architect's ruling of 2026-09-27 a part that
+ * holds others, leads a motion or is followed goes, and what depended on it is let go of (`removalNoticeOf`); what is
+ * left is the declared space (with a way on: fit it again) and a row -- one laid along the part, or hanging in its row.
+ */
+export function partRefusalOf(error, part, say) {
+    const code = error?.code;
+    if (code !== 'PART_REFERENCED' && code !== 'PART_ROW')
+        return null;
+    /* figure-model's sentence after its code and path: 「PART_ROW: bed: roller is a row laid along bed; …」. */
+    const message = (error instanceof Error ? error.message : String(error)).replace(/^[A-Z_]+: [^:]+: /, '');
+    if (/is in the space the figure declares/.test(message))
+        return say('figure.text.part-in-declared-space', { part });
+    const along = /^(.+?) (?:is a row|are rows) laid along /.exec(message);
+    if (along)
+        return say('figure.text.part-row-along', { part, rows: along[1] });
+    const carried = /^(.+?) hangs? in the row /.exec(message);
+    if (carried)
+        return say('figure.text.part-row-carries', { part, others: carried[1] });
+    return say('figure.text.part-is-referenced', { part });
+}
+/** What removing a part let go of (figure-model's `RemovalNotice`), said in one line, or nothing when it let go of nothing. */
+export function removalNoticeOf(notice, say) {
+    if (!notice)
+        return null;
+    const number = (v) => v.toLocaleString(undefined, { maximumFractionDigits: 3 });
+    const lines = [];
+    const still = notice.released.filter(r => !r.control).map(r => r.part);
+    if (still.length)
+        lines.push(say('figure.text.removal-released', { parts: still.join(', ') }));
+    for (const r of notice.released.filter(r => r.control))
+        lines.push(say('figure.text.removal-released-motion', { part: r.part, control: r.control }));
+    for (const c of notice.controls)
+        lines.push(say('figure.text.removal-own-control', { part: c.part, control: c.control, min: number(c.min), max: number(c.max) }));
+    const fixed = [...new Set(notice.fixed.map(f => f.part))];
+    if (fixed.length)
+        lines.push(say('figure.text.removal-fixed', { parts: fixed.join(', ') }));
+    if (notice.bindings?.length)
+        lines.push(say('figure.text.removal-bindings', { places: notice.bindings.map(b => b.label ?? b.id).join(', ') }));
+    if (notice.mountingFace)
+        lines.push(say('figure.text.removal-mounting-face', {}));
+    return lines.length ? lines.join(' ') : null;
+}
+/**
+ * A recipe refused at one of its steps: which step, and why -- the particular sentence when there is one (a size
+ * range, a value's range, a placement), otherwise the kernel's code. The kernel says 「steps[2]: attach: …」.
+ */
+export function recipeRefusalOf(error, say) {
+    const step = /^steps\[(\d+)\]$/.exec(error?.path ?? '');
+    if (!step)
+        return null;
+    const why = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? placementRefusalOf(error, say);
+    return say('figure.text.recipe-step-refused', { step: String(Number(step[1]) + 1), why: why ?? '', code: error?.code ?? '' });
+}
+/**
+ * A refusal no sentence above knows, said as a refusal with its code -- never the kernel's English on the screen (the
+ * duplicate of a row's part showed 「EDIT_TARGET: … not a repeated template」, 2026-09-27). The figure's node limit
+ * is said with its number.
+ */
+export function editRefusalOf(error, say) {
+    const code = error?.code;
+    const message = error instanceof Error ? error.message : String(error);
+    if (code === 'DOCUMENT_LIMIT')
+        return say('figure.text.edit-refused-node-limit', { max: /maximum (\d+) nodes/.exec(message)?.[1] ?? '' });
+    return say('figure.text.edit-refused', { code: code ?? '' });
+}
+/**
+ * A value outside the range its input declares, with the range and the value given -- the kernel says
+ * 「size.x: 6021100 outside [300,1200]」. The figure's own size is named by its axis; any other input by its range only.
+ * The repeat pitch's refusal shares the code and has its own words (`figure.text.repeat-pitch-too-small`).
+ */
+export function inputRangeRefusalOf(error, say) {
+    if (error?.code !== 'INPUT_RANGE')
+        return null;
+    const message = error instanceof Error ? error.message : String(error);
+    const found = /([\w.-]+): (-?[\d.e+]+) outside \[(-?[\d.e+]+),\s*(-?[\d.e+]+)\]/.exec(message);
+    if (!found)
+        return null;
+    const [, input, value, min, max] = found;
+    const number = (text) => Number(text).toLocaleString(undefined, { maximumFractionDigits: 3 });
+    const axis = /^size\.([xyz])$/.exec(input)?.[1];
+    const params = { value: number(value), min: number(min), max: number(max) };
+    return axis ? say('figure.text.input-range-size', { ...params, axis: axis.toUpperCase() }) : say('figure.text.input-range', params);
+}
+//# sourceMappingURL=refusals.js.map

package/dist-client/modeller/refusals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusals.js","sourceRoot":"","sources":["../../client/modeller/refusals.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * A command refused because the figure could not be drawn at an end of its declared size range, in the author's words\n * with the numbers and where to put it right -- not the kernel's English (user, 2026-09-24: 「what is this warning\n * message means?」). Kept apart from the element so it is tested without a browser.\n */\n\ntype Say = (key: string, params: Record<string, string>) => string\n\n/** The refusal in words, or nothing for any other refusal. */\nexport function sizeRangeRefusalOf(error: unknown, say: Say): string | null {\n  if ((error as { code?: string })?.code !== 'INSTANCE_SIZE_RANGE') return null\n  const message = error instanceof Error ? error.message : String(error)\n  const found = /size\\.([xyz]):\\s*(below|above) ([\\d.]+) mm [^(;]*(?:\\(([^)]+)\\))?;/.exec(message)\n  if (!found) return null\n  const [, axis, side, mm, part] = found\n  return say(side === 'below' ? 'figure.text.size-range-too-small' : 'figure.text.size-range-too-large', {\n    axis: axis!.toUpperCase(),\n    mm: Number(mm).toLocaleString(undefined, { maximumFractionDigits: 1 }),\n    part: part ?? ''\n  })\n}\n\n/**\n * A link refused because the size range it would leave cannot hold: measuring again cannot help (the link is not there\n * to measure), so the author is offered the same link that narrows the range to what the figure then allows.\n */\nexport function narrowingRetryOf<A extends { kind: string }>(action: A, error: unknown, say: Say): { message: string; label: string; retry: A & { narrowRange: true } } | null {\n  if (action.kind !== 'link-dimension' || (error as { code?: string })?.code !== 'INSTANCE_SIZE_RANGE') return null\n  const message = error instanceof Error ? error.message : String(error)\n  const found = /size\\.([xyz]):\\s*(below|above) ([\\d.]+) mm [^(;]*(?:\\(([^)]+)\\))?;/.exec(message)\n  if (!found) return null\n  const [, axis, side, raw, part] = found\n  const mm = Number(raw).toLocaleString(undefined, { maximumFractionDigits: 1 })\n  const words = { axis: axis!.toUpperCase(), mm, part: part ?? '' }\n  return {\n    message: say(side === 'below' ? 'figure.text.link-needs-smaller-range' : 'figure.text.link-needs-larger-range', words),\n    label: say(side === 'below' ? 'figure.button.narrow-range-from' : 'figure.button.narrow-range-to', words),\n    retry: { ...action, narrowRange: true }\n  }\n}\n\n/**\n * A placement refused because a part is fastened to the mounting plane by a face the new plane does not take (a bottom\n * on the floor, when the figure is to hang on a wall), said in the author's words with the parts it names.\n */\nexport function placementRefusalOf(error: unknown, say: Say): string | null {\n  if ((error as { code?: string })?.code !== 'PLACEMENT_PLANE') return null\n  const message = error instanceof Error ? error.message : String(error)\n  const found = /: (.+?) (?:is|are) fastened to the mounting plane by a face an? (\\w+) does not take \\(([^)]+)\\)/.exec(message)\n  if (!found) return null\n  return say('figure.text.placement-plane-refused', { parts: found[1]!, placement: say('figure.label.placement-' + found[2]!, {}), faces: found[3]! })\n}\n\n/** A part refused because the declared room reads it -- the one refusal deleting it with the room refitted answers. */\nexport function inDeclaredRoom(error: unknown): boolean {\n  return (error as { code?: string })?.code === 'PART_REFERENCED' && /is in the space the figure declares/.test(error instanceof Error ? error.message : String(error))\n}\n\n/**\n * Why a part cannot be deleted, in the author's words. Since the chief architect's ruling of 2026-09-27 a part that\n * holds others, leads a motion or is followed goes, and what depended on it is let go of (`removalNoticeOf`); what is\n * left is the declared space (with a way on: fit it again) and a row -- one laid along the part, or hanging in its row.\n */\nexport function partRefusalOf(error: unknown, part: string, say: Say): string | null {\n  const code = (error as { code?: string })?.code\n  if (code !== 'PART_REFERENCED' && code !== 'PART_ROW') return null\n  /* figure-model's sentence after its code and path: 「PART_ROW: bed: roller is a row laid along bed; …」. */\n  const message = (error instanceof Error ? error.message : String(error)).replace(/^[A-Z_]+: [^:]+: /, '')\n  if (/is in the space the figure declares/.test(message)) return say('figure.text.part-in-declared-space', { part })\n  const along = /^(.+?) (?:is a row|are rows) laid along /.exec(message)\n  if (along) return say('figure.text.part-row-along', { part, rows: along[1]! })\n  const carried = /^(.+?) hangs? in the row /.exec(message)\n  if (carried) return say('figure.text.part-row-carries', { part, others: carried[1]! })\n  return say('figure.text.part-is-referenced', { part })\n}\n\n/** What removing a part let go of (figure-model's `RemovalNotice`), said in one line, or nothing when it let go of nothing. */\nexport function removalNoticeOf(\n  notice:\n    | {\n        released: Array<{ part: string; control?: string }>\n        fixed: Array<{ part: string }>\n        controls: Array<{ part: string; control: string; min: number; max: number }>\n        mountingFace?: boolean\n        bindings?: Array<{ id: string; label?: string }>\n      }\n    | undefined,\n  say: Say\n): string | null {\n  if (!notice) return null\n  const number = (v: number) => v.toLocaleString(undefined, { maximumFractionDigits: 3 })\n  const lines: string[] = []\n  const still = notice.released.filter(r => !r.control).map(r => r.part)\n  if (still.length) lines.push(say('figure.text.removal-released', { parts: still.join(', ') }))\n  for (const r of notice.released.filter(r => r.control)) lines.push(say('figure.text.removal-released-motion', { part: r.part, control: r.control! }))\n  for (const c of notice.controls) lines.push(say('figure.text.removal-own-control', { part: c.part, control: c.control, min: number(c.min), max: number(c.max) }))\n  const fixed = [...new Set(notice.fixed.map(f => f.part))]\n  if (fixed.length) lines.push(say('figure.text.removal-fixed', { parts: fixed.join(', ') }))\n  if (notice.bindings?.length) lines.push(say('figure.text.removal-bindings', { places: notice.bindings.map(b => b.label ?? b.id).join(', ') }))\n  if (notice.mountingFace) lines.push(say('figure.text.removal-mounting-face', {}))\n  return lines.length ? lines.join(' ') : null\n}\n\n/**\n * A recipe refused at one of its steps: which step, and why -- the particular sentence when there is one (a size\n * range, a value's range, a placement), otherwise the kernel's code. The kernel says 「steps[2]: attach: …」.\n */\nexport function recipeRefusalOf(error: unknown, say: Say): string | null {\n  const step = /^steps\\[(\\d+)\\]$/.exec((error as { path?: string })?.path ?? '')\n  if (!step) return null\n  const why = sizeRangeRefusalOf(error, say) ?? inputRangeRefusalOf(error, say) ?? placementRefusalOf(error, say)\n  return say('figure.text.recipe-step-refused', { step: String(Number(step[1]) + 1), why: why ?? '', code: (error as { code?: string })?.code ?? '' })\n}\n\n/**\n * A refusal no sentence above knows, said as a refusal with its code -- never the kernel's English on the screen (the\n * duplicate of a row's part showed 「EDIT_TARGET: … not a repeated template」, 2026-09-27). The figure's node limit\n * is said with its number.\n */\nexport function editRefusalOf(error: unknown, say: Say): string {\n  const code = (error as { code?: string })?.code\n  const message = error instanceof Error ? error.message : String(error)\n  if (code === 'DOCUMENT_LIMIT') return say('figure.text.edit-refused-node-limit', { max: /maximum (\\d+) nodes/.exec(message)?.[1] ?? '' })\n  return say('figure.text.edit-refused', { code: code ?? '' })\n}\n\n/**\n * A value outside the range its input declares, with the range and the value given -- the kernel says\n * 「size.x: 6021100 outside [300,1200]」. The figure's own size is named by its axis; any other input by its range only.\n * The repeat pitch's refusal shares the code and has its own words (`figure.text.repeat-pitch-too-small`).\n */\nexport function inputRangeRefusalOf(error: unknown, say: Say): string | null {\n  if ((error as { code?: string })?.code !== 'INPUT_RANGE') return null\n  const message = error instanceof Error ? error.message : String(error)\n  const found = /([\\w.-]+): (-?[\\d.e+]+) outside \\[(-?[\\d.e+]+),\\s*(-?[\\d.e+]+)\\]/.exec(message)\n  if (!found) return null\n  const [, input, value, min, max] = found\n  const number = (text: string) => Number(text).toLocaleString(undefined, { maximumFractionDigits: 3 })\n  const axis = /^size\\.([xyz])$/.exec(input!)?.[1]\n  const params = { value: number(value!), min: number(min!), max: number(max!) }\n  return axis ? say('figure.text.input-range-size', { ...params, axis: axis.toUpperCase() }) : say('figure.text.input-range', params)\n}\n"]}

package/dist-client/modeller/renderer.d.ts

@@ -0,0 +1,40 @@
+import * as THREE from 'three';
+/** Evaluated boundary: graph values are resolved before reaching the renderer. */
+export interface FigureRenderPart {
+    id: string;
+    shape: {
+        provider: string;
+        dimensions: Record<string, number>;
+        profile?: Array<{
+            x: number;
+            y: number;
+        }>;
+    };
+    pose: {
+        r: number[][];
+        t: number[];
+    };
+    material: {
+        token: string;
+        preset?: string;
+        transparent?: boolean;
+        emissive?: {
+            token: string;
+            intensity: number;
+            on: boolean;
+        };
+    };
+    segments?: number;
+}
+/**
+ * The bodies a canvas draws, out of everything the asset evaluated.
+ *
+ * Two are left out. A scalar body carries no shape or pose — it is a number the graph produced, not something
+ * on screen. A body the asset hides is evaluated, placed and gated exactly as a shown one, and excluded from
+ * rendering, from shadows and from pointer picking (designer's ruling 2026-09-22); drawing it would make
+ * "hidden" mean nothing in the modeller while it means something on a board.
+ */
+export declare function drawableFigureParts(geometry: readonly unknown[]): FigureRenderPart[];
+export declare function disposeFigureMeshes(group: THREE.Group): void;
+/** Build first, then swap; failed rendering must not erase the previous scene. No old meshes survive a successful swap. */
+export declare function replaceFigureMeshes(group: THREE.Group, parts: readonly FigureRenderPart[], palette: Record<string, string>): void;

package/dist-client/modeller/renderer.js

@@ -0,0 +1,73 @@
+import * as THREE from 'three';
+import { buildFigureGeometry } from '@hatiolab/things-scene';
+/**
+ * The bodies a canvas draws, out of everything the asset evaluated.
+ *
+ * Two are left out. A scalar body carries no shape or pose — it is a number the graph produced, not something
+ * on screen. A body the asset hides is evaluated, placed and gated exactly as a shown one, and excluded from
+ * rendering, from shadows and from pointer picking (designer's ruling 2026-09-22); drawing it would make
+ * "hidden" mean nothing in the modeller while it means something on a board.
+ */
+export function drawableFigureParts(geometry) {
+    return geometry.filter((body) => !!body && typeof body === 'object' && 'shape' in body && 'pose' in body && body.visible !== false);
+}
+/**
+ * The mesh for one body — things-scene's builder, not a copy of it.
+ *
+ * The modeller kept its own provider switch and it knew four providers; figures use eleven. A body the
+ * board drew was refused here with "Unsupported provider: roundedBoxXZ" (2026-09-24, the first canvas check of
+ * ADR-0087 step 4). One builder, and the canvas an author looks at shows what a board will show.
+ */
+function geometry(part) {
+    const built = buildFigureGeometry(part.shape, part.segments ?? 12);
+    if (!built)
+        throw Error('Unsupported provider: ' + part.shape.provider);
+    return built;
+}
+export function disposeFigureMeshes(group) {
+    for (const child of [...group.children]) {
+        if (child instanceof THREE.Mesh) {
+            child.geometry.dispose();
+            const materials = Array.isArray(child.material) ? child.material : [child.material];
+            materials.forEach(m => m.dispose());
+        }
+        group.remove(child);
+    }
+}
+/** Build first, then swap; failed rendering must not erase the previous scene. No old meshes survive a successful swap. */
+export function replaceFigureMeshes(group, parts, palette) {
+    const staged = new THREE.Group(), ids = new Set();
+    try {
+        for (const part of parts) {
+            if (ids.has(part.id))
+                throw Error('Duplicate geometry ID: ' + part.id);
+            ids.add(part.id);
+            const color = palette[part.material.token];
+            if (!color || !/^#[0-9a-f]{6}$/i.test(color))
+                throw Error('Unresolved material token: ' + part.material.token);
+            const { r, t } = part.pose;
+            if (r.length !== 3 || r.some(row => row.length !== 3 || row.some(x => !Number.isFinite(x))) || t.length !== 3 || t.some(x => !Number.isFinite(x)))
+                throw Error('Invalid pose: ' + part.id);
+            const emissive = part.material.emissive;
+            if (emissive?.on && !/^#[0-9a-f]{6}$/i.test(palette[emissive.token] ?? ''))
+                throw Error('Unresolved emissive token');
+            const g = geometry(part);
+            const material = new THREE.MeshStandardMaterial({ color, metalness: part.material.preset === 'metal' ? 0.8 : 0, roughness: part.material.preset === 'metal' ? 0.3 : 0.65, transparent: !!part.material.transparent, opacity: part.material.transparent ? 0.35 : 1, emissive: emissive?.on ? palette[emissive.token] : 0, emissiveIntensity: emissive?.on ? emissive.intensity : 0 });
+            const mesh = new THREE.Mesh(g, material);
+            mesh.name = part.id;
+            mesh.userData.figurePartId = part.id;
+            mesh.matrixAutoUpdate = false;
+            mesh.matrix.set(r[0][0], r[0][1], r[0][2], t[0], r[1][0], r[1][1], r[1][2], t[1], r[2][0], r[2][1], r[2][2], t[2], 0, 0, 0, 1);
+            staged.add(mesh);
+        }
+    }
+    catch (error) {
+        disposeFigureMeshes(staged);
+        throw error;
+    }
+    disposeFigureMeshes(group);
+    for (const mesh of [...staged.children])
+        group.add(mesh);
+    group.updateMatrixWorld(true);
+}
+//# sourceMappingURL=renderer.js.map

package/dist-client/modeller/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../client/modeller/renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\nimport { buildFigureGeometry } from '@hatiolab/things-scene'\n\n/** Evaluated boundary: graph values are resolved before reaching the renderer. */\nexport interface FigureRenderPart {\n  id: string\n  shape: { provider: string; dimensions: Record<string, number>; profile?: Array<{x:number;y:number}> }\n  pose: {r:number[][];t:number[]}\n  material: {token:string;preset?:string;transparent?:boolean;emissive?:{token:string;intensity:number;on:boolean}}\n  segments?:number\n}\n\n/**\n * The bodies a canvas draws, out of everything the asset evaluated.\n *\n * Two are left out. A scalar body carries no shape or pose — it is a number the graph produced, not something\n * on screen. A body the asset hides is evaluated, placed and gated exactly as a shown one, and excluded from\n * rendering, from shadows and from pointer picking (designer's ruling 2026-09-22); drawing it would make\n * \"hidden\" mean nothing in the modeller while it means something on a board.\n */\nexport function drawableFigureParts(geometry: readonly unknown[]): FigureRenderPart[] {\n  return geometry.filter(\n    (body): body is FigureRenderPart =>\n      !!body && typeof body === 'object' && 'shape' in body && 'pose' in body && (body as { visible?: boolean }).visible !== false\n  )\n}\n\n/**\n * The mesh for one body — things-scene's builder, not a copy of it.\n *\n * The modeller kept its own provider switch and it knew four providers; figures use eleven. A body the\n * board drew was refused here with \"Unsupported provider: roundedBoxXZ\" (2026-09-24, the first canvas check of\n * ADR-0087 step 4). One builder, and the canvas an author looks at shows what a board will show.\n */\nfunction geometry(part: FigureRenderPart): THREE.BufferGeometry {\n  const built = buildFigureGeometry(part.shape as never, part.segments ?? 12) as THREE.BufferGeometry | undefined\n  if (!built) throw Error('Unsupported provider: ' + part.shape.provider)\n  return built\n}\n\nexport function disposeFigureMeshes(group:THREE.Group):void {\n for(const child of [...group.children]){\n  if(child instanceof THREE.Mesh){child.geometry.dispose();const materials=Array.isArray(child.material)?child.material:[child.material];materials.forEach(m=>m.dispose())}\n  group.remove(child)\n }\n}\n\n/** Build first, then swap; failed rendering must not erase the previous scene. No old meshes survive a successful swap. */\nexport function replaceFigureMeshes(group:THREE.Group,parts:readonly FigureRenderPart[],palette:Record<string,string>):void {\n const staged=new THREE.Group(),ids=new Set<string>()\n try{\n  for(const part of parts){\n   if(ids.has(part.id))throw Error('Duplicate geometry ID: '+part.id);ids.add(part.id)\n   const color=palette[part.material.token]\n   if(!color||!/^#[0-9a-f]{6}$/i.test(color))throw Error('Unresolved material token: '+part.material.token)\n   const {r,t}=part.pose\n   if(r.length!==3||r.some(row=>row.length!==3||row.some(x=>!Number.isFinite(x)))||t.length!==3||t.some(x=>!Number.isFinite(x)))throw Error('Invalid pose: '+part.id)\n   const emissive=part.material.emissive\n   if(emissive?.on&&!/^#[0-9a-f]{6}$/i.test(palette[emissive.token]??''))throw Error('Unresolved emissive token')\n   const g=geometry(part)\n   const material=new THREE.MeshStandardMaterial({color,metalness:part.material.preset==='metal'?0.8:0,roughness:part.material.preset==='metal'?0.3:0.65,transparent:!!part.material.transparent,opacity:part.material.transparent?0.35:1,emissive:emissive?.on?palette[emissive.token]:0,emissiveIntensity:emissive?.on?emissive.intensity:0})\n   const mesh=new THREE.Mesh(g,material);mesh.name=part.id;mesh.userData.figurePartId=part.id\n   mesh.matrixAutoUpdate=false;mesh.matrix.set(r[0][0],r[0][1],r[0][2],t[0],r[1][0],r[1][1],r[1][2],t[1],r[2][0],r[2][1],r[2][2],t[2],0,0,0,1)\n   staged.add(mesh)\n  }\n }catch(error){disposeFigureMeshes(staged);throw error}\n disposeFigureMeshes(group)\n for(const mesh of [...staged.children])group.add(mesh)\n group.updateMatrixWorld(true)\n}\n"]}

package/dist-client/modeller/stage-model.d.ts

@@ -0,0 +1,39 @@
+import * as THREE from 'three';
+import type { GizmoResult } from './gizmo.js';
+import type { FigureRenderPart } from './renderer.js';
+export interface Board {
+    width: number;
+    height: number;
+}
+export interface BodyFrame {
+    /** The body's box: its centre in the body's own frame, and its extent. */
+    centre: THREE.Vector3;
+    extent: THREE.Vector3;
+    rotation: THREE.Matrix4;
+    origin: THREE.Vector3;
+}
+export declare function frameOf(part: FigureRenderPart): BodyFrame | null;
+/** The component state that draws a body where figure-model put it. */
+export declare function componentOf(part: FigureRenderPart, palette: Record<string, string>, board: Board): Record<string, unknown> | null;
+/**
+ * What the gizmo did, in the inputs' terms: where the body's origin is now, how it is turned (degrees, rigid@1's
+ * order) and how much each of its own axes grew. Only what changed is given; a component the gizmo did not move gives
+ * nothing.
+ */
+export declare function gizmoResultOf(part: FigureRenderPart, after: Record<string, unknown>, board: Board): GizmoResult;
+/**
+ * A drag as amounts, for a part whose place is worked out (`nudge-part`): how far its origin moved and how far each of
+ * its angles turned (rigid@1's order, degrees). Nothing on an axis that did not change.
+ */
+export declare function nudgeOf(part: FigureRenderPart, result: GizmoResult): {
+    by: Partial<Record<'x' | 'y' | 'z', number>>;
+    turn: Partial<Record<'x' | 'y' | 'z', number>>;
+};
+/** The keys of `next` whose values differ from `current` -- only those are set, so the scene raises no echo. */
+export declare function changedKeys(current: Record<string, unknown>, next: Record<string, unknown>): Record<string, unknown> | null;
+/** A board wide and deep enough for the figure, with room around it; its size only grows while a figure is edited. */
+export declare function boardFor(parts: readonly FigureRenderPart[], at?: Board & {
+    depth?: number;
+}): Board & {
+    depth: number;
+};