@hatiolab/things-scene 10.0.5 → 10.1.0

package/dist-types/diagnostics/inspector.d.ts

@@ -1,10 +1,50 @@
 import type { ComponentNature } from '../interfaces/types.js';
 import type { Material3D, ResolvedMaterial3D } from '../threed/material-3d.js';
+/**
+ * 재질이 그려지지 않을 조건 — **왜 화면이 검은지**를 말해 준다.
+ *
+ * 이것을 두는 이유. PBR 에서 완전한 금속은 확산 성분이 없어 보이는 것이 전부 반사다.
+ * 반사할 환경(IBL)이 없으면 저작자가 고른 색과 무관하게 검게 나온다. 그때 저작자는
+ * 색을 잘못 골랐다고 생각한다 — 화면이 원인을 알려 주지 않기 때문이다.
+ */
+export interface MaterialVisibilityWarning {
+    code: 'metal-without-environment';
+    /** 사람이 읽는 사유. 그대로 보여도 된다. */
+    message: string;
+    /** 판단에 쓴 값. */
+    metalness: number;
+}
 interface ThreedInfo {
     is3dish: boolean;
     type: string;
     material3d?: Material3D;
     resolved?: ResolvedMaterial3D;
+    /**
+     * 재질을 나눠 쓰고 있나.
+     *
+     * 대량으로 놓이는 컴포넌트(캐리어·선반 칸·롤러)는 재질을 나눠 써야 한다. 안 나눠
+     * 쓰면 인스턴스 수만큼 재질이 생긴다 — 캐리어 1만 개면 재질 1만 개다.
+     *
+     * `violated` 는 「나눠 써야 한다고 선언했는데 못 쓰고 있다」는 뜻이고, 그때
+     * `reason` 이 무엇을 고쳐야 하는지 말한다.
+     *
+     * 판단할 수 없으면(3D 오브젝트가 아직 없는 등) `undefined` 다 — **나눠 쓴다고
+     * 단정하지 않는다.**
+     */
+    materialSharing?: {
+        shared: boolean;
+        required: boolean;
+        violated: boolean;
+        reason?: string;
+        bankKey?: string;
+    };
+    /**
+     * 이 재질이 의도대로 안 보일 조건. 없으면 빈 배열이다.
+     *
+     * **비어 있다는 것과 「모른다」는 것은 다르다** — 판단할 수 없었으면 `undefined` 다
+     * (씬을 못 찾은 경우 등).
+     */
+    visibilityWarnings?: MaterialVisibilityWarning[];
     nodeNames?: string[];
     animationNames?: string[];
     nodes?: Record<string, any>;
@@ -181,6 +221,13 @@ declare class SceneInspector {
      * Material3D, GLTF 노드/애니메이션 등.
      */
     getThreedInfo(componentId: string, sceneIndex?: number): ThreedInfo | null;
+    /**
+     * 반사할 환경이 없는데 금속성이 높으면 알린다.
+     *
+     * 문턱 0.5 — 그 아래는 확산 성분이 남아 색이 보인다. 1.0 은 완전히 검게 나온다.
+     * 문턱을 넘었다고 잘못된 것은 아니다. 환경을 주면 의도대로 보인다.
+     */
+    private _materialVisibilityWarnings;
     private _getScene;
     private _cleanup;
     private _findComponent;

package/dist-types/diagnostics/inspector.d.ts.map

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

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

@@ -0,0 +1,118 @@
+/**
+ * 청사진을 **읽는 쪽**의 계약.
+ *
+ * 정본은 `@hatiolab/figure-model` 의 `FigureBlueprint` 다. 여기 있는 것은 그 형식 중
+ * things-scene 이 실제로 읽는 부분만 적은 것이며, **의존성을 만들지 않으려고** 형식을
+ * 다시 적었다. figure-model 은 의존성 없는 순수 데이터 모듈이고 things-scene 은 npm 에
+ * 배포되므로, 아직 배포되지 않은 패키지를 배포되는 라이브러리의 의존성으로 넣을 수 없다.
+ *
+ * **두 벌이 되면 어긋날 수 있다.** 그래서 `test/fixtures/figure-blueprint-sample.json`
+ * 에 figure-model 이 실제로 낸 청사진을 넣어 두고, 시험이 그것을 이 형식으로 읽는다.
+ * figure-model 의 형식이 바뀌면 표본을 다시 뽑을 때 시험이 깨진다.
+ *
+ * 좌표 규약은 figure-model 의 `PartTransform` 과 같다 — `x`·`y`·`z` 는 부품의 **최소
+ * 모서리**이고 기준은 `base` 상자의 (0,0,0) 이다. `x` 오른쪽, `y` 아래, `z` 위이며
+ * `depth` 가 높이다.
+ */
+export type FigurePrimitiveKind = 'cube' | 'wall' | 'cylinder' | 'sphere' | 'rect' | 'polygon';
+export type FigureMaterialSlot = 'cap' | 'side';
+export type FigureSizingRule = 'scale' | 'fixed' | 'stretch' | 'repeat';
+export type FigureAnimationKind = 'fade' | 'heartbeat' | 'moving' | 'outline' | 'rotation' | 'vibration' | 'waypoint';
+export interface FigureVec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface FigurePartTransform extends FigureVec3 {
+    width: number;
+    height: number;
+    depth: number;
+    rotation?: Partial<FigureVec3>;
+}
+export interface FigurePartMaterial {
+    /** 팔레트 토큰. 값이 아니라 이름이다 — 해석은 그리는 쪽이 한다. */
+    token?: string;
+    preset?: 'default' | 'metal' | 'glass' | 'plastic' | 'wood' | 'ceramic' | 'rubber';
+    flatShading?: boolean;
+    transparent?: boolean;
+}
+export interface FigurePartShape {
+    /** polygon 의 단면. `base` 좌표계의 점들. */
+    path?: {
+        x: number;
+        y: number;
+    }[];
+    /** rect 의 모서리 반경. */
+    round?: number;
+}
+export interface FigureBlueprintMember {
+    name: string;
+    primitive: FigurePrimitiveKind;
+    /** GeometryBank 키. 치수가 들어 있다. */
+    geometryKey: string;
+    transform: FigurePartTransform;
+    sizing: FigureSizingRule;
+    repeat?: {
+        axis: 'x' | 'y' | 'z';
+        gap: number;
+    };
+    shape?: FigurePartShape;
+    triangles: number;
+}
+export interface FigureBlueprintGroup {
+    materialKey: string;
+    material: FigurePartMaterial;
+    slot?: FigureMaterialSlot;
+    /** 애니메이션 포인트에 걸린 묶음. 걸리면 부품 하나만 든다. */
+    animated: boolean;
+    members: FigureBlueprintMember[];
+}
+export interface FigureBlueprintPoint {
+    /** 어느 부품인가. `FigureBlueprintMember.name`. */
+    name: string;
+    kind: FigureAnimationKind;
+    axis?: 'x' | 'y' | 'z';
+    pivot?: FigureVec3;
+}
+export interface FigureBlueprintLabel {
+    name: string;
+    source: string;
+    when: 'always' | 'zoomed' | 'selected' | 'abnormal';
+    /** 어느 부품에 붙나. */
+    at: string;
+}
+export interface FigureBlueprint {
+    version: number;
+    type: string;
+    base: {
+        width: number;
+        height: number;
+        depth: number;
+    };
+    anchor?: FigureVec3;
+    budget: {
+        triangles: number;
+        groups: number;
+    };
+    groups: FigureBlueprintGroup[];
+    points: FigureBlueprintPoint[];
+    labels: FigureBlueprintLabel[];
+    violations: {
+        code: string;
+        message: string;
+        actual?: number;
+        limit?: number;
+    }[];
+}
+/** 이 판올림이 읽을 수 있는 청사진 판. */
+export declare const SUPPORTED_BLUEPRINT_VERSION = 1;
+/**
+ * 청사진의 형태를 확인한다 — **읽기 전에 한 번**, 등록 시점에.
+ *
+ * 그리는 시점이 아니라 등록 시점에 보는 이유는, 잘못된 청사진이 프레임마다 조용히
+ * 실패하는 대신 등록에서 한 번 크게 실패하게 하려는 것이다.
+ *
+ * 문제를 찾으면 사람이 읽을 수 있는 사유 목록을 돌려준다. 비어 있으면 읽을 수 있다.
+ */
+export declare function blueprintProblems(value: unknown): string[];
+//# sourceMappingURL=figure-blueprint.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,283 @@
+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';
+declare const FigureInstance_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;
+export declare class FigureInstance extends FigureInstance_base {
+    /**
+     * 이 타입을 그리는 것이 FigureInstance 임을 등록한다. `registerFigure()` 가 부른다.
+     *
+     * 청사진 등록과 컴포넌트 타입 등록이 늘 함께 일어나야, 보드가 `type` 만 적고도
+     * 세워진다.
+     */
+    static registerType(type: string): void;
+    get hasTextProperty(): boolean;
+    is3dish(): boolean;
+    get nature(): ComponentNature;
+    buildRealObject(): IRealObject | undefined;
+    /** 이 인스턴스가 그리는 청사진. 등록이 지워졌으면 null 이다. */
+    get figure(): import("./figure-registry.js").PreparedFigure | null;
+    render(ctx: SceneRenderContext): void;
+    /** 부품 하나의 톱뷰 윤곽을 현재 path 에 그린다. */
+    private tracePart;
+    /**
+     * 청사진을 못 찾았을 때. **빈 자리로 두지 않는다** — 아무것도 안 그리면 보는 사람은
+     * 컴포넌트가 없는 것인지 청사진이 없는 것인지 알 수 없다. 자리와 타입 이름을 보인다.
+     */
+    private renderMissing;
+    /**
+     * Shape 의 drawFill·drawStroke 를 타지 않는다.
+     *
+     * 부품마다 제 색으로 이미 칠했다. 그리고 인스턴스의 `fillStyle` 은 「청사진 색을
+     * 전부 덮어라」는 뜻이 아니다 — 그렇게 읽으면 저작한 색이 통째로 사라진다.
+     */
+    postrender(context: SceneRenderContext): void;
+}
+export default FigureInstance;
+//# sourceMappingURL=figure-instance.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,37 @@
+/**
+ * 팔레트 — 청사진의 색 **토큰**을 실제 색으로 옮긴다.
+ *
+ * 청사진은 `'#4a9eff'` 가 아니라 `'palette.primary'` 를 담는다. 값을 구우면 테마를
+ * 바꿔도 따라오지 않고, 저작한 자산 수백 개를 하나씩 고쳐야 한다.
+ *
+ * 토큰 수를 적게 두는 것은 미감과 성능 양쪽의 근거다 — 색이 적으면 화면이 정돈되고,
+ * MaterialBank 의 키도 그만큼만 생긴다.
+ */
+export type FigurePalette = Readonly<Record<string, string>>;
+/**
+ * 기본 팔레트.
+ *
+ * **여기 든 이름이 저작에서 고를 수 있는 전부다.** 자유색을 허용하지 않는 것이
+ * 「감각적인 로우폴리」의 첫 규칙이고, 동시에 재질 키를 묶는 근거다.
+ */
+export declare const DEFAULT_PALETTE: FigurePalette;
+/** 팔레트가 바뀔 때마다 오른다. 해석해 둔 색을 다시 풀어야 하는지 판단하는 데 쓴다. */
+export declare function paletteVersion(): number;
+/** 팔레트를 등록한다. 같은 이름이면 갈아 끼운다. */
+export declare function registerPalette(name: string, palette: FigurePalette): void;
+/** 쓸 팔레트를 고른다. 없는 이름이면 던진다 — 조용히 기본으로 돌아가지 않는다. */
+export declare function setActivePalette(name: string): void;
+export declare function activePaletteName(): string;
+export declare function activePalette(): FigurePalette;
+/**
+ * 토큰을 색으로 옮긴다. **모르는 토큰이면 던진다.**
+ *
+ * 회색 같은 것으로 갈음하지 않는다 — 그러면 저작자는 자기가 고른 색이 안 나온 것을
+ * 팔레트 탓인지 저작 실수인지 알 수 없다. 등록 시점에 한 번 크게 실패하는 편이 낫다.
+ */
+export declare function resolveToken(token: string): string;
+/** 토큰이 없는 부품에 쓸 색. 청사진이 색을 안 정했다는 뜻이지 오류는 아니다. */
+export declare const UNTOKENED_COLOR: string;
+/** 시험을 위해 처음 상태로 되돌린다. */
+export declare function resetPalettes(): void;
+//# sourceMappingURL=figure-palette.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-palette.d.ts","sourceRoot":"","sources":["../../src/figure/figure-palette.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,aAO7B,CAAA;AAOD,sDAAsD;AACtD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAG1E;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CASnD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,kDAAkD;AAClD,eAAO,MAAM,eAAe,QAAsC,CAAA;AAElE,0BAA0B;AAC1B,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

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

@@ -0,0 +1,73 @@
+import * as THREE from 'three';
+import { RealObject } from '../threed/real-object.js';
+import type { TopOutline } from '../interfaces/real-object.js';
+import type { PreparedFigure } from './figure-registry.js';
+import type { FigureBlueprintMember } from './figure-blueprint.js';
+/**
+ * 저작한 Figure 의 3D 표현.
+ *
+ * ## 어떻게 서나
+ *
+ *   object3d   묶음마다 mesh 하나를 자식으로 둔다
+ *              배율 = state.scale × dimensionScale(bounds ÷ base)
+ *    ├ mesh(묶음 0)   공유 병합 geometry + 공유 material
+ *    └ mesh(묶음 1)
+ *
+ * 치수는 `RealObject.dimensionScale` 에 실는다. 엔진이 state.scale·애니메이션과
+ * **곱해서** 반영하므로 서로 덮지 않는다. Figure 만 다른 구조를 쓸 이유가 없다.
+ *
+ * ## 무엇이 공유되고 무엇이 인스턴스마다 생기나
+ *
+ * **geometry 는 타입·묶음당 하나다.** 부품들을 base 좌표계에서 미리 합쳐 두고
+ * GeometryBank 에 넣는다. 인스턴스가 500개든 5,000개든 정점 버퍼는 묶음 수만큼만
+ * 있다. **material 도 마찬가지로 MaterialBank 가 공유한다.**
+ *
+ * **Mesh 객체는 인스턴스마다 생긴다.** three.js 에서 한 객체는 부모가 하나뿐이고 자기
+ * 행렬을 가지므로 같은 Mesh 를 여러 자리에 놓을 수 없다. 다만 Mesh 는 껍데기다 —
+ * geometry·material 참조와 행렬만 든다. 진짜로 객체까지 하나가 되는 길은
+ * `InstancedMesh` 이고, 그것은 인스턴스별 선택·컬링·재질을 다르게 다뤄야 해서 별개
+ * 결정이다.
+ */
+/** base 좌표 → three 좌표. 모델 x→X, **모델 z(높이)→Y**, 모델 y→Z. */
+export declare function memberGeometry(member: FigureBlueprintMember): THREE.BufferGeometry | null;
+/**
+ * 한 묶음의 부품들을 하나로 합친다. **타입·묶음당 한 번만** 만들고 창고에 둔다 —
+ * 같은 (타입, 묶음)이면 몇 번을 불러도 **같은 객체**가 나온다. 공유가 실제로
+ * 일어나는지 시험이 확인할 수 있게 내보낸다.
+ *
+ * 합친 결과는 base 좌표계이고 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` 로 나뉘어 형상이 납작하게 눌린다.
+     *
+     * **저작한 비례를 지킨다** — 평면 두 축이 커진 만큼 높이도 커진다. 배치 크기가
+     * 템플릿의 비율로 처리된다는 것이 이 뜻이다. 두 축의 기하평균을 쓰므로 한 축만 늘여도
+     * 덜 왜곡된다. `state.depth` 를 적었으면 그것이 이긴다.
+     */
+    get effectiveDepth(): number;
+    /**
+     * 인스턴스 치수를 **배율로만** 준다 — geometry 는 건드리지 않으므로 인스턴스가
+     * 늘어도 정점 버퍼가 늘지 않는다.
+     */
+    updateDimension(): void;
+    /**
+     * Figure 는 부품이 여럿이라 **하나의 폐다각형이 아니다.** 2D 표현은 컴포넌트가
+     * 부품마다 그리므로(`FigureInstance.render`) 여기서 윤곽을 지어내지 않는다.
+     * 경계상자를 돌려주면 부르는 쪽이 그것을 실제 윤곽으로 오해한다.
+     */
+    topOutline(): TopOutline | null;
+    clear(): THREE.Object3D<THREE.Object3DEventMap>;
+}
+//# sourceMappingURL=figure-real-object.d.ts.map

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

@@ -0,0 +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"}