@faicad/faijs 0.30.9 → 0.32.2

package/dist/mesh/meshdata/ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.js","sourceRoot":"","sources":["../../../src/mesh/meshdata/ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAmB,MAAM,cAAc,CAAA;AAEpD,OAAO,EAAE,QAAQ,EAAiB,MAAM,QAAQ,CAAA;AAIhD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,SAA4B,EAC5B,OAA0B,EAC1B,KAAsB;IAEtB,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACzC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAA;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAC7B,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACxB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;QACzB,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACjC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACnC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACnD,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAA;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,CAAa;IACxD,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACpD,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAA;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACzE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACjB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACZ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAChB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,CAAS,EAAE,CAAS,EAAE,CAAC,GAAG,CAAC;IACtE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAA;IACtD,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACX,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;QACf,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;AACrC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAC7B,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAClD,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IACrB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IACrB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IACrB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IACrB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACxB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QAC5B,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACxD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACxD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACxD,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACrB,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACrB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACZ,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAClB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACtB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACtB,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAClB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACtB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACtB,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAClB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACtB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACxB,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAA;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAA;QAC7D,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAChB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACpB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACnB,OAAO,EAAE,SAAS,EAAE,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAA;IAC1F,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAA;QAC5B,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IAC5B,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,EAAE,GAAG,CAAC,CAAA;IACV,IAAI,EAAE,GAAG,CAAC,CAAA;IACV,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAC9B,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAA;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAA;QACxF,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;QACtB,YAAY,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AAC/B,CAAC","sourcesContent":["/**\r\n * meshdata/ops — 作用在 Shape / 原始数组上的纯函数几何操作（L1 容器操作）。\r\n *\r\n * 替代 three `BufferGeometry` 的少量方法面（`toNonIndexed`、`computeVertexNormals`、\r\n * `applyMatrix4`/`translate`、`clone`、merge）——**纯函数集，不给对外 `Shape` 挂方法**\r\n * （与设计 §3.3 一致）。不重复 `mesh/query.ts` 已有的 `boundingBox`/`volume` 等查询。\r\n */\r\n\r\nimport { Vec3, type MatrixLike } from '../../math3d'\r\nimport type { Shape } from '../types'\r\nimport { weldMesh, type MeshData } from './weld'\r\n\r\nexport type { MatrixLike }\r\n\r\n/**\r\n * Weld raw positions+indices into a mesh Shape (same behaviour as the old\r\n * `geoToManifoldMesh` on a position-only geometry).\r\n * @param positions - flat position array (x, y, z, ...).\r\n * @param indices - triangle index array into `positions`.\r\n * @param extra - optional extra Shape fields to attach (e.g. `faceRanges`).\r\n * @returns the welded Shape.\r\n */\r\nexport function shapeFromMesh(\r\n  positions: ArrayLike<number>,\r\n  indices: ArrayLike<number>,\r\n  extra?: Partial<Shape>,\r\n): Shape {\r\n  const mesh = weldMesh(positions, indices)\r\n  return { positions: mesh.positions, indices: mesh.indices, ...extra }\r\n}\r\n\r\n/**\r\n * Expand an indexed Shape to non-indexed (each triangle gets its own vertices),\r\n * mirroring three `BufferGeometry.toNonIndexed`.\r\n * @param shape - the indexed shape.\r\n * @returns a non-indexed copy of the shape.\r\n */\r\nexport function toNonIndexed(shape: Shape): MeshData {\r\n  const positions = shape.positions\r\n  const indices = shape.indices\r\n  const out = new Float32Array(indices.length * 3)\r\n  for (let i = 0; i < indices.length; i++) {\r\n    const v = indices[i] * 3\r\n    out[i * 3] = positions[v]\r\n    out[i * 3 + 1] = positions[v + 1]\r\n    out[i * 3 + 2] = positions[v + 2]\r\n  }\r\n  const seq = new Uint32Array(indices.length)\r\n  for (let i = 0; i < indices.length; i++) seq[i] = i\r\n  return { positions: out, indices: seq }\r\n}\r\n\r\n/**\r\n * Apply a 4x4 matrix to a Shape's vertices (bakes the transform).\r\n * @param shape - the source shape.\r\n * @param m - column-major 4x4 matrix.\r\n * @returns a new shape with transformed vertices (indices/other fields preserved).\r\n */\r\nexport function transformShape(shape: Shape, m: MatrixLike): Shape {\r\n  const out = new Float32Array(shape.positions.length)\r\n  const v = new Vec3()\r\n  for (let i = 0; i < shape.positions.length; i += 3) {\r\n    v.set(shape.positions[i], shape.positions[i + 1], shape.positions[i + 2])\r\n    v.applyMatrix4(m)\r\n    out[i] = v.x\r\n    out[i + 1] = v.y\r\n    out[i + 2] = v.z\r\n  }\r\n  return { ...shape, positions: out }\r\n}\r\n\r\n/**\r\n * Translate a Shape's vertices by (x, y, z).\r\n * @param shape - the source shape.\r\n * @param x - X offset.\r\n * @param y - Y offset.\r\n * @param z - Z offset.\r\n * @returns a new shape with translated vertices.\r\n */\r\nexport function translateShape(shape: Shape, x: number, y: number, z = 0): Shape {\r\n  if (x === 0 && y === 0 && z === 0) return { ...shape }\r\n  const out = new Float32Array(shape.positions)\r\n  for (let i = 0; i < out.length; i += 3) {\r\n    out[i] += x\r\n    out[i + 1] += y\r\n    out[i + 2] += z\r\n  }\r\n  return { ...shape, positions: out }\r\n}\r\n\r\n/**\r\n * Compute per-vertex normals with three `BufferGeometry.computeVertexNormals`\r\n * semantics (face normals averaged across shared vertices).\r\n *\r\n * **折边红线提醒**：在索引（共享顶点）几何上这会把棱边\"磨圆\"——core 的派生法线\r\n * 一律走 `boolean/creased-normals.ts`（`deriveNormals`）。本函数只为替换 three 的\r\n * **罕见**直调用点而保留，返回纯数据，不改变 Shape。\r\n * @param shape - the source shape.\r\n * @returns a Float32Array of per-vertex normals.\r\n */\r\nexport function computeVertexNormals(shape: Shape): Float32Array {\r\n  const positions = shape.positions\r\n  const indices = shape.indices\r\n  const normals = new Float32Array(positions.length)\r\n  const pA = new Vec3()\r\n  const pB = new Vec3()\r\n  const pC = new Vec3()\r\n  const cb = new Vec3()\r\n  const ab = new Vec3()\r\n\r\n  for (let i = 0; i < indices.length; i += 3) {\r\n    const a = indices[i] * 3\r\n    const b = indices[i + 1] * 3\r\n    const c = indices[i + 2] * 3\r\n    pA.set(positions[a], positions[a + 1], positions[a + 2])\r\n    pB.set(positions[b], positions[b + 1], positions[b + 2])\r\n    pC.set(positions[c], positions[c + 1], positions[c + 2])\r\n    cb.subVectors(pC, pB)\r\n    ab.subVectors(pA, pB)\r\n    cb.cross(ab)\r\n    normals[a] += cb.x\r\n    normals[a + 1] += cb.y\r\n    normals[a + 2] += cb.z\r\n    normals[b] += cb.x\r\n    normals[b + 1] += cb.y\r\n    normals[b + 2] += cb.z\r\n    normals[c] += cb.x\r\n    normals[c + 1] += cb.y\r\n    normals[c + 2] += cb.z\r\n  }\r\n\r\n  const v = new Vec3()\r\n  for (let i = 0; i < normals.length; i += 3) {\r\n    v.set(normals[i], normals[i + 1], normals[i + 2]).normalize()\r\n    normals[i] = v.x\r\n    normals[i + 1] = v.y\r\n    normals[i + 2] = v.z\r\n  }\r\n  return normals\r\n}\r\n\r\n/**\r\n * Merge several Shapes into one indexed Shape (position + index concatenation,\r\n * mirroring the old `mergeBufferGeometries`).\r\n * @param shapes - the shapes to merge.\r\n * @returns the merged Shape.\r\n */\r\nexport function mergeShapes(shapes: Shape[]): Shape {\r\n  if (shapes.length === 1) {\r\n    const s = shapes[0]\r\n    return { positions: new Float32Array(s.positions), indices: new Uint32Array(s.indices) }\r\n  }\r\n  let posLen = 0\r\n  let idxLen = 0\r\n  for (const s of shapes) {\r\n    posLen += s.positions.length\r\n    idxLen += s.indices.length\r\n  }\r\n  const positions = new Float32Array(posLen)\r\n  const indices = new Uint32Array(idxLen)\r\n  let po = 0\r\n  let io = 0\r\n  let vertexOffset = 0\r\n  for (const s of shapes) {\r\n    positions.set(s.positions, po)\r\n    po += s.positions.length\r\n    for (let i = 0; i < s.indices.length; i++) indices[io + i] = s.indices[i] + vertexOffset\r\n    io += s.indices.length\r\n    vertexOffset += s.positions.length / 3\r\n  }\r\n  return { positions, indices }\r\n}"]}

