@faicad/faijs 0.30.9 → 0.32.2

package/dist/mesh/io.js.map

@@ -1 +1 @@
-{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh IO API — headless 文件加载\n *\n * STL 由 core 自持的 `mesh/stl-loader.ts` 解析（零 three addons）；3MF 由\n * `mesh/threemf-loader.ts` 解析（ZIP 解压 + XML，单位换算到 mm 基准）。\n * 坐标永远以 faijs 基准长度单位（mm）存储 — Shape 不贴 unit 标签（D3）。\n *\n * 单位换算边界（unit-system §5.2）：\n * - STL 无单位元数据 → 由 `opts.unit` 显式声明优先；未声明时 faijs 按历史\n *   host 行为做启发式猜测（`guessStlUnit`，unified 方案 §6.1/§8 —— 3d_editor\n *   迁移回归的单位断言依赖此行为）。猜测收敛在 faijs 内（红线 R0：宿主不\n *   自实现单位换算），G0 = 折算后坐标，渲染 = 拓扑 = G0。\n * - 3MF `<model unit>` 由解析器读取并换算（micron/mm/cm/inch/foot/meter）。\n *\n * 返回契约（unit-system §10.6）：`importFile` 返回 `{ shape, unit }` — `unit`\n * 是文件源单位（必然有值；faijs 是单一真源）：3MF/STEP 取文件声明（STEP 无声明\n * → 'mm'，与 OCCT 一致），STL 取 opts.unit 或 guessStlUnit 启发式猜测。坐标恒\n * 为基准值 — `unit` 只作元数据（sourceUnit 记录、导出目标判定），绝不参与几何\n * 缩放（读入折算已由内核/解析器完成，二次缩放 = 双重换算）。\n */\n\nimport * as THREE from 'three'\nimport { geoToManifoldMesh } from '../boolean/geo-convert'\nimport { parseStl } from './stl-loader'\nimport { parseThreemf, type ThreemfObject } from './threemf-loader'\nimport { parseBambu3mfFromEntries } from './threemf-bambu'\nimport { unitScale, type UnitName } from '../units'\nimport { guessStlUnit } from './stl-unit'\nimport type { Shape } from './types'\nimport type { PbrAppearance } from '../api/appearance'\nimport type { FileMeta } from '../api/meta'\nimport type { ImportModel } from './import-model'\n\n/** Result of a unit-aware file import. */\nexport interface ImportFileResult {\n  shape: Shape\n  /**\n   * All parts the file declared, in declaration order (3MF `<build><item>` 序 /\n   * STL 单零件)。`shape` is `parts[0]`（单零件兼容，过渡期）。\n   * P0（2026-10-06-step-3mf-multipart-import-plan.md §5.4）：多对象 3MF 不再折叠。\n   */\n  parts: Shape[]\n  /**\n   * The file's source unit (always present; faijs is the single source of truth).\n   * 3MF/STEP: the file's declared unit (STEP 无声明 → 'mm', 与 OCCT 一致).\n   * STL: opts.unit if declared, else the guessStlUnit heuristic result.\n   * Metadata only — coordinates are already in the faijs base unit (mm).\n   */\n  unit: UnitName\n  /**\n   * Total parts the single file declared (e.g. 3MF `<build>` object count),\n   * present only when > 1. Single-part mesh (STL, single-object 3MF) omits it.\n   * 保留为 `parts.length`（>1 时）；多零件不再折叠后该字段仅供旧宿主判断。\n   */\n  multiPartCount?: number\n  /**\n   * 整体级元数据（文件级；方案 §5.1 3MF `<model><metadata>`）。STL/STEP 视实现\n   * 是否解析；无声明则省略。仅随导入结果上抛，不挂 Shape。\n   */\n  fileMeta?: FileMeta\n  /**\n   * 本次导入的结构数据（P0 §5.1）：零件身份表 + Bambu 视图（3MF 分支填充）。\n   * 单/多零件均登记（单零件 parts 长度 1）。\n   */\n  importModel?: ImportModel\n}\n\n/** SI prefixes that may precede .METRE. in a STEP SI_UNIT, → faijs UnitName. */\nconst SI_PREFIX_TO_UNIT: Record<string, UnitName> = {\n  '.MILLI.': 'mm',\n  '.CENTI.': 'cm',\n  '$': 'm',\n}\n\n/** CONVERSION_BASED_UNIT names (uppercased) found in real-world STEP files. */\nconst CONVERSION_NAME_TO_UNIT: Record<string, UnitName> = {\n  'METRE': 'm',\n  'METER': 'm',\n  'MILLIMETRE': 'mm',\n  'MILLIMETER': 'mm',\n  'CENTIMETRE': 'cm',\n  'CENTIMETER': 'cm',\n  'MICROMETRE': 'micron',\n  'MICROMETER': 'micron',\n  'INCH': 'inch',\n  'FOOT': 'foot',\n}\n\n/**\n * Bounded scan window for `detectStepUnit`. Unit entities sit at the front of\n * the DATA section (right after the product/context blocks); 256 KiB covers\n * every real-world header+context preamble observed so far. Recomputable\n * constant — raise if a fixture ever misses.\n */\nexport const STEP_UNIT_SCAN_PREFIX = 256 * 1024\n\n/**\n * Parse the declared length unit from STEP text (unit-system §10.4).\n *\n * Unit entities live in the DATA section (not HEADER — ISO 10303-21 reserves\n * HEADER for FILE_DESCRIPTION/FILE_NAME/FILE_SCHEMA), near its start. We scan\n * a bounded prefix; the justification is \"unit entities sit at the front of\n * the DATA section\", not \"top of file\".\n *\n * Recognized forms, both attached to a LENGTH_UNIT():\n * - `SI_UNIT(<prefix>, .METRE.)` — prefix `.MILLI.`/`.CENTI.`/`.MICRO.` or `$`.\n * - `CONVERSION_BASED_UNIT('<NAME>', #n)` — inch/foot/etc.\n *\n * Metadata only — NEVER used to scale geometry (OCCT already normalizes on\n * read; re-scaling = double conversion).\n *\n * @param stepText - the full STEP file text to scan (only a bounded prefix is read).\n * @returns the faijs UnitName, or null when no length-unit declaration is found\n *   (STEP permits omitting it; caller falls back to the base unit).\n */\nexport function detectStepUnit(stepText: string): UnitName | null {\n  const head = stepText.slice(0, STEP_UNIT_SCAN_PREFIX)\n\n  // 1) CONVERSION_BASED_UNIT('<NAME>', #n) — non-SI units (inch/foot/…).\n  const conv = head.match(/CONVERSION_BASED_UNIT\\s*\\(\\s*'([^']+)'/i)\n  if (conv) {\n    const mapped = CONVERSION_NAME_TO_UNIT[conv[1].toUpperCase()]\n    if (mapped) return mapped\n  }\n\n  // 2) SI_UNIT(<prefix>, .METRE.) — the .METRE. guard excludes angle entities\n  //    (they carry .RADIAN./.STERADIAN., never .METRE.).\n  const si = head.match(/SI_UNIT\\s*\\(\\s*([^)]*?)\\s*,\\s*\\.METRE\\.\\s*\\)/i)\n  if (si) {\n    const prefix = si[1].trim().toUpperCase()\n    if (prefix === '.MICRO.') return 'micron'\n    const mapped = SI_PREFIX_TO_UNIT[prefix]\n    if (mapped) return mapped\n  }\n\n  return null\n}\n\n/**\n * Load geometry from raw file bytes (headless variant).\n *\n * @param buffer - the raw file bytes to parse (already decompressed; stpz\n *   unzipping is the caller's job — faijs never unzips implicitly).\n * @param format - format identifier such as 'stl', '3mf'/'threemf' or 'step'\n *   (defaults to 'stl').\n * @param opts - optional settings; `unit` (a UnitName string) declares the\n *   source unit for formats without unit metadata (e.g. STL). Defaults to\n *   the guessStlUnit heuristic when omitted.\n * @returns the shape with base-unit coordinates plus the file's source unit\n *   (`unit`, metadata only; always present — faijs is the single source of truth).\n */\nexport async function importFile(\n  buffer: ArrayBuffer,\n  format?: string,\n  opts?: { unit?: UnitName },\n): Promise<ImportFileResult> {\n  const fmt = (format ?? 'stl').toLowerCase()\n\n  if (fmt === '3mf' || fmt === 'threemf') {\n    const archive = await parseThreemf(buffer)\n    // P0（方案 §5.4）：不再折叠——返回全部 `<build><item>` 对象（declaration order，\n    // 坐标已在 parseThreemf 里折算为 faijs 基准单位）。`shape` 保留为 parts[0]\n    // （单零件兼容，过渡期）。\n    if (archive.objects.length === 0) {\n      throw new Error('[mesh/io] 3MF contains no objects')\n    }\n    // Bambu 元数据（盘号/挤出机/视图变换）：有 Bambu 配置才产生内容，普通 3MF 返回空表。\n    // P4：根 model XML 直传（3MF `<build>` 在 resources 前；id 两套编号经父\n    // object components 关联——leafParts 表承载）。\n    const bambu = parseBambu3mfFromEntries(archive.extraEntries, archive.modelXml)\n    const parts = archive.objects.map(threemfObjectToShape)\n    const multiPartCount = parts.length > 1 ? parts.length : undefined\n    const importModel: ImportModel = {\n      format: '3mf',\n      unit: archive.unit,\n      parts: archive.objects.map((obj, i) => {\n        const part: ImportModel['parts'][number] = {\n          index: i,\n          name: obj.name ?? `imported:${i}`,\n        }\n        if (obj.baseColor) part.color = [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]]\n        if (obj.meta) part.meta = obj.meta\n        // Bambu 身份：3MF `<object id>`（叶子实例）与 Bambu objects 表（键为\n        // model_settings 父对象 id）是两套编号——经父 object components 关联\n        // （ThreemfObject.parentObjectId/componentIndex → bambu.leafParts）。\n        const bm = obj.parentObjectId !== undefined\n          ? bambu.leafParts.get(`${obj.parentObjectId}:${obj.componentIndex ?? 1}`)\n          : undefined\n        if (bm) {\n          part.objectId = bm.objectId\n          if (bm.plateId > 0) part.plateId = bm.plateId\n          // Bambu extruder 1-based（默认 1）：显式登记文件声明值\n          part.extruder = bm.extruder\n          part.partId = bm.partId\n        }\n        return part\n      }),\n      ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n    }\n    const bambuViews = buildBambuViews(bambu)\n    if (bambuViews) importModel.bambuViews = bambuViews\n    return {\n      shape: parts[0],\n      parts,\n      unit: archive.unit,\n      multiPartCount,\n      importModel,\n      // 整体级元数据（`<model><metadata>`）随导入结果上抛（方案 §5.1）。\n      ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n    }\n  }\n\n  if (fmt === 'stl') {\n    const geo = parseStl(buffer)\n    // STL 无单位声明：opts.unit 显式声明优先；未声明时做启发式猜测\n    // （guessStlUnit —— 历史 host 行为，unified §6.1/§8 迁移基线）。猜测与\n    // 折算都在 faijs 内完成（红线 R0），G0 即基准值，宿主不再二次换算。\n    // unit 字段回传源单位（声明值或猜测值），供宿主记录 sourceUnit 元数据。\n    let scale = 1\n    let sourceUnit: UnitName = 'mm'\n    const declared = opts?.unit\n    if (declared) {\n      sourceUnit = declared\n      scale = unitScale(declared)\n    } else {\n      geo.computeBoundingBox()\n      const bb = geo.boundingBox\n      if (bb) {\n        sourceUnit = guessStlUnit({\n          min: [bb.min.x, bb.min.y, bb.min.z],\n          max: [bb.max.x, bb.max.y, bb.max.z],\n        })\n        scale = unitScale(sourceUnit)\n      }\n    }\n    if (scale !== 1) {\n      const attr = geo.getAttribute('position') as THREE.BufferAttribute\n      const arr = attr.array as Float32Array\n      for (let i = 0; i < arr.length; i++) arr[i] *= scale\n    }\n    const shape = geoToManifoldMesh(geo)\n    return { shape, parts: [shape], unit: sourceUnit }\n  }\n\n  // STEP goes through the BREP chain (loadBrep → OCCT, which normalizes to the\n  // base unit on read). The mesh io path has no kernel-independent STEP parser\n  // and must not fake one — a missing path is an error, not a fallback.\n  throw new Error(`[mesh/io] unsupported format: ${fmt}`)\n}\n\n/** 单个 3MF `<build><item>` 对象 → Shape（P0：逐对象构造，替换原\"只取第一个\"收敛）。 */\nfunction threemfObjectToShape(obj: ThreemfObject): Shape {\n  return {\n    positions: obj.positions as Float32Array,\n    indices: obj.indices as Uint32Array,\n    // P2（方案 §5 3MF 行）：对象级 baseColor → appearance.color（sRGB 原值，\n    // 宽容兼容：无 baseColor 不带 appearance）。colorgroup（vertexColors）与\n    // 逐三角形材质属 Phase 2（materialGroups / vertexColors），P2 不映射。\n    ...(obj.baseColor ? { appearance: { color: [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]] } } : {}),\n    // P4（方案 §5 3MF 行）：逐三角形 basematerials（p1=p2=p3）→ materialGroups\n    // （三角形区间 + appearance.color）；无则不带。vertexColors（colorgroup）\n    // 由上层（编辑器导入路径）消费，io 单零件收敛不展开为材质分组。\n    ...(obj.materialGroups && obj.materialGroups.length > 0\n      ? {\n          materialGroups: obj.materialGroups.map((g) => ({\n            start: g.start,\n            count: g.count,\n            appearance: { color: [g.color[0], g.color[1], g.color[2]] } as PbrAppearance,\n          })),\n        }\n      : {}),\n    // 零件级元数据（方案 §5.1 3MF 行）：对象 name/partnumber/metadatagroup → meta。\n    ...(obj.meta ? { meta: obj.meta } : {}),\n  }\n}\n\n/** Bambu 显示视图数据 → ImportModel.bambuViews（无任何 Bambu 结构时省略）。 */\nfunction buildBambuViews(\n  bambu: import('./threemf-bambu').Bambu3mfMetadata,\n): ImportModel['bambuViews'] | undefined {\n  const plates = [...bambu.plates.keys()].sort((a, b) => a - b)\n  if (plates.length === 0 && !bambu.assembleTransforms && !bambu.importTransforms) return undefined\n  const views: NonNullable<ImportModel['bambuViews']> = { plates }\n  if (bambu.assembleTransforms) {\n    views.assembleTransforms = Object.fromEntries(\n      [...bambu.assembleTransforms].map(([k, v]) => [k, { transform: v.transform, offset: v.offset }]),\n    )\n  }\n  if (bambu.importTransforms) {\n    views.importTransforms = Object.fromEntries(\n      [...bambu.importTransforms].map(([k, v]) => [k, { matrix: v.matrix, sourceOffset: v.sourceOffset }]),\n    )\n  }\n  // P4：完整消费面随结果回传——宿主重建 Bambu3mfMetadata 不再回读 archive。\n  if (bambu.buildItems) {\n    views.buildItems = bambu.buildItems.map((b) => ({\n      objectId: b.objectId,\n      transform: b.transform ?? null,\n    }))\n  }\n  if (bambu.filamentColors.length > 0) views.filamentColors = bambu.filamentColors\n  if (bambu.filamentTypes.length > 0) views.filamentTypes = bambu.filamentTypes\n  if (bambu.parts.length > 0) {\n    views.parts = bambu.parts.map((p) => ({\n      partIndex: p.partIndex,\n      objectId: p.objectId,\n      partId: p.partId,\n      name: p.name,\n      extruder: p.extruder,\n      plateId: p.plateId,\n    }))\n  }\n  return views\n}\n"]}
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh IO API — headless 文件加载\n *\n * STL 由 core 自持的 `mesh/stl-loader.ts` 解析（零 three addons）；3MF 由\n * `mesh/threemf-loader.ts` 解析（ZIP 解压 + XML，单位换算到 mm 基准）。\n * 坐标永远以 faijs 基准长度单位（mm）存储 — Shape 不贴 unit 标签（D3）。\n *\n * 单位换算边界（unit-system §5.2）：\n * - 本模块只处理 **mesh 格式（STL/3MF）**，坐标可直接折算 → `opts.unit` 提供即\n *   **强制设置模型的源单位**（直接指定，覆盖/忽略模型内部记录的单位——STL 无\n *   内部单位、3MF `<model unit>` 声明被覆盖），按 `unitScale(unit)` 折算坐标。\n *   它**只可能来自调用方的显式知识**（脚本作者手写 `cad.load({ file, unit })`、\n *   或宿主让用户选定单位后传入）；调用方不知道单位时**必须省略**——省略时：\n *   STL 走 faijs 启发式（`guessStlUnit`，unified 方案 §6.1/§8 —— 3d_editor\n *   迁移回归的单位断言依赖此行为）、3MF 走文件 `<model unit>`（无声明 →\n *   millimeter）。猜测/折算收敛在 faijs 内（红线 R0：宿主不自实现单位换算），\n *   G0 = 折算后坐标，渲染 = 拓扑 = G0。\n * - **STEP/.brep 不经过本模块**（走 BREP 链，load op 内 OCCT 读取）：OCCT 按\n *   文件内部单位声明折算（SI_UNIT），**不支持强制设置单位**——load op 对\n *   BREP 路径 + 用户显式 unit 直接**明确报错**（不缩放、不 workaround）。\n * - 3MF `<model unit>` 由解析器读取并换算（micron/mm/cm/inch/foot/meter）。\n *\n * 返回契约（unit-system §10.6）：`importFile` 返回 `{ shape, unit }` — `unit`\n * 是文件源单位（必然有值；faijs 是单一真源）：3MF 取 opts.unit（强制）或文件\n * 声明（无声明 → millimeter），STL 取 opts.unit 或 guessStlUnit 启发式猜测。\n * 坐标恒为基准值 — `unit` 只作元数据（sourceUnit 记录、导出目标判定），绝不\n * 参与几何缩放（读入折算已由解析器完成，二次缩放 = 双重换算）。\n */\n\nimport { geoToManifoldMesh } from '../boolean/geo-convert'\nimport { parseStl } from './stl-loader'\nimport { boundingBox } from './query'\nimport { parseThreemf, type ThreemfObject, type ThreemfNode } from './threemf-loader'\nimport { parseBambu3mfFromEntries } from './threemf-bambu'\nimport { unitScale, type UnitName } from '../units'\nimport { guessStlUnit } from './stl-unit'\nimport type { Shape } from './types'\nimport type { CompoundShape } from '../shape'\nimport type { PbrAppearance } from '../api/appearance'\nimport type { FileMeta } from '../api/meta'\nimport type { ImportModel } from './import-model'\n\n/** Result of a unit-aware file import. */\nexport interface ImportFileResult {\n  shape: Shape\n  /**\n   * All parts the file declared, in declaration order (3MF `<build><item>` 序 /\n   * STL 单零件)。`shape` is `parts[0]`（单零件兼容，过渡期）。\n   * P0（2026-10-06-step-3mf-multipart-import-plan.md §5.4）：多对象 3MF 不再折叠。\n   */\n  parts: Shape[]\n  /**\n   * The file's source unit (always present; faijs is the single source of truth).\n   * 3MF: opts.unit (forced) if provided, else the file's declared unit\n   * (无声明 → millimeter). STL: opts.unit (forced) if provided, else the\n   * guessStlUnit heuristic result. STEP/BREP 不经过本模块（OCCT 链不支持\n   * 强制设置单位，load op 报错）。\n   * Metadata only — coordinates are already in the faijs base unit (mm).\n   */\n  unit: UnitName\n  /**\n   * Total parts the single file declared (e.g. 3MF `<build>` object count),\n   * present only when > 1. Single-part mesh (STL, single-object 3MF) omits it.\n   * 保留为 `parts.length`（>1 时）；多零件不再折叠后该字段仅供旧宿主判断。\n   */\n  multiPartCount?: number\n  /**\n   * 整体级元数据（文件级；方案 §5.1 3MF `<model><metadata>`）。STL/STEP 视实现\n   * 是否解析；无声明则省略。仅随导入结果上抛，不挂 Shape。\n   */\n  fileMeta?: FileMeta\n  /**\n   * 本次导入的结构数据（P0 §5.1）：零件身份表 + Bambu 视图（3MF 分支填充）。\n   * 单/多零件均登记（单零件 parts 长度 1）。\n   */\n  importModel?: ImportModel\n  /**\n   * 装配层级（方案 2026-10-08 §2.1 / 第 5 步「导入归一」）：当 3MF 含 `<components>`\n   * 装配结构时，按层级重建为 `CompoundShape`，每个子节点携带相对父的 `transform`\n   * （来自 3MF `<component transform>` / build `<item transform>`，行主序 3×4，平移在\n   * 末列，与写出器同源）。仅当存在真实装配（多 item 或任一 item 带 components）时存在；\n   * 单零件平铺导入不走它（`shape` / `parts` 已覆盖）。viewer 用 `parts`（已烘焙实例），\n   * 往返/层级消费者用 `assembly`（局部几何 + 节点 transform）。\n   */\n  assembly?: Shape | CompoundShape\n}\n\n/** SI prefixes that may precede .METRE. in a STEP SI_UNIT, → faijs UnitName. */\nconst SI_PREFIX_TO_UNIT: Record<string, UnitName> = {\n  '.MILLI.': 'mm',\n  '.CENTI.': 'cm',\n  '$': 'm',\n}\n\n/** CONVERSION_BASED_UNIT names (uppercased) found in real-world STEP files. */\nconst CONVERSION_NAME_TO_UNIT: Record<string, UnitName> = {\n  'METRE': 'm',\n  'METER': 'm',\n  'MILLIMETRE': 'mm',\n  'MILLIMETER': 'mm',\n  'CENTIMETRE': 'cm',\n  'CENTIMETER': 'cm',\n  'MICROMETRE': 'micron',\n  'MICROMETER': 'micron',\n  'INCH': 'inch',\n  'FOOT': 'foot',\n}\n\n/**\n * Bounded scan window for `detectStepUnit`. Unit entities sit at the front of\n * the DATA section (right after the product/context blocks); 256 KiB covers\n * every real-world header+context preamble observed so far. Recomputable\n * constant — raise if a fixture ever misses.\n */\nexport const STEP_UNIT_SCAN_PREFIX = 256 * 1024\n\n/**\n * Parse the declared length unit from STEP text (unit-system §10.4).\n *\n * Unit entities live in the DATA section (not HEADER — ISO 10303-21 reserves\n * HEADER for FILE_DESCRIPTION/FILE_NAME/FILE_SCHEMA), near its start. We scan\n * a bounded prefix; the justification is \"unit entities sit at the front of\n * the DATA section\", not \"top of file\".\n *\n * Recognized forms, both attached to a LENGTH_UNIT():\n * - `SI_UNIT(<prefix>, .METRE.)` — prefix `.MILLI.`/`.CENTI.`/`.MICRO.` or `$`.\n * - `CONVERSION_BASED_UNIT('<NAME>', #n)` — inch/foot/etc.\n *\n * Metadata only — NEVER used to scale geometry (OCCT already normalizes on\n * read; re-scaling = double conversion).\n *\n * @param stepText - the full STEP file text to scan (only a bounded prefix is read).\n * @returns the faijs UnitName, or null when no length-unit declaration is found\n *   (STEP permits omitting it; caller falls back to the base unit).\n */\nexport function detectStepUnit(stepText: string): UnitName | null {\n  const head = stepText.slice(0, STEP_UNIT_SCAN_PREFIX)\n\n  // 1) CONVERSION_BASED_UNIT('<NAME>', #n) — non-SI units (inch/foot/…).\n  const conv = head.match(/CONVERSION_BASED_UNIT\\s*\\(\\s*'([^']+)'/i)\n  if (conv) {\n    const mapped = CONVERSION_NAME_TO_UNIT[conv[1].toUpperCase()]\n    if (mapped) return mapped\n  }\n\n  // 2) SI_UNIT(<prefix>, .METRE.) — the .METRE. guard excludes angle entities\n  //    (they carry .RADIAN./.STERADIAN., never .METRE.).\n  const si = head.match(/SI_UNIT\\s*\\(\\s*([^)]*?)\\s*,\\s*\\.METRE\\.\\s*\\)/i)\n  if (si) {\n    const prefix = si[1].trim().toUpperCase()\n    if (prefix === '.MICRO.') return 'micron'\n    const mapped = SI_PREFIX_TO_UNIT[prefix]\n    if (mapped) return mapped\n  }\n\n  return null\n}\n\n/**\n * Load geometry from raw file bytes (headless variant).\n *\n * @param buffer - the raw file bytes to parse (already decompressed; stpz\n *   unzipping is the caller's job — faijs never unzips implicitly).\n * @param format - format identifier such as 'stl', '3mf'/'threemf' or 'step'\n *   (defaults to 'stl'). **仅 mesh 格式（STL/3MF）走本模块**；STEP/BREP 走\n *   BREP 链（load op 内 OCCT 读取，不支持强制设置单位）。\n * @param opts - optional settings; `unit` (a UnitName string) **force-sets the\n *   model's source unit** (STL/3MF): it is NOT a default, it directly specifies\n *   the unit and overrides/ignores any unit recorded inside the model (3MF\n *   `<model unit>`; STL has none), geometry scaled by `unitScale(unit)`. Only\n *   provide it when the caller actually knows the unit (author-written\n *   `cad.load({ file, unit })`, or a host unit picker). When the caller does\n *   NOT know the unit, it MUST omit `unit` — STL then guesses via\n *   `guessStlUnit` (the only allowed guessing path), 3MF uses the file\n *   declaration (none → millimeter). A wrong explicit unit scales geometry\n *   wrongly and is never re-guessed.\n * @returns the shape with base-unit coordinates plus the file's source unit\n *   (`unit`, metadata only; always present — faijs is the single source of truth).\n */\nexport async function importFile(\n  buffer: ArrayBuffer,\n  format?: string,\n  opts?: { unit?: UnitName },\n): Promise<ImportFileResult> {\n  const fmt = (format ?? 'stl').toLowerCase()\n\n  if (fmt === '3mf' || fmt === 'threemf') {\n    const archive = await parseThreemf(buffer, opts)\n    // P0（方案 §5.4）：不再折叠——返回全部 `<build><item>` 对象（declaration order，\n    // 坐标已在 parseThreemf 里折算为 faijs 基准单位）。`shape` 保留为 parts[0]\n    // （单零件兼容，过渡期）。\n    if (archive.objects.length === 0) {\n      throw new Error('[mesh/io] 3MF contains no objects')\n    }\n    // Bambu 元数据（盘号/挤出机/视图变换）：有 Bambu 配置才产生内容，普通 3MF 返回空表。\n    // P4：根 model XML 直传（3MF `<build>` 在 resources 前；id 两套编号经父\n    // object components 关联——leafParts 表承载）。\n    const bambu = parseBambu3mfFromEntries(archive.extraEntries, archive.modelXml)\n    const parts = archive.objects.map(threemfObjectToShape)\n    const multiPartCount = parts.length > 1 ? parts.length : undefined\n    const importModel: ImportModel = {\n      format: '3mf',\n      unit: archive.unit,\n      parts: archive.objects.map((obj, i) => {\n        const part: ImportModel['parts'][number] = {\n          index: i,\n          name: obj.name ?? `imported:${i}`,\n        }\n        if (obj.baseColor) part.color = [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]]\n        if (obj.meta) part.meta = obj.meta\n        // Bambu 身份：3MF `<object id>`（叶子实例）与 Bambu objects 表（键为\n        // model_settings 父对象 id）是两套编号——经父 object components 关联\n        // （ThreemfObject.parentObjectId/componentIndex → bambu.leafParts）。\n        const bm = obj.parentObjectId !== undefined\n          ? bambu.leafParts.get(`${obj.parentObjectId}:${obj.componentIndex ?? 1}`)\n          : undefined\n        if (bm) {\n          part.objectId = bm.objectId\n          if (bm.plateId > 0) part.plateId = bm.plateId\n          // Bambu extruder 1-based（默认 1）：显式登记文件声明值\n          part.extruder = bm.extruder\n          part.partId = bm.partId\n        }\n        return part\n      }),\n      ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n    }\n    const bambuViews = buildBambuViews(bambu)\n    if (bambuViews) importModel.bambuViews = bambuViews\n    // 装配层级重建（方案 §2.1 / 第 5 步）：含 `<components>` 时还原 CompoundShape，\n    // 叶节点携带相对父 transform；单零件平铺导入不挂载。\n    const assembly = archive.hierarchy && archive.localGeomById\n      ? buildAssemblyFromArchive(archive.hierarchy, archive.localGeomById)\n      : undefined\n    return {\n      shape: parts[0],\n      parts,\n      unit: archive.unit,\n      multiPartCount,\n      importModel,\n      // 整体级元数据（`<model><metadata>`）随导入结果上抛（方案 §5.1）。\n      ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n      ...(assembly ? { assembly } : {}),\n    }\n  }\n\n  if (fmt === 'stl') {\n    const geo = parseStl(buffer)\n    // STL 无单位声明：opts.unit 显式声明优先；未声明时做启发式猜测\n    // （guessStlUnit —— 历史 host 行为，unified §6.1/§8 迁移基线）。猜测与\n    // 折算都在 faijs 内完成（红线 R0），G0 即基准值，宿主不再二次换算。\n    // unit 字段回传源单位（声明值或猜测值），供宿主记录 sourceUnit 元数据。\n    let scale = 1\n    let sourceUnit: UnitName = 'mm'\n    const declared = opts?.unit\n    if (declared) {\n      sourceUnit = declared\n      scale = unitScale(declared)\n    } else {\n      const bb = boundingBox(geo)\n      if (bb.min[0] !== Infinity) {\n        sourceUnit = guessStlUnit({\n          min: [bb.min[0], bb.min[1], bb.min[2]],\n          max: [bb.max[0], bb.max[1], bb.max[2]],\n        })\n        scale = unitScale(sourceUnit)\n      }\n    }\n    if (scale !== 1) {\n      const arr = geo.positions\n      for (let i = 0; i < arr.length; i++) arr[i] *= scale\n    }\n    const shape = geoToManifoldMesh(geo)\n    return { shape, parts: [shape], unit: sourceUnit }\n  }\n\n  // STEP goes through the BREP chain (loadBrep → OCCT, which normalizes to the\n  // base unit on read). The mesh io path has no kernel-independent STEP parser\n  // and must not fake one — a missing path is an error, not a fallback.\n  throw new Error(`[mesh/io] unsupported format: ${fmt}`)\n}\n\n/** 单个 3MF `<build><item>` 对象 → Shape（P0：逐对象构造，替换原\"只取第一个\"收敛）。 */\nfunction threemfObjectToShape(obj: ThreemfObject): Shape {\n  return {\n    positions: obj.positions as Float32Array,\n    indices: obj.indices as Uint32Array,\n    // P2（方案 §5 3MF 行）：对象级 baseColor → appearance.color（sRGB 原值，\n    // 宽容兼容：无 baseColor 不带 appearance）。colorgroup（vertexColors）与\n    // 逐三角形材质属 Phase 2（materialGroups / vertexColors），P2 不映射。\n    ...(obj.baseColor ? { appearance: { color: [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]] } } : {}),\n    // P4（方案 §5 3MF 行）：逐三角形 basematerials（p1=p2=p3）→ materialGroups\n    // （三角形区间 + appearance.color）；无则不带。vertexColors（colorgroup）\n    // 由上层（编辑器导入路径）消费，io 单零件收敛不展开为材质分组。\n    ...(obj.materialGroups && obj.materialGroups.length > 0\n      ? {\n          materialGroups: obj.materialGroups.map((g) => ({\n            start: g.start,\n            count: g.count,\n            appearance: { color: [g.color[0], g.color[1], g.color[2]] } as PbrAppearance,\n          })),\n        }\n      : {}),\n    // 零件级元数据（方案 §5.1 3MF 行）：对象 name/partnumber/metadatagroup → meta。\n    ...(obj.meta ? { meta: obj.meta } : {}),\n  }\n}\n\n/**\n * 由 3MF 装配层级重建 `CompoundShape`（方案 §2.1 / 第 5 步「导入归一」）。\n *\n * 见 `ThreemfArchive.hierarchy` / `localGeomById`：节点带**相对父**位姿（行主序 3×4，\n * 平移在末列，与写出器 `transformToMatrix12` 同源）；几何来自 `localGeomById` 的**未烘焙**\n * 局部网格。叶节点的最终 `Shape.transform` 即该相对位姿（写回 `Shape.transform`，供\n * 后续导出按 3MF `<component transform>` 原样还原——D1 往返）。容器节点落为\n * `CompoundShape`（不含 `transform` / `meta`，与 `shape.ts` 的 `CompoundShape` 形态一致）。\n *\n * 注：`shape.ts` 的 `CompoundShape.children` 当前声明为 `Shape[]`（非递归），故嵌套装配\n * 在类型层面暂不表达；运行时子节点可为子 `CompoundShape`（由 `isCompoundLike` 结构判定消费）。\n * 把 `CompoundShape` 改为递归类型是独立的后续重构（会波及 faijs-extra / cad-runtime），本步\n * 以最小改动桥接——见下方 `children` 处的收窄断言。\n *\n * 仅在存在真实装配（多 item 或任一 item 带 components）时返回非空；单零件平铺导入返回\n * `undefined`（由调用方决定是否挂载到 `result.assembly`，避免改变单零件结果形状）。\n */\nfunction buildAssemblyFromArchive(\n  hierarchy: ThreemfNode[],\n  localGeomById: Map<number, ThreemfObject>,\n): Shape | CompoundShape | undefined {\n  const hasHierarchy = hierarchy.length > 1 || hierarchy.some((n) => (n.children?.length ?? 0) > 0)\n  if (!hasHierarchy) return undefined\n\n  const buildNode = (node: ThreemfNode): Shape | CompoundShape => {\n    const obj = localGeomById.get(node.objectId)\n    if (node.children && node.children.length > 0) {\n      // 收窄断言：共享 CompoundShape 非递归声明，运行时子节点可含子 CompoundShape。\n      return { kind: 'compound', children: node.children.map(buildNode) as Shape[] }\n    }\n    // 叶节点：局部几何 + 相对父位姿。\n    if (!obj || !obj.positions || !obj.indices) {\n      return { kind: 'compound', children: [] }\n    }\n    const leaf = threemfObjectToShape(obj)\n    if (node.transform) {\n      ;(leaf as Shape & { transform?: unknown }).transform = { matrix: Array.from(node.transform) }\n    }\n    return leaf\n  }\n\n  return hierarchy.length === 1\n    ? buildNode(hierarchy[0])\n    : { kind: 'compound', children: hierarchy.map(buildNode) as Shape[] }\n}\n\n/** Bambu 显示视图数据 → ImportModel.bambuViews（无任何 Bambu 结构时省略）。 */\nfunction buildBambuViews(\n  bambu: import('./threemf-bambu').Bambu3mfMetadata,\n): ImportModel['bambuViews'] | undefined {\n  const plates = [...bambu.plates.keys()].sort((a, b) => a - b)\n  if (plates.length === 0 && !bambu.assembleTransforms && !bambu.importTransforms) return undefined\n  const views: NonNullable<ImportModel['bambuViews']> = { plates }\n  if (bambu.assembleTransforms) {\n    views.assembleTransforms = Object.fromEntries(\n      [...bambu.assembleTransforms].map(([k, v]) => [k, { transform: v.transform, offset: v.offset }]),\n    )\n  }\n  if (bambu.importTransforms) {\n    views.importTransforms = Object.fromEntries(\n      [...bambu.importTransforms].map(([k, v]) => [k, { matrix: v.matrix, sourceOffset: v.sourceOffset }]),\n    )\n  }\n  // P4：完整消费面随结果回传——宿主重建 Bambu3mfMetadata 不再回读 archive。\n  if (bambu.buildItems) {\n    views.buildItems = bambu.buildItems.map((b) => ({\n      objectId: b.objectId,\n      transform: b.transform ?? null,\n    }))\n  }\n  if (bambu.filamentColors.length > 0) views.filamentColors = bambu.filamentColors\n  if (bambu.filamentTypes.length > 0) views.filamentTypes = bambu.filamentTypes\n  if (bambu.parts.length > 0) {\n    views.parts = bambu.parts.map((p) => ({\n      partIndex: p.partIndex,\n      objectId: p.objectId,\n      partId: p.partId,\n      name: p.name,\n      extruder: p.extruder,\n      plateId: p.plateId,\n    }))\n  }\n  return views\n}\n"]}

package/dist/mesh/knurl/KnurlGenerator.d.ts

@@ -6,7 +6,8 @@
  *
  * 全程在 mesh 局部空间工作，不需要 world matrix 变换。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C } from '../../math3d/index.js';
+import type { Shape } from '../types.js';
 /**
  * Knurling texture-displacement parameters: texture height, inversion,
  * subdivision resolution, UV scale/offset/rotation, mapping mode, seam
@@ -44,10 +45,10 @@ export interface KnurlParams {
 }
 /** 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） */
 export interface KnurlBounds {
-    min: THREE.Vector3;
-    max: THREE.Vector3;
-    size: THREE.Vector3;
-    center: THREE.Vector3;
+    min: Vec3C;
+    max: Vec3C;
+    size: Vec3C;
+    center: Vec3C;
 }
 /** Default knurling parameters, used for every field the caller leaves unset. */
 export declare const KNURL_DEFAULTS: KnurlParams;
@@ -68,10 +69,10 @@ export declare const KNURL_DEFAULTS: KnurlParams;
  * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.
  * @returns the displaced geometry.
  */
-export declare function applyKnurlDisplacement(geometry: THREE.BufferGeometry, params: KnurlParams, onProgress?: (stage: string, p: number) => void, 
+export declare function applyKnurlDisplacement(geometry: Shape, params: KnurlParams, onProgress?: (stage: string, p: number) => void, 
 /** External whole-part bounds (defaults to the geometry's own bounds).
  *  Passing the whole part's bounds keeps texture density consistent with the
  *  GPU preview, which normalizes against the part bbox while this geometry
  *  is often only the selected-face subset. */
-boundsOverride?: KnurlBounds): Promise<THREE.BufferGeometry>;
+boundsOverride?: KnurlBounds): Promise<Shape>;
 //# sourceMappingURL=KnurlGenerator.d.ts.map

package/dist/mesh/knurl/KnurlGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KnurlGenerator.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAQ9B;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CAClC;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAA;IACnB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CACtB;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI;AAC/C;;;8CAG8C;AAC9C,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAkG/B"}
+{"version":3,"file":"KnurlGenerator.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,cAAc,CAAA;AAM5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAIrC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CAClC;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,KAAK,CAAA;IACV,GAAG,EAAE,KAAK,CAAA;IACV,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,KAAK,CAAA;CACd;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,KAAK,EACf,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI;AAC/C;;;8CAG8C;AAC9C,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,KAAK,CAAC,CAiGhB"}

package/dist/mesh/knurl/KnurlGenerator.js

@@ -6,11 +6,12 @@
  *
  * 全程在 mesh 局部空间工作，不需要 world matrix 变换。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C } from '../../math3d/index.js';
 import { subdivide } from './subdivision.js';
 import { applyDisplacement } from './displacement.js';
 import { loadKnurlingTexture } from './textureLoader.js';
 import { MODE_TRIPLANAR } from './mapping.js';
+import { boundingBox } from '../query.js';
 /** Default knurling parameters, used for every field the caller leaves unset. */
 export const KNURL_DEFAULTS = {
     textureHeight: 0.5,
@@ -69,13 +70,14 @@ boundsOverride) {
     const bounds = boundsOverride
         ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }
         : (() => {
-            geometry.computeBoundingBox();
-            const bb = geometry.boundingBox;
+            const bb = boundingBox(geometry);
+            const bbMin = new Vec3C(bb.min[0], bb.min[1], bb.min[2]);
+            const bbMax = new Vec3C(bb.max[0], bb.max[1], bb.max[2]);
             return {
-                min: bb.min.clone(),
-                max: bb.max.clone(),
-                size: new THREE.Vector3().subVectors(bb.max, bb.min),
-                center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),
+                min: bbMin,
+                max: bbMax,
+                size: new Vec3C().subVectors(bbMax, bbMin),
+                center: new Vec3C().addVectors(bbMin, bbMax).multiplyScalar(0.5),
             };
         })();
     // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），
