@things-factory/figure-ui 10.1.74 → 10.1.76

package/dist-client/graphql/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../client/graphql/store.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,aAAa,CAAA;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,KAAK,CAAC,kBAAkB,CAAC,CAAA;QACpD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACnC,QAAQ,EAAE,GAAG,CAAA;;;;;;;;;;;;;;OAcZ;YACD,SAAS,EAAE,OAAO;SACnB,CAAC,CAAA;QACF,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACxF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,UAA6C,CAAA;QAC3E,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAA;QACxE,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA","sourcesContent":["import gql from 'graphql-tag'\nimport { client } from '@operato/graphql'\nimport { fetchFigure } from './index.js'\nimport type { FigureProductStore, FigureProductRecord } from '../modeller/product-session.js'\n\n/** source is sent intact. No conversion into the old parts/base authoring representation. */\nexport const figureProductStore: FigureProductStore = {\n  async load(id) {\n    const record = await fetchFigure(id)\n    if (!record?.source) throw Error('Figure 정본이 없습니다.')\n    return { id: record.id, source: record.source }\n  },\n  async save(request) {\n    const response = await client.mutate({\n      mutation: gql`\n        mutation SaveFigure($source: String!, $id: String, $expectedSource: String, $creationId: String, $thumbnail: String, $type: String) {\n          saveFigure(\n            source: $source\n            id: $id\n            expectedSource: $expectedSource\n            creationId: $creationId\n            thumbnail: $thumbnail\n            type: $type\n          ) {\n            id\n            source\n          }\n        }\n      `,\n      variables: request\n    })\n    if (response.errors?.length) throw Error(response.errors.map(e => e.message).join('\\n'))\n    const result = response.data?.saveFigure as FigureProductRecord | undefined\n    if (!result?.id || !result.source) throw Error('서버가 저장 결과를 돌려주지 않았습니다.')\n    return result\n  }\n}\n"]}

package/dist-client/modeller/ai-proposal.d.ts