package/dist/mesh/meshdata/parametric.d.ts

@@ -0,0 +1,70 @@
+/**
+ * meshdata/parametric — three.js r162 参数化几何的最小复刻（box / cylinder /
+ * cone / sphere），去掉 normal / uv，只产出 position + index。
+ *
+ * Ported from three.js r162 `src/geometries/{Box,Cylinder,Cone,Sphere}Geometry.js`
+ * (MIT License, © 2010-2024 three.js authors). **顶点与索引的生成顺序逐行照抄**
+ * ——`mesh/primitives.ts` 的 `faceRanges` 面序契约正建立在该顺序之上（例如 Box
+ * 12 三角形 = 6 面 × 2，顺序固定 +X/−X/+Y/−Y/+Z/−Z；Cylinder 侧面→顶盖→底盖）。
+ * 改动这里的循环顺序 = 改变面序契约，属破坏性改动。
+ *
+ * 本模块零依赖（除 `MeshData` 类型），是「去 three」后 core 自有的参数化几何来源。
+ */
+import type { MeshData } from './weld.js';
+/** Raw geometry output: interleaved positions + triangle indices. */
+export interface GeoData {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * Box geometry (three `BoxGeometry`, default 1 segment per side).
+ * @param width - size along X.
+ * @param height - size along Y.
+ * @param depth - size along Z.
+ * @param widthSegments - segments along X.
+ * @param heightSegments - segments along Y.
+ * @param depthSegments - segments along Z.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export declare function boxGeometry(width?: number, height?: number, depth?: number, widthSegments?: number, heightSegments?: number, depthSegments?: number): GeoData;
+/**
+ * Cylinder / frustum geometry (three `CylinderGeometry`: torso then top cap then
+ * bottom cap).
+ * @param radiusTop - top radius.
+ * @param radiusBottom - bottom radius.
+ * @param height - height along Y (three is Y-up; callers rotate to Z-up).
+ * @param radialSegments - radial segment count.
+ * @param heightSegments - axial segment count.
+ * @param openEnded - skip caps when true.
+ * @param thetaStart - start angle.
+ * @param thetaLength - swept angle.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export declare function cylinderGeometry(radiusTop?: number, radiusBottom?: number, height?: number, radialSegments?: number, heightSegments?: number, openEnded?: boolean, thetaStart?: number, thetaLength?: number): GeoData;
+/**
+ * Cone geometry (three `ConeGeometry` = `CylinderGeometry(0, radius, ...)`).
+ * @param radius - base radius.
+ * @param height - height along Y.
+ * @param radialSegments - radial segment count.
+ * @param heightSegments - axial segment count.
+ * @param openEnded - skip the base cap when true.
+ * @param thetaStart - start angle.
+ * @param thetaLength - swept angle.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export declare function coneGeometry(radius?: number, height?: number, radialSegments?: number, heightSegments?: number, openEnded?: boolean, thetaStart?: number, thetaLength?: number): GeoData;
+/**
+ * Sphere geometry (three `SphereGeometry`).
+ * @param radius - sphere radius.
+ * @param widthSegments - longitude segment count.
+ * @param heightSegments - latitude segment count.
+ * @param phiStart - start longitude.
+ * @param phiLength - swept longitude.
+ * @param thetaStart - start latitude.
+ * @param thetaLength - swept latitude.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export declare function sphereGeometry(radius?: number, widthSegments?: number, heightSegments?: number, phiStart?: number, phiLength?: number, thetaStart?: number, thetaLength?: number): GeoData;
+/** Re-export the raw mesh container type for callers. */
+export type { MeshData };
+//# sourceMappingURL=parametric.d.ts.map

package/dist/mesh/meshdata/parametric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parametric.d.ts","sourceRoot":"","sources":["../../../src/mesh/meshdata/parametric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEtC,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB;AAID;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,SAAI,EACT,MAAM,SAAI,EACV,KAAK,SAAI,EACT,aAAa,SAAI,EACjB,cAAc,SAAI,EAClB,aAAa,SAAI,GAChB,OAAO,CA2DT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,SAAI,EACb,YAAY,SAAI,EAChB,MAAM,SAAI,EACV,cAAc,SAAK,EACnB,cAAc,SAAI,EAClB,SAAS,UAAQ,EACjB,UAAU,SAAI,EACd,WAAW,SAAc,GACxB,OAAO,CAwET;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,SAAI,EACV,MAAM,SAAI,EACV,cAAc,SAAK,EACnB,cAAc,SAAI,EAClB,SAAS,UAAQ,EACjB,UAAU,SAAI,EACd,WAAW,SAAc,GACxB,OAAO,CAET;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,SAAI,EACV,aAAa,SAAK,EAClB,cAAc,SAAK,EACnB,QAAQ,SAAI,EACZ,SAAS,SAAc,EACvB,UAAU,SAAI,EACd,WAAW,SAAU,GACpB,OAAO,CAoCT;AAED,yDAAyD;AACzD,YAAY,EAAE,QAAQ,EAAE,CAAA"}

package/dist/mesh/meshdata/parametric.js

@@ -0,0 +1,213 @@
+/**
+ * meshdata/parametric — three.js r162 参数化几何的最小复刻（box / cylinder /
+ * cone / sphere），去掉 normal / uv，只产出 position + index。
+ *
+ * Ported from three.js r162 `src/geometries/{Box,Cylinder,Cone,Sphere}Geometry.js`
+ * (MIT License, © 2010-2024 three.js authors). **顶点与索引的生成顺序逐行照抄**
+ * ——`mesh/primitives.ts` 的 `faceRanges` 面序契约正建立在该顺序之上（例如 Box
+ * 12 三角形 = 6 面 × 2，顺序固定 +X/−X/+Y/−Y/+Z/−Z；Cylinder 侧面→顶盖→底盖）。
+ * 改动这里的循环顺序 = 改变面序契约，属破坏性改动。
+ *
+ * 本模块零依赖（除 `MeshData` 类型），是「去 three」后 core 自有的参数化几何来源。
+ */
+/**
+ * Box geometry (three `BoxGeometry`, default 1 segment per side).
+ * @param width - size along X.
+ * @param height - size along Y.
+ * @param depth - size along Z.
+ * @param widthSegments - segments along X.
+ * @param heightSegments - segments along Y.
+ * @param depthSegments - segments along Z.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export function boxGeometry(width = 1, height = 1, depth = 1, widthSegments = 1, heightSegments = 1, depthSegments = 1) {
+    const indices = [];
+    const vertices = [];
+    let numberOfVertices = 0;
+    const gx = Math.floor(widthSegments);
+    const gy = Math.floor(heightSegments);
+    const gz = Math.floor(depthSegments);
+    const vector = { x: 0, y: 0, z: 0 };
+    function buildPlane(u, v, w, udir, vdir, planeWidth, planeHeight, planeDepth, gridX, gridY) {
+        const segmentWidth = planeWidth / gridX;
+        const segmentHeight = planeHeight / gridY;
+        const widthHalf = planeWidth / 2;
+        const heightHalf = planeHeight / 2;
+        const depthHalf = planeDepth / 2;
+        const gridX1 = gridX + 1;
+        const gridY1 = gridY + 1;
+        let vertexCounter = 0;
+        for (let iy = 0; iy < gridY1; iy++) {
+            const y = iy * segmentHeight - heightHalf;
+            for (let ix = 0; ix < gridX1; ix++) {
+                const x = ix * segmentWidth - widthHalf;
+                vector[u] = x * udir;
+                vector[v] = y * vdir;
+                vector[w] = depthHalf;
+                vertices.push(vector.x, vector.y, vector.z);
+                vertexCounter += 1;
+            }
+        }
+        for (let iy = 0; iy < gridY; iy++) {
+            for (let ix = 0; ix < gridX; ix++) {
+                const a = numberOfVertices + ix + gridX1 * iy;
+                const b = numberOfVertices + ix + gridX1 * (iy + 1);
+                const c = numberOfVertices + (ix + 1) + gridX1 * (iy + 1);
+                const d = numberOfVertices + (ix + 1) + gridX1 * iy;
+                indices.push(a, b, d);
+                indices.push(b, c, d);
+            }
+        }
+        numberOfVertices += vertexCounter;
+    }
+    buildPlane('z', 'y', 'x', -1, -1, depth, height, width, gz, gy); // px
+    buildPlane('z', 'y', 'x', 1, -1, depth, height, -width, gz, gy); // nx
+    buildPlane('x', 'z', 'y', 1, 1, width, depth, height, gx, gz); // py
+    buildPlane('x', 'z', 'y', 1, -1, width, depth, -height, gx, gz); // ny
+    buildPlane('x', 'y', 'z', 1, -1, width, height, depth, gx, gy); // pz
+    buildPlane('x', 'y', 'z', -1, -1, width, height, -depth, gx, gy); // nz
+    return { positions: new Float32Array(vertices), indices: new Uint32Array(indices) };
+}
+/**
+ * Cylinder / frustum geometry (three `CylinderGeometry`: torso then top cap then
+ * bottom cap).
+ * @param radiusTop - top radius.
+ * @param radiusBottom - bottom radius.
+ * @param height - height along Y (three is Y-up; callers rotate to Z-up).
+ * @param radialSegments - radial segment count.
+ * @param heightSegments - axial segment count.
+ * @param openEnded - skip caps when true.
+ * @param thetaStart - start angle.
+ * @param thetaLength - swept angle.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export function cylinderGeometry(radiusTop = 1, radiusBottom = 1, height = 1, radialSegments = 32, heightSegments = 1, openEnded = false, thetaStart = 0, thetaLength = Math.PI * 2) {
+    const indices = [];
+    const vertices = [];
+    let index = 0;
+    const halfHeight = height / 2;
+    const rSeg = Math.floor(radialSegments);
+    const hSeg = Math.floor(heightSegments);
+    const indexArray = [];
+    // torso
+    {
+        for (let y = 0; y <= hSeg; y++) {
+            const indexRow = [];
+            const v = y / hSeg;
+            const radius = v * (radiusBottom - radiusTop) + radiusTop;
+            for (let x = 0; x <= rSeg; x++) {
+                const u = x / rSeg;
+                const theta = u * thetaLength + thetaStart;
+                const sinTheta = Math.sin(theta);
+                const cosTheta = Math.cos(theta);
+                vertices.push(radius * sinTheta, -v * height + halfHeight, radius * cosTheta);
+                indexRow.push(index++);
+            }
+            indexArray.push(indexRow);
+        }
+        for (let x = 0; x < rSeg; x++) {
+            for (let y = 0; y < hSeg; y++) {
+                const a = indexArray[y][x];
+                const b = indexArray[y + 1][x];
+                const c = indexArray[y + 1][x + 1];
+                const d = indexArray[y][x + 1];
+                indices.push(a, b, d);
+                indices.push(b, c, d);
+            }
+        }
+    }
+    const generateCap = (top) => {
+        const centerIndexStart = index;
+        const radius = top ? radiusTop : radiusBottom;
+        const sign = top ? 1 : -1;
+        for (let x = 1; x <= rSeg; x++) {
+            vertices.push(0, halfHeight * sign, 0);
+            index++;
+        }
+        const centerIndexEnd = index;
+        for (let x = 0; x <= rSeg; x++) {
+            const u = x / rSeg;
+            const theta = u * thetaLength + thetaStart;
+            const cosTheta = Math.cos(theta);
+            const sinTheta = Math.sin(theta);
+            vertices.push(radius * sinTheta, halfHeight * sign, radius * cosTheta);
+            index++;
+        }
+        for (let x = 0; x < rSeg; x++) {
+            const c = centerIndexStart + x;
+            const i = centerIndexEnd + x;
+            if (top)
+                indices.push(i, i + 1, c);
+            else
+                indices.push(i + 1, i, c);
+        }
+    };
+    if (!openEnded) {
+        if (radiusTop > 0)
+            generateCap(true);
+        if (radiusBottom > 0)
+            generateCap(false);
+    }
+    return { positions: new Float32Array(vertices), indices: new Uint32Array(indices) };
+}
+/**
+ * Cone geometry (three `ConeGeometry` = `CylinderGeometry(0, radius, ...)`).
+ * @param radius - base radius.
+ * @param height - height along Y.
+ * @param radialSegments - radial segment count.
+ * @param heightSegments - axial segment count.
+ * @param openEnded - skip the base cap when true.
+ * @param thetaStart - start angle.
+ * @param thetaLength - swept angle.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export function coneGeometry(radius = 1, height = 1, radialSegments = 32, heightSegments = 1, openEnded = false, thetaStart = 0, thetaLength = Math.PI * 2) {
+    return cylinderGeometry(0, radius, height, radialSegments, heightSegments, openEnded, thetaStart, thetaLength);
+}
+/**
+ * Sphere geometry (three `SphereGeometry`).
+ * @param radius - sphere radius.
+ * @param widthSegments - longitude segment count.
+ * @param heightSegments - latitude segment count.
+ * @param phiStart - start longitude.
+ * @param phiLength - swept longitude.
+ * @param thetaStart - start latitude.
+ * @param thetaLength - swept latitude.
+ * @returns positions + indices in three's vertex/index order.
+ */
+export function sphereGeometry(radius = 1, widthSegments = 32, heightSegments = 16, phiStart = 0, phiLength = Math.PI * 2, thetaStart = 0, thetaLength = Math.PI) {
+    const wSeg = Math.max(3, Math.floor(widthSegments));
+    const hSeg = Math.max(2, Math.floor(heightSegments));
+    const thetaEnd = Math.min(thetaStart + thetaLength, Math.PI);
+    let index = 0;
+    const grid = [];
+    const indices = [];
+    const vertices = [];
+    for (let iy = 0; iy <= hSeg; iy++) {
+        const verticesRow = [];
+        const v = iy / hSeg;
+        for (let ix = 0; ix <= wSeg; ix++) {
+            const u = ix / wSeg;
+            const x = -radius * Math.cos(phiStart + u * phiLength) * Math.sin(thetaStart + v * thetaLength);
+            const y = radius * Math.cos(thetaStart + v * thetaLength);
+            const z = radius * Math.sin(phiStart + u * phiLength) * Math.sin(thetaStart + v * thetaLength);
+            vertices.push(x, y, z);
+            verticesRow.push(index++);
+        }
+        grid.push(verticesRow);
+    }
+    for (let iy = 0; iy < hSeg; iy++) {
+        for (let ix = 0; ix < wSeg; ix++) {
+            const a = grid[iy][ix + 1];
+            const b = grid[iy][ix];
+            const c = grid[iy + 1][ix];
+            const d = grid[iy + 1][ix + 1];
+            if (iy !== 0 || thetaStart > 0)
+                indices.push(a, b, d);
+            if (iy !== hSeg - 1 || thetaEnd < Math.PI)
+                indices.push(b, c, d);
+        }
+    }
+    return { positions: new Float32Array(vertices), indices: new Uint32Array(indices) };
+}
+//# sourceMappingURL=parametric.js.map

package/dist/mesh/meshdata/parametric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parametric.js","sourceRoot":"","sources":["../../../src/mesh/meshdata/parametric.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * meshdata/parametric — three.js r162 参数化几何的最小复刻（box / cylinder /\r\n * cone / sphere），去掉 normal / uv，只产出 position + index。\r\n *\r\n * Ported from three.js r162 `src/geometries/{Box,Cylinder,Cone,Sphere}Geometry.js`\r\n * (MIT License, © 2010-2024 three.js authors). **顶点与索引的生成顺序逐行照抄**\r\n * ——`mesh/primitives.ts` 的 `faceRanges` 面序契约正建立在该顺序之上（例如 Box\r\n * 12 三角形 = 6 面 × 2，顺序固定 +X/−X/+Y/−Y/+Z/−Z；Cylinder 侧面→顶盖→底盖）。\r\n * 改动这里的循环顺序 = 改变面序契约，属破坏性改动。\r\n *\r\n * 本模块零依赖（除 `MeshData` 类型），是「去 three」后 core 自有的参数化几何来源。\r\n */\r\n\r\nimport type { MeshData } from './weld'\r\n\r\n/** Raw geometry output: interleaved positions + triangle indices. */\r\nexport interface GeoData {\r\n  positions: Float32Array\r\n  indices: Uint32Array\r\n}\r\n\r\ntype Axis = 'x' | 'y' | 'z'\r\n\r\n/**\r\n * Box geometry (three `BoxGeometry`, default 1 segment per side).\r\n * @param width - size along X.\r\n * @param height - size along Y.\r\n * @param depth - size along Z.\r\n * @param widthSegments - segments along X.\r\n * @param heightSegments - segments along Y.\r\n * @param depthSegments - segments along Z.\r\n * @returns positions + indices in three's vertex/index order.\r\n */\r\nexport function boxGeometry(\r\n  width = 1,\r\n  height = 1,\r\n  depth = 1,\r\n  widthSegments = 1,\r\n  heightSegments = 1,\r\n  depthSegments = 1,\r\n): GeoData {\r\n  const indices: number[] = []\r\n  const vertices: number[] = []\r\n  let numberOfVertices = 0\r\n\r\n  const gx = Math.floor(widthSegments)\r\n  const gy = Math.floor(heightSegments)\r\n  const gz = Math.floor(depthSegments)\r\n  const vector: Record<Axis, number> = { x: 0, y: 0, z: 0 }\r\n\r\n  function buildPlane(\r\n    u: Axis, v: Axis, w: Axis,\r\n    udir: number, vdir: number,\r\n    planeWidth: number, planeHeight: number, planeDepth: number,\r\n    gridX: number, gridY: number,\r\n  ): void {\r\n    const segmentWidth = planeWidth / gridX\r\n    const segmentHeight = planeHeight / gridY\r\n    const widthHalf = planeWidth / 2\r\n    const heightHalf = planeHeight / 2\r\n    const depthHalf = planeDepth / 2\r\n    const gridX1 = gridX + 1\r\n    const gridY1 = gridY + 1\r\n    let vertexCounter = 0\r\n\r\n    for (let iy = 0; iy < gridY1; iy++) {\r\n      const y = iy * segmentHeight - heightHalf\r\n      for (let ix = 0; ix < gridX1; ix++) {\r\n        const x = ix * segmentWidth - widthHalf\r\n        vector[u] = x * udir\r\n        vector[v] = y * vdir\r\n        vector[w] = depthHalf\r\n        vertices.push(vector.x, vector.y, vector.z)\r\n        vertexCounter += 1\r\n      }\r\n    }\r\n\r\n    for (let iy = 0; iy < gridY; iy++) {\r\n      for (let ix = 0; ix < gridX; ix++) {\r\n        const a = numberOfVertices + ix + gridX1 * iy\r\n        const b = numberOfVertices + ix + gridX1 * (iy + 1)\r\n        const c = numberOfVertices + (ix + 1) + gridX1 * (iy + 1)\r\n        const d = numberOfVertices + (ix + 1) + gridX1 * iy\r\n        indices.push(a, b, d)\r\n        indices.push(b, c, d)\r\n      }\r\n    }\r\n\r\n    numberOfVertices += vertexCounter\r\n  }\r\n\r\n  buildPlane('z', 'y', 'x', -1, -1, depth, height, width, gz, gy) // px\r\n  buildPlane('z', 'y', 'x', 1, -1, depth, height, -width, gz, gy) // nx\r\n  buildPlane('x', 'z', 'y', 1, 1, width, depth, height, gx, gz) // py\r\n  buildPlane('x', 'z', 'y', 1, -1, width, depth, -height, gx, gz) // ny\r\n  buildPlane('x', 'y', 'z', 1, -1, width, height, depth, gx, gy) // pz\r\n  buildPlane('x', 'y', 'z', -1, -1, width, height, -depth, gx, gy) // nz\r\n\r\n  return { positions: new Float32Array(vertices), indices: new Uint32Array(indices) }\r\n}\r\n\r\n/**\r\n * Cylinder / frustum geometry (three `CylinderGeometry`: torso then top cap then\r\n * bottom cap).\r\n * @param radiusTop - top radius.\r\n * @param radiusBottom - bottom radius.\r\n * @param height - height along Y (three is Y-up; callers rotate to Z-up).\r\n * @param radialSegments - radial segment count.\r\n * @param heightSegments - axial segment count.\r\n * @param openEnded - skip caps when true.\r\n * @param thetaStart - start angle.\r\n * @param thetaLength - swept angle.\r\n * @returns positions + indices in three's vertex/index order.\r\n */\r\nexport function cylinderGeometry(\r\n  radiusTop = 1,\r\n  radiusBottom = 1,\r\n  height = 1,\r\n  radialSegments = 32,\r\n  heightSegments = 1,\r\n  openEnded = false,\r\n  thetaStart = 0,\r\n  thetaLength = Math.PI * 2,\r\n): GeoData {\r\n  const indices: number[] = []\r\n  const vertices: number[] = []\r\n  let index = 0\r\n  const halfHeight = height / 2\r\n\r\n  const rSeg = Math.floor(radialSegments)\r\n  const hSeg = Math.floor(heightSegments)\r\n\r\n  const indexArray: number[][] = []\r\n\r\n  // torso\r\n  {\r\n\r\n    for (let y = 0; y <= hSeg; y++) {\r\n      const indexRow: number[] = []\r\n      const v = y / hSeg\r\n      const radius = v * (radiusBottom - radiusTop) + radiusTop\r\n      for (let x = 0; x <= rSeg; x++) {\r\n        const u = x / rSeg\r\n        const theta = u * thetaLength + thetaStart\r\n        const sinTheta = Math.sin(theta)\r\n        const cosTheta = Math.cos(theta)\r\n        vertices.push(radius * sinTheta, -v * height + halfHeight, radius * cosTheta)\r\n        indexRow.push(index++)\r\n      }\r\n      indexArray.push(indexRow)\r\n    }\r\n    for (let x = 0; x < rSeg; x++) {\r\n      for (let y = 0; y < hSeg; y++) {\r\n        const a = indexArray[y][x]\r\n        const b = indexArray[y + 1][x]\r\n        const c = indexArray[y + 1][x + 1]\r\n        const d = indexArray[y][x + 1]\r\n        indices.push(a, b, d)\r\n        indices.push(b, c, d)\r\n      }\r\n    }\r\n\r\n  }\r\n\r\n  const generateCap = (top: boolean): void => {\r\n    const centerIndexStart = index\r\n    const radius = top ? radiusTop : radiusBottom\r\n    const sign = top ? 1 : -1\r\n    for (let x = 1; x <= rSeg; x++) {\r\n      vertices.push(0, halfHeight * sign, 0)\r\n      index++\r\n    }\r\n    const centerIndexEnd = index\r\n    for (let x = 0; x <= rSeg; x++) {\r\n      const u = x / rSeg\r\n      const theta = u * thetaLength + thetaStart\r\n      const cosTheta = Math.cos(theta)\r\n      const sinTheta = Math.sin(theta)\r\n      vertices.push(radius * sinTheta, halfHeight * sign, radius * cosTheta)\r\n      index++\r\n    }\r\n    for (let x = 0; x < rSeg; x++) {\r\n      const c = centerIndexStart + x\r\n      const i = centerIndexEnd + x\r\n      if (top) indices.push(i, i + 1, c)\r\n      else indices.push(i + 1, i, c)\r\n    }\r\n  }\r\n\r\n  if (!openEnded) {\r\n    if (radiusTop > 0) generateCap(true)\r\n    if (radiusBottom > 0) generateCap(false)\r\n  }\r\n\r\n  return { positions: new Float32Array(vertices), indices: new Uint32Array(indices) }\r\n}\r\n\r\n/**\r\n * Cone geometry (three `ConeGeometry` = `CylinderGeometry(0, radius, ...)`).\r\n * @param radius - base radius.\r\n * @param height - height along Y.\r\n * @param radialSegments - radial segment count.\r\n * @param heightSegments - axial segment count.\r\n * @param openEnded - skip the base cap when true.\r\n * @param thetaStart - start angle.\r\n * @param thetaLength - swept angle.\r\n * @returns positions + indices in three's vertex/index order.\r\n */\r\nexport function coneGeometry(\r\n  radius = 1,\r\n  height = 1,\r\n  radialSegments = 32,\r\n  heightSegments = 1,\r\n  openEnded = false,\r\n  thetaStart = 0,\r\n  thetaLength = Math.PI * 2,\r\n): GeoData {\r\n  return cylinderGeometry(0, radius, height, radialSegments, heightSegments, openEnded, thetaStart, thetaLength)\r\n}\r\n\r\n/**\r\n * Sphere geometry (three `SphereGeometry`).\r\n * @param radius - sphere radius.\r\n * @param widthSegments - longitude segment count.\r\n * @param heightSegments - latitude segment count.\r\n * @param phiStart - start longitude.\r\n * @param phiLength - swept longitude.\r\n * @param thetaStart - start latitude.\r\n * @param thetaLength - swept latitude.\r\n * @returns positions + indices in three's vertex/index order.\r\n */\r\nexport function sphereGeometry(\r\n  radius = 1,\r\n  widthSegments = 32,\r\n  heightSegments = 16,\r\n  phiStart = 0,\r\n  phiLength = Math.PI * 2,\r\n  thetaStart = 0,\r\n  thetaLength = Math.PI,\r\n): GeoData {\r\n  const wSeg = Math.max(3, Math.floor(widthSegments))\r\n  const hSeg = Math.max(2, Math.floor(heightSegments))\r\n  const thetaEnd = Math.min(thetaStart + thetaLength, Math.PI)\r\n\r\n  let index = 0\r\n  const grid: number[][] = []\r\n  const indices: number[] = []\r\n  const vertices: number[] = []\r\n\r\n  for (let iy = 0; iy <= hSeg; iy++) {\r\n    const verticesRow: number[] = []\r\n    const v = iy / hSeg\r\n    for (let ix = 0; ix <= wSeg; ix++) {\r\n      const u = ix / wSeg\r\n      const x = -radius * Math.cos(phiStart + u * phiLength) * Math.sin(thetaStart + v * thetaLength)\r\n      const y = radius * Math.cos(thetaStart + v * thetaLength)\r\n      const z = radius * Math.sin(phiStart + u * phiLength) * Math.sin(thetaStart + v * thetaLength)\r\n      vertices.push(x, y, z)\r\n      verticesRow.push(index++)\r\n    }\r\n    grid.push(verticesRow)\r\n  }\r\n\r\n  for (let iy = 0; iy < hSeg; iy++) {\r\n    for (let ix = 0; ix < wSeg; ix++) {\r\n      const a = grid[iy][ix + 1]\r\n      const b = grid[iy][ix]\r\n      const c = grid[iy + 1][ix]\r\n      const d = grid[iy + 1][ix + 1]\r\n      if (iy !== 0 || thetaStart > 0) indices.push(a, b, d)\r\n      if (iy !== hSeg - 1 || thetaEnd < Math.PI) indices.push(b, c, d)\r\n    }\r\n  }\r\n\r\n  return { positions: new Float32Array(vertices), indices: new Uint32Array(indices) }\r\n}\r\n\r\n/** Re-export the raw mesh container type for callers. */\r\nexport type { MeshData }"]}

package/dist/mesh/meshdata/weld.d.ts

@@ -0,0 +1,21 @@
+/**
+ * meshdata/weld — 顶点焊接（从 `boolean/geo-convert.ts` 迁出的共享实现）。
+ *
+ * 按 1e-6 量化位置把重复顶点焊成唯一顶点，并把索引用焊接后的编号重写。
+ * 这是 mesh 面从「未焊接的生成几何」到「Shape」的统一收口，`geo-convert` 与
+ * `meshdata` 共用同一实现（一个事实一个家，避免两份焊接逻辑漂移）。
+ */
+/** Interleaved positions + triangle indices (the raw mesh container). */
+export interface MeshData {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * Weld duplicate vertices by 1e-6-quantised position.
+ * @param positions - flat position array (x, y, z, ...).
+ * @param indices - triangle index array into `positions`.
+ * @param count - number of indices to consume (defaults to the whole array).
+ * @returns welded positions and rewritten indices.
+ */
+export declare function weldMesh(positions: ArrayLike<number>, indices: ArrayLike<number>, count?: number): MeshData;
+//# sourceMappingURL=weld.d.ts.map

package/dist/mesh/meshdata/weld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weld.d.ts","sourceRoot":"","sources":["../../../src/mesh/meshdata/weld.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAC5B,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,EAC1B,KAAK,GAAE,MAAuB,GAC7B,QAAQ,CAqCV"}

package/dist/mesh/meshdata/weld.js

@@ -0,0 +1,50 @@
+/**
+ * meshdata/weld — 顶点焊接（从 `boolean/geo-convert.ts` 迁出的共享实现）。
+ *
+ * 按 1e-6 量化位置把重复顶点焊成唯一顶点，并把索引用焊接后的编号重写。
+ * 这是 mesh 面从「未焊接的生成几何」到「Shape」的统一收口，`geo-convert` 与
+ * `meshdata` 共用同一实现（一个事实一个家，避免两份焊接逻辑漂移）。
+ */
+/**
+ * Weld duplicate vertices by 1e-6-quantised position.
+ * @param positions - flat position array (x, y, z, ...).
+ * @param indices - triangle index array into `positions`.
+ * @param count - number of indices to consume (defaults to the whole array).
+ * @returns welded positions and rewritten indices.
+ */
+export function weldMesh(positions, indices, count = indices.length) {
+    const mapX = new Map();
+    const weldedPosArr = [];
+    const weldedIdxArr = [];
+    for (let i = 0; i < count; i++) {
+        const vi = indices[i];
+        const x = positions[vi * 3];
+        const y = positions[vi * 3 + 1];
+        const z = positions[vi * 3 + 2];
+        const qx = Math.round(x * 1e6);
+        const qy = Math.round(y * 1e6);
+        const qz = Math.round(z * 1e6);
+        let mapY = mapX.get(qx);
+        if (mapY === undefined) {
+            mapY = new Map();
+            mapX.set(qx, mapY);
+        }
+        let mapZ = mapY.get(qy);
+        if (mapZ === undefined) {
+            mapZ = new Map();
+            mapY.set(qy, mapZ);
+        }
+        let ni = mapZ.get(qz);
+        if (ni === undefined) {
+            ni = weldedPosArr.length / 3;
+            mapZ.set(qz, ni);
+            weldedPosArr.push(x, y, z);
+        }
+        weldedIdxArr.push(ni);
+    }
+    return {
+        positions: new Float32Array(weldedPosArr),
+        indices: new Uint32Array(weldedIdxArr),
+    };
+}
+//# sourceMappingURL=weld.js.map

package/dist/mesh/meshdata/weld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weld.js","sourceRoot":"","sources":["../../../src/mesh/meshdata/weld.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,SAA4B,EAC5B,OAA0B,EAC1B,QAAgB,OAAO,CAAC,MAAM;IAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4C,CAAA;IAChE,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,MAAM,YAAY,GAAa,EAAE,CAAA;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;QACrB,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;QAE9B,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,GAAG,IAAI,GAAG,EAA+B,CAAA;YAC7C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QACpB,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAA;YAChC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QACpB,CAAC;QACD,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACrB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,EAAE,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAA;YAC5B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;YAChB,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5B,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI,YAAY,CAAC,YAAY,CAAC;QACzC,OAAO,EAAE,IAAI,WAAW,CAAC,YAAY,CAAC;KACvC,CAAA;AACH,CAAC","sourcesContent":["/**\r\n * meshdata/weld — 顶点焊接（从 `boolean/geo-convert.ts` 迁出的共享实现）。\r\n *\r\n * 按 1e-6 量化位置把重复顶点焊成唯一顶点，并把索引用焊接后的编号重写。\r\n * 这是 mesh 面从「未焊接的生成几何」到「Shape」的统一收口，`geo-convert` 与\r\n * `meshdata` 共用同一实现（一个事实一个家，避免两份焊接逻辑漂移）。\r\n */\r\n\r\n/** Interleaved positions + triangle indices (the raw mesh container). */\r\nexport interface MeshData {\r\n  positions: Float32Array\r\n  indices: Uint32Array\r\n}\r\n\r\n/**\r\n * Weld duplicate vertices by 1e-6-quantised position.\r\n * @param positions - flat position array (x, y, z, ...).\r\n * @param indices - triangle index array into `positions`.\r\n * @param count - number of indices to consume (defaults to the whole array).\r\n * @returns welded positions and rewritten indices.\r\n */\r\nexport function weldMesh(\r\n  positions: ArrayLike<number>,\r\n  indices: ArrayLike<number>,\r\n  count: number = indices.length,\r\n): MeshData {\r\n  const mapX = new Map<number, Map<number, Map<number, number>>>()\r\n  const weldedPosArr: number[] = []\r\n  const weldedIdxArr: number[] = []\r\n\r\n  for (let i = 0; i < count; i++) {\r\n    const vi = indices[i]\r\n    const x = positions[vi * 3]\r\n    const y = positions[vi * 3 + 1]\r\n    const z = positions[vi * 3 + 2]\r\n    const qx = Math.round(x * 1e6)\r\n    const qy = Math.round(y * 1e6)\r\n    const qz = Math.round(z * 1e6)\r\n\r\n    let mapY = mapX.get(qx)\r\n    if (mapY === undefined) {\r\n      mapY = new Map<number, Map<number, number>>()\r\n      mapX.set(qx, mapY)\r\n    }\r\n    let mapZ = mapY.get(qy)\r\n    if (mapZ === undefined) {\r\n      mapZ = new Map<number, number>()\r\n      mapY.set(qy, mapZ)\r\n    }\r\n    let ni = mapZ.get(qz)\r\n    if (ni === undefined) {\r\n      ni = weldedPosArr.length / 3\r\n      mapZ.set(qz, ni)\r\n      weldedPosArr.push(x, y, z)\r\n    }\r\n    weldedIdxArr.push(ni)\r\n  }\r\n\r\n  return {\r\n    positions: new Float32Array(weldedPosArr),\r\n    indices: new Uint32Array(weldedIdxArr),\r\n  }\r\n}"]}

package/dist/mesh/primitives.d.ts

@@ -9,7 +9,7 @@
  * B 组迁到 `@faicad/faijs-extra` 的 `mesh/primitives.ts`，core 的 mesh 面不再
  * 承载 three 的非基础几何生成链。
  *
- * 所有函数返回 Shape (ManifoldMeshData)：THREE.BufferGeometry → geoToManifoldMesh 转换。
+ * 所有函数返回 Shape (ManifoldMeshData)：parametric GeoData → geoToManifoldMesh 转换。
  * 坐标系：Z-up、毫米。
  */
 import type { Shape, BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams, SdfParams } from './types.js';

package/dist/mesh/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/mesh/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAcjH;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAiC5C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAOlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAkBtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CA6C9C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA0DhD;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE;IAClC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC,KAAK,CAAC,CAYjB;AAED;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAc3D"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/mesh/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAiBjH;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAkC5C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAQlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAkBtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAiC9C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAwDhD;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE;IAClC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC,KAAK,CAAC,CAYjB;AAED;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAc3D"}

package/dist/mesh/primitives.js

@@ -9,21 +9,24 @@
  * B 组迁到 `@faicad/faijs-extra` 的 `mesh/primitives.ts`，core 的 mesh 面不再
  * 承载 three 的非基础几何生成链。
  *
- * 所有函数返回 Shape (ManifoldMeshData)：THREE.BufferGeometry → geoToManifoldMesh 转换。
+ * 所有函数返回 Shape (ManifoldMeshData)：parametric GeoData → geoToManifoldMesh 转换。
  * 坐标系：Z-up、毫米。
  */
-import * as THREE from 'three';
-import { makePrimitiveGeo } from '../primitives/mesh-primitives.js';
+import { Mat4 } from '../math3d/index.js';
+import { boxGeometry, cylinderGeometry, coneGeometry, sphereGeometry } from './meshdata/parametric.js';
+import { transformShape, translateShape } from './meshdata/ops.js';
 import { geoToManifoldMesh } from '../boolean/csg-backend.js';
 import { clampNRad } from './types.js';
 // ── 内部工具 ──
-/** THREE.BufferGeometry → Shape (ManifoldMeshData)；可选携带面结构元数据。 */
+/** GeoData → Shape (ManifoldMeshData)；可选携带面结构元数据。 */
 function geoToShape(geo, faceRanges) {
     const shape = geoToManifoldMesh(geo);
     if (faceRanges !== undefined)
         shape.faceRanges = faceRanges;
     return shape;
 }
+/** Y-up → Z-up rotation (rotateX by PI/2), same as three's `makeRotationX(Math.PI / 2)`. */
+const ROT_Y_TO_Z = new Mat4().makeRotationX(Math.PI / 2);
 // ── 创建 API ──
 /**
  * Create a box solid (brepjs contract, §4.1 A 决策).
@@ -39,11 +42,10 @@ function geoToShape(geo, faceRanges) {
  */
 export function box(params) {
     const { width, depth, height } = params;
-    // THREE.BoxGeometry(a, b, c) is Y-up (X=a, Y=b, Z=c); after the +90° rotateX
-    // the dims map to X=a, Y=c, Z=b. To reach X=width, Y=depth, Z=height the
-    // pre-rotation sizes must be (width, height, depth) — 裁决 7 xyz contract.
-    const geo = new THREE.BoxGeometry(width, height, depth);
-    geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2));
+    // boxGeometry(width, height, depth) is Y-up (X=width, Y=height, Z=depth);
+    // after the +90° rotateX the dims map to X=width, Y=depth, Z=height.
+    const geo = boxGeometry(width, height, depth);
+    const rotated = transformShape(geo, ROT_Y_TO_Z);
     // 原 brepjs box semantics: corner at origin by default; centered at origin when
     // `centered` (no `at`); `at` (CENTER semantics) takes precedence.
     const at = params.at;
@@ -59,8 +61,9 @@ export function box(params) {
         ty = depth / 2;
         tz = height / 2;
     }
-    if (tx !== 0 || ty !== 0 || tz !== 0)
-        geo.translate(tx, ty, tz);
+    const translated = tx !== 0 || ty !== 0 || tz !== 0
+        ? translateShape(rotated, tx, ty, tz)
+        : rotated;
     // 面结构（P4 面级）：BoxGeometry 12 三角形 = 6 面 × 2，顺序固定
     // (+X, −X, +Y, −Y, +Z, −Z)；geoToManifoldMesh 焊接顶点保三角形序，故面序契约成立。
     // 面序号契约（setFaceColor 的 faceIds 即此序号）：0=+X, 1=−X, 2=+Y, 3=−Y, 4=+Z, 5=−Z。
@@ -72,7 +75,7 @@ export function box(params) {
         { start: 8, count: 2 },
         { start: 10, count: 2 },
     ];
-    return geoToShape(geo, faceRanges);
+    return geoToShape(translated, faceRanges);
 }
 /**
  * Create a sphere centered at the origin (or the optional `center`).
@@ -82,11 +85,12 @@ export function box(params) {
  */
 export function sphere(params) {
     const segs = clampNRad(params.nRad ?? params.segments);
-    const geo = makePrimitiveGeo('sphere', params.radius * 2, segs);
-    if (params.center) {
-        geo.translate(params.center[0], params.center[1], params.center[2]);
-    }
-    return geoToShape(geo);
+    const geo = sphereGeometry(params.radius, segs, segs);
+    const rotated = transformShape(geo, ROT_Y_TO_Z);
+    const translated = params.center
+        ? translateShape(rotated, params.center[0], params.center[1], params.center[2])
+        : rotated;
+    return geoToShape(translated);
 }
 /**
  * Create a cylinder along +Z (`cylinder(radius, height, { at?, centered?,
@@ -101,14 +105,14 @@ export function sphere(params) {
  */
 export function cylinder(params) {
     const segs = clampNRad(params.nRad ?? params.segments);
-    const geo = new THREE.CylinderGeometry(params.radius, params.radius, params.height, segs);
-    geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2));
+    const geo = cylinderGeometry(params.radius, params.radius, params.height, segs);
+    const rotated = transformShape(geo, ROT_Y_TO_Z);
     // geometry（rotateX 后）沿 z ∈ [-h/2, +h/2]（three 默认 Y-up 居中）：
     // 目标底面中心 in baseZ = (at?.[2] ?? 0) - (centered ? h/2 : 0) → 平移到 baseZ + h/2。
     const baseX = params.at?.[0] ?? 0;
     const baseY = params.at?.[1] ?? 0;
     const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0);