@@ -109,8 +111,6 @@ boundsOverride) {
         seamBandWidth,
     };
     const result = applyDisplacement(subdivided, texData, texData.width, texData.height, settings, bounds, (p) => onProgress?.('displace', p));
-    // 5. 释放中间几何体
-    subdivided.dispose();
     return result;
 }
 //# sourceMappingURL=KnurlGenerator.js.map

package/dist/mesh/knurl/KnurlGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"KnurlGenerator.js","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * KnurlGenerator — 滚花纹理位移管线编排器\n *\n * 完全照搬 stlTexturizer 的管线：subdivide → applyDisplacement。\n * 使用 knurling.jpg 作为位移纹理。\n *\n * 全程在 mesh 局部空间工作，不需要 world matrix 变换。\n */\n\nimport * as THREE from 'three'\nimport { subdivide } from './subdivision'\nimport { applyDisplacement, type DisplacementSettings } from './displacement'\nimport { loadKnurlingTexture, type TextureData } from './textureLoader'\nimport { MODE_TRIPLANAR } from './mapping'\n\n// ── Types ──\n\n/**\n * Knurling texture-displacement parameters: texture height, inversion,\n * subdivision resolution, UV scale/offset/rotation, mapping mode, seam\n * blending, and angle-based face masking limits.\n */\nexport interface KnurlParams {\n  /** 纹理高度 (mm)，默认 0.5 */\n  textureHeight: number\n  /** 反向（内推而非外推），默认 false */\n  invertDisplacement: boolean\n  /** 分辨率 (mm) — 细分后最大边长，默认 1.0 */\n  refineLength: number\n  /** U 缩放，默认 0.15（knurling 专用） */\n  scaleU: number\n  /** V 缩放，默认 0.15 */\n  scaleV: number\n  /** 投影模式，默认 5 (Triplanar) */\n  mappingMode: number\n  /** UV 偏移 U，默认 0 */\n  offsetU?: number\n  /** UV 偏移 V，默认 0 */\n  offsetV?: number\n  /** UV 旋转（度），默认 0 */\n  rotation?: number\n  /** 底面角度遮罩（度），默认 5 */\n  bottomAngleLimit?: number\n  /** 顶面角度遮罩（度），默认 0（不遮罩） */\n  topAngleLimit?: number\n  /** 接缝混合，默认 1 */\n  mappingBlend?: number\n  /** 接缝带宽，默认 0.5 */\n  seamBandWidth?: number\n  /** 面排除权重（By Surface 用），null = 不排除 */\n  faceWeights?: Float32Array | null\n}\n\n/** 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） */\nexport interface KnurlBounds {\n  min: THREE.Vector3\n  max: THREE.Vector3\n  size: THREE.Vector3\n  center: THREE.Vector3\n}\n\n/** Default knurling parameters, used for every field the caller leaves unset. */\nexport const KNURL_DEFAULTS: KnurlParams = {\n  textureHeight: 0.5,\n  invertDisplacement: false,\n  refineLength: 1.0,\n  scaleU: 0.15,\n  scaleV: 0.15,\n  mappingMode: MODE_TRIPLANAR,\n  offsetU: 0,\n  offsetV: 0,\n  rotation: 0,\n  bottomAngleLimit: 5,\n  topAngleLimit: 0,\n  mappingBlend: 1,\n  seamBandWidth: 0.5,\n  faceWeights: null,\n}\n\n/**\n * Apply a knurling texture displacement to a geometry, entirely in mesh-local\n * space. Pipeline:\n *   1. Load the knurling texture as ImageData.\n *   2. Subdivide the geometry to the effective refine length.\n *   3. Displace the subdivided vertices along their smoothed normals.\n *\n * The effective refine length is never coarser than the caller's\n * `refineLength`: it is clamped so each texture tile keeps ~8 segments when\n * the requested resolution would alias the fine diamond pattern.\n *\n * @param geometry - the source geometry (mesh-local space).\n * @param params - knurl parameters.\n * @param onProgress - optional callback reporting stage and progress ('texture' | 'subdivide' | 'displace').\n * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.\n * @returns the displaced geometry.\n */\nexport async function applyKnurlDisplacement(\n  geometry: THREE.BufferGeometry,\n  params: KnurlParams,\n  onProgress?: (stage: string, p: number) => void,\n  /** External whole-part bounds (defaults to the geometry's own bounds).\n   *  Passing the whole part's bounds keeps texture density consistent with the\n   *  GPU preview, which normalizes against the part bbox while this geometry\n   *  is often only the selected-face subset. */\n  boundsOverride?: KnurlBounds,\n): Promise<THREE.BufferGeometry> {\n  const {\n    textureHeight,\n    invertDisplacement,\n    refineLength,\n    scaleU,\n    scaleV,\n    mappingMode,\n    offsetU = 0,\n    offsetV = 0,\n    rotation = 0,\n    bottomAngleLimit = 5,\n    topAngleLimit = 0,\n    mappingBlend = 1,\n    seamBandWidth = 0.5,\n    faceWeights = null,\n  } = params\n\n  // 1. 加载纹理\n  onProgress?.('texture', 0)\n  let texData: TextureData | null\n  try {\n    texData = await loadKnurlingTexture()\n  } catch (err) {\n    console.error('[KnurlGenerator] Failed to load texture:', err)\n    throw new Error(`Failed to load knurling texture: ${err instanceof Error ? err.message : String(err)}`, { cause: err })\n  }\n\n  if (!texData) {\n    throw new Error('[KnurlGenerator] No texture data available — TextureSampler port not injected')\n  }\n\n  // 2. 计算几何体边界（优先使用整块部件包围盒，使密度与预览一致）\n  const bounds: KnurlBounds = boundsOverride\n    ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }\n    : (() => {\n        geometry.computeBoundingBox()\n        const bb = geometry.boundingBox!\n        return {\n          min: bb.min.clone(),\n          max: bb.max.clone(),\n          size: new THREE.Vector3().subVectors(bb.max, bb.min),\n          center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),\n        }\n      })()\n\n  // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），\n  //    而实刻是真几何位移，受三角形密度限制。若 refineLength 大于滚花纹理\n  //    的物理周期，网格采样不足会把细密菱形混叠成更低频、更稀疏的图案，\n  //    看起来就比预览\"密度低\"。这里保证每瓦片至少 ~8 段，只在用户设得太\n  //    粗时才自动加密——绝不会比用户设定的 refineLength 更粗。\n  const maxDim = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n  const knurlPeriod = Math.max(maxDim * scaleU, 1e-6) // 单个纹理瓦片的物理尺寸 (mm)\n  const minRefineForPattern = knurlPeriod / 8\n  const effectiveRefine = Math.min(refineLength, Math.max(minRefineForPattern, 0.1))\n\n  // 3. 细分\n  onProgress?.('subdivide', 0)\n  const { geometry: subdivided } = await subdivide(\n    geometry,\n    effectiveRefine,\n    (p) => onProgress?.('subdivide', p),\n    faceWeights,\n  )\n\n  // 4. 位移\n  onProgress?.('displace', 0)\n  const settings: DisplacementSettings = {\n    mappingMode,\n    scaleU,\n    scaleV,\n    offsetU,\n    offsetV,\n    rotation,\n    // 与预览着色器 (knurlPreviewMaterial: h = h - 0.5) 保持一致：\n    // 纹理以中灰为 0 的对称高度图，位移范围 [-amplitude/2, +amplitude/2]。\n    amplitude: (invertDisplacement ? -1 : 1) * textureHeight,\n    symmetricDisplacement: true,\n    bottomAngleLimit,\n    topAngleLimit,\n    mappingBlend,\n    seamBandWidth,\n  }\n\n  const result = applyDisplacement(\n    subdivided,\n    texData,\n    texData.width,\n    texData.height,\n    settings,\n    bounds,\n    (p) => onProgress?.('displace', p),\n  )\n\n  // 5. 释放中间几何体\n  subdivided.dispose()\n\n  return result\n}\n"]}
+{"version":3,"file":"KnurlGenerator.js","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * KnurlGenerator — 滚花纹理位移管线编排器\n *\n * 完全照搬 stlTexturizer 的管线：subdivide → applyDisplacement。\n * 使用 knurling.jpg 作为位移纹理。\n *\n * 全程在 mesh 局部空间工作，不需要 world matrix 变换。\n */\n\nimport { Vec3 as Vec3C } from '../../math3d'\nimport { subdivide } from './subdivision'\nimport { applyDisplacement, type DisplacementSettings } from './displacement'\nimport { loadKnurlingTexture, type TextureData } from './textureLoader'\nimport { MODE_TRIPLANAR } from './mapping'\nimport { boundingBox } from '../query'\nimport type { Shape } from '../types'\n\n// ── Types ──\n\n/**\n * Knurling texture-displacement parameters: texture height, inversion,\n * subdivision resolution, UV scale/offset/rotation, mapping mode, seam\n * blending, and angle-based face masking limits.\n */\nexport interface KnurlParams {\n  /** 纹理高度 (mm)，默认 0.5 */\n  textureHeight: number\n  /** 反向（内推而非外推），默认 false */\n  invertDisplacement: boolean\n  /** 分辨率 (mm) — 细分后最大边长，默认 1.0 */\n  refineLength: number\n  /** U 缩放，默认 0.15（knurling 专用） */\n  scaleU: number\n  /** V 缩放，默认 0.15 */\n  scaleV: number\n  /** 投影模式，默认 5 (Triplanar) */\n  mappingMode: number\n  /** UV 偏移 U，默认 0 */\n  offsetU?: number\n  /** UV 偏移 V，默认 0 */\n  offsetV?: number\n  /** UV 旋转（度），默认 0 */\n  rotation?: number\n  /** 底面角度遮罩（度），默认 5 */\n  bottomAngleLimit?: number\n  /** 顶面角度遮罩（度），默认 0（不遮罩） */\n  topAngleLimit?: number\n  /** 接缝混合，默认 1 */\n  mappingBlend?: number\n  /** 接缝带宽，默认 0.5 */\n  seamBandWidth?: number\n  /** 面排除权重（By Surface 用），null = 不排除 */\n  faceWeights?: Float32Array | null\n}\n\n/** 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） */\nexport interface KnurlBounds {\n  min: Vec3C\n  max: Vec3C\n  size: Vec3C\n  center: Vec3C\n}\n\n/** Default knurling parameters, used for every field the caller leaves unset. */\nexport const KNURL_DEFAULTS: KnurlParams = {\n  textureHeight: 0.5,\n  invertDisplacement: false,\n  refineLength: 1.0,\n  scaleU: 0.15,\n  scaleV: 0.15,\n  mappingMode: MODE_TRIPLANAR,\n  offsetU: 0,\n  offsetV: 0,\n  rotation: 0,\n  bottomAngleLimit: 5,\n  topAngleLimit: 0,\n  mappingBlend: 1,\n  seamBandWidth: 0.5,\n  faceWeights: null,\n}\n\n/**\n * Apply a knurling texture displacement to a geometry, entirely in mesh-local\n * space. Pipeline:\n *   1. Load the knurling texture as ImageData.\n *   2. Subdivide the geometry to the effective refine length.\n *   3. Displace the subdivided vertices along their smoothed normals.\n *\n * The effective refine length is never coarser than the caller's\n * `refineLength`: it is clamped so each texture tile keeps ~8 segments when\n * the requested resolution would alias the fine diamond pattern.\n *\n * @param geometry - the source geometry (mesh-local space).\n * @param params - knurl parameters.\n * @param onProgress - optional callback reporting stage and progress ('texture' | 'subdivide' | 'displace').\n * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.\n * @returns the displaced geometry.\n */\nexport async function applyKnurlDisplacement(\n  geometry: Shape,\n  params: KnurlParams,\n  onProgress?: (stage: string, p: number) => void,\n  /** External whole-part bounds (defaults to the geometry's own bounds).\n   *  Passing the whole part's bounds keeps texture density consistent with the\n   *  GPU preview, which normalizes against the part bbox while this geometry\n   *  is often only the selected-face subset. */\n  boundsOverride?: KnurlBounds,\n): Promise<Shape> {\n  const {\n    textureHeight,\n    invertDisplacement,\n    refineLength,\n    scaleU,\n    scaleV,\n    mappingMode,\n    offsetU = 0,\n    offsetV = 0,\n    rotation = 0,\n    bottomAngleLimit = 5,\n    topAngleLimit = 0,\n    mappingBlend = 1,\n    seamBandWidth = 0.5,\n    faceWeights = null,\n  } = params\n\n  // 1. 加载纹理\n  onProgress?.('texture', 0)\n  let texData: TextureData | null\n  try {\n    texData = await loadKnurlingTexture()\n  } catch (err) {\n    console.error('[KnurlGenerator] Failed to load texture:', err)\n    throw new Error(`Failed to load knurling texture: ${err instanceof Error ? err.message : String(err)}`, { cause: err })\n  }\n\n  if (!texData) {\n    throw new Error('[KnurlGenerator] No texture data available — TextureSampler port not injected')\n  }\n\n  // 2. 计算几何体边界（优先使用整块部件包围盒，使密度与预览一致）\n  const bounds: KnurlBounds = boundsOverride\n    ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }\n    : (() => {\n        const bb = boundingBox(geometry)\n        const bbMin = new Vec3C(bb.min[0], bb.min[1], bb.min[2])\n        const bbMax = new Vec3C(bb.max[0], bb.max[1], bb.max[2])\n        return {\n          min: bbMin,\n          max: bbMax,\n          size: new Vec3C().subVectors(bbMax, bbMin),\n          center: new Vec3C().addVectors(bbMin, bbMax).multiplyScalar(0.5),\n        }\n      })()\n\n  // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），\n  //    而实刻是真几何位移，受三角形密度限制。若 refineLength 大于滚花纹理\n  //    的物理周期，网格采样不足会把细密菱形混叠成更低频、更稀疏的图案，\n  //    看起来就比预览\"密度低\"。这里保证每瓦片至少 ~8 段，只在用户设得太\n  //    粗时才自动加密——绝不会比用户设定的 refineLength 更粗。\n  const maxDim = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n  const knurlPeriod = Math.max(maxDim * scaleU, 1e-6) // 单个纹理瓦片的物理尺寸 (mm)\n  const minRefineForPattern = knurlPeriod / 8\n  const effectiveRefine = Math.min(refineLength, Math.max(minRefineForPattern, 0.1))\n\n  // 3. 细分\n  onProgress?.('subdivide', 0)\n  const { geometry: subdivided } = await subdivide(\n    geometry,\n    effectiveRefine,\n    (p) => onProgress?.('subdivide', p),\n    faceWeights,\n  )\n\n  // 4. 位移\n  onProgress?.('displace', 0)\n  const settings: DisplacementSettings = {\n    mappingMode,\n    scaleU,\n    scaleV,\n    offsetU,\n    offsetV,\n    rotation,\n    // 与预览着色器 (knurlPreviewMaterial: h = h - 0.5) 保持一致：\n    // 纹理以中灰为 0 的对称高度图，位移范围 [-amplitude/2, +amplitude/2]。\n    amplitude: (invertDisplacement ? -1 : 1) * textureHeight,\n    symmetricDisplacement: true,\n    bottomAngleLimit,\n    topAngleLimit,\n    mappingBlend,\n    seamBandWidth,\n  }\n\n  const result = applyDisplacement(\n    subdivided,\n    texData,\n    texData.width,\n    texData.height,\n    settings,\n    bounds,\n    (p) => onProgress?.('displace', p),\n  )\n\n\n  return result\n}\n"]}

