@faicad/faijs 0.13.0

package/dist/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../src/shape.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib shape — 类型化构造器 + 身份槽\n *\n *\n * 变更要点：\n * - 身份表（created / slots / shapeToName）改读全局锚点 runtime-state，\n *   使\"两份 faijs 代码\"共享同一份状态（解决 Shape 身份孤岛）。\n * - 新增 fromBrep(mesh, holder)：BREP 产物一次登记句柄与面演化，\n *   库函数不再手动登记（P2 落地）。\n * - 新增 hasBrep / brepOf：引擎侧判定\"某 Shape 是否在 BREP 链上\"。\n */\n\nimport type { Shape } from './mesh/types'\nimport { getRuntimeState, registerFunctionBrep, nameOf, type ShapeSlot } from './runtime-state'\n\n// ── Shape 构造器 ──\n\n/** Discriminator for the concrete shape kinds. */\nexport type ShapeKind = 'solid' | 'shape2d' | 'curve' | 'compound'\n\n/** A solid mesh shape produced by a constructor. */\nexport interface SolidShape extends Shape {\n  kind: 'solid'\n}\n\n/** A structural compound grouping a list of child shapes. */\nexport interface CompoundShape {\n  kind: 'compound'\n  children: Shape[]\n}\n\n/** A shape that the stdlib exports as a finished result. */\nexport type StdShape = SolidShape | CompoundShape\n\n/**\n * 实体 Shape 构造器：mesh 产物必须经此创建。\n *\n * @param mesh - the mesh shape to wrap as a solid.\n * @returns the created solid shape.\n */\nexport function solid(mesh: Shape): SolidShape {\n  const s: SolidShape = { ...mesh, kind: 'solid' }\n  getRuntimeState().created.add(s)\n  return s\n}\n\n/**\n * BREP 产物构造器：同时登记 mesh 与 OCCT 句柄（+ 可选面演化）。\n *\n * 库函数用它替代 `solid(mesh)` + 手动登记句柄两步行：\n * ```ts\n * return fromBrep(solidToShape(kernel, resultSolid), {\n *   solid: resultSolid,\n *   faceEvolution: identityEvolution(kernel, resultSolid),\n * })\n * ```\n *\n * @param mesh - the mesh shape to register.\n * @param holder - the BREP holder providing the OCCT handle and optional face evolution.\n * @returns the created solid shape with the BREP handle attached.\n */\nexport function fromBrep(mesh: Shape, holder: BrepHolder): SolidShape {\n  const s = solid(mesh)\n  const state = getRuntimeState()\n  const slot = state.slots.get(s) ?? {}\n  slot.solid = holder.solid\n  if (holder.faceEvolution) slot.faceEvolution = holder.faceEvolution\n  if (holder.roleTable) slot.roleTable = holder.roleTable\n  state.slots.set(s, slot)\n  // 函数 BREP 域（§5.6）：函数体内 op 产生的新句柄登记到当前域，函数返回后统一释放\n  registerFunctionBrep(holder.solid)\n  return s\n}\n\n/** BREP 句柄 + 面演化 + 拓扑命名 RoleTable（对应 OCCT 的 ShapeHandle）。类型为 unknown 以保持零依赖。 */\nexport interface BrepHolder {\n  solid: unknown\n  faceEvolution?: Map<number, number[]>\n  roleTable?: unknown\n}\n\n/**\n * compound Shape 构造器：结构（层级）而非新几何。\n *\n * @param children - the child shapes to group.\n * @returns the created compound shape.\n */\nexport function compound(children: Shape[]): CompoundShape {\n  const c: CompoundShape = { kind: 'compound', children }\n  getRuntimeState().created.add(c)\n  return c\n}\n\n/**\n * 是否为构造器产物（终端判定与 compound 检测的依据）。\n *\n * @param v - the value to test.\n * @returns true if the value was created by a shape constructor.\n */\nexport function isShape(v: unknown): v is Shape {\n  return !!v && typeof v === 'object' && getRuntimeState().created.has(v)\n}\n\n/**\n * Returns true if the value is a strict compound shape created by a constructor.\n *\n * @param v - the value to test.\n * @returns true if the value is a strict compound shape.\n */\nexport function isCompound(v: unknown): v is CompoundShape {\n  return isShape(v) && (v as { kind?: string }).kind === 'compound'\n}\n\n/**\n * 结构判定：是否为 compound 形态（keep-syntax §5.3 D5，对任意库函数零要求）。\n * 引擎内部的终端/消费判定用结构判定；SDK 公开的 isShape/isCompound 保持 WeakSet 严格。\n *\n * @param v - the value to test.\n * @returns true if the value has compound shape structure.\n */\nexport function isCompoundLike(v: unknown): v is CompoundShape {\n  return !!v && typeof v === 'object'\n    && (v as { kind?: string }).kind === 'compound'\n    && Array.isArray((v as { children?: unknown }).children)\n}\n\n// ── 身份槽 ──\n\nexport type { ShapeSlot }\n\n/**\n * 读取 Shape 的身份槽（无则 undefined）。\n *\n * @param shape - the shape whose slot to read.\n * @returns the identity slot, or undefined if none is registered.\n */\nexport function getSlot(shape: object): ShapeSlot | undefined {\n  return getRuntimeState().slots.get(shape)\n}\n\n/**\n * 读取或创建 Shape 的身份槽。\n *\n * @param shape - the shape whose slot to read or create.\n * @returns the shape's identity slot.\n */\nexport function ensureSlot(shape: object): ShapeSlot {\n  const state = getRuntimeState()\n  let slot = state.slots.get(shape)\n  if (!slot) {\n    slot = {}\n    state.slots.set(shape, slot)\n  }\n  return slot\n}\n\n/**\n * 该 Shape 是否在 BREP 链上（有 OCCT 句柄）。引擎分派与 UI 查询用。\n *\n * @param shape - the shape to test.\n * @returns true if the shape has an attached OCCT handle.\n */\nexport function hasBrep(shape: Shape): boolean {\n  return getRuntimeState().slots.get(shape)?.solid !== undefined\n}\n\n/**\n * 读取该 Shape 的 OCCT 句柄（无则 undefined）。库函数用前必须判空。\n *\n * @param shape - the shape whose handle to read.\n * @returns the OCCT handle, or undefined if none.\n */\nexport function brepOf(shape: Shape): unknown | undefined {\n  return getRuntimeState().slots.get(shape)?.solid\n}\n\n/**\n * nameOf 批量版：Shape[] → 成员名（装配 memberNames，P6 替代读 IR）。\n *\n * @param shapes - the shapes to name.\n * @returns the member names, one per shape (empty string when unnamed).\n */\nexport function nameOfShapes(shapes: Shape[]): string[] {\n  return shapes.map((s) => String(nameOf(s) ?? ''))\n}\n"]}