-    geo.translate(baseX, baseY, baseZ + params.height / 2);
+    const translated = translateShape(rotated, baseX, baseY, baseZ + params.height / 2);
     // 面结构（P4 面级）：CylinderGeometry 三角形布局稳定——侧面 2*segs（tri 0..2segs-1）、
     // 顶盖 segs、底盖 segs。面序号契约：0=侧面, 1=顶, 2=底。
     const faceRanges = [
@@ -116,7 +120,7 @@ export function cylinder(params) {
         { start: 2 * segs, count: segs },
         { start: 3 * segs, count: segs },
     ];
-    return geoToShape(geo, faceRanges);
+    return geoToShape(translated, faceRanges);
 }
 /**
  * Create a cone, or a frustum when the top and bottom radii differ
@@ -132,25 +136,22 @@ export function cylinder(params) {
  */
 export function cone(params) {
     const segs = clampNRad(params.nRad ?? params.segments);
-    const geo = new THREE.ConeGeometry(Math.max(params.radiusBottom, params.radiusTop), params.height, segs);
-    geo.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2));
-    // radiusTop === 0 → 尖锥（ConeGeometry 顶点在顶）；其余（含 radiusTop ===
-    // radiusBottom 的等径圆柱/圆台）用 CylinderGeometry（radiusTop/bottom 各就各位）。
-    let resultGeo;
+    // radiusTop === 0 → 尖锥（coneGeometry 顶点在顶）；其余（含 radiusTop ===
+    // radiusBottom 的等径圆柱/圆台）用 cylinderGeometry（radiusTop/bottom 各就各位）。
+    let geo;
     if (params.radiusTop === 0) {
-        resultGeo = geo;
+        geo = coneGeometry(Math.max(params.radiusBottom, params.radiusTop), params.height, segs);
     }
     else {
-        const geo2 = new THREE.CylinderGeometry(params.radiusTop, params.radiusBottom, params.height, segs);
-        geo2.applyMatrix4(new THREE.Matrix4().makeRotationX(Math.PI / 2));
-        resultGeo = geo2;
+        geo = cylinderGeometry(params.radiusTop, params.radiusBottom, params.height, segs);
     }