@@ -0,0 +1,51 @@
+import type { FigureProposalStep } from '@hatiolab/figure-model';
+/** What the card carries, as `proposeFigureCandidate` returned it. */
+export interface FigureProposalCard {
+    steps?: FigureProposalStep[];
+    create?: boolean;
+    figureId?: string;
+    context?: string;
+    revision?: number;
+}
+/** The `figure-apply` event's detail. The page that takes it sets `applied`, and `error` when refused. */
+export interface FigureApplyDetail {
+    steps: FigureProposalStep[];
+    create: boolean;
+    context?: string;
+    revision?: number;
+    applied?: boolean;
+    error?: string;
+    code?: string;
+}
+export type Say = (key: string, params?: Record<string, string>) => string;
+export interface FigureProposalTarget {
+    /** Offers the proposal to a modeller on screen. It comes back untouched when none took it. */
+    offer(detail: FigureApplyDetail): FigureApplyDetail;
+    /** Opens a new figure in the modeller and applies the steps there; resolves once the page has, or has not. */
+    openNew(steps: FigureProposalStep[]): Promise<{
+        applied: boolean;
+        error?: string;
+        code?: string;
+    }>;
+}
+export interface FigureProposalOutcome {
+    verdict: 'accepted' | 'refused' | 'unavailable';
+    errorCode?: string;
+    applied?: number;
+    note?: string;
+}
+export declare function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome>;
+export declare function pendNewFigure(steps: FigureProposalStep[], ms?: number): Promise<{
+    applied: boolean;
+    error?: string;
+    code?: string;
+}>;
+/** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
+export declare function takePendingNewFigure(): {
+    steps: FigureProposalStep[];
+    settle: (result: {
+        applied: boolean;
+        error?: string;
+        code?: string;
+    }) => void;
+} | undefined;

package/dist-client/modeller/ai-proposal.js

@@ -0,0 +1,64 @@
+/** The workspace refuses a request made on another version; said as what happened, not as the kernel's code. */
+const STALE = new Set(['REVISION_CONFLICT', 'CONTEXT_CONFLICT']);
+function refused(code, error, say) {
+    const note = code && STALE.has(code)
+        ? say('figure.text.proposal-stale')
+        : code === 'NEW_FIGURE_UNSAVED'
+            ? (error ?? '')
+            : say('figure.text.proposal-refused', { reason: error ?? '' });
+    return { verdict: 'refused', errorCode: code ?? 'refused', note };
+}
+export async function runFigureProposal(card, target, say) {
+    const steps = card?.steps;
+    if (!Array.isArray(steps) || !steps.length)
+        return { verdict: 'unavailable', errorCode: 'no-steps' };
+    const create = card.create === true;
+    const accepted = () => ({
+        verdict: 'accepted',
+        applied: steps.length,
+        note: say('figure.text.proposal-applied', { n: String(steps.length) })
+    });
+    const detail = target.offer({ steps, create, context: card.context, revision: card.revision });
+    if (detail.applied)
+        return accepted();
+    if (detail.applied === false)
+        return refused(detail.code, detail.error, say);
+    /* A revision belongs to the figure the model saw; with that modeller gone there is nowhere true to apply it. */
+    if (!create)
+        return { verdict: 'unavailable', errorCode: 'modeller-not-open', note: say('figure.text.proposal-needs-modeller') };
+    const opened = await target.openNew(steps);
+    if (opened.applied)
+        return accepted();
+    return opened.code === 'not-opened'
+        ? { verdict: 'unavailable', errorCode: 'not-opened', note: say('figure.text.proposal-not-opened') }
+        : refused(opened.code, opened.error, say);
+}
+/*
+  A new figure's proposal handed to the modeller page across a navigation: the handler leaves it here and opens the
+  modeller on a new figure; the page takes it once it has started that figure. Left untaken, it lapses -- a later new
+  figure must not receive steps nobody is waiting for.
+*/
+let pending;
+export function pendNewFigure(steps, ms = 10_000) {
+    pending?.settle({ applied: false, code: 'not-opened' });
+    return new Promise(resolve => {
+        const mine = {
+            steps,
+            settle: (result) => {
+                clearTimeout(timer);
+                if (pending === mine)
+                    pending = undefined;
+                resolve(result);
+            }
+        };
+        const timer = setTimeout(() => mine.settle({ applied: false, code: 'not-opened' }), ms);
+        pending = mine;
+    });
+}
+/** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
+export function takePendingNewFigure() {
+    const taken = pending;
+    pending = undefined;
+    return taken;
+}
+//# sourceMappingURL=ai-proposal.js.map

package/dist-client/modeller/ai-proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-proposal.js","sourceRoot":"","sources":["../../client/modeller/ai-proposal.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * An AI proposal reaching the modeller (ADR-0094). The dock's card carries the modeller's own commands; running it\n * applies them as one step of the modeller's history, undone whole, on the version the model saw. Nothing half made\n * is applied, and every outcome is said: applied, refused with the reason, or not possible here.\n *\n * Kept free of Lit, i18n and the shell so node tests read it directly; the handler and the page pass in what they own.\n */\nimport type { FigureProposalStep } from '@hatiolab/figure-model'\n\n/** What the card carries, as `proposeFigureCandidate` returned it. */\nexport interface FigureProposalCard {\n  steps?: FigureProposalStep[]\n  create?: boolean\n  figureId?: string\n  context?: string\n  revision?: number\n}\n\n/** The `figure-apply` event's detail. The page that takes it sets `applied`, and `error` when refused. */\nexport interface FigureApplyDetail {\n  steps: FigureProposalStep[]\n  create: boolean\n  context?: string\n  revision?: number\n  applied?: boolean\n  error?: string\n  code?: string\n}\n\nexport type Say = (key: string, params?: Record<string, string>) => string\n\nexport interface FigureProposalTarget {\n  /** Offers the proposal to a modeller on screen. It comes back untouched when none took it. */\n  offer(detail: FigureApplyDetail): FigureApplyDetail\n  /** Opens a new figure in the modeller and applies the steps there; resolves once the page has, or has not. */\n  openNew(steps: FigureProposalStep[]): Promise<{ applied: boolean; error?: string; code?: string }>\n}\n\nexport interface FigureProposalOutcome {\n  verdict: 'accepted' | 'refused' | 'unavailable'\n  errorCode?: string\n  applied?: number\n  note?: string\n}\n\n/** The workspace refuses a request made on another version; said as what happened, not as the kernel's code. */\nconst STALE = new Set(['REVISION_CONFLICT', 'CONTEXT_CONFLICT'])\n\nfunction refused(code: string | undefined, error: string | undefined, say: Say): FigureProposalOutcome {\n  const note =\n    code && STALE.has(code)\n      ? say('figure.text.proposal-stale')\n      : code === 'NEW_FIGURE_UNSAVED'\n        ? (error ?? '')\n        : say('figure.text.proposal-refused', { reason: error ?? '' })\n  return { verdict: 'refused', errorCode: code ?? 'refused', note }\n}\n\nexport async function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome> {\n  const steps = card?.steps\n  if (!Array.isArray(steps) || !steps.length) return { verdict: 'unavailable', errorCode: 'no-steps' }\n  const create = card.create === true\n  const accepted = (): FigureProposalOutcome => ({\n    verdict: 'accepted',\n    applied: steps.length,\n    note: say('figure.text.proposal-applied', { n: String(steps.length) })\n  })\n\n  const detail = target.offer({ steps, create, context: card.context, revision: card.revision })\n  if (detail.applied) return accepted()\n  if (detail.applied === false) return refused(detail.code, detail.error, say)\n\n  /* A revision belongs to the figure the model saw; with that modeller gone there is nowhere true to apply it. */\n  if (!create) return { verdict: 'unavailable', errorCode: 'modeller-not-open', note: say('figure.text.proposal-needs-modeller') }\n\n  const opened = await target.openNew(steps)\n  if (opened.applied) return accepted()\n  return opened.code === 'not-opened'\n    ? { verdict: 'unavailable', errorCode: 'not-opened', note: say('figure.text.proposal-not-opened') }\n    : refused(opened.code, opened.error, say)\n}\n\n/*\n  A new figure's proposal handed to the modeller page across a navigation: the handler leaves it here and opens the\n  modeller on a new figure; the page takes it once it has started that figure. Left untaken, it lapses -- a later new\n  figure must not receive steps nobody is waiting for.\n*/\nlet pending: { steps: FigureProposalStep[]; settle: (result: { applied: boolean; error?: string; code?: string }) => void } | undefined\n\nexport function pendNewFigure(steps: FigureProposalStep[], ms = 10_000): Promise<{ applied: boolean; error?: string; code?: string }> {\n  pending?.settle({ applied: false, code: 'not-opened' })\n  return new Promise(resolve => {\n    const mine = {\n      steps,\n      settle: (result: { applied: boolean; error?: string; code?: string }) => {\n        clearTimeout(timer)\n        if (pending === mine) pending = undefined\n        resolve(result)\n      }\n    }\n    const timer = setTimeout(() => mine.settle({ applied: false, code: 'not-opened' }), ms)\n    pending = mine\n  })\n}\n\n/** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */\nexport function takePendingNewFigure(): { steps: FigureProposalStep[]; settle: (result: { applied: boolean; error?: string; code?: string }) => void } | undefined {\n  const taken = pending\n  pending = undefined\n  return taken\n}\n"]}

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