package/dist/test-helpers.d.ts

@@ -0,0 +1,31 @@
+/**
+ * test-helpers — 测试辅助函数
+ *
+ * 提供 executeScript 等便利函数，供测试使用。
+ * 从 script-engine/replay-validator.ts 迁移（原名 replayScript，已改名对齐 roadmap §3.6）。
+ *
+ * Phase 2.5：executeScript 改用 CadRuntime（VM 执行），不再依赖 src/ops/dispatcher 的 executeStatement。
+ * executeScript 接受代码文本，走 CadRuntime.execute（无 IR 中间层）。
+ */
+import type { Shape } from './mesh/types.js';
+import type { BrepChainState } from './brep/brep-chain.js';
+import type { HostPorts, ExecutionMode } from './cad-runtime/ports.js';
+/** Result of executing a script via the test helper. */
+export interface ExecuteOutput {
+    contentKey: string;
+    shape: Shape;
+    brepChain: BrepChainState;
+}
+/**
+ * Execute a script through the CadRuntime (direct path) and return the final
+ * shape, its content key, and the resulting BREP chain state.
+ *
+ * @param code - the .fai.js source text to execute.
+ * @param params - optional execution parameters.
+ * @param ports - optional host ports (defaults to a no-op events sink).
+ * @param mode - optional execution mode.
+ * @param _brepChain - optional pre-existing BREP chain state (reserved).
+ * @returns the final shape, content key, and BREP chain state.
+ */
+export declare function executeScript(code: string, params?: Record<string, unknown>, ports?: HostPorts, mode?: ExecutionMode, _brepChain?: BrepChainState): Promise<ExecuteOutput>;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIvD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAWnE,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,cAAc,CAAA;CAC1B;AAOD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE,aAAa,EACpB,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,aAAa,CAAC,CAsBxB"}

package/dist/test-helpers.js

