@faicad/faijs 0.22.2 → 0.29.3

package/dist/mesh/threemf-bambu.js

@@ -0,0 +1,334 @@
+const KNOWN_EXTENSIONS = new Set(['stl', 'step', 'stp', '3mf']);
+/** Remove a known 3D file extension from a filename.
+ *
+ * @param name - the entry name, possibly ending in `.3mf`, `.stl`, `.step`, `.stp`
+ *   (optionally suffixed `_<n>` for multi-plate objects).
+ * @returns the name without the known extension.
+ */
+export function stripExtension(name) {
+    const extPattern = Array.from(KNOWN_EXTENSIONS).join('|');
+    const multiRe = new RegExp(`^(.+)\\.(?:${extPattern})_(\\d+)$`, 'i');
+    const multiMatch = name.match(multiRe);
+    if (multiMatch)
+        return `${multiMatch[1]}_${multiMatch[2]}`;
+    const singleRe = new RegExp(`^(.+)\\.(?:${extPattern})$`, 'i');
+    const singleMatch = name.match(singleRe);
+    if (singleMatch)
+        return singleMatch[1];
+    return name;
+}
+/** Parse `<build>` section object IDs and transforms from 3D/3dmodel.model XML.
+ *
+ * @param xml - the raw 3D model XML text.
+ * @returns the build items (objectId + optional print transform).
+ */
+export function parse3mfBuild(xml) {
+    const items = [];
+    const itemRe = /<item\s+objectid="(\d+)"[^>]*\/?>/g;
+    let m;
+    while ((m = itemRe.exec(xml)) !== null) {
+        const objectId = m[1];
+        const transformMatch = m[0].match(/transform="([^"]*)"/);
+        const transform = transformMatch ? transformMatch[1].split(/\s+/).map(Number) : null;
+        items.push({ objectId, transform });
+    }
+    return items;
+}
+/** Parse model-level `<metadata name="...">…</metadata>` tags (3MF standard).
+ *
+ * @param xml - the raw 3D model XML text.
+ * @returns the recognised model meta fields plus every raw metadata entry.
+ */
+export function parseModelMeta(xml) {
+    const meta = {};
+    const entries = [];
+    const re = /<metadata\s+name="([^"]*)"[^>]*>([\s\S]*?)<\/metadata>/gi;
+    let m;
+    while ((m = re.exec(xml)) !== null) {
+        const name = m[1];
+        const value = m[2].trim();
+        entries.push({ name, value });
+        if (name === 'Title')
+            meta.title = value;
+        else if (name === 'Designer')
+            meta.designer = value;
+        else if (name === 'Description')
+            meta.description = value;
+        else if (name === 'License')
+            meta.license = value;
+    }
+    return { modelMeta: Object.keys(meta).length > 0 ? meta : undefined, metadataEntries: entries };
+}
+/** Known 3MF thumbnail PNG paths, in priority order. */
+const THUMBNAIL_PATHS = [
+    'MetaData/thumbnail.png',
+    'Auxiliaries/.thumbnails/thumbnail_3mf.png',
+    'Auxiliaries/.thumbnails/thumbnail_middle.png',
+    'Auxiliaries/.thumbnails/thumbnail_small.png',
+];
+/** Extract a standard 3MF thumbnail PNG from an entry table (raw bytes).
+ *
+ * @param entries - the unzipped 3MF entry table (path -> bytes).
+ * @returns the PNG bytes of the first matching thumbnail, or undefined.
+ */
+export function extractThumbnailBytes(entries) {
+    const keys = [...entries.keys()];
+    for (const path of THUMBNAIL_PATHS) {
+        const entry = keys.find(k => k === path);
+        if (entry)
+            return entries.get(entry);
+    }
+    const metaDataEntry = keys.find(k => /^metadata\/thumbnail\.png$/i.test(k));
+    if (metaDataEntry)
+        return entries.get(metaDataEntry);
+    return undefined;
+}
+/** Parse Bambu Lab metadata from an already-unzipped entry table.
+ *
+ * @param extraEntries - the 3MF entry table excluding the geometry model shared
+ *   with `parseThreemf` (project_settings / model_settings configs + thumbnails).
+ * @returns the resolved `Bambu3mfMetadata`.
+ */
+export function parseBambu3mfFromEntries(extraEntries) {
+    const decoder = new TextDecoder();
+    const filamentColors = [];
+    const filamentTypes = [];
+    const objects = new Map();
+    const plates = new Map();
+    const objectParts = new Map();
+    const assembleTransforms = new Map();
+    const importTransforms = new Map();
+    // ---- 1. project_settings.config (JSON) ----
+    let bedSize;
+    const projKey = [...extraEntries.keys()].find(f => f.endsWith('project_settings.config'));
+    if (projKey) {
+        try {
+            const json = JSON.parse(decoder.decode(extraEntries.get(projKey)));
+            const rawColors = json.filament_colour ?? json.filament_color ?? [];
+            const cArr = Array.isArray(rawColors) ? rawColors : [rawColors];
+            for (const c of cArr) {
+                filamentColors.push(typeof c === 'string' ? c.replace(/^"(.*)"$/, '$1').trim() : String(c));
+            }
+            const fTypes = json.filament_type ?? [];
+            if (Array.isArray(fTypes)) {
+                for (const t of fTypes)
+                    filamentTypes.push(typeof t === 'string' ? t : String(t));
+            }
+            if (json.printable_area) {
+                const area = Array.isArray(json.printable_area) ? json.printable_area : [json.printable_area];
+                let maxX = 0;
+                let maxY = 0;
+                for (const pt of area) {
+                    const parts = String(pt).split('x');
+                    if (parts.length === 2) {
+                        const x = parseFloat(parts[0]);
+                        const y = parseFloat(parts[1]);
+                        if (Number.isFinite(x) && x > maxX)
+                            maxX = x;
+                        if (Number.isFinite(y) && y > maxY)
+                            maxY = y;
+                    }
+                }
+                const height = parseFloat(String(json.printable_height ?? '0'));
+                if (maxX > 0 && maxY > 0 && Number.isFinite(height) && height > 0) {
+                    bedSize = { width: maxX, depth: maxY, height };
+                }
+            }
+        }
+        catch {
+            /* ignore malformed project settings */
+        }
+    }
+    // ---- 2. model_settings.config (XML) ----
+    const msKey = [...extraEntries.keys()].find(f => f.endsWith('model_settings.config'));
+    if (msKey) {
+        const xml = decoder.decode(extraEntries.get(msKey));
+        const objBlockRe = /<object\s+id="(\d+)"[^>]*>([\s\S]*?)<\/object>/gi;
+        let objMatch;
+        while ((objMatch = objBlockRe.exec(xml)) !== null) {
+            const oid = objMatch[1];
+            const body = objMatch[2];
+            const topLevel = body.replace(/<part[^>]*>[\s\S]*?<\/part>/gi, '');
+            let objName = '';
+            let objExtruder = 1;
+            const metaRe = /<metadata\s+key="([^"]*)"\s+value="([^"]*)"\s*\/?>/gi;
+            let mm;
+            while ((mm = metaRe.exec(topLevel)) !== null) {
+                if (mm[1] === 'name')
+                    objName = mm[2];
+                if (mm[1] === 'extruder')
+                    objExtruder = parseInt(mm[2], 10) || 1;
+            }
+            objects.set(oid, { objectId: oid, name: objName, extruder: objExtruder, plateId: 0 });
+            const partList = [];
+            const partBlockRe = /<part\s+id="(\d+)"[^>]*>([\s\S]*?)<\/part>/gi;
+            let pm;
+            while ((pm = partBlockRe.exec(body)) !== null) {
+                const pid = pm[1];
+                const partBody = pm[2];
+                let partName = objName;
+                let partExtruder = objExtruder;
+                const pmRe = /<metadata\s+key="([^"]*)"\s+value="([^"]*)"\s*\/?>/gi;
+                let pmm;
+                while ((pmm = pmRe.exec(partBody)) !== null) {
+                    if (pmm[1] === 'name')
+                        partName = pmm[2];
+                    if (pmm[1] === 'extruder')
+                        partExtruder = parseInt(pmm[2], 10) || objExtruder;
+                }
+                partList.push({ partId: pid, name: partName, extruder: partExtruder });
+            }
+            if (partList.length === 0) {
+                partList.push({ partId: '0', name: objName, extruder: objExtruder });
+            }
+            objectParts.set(oid, partList);
+        }
+        // 2c. <plate> blocks
+        const plateBlockRe = /<plate>([\s\S]*?)<\/plate>/gi;
+        let plateMatch;
+        while ((plateMatch = plateBlockRe.exec(xml)) !== null) {
+            const plateBody = plateMatch[1];
+            let platerId = 0;
+            let platerName = '';
+            const pmRe2 = /<metadata\s+key="([^"]*)"\s+value="([^"]*)"\s*\/?>/gi;
+            let m2;
+            while ((m2 = pmRe2.exec(plateBody)) !== null) {
+                if (m2[1] === 'plater_id')
+                    platerId = parseInt(m2[2], 10) || 0;
+                if (m2[1] === 'plater_name')
+                    platerName = m2[2];
+            }
+            if (platerId > 0) {
+                plates.set(platerId, { plateId: platerId, plateName: platerName, size: bedSize });
+            }
+            const instRe = /<model_instance>([\s\S]*?)<\/model_instance>/gi;
+            let im;
+            while ((im = instRe.exec(plateBody)) !== null) {
+                const oidMatch = /<metadata\s+key="object_id"\s+value="(\d+)"\s*\/?>/i.exec(im[1]);
+                if (oidMatch) {
+                    const obj = objects.get(oidMatch[1]);
+                    if (obj)
+                        obj.plateId = platerId;
+                }
+            }
+        }
+        // 2d. <assemble> — assembly transforms
+        const assembleBlock = xml.match(/<assemble>([\s\S]*?)<\/assemble>/i);
+        if (assembleBlock) {
+            const assembleItemRe = /<assemble_item\s+([^>]*)\/?>/gi;
+            let am;
+            while ((am = assembleItemRe.exec(assembleBlock[1])) !== null) {
+                const attrs = am[1];
+                const oidMatch = /object_id="(\d+)"/.exec(attrs);
+                const xformMatch = /transform="([^"]*)"/.exec(attrs);
+                const offsetMatch = /offset="([^"]*)"/.exec(attrs);
+                const oid = oidMatch?.[1];
+                if (oid && xformMatch) {
+                    const xform = xformMatch[1].split(/\s+/).map(Number);
+                    const offsetArr = offsetMatch ? offsetMatch[1].split(/\s+/).map(Number) : [0, 0, 0];
+                    if (xform.length === 12 && offsetArr.length === 3) {
+                        assembleTransforms.set(oid, {
+                            objectId: oid,
+                            transform: xform,
+                            offset: offsetArr,
+                        });
+                    }
+                }
+            }
+        }
+        // 2e. <part> matrix metadata (per-part import transforms)
+        const importObjBlockRe = /<object\s+id="(\d+)"[^>]*>([\s\S]*?)<\/object>/gi;
+        let importObjMatch;
+        while ((importObjMatch = importObjBlockRe.exec(xml)) !== null) {
+            const oid = importObjMatch[1];
+            const body = importObjMatch[2];
+            const importPartRe = /<part\s+id="(\d+)"[^>]*>([\s\S]*?)<\/part>/gi;
+            let ipm;
+            while ((ipm = importPartRe.exec(body)) !== null) {
+                const pid = ipm[1];
+                let matrix;
+                let sox = 0;
+                let soy = 0;
+                let soz = 0;
+                const imRe = /<metadata\s+key="([^"]*)"\s+value="([^"]*)"\s*\/?>/gi;
+                let imm;
+                while ((imm = imRe.exec(ipm[2])) !== null) {
+                    if (imm[1] === 'matrix')
+                        matrix = imm[2].split(/\s+/).map(Number);
+                    if (imm[1] === 'source_offset_x')
+                        sox = parseFloat(imm[2]) || 0;
+                    if (imm[1] === 'source_offset_y')
+                        soy = parseFloat(imm[2]) || 0;
+                    if (imm[1] === 'source_offset_z')
+                        soz = parseFloat(imm[2]) || 0;
+                }
+                if (matrix && matrix.length === 16) {
+                    importTransforms.set(`${oid}:${pid}`, {
+                        objectId: oid,
+                        partId: pid,
+                        matrix,
+                        sourceOffset: [sox, soy, soz],
+                    });
+                }
+            }
+        }
+    }
+    // ---- 3. Model-level metadata + build items from 3D/3dmodel.model ----
+    const thumbnailBytes = extractThumbnailBytes(extraEntries);
+    let modelMeta;
+    let metadataEntries = [];
+    let buildItems = [];
+    const modelFile = [...extraEntries.keys()].find(f => f.endsWith('/3dmodel.model') || f === '3D/3dmodel.model');
+    if (modelFile) {
+        const modelXml = decoder.decode(extraEntries.get(modelFile));
+        const resourcesStart = modelXml.indexOf('<resources>');
+        const resourcesEnd = modelXml.indexOf('</resources>');
+        const head = resourcesStart >= 0 ? modelXml.slice(0, resourcesStart) : modelXml;
+        const tail = resourcesEnd >= 0 ? modelXml.slice(resourcesEnd) : '';
+        const parsedHead = parseModelMeta(head);
+        const parsedTail = parseModelMeta(tail);
+        modelMeta = { ...parsedHead.modelMeta, ...parsedTail.modelMeta };
+        metadataEntries = [...parsedHead.metadataEntries, ...parsedTail.metadataEntries];
+        buildItems = parse3mfBuild(tail);
+    }
+    // ---- 4. Ordered flat parts list ----
+    const parts = [];
+    let partIndex = 0;
+    for (const item of buildItems) {
+        const oid = item.objectId;
+        const objMeta = objects.get(oid);
+        const partList = objectParts.get(oid) ?? [];
+        for (const p of partList) {
+            parts.push({
+                partIndex: partIndex++,
+                objectId: oid,
+                partId: p.partId,
+                name: stripExtension(p.name),
+                extruder: p.extruder,
+                plateId: objMeta?.plateId ?? 0,
+            });
+        }
+    }
+    return {
+        filamentColors,
+        filamentTypes,
+        objects,
+        parts,
+        plates,
+        modelMeta: modelMeta && Object.keys(modelMeta).length > 0 ? modelMeta : undefined,
+        metadataEntries,
+        thumbnailBytes,
+        assembleTransforms: assembleTransforms.size > 0 ? assembleTransforms : undefined,
+        importTransforms: importTransforms.size > 0 ? importTransforms : undefined,
+        buildItems: buildItems.length > 0 ? buildItems : undefined,
+    };
+}
+/** Parse Bambu metadata from a `ThreemfArchive`'s `extraEntries`.
+ *
+ * @param archive - a `ThreemfArchive` produced by `parseThreemf`.
+ * @returns the resolved `Bambu3mfMetadata`.
+ */
+export function parseBambu3mfFromArchive(archive) {
+    return parseBambu3mfFromEntries(archive.extraEntries);
+}
+//# sourceMappingURL=threemf-bambu.js.map

