@hatiolab/things-scene 10.1.0 → 10.1.1

package/dist-types/figure/figure-blueprint.d.ts

@@ -3,16 +3,23 @@
  *
  * 정본은 `@hatiolab/figure-model` 의 `FigureBlueprint` 다. 여기 있는 것은 그 형식 중
  * things-scene 이 실제로 읽는 부분만 적은 것이며, **의존성을 만들지 않으려고** 형식을
- * 다시 적었다. figure-model 은 의존성 없는 순수 데이터 모듈이고 things-scene 은 npm 에
- * 배포되므로, 아직 배포되지 않은 패키지를 배포되는 라이브러리의 의존성으로 넣을 수 없다.
+ * 다시 적었다.
+ *
+ * figure-model 은 이미 npm 에 있으므로(`@hatiolab/figure-model`) `import type` 으로
+ * 받아 이 중복을 지울 수 있다 — 타입만 받으면 런타임 의존이 생기지 않는다. 배포되는
+ * 라이브러리의 의존성 목록을 바꾸는 일이라 아직 하지 않았다.
  *
  * **두 벌이 되면 어긋날 수 있다.** 그래서 `test/fixtures/figure-blueprint-sample.json`
  * 에 figure-model 이 실제로 낸 청사진을 넣어 두고, 시험이 그것을 이 형식으로 읽는다.
  * figure-model 의 형식이 바뀌면 표본을 다시 뽑을 때 시험이 깨진다.
  *
- * 좌표 규약은 figure-model 의 `PartTransform` 과 같다 — `x`·`y`·`z` 는 부품의 **최소
- * 모서리**이고 기준은 `base` 상자의 (0,0,0) 이다. `x` 오른쪽, `y` 아래, `z` 위이며
- * `depth` 가 높이다.
+ * 좌표 규약은 figure-model 의 `PartTransform` 과 같다 — **3D 도구들이 쓰는 그대로**
+ * `x` 오른쪽, `y` 위, `z` 앞이고, `position` 은 부품 **중심**의 자리이며 기준은
+ * `base` 상자의 중심 (0,0,0) 이다. 크기는 `size.x`·`size.y`·`size.z` 로 부른다.
+ *
+ * **컴포넌트 state 의 낱말과 다르다.** state 는 `width`·`height`·`depth` 이고 그쪽은
+ * `depth` 가 높이다. 환산은 `figure-real-object.ts` 의 `updateDimension` 한 곳에서만
+ * 한다 — 그 밖에서는 청사진의 축을 그대로 three 에 넘긴다(three 도 y 가 위다).
  */
 export type FigurePrimitiveKind = 'cube' | 'wall' | 'cylinder' | 'sphere' | 'rect' | 'polygon';
 export type FigureMaterialSlot = 'cap' | 'side';
@@ -23,10 +30,11 @@ export interface FigureVec3 {
     y: number;
     z: number;
 }