@@ -0,0 +1,30 @@
+import type { FigureAsset, FigureInputChange, FigureWorldBox } from '@hatiolab/figure-model';
+import type { GizmoReach } from './gizmo.js';
+/**
+ * 맞추기 — the align tools on a part: centre on X, centre on Z, stand on the floor,
+ * mirror on X or Z, snap to the grid.
+ *
+ * The asset's frame has the floor at y 0 and X and Z centred on 0, so centring puts the part's box centre on 0 and the floor puts its lowest point on
+ * y 0. The part's box is its evaluated, rotated extent (`figureOccupiedBoxesOf`), so a turned part lands by what it
+ * actually covers, not by its unturned size.
+ *
+ * Every tool writes the part's own position (and, for snap, size) inputs — the same ones the gizmo writes, and only
+ * where the gizmo could (`GizmoReach`).
+ */
+export type AlignTool = 'centre-x' | 'centre-z' | 'floor' | 'snap';
+export declare function boxOf(asset: FigureAsset, part: string): FigureWorldBox | undefined;
+/** The snapping grid: about five steps across the figure, on 1 · 2 · 5 multiples. */
+export declare function gridStepOf(asset: FigureAsset): number;
+export declare function alignChanges(asset: FigureAsset, part: string, reach: GizmoReach, tool: AlignTool): FigureInputChange[];
+/**
+ * Where a mirrored copy goes: the same distance on the other side of the centre plane. The copy is made by
+ * `duplicate-part` first; this is the position the copy is then given.
+ */
+export declare function mirrorChanges(asset: FigureAsset, part: string, copy: string, axis: 'x' | 'z'): FigureInputChange[];
+/** Mirroring a part that already sits on the centre plane would put the copy inside it, so it is refused. */
+export declare function canMirror(asset: FigureAsset, part: string, axis: 'x' | 'z', reach: GizmoReach): boolean;
+/**
+ * A **readable** grid step for a length: about five cells, rounded up to a 1, 2 or 5 multiple as rulers and charts do.
+ * Divided plainly it gives 27 or 33, and coordinates snapped to that read as 54 and 81. Never 0.
+ */
+export declare function niceStep(span: number): number;