package/dist/mesh/knurl/displacement.d.ts

@@ -9,7 +9,8 @@
  * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。
  * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C } from '../../math3d/index.js';
+import type { Shape } from '../types.js';
 import { type MappingSettings } from './mapping.js';
 /**
  * Displacement settings: the mapping settings plus the amplitude, optional
@@ -23,10 +24,10 @@ export interface DisplacementSettings extends MappingSettings {
     topAngleLimit?: number;
 }
 interface Bounds {
-    min: THREE.Vector3;
-    max: THREE.Vector3;
-    center: THREE.Vector3;
-    size: THREE.Vector3;
+    min: Vec3C;
+    max: Vec3C;
+    center: Vec3C;
+    size: Vec3C;
 }
 interface ImageDataLike {
     data: Uint8ClampedArray | Uint8Array;
@@ -48,6 +49,6 @@ interface ImageDataLike {
  * @param onProgress - optional callback receiving progress in [0, 1].
  * @returns a new BufferGeometry with displaced positions and face normals.
  */
-export declare function applyDisplacement(geometry: THREE.BufferGeometry, imageData: ImageDataLike, imgWidth: number, imgHeight: number, settings: DisplacementSettings, bounds: Bounds, onProgress?: (p: number) => void): THREE.BufferGeometry;
+export declare function applyDisplacement(geometry: Shape, imageData: ImageDataLike, imgWidth: number, imgHeight: number, settings: DisplacementSettings, bounds: Bounds, onProgress?: (p: number) => void): Shape;
 export {};
 //# sourceMappingURL=displacement.d.ts.map

