@things-factory/figure-ui 10.1.44 → 10.1.45

package/dist-client/pages/figure-modeller-page.d.ts

@@ -1,419 +0,0 @@
-import '@material/web/icon/icon.js';
-import '../modeller/figure-side.js';
-import '../modeller/figure-canvas.js';
-import '../modeller/figure-preview.js';
-import '../modeller/figure-parts.js';
-import '../modeller/figure-inspector.js';
-import { PageView } from '@operato/shell';
-declare const FigureModellerPageBase: typeof PageView;
-export declare class FigureModellerPage extends FigureModellerPageBase {
-    static styles: import("lit").CSSResult;
-    /** 편집 중인 Figure. 새로 만드는 중이면 `id` 가 없다. */
-    private figure?;
-    /** 편집 데이터 — 미리보기에 그대로 세워지는 씬 모델이다. */
-    private draft?;
-    private parts;
-    private selected;
-    private view;
-    /**
-     * 가운데 칸이 무엇을 보이나.
-     *
-     * 편집 캔버스는 늘 기준 크기다. 그런데 이 형식의 값 절반은 크기가 달라졌을 때 어떻게
-     * 반응하는가에 있다. 그것을 볼 자리가 없었다.
-     */
-    private mode;
-    /**
-     * 어느 칸이 접혀 있나.
-     *
-     * 통째로 갈아 끼운다 — 안쪽 값만 바꾸면 Lit 이 같은 객체로 보고 다시 그리지 않는다.
-     */
-    private collapsed;
-    private dirty;
-    private saving;
-    private violations;
-    /**
-     * 저장이 왜 안 됐나.
-     *
-     * **`save()` 에 `catch` 가 없었다.** `try … finally` 뿐이라 서버가 거절하면(형식 위반 · 타입 이름
-     * 중복 · 권한 없음 · 네트워크) 단추만 멈추고 화면은 **아무 말도 하지 않았다.** 저작자는 눌렀는데
-     * 아무 일도 안 난 것으로 보고, 저장됐는지 아닌지도 알 수 없었다.
-     *
-     * 미저장 표시(`dirty`)는 그대로 남으므로 데이터를 잃지는 않았다. 잃은 것은 **사유**다.
-     */
-    private saveFailure;
-    private sourceLoadFailure;
-    private showSaveModal;
-    private saveModalType;
-    private saveModalName;
-    private saveModalError;
-    /** 저작 보조 또는 발행 게이트가 연 후보 검토 세션. 받기 전에는 정본이 아니다. */
-    private proposalSession?;
-    /** 인라인 요청창과 AI 도크가 함께 쓰는 현재 Figure의 제한된 세션 피드백. */
-    private proposalFeedback;
-    private undoStack;
-    private redoStack;
-    private sceneRevision;
-    private lastCoalesceKey?;
-    private lastHistoryTime;
-    /**
-     * 저장 형식으로 변환한 것. 씬 모델이 바뀔 때만 다시 만든다.
-     *
-     * 저장·판단·AI 후보 비교가 이것을 쓴다. 렌더링할 때마다 새로 만들면 판단 패널이 매번
-     * 다시 계산하므로, 변환은 `willUpdate` 에서 한 번만 한다.
-     */
-    private folded?;
-    /**
-     * 직전 발행판의 정본. 한 번도 발행 안 한 도형에는 없다.
-     *
-     * 발행된 도형을 고치는 동안 「이 고침이 이미 놓인 것을 깨나」를 견주려면 이것이 있어야 한다.
-     * 저장 전 초안은 서버가 모르므로 판정도 여기서 한다 — 형식의 같은 함수를 쓴다(ADR-0063 결정 3).
-     */
-    private releasedSource?;
-    /** 지금 고친 것이 놓인 것에 무엇을 하나. 발행 전에는 비어 있다. */
-    private contract;
-    /** 견주지 못한 까닭. **비어 있는 목록과 다르다** — 「깨지 않는다」가 아니라 「모른다」다. */
-    private contractFailure?;
-    willUpdate(changed: Map<string, unknown>): void;
-    /**
-     * 고치는 중의 정본은 **잠깐 형식을 못 지날 수 있다** — 부품 이름을 지웠다가 다시 적는 사이가
-     * 그렇다. 그때 견주기가 던지면 화면이 통째로 멈추므로 목록은 비운다.
-     *
-     * **빈 목록을 「깨지 않는다」로 보이게 두지 않는다.** 까닭을 함께 들고 있다가 화면이 「확인하지
-     * 못했다」로 말한다. 조용히 비우면 저작자는 안전하다고 읽는다 — 실제로 그런 일이 났다: 앱에
-     * 든 형식이 옛 판이라 견주는 함수 자체가 없었는데, 화면은 아무 말도 안 하고 조용했다.
-     */
-    private compareWithReleased;
-    /**
-     * 페이지 밖 AI 도크에도 **지금 손에 든 정본**을 알려 준다.
-     *
-     * asidebar 도크는 주소의 id만
-     * 알았으므로 DB에 저장된 옛 판을 읽었다. 저장 전 변경을 두고 "왜 발행이 안 되나" 또는
-     * "이 부품을 줄여 달라"고 물으면 대화가 엉뚱한 판을 보게 되는 결함이었다.
-     *
-     * 이 이벤트는 저장하지 않는다. 도크가 대화 인자로만 잠시 들고 있고, 서버 도구도 도메인 소속
-     * Figure를 먼저 확인한 뒤에만 이 source를 사용한다. 페이지를 떠날 때는 아래에서 지워 오래된
-     * 초안이 다음 Figure에 섞이지 않게 한다.
-     */
-    updated(changed: Map<string, unknown>): void;
-    private announceAiContext;
-    private receiveDockProposal;
-    private onFigureAiStage;
-    /**
-     * A candidate from the dock opens the review lane. It does not become the draft.
-     *
-     * This used to write `draft` and `parts` straight onto the working draft and then set
-     * `proposalSession = undefined` — the dock's candidate overwrote what the author had open and
-     * erased the lane built to review it. There was no moment where the person said yes, and a
-     * draft has no version history to go back to, so the previous work was simply gone.
-     *
-     * `ai-client-base`'s analysis contract states this as a literal type: `approvalRequired: true`,
-     * and of `proposal`, "It is never an instruction to mutate canonical state." The in-page
-     * The in-page entrance honoured this through `openAiProposal` before it was removed, and the dock
-     * entrance is now the same door. Applying is what the take button does, from the lane, per change.
-     *
-     * ## Why the overwrite was there — so it does not come back
-     *
-     * The dock opened the review lane originally. Before `c42a0b63df` this handler read:
-     *
-     *     if (!this.active || (detail?.figureId ?? '') !== (this.figure?.id ?? '')) return
-     *     if (detail?.draftType && detail.draftType !== this.folded?.type) return
-     *     if (detail?.baseSource && detail.baseSource !== JSON.stringify(this.folded)) return
-     *     this.receive(detail.proposal)
-     *
-     * Three guards, each a silent `return`, and the last compared a serialized source byte for byte.
-     * Any difference that changed nothing at all dropped the candidate with no message, so the dock
-     * would report a candidate and the screen would show none.
-     *
-     * The `ox-assistant-chat` migration fixed that by replacing the path rather than the guards, and
-     * the review lane went out with them — `applySourceDirectly` wrote straight to the draft, and
-     * cleared `proposalSession` on the way past. **Nobody decided that reviews were unwanted here.**
-     * It was the cost of loosening a guard by deleting what stood around it.
-     *
-     * So the guards are gone and stay gone, and the lane is back. If a candidate ever seems not to
-     * arrive, the thing to look for is a silent `return` on this path — not the lane.
-     *
-     * Returns whether the lane opened, so the dock can tell the chat whether to say it staged.
-     */
-    private openProposalForReview;
-    private proposalBaseSource?;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    private onSaveRequest;
-    private handleKeyDown;
-    get context(): {
-        title: string;
-        heading: boolean;
-    };
-    render(): import("lit-html").TemplateResult<1>;
-    /**
-     * 가운데 칸 위의 띠 — 무엇을 보고 있나와, 양쪽 칸을 접는 손잡이.
-     *
-     * ## 무엇을 보고 있나
-     *
-     * 편집과 미리보기는 같은 자리를 놓고 다투지 않는다. 둘 다 넓이가 필요하고, 동시에
-     * 봐야 할 일이 없다. 부품을 고치는 동안에는 편집만 보면 되고, 다 고친 뒤에 도면에서
-     * 어떻게 되는지 보면 된다.
-     *
-     * 후보가 와 있을 때는 그 두 단추를 내지 않는다. 그때는 가운데가 이미 둘로 나뉘어
-     * 있다.
-     *
-     * ## 띠는 늘 있다
-     *
-     * 손잡이가 여기 있기 때문이다. 후보가 왔다고 띠를 통째로 감추면, 칸을 접어 둔 채로
-     * 후보를 받으면 되돌릴 방법이 없어진다.
-     */
-    private renderBar;
-    /**
-     * 한쪽 칸을 접고 펴는 손잡이.
-     *
-     * 화살표는 **누르면 무엇이 일어나는지**를 가리킨다 — 펴져 있으면 칸이 사라질 쪽,
-     * 접혀 있으면 칸이 돌아올 쪽. 지금 상태를 가리키게 하면 반대로 읽힌다.
-     */
-    private renderCollapse;
-    private toggleCollapse;
-    /**
-     * AI 후보를 실제 배치 크기에서도 본다.
-     *
-     * 편집 캔버스 한 장으로는 `repeat`·`fixed`·`anchor`가 맞는지 알 수 없다. 후보는 아직
-     * 정본이 아니므로 저장하지 않고, `figure-preview`가 같은 FigureSource를 기준 크기와
-     * 일곱 가지 확장 축에서 실제 FigureInstance로 세운다. 따라서 저작자는 "좋아 보이는
-     * 한 장"이 아니라 배치될 때도 붙어 있는지를 보고 수락한다.
-     */
-    private renderProposed;
-    /**
-     * 무엇을 받을지 고른다.
-     *
-     * 통째로만 받게 두면 「몸통은 좋은데 모터 자리가 틀렸다」에 답할 수 없다 — 그게
-     * 가장 흔한 반응이다. 변경 하나가 칩 하나이고, 처음에는 전부 골라 둔다. 통째로
-     * 받는 것이 보통의 길이므로 그것이 한 번 누르기여야 한다.
-     *
-     * 고른 조합을 **받기 전에 재 본다.** 형식을 어기면 못 누르게 하고, 정책을 넘으면
-     * 알린다. 골라 받으면 후보를 낼 때와 다른 조합이 되므로 후보의 점수를 그대로
-     * 믿을 수 없다 — 예를 들어 등급은 안 받고 부품만 받으면 부품 수 한도를 넘는다.
-     *
-     * 형식 오류가 실제로 나는 조합은 아직 보지 못했다. 그래도 두는 것은 값이 거의
-     * 안 들고, 우리가 생각 못 한 조합을 막아 주기 때문이다.
-     */
-    private renderDecision;
-    /** 후보 품질 판단의 근거를 수락 전에 전부 보여 준다. */
-    private renderQualityReview;
-    /** 변경 하나. 무엇을 하겠다는 것인지 부호로 먼저 말한다. */
-    private renderChange;
-    private toggle;
-    /**
-     * 후보가 왔다.
-     *
-     * 원본 데이터에 넣지 않는다. 나란히 두고 저작자가 고른다. AI 가 원본 데이터에 직접 쓰면
-     * 무엇이 자기 것이고 무엇이 기계 것인지 모르게 된다.
-     */
-    private receive;
-    /**
-     * 발행 게이트의 구조화된 수정안 하나를 현재 작업 사본에만 겹쳐 본다. 서버가 준 값은
-     * `part.anchor.axis = to`라는 데이터이지 사람이 읽을 문장을 다시 해석한 결과가 아니다.
-     * 원본 `draft`/`parts`는 여기서 전혀 바꾸지 않고, 아래의 `take()`만 바꾼 사본을 적용한다.
-     */
-    private previewSizingFix;
-    /**
-     * 원클릭 적용은 서버가 모든 크기 변경 case를 재검사해 안전하다고 표시한 한-앵커 후보에만 연다.
-     * 그래도 저장은 저작자의 별도 행위다. 잘못 눌러도 DB 정본이나 발행판은 바뀌지 않는다.
-     */
-    private applySizingFix;
-    /**
-     * The release gate may need several anchors to keep a connected assembly together. It has already
-     * measured the complete set. Apply it directly to this unsaved work copy instead of making the
-     * author accept a sequence of opaque mini-proposals.
-     */
-    private applySizingFixPlan;
-    /**
-     * 고른 변경을 받아들인다.
-     *
-     * 후보 비교는 저장 형식으로 한다 — 부품 이름으로 짝짓고 기준 치수·등급까지 함께 봐야
-     * 하므로 그쪽이 자연스럽다. 받아들인 결과는 다시 씬 모델로 되돌려 편집을 이어간다.
-     */
-    private take;
-    /**
-     * 후보에 대한 사람의 결정을 도크에만 알린다.
-     *
-     * 이 기록은 분석 이벤트나 Figure 속성이 아니다. 같은 모델러 세션에서 다음 요청을 더 잘
-     * 이해시키는 짧은 신호일 뿐이다. 원본 source나 사람의 작업 내용을 다시 보내지 않고, 사람이
-     * 후보 변경 중 몇 개를 받아들였는지와 이미 화면에 보였던 품질 판정만 보낸다.
-     */
-    private reportProposalFeedback;
-    private discard;
-    /**
-     * 저장할 수 있나.
-     *
-     * 형식을 어긴 원본 데이터로는 저장을 누를 수 없게 한다. 눌렀다가 서버가 받아주지 않는 것보다,
-     * 누를 수 없는 이유가 판단 패널에 떠 있는 것이 낫다.
-     *
-     * ## 바뀐 것이 없으면 누를 수 없다
-     *
-     * **`dirty` 를 안 보고 있었다.** 저장한 직후에도 단추가 살아 있어 같은 정본을 몇 번이고 다시 쓸
-     * 수 있었고, 저장마다 썸네일을 새로 찍어 20KB 를 다시 넣고 `thumbnailUpdatedAt` 을 올렸다 —
-     * 그림 주소의 판이 바뀌므로 브라우저 캐시도 함께 버려진다. 바뀐 것이 없는데 일어날 일이 아니다.
-     *
-     * 새로 만드는 중인 것은 `startNew` 가 `dirty` 로 시작하므로 첫 저장이 막히지 않는다.
-     * 저장이 거절되면 `dirty` 를 그대로 두므로 다시 누를 수 있다.
-     */
-    private get canSave();
-    pageUpdated(changes: Record<string, unknown>, lifecycle: {
-        resourceId?: string;
-    }): Promise<void>;
-    private loadGeneration;
-    private load;
-    /** 직전 발행판을 가져다 둔다. 못 읽으면 견주지 않는다 — 없는 판정을 지어내지 않는다. */
-    private loadReleased;
-    private startNew;
-    private rename;
-    /**
-     * 타입을 고친다 — **발행 전까지만**(ADR-0063 결정 4).
-     *
-     * 전에는 저장된 도형이면 무조건 돌아섰다. 그래서 기계가 지은 이름이 그대로 굳었다. 발행된
-     * 뒤에는 문이 거절하므로 여기서도 막는다 — 눌러서 되는 것처럼 보이고 저장에서 실패하면
-     * 저작자가 무엇을 잘못했는지 못 읽는다.
-     */
-    private typeChanged;
-    /**
-     * 분류와 태그를 고친다.
-     *
-     * 정본(`source`)이 아니라 **카탈로그의 값**이다 — 도형이 무엇으로 생겼는지가 아니라 어디에
-     * 걸리는지다. 그래서 점수도 발행도 흔들리지 않는다.
-     */
-    private catalog;
-    private snapshotState;
-    private recordHistory;
-    private undo;
-    private redo;
-    /**
-     * 부품 목록을 갈아 끼운다.
-     *
-     * 편집 규칙은 `part-edits` 가 갖는다 — 화면과 테스트가 같은 것을 쓰게 하려고 떼어
-     * 놓았다. 여기서는 결과를 담고 선택 인덱스를 정리한다.
-     */
-    private put;
-    private addPart;
-    private removePart;
-    private duplicatePart;
-    private movePart;
-    private updatePart;
-    /**
-     * 판 자체의 값을 갈아 끼운다 — 능력처럼 부품보다 위에 있는 것들.
-     *
-     * 부품 목록은 건드리지 않는다. `put` 은 부품을 함께 받으므로 여기서 쓰면 능력 하나를
-     * 고칠 때마다 부품 목록이 새 배열이 되고, 그리는 쪽이 전부 다시 그린다.
-     */
-    /**
-     * 미리보기에서 세운 자세를 파라미터의 기본값으로 앉힌다.
-     *
-     * 관절이 있는 도형은 값이 0 인 자세(휴지 자세)가 곧게 선 기둥이라, 기본값이 없으면 목록과
-     * 도면에서 그 모양으로 선다. 저작자가 미리보기에서 맞춘 자세가 곧 그 답이다.
-     */
-    private poseAsDefault;
-    /**
-     * 기준 상자를 고친다 — 초안과 부품이 **한 걸음으로** 바뀐다.
-     *
-     * 상자가 커지면 한가운데가 옮겨 가므로 부품을 그만큼 되밀어야 저장되는 자리가 유지된다
-     * (`base-box.ts`). 그 둘을 따로 기록하면 한 번 되돌렸을 때 부품이 반쯤 밀린 화면이 남는다.
-     */
-    /**
-     * 기준 상자를 부품에 맞춘다. 속성 패널의 단추와 **같은 함수**를 쓴다 — 두 자리가 다른 크기를
-     * 내면 어느 쪽을 눌렀는지에 따라 발행이 갈린다.
-     */
-    private fitBaseToParts;
-    /** 떠 있는 부품 전부를 바닥에 앉힌다. 상자는 건드리지 않는다 — 조치 하나가 한 가지만 한다. */
-    private settlePartsOnFloor;
-    /** 이전 발행 X·Z만 복원한다. Y와 이번 리비전의 부품 편집은 건드리지 않는다. */
-    private restoreReleasedFootprint;
-    private resizeBase;
-    private updateDraft;
-    /**
-     * 디테일 등급을 바꾼다.
-     *
-     * 이 값은 부품 수 한도를 정하고 성숙도의 한 축이 된다. 부품보다 위에 있는 값이라
-     * 초안에 담는다.
-     *
-     * 한도를 내려서 이미 넣은 부품 수보다 작아질 수 있다. 그때 부품을 지우지 않는다.
-     * 검증이 위반으로 알리고, 성숙도가 등급에 안 맞는다고 말한다. 저작자가 무엇을 뺄지
-     * 정할 일이지 도구가 정할 일이 아니다.
-     */
-    private changeDetailLevel;
-    /**
-     * 부품을 잠깐 가린다.
-     *
-     * 씬이 이미 갖고 있는 상태를 켜고 끄는 것뿐이다 — 편집 모드에서는 faint 로 보이고
-     * 뷰 모드에서는 안 그려진다. 저장 형식에는 실리지 않으므로 다시 열면 전부 보인다.
-     *
-     * `dirty` 로 치지 않는다. 저장될 것이 하나도 바뀌지 않았는데 "저장하지 않은 변경"이
-     * 뜨면, 저장 버튼이 무엇을 저장하겠다는 것인지 알 수 없다.
-     */
-    private toggleHidden;
-    /**
-     * 한꺼번에 감추거나 되돌린다.
-     *
-     * 부품 스물짜리에서 안쪽 하나를 보려고 열아홉을 누르던 것을 없앤다. 한 번에 바꾸므로
-     * 목록을 한 번만 갈아 끼운다 — 하나씩 스무 번 갈면 미리보기가 스무 번 다시 선다.
-     */
-    private setAllHidden;
-    /**
-     * 미리보기에서 기즈모로 옮기거나 2D 에서 끌었다.
-     *
-     * 알려 오는 것은 부품 **이름**이다. 목록의 몇 번째인지는 여기서 찾는다 — 이벤트가
-     * 오는 사이에 목록이 바뀌었으면 찾지 못하고, 그때는 아무것도 하지 않는다.
-     */
-    private partChanged;
-    /**
-     * 정밀 배치 도구.
-     *
-     * 규칙은 `part-edits` 가 갖는다. 여기서는 어느 것을 부를지만 정한다.
-     */
-    private runTool;
-    /**
-     * 캔버스에서 부품을 선택했다.
-     *
-     * 캔버스가 알리는 것은 **이름**이다. 목록의 몇 번째인지는 여기서 찾는다 — 알림이
-     * 오는 사이에 목록이 바뀌었으면 못 찾고, 그때는 고른 것을 바꾸지 않는다.
-     * 없는 자리를 고르면 속성 칸이 빈 채로 열려 「사라졌나」로 읽힌다.
-     */
-    /** 지금 고른 부품 이름. 캔버스가 인덱스가 아니라 이름을 받는다. */
-    private get pickedName();
-    /**
-     * 고른 부품에 관절이 있으면 **그 관절이 도는 자리**를 저작면에 함께 그린다(`joint-gizmo.ts`).
-     *
-     * 축을 고르는 칸은 이 화면에 있는데 도는 모습은 미리보기에만 있었다. 고르는 자리와 보이는
-     * 자리가 갈리면 사람은 왕복하며 맞춘다 — 여섯 축짜리 로봇이면 여섯 번이다.
-     */
-    private get jointGizmo();
-    private pickPart;
-    /**
-     * 그림이 없는 도형을 **열었을 때 한 번** 찍어 채운다.
-     *
-     * ## 왜 여기인가
-     *
-     * 도면은 저장할 때 서버가 찍는다. 그런데 백엔드에 GPU 가 없는 배포가 많아 헤드리스로 3D 를 찍는
-     * 것이 자주 실패한다. 도형을 그리는 GPU 는 이미 보는 사람 손에 있고, 씬은 지금 여기 서 있다.
-     *
-     * 저작면을 거치지 않고 생긴 것들이 그림이 없다 — 씨앗으로 넣은 표본, AI 가 낸 후보, 반입한 자산.
-     * 그것들을 한 번 열어 보면 그때 채워진다.
-     *
-     * ## 저장이 아니다
-     *
-     * 그림만 보낸다. 정본을 건드리지 않으므로 미저장 표시도 켜지 않는다 — 열어 봤다는 것이 고쳤다는
-     * 뜻이 되면 저작자가 저장할지 말지를 매번 고민한다.
-     */
-    /**
-     * 발행되었다 — **정본을 든 자리가 그 사실을 받는다.**
-     *
-     * 이력 패널은 발행을 시키고 결과를 알릴 뿐, 이 페이지의 상태를 고쳐 쓰지 않는다. 판 번호와 상태가
-     * 여기서 갱신되어야 머리줄·이력 탭이 같은 것을 본다.
-     *
-     * 정본(source)은 발행이 건드리지 않으므로 다시 불러오지 않는다 — 저작 중인 화면을 되감지 않는다.
-     */
-    private released;
-    private fillThumbnail;
-    private save;
-    private doSave;
-    /** Title of the candidate bar. A candidate opened from a release-check fix is described by translating that fix here. */
-    private proposalTitle;
-    private renderSaveModal;
-}
-export {};