@faicad/faijs 0.13.2 → 0.16.0

package/dist/mesh/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/mesh/primitives.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 基本体 API — 从现有纯函数提取的统一接口\n *\n * 提取来源（§5.7）：\n * - box/sphere/cylinder/cone/wedge ← engine/primitives/mesh-primitives.ts (makePrimitiveGeo)\n * - text ← engine/components/engraving/EngravingCore.ts (createTextGeometry)\n * - screw ← engine/primitives/screw/screw.ts (makeScrew)\n * - svgExtrude ← engine/primitives/svg-extrude/ (svgToExtrudedGeometry)\n *\n * 所有函数返回 Shape (ManifoldMeshData)：THREE.BufferGeometry → geoToManifoldMesh 转换。\n * 坐标系：Z-up、毫米。\n */\n\nimport * as THREE from 'three'\nimport { makePrimitiveGeo } from '../primitives/mesh-primitives'\nimport { geoToManifoldMesh } from '../boolean/csg-backend'\nimport { svgToExtrudedGeometry } from '../primitives/svg-extrude'\nimport type { Shape, BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams, TextParams, SvgExtrudeParams, SdfParams } from './types'\nimport { clampNRad } from './types'\n\n// ── 内部工具 ──\n\n/** THREE.BufferGeometry → Shape (ManifoldMeshData) */\nfunction geoToShape(geo: THREE.BufferGeometry): Shape {\n  return geoToManifoldMesh(geo)\n}\n\n// ── 创建 API ──\n\n/**\n * Create a box solid (brepjs contract, §4.1 A 决策).\n *\n * `box(width, depth, height)` — X=width, Y=depth, Z=height — places the\n * min-corner at the origin by default (`centered:false`). `centered: true`\n * centers the box at the origin; `at` is CENTER semantics and takes precedence\n * over `centered`. The `segments` option is consumed by the tessellation\n * caller (this mesh builder keeps it via clampNRad when present).\n *\n * @param params - box parameters (width/depth/height, optional at/centered/segments).\n * @returns the box shape.\n */\nexport function box(params: BoxParams): Shape {\n  const { width, depth, height } = params\n  // THREE.BoxGeometry(a, b, c) is Y-up (X=a, Y=b, Z=c); after the +90° rotateX\n  // the dims map to X=a, Y=c, Z=b. To reach X=width, Y=depth, Z=height the\n  // pre-rotation sizes must be (width, height, depth) — 裁决 7 xyz contract.\n  const geo = new THREE.BoxGeometry(width, height, depth)\n  geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n  // brepjs box semantics: corner at origin by default; centered at origin when\n  // `centered` (no `at`); `at` (CENTER semantics) takes precedence.\n  const at = params.at\n  let tx = 0\n  let ty = 0\n  let tz = 0\n  if (at !== undefined) {\n    ;[tx, ty, tz] = at\n  } else if (!params.centered) {\n    tx = width / 2\n    ty = depth / 2\n    tz = height / 2\n  }\n  if (tx !== 0 || ty !== 0 || tz !== 0) geo.translate(tx, ty, tz)\n  return geoToShape(geo)\n}\n\n/**\n * Create a sphere centered at the origin (or the optional `center`).\n *\n * @param params - sphere parameters (radius, optional segments, optional center).\n * @returns the sphere shape.\n */\nexport function sphere(params: SphereParams): Shape {\n  const segs = clampNRad(params.nRad ?? params.segments)\n  const geo = makePrimitiveGeo('sphere', params.radius * 2, segs)\n  if (params.center) {\n    geo.translate(params.center[0], params.center[1], params.center[2])\n  }\n  return geoToShape(geo)\n}\n\n/**\n * Create a cylinder along +Z (`cylinder(radius, height, { at?, centered?,\n * segments? })` brepjs 契约，§4.3 A 决策；与 brep 路径逐点对齐）。\n *\n * 锚点：`at` 是**底面轴心**（BASE）语义（默认 [0,0,0]，底面在原点、+Z 延伸）；\n * `centered:true` 指底面落到 −h/2（无 at 时居中到原点）——与 `at` 同给时以\n * `at` 为中心。`segments` 经 clampNRad 消费（P0 §5）。\n *\n * @param params - cylinder parameters (radius, height, optional at/centered/segments).\n * @returns the cylinder shape.\n */\nexport function cylinder(params: CylinderParams): Shape {\n  const segs = clampNRad(params.nRad ?? params.segments)\n  const geo = new THREE.CylinderGeometry(params.radius, params.radius, params.height, segs)\n  geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n  // geometry（rotateX 后）沿 z ∈ [-h/2, +h/2]（three 默认 Y-up 居中）：\n  // 目标底面中心 in baseZ = (at?.[2] ?? 0) - (centered ? h/2 : 0) → 平移到 baseZ + h/2。\n  const baseX = params.at?.[0] ?? 0\n  const baseY = params.at?.[1] ?? 0\n  const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0)\n  geo.translate(baseX, baseY, baseZ + params.height / 2)\n  return geoToShape(geo)\n}\n\n/**\n * Create a cone, or a frustum when the top and bottom radii differ\n * (`cone(bottomRadius, topRadius, height, { at?, centered?, segments? })` brepjs\n * 契约，§4.1 P 决策；与 brep 路径逐点对齐）。\n *\n * 锚点：`at` 是**底面轴心**（BASE）语义（默认 [0,0,0]，底面在原点、+Z 延伸）；\n * `centered:true` 指底面落到 −h/2（无 at 时居中到原点）——与 `at` 同给时以\n * `at` 为中心。`segments` 经 clampNRad 消费（P0 §5）。\n *\n * @param params - cone parameters (radiusBottom, radiusTop, height, optional at/centered/segments).\n * @returns the cone shape.\n */\nexport function cone(params: ConeParams): Shape {\n  const segs = clampNRad(params.nRad ?? params.segments)\n  const geo = new THREE.ConeGeometry(\n    Math.max(params.radiusBottom, params.radiusTop),\n    params.height,\n    segs,\n  )\n  geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n  // radiusTop === 0 → 尖锥（ConeGeometry 顶点在顶）；其余（含 radiusTop ===\n  // radiusBottom 的等径圆柱/圆台）用 CylinderGeometry（radiusTop/bottom 各就各位）。\n  let resultGeo: THREE.BufferGeometry\n  if (params.radiusTop === 0) {\n    resultGeo = geo\n  } else {\n    const geo2 = new THREE.CylinderGeometry(\n      params.radiusTop,\n      params.radiusBottom,\n      params.height,\n      segs,\n    )\n    geo2.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n    resultGeo = geo2\n  }\n  // geometry（rotateX 后）沿 z ∈ [-h/2, +h/2]（three 默认 Y-up 居中）：\n  // 目标底面中心 in baseZ = (at?.[2] ?? 0) - (centered ? h/2 : 0) → 平坦平移 baseZ + h/2。\n  const baseX = params.at?.[0] ?? 0\n  const baseY = params.at?.[1] ?? 0\n  const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0)\n  resultGeo.translate(baseX, baseY, baseZ + params.height / 2)\n  return geoToShape(resultGeo)\n}\n\n/**\n * Create a wedge (ramp) solid, fully parameterized and Z-up.\n *\n * @param params - wedge parameters (width, height, angle, length, optional center).\n * @returns the wedge shape.\n */\nexport function wedge(params: WedgeParams): Shape {\n  const width = params.width\n  const height = params.height\n  const angle = params.angle\n  const length = params.length\n\n  const angleRad = (angle * Math.PI) / 180\n  const halfExtrude = length / 2\n  const hw = width / 2\n  const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad))\n  // 顶边塌缩（斜坡已在宽度内到顶）→ 三角棱柱（与 brep wedge 的退化处理一致，\n  // 保证 mesh/brep 同参数 bbox 一致；零面积三角形会破坏 manifold）。\n  const degenerate = halfTopWidth <= 1e-12\n\n  const positions = degenerate\n    ? new Float32Array([\n        -halfExtrude, -hw, 0,\n        -halfExtrude,  hw, 0,\n        -halfExtrude,   0, height,\n         halfExtrude, -hw, 0,\n         halfExtrude,  hw, 0,\n         halfExtrude,   0, height,\n      ])\n    : new Float32Array([\n        -halfExtrude, -hw, 0,\n        -halfExtrude,  hw, 0,\n        -halfExtrude,  halfTopWidth, height,\n        -halfExtrude, -halfTopWidth, height,\n         halfExtrude, -hw, 0,\n         halfExtrude,  hw, 0,\n         halfExtrude,  halfTopWidth, height,\n         halfExtrude, -halfTopWidth, height,\n      ])\n\n  const indices = degenerate\n    ? new Uint32Array([\n        0, 1, 2,  3, 5, 4,\n        0, 3, 4,  0, 4, 1,\n        0, 2, 5,  0, 5, 3,\n        1, 4, 5,  1, 5, 2,\n      ])\n    : new Uint32Array([\n        0, 1, 2,  0, 2, 3,\n        4, 6, 5,  4, 7, 6,\n        0, 4, 5,  0, 5, 1,\n        3, 2, 6,  3, 6, 7,\n        0, 3, 7,  0, 7, 4,\n        1, 5, 6,  1, 6, 2,\n      ])\n\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3))\n  geo.setIndex(new THREE.BufferAttribute(indices, 1))\n\n  if (params.center) {\n    geo.translate(params.center[0], params.center[1], params.center[2])\n  }\n  return geoToShape(geo)\n}\n\n/**\n * Create text geometry. Font loading is asynchronous, so this function is\n * async; CJK text is rendered with the system font when one is available.\n *\n * @param params - text parameters (text, size, depth).\n * @returns the text shape.\n */\nexport async function text(params: TextParams): Promise<Shape> {\n  const { getOpentypeFont, createTextGeometry } = await import(\n    '../primitives/text-geometry'\n  )\n  const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import(\n    '../primitives/text/cjk'\n  )\n  const font = await getOpentypeFont()\n  let geo: THREE.BufferGeometry\n  if (containsCjk(params.text)) {\n    const cjkFont = await loadSystemCjkFont()\n    if (cjkFont) {\n      geo = await createMixedTextGeometry(params.text, params.size, params.depth, cjkFont.font, font)\n    } else {\n      // No CJK font available: replace CJK chars with '?' so geometry still\n      // can be created (graceful degradation). Without this, createTextGeometry\n      // would throw because CJK glyphs are .notdef in OpenSans Regular.\n      const fallback = params.text.replace(/[\\u4E00-\\u9FFF\\u3400-\\u4DBF\\u2F800-\\u2FA1F\\u3000-\\u303F\\uFF00-\\uFFEF]/g, '?')\n      geo = await createTextGeometry(fallback, params.size, params.depth, font)\n    }\n  } else {\n    geo = await createTextGeometry(params.text, params.size, params.depth, font)\n  }\n  return geoToShape(geo)\n}\n\n/**\n * Create a screw (threaded) geometry.\n *\n * @param params - screw parameters (system, specIdx, thread, length, head, optional pitchCustom and nRad).\n * @returns the screw shape.\n */\nexport async function screw(params: {\n  system: 'metric' | 'imperial'\n  specIdx: number\n  thread: 'coarse' | 'fine' | 'custom' | 'none'\n  pitchCustom?: number\n  length: number\n  head: 'hex' | 'chc' | 'none'\n  nRad?: number\n}): Promise<Shape> {\n  const { makeScrew } = await import('../primitives/screw/screw')\n  const geo = makeScrew({\n    system: params.system,\n    specIdx: params.specIdx,\n    thread: params.thread,\n    pitchCustom: params.pitchCustom ?? 0,\n    length: params.length,\n    head: params.head,\n    nRad: clampNRad(params.nRad),\n  })\n  return geoToShape(geo)\n}\n\n/**\n * Create an extruded geometry from an SVG source.\n *\n * @param params - SVG extrude parameters (svg, depth, target size, optional natural size).\n * @returns the extruded shape.\n */\nexport function svgExtrude(params: SvgExtrudeParams): Shape {\n  const geo = svgToExtrudedGeometry(params.svg, {\n    depth: params.depth,\n    targetLongSide: params.targetLongSide ?? 20,\n    naturalWidth: params.naturalWidth ?? 0,\n    naturalHeight: params.naturalHeight ?? 0,\n  })\n  return geoToShape(geo)\n}\n\n/**\n * Create a mesh from SDF (signed distance field) code, sampling the field with\n * marching cubes.\n *\n * @param params - SDF parameters (code, optional bounds, params, resolution).\n * @returns the sampled shape.\n */\nexport async function sdf(params: SdfParams): Promise<Shape> {\n  const { runSdf } = await import('../sdf/sdf-runner')\n  const box = params.box ?? [[-10, -10, -10], [10, 10, 10]]\n  const bounds: [number, number, number, number, number, number] = [\n    box[0][0], box[0][1], box[0][2],\n    box[1][0], box[1][1], box[1][2],\n  ]\n  const mesh = await runSdf(\n    params.code,\n    params.params ?? {},\n    bounds,\n    params.resolution ?? 1.0,\n  )\n  return { positions: mesh.positions, indices: mesh.indices }\n}\n"]}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/mesh/primitives.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 基本体 API — 从现有纯函数提取的统一接口\n *\n * 提取来源（§5.7）：\n * - box/sphere/cylinder/cone/wedge ← engine/primitives/mesh-primitives.ts (makePrimitiveGeo)\n * - screw ← engine/primitives/screw/screw.ts (makeScrew)\n *\n * `text` / `svgExtrude`（three 的 Shape / ExtrudeGeometry / SVGLoader 链）已随\n * B 组迁到 `@faicad/faijs-extra` 的 `mesh/primitives.ts`，core 的 mesh 面不再\n * 承载 three 的非基础几何生成链。\n *\n * 所有函数返回 Shape (ManifoldMeshData)：THREE.BufferGeometry → geoToManifoldMesh 转换。\n * 坐标系：Z-up、毫米。\n */\n\nimport * as THREE from 'three'\nimport { makePrimitiveGeo } from '../primitives/mesh-primitives'\nimport { geoToManifoldMesh } from '../boolean/csg-backend'\nimport type { Shape, BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams, SdfParams } from './types'\nimport { clampNRad } from './types'\n\n// ── 内部工具 ──\n\n/** THREE.BufferGeometry → Shape (ManifoldMeshData) */\nfunction geoToShape(geo: THREE.BufferGeometry): Shape {\n  return geoToManifoldMesh(geo)\n}\n\n// ── 创建 API ──\n\n/**\n * Create a box solid (brepjs contract, §4.1 A 决策).\n *\n * `box(width, depth, height)` — X=width, Y=depth, Z=height — places the\n * min-corner at the origin by default (`centered:false`). `centered: true`\n * centers the box at the origin; `at` is CENTER semantics and takes precedence\n * over `centered`. The `segments` option is consumed by the tessellation\n * caller (this mesh builder keeps it via clampNRad when present).\n *\n * @param params - box parameters (width/depth/height, optional at/centered/segments).\n * @returns the box shape.\n */\nexport function box(params: BoxParams): Shape {\n  const { width, depth, height } = params\n  // THREE.BoxGeometry(a, b, c) is Y-up (X=a, Y=b, Z=c); after the +90° rotateX\n  // the dims map to X=a, Y=c, Z=b. To reach X=width, Y=depth, Z=height the\n  // pre-rotation sizes must be (width, height, depth) — 裁决 7 xyz contract.\n  const geo = new THREE.BoxGeometry(width, height, depth)\n  geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n  // brepjs box semantics: corner at origin by default; centered at origin when\n  // `centered` (no `at`); `at` (CENTER semantics) takes precedence.\n  const at = params.at\n  let tx = 0\n  let ty = 0\n  let tz = 0\n  if (at !== undefined) {\n    ;[tx, ty, tz] = at\n  } else if (!params.centered) {\n    tx = width / 2\n    ty = depth / 2\n    tz = height / 2\n  }\n  if (tx !== 0 || ty !== 0 || tz !== 0) geo.translate(tx, ty, tz)\n  return geoToShape(geo)\n}\n\n/**\n * Create a sphere centered at the origin (or the optional `center`).\n *\n * @param params - sphere parameters (radius, optional segments, optional center).\n * @returns the sphere shape.\n */\nexport function sphere(params: SphereParams): Shape {\n  const segs = clampNRad(params.nRad ?? params.segments)\n  const geo = makePrimitiveGeo('sphere', params.radius * 2, segs)\n  if (params.center) {\n    geo.translate(params.center[0], params.center[1], params.center[2])\n  }\n  return geoToShape(geo)\n}\n\n/**\n * Create a cylinder along +Z (`cylinder(radius, height, { at?, centered?,\n * segments? })` brepjs 契约，§4.3 A 决策；与 brep 路径逐点对齐）。\n *\n * 锚点：`at` 是**底面轴心**（BASE）语义（默认 [0,0,0]，底面在原点、+Z 延伸）；\n * `centered:true` 指底面落到 −h/2（无 at 时居中到原点）——与 `at` 同给时以\n * `at` 为中心。`segments` 经 clampNRad 消费（P0 §5）。\n *\n * @param params - cylinder parameters (radius, height, optional at/centered/segments).\n * @returns the cylinder shape.\n */\nexport function cylinder(params: CylinderParams): Shape {\n  const segs = clampNRad(params.nRad ?? params.segments)\n  const geo = new THREE.CylinderGeometry(params.radius, params.radius, params.height, segs)\n  geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n  // geometry（rotateX 后）沿 z ∈ [-h/2, +h/2]（three 默认 Y-up 居中）：\n  // 目标底面中心 in baseZ = (at?.[2] ?? 0) - (centered ? h/2 : 0) → 平移到 baseZ + h/2。\n  const baseX = params.at?.[0] ?? 0\n  const baseY = params.at?.[1] ?? 0\n  const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0)\n  geo.translate(baseX, baseY, baseZ + params.height / 2)\n  return geoToShape(geo)\n}\n\n/**\n * Create a cone, or a frustum when the top and bottom radii differ\n * (`cone(bottomRadius, topRadius, height, { at?, centered?, segments? })` brepjs\n * 契约，§4.1 P 决策；与 brep 路径逐点对齐）。\n *\n * 锚点：`at` 是**底面轴心**（BASE）语义（默认 [0,0,0]，底面在原点、+Z 延伸）；\n * `centered:true` 指底面落到 −h/2（无 at 时居中到原点）——与 `at` 同给时以\n * `at` 为中心。`segments` 经 clampNRad 消费（P0 §5）。\n *\n * @param params - cone parameters (radiusBottom, radiusTop, height, optional at/centered/segments).\n * @returns the cone shape.\n */\nexport function cone(params: ConeParams): Shape {\n  const segs = clampNRad(params.nRad ?? params.segments)\n  const geo = new THREE.ConeGeometry(\n    Math.max(params.radiusBottom, params.radiusTop),\n    params.height,\n    segs,\n  )\n  geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n  // radiusTop === 0 → 尖锥（ConeGeometry 顶点在顶）；其余（含 radiusTop ===\n  // radiusBottom 的等径圆柱/圆台）用 CylinderGeometry（radiusTop/bottom 各就各位）。\n  let resultGeo: THREE.BufferGeometry\n  if (params.radiusTop === 0) {\n    resultGeo = geo\n  } else {\n    const geo2 = new THREE.CylinderGeometry(\n      params.radiusTop,\n      params.radiusBottom,\n      params.height,\n      segs,\n    )\n    geo2.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2))\n    resultGeo = geo2\n  }\n  // geometry（rotateX 后）沿 z ∈ [-h/2, +h/2]（three 默认 Y-up 居中）：\n  // 目标底面中心 in baseZ = (at?.[2] ?? 0) - (centered ? h/2 : 0) → 平坦平移 baseZ + h/2。\n  const baseX = params.at?.[0] ?? 0\n  const baseY = params.at?.[1] ?? 0\n  const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0)\n  resultGeo.translate(baseX, baseY, baseZ + params.height / 2)\n  return geoToShape(resultGeo)\n}\n\n/**\n * Create a wedge (ramp) solid, fully parameterized and Z-up.\n *\n * @param params - wedge parameters (width, height, angle, length, optional center).\n * @returns the wedge shape.\n */\nexport function wedge(params: WedgeParams): Shape {\n  const width = params.width\n  const height = params.height\n  const angle = params.angle\n  const length = params.length\n\n  const angleRad = (angle * Math.PI) / 180\n  const halfExtrude = length / 2\n  const hw = width / 2\n  const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad))\n  // 顶边塌缩（斜坡已在宽度内到顶）→ 三角棱柱（与 brep wedge 的退化处理一致，\n  // 保证 mesh/brep 同参数 bbox 一致；零面积三角形会破坏 manifold）。\n  const degenerate = halfTopWidth <= 1e-12\n\n  const positions = degenerate\n    ? new Float32Array([\n        -halfExtrude, -hw, 0,\n        -halfExtrude,  hw, 0,\n        -halfExtrude,   0, height,\n         halfExtrude, -hw, 0,\n         halfExtrude,  hw, 0,\n         halfExtrude,   0, height,\n      ])\n    : new Float32Array([\n        -halfExtrude, -hw, 0,\n        -halfExtrude,  hw, 0,\n        -halfExtrude,  halfTopWidth, height,\n        -halfExtrude, -halfTopWidth, height,\n         halfExtrude, -hw, 0,\n         halfExtrude,  hw, 0,\n         halfExtrude,  halfTopWidth, height,\n         halfExtrude, -halfTopWidth, height,\n      ])\n\n  const indices = degenerate\n    ? new Uint32Array([\n        0, 1, 2,  3, 5, 4,\n        0, 3, 4,  0, 4, 1,\n        0, 2, 5,  0, 5, 3,\n        1, 4, 5,  1, 5, 2,\n      ])\n    : new Uint32Array([\n        0, 1, 2,  0, 2, 3,\n        4, 6, 5,  4, 7, 6,\n        0, 4, 5,  0, 5, 1,\n        3, 2, 6,  3, 6, 7,\n        0, 3, 7,  0, 7, 4,\n        1, 5, 6,  1, 6, 2,\n      ])\n\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3))\n  geo.setIndex(new THREE.BufferAttribute(indices, 1))\n\n  if (params.center) {\n    geo.translate(params.center[0], params.center[1], params.center[2])\n  }\n  return geoToShape(geo)\n}\n\n/**\n * Create a screw (threaded) geometry.\n *\n * @param params - screw parameters (system, specIdx, thread, length, head, optional pitchCustom and nRad).\n * @returns the screw shape.\n */\nexport async function screw(params: {\n  system: 'metric' | 'imperial'\n  specIdx: number\n  thread: 'coarse' | 'fine' | 'custom' | 'none'\n  pitchCustom?: number\n  length: number\n  head: 'hex' | 'chc' | 'none'\n  nRad?: number\n}): Promise<Shape> {\n  const { makeScrew } = await import('../primitives/screw/screw')\n  const geo = makeScrew({\n    system: params.system,\n    specIdx: params.specIdx,\n    thread: params.thread,\n    pitchCustom: params.pitchCustom ?? 0,\n    length: params.length,\n    head: params.head,\n    nRad: clampNRad(params.nRad),\n  })\n  return geoToShape(geo)\n}\n\n/**\n * Create a mesh from SDF (signed distance field) code, sampling the field with\n * marching cubes.\n *\n * @param params - SDF parameters (code, optional bounds, params, resolution).\n * @returns the sampled shape.\n */\nexport async function sdf(params: SdfParams): Promise<Shape> {\n  const { runSdf } = await import('../sdf/sdf-runner')\n  const box = params.box ?? [[-10, -10, -10], [10, 10, 10]]\n  const bounds: [number, number, number, number, number, number] = [\n    box[0][0], box[0][1], box[0][2],\n    box[1][0], box[1][1], box[1][2],\n  ]\n  const mesh = await runSdf(\n    params.code,\n    params.params ?? {},\n    bounds,\n    params.resolution ?? 1.0,\n  )\n  return { positions: mesh.positions, indices: mesh.indices }\n}\n"]}

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