@@ -0,0 +1,55 @@
+/**
+ * test-helpers — 测试辅助函数
+ *
+ * 提供 executeScript 等便利函数，供测试使用。
+ * 从 script-engine/replay-validator.ts 迁移（原名 replayScript，已改名对齐 roadmap §3.6）。
+ *
+ * Phase 2.5：executeScript 改用 CadRuntime（VM 执行），不再依赖 src/ops/dispatcher 的 executeStatement。
+ * executeScript 接受代码文本，走 CadRuntime.execute（无 IR 中间层）。
+ */
+import { createRuntime } from './cad-runtime/runtime.js';
+import { computeContentKey } from './cad-runtime/runtime.js';
+// P6/D1：库函数已并入 core 的 api/ 层（原 packages/stdlib 取消）。
+// 用「变量动态 import」——tsc 不解析非字面量 specifier，vitest 经 alias 解析到 api 源码。
+const API_NAMESPACE_MODULE = '@faicad/faijs-core/api/api-namespace';
+async function getCadLib() {
+    const mod = (await import(API_NAMESPACE_MODULE));
+    return mod.createApiNamespace();
+}
+/** 最小 ports（events no-op），供未传 ports 的测试使用。 */
+function defaultPorts() {
+    return { events: { emit: () => { } } };
+}
+/**
+ * Execute a script through the CadRuntime (direct path) and return the final
+ * shape, its content key, and the resulting BREP chain state.
+ *
+ * @param code - the .fai.js source text to execute.
+ * @param params - optional execution parameters.
+ * @param ports - optional host ports (defaults to a no-op events sink).
+ * @param mode - optional execution mode.
+ * @param _brepChain - optional pre-existing BREP chain state (reserved).
+ * @returns the final shape, content key, and BREP chain state.
+ */
+export async function executeScript(code, params, ports, mode, _brepChain) {
+    // P5/E-a-1：测试辅助注入 cad 命名空间（core 不默认装配；test-helpers 只被测试消费）
+    const runtime = createRuntime(ports ?? defaultPorts(), mode, { cad: await getCadLib() });
+    const result = await runtime.execute(code, { params });
+    // 从 outputs 中取最后一个 shape（与原逻辑一致）
+    const shapeNames = [...result.outputs.keys()];
+    if (shapeNames.length === 0) {
+        throw new Error(`[executeScript] empty result — no geometry outputs`);
+    }
+    const finalName = shapeNames[shapeNames.length - 1];
+    const finalShape = result.outputs.get(finalName);
+    if (!('positions' in finalShape) || !('indices' in finalShape)) {
+        throw new Error(`[executeScript] final output "${finalName}" is not a mesh shape`);
+    }
+    const contentKey = computeContentKey(finalShape.positions, finalShape.indices);
+    return {
+        contentKey,
+        shape: finalShape,
+        brepChain: result.brepChain,
+    };
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAIzD,oDAAoD;AACpD,mEAAmE;AACnE,MAAM,oBAAoB,GAAG,sCAAsC,CAAA;AAEnE,KAAK,UAAU,SAAS;IACtB,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAkD,CAAA;IACjG,OAAO,GAAG,CAAC,kBAAkB,EAAE,CAAA;AACjC,CAAC;AASD,8CAA8C;AAC9C,SAAS,YAAY;IACnB,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,EAAe,CAAA;AACpD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,MAAgC,EAChC,KAAiB,EACjB,IAAoB,EACpB,UAA2B;IAE3B,2DAA2D;IAC3D,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,IAAI,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,SAAS,EAAE,EAAE,CAAC,CAAA;IACxF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAEtD,iCAAiC;IACjC,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,CAAC;IACD,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAE,CAAA;IACjD,IAAI,CAAC,CAAC,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,uBAAuB,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAE9E,OAAO;QACL,UAAU;QACV,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;AACH,CAAC","sourcesContent":["/**\n * test-helpers — 测试辅助函数\n *\n * 提供 executeScript 等便利函数，供测试使用。\n * 从 script-engine/replay-validator.ts 迁移（原名 replayScript，已改名对齐 roadmap §3.6）。\n *\n * Phase 2.5：executeScript 改用 CadRuntime（VM 执行），不再依赖 src/ops/dispatcher 的 executeStatement。\n * executeScript 接受代码文本，走 CadRuntime.execute（无 IR 中间层）。\n */\n\nimport type { Shape } from './mesh/types'\nimport type { BrepChainState } from './brep/brep-chain'\nimport { createRuntime } from './cad-runtime/runtime'\nimport { computeContentKey } from './cad-runtime/runtime'\nimport type { StdlibNamespace } from './runtime-state'\nimport type { HostPorts, ExecutionMode } from './cad-runtime/ports'\n\n// P6/D1：库函数已并入 core 的 api/ 层（原 packages/stdlib 取消）。\n// 用「变量动态 import」——tsc 不解析非字面量 specifier，vitest 经 alias 解析到 api 源码。\nconst API_NAMESPACE_MODULE = '@faicad/faijs-core/api/api-namespace'\n\nasync function getCadLib(): Promise<StdlibNamespace> {\n  const mod = (await import(API_NAMESPACE_MODULE)) as { createApiNamespace: () => StdlibNamespace }\n  return mod.createApiNamespace()\n}\n\n/** Result of executing a script via the test helper. */\nexport interface ExecuteOutput {\n  contentKey: string\n  shape: Shape\n  brepChain: BrepChainState\n}\n\n/** 最小 ports（events no-op），供未传 ports 的测试使用。 */\nfunction defaultPorts(): HostPorts {\n  return { events: { emit: () => {} } } as HostPorts\n}\n\n/**\n * Execute a script through the CadRuntime (direct path) and return the final\n * shape, its content key, and the resulting BREP chain state.\n *\n * @param code - the .fai.js source text to execute.\n * @param params - optional execution parameters.\n * @param ports - optional host ports (defaults to a no-op events sink).\n * @param mode - optional execution mode.\n * @param _brepChain - optional pre-existing BREP chain state (reserved).\n * @returns the final shape, content key, and BREP chain state.\n */\nexport async function executeScript(\n  code: string,\n  params?: Record<string, unknown>,\n  ports?: HostPorts,\n  mode?: ExecutionMode,\n  _brepChain?: BrepChainState,\n): Promise<ExecuteOutput> {\n  // P5/E-a-1：测试辅助注入 cad 命名空间（core 不默认装配；test-helpers 只被测试消费）\n  const runtime = createRuntime(ports ?? defaultPorts(), mode, { cad: await getCadLib() })\n  const result = await runtime.execute(code, { params })\n\n  // 从 outputs 中取最后一个 shape（与原逻辑一致）\n  const shapeNames = [...result.outputs.keys()]\n  if (shapeNames.length === 0) {\n    throw new Error(`[executeScript] empty result — no geometry outputs`)\n  }\n  const finalName = shapeNames[shapeNames.length - 1]\n  const finalShape = result.outputs.get(finalName)!\n  if (!('positions' in finalShape) || !('indices' in finalShape)) {\n    throw new Error(`[executeScript] final output \"${finalName}\" is not a mesh shape`)\n  }\n  const contentKey = computeContentKey(finalShape.positions, finalShape.indices)\n\n  return {\n    contentKey,\n    shape: finalShape,\n    brepChain: result.brepChain,\n  }\n}\n"]}

package/dist/topology/build-face-ids.d.ts

@@ -0,0 +1,35 @@
+import type { SelectorRuntime } from './types.js';
+/** Sentinel face id meaning "no face" for a triangle. */
+export declare const TOPOLOGY_FACE_ID_NONE = 4294967295;
+interface FaceRunColumns {
+    stride: number;
+    occurrenceRow: number;
+    primitiveIndex: number;
+    triangleStart: number;
+    triangleCount: number;
+    faceRow: number;
+}
+/**
+ * Resolve the column indexes used to read face-run rows from a proxy.
+ *
+ * @param runtime - the selector runtime whose proxy defines the run columns.
+ * @returns the resolved column positions and row stride.
+ */
+export declare function faceRunColumnIndexes(runtime: SelectorRuntime): FaceRunColumns;
+/** Identifies a single part/mesh for which face ids are computed. */
+export interface PartMeshInfo {
+    occurrenceId: string;
+    primitiveIndex: number;
+    triangleCount: number;
+}
+/**
+ * Build a per-triangle faceId array for one part/mesh (from SelectorRuntime).
+ * Each entry is either a face table row index or TOPOLOGY_FACE_ID_NONE.
+ *
+ * @param part - identifies the part/mesh whose triangles to label.
+ * @param runtime - the selector runtime providing the face-run data.
+ * @returns the per-triangle faceId array, or null when no faces match.
+ */
+export declare function buildFaceIdsForPart(part: PartMeshInfo, runtime: SelectorRuntime): Uint32Array | null;
+export {};
+//# sourceMappingURL=build-face-ids.d.ts.map

package/dist/topology/build-face-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-face-ids.d.ts","sourceRoot":"","sources":["../../src/topology/build-face-ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,aAAa,CAAA;AAE/C,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAc7E;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,eAAe,GACvB,WAAW,GAAG,IAAI,CAoDpB"}

package/dist/topology/build-face-ids.js

@@ -0,0 +1,70 @@
+/** Sentinel face id meaning "no face" for a triangle. */
+export const TOPOLOGY_FACE_ID_NONE = 0xffffffff;
+/**
+ * Resolve the column indexes used to read face-run rows from a proxy.
+ *
+ * @param runtime - the selector runtime whose proxy defines the run columns.
+ * @returns the resolved column positions and row stride.
+ */
+export function faceRunColumnIndexes(runtime) {
+    const columns = Array.isArray(runtime.proxy.faceRunColumns) && runtime.proxy.faceRunColumns.length > 0
+        ? runtime.proxy.faceRunColumns
+        : ['occurrenceRow', 'primitiveIndex', 'triangleStart', 'triangleCount', 'faceRow'];
+    return {
+        stride: columns.length,
+        occurrenceRow: Math.max(0, columns.indexOf('occurrenceRow')),
+        primitiveIndex: Math.max(0, columns.indexOf('primitiveIndex')),
+        triangleStart: Math.max(0, columns.indexOf('triangleStart')),
+        triangleCount: Math.max(0, columns.indexOf('triangleCount')),
+        faceRow: Math.max(0, columns.indexOf('faceRow')),
+    };
+}
+/**
+ * Build a per-triangle faceId array for one part/mesh (from SelectorRuntime).
+ * Each entry is either a face table row index or TOPOLOGY_FACE_ID_NONE.
+ *
+ * @param part - identifies the part/mesh whose triangles to label.
+ * @param runtime - the selector runtime providing the face-run data.
+ * @returns the per-triangle faceId array, or null when no faces match.
+ */
+export function buildFaceIdsForPart(part, runtime) {
+    const runs = runtime.proxy.faceRuns;
+    const triangleCount = Math.max(0, Math.floor(Number(part.triangleCount || 0)));
+    if (!(runs instanceof Uint32Array) || runs.length === 0 || triangleCount <= 0) {
+        return null;
+    }
+    const occurrenceId = String(part.occurrenceId || '').trim();
+    if (!occurrenceId) {
+        return null;
+    }
+    const primitiveIndex = Math.max(0, Math.floor(Number(part.primitiveIndex || 0)));
+    const cols = faceRunColumnIndexes(runtime);
+    const faceIds = new Uint32Array(triangleCount);
+    faceIds.fill(TOPOLOGY_FACE_ID_NONE);
+    let matched = false;
+    for (let offset = 0; offset + cols.stride <= runs.length; offset += cols.stride) {
+        const runOccurrenceRow = Number(runs[offset + cols.occurrenceRow]);
+        const triangleStart = Number(runs[offset + cols.triangleStart]);
+        const runTriangleCount = Number(runs[offset + cols.triangleCount]);
+        const faceRow = Number(runs[offset + cols.faceRow]);
+        if (!Number.isInteger(triangleStart) ||
+            !Number.isInteger(runTriangleCount) ||
+            !Number.isInteger(faceRow) ||
+            triangleStart < 0 ||
+            runTriangleCount <= 0 ||
+            faceRow < 0) {
+            continue;
+        }
+        const runOccurrenceId = runtime.occurrenceIdByRowIndex.get(runOccurrenceRow);
+        if (runOccurrenceId !== occurrenceId ||
+            Number(runs[offset + cols.primitiveIndex]) !== primitiveIndex ||
+            triangleStart >= triangleCount) {
+            continue;
+        }
+        const end = Math.min(triangleStart + runTriangleCount, triangleCount);
+        faceIds.fill(faceRow, triangleStart, end);
+        matched = true;
+    }
+    return matched ? faceIds : null;
+}
+//# sourceMappingURL=build-face-ids.js.map

package/dist/topology/build-face-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-face-ids.js","sourceRoot":"","sources":["../../src/topology/build-face-ids.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SelectorRuntime } from './types'\n\n/** Sentinel face id meaning \"no face\" for a triangle. */\nexport const TOPOLOGY_FACE_ID_NONE = 0xffffffff\n\ninterface FaceRunColumns {\n  stride: number\n  occurrenceRow: number\n  primitiveIndex: number\n  triangleStart: number\n  triangleCount: number\n  faceRow: number\n}\n\n/**\n * Resolve the column indexes used to read face-run rows from a proxy.\n *\n * @param runtime - the selector runtime whose proxy defines the run columns.\n * @returns the resolved column positions and row stride.\n */\nexport function faceRunColumnIndexes(runtime: SelectorRuntime): FaceRunColumns {\n  const columns =\n    Array.isArray(runtime.proxy.faceRunColumns) && runtime.proxy.faceRunColumns.length > 0\n      ? runtime.proxy.faceRunColumns\n      : ['occurrenceRow', 'primitiveIndex', 'triangleStart', 'triangleCount', 'faceRow']\n\n  return {\n    stride: columns.length,\n    occurrenceRow: Math.max(0, columns.indexOf('occurrenceRow')),\n    primitiveIndex: Math.max(0, columns.indexOf('primitiveIndex')),\n    triangleStart: Math.max(0, columns.indexOf('triangleStart')),\n    triangleCount: Math.max(0, columns.indexOf('triangleCount')),\n    faceRow: Math.max(0, columns.indexOf('faceRow')),\n  }\n}\n\n/** Identifies a single part/mesh for which face ids are computed. */\nexport interface PartMeshInfo {\n  occurrenceId: string\n  primitiveIndex: number\n  triangleCount: number\n}\n\n/**\n * Build a per-triangle faceId array for one part/mesh (from SelectorRuntime).\n * Each entry is either a face table row index or TOPOLOGY_FACE_ID_NONE.\n *\n * @param part - identifies the part/mesh whose triangles to label.\n * @param runtime - the selector runtime providing the face-run data.\n * @returns the per-triangle faceId array, or null when no faces match.\n */\nexport function buildFaceIdsForPart(\n  part: PartMeshInfo,\n  runtime: SelectorRuntime,\n): Uint32Array | null {\n  const runs = runtime.proxy.faceRuns\n  const triangleCount = Math.max(0, Math.floor(Number(part.triangleCount || 0)))\n\n  if (!(runs instanceof Uint32Array) || runs.length === 0 || triangleCount <= 0) {\n    return null\n  }\n\n  const occurrenceId = String(part.occurrenceId || '').trim()\n  if (!occurrenceId) {\n    return null\n  }\n\n  const primitiveIndex = Math.max(0, Math.floor(Number(part.primitiveIndex || 0)))\n  const cols = faceRunColumnIndexes(runtime)\n  const faceIds = new Uint32Array(triangleCount)\n  faceIds.fill(TOPOLOGY_FACE_ID_NONE)\n\n  let matched = false\n\n  for (let offset = 0; offset + cols.stride <= runs.length; offset += cols.stride) {\n    const runOccurrenceRow = Number(runs[offset + cols.occurrenceRow])\n    const triangleStart = Number(runs[offset + cols.triangleStart])\n    const runTriangleCount = Number(runs[offset + cols.triangleCount])\n    const faceRow = Number(runs[offset + cols.faceRow])\n\n    if (\n      !Number.isInteger(triangleStart) ||\n      !Number.isInteger(runTriangleCount) ||\n      !Number.isInteger(faceRow) ||\n      triangleStart < 0 ||\n      runTriangleCount <= 0 ||\n      faceRow < 0\n    ) {\n      continue\n    }\n\n    const runOccurrenceId = runtime.occurrenceIdByRowIndex.get(runOccurrenceRow)\n    if (\n      runOccurrenceId !== occurrenceId ||\n      Number(runs[offset + cols.primitiveIndex]) !== primitiveIndex ||\n      triangleStart >= triangleCount\n    ) {\n      continue\n    }\n\n    const end = Math.min(triangleStart + runTriangleCount, triangleCount)\n    faceIds.fill(faceRow, triangleStart, end)\n    matched = true\n  }\n\n  return matched ? faceIds : null\n}\n"]}

