@faicad/faijs 0.13.0

package/dist/vendored/brepjs/topology/surfaceFns.js

@@ -0,0 +1,178 @@
+/**
+ * Surface creation functions — generate faces from height-map grids.
+ */
+import { getKernel } from '../kernel/index.js';
+import { castResultShape, disposeResultShape, isFace, isShell } from '../core/shapeTypes.js';
+import { ok, err } from '../core/result.js';
+import { validationError, kernelError, ioError, BrepErrorCode } from '../core/errors.js';
+/** Rec. 601 luma coefficients for luminance calculation. */
+const REC601_R = 0.299;
+const REC601_G = 0.587;
+const REC601_B = 0.114;
+/**
+ * Create a B-spline surface (or triangulated shell) from a 2D grid of height values.
+ *
+ * The grid is interpreted as Z heights at evenly spaced (X, Y) positions.
+ * Row index maps to Y, column index maps to X.
+ *
+ * @param heights - 2D array of Z values, at least 2x2
+ * @param options - Physical dimensions and Z scaling
+ * @returns Result containing the surface shape (may be a Face or Shell depending on grid complexity)
+ */
+export function surfaceFromGrid(heights, options = {}) {
+    // ── Validation ──
+    if (heights.length < 2) {
+        return err(validationError(BrepErrorCode.SURFACE_GRID_TOO_SMALL, `surfaceFromGrid: need at least 2 rows, got ${heights.length}`));
+    }
+    const rows = heights.length;
+    const cols = heights[0]?.length ?? 0;
+    if (cols < 2) {
+        return err(validationError(BrepErrorCode.SURFACE_GRID_TOO_SMALL, `surfaceFromGrid: need at least 2 columns, got ${cols}`));
+    }
+    // Check all rows have same length
+    for (let r = 0; r < rows; r++) {
+        const row = heights[r];
+        if (!row || row.length !== cols) {
+            return err(validationError(BrepErrorCode.SURFACE_GRID_JAGGED, `surfaceFromGrid: row ${r} has ${row?.length ?? 0} columns, expected ${cols}`));
+        }
+    }
+    const { width = cols - 1, depth = rows - 1, scaleZ = 1 } = options;
+    const dx = width / (cols - 1);
+    const dy = depth / (rows - 1);
+    // ── Try B-spline approach first ──
+    try {
+        return buildBSplineSurface(heights, rows, cols, dx, dy, scaleZ);
+    }
+    catch {
+        // B-spline types not bound in WASM — fall through to triangulated mesh
+    }
+    // ── Fallback: triangulated mesh ──
+    try {
+        return buildTriangulatedSurface(heights, rows, cols, dx, dy, scaleZ);
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError(BrepErrorCode.SURFACE_FAILED, `surfaceFromGrid failed: ${raw}`, e));
+    }
+}
+/** Build a B-spline surface using GeomAPI_PointsToBSplineSurface. */
+function buildBSplineSurface(heights, rows, cols, dx, dy, scaleZ) {
+    const points = [];
+    for (let r = 0; r < rows; r++) {
+        for (let c = 0; c < cols; c++) {
+            const row = heights[r];
+            const z = (row ? (row[c] ?? 0) : 0) * scaleZ;
+            points.push([c * dx, r * dy, z]);
+        }
+    }
+    const faceShape = getKernel().bsplineSurface(points, rows, cols);
+    const shape = castResultShape(faceShape);
+    if (isFace(shape)) {
+        return ok(shape);
+    }
+    disposeResultShape(shape);
+    return err(kernelError(BrepErrorCode.SURFACE_FAILED, 'B-spline surface did not produce a face'));
+}
+/** Build a triangulated surface by sewing triangular faces. */
+function buildTriangulatedSurface(heights, rows, cols, dx, dy, scaleZ) {
+    const points = [];
+    for (let r = 0; r < rows; r++) {
+        for (let c = 0; c < cols; c++) {
+            const row = heights[r];
+            const z = (row ? (row[c] ?? 0) : 0) * scaleZ;
+            points.push([c * dx, r * dy, z]);
+        }
+    }
+    const resultShape = getKernel().triangulatedSurface(points, rows, cols);
+    const shape = castResultShape(resultShape);
+    if (isFace(shape)) {
+        return ok(shape);
+    }
+    if (isShell(shape)) {
+        return ok(shape);
+    }
+    disposeResultShape(shape);
+    return err(kernelError(BrepErrorCode.SURFACE_FAILED, 'surfaceFromGrid: unexpected shape type from sewing'));
+}
+/**
+ * Create a surface from an image blob by interpreting pixel brightness as height.
+ * Requires `createImageBitmap` and `OffscreenCanvas` (available in browsers and
+ * some worker environments; not available in Node.js).
+ *
+ * @param blob - Image data as a Blob
+ * @param options - Channel selection, downsampling, and grid options
+ * @returns A Result containing the surface shape
+ */
+export async function surfaceFromImage(blob, options = {}) {
+    const channel = options.channel ?? 'luminance';
+    const downsample = Math.max(1, Math.round(options.downsample ?? 1));
+    // Check for browser APIs
+    if (typeof createImageBitmap !== 'function') {
+        return err(ioError(BrepErrorCode.SURFACE_FAILED, 'surfaceFromImage requires createImageBitmap (not available in this environment)'));
+    }
+    let bitmap;
+    try {
+        bitmap = await createImageBitmap(blob);
+    }
+    catch (e) {
+        return err(ioError(BrepErrorCode.SURFACE_FAILED, `surfaceFromImage: failed to decode image — ${e instanceof Error ? e.message : String(e)}`));
+    }
+    const w = bitmap.width;
+    const h = bitmap.height;
+    if (w < 2 || h < 2) {
+        bitmap.close();
+        return err(validationError(BrepErrorCode.SURFACE_GRID_TOO_SMALL, `surfaceFromImage: image too small (${w}x${h}), need at least 2x2`));
+    }
+    // Use OffscreenCanvas to read pixel data
+    if (typeof OffscreenCanvas !== 'function') {
+        bitmap.close();
+        return err(ioError(BrepErrorCode.SURFACE_FAILED, 'surfaceFromImage requires OffscreenCanvas (not available in this environment)'));
+    }
+    const canvas = new OffscreenCanvas(w, h);
+    const ctx = canvas.getContext('2d');
+    if (!ctx) {
+        bitmap.close();
+        return err(ioError(BrepErrorCode.SURFACE_FAILED, 'surfaceFromImage: could not get 2D canvas context'));
+    }
+    ctx.drawImage(bitmap, 0, 0);
+    bitmap.close();
+    const imageData = ctx.getImageData(0, 0, w, h);
+    const data = imageData.data;
+    // Build height grid
+    const rows = [];
+    for (let y = 0; y < h; y += downsample) {
+        const row = [];
+        for (let x = 0; x < w; x += downsample) {
+            const idx = (y * w + x) * 4;
+            const r = data[idx] ?? 0;
+            const g = data[idx + 1] ?? 0;
+            const b = data[idx + 2] ?? 0;
+            let value;
+            switch (channel) {
+                case 'r':
+                    value = r / 255;
+                    break;
+                case 'g':
+                    value = g / 255;
+                    break;
+                case 'b':
+                    value = b / 255;
+                    break;
+                default:
+                    value = (REC601_R * r + REC601_G * g + REC601_B * b) / 255;
+                    break;
+            }
+            row.push(value);
+        }
+        rows.push(row);
+    }
+    const gridOpts = {};
+    if (options.width !== undefined)
+        gridOpts.width = options.width;
+    if (options.depth !== undefined)
+        gridOpts.depth = options.depth;
+    if (options.scaleZ !== undefined)
+        gridOpts.scaleZ = options.scaleZ;
+    return surfaceFromGrid(rows, gridOpts);
+}
+//# sourceMappingURL=surfaceFns.js.map