@@ -0,0 +1,23 @@
+/**
+ * stl-loader — minimal STL parser (binary + ASCII), zero addons.
+ *
+ * Why hand-written: three's `STLLoader` lives in `three/examples/jsm/`, which is
+ * outside three's version-compatibility promise and would pull a second,
+ * unpinnable module into every faijs consumer — including the weapp worker,
+ * whose bundle must stay free of the addons. Precedent: `mesh/creased-normals.ts`
+ * ports three's `toCreasedNormals` for exactly this reason.
+ *
+ * Output matches `STLLoader.parse()`: a non-indexed `BufferGeometry` carrying
+ * `position` (one vertex triple per triangle, duplicates preserved) and `normal`
+ * attributes, so callers can keep using `geoToManifoldMesh` for welding.
+ */
+import * as THREE from 'three';
+/**
+ * Parse STL bytes into a non-indexed BufferGeometry.
+ *
+ * @param buffer - the raw STL file bytes (binary or ASCII).
+ * @returns the parsed geometry (empty when the file holds no triangle).
+ * @throws when the buffer is neither a well-formed binary nor ASCII STL.
+ */
+export declare function parseStl(buffer: ArrayBuffer): THREE.BufferGeometry;
+//# sourceMappingURL=stl-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stl-loader.d.ts","sourceRoot":"","sources":["../../src/mesh/stl-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA4H9B;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAAC,cAAc,CAKlE"}

