brepjs-bim 0.20.0 → 0.22.0

package/dist/elementFns/placedGeometry.d.ts

@@ -1,20 +1,31 @@
 import { ValidSolid, Result } from 'brepjs';
 import { AnyBimElement } from '../types/bimTypes.js';
 import { BimError } from '../errors/bimError.js';
+import { FrameInput } from '../import/placement.js';
+export interface PlacedSolidsOptions {
+    /**
+     * Cumulative frame of the element's containing spatial structure. Element
+     * specs and stored arbitrary bodies are relative to that structure; pass its
+     * frame here when world coordinates are required.
+     */
+    readonly parentFrame?: FrameInput | undefined;
+}
 /**
- * Returns each element's geometry transformed to its world placement, as fresh
- * caller-owned solids, wrapped in a `Result` (Layer-2 code prefers `Result` over
- * throwing). **Dispose the returned solids** (e.g. via `using` / `[Symbol.dispose]`)
- * when you own their lifetime — they are independent of the model
+ * Returns each element's geometry transformed to its element-local placement,
+ * and optionally through the cumulative frame of its containing spatial
+ * structure, as fresh caller-owned solids. Pass `parentFrame` to obtain world
+ * coordinates for elements beneath a placed Site, Bridge, Bridge Part, or
+ * other spatial structure. **Dispose the returned solids** (e.g. via `using` /
+ * `[Symbol.dispose]`) when you own their lifetime — they are independent of the model
  * (`BimModel[Symbol.dispose]` frees only the stored, unplaced `.geometry`). On any
  * failure the solids already built for this call are disposed before the error is
  * returned, so no partial array is leaked.
  *
  * Stairs and ramps carry no element solid (`.geometry` is null), so flight
  * solids are built from `spec.flights` and placed per flight. Curtain walls
- * return placed panels + mullions. Proxies are authored in world coordinates
- * (no placement frame), so their solid is returned as a fresh identity-placed
- * copy. Elements with no solid geometry (doors/windows/groups/spatial) return
- * an empty array.
+ * return placed panels + mullions. Proxy and Earthworks Fill bodies are stored
+ * relative to their containing spatial structure, so their body is copied and
+ * then transformed by `parentFrame` when supplied. Elements with no solid geometry
+ * (doors/windows/groups/spatial) return an empty array.
  */
-export declare function placedSolids(el: AnyBimElement): Result<readonly ValidSolid[], BimError>;
+export declare function placedSolids(el: AnyBimElement, options?: PlacedSolidsOptions): Result<readonly ValidSolid[], BimError>;

package/dist/familiesAdapter.d.ts

@@ -8,13 +8,20 @@ export interface FamiliesToBimOptions {
     readonly project: ProjectSpec;
     readonly siteName?: string | undefined;
     readonly buildingName?: string | undefined;
+    /**
+     * Materializes exact evaluated Product Bodies for supported typed routes
+     * such as Earthworks Fill. Supplying this option does not opt unsupported
+     * products into the proxy fallback.
+     */
+    readonly bodyEvaluator?: csg.Evaluator | undefined;
     /**
      * Enables the proxy route: an unrouted geometry-bearing element is
      * materialized through this evaluator and exported as an
-     * IfcBuildingElementProxy (tessellated, world-frame body). Without it,
+     * IfcBuildingElementProxy (tessellated authoritative body). Without it,
      * unrouted types stay a hard FAMILIES_UNSUPPORTED_TYPE error. The
      * evaluator's handles stay borrowed; the adapter clones what it hands the
-     * model.
+     * model. For backward compatibility it also supplies the body evaluator when
+     * `bodyEvaluator` is absent.
      */
     readonly proxyEvaluator?: csg.Evaluator | undefined;
 }

package/dist/ifc-writer/assemblyWriter.d.ts

@@ -1,6 +1,11 @@
 import { IfcWriter } from './ifcWriter.js';
 import { IfcGuid } from '../identity/ifcGuid.js';
-/** IfcAssemblyPlaceEnum values; SITE for in-place assemblies, FACTORY for prefabricated. */
+/**
+ * Enumeration literals transcribed verbatim from `IfcAssemblyPlaceEnum` in the
+ * buildingSMART IFC 4.3 ADD2 (`IFC4X3_ADD2`) EXPRESS schema:
+ * https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/IFC4X3_ADD2.exp
+ * SITE denotes in-place assemblies; FACTORY denotes prefabricated assemblies.
+ */
 export type AssemblyPlaceIfc = 'SITE' | 'FACTORY' | 'NOTDEFINED';
 /** IfcElementAssemblyTypeEnum values (IFC4). */
 export type ElementAssemblyPredefinedTypeIfc = 'ACCESSORY_ASSEMBLY' | 'ARCH' | 'BEAM_GRID' | 'BRACED_FRAME' | 'GIRDER' | 'REINFORCEMENT_UNIT' | 'RIGID_FRAME' | 'SLAB_FIELD' | 'TRUSS' | 'USERDEFINED' | 'NOTDEFINED';

