brepjs-bim 0.1.0

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

@@ -0,0 +1,12 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { CoveringSpec, CoveringPredefinedType } from '../specs/coveringSpec.js';
+export interface CoveringRepresentationIds {
+    localPlacementId: number;
+    productDefinitionShapeId: number;
+    /** Express ID of the body representation item (the extrusion), for styling. */
+    bodyItemId: number;
+}
+export declare function writeCoveringGeometry(w: IfcWriter, spec: CoveringSpec, geomSubContextId: number, parentPlacementId: number | null): CoveringRepresentationIds;
+export declare function writeCoveringEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: CoveringPredefinedType, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;
+export declare function writeRelCoversBldgElements(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, relatingBuildingElementId: number, relatedCoveringIds: readonly number[]): number;

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

@@ -0,0 +1,23 @@
+import { IfcWriter } from './ifcWriter.js';
+import { CurtainWallSpec } from '../specs/curtainWallSpec.js';
+import { CurtainWallGrid } from '../elementFns/curtainWallFns.js';
+export interface CurtainWallWriteResult {
+    /** Express ID of the IfcCurtainWall assembly. */
+    readonly curtainWallId: number;
+    /** Express IDs of the emitted IfcPlate panels. */
+    readonly plateIds: readonly number[];
+    /** Express IDs of the emitted IfcMember mullions. */
+    readonly memberIds: readonly number[];
+    /** Express ID of the IfcRelAggregates linking the wall to its parts. */
+    readonly aggregatesId: number;
+}
+/**
+ * Serializes a curtain wall: an IfcCurtainWall assembly (no own geometry) that
+ * aggregates one IfcPlate per glazing panel and one IfcMember per mullion via a
+ * single IfcRelAggregates. The wall carries an IfcLocalPlacement at its world
+ * origin/orientation; each plate and member is placed relative to it.
+ *
+ * GlobalIds are derived deterministically from `stableKey` so re-serializing an
+ * identical wall yields identical IDs for every part and the aggregation rel.
+ */
+export declare function writeCurtainWall(w: IfcWriter, spec: CurtainWallSpec, grid: CurtainWallGrid, stableKey: string, name: string, ownerHistoryId: number, geomSubContextId: number, parentPlacementId: number | null): CurtainWallWriteResult;

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