package/dist/mesh/stl-loader.js

@@ -0,0 +1,139 @@
+/**
+ * stl-loader — minimal STL parser (binary + ASCII), zero addons.
+ *
+ * Why hand-written: three's `STLLoader` lives in `three/examples/jsm/`, which is
+ * outside three's version-compatibility promise and would pull a second,
+ * unpinnable module into every faijs consumer — including the weapp worker,
+ * whose bundle must stay free of the addons. Precedent: `mesh/creased-normals.ts`
+ * ports three's `toCreasedNormals` for exactly this reason.
+ *
+ * Output matches `STLLoader.parse()`: a non-indexed `BufferGeometry` carrying
+ * `position` (one vertex triple per triangle, duplicates preserved) and `normal`
+ * attributes, so callers can keep using `geoToManifoldMesh` for welding.
+ */
+import * as THREE from 'three';
+/** Binary STL layout: 80-byte header + uint32 count + 50 bytes per triangle. */
+const BINARY_HEADER_BYTES = 80;
+const BINARY_TRIANGLE_BYTES = 50;
+/**
+ * Decide whether `buffer` is a binary STL by checking the declared triangle
+ * count against the file size (the same test `STLLoader` uses).
+ *
+ * @param buffer - the raw file bytes.
+ * @returns true when the buffer is binary STL.
+ */
+function isBinaryStl(buffer) {
+    if (buffer.byteLength < BINARY_HEADER_BYTES + 4)
+        return false;
+    const view = new DataView(buffer);
+    const triangles = view.getUint32(BINARY_HEADER_BYTES, true);
+    if (triangles === 0)
+        return false;
+    return BINARY_HEADER_BYTES + 4 + triangles * BINARY_TRIANGLE_BYTES === buffer.byteLength;
+}
+/** Normalize a triangle normal, falling back to the geometric one. */
+function normalOf(ax, ay, az, bx, by, bz, cx, cy, cz) {
+    const ux = bx - ax, uy = by - ay, uz = bz - az;
+    const vx = cx - ax, vy = cy - ay, vz = cz - az;
+    const nx = uy * vz - uz * vy;
+    const ny = uz * vx - ux * vz;
+    const nz = ux * vy - uy * vx;
+    const len = Math.hypot(nx, ny, nz);
+    if (len < 1e-20)
+        return [0, 0, 0];
+    return [nx / len, ny / len, nz / len];
+}
+function parseBinary(buffer) {
+    const view = new DataView(buffer);
+    const triangles = view.getUint32(BINARY_HEADER_BYTES, true);
+    const positions = new Float32Array(triangles * 9);
+    const normals = new Float32Array(triangles * 9);
+    let offset = BINARY_HEADER_BYTES + 4;
+    for (let t = 0; t < triangles; t++) {
+        // Stored facet normal — used when it is a usable unit vector.
+        let nx = view.getFloat32(offset, true);
+        let ny = view.getFloat32(offset + 4, true);
+        let nz = view.getFloat32(offset + 8, true);
+        const stored = Math.hypot(nx, ny, nz);
+        offset += 12;
+        const base = t * 9;
+        for (let v = 0; v < 3; v++) {
+            positions[base + v * 3] = view.getFloat32(offset, true);
+            positions[base + v * 3 + 1] = view.getFloat32(offset + 4, true);
+            positions[base + v * 3 + 2] = view.getFloat32(offset + 8, true);
+            offset += 12;
+        }
+        if (stored < 1e-20) {
+            ;
+            [nx, ny, nz] = normalOf(positions[base], positions[base + 1], positions[base + 2], positions[base + 3], positions[base + 4], positions[base + 5], positions[base + 6], positions[base + 7], positions[base + 8]);
+        }
+        else {
+            nx /= stored;
+            ny /= stored;
+            nz /= stored;
+        }
+        for (let v = 0; v < 3; v++) {
+            normals[base + v * 3] = nx;
+            normals[base + v * 3 + 1] = ny;
+            normals[base + v * 3 + 2] = nz;
+        }
+        offset += 2; // attribute byte count
+    }
+    const geo = new THREE.BufferGeometry();
+    geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+    geo.setAttribute('normal', new THREE.BufferAttribute(normals, 3));
+    return geo;
+}
+function parseAscii(buffer) {
+    const text = new TextDecoder().decode(new Uint8Array(buffer));
+    const vertices = [];
+    const normals = [];
+    let facetNormal = null;
+    const pending = [];
+    const flush = () => {
+        if (pending.length !== 9)
+            return;
+        vertices.push(...pending);
+        const n = facetNormal ?? normalOf(pending[0], pending[1], pending[2], pending[3], pending[4], pending[5], pending[6], pending[7], pending[8]);
+        for (let v = 0; v < 3; v++)
+            normals.push(n[0], n[1], n[2]);
+        pending.length = 0;
+    };
+    for (const rawLine of text.split('\n')) {
+        const line = rawLine.trim();
+        if (line.startsWith('facet normal')) {
+            flush();
+            const parts = line.split(/\s+/);
+            facetNormal = [Number(parts[2]), Number(parts[3]), Number(parts[4])];
+            continue;
+        }
+        if (line.startsWith('vertex')) {
+            const parts = line.split(/\s+/);
+            pending.push(Number(parts[1]), Number(parts[2]), Number(parts[3]));
+            continue;
+        }
+        if (line.startsWith('endfacet')) {
+            flush();
+            facetNormal = null;
+        }
+    }
+    flush();
+    const geo = new THREE.BufferGeometry();
+    geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(vertices), 3));
+    geo.setAttribute('normal', new THREE.BufferAttribute(new Float32Array(normals), 3));
+    return geo;
+}
+/**
+ * Parse STL bytes into a non-indexed BufferGeometry.
+ *
+ * @param buffer - the raw STL file bytes (binary or ASCII).
+ * @returns the parsed geometry (empty when the file holds no triangle).
+ * @throws when the buffer is neither a well-formed binary nor ASCII STL.
+ */
+export function parseStl(buffer) {
+    if (buffer.byteLength === 0) {
+        throw new Error('[mesh/stl-loader] empty STL buffer');
+    }
+    return isBinaryStl(buffer) ? parseBinary(buffer) : parseAscii(buffer);
+}
+//# sourceMappingURL=stl-loader.js.map