package/dist/ifc-writer/connectivityWriter.d.ts

@@ -1,6 +1,11 @@
 import { IfcWriter } from './ifcWriter.js';
 import { IfcGuid } from '../identity/ifcGuid.js';
-/** IfcConnectionTypeEnum values used by IfcRelConnectsPathElements path ends. */
+/**
+ * Enumeration literals transcribed verbatim from `IfcConnectionTypeEnum` in
+ * the buildingSMART IFC 4.3 ADD2 (`IFC4X3_ADD2`) EXPRESS schema:
+ * https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/IFC4X3_ADD2.exp
+ * These values identify the path ends used by `IfcRelConnectsPathElements`.
+ */
 export type PathConnectionTypeIfc = 'ATSTART' | 'ATEND' | 'ATPATH' | 'NOTDEFINED';
 /**
  * Emits an IfcRelConnectsElements recording a physical connection between two

package/dist/ifc-writer/entityWriter.d.ts

@@ -1,10 +1,12 @@
 import { IfcWriter } from './ifcWriter.js';
 import { IfcGuid } from '../identity/ifcGuid.js';
+import { SiteSpec, SpatialPlacementSpec } from '../specs/spatialSpec.js';
 export declare function writeProject(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, unitAssignmentId: number, geomContextId: number): number;
-export declare function writeSite(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number): {
+export declare function writeSite(w: IfcWriter, guid: IfcGuid, spec: SiteSpec, ownerHistoryId: number, parentPlacementId?: number | null): {
     entityId: number;
     placementId: number;
 };
+export declare function writeSpatialLocalPlacement(w: IfcWriter, spec: SpatialPlacementSpec, parentPlacementId: number | null): number;
 export declare function writeBuilding(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, parentPlacementId: number | null): {
     entityId: number;
     placementId: number;

package/dist/ifc-writer/infrastructureWriter.d.ts

@@ -0,0 +1,12 @@
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { BridgePartSpec, BridgeSpec, EarthworksFillSpec } from '../specs/infrastructureSpec.js';
+import { IfcWriter } from './ifcWriter.js';
+export declare function writeBridge(w: IfcWriter, guid: IfcGuid, spec: BridgeSpec, ownerHistoryId: number, parentPlacementId: number | null): {
+    entityId: number;
+    placementId: number;
+};
+export declare function writeBridgePart(w: IfcWriter, guid: IfcGuid, spec: BridgePartSpec, ownerHistoryId: number, parentPlacementId: number | null): {
+    entityId: number;
+    placementId: number;
+};
+export declare function writeEarthworksFillEntity(w: IfcWriter, guid: IfcGuid, spec: EarthworksFillSpec, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;

package/dist/ifc-writer/proxyWriter.d.ts

@@ -1,17 +1,13 @@
 import { IfcWriter } from './ifcWriter.js';
-import { TessellationOutput } from './tessellationWriter.js';
 import { IfcGuid } from '../identity/ifcGuid.js';
 import { ProxySpec } from '../specs/proxySpec.js';
-export interface ProxyRepresentationIds {
-    readonly localPlacementId: number;
-    readonly productDefinitionShapeId: number;
-    readonly tessellation: TessellationOutput;
-}
+import { TessellatedProductRepresentationIds } from './tessellatedProductWriter.js';
+export type ProxyRepresentationIds = TessellatedProductRepresentationIds;
 /**
  * Writes the IfcLocalPlacement (at origin, relative to parentPlacementId) and a
- * tessellated body (IfcTriangulatedFaceSet) for a proxy's solid. The solid is
- * exported in its authored coordinate frame; placement is identity because proxy
- * solids carry their own world positions in the brepjs geometry.
+ * tessellated body (IfcTriangulatedFaceSet) for a proxy's solid. Solid
+ * coordinates are emitted as supplied; the caller is responsible for matching
+ * them to the containing spatial structure's frame.
  */
 export declare function writeProxyGeometry(w: IfcWriter, spec: ProxySpec, geomSubContextId: number, parentPlacementId: number | null): ProxyRepresentationIds;
 export declare function writeProxyEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: string, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;