-export interface FigurePartTransform extends FigureVec3 {
-    width: number;
-    height: number;
-    depth: number;
+export interface FigurePartTransform {
+    /** 부품 중심의 자리. */
+    position: FigureVec3;
+    /** 축별 크기. */
+    size: FigureVec3;
     rotation?: Partial<FigureVec3>;
 }
 export interface FigurePartMaterial {
@@ -84,11 +92,8 @@ export interface FigureBlueprintLabel {
 export interface FigureBlueprint {
     version: number;
     type: string;
-    base: {
-        width: number;
-        height: number;
-        depth: number;
-    };
+    /** 기준 크기(축별). `base.y` 가 높이다. */
+    base: FigureVec3;
     anchor?: FigureVec3;
     budget: {
         triangles: number;

package/dist-types/figure/figure-blueprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-blueprint.d.ts","sourceRoot":"","sources":["../../src/figure/figure-blueprint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"figure-blueprint.d.ts","sourceRoot":"","sources":["../../src/figure/figure-blueprint.ts"],"names":[],"mappings":"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"}

package/dist-types/figure/figure-instance.d.ts

@@ -264,8 +264,24 @@ export declare class FigureInstance extends FigureInstance_base {
     /** 이 인스턴스가 그리는 청사진. 등록이 지워졌으면 null 이다. */
     get figure(): import("./figure-registry.js").PreparedFigure | null;
     render(ctx: SceneRenderContext): void;
-    /** 부품 하나의 톱뷰 윤곽을 현재 path 에 그린다. */
+    /**
+     * 부품 하나의 톱뷰 윤곽을 현재 path 에 그린다. `ox`·`oy` 는 캔버스에 놓인 원점이다.
+     *
+     * ## 회전을 반영한다
+     *
+     * 3D 는 도는데 2D 가 안 돌면 **같은 물건이 두 화면에서 다르게** 보인다. 위에서
+     * 내려다보므로 축마다 뜻이 다르다.
+     *
+     *   y 회전  평면 안에서 도는 것이다. 그대로 돌려 그린다 — 정확하다
+     *   x·z 회전 부품이 **기울어진다.** 발자국의 모양 자체가 달라져서 원기둥이 타원
+     *            비슷한 것이 되고 상자는 육각형 그림자가 된다
+     *
+     * 기울어진 것은 **회전한 상자의 평면 경계**로 근사한다. 실제 그림자보다 조금 크게
+     * 잡히지만, 안 돌린 채로 두면 「어디에 걸리는지」를 아예 못 보여 준다.
+     */
     private tracePart;
+    /** 부품의 평면 윤곽을 `cx`·`cy` 를 중심으로 그린다. 회전은 부르는 쪽이 이미 걸었다. */
+    private traceShape;
     /**
      * 청사진을 못 찾았을 때. **빈 자리로 두지 않는다** — 아무것도 안 그리면 보는 사람은
      * 컴포넌트가 없는 것인지 청사진이 없는 것인지 알 수 없다. 자리와 타입 이름을 보인다.

package/dist-types/figure/figure-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-instance.d.ts","sourceRoot":"","sources":["../../src/figure/figure-instance.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,KAAK,MAAM,wBAAwB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsC7D,qBAAa,cAAe,SAAQ,mBAAe;IACjD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIvC,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,0CAA0C;IAC1C,IAAI,MAAM,yDAET;IAED,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAqB9B,mCAAmC;IACnC,OAAO,CAAC,SAAS;IAoDjB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;;;OAKG;IACM,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAGvD;AAMD,eAAe,cAAc,CAAA"}
+{"version":3,"file":"figure-instance.d.ts","sourceRoot":"","sources":["../../src/figure/figure-instance.ts"],"names":[],"mappings":"AAIA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,KAAK,MAAM,wBAAwB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgF7D,qBAAa,cAAe,SAAQ,mBAAe;IACjD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIvC,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,0CAA0C;IAC1C,IAAI,MAAM,yDAET;IAED,MAAM,CAAC,GAAG,EAAE,kBAAkB;IA6B9B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS;IA6CjB,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IAmDlB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;;;OAKG;IACM,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAGvD;AAMD,eAAe,cAAc,CAAA"}

package/dist-types/figure/figure-part-component.d.ts

@@ -0,0 +1,324 @@
+import Component from '../components/component.js';
+import Shape from '../components/shape.js';
+import type { SceneRenderContext } from '../interfaces/rendering.js';
+import type { IRealObject } from '../interfaces/real-object.js';
+import type { ComponentNature } from '../interfaces/types.js';
+import { RealObject } from '../threed/real-object.js';
+import { MATERIAL_PRESETS } from '../threed/material-3d.js';
+/** 이 컴포넌트가 3D 로 세울 수 있는 도형. `PRIMITIVE_KINDS` 와 같은 집합이다. */
+export type FigurePartPrimitive = 'cube' | 'wall' | 'cylinder' | 'sphere' | 'rect' | 'polygon';
+/** 부품 컴포넌트가 갖는, 씬 공통 상태 밖의 값들. */
+export interface FigurePartState {
+    primitive?: FigurePartPrimitive;
+    segments?: number;
+    /** `rect` 의 모서리 굴림, `polygon` 의 단면 경로. */
+    round?: number;
+    path?: {
+        x: number;
+        y: number;
+    }[];
+    /** 팔레트 토큰. 값이 아니라 이름을 둔다 — 테마를 바꾸면 따라온다. */
+    token?: string;
+    preset?: keyof typeof MATERIAL_PRESETS;
+    flatShading?: boolean;
+    transparent?: boolean;
+}
+/**
+ * 부품의 3D 표현.
+ *
+ * 치수를 형상에 굽지 않는다 — 단위 형상을 창고에서 꺼내 `dimensionScale` 로 키운다.
+ * 그래야 크기가 다른 부품끼리도 형상 하나를 나눠 쓴다. 단면을 미는 것(`rect` ·
+ * `polygon`)만 예외인데, 단위로 정규화하면 모서리 굴림 비율이 망가지기 때문이다.
+ */
+export declare class FigurePartRealObject extends RealObject {
+    build(): void;
+    /** 단위 형상. 치수는 배율로 준다. */
+    private unitGeometry;
+    /**
+     * 단면을 밀어 만든 형상. **치수가 구워지므로 열쇠에 치수가 든다.**
+     *
+     * 단면은 평면도다 — 가로가 `width`, 세로가 `height` 이고 밀리는 두께가 `depth` 다.
+     * 여기서는 두께 1 로 만들고 배율로 키운다. 굴림은 평면 안의 값이라 배율에 안 눌린다.
+     */
+    private extrudedGeometry;
+    private crossSection;
+    /**
+     * 재질. **팔레트 토큰과 프리셋으로만 정한다** — 배포된 Figure 와 같은 규칙이다.
+     *
+     * 창고가 값으로 공유하므로 같은 토큰·프리셋을 쓰는 부품끼리 재질 하나를 나눠 쓴다.
+     * 접었을 때 세어지는 「재질 묶음」이 저작 중에도 그대로 눈에 보인다.
+     */
+    private material;
+    /**
+     * 치수를 배율로 준다.
+     *
+     * 단면을 민 것은 평면 치수가 이미 형상에 구워져 있으므로 두께만 키운다 — 평면까지
+     * 배율을 걸면 두 번 곱해진다.
+     */
+    updateDimension(): void;
+}
+declare const FigurePart_base: {
+    new (...args: any[]): {
+        contains(x: number, y: number): boolean;
+        get path(): {
+            x: any;
+            y: any;
+        }[];
+        set path(path: {
+            x: any;
+            y: any;
+        }[]);
+        get anchors(): {
+            name: string;
+            position: {
+                x: any;
+                y: any;
+            };
+        }[];
+        get bounds(): any;
+        set bounds(bounds: any);
+        render(ctx: CanvasRenderingContext2D): void;
+        _app: any;
+        _model: any;
+        _state: any;
+        _delta: any;
+        _animation: any;
+        _animate: any;
+        _parent: any;
+        _disposed: any;
+        _textHidden: any;
+        _text_substitutor: any;
+        _value_substitutor: any;
+        _mappings: any;
+        _realObject: IRealObject | undefined;
+        _cachedState: any;
+        updatedAt: any;
+        fontSize: any;
+        __cache__: any;
+        created(): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
+        ready(): Promise<void>;
+        _readyInvoked: boolean;
+        invokeReady(): void | Promise<void>;
+        touch(): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
+        resetAnimation(): void;
+        dispose(): void;
+        get nature(): ComponentNature;
+        get disposed(): boolean;
+        isLayer(): boolean;
+        isGroup(): boolean;
+        isContainer(): this is import("../types/component.js").Container;
+        isLine(): boolean;
+        isRoot(): boolean;
+        isRootModel(): boolean;
+        is3dish(): boolean;
+        get is3dMode(): boolean;
+        isIn3DSpace(): boolean;
+        isTemplate(): boolean;
+        isHTMLElement(): boolean;
+        isConnectable(): boolean;
+        isIdentifiable(): boolean;
+        isPositionable(): boolean;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
+        set(props: any, propval?: any): any;
+        getState(property: string): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
+        get model(): any;
+        get state(): import("../index.js").State;
+        get refid(): any;
+        get hierarchy(): any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../components/component.js").ApplyPropsOptions): /*elided*/ any;
+        move(offset: {
+            x: number;
+            y: number;
+        }, ...args: boolean[]): void;
+        symmetryX(x?: number): void;
+        symmetryY(y: number): void;
+        adjustResize(bounds: import("../index.js").BOUNDS, origin_bounds: import("../index.js").BOUNDS, diagonal: boolean): {
+            left: any;
+            top: any;
+            width: any;
+            height: any;
+        };
+        adjustRotation(rotation: number, step: boolean): number;
+        outline(progress: number): any;
+        get center(): import("../index.js").POINT;
+        set center(p: import("../index.js").POINT);
+        get location(): import("../index.js").POINT;
+        set location(l: import("../index.js").POINT);
+        get rotate(): import("../index.js").POINT;
+        set rotate(r: import("../index.js").POINT);
+        get dimension(): import("../index.js").DIMENSION;
+        set dimension(d: import("../index.js").DIMENSION);
+        get drawPath(): import("../index.js").POINT[];
+        get rotatePoint(): import("../index.js").POINT;
+        get mutable(): boolean;
+        get resizable(): boolean;
+        get rotatable(): boolean;
+        buildRealObject(): IRealObject | undefined;
+        get realObject(): IRealObject | undefined;
+        draw(context?: SceneRenderContext): void;
+        prerender(context: SceneRenderContext): void;
+        postrender(context: SceneRenderContext): void;
+        prepare(resolve: (component: Component) => void, reject: (reason: any) => void): void;
+        prepareIf(condition: boolean): void;
+        drawText(context: SceneRenderContext): void;
+        drawStroke(context: SceneRenderContext, override?: Record<string, unknown>): void;
+        drawFill(context: SceneRenderContext, override?: Record<string, unknown>): void;
+        get strokeStyle(): any;
+        set strokeStyle(v: any);
+        get fillStyle(): any;
+        set fillStyle(v: any);
+        get fontColor(): string;
+        set fontColor(v: string);
+        get rotation(): number;
+        set rotation(v: number);
+        get decorators(): string[];
+        get decotag(): string;
+        get hidden(): boolean;
+        set hidden(v: boolean);
+        get tag(): string;
+        set tag(v: string);
+        get appendum(): any;
+        set appendum(v: any);
+        defaultTextSubstitutor(): string;
+        textLines(context?: SceneRenderContext): any[][];
+        get font(): string;
+        get lineHeight(): number;
+        get textSubstitutor(): () => string;
+        get text(): string;
+        set text(v: string);
+        get textBounds(): import("../index.js").BOUNDS;
+        get textRotation(): number;
+        get textHidden(): boolean;
+        set textHidden(v: boolean);
+        get hasTextProperty(): boolean;
+        animate(opts: import("../index.js").AnimationConfig): any;
+        effect(context: SceneRenderContext, model: any): void;
+        serialize(...others: any[]): string;
+        trim(): void;
+        closeScene(data: any): void;
+        delta(attr?: string | object, value?: any): any;
+        invalidate(): void;
+        get value(): any;
+        set value(v: any);
+        get data(): any;
+        set data(v: any);
+        set tap(v: any);
+        get mappings(): any[];
+        get retention(): number;
+        get animation(): import("../index.js").AnimationController | undefined;
+        get started(): boolean;
+        set started(v: boolean);
+        get controls(): import("../index.js").Control[] | undefined;
+        findFirst(finder: string | ((c: Component) => boolean), ...others: any[]): Component | undefined;
+        findAll(s: string | ((c: Component) => boolean), ...others: any[]): any[] | undefined;
+        capture(x: number, y: number, except?: (c: Component) => boolean): any;
+        findAnchor(name: string): any;
+        isDescendible(container: Component | any): boolean;
+        getContext(component?: unknown): any;
+        get root(): Component;
+        get rootModel(): Component;
+        get parent(): Component;
+        set parent(v: Component);
+        get scalable(): boolean;
+        get stuck(): boolean;
+        get capturable(): boolean;
+        get position(): string;
+        get origin(): string;
+        get offset(): import("../index.js").POINT;
+        get app(): import("../index.js").ApplicationContext;
+        drawEffect(context: SceneRenderContext): void;
+        prepareFill(resolve: Function, reject: Function): void;
+        prepareFillIf(condition: boolean): void;
+        onchangeFill(after: Record<string, any>, before: Record<string, any>): void;
+        drawImage(context: SceneRenderContext, image: HTMLImageElement, left: number, top: number, width: number, height: number): void;
+        mutateBounds(logic: ((bounds: import("../index.js").BOUNDS) => import("../index.js").BOUNDS | void) | null, context?: any): void;
+        mutatePath(beforeLogic: ((path: import("../index.js").POINT[]) => import("../index.js").POINT[] | void) | null, afterLogic: ((path: import("../index.js").POINT[]) => import("../index.js").POINT[] | void) | null, context?: any): void;
+        access(accessor: string): any;
+        substitute(template: string, data: any): string | undefined;
+        onchangeMappings(after: Record<string, any>, before: Record<string, any>): void;
+        onchangeData(after: Record<string, any>, before: Record<string, any>): void;
+        buildMappings(): void;
+        executeMappings(force?: boolean): void;
+        disposeMappings(): void;
+        ondropfile(transfered: FileList, files: string[]): void;
+        transcoordS2P(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        transcoordP2S(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        transcoordS2T(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordT2P(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordT2S(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2TR(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2O(x: number, y: number, target: Component): import("../index.js").POINT;
+        transcoordC2S(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2C(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toParent(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        fromParent(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        toScene(x: number, y: number, top?: Component): import("../index.js").POINT;
+        fromScene(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toLocal(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toGlobal(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toOther(x: number, y: number, target: Component): import("../index.js").POINT;
+        on<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        on(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        off<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback?: ((...args: import("../index.js").ComponentEventMap[K]) => void) | undefined, context?: any): /*elided*/ any;
+        off(name?: string | object, callback?: Function, context?: any): /*elided*/ any;
+        once<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        once(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        trigger<K extends keyof import("../index.js").ComponentEventMap>(name: K, ...args: import("../index.js").ComponentEventMap[K]): /*elided*/ any;
+        trigger(name: string, ...args: any[]): /*elided*/ any;
+        delegate_on(delegator: any): /*elided*/ any;
+        delegate_off(delegator: any): /*elided*/ any;
+        onchange(after: Record<string, any>, before: Record<string, any>): void;
+        calculateBounds?(): void;
+        oncreate_element?(element: HTMLElement): void;
+        removeComponent(component: Component, ghost?: boolean): void;
+        addComponent(component: Component, ghost?: boolean): void;
+        insertComponentAt(component: Component, index: number, ghost?: boolean): void;
+        getOverlay(component: Component): HTMLElement | undefined;
+        findById(id: string): Component | undefined;
+        findByRefid(ref: string | number): Component | undefined;
+        findAllById(id: string): Component[];
+        resize(): void;
+        fit(type?: string): void;
+        get components(): Component[] | undefined;
+        get layout(): any;
+        get auxOverlay(): HTMLElement | undefined;
+        get isReady(): boolean;
+        get unitScale(): number;
+        get selected(): Component[];
+        set selected(_v: Component[]);
+        get focused(): Component | null;
+        set focused(_v: Component | null);
+        get hasSameParentForAllSelected(): boolean;
+        set hasSameParentForAllSelected(_v: boolean);
+        get fitMode(): string | undefined;
+        set fitMode(_v: string | undefined);
+        get element(): HTMLElement | null;
+        set element(_v: HTMLElement | null);
+    };
+} & typeof Shape;
+/**
+ * 저작 중인 부품. 판 위에 놓이는 여느 컴포넌트다.
+ *
+ * 2D 는 위에서 내려다본 발자국을 그린다. 저작면의 2D 뷰와 배포된 Figure 의 2D 표현이
+ * 같은 규칙으로 그려져야, 접기 전후로 그림이 달라지지 않는다.
+ */
+export declare class FigurePart extends FigurePart_base {
+    /** 이름이 `register` 면 밑바탕 클래스의 것과 부딪힌다 — `FigureInstance` 와 같은 이름을 쓴다. */
+    static registerType(): void;
+    get hasTextProperty(): boolean;
+    is3dish(): boolean;
+    get nature(): ComponentNature;
+    buildRealObject(): IRealObject | undefined;
+    render(ctx: SceneRenderContext): void;
+    /** 위에서 내려다본 발자국. 3D 와 **같은 분할 수**로 근사한다. */
+    private traceFootprint;
+}
+export {};
+//# sourceMappingURL=figure-part-component.d.ts.map

package/dist-types/figure/figure-part-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-part-component.d.ts","sourceRoot":"","sources":["../../src/figure/figure-part-component.ts"],"names":[],"mappings":"AAMA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,KAAK,MAAM,wBAAwB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAyC3D,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;AAQ9F,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,mBAAmB,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACjC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,OAAO,gBAAgB,CAAA;IACtC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAMD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,KAAK;IAgBL,yBAAyB;IACzB,OAAO,CAAC,YAAY;IAapB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,YAAY;IA4CpB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAsBhB;;;;;OAKG;IACH,eAAe,IAAI,IAAI;CAWxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,eAAe;IAC7C,wEAAwE;IACxE,MAAM,CAAC,YAAY,IAAI,IAAI;IAI3B,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAU9B,4CAA4C;IAC5C,OAAO,CAAC,cAAc;CA2CvB"}

package/dist-types/figure/figure-real-object.d.ts

@@ -28,29 +28,40 @@ import type { FigureBlueprintMember } from './figure-blueprint.js';
  * `InstancedMesh` 이고, 그것은 인스턴스별 선택·컬링·재질을 다르게 다뤄야 해서 별개
  * 결정이다.
  */
-/** base 좌표 → three 좌표. 모델 x→X, **모델 z(높이)→Y**, 모델 y→Z. */
+/**
+ * 청사진 좌표가 곧 three 좌표다 — 둘 다 x 오른쪽, y 위, z 앞이고, 둘 다 원점이
+ * 중심이다. **갈아끼울 것이 없다.**
+ *
+ * 컴포넌트 state 와의 환산은 `updateDimension` 한 곳에만 있다.
+ */
 export declare function memberGeometry(member: FigureBlueprintMember): THREE.BufferGeometry | null;
 /**
- * 한 묶음의 부품들을 하나로 합친다. **타입·묶음당 한 번만** 만들고 창고에 둔다 —
- * 같은 (타입, 묶음)이면 몇 번을 불러도 **같은 객체**가 나온다. 공유가 실제로
- * 일어나는지 시험이 확인할 수 있게 내보낸다.
+ * 부품 하나의 형상을 **제 중심을 원점에 두고** 만든다.
+ *
+ * 자리를 굽지 않는다. 그러면 크기·종류가 같은 부품끼리는 자리가 달라도 같은 형상을
+ * 나눠 쓸 수 있고, 저작면에서는 `mesh.position` 이 곧 부품의 자리가 되어 기즈모로 끈
+ * 결과를 그대로 되읽을 수 있다.
+ */
+export declare function memberGeometryAtOrigin(member: FigureBlueprintMember): THREE.BufferGeometry | null;
+/**
+ * 한 묶음의 부품들을 하나로 합친다. **모양당 한 번만** 만들고 창고에 둔다 — 모양이
+ * 같으면 몇 번을 불러도 **같은 객체**가 나온다. 공유가 실제로 일어나는지 시험이
+ * 확인할 수 있게 내보낸다.
  *
- * 합친 결과는 base 좌표계이고 base 상자의 중심이 원점이 되도록 옮긴다 — 다른
- * 컴포넌트들이 `geometry.center()` 로 맞추는 기준과 같다.
+ * 합친 결과는 청사진 좌표 그대로다. 청사진의 원점이 이미 base 상자의 중심이라, 다른
+ * 컴포넌트들이 `geometry.center()` 로 맞추는 기준과 같은 자리에 있다.
  */
 export declare function mergedGeometryOf(figure: PreparedFigure, index: number): THREE.BufferGeometry | null;
 export declare class FigureRealObject extends RealObject {
     /** 부품 이름 → mesh. 애니메이션·바인딩이 부품을 찾는 자리다. */
     private _meshByName;
     get figure(): PreparedFigure | null;
-    /** 부품 이름으로 mesh 를 찾는다. 이름이 곧 바인딩·애니메이션이 붙는 자리다. */
-    meshOf(name: string): THREE.Mesh | undefined;
     build(): void;
     /**
      * 인스턴스의 높이.
      *
      * 보드는 `left`·`top`·`width`·`height` 만 적는 것이 보통이고 `depth` 는 잘 적지
-     * 않는다. 그때 기본 높이(≈1)를 쓰면 `base.depth` 로 나뉘어 형상이 납작하게 눌린다.
+     * 않는다. 그때 기본 높이(≈1)를 쓰면 `base.y` 로 나뉘어 형상이 납작하게 눌린다.
      *
      * **저작한 비례를 지킨다** — 평면 두 축이 커진 만큼 높이도 커진다. 배치 크기가
      * 템플릿의 비율로 처리된다는 것이 이 뜻이다. 두 축의 기하평균을 쓰므로 한 축만 늘여도
@@ -60,6 +71,14 @@ export declare class FigureRealObject extends RealObject {
     /**
      * 인스턴스 치수를 **배율로만** 준다 — geometry 는 건드리지 않으므로 인스턴스가
      * 늘어도 정점 버퍼가 늘지 않는다.
+     *
+     * **낱말이 갈리는 유일한 자리다.** 청사진은 3D 도구들의 축(`x` 오른쪽, `y` 위,
+     * `z` 앞)을 쓰고, 컴포넌트 state 는 2D 캔버스에서 온 낱말(`width`·`height` 가
+     * 평면, `depth` 가 높이)을 쓴다. 환산은 여기서 한 번만 한다.
+     *
+     *   state.width  ↔ base.x   평면 가로
+     *   state.height ↔ base.z   평면 세로
+     *   state.depth  ↔ base.y   높이
      */
     updateDimension(): void;
     /**

package/dist-types/figure/figure-real-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-real-object.d.ts","sourceRoot":"","sources":["../../src/figure/figure-real-object.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAKrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAA;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAyCzF;AA+CD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CA2CnG;AAkBD,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,2CAA2C;IAC3C,OAAO,CAAC,WAAW,CAAgC;IAEnD,IAAI,MAAM,IAAI,cAAc,GAAG,IAAI,CAElC;IAED,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS;IAI5C,KAAK;IAwBL;;;;;;;;;OASG;IACH,IAAa,cAAc,IAAI,MAAM,CAepC;IAED;;;OAGG;IACH,eAAe,IAAI,IAAI;IAevB;;;;OAIG;IACM,UAAU,IAAI,UAAU,GAAG,IAAI;IAIxC,KAAK;CAIN"}
+{"version":3,"file":"figure-real-object.d.ts","sourceRoot":"","sources":["../../src/figure/figure-real-object.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAKrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAA;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAuBzF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAiCjG;AAmFD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CA0CnG;AAkBD,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,2CAA2C;IAC3C,OAAO,CAAC,WAAW,CAAgC;IAEnD,IAAI,MAAM,IAAI,cAAc,GAAG,IAAI,CAElC;IAED,KAAK;IAwBL;;;;;;;;;OASG;IACH,IAAa,cAAc,IAAI,MAAM,CAepC;IAED;;;;;;;;;;;OAWG;IACH,eAAe,IAAI,IAAI;IAevB;;;;OAIG;IACM,UAAU,IAAI,UAAU,GAAG,IAAI;IAIxC,KAAK;CAIN"}

package/dist-types/figure/index.d.ts

@@ -5,6 +5,7 @@
  * 적재되며 컴포넌트 클래스를 registry 에 넣기 때문이다. 그래서 instance 를 먼저 읽는다.
  */
 export * from './figure-instance.js';
+export * from './figure-part-component.js';
 export * from './figure-blueprint.js';
 export * from './figure-palette.js';
 export * from './figure-registry.js';

package/dist-types/figure/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/figure/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/figure/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAA;AAKpC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA"}

package/dist-types/threed/coordinate-ground.d.ts

@@ -0,0 +1,51 @@
+import * as THREE from 'three';
+/**
+ * 좌표 바탕 — 바닥 모눈과 축.
+ *
+ * 3D 저작면에서 이것이 없으면 **어디가 원점이고 어느 쪽이 위인지 알 수 없다.** 형상만
+ * 떠 있으면 크기도 방향도 짐작이 안 된다.
+ *
+ * ## 왜 씬이 갖나
+ *
+ * 한동안 저작 화면이 만들어 `scene3d` 에 얹었다. 그랬더니 2D 로 갔다 오면 사라졌다 —
+ * 그때 씬이 통째로 다시 서면서 새 `THREE.Scene` 을 만드는데, 얹어 둔 것은 옛 씬에
+ * 남기 때문이다. 씬이 소유하면 다시 설 때 같이 산다.
+ *
+ * 3D 저작면이면 다 필요한 것이라, 자리도 여기가 맞다.
+ *
+ * ## 두 단계로 그린다
+ *
+ * 잔 눈금만 있으면 「지금 몇 칸인가」를 셀 수 없다. 다섯 칸마다 굵은 눈금을 둔다 —
+ * 자와 모눈종이가 하는 것과 같다.
+ *
+ * ## 멀어질수록 사라지게
+ *
+ * 끝까지 같은 세기로 그으면 원경에서 선이 뒤엉켜 **어두운 띠**가 된다. 정점 색을
+ * 배경색 쪽으로 섞어 반지름에 따라 지운다 — 투명도가 아니라 색으로 지우므로 깊이
+ * 정렬과 싸우지 않는다.
+ */
+export interface CoordinateGroundOptions {
+    /** 잔 눈금 한 칸. */
+    step: number;
+    /** 원점에서 몇 칸까지 뻗나. */
+    cells?: number;
+    /** 배경색. 선이 이 색으로 스러진다. */
+    background?: string;
+    /** 축 이름표를 보이나. */
+    labels?: boolean;
+}
+export declare const COORDINATE_GROUND_NAME = "coordinate-ground";
+/**
+ * 가로 길이에 어울리는 **둥근** 눈금 한 칸. 대여섯 칸이 되게 잡는다.
+ *
+ * 그냥 나누면 27 · 33 같은 값이 나온다. 그 눈금에 맞추면 좌표가 54 · 81 이 되어 사람이
+ * 읽을 수 없다. 1 · 2 · 5 사다리로 올려 붙인다 — 자와 차트 눈금이 쓰는 방식이다.
+ *
+ * 칸이 성기어야 형상이 주인공이 된다. 열 칸으로 잡았더니 모눈이 촘촘해 바탕이 먼저
+ * 보였다.
+ */
+export declare function niceGridStep(span: number): number;
+export declare function buildCoordinateGround(options: CoordinateGroundOptions): THREE.Group;
+/** 좌표 바탕이 쥐고 있는 것을 놓는다. 창고에 든 것이 아니라 우리가 만든 것들이다. */
+export declare function disposeCoordinateGround(ground: THREE.Object3D): void;
+//# sourceMappingURL=coordinate-ground.d.ts.map

package/dist-types/threed/coordinate-ground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate-ground.d.ts","sourceRoot":"","sources":["../../src/threed/coordinate-ground.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,uBAAuB;IACtC,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAYD,eAAO,MAAM,sBAAsB,sBAAsB,CAAA;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAYD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,KAAK,CAAC,KAAK,CAsCnF;AA+GD,qDAAqD;AACrD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAYpE"}

package/dist-types/threed/floor/floor.d.ts

@@ -1,4 +1,26 @@
 import * as THREE from 'three';
 import type Component from '../../components/component.js';
+/**
+ * 판의 바닥판을 만든다. 필요 없으면 만들지 않는다.
+ *
+ * ## `floor: false` 를 따로 두는 까닭
+ *
+ * **판의 면은 한 개념이다** — 2D 에서는 종이이고 3D 에서는 바닥판이다. 그래서 `fillStyle`
+ * 하나가 둘을 정하는 것은 원래 일관적이다.
+ *
+ * 그런데 **그 둘을 따로 원하는 화면이 있다.** 3D 저작면이 그렇다:
+ *
+ *   - 2D 종이는 **밝아야 한다.** 편집 손잡이와 안내선이 어두운 색이라 어두운 바탕에서는
+ *     안 보인다.
+ *   - 3D 바닥판은 **없어야 한다.** 좌표 모눈과 겹쳐 싸우고, 원점 아래쪽을 가린다.
+ *
+ * 이 조합을 말할 방법이 없었다. 유일한 길이 `fillStyle: 'none'` 인데 그러면 2D 종이까지
+ * 비어 버려 편집 도구가 안 보인다.
+ *
+ * 바닥이 별개로 없어질 수 있다는 것은 코드가 이미 인정하고 있었다 — `placement === 'space'`
+ * 는 `fillStyle` 과 무관하게 바닥을 안 만든다. 그 자리를 명시적으로 연 것뿐이다.
+ *
+ * **안 주면 종전 그대로다.** 이미 세워져 있는 보드는 아무것도 달라지지 않는다.
+ */
 export declare function createFloor(component: Component): THREE.Mesh | undefined;
 //# sourceMappingURL=floor.d.ts.map

package/dist-types/threed/floor/floor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floor.d.ts","sourceRoot":"","sources":["../../../src/threed/floor/floor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAqB1D,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CAuExE"}
+{"version":3,"file":"floor.d.ts","sourceRoot":"","sources":["../../../src/threed/floor/floor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAqB1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS,CA2ExE"}

package/dist-types/threed/index.d.ts

@@ -94,4 +94,8 @@ export { createCanvasTexture, renderCanvasTexture } from './texture/canvas-textu
 export { textTexture, textBounds, drawTextTexture, fontStyle } from './texture/text-texture.js';
 export { createCanvas, PIXEL_RATIO } from './html/elements.js';
 export { createFloor } from './floor/floor.js';
+export { isParted, partAtByIndex } from './parted-real-object.js';
+export type { PartedRealObject } from './parted-real-object.js';
+export { buildCoordinateGround, disposeCoordinateGround, niceGridStep } from './coordinate-ground.js';
+export type { CoordinateGroundOptions } from './coordinate-ground.js';
 //# sourceMappingURL=index.d.ts.map