package/dist/mesh/stl-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stl-loader.js","sourceRoot":"","sources":["../../src/mesh/stl-loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stl-loader — minimal STL parser (binary + ASCII), zero addons.\n *\n * Why hand-written: three's `STLLoader` lives in `three/examples/jsm/`, which is\n * outside three's version-compatibility promise and would pull a second,\n * unpinnable module into every faijs consumer — including the weapp worker,\n * whose bundle must stay free of the addons. Precedent: `mesh/creased-normals.ts`\n * ports three's `toCreasedNormals` for exactly this reason.\n *\n * Output matches `STLLoader.parse()`: a non-indexed `BufferGeometry` carrying\n * `position` (one vertex triple per triangle, duplicates preserved) and `normal`\n * attributes, so callers can keep using `geoToManifoldMesh` for welding.\n */\nimport * as THREE from 'three'\n\n/** Binary STL layout: 80-byte header + uint32 count + 50 bytes per triangle. */\nconst BINARY_HEADER_BYTES = 80\nconst BINARY_TRIANGLE_BYTES = 50\n\n/**\n * Decide whether `buffer` is a binary STL by checking the declared triangle\n * count against the file size (the same test `STLLoader` uses).\n *\n * @param buffer - the raw file bytes.\n * @returns true when the buffer is binary STL.\n */\nfunction isBinaryStl(buffer: ArrayBuffer): boolean {\n  if (buffer.byteLength < BINARY_HEADER_BYTES + 4) return false\n  const view = new DataView(buffer)\n  const triangles = view.getUint32(BINARY_HEADER_BYTES, true)\n  if (triangles === 0) return false\n  return BINARY_HEADER_BYTES + 4 + triangles * BINARY_TRIANGLE_BYTES === buffer.byteLength\n}\n\n/** Normalize a triangle normal, falling back to the geometric one. */\nfunction normalOf(\n  ax: number, ay: number, az: number,\n  bx: number, by: number, bz: number,\n  cx: number, cy: number, cz: number,\n): [number, number, number] {\n  const ux = bx - ax, uy = by - ay, uz = bz - az\n  const vx = cx - ax, vy = cy - ay, vz = cz - az\n  const nx = uy * vz - uz * vy\n  const ny = uz * vx - ux * vz\n  const nz = ux * vy - uy * vx\n  const len = Math.hypot(nx, ny, nz)\n  if (len < 1e-20) return [0, 0, 0]\n  return [nx / len, ny / len, nz / len]\n}\n\nfunction parseBinary(buffer: ArrayBuffer): THREE.BufferGeometry {\n  const view = new DataView(buffer)\n  const triangles = view.getUint32(BINARY_HEADER_BYTES, true)\n  const positions = new Float32Array(triangles * 9)\n  const normals = new Float32Array(triangles * 9)\n  let offset = BINARY_HEADER_BYTES + 4\n  for (let t = 0; t < triangles; t++) {\n    // Stored facet normal — used when it is a usable unit vector.\n    let nx = view.getFloat32(offset, true)\n    let ny = view.getFloat32(offset + 4, true)\n    let nz = view.getFloat32(offset + 8, true)\n    const stored = Math.hypot(nx, ny, nz)\n    offset += 12\n    const base = t * 9\n    for (let v = 0; v < 3; v++) {\n      positions[base + v * 3] = view.getFloat32(offset, true)\n      positions[base + v * 3 + 1] = view.getFloat32(offset + 4, true)\n      positions[base + v * 3 + 2] = view.getFloat32(offset + 8, true)\n      offset += 12\n    }\n    if (stored < 1e-20) {\n      ;[nx, ny, nz] = normalOf(\n        positions[base], positions[base + 1], positions[base + 2],\n        positions[base + 3], positions[base + 4], positions[base + 5],\n        positions[base + 6], positions[base + 7], positions[base + 8],\n      )\n    } else {\n      nx /= stored; ny /= stored; nz /= stored\n    }\n    for (let v = 0; v < 3; v++) {\n      normals[base + v * 3] = nx\n      normals[base + v * 3 + 1] = ny\n      normals[base + v * 3 + 2] = nz\n    }\n    offset += 2 // attribute byte count\n  }\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3))\n  geo.setAttribute('normal', new THREE.BufferAttribute(normals, 3))\n  return geo\n}\n\nfunction parseAscii(buffer: ArrayBuffer): THREE.BufferGeometry {\n  const text = new TextDecoder().decode(new Uint8Array(buffer))\n  const vertices: number[] = []\n  const normals: number[] = []\n  let facetNormal: [number, number, number] | null = null\n  const pending: number[] = []\n\n  const flush = (): void => {\n    if (pending.length !== 9) return\n    vertices.push(...pending)\n    const n = facetNormal ?? normalOf(\n      pending[0], pending[1], pending[2],\n      pending[3], pending[4], pending[5],\n      pending[6], pending[7], pending[8],\n    )\n    for (let v = 0; v < 3; v++) normals.push(n[0], n[1], n[2])\n    pending.length = 0\n  }\n\n  for (const rawLine of text.split('\\n')) {\n    const line = rawLine.trim()\n    if (line.startsWith('facet normal')) {\n      flush()\n      const parts = line.split(/\\s+/)\n      facetNormal = [Number(parts[2]), Number(parts[3]), Number(parts[4])]\n      continue\n    }\n    if (line.startsWith('vertex')) {\n      const parts = line.split(/\\s+/)\n      pending.push(Number(parts[1]), Number(parts[2]), Number(parts[3]))\n      continue\n    }\n    if (line.startsWith('endfacet')) {\n      flush()\n      facetNormal = null\n    }\n  }\n  flush()\n\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(vertices), 3))\n  geo.setAttribute('normal', new THREE.BufferAttribute(new Float32Array(normals), 3))\n  return geo\n}\n\n/**\n * Parse STL bytes into a non-indexed BufferGeometry.\n *\n * @param buffer - the raw STL file bytes (binary or ASCII).\n * @returns the parsed geometry (empty when the file holds no triangle).\n * @throws when the buffer is neither a well-formed binary nor ASCII STL.\n */\nexport function parseStl(buffer: ArrayBuffer): THREE.BufferGeometry {\n  if (buffer.byteLength === 0) {\n    throw new Error('[mesh/stl-loader] empty STL buffer')\n  }\n  return isBinaryStl(buffer) ? parseBinary(buffer) : parseAscii(buffer)\n}\n"]}

