@ifc-lite/wasm 1.2.1 → 1.5.0

package/package.json

@@ -5,7 +5,7 @@
     "IFC-Lite Contributors"
   ],
   "description": "WebAssembly bindings for IFC-Lite",
-  "version": "1.2.1",
+  "version": "1.5.0",
   "license": "MPL-2.0",
   "repository": {
     "type": "git",

package/pkg/ifc-lite.d.ts

@@ -54,6 +54,10 @@ export class GeoReferenceJs {
 export class GpuGeometry {
   free(): void;
   [Symbol.dispose](): void;
+  /**
+   * Set the RTC (Relative To Center) offset applied to coordinates
+   */
+  set_rtc_offset(x: number, y: number, z: number): void;
   /**
    * Get IFC type name by index
    */
@@ -78,6 +82,22 @@ export class GpuGeometry {
    * Get pointer to indices array for zero-copy view
    */
   readonly indicesPtr: number;
+  /**
+   * Get X component of RTC offset
+   */
+  readonly rtcOffsetX: number;
+  /**
+   * Get Y component of RTC offset
+   */
+  readonly rtcOffsetY: number;
+  /**
+   * Get Z component of RTC offset
+   */
+  readonly rtcOffsetZ: number;
+  /**
+   * Check if RTC offset is active (non-zero)
+   */
+  readonly hasRtcOffset: boolean;
   /**
    * Get length of vertex data array (in f32 elements, not bytes)
    */
@@ -256,13 +276,25 @@ export class IfcAPI {
    * Parse IFC file with streaming mesh batches for progressive rendering
    * Calls the callback with batches of meshes, yielding to browser between batches
    *
+   * Options:
+   * - `batchSize`: Number of meshes per batch (default: 25)
+   * - `onBatch(meshes, progress)`: Called for each batch of meshes
+   * - `onRtcOffset({x, y, z, hasRtc})`: Called early with RTC offset for camera/world setup
+   * - `onColorUpdate(Map<id, color>)`: Called with style updates after initial render
+   * - `onComplete(stats)`: Called when parsing completes with stats including rtcOffset
+   *
    * Example:
    * ```javascript
    * const api = new IfcAPI();
    * await api.parseMeshesAsync(ifcData, {
    *   batchSize: 100,
+   *   onRtcOffset: (rtc) => {
+   *     if (rtc.hasRtc) {
+   *       // Model uses large coordinates - adjust camera/world origin
+   *       viewer.setWorldOffset(rtc.x, rtc.y, rtc.z);
+   *     }
+   *   },
    *   onBatch: (meshes, progress) => {
-   *     // Add meshes to scene
    *     for (const mesh of meshes) {
    *       scene.add(createThreeMesh(mesh));
    *     }
@@ -270,6 +302,7 @@ export class IfcAPI {
    *   },
    *   onComplete: (stats) => {
    *     console.log(`Done! ${stats.totalMeshes} meshes`);
+   *     // stats.rtcOffset also available here: {x, y, z, hasRtc}
    *   }
    * });
    * ```
@@ -428,6 +461,22 @@ export class IfcAPI {
    * ```
    */
   parseMeshesInstancedAsync(content: string, options: any): Promise<any>;
+  /**
+   * Parse IFC file and extract symbolic representations (Plan, Annotation, FootPrint)
+   * These are 2D curves used for architectural drawings instead of sectioning 3D geometry
+   *
+   * Example:
+   * ```javascript
+   * const api = new IfcAPI();
+   * const symbols = api.parseSymbolicRepresentations(ifcData);
+   * console.log('Found', symbols.totalCount, 'symbolic items');
+   * for (let i = 0; i < symbols.polylineCount; i++) {
+   *   const polyline = symbols.getPolyline(i);
+   *   console.log('Polyline for', polyline.ifcType, ':', polyline.points);
+   * }
+   * ```
+   */
+  parseSymbolicRepresentations(content: string): SymbolicRepresentationCollection;
   /**
    * Parse IFC file to GPU-ready instanced geometry for zero-copy upload
    *
@@ -495,10 +544,32 @@ export class MeshCollection {
   private constructor();
   free(): void;
   [Symbol.dispose](): void;
+  /**
+   * Check if RTC offset is significant (>10km)
+   */
+  hasRtcOffset(): boolean;
+  /**
+   * Convert local coordinates to world coordinates
+   * Use this to convert mesh positions back to original IFC coordinates
+   */
+  localToWorld(x: number, y: number, z: number): Float64Array;
   /**
    * Get mesh at index
    */
   get(index: number): MeshDataJs | undefined;
+  /**
+   * Get RTC offset X (for converting local coords back to world coords)
+   * Add this to local X coordinates to get world X coordinates
+   */
+  readonly rtcOffsetX: number;
+  /**
+   * Get RTC offset Y
+   */
+  readonly rtcOffsetY: number;
+  /**
+   * Get RTC offset Z
+   */
+  readonly rtcOffsetZ: number;
   /**
    * Get total vertex count across all meshes
    */
@@ -507,6 +578,11 @@ export class MeshCollection {
    * Get total triangle count across all meshes
    */
   readonly totalTriangles: number;
+  /**
+   * Get building rotation angle in radians (from IfcSite placement)
+   * Returns None if no rotation was detected
+   */
+  readonly buildingRotation: number | undefined;
   /**
    * Get number of meshes
    */
@@ -599,6 +675,88 @@ export class RtcOffsetJs {
   z: number;
 }
 
+export class SymbolicCircle {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  readonly expressId: number;
+  readonly startAngle: number;
+  /**
+   * Check if this is a full circle
+   */
+  readonly isFullCircle: boolean;
+  readonly repIdentifier: string;
+  readonly radius: number;
+  readonly centerX: number;
+  readonly centerY: number;
+  readonly ifcType: string;
+  readonly endAngle: number;
+}
+
+export class SymbolicPolyline {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Get express ID of the parent element
+   */
+  readonly expressId: number;
+  /**
+   * Get number of points
+   */
+  readonly pointCount: number;
+  /**
+   * Get representation identifier ("Plan", "Annotation", "FootPrint", "Axis")
+   */
+  readonly repIdentifier: string;
+  /**
+   * Get 2D points as Float32Array [x1, y1, x2, y2, ...]
+   */
+  readonly points: Float32Array;
+  /**
+   * Get IFC type name (e.g., "IfcDoor", "IfcWindow")
+   */
+  readonly ifcType: string;
+  /**
+   * Check if this is a closed loop
+   */
+  readonly isClosed: boolean;
+}
+
+export class SymbolicRepresentationCollection {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Get circle at index
+   */
+  getCircle(index: number): SymbolicCircle | undefined;
+  /**
+   * Get polyline at index
+   */
+  getPolyline(index: number): SymbolicPolyline | undefined;
+  /**
+   * Get all express IDs that have symbolic representations
+   */
+  getExpressIds(): Uint32Array;
+  /**
+   * Get total count of all symbolic items
+   */
+  readonly totalCount: number;
+  /**
+   * Get number of circles/arcs
+   */
+  readonly circleCount: number;
+  /**
+   * Get number of polylines
+   */
+  readonly polylineCount: number;
+  /**
+   * Check if collection is empty
+   */
+  readonly isEmpty: boolean;
+}
+
 export class ZeroCopyMesh {
   free(): void;
   [Symbol.dispose](): void;
@@ -711,6 +869,9 @@ export interface InitOutput {
   readonly __wbg_set_georeferencejs_scale: (a: number, b: number) => void;
   readonly __wbg_set_georeferencejs_x_axis_abscissa: (a: number, b: number) => void;
   readonly __wbg_set_georeferencejs_x_axis_ordinate: (a: number, b: number) => void;
+  readonly __wbg_symboliccircle_free: (a: number, b: number) => void;
+  readonly __wbg_symbolicpolyline_free: (a: number, b: number) => void;
+  readonly __wbg_symbolicrepresentationcollection_free: (a: number, b: number) => void;
   readonly __wbg_zerocopymesh_free: (a: number, b: number) => void;
   readonly georeferencejs_crsName: (a: number, b: number) => void;
   readonly georeferencejs_localToMap: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -719,12 +880,17 @@ export interface InitOutput {
   readonly georeferencejs_toMatrix: (a: number, b: number) => void;
   readonly gpugeometry_getIfcTypeName: (a: number, b: number, c: number) => void;
   readonly gpugeometry_getMeshMetadata: (a: number, b: number) => number;
+  readonly gpugeometry_hasRtcOffset: (a: number) => number;
   readonly gpugeometry_indicesByteLength: (a: number) => number;
   readonly gpugeometry_indicesLen: (a: number) => number;
   readonly gpugeometry_indicesPtr: (a: number) => number;
   readonly gpugeometry_isEmpty: (a: number) => number;
   readonly gpugeometry_meshCount: (a: number) => number;
   readonly gpugeometry_new: () => number;
+  readonly gpugeometry_rtcOffsetX: (a: number) => number;
+  readonly gpugeometry_rtcOffsetY: (a: number) => number;
+  readonly gpugeometry_rtcOffsetZ: (a: number) => number;
+  readonly gpugeometry_set_rtc_offset: (a: number, b: number, c: number, d: number) => void;
   readonly gpugeometry_totalTriangleCount: (a: number) => number;
   readonly gpugeometry_totalVertexCount: (a: number) => number;
   readonly gpugeometry_vertexDataByteLength: (a: number) => number;
@@ -744,6 +910,7 @@ export interface InitOutput {
   readonly gpuinstancedgeometry_vertexCount: (a: number) => number;
   readonly gpuinstancedgeometry_vertexDataByteLength: (a: number) => number;
   readonly gpuinstancedgeometry_vertexDataLen: (a: number) => number;
+  readonly gpuinstancedgeometry_vertexDataPtr: (a: number) => number;
   readonly gpuinstancedgeometrycollection_get: (a: number, b: number) => number;
   readonly gpuinstancedgeometrycollection_getRef: (a: number, b: number) => number;
   readonly gpuinstancedgeometrycollection_length: (a: number) => number;
@@ -780,6 +947,7 @@ export interface InitOutput {
   readonly ifcapi_parseMeshesInstancedAsync: (a: number, b: number, c: number, d: number) => number;
   readonly ifcapi_parseMeshesWithRtc: (a: number, b: number, c: number) => number;
   readonly ifcapi_parseStreaming: (a: number, b: number, c: number, d: number) => number;
+  readonly ifcapi_parseSymbolicRepresentations: (a: number, b: number, c: number) => number;
   readonly ifcapi_parseToGpuGeometry: (a: number, b: number, c: number) => number;
   readonly ifcapi_parseToGpuGeometryAsync: (a: number, b: number, c: number, d: number) => number;
   readonly ifcapi_parseToGpuInstancedGeometry: (a: number, b: number, c: number) => number;
@@ -797,12 +965,16 @@ export interface InitOutput {
   readonly instancedgeometry_positions: (a: number) => number;
   readonly instancedmeshcollection_get: (a: number, b: number) => number;
   readonly instancedmeshcollection_totalInstances: (a: number) => number;
+  readonly meshcollection_buildingRotation: (a: number, b: number) => void;
   readonly meshcollection_get: (a: number, b: number) => number;
+  readonly meshcollection_hasRtcOffset: (a: number) => number;
   readonly meshcollection_length: (a: number) => number;
+  readonly meshcollection_localToWorld: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly meshcollection_rtcOffsetY: (a: number) => number;
+  readonly meshcollection_rtcOffsetZ: (a: number) => number;
   readonly meshcollection_totalTriangles: (a: number) => number;
   readonly meshcollection_totalVertices: (a: number) => number;
   readonly meshcollectionwithrtc_get: (a: number, b: number) => number;
-  readonly meshcollectionwithrtc_length: (a: number) => number;
   readonly meshcollectionwithrtc_meshes: (a: number) => number;
   readonly meshcollectionwithrtc_rtcOffset: (a: number) => number;
   readonly meshdatajs_color: (a: number, b: number) => void;
@@ -812,43 +984,66 @@ export interface InitOutput {
   readonly meshdatajs_normals: (a: number) => number;
   readonly meshdatajs_positions: (a: number) => number;
   readonly meshdatajs_triangleCount: (a: number) => number;
+  readonly meshdatajs_vertexCount: (a: number) => number;
   readonly rtcoffsetjs_isSignificant: (a: number) => number;
   readonly rtcoffsetjs_toWorld: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly symboliccircle_centerX: (a: number) => number;
+  readonly symboliccircle_centerY: (a: number) => number;
+  readonly symboliccircle_endAngle: (a: number) => number;
+  readonly symboliccircle_ifcType: (a: number, b: number) => void;
+  readonly symboliccircle_isFullCircle: (a: number) => number;
+  readonly symboliccircle_radius: (a: number) => number;
+  readonly symboliccircle_repIdentifier: (a: number, b: number) => void;
+  readonly symboliccircle_startAngle: (a: number) => number;
+  readonly symbolicpolyline_expressId: (a: number) => number;
+  readonly symbolicpolyline_ifcType: (a: number, b: number) => void;
+  readonly symbolicpolyline_isClosed: (a: number) => number;
+  readonly symbolicpolyline_pointCount: (a: number) => number;
+  readonly symbolicpolyline_points: (a: number) => number;
+  readonly symbolicpolyline_repIdentifier: (a: number, b: number) => void;
+  readonly symbolicrepresentationcollection_circleCount: (a: number) => number;
+  readonly symbolicrepresentationcollection_getCircle: (a: number, b: number) => number;
+  readonly symbolicrepresentationcollection_getExpressIds: (a: number, b: number) => void;
+  readonly symbolicrepresentationcollection_getPolyline: (a: number, b: number) => number;
+  readonly symbolicrepresentationcollection_isEmpty: (a: number) => number;
+  readonly symbolicrepresentationcollection_polylineCount: (a: number) => number;
+  readonly symbolicrepresentationcollection_totalCount: (a: number) => number;
   readonly version: (a: number) => void;
   readonly zerocopymesh_bounds_max: (a: number, b: number) => void;
   readonly zerocopymesh_bounds_min: (a: number, b: number) => void;
+  readonly zerocopymesh_is_empty: (a: number) => number;
   readonly zerocopymesh_new: () => number;
+  readonly zerocopymesh_normals_len: (a: number) => number;
+  readonly zerocopymesh_positions_len: (a: number) => number;
+  readonly zerocopymesh_positions_ptr: (a: number) => number;
   readonly zerocopymesh_vertex_count: (a: number) => number;
   readonly init: () => void;
   readonly instancedmeshcollection_length: (a: number) => number;
   readonly instancedmeshcollection_totalGeometries: (a: number) => number;
+  readonly meshcollectionwithrtc_length: (a: number) => number;
   readonly zerocopymesh_indices_len: (a: number) => number;
-  readonly zerocopymesh_normals_len: (a: number) => number;
-  readonly zerocopymesh_positions_len: (a: number) => number;
   readonly __wbg_set_rtcoffsetjs_x: (a: number, b: number) => void;
   readonly __wbg_set_rtcoffsetjs_y: (a: number, b: number) => void;
   readonly __wbg_set_rtcoffsetjs_z: (a: number, b: number) => void;
-  readonly meshdatajs_vertexCount: (a: number) => number;
   readonly zerocopymesh_triangle_count: (a: number) => number;
   readonly get_memory: () => number;
-  readonly gpuinstancedgeometry_vertexDataPtr: (a: number) => number;
   readonly zerocopymesh_indices_ptr: (a: number) => number;
   readonly zerocopymesh_normals_ptr: (a: number) => number;
-  readonly zerocopymesh_positions_ptr: (a: number) => number;
-  readonly zerocopymesh_is_empty: (a: number) => number;
   readonly __wbg_get_rtcoffsetjs_x: (a: number) => number;
   readonly __wbg_get_rtcoffsetjs_y: (a: number) => number;
   readonly __wbg_get_rtcoffsetjs_z: (a: number) => number;
   readonly instancedgeometry_geometryId: (a: number) => bigint;
-  readonly __wasm_bindgen_func_elem_393: (a: number, b: number) => void;
-  readonly __wasm_bindgen_func_elem_389: (a: number, b: number) => void;
-  readonly __wasm_bindgen_func_elem_725: (a: number, b: number, c: number) => void;
-  readonly __wasm_bindgen_func_elem_720: (a: number, b: number) => void;
-  readonly __wasm_bindgen_func_elem_756: (a: number, b: number, c: number, d: number) => void;
-  readonly __wbindgen_export: (a: number, b: number) => number;
-  readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
-  readonly __wbindgen_export3: (a: number) => void;
-  readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
+  readonly meshcollection_rtcOffsetX: (a: number) => number;
+  readonly symboliccircle_expressId: (a: number) => number;
+  readonly __wasm_bindgen_func_elem_474: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_472: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_921: (a: number, b: number, c: number) => void;
+  readonly __wasm_bindgen_func_elem_919: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_952: (a: number, b: number, c: number, d: number) => void;
+  readonly __wbindgen_export: (a: number) => void;
+  readonly __wbindgen_export2: (a: number, b: number, c: number) => void;
+  readonly __wbindgen_export3: (a: number, b: number) => number;
+  readonly __wbindgen_export4: (a: number, b: number, c: number, d: number) => number;
   readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
   readonly __wbindgen_start: () => void;
 }