package/dist/mesh/threemf-bambu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threemf-bambu.js","sourceRoot":"","sources":["../../src/mesh/threemf-bambu.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * threemf-bambu — Bambu Lab private 3MF extensions (moved up from 3d_editor,\n * plan §8 decision 2).\n *\n * Bambu Studio stores non-standard metadata in:\n *   - `Metadata/project_settings.config`   (JSON — filament colours/types, bed)\n *   - `Metadata/model_settings.config`     (XML — objects, parts, plates,\n *     assemble/import transforms)\n * plus standard 3MF `<metadata>` / thumbnails.\n *\n * This module parses those from an already-unzipped entry table so the host's\n * single `parseThreemf` unzip feeds both the geometry and the Bambu metadata\n * layer (one unzip, two consumer chains — plan D4). Everything here is\n * environment-agnostic: no three.js, no `Blob`, no browser globals — the thumb\n * is returned as bytes and the host wraps it. Matrix helpers return plain 16x4\n * row-major number arrays (host converts to THREE.Matrix4).\n *\n * The parser mirrors the behaviour of the retired 3d_editor `bambu-3mf.ts` and\n * `viewTransforms.ts` so ModelGroup / DesktopLayout keep working unchanged\n * apart from the import source.\n */\nimport type { ThreemfArchive } from './threemf-loader'\n\nconst KNOWN_EXTENSIONS = new Set(['stl', 'step', 'stp', '3mf'])\n\n/** Remove a known 3D file extension from a filename.\n *\n * @param name - the entry name, possibly ending in `.3mf`, `.stl`, `.step`, `.stp`\n *   (optionally suffixed `_<n>` for multi-plate objects).\n * @returns the name without the known extension.\n */\nexport function stripExtension(name: string): string {\n  const extPattern = Array.from(KNOWN_EXTENSIONS).join('|')\n  const multiRe = new RegExp(`^(.+)\\\\.(?:${extPattern})_(\\\\d+)$`, 'i')\n  const multiMatch = name.match(multiRe)\n  if (multiMatch) return `${multiMatch[1]}_${multiMatch[2]}`\n  const singleRe = new RegExp(`^(.+)\\\\.(?:${extPattern})$`, 'i')\n  const singleMatch = name.match(singleRe)\n  if (singleMatch) return singleMatch[1]\n  return name\n}\n\n/** A Bambu model object (an `<object>` in model_settings.config). */\nexport interface BambuObjectMeta {\n  objectId: string\n  name: string\n  extruder: number\n  plateId: number\n}\n\n/** A part inside a Bambu object (a `<part>` in model_settings.config). */\nexport interface BambuPartMeta {\n  partIndex: number\n  objectId: string\n  partId: string\n  name: string\n  extruder: number\n  plateId: number\n}\n\n/** Build-plate printable-area size, in millimetres. */\nexport interface BambuPlateSize {\n  width: number\n  depth: number\n  height: number\n}\n\n/** A build plate in the project (id + display name + optional size). */\nexport interface BambuPlateInfo {\n  plateId: number\n  plateName: string\n  size?: BambuPlateSize\n}\n\n/** Model-level descriptive metadata (Title/Designer/Description/License). */\nexport interface BambuModelMeta {\n  title?: string\n  designer?: string\n  description?: string\n  license?: string\n}\n\n/** A `<build>-section `<item> entry: object id and its print transform. */\nexport interface BuildItem {\n  objectId: string\n  transform: number[] | null\n}\n\n/** An assembly pose for a Bambu object (an `<assemble_item` entry). */\nexport interface AssembleItemTransform {\n  objectId: string\n  /** 12-value 4×3 matrix (same format as build `<item transform>`). */\n  transform: number[]\n  /** Additional fine-tune translation [tx, ty, tz]. */\n  offset: [number, number, number]\n}\n\n/** A per-part import pose (4×4 matrix from model_settings.config). */\nexport interface PartImportTransform {\n  objectId: string\n  partId: string\n  /** 16-value 4×4 matrix (row-major). */\n  matrix: number[]\n  /** Additional import translation offset. */\n  sourceOffset: [number, number, number]\n}\n\n/** Everything parsed from a Bambu-labelled 3MF's private metadata layer. */\nexport interface Bambu3mfMetadata {\n  filamentColors: string[]\n  filamentTypes: string[]\n  objects: Map<string, BambuObjectMeta>\n  parts: BambuPartMeta[]\n  plates: Map<number, BambuPlateInfo>\n  modelMeta?: BambuModelMeta\n  metadataEntries: Array<{ name: string; value: string }>\n  /** Raw thumbnail PNG bytes, or undefined when absent. */\n  thumbnailBytes?: Uint8Array\n  assembleTransforms?: Map<string, AssembleItemTransform>\n  importTransforms?: Map<string, PartImportTransform>\n  buildItems?: BuildItem[]\n}\n\n/** Parse `<build>` section object IDs and transforms from 3D/3dmodel.model XML.\n *\n * @param xml - the raw 3D model XML text.\n * @returns the build items (objectId + optional print transform).\n */\nexport function parse3mfBuild(xml: string): BuildItem[] {\n  const items: BuildItem[] = []\n  const itemRe = /<item\\s+objectid=\"(\\d+)\"[^>]*\\/?>/g\n  let m: RegExpExecArray | null\n  while ((m = itemRe.exec(xml)) !== null) {\n    const objectId = m[1]\n    const transformMatch = m[0].match(/transform=\"([^\"]*)\"/)\n    const transform = transformMatch ? transformMatch[1].split(/\\s+/).map(Number) : null\n    items.push({ objectId, transform })\n  }\n  return items\n}\n\n/** Parse model-level `<metadata name=\"...\">…</metadata>` tags (3MF standard).\n *\n * @param xml - the raw 3D model XML text.\n * @returns the recognised model meta fields plus every raw metadata entry.\n */\nexport function parseModelMeta(xml: string): {\n  modelMeta: BambuModelMeta | undefined\n  metadataEntries: Array<{ name: string; value: string }>\n} {\n  const meta: BambuModelMeta = {}\n  const entries: Array<{ name: string; value: string }> = []\n  const re = /<metadata\\s+name=\"([^\"]*)\"[^>]*>([\\s\\S]*?)<\\/metadata>/gi\n  let m: RegExpExecArray | null\n  while ((m = re.exec(xml)) !== null) {\n    const name = m[1]\n    const value = m[2].trim()\n    entries.push({ name, value })\n    if (name === 'Title') meta.title = value\n    else if (name === 'Designer') meta.designer = value\n    else if (name === 'Description') meta.description = value\n    else if (name === 'License') meta.license = value\n  }\n  return { modelMeta: Object.keys(meta).length > 0 ? meta : undefined, metadataEntries: entries }\n}\n\n/** Known 3MF thumbnail PNG paths, in priority order. */\nconst THUMBNAIL_PATHS = [\n  'MetaData/thumbnail.png',\n  'Auxiliaries/.thumbnails/thumbnail_3mf.png',\n  'Auxiliaries/.thumbnails/thumbnail_middle.png',\n  'Auxiliaries/.thumbnails/thumbnail_small.png',\n]\n\n/** Extract a standard 3MF thumbnail PNG from an entry table (raw bytes).\n *\n * @param entries - the unzipped 3MF entry table (path -> bytes).\n * @returns the PNG bytes of the first matching thumbnail, or undefined.\n */\nexport function extractThumbnailBytes(\n  entries: Map<string, Uint8Array>,\n): Uint8Array | undefined {\n  const keys = [...entries.keys()]\n  for (const path of THUMBNAIL_PATHS) {\n    const entry = keys.find(k => k === path)\n    if (entry) return entries.get(entry)\n  }\n  const metaDataEntry = keys.find(k => /^metadata\\/thumbnail\\.png$/i.test(k))\n  if (metaDataEntry) return entries.get(metaDataEntry)\n  return undefined\n}\n\n/** Parse Bambu Lab metadata from an already-unzipped entry table.\n *\n * @param extraEntries - the 3MF entry table excluding the geometry model shared\n *   with `parseThreemf` (project_settings / model_settings configs + thumbnails).\n * @returns the resolved `Bambu3mfMetadata`.\n */\nexport function parseBambu3mfFromEntries(\n  extraEntries: Map<string, Uint8Array>,\n): Bambu3mfMetadata {\n  const decoder = new TextDecoder()\n\n  const filamentColors: string[] = []\n  const filamentTypes: string[] = []\n  const objects = new Map<string, BambuObjectMeta>()\n  const plates = new Map<number, BambuPlateInfo>()\n  const objectParts = new Map<string, { partId: string; name: string; extruder: number }[]>()\n  const assembleTransforms = new Map<string, AssembleItemTransform>()\n  const importTransforms = new Map<string, PartImportTransform>()\n\n  // ---- 1. project_settings.config (JSON) ----\n  let bedSize: BambuPlateSize | undefined\n  const projKey = [...extraEntries.keys()].find(f => f.endsWith('project_settings.config'))\n  if (projKey) {\n    try {\n      const json = JSON.parse(decoder.decode(extraEntries.get(projKey)!))\n      const rawColors = json.filament_colour ?? json.filament_color ?? []\n      const cArr = Array.isArray(rawColors) ? rawColors : [rawColors]\n      for (const c of cArr) {\n        filamentColors.push(typeof c === 'string' ? c.replace(/^\"(.*)\"$/, '$1').trim() : String(c))\n      }\n      const fTypes = json.filament_type ?? []\n      if (Array.isArray(fTypes)) {\n        for (const t of fTypes) filamentTypes.push(typeof t === 'string' ? t : String(t))\n      }\n      if (json.printable_area) {\n        const area = Array.isArray(json.printable_area) ? json.printable_area : [json.printable_area]\n        let maxX = 0\n        let maxY = 0\n        for (const pt of area) {\n          const parts = String(pt).split('x')\n          if (parts.length === 2) {\n            const x = parseFloat(parts[0])\n            const y = parseFloat(parts[1])\n            if (Number.isFinite(x) && x > maxX) maxX = x\n            if (Number.isFinite(y) && y > maxY) maxY = y\n          }\n        }\n        const height = parseFloat(String(json.printable_height ?? '0'))\n        if (maxX > 0 && maxY > 0 && Number.isFinite(height) && height > 0) {\n          bedSize = { width: maxX, depth: maxY, height }\n        }\n      }\n    } catch {\n      /* ignore malformed project settings */\n    }\n  }\n\n  // ---- 2. model_settings.config (XML) ----\n  const msKey = [...extraEntries.keys()].find(f => f.endsWith('model_settings.config'))\n  if (msKey) {\n    const xml = decoder.decode(extraEntries.get(msKey)!)\n\n    const objBlockRe = /<object\\s+id=\"(\\d+)\"[^>]*>([\\s\\S]*?)<\\/object>/gi\n    let objMatch: RegExpExecArray | null\n    while ((objMatch = objBlockRe.exec(xml)) !== null) {\n      const oid = objMatch[1]\n      const body = objMatch[2]\n      const topLevel = body.replace(/<part[^>]*>[\\s\\S]*?<\\/part>/gi, '')\n      let objName = ''\n      let objExtruder = 1\n      const metaRe = /<metadata\\s+key=\"([^\"]*)\"\\s+value=\"([^\"]*)\"\\s*\\/?>/gi\n      let mm: RegExpExecArray | null\n      while ((mm = metaRe.exec(topLevel)) !== null) {\n        if (mm[1] === 'name') objName = mm[2]\n        if (mm[1] === 'extruder') objExtruder = parseInt(mm[2], 10) || 1\n      }\n      objects.set(oid, { objectId: oid, name: objName, extruder: objExtruder, plateId: 0 })\n\n      const partList: { partId: string; name: string; extruder: number }[] = []\n      const partBlockRe = /<part\\s+id=\"(\\d+)\"[^>]*>([\\s\\S]*?)<\\/part>/gi\n      let pm: RegExpExecArray | null\n      while ((pm = partBlockRe.exec(body)) !== null) {\n        const pid = pm[1]\n        const partBody = pm[2]\n        let partName = objName\n        let partExtruder = objExtruder\n        const pmRe = /<metadata\\s+key=\"([^\"]*)\"\\s+value=\"([^\"]*)\"\\s*\\/?>/gi\n        let pmm: RegExpExecArray | null\n        while ((pmm = pmRe.exec(partBody)) !== null) {\n          if (pmm[1] === 'name') partName = pmm[2]\n          if (pmm[1] === 'extruder') partExtruder = parseInt(pmm[2], 10) || objExtruder\n        }\n        partList.push({ partId: pid, name: partName, extruder: partExtruder })\n      }\n      if (partList.length === 0) {\n        partList.push({ partId: '0', name: objName, extruder: objExtruder })\n      }\n      objectParts.set(oid, partList)\n    }\n\n    // 2c. <plate> blocks\n    const plateBlockRe = /<plate>([\\s\\S]*?)<\\/plate>/gi\n    let plateMatch: RegExpExecArray | null\n    while ((plateMatch = plateBlockRe.exec(xml)) !== null) {\n      const plateBody = plateMatch[1]\n      let platerId = 0\n      let platerName = ''\n      const pmRe2 = /<metadata\\s+key=\"([^\"]*)\"\\s+value=\"([^\"]*)\"\\s*\\/?>/gi\n      let m2: RegExpExecArray | null\n      while ((m2 = pmRe2.exec(plateBody)) !== null) {\n        if (m2[1] === 'plater_id') platerId = parseInt(m2[2], 10) || 0\n        if (m2[1] === 'plater_name') platerName = m2[2]\n      }\n      if (platerId > 0) {\n        plates.set(platerId, { plateId: platerId, plateName: platerName, size: bedSize })\n      }\n      const instRe = /<model_instance>([\\s\\S]*?)<\\/model_instance>/gi\n      let im: RegExpExecArray | null\n      while ((im = instRe.exec(plateBody)) !== null) {\n        const oidMatch = /<metadata\\s+key=\"object_id\"\\s+value=\"(\\d+)\"\\s*\\/?>/i.exec(im[1])\n        if (oidMatch) {\n          const obj = objects.get(oidMatch[1])\n          if (obj) obj.plateId = platerId\n        }\n      }\n    }\n\n    // 2d. <assemble> — assembly transforms\n    const assembleBlock = xml.match(/<assemble>([\\s\\S]*?)<\\/assemble>/i)\n    if (assembleBlock) {\n      const assembleItemRe = /<assemble_item\\s+([^>]*)\\/?>/gi\n      let am: RegExpExecArray | null\n      while ((am = assembleItemRe.exec(assembleBlock[1])) !== null) {\n        const attrs = am[1]\n        const oidMatch = /object_id=\"(\\d+)\"/.exec(attrs)\n        const xformMatch = /transform=\"([^\"]*)\"/.exec(attrs)\n        const offsetMatch = /offset=\"([^\"]*)\"/.exec(attrs)\n        const oid = oidMatch?.[1]\n        if (oid && xformMatch) {\n          const xform = xformMatch[1].split(/\\s+/).map(Number)\n          const offsetArr = offsetMatch ? offsetMatch[1].split(/\\s+/).map(Number) : [0, 0, 0]\n          if (xform.length === 12 && offsetArr.length === 3) {\n            assembleTransforms.set(oid, {\n              objectId: oid,\n              transform: xform,\n              offset: offsetArr as [number, number, number],\n            })\n          }\n        }\n      }\n    }\n\n    // 2e. <part> matrix metadata (per-part import transforms)\n    const importObjBlockRe = /<object\\s+id=\"(\\d+)\"[^>]*>([\\s\\S]*?)<\\/object>/gi\n    let importObjMatch: RegExpExecArray | null\n    while ((importObjMatch = importObjBlockRe.exec(xml)) !== null) {\n      const oid = importObjMatch[1]\n      const body = importObjMatch[2]\n      const importPartRe = /<part\\s+id=\"(\\d+)\"[^>]*>([\\s\\S]*?)<\\/part>/gi\n      let ipm: RegExpExecArray | null\n      while ((ipm = importPartRe.exec(body)) !== null) {\n        const pid = ipm[1]\n        let matrix: number[] | undefined\n        let sox = 0; let soy = 0; let soz = 0\n        const imRe = /<metadata\\s+key=\"([^\"]*)\"\\s+value=\"([^\"]*)\"\\s*\\/?>/gi\n        let imm: RegExpExecArray | null\n        while ((imm = imRe.exec(ipm[2])) !== null) {\n          if (imm[1] === 'matrix') matrix = imm[2].split(/\\s+/).map(Number)\n          if (imm[1] === 'source_offset_x') sox = parseFloat(imm[2]) || 0\n          if (imm[1] === 'source_offset_y') soy = parseFloat(imm[2]) || 0\n          if (imm[1] === 'source_offset_z') soz = parseFloat(imm[2]) || 0\n        }\n        if (matrix && matrix.length === 16) {\n          importTransforms.set(`${oid}:${pid}`, {\n            objectId: oid,\n            partId: pid,\n            matrix,\n            sourceOffset: [sox, soy, soz],\n          })\n        }\n      }\n    }\n  }\n\n  // ---- 3. Model-level metadata + build items from 3D/3dmodel.model ----\n  const thumbnailBytes = extractThumbnailBytes(extraEntries)\n  let modelMeta: BambuModelMeta | undefined\n  let metadataEntries: Array<{ name: string; value: string }> = []\n  let buildItems: BuildItem[] = []\n\n  const modelFile = [...extraEntries.keys()].find(\n    f => f.endsWith('/3dmodel.model') || f === '3D/3dmodel.model',\n  )\n  if (modelFile) {\n    const modelXml = decoder.decode(extraEntries.get(modelFile)!)\n    const resourcesStart = modelXml.indexOf('<resources>')\n    const resourcesEnd = modelXml.indexOf('</resources>')\n    const head = resourcesStart >= 0 ? modelXml.slice(0, resourcesStart) : modelXml\n    const tail = resourcesEnd >= 0 ? modelXml.slice(resourcesEnd) : ''\n    const parsedHead = parseModelMeta(head)\n    const parsedTail = parseModelMeta(tail)\n    modelMeta = { ...parsedHead.modelMeta, ...parsedTail.modelMeta }\n    metadataEntries = [...parsedHead.metadataEntries, ...parsedTail.metadataEntries]\n    buildItems = parse3mfBuild(tail)\n  }\n\n  // ---- 4. Ordered flat parts list ----\n  const parts: BambuPartMeta[] = []\n  let partIndex = 0\n  for (const item of buildItems) {\n    const oid = item.objectId\n    const objMeta = objects.get(oid)\n    const partList = objectParts.get(oid) ?? []\n    for (const p of partList) {\n      parts.push({\n        partIndex: partIndex++,\n        objectId: oid,\n        partId: p.partId,\n        name: stripExtension(p.name),\n        extruder: p.extruder,\n        plateId: objMeta?.plateId ?? 0,\n      })\n    }\n  }\n\n  return {\n    filamentColors,\n    filamentTypes,\n    objects,\n    parts,\n    plates,\n    modelMeta: modelMeta && Object.keys(modelMeta).length > 0 ? modelMeta : undefined,\n    metadataEntries,\n    thumbnailBytes,\n    assembleTransforms: assembleTransforms.size > 0 ? assembleTransforms : undefined,\n    importTransforms: importTransforms.size > 0 ? importTransforms : undefined,\n    buildItems: buildItems.length > 0 ? buildItems : undefined,\n  }\n}\n\n/** Parse Bambu metadata from a `ThreemfArchive`'s `extraEntries`.\n *\n * @param archive - a `ThreemfArchive` produced by `parseThreemf`.\n * @returns the resolved `Bambu3mfMetadata`.\n */\nexport function parseBambu3mfFromArchive(archive: ThreemfArchive): Bambu3mfMetadata {\n  return parseBambu3mfFromEntries(archive.extraEntries)\n}"]}