package/dist/module-resolver/parse-imports.d.ts

@@ -0,0 +1,37 @@
+/**
+ * parse-imports — 顶层 import 声明定位（span 提取）
+ *
+ * 通用模块解析能力：acorn 解析模块源码，返回每个静态顶层 import 声明在
+ * 源码中的精确 span（specifier 的 start/end 偏移），供调用方做字符串级
+ * 重写（不重建 AST，保持行号/注释/格式）。由 `module-resolver/resolver.ts`
+ * 与其它需要 import 定位的通道复用。
+ *
+ * 只处理顶层静态 import 声明（ESM）；动态 `import()` 是运行时行为，不在
+ * span 提取范围内。
+ */
+/**
+ * The exact location of one static import declaration within module source,
+ * used to rewrite its specifier without rebuilding the AST.
+ */
+export interface ImportSpan {
+    /** import 声明的原始说明符，如 `./partner`、`@faicad/faijs/sdk` */
+    specifier: string;
+    /** 说明符字符串在源码中的起始偏移（不含引号） */
+    start: number;
+    /** 说明符字符串在源码中的结束偏移（不含引号） */
+    end: number;
+    /** 是否裸说明符（既非相对路径也非绝对 URL） */
+    bare: boolean;
+}
+/**
+ * Parse module source (plain JS) and return the specifier and location of
+ * every static top-level import declaration. Dynamic import() is runtime
+ * behavior and is not part of the rewrite scope.
+ *
+ * The input is expected to be plain JS — the caller is responsible for
+ * ensuring the source is de-typed (libraries ship compiled JS at runtime).
+ * @param code - the module JavaScript source text.
+ * @returns an array of import spans covering each static import declaration.
+ */
+export declare function findImports(code: string): ImportSpan[];
+//# sourceMappingURL=parse-imports.d.ts.map

package/dist/module-resolver/parse-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-imports.d.ts","sourceRoot":"","sources":["../../src/module-resolver/parse-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAatD"}

package/dist/module-resolver/parse-imports.js

@@ -0,0 +1,39 @@
+/**
+ * parse-imports — 顶层 import 声明定位（span 提取）
+ *
+ * 通用模块解析能力：acorn 解析模块源码，返回每个静态顶层 import 声明在
+ * 源码中的精确 span（specifier 的 start/end 偏移），供调用方做字符串级
+ * 重写（不重建 AST，保持行号/注释/格式）。由 `module-resolver/resolver.ts`
+ * 与其它需要 import 定位的通道复用。
+ *
+ * 只处理顶层静态 import 声明（ESM）；动态 `import()` 是运行时行为，不在
+ * span 提取范围内。
+ */
+import { parse } from 'acorn';
+/**
+ * Parse module source (plain JS) and return the specifier and location of
+ * every static top-level import declaration. Dynamic import() is runtime
+ * behavior and is not part of the rewrite scope.
+ *
+ * The input is expected to be plain JS — the caller is responsible for
+ * ensuring the source is de-typed (libraries ship compiled JS at runtime).
+ * @param code - the module JavaScript source text.
+ * @returns an array of import spans covering each static import declaration.
+ */
+export function findImports(code) {
+    const ast = parse(code, { ecmaVersion: 'latest', sourceType: 'module' });
+    const spans = [];
+    for (const node of ast.body) {
+        if (node.type !== 'ImportDeclaration')
+            continue;
+        const src = node.source;
+        if (!src || src.start === undefined || src.end === undefined)
+            continue;
+        const spec = src.value;
+        const bare = !spec.startsWith('.') && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(spec);
+        // acorn 的 source.start/end 覆盖含引号的字符串字面量 → 收缩到不含引号的内容
+        spans.push({ specifier: spec, start: src.start + 1, end: src.end - 1, bare });
+    }
+    return spans;
+}
+//# sourceMappingURL=parse-imports.js.map

package/dist/module-resolver/parse-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-imports.js","sourceRoot":"","sources":["../../src/module-resolver/parse-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAiB7B;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;IACxE,MAAM,KAAK,GAAiB,EAAE,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB;YAAE,SAAQ;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAyD,CAAA;QAC1E,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS;YAAE,SAAQ;QACtE,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAA;QACtB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7E,qDAAqD;QACrD,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["/**\n * parse-imports — 顶层 import 声明定位（span 提取）\n *\n * 通用模块解析能力：acorn 解析模块源码，返回每个静态顶层 import 声明在\n * 源码中的精确 span（specifier 的 start/end 偏移），供调用方做字符串级\n * 重写（不重建 AST，保持行号/注释/格式）。由 `module-resolver/resolver.ts`\n * 与其它需要 import 定位的通道复用。\n *\n * 只处理顶层静态 import 声明（ESM）；动态 `import()` 是运行时行为，不在\n * span 提取范围内。\n */\n\nimport { parse } from 'acorn'\n\n/**\n * The exact location of one static import declaration within module source,\n * used to rewrite its specifier without rebuilding the AST.\n */\nexport interface ImportSpan {\n  /** import 声明的原始说明符，如 `./partner`、`@faicad/faijs/sdk` */\n  specifier: string\n  /** 说明符字符串在源码中的起始偏移（不含引号） */\n  start: number\n  /** 说明符字符串在源码中的结束偏移（不含引号） */\n  end: number\n  /** 是否裸说明符（既非相对路径也非绝对 URL） */\n  bare: boolean\n}\n\n/**\n * Parse module source (plain JS) and return the specifier and location of\n * every static top-level import declaration. Dynamic import() is runtime\n * behavior and is not part of the rewrite scope.\n *\n * The input is expected to be plain JS — the caller is responsible for\n * ensuring the source is de-typed (libraries ship compiled JS at runtime).\n * @param code - the module JavaScript source text.\n * @returns an array of import spans covering each static import declaration.\n */\nexport function findImports(code: string): ImportSpan[] {\n  const ast = parse(code, { ecmaVersion: 'latest', sourceType: 'module' })\n  const spans: ImportSpan[] = []\n  for (const node of ast.body) {\n    if (node.type !== 'ImportDeclaration') continue\n    const src = node.source as { value: string; start?: number; end?: number }\n    if (!src || src.start === undefined || src.end === undefined) continue\n    const spec = src.value\n    const bare = !spec.startsWith('.') && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(spec)\n    // acorn 的 source.start/end 覆盖含引号的字符串字面量 → 收缩到不含引号的内容\n    spans.push({ specifier: spec, start: src.start + 1, end: src.end - 1, bare })\n  }\n  return spans\n}\n"]}

package/dist/module-resolver/resolver.d.ts

@@ -2,7 +2,7 @@
  * module-resolver — 运行时模块解析（channel ③，V5.2 / V5.4）
  *
  * 提供纯函数 `resolveImports(code, options)`：
- * - acorn 解析每个顶层 import 声明（复用 faqts imports 的 span 定位）
+ * - acorn 解析每个顶层 import 声明（复用 parse-imports 的 span 定位）
  * - 裸说明符 → 查找解析表（slices / imports / scopes）→ 重写为宿主可加载的绝对 URL
  * - V5.4 大库切片（`pkg/sub`）：仅导出清单中的切片可被引用，未声明 → 抛错
  * - 相对说明符 → 按 importer/baseURL 绝对化

package/dist/module-resolver/resolver.js

@@ -2,7 +2,7 @@
  * module-resolver — 运行时模块解析（channel ③，V5.2 / V5.4）
  *
  * 提供纯函数 `resolveImports(code, options)`：
- * - acorn 解析每个顶层 import 声明（复用 faqts imports 的 span 定位）
+ * - acorn 解析每个顶层 import 声明（复用 parse-imports 的 span 定位）
  * - 裸说明符 → 查找解析表（slices / imports / scopes）→ 重写为宿主可加载的绝对 URL
  * - V5.4 大库切片（`pkg/sub`）：仅导出清单中的切片可被引用，未声明 → 抛错
  * - 相对说明符 → 按 importer/baseURL 绝对化
@@ -12,7 +12,7 @@
  *
  * 本模块不发起网络、不做递归依赖装配（宿主负责拓扑与 fetch/build）。
  */