package/dist/mesh/knurl/displacement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"displacement.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAEjF;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,MAAM;IACd,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;IACrB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAA;CACpB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC/B,KAAK,CAAC,cAAc,CA8OtB"}
+{"version":3,"file":"displacement.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAEjF;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,MAAM;IACd,GAAG,EAAE,KAAK,CAAA;IACV,GAAG,EAAE,KAAK,CAAA;IACV,MAAM,EAAE,KAAK,CAAA;IACb,IAAI,EAAE,KAAK,CAAA;CACZ;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,KAAK,EACf,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC/B,KAAK,CA6OP"}

package/dist/mesh/knurl/displacement.js

@@ -9,7 +9,7 @@
  * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。
  * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C } from '../../math3d/index.js';
 import { QuantizedPointMap } from './meshIndex.js';
 import { computeUV, getCubicBlendWeights } from './mapping.js';
 /**
@@ -28,19 +28,19 @@ import { computeUV, getCubicBlendWeights } from './mapping.js';
  * @returns a new BufferGeometry with displaced positions and face normals.
  */
 export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, settings, bounds, onProgress) {
-    const posAttr = geometry.attributes.position;
-    const nrmAttr = geometry.attributes.normal;
-    const count = posAttr.count;
+    const posAttr = geometry.positions;
+    const nrmAttr = geometry.normals || new Float32Array(posAttr.length);
+    const count = posAttr.length / 3;
     const newPos = new Float32Array(count * 3);
     const newNrm = new Float32Array(count * 3);
-    const tmpPos = new THREE.Vector3();
-    const tmpNrm = new THREE.Vector3();
-    const vA = new THREE.Vector3();
-    const vB = new THREE.Vector3();
-    const vC = new THREE.Vector3();
-    const edge1 = new THREE.Vector3();
-    const edge2 = new THREE.Vector3();
-    const faceNrm = new THREE.Vector3();
+    const tmpPos = new Vec3C();
+    const tmpNrm = new Vec3C();
+    const vA = new Vec3C();
+    const vB = new Vec3C();
+    const vC = new Vec3C();
+    const edge1 = new Vec3C();
+    const edge2 = new Vec3C();
+    const faceNrm = new Vec3C();
     // 纹理纵横比校正
     const tmax = Math.max(imgWidth, imgHeight, 1);
     const aspectU = tmax / Math.max(imgWidth, 1);
@@ -53,7 +53,7 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
     let nextId = 0;
     const vertexId = new Uint32Array(count);
     for (let i = 0; i < count; i++) {
-        const x = posAttr.getX(i), y = posAttr.getY(i), z = posAttr.getZ(i);
+        const x = posAttr[i * 3], y = posAttr[i * 3 + 1], z = posAttr[i * 3 + 2];
         const id = dedupMap.getOrSet(x, y, z, nextId);
         if (dedupMap.inserted)
             nextId++;
@@ -68,13 +68,13 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
     const maskedFracMasked = new Float64Array(uniqueCount);
     const maskedFracTotal = new Float64Array(uniqueCount);
     // 面排除权重
-    const ewAttr = geometry.attributes.excludeWeight || null;
+    const ewAttr = geometry.excludeWeight || null;
     const userExcludedFaces = ewAttr ? new Uint8Array(count / 3) : null;
     const excludedPos = ewAttr ? new Uint8Array(uniqueCount) : null;
     for (let t = 0; t < count; t += 3) {
-        vA.fromBufferAttribute(posAttr, t);
-        vB.fromBufferAttribute(posAttr, t + 1);
-        vC.fromBufferAttribute(posAttr, t + 2);
+        vA.set(posAttr[t * 3], posAttr[t * 3 + 1], posAttr[t * 3 + 2]);
+        vB.set(posAttr[(t + 1) * 3], posAttr[(t + 1) * 3 + 1], posAttr[(t + 1) * 3 + 2]);
+        vC.set(posAttr[(t + 2) * 3], posAttr[(t + 2) * 3 + 1], posAttr[(t + 2) * 3 + 2]);
         edge1.subVectors(vB, vA);
         edge2.subVectors(vC, vA);
         faceNrm.crossVectors(edge1, edge2);
@@ -87,7 +87,7 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
             : (settings.topAngleLimit ?? 0) > 0 &&
                 faceAngle <= (settings.topAngleLimit ?? 0);
         const userExcluded = ewAttr
-            ? (ewAttr.getX(t) + ewAttr.getX(t + 1) + ewAttr.getX(t + 2)) / 3 > 0.99
+            ? (ewAttr[t] + ewAttr[t + 1] + ewAttr[t + 2]) / 3 > 0.99
             : false;
         const faceMasked = angleMasked;
         if (userExcluded && userExcludedFaces)
@@ -96,7 +96,7 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
             const vid = vertexId[t + v];
             if (userExcluded && excludedPos)
                 excludedPos[vid] = 1;
-            tmpNrm.fromBufferAttribute(nrmAttr, t + v);
+            tmpNrm.set(nrmAttr[(t + v) * 3], nrmAttr[(t + v) * 3 + 1], nrmAttr[(t + v) * 3 + 2]);
             smoothNrmX[vid] += tmpNrm.x * faceArea;
             smoothNrmY[vid] += tmpNrm.y * faceArea;
             smoothNrmZ[vid] += tmpNrm.z * faceArea;
@@ -123,7 +123,7 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
         if (dispCacheSet[vid])
             continue;
         dispCacheSet[vid] = 1;
-        tmpPos.fromBufferAttribute(posAttr, i);
+        tmpPos.set(posAttr[i * 3], posAttr[i * 3 + 1], posAttr[i * 3 + 2]);
         // Cubic 模式特殊处理
         if (settings.mappingMode === 6) {
             const md = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6);
@@ -181,8 +181,8 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
     // ── Pass 3: 每个顶点副本沿平滑法线位移 ──
     const REPORT_EVERY = 5000;
     for (let i = 0; i < count; i++) {
-        tmpPos.fromBufferAttribute(posAttr, i);
-        tmpNrm.fromBufferAttribute(nrmAttr, i);
+        tmpPos.set(posAttr[i * 3], posAttr[i * 3 + 1], posAttr[i * 3 + 2]);
+        tmpNrm.set(nrmAttr[i * 3], nrmAttr[i * 3 + 1], nrmAttr[i * 3 + 2]);
         const vid = vertexId[i];
         const grey = dispCacheVal[vid];
         const isFaceExcluded = userExcludedFaces && userExcludedFaces[Math.floor(i / 3)];
@@ -213,9 +213,9 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
             onProgress(i / count);
     }
     // 从位移后位置计算精确的面法线
-    const eA = new THREE.Vector3();
-    const eB = new THREE.Vector3();
-    const fn = new THREE.Vector3();
+    const eA = new Vec3C();
+    const eB = new Vec3C();
+    const fn = new Vec3C();
     for (let t = 0; t < count; t += 3) {
         const ax = newPos[t * 3], ay = newPos[t * 3 + 1], az = newPos[t * 3 + 2];
         const bx = newPos[t * 3 + 3], by = newPos[t * 3 + 4], bz = newPos[t * 3 + 5];
@@ -229,10 +229,10 @@ export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, sett
             newNrm[(t + v) * 3 + 2] = fn.z;
         }
     }
-    const out = new THREE.BufferGeometry();
-    out.setAttribute('position', new THREE.BufferAttribute(newPos, 3));
-    out.setAttribute('normal', new THREE.BufferAttribute(newNrm, 3));
-    return out;
+    const indices = new Uint32Array(count);
+    for (let i = 0; i < count; i++)
+        indices[i] = i;
+    return { positions: newPos, indices, normals: newNrm };
 }
 // ── 双线性采样 ──
 function sampleBilinear(data, w, h, u, v) {

package/dist/mesh/knurl/displacement.js.map

@@ -1 +1 @@
-{"version":3,"file":"displacement.js","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * displacement.ts — 纹理位移核心，从 stlTexturizer/js/displacement.js 移植为 TS（简化版）。\n *\n * 对每个顶点：\n *   1. 用与 GPU 预览 shader 相同的数学计算 UV（mapping.ts）\n *   2. 双线性采样灰度 ImageData\n *   3. 沿平滑法线位移：grey × amplitude\n *\n * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。\n * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。\n */\n\nimport * as THREE from 'three'\nimport { QuantizedPointMap } from './meshIndex'\nimport { computeUV, getCubicBlendWeights, type MappingSettings } from './mapping'\n\n/**\n * Displacement settings: the mapping settings plus the amplitude, optional\n * symmetric displacement, and angle-based face-masking limits.\n */\nexport interface DisplacementSettings extends MappingSettings {\n  mappingMode: number\n  amplitude: number\n  symmetricDisplacement?: boolean\n  bottomAngleLimit?: number\n  topAngleLimit?: number\n}\n\ninterface Bounds {\n  min: THREE.Vector3\n  max: THREE.Vector3\n  center: THREE.Vector3\n  size: THREE.Vector3\n}\n\ninterface ImageDataLike {\n  data: Uint8ClampedArray | Uint8Array\n  width: number\n  height: number\n}\n\n/**\n * Displace every vertex of a non-indexed BufferGeometry. For each vertex the\n * UV is computed with the same math as the GPU preview shader, the greyscale\n * ImageData is sampled bilinearly, and the position is shifted along the\n * smoothed normal by grey × amplitude.\n *\n * @param geometry - the non-indexed source geometry (position + normal attributes).\n * @param imageData - RGBA pixel data of the height map.\n * @param imgWidth - texture width in pixels.\n * @param imgHeight - texture height in pixels.\n * @param settings - displacement and mapping settings.\n * @param bounds - overall mesh bounds used to normalize UV coordinates.\n * @param onProgress - optional callback receiving progress in [0, 1].\n * @returns a new BufferGeometry with displaced positions and face normals.\n */\nexport function applyDisplacement(\n  geometry: THREE.BufferGeometry,\n  imageData: ImageDataLike,\n  imgWidth: number,\n  imgHeight: number,\n  settings: DisplacementSettings,\n  bounds: Bounds,\n  onProgress?: (p: number) => void,\n): THREE.BufferGeometry {\n  const posAttr = geometry.attributes.position\n  const nrmAttr = geometry.attributes.normal\n  const count = posAttr.count\n\n  const newPos = new Float32Array(count * 3)\n  const newNrm = new Float32Array(count * 3)\n\n  const tmpPos = new THREE.Vector3()\n  const tmpNrm = new THREE.Vector3()\n  const vA = new THREE.Vector3()\n  const vB = new THREE.Vector3()\n  const vC = new THREE.Vector3()\n  const edge1 = new THREE.Vector3()\n  const edge2 = new THREE.Vector3()\n  const faceNrm = new THREE.Vector3()\n\n  // 纹理纵横比校正\n  const tmax = Math.max(imgWidth, imgHeight, 1)\n  const aspectU = tmax / Math.max(imgWidth, 1)\n  const aspectV = tmax / Math.max(imgHeight, 1)\n  const settingsWithAspect = { ...settings, textureAspectU: aspectU, textureAspectV: aspectV }\n\n  // 10μm 顶点去重\n  const QUANT = 1e5\n\n  // ── 顶点去重：position → numeric ID ──\n  const dedupMap = new QuantizedPointMap(QUANT, Math.min(count, 1 << 22))\n  let nextId = 0\n  const vertexId = new Uint32Array(count)\n  for (let i = 0; i < count; i++) {\n    const x = posAttr.getX(i),\n      y = posAttr.getY(i),\n      z = posAttr.getZ(i)\n    const id = dedupMap.getOrSet(x, y, z, nextId)\n    if (dedupMap.inserted) nextId++\n    vertexId[i] = id\n  }\n  const uniqueCount = nextId\n\n  // ── Pass 1: 每个唯一顶点累加面积加权平滑法线 ──\n  const smoothNrmX = new Float64Array(uniqueCount)\n  const smoothNrmY = new Float64Array(uniqueCount)\n  const smoothNrmZ = new Float64Array(uniqueCount)\n\n  // 角度遮罩\n  const maskedFracMasked = new Float64Array(uniqueCount)\n  const maskedFracTotal = new Float64Array(uniqueCount)\n\n  // 面排除权重\n  const ewAttr = geometry.attributes.excludeWeight || null\n  const userExcludedFaces = ewAttr ? new Uint8Array(count / 3) : null\n  const excludedPos = ewAttr ? new Uint8Array(uniqueCount) : null\n\n  for (let t = 0; t < count; t += 3) {\n    vA.fromBufferAttribute(posAttr, t)\n    vB.fromBufferAttribute(posAttr, t + 1)\n    vC.fromBufferAttribute(posAttr, t + 2)\n    edge1.subVectors(vB, vA)\n    edge2.subVectors(vC, vA)\n    faceNrm.crossVectors(edge1, edge2)\n\n    const faceArea = faceNrm.length()\n    const faceNzNorm = faceArea > 1e-12 ? faceNrm.z / faceArea : 0\n    const faceAngle = Math.acos(Math.abs(faceNzNorm)) * (180 / Math.PI)\n    const angleMasked =\n      faceNzNorm < 0\n        ? (settings.bottomAngleLimit ?? 0) > 0 &&\n          faceAngle <= (settings.bottomAngleLimit ?? 0)\n        : (settings.topAngleLimit ?? 0) > 0 &&\n          faceAngle <= (settings.topAngleLimit ?? 0)\n\n    const userExcluded = ewAttr\n      ? (ewAttr.getX(t) + ewAttr.getX(t + 1) + ewAttr.getX(t + 2)) / 3 > 0.99\n      : false\n    const faceMasked = angleMasked\n    if (userExcluded && userExcludedFaces) userExcludedFaces[t / 3] = 1\n\n    for (let v = 0; v < 3; v++) {\n      const vid = vertexId[t + v]\n      if (userExcluded && excludedPos) excludedPos[vid] = 1\n      tmpNrm.fromBufferAttribute(nrmAttr, t + v)\n      smoothNrmX[vid] += tmpNrm.x * faceArea\n      smoothNrmY[vid] += tmpNrm.y * faceArea\n      smoothNrmZ[vid] += tmpNrm.z * faceArea\n      if (faceMasked) maskedFracMasked[vid] += faceArea\n      maskedFracTotal[vid] += faceArea\n    }\n  }\n\n  // 归一化平滑法线\n  for (let id = 0; id < uniqueCount; id++) {\n    const len = Math.sqrt(\n      smoothNrmX[id] * smoothNrmX[id] +\n        smoothNrmY[id] * smoothNrmY[id] +\n        smoothNrmZ[id] * smoothNrmZ[id],\n    )\n    const inv = len > 0 ? 1 / len : 1\n    smoothNrmX[id] *= inv\n    smoothNrmY[id] *= inv\n    smoothNrmZ[id] *= inv\n  }\n\n  // ── Pass 2: 每个唯一顶点采样纹理一次 ──\n  const dispCacheVal = new Float64Array(uniqueCount)\n  const dispCacheSet = new Uint8Array(uniqueCount)\n\n  for (let i = 0; i < count; i++) {\n    const vid = vertexId[i]\n    if (dispCacheSet[vid]) continue\n    dispCacheSet[vid] = 1\n\n    tmpPos.fromBufferAttribute(posAttr, i)\n\n    // Cubic 模式特殊处理\n    if (settings.mappingMode === 6) {\n      const md = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n      const rotRad = (settings.rotation ?? 0) * Math.PI / 180\n      const cubicBlend = settings.mappingBlend ?? 0\n      const cubicBandWidth = settings.seamBandWidth ?? 0.35\n\n      const sn = {\n        x: smoothNrmX[vid],\n        y: smoothNrmY[vid],\n        z: smoothNrmZ[vid],\n      }\n      const w = getCubicBlendWeights(sn, cubicBlend, cubicBandWidth)\n\n      if (w.x + w.y + w.z > 0) {\n        let grey = 0\n        if (w.x > 0) {\n          let rawU = (tmpPos.y - bounds.min.y) / md\n          if (smoothNrmX[vid] < 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.x\n        }\n        if (w.y > 0) {\n          let rawU = (tmpPos.x - bounds.min.x) / md\n          if (smoothNrmY[vid] > 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.y\n        }\n        if (w.z > 0) {\n          let rawU = (tmpPos.x - bounds.min.x) / md\n          if (smoothNrmZ[vid] < 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.y - bounds.min.y) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.z\n        }\n        dispCacheVal[vid] = grey\n        continue\n      }\n    }\n\n    // 其他模式：用平滑法线计算 UV\n    tmpNrm.set(smoothNrmX[vid], smoothNrmY[vid], smoothNrmZ[vid])\n\n    const uvResult = computeUV(tmpPos, tmpNrm, settings.mappingMode, settingsWithAspect, bounds)\n    let grey: number\n    if (uvResult.triplanar && uvResult.samples) {\n      grey = 0\n      for (const s of uvResult.samples) {\n        grey += sampleBilinear(imageData.data, imgWidth, imgHeight, s.u, s.v) * s.w\n      }\n    } else {\n      grey = sampleBilinear(imageData.data, imgWidth, imgHeight, uvResult.u, uvResult.v)\n    }\n    dispCacheVal[vid] = grey\n  }\n\n  // ── Pass 3: 每个顶点副本沿平滑法线位移 ──\n  const REPORT_EVERY = 5000\n\n  for (let i = 0; i < count; i++) {\n    tmpPos.fromBufferAttribute(posAttr, i)\n    tmpNrm.fromBufferAttribute(nrmAttr, i)\n\n    const vid = vertexId[i]\n    const grey = dispCacheVal[vid]\n\n    const isFaceExcluded = userExcludedFaces && userExcludedFaces[Math.floor(i / 3)]\n    const isSealedBoundary = !isFaceExcluded && excludedPos && excludedPos[vid] === 1\n    const mfTotal = maskedFracTotal[vid]\n    const maskedFrac = mfTotal > 0 ? maskedFracMasked[vid] / mfTotal : 0\n    const centeredGrey = settings.symmetricDisplacement ? grey - 0.5 : grey\n    const disp =\n      isFaceExcluded || isSealedBoundary\n        ? 0\n        : (1 - maskedFrac) * centeredGrey * settings.amplitude\n\n    const newX = tmpPos.x + smoothNrmX[vid] * disp\n    const newY = tmpPos.y + smoothNrmY[vid] * disp\n    let newZ = tmpPos.z + smoothNrmZ[vid] * disp\n\n    // 防止边界顶点穿过遮罩表面\n    if (maskedFrac > 0) {\n      if ((settings.bottomAngleLimit ?? 0) > 0 && newZ < tmpPos.z) newZ = tmpPos.z\n      if ((settings.topAngleLimit ?? 0) > 0 && newZ > tmpPos.z) newZ = tmpPos.z\n    }\n\n    newPos[i * 3] = newX\n    newPos[i * 3 + 1] = newY\n    newPos[i * 3 + 2] = newZ\n\n    newNrm[i * 3] = tmpNrm.x\n    newNrm[i * 3 + 1] = tmpNrm.y\n    newNrm[i * 3 + 2] = tmpNrm.z\n\n    if (onProgress && i % REPORT_EVERY === 0) onProgress(i / count)\n  }\n\n  // 从位移后位置计算精确的面法线\n  const eA = new THREE.Vector3()\n  const eB = new THREE.Vector3()\n  const fn = new THREE.Vector3()\n  for (let t = 0; t < count; t += 3) {\n    const ax = newPos[t * 3],\n      ay = newPos[t * 3 + 1],\n      az = newPos[t * 3 + 2]\n    const bx = newPos[t * 3 + 3],\n      by = newPos[t * 3 + 4],\n      bz = newPos[t * 3 + 5]\n    const cx = newPos[t * 3 + 6],\n      cy = newPos[t * 3 + 7],\n      cz = newPos[t * 3 + 8]\n    eA.set(bx - ax, by - ay, bz - az)\n    eB.set(cx - ax, cy - ay, cz - az)\n    fn.crossVectors(eA, eB).normalize()\n    for (let v = 0; v < 3; v++) {\n      newNrm[(t + v) * 3] = fn.x\n      newNrm[(t + v) * 3 + 1] = fn.y\n      newNrm[(t + v) * 3 + 2] = fn.z\n    }\n  }\n\n  const out = new THREE.BufferGeometry()\n  out.setAttribute('position', new THREE.BufferAttribute(newPos, 3))\n  out.setAttribute('normal', new THREE.BufferAttribute(newNrm, 3))\n  return out\n}\n\n// ── 双线性采样 ──\n\nfunction sampleBilinear(\n  data: Uint8ClampedArray | Uint8Array,\n  w: number,\n  h: number,\n  u: number,\n  v: number,\n): number {\n  u = ((u % 1) + 1) % 1\n  v = ((v % 1) + 1) % 1\n  v = 1 - v\n\n  const fx = u * w - 0.5\n  const fy = v * h - 0.5\n  let x0 = Math.floor(fx)\n  let y0 = Math.floor(fy)\n  const tx = fx - x0\n  const ty = fy - y0\n  const x1 = (x0 + 1 + w) % w\n  const y1 = (y0 + 1 + h) % h\n  x0 = ((x0 % w) + w) % w\n  y0 = ((y0 % h) + h) % h\n\n  const v00 = data[(y0 * w + x0) * 4] / 255\n  const v10 = data[(y0 * w + x1) * 4] / 255\n  const v01 = data[(y1 * w + x0) * 4] / 255\n  const v11 = data[(y1 * w + x1) * 4] / 255\n\n  return (\n    v00 * (1 - tx) * (1 - ty) +\n    v10 * tx * (1 - ty) +\n    v01 * (1 - tx) * ty +\n    v11 * tx * ty\n  )\n}\n\nfunction _cubicUV(\n  rawU: number,\n  rawV: number,\n  settings: DisplacementSettings,\n  rotRad: number,\n  aspectU: number,\n  aspectV: number,\n): { u: number; v: number } {\n  let u = (rawU * aspectU) / settings.scaleU + settings.offsetU\n  let v = (rawV * aspectV) / settings.scaleV + settings.offsetV\n  if (rotRad !== 0) {\n    const c = Math.cos(rotRad),\n      s = Math.sin(rotRad)\n    u -= 0.5\n    v -= 0.5\n    const ru = c * u - s * v,\n      rv = s * u + c * v\n    u = ru + 0.5\n    v = rv + 0.5\n  }\n  return { u: u - Math.floor(u), v: v - Math.floor(v) }\n}\n"]}
+{"version":3,"file":"displacement.js","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * displacement.ts — 纹理位移核心，从 stlTexturizer/js/displacement.js 移植为 TS（简化版）。\n *\n * 对每个顶点：\n *   1. 用与 GPU 预览 shader 相同的数学计算 UV（mapping.ts）\n *   2. 双线性采样灰度 ImageData\n *   3. 沿平滑法线位移：grey × amplitude\n *\n * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。\n * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。\n */\n\nimport { Vec3 as Vec3C } from '../../math3d'\nimport type { Shape } from '../types'\nimport { QuantizedPointMap } from './meshIndex'\nimport { computeUV, getCubicBlendWeights, type MappingSettings } from './mapping'\n\n/**\n * Displacement settings: the mapping settings plus the amplitude, optional\n * symmetric displacement, and angle-based face-masking limits.\n */\nexport interface DisplacementSettings extends MappingSettings {\n  mappingMode: number\n  amplitude: number\n  symmetricDisplacement?: boolean\n  bottomAngleLimit?: number\n  topAngleLimit?: number\n}\n\ninterface Bounds {\n  min: Vec3C\n  max: Vec3C\n  center: Vec3C\n  size: Vec3C\n}\n\ninterface ImageDataLike {\n  data: Uint8ClampedArray | Uint8Array\n  width: number\n  height: number\n}\n\n/**\n * Displace every vertex of a non-indexed BufferGeometry. For each vertex the\n * UV is computed with the same math as the GPU preview shader, the greyscale\n * ImageData is sampled bilinearly, and the position is shifted along the\n * smoothed normal by grey × amplitude.\n *\n * @param geometry - the non-indexed source geometry (position + normal attributes).\n * @param imageData - RGBA pixel data of the height map.\n * @param imgWidth - texture width in pixels.\n * @param imgHeight - texture height in pixels.\n * @param settings - displacement and mapping settings.\n * @param bounds - overall mesh bounds used to normalize UV coordinates.\n * @param onProgress - optional callback receiving progress in [0, 1].\n * @returns a new BufferGeometry with displaced positions and face normals.\n */\nexport function applyDisplacement(\n  geometry: Shape,\n  imageData: ImageDataLike,\n  imgWidth: number,\n  imgHeight: number,\n  settings: DisplacementSettings,\n  bounds: Bounds,\n  onProgress?: (p: number) => void,\n): Shape {\n  const posAttr = geometry.positions\n  const nrmAttr = geometry.normals || new Float32Array(posAttr.length)\n  const count = posAttr.length / 3\n\n  const newPos = new Float32Array(count * 3)\n  const newNrm = new Float32Array(count * 3)\n\n  const tmpPos = new Vec3C()\n  const tmpNrm = new Vec3C()\n  const vA = new Vec3C()\n  const vB = new Vec3C()\n  const vC = new Vec3C()\n  const edge1 = new Vec3C()\n  const edge2 = new Vec3C()\n  const faceNrm = new Vec3C()\n\n  // 纹理纵横比校正\n  const tmax = Math.max(imgWidth, imgHeight, 1)\n  const aspectU = tmax / Math.max(imgWidth, 1)\n  const aspectV = tmax / Math.max(imgHeight, 1)\n  const settingsWithAspect = { ...settings, textureAspectU: aspectU, textureAspectV: aspectV }\n\n  // 10μm 顶点去重\n  const QUANT = 1e5\n\n  // ── 顶点去重：position → numeric ID ──\n  const dedupMap = new QuantizedPointMap(QUANT, Math.min(count, 1 << 22))\n  let nextId = 0\n  const vertexId = new Uint32Array(count)\n  for (let i = 0; i < count; i++) {\n    const x = posAttr[i * 3],\n      y = posAttr[i * 3 + 1],\n      z = posAttr[i * 3 + 2]\n    const id = dedupMap.getOrSet(x, y, z, nextId)\n    if (dedupMap.inserted) nextId++\n    vertexId[i] = id\n  }\n  const uniqueCount = nextId\n\n  // ── Pass 1: 每个唯一顶点累加面积加权平滑法线 ──\n  const smoothNrmX = new Float64Array(uniqueCount)\n  const smoothNrmY = new Float64Array(uniqueCount)\n  const smoothNrmZ = new Float64Array(uniqueCount)\n\n  // 角度遮罩\n  const maskedFracMasked = new Float64Array(uniqueCount)\n  const maskedFracTotal = new Float64Array(uniqueCount)\n\n  // 面排除权重\n  const ewAttr = (geometry as Shape & { excludeWeight?: Float32Array | null }).excludeWeight || null\n  const userExcludedFaces = ewAttr ? new Uint8Array(count / 3) : null\n  const excludedPos = ewAttr ? new Uint8Array(uniqueCount) : null\n\n  for (let t = 0; t < count; t += 3) {\n    vA.set(posAttr[t * 3], posAttr[t * 3 + 1], posAttr[t * 3 + 2])\n    vB.set(posAttr[(t + 1) * 3], posAttr[(t + 1) * 3 + 1], posAttr[(t + 1) * 3 + 2])\n    vC.set(posAttr[(t + 2) * 3], posAttr[(t + 2) * 3 + 1], posAttr[(t + 2) * 3 + 2])\n    edge1.subVectors(vB, vA)\n    edge2.subVectors(vC, vA)\n    faceNrm.crossVectors(edge1, edge2)\n\n    const faceArea = faceNrm.length()\n    const faceNzNorm = faceArea > 1e-12 ? faceNrm.z / faceArea : 0\n    const faceAngle = Math.acos(Math.abs(faceNzNorm)) * (180 / Math.PI)\n    const angleMasked =\n      faceNzNorm < 0\n        ? (settings.bottomAngleLimit ?? 0) > 0 &&\n          faceAngle <= (settings.bottomAngleLimit ?? 0)\n        : (settings.topAngleLimit ?? 0) > 0 &&\n          faceAngle <= (settings.topAngleLimit ?? 0)\n\n    const userExcluded = ewAttr\n      ? (ewAttr[t] + ewAttr[t + 1] + ewAttr[t + 2]) / 3 > 0.99\n      : false\n    const faceMasked = angleMasked\n    if (userExcluded && userExcludedFaces) userExcludedFaces[t / 3] = 1\n\n    for (let v = 0; v < 3; v++) {\n      const vid = vertexId[t + v]\n      if (userExcluded && excludedPos) excludedPos[vid] = 1\n      tmpNrm.set(nrmAttr[(t + v) * 3], nrmAttr[(t + v) * 3 + 1], nrmAttr[(t + v) * 3 + 2])\n      smoothNrmX[vid] += tmpNrm.x * faceArea\n      smoothNrmY[vid] += tmpNrm.y * faceArea\n      smoothNrmZ[vid] += tmpNrm.z * faceArea\n      if (faceMasked) maskedFracMasked[vid] += faceArea\n      maskedFracTotal[vid] += faceArea\n    }\n  }\n\n  // 归一化平滑法线\n  for (let id = 0; id < uniqueCount; id++) {\n    const len = Math.sqrt(\n      smoothNrmX[id] * smoothNrmX[id] +\n        smoothNrmY[id] * smoothNrmY[id] +\n        smoothNrmZ[id] * smoothNrmZ[id],\n    )\n    const inv = len > 0 ? 1 / len : 1\n    smoothNrmX[id] *= inv\n    smoothNrmY[id] *= inv\n    smoothNrmZ[id] *= inv\n  }\n\n  // ── Pass 2: 每个唯一顶点采样纹理一次 ──\n  const dispCacheVal = new Float64Array(uniqueCount)\n  const dispCacheSet = new Uint8Array(uniqueCount)\n\n  for (let i = 0; i < count; i++) {\n    const vid = vertexId[i]\n    if (dispCacheSet[vid]) continue\n    dispCacheSet[vid] = 1\n\n    tmpPos.set(posAttr[i * 3], posAttr[i * 3 + 1], posAttr[i * 3 + 2])\n\n    // Cubic 模式特殊处理\n    if (settings.mappingMode === 6) {\n      const md = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n      const rotRad = (settings.rotation ?? 0) * Math.PI / 180\n      const cubicBlend = settings.mappingBlend ?? 0\n      const cubicBandWidth = settings.seamBandWidth ?? 0.35\n\n      const sn = {\n        x: smoothNrmX[vid],\n        y: smoothNrmY[vid],\n        z: smoothNrmZ[vid],\n      }\n      const w = getCubicBlendWeights(sn, cubicBlend, cubicBandWidth)\n\n      if (w.x + w.y + w.z > 0) {\n        let grey = 0\n        if (w.x > 0) {\n          let rawU = (tmpPos.y - bounds.min.y) / md\n          if (smoothNrmX[vid] < 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.x\n        }\n        if (w.y > 0) {\n          let rawU = (tmpPos.x - bounds.min.x) / md\n          if (smoothNrmY[vid] > 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.y\n        }\n        if (w.z > 0) {\n          let rawU = (tmpPos.x - bounds.min.x) / md\n          if (smoothNrmZ[vid] < 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.y - bounds.min.y) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.z\n        }\n        dispCacheVal[vid] = grey\n        continue\n      }\n    }\n\n    // 其他模式：用平滑法线计算 UV\n    tmpNrm.set(smoothNrmX[vid], smoothNrmY[vid], smoothNrmZ[vid])\n\n    const uvResult = computeUV(tmpPos, tmpNrm, settings.mappingMode, settingsWithAspect, bounds)\n    let grey: number\n    if (uvResult.triplanar && uvResult.samples) {\n      grey = 0\n      for (const s of uvResult.samples) {\n        grey += sampleBilinear(imageData.data, imgWidth, imgHeight, s.u, s.v) * s.w\n      }\n    } else {\n      grey = sampleBilinear(imageData.data, imgWidth, imgHeight, uvResult.u, uvResult.v)\n    }\n    dispCacheVal[vid] = grey\n  }\n\n  // ── Pass 3: 每个顶点副本沿平滑法线位移 ──\n  const REPORT_EVERY = 5000\n\n  for (let i = 0; i < count; i++) {\n    tmpPos.set(posAttr[i * 3], posAttr[i * 3 + 1], posAttr[i * 3 + 2])\n    tmpNrm.set(nrmAttr[i * 3], nrmAttr[i * 3 + 1], nrmAttr[i * 3 + 2])\n\n    const vid = vertexId[i]\n    const grey = dispCacheVal[vid]\n\n    const isFaceExcluded = userExcludedFaces && userExcludedFaces[Math.floor(i / 3)]\n    const isSealedBoundary = !isFaceExcluded && excludedPos && excludedPos[vid] === 1\n    const mfTotal = maskedFracTotal[vid]\n    const maskedFrac = mfTotal > 0 ? maskedFracMasked[vid] / mfTotal : 0\n    const centeredGrey = settings.symmetricDisplacement ? grey - 0.5 : grey\n    const disp =\n      isFaceExcluded || isSealedBoundary\n        ? 0\n        : (1 - maskedFrac) * centeredGrey * settings.amplitude\n\n    const newX = tmpPos.x + smoothNrmX[vid] * disp\n    const newY = tmpPos.y + smoothNrmY[vid] * disp\n    let newZ = tmpPos.z + smoothNrmZ[vid] * disp\n\n    // 防止边界顶点穿过遮罩表面\n    if (maskedFrac > 0) {\n      if ((settings.bottomAngleLimit ?? 0) > 0 && newZ < tmpPos.z) newZ = tmpPos.z\n      if ((settings.topAngleLimit ?? 0) > 0 && newZ > tmpPos.z) newZ = tmpPos.z\n    }\n\n    newPos[i * 3] = newX\n    newPos[i * 3 + 1] = newY\n    newPos[i * 3 + 2] = newZ\n\n    newNrm[i * 3] = tmpNrm.x\n    newNrm[i * 3 + 1] = tmpNrm.y\n    newNrm[i * 3 + 2] = tmpNrm.z\n\n    if (onProgress && i % REPORT_EVERY === 0) onProgress(i / count)\n  }\n\n  // 从位移后位置计算精确的面法线\n  const eA = new Vec3C()\n  const eB = new Vec3C()\n  const fn = new Vec3C()\n  for (let t = 0; t < count; t += 3) {\n    const ax = newPos[t * 3],\n      ay = newPos[t * 3 + 1],\n      az = newPos[t * 3 + 2]\n    const bx = newPos[t * 3 + 3],\n      by = newPos[t * 3 + 4],\n      bz = newPos[t * 3 + 5]\n    const cx = newPos[t * 3 + 6],\n      cy = newPos[t * 3 + 7],\n      cz = newPos[t * 3 + 8]\n    eA.set(bx - ax, by - ay, bz - az)\n    eB.set(cx - ax, cy - ay, cz - az)\n    fn.crossVectors(eA, eB).normalize()\n    for (let v = 0; v < 3; v++) {\n      newNrm[(t + v) * 3] = fn.x\n      newNrm[(t + v) * 3 + 1] = fn.y\n      newNrm[(t + v) * 3 + 2] = fn.z\n    }\n  }\n\n  const indices = new Uint32Array(count)\n  for (let i = 0; i < count; i++) indices[i] = i\n  return { positions: newPos, indices, normals: newNrm }\n}\n\n// ── 双线性采样 ──\n\nfunction sampleBilinear(\n  data: Uint8ClampedArray | Uint8Array,\n  w: number,\n  h: number,\n  u: number,\n  v: number,\n): number {\n  u = ((u % 1) + 1) % 1\n  v = ((v % 1) + 1) % 1\n  v = 1 - v\n\n  const fx = u * w - 0.5\n  const fy = v * h - 0.5\n  let x0 = Math.floor(fx)\n  let y0 = Math.floor(fy)\n  const tx = fx - x0\n  const ty = fy - y0\n  const x1 = (x0 + 1 + w) % w\n  const y1 = (y0 + 1 + h) % h\n  x0 = ((x0 % w) + w) % w\n  y0 = ((y0 % h) + h) % h\n\n  const v00 = data[(y0 * w + x0) * 4] / 255\n  const v10 = data[(y0 * w + x1) * 4] / 255\n  const v01 = data[(y1 * w + x0) * 4] / 255\n  const v11 = data[(y1 * w + x1) * 4] / 255\n\n  return (\n    v00 * (1 - tx) * (1 - ty) +\n    v10 * tx * (1 - ty) +\n    v01 * (1 - tx) * ty +\n    v11 * tx * ty\n  )\n}\n\nfunction _cubicUV(\n  rawU: number,\n  rawV: number,\n  settings: DisplacementSettings,\n  rotRad: number,\n  aspectU: number,\n  aspectV: number,\n): { u: number; v: number } {\n  let u = (rawU * aspectU) / settings.scaleU + settings.offsetU\n  let v = (rawV * aspectV) / settings.scaleV + settings.offsetV\n  if (rotRad !== 0) {\n    const c = Math.cos(rotRad),\n      s = Math.sin(rotRad)\n    u -= 0.5\n    v -= 0.5\n    const ru = c * u - s * v,\n      rv = s * u + c * v\n    u = ru + 0.5\n    v = rv + 0.5\n  }\n  return { u: u - Math.floor(u), v: v - Math.floor(v) }\n}\n"]}