package/dist/topology/build-logical-points.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Build logical point data — edge midpoints, face centers, and the merged
+ * "all points" array used by the point selection pick geometry.
+ *
+ * All functions are pure: no Three.js dependency, no side effects.
+ */
+/**
+ * Compute edge midpoints from edge line-segment geometry.
+ *
+ * Each edge row has a `segmentStart` into edgeIndices.  Multi-segment edges
+ * (e.g. circles) use the middle segment for a representative midpoint.
+ *
+ * @param edgeSegmentStarts — segmentStart value per edge (from edge row)
+ * @param edgeSegmentCounts — segmentCount value per edge (from edge row)
+ * @param edgePositions — vertex positions of edge endpoints.
+ * @param edgeIndices — index pairs defining each edge segment.
+ * @param edgeCount — the number of edges.
+ * @returns the midpoints as a Float32Array of (x, y, z) per edge.
+ */
+export declare function computeEdgeMidpoints(edgePositions: Float32Array, edgeIndices: Uint32Array, edgeSegmentStarts: number[], edgeSegmentCounts: number[], edgeCount: number): Float32Array;
+/**
+ * Compute face centers from the face proxy triangle geometry.
+ *
+ * faceRuns is a flat Uint32Array with rows of `stride` columns.
+ * The default stride = 5: [occurrenceRow, primitiveIndex, triangleStart, triangleCount, faceRow].
+ * Each run maps `triangleCount` triangles (starting at `triangleStart` in faceIndices)
+ * to a face identified by `faceRow`.
+ *
+ * Multiple runs may reference the same faceRow (e.g. when a face's triangles
+ * are split across multiple 3MF primitives). This function collects all
+ * triangle vertices per face and averages their unique positions.
+ *
+ * @param facePositions — vertex positions of face triangles.
+ * @param faceIndices — triangle indices into facePositions.
+ * @param faceRuns — flat run table with rows of `faceRunStride` columns.
+ * @param faceRunStride — number of columns per run row.
+ * @param faceCount — the number of faces.
+ * @returns the face centers as a Float32Array of (x, y, z) per face.
+ */
+export declare function computeFaceCenters(facePositions: Float32Array, faceIndices: Uint32Array, faceRuns: Uint32Array, faceRunStride: number, faceCount: number): Float32Array;
+/** Merged point buffers and counts for the point selection pick geometry. */
+export interface AllPointData {
+    allPointPositions: Float32Array;
+    /** 0=vertex, 1=edge-mid, 2=face-center */
+    allPointTypes: Uint8Array;
+    /** Source row index — into vertex/edge/face tables respectively */
+    allPointRefIndices: Uint32Array;
+    vertexPointCount: number;
+    edgeMidCount: number;
+    faceCenterCount: number;
+}
+/**
+ * Merge vertex positions, edge midpoints, and face centers into a single
+ * contiguous buffer suitable for building a THREE.Points pick geometry.
+ *
+ * @param params - the individual position and index buffers plus counts.
+ * @returns the merged point data.
+ */
+export declare function buildAllPointData(params: {
+    vertexPositions: Float32Array;
+    vertexIds: Uint32Array;
+    edgeMidpoints: Float32Array;
+    faceCenters: Float32Array;
+    vertexCount: number;
+    edgeCount: number;
+    faceCount: number;
+}): AllPointData;
+//# sourceMappingURL=build-logical-points.d.ts.map