@@ -0,0 +1,21 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.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): {
+    entityId: number;
+    placementId: number;
+};
+export declare function writeBuilding(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, parentPlacementId: number | null): {
+    entityId: number;
+    placementId: number;
+};
+export declare function writeStorey(w: IfcWriter, guid: IfcGuid, name: string, elevationMm: number, ownerHistoryId: number, parentPlacementId: number | null): {
+    entityId: number;
+    placementId: number;
+};
+export declare function writeWallEntity(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;
+export declare function writeSlabEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: 'FLOOR' | 'ROOF' | 'LANDING' | 'BASESLAB', ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;
+export type BeamPredefinedTypeIfc = 'BEAM' | 'JOIST' | 'LINTEL' | 'HOLLOWCORE' | 'PURLIN' | 'RAFTER' | 'SPANDREL' | 'T_BEAM' | 'NOTDEFINED';
+export declare function writeBeamEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: BeamPredefinedTypeIfc, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;
+export type ColumnPredefinedTypeIfc = 'COLUMN' | 'PILASTER' | 'NOTDEFINED';
+export declare function writeColumnEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: ColumnPredefinedTypeIfc, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;

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

@@ -0,0 +1,11 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { FootingSpec, PileSpec, FootingPredefinedType, PilePredefinedType, PileConstructionType } from '../specs/foundationSpec.js';
+export interface FoundationRepresentationIds {
+    localPlacementId: number;
+    productDefinitionShapeId: number;
+}
+export declare function writeFootingGeometry(w: IfcWriter, spec: FootingSpec, geomSubContextId: number, parentPlacementId: number | null): FoundationRepresentationIds;
+export declare function writePileGeometry(w: IfcWriter, spec: PileSpec, geomSubContextId: number, parentPlacementId: number | null): FoundationRepresentationIds;
+export declare function writeFootingEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: FootingPredefinedType, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;
+export declare function writePileEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: PilePredefinedType, constructionType: PileConstructionType | null, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;

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

@@ -0,0 +1,25 @@
+import { IfcWriter } from './ifcWriter.js';
+import { WallSpec } from '../specs/wallSpec.js';
+import { SlabSpec } from '../specs/slabSpec.js';
+import { BeamSpec } from '../specs/beamSpec.js';
+import { ColumnSpec } from '../specs/columnSpec.js';
+import { RoofSpec } from '../specs/roofSpec.js';
+import { Profile } from '../specs/profile.js';
+export interface WallRepresentationIds {
+    localPlacementId: number;
+    productDefinitionShapeId: number;
+}
+export interface SlabRepresentationIds {
+    localPlacementId: number;
+    productDefinitionShapeId: number;
+}
+export interface LinearElementRepresentationIds {
+    localPlacementId: number;
+    productDefinitionShapeId: number;
+}
+export declare function writeWallGeometry(w: IfcWriter, spec: WallSpec, geomSubContextId: number, parentPlacementId: number | null): WallRepresentationIds;
+export declare function writeSlabGeometry(w: IfcWriter, spec: SlabSpec, geomSubContextId: number, parentPlacementId: number | null): SlabRepresentationIds;
+export declare function writeRoofGeometry(w: IfcWriter, spec: RoofSpec, geomSubContextId: number, parentPlacementId: number | null): SlabRepresentationIds;
+export declare function writeProfile(w: IfcWriter, profile: Profile): number;
+export declare function writeBeamGeometry(w: IfcWriter, spec: BeamSpec, geomSubContextId: number, parentPlacementId: number | null): LinearElementRepresentationIds;
+export declare function writeColumnGeometry(w: IfcWriter, spec: ColumnSpec, geomSubContextId: number, parentPlacementId: number | null): LinearElementRepresentationIds;

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

@@ -0,0 +1,19 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+/**
+ * Emits an IfcZone grouping object. `longName` (a descriptive label such as
+ * "Top Floor Thermal Zone") maps to the entity Description since IfcZone has no
+ * LongName attribute; `objectType` maps to ObjectType.
+ */
+export declare function writeZoneEntity(w: IfcWriter, guid: IfcGuid, name: string, longName: string | null, objectType: string | null, ownerHistoryId: number): number;
+/**
+ * Emits an IfcSystem grouping object. As with {@link writeZoneEntity}, `longName`
+ * maps to Description and `objectType` to ObjectType.
+ */
+export declare function writeSystemEntity(w: IfcWriter, guid: IfcGuid, name: string, longName: string | null, objectType: string | null, ownerHistoryId: number): number;
+/**
+ * Links a group (zone or system) to its members via IfcRelAssignsToGroup.
+ * `groupExpressId` becomes RelatingGroup; each member id becomes a RelatedObjects
+ * reference. Member entities must already be written so their express ids exist.
+ */
+export declare function writeRelAssignsToGroup(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, groupExpressId: number, memberExpressIds: readonly number[]): void;

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

@@ -0,0 +1,31 @@
+import { IfcWriter } from './ifcWriter.js';
+import { OwnerHistoryAuthor } from './ownerHistoryWriter.js';
+import { IfcSchema } from './schemaVersion.js';
+export interface HeaderIds {
+    ownerHistoryId: number;
+    geomContextId: number;
+    geomSubContextId: number;
+    unitAssignmentId: number;
+}
+export interface BimModelMeta {
+    applicationName: string;
+    applicationVersion: string;
+    /** MVD ViewDefinition declared in the STEP FILE_DESCRIPTION header. */
+    mvdViewDefinition?: string | undefined;
+    /** Authoring person for the IfcOwnerHistory chain. Defaults to an empty person. */
+    author?: OwnerHistoryAuthor | undefined;
+    /** Owning organization name for the IfcOwnerHistory chain. Defaults to "Unknown". */
+    organizationName?: string | undefined;
+    /**
+     * Unix epoch seconds for IfcOwnerHistory.CreationDate. Defaults to 0 (epoch)
+     * so serialized output stays byte-deterministic; pass a real timestamp to
+     * record authoring time.
+     */
+    creationTimestamp?: number | undefined;
+    /** Target IFC schema (FILE_SCHEMA + CreateModel). Defaults to IFC4. */
+    ifcSchema?: IfcSchema | undefined;
+}
+export declare function writeHeader(w: IfcWriter, meta: BimModelMeta): HeaderIds;
+export declare function writeAxis2Placement3D(w: IfcWriter, origin?: [number, number, number], axisZ?: [number, number, number], axisX?: [number, number, number]): number;
+export declare function writeCartesianPoint(w: IfcWriter, coords: [number, number, number]): number;
+export declare function writeDirection(w: IfcWriter, dir: [number, number, number]): number;

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

@@ -0,0 +1,27 @@
+import { Handle } from 'web-ifc';
+import { BimError } from '../errors/bimError.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { IfcSchema } from './schemaVersion.js';
+import { Result } from 'brepjs';
+/** Default MVD ViewDefinition declared in the STEP FILE_DESCRIPTION header. */
+export declare const DEFAULT_MVD_VIEW_DEFINITION = "ReferenceView_v1.2";
+export declare class IfcWriter {
+    #private;
+    private constructor();
+    static create(mvdViewDefinition?: string, ifcSchema?: IfcSchema): Promise<Result<IfcWriter, BimError>>;
+    nextId(): number;
+    /**
+     * Deterministic GlobalId for a writer-minted line, keyed on its express ID.
+     * Express IDs are assigned in a fixed serialization order, so an identical
+     * model produces identical GlobalIds for its psets/quantities/rels.
+     */
+    /** Sets the per-model scope mixed into writer-minted GlobalIds. */
+    setModelScope(scope: string): void;
+    guidFor(expressId: number): IfcGuid;
+    writeLine(entity: {
+        expressID: number;
+    } & Record<string, unknown>): number;
+    ref(id: number): InstanceType<typeof Handle>;
+    mkType(type: number, value: unknown): Record<string, unknown>;
+    save(): Result<Uint8Array, BimError>;
+}

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

@@ -0,0 +1,39 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { MaterialLayer } from '../types/materialTypes.js';
+export type { MaterialLayer } from '../types/materialTypes.js';
+export interface MaterialLayerSetSpec {
+    readonly kind: 'LAYER_SET';
+    readonly layerSetName: string;
+    readonly layers: readonly MaterialLayer[];
+    /** Offset of the layer set from the element reference line, in mm (default 0). */
+    readonly offsetFromReferenceLine?: number | undefined;
+}
+export interface MaterialProfileSpec {
+    readonly kind: 'PROFILE_SET';
+    readonly profileSetName: string;
+    /** Name of the profile; the profile geometry is referenced by name only. */
+    readonly profileName: string;
+    readonly materialName: string;
+}
+export type MaterialSpec = MaterialLayerSetSpec | MaterialProfileSpec;
+/**
+ * Writes IfcMaterialLayer × N + IfcMaterialLayerSet + IfcMaterialLayerSetUsage,
+ * then associates the usage with the related objects via IfcRelAssociatesMaterial.
+ * The rel GlobalId comes from `guid` (a deterministic, caller-supplied GUID).
+ * Returns the IfcRelAssociatesMaterial express ID, or 0 if the layer list is
+ * empty (nothing is written).
+ */
+export declare function writeMaterialLayerSet(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, spec: MaterialLayerSetSpec, relatedObjectIds: readonly number[], direction?: 'AXIS2' | 'AXIS3'): number;
+/**
+ * Writes a IfcMaterialProfileSet referencing a single named profile + material,
+ * then associates it with the related objects via IfcRelAssociatesMaterial.
+ * Profile geometry is referenced by name only (no IfcProfileDef geometry).
+ * Returns the IfcRelAssociatesMaterial express ID.
+ */
+export declare function writeMaterialProfileSet(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, spec: MaterialProfileSpec, relatedObjectIds: readonly number[]): number;
+/**
+ * Writes a bare IfcMaterial + IfcRelAssociatesMaterial. This is the
+ * single-material path used when no layer/profile spec is present.
+ */
+export declare function writeMaterialSimple(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, materialName: string, relatedObjectIds: readonly number[]): void;

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

@@ -0,0 +1,24 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { WallSpec } from '../specs/wallSpec.js';
+import { WallOpeningSpec, SlabOpeningSpec } from '../types/bimTypes.js';
+import { SlabSpec } from '../specs/slabSpec.js';
+export interface OpeningIds {
+    openingEntityId: number;
+    openingPlacementId: number;
+}
+type OpeningPsetSpec = {
+    readonly isExternal?: boolean | undefined;
+    readonly fireRating?: string | undefined;
+    readonly acousticRating?: string | undefined;
+    readonly thermalTransmittance?: number | undefined;
+};
+export declare function writeOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: WallOpeningSpec, wallSpec: WallSpec, wallPlacementId: number, geomSubContextId: number, ownerHistoryId: number): OpeningIds;
+export declare function writeSlabOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: SlabOpeningSpec, slabSpec: SlabSpec, slabPlacementId: number, geomSubContextId: number, ownerHistoryId: number): OpeningIds;
+export declare function writeDoorEntity(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, openingPlacementId: number, geomSubContextId: number, overallWidthM: number, overallHeightM: number, nominalDepthMm?: number): number;
+export declare function writeWindowEntity(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, openingPlacementId: number, geomSubContextId: number, overallWidthM: number, overallHeightM: number, nominalDepthMm?: number): number;
+export declare function writeRelVoidsElement(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, wallEntityId: number, openingEntityId: number): void;
+export declare function writeRelFillsElement(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, openingEntityId: number, fillerEntityId: number): void;
+export declare function writeDoorCommonPset(w: IfcWriter, ownerHistoryId: number, doorEntityId: number, spec: OpeningPsetSpec): void;
+export declare function writeWindowCommonPset(w: IfcWriter, ownerHistoryId: number, windowEntityId: number, spec: OpeningPsetSpec): void;
+export {};

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