package/dist/mesh/knurl/subdivision.d.ts

@@ -33,7 +33,7 @@
  *     - E2E 测试通过：hasNaN: false, bounds 正确
  *     - 原始 bounds [0,0,0]~[150,120,90] → knurl 后 [-0.5,-0.5,0]~[150.5,120.5,90.5]
  */
-import * as THREE from 'three';
+import type { Shape } from '../types.js';
 /**
  * Adaptively subdivide a geometry until every edge is ≤ maxEdgeLength.
  * Indexed inputs are expanded to non-indexed form first; sharp edges are
@@ -47,8 +47,8 @@ import * as THREE from 'three';
  * @param faceWeights - optional per-face exclusion weights (non-indexed triangle soup layout).
  * @returns the subdivided non-indexed geometry and whether the safety cap was reached.
  */
-export declare function subdivide(geometry: THREE.BufferGeometry, maxEdgeLength: number, onProgress?: (p: number, triCount: number, longestEdge: number) => void, faceWeights?: Float32Array | null): Promise<{
-    geometry: THREE.BufferGeometry;
+export declare function subdivide(geometry: Shape, maxEdgeLength: number, onProgress?: (p: number, triCount: number, longestEdge: number) => void, faceWeights?: Float32Array | null): Promise<{
+    geometry: Shape;
     safetyCapHit: boolean;
 }>;
 //# sourceMappingURL=subdivision.d.ts.map

package/dist/mesh/knurl/subdivision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subdivision.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/subdivision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA6D9B;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,EACvE,WAAW,GAAE,YAAY,GAAG,IAAW,GACtC,OAAO,CAAC;IACT,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAA;IAC9B,YAAY,EAAE,OAAO,CAAA;CACtB,CAAC,CAsED"}
+{"version":3,"file":"subdivision.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/subdivision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AA8DrC;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,KAAK,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,EACvE,WAAW,GAAE,YAAY,GAAG,IAAW,GACtC,OAAO,CAAC;IACT,QAAQ,EAAE,KAAK,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;CACtB,CAAC,CAuED"}