package/dist/mesh/threemf-loader.d.ts

@@ -1,15 +1,50 @@
-/** A parsed 3MF solid: triangle soup in mm base (already unit-scaled). */
-export interface ThreemfMesh {
+import { type UnitName } from '../units.js';
+/** One parsed 3MF object instance: triangle soup in mm base (unit-scaled). */
+export interface ThreemfObject {
+    /** The `<object id>` this instance instantiates. */
+    id: number;
+    /** The object's `<object name>` (Bambu exports a human label here). */
+    name?: string;
     positions: Float32Array;
     indices: Uint32Array;
-    /** The declared `<model unit>` (raw, e.g. "millimeter"). */
-    sourceUnit: string;
+    /**
+     * Basematerials display color, `[r, g, b]` in 0..1 (sRGB components as
+     * written in the file, matching the host's `setStyle(…, SRGBColorSpace)`).
+     * Set when every triangle of the object references the *same* base index;
+     * multi-base objects cannot be expressed by a single color → undefined
+     * (host falls back to the default material).
+     */
+    baseColor?: readonly [number, number, number];
+    /**
+     * Colorgroup vertex colors, one RGB triple per emitted vertex — the geometry
+     * is *expanded* (each triangle owns 3 independent vertices, indices are
+     * sequential) whenever a colorgroup is referenced, so per-triangle
+     * p1/p2/p3 colors survive without shared-vertex conflicts. Length equals
+     * `positions.length`.
+     */
+    vertexColors?: Float32Array;
+}
+/** Structured 3MF parse result. */
+export interface ThreemfArchive {
+    /** The declared `<model unit>` mapped to a faijs UnitName. */
+    unit: UnitName;
+    /** One object per build `<item>` (transform baked), or per `<resources>` object. */
+    objects: ThreemfObject[];
+    /** Every non-model archive entry (key → raw bytes) for downstream consumers. */
+    extraEntries: Map<string, Uint8Array>;
 }
 /**
- * Parse 3MF bytes into a mm-base mesh.
+ * Parse 3MF bytes into a structured archive.
+ *
+ * Supports Bambu's multi-file layout: `3D/3dmodel.model` (root, holds the
+ * `<build>` and component-container skeletons) plus per-object sub-models
+ * `3D/Objects/*.model` whose `<resources>` are merged by object id
+ * (sub-models first, root last — root wins collisions).
+ *
  * @param buffer - the raw .3mf (ZIP) bytes.
- * @returns the parsed mesh plus the declared source unit.
+ * @returns an `ThreemfArchive` with mm-base per-instance objects, the declared
+ *   source unit, and every non-model archive entry.
  * @throws when the buffer is not a 3MF/ZIP archive or the unit is invalid.
  */
-export declare function parseThreemf(buffer: ArrayBuffer): Promise<ThreemfMesh>;
+export declare function parseThreemf(buffer: ArrayBuffer): Promise<ThreemfArchive>;
 //# sourceMappingURL=threemf-loader.d.ts.map

package/dist/mesh/threemf-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threemf-loader.d.ts","sourceRoot":"","sources":["../../src/mesh/threemf-loader.ts"],"names":[],"mappings":"AAuCA,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;IACpB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;CACnB;AA8GD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB5E"}
+{"version":3,"file":"threemf-loader.d.ts","sourceRoot":"","sources":["../../src/mesh/threemf-loader.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAmHpD,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAA;IACV,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;IACpB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,QAAQ,CAAA;IACd,oFAAoF;IACpF,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,gFAAgF;IAChF,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACtC;AA8dD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAgC/E"}