@@ -0,0 +1,30 @@
+import { IfcWriter } from './ifcWriter.js';
+/** Authoring person for the IfcOwnerHistory chain. */
+export interface OwnerHistoryAuthor {
+    readonly givenName?: string | undefined;
+    readonly familyName?: string | undefined;
+    /** Optional contact email; emitted as an IfcTelecomAddress on the person. */
+    readonly email?: string | undefined;
+}
+/**
+ * Configurable owner-history metadata. All identity values are passed in so the
+ * writer never reads wall-clock time — `creationTimestamp` defaults to 0 (epoch)
+ * to keep serialized output byte-deterministic.
+ */
+export interface OwnerHistoryMeta {
+    readonly author: OwnerHistoryAuthor;
+    readonly organizationName: string;
+    readonly applicationName: string;
+    readonly applicationVersion: string;
+    /** Unix epoch seconds for IfcOwnerHistory.CreationDate. Default 0 (epoch). */
+    readonly creationTimestamp?: number | undefined;
+}
+/**
+ * Writes the IfcPerson → IfcOrganization → IfcPersonAndOrganization →
+ * IfcApplication → IfcOwnerHistory chain from the supplied metadata and returns
+ * the IfcOwnerHistory express id for owned entities to reference.
+ *
+ * Determinism: no wall-clock time is read here; CreationDate comes solely from
+ * `meta.creationTimestamp` (default 0). Identical meta yields identical output.
+ */
+export declare function writeOwnerHistory(w: IfcWriter, meta: OwnerHistoryMeta): number;

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