+    const rotated = transformShape(geo, ROT_Y_TO_Z);
     // geometry（rotateX 后）沿 z ∈ [-h/2, +h/2]（three 默认 Y-up 居中）：
     // 目标底面中心 in baseZ = (at?.[2] ?? 0) - (centered ? h/2 : 0) → 平坦平移 baseZ + h/2。
     const baseX = params.at?.[0] ?? 0;
     const baseY = params.at?.[1] ?? 0;
     const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0);
-    resultGeo.translate(baseX, baseY, baseZ + params.height / 2);
+    const translated = translateShape(rotated, baseX, baseY, baseZ + params.height / 2);
     // 面结构（P4 面级）：radiusTop=0 的 ConeGeometry 只有 2 面——侧面（segs 个
     // 三角扇）+ 底盖（segs 个）；radiusTop>0 的圆台 CylinderGeometry 3 面
     // （侧面 2*segs、顶、底，同 cylinder 布局）。面序号契约：0=侧面, 1=底
@@ -165,7 +166,7 @@ export function cone(params) {
             { start: 2 * segs, count: segs },
             { start: 3 * segs, count: segs },
         ];
-    return geoToShape(resultGeo, faceRanges);
+    return geoToShape(translated, faceRanges);
 }
 /**
  * Create a wedge (ramp) solid, fully parameterized and Z-up.
@@ -219,13 +220,11 @@ export function wedge(params) {
             0, 3, 7, 0, 7, 4,
             1, 5, 6, 1, 6, 2,
         ]);
-    const geo = new THREE.BufferGeometry();
-    geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
-    geo.setIndex(new THREE.BufferAttribute(indices, 1));
-    if (params.center) {
-        geo.translate(params.center[0], params.center[1], params.center[2]);
-    }
-    return geoToShape(geo);
+    const geo = { positions, indices };
+    const translated = params.center
+        ? translateShape(geo, params.center[0], params.center[1], params.center[2])
+        : geo;
+    return geoToShape(translated);
 }
 /**
  * Create a screw (threaded) geometry.