package/dist-client/modeller/align.js

@@ -0,0 +1,75 @@
+import { compileFigureAsset, figureOccupiedBoxesOf, figureWritersOf } from '@hatiolab/figure-model';
+const AXES = ['x', 'y', 'z'];
+export function boxOf(asset, part) {
+    const geometry = compileFigureAsset(asset).evaluate().geometry;
+    return figureOccupiedBoxesOf(geometry, figureWritersOf(asset)).find(box => box.part === part);
+}
+/** The snapping grid: about five steps across the figure, on 1 · 2 · 5 multiples. */
+export function gridStepOf(asset) {
+    const geometry = compileFigureAsset(asset).evaluate().geometry;
+    const boxes = figureOccupiedBoxesOf(geometry, figureWritersOf(asset));
+    if (!boxes.length)
+        return 1;
+    const span = Math.max(...AXES.map(axis => {
+        const lo = Math.min(...boxes.map(b => b.centre[axis] - b.extent[axis] / 2));
+        const hi = Math.max(...boxes.map(b => b.centre[axis] + b.extent[axis] / 2));
+        return hi - lo;
+    }));
+    return niceStep(span);
+}
+export function alignChanges(asset, part, reach, tool) {
+    if (!reach.translate)
+        return [];
+    const box = boxOf(asset, part);
+    if (!box)
+        return [];
+    const value = (id) => asset.designInputs[id] ?? 0;
+    const set = (input, next) => ({ kind: 'set-design', input, unit: 'mm', value: Math.round(next) });
+    const at = (axis) => `${part}.position.${axis}`;
+    switch (tool) {
+        case 'centre-x':
+            return [set(at('x'), value(at('x')) - box.centre.x)];
+        case 'centre-z':
+            return [set(at('z'), value(at('z')) - box.centre.z)];
+        case 'floor':
+            return [set(at('y'), value(at('y')) - (box.centre.y - box.extent.y / 2))];
+        case 'snap': {
+            const step = gridStepOf(asset);
+            const round = (n) => Math.round(n / step) * step;
+            const changes = AXES.map(axis => set(at(axis), round(value(at(axis)))));
+            /* A size never snaps to 0 — the part would look gone. */
+            if (reach.scale && reach.sizes)
+                for (const id of reach.sizes)
+                    changes.push(set(id, Math.max(step, round(value(id)))));
+            return changes;
+        }
+    }
+}
+/**
+ * Where a mirrored copy goes: the same distance on the other side of the centre plane. The copy is made by
+ * `duplicate-part` first; this is the position the copy is then given.
+ */
+export function mirrorChanges(asset, part, copy, axis) {
+    const box = boxOf(asset, part);
+    if (!box)
+        return [];
+    const id = `${part}.position.${axis}`;
+    return [{ kind: 'set-design', input: `${copy}.position.${axis}`, unit: 'mm', value: Math.round((asset.designInputs[id] ?? 0) - 2 * box.centre[axis]) }];
+}
+/** Mirroring a part that already sits on the centre plane would put the copy inside it, so it is refused. */
+export function canMirror(asset, part, axis, reach) {
+    const box = reach.translate ? boxOf(asset, part) : undefined;
+    return !!box && Math.abs(box.centre[axis]) >= 0.5;
+}
+/**
+ * A **readable** grid step for a length: about five cells, rounded up to a 1, 2 or 5 multiple as rulers and charts do.
+ * Divided plainly it gives 27 or 33, and coordinates snapped to that read as 54 and 81. Never 0.
+ */
+export function niceStep(span) {
+    const raw = Math.max(span, 1) / 5;
+    const magnitude = Math.pow(10, Math.floor(Math.log10(raw)));
+    const n = raw / magnitude;
+    const multiple = n < 1.5 ? 1 : n < 3.5 ? 2 : n < 7.5 ? 5 : 10;
+    return Math.max(1, multiple * magnitude);
+}
+//# sourceMappingURL=align.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"align.js","sourceRoot":"","sources":["../../client/modeller/align.ts"],"names":[],"mappings":"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","sourcesContent":["import { compileFigureAsset, figureOccupiedBoxesOf, figureWritersOf } from '@hatiolab/figure-model'\nimport type { FigureAsset, FigureInputChange, FigureWorldBox } from '@hatiolab/figure-model'\n\nimport type { GizmoReach } from './gizmo.js'\n\n/**\n * 맞추기 — the align tools on a part: centre on X, centre on Z, stand on the floor,\n * mirror on X or Z, snap to the grid.\n *\n * The asset's frame has the floor at y 0 and X and Z centred on 0, so centring puts the part's box centre on 0 and the floor puts its lowest point on\n * y 0. The part's box is its evaluated, rotated extent (`figureOccupiedBoxesOf`), so a turned part lands by what it\n * actually covers, not by its unturned size.\n *\n * Every tool writes the part's own position (and, for snap, size) inputs — the same ones the gizmo writes, and only\n * where the gizmo could (`GizmoReach`).\n */\nexport type AlignTool = 'centre-x' | 'centre-z' | 'floor' | 'snap'\n\nconst AXES = ['x', 'y', 'z'] as const\n\nexport function boxOf(asset: FigureAsset, part: string): FigureWorldBox | undefined {\n  const geometry = compileFigureAsset(asset).evaluate().geometry\n  return figureOccupiedBoxesOf(geometry, figureWritersOf(asset)).find(box => box.part === part)\n}\n\n/** The snapping grid: about five steps across the figure, on 1 · 2 · 5 multiples. */\nexport function gridStepOf(asset: FigureAsset): number {\n  const geometry = compileFigureAsset(asset).evaluate().geometry\n  const boxes = figureOccupiedBoxesOf(geometry, figureWritersOf(asset))\n  if (!boxes.length) return 1\n  const span = Math.max(\n    ...AXES.map(axis => {\n      const lo = Math.min(...boxes.map(b => b.centre[axis] - b.extent[axis] / 2))\n      const hi = Math.max(...boxes.map(b => b.centre[axis] + b.extent[axis] / 2))\n      return hi - lo\n    })\n  )\n  return niceStep(span)\n}\n\nexport function alignChanges(asset: FigureAsset, part: string, reach: GizmoReach, tool: AlignTool): FigureInputChange[] {\n  if (!reach.translate) return []\n  const box = boxOf(asset, part)\n  if (!box) return []\n  const value = (id: string) => asset.designInputs[id] ?? 0\n  const set = (input: string, next: number): FigureInputChange => ({ kind: 'set-design', input, unit: 'mm', value: Math.round(next) })\n  const at = (axis: 'x' | 'y' | 'z') => `${part}.position.${axis}`\n  switch (tool) {\n    case 'centre-x':\n      return [set(at('x'), value(at('x')) - box.centre.x)]\n    case 'centre-z':\n      return [set(at('z'), value(at('z')) - box.centre.z)]\n    case 'floor':\n      return [set(at('y'), value(at('y')) - (box.centre.y - box.extent.y / 2))]\n    case 'snap': {\n      const step = gridStepOf(asset)\n      const round = (n: number) => Math.round(n / step) * step\n      const changes = AXES.map(axis => set(at(axis), round(value(at(axis)))))\n      /* A size never snaps to 0 — the part would look gone. */\n      if (reach.scale && reach.sizes)\n        for (const id of reach.sizes) changes.push(set(id, Math.max(step, round(value(id)))))\n      return changes\n    }\n  }\n}\n\n/**\n * Where a mirrored copy goes: the same distance on the other side of the centre plane. The copy is made by\n * `duplicate-part` first; this is the position the copy is then given.\n */\nexport function mirrorChanges(asset: FigureAsset, part: string, copy: string, axis: 'x' | 'z'): FigureInputChange[] {\n  const box = boxOf(asset, part)\n  if (!box) return []\n  const id = `${part}.position.${axis}`\n  return [{ kind: 'set-design', input: `${copy}.position.${axis}`, unit: 'mm', value: Math.round((asset.designInputs[id] ?? 0) - 2 * box.centre[axis]) }]\n}\n\n/** Mirroring a part that already sits on the centre plane would put the copy inside it, so it is refused. */\nexport function canMirror(asset: FigureAsset, part: string, axis: 'x' | 'z', reach: GizmoReach): boolean {\n  const box = reach.translate ? boxOf(asset, part) : undefined\n  return !!box && Math.abs(box.centre[axis]) >= 0.5\n}\n\n/**\n * A **readable** grid step for a length: about five cells, rounded up to a 1, 2 or 5 multiple as rulers and charts do.\n * Divided plainly it gives 27 or 33, and coordinates snapped to that read as 54 and 81. Never 0.\n */\nexport function niceStep(span: number): number {\n  const raw = Math.max(span, 1) / 5\n  const magnitude = Math.pow(10, Math.floor(Math.log10(raw)))\n  const n = raw / magnitude\n  const multiple = n < 1.5 ? 1 : n < 3.5 ? 2 : n < 7.5 ? 5 : 10\n  return Math.max(1, multiple * magnitude)\n}\n"]}

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