-import { findImports } from '../faqts/imports.js';
+import { findImports } from './parse-imports.js';
 import { assertSatisfies } from './version.js';
 /**
  * Base error for module-resolution failures.

package/dist/module-resolver/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/module-resolver/resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * module-resolver — 运行时模块解析（channel ③，V5.2 / V5.4）\n *\n * 提供纯函数 `resolveImports(code, options)`：\n * - acorn 解析每个顶层 import 声明（复用 faqts imports 的 span 定位）\n * - 裸说明符 → 查找解析表（slices / imports / scopes）→ 重写为宿主可加载的绝对 URL\n * - V5.4 大库切片（`pkg/sub`）：仅导出清单中的切片可被引用，未声明 → 抛错\n * - 相对说明符 → 按 importer/baseURL 绝对化\n * - `@faicad/faijs` 家族 → 零替换（宿主 importmap 解析，保证单例）\n * - 未登记的裸说明符 → 抛错（roadmap §11 验收：不回退、不静默）\n * - 版本范围 → 校验（roadmap §11 验收：版本不匹配必须抛错）\n *\n * 本模块不发起网络、不做递归依赖装配（宿主负责拓扑与 fetch/build）。\n */\n\nimport { findImports } from '../faqts/imports'\nimport { assertSatisfies } from './version'\n\n/** Resolution value: a direct URL, or an object with URL plus an optional version for range validation. */\nexport type ResolverValue = string | { url: string; version?: string }\n\n/**\n * Options for resolveImports: the resolution table, scopes, slices, and the\n * importer/base context used to absolutize relative specifiers.\n */\nexport interface ResolveImportsOptions {\n  /** 顶层解析表：裸说明符 → URL / {url, version} */\n  imports: Record<string, ResolverValue>\n  /**\n   * V5.2 多版本 scopes：键为导入方模块的 URL 前缀，值为局部解析表。\n   * 解析当前模块时按 importer 前缀匹配**最长** scope，优先于顶层 imports。\n   */\n  scopes?: Record<string, Record<string, ResolverValue>>\n  /**\n   * V5.4 按需加载：大库存量切片声明。\n   *\n   * 键为\"包名\"，值为该库的切片表：只开放被列出的子路径（`pkg/sliceName`）\n   * 给模块图引用；每个切片解析为独立 URL（宿主只 fetch 被引用的切片）。\n   * 引用未声明的 `pkg/x` → 抛 UnresolvedImportError（不回退、不静默，\n   * 与 V5.2 未登记裸说明符的语义一致）。\n   *\n   * `base` 是切片文件所在目录的绝对 URL；`version` 用于切片范围校验。\n   */\n  slices?: Record<string, { base: string; version?: string; exports: Record<string, string> }>\n  /** 当前模块 URL（可选）：用于 relative 绝对化与 scope 匹配 */\n  importer?: string | URL\n  /** base URL（可选）；缺省时相对 `importer` 的目录 */\n  baseURL?: string | URL\n  /** 保留前缀，默认 `@faicad/faijs` 家族零替换 */\n  reservedPrefixes?: string[]\n}\n\n/**\n * Result of resolveImports: the rewritten module source plus the mapping of\n * every rewritten import specifier to its absolute URL.\n */\nexport interface ResolveResult {\n  /** 重写后的模块源码 */\n  code: string\n  /** 每个被重写的 import 的映射：原 specifier → 绝对 URL */\n  resolved: Record<string, string>\n}\n\n/**\n * Base error for module-resolution failures.\n */\nexport class ModuleResolverError extends Error {}\n\n/**\n * Thrown for a bare specifier that is not registered in the resolution table\n * (roadmap acceptance: never fall back, never stay silent).\n */\nexport class UnresolvedImportError extends ModuleResolverError {\n  /** The unresolvable bare module specifier. */\n  readonly specifier: string\n  constructor(specifier: string, importerHint?: string) {\n    super(\n      `[module-resolver] unresolvable bare module specifier \"${specifier}\"` +\n        (importerHint ? ` (imported by ${importerHint})` : '') +\n        ' — not registered in the resolution table',\n    )\n    this.name = 'UnresolvedImportError'\n    this.specifier = specifier\n  }\n}\n\n/**\n * Thrown when an import's version range is not satisfied (roadmap\n * acceptance: a version mismatch must throw).\n */\nexport class ImportVersionError extends ModuleResolverError {\n  /** The specifier whose version range was not satisfied. */\n  readonly specifier: string\n  constructor(specifier: string, version: string, range: string) {\n    super(\n      `[module-resolver] import \"${specifier}\" requires range \"${range}\" ` +\n        `but registry entry resolves to version \"${version}\"`,\n    )\n    this.name = 'ImportVersionError'\n    this.specifier = specifier\n  }\n}\n\nconst DEFAULT_RESERVED = ['@faicad/faijs', '@faicad/faq', '@faicad/faq/sdk', '@fc/fq/']\n\nfunction isReserved(spec: string, prefixes: string[]): boolean {\n  return prefixes.some((p) => spec === p || spec.startsWith(p + '/'))\n}\n\nfunction asString(u: string | URL): string {\n  return typeof u === 'string' ? u : u.href\n}\n\nfunction resolverBase(opts: ResolveImportsOptions): string | undefined {\n  if (opts.baseURL) return asString(opts.baseURL)\n  if (opts.importer) {\n    const imp = asString(opts.importer)\n    try {\n      return new URL('.', imp).href\n    } catch {\n      return imp\n    }\n  }\n  return undefined\n}\n\n/**\n * Split a bare specifier that may embed a version range:\n * `mech@^1.2` / `@scope/gear@~2.0`.\n * @param spec - the bare module specifier, possibly with an embedded range.\n * @returns the package name and the optional version range.\n */\nexport function splitVersionRange(spec: string): { name: string; range?: string } {\n  const at = spec.startsWith('@') ? spec.indexOf('@', 1) : spec.indexOf('@')\n  if (at === -1 || at === spec.length - 1) return { name: spec }\n  return { name: spec.slice(0, at), range: spec.slice(at + 1) }\n}\n\n/** 选最长匹配的 scope 表（V5.2 多版本）。 */\nfunction pickScope(opts: ResolveImportsOptions): Record<string, ResolverValue> | undefined {\n  if (!opts.scopes || !opts.importer) return undefined\n  const imp = asString(opts.importer)\n  let best: Record<string, ResolverValue> | undefined\n  let bestLen = -1\n  for (const [prefix, table] of Object.entries(opts.scopes)) {\n    if (imp.startsWith(prefix) && prefix.length > bestLen) {\n      best = table\n      bestLen = prefix.length\n    }\n  }\n  return best\n}\n\n/**\n * V5.4 按需加载：大库切片声明解析。\n *\n * 大库（如标准件库）的公开导入面只有 `pkg` 前缀；子路径必须显式声明为切片。\n * 只 fetch 被引用的切片（宿主按需加载），未声明的 `pkg/x` → 抛错（不静默）。\n * 与内置 op 的静态判定一致——不做运行时回退，只做解析期静态判定。\n */\nfunction resolveSlice(\n  name: string,\n  range: string | undefined,\n  options: ResolveImportsOptions,\n): string | undefined {\n  const slices = options.slices\n  if (!slices) return undefined\n  // 子路径形如 `pkg/sub`；选最长匹配的库前缀（与 scopes 同法）\n  let bestPkg: string | undefined\n  let bestLen = -1\n  for (const pkg of Object.keys(slices)) {\n    const prefix = pkg + '/'\n    if (name.startsWith(prefix) && prefix.length > bestLen) {\n      bestPkg = pkg\n      bestLen = prefix.length\n    }\n  }\n  if (bestPkg === undefined) return undefined\n\n  const entry = slices[bestPkg]\n  const sub = name.slice(bestLen)\n  const file = entry.exports[sub]\n  if (file === undefined) {\n    throw new ModuleResolverError(\n      `[module-resolver] slice \"${name}\" is not an exported slice of library \"${bestPkg}\" ` +\n        '(V5.4 按需加载：仅导出清单中的切片可被引用，不回退、不静默)',\n    )\n  }\n  if (range !== undefined) {\n    // 与顶层 imports 同语义：范围校验失败抛 ImportVersionError\n    try {\n      assertSatisfies(entry.version ?? '(unknown)', range, name)\n    } catch {\n      throw new ImportVersionError(name, entry.version ?? '(unknown)', range)\n    }\n  }\n  return new URL(file, entry.base).href\n}\n\n/** 表内精确查找，或子路径键（`gear/` → `gear/sub`）。 */\nfunction lookupValue(\n  pkgName: string,\n  table: Record<string, ResolverValue> | undefined,\n): ResolverValue | undefined {\n  if (!table) return undefined\n  if (Object.prototype.hasOwnProperty.call(table, pkgName)) return table[pkgName]\n  for (const k of Object.keys(table)) {\n    if (k.endsWith('/') && pkgName.startsWith(k)) return table[k]\n  }\n  return undefined\n}\n\nfunction resolveEntry(\n  value: ResolverValue,\n  specifier: string,\n  range: string | undefined,\n): string {\n  const url = typeof value === 'string' ? value : value.url\n  if (range !== undefined) {\n    const version = typeof value === 'string' ? undefined : value.version\n    if (version !== undefined) {\n      try {\n        assertSatisfies(version, range, specifier)\n      } catch {\n        throw new ImportVersionError(specifier, version, range)\n      }\n    } else {\n      throw new ImportVersionError(specifier, '(unknown)', range)\n    }\n  }\n  return url\n}\n\n/**\n * Pure function: resolve and rewrite the import specifiers in module code.\n *\n * Priority order:\n * 1. Reserved prefixes (@faicad/faijs family) → untouched (host importmap)\n * 2. Library slices (`pkg/sub` in `slices`) → slice URL (V5.4 on-demand)\n * 3. Scope tables (longest-prefix match) override top-level imports\n * 4. Relative specifiers with a base → absolutized; otherwise kept as-is\n * 5. Top-level table entry → absolute URL (with version-range validation)\n * 6. Unregistered bare specifiers → UnresolvedImportError\n * @param code - the module source code to rewrite.\n * @param options - resolution tables, scopes, slices and importer/base context.\n * @returns the rewritten code and the specifier→URL mapping.\n */\nexport function resolveImports(code: string, options: ResolveImportsOptions): ResolveResult {\n  const spans = findImports(code)\n  const reserved = options.reservedPrefixes === undefined ? DEFAULT_RESERVED : options.reservedPrefixes\n  const scopeTable = pickScope(options)\n  const base = resolverBase(options)\n  let out = code\n  const resolved: Record<string, string> = {}\n\n  // 从后往前，保证 span 位置在之前替换后不漂移\n  for (let i = spans.length - 1; i >= 0; i--) {\n    const span = spans[i]\n    const spec = span.specifier\n\n    // 保留前缀：零替换\n    if (span.bare && isReserved(spec, reserved)) continue\n\n    if (span.bare) {\n      const { name, range } = splitVersionRange(spec)\n      // V5.4 按需加载：大库切片（`pkg/sub`）优先于顶层 imports 命中\n      const sliceUrl = resolveSlice(name, range, options)\n      if (sliceUrl !== undefined) {\n        out = out.slice(0, span.start) + sliceUrl + out.slice(span.end)\n        resolved[spec] = sliceUrl\n        continue\n      }\n      const value = lookupValue(name, scopeTable) ?? lookupValue(name, options.imports)\n      if (value === undefined) {\n        throw new UnresolvedImportError(spec, options.importer !== undefined ? asString(options.importer) : undefined)\n      }\n      const url = resolveEntry(value, spec, range)\n      out = out.slice(0, span.start) + url + out.slice(span.end)\n      resolved[spec] = url\n    } else if (spec.startsWith('.') && base !== undefined) {\n      const url = new URL(spec, base).href\n      if (url !== spec) {\n        out = out.slice(0, span.start) + url + out.slice(span.end)\n        resolved[spec] = url\n      }\n    }\n    // 其余（绝对 URL）原样保留\n  }\n\n  return { code: out, resolved }\n}"]}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/module-resolver/resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * module-resolver — 运行时模块解析（channel ③，V5.2 / V5.4）\n *\n * 提供纯函数 `resolveImports(code, options)`：\n * - acorn 解析每个顶层 import 声明（复用 parse-imports 的 span 定位）\n * - 裸说明符 → 查找解析表（slices / imports / scopes）→ 重写为宿主可加载的绝对 URL\n * - V5.4 大库切片（`pkg/sub`）：仅导出清单中的切片可被引用，未声明 → 抛错\n * - 相对说明符 → 按 importer/baseURL 绝对化\n * - `@faicad/faijs` 家族 → 零替换（宿主 importmap 解析，保证单例）\n * - 未登记的裸说明符 → 抛错（roadmap §11 验收：不回退、不静默）\n * - 版本范围 → 校验（roadmap §11 验收：版本不匹配必须抛错）\n *\n * 本模块不发起网络、不做递归依赖装配（宿主负责拓扑与 fetch/build）。\n */\n\nimport { findImports } from './parse-imports'\nimport { assertSatisfies } from './version'\n\n/** Resolution value: a direct URL, or an object with URL plus an optional version for range validation. */\nexport type ResolverValue = string | { url: string; version?: string }\n\n/**\n * Options for resolveImports: the resolution table, scopes, slices, and the\n * importer/base context used to absolutize relative specifiers.\n */\nexport interface ResolveImportsOptions {\n  /** 顶层解析表：裸说明符 → URL / {url, version} */\n  imports: Record<string, ResolverValue>\n  /**\n   * V5.2 多版本 scopes：键为导入方模块的 URL 前缀，值为局部解析表。\n   * 解析当前模块时按 importer 前缀匹配**最长** scope，优先于顶层 imports。\n   */\n  scopes?: Record<string, Record<string, ResolverValue>>\n  /**\n   * V5.4 按需加载：大库存量切片声明。\n   *\n   * 键为\"包名\"，值为该库的切片表：只开放被列出的子路径（`pkg/sliceName`）\n   * 给模块图引用；每个切片解析为独立 URL（宿主只 fetch 被引用的切片）。\n   * 引用未声明的 `pkg/x` → 抛 UnresolvedImportError（不回退、不静默，\n   * 与 V5.2 未登记裸说明符的语义一致）。\n   *\n   * `base` 是切片文件所在目录的绝对 URL；`version` 用于切片范围校验。\n   */\n  slices?: Record<string, { base: string; version?: string; exports: Record<string, string> }>\n  /** 当前模块 URL（可选）：用于 relative 绝对化与 scope 匹配 */\n  importer?: string | URL\n  /** base URL（可选）；缺省时相对 `importer` 的目录 */\n  baseURL?: string | URL\n  /** 保留前缀，默认 `@faicad/faijs` 家族零替换 */\n  reservedPrefixes?: string[]\n}\n\n/**\n * Result of resolveImports: the rewritten module source plus the mapping of\n * every rewritten import specifier to its absolute URL.\n */\nexport interface ResolveResult {\n  /** 重写后的模块源码 */\n  code: string\n  /** 每个被重写的 import 的映射：原 specifier → 绝对 URL */\n  resolved: Record<string, string>\n}\n\n/**\n * Base error for module-resolution failures.\n */\nexport class ModuleResolverError extends Error {}\n\n/**\n * Thrown for a bare specifier that is not registered in the resolution table\n * (roadmap acceptance: never fall back, never stay silent).\n */\nexport class UnresolvedImportError extends ModuleResolverError {\n  /** The unresolvable bare module specifier. */\n  readonly specifier: string\n  constructor(specifier: string, importerHint?: string) {\n    super(\n      `[module-resolver] unresolvable bare module specifier \"${specifier}\"` +\n        (importerHint ? ` (imported by ${importerHint})` : '') +\n        ' — not registered in the resolution table',\n    )\n    this.name = 'UnresolvedImportError'\n    this.specifier = specifier\n  }\n}\n\n/**\n * Thrown when an import's version range is not satisfied (roadmap\n * acceptance: a version mismatch must throw).\n */\nexport class ImportVersionError extends ModuleResolverError {\n  /** The specifier whose version range was not satisfied. */\n  readonly specifier: string\n  constructor(specifier: string, version: string, range: string) {\n    super(\n      `[module-resolver] import \"${specifier}\" requires range \"${range}\" ` +\n        `but registry entry resolves to version \"${version}\"`,\n    )\n    this.name = 'ImportVersionError'\n    this.specifier = specifier\n  }\n}\n\nconst DEFAULT_RESERVED = ['@faicad/faijs', '@faicad/faq', '@faicad/faq/sdk', '@fc/fq/']\n\nfunction isReserved(spec: string, prefixes: string[]): boolean {\n  return prefixes.some((p) => spec === p || spec.startsWith(p + '/'))\n}\n\nfunction asString(u: string | URL): string {\n  return typeof u === 'string' ? u : u.href\n}\n\nfunction resolverBase(opts: ResolveImportsOptions): string | undefined {\n  if (opts.baseURL) return asString(opts.baseURL)\n  if (opts.importer) {\n    const imp = asString(opts.importer)\n    try {\n      return new URL('.', imp).href\n    } catch {\n      return imp\n    }\n  }\n  return undefined\n}\n\n/**\n * Split a bare specifier that may embed a version range:\n * `mech@^1.2` / `@scope/gear@~2.0`.\n * @param spec - the bare module specifier, possibly with an embedded range.\n * @returns the package name and the optional version range.\n */\nexport function splitVersionRange(spec: string): { name: string; range?: string } {\n  const at = spec.startsWith('@') ? spec.indexOf('@', 1) : spec.indexOf('@')\n  if (at === -1 || at === spec.length - 1) return { name: spec }\n  return { name: spec.slice(0, at), range: spec.slice(at + 1) }\n}\n\n/** 选最长匹配的 scope 表（V5.2 多版本）。 */\nfunction pickScope(opts: ResolveImportsOptions): Record<string, ResolverValue> | undefined {\n  if (!opts.scopes || !opts.importer) return undefined\n  const imp = asString(opts.importer)\n  let best: Record<string, ResolverValue> | undefined\n  let bestLen = -1\n  for (const [prefix, table] of Object.entries(opts.scopes)) {\n    if (imp.startsWith(prefix) && prefix.length > bestLen) {\n      best = table\n      bestLen = prefix.length\n    }\n  }\n  return best\n}\n\n/**\n * V5.4 按需加载：大库切片声明解析。\n *\n * 大库（如标准件库）的公开导入面只有 `pkg` 前缀；子路径必须显式声明为切片。\n * 只 fetch 被引用的切片（宿主按需加载），未声明的 `pkg/x` → 抛错（不静默）。\n * 与内置 op 的静态判定一致——不做运行时回退，只做解析期静态判定。\n */\nfunction resolveSlice(\n  name: string,\n  range: string | undefined,\n  options: ResolveImportsOptions,\n): string | undefined {\n  const slices = options.slices\n  if (!slices) return undefined\n  // 子路径形如 `pkg/sub`；选最长匹配的库前缀（与 scopes 同法）\n  let bestPkg: string | undefined\n  let bestLen = -1\n  for (const pkg of Object.keys(slices)) {\n    const prefix = pkg + '/'\n    if (name.startsWith(prefix) && prefix.length > bestLen) {\n      bestPkg = pkg\n      bestLen = prefix.length\n    }\n  }\n  if (bestPkg === undefined) return undefined\n\n  const entry = slices[bestPkg]\n  const sub = name.slice(bestLen)\n  const file = entry.exports[sub]\n  if (file === undefined) {\n    throw new ModuleResolverError(\n      `[module-resolver] slice \"${name}\" is not an exported slice of library \"${bestPkg}\" ` +\n        '(V5.4 按需加载：仅导出清单中的切片可被引用，不回退、不静默)',\n    )\n  }\n  if (range !== undefined) {\n    // 与顶层 imports 同语义：范围校验失败抛 ImportVersionError\n    try {\n      assertSatisfies(entry.version ?? '(unknown)', range, name)\n    } catch {\n      throw new ImportVersionError(name, entry.version ?? '(unknown)', range)\n    }\n  }\n  return new URL(file, entry.base).href\n}\n\n/** 表内精确查找，或子路径键（`gear/` → `gear/sub`）。 */\nfunction lookupValue(\n  pkgName: string,\n  table: Record<string, ResolverValue> | undefined,\n): ResolverValue | undefined {\n  if (!table) return undefined\n  if (Object.prototype.hasOwnProperty.call(table, pkgName)) return table[pkgName]\n  for (const k of Object.keys(table)) {\n    if (k.endsWith('/') && pkgName.startsWith(k)) return table[k]\n  }\n  return undefined\n}\n\nfunction resolveEntry(\n  value: ResolverValue,\n  specifier: string,\n  range: string | undefined,\n): string {\n  const url = typeof value === 'string' ? value : value.url\n  if (range !== undefined) {\n    const version = typeof value === 'string' ? undefined : value.version\n    if (version !== undefined) {\n      try {\n        assertSatisfies(version, range, specifier)\n      } catch {\n        throw new ImportVersionError(specifier, version, range)\n      }\n    } else {\n      throw new ImportVersionError(specifier, '(unknown)', range)\n    }\n  }\n  return url\n}\n\n/**\n * Pure function: resolve and rewrite the import specifiers in module code.\n *\n * Priority order:\n * 1. Reserved prefixes (@faicad/faijs family) → untouched (host importmap)\n * 2. Library slices (`pkg/sub` in `slices`) → slice URL (V5.4 on-demand)\n * 3. Scope tables (longest-prefix match) override top-level imports\n * 4. Relative specifiers with a base → absolutized; otherwise kept as-is\n * 5. Top-level table entry → absolute URL (with version-range validation)\n * 6. Unregistered bare specifiers → UnresolvedImportError\n * @param code - the module source code to rewrite.\n * @param options - resolution tables, scopes, slices and importer/base context.\n * @returns the rewritten code and the specifier→URL mapping.\n */\nexport function resolveImports(code: string, options: ResolveImportsOptions): ResolveResult {\n  const spans = findImports(code)\n  const reserved = options.reservedPrefixes === undefined ? DEFAULT_RESERVED : options.reservedPrefixes\n  const scopeTable = pickScope(options)\n  const base = resolverBase(options)\n  let out = code\n  const resolved: Record<string, string> = {}\n\n  // 从后往前，保证 span 位置在之前替换后不漂移\n  for (let i = spans.length - 1; i >= 0; i--) {\n    const span = spans[i]\n    const spec = span.specifier\n\n    // 保留前缀：零替换\n    if (span.bare && isReserved(spec, reserved)) continue\n\n    if (span.bare) {\n      const { name, range } = splitVersionRange(spec)\n      // V5.4 按需加载：大库切片（`pkg/sub`）优先于顶层 imports 命中\n      const sliceUrl = resolveSlice(name, range, options)\n      if (sliceUrl !== undefined) {\n        out = out.slice(0, span.start) + sliceUrl + out.slice(span.end)\n        resolved[spec] = sliceUrl\n        continue\n      }\n      const value = lookupValue(name, scopeTable) ?? lookupValue(name, options.imports)\n      if (value === undefined) {\n        throw new UnresolvedImportError(spec, options.importer !== undefined ? asString(options.importer) : undefined)\n      }\n      const url = resolveEntry(value, spec, range)\n      out = out.slice(0, span.start) + url + out.slice(span.end)\n      resolved[spec] = url\n    } else if (spec.startsWith('.') && base !== undefined) {\n      const url = new URL(spec, base).href\n      if (url !== spec) {\n        out = out.slice(0, span.start) + url + out.slice(span.end)\n        resolved[spec] = url\n      }\n    }\n    // 其余（绝对 URL）原样保留\n  }\n\n  return { code: out, resolved }\n}"]}

package/dist/node-host/cli.d.ts.map

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

package/dist/node-host/cli.js

@@ -17,9 +17,9 @@
  *                                       — (view) 单视图方向（默认 front）
  *   --sheet <front,top,right,iso>       — (view) 多视图图纸（projectSheet；与 --view 互斥）
  */
-import { readFileSync, writeFileSync } from 'node:fs';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { resolve, extname } from 'node:path';
+import { resolve, extname, dirname, join } from 'node:path';
 import { createRuntime } from '../cad-runtime/runtime.js';
 import { createNodePorts } from './index.js';
 import { createFsProjectLoader, findProjectRoot, projectKeyOf } from './fs-project-loader.js';
@@ -34,13 +34,12 @@ import { projectView, projectSheet } from '../api/view/index.js';
 // ── P 四（4.4）：Node CLI 自动装载（D3-Node，§9.4）──
 // 脚本 import 的第三方库按 specifier 动态解析，host 不再写死任何包清单：
 // - scoped 包名（`@faicad/...`）直接动态 import；
-// - 短名（如 `gear-lib-demo`）先归一为 scoped 全名再装载（避免误装同名陌生人包）。
+// - 短名（如 `sheetmetal`）先归一为 scoped 全名再装载（避免误装同名陌生人包）。
 // 包未安装 → 动态 import 抛 ERR_MODULE_NOT_FOUND，由 runtime 报明确装载失败信息。
 /** scoped 包名前缀：CLI 允许动态装载的库范围。 */
 const CLI_SCOPED_PREFIX = '@faicad/';
 /** 已登记短名 → scoped 全名归一表（仅收录 `@faicad/` 范围内的库，防同名陌生人包）。 */
 const CLI_SHORT_NAMES = {
-    'gear-lib-demo': '@faicad/gear-lib-demo',
     'sheetmetal': '@faicad/sheetmetal',
     'cq-compat': '@faicad/cq-compat',
     'fai-cq-gears': '@faicad/fai-cq-gears',
@@ -78,6 +77,24 @@ const cliPortsLibLoader = {
         return (await import(pkg));
     },
     listLibs: () => [...Object.keys(CLI_SHORT_NAMES), '@faicad/'],
+    loadSource: async (name) => {
+        const pkg = normalizeCliSpecifier(name);
+        if (!pkg.startsWith(CLI_SCOPED_PREFIX))
+            return undefined;
+        try {
+            const req = createRequire(import.meta.url);
+            const pkgJsonPath = req.resolve(`${pkg}/package.json`);
+            const pkgDir = dirname(pkgJsonPath);
+            for (const p of [join(pkgDir, 'src', 'index.ts'), join(pkgDir, 'dist', 'index.js'), join(pkgDir, 'src', 'index.js')]) {
+                if (existsSync(p))
+                    return readFileSync(p, 'utf-8');
+            }
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+    },
     // 默认不提升（与历史 CLI 行为一致）；各库用 package.json "faijs.autoLift" 逐库覆盖。
     options: {
         autoLift: false,
@@ -174,6 +191,22 @@ export async function cliRun(filePath, outPath, opts) {
     // Determine output format from extension
     const ext = extname(outPath).toLowerCase().slice(1);
     const terminals = execResult.terminals ?? [];
+    // E1 (H12): export-side failures must surface as a structured result, not an
+    // exception — the census and batch driver treat a throw as a process crash,
+    // while `{ ok: false, error }` keeps it a per-file, classifiable failure.
+    try {
+        return await exportExecutionResult(outPath, ext, execResult, terminals);
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: `Export failed: ${String(e?.message ?? e)}`,
+            infos: execResult.infos,
+        };
+    }
+}
+/** Export an executed result to `outPath` (shared body of cliRun's export path). */
+async function exportExecutionResult(outPath, ext, execResult, terminals) {
     if (terminals.length === 0) {
         // No terminals — use last output
         const outputNames = [...execResult.outputs.keys()];