package/dist/vendored/brepjs/topology/surfaceFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceFns.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/topology/surfaceFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Surface creation functions — generate faces from height-map grids.\n */\n\nimport { getKernel } from '../kernel/index.js';\nimport type { AnyShape } from '../core/shapeTypes.js';\nimport { castResultShape, disposeResultShape, isFace, isShell } from '../core/shapeTypes.js';\nimport { type Result, ok, err } from '../core/result.js';\nimport { validationError, kernelError, ioError, BrepErrorCode } from '../core/errors.js';\n\n/** Rec. 601 luma coefficients for luminance calculation. */\nconst REC601_R = 0.299;\nconst REC601_G = 0.587;\nconst REC601_B = 0.114;\n\nexport interface SurfaceFromGridOptions {\n  /** Physical width in X direction. Default: number of columns - 1. */\n  width?: number;\n  /** Physical depth in Y direction. Default: number of rows - 1. */\n  depth?: number;\n  /** Scale factor for Z values. Default: 1. */\n  scaleZ?: number;\n}\n\n/**\n * Create a B-spline surface (or triangulated shell) from a 2D grid of height values.\n *\n * The grid is interpreted as Z heights at evenly spaced (X, Y) positions.\n * Row index maps to Y, column index maps to X.\n *\n * @param heights - 2D array of Z values, at least 2x2\n * @param options - Physical dimensions and Z scaling\n * @returns Result containing the surface shape (may be a Face or Shell depending on grid complexity)\n */\nexport function surfaceFromGrid(\n  heights: ReadonlyArray<ReadonlyArray<number>>,\n  options: SurfaceFromGridOptions = {}\n): Result<AnyShape> {\n  // ── Validation ──\n  if (heights.length < 2) {\n    return err(\n      validationError(\n        BrepErrorCode.SURFACE_GRID_TOO_SMALL,\n        `surfaceFromGrid: need at least 2 rows, got ${heights.length}`\n      )\n    );\n  }\n\n  const rows = heights.length;\n  const cols = heights[0]?.length ?? 0;\n\n  if (cols < 2) {\n    return err(\n      validationError(\n        BrepErrorCode.SURFACE_GRID_TOO_SMALL,\n        `surfaceFromGrid: need at least 2 columns, got ${cols}`\n      )\n    );\n  }\n\n  // Check all rows have same length\n  for (let r = 0; r < rows; r++) {\n    const row = heights[r];\n    if (!row || row.length !== cols) {\n      return err(\n        validationError(\n          BrepErrorCode.SURFACE_GRID_JAGGED,\n          `surfaceFromGrid: row ${r} has ${row?.length ?? 0} columns, expected ${cols}`\n        )\n      );\n    }\n  }\n\n  const { width = cols - 1, depth = rows - 1, scaleZ = 1 } = options;\n  const dx = width / (cols - 1);\n  const dy = depth / (rows - 1);\n\n  // ── Try B-spline approach first ──\n  try {\n    return buildBSplineSurface(heights, rows, cols, dx, dy, scaleZ);\n  } catch {\n    // B-spline types not bound in WASM — fall through to triangulated mesh\n  }\n\n  // ── Fallback: triangulated mesh ──\n  try {\n    return buildTriangulatedSurface(heights, rows, cols, dx, dy, scaleZ);\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e);\n    return err(kernelError(BrepErrorCode.SURFACE_FAILED, `surfaceFromGrid failed: ${raw}`, e));\n  }\n}\n\n/** Build a B-spline surface using GeomAPI_PointsToBSplineSurface. */\nfunction buildBSplineSurface(\n  heights: ReadonlyArray<ReadonlyArray<number>>,\n  rows: number,\n  cols: number,\n  dx: number,\n  dy: number,\n  scaleZ: number\n): Result<AnyShape> {\n  const points: [number, number, number][] = [];\n  for (let r = 0; r < rows; r++) {\n    for (let c = 0; c < cols; c++) {\n      const row = heights[r];\n      const z = (row ? (row[c] ?? 0) : 0) * scaleZ;\n      points.push([c * dx, r * dy, z]);\n    }\n  }\n\n  const faceShape = getKernel().bsplineSurface(points, rows, cols);\n  const shape = castResultShape(faceShape);\n  if (isFace(shape)) {\n    return ok(shape);\n  }\n  disposeResultShape(shape);\n  return err(kernelError(BrepErrorCode.SURFACE_FAILED, 'B-spline surface did not produce a face'));\n}\n\n/** Build a triangulated surface by sewing triangular faces. */\nfunction buildTriangulatedSurface(\n  heights: ReadonlyArray<ReadonlyArray<number>>,\n  rows: number,\n  cols: number,\n  dx: number,\n  dy: number,\n  scaleZ: number\n): Result<AnyShape> {\n  const points: [number, number, number][] = [];\n  for (let r = 0; r < rows; r++) {\n    for (let c = 0; c < cols; c++) {\n      const row = heights[r];\n      const z = (row ? (row[c] ?? 0) : 0) * scaleZ;\n      points.push([c * dx, r * dy, z]);\n    }\n  }\n\n  const resultShape = getKernel().triangulatedSurface(points, rows, cols);\n  const shape = castResultShape(resultShape);\n\n  if (isFace(shape)) {\n    return ok(shape);\n  }\n\n  if (isShell(shape)) {\n    return ok(shape);\n  }\n\n  disposeResultShape(shape);\n  return err(\n    kernelError(BrepErrorCode.SURFACE_FAILED, 'surfaceFromGrid: unexpected shape type from sewing')\n  );\n}\n\n// ---------------------------------------------------------------------------\n// surfaceFromImage\n// ---------------------------------------------------------------------------\n\nexport interface SurfaceFromImageOptions extends SurfaceFromGridOptions {\n  /** Which channel to use for height. Default: 'luminance'. */\n  channel?: 'r' | 'g' | 'b' | 'luminance';\n  /** Downsample factor — use every Nth pixel. Default: 1 (no downsampling). */\n  downsample?: number;\n}\n\n/**\n * Create a surface from an image blob by interpreting pixel brightness as height.\n * Requires `createImageBitmap` and `OffscreenCanvas` (available in browsers and\n * some worker environments; not available in Node.js).\n *\n * @param blob - Image data as a Blob\n * @param options - Channel selection, downsampling, and grid options\n * @returns A Result containing the surface shape\n */\nexport async function surfaceFromImage(\n  blob: Blob,\n  options: SurfaceFromImageOptions = {}\n): Promise<Result<AnyShape>> {\n  const channel = options.channel ?? 'luminance';\n  const downsample = Math.max(1, Math.round(options.downsample ?? 1));\n\n  // Check for browser APIs\n  if (typeof createImageBitmap !== 'function') {\n    return err(\n      ioError(\n        BrepErrorCode.SURFACE_FAILED,\n        'surfaceFromImage requires createImageBitmap (not available in this environment)'\n      )\n    );\n  }\n\n  let bitmap: ImageBitmap;\n  try {\n    bitmap = await createImageBitmap(blob);\n  } catch (e) {\n    return err(\n      ioError(\n        BrepErrorCode.SURFACE_FAILED,\n        `surfaceFromImage: failed to decode image — ${e instanceof Error ? e.message : String(e)}`\n      )\n    );\n  }\n\n  const w = bitmap.width;\n  const h = bitmap.height;\n\n  if (w < 2 || h < 2) {\n    bitmap.close();\n    return err(\n      validationError(\n        BrepErrorCode.SURFACE_GRID_TOO_SMALL,\n        `surfaceFromImage: image too small (${w}x${h}), need at least 2x2`\n      )\n    );\n  }\n\n  // Use OffscreenCanvas to read pixel data\n  if (typeof OffscreenCanvas !== 'function') {\n    bitmap.close();\n    return err(\n      ioError(\n        BrepErrorCode.SURFACE_FAILED,\n        'surfaceFromImage requires OffscreenCanvas (not available in this environment)'\n      )\n    );\n  }\n\n  const canvas = new OffscreenCanvas(w, h);\n  const ctx = canvas.getContext('2d');\n  if (!ctx) {\n    bitmap.close();\n    return err(\n      ioError(BrepErrorCode.SURFACE_FAILED, 'surfaceFromImage: could not get 2D canvas context')\n    );\n  }\n\n  ctx.drawImage(bitmap, 0, 0);\n  bitmap.close();\n\n  const imageData = ctx.getImageData(0, 0, w, h);\n  const data = imageData.data;\n\n  // Build height grid\n  const rows: number[][] = [];\n  for (let y = 0; y < h; y += downsample) {\n    const row: number[] = [];\n    for (let x = 0; x < w; x += downsample) {\n      const idx = (y * w + x) * 4;\n      const r = data[idx] ?? 0;\n      const g = data[idx + 1] ?? 0;\n      const b = data[idx + 2] ?? 0;\n\n      let value: number;\n      switch (channel) {\n        case 'r':\n          value = r / 255;\n          break;\n        case 'g':\n          value = g / 255;\n          break;\n        case 'b':\n          value = b / 255;\n          break;\n        default:\n          value = (REC601_R * r + REC601_G * g + REC601_B * b) / 255;\n          break;\n      }\n      row.push(value);\n    }\n    rows.push(row);\n  }\n\n  const gridOpts: SurfaceFromGridOptions = {};\n  if (options.width !== undefined) gridOpts.width = options.width;\n  if (options.depth !== undefined) gridOpts.depth = options.depth;\n  if (options.scaleZ !== undefined) gridOpts.scaleZ = options.scaleZ;\n\n  return surfaceFromGrid(rows, gridOpts);\n}\n"]}

package/dist/vendored/brepjs/topology/threeHelpers.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Three.js integration helpers.
+ *
+ * Converts brepjs mesh data into typed arrays suitable for
+ * THREE.BufferGeometry.setAttribute(). No three.js dependency required.
+ */
+import type { ShapeMesh, EdgeMesh, MultiLODMesh, LODMesh } from './meshFns.js';
+/** Data ready to be used with THREE.BufferGeometry. */
+export interface BufferGeometryData {
+    /** Flat float array of vertex positions (x,y,z interleaved). */
+    position: Float32Array;
+    /** Flat float array of vertex normals (x,y,z interleaved). */
+    normal: Float32Array;
+    /** Triangle index array (3 indices per triangle). */
+    index: Uint32Array;
+}
+/** Line segment data ready for THREE.LineSegments or THREE.Line. */
+export interface LineGeometryData {
+    /** Flat float array of line vertex positions (x,y,z interleaved). */
+    position: Float32Array;
+}
+/**
+ * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.
+ *
+ * The returned arrays can be used directly with Three.js:
+ * ```ts
+ * const geo = new THREE.BufferGeometry();
+ * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));
+ * geo.setAttribute('normal', new THREE.BufferAttribute(data.normal, 3));
+ * geo.setIndex(new THREE.BufferAttribute(data.index, 1));
+ * ```
+ */
+export declare function toBufferGeometryData(mesh: ShapeMesh): BufferGeometryData;
+/** A material group entry compatible with THREE.BufferGeometry.addGroup(). */
+export interface BufferGeometryGroup {
+    /** Start index in the triangle index buffer. */
+    readonly start: number;
+    /** Number of indices in this group. */
+    readonly count: number;
+    /** Sequential material index (0-based). */
+    readonly materialIndex: number;
+    /** Face topology ID for correlation with the shape's face. */
+    readonly faceId: number;
+}
+/** BufferGeometry data with per-face material groups. */
+export interface GroupedBufferGeometryData extends BufferGeometryData {
+    /** Face groups for use with THREE.BufferGeometry.addGroup(). */
+    readonly groups: ReadonlyArray<BufferGeometryGroup>;
+}
+/**
+ * Convert a ShapeMesh into grouped BufferGeometry data with face material groups.
+ *
+ * Each face becomes a separate group, allowing per-face materials in Three.js:
+ * ```ts
+ * const data = toGroupedBufferGeometryData(mesh);
+ * const geo = new THREE.BufferGeometry();
+ * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));
+ * geo.setAttribute('normal', new THREE.BufferAttribute(data.normal, 3));
+ * geo.setIndex(new THREE.BufferAttribute(data.index, 1));
+ * for (const g of data.groups) {
+ *   geo.addGroup(g.start, g.count, g.materialIndex);
+ * }
+ * ```
+ */
+export declare function toGroupedBufferGeometryData(mesh: ShapeMesh): GroupedBufferGeometryData;
+/**
+ * Convert an EdgeMesh into position data for THREE.LineSegments.
+ *
+ * ```ts
+ * const geo = new THREE.BufferGeometry();
+ * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));
+ * const lines = new THREE.LineSegments(geo, material);
+ * ```
+ */
+export declare function toLineGeometryData(mesh: EdgeMesh): LineGeometryData;
+/** LOD-ready geometry data for Three.js LOD class. */
+export interface LODGeometryData {
+    readonly coarse: BufferGeometryData;
+    readonly fine: BufferGeometryData;
+    /** Camera distance at which to switch to coarse geometry. */
+    readonly coarseDistance: number;
+    /** Camera distance at which to show fine geometry (typically 0). */
+    readonly fineDistance: number;
+}
+/**
+ * Convert a multi-LOD mesh into Three.js LOD-compatible geometry data.
+ *
+ * @example
+ * ```ts
+ * const lod = new THREE.LOD();
+ * const data = toLODGeometryData(meshMultiLOD(shape));
+ * lod.addLevel(new THREE.Mesh(toBufferGeometry(data.fine), mat), data.fineDistance);
+ * lod.addLevel(new THREE.Mesh(toBufferGeometry(data.coarse), mat), data.coarseDistance);
+ * ```
+ */
+export declare function toLODGeometryData(multiLOD: MultiLODMesh, distances?: {
+    readonly coarse?: number | undefined;
+    readonly fine?: number | undefined;
+}): LODGeometryData;
+/** One LOD level of THREE.LOD-ready geometry: geometry plus its switch distance. */
+export interface LODGeometryLevel {
+    /** Geometry for this level. */
+    readonly geometry: BufferGeometryData;
+    /** Camera distance at which THREE.LOD switches to this level (finest = 0). */
+    readonly distance: number;
+}
+/**
+ * Convert N LOD meshes (from `meshLODs`, coarse → fine) into THREE.LOD level
+ * data. The finest level gets distance 0 and each coarser level steps out by
+ * `step`; pass `distances` (indexed coarse → fine) to set them explicitly.
+ *
+ * @example
+ * ```ts
+ * const lod = new THREE.LOD();
+ * for (const { geometry, distance } of toLODGeometryLevels(meshLODs(shape))) {
+ *   lod.addLevel(new THREE.Mesh(toBufferGeometry(geometry), mat), distance);
+ * }
+ * ```
+ */
+export declare function toLODGeometryLevels(lods: ReadonlyArray<LODMesh>, options?: {
+    readonly distances?: readonly number[];
+    readonly step?: number;
+}): LODGeometryLevel[];
+//# sourceMappingURL=threeHelpers.d.ts.map

package/dist/vendored/brepjs/topology/threeHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threeHelpers.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/topology/threeHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM/E,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,QAAQ,EAAE,YAAY,CAAC;IACvB,8DAA8D;IAC9D,MAAM,EAAE,YAAY,CAAC;IACrB,qDAAqD;IACrD,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,QAAQ,EAAE,YAAY,CAAC;CACxB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAMxE;AAMD,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CACrD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,GAAG,yBAAyB,CAYtF;AAMD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAInE;AAMD,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvF,eAAe,CAOjB;AAED,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E,gBAAgB,EAAE,CAcpB"}

package/dist/vendored/brepjs/topology/threeHelpers.js

@@ -0,0 +1,118 @@
+/**
+ * Three.js integration helpers.
+ *
+ * Converts brepjs mesh data into typed arrays suitable for
+ * THREE.BufferGeometry.setAttribute(). No three.js dependency required.
+ */
+// ---------------------------------------------------------------------------
+// Conversion functions
+// ---------------------------------------------------------------------------
+/**
+ * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.
+ *
+ * The returned arrays can be used directly with Three.js:
+ * ```ts
+ * const geo = new THREE.BufferGeometry();
+ * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));
+ * geo.setAttribute('normal', new THREE.BufferAttribute(data.normal, 3));
+ * geo.setIndex(new THREE.BufferAttribute(data.index, 1));
+ * ```
+ */
+export function toBufferGeometryData(mesh) {
+    return {
+        position: mesh.vertices,
+        normal: mesh.normals,
+        index: mesh.triangles,
+    };
+}
+/**
+ * Convert a ShapeMesh into grouped BufferGeometry data with face material groups.
+ *
+ * Each face becomes a separate group, allowing per-face materials in Three.js:
+ * ```ts
+ * const data = toGroupedBufferGeometryData(mesh);
+ * const geo = new THREE.BufferGeometry();
+ * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));
+ * geo.setAttribute('normal', new THREE.BufferAttribute(data.normal, 3));
+ * geo.setIndex(new THREE.BufferAttribute(data.index, 1));
+ * for (const g of data.groups) {
+ *   geo.addGroup(g.start, g.count, g.materialIndex);
+ * }
+ * ```
+ */
+export function toGroupedBufferGeometryData(mesh) {
+    return {
+        position: mesh.vertices,
+        normal: mesh.normals,
+        index: mesh.triangles,
+        groups: mesh.faceGroups.map((g, i) => ({
+            start: g.start,
+            count: g.count,
+            materialIndex: i,
+            faceId: g.faceId,
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// Edge mesh conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert an EdgeMesh into position data for THREE.LineSegments.
+ *
+ * ```ts
+ * const geo = new THREE.BufferGeometry();
+ * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));
+ * const lines = new THREE.LineSegments(geo, material);
+ * ```
+ */
+export function toLineGeometryData(mesh) {
+    return {
+        position: mesh.lines,
+    };
+}
+/**
+ * Convert a multi-LOD mesh into Three.js LOD-compatible geometry data.
+ *
+ * @example
+ * ```ts
+ * const lod = new THREE.LOD();
+ * const data = toLODGeometryData(meshMultiLOD(shape));
+ * lod.addLevel(new THREE.Mesh(toBufferGeometry(data.fine), mat), data.fineDistance);
+ * lod.addLevel(new THREE.Mesh(toBufferGeometry(data.coarse), mat), data.coarseDistance);
+ * ```
+ */
+export function toLODGeometryData(multiLOD, distances) {
+    return {
+        coarse: toBufferGeometryData(multiLOD.coarse),
+        fine: toBufferGeometryData(multiLOD.fine),
+        coarseDistance: distances?.coarse ?? 50,
+        fineDistance: distances?.fine ?? 0,
+    };
+}
+/**
+ * Convert N LOD meshes (from `meshLODs`, coarse → fine) into THREE.LOD level
+ * data. The finest level gets distance 0 and each coarser level steps out by
+ * `step`; pass `distances` (indexed coarse → fine) to set them explicitly.
+ *
+ * @example
+ * ```ts
+ * const lod = new THREE.LOD();
+ * for (const { geometry, distance } of toLODGeometryLevels(meshLODs(shape))) {
+ *   lod.addLevel(new THREE.Mesh(toBufferGeometry(geometry), mat), distance);
+ * }
+ * ```
+ */
+export function toLODGeometryLevels(lods, options) {
+    const step = options?.step ?? 50;
+    const distances = options?.distances;
+    if (distances && distances.length !== lods.length) {
+        throw new Error(`toLODGeometryLevels: distances must have one entry per level (got ${distances.length} for ${lods.length} levels)`);
+    }
+    const last = lods.length - 1;
+    return lods.map((lod, idx) => ({
+        geometry: toBufferGeometryData(lod.mesh),
+        // lods are coarse → fine; finest (last) sits at distance 0, coarser further out.
+        distance: distances?.[idx] ?? (last - idx) * step,
+    }));
+}
+//# sourceMappingURL=threeHelpers.js.map

package/dist/vendored/brepjs/topology/threeHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threeHelpers.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/topology/threeHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,OAAO;QACpB,KAAK,EAAE,IAAI,CAAC,SAAS;KACtB,CAAC;AACJ,CAAC;AAwBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAe;IACzD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,OAAO;QACpB,KAAK,EAAE,IAAI,CAAC,SAAS;QACrB,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,KAAK;KACrB,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAsB,EACtB,SAAwF;IAExF,OAAO;QACL,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC7C,IAAI,EAAE,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC;QACzC,cAAc,EAAE,SAAS,EAAE,MAAM,IAAI,EAAE;QACvC,YAAY,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAUD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA4B,EAC5B,OAA4E;IAE5E,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACrC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,qEAAqE,SAAS,CAAC,MAAM,QAAQ,IAAI,CAAC,MAAM,UAAU,CACnH,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7B,QAAQ,EAAE,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC;QACxC,iFAAiF;QACjF,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI;KAClD,CAAC,CAAC,CAAC;AACN,CAAC","sourcesContent":["/**\n * Three.js integration helpers.\n *\n * Converts brepjs mesh data into typed arrays suitable for\n * THREE.BufferGeometry.setAttribute(). No three.js dependency required.\n */\n\nimport type { ShapeMesh, EdgeMesh, MultiLODMesh, LODMesh } from './meshFns.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Data ready to be used with THREE.BufferGeometry. */\nexport interface BufferGeometryData {\n  /** Flat float array of vertex positions (x,y,z interleaved). */\n  position: Float32Array;\n  /** Flat float array of vertex normals (x,y,z interleaved). */\n  normal: Float32Array;\n  /** Triangle index array (3 indices per triangle). */\n  index: Uint32Array;\n}\n\n/** Line segment data ready for THREE.LineSegments or THREE.Line. */\nexport interface LineGeometryData {\n  /** Flat float array of line vertex positions (x,y,z interleaved). */\n  position: Float32Array;\n}\n\n// ---------------------------------------------------------------------------\n// Conversion functions\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.\n *\n * The returned arrays can be used directly with Three.js:\n * ```ts\n * const geo = new THREE.BufferGeometry();\n * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));\n * geo.setAttribute('normal', new THREE.BufferAttribute(data.normal, 3));\n * geo.setIndex(new THREE.BufferAttribute(data.index, 1));\n * ```\n */\nexport function toBufferGeometryData(mesh: ShapeMesh): BufferGeometryData {\n  return {\n    position: mesh.vertices,\n    normal: mesh.normals,\n    index: mesh.triangles,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Grouped buffer geometry (with face groups for multi-material support)\n// ---------------------------------------------------------------------------\n\n/** A material group entry compatible with THREE.BufferGeometry.addGroup(). */\nexport interface BufferGeometryGroup {\n  /** Start index in the triangle index buffer. */\n  readonly start: number;\n  /** Number of indices in this group. */\n  readonly count: number;\n  /** Sequential material index (0-based). */\n  readonly materialIndex: number;\n  /** Face topology ID for correlation with the shape's face. */\n  readonly faceId: number;\n}\n\n/** BufferGeometry data with per-face material groups. */\nexport interface GroupedBufferGeometryData extends BufferGeometryData {\n  /** Face groups for use with THREE.BufferGeometry.addGroup(). */\n  readonly groups: ReadonlyArray<BufferGeometryGroup>;\n}\n\n/**\n * Convert a ShapeMesh into grouped BufferGeometry data with face material groups.\n *\n * Each face becomes a separate group, allowing per-face materials in Three.js:\n * ```ts\n * const data = toGroupedBufferGeometryData(mesh);\n * const geo = new THREE.BufferGeometry();\n * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));\n * geo.setAttribute('normal', new THREE.BufferAttribute(data.normal, 3));\n * geo.setIndex(new THREE.BufferAttribute(data.index, 1));\n * for (const g of data.groups) {\n *   geo.addGroup(g.start, g.count, g.materialIndex);\n * }\n * ```\n */\nexport function toGroupedBufferGeometryData(mesh: ShapeMesh): GroupedBufferGeometryData {\n  return {\n    position: mesh.vertices,\n    normal: mesh.normals,\n    index: mesh.triangles,\n    groups: mesh.faceGroups.map((g, i) => ({\n      start: g.start,\n      count: g.count,\n      materialIndex: i,\n      faceId: g.faceId,\n    })),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Edge mesh conversion\n// ---------------------------------------------------------------------------\n\n/**\n * Convert an EdgeMesh into position data for THREE.LineSegments.\n *\n * ```ts\n * const geo = new THREE.BufferGeometry();\n * geo.setAttribute('position', new THREE.BufferAttribute(data.position, 3));\n * const lines = new THREE.LineSegments(geo, material);\n * ```\n */\nexport function toLineGeometryData(mesh: EdgeMesh): LineGeometryData {\n  return {\n    position: mesh.lines,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// LOD geometry\n// ---------------------------------------------------------------------------\n\n/** LOD-ready geometry data for Three.js LOD class. */\nexport interface LODGeometryData {\n  readonly coarse: BufferGeometryData;\n  readonly fine: BufferGeometryData;\n  /** Camera distance at which to switch to coarse geometry. */\n  readonly coarseDistance: number;\n  /** Camera distance at which to show fine geometry (typically 0). */\n  readonly fineDistance: number;\n}\n\n/**\n * Convert a multi-LOD mesh into Three.js LOD-compatible geometry data.\n *\n * @example\n * ```ts\n * const lod = new THREE.LOD();\n * const data = toLODGeometryData(meshMultiLOD(shape));\n * lod.addLevel(new THREE.Mesh(toBufferGeometry(data.fine), mat), data.fineDistance);\n * lod.addLevel(new THREE.Mesh(toBufferGeometry(data.coarse), mat), data.coarseDistance);\n * ```\n */\nexport function toLODGeometryData(\n  multiLOD: MultiLODMesh,\n  distances?: { readonly coarse?: number | undefined; readonly fine?: number | undefined }\n): LODGeometryData {\n  return {\n    coarse: toBufferGeometryData(multiLOD.coarse),\n    fine: toBufferGeometryData(multiLOD.fine),\n    coarseDistance: distances?.coarse ?? 50,\n    fineDistance: distances?.fine ?? 0,\n  };\n}\n\n/** One LOD level of THREE.LOD-ready geometry: geometry plus its switch distance. */\nexport interface LODGeometryLevel {\n  /** Geometry for this level. */\n  readonly geometry: BufferGeometryData;\n  /** Camera distance at which THREE.LOD switches to this level (finest = 0). */\n  readonly distance: number;\n}\n\n/**\n * Convert N LOD meshes (from `meshLODs`, coarse → fine) into THREE.LOD level\n * data. The finest level gets distance 0 and each coarser level steps out by\n * `step`; pass `distances` (indexed coarse → fine) to set them explicitly.\n *\n * @example\n * ```ts\n * const lod = new THREE.LOD();\n * for (const { geometry, distance } of toLODGeometryLevels(meshLODs(shape))) {\n *   lod.addLevel(new THREE.Mesh(toBufferGeometry(geometry), mat), distance);\n * }\n * ```\n */\nexport function toLODGeometryLevels(\n  lods: ReadonlyArray<LODMesh>,\n  options?: { readonly distances?: readonly number[]; readonly step?: number }\n): LODGeometryLevel[] {\n  const step = options?.step ?? 50;\n  const distances = options?.distances;\n  if (distances && distances.length !== lods.length) {\n    throw new Error(\n      `toLODGeometryLevels: distances must have one entry per level (got ${distances.length} for ${lods.length} levels)`\n    );\n  }\n  const last = lods.length - 1;\n  return lods.map((lod, idx) => ({\n    geometry: toBufferGeometryData(lod.mesh),\n    // lods are coarse → fine; finest (last) sits at distance 0, coarser further out.\n    distance: distances?.[idx] ?? (last - idx) * step,\n  }));\n}\n"]}

package/dist/vendored/brepjs/topology/topologyQueryFns.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Topology query functions — extract sub-shapes, compute bounds, and
+ * describe shape topology. All results are lazily cached per shape.
+ */
+import type { ShapeType, SurfaceType } from '../kernel/types.js';
+import type { AnyShape, Dimension, Edge, Face, Wire, Vertex, Shell, Solid, CompSolid, ShapeKind } from '../core/shapeTypes.js';
+import type { Vec3 } from '../core/types.js';
+/**
+ * Count sub-shapes of a type without materialising (and disposing) a handle per
+ * sub-shape. Uses the kernel's native `subShapeCount` when available (occt-wasm
+ * >= 3.7.0); otherwise iterates and releases. Prefer this over
+ * `getFaces(shape).length` when only the count is needed and the handles aren't
+ * — it neither allocates nor warms the topology cache.
+ */
+export declare function subShapeCount(shape: AnyShape<Dimension>, type: ShapeType): number;
+/**
+ * Deduplicated hashes of a shape's sub-shapes, keyed the same as
+ * {@link getKernel}'s `hashCode(_, HASH_CODE_MAX)`. Uses the native
+ * `subShapeHashes` when available (occt-wasm >= 3.7.0); otherwise iterates,
+ * hashes, and releases. For hash-only paths (origin/tag maps) that would
+ * otherwise allocate a handle per sub-shape just to hash it.
+ */
+export declare function subShapeHashes(shape: AnyShape<Dimension>, type: ShapeType): number[];
+/**
+ * Invalidate cached topology data for a shape, releasing its cached sub-shape
+ * handles. Call this after operations that modify a shape in-place (e.g.,
+ * unifyFaces).
+ */
+export declare function invalidateShapeCache(shape: AnyShape<Dimension>): void;
+/** Get all edges of a shape as branded Edge handles. Results are cached per shape. */
+export declare function getEdges<D extends Dimension>(shape: AnyShape<D>): Edge<D>[];
+/**
+ * Get all faces of a shape. Results are cached per shape.
+ *
+ * Returns `Face[]` — use `isOrientedFace()` or `orientedFace()` to narrow
+ * individual faces to `OrientedFace` when the orientation guarantee is needed.
+ */
+export declare function getFaces<D extends Dimension>(shape: AnyShape<D>): Face<D>[];
+/** Get all wires of a shape as branded Wire handles. Results are cached per shape. */
+export declare function getWires<D extends Dimension>(shape: AnyShape<D>): Wire<D>[];
+/** Get all vertices of a shape as branded Vertex handles. Results are cached per shape. */
+export declare function getVertices<D extends Dimension>(shape: AnyShape<D>): Vertex<D>[];
+/**
+ * Get all solids of a shape as branded Solid handles. Results are cached per shape.
+ *
+ * Booleans (`cut`/`fuse`/`fuseAll`), `chamfer`/`fillet`, and some sweeps return a
+ * `Compound` wrapping the solid(s); use this to unwrap them without reaching into
+ * the kernel. Returns `[]` for shapes with no solids (wires, bare faces, shells).
+ */
+export declare function getSolids(shape: AnyShape<Dimension>): Solid[];
+/** Get all shells of a shape as branded Shell handles. Results are cached per shape. */
+export declare function getShells(shape: AnyShape<Dimension>): Shell[];
+/** Get all compsolids of a shape as branded CompSolid handles. Results are cached per shape. */
+export declare function getCompSolids(shape: AnyShape<Dimension>): CompSolid[];
+/** Lazily iterate edges of a shape, yielding branded Edge handles one at a time. */
+export declare function iterEdges<D extends Dimension>(shape: AnyShape<D>): Generator<Edge<D>>;
+/** Lazily iterate faces of a shape, yielding branded Face handles one at a time. */
+export declare function iterFaces<D extends Dimension>(shape: AnyShape<D>): Generator<Face<D>>;
+/** Lazily iterate wires of a shape, yielding branded Wire handles one at a time. */
+export declare function iterWires<D extends Dimension>(shape: AnyShape<D>): Generator<Wire<D>>;
+/** Lazily iterate vertices of a shape, yielding branded Vertex handles one at a time. */
+export declare function iterVertices<D extends Dimension>(shape: AnyShape<D>): Generator<Vertex<D>>;
+/** Lazily iterate solids of a shape, yielding branded Solid handles one at a time. */
+export declare function iterSolids(shape: AnyShape<Dimension>): Generator<Solid>;
+/** Lazily iterate shells of a shape, yielding branded Shell handles one at a time. */
+export declare function iterShells(shape: AnyShape<Dimension>): Generator<Shell>;
+/** Lazily iterate compsolids of a shape, yielding branded CompSolid handles one at a time. */
+export declare function iterCompSolids(shape: AnyShape<Dimension>): Generator<CompSolid>;
+/** Bounding box as a plain object. */
+export interface Bounds3D {
+    readonly xMin: number;
+    readonly xMax: number;
+    readonly yMin: number;
+    readonly yMax: number;
+    readonly zMin: number;
+    readonly zMax: number;
+}
+/** Get the axis-aligned bounding box of a shape. Cached per shape. */
+export declare function getBounds(shape: AnyShape<Dimension>): Bounds3D;
+/** Get the topological kind of a shape. Cached per shape via shapeTypeCache. */
+export declare function getCachedShapeKind(shape: AnyShape<Dimension>): ShapeKind;
+/** Get the kernel surface type of a face. Cached per face (shapes are immutable). */
+export declare function getCachedSurfaceType(face: Face<Dimension>): SurfaceType;
+/** Get whether a shape is valid. Cached per shape (shapes are immutable). */
+export declare function getCachedIsValid(shape: AnyShape<Dimension>): boolean;
+/** A summary of a shape's topology, geometry, and validity. */
+export interface ShapeDescription {
+    readonly kind: ShapeKind;
+    readonly faceCount: number;
+    readonly edgeCount: number;
+    readonly wireCount: number;
+    readonly vertexCount: number;
+    readonly valid: boolean;
+    readonly bounds: Bounds3D;
+}
+/** Get a quick summary of a shape for debugging and inspection. */
+export declare function describe(shape: AnyShape<Dimension>): ShapeDescription;
+/** Get the position of a vertex as a Vec3 tuple. */
+export declare function vertexPosition(vertex: Vertex): Vec3;
+//# sourceMappingURL=topologyQueryFns.d.ts.map

package/dist/vendored/brepjs/topology/topologyQueryFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topologyQueryFns.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/topology/topologyQueryFns.ts"],"names":[],"mappings":"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"}