@@ -0,0 +1,72 @@
+import { LitElement, type PropertyValues } from 'lit';
+import type { GizmoReach } from './gizmo.js';
+import type { FigureRenderPart } from './renderer.js';
+import { type ViewSettings } from './figure-view.js';
+export declare class FigureCanvas extends LitElement {
+    static styles: import("lit").CSSResult;
+    parts: FigureRenderPart[];
+    palette: Record<string, string>;
+    /** Which figure is open. Another one stands the board up again. */
+    context: string;
+    selected: string;
+    /** What the gizmo may write for the selected part; a change beyond it is not applied and the part springs back. */
+    reach: GizmoReach;
+    view: ViewSettings;
+    /**
+     * View only: nothing that happens on the board is told out. The card's picture is taken from a second canvas stood up
+     * off screen (`thumbnail.ts`); the scene settles its components as it builds them, and a change told from there
+     * would reach the editor as an edit.
+     */
+    viewOnly: boolean;
+    /** Where the selected part turns and how far (`joint-fan`): shown, never picked, never saved. */
+    fan: FigureRenderPart | null;
+    private stage;
+    private scene?;
+    private board?;
+    private standingFor?;
+    private watcher?;
+    /** Set while this canvas writes to components, so the scene's echo of it is not taken for a drag. */
+    private writing;
+    render(): import("lit-html").TemplateResult<1>;
+    firstUpdated(): void;
+    protected updated(changed: PropertyValues): void;
+    disconnectedCallback(): void;
+    /**
+     * The board as a picture, for the card: the 3D view at this size, or nothing when it cannot be taken. The scene's
+     * `toDataURL` renders the 2D board (a white sheet), and the 3D renderer keeps no drawing buffer, so the
+     * scene's own `snapshot3d` draws and reads in one task. A picture that cannot be taken is not an error and is not
+     * faked (user, 2026-09-24: no card had a picture after this canvas moved onto the scene).
+     */
+    snapshot(width?: number, height?: number): Promise<string | undefined>;
+    /** The whole figure in view: the board's fit, then the 3D camera's own. */
+    fit(): void;
+    /** The gizmo in a mode on the selected part, as W, E and R do with the canvas focused -- the scene's toggle. */
+    gizmo(mode: 'translate' | 'rotate' | 'scale'): void;
+    /**
+     * Stand the board up for this figure, or bring the one standing up to date. A new board only for another figure or
+     * one that has outgrown it -- standing up again loses the selection and the camera.
+     */
+    private standUp;
+    private components;
+    /** The components standing now, by name. Not held between calls: the scene stands its board up again at times. */
+    private standing;
+    /** A larger board under the same scene: its size, and the grid that suits it. Components are re-placed by `sync`. */
+    private grow;
+    /** Bring the components to the evaluation: remove the gone, write only what differs, add the new. */
+    private sync;
+    /** Selection and drags, told out by the part's name -- never by its place in the list, which may change meanwhile. */
+    private watchScene;
+    /** Components the gizmo changed since the last commit, by part name. */
+    private pending;
+    private pointerDown;
+    private commitTimer?;
+    private onPointerDown;
+    private onPointerUp;
+    private commitSoon;
+    /** Tell each changed part once, in the inputs' terms; then put the board where the inputs say (a refusal springs back). */
+    private commit;
+    private showSelected;
+    /** View settings go into the scene as they are: they are the board's own state names. Nothing is stood up again. */
+    private applyView;
+    private teardown;
+}