@ifc-lite/wasm 6.4.0 → 7.0.0

package/README.md

@@ -111,3 +111,52 @@ See the [WASM API Reference](https://ifclite.dev/docs/api/wasm/).
 ## License
 
 [MPL-2.0](https://mozilla.org/MPL/2.0/)
+
+
+For appearance authoring, `IfcAPI.catalogAppearance` resolves current IFC product
+classes and type memberships from an effective STEP snapshot before planning.
+It shares bounded native decoding with `planAppearance`; run both in a worker and
+validate the source revision before using a catalog or applying a plan. See the
+[WASM API guide](../../docs/api/wasm.md#effective-appearance-scope-catalog) for the
+request, response and limits.
+
+`IfcAPI.planPageAppearance(content, requestJson, rgba)` adds a bounded finite-page
+compositor. It returns an `IFPA` metadata/PNG envelope with per-item digest-named
+assets and ordinary atomic IFC edits. Outside-page albedo is resampled from the
+original canonical style/texture, not a repeated or clamped page border. Run in
+a cancellable worker and retain all generated assets with the command. See the
+[WASM API guide](../../docs/api/wasm.md#finite-page-appearance-output).
+
+`IfcAPI.planAnnotationPlane` creates a bounded calibrated image `IfcAnnotation`
+plan for an explicit spatial container, reusing canonical native geometry. Run it
+in a worker and publish its typed entities, source-image lease and returned mesh
+as one existing model/history transaction. See the [WASM API guide](../../docs/api/wasm.md#calibrated-annotation-creation)
+for the Z-up geometry/top-down UV and allocator/source validation contract.
+
+`IfcAPI.planCapturedMesh` creates a bounded `IfcBuildingElementProxy` plan from
+an already segmented textured triangle mesh, retaining independent UV seams and
+the original image URI. It uses the same native authoring and geometry path as
+annotation creation. See [captured surface creation](../../docs/api/wasm.md#captured-textured-surface-creation)
+for coordinate, budget and atomic host-commit requirements.
+
+Captured-mesh planning preserves optional `repeatS`/`repeatT` image sampler flags
+(default `false`); UVs remain bounded to `[0, 1]`.
+
+`IfcAPI.registerScanCorrespondences` fits bounded manual source-scan/IFC point
+pairs and returns a proper rigid transform plus separate fitting and held-out
+residuals. Frames and asset identities are bound into the report; the call does
+not align a loaded model or approve scan accuracy. See the
+[registration contract](../../docs/api/wasm.md#scan-correspondence-registration).
+
+`IfcAPI.planMeshTransfer` composes registered opaque textured-mesh observations
+onto supported direct IFC tessellations using the shared atlas planner. Unknown
+samples retain existing target albedo; the IFPA response includes explicit
+coverage and frozen-input bindings. Entirely unknown transfer has no applicable
+plan. See the [transfer contract](../../docs/api/wasm.md#registered-textured-mesh-appearance-transfer)
+for source identity, coordinate frames, budgets and host acceptance requirements.
+
+`IfcAPI.preparePdfVectorPage` validates bounded ordered PDF vector graphics states
+and preserves source operator identity, calibrated transforms and paint state.
+Unsupported content remains an explicit blocker. It emits no IFC entities and
+makes no flattened-geometry fidelity claim; see the
+[preparation contract](../../docs/api/wasm.md#pdf-vector-graphics-state-preparation).

package/package.json

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

package/pkg/ifc-lite.d.ts

@@ -313,6 +313,18 @@ export class IfcAPI {
      * Existing streaming prepass plus an exact full-source key in complete.
      */
     buildPrePassStreamingWithSourceFingerprint(data: Uint8Array, on_event: Function, chunk_size: number, disabled_type_names: string[] | null | undefined, skip_type_geometry: boolean): any;
+    /**
+     * Calibrate one raster plane from native-source landmarks and a measured
+     * world span. Returns UTF-8 CalibratedPlane JSON. Constant bounded work;
+     * does not read IFC, decode image pixels or mutate a model.
+     */
+    calibrateAppearancePlane(request_json: string): Uint8Array;
+    /**
+     * Catalog effective IfcProduct classes and IfcRelDefinesByType membership.
+     * JSON input is AppearanceCatalogRequest; output is AppearanceCatalog JSON.
+     * Run in a worker and validate sourceRevision before using the selectors.
+     */
+    catalogAppearance(content: Uint8Array, request_json: string): Uint8Array;
     /**
      * Clear the cached entity index (call between loads when reusing
      * the same `IfcAPI` instance — e.g. the parser worker keeps one
@@ -353,8 +365,17 @@ export class IfcAPI {
      *
      * `hidden` / `isolated` are express-id visibility filters; `hidden_types_csv` is a
      * comma-separated list of IFC type names whose class toggle is off (e.g.
-     * `"IfcOpeningElement,IfcSpace"`). `include_metadata` attaches counts + per-node
-     * `expressId`. Per-mesh RTC origin rides the node translation (precision-safe).
+     * `"IfcOpeningElement,IfcSpace"`). `isolated` carries the isolation allowlist's
+     * null-vs-empty distinction across the wasm boundary: omit it (`undefined`) for
+     * "no isolation filter" (every mesh is a candidate); pass an empty `Uint32Array`
+     * for "isolation is ACTIVE and currently matches nothing" (every mesh is
+     * excluded). Collapsing the two — as a bare `Uint32Array` parameter would force a
+     * caller to do — silently exports the whole model when a filter matches nothing
+     * (#4328 follow-up: reachable by filtering the Class tab to a type present only
+     * in a federated model's secondary member, then exporting "Visible Only"). A
+     * non-empty `Uint32Array` is the ordinary allowlist. `include_metadata` attaches
+     * counts + per-node `expressId`. Per-mesh RTC origin rides the node translation
+     * (precision-safe).
      * `lit` emits standard PBR materials that shade from normals; omitted or
      * `true` ⇒ lit (the default), `false` ⇒ flat `KHR_materials_unlit` (the
      * historical look — #1321). Optional at the boundary so older 5-arg callers
@@ -369,7 +390,7 @@ export class IfcAPI {
      * CLI/MCP wrappers; making the boundary itself refuse means SDK/viewer/
      * direct callers inherit it too (the TS guards stay as defense-in-depth).
      */
-    exportGlb(content: Uint8Array, include_metadata: boolean, hidden: Uint32Array, isolated: Uint32Array, hidden_types_csv: string, lit?: boolean | null, emissive?: boolean | null): Uint8Array;
+    exportGlb(content: Uint8Array, include_metadata: boolean, hidden: Uint32Array, isolated: Uint32Array | null | undefined, hidden_types_csv: string, lit?: boolean | null, emissive?: boolean | null): Uint8Array;
     /**
      * Assemble a **GLB** from already-produced meshes (the viewer's `MeshData`, flattened)
      * — no re-meshing. Per mesh `i`: `vertex_counts[i]` verts + `index_counts[i]` indices
@@ -477,14 +498,21 @@ export class IfcAPI {
      * V8 max-string ceiling (~512 MB); decode with `TextDecoder` when a string
      * is genuinely needed.
      *
-     * `hidden` / `isolated` are express-id filters mirroring the viewer's visibility
-     * state (empty `isolated` ⇒ all visible). Instanced type-library shapes are skipped.
+     * `hidden` is an express-id filter mirroring the viewer's visibility state.
+     * `isolated` carries the isolation allowlist's null-vs-empty distinction across
+     * the wasm boundary: omit it (`undefined`) for "no isolation filter" (every mesh
+     * is a candidate); pass an empty `Uint32Array` for "isolation is ACTIVE and
+     * currently matches nothing" (every mesh is excluded). Collapsing the two — as a
+     * bare `Uint32Array` parameter would force a caller to do — silently exports the
+     * whole model when a filter matches nothing (the OBJ twin of #4328/#4364, fixed
+     * for GLB in `export_glb`). A non-empty `Uint32Array` is the ordinary allowlist.
+     * Instanced type-library shapes are skipped regardless of the filter.
      *
      * ```javascript
-     * const obj = api.exportObj(ifcContent, true, new Uint32Array(), new Uint32Array());
+     * const obj = api.exportObj(ifcContent, true, new Uint32Array(), undefined);
      * ```
      */
-    exportObj(content: Uint8Array, include_normals: boolean, hidden: Uint32Array, isolated: Uint32Array): Uint8Array;
+    exportObj(content: Uint8Array, include_normals: boolean, hidden: Uint32Array, isolated?: Uint32Array | null): Uint8Array;
     /**
      * Re-serialize the model in `content` to STEP/IFC UTF-8 bytes.
      *
@@ -605,6 +633,49 @@ export class IfcAPI {
      * ```
      */
     parseSymbolicRepresentations(content: string): SymbolicRepresentationCollection;
+    /**
+     * Create a calibrated image annotation through canonical native geometry.
+     * Input is AnnotationPlaneRequest; output UTF-8 AnnotationPlanePlan JSON.
+     * Does not mutate the IFC snapshot or decode the host-owned image.
+     */
+    planAnnotationPlane(content: Uint8Array, request_json: string): Uint8Array;
+    /**
+     * Plan image/UV edits against an effective IFC snapshot without mutating it.
+     * JSON input uses AppearanceRequest; output is UTF-8 AppearancePlan JSON.
+     * Call from a worker, then validate sourceRevision and allocator before an
+     * atomic host commit. Preview UVs describe an unsplit canonical mesh item.
+     */
+    planAppearance(content: Uint8Array, request_json: string): Uint8Array;
+    /**
+     * Create a captured textured surface through canonical native geometry.
+     * Input is CapturedMeshRequest; output UTF-8 CapturedMeshPlan JSON.
+     * Does not mutate the IFC snapshot or decode the host-owned image.
+     */
+    planCapturedMesh(content: Uint8Array, request_json: string): Uint8Array;
+    /**
+     * Registered mesh observations over canonical target albedo. Host verifies
+     * original GLB identity against decoded source mesh/image and freezes frames.
+     * Run in an owned cancellable worker. IFPA output adds `transfer` coverage;
+     * `plan` is null when no sample is observed. Never infer accuracy approval.
+     */
+    planMeshTransfer(content: Uint8Array, request_json: string, rgba: Uint8Array): Uint8Array;
+    /**
+     * Finite-page composition over original canonical albedo. RGBA is supplied
+     * separately from the bounded JSON request. Result: IFPA magic, little-endian
+     * u32 JSON byte length, metadata JSON, then PNG bytes addressed by metadata.
+     * Run in a cancellable worker; atomically adopt every item asset and IFC edit.
+     */
+    planPageAppearance(content: Uint8Array, request_json: string, rgba: Uint8Array): Uint8Array;
+    /**
+     * Plan a complete opaque polygonal PDF fill page as canonical IfcAnnotation
+     * geometry. Painted strokes, curves and unsupported states refuse atomically.
+     */
+    planPdfFillAnnotation(source: Uint8Array, request_json: string): Uint8Array;
+    /**
+     * Prepare bounded ordered PDF vector graphics states. No IFC entities or
+     * flattened geometry are produced; unsupported content prevents qualification.
+     */
+    preparePdfVectorPage(request_json: string): Uint8Array;
     /**
      * Process geometry for a subset of pre-scanned entities → flat
      * MeshCollection. Takes raw bytes + pre-pass data from buildPrePassOnce.
@@ -655,6 +726,11 @@ export class IfcAPI {
      * Byte-for-byte identical output — it delegates to the legacy twin.
      */
     processGeometryBatchPartitionedFromSource(jobs_flat: Uint32Array, unit_scale: number, rtc_x: number, rtc_y: number, rtc_z: number, needs_shift: boolean, void_keys: Uint32Array, void_counts: Uint32Array, void_values: Uint32Array, style_ids: Uint32Array, style_colors: Uint8Array, plane_angle_to_radians?: number | null, material_element_ids?: Uint32Array | null, material_color_counts?: Uint32Array | null, material_colors_rgba?: Uint8Array | null): PartitionedBatch;
+    /**
+     * Fit bounded manual correspondences in source metres -> IFC world Z-up
+     * metres, reporting held-out errors separately. Does not load or move models.
+     */
+    registerScanCorrespondences(request_json: string): Uint8Array;
     /**
      * Sharded pre-pass: resolve ONE contiguous (file-ordered) slice of the
      * styled-item span list on this worker, against the entity index installed
@@ -1564,6 +1640,7 @@ export class SymbolicFillArea {
     readonly fillB: number;
     readonly fillG: number;
     readonly fillR: number;
+    readonly geometryItemId: number | undefined;
     readonly hasHatching: boolean;
     readonly hatchAngle: number;
     readonly hatchAngleSecondary: number;
@@ -1998,6 +2075,8 @@ export interface InitOutput {
     readonly ifcapi_buildPrePassStreamingSharded: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number) => void;
     readonly ifcapi_buildPrePassStreamingShardedWithSourceFingerprint: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number) => void;
     readonly ifcapi_buildPrePassStreamingWithSourceFingerprint: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+    readonly ifcapi_calibrateAppearancePlane: (a: number, b: number, c: number, d: number) => void;
+    readonly ifcapi_catalogAppearance: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly ifcapi_clearPrePassCache: (a: number) => void;
     readonly ifcapi_diagnoseGeometry: (a: number, b: number, c: number) => number;
     readonly ifcapi_exportCsv: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
@@ -2026,11 +2105,19 @@ export interface InitOutput {
     readonly ifcapi_parseGridAxes: (a: number, b: number, c: number) => number;
     readonly ifcapi_parseGridLines: (a: number, b: number, c: number) => number;
     readonly ifcapi_parseSymbolicRepresentations: (a: number, b: number, c: number) => number;
+    readonly ifcapi_planAnnotationPlane: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly ifcapi_planAppearance: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly ifcapi_planCapturedMesh: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly ifcapi_planMeshTransfer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly ifcapi_planPageAppearance: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly ifcapi_planPdfFillAnnotation: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly ifcapi_preparePdfVectorPage: (a: number, b: number, c: number, d: number) => void;
     readonly ifcapi_processGeometryBatch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number) => number;
     readonly ifcapi_processGeometryBatchFromSource: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number) => number;
     readonly ifcapi_processGeometryBatchInstanced: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number) => void;
     readonly ifcapi_processGeometryBatchPartitioned: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number) => number;
     readonly ifcapi_processGeometryBatchPartitionedFromSource: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number) => number;
+    readonly ifcapi_registerScanCorrespondences: (a: number, b: number, c: number, d: number) => void;
     readonly ifcapi_resolveStyledItemsShard: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly ifcapi_resolveStyledItemsShardFromSource: (a: number, b: number, c: number, d: number) => void;
     readonly ifcapi_scanEntitiesFast: (a: number, b: number, c: number) => number;
@@ -2161,10 +2248,12 @@ export interface InitOutput {
     readonly symboliccircle_repIdentifier: (a: number, b: number) => void;
     readonly symboliccircle_startAngle: (a: number) => number;
     readonly symboliccircle_worldY: (a: number) => number;
+    readonly symbolicfillarea_expressId: (a: number) => number;
     readonly symbolicfillarea_fillA: (a: number) => number;
     readonly symbolicfillarea_fillB: (a: number) => number;
     readonly symbolicfillarea_fillG: (a: number) => number;
     readonly symbolicfillarea_fillR: (a: number) => number;
+    readonly symbolicfillarea_geometryItemId: (a: number) => number;
     readonly symbolicfillarea_hasHatching: (a: number) => number;
     readonly symbolicfillarea_hatchAngle: (a: number) => number;
     readonly symbolicfillarea_hatchAngleSecondary: (a: number) => number;
@@ -2180,6 +2269,7 @@ export interface InitOutput {
     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;
@@ -2197,11 +2287,11 @@ export interface InitOutput {
     readonly symbolicrepresentationcollection_truncatedLimit: (a: number) => number;
     readonly symbolicrepresentationcollection_truncatedReason: (a: number, b: number) => void;
     readonly symbolictext_alignment: (a: number, b: number) => void;
-    readonly symbolictext_colorA: (a: number) => number;
     readonly symbolictext_content: (a: number, b: number) => void;
     readonly symbolictext_ifcType: (a: number, b: number) => void;
     readonly symbolictext_repIdentifier: (a: number, b: number) => void;
-    readonly symbolictext_targetPx: (a: number) => number;
+    readonly symbolictext_x: (a: number) => number;
+    readonly symbolictext_y: (a: number) => number;
     readonly union2d: (a: number, b: number) => number;
     readonly version: (a: number) => void;
     readonly zonepiecejs_indices: (a: number) => number;
@@ -2211,10 +2301,9 @@ export interface InitOutput {
     readonly zonesplitjs_pieceCount: (a: number) => number;
     readonly zonesplitjs_remainderFailed: (a: number) => number;
     readonly meshoutlinejs_contourCount: (a: number) => number;
-    readonly symbolicpolyline_pointCount: (a: number) => number;
     readonly get_memory: () => number;
-    readonly symbolicfillarea_expressId: (a: number) => number;
     readonly symbolicpolyline_worldY: (a: number) => number;
+    readonly symbolictext_colorA: (a: number) => number;
     readonly symbolictext_colorB: (a: number) => number;
     readonly symbolictext_colorG: (a: number) => number;
     readonly symbolictext_colorR: (a: number) => number;
@@ -2222,9 +2311,8 @@ export interface InitOutput {
     readonly symbolictext_dirY: (a: number) => number;
     readonly symbolictext_expressId: (a: number) => number;
     readonly symbolictext_height: (a: number) => number;
+    readonly symbolictext_targetPx: (a: number) => number;
     readonly symbolictext_worldY: (a: number) => number;
-    readonly symbolictext_x: (a: number) => number;
-    readonly symbolictext_y: (a: number) => number;
     readonly zonepiecejs_volume: (a: number) => number;
     readonly zonesplitjs_sumErrorRel: (a: number) => number;
     readonly zonesplitjs_wholeVolume: (a: number) => number;

package/pkg/ifc-lite.js

@@ -840,6 +840,63 @@ export class IfcAPI {
             heap[stack_pointer++] = undefined;
         }
     }
+    /**
+     * Calibrate one raster plane from native-source landmarks and a measured
+     * world span. Returns UTF-8 CalibratedPlane JSON. Constant bounded work;
+     * does not read IFC, decode image pixels or mutate a model.
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    calibrateAppearancePlane(request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.ifcapi_calibrateAppearancePlane(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Catalog effective IfcProduct classes and IfcRelDefinesByType membership.
+     * JSON input is AppearanceCatalogRequest; output is AppearanceCatalog JSON.
+     * Run in a worker and validate sourceRevision before using the selectors.
+     * @param {Uint8Array} content
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    catalogAppearance(content, request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(content, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.ifcapi_catalogAppearance(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v3 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v3;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Clear the cached entity index (call between loads when reusing
      * the same `IfcAPI` instance — e.g. the parser worker keeps one
@@ -934,8 +991,17 @@ export class IfcAPI {
      *
      * `hidden` / `isolated` are express-id visibility filters; `hidden_types_csv` is a
      * comma-separated list of IFC type names whose class toggle is off (e.g.
-     * `"IfcOpeningElement,IfcSpace"`). `include_metadata` attaches counts + per-node
-     * `expressId`. Per-mesh RTC origin rides the node translation (precision-safe).
+     * `"IfcOpeningElement,IfcSpace"`). `isolated` carries the isolation allowlist's
+     * null-vs-empty distinction across the wasm boundary: omit it (`undefined`) for
+     * "no isolation filter" (every mesh is a candidate); pass an empty `Uint32Array`
+     * for "isolation is ACTIVE and currently matches nothing" (every mesh is
+     * excluded). Collapsing the two — as a bare `Uint32Array` parameter would force a
+     * caller to do — silently exports the whole model when a filter matches nothing
+     * (#4328 follow-up: reachable by filtering the Class tab to a type present only
+     * in a federated model's secondary member, then exporting "Visible Only"). A
+     * non-empty `Uint32Array` is the ordinary allowlist. `include_metadata` attaches
+     * counts + per-node `expressId`. Per-mesh RTC origin rides the node translation
+     * (precision-safe).
      * `lit` emits standard PBR materials that shade from normals; omitted or
      * `true` ⇒ lit (the default), `false` ⇒ flat `KHR_materials_unlit` (the
      * historical look — #1321). Optional at the boundary so older 5-arg callers
@@ -952,7 +1018,7 @@ export class IfcAPI {
      * @param {Uint8Array} content
      * @param {boolean} include_metadata
      * @param {Uint32Array} hidden
-     * @param {Uint32Array} isolated
+     * @param {Uint32Array | null | undefined} isolated
      * @param {string} hidden_types_csv
      * @param {boolean | null} [lit]
      * @param {boolean | null} [emissive]
@@ -965,8 +1031,8 @@ export class IfcAPI {
             const len0 = WASM_VECTOR_LEN;
             const ptr1 = passArray32ToWasm0(hidden, wasm.__wbindgen_export);
             const len1 = WASM_VECTOR_LEN;
-            const ptr2 = passArray32ToWasm0(isolated, wasm.__wbindgen_export);
-            const len2 = WASM_VECTOR_LEN;
+            var ptr2 = isLikeNone(isolated) ? 0 : passArray32ToWasm0(isolated, wasm.__wbindgen_export);
+            var len2 = WASM_VECTOR_LEN;
             const ptr3 = passStringToWasm0(hidden_types_csv, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len3 = WASM_VECTOR_LEN;
             wasm.ifcapi_exportGlb(retptr, this.__wbg_ptr, ptr0, len0, include_metadata, ptr1, len1, ptr2, len2, ptr3, len3, isLikeNone(lit) ? 0xFFFFFF : lit ? 1 : 0, isLikeNone(emissive) ? 0xFFFFFF : emissive ? 1 : 0);
@@ -1321,16 +1387,23 @@ export class IfcAPI {
      * V8 max-string ceiling (~512 MB); decode with `TextDecoder` when a string
      * is genuinely needed.
      *
-     * `hidden` / `isolated` are express-id filters mirroring the viewer's visibility
-     * state (empty `isolated` ⇒ all visible). Instanced type-library shapes are skipped.
+     * `hidden` is an express-id filter mirroring the viewer's visibility state.
+     * `isolated` carries the isolation allowlist's null-vs-empty distinction across
+     * the wasm boundary: omit it (`undefined`) for "no isolation filter" (every mesh
+     * is a candidate); pass an empty `Uint32Array` for "isolation is ACTIVE and
+     * currently matches nothing" (every mesh is excluded). Collapsing the two — as a
+     * bare `Uint32Array` parameter would force a caller to do — silently exports the
+     * whole model when a filter matches nothing (the OBJ twin of #4328/#4364, fixed
+     * for GLB in `export_glb`). A non-empty `Uint32Array` is the ordinary allowlist.
+     * Instanced type-library shapes are skipped regardless of the filter.
      *
      * ```javascript
-     * const obj = api.exportObj(ifcContent, true, new Uint32Array(), new Uint32Array());
+     * const obj = api.exportObj(ifcContent, true, new Uint32Array(), undefined);
      * ```
      * @param {Uint8Array} content
      * @param {boolean} include_normals
      * @param {Uint32Array} hidden
-     * @param {Uint32Array} isolated
+     * @param {Uint32Array | null} [isolated]
      * @returns {Uint8Array}
      */
     exportObj(content, include_normals, hidden, isolated) {
@@ -1340,8 +1413,8 @@ export class IfcAPI {
             const len0 = WASM_VECTOR_LEN;
             const ptr1 = passArray32ToWasm0(hidden, wasm.__wbindgen_export);
             const len1 = WASM_VECTOR_LEN;
-            const ptr2 = passArray32ToWasm0(isolated, wasm.__wbindgen_export);
-            const len2 = WASM_VECTOR_LEN;
+            var ptr2 = isLikeNone(isolated) ? 0 : passArray32ToWasm0(isolated, wasm.__wbindgen_export);
+            var len2 = WASM_VECTOR_LEN;
             wasm.ifcapi_exportObj(retptr, this.__wbg_ptr, ptr0, len0, include_normals, ptr1, len1, ptr2, len2);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
@@ -1665,6 +1738,220 @@ export class IfcAPI {
         const ret = wasm.ifcapi_parseSymbolicRepresentations(this.__wbg_ptr, ptr0, len0);
         return SymbolicRepresentationCollection.__wrap(ret);
     }
+    /**
+     * Create a calibrated image annotation through canonical native geometry.
+     * Input is AnnotationPlaneRequest; output UTF-8 AnnotationPlanePlan JSON.
+     * Does not mutate the IFC snapshot or decode the host-owned image.
+     * @param {Uint8Array} content
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    planAnnotationPlane(content, request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(content, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.ifcapi_planAnnotationPlane(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v3 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v3;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Plan image/UV edits against an effective IFC snapshot without mutating it.
+     * JSON input uses AppearanceRequest; output is UTF-8 AppearancePlan JSON.
+     * Call from a worker, then validate sourceRevision and allocator before an
+     * atomic host commit. Preview UVs describe an unsplit canonical mesh item.
+     * @param {Uint8Array} content
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    planAppearance(content, request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(content, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.ifcapi_planAppearance(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v3 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v3;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Create a captured textured surface through canonical native geometry.
+     * Input is CapturedMeshRequest; output UTF-8 CapturedMeshPlan JSON.
+     * Does not mutate the IFC snapshot or decode the host-owned image.
+     * @param {Uint8Array} content
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    planCapturedMesh(content, request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(content, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.ifcapi_planCapturedMesh(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v3 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v3;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Registered mesh observations over canonical target albedo. Host verifies
+     * original GLB identity against decoded source mesh/image and freezes frames.
+     * Run in an owned cancellable worker. IFPA output adds `transfer` coverage;
+     * `plan` is null when no sample is observed. Never infer accuracy approval.
+     * @param {Uint8Array} content
+     * @param {string} request_json
+     * @param {Uint8Array} rgba
+     * @returns {Uint8Array}
+     */
+    planMeshTransfer(content, request_json, rgba) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(content, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            const ptr2 = passArray8ToWasm0(rgba, wasm.__wbindgen_export);
+            const len2 = WASM_VECTOR_LEN;
+            wasm.ifcapi_planMeshTransfer(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v4 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v4;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Finite-page composition over original canonical albedo. RGBA is supplied
+     * separately from the bounded JSON request. Result: IFPA magic, little-endian
+     * u32 JSON byte length, metadata JSON, then PNG bytes addressed by metadata.
+     * Run in a cancellable worker; atomically adopt every item asset and IFC edit.
+     * @param {Uint8Array} content
+     * @param {string} request_json
+     * @param {Uint8Array} rgba
+     * @returns {Uint8Array}
+     */
+    planPageAppearance(content, request_json, rgba) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(content, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            const ptr2 = passArray8ToWasm0(rgba, wasm.__wbindgen_export);
+            const len2 = WASM_VECTOR_LEN;
+            wasm.ifcapi_planPageAppearance(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v4 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v4;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Plan a complete opaque polygonal PDF fill page as canonical IfcAnnotation
+     * geometry. Painted strokes, curves and unsupported states refuse atomically.
+     * @param {Uint8Array} source
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    planPdfFillAnnotation(source, request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(source, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.ifcapi_planPdfFillAnnotation(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v3 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v3;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Prepare bounded ordered PDF vector graphics states. No IFC entities or
+     * flattened geometry are produced; unsupported content prevents qualification.
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    preparePdfVectorPage(request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.ifcapi_preparePdfVectorPage(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Process geometry for a subset of pre-scanned entities → flat
      * MeshCollection. Takes raw bytes + pre-pass data from buildPrePassOnce.
@@ -1918,6 +2205,32 @@ export class IfcAPI {
         const ret = wasm.ifcapi_processGeometryBatchPartitionedFromSource(this.__wbg_ptr, ptr0, len0, unit_scale, rtc_x, rtc_y, rtc_z, needs_shift, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, !isLikeNone(plane_angle_to_radians), isLikeNone(plane_angle_to_radians) ? 0 : plane_angle_to_radians, ptr6, len6, ptr7, len7, ptr8, len8);
         return PartitionedBatch.__wrap(ret);
     }
+    /**
+     * Fit bounded manual correspondences in source metres -> IFC world Z-up
+     * metres, reporting held-out errors separately. Does not load or move models.
+     * @param {string} request_json
+     * @returns {Uint8Array}
+     */
+    registerScanCorrespondences(request_json) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(request_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.ifcapi_registerScanCorrespondences(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Sharded pre-pass: resolve ONE contiguous (file-ordered) slice of the
      * styled-item span list on this worker, against the entity index installed
@@ -4154,6 +4467,13 @@ export class SymbolicFillArea {
         const ret = wasm.symbolicfillarea_fillR(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * @returns {number | undefined}
+     */
+    get geometryItemId() {
+        const ret = wasm.symbolicfillarea_geometryItemId(this.__wbg_ptr);
+        return ret === Number.MAX_SAFE_INTEGER ? undefined : ret;
+    }
     /**
      * @returns {boolean}
      */