package/dist/ifc-writer/spaceWriter.d.ts

@@ -7,5 +7,10 @@ export interface SpaceRepresentationIds {
 }
 export declare function writeSpaceGeometry(w: IfcWriter, spec: SpaceSpec, geomSubContextId: number, parentPlacementId: number | null): SpaceRepresentationIds;
 export declare function writeSpaceEntity(w: IfcWriter, guid: IfcGuid, name: string, longName: string | null, _predefinedType: SpacePredefinedType, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;
+/**
+ * Enumeration literals transcribed verbatim from `IfcPhysicalOrVirtualEnum` in
+ * the buildingSMART IFC 4.3 ADD2 (`IFC4X3_ADD2`) EXPRESS schema:
+ * https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/IFC4X3_ADD2.exp
+ */
 export type SpaceBoundaryConnectionType = 'PHYSICAL' | 'VIRTUAL' | 'NOTDEFINED';
 export declare function writeRelSpaceBoundary(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, spaceExpressId: number, elementExpressId: number, connectionType: SpaceBoundaryConnectionType): void;

package/dist/ifc-writer/tessellatedProductWriter.d.ts

@@ -0,0 +1,10 @@
+import { ValidSolid } from 'brepjs';
+import { IfcWriter } from './ifcWriter.js';
+import { TessellationOutput } from './tessellationWriter.js';
+export interface TessellatedProductRepresentationIds {
+    readonly localPlacementId: number;
+    readonly productDefinitionShapeId: number;
+    readonly tessellation: TessellationOutput;
+}
+/** Write a tessellated body in the coordinate frame supplied by the caller. */
+export declare function writeTessellatedProductGeometry(w: IfcWriter, solid: ValidSolid, geomSubContextId: number, parentPlacementId: number | null): TessellatedProductRepresentationIds;

package/dist/import/importedModel.d.ts

@@ -48,13 +48,16 @@ export interface ImportedClassification {
     readonly code: string;
     readonly description?: string | undefined;
 }
-export type ImportedElementCategory = 'WALL' | 'SLAB' | 'BEAM' | 'COLUMN' | 'DOOR' | 'WINDOW' | 'OPENING' | 'SPACE' | 'ROOF' | 'CURTAIN_WALL' | 'FOOTING' | 'PILE' | 'STAIR' | 'RAMP' | 'RAILING' | 'COVERING' | 'ELEMENT_ASSEMBLY' | 'PROXY';
+export type ImportedElementCategory = 'WALL' | 'SLAB' | 'BEAM' | 'COLUMN' | 'DOOR' | 'WINDOW' | 'OPENING' | 'SPACE' | 'ROOF' | 'CURTAIN_WALL' | 'FOOTING' | 'PILE' | 'STAIR' | 'RAMP' | 'RAILING' | 'COVERING' | 'ELEMENT_ASSEMBLY' | 'EARTHWORKS_FILL' | 'PROXY';
 export interface ImportedElement {
     readonly expressId: number;
     readonly guid: IfcGuid;
     readonly name: string;
     readonly category: ImportedElementCategory;
     readonly predefinedType?: string | undefined;
+    /** Express id of the directly containing spatial structure. */
+    readonly spatialStructureExpressId?: number | undefined;
+    /** @deprecated Use `spatialStructureExpressId`; retained as a compatibility alias. */
     readonly storeyExpressId?: number | undefined;
     readonly geometry: ImportedGeometry;
     readonly psets: readonly ImportedPset[];
@@ -69,7 +72,7 @@ export interface ImportedSpatialNode {
     readonly expressId: number;
     readonly guid: IfcGuid;
     readonly name: string;
-    readonly category: 'PROJECT' | 'SITE' | 'BUILDING' | 'STOREY';
+    readonly category: 'PROJECT' | 'SITE' | 'BUILDING' | 'STOREY' | 'BRIDGE' | 'BRIDGE_PART';
     readonly elevationMm?: number | undefined;
     readonly children: readonly ImportedSpatialNode[];
     readonly containedElements: readonly number[];

package/dist/import/spatialTree.d.ts

@@ -1,9 +1,9 @@
 import { SpfReader } from './spfReader.js';
 /**
  * A reconstructed spatial-structure node. The tree mirrors the IFC spatial
- * containment hierarchy (`IfcProject → IfcSite → IfcBuilding → IfcBuildingStorey`)
+ * containment hierarchy (including building and IFC4X3 civil spatial nodes)
  * rebuilt from `IfcRelAggregates`, with physical elements attached to their
- * storey via `IfcRelContainedInSpatialStructure`.
+ * direct spatial structure via `IfcRelContainedInSpatialStructure`.
  *
  * Nodes are addressable by {@link SpatialNode.guid} (the IFC `GlobalId`).
  */
@@ -11,7 +11,7 @@ export interface SpatialNode {
     readonly expressId: number;
     readonly guid: string;
     readonly name: string;
-    readonly category: 'PROJECT' | 'SITE' | 'BUILDING' | 'STOREY';
+    readonly category: 'PROJECT' | 'SITE' | 'BUILDING' | 'STOREY' | 'BRIDGE' | 'BRIDGE_PART';
     /** Storey elevation in mm; present on `STOREY` nodes only. */
     readonly elevation?: number | undefined;
     readonly children: readonly SpatialNode[];

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { BimModel, type ElementIdentityOptions, type OpeningIdentityOptions, } from './model/bimModel.js';
 export type { BimTreeNode, BimTreeSummary } from './model/treeSummary.js';
 export { placedSolids } from './elementFns/placedGeometry.js';
+export type { PlacedSolidsOptions } from './elementFns/placedGeometry.js';
+export type { FrameInput } from './import/placement.js';
 export { toIfc, toIfcValidated } from './serialize/toIfc.js';
 export type { ValidatedIfcResult } from './serialize/toIfc.js';
 export { setIfcWasmLocateFile } from './ifcRuntime.js';
@@ -27,6 +29,7 @@ export { parseElementAssemblySpec } from './specs/assemblySpec.js';
 export { parseZoneSpec, parseSystemSpec } from './specs/groupSpec.js';
 export { parseSurfaceStyleSpec } from './specs/styleSpec.js';
 export { parseDoorSpec, parseWindowSpec, parseSlabOpeningInput } from './specs/openingSpec.js';
+export { parseBridgeSpec, parseBridgePartSpec } from './specs/infrastructureSpec.js';
 export { newIfcGuid, isValidIfcGuid } from './identity/ifcGuid.js';
 export { deriveIfcGuid, deriveIfcGuidSync } from './identity/guidDerivation.js';
 export { makeLocalIdCounter } from './identity/localId.js';
@@ -69,7 +72,8 @@ export type { AssemblyPlaceIfc, ElementAssemblyPredefinedTypeIfc, } from './ifc-
 export type { PathConnectionTypeIfc } from './ifc-writer/connectivityWriter.js';
 export type { DoorSpec, WindowSpec, SlabOpeningInput } from './specs/openingSpec.js';
 export type { ProxySpec } from './specs/proxySpec.js';
-export type { ProjectSpec, ProjectCrs, SiteSpec, BuildingSpec, StoreySpec, } from './specs/spatialSpec.js';
+export type { BridgeSpec, BridgePartSpec, CivilSpatialSpec, BridgePredefinedType, BridgePartPredefinedType, EarthworksFillSpec, EarthworksFillPredefinedType, FacilityUsageType, } from './specs/infrastructureSpec.js';
+export type { ProjectSpec, ProjectCrs, IfcElementCompositionType, SpatialPlacementSpec, SiteSpec, BuildingSpec, StoreySpec, } from './specs/spatialSpec.js';
 export type { BimCategory, BimElement, AnyBimElement, OpeningSpec, WallOpeningSpec, SlabOpeningSpec, } from './types/bimTypes.js';
 export { isWallOpening, isSlabOpening } from './types/bimTypes.js';
 export type { BimRelationship, AssociatesMaterialRel, AssociatesClassificationRel, VoidsWallRel, VoidsSlabRel, FillsOpeningRel, SpaceBoundaryRel, NestsRel, ConnectsElementsRel, ConnectsPathElementsRel, CoversElementRel, AssignsToGroupRel, } from './types/relationships.js';

package/dist/model/bimModel.d.ts

@@ -23,6 +23,7 @@ import { ElementAssemblySpec } from '../specs/assemblySpec.js';
 import { ZoneSpec, SystemSpec } from '../specs/groupSpec.js';
 import { SurfaceStyleSpec } from '../ifc-writer/styleWriter.js';
 import { ProjectSpec, SiteSpec, BuildingSpec, StoreySpec } from '../specs/spatialSpec.js';
+import { BridgePartSpec, BridgeSpec, EarthworksFillSpec } from '../specs/infrastructureSpec.js';
 /** Optional identity override for created elements: a stable key (e.g. a
  *  families key path) that replaces the positional GlobalId derivation. */
 export interface ElementIdentityOptions {
@@ -35,9 +36,14 @@ export interface OpeningIdentityOptions extends ElementIdentityOptions {
 }
 export declare class BimModel {
     #private;
-    init(spec: ProjectSpec): Result<LocalId, BimError>;
+    init(spec: ProjectSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     [Symbol.dispose](): void;
     addSite(spec: SiteSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
+    addBridge(spec: BridgeSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
+    addBridgePart(spec: BridgePartSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
+    /** Adds a typed IfcEarthworksFill body. Ownership of `spec.solid` transfers
+     * to the model only when this call succeeds. */
+    addEarthworksFill(spec: EarthworksFillSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addBuilding(spec: BuildingSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addStorey(spec: StoreySpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
     addWall(spec: WallSpec, options?: ElementIdentityOptions): Result<LocalId, BimError>;
@@ -150,6 +156,9 @@ export declare class BimModel {
     getWalls(): BimElement<'WALL'>[];
     getSlabs(): BimElement<'SLAB'>[];
     getBeams(): BimElement<'BEAM'>[];
+    getBridges(): BimElement<'BRIDGE'>[];
+    getBridgeParts(): BimElement<'BRIDGE_PART'>[];
+    getEarthworksFills(): BimElement<'EARTHWORKS_FILL'>[];
     getColumns(): BimElement<'COLUMN'>[];
     getProxies(): BimElement<'PROXY'>[];
     getSpaces(): BimElement<'SPACE'>[];

package/dist/specs/assemblySpec.d.ts

@@ -1,6 +1,11 @@
 import { BimError } from '../errors/bimError.js';
 import { Result } from 'brepjs';
 export type AssemblyPredefinedType = 'ACCESSORY_ASSEMBLY' | 'ARCH' | 'BEAM_GRID' | 'BRACED_FRAME' | 'GIRDER' | 'REINFORCEMENT_UNIT' | 'RIGID_FRAME' | 'SLAB_FIELD' | 'TRUSS' | 'USERDEFINED' | 'NOTDEFINED';
+/**
+ * Enumeration literals transcribed verbatim from `IfcAssemblyPlaceEnum` in the
+ * buildingSMART IFC 4.3 ADD2 (`IFC4X3_ADD2`) EXPRESS schema:
+ * https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/IFC4X3_ADD2.exp
+ */
 export type AssemblyPlace = 'SITE' | 'FACTORY' | 'NOTDEFINED';
 /**
  * A grouping container (IfcElementAssembly). Carries no geometry of its own;

package/dist/specs/curtainWallSpec.d.ts

@@ -1,6 +1,11 @@
 import { BimError } from '../errors/bimError.js';
 import { Result } from 'brepjs';
 import { ClassificationRef } from '../types/classificationTypes.js';
+/**
+ * Enumeration literals transcribed verbatim from `IfcCurtainWallTypeEnum` in
+ * the buildingSMART IFC 4.3 ADD2 (`IFC4X3_ADD2`) EXPRESS schema:
+ * https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/IFC4X3_ADD2.exp
+ */
 export type CurtainWallPredefinedType = 'NOTDEFINED' | 'USERDEFINED';
 /**
  * A planar curtain wall, modelled as a rectangular grid of glazing panels

package/dist/specs/infrastructureSpec.d.ts

@@ -0,0 +1,40 @@
+import { Result, ValidSolid } from 'brepjs';
+import { BimError } from '../errors/bimError.js';
+import { IfcElementCompositionType, SpatialPlacementSpec } from './spatialSpec.js';
+/**
+ * IFC enumeration literals in this module are transcribed verbatim from the
+ * buildingSMART IFC 4.3 ADD2 (`IFC4X3_ADD2`) EXPRESS schema, specifically
+ * `IfcBridgeTypeEnum`, `IfcBridgePartTypeEnum`, `IfcFacilityUsageEnum`, and
+ * `IfcEarthworksFillTypeEnum`:
+ * https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/IFC4X3_ADD2.exp
+ *
+ * The Families-facing civil vocabulary stays target-independent; projection
+ * into these IFC-owned keywords occurs in `familiesAdapter.ts`.
+ */
+export type BridgePredefinedType = 'ARCHED' | 'CABLE_STAYED' | 'CANTILEVER' | 'CULVERT' | 'FRAMEWORK' | 'GIRDER' | 'SUSPENSION' | 'TRUSS' | 'USERDEFINED' | 'NOTDEFINED';
+export type BridgePartPredefinedType = 'ABUTMENT' | 'DECK' | 'DECK_SEGMENT' | 'FOUNDATION' | 'PIER' | 'PIER_SEGMENT' | 'PYLON' | 'SUBSTRUCTURE' | 'SUPERSTRUCTURE' | 'SURFACESTRUCTURE' | 'USERDEFINED' | 'NOTDEFINED';
+export type FacilityUsageType = 'LATERAL' | 'LONGITUDINAL' | 'REGION' | 'VERTICAL' | 'USERDEFINED' | 'NOTDEFINED';
+export type EarthworksFillPredefinedType = 'BACKFILL' | 'COUNTERWEIGHT' | 'EMBANKMENT' | 'SLOPEFILL' | 'SUBGRADE' | 'SUBGRADEBED' | 'TRANSITIONSECTION' | 'USERDEFINED' | 'NOTDEFINED';
+export interface CivilSpatialSpec extends SpatialPlacementSpec {
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly compositionType?: IfcElementCompositionType | undefined;
+}
+export interface BridgeSpec extends CivilSpatialSpec {
+    readonly predefinedType?: BridgePredefinedType | undefined;
+}
+export interface BridgePartSpec extends CivilSpatialSpec {
+    readonly usageType: FacilityUsageType;
+    readonly predefinedType?: BridgePartPredefinedType | undefined;
+}
+/** Typed arbitrary body for IfcEarthworksFill. The model takes ownership of
+ * `solid` on a successful add and disposes it with the model. */
+export interface EarthworksFillSpec {
+    readonly name: string;
+    readonly solid: ValidSolid;
+    readonly materialName: string;
+    readonly predefinedType?: EarthworksFillPredefinedType | undefined;
+    readonly customProperties?: Readonly<Record<string, Readonly<Record<string, string | number | boolean>>>> | undefined;
+}
+export declare function parseBridgeSpec(input: unknown): Result<BridgeSpec, BimError>;
+export declare function parseBridgePartSpec(input: unknown): Result<BridgePartSpec, BimError>;

package/dist/specs/proxySpec.d.ts

@@ -9,9 +9,11 @@ import { ValidSolid } from 'brepjs';
 export interface ProxySpec {
     readonly name: string;
     /**
-     * The proxy body. OWNERSHIP TRANSFERS to the BimModel on addProxy(): the model
-     * disposes this handle when it is disposed, so the caller MUST NOT dispose it
-     * itself (no `using`) — doing so double-frees the underlying WASM shape.
+     * The proxy body. Its coordinates are written as supplied under an identity
+     * placement relative to its containing spatial structure. OWNERSHIP TRANSFERS
+     * to the BimModel on addProxy(): the model disposes this handle when it is
+     * disposed, so the caller MUST NOT dispose it itself (no `using`) — doing so
+     * double-frees the underlying WASM shape.
      */
     readonly solid: ValidSolid;
     readonly materialName?: string | undefined;

package/dist/specs/spatialSpec.d.ts

@@ -1,3 +1,6 @@
+import { Result } from 'brepjs';
+import { z, RefinementCtx } from 'zod';
+import { BimError } from '../errors/bimError.js';
 export interface ProjectSpec {
     readonly name: string;
     readonly description?: string;
@@ -34,10 +37,29 @@ export interface ProjectCrs {
     readonly xAxisOrdinate?: number | undefined;
     readonly scale?: number | undefined;
 }
-export interface SiteSpec {
+/**
+ * Enumeration literals transcribed verbatim from `IfcElementCompositionEnum`
+ * in the buildingSMART IFC 4.3 ADD2 (`IFC4X3_ADD2`) EXPRESS schema:
+ * https://standards.buildingsmart.org/IFC/RELEASE/IFC4_3/HTML/IFC4X3_ADD2.exp
+ */
+export type IfcElementCompositionType = 'COMPLEX' | 'ELEMENT' | 'PARTIAL';
+export interface SpatialPlacementSpec {
+    readonly origin?: [number, number, number] | undefined;
+    readonly axisX?: [number, number, number] | undefined;
+    readonly axisZ?: [number, number, number] | undefined;
+}
+export interface SiteSpec extends SpatialPlacementSpec {
     readonly name: string;
     readonly description?: string;
+    readonly compositionType?: IfcElementCompositionType | undefined;
 }
+export declare const spatialPlacementFields: {
+    origin: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    axisX: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    axisZ: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+};
+export declare function validateSpatialAxes(data: SpatialPlacementSpec, ctx: RefinementCtx): void;
+export declare function parseSiteSpec(input: unknown): Result<SiteSpec, BimError>;
 export interface BuildingSpec {
     readonly name: string;
     readonly description?: string;

package/dist/types/bimTypes.d.ts

@@ -19,7 +19,8 @@ import { CoveringSpec } from '../specs/coveringSpec.js';
 import { ElementAssemblySpec } from '../specs/assemblySpec.js';
 import { ZoneSpec, SystemSpec } from '../specs/groupSpec.js';
 import { ProjectSpec, SiteSpec, BuildingSpec, StoreySpec } from '../specs/spatialSpec.js';
-export type BimCategory = 'WALL' | 'SLAB' | 'BEAM' | 'COLUMN' | 'OPENING' | 'DOOR' | 'WINDOW' | 'PROXY' | 'SPACE' | 'ROOF' | 'CURTAIN_WALL' | 'FOOTING' | 'PILE' | 'STAIR' | 'RAMP' | 'RAILING' | 'COVERING' | 'ELEMENT_ASSEMBLY' | 'ZONE' | 'SYSTEM' | 'PROJECT' | 'SITE' | 'BUILDING' | 'STOREY';
+import { BridgePartSpec, BridgeSpec, EarthworksFillSpec } from '../specs/infrastructureSpec.js';
+export type BimCategory = 'WALL' | 'SLAB' | 'BEAM' | 'COLUMN' | 'OPENING' | 'DOOR' | 'WINDOW' | 'PROXY' | 'SPACE' | 'ROOF' | 'CURTAIN_WALL' | 'FOOTING' | 'PILE' | 'STAIR' | 'RAMP' | 'RAILING' | 'COVERING' | 'ELEMENT_ASSEMBLY' | 'ZONE' | 'SYSTEM' | 'PROJECT' | 'SITE' | 'BRIDGE' | 'BRIDGE_PART' | 'EARTHWORKS_FILL' | 'BUILDING' | 'STOREY';
 export type WallOpeningSpec = {
     readonly kind: 'WALL_OPENING';
     readonly width: number;
@@ -37,8 +38,8 @@ export type SlabOpeningSpec = {
 export type OpeningSpec = WallOpeningSpec | SlabOpeningSpec;
 export declare function isWallOpening(spec: OpeningSpec): spec is WallOpeningSpec;
 export declare function isSlabOpening(spec: OpeningSpec): spec is SlabOpeningSpec;
-export type BimSpecFor<C extends BimCategory> = C extends 'WALL' ? WallSpec : C extends 'SLAB' ? SlabSpec : C extends 'BEAM' ? BeamSpec : C extends 'COLUMN' ? ColumnSpec : C extends 'OPENING' ? OpeningSpec : C extends 'DOOR' ? DoorSpec : C extends 'WINDOW' ? WindowSpec : C extends 'PROXY' ? ProxySpec : C extends 'SPACE' ? SpaceSpec : C extends 'ROOF' ? RoofSpec : C extends 'CURTAIN_WALL' ? CurtainWallSpec : C extends 'FOOTING' ? FootingSpec : C extends 'PILE' ? PileSpec : C extends 'STAIR' ? StairSpec : C extends 'RAMP' ? RampSpec : C extends 'RAILING' ? RailingSpec : C extends 'COVERING' ? CoveringSpec : C extends 'ELEMENT_ASSEMBLY' ? ElementAssemblySpec : C extends 'ZONE' ? ZoneSpec : C extends 'SYSTEM' ? SystemSpec : C extends 'PROJECT' ? ProjectSpec : C extends 'SITE' ? SiteSpec : C extends 'BUILDING' ? BuildingSpec : C extends 'STOREY' ? StoreySpec : never;
-export type BimGeometryFor<C extends BimCategory> = C extends 'CURTAIN_WALL' ? CurtainWallGrid : C extends 'WALL' | 'SLAB' | 'BEAM' | 'COLUMN' | 'PROXY' | 'SPACE' | 'ROOF' | 'FOOTING' | 'PILE' | 'RAILING' | 'COVERING' ? ValidSolid : null;
+export type BimSpecFor<C extends BimCategory> = C extends 'WALL' ? WallSpec : C extends 'SLAB' ? SlabSpec : C extends 'BEAM' ? BeamSpec : C extends 'COLUMN' ? ColumnSpec : C extends 'OPENING' ? OpeningSpec : C extends 'DOOR' ? DoorSpec : C extends 'WINDOW' ? WindowSpec : C extends 'PROXY' ? ProxySpec : C extends 'SPACE' ? SpaceSpec : C extends 'ROOF' ? RoofSpec : C extends 'CURTAIN_WALL' ? CurtainWallSpec : C extends 'FOOTING' ? FootingSpec : C extends 'PILE' ? PileSpec : C extends 'STAIR' ? StairSpec : C extends 'RAMP' ? RampSpec : C extends 'RAILING' ? RailingSpec : C extends 'COVERING' ? CoveringSpec : C extends 'ELEMENT_ASSEMBLY' ? ElementAssemblySpec : C extends 'ZONE' ? ZoneSpec : C extends 'SYSTEM' ? SystemSpec : C extends 'PROJECT' ? ProjectSpec : C extends 'SITE' ? SiteSpec : C extends 'BRIDGE' ? BridgeSpec : C extends 'BRIDGE_PART' ? BridgePartSpec : C extends 'EARTHWORKS_FILL' ? EarthworksFillSpec : C extends 'BUILDING' ? BuildingSpec : C extends 'STOREY' ? StoreySpec : never;
+export type BimGeometryFor<C extends BimCategory> = C extends 'CURTAIN_WALL' ? CurtainWallGrid : C extends 'WALL' | 'SLAB' | 'BEAM' | 'COLUMN' | 'PROXY' | 'EARTHWORKS_FILL' | 'SPACE' | 'ROOF' | 'FOOTING' | 'PILE' | 'RAILING' | 'COVERING' ? ValidSolid : null;
 export interface BimElement<C extends BimCategory> {
     readonly guid: IfcGuid;
     readonly localId: LocalId;
@@ -46,4 +47,4 @@ export interface BimElement<C extends BimCategory> {
     readonly spec: BimSpecFor<C>;
     readonly geometry: BimGeometryFor<C>;
 }
-export type AnyBimElement = BimElement<'WALL'> | BimElement<'SLAB'> | BimElement<'BEAM'> | BimElement<'COLUMN'> | BimElement<'OPENING'> | BimElement<'DOOR'> | BimElement<'WINDOW'> | BimElement<'PROXY'> | BimElement<'SPACE'> | BimElement<'ROOF'> | BimElement<'CURTAIN_WALL'> | BimElement<'FOOTING'> | BimElement<'PILE'> | BimElement<'STAIR'> | BimElement<'RAMP'> | BimElement<'RAILING'> | BimElement<'COVERING'> | BimElement<'ELEMENT_ASSEMBLY'> | BimElement<'ZONE'> | BimElement<'SYSTEM'> | BimElement<'PROJECT'> | BimElement<'SITE'> | BimElement<'BUILDING'> | BimElement<'STOREY'>;
+export type AnyBimElement = BimElement<'WALL'> | BimElement<'SLAB'> | BimElement<'BEAM'> | BimElement<'COLUMN'> | BimElement<'OPENING'> | BimElement<'DOOR'> | BimElement<'WINDOW'> | BimElement<'PROXY'> | BimElement<'SPACE'> | BimElement<'ROOF'> | BimElement<'CURTAIN_WALL'> | BimElement<'FOOTING'> | BimElement<'PILE'> | BimElement<'STAIR'> | BimElement<'RAMP'> | BimElement<'RAILING'> | BimElement<'COVERING'> | BimElement<'ELEMENT_ASSEMBLY'> | BimElement<'ZONE'> | BimElement<'SYSTEM'> | BimElement<'PROJECT'> | BimElement<'SITE'> | BimElement<'BRIDGE'> | BimElement<'BRIDGE_PART'> | BimElement<'EARTHWORKS_FILL'> | BimElement<'BUILDING'> | BimElement<'STOREY'>;

package/dist/validation/roundTrip.d.ts

@@ -4,7 +4,7 @@ import { ValidationIssue, ValidationReport } from './severity.js';
  * across a write→read→re-write round-trip. The keys double as `typeCounts` map
  * keys so callers can assert on stable names rather than numeric web-ifc codes.
  */
-export declare const KEY_ENTITY_NAMES: readonly ["IfcProject", "IfcWall", "IfcSlab", "IfcBeam", "IfcColumn", "IfcRelContainedInSpatialStructure", "IfcRelAggregates", "IfcPropertySet"];
+export declare const KEY_ENTITY_NAMES: readonly ["IfcProject", "IfcWall", "IfcSlab", "IfcBeam", "IfcColumn", "IfcEarthworksFill", "IfcRelContainedInSpatialStructure", "IfcRelAggregates", "IfcPropertySet"];
 export type KeyEntityName = (typeof KEY_ENTITY_NAMES)[number];
 export interface EntityCounts {
     /** Total number of entity lines in the model. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-bim",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
   "keywords": [
     "bim",