@things-factory/figure-ui 10.1.74 → 10.1.76

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

@@ -0,0 +1,203 @@
+import { LitElement, type PropertyValues } from 'lit';
+import '@operato/layout';
+import type { RecipeTemplate } from './recipes.js';
+import './figure-recipe-catalog.js';
+import type { FigureProductSession } from './product-session.js';
+import './canvas.js';
+import './figure-parts.js';
+import './figure-material-panel.js';
+import './figure-links.js';
+import './figure-controls.js';
+import './figure-clips.js';
+import './figure-preview.js';
+import './figure-settings.js';
+import './figure-capability-panel.js';
+import type { FigureBudgetLine } from './maturity.js';
+import type { FirstSave } from './first-save.js';
+/** Product editor surface. The injected session is shared by page persistence and AI commands. */
+export declare class FigureEditor extends LitElement {
+    static styles: import("lit").CSSResult[];
+    session?: FigureProductSession;
+    /** The recipe templates (ADR-0095), read by the page from the server. */
+    templates: RecipeTemplate[];
+    /** Reads a template's guide; given by the page. */
+    guideOf?: (name: string) => Promise<string>;
+    thumbnailOf?: (name: string) => string;
+    /** The 「보드에서 바꿀 수 있음」 form being filled for a row, before it is published (ADR-0096). */
+    private publishing?;
+    private catalogOpen;
+    /** Why the last recipe was refused, in the kernel's words. */
+    private recipeError;
+    revision: number;
+    /** The verdict's count, drawn on its tab so it stays in sight while another tab is open. */
+    instances?: number;
+    /** The cost line the parts list shows, from the maturity report. */
+    budget?: FigureBudgetLine;
+    /**
+     * Asks the type and name of a figure saved for the first time (the host has the catalogue's names); undefined
+     * when the author cancels, and then nothing is saved. Without it a new figure is saved under a temporary type.
+     */
+    firstSave?: (name: string) => Promise<FirstSave | undefined>;
+    private selected;
+    private error;
+    /** The same link offered again with the size range narrowed, after a link the declared range could not hold. */
+    private retry?;
+    private tab;
+    /** The frame the bar folds - found after the first render, since the bar is drawn before it. */
+    private panes?;
+    /** What the middle shows: the parts being edited, or the figure placed on a board at eight sizes. */
+    private middle;
+    /** The gizmo shown on the selected part, as the tools in the bar and W · E · R choose it; none once the part changes. */
+    private gizmoMode?;
+    /** A line saying what a command did besides what was asked; gone at the next command. */
+    private notice;
+    /**
+     * How the workbench shows the figure, in the board's own state names. The viewer's, kept in
+     * their browser, never in the figure.
+     */
+    private view;
+    private static storedView;
+    private setView;
+    /**
+     * Parts hidden on the workbench — the author's view while working, not the asset's visibility. Not saved: a part
+     * hidden here is still in the figure, still checked, still drawn on a board.
+     */
+    private hiddenParts;
+    /** A value in hand -- typed, held on a spinner, scrubbed, dragged -- drawn at once and recorded on release. */
+    private live;
+    private lastContext;
+    /**
+     * Move, turn and size on the canvas, in the bar's tools: the gizmo the W · E · R keys give, found without knowing the
+     * keys (2026-09-26 -- a person dragging the part turned the camera). Each is offered only where the part's own
+     * numbers can take it (`gizmoReachOf`).
+     */
+    private renderGizmoTools;
+    /** The modeller's keys (`keys.ts`): undo, redo, duplicate, remove, back to the whole figure, the gizmo's modes. */
+    private onKey;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(_changed: PropertyValues): void;
+    /** The scene toggles: the mode already shown takes the gizmo away. */
+    private useGizmo;
+    /**
+     * A refusal no particular sentence knows: figure-model's code said as a refusal, never its English; any other error
+     * (the network, the server) as it came.
+     */
+    private said;
+    private run;
+    /** What the canvas draws: the figure with the value in hand when there is one, and without the parts hidden on the workbench. */
+    private drawnParts;
+    /**
+     * Where the selected part turns and how far, with the pose as it is drawn now -- a value in hand included, so the
+     * fan follows the arm while a control is dragged. Its size comes from what the joint turns (`joint-fan`).
+     */
+    private fanOf;
+    /**
+     * Every input as the session holds it now -- the pose the author has set with the controls, and design values. The
+     * asset's source carries only the saved defaults, so drawing a value in hand over it put every other joint back to its
+     * saved angle while one slider moved, and the arm jumped when released (user, 2026-09-24).
+     */
+    private currentInputs;
+    /** A value in hand: an input's value (design or pose) or a part edit. Nothing is recorded. */
+    private hold;
+    private changed;
+    private save;
+    private add;
+    /**
+     * The list's own operations, as part edits — each one step of the session's history. The copy and the moved
+     * part stay selected.
+     */
+    private duplicatePart;
+    private movePart;
+    private removePart;
+    private toggleHiddenPart;
+    /** Whether the figure declares its size (the three size inputs). */
+    private hasSize;
+    /**
+     * A recipe put in (ADR-0095): resolved on the figure as it stands -- its parts take the next free name, onto the part
+     * chosen -- and applied as one step. Refused, the kernel's sentence goes to the form as it is (condition 3).
+     */
+    private insertRecipe;
+    /** The design values of the asset being edited. */
+    private designValues;
+    /** What the gizmo may write for the selected part — read off the asset being edited. */
+    private reachOf;
+    /** A drag, written back as the part's own inputs — one step of the history, like typing the numbers. */
+    private transformed;
+    /** 맞추기 — one tool, one step of the history, through the same inputs as the gizmo. */
+    private align;
+    /** A mirrored copy: duplicate, then place the copy on the other side — two steps. */
+    private mirror;
+    private renderTools;
+    /**
+     * A part's name. It renames every value the part owns, and what refers to them follows
+     * (figure-model's rename-part), as one step of the history.
+     */
+    /**
+     * A repeated body is one of its repeat's copies and is named after it -- the list and this field read `roller 15`, not
+     * its path through the repeat (user, 2026-09-24: 「부품 이름 ???」). A copy has no name of its own to change.
+     */
+    private renderRepeatNote;
+    private renamePart;
+    /** Size response, fastening and motion for the selected part, as authoring commands. */
+    private renderLinks;
+    /** The figure's controls: try a value, name it, set its range and travel time, keep the pose. */
+    private renderControls;
+    /** One command, one step of the history. A refusal a person can meet here is said in their words. */
+    private linkCommand;
+    private changeField;
+    /** Typing or a held spinner: each number on the way is drawn; the field's change records it. */
+    private typing;
+    /**
+     * Drag a field's label (or an axis letter) sideways to scrub its value, as vector tools do: the figure follows the
+     * pointer, and the release records one step. The field's number follows too, so the value in hand is always read.
+     */
+    private scrub;
+    /** The measured range, kept for the revision it was measured at: measuring evaluates the figure at its edges. */
+    private range?;
+    /** The sizes a board may give the figure, and the way to measure them again after its parts changed. */
+    private renderInstanceRange;
+    /**
+     * How the figure grows. One ratio (`sizing: 'uniform'`) is said as it is; a figure with joints that has not declared
+     * it is offered it -- a mechanism does not shear -- and the author decides (chief architect's ruling 2026-09-24).
+     */
+    private renderSizingRule;
+    /**
+     * The parts list, one row per part the author made: a repeat is one row with how many copies it makes now
+     * (user, 2026-09-24: the conveyor's sixteen rollers were sixteen rows).
+     */
+    private partRows;
+    /** The detail level's part budget for the list's head, from figure-model's count (a repeat once). */
+    private partBudgetOf;
+    /**
+     * A repeat: which way its copies run, how many there are now, and how far apart.
+     * The pitch of a row that fills its length is edited as a number (`set-repeat` makes it the part's own the first
+     * time); a row of a fixed count says its pitch cannot be set yet (figure-model refuses it the same way).
+     */
+    private renderRepeat;
+    /** The design input a row's pitch is read from, when it is read from one (ADR-0096). */
+    private pitchInputOf;
+    /**
+     * 「보드에서 바꿀 수 있음」 (ADR-0096): the row's pitch made a design input the figure publishes -- a name on the board and
+     * a range the board's value is held to -- in one step; changed or withdrawn the same way. Only a row with a record.
+     */
+    private renderPublicPitch;
+    /**
+     * A pitch always goes through `set-repeat`: the command moves the longest length with it (at most `limit` copies),
+     * which a plain input edit would not. Refused only when the authored length would already hold more copies than
+     * that -- said with the numbers.
+     */
+    private setPitch;
+    /** Choose a part, from the list, the canvas or a place row. A figure-level tab gives way to the part's properties. */
+    private choose;
+    private asset;
+    private renderTab;
+    updated(changed: PropertyValues<this>): void;
+    /** Which part the panel speaks of, with the way back to the whole figure. */
+    private renderSubject;
+    render(): import("lit-html").TemplateResult<1>;
+    /** Position, rotation and size as rows of three cells; the shape's own measures one to a line, under their title. */
+    private renderGroups;
+    private renderVector;
+    private renderSingle;
+}