@@ -0,0 +1,3 @@
+import { IfcWriter } from './ifcWriter.js';
+import { ExtendedProfile } from '../specs/profilesExtended.js';
+export declare function writeExtendedProfileDef(w: IfcWriter, profile: ExtendedProfile): number;

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

@@ -0,0 +1,17 @@
+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;
+}
+/**
+ * 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.
+ */
+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/psetWriter.d.ts

@@ -0,0 +1,67 @@
+import { IfcWriter } from './ifcWriter.js';
+import { WallSpec } from '../specs/wallSpec.js';
+import { SlabSpec } from '../specs/slabSpec.js';
+import { BeamSpec } from '../specs/beamSpec.js';
+import { ColumnSpec } from '../specs/columnSpec.js';
+import { SpaceSpec } from '../specs/spaceSpec.js';
+import { RoofSpec } from '../specs/roofSpec.js';
+import { CurtainWallSpec } from '../specs/curtainWallSpec.js';
+import { FootingSpec, PileSpec } from '../specs/foundationSpec.js';
+import { RailingSpec } from '../specs/railingSpec.js';
+import { CoveringSpec } from '../specs/coveringSpec.js';
+import { StairSpec } from '../specs/stairSpec.js';
+import { RampSpec } from '../specs/rampSpec.js';
+import { WallOpeningSpec, SlabOpeningSpec } from '../types/bimTypes.js';
+import { PsetCategory } from '../psets/psetTemplates.js';
+type PsetValue = string | number | boolean;
+export declare function writePropertySingleValueTyped(w: IfcWriter, name: string, value: PsetValue): number;
+/**
+ * Emits an IfcPropertyEnumeratedValue: the value plus the backing
+ * IfcPropertyEnumeration listing every legal value. Used for enumerated Pset
+ * properties such as `Status`.
+ */
+export declare function writePropertyEnumeratedValue(w: IfcWriter, name: string, value: string, enumValues: readonly string[]): number;
+export declare function writePropertySet(w: IfcWriter, ownerHistoryId: number, name: string, propertyIds: readonly number[]): number;
+export declare function writeRelDefinesByProperties(w: IfcWriter, ownerHistoryId: number, entityExpressId: number, psetId: number): void;
+/**
+ * Writes the standard Pset_*Common set for an element from its category template
+ * and a set of property values. Shared by the door/window pset writers in
+ * openingWriter.ts so every element type emits the correct measure types.
+ */
+export declare function writeCommonPset(w: IfcWriter, ownerHistoryId: number, entityExpressId: number, category: PsetCategory, values: Readonly<Record<string, PsetValue>>): void;
+export declare function writeWallCommonPset(w: IfcWriter, ownerHistoryId: number, wallExpressId: number, spec: WallSpec): void;
+interface ManufacturerFields {
+    readonly manufacturerName?: string | undefined;
+    readonly manufacturerModel?: string | undefined;
+    readonly manufacturerProductionYear?: number | undefined;
+}
+export declare function writeManufacturerPset(w: IfcWriter, ownerHistoryId: number, entityExpressId: number, spec: ManufacturerFields): void;
+export declare function writeCustomPsets(w: IfcWriter, ownerHistoryId: number, entityExpressId: number, customProperties: Readonly<Record<string, Readonly<Record<string, string | number | boolean>>>>): void;
+/**
+ * Resolves a bulk density (kg/m³) for an element's material association: an
+ * explicit `densityKgM3` on the material spec wins, otherwise a nominal value is
+ * looked up from the material name. Returns `undefined` when neither is available
+ * so the caller can skip emitting a weight quantity.
+ */
+export declare function resolveDensityKgM3(materialName: string | undefined, explicitDensityKgM3: number | undefined): number | undefined;
+export declare function writeWallBaseQuantities(w: IfcWriter, ownerHistoryId: number, wallExpressId: number, spec: WallSpec, openings: readonly WallOpeningSpec[], densityKgM3?: number): void;
+export declare function writeSlabCommonPset(w: IfcWriter, ownerHistoryId: number, slabExpressId: number, spec: SlabSpec): void;
+export declare function writeSlabBaseQuantities(w: IfcWriter, ownerHistoryId: number, slabExpressId: number, spec: SlabSpec, openings: readonly SlabOpeningSpec[], densityKgM3?: number): void;
+export declare function writeBeamCommonPset(w: IfcWriter, ownerHistoryId: number, beamExpressId: number, spec: BeamSpec): void;
+export declare function writeColumnCommonPset(w: IfcWriter, ownerHistoryId: number, columnExpressId: number, spec: ColumnSpec): void;
+export declare function writeBeamBaseQuantities(w: IfcWriter, ownerHistoryId: number, beamExpressId: number, spec: BeamSpec): void;
+export declare function writeColumnBaseQuantities(w: IfcWriter, ownerHistoryId: number, columnExpressId: number, spec: ColumnSpec): void;
+export declare function writeSpaceCommonPset(w: IfcWriter, ownerHistoryId: number, spaceExpressId: number, spec: SpaceSpec): void;
+export declare function writeSpaceBaseQuantities(w: IfcWriter, ownerHistoryId: number, spaceExpressId: number, spec: SpaceSpec): void;
+export declare function writeRoofCommonPset(w: IfcWriter, ownerHistoryId: number, roofExpressId: number, spec: RoofSpec): void;
+export declare function writeRoofBaseQuantities(w: IfcWriter, ownerHistoryId: number, roofExpressId: number, spec: RoofSpec): void;
+export declare function writeCurtainWallCommonPset(w: IfcWriter, ownerHistoryId: number, curtainWallExpressId: number, spec: CurtainWallSpec): void;
+export declare function writeFootingCommonPset(w: IfcWriter, ownerHistoryId: number, footingExpressId: number, spec: FootingSpec): void;
+export declare function writeFootingBaseQuantities(w: IfcWriter, ownerHistoryId: number, footingExpressId: number, spec: FootingSpec): void;
+export declare function writePileCommonPset(w: IfcWriter, ownerHistoryId: number, pileExpressId: number, spec: PileSpec): void;
+export declare function writePileBaseQuantities(w: IfcWriter, ownerHistoryId: number, pileExpressId: number, spec: PileSpec): void;
+export declare function writeStairCommonPset(w: IfcWriter, ownerHistoryId: number, stairExpressId: number, spec: StairSpec): void;
+export declare function writeRampCommonPset(w: IfcWriter, ownerHistoryId: number, rampExpressId: number, spec: RampSpec): void;
+export declare function writeRailingCommonPset(w: IfcWriter, ownerHistoryId: number, railingExpressId: number, spec: RailingSpec): void;
+export declare function writeCoveringCommonPset(w: IfcWriter, ownerHistoryId: number, coveringExpressId: number, spec: CoveringSpec): void;
+export {};

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

