@faicad/faijs 0.13.0

package/dist/occt-kernel/stepColorParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepColorParser.js","sourceRoot":"","sources":["../../src/occt-kernel/stepColorParser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * STEP 颜色解析器 — 从 STEP 文本中提取每个 solid 的颜色。\n *\n * STEP 文件中的颜色引用链：\n *   STYLED_ITEM → PRESENTATION_STYLE_ASSIGNMENT → SURFACE_STYLE_USAGE\n *   → SURFACE_SIDE_STYLE → SURFACE_STYLE_FILL_AREA → FILL_AREA_STYLE\n *   → FILL_AREA_STYLE_COLOUR → COLOUR_RGB\n *\n * STYLED_ITEM 的第三个参数引用被着色的 shape entity（通常是 MANIFOLD_SOLID_BREP）。\n * 我们解析这个引用链，建立 solid entity ID → color 的映射。\n *\n * 当 OCCT XCAF 的 getLabelInfo 返回 hasColor=false 时（颜色存储在 sub-shape 层级\n * 而非 label 层级），此解析器作为后备方案提取颜色。\n */\n\nexport interface StepEntity {\n  id: number\n  type: string\n  /** Raw parameter string (between parentheses). */\n  params: string\n}\n\n/** A solid's color parsed from STEP text. */\nexport interface SolidColor {\n  /** STEP entity ID of the MANIFOLD_SOLID_BREP. */\n  solidId: number\n  /** RGB color in 0..1 range. */\n  color: [number, number, number]\n}\n\n/** Parse all entities from STEP text into a Map<id, StepEntity>. */\nfunction parseStepEntities(stepText: string): Map<number, StepEntity> {\n  const entities = new Map<number, StepEntity>()\n  // Match lines like: #123=ENTITY_TYPE(params);\n  // STEP entities can span multiple lines, but the closing ); is always at end\n  const regex = /#(\\d+)\\s*=\\s*([A-Z_]+)\\s*\\(([^;]*)\\)/g\n  let match: RegExpExecArray | null\n  while ((match = regex.exec(stepText)) !== null) {\n    const id = parseInt(match[1], 10)\n    const type = match[2]\n    const params = match[3]\n    entities.set(id, { id, type, params })\n  }\n  return entities\n}\n\n/** Extract all # references from a parameter string. Returns array of IDs. */\nfunction extractRefs(params: string): number[] {\n  const refs: number[] = []\n  const regex = /#(\\d+)/g\n  let match: RegExpExecArray | null\n  while ((match = regex.exec(params)) !== null) {\n    refs.push(parseInt(match[1], 10))\n  }\n  return refs\n}\n\n/**\n * Resolve the color reference chain starting from a STYLED_ITEM.\n * Returns the COLOUR_RGB values if found, or null if the chain is broken.\n */\nfunction resolveColorChain(\n  entityId: number,\n  entities: Map<number, StepEntity>,\n  visited: Set<number> = new Set(),\n): [number, number, number] | null {\n  if (visited.has(entityId)) return null // cycle guard\n  visited.add(entityId)\n\n  const entity = entities.get(entityId)\n  if (!entity) return null\n\n  if (entity.type === 'COLOUR_RGB') {\n    // Parse: 'name', r, g, b\n    const parts = entity.params.split(',')\n    // Color values start after the name (which may contain commas if quoted)\n    // Find the last 3 numeric values\n    const nums: number[] = []\n    for (let i = parts.length - 1; i >= 0 && nums.length < 3; i--) {\n      const n = parseFloat(parts[i].trim())\n      if (!isNaN(n)) nums.unshift(n)\n    }\n    if (nums.length === 3) {\n      return [nums[0], nums[1], nums[2]]\n    }\n    return null\n  }\n\n  // For all intermediate types, follow # references\n  const refs = extractRefs(entity.params)\n  for (const ref of refs) {\n    const color = resolveColorChain(ref, entities, visited)\n    if (color) return color\n  }\n\n  return null\n}\n\n/**\n * Parse STEP text and extract colors for each solid.\n *\n * @param stepText Raw STEP file content\n * @returns Map<solidEntityId, [r, g, b]> where r,g,b are in 0..1 range\n */\nexport function parseStepColors(stepText: string): Map<number, [number, number, number]> {\n  const entities = parseStepEntities(stepText)\n  const colorMap = new Map<number, [number, number, number]>()\n\n  for (const [, entity] of entities) {\n    if (entity.type === 'STYLED_ITEM') {\n      // STYLED_ITEM('', (#styleRef), #shapeRef)\n      // The last # reference is the shape being styled\n      const refs = extractRefs(entity.params)\n      if (refs.length < 2) continue\n\n      const shapeRef = refs[refs.length - 1] // last ref = styled shape\n      const styleRef = refs[0] // first ref = presentation style\n\n      // Verify the shape ref is a MANIFOLD_SOLID_BREP (or ADVANCED_BREP_SHAPE_REPRESENTATION)\n      const shapeEntity = entities.get(shapeRef)\n      if (!shapeEntity) continue\n\n      // Resolve color from the style reference chain\n      const color = resolveColorChain(styleRef, entities)\n      if (color) {\n        colorMap.set(shapeRef, color)\n      }\n    }\n  }\n\n  return colorMap\n}\n\n/**\n * Parse STEP text and return the ordered list of solid entity IDs.\n *\n * This order should match OCCT's getSubShapes(compound, 'solid') order,\n * because both iterate the compound's sub-shapes in the same order\n * they appear in the STEP file.\n *\n * @param stepText - raw STEP file content\n * @returns the ordered MANIFOLD_SOLID_BREP entity IDs\n */\nexport function parseStepSolidOrder(stepText: string): number[] {\n  const entities = parseStepEntities(stepText)\n  const solids: number[] = []\n  for (const [id, entity] of entities) {\n    if (entity.type === 'MANIFOLD_SOLID_BREP') {\n      solids.push(id)\n    }\n  }\n  return solids\n}\n\n/**\n * Get colors for each solid in order.\n *\n * @param stepText Raw STEP file content\n * @returns Array of colors [r,g,b] in 0..1, or null for solids without color.\n *          Length matches the number of MANIFOLD_SOLID_BREP entities.\n */\nexport function getSolidColorsOrdered(stepText: string): ([number, number, number] | null)[] {\n  const colorMap = parseStepColors(stepText)\n  const solidOrder = parseStepSolidOrder(stepText)\n  return solidOrder.map(id => colorMap.get(id) ?? null)\n}\n"]}

package/dist/occt-kernel/topologyExt.d.ts

@@ -0,0 +1,80 @@
+import type { BrepHandle, BrepMeshResult } from '../brep/engine/types.js';
+import type { BrepEngineApi } from '../brep/engine/primitives.js';
+interface SelectorManifestOptions {
+    stepHash?: string;
+    cadPath?: string;
+}
+/** Input for building a per-part selector manifest. */
+export interface SelectorManifestInput {
+    shapeHandle: BrepHandle;
+    meshWithGroups: BrepMeshResult;
+}
+/**
+ * Build a selector manifest for a single part's topology.
+ *
+ * Enumerates the shape's faces and edges and their relations, extracts edge
+ * polylines from the kernel wireframe and face geometry from the mesh, computes
+ * relevance scores, and assembles everything into a columnar selector manifest
+ * plus its binary attribute buffers.
+ *
+ * @param kernel - the OCCT kernel
+ * @param input - the shape handle and mesh-with-groups input
+ * @param options - optional metadata (step hash and CAD path)
+ * @param occurrenceId - the occurrence ID to prefix this part's ids (default 'o1')
+ * @returns the assembled manifest and its binary buffers
+ */
+export declare function buildSelectorManifest(kernel: BrepEngineApi, input: SelectorManifestInput, options: SelectorManifestOptions, occurrenceId?: string): {
+    manifest: Record<string, unknown>;
+    buffers: Record<string, Float32Array | Uint32Array>;
+};
+/** Input for per-part topology identification in an assembly. */
+export interface PartTopologyInput {
+    labelPath: string;
+    shapeHandle: BrepHandle;
+    meshWithGroups: BrepMeshResult;
+}
+/** Result of assembly-level topology identification. */
+export interface AssemblyTopologyResult {
+    manifest: Record<string, unknown>;
+    buffers: Record<string, Float32Array | Uint32Array>;
+}
+/**
+ * Build a selector manifest for an assembly (multi-part) topology.
+ *
+ * For each part, runs the per-part topology identification (face/edge enumeration,
+ * wireframe, relations) and merges into a single assembly manifest.
+ *
+ * Occurrence IDs use the part's labelPath (e.g., "o0", "o0.o1").
+ *
+ * Face/edge triangle ranges are per-mesh (each part has its own mesh),
+ * identified by the occurrenceRow index in faceRuns.
+ *
+ * @param kernel - the OCCT kernel
+ * @param parts - per-part topology inputs for the assembly
+ * @param opts - optional step hash and CAD path metadata
+ * @returns the merged assembly manifest and its binary buffers
+ */
+export declare function buildAssemblySelectorManifest(kernel: BrepEngineApi, parts: PartTopologyInput[], opts?: SelectorManifestOptions): AssemblyTopologyResult;
+/** 拓扑邻接表：ordinal(1 起) ↔ 邻接 ordinal 列表。 */
+export interface TopologyAdjacency {
+    /** face ordinal(1 起) → 邻接 edge ordinal 列表。 */
+    readonly faceEdgeOrdinals: ReadonlyArray<readonly number[]>;
+    /** edge ordinal(1 起) → 邻接 face ordinal 列表。 */
+    readonly edgeFaceOrdinals: ReadonlyArray<readonly number[]>;
+    /** face ordinal(1 起) → 邻接 vertex ordinal 列表。 */
+    readonly faceVertexOrdinals: ReadonlyArray<readonly number[]>;
+}
+/**
+ * 构建一个 solid 的拓扑邻接表（edge/vertex lineage 解析用，§4.2/§4.4）。
+ *
+ * 与 buildSelectorManifest 同一枚举序（getSubShapes ↔ subShapeHashes ↔
+ * manifest 行序），hash 碰撞按既有办法用 isSame 消解（findOrdinal）。
+ * 每次调用重新枚举（解析是低频路径，不建缓存）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param shape - the solid to query.
+ * @returns the adjacency tables (face→edge, edge→face, face→vertex).
+ */
+export declare function buildTopologyAdjacency(kernel: BrepEngineApi, shape: BrepHandle): TopologyAdjacency;
+export {};
+//# sourceMappingURL=topologyExt.d.ts.map

package/dist/occt-kernel/topologyExt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topologyExt.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/topologyExt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAA6B,MAAM,sBAAsB,CAAA;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AA+E9D,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAOD,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,UAAU,CAAA;IACvB,cAAc,EAAE,cAAc,CAAA;CAC/B;AA4dD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,uBAAuB,EAChC,YAAY,GAAE,MAAa,GAC1B;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAAC,CAAA;CAAE,CAY5F;AA6dD,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,UAAU,CAAA;IACvB,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAAC,CAAA;CACpD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,EAAE,EAC1B,IAAI,GAAE,uBAA4B,GACjC,sBAAsB,CAoRxB;AASD,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IAC3D,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IAC3D,gDAAgD;IAChD,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;CAC9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,UAAU,GAChB,iBAAiB,CA6CnB"}