package/dist/topology/build-logical-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-logical-points.d.ts","sourceRoot":"","sources":["../../src/topology/build-logical-points.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,YAAY,EAC3B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,iBAAiB,EAAE,MAAM,EAAE,EAC3B,SAAS,EAAE,MAAM,GAChB,YAAY,CAsBd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,YAAY,EAC3B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,YAAY,CAoDd;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,YAAY,CAAA;IAC/B,0CAA0C;IAC1C,aAAa,EAAE,UAAU,CAAA;IACzB,mEAAmE;IACnE,kBAAkB,EAAE,WAAW,CAAA;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,eAAe,EAAE,YAAY,CAAA;IAC7B,SAAS,EAAE,WAAW,CAAA;IACtB,aAAa,EAAE,YAAY,CAAA;IAC3B,WAAW,EAAE,YAAY,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,YAAY,CA0Df"}

package/dist/topology/build-logical-points.js

@@ -0,0 +1,169 @@
+/**
+ * Build logical point data — edge midpoints, face centers, and the merged
+ * "all points" array used by the point selection pick geometry.
+ *
+ * All functions are pure: no Three.js dependency, no side effects.
+ */
+/**
+ * Compute edge midpoints from edge line-segment geometry.
+ *
+ * Each edge row has a `segmentStart` into edgeIndices.  Multi-segment edges
+ * (e.g. circles) use the middle segment for a representative midpoint.
+ *
+ * @param edgeSegmentStarts — segmentStart value per edge (from edge row)
+ * @param edgeSegmentCounts — segmentCount value per edge (from edge row)
+ * @param edgePositions — vertex positions of edge endpoints.
+ * @param edgeIndices — index pairs defining each edge segment.
+ * @param edgeCount — the number of edges.
+ * @returns the midpoints as a Float32Array of (x, y, z) per edge.
+ */
+export function computeEdgeMidpoints(edgePositions, edgeIndices, edgeSegmentStarts, edgeSegmentCounts, edgeCount) {
+    if (edgePositions.length === 0 || edgeIndices.length === 0 || edgeCount <= 0) {
+        return new Float32Array(0);
+    }
+    const midpoints = new Float32Array(edgeCount * 3);
+    for (let i = 0; i < edgeCount; i++) {
+        const segStart = edgeSegmentStarts[i] ?? 0;
+        const segCount = edgeSegmentCounts[i] ?? 1;
+        // Use the middle segment for multi-segment edges, first for single-segment
+        const segIdx = segStart + (segCount > 1 ? Math.floor(segCount / 2) : 0);
+        const a = edgeIndices[segIdx * 2] * 3;
+        const b = edgeIndices[segIdx * 2 + 1] * 3;
+        if (a + 2 >= edgePositions.length || b + 2 >= edgePositions.length) {
+            midpoints[i * 3] = midpoints[i * 3 + 1] = midpoints[i * 3 + 2] = 0;
+            continue;
+        }
+        midpoints[i * 3] = (edgePositions[a] + edgePositions[b]) / 2;
+        midpoints[i * 3 + 1] = (edgePositions[a + 1] + edgePositions[b + 1]) / 2;
+        midpoints[i * 3 + 2] = (edgePositions[a + 2] + edgePositions[b + 2]) / 2;
+    }
+    return midpoints;
+}
+/**
+ * Compute face centers from the face proxy triangle geometry.
+ *
+ * faceRuns is a flat Uint32Array with rows of `stride` columns.
+ * The default stride = 5: [occurrenceRow, primitiveIndex, triangleStart, triangleCount, faceRow].
+ * Each run maps `triangleCount` triangles (starting at `triangleStart` in faceIndices)
+ * to a face identified by `faceRow`.
+ *
+ * Multiple runs may reference the same faceRow (e.g. when a face's triangles
+ * are split across multiple 3MF primitives). This function collects all
+ * triangle vertices per face and averages their unique positions.
+ *
+ * @param facePositions — vertex positions of face triangles.
+ * @param faceIndices — triangle indices into facePositions.
+ * @param faceRuns — flat run table with rows of `faceRunStride` columns.
+ * @param faceRunStride — number of columns per run row.
+ * @param faceCount — the number of faces.
+ * @returns the face centers as a Float32Array of (x, y, z) per face.
+ */
+export function computeFaceCenters(facePositions, faceIndices, faceRuns, faceRunStride, faceCount) {
+    if (facePositions.length === 0 || faceIndices.length === 0 || faceRuns.length === 0 || faceCount <= 0) {
+        return new Float32Array(0);
+    }
+    if (faceRunStride < 5) {
+        return new Float32Array(0);
+    }
+    // Default column indices per faceRunColumnIndexes in build-face-ids.ts
+    const colTriangleStart = 2;
+    const colTriangleCount = 3;
+    const colFaceRow = 4;
+    // Build per-face vertex sets
+    const faceVertices = Array.from({ length: faceCount }, () => new Map());
+    for (let offset = 0; offset + faceRunStride <= faceRuns.length; offset += faceRunStride) {
+        const triangleStart = faceRuns[offset + colTriangleStart];
+        const triangleCount = faceRuns[offset + colTriangleCount];
+        const faceRow = faceRuns[offset + colFaceRow];
+        if (faceRow >= faceCount || triangleCount === 0)
+            continue;
+        const triEnd = Math.min(triangleStart + triangleCount, faceIndices.length / 3) * 3;
+        for (let ti = triangleStart * 3; ti < triEnd; ti++) {
+            const vi = faceIndices[ti] * 3;
+            if (vi + 2 >= facePositions.length)
+                continue;
+            const key = `${facePositions[vi].toFixed(6)},${facePositions[vi + 1].toFixed(6)},${facePositions[vi + 2].toFixed(6)}`;
+            faceVertices[faceRow].set(key, vi);
+        }
+    }
+    const centers = new Float32Array(faceCount * 3);
+    for (let f = 0; f < faceCount; f++) {
+        const verts = faceVertices[f];
+        if (verts.size === 0) {
+            centers[f * 3] = centers[f * 3 + 1] = centers[f * 3 + 2] = 0;
+            continue;
+        }
+        let sx = 0, sy = 0, sz = 0;
+        for (const vi of verts.values()) {
+            sx += facePositions[vi];
+            sy += facePositions[vi + 1];
+            sz += facePositions[vi + 2];
+        }
+        const n = verts.size;
+        centers[f * 3] = sx / n;
+        centers[f * 3 + 1] = sy / n;
+        centers[f * 3 + 2] = sz / n;
+    }
+    return centers;
+}
+/**
+ * Merge vertex positions, edge midpoints, and face centers into a single
+ * contiguous buffer suitable for building a THREE.Points pick geometry.
+ *
+ * @param params - the individual position and index buffers plus counts.
+ * @returns the merged point data.
+ */
+export function buildAllPointData(params) {
+    const { vertexPositions, edgeMidpoints, faceCenters, vertexCount, edgeCount, faceCount } = params;
+    const totalPoints = vertexCount + edgeCount + faceCount;
+    const allPointPositions = new Float32Array(totalPoints * 3);
+    const allPointTypes = new Uint8Array(totalPoints);
+    const allPointRefIndices = new Uint32Array(totalPoints);
+    let offset = 0;
+    // Vertices (type 0)
+    for (let i = 0; i < vertexCount; i++) {
+        const si = i * 3;
+        const di = offset * 3;
+        allPointPositions[di] = vertexPositions[si];
+        allPointPositions[di + 1] = vertexPositions[si + 1];
+        allPointPositions[di + 2] = vertexPositions[si + 2];
+        allPointTypes[offset] = 0;
+        allPointRefIndices[offset] = i;
+        offset++;
+    }
+    // Edge midpoints (type 1)
+    // refIndex = vertexCount + i — matches the rowIndex used in
+    // build-selector-runtime when creating edge-midpoint References.
+    for (let i = 0; i < edgeCount; i++) {
+        const si = i * 3;
+        const di = offset * 3;
+        allPointPositions[di] = edgeMidpoints[si];
+        allPointPositions[di + 1] = edgeMidpoints[si + 1];
+        allPointPositions[di + 2] = edgeMidpoints[si + 2];
+        allPointTypes[offset] = 1;
+        allPointRefIndices[offset] = vertexCount + i;
+        offset++;
+    }
+    // Face centers (type 2)
+    // refIndex = vertexCount + edgeCount + i — matches the rowIndex used in
+    // build-selector-runtime when creating face-center References.
+    for (let i = 0; i < faceCount; i++) {
+        const si = i * 3;
+        const di = offset * 3;
+        allPointPositions[di] = faceCenters[si];
+        allPointPositions[di + 1] = faceCenters[si + 1];
+        allPointPositions[di + 2] = faceCenters[si + 2];
+        allPointTypes[offset] = 2;
+        allPointRefIndices[offset] = vertexCount + edgeCount + i;
+        offset++;
+    }
+    return {
+        allPointPositions,
+        allPointTypes,
+        allPointRefIndices,
+        vertexPointCount: vertexCount,
+        edgeMidCount: edgeCount,
+        faceCenterCount: faceCount,
+    };
+}
+//# sourceMappingURL=build-logical-points.js.map