@@ -0,0 +1,11 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { RailingSpec, RailingPredefinedType } from '../specs/railingSpec.js';
+export interface RailingRepresentationIds {
+    localPlacementId: number;
+    productDefinitionShapeId: number;
+    /** Express ID of the body representation item (the extrusion), for styling. */
+    bodyItemId: number;
+}
+export declare function writeRailingGeometry(w: IfcWriter, spec: RailingSpec, geomSubContextId: number, parentPlacementId: number | null): RailingRepresentationIds;
+export declare function writeRailingEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: RailingPredefinedType, ownerHistoryId: number, localPlacementId: number, productDefinitionShapeId: number): number;

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

@@ -0,0 +1,4 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+export declare function writeRelAggregates(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, relatingObjectId: number, relatedObjectIds: number[]): void;
+export declare function writeRelContainedInSpatialStructure(w: IfcWriter, guid: IfcGuid, ownerHistoryId: number, relatingStructureId: number, relatedElementIds: number[]): void;

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

@@ -0,0 +1,21 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+import { RoofPredefinedType } from '../specs/roofSpec.js';
+/** IfcRoofTypeEnum values, mirrored from {@link RoofPredefinedType}. */
+export type RoofTypeEnum = RoofPredefinedType;
+/**
+ * Writes an IfcRoof occurrence. `localPlacementId` and `productDefinitionShapeId`
+ * are the IfcLocalPlacement and IfcProductDefinitionShape express IDs produced by
+ * the geometry layer; pass `null` for either when not available.
+ */
+export declare function writeRoofEntity(w: IfcWriter, guid: IfcGuid, name: string, predefinedType: RoofTypeEnum, ownerHistoryId: number, localPlacementId: number | null, productDefinitionShapeId: number | null): number;
+export interface RoofTypeWriteResult {
+    typeExpressId: number;
+    relExpressId: number;
+}
+/**
+ * Writes one IfcRoofType plus an IfcRelDefinesByType linking it to the given
+ * occurrence express IDs. `typeGuid`/`relGuid` are the deterministic GUIDs
+ * derived for the type object and its relationship.
+ */
+export declare function writeRoofType(w: IfcWriter, ownerHistoryId: number, typeGuid: IfcGuid, relGuid: IfcGuid, predefinedType: RoofTypeEnum, occurrenceExpressIds: readonly number[]): RoofTypeWriteResult;

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

