@things-factory/figure-ui 10.1.34 → 10.1.36

package/dist-client/modeller/v3-product-session.d.ts

@@ -0,0 +1,366 @@
+import { type V3InputChange, type V3PrimitiveCreation, type V3PartEdit } from '@hatiolab/figure-model';
+export interface V3ProductRecord {
+    id: string;
+    source: string;
+}
+/** Persistence is injected; neither the model engine nor the renderer owns the product ID. */
+export interface V3ProductStore {
+    load(id: string): Promise<V3ProductRecord>;
+    save(request: {
+        id?: string;
+        source: string;
+        expectedSource?: string;
+        creationId?: string;
+    }): Promise<V3ProductRecord>;
+}
+/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */
+export declare function createV3ProductSession(store: V3ProductStore): {
+    read: () => {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    startNew({ discard }?: {
+        discard?: boolean | undefined;
+    }): {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    open(nextId: string, { discard }?: {
+        discard?: boolean | undefined;
+    }): Promise<{
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    }>;
+    close({ discard }?: {
+        discard?: boolean | undefined;
+    }): {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    apply(changes: V3InputChange[], origin?: "ui" | "ai", expectedRevision?: number, context?: string): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    add(part: V3PrimitiveCreation): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    edit(edit: V3PartEdit): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    undo(): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    redo(): {
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    source(): string;
+    save(): Promise<{
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        dirty: boolean;
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+    } | {
+        id: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        dirty: boolean;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: {
+            value: number;
+            id: string;
+            unit: import("@hatiolab/figure-model").V3Unit;
+            min: number;
+            max: number;
+            role?: "design" | "state";
+        }[];
+        geometry: import("@hatiolab/figure-model").V3AssetGeometry[];
+        bindings: import("@hatiolab/figure-model").V3EvaluatedBinding[];
+        palette: Record<string, string>;
+    }>;
+};
+export type V3ProductSession = ReturnType<typeof createV3ProductSession>;

package/dist-client/modeller/v3-product-session.js

@@ -0,0 +1,130 @@
+import { createV3Asset, createV3EditorWorkspace, serializeV3Asset, parseV3Asset } from '@hatiolab/figure-model';
+/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */
+export function createV3ProductSession(store) {
+    const workspace = createV3EditorWorkspace();
+    let epoch = 0, id, baseline;
+    let loading = false, saving = false, error;
+    let creationId;
+    function read() {
+        return { ...workspace.read(), id, loading, saving, error };
+    }
+    function writable() {
+        const view = workspace.read();
+        if (loading || error || !view.context || view.revision === null)
+            throw Error('먼저 모델을 정상적으로 열어 주세요.');
+        // Serializing writes also makes create retries safe: no second create while the first is pending.
+        if (saving)
+            throw Error('저장이 끝난 뒤 편집해 주세요.');
+        return { context: view.context, expectedRevision: view.revision, origin: 'ui' };
+    }
+    function clear() {
+        workspace.close({ discardDesignChanges: true });
+        id = undefined;
+        baseline = undefined;
+        error = undefined;
+        saving = false;
+        creationId = undefined;
+    }
+    function canLeave(discard) {
+        if (saving)
+            throw Error('저장이 끝난 뒤 모델을 전환해 주세요.');
+        if (workspace.read().dirty && !discard)
+            throw Error('저장하지 않은 변경이 있습니다.');
+    }
+    return {
+        read,
+        startNew({ discard = false } = {}) {
+            canLeave(discard);
+            ++epoch;
+            clear();
+            loading = false;
+            workspace.open(serializeV3Asset(createV3Asset('새 Figure')));
+            creationId = crypto.randomUUID();
+            return read();
+        },
+        async open(nextId, { discard = false } = {}) {
+            canLeave(discard);
+            const requestEpoch = ++epoch;
+            clear();
+            loading = true;
+            try {
+                const record = await store.load(nextId);
+                if (requestEpoch !== epoch)
+                    return read();
+                if (record.id !== nextId)
+                    throw Error('요청한 Figure와 응답의 대상이 다릅니다.');
+                workspace.open(record.source);
+                id = nextId;
+                baseline = record.source;
+            }
+            catch (cause) {
+                if (requestEpoch === epoch)
+                    error = cause instanceof Error ? cause.message : String(cause);
+            }
+            finally {
+                if (requestEpoch === epoch)
+                    loading = false;
+            }
+            return read();
+        },
+        close({ discard = false } = {}) {
+            canLeave(discard);
+            ++epoch;
+            clear();
+            loading = false;
+            return read();
+        },
+        apply(changes, origin = 'ui', expectedRevision, context) {
+            const control = writable();
+            // AI must supply the context AND revision captured when it started. Never substitute current values.
+            if (origin === 'ai' && (context === undefined || expectedRevision === undefined))
+                throw Error('AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.');
+            return workspace.apply({
+                ...control,
+                origin,
+                context: context ?? control.context,
+                expectedRevision: expectedRevision ?? control.expectedRevision,
+                changes
+            });
+        },
+        add(part) {
+            return workspace.addPrimitive({ ...writable(), part });
+        },
+        edit(edit) {
+            return workspace.editPart({ ...writable(), edit });
+        },
+        undo() {
+            return workspace.undo(writable());
+        },
+        redo() {
+            return workspace.redo(writable());
+        },
+        source() {
+            const { context } = writable();
+            return workspace.export({ context }).text;
+        },
+        async save() {
+            const control = writable(), requestEpoch = epoch;
+            const exported = workspace.export(control);
+            saving = true;
+            try {
+                const record = await store.save({ id, source: exported.text, expectedSource: baseline, creationId });
+                if (requestEpoch !== epoch)
+                    return read();
+                if (!record.id || (id !== undefined && record.id !== id))
+                    throw Error('저장 응답의 Figure 대상이 다릅니다.');
+                if (serializeV3Asset(parseV3Asset(record.source)) !== exported.text)
+                    throw Error('저장 응답이 보낸 모델과 다릅니다. 저장 상태를 다시 확인해 주세요.');
+                workspace.acknowledgeSaved(exported);
+                id = record.id;
+                baseline = record.source;
+            }
+            finally {
+                if (requestEpoch === epoch)
+                    saving = false;
+            }
+            return read();
+        }
+    };
+}
+//# sourceMappingURL=v3-product-session.js.map

package/dist-client/modeller/v3-product-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-product-session.js","sourceRoot":"","sources":["../../client/modeller/v3-product-session.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createV3Asset,\n  createV3EditorWorkspace,\n  serializeV3Asset,\n  parseV3Asset,\n  type V3InputChange,\n  type V3PrimitiveCreation,\n  type V3PartEdit\n} from '@hatiolab/figure-model'\n\nexport interface V3ProductRecord {\n  id: string\n  source: string\n}\n\n/** Persistence is injected; neither the model engine nor the renderer owns the product ID. */\nexport interface V3ProductStore {\n  load(id: string): Promise<V3ProductRecord>\n  save(request: { id?: string; source: string; expectedSource?: string; creationId?: string }): Promise<V3ProductRecord>\n}\n\n/** Product lifecycle boundary. A late response can never change another editor's asset or ID. */\nexport function createV3ProductSession(store: V3ProductStore) {\n  const workspace = createV3EditorWorkspace()\n  let epoch = 0,\n    id: string | undefined,\n    baseline: string | undefined\n  let loading = false,\n    saving = false,\n    error: string | undefined\n  let creationId: string | undefined\n  function read() {\n    return { ...workspace.read(), id, loading, saving, error }\n  }\n  function writable() {\n    const view = workspace.read()\n    if (loading || error || !view.context || view.revision === null) throw Error('먼저 모델을 정상적으로 열어 주세요.')\n    // Serializing writes also makes create retries safe: no second create while the first is pending.\n    if (saving) throw Error('저장이 끝난 뒤 편집해 주세요.')\n    return { context: view.context, expectedRevision: view.revision, origin: 'ui' as const }\n  }\n  function clear() {\n    workspace.close({ discardDesignChanges: true })\n    id = undefined\n    baseline = undefined\n    error = undefined\n    saving = false\n    creationId = undefined\n  }\n  function canLeave(discard: boolean) {\n    if (saving) throw Error('저장이 끝난 뒤 모델을 전환해 주세요.')\n    if (workspace.read().dirty && !discard) throw Error('저장하지 않은 변경이 있습니다.')\n  }\n  return {\n    read,\n    startNew({ discard = false } = {}) {\n      canLeave(discard)\n      ++epoch\n      clear()\n      loading = false\n      workspace.open(serializeV3Asset(createV3Asset('새 Figure')))\n      creationId = crypto.randomUUID()\n      return read()\n    },\n    async open(nextId: string, { discard = false } = {}) {\n      canLeave(discard)\n      const requestEpoch = ++epoch\n      clear()\n      loading = true\n      try {\n        const record = await store.load(nextId)\n        if (requestEpoch !== epoch) return read()\n        if (record.id !== nextId) throw Error('요청한 Figure와 응답의 대상이 다릅니다.')\n        workspace.open(record.source)\n        id = nextId\n        baseline = record.source\n      } catch (cause) {\n        if (requestEpoch === epoch) error = cause instanceof Error ? cause.message : String(cause)\n      } finally {\n        if (requestEpoch === epoch) loading = false\n      }\n      return read()\n    },\n    close({ discard = false } = {}) {\n      canLeave(discard)\n      ++epoch\n      clear()\n      loading = false\n      return read()\n    },\n    apply(changes: V3InputChange[], origin: 'ui' | 'ai' = 'ui', expectedRevision?: number, context?: string) {\n      const control = writable()\n      // AI must supply the context AND revision captured when it started. Never substitute current values.\n      if (origin === 'ai' && (context === undefined || expectedRevision === undefined))\n        throw Error('AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.')\n      return workspace.apply({\n        ...control,\n        origin,\n        context: context ?? control.context,\n        expectedRevision: expectedRevision ?? control.expectedRevision,\n        changes\n      })\n    },\n    add(part: V3PrimitiveCreation) {\n      return workspace.addPrimitive({ ...writable(), part })\n    },\n    edit(edit: V3PartEdit) {\n      return workspace.editPart({ ...writable(), edit })\n    },\n    undo() {\n      return workspace.undo(writable())\n    },\n    redo() {\n      return workspace.redo(writable())\n    },\n    source() {\n      const { context } = writable()\n      return workspace.export({ context }).text\n    },\n    async save() {\n      const control = writable(),\n        requestEpoch = epoch\n      const exported = workspace.export(control)\n      saving = true\n      try {\n        const record = await store.save({ id, source: exported.text, expectedSource: baseline, creationId })\n        if (requestEpoch !== epoch) return read()\n        if (!record.id || (id !== undefined && record.id !== id)) throw Error('저장 응답의 Figure 대상이 다릅니다.')\n        if (serializeV3Asset(parseV3Asset(record.source)) !== exported.text)\n          throw Error('저장 응답이 보낸 모델과 다릅니다. 저장 상태를 다시 확인해 주세요.')\n        workspace.acknowledgeSaved(exported)\n        id = record.id\n        baseline = record.source\n      } finally {\n        if (requestEpoch === epoch) saving = false\n      }\n      return read()\n    }\n  }\n}\nexport type V3ProductSession = ReturnType<typeof createV3ProductSession>\n"]}

package/dist-client/modeller/v3-renderer.d.ts

@@ -0,0 +1,31 @@
+import * as THREE from 'three';
+/** Evaluated V3 boundary: graph values are resolved before reaching the renderer. */
+export interface V3RenderPart {
+    id: string;
+    shape: {
+        provider: string;
+        dimensions: Record<string, number>;
+        profile?: Array<{
+            x: number;
+            y: number;
+        }>;
+    };
+    pose: {
+        r: number[][];
+        t: number[];
+    };
+    material: {
+        token: string;
+        preset?: string;
+        transparent?: boolean;
+        emissive?: {
+            token: string;
+            intensity: number;
+            on: boolean;
+        };
+    };
+    segments?: number;
+}
+export declare function disposeV3Meshes(group: THREE.Group): void;
+/** Build first, then swap; failed rendering must not erase the previous scene. No old meshes survive a successful swap. */
+export declare function replaceV3Meshes(group: THREE.Group, parts: readonly V3RenderPart[], palette: Record<string, string>): void;

package/dist-client/modeller/v3-renderer.js

@@ -0,0 +1,81 @@
+import * as THREE from 'three';
+function geometry(part) {
+    const d = part.shape.dimensions;
+    let g;
+    if (part.shape.provider === 'box')
+        g = new THREE.BoxGeometry(d.width, d.height, d.depth);
+    else if (part.shape.provider === 'cylinder')
+        g = new THREE.CylinderGeometry(d.radius, d.radius, d.length, part.segments ?? 12);
+    else if (part.shape.provider === 'roundedBox') {
+        const w = d.width / 2, z = d.depth / 2, r = d.round, s = new THREE.Shape();
+        s.moveTo(-w + r, -z);
+        s.lineTo(w - r, -z);
+        s.quadraticCurveTo(w, -z, w, -z + r);
+        s.lineTo(w, z - r);
+        s.quadraticCurveTo(w, z, w - r, z);
+        s.lineTo(-w + r, z);
+        s.quadraticCurveTo(-w, z, -w, z - r);
+        s.lineTo(-w, -z + r);
+        s.quadraticCurveTo(-w, -z, -w + r, -z);
+        g = new THREE.ExtrudeGeometry(s, { depth: d.height, bevelEnabled: false, steps: 1, curveSegments: 6 });
+        g.rotateX(Math.PI / 2);
+        g.translate(0, d.height / 2, 0);
+    }
+    else if (part.shape.provider === 'portal') {
+        if (!part.shape.profile?.length)
+            throw Error('Portal profile is missing');
+        const s = new THREE.Shape(part.shape.profile.map(p => new THREE.Vector2(p.x, p.y)));
+        g = new THREE.ExtrudeGeometry(s, { depth: d.depth, bevelEnabled: false, steps: 1 });
+        g.translate(0, 0, -d.depth / 2);
+    }
+    else
+        throw Error('Unsupported V3 provider: ' + part.shape.provider);
+    return g;
+}
+export function disposeV3Meshes(group) {
+    for (const child of [...group.children]) {
+        if (child instanceof THREE.Mesh) {
+            child.geometry.dispose();
+            const materials = Array.isArray(child.material) ? child.material : [child.material];
+            materials.forEach(m => m.dispose());
+        }
+        group.remove(child);
+    }
+}
+/** Build first, then swap; failed rendering must not erase the previous scene. No old meshes survive a successful swap. */
+export function replaceV3Meshes(group, parts, palette) {
+    const staged = new THREE.Group(), ids = new Set();
+    try {
+        for (const part of parts) {
+            if (ids.has(part.id))
+                throw Error('Duplicate V3 geometry ID: ' + part.id);
+            ids.add(part.id);
+            const color = palette[part.material.token];
+            if (!color || !/^#[0-9a-f]{6}$/i.test(color))
+                throw Error('Unresolved material token: ' + part.material.token);
+            const { r, t } = part.pose;
+            if (r.length !== 3 || r.some(row => row.length !== 3 || row.some(x => !Number.isFinite(x))) || t.length !== 3 || t.some(x => !Number.isFinite(x)))
+                throw Error('Invalid V3 pose: ' + part.id);
+            const emissive = part.material.emissive;
+            if (emissive?.on && !/^#[0-9a-f]{6}$/i.test(palette[emissive.token] ?? ''))
+                throw Error('Unresolved emissive token');
+            const g = geometry(part);
+            const material = new THREE.MeshStandardMaterial({ color, metalness: part.material.preset === 'metal' ? 0.8 : 0, roughness: part.material.preset === 'metal' ? 0.3 : 0.65, transparent: !!part.material.transparent, opacity: part.material.transparent ? 0.35 : 1, emissive: emissive?.on ? palette[emissive.token] : 0, emissiveIntensity: emissive?.on ? emissive.intensity : 0 });
+            const mesh = new THREE.Mesh(g, material);
+            mesh.name = part.id;
+            mesh.userData.figurePartId = part.id;
+            mesh.matrixAutoUpdate = false;
+            mesh.matrix.set(r[0][0], r[0][1], r[0][2], t[0], r[1][0], r[1][1], r[1][2], t[1], r[2][0], r[2][1], r[2][2], t[2], 0, 0, 0, 1);
+            staged.add(mesh);
+        }
+    }
+    catch (error) {
+        disposeV3Meshes(staged);
+        throw error;
+    }
+    disposeV3Meshes(group);
+    for (const mesh of [...staged.children])
+        group.add(mesh);
+    group.updateMatrixWorld(true);
+}
+//# sourceMappingURL=v3-renderer.js.map

package/dist-client/modeller/v3-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-renderer.js","sourceRoot":"","sources":["../../client/modeller/v3-renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\n\n/** Evaluated V3 boundary: graph values are resolved before reaching the renderer. */\nexport interface V3RenderPart {\n  id: string\n  shape: { provider: string; dimensions: Record<string, number>; profile?: Array<{x:number;y:number}> }\n  pose: {r:number[][];t:number[]}\n  material: {token:string;preset?:string;transparent?:boolean;emissive?:{token:string;intensity:number;on:boolean}}\n  segments?:number\n}\n\nfunction geometry(part:V3RenderPart):THREE.BufferGeometry {\n const d=part.shape.dimensions\n let g:THREE.BufferGeometry\n if(part.shape.provider==='box')g=new THREE.BoxGeometry(d.width,d.height,d.depth)\n else if(part.shape.provider==='cylinder')g=new THREE.CylinderGeometry(d.radius,d.radius,d.length,part.segments??12)\n else if(part.shape.provider==='roundedBox'){\n  const w=d.width/2,z=d.depth/2,r=d.round,s=new THREE.Shape()\n  s.moveTo(-w+r,-z);s.lineTo(w-r,-z);s.quadraticCurveTo(w,-z,w,-z+r)\n  s.lineTo(w,z-r);s.quadraticCurveTo(w,z,w-r,z);s.lineTo(-w+r,z)\n  s.quadraticCurveTo(-w,z,-w,z-r);s.lineTo(-w,-z+r);s.quadraticCurveTo(-w,-z,-w+r,-z)\n  g=new THREE.ExtrudeGeometry(s,{depth:d.height,bevelEnabled:false,steps:1,curveSegments:6})\n  g.rotateX(Math.PI/2);g.translate(0,d.height/2,0)\n }else if(part.shape.provider==='portal'){\n  if(!part.shape.profile?.length)throw Error('Portal profile is missing')\n  const s=new THREE.Shape(part.shape.profile.map(p=>new THREE.Vector2(p.x,p.y)))\n  g=new THREE.ExtrudeGeometry(s,{depth:d.depth,bevelEnabled:false,steps:1});g.translate(0,0,-d.depth/2)\n }else throw Error('Unsupported V3 provider: '+part.shape.provider)\n return g\n}\n\nexport function disposeV3Meshes(group:THREE.Group):void {\n for(const child of [...group.children]){\n  if(child instanceof THREE.Mesh){child.geometry.dispose();const materials=Array.isArray(child.material)?child.material:[child.material];materials.forEach(m=>m.dispose())}\n  group.remove(child)\n }\n}\n\n/** Build first, then swap; failed rendering must not erase the previous scene. No old meshes survive a successful swap. */\nexport function replaceV3Meshes(group:THREE.Group,parts:readonly V3RenderPart[],palette:Record<string,string>):void {\n const staged=new THREE.Group(),ids=new Set<string>()\n try{\n  for(const part of parts){\n   if(ids.has(part.id))throw Error('Duplicate V3 geometry ID: '+part.id);ids.add(part.id)\n   const color=palette[part.material.token]\n   if(!color||!/^#[0-9a-f]{6}$/i.test(color))throw Error('Unresolved material token: '+part.material.token)\n   const {r,t}=part.pose\n   if(r.length!==3||r.some(row=>row.length!==3||row.some(x=>!Number.isFinite(x)))||t.length!==3||t.some(x=>!Number.isFinite(x)))throw Error('Invalid V3 pose: '+part.id)\n   const emissive=part.material.emissive\n   if(emissive?.on&&!/^#[0-9a-f]{6}$/i.test(palette[emissive.token]??''))throw Error('Unresolved emissive token')\n   const g=geometry(part)\n   const material=new THREE.MeshStandardMaterial({color,metalness:part.material.preset==='metal'?0.8:0,roughness:part.material.preset==='metal'?0.3:0.65,transparent:!!part.material.transparent,opacity:part.material.transparent?0.35:1,emissive:emissive?.on?palette[emissive.token]:0,emissiveIntensity:emissive?.on?emissive.intensity:0})\n   const mesh=new THREE.Mesh(g,material);mesh.name=part.id;mesh.userData.figurePartId=part.id\n   mesh.matrixAutoUpdate=false;mesh.matrix.set(r[0][0],r[0][1],r[0][2],t[0],r[1][0],r[1][1],r[1][2],t[1],r[2][0],r[2][1],r[2][2],t[2],0,0,0,1)\n   staged.add(mesh)\n  }\n }catch(error){disposeV3Meshes(staged);throw error}\n disposeV3Meshes(group)\n for(const mesh of [...staged.children])group.add(mesh)\n group.updateMatrixWorld(true)\n}\n"]}

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

@@ -41,6 +41,7 @@ export declare class FigureModellerPage extends FigureModellerPageBase {
      * 미저장 표시(`dirty`)는 그대로 남으므로 데이터를 잃지는 않았다. 잃은 것은 **사유**다.
      */
     private saveFailure;
+    private sourceLoadFailure;
     private showSaveModal;
     private saveModalType;
     private saveModalName;
@@ -217,6 +218,12 @@ export declare class FigureModellerPage extends FigureModellerPageBase {
      * 그래도 저장은 저작자의 별도 행위다. 잘못 눌러도 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;
     /**
      * 고른 변경을 받아들인다.
      *