package/dist/topology/build-logical-points.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-logical-points.js","sourceRoot":"","sources":["../../src/topology/build-logical-points.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Build logical point data — edge midpoints, face centers, and the merged\n * \"all points\" array used by the point selection pick geometry.\n *\n * All functions are pure: no Three.js dependency, no side effects.\n */\n\n/**\n * Compute edge midpoints from edge line-segment geometry.\n *\n * Each edge row has a `segmentStart` into edgeIndices.  Multi-segment edges\n * (e.g. circles) use the middle segment for a representative midpoint.\n *\n * @param edgeSegmentStarts — segmentStart value per edge (from edge row)\n * @param edgeSegmentCounts — segmentCount value per edge (from edge row)\n * @param edgePositions — vertex positions of edge endpoints.\n * @param edgeIndices — index pairs defining each edge segment.\n * @param edgeCount — the number of edges.\n * @returns the midpoints as a Float32Array of (x, y, z) per edge.\n */\nexport function computeEdgeMidpoints(\n  edgePositions: Float32Array,\n  edgeIndices: Uint32Array,\n  edgeSegmentStarts: number[],\n  edgeSegmentCounts: number[],\n  edgeCount: number,\n): Float32Array {\n  if (edgePositions.length === 0 || edgeIndices.length === 0 || edgeCount <= 0) {\n    return new Float32Array(0)\n  }\n\n  const midpoints = new Float32Array(edgeCount * 3)\n  for (let i = 0; i < edgeCount; i++) {\n    const segStart = edgeSegmentStarts[i] ?? 0\n    const segCount = edgeSegmentCounts[i] ?? 1\n    // Use the middle segment for multi-segment edges, first for single-segment\n    const segIdx = segStart + (segCount > 1 ? Math.floor(segCount / 2) : 0)\n    const a = edgeIndices[segIdx * 2] * 3\n    const b = edgeIndices[segIdx * 2 + 1] * 3\n    if (a + 2 >= edgePositions.length || b + 2 >= edgePositions.length) {\n      midpoints[i * 3] = midpoints[i * 3 + 1] = midpoints[i * 3 + 2] = 0\n      continue\n    }\n    midpoints[i * 3] = (edgePositions[a] + edgePositions[b]) / 2\n    midpoints[i * 3 + 1] = (edgePositions[a + 1] + edgePositions[b + 1]) / 2\n    midpoints[i * 3 + 2] = (edgePositions[a + 2] + edgePositions[b + 2]) / 2\n  }\n  return midpoints\n}\n\n/**\n * Compute face centers from the face proxy triangle geometry.\n *\n * faceRuns is a flat Uint32Array with rows of `stride` columns.\n * The default stride = 5: [occurrenceRow, primitiveIndex, triangleStart, triangleCount, faceRow].\n * Each run maps `triangleCount` triangles (starting at `triangleStart` in faceIndices)\n * to a face identified by `faceRow`.\n *\n * Multiple runs may reference the same faceRow (e.g. when a face's triangles\n * are split across multiple 3MF primitives). This function collects all\n * triangle vertices per face and averages their unique positions.\n *\n * @param facePositions — vertex positions of face triangles.\n * @param faceIndices — triangle indices into facePositions.\n * @param faceRuns — flat run table with rows of `faceRunStride` columns.\n * @param faceRunStride — number of columns per run row.\n * @param faceCount — the number of faces.\n * @returns the face centers as a Float32Array of (x, y, z) per face.\n */\nexport function computeFaceCenters(\n  facePositions: Float32Array,\n  faceIndices: Uint32Array,\n  faceRuns: Uint32Array,\n  faceRunStride: number,\n  faceCount: number,\n): Float32Array {\n  if (facePositions.length === 0 || faceIndices.length === 0 || faceRuns.length === 0 || faceCount <= 0) {\n    return new Float32Array(0)\n  }\n\n  if (faceRunStride < 5) {\n    return new Float32Array(0)\n  }\n\n  // Default column indices per faceRunColumnIndexes in build-face-ids.ts\n  const colTriangleStart = 2\n  const colTriangleCount = 3\n  const colFaceRow = 4\n\n  // Build per-face vertex sets\n  const faceVertices: Map<string, number>[] = Array.from({ length: faceCount }, () => new Map())\n\n  for (let offset = 0; offset + faceRunStride <= faceRuns.length; offset += faceRunStride) {\n    const triangleStart = faceRuns[offset + colTriangleStart]\n    const triangleCount = faceRuns[offset + colTriangleCount]\n    const faceRow = faceRuns[offset + colFaceRow]\n\n    if (faceRow >= faceCount || triangleCount === 0) continue\n\n    const triEnd = Math.min(triangleStart + triangleCount, faceIndices.length / 3) * 3\n    for (let ti = triangleStart * 3; ti < triEnd; ti++) {\n      const vi = faceIndices[ti] * 3\n      if (vi + 2 >= facePositions.length) continue\n      const key = `${facePositions[vi].toFixed(6)},${facePositions[vi + 1].toFixed(6)},${facePositions[vi + 2].toFixed(6)}`\n      faceVertices[faceRow].set(key, vi)\n    }\n  }\n\n  const centers = new Float32Array(faceCount * 3)\n  for (let f = 0; f < faceCount; f++) {\n    const verts = faceVertices[f]\n    if (verts.size === 0) {\n      centers[f * 3] = centers[f * 3 + 1] = centers[f * 3 + 2] = 0\n      continue\n    }\n    let sx = 0, sy = 0, sz = 0\n    for (const vi of verts.values()) {\n      sx += facePositions[vi]\n      sy += facePositions[vi + 1]\n      sz += facePositions[vi + 2]\n    }\n    const n = verts.size\n    centers[f * 3] = sx / n\n    centers[f * 3 + 1] = sy / n\n    centers[f * 3 + 2] = sz / n\n  }\n  return centers\n}\n\n/** Merged point buffers and counts for the point selection pick geometry. */\nexport interface AllPointData {\n  allPointPositions: Float32Array\n  /** 0=vertex, 1=edge-mid, 2=face-center */\n  allPointTypes: Uint8Array\n  /** Source row index — into vertex/edge/face tables respectively */\n  allPointRefIndices: Uint32Array\n  vertexPointCount: number\n  edgeMidCount: number\n  faceCenterCount: number\n}\n\n/**\n * Merge vertex positions, edge midpoints, and face centers into a single\n * contiguous buffer suitable for building a THREE.Points pick geometry.\n *\n * @param params - the individual position and index buffers plus counts.\n * @returns the merged point data.\n */\nexport function buildAllPointData(params: {\n  vertexPositions: Float32Array\n  vertexIds: Uint32Array\n  edgeMidpoints: Float32Array\n  faceCenters: Float32Array\n  vertexCount: number\n  edgeCount: number\n  faceCount: number\n}): AllPointData {\n  const { vertexPositions, edgeMidpoints, faceCenters, vertexCount, edgeCount, faceCount } = params\n\n  const totalPoints = vertexCount + edgeCount + faceCount\n  const allPointPositions = new Float32Array(totalPoints * 3)\n  const allPointTypes = new Uint8Array(totalPoints)\n  const allPointRefIndices = new Uint32Array(totalPoints)\n\n  let offset = 0\n\n  // Vertices (type 0)\n  for (let i = 0; i < vertexCount; i++) {\n    const si = i * 3\n    const di = offset * 3\n    allPointPositions[di] = vertexPositions[si]\n    allPointPositions[di + 1] = vertexPositions[si + 1]\n    allPointPositions[di + 2] = vertexPositions[si + 2]\n    allPointTypes[offset] = 0\n    allPointRefIndices[offset] = i\n    offset++\n  }\n\n  // Edge midpoints (type 1)\n  // refIndex = vertexCount + i — matches the rowIndex used in\n  // build-selector-runtime when creating edge-midpoint References.\n  for (let i = 0; i < edgeCount; i++) {\n    const si = i * 3\n    const di = offset * 3\n    allPointPositions[di] = edgeMidpoints[si]\n    allPointPositions[di + 1] = edgeMidpoints[si + 1]\n    allPointPositions[di + 2] = edgeMidpoints[si + 2]\n    allPointTypes[offset] = 1\n    allPointRefIndices[offset] = vertexCount + i\n    offset++\n  }\n\n  // Face centers (type 2)\n  // refIndex = vertexCount + edgeCount + i — matches the rowIndex used in\n  // build-selector-runtime when creating face-center References.\n  for (let i = 0; i < faceCount; i++) {\n    const si = i * 3\n    const di = offset * 3\n    allPointPositions[di] = faceCenters[si]\n    allPointPositions[di + 1] = faceCenters[si + 1]\n    allPointPositions[di + 2] = faceCenters[si + 2]\n    allPointTypes[offset] = 2\n    allPointRefIndices[offset] = vertexCount + edgeCount + i\n    offset++\n  }\n\n  return {\n    allPointPositions,\n    allPointTypes,\n    allPointRefIndices,\n    vertexPointCount: vertexCount,\n    edgeMidCount: edgeCount,\n    faceCenterCount: faceCount,\n  }\n}\n"]}

package/dist/topology/build-selector-runtime.d.ts

@@ -0,0 +1,82 @@
+import { type OccurrenceId } from '../identity.js';
+import type { BBox, EdgeRow, FaceRow, OccurrenceRow, Reference, SelectorBundle, SelectorProxy, SelectorRuntime, ShapeRow } from './types.js';
+/**
+ * Same as SelectorRuntime but without Map fields.
+ * Used to transfer the runtime across the Worker boundary — Maps cannot be
+ * efficiently structured-cloned, so we build them on the main thread instead.
+ */
+export interface SelectorRuntimeData {
+    cadPath: string;
+    stepHash: string;
+    bbox: BBox | null;
+    occurrences: OccurrenceRow[];
+    shapes: ShapeRow[];
+    faces: FaceRow[];
+    edges: EdgeRow[];
+    vertices: Record<string, unknown>[];
+    /** Already filtered to visible references (non-empty normalizedSelector). */
+    references: Reference[];
+    singleOccurrenceId: OccurrenceId;
+    proxy: SelectorProxy;
+}
+/**
+ * Extract unique vertices from edge line-segment endpoint positions.
+ * No producer emits a dedicated vertexPositions buffer, so vertices are
+ * always extracted from edge data.
+ *
+ * Each edge is defined by 2 endpoint indices into edgePositions, so we
+ * walk edgeIndices and collect the referenced positions, deduplicating
+ * by a spatial tolerance.
+ *
+ * @param edgePositions - vertex positions of edge endpoints.
+ * @param edgeIndices - index pairs defining each edge segment.
+ * @param tolerance - spatial tolerance used to deduplicate by position.
+ * @returns the unique vertex positions and their sequential ids.
+ */
+export declare function extractVerticesFromEdges(edgePositions: Float32Array, edgeIndices: Uint32Array, tolerance?: number): {
+    positions: Float32Array;
+    ids: Uint32Array;
+};
+/**
+ * Build the serializable selector runtime data (manifest rows, reference
+ * list, logical point buffers) without Maps, so it can be structured-cloned
+ * across the Worker boundary.
+ *
+ * @param bundle - the parsed selector manifest and its typed buffer views.
+ * @param options - optional transform and scale for topology positions.
+ * @returns the serializable selector runtime data.
+ */
+export declare function buildSelectorRuntimeData(bundle: SelectorBundle, options?: {
+    transform?: number[] | null;
+    /** Scale factor for topology positions (default 0.001 = mm→m for STEP).
+     *  STEP data is authored in mm; callers with mm scene units should
+     *  pass scale: 1. */
+    scale?: number;
+}): SelectorRuntimeData;
+/**
+ * Rebuild Map fields from SelectorRuntimeData.
+ *
+ * This runs on the main thread after receiving data from the worker.
+ * It is O(n) in the number of references — fast compared to the full
+ * buildSelectorRuntimeData computation.
+ *
+ * @param data - the serializable runtime data.
+ * @returns the fully assembled selector runtime with Map lookups.
+ */
+export declare function buildSelectorRuntimeMaps(data: SelectorRuntimeData): SelectorRuntime;
+/**
+ * Build a fully assembled SelectorRuntime (data + Maps).
+ *
+ * Convenience wrapper: buildSelectorRuntimeData + buildSelectorRuntimeMaps.
+ * Use buildSelectorRuntimeData in workers and rebuild Maps on the main thread
+ * to avoid expensive structured-clone of Map objects.
+ *
+ * @param bundle - the parsed selector manifest and its typed buffer views.
+ * @param options - optional transform and scale for topology positions.
+ * @returns the fully assembled selector runtime.
+ */
+export declare function buildSelectorRuntime(bundle: SelectorBundle, options?: {
+    transform?: number[] | null;
+    scale?: number;
+}): SelectorRuntime;
+//# sourceMappingURL=build-selector-runtime.d.ts.map

package/dist/topology/build-selector-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-selector-runtime.d.ts","sourceRoot":"","sources":["../../src/topology/build-selector-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAGlB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EACV,IAAI,EACJ,OAAO,EACP,OAAO,EACP,aAAa,EACb,SAAS,EACT,cAAc,EAEd,aAAa,EACb,eAAe,EACf,QAAQ,EACT,MAAM,SAAS,CAAA;AAIhB;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,WAAW,EAAE,aAAa,EAAE,CAAA;IAC5B,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IACnC,6EAA6E;IAC7E,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,kBAAkB,EAAE,YAAY,CAAA;IAChC,KAAK,EAAE,aAAa,CAAA;CACrB;AAsaD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,YAAY,EAC3B,WAAW,EAAE,WAAW,EACxB,SAAS,GAAE,MAAa,GACvB;IAAE,SAAS,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CA2B/C;AAID;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC3B;;yBAEqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACV,GACL,mBAAmB,CAyPrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CAyCnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;CACV,GACL,eAAe,CAEjB"}