@@ -0,0 +1,36 @@
+/**
+ * IFC schema-version abstraction for the writer.
+ *
+ * The writer targets a single IFC schema per model. This module is the single
+ * source of truth for which schemas are supported, the FILE_SCHEMA token that
+ * goes into the STEP header (and into web-ifc's `CreateModel({ schema })`), and
+ * a guard helper for entities that exist only in a given schema.
+ *
+ * Selection is wired in by the writer integrator via `BimModelMeta.ifcSchema`;
+ * the default is {@link DEFAULT_IFC_SCHEMA}.
+ */
+/** Writer-supported IFC schemas, in declared order. */
+export declare const IFC_SCHEMAS: readonly ["IFC4", "IFC4X3"];
+/** Union of writer-supported IFC schema identifiers. */
+export type IfcSchema = (typeof IFC_SCHEMAS)[number];
+/** Schema used when none is specified in model meta. */
+export declare const DEFAULT_IFC_SCHEMA: IfcSchema;
+/**
+ * The FILE_SCHEMA token for the STEP header and `CreateModel({ schema })`.
+ *
+ * web-ifc identifies schemas by these exact strings, and the STEP serializer
+ * emits `FILE_SCHEMA(('<token>'));`. For the supported set the token equals the
+ * schema identifier itself, but callers should route through this function so a
+ * future schema whose header token diverges from its identifier stays correct.
+ */
+export declare function fileSchemaString(schema: IfcSchema): string;
+/** Type guard narrowing an unknown value to a supported {@link IfcSchema}. */
+export declare function isIfcSchema(value: unknown): value is IfcSchema;
+/**
+ * Whether `entityName` may be written in `schema`.
+ *
+ * Used by entity writers to gate emission of schema-specific entities: an
+ * IFC4X3-only entity must not be written into an IFC4 model. Unknown entity
+ * names default to supported so the guard never blocks schema-agnostic writes.
+ */
+export declare function schemaSupports(schema: IfcSchema, entityName: string): boolean;

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

@@ -0,0 +1,11 @@
+import { IfcWriter } from './ifcWriter.js';
+import { SpaceSpec, SpacePredefinedType } from '../specs/spaceSpec.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+export interface SpaceRepresentationIds {
+    localPlacementId: number;
+    productDefinitionShapeId: number;
+}
+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;
+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/stairWriter.d.ts

@@ -0,0 +1,49 @@
+import { IfcWriter } from './ifcWriter.js';
+import { StairSpec } from '../specs/stairSpec.js';
+import { RampSpec } from '../specs/rampSpec.js';
+import { BimError } from '../errors/bimError.js';
+export interface AssemblyWriteResult {
+    /** Express ID of the IfcStair / IfcRamp assembly entity. */
+    readonly assemblyExpressId: number;
+    /** Express IDs of the IfcStairFlight / IfcRampFlight occurrences. */
+    readonly flightExpressIds: readonly number[];
+    /**
+     * True if any flight body fell back to simplified/degenerate geometry, or if
+     * the flight kind is inherently a simplified solid (ramp flights). The caller
+     * should surface this as a SIMPLIFIED_GEOMETRY note. Stair flights are real
+     * stepped solids and set this false unless tessellation itself fell back.
+     */
+    readonly geometrySimplified: boolean;
+}
+/**
+ * Writes a complete IfcStair assembly: the IfcStair container, one IfcStairFlight
+ * per `spec.flights[i]` (each with a tessellated stepped-solid body), and a single
+ * IfcRelAggregates linking the flights to the stair. Flight placements are
+ * relative to the stair placement, which is relative to `parentPlacementId`
+ * (typically the storey). GUIDs are deterministic, keyed on `stairKey`/index so
+ * re-serializing an identical model is byte-stable.
+ *
+ * Returns a BimError if any flight solid cannot be built. Stair flights are real
+ * stepped solids; tessellation failure is flagged via `geometrySimplified`.
+ */
+export declare function writeStairAssembly(w: IfcWriter, spec: StairSpec, stairKey: string, ownerHistoryId: number, geomSubContextId: number, parentPlacementId: number | null): {
+    ok: true;
+    value: AssemblyWriteResult;
+} | {
+    ok: false;
+    error: BimError;
+};
+/**
+ * Writes a complete IfcRamp assembly: the IfcRamp container, one IfcRampFlight
+ * per `spec.flights[i]` (each an inclined-slab tessellated body), and a single
+ * IfcRelAggregates linking the flights to the ramp. Ramp flights are simplified
+ * inclined-slab solids, so `geometrySimplified` is always true. GUIDs are
+ * deterministic keyed on `rampKey`.
+ */
+export declare function writeRampAssembly(w: IfcWriter, spec: RampSpec, rampKey: string, ownerHistoryId: number, geomSubContextId: number, parentPlacementId: number | null): {
+    ok: true;
+    value: AssemblyWriteResult;
+} | {
+    ok: false;
+    error: BimError;
+};

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

@@ -0,0 +1,30 @@
+import { IfcWriter } from './ifcWriter.js';
+export interface SurfaceStyleSpec {
+    readonly name: string;
+    /** Red channel, 0–1. */
+    readonly r: number;
+    /** Green channel, 0–1. */
+    readonly g: number;
+    /** Blue channel, 0–1. */
+    readonly b: number;
+    /** 0 = opaque (default), 1 = fully transparent. */
+    readonly transparency?: number;
+}
+/**
+ * Emits IfcColourRgb + IfcSurfaceStyleRendering + IfcSurfaceStyle and returns the
+ * IfcSurfaceStyle express ID. Link the style to geometry items with
+ * {@link writeStyledItem}. Colour channels and transparency are clamped to [0,1].
+ */
+export declare function writeSurfaceStyle(w: IfcWriter, spec: SurfaceStyleSpec): number;
+/**
+ * Emits an IfcStyledItem associating a single geometry representation item
+ * (e.g. an IfcExtrudedAreaSolid or IfcTriangulatedFaceSet) with a surface style
+ * produced by {@link writeSurfaceStyle}.
+ */
+export declare function writeStyledItem(w: IfcWriter, geomItemId: number, styleId: number): void;
+/**
+ * Emits an IfcPresentationLayerAssignment grouping representation items under a
+ * named layer. An empty `itemIds` set is a no-op (IFC requires a non-empty
+ * AssignedItems set).
+ */
+export declare function writePresentationLayer(w: IfcWriter, layerName: string, itemIds: readonly number[]): void;

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

@@ -0,0 +1,42 @@
+import { ValidSolid } from 'brepjs';
+import { IfcWriter } from './ifcWriter.js';
+export interface TessellationResult {
+    readonly productDefinitionShapeId: number;
+    /** True when the IfcFacetedBrep fallback was used because mesh() failed. */
+    readonly usedFallback: false;
+}
+export interface TessellationFallbackResult {
+    readonly productDefinitionShapeId: number;
+    readonly usedFallback: true;
+    readonly fallbackReason: string;
+}
+export type TessellationOutput = TessellationResult | TessellationFallbackResult;
+/**
+ * Writes an IfcTriangulatedFaceSet (preferred IFC4 tessellation) from a brepjs
+ * ValidSolid, wrapped in an IfcShapeRepresentation (Body/Tessellation) and an
+ * IfcProductDefinitionShape. Returns the IfcProductDefinitionShape express ID.
+ *
+ * Vertices from mesh() are in mm (brepjs native units) and are converted to
+ * metres for IFC. CoordIndex is emitted 1-based as IFC requires.
+ *
+ * On mesh() failure the function falls back to a degenerate single-vertex
+ * IfcFacetedBrep, logs a console.warn, and returns usedFallback: true. The
+ * caller should surface the fallback through its ValidationReport.
+ *
+ * geomSubContextId must be the geometric representation sub-context ('Body').
+ * localPlacement is accepted for call-site symmetry with the other geometry
+ * writers; tessellation placement is carried by the owning product, not by the
+ * shape representation, so it is not referenced here.
+ */
+export declare function writeTessellation(w: IfcWriter, solid: ValidSolid, geomSubContextId: number, _localPlacementId: number | null, toleranceMm?: number): TessellationOutput;
+/**
+ * Builds a wall 'Axis' IfcShapeRepresentation: an IfcPolyline from (0,0) to
+ * (lengthM, 0) in the wall's local XY plane, wrapped in an IfcShapeRepresentation
+ * with RepresentationIdentifier='Axis', RepresentationType='Curve2D'. Returns
+ * the IfcShapeRepresentation express ID so callers can add it alongside the Body
+ * representation in an IfcProductDefinitionShape.
+ *
+ * wallLengthMm is the wall length in mm (brepjs native units); it is converted
+ * to metres for IFC.
+ */
+export declare function writeWallAxisRepresentation(w: IfcWriter, wallLengthMm: number, geomSubContextId: number): number;

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

@@ -0,0 +1,13 @@
+import { IfcWriter } from './ifcWriter.js';
+import { IfcGuid } from '../identity/ifcGuid.js';
+export type IfcTypeName = 'IFCWALLTYPE' | 'IFCSLABTYPE' | 'IFCBEAMTYPE' | 'IFCCOLUMNTYPE' | 'IFCDOORTYPE' | 'IFCWINDOWTYPE' | 'IFCSPACETYPE' | 'IFCFOOTINGTYPE' | 'IFCPILETYPE' | 'IFCRAILINGTYPE' | 'IFCCOVERINGTYPE';
+export interface TypeWriteResult {
+    typeExpressId: number;
+    relExpressId: number;
+}
+/**
+ * Writes one IfcXxxType plus an IfcRelDefinesByType that
+ * links it to the given occurrence expressIDs. `typeGuid`/`relGuid` are the
+ * deterministic GUIDs derived for the type object and its relationship.
+ */
+export declare function writeIfcType(w: IfcWriter, ownerHistoryId: number, typeName: IfcTypeName, typeGuid: IfcGuid, relGuid: IfcGuid, predefinedType: string, occurrenceExpressIds: readonly number[]): TypeWriteResult;