@pascal-app/ifc-converter 1.0.3 → 1.0.4

package/README.md

@@ -17,10 +17,11 @@ Native Pascal nodes are produced when the converter can recover the required
 parameters for sites, buildings, levels, walls, doors, windows, slabs, columns,
 and IFC spaces (as room zones). IFC stair flights are retained as exact imported
 meshes; roofs retain Pascal hierarchy and source metadata but are not yet a
-complete parametric conversion. Railings, coverings, furnishings, proxies,
-curtain walls, plates, members,
-footings, and elements whose native parameters cannot be recovered are retained
-as selectable `imported-mesh` nodes using their IFC triangle geometry and color.
+complete parametric conversion. Railings, coverings other than ceilings and
+flooring, furnishings, proxies, curtain walls, plates, members, footings,
+vegetation (`IfcGeographicElement`), and elements whose native parameters
+cannot be recovered are retained as selectable `imported-mesh` nodes using
+their IFC triangle geometry and color.
 Imported meshes are import-only and do not appear as empty objects in the editor
 palette.
 
@@ -28,5 +29,64 @@ Door families are derived from `IfcDoor.OperationType`. Glazing is applied from
 the standardized `Pset_DoorCommon.GlazingAreaFraction` property rather than
 from element names or project-specific conventions.
 
+## Room-first structure
+
+The importer writes intent for Pascal's room-first model; the scene load
+migrations (room adoption, floor plates) and the structure kernel turn it into
+rooms, floor plates and ceilings. `tests/room-first-load.test.ts` converts the
+reference files and runs that load chain.
+
+- **Walls.** Merged collinear fragments, then every straight wall end moves
+  along its axis onto the centreline it meets (L and T joins; ends inside
+  another wall's body reach its centreline, `IfcRelConnectsPathElements` widens
+  the reach). Walls crossing mid-span split; thin cladding (tiles, skirting)
+  and walls lining or hidden in another wall stay imported meshes. Openings
+  keep their plan position. An `IfcMaterialLayerSetUsage` whose reference line
+  is a wall face becomes `justification` (`a`/`b`) with start/end on that face,
+  and each junction is rebuilt where the reference lines meet (junctions they
+  cannot close stay centred); other offsets are moved to the body centreline.
+- **Rooms.** `IfcSpace` becomes a room zone (`LongName` → name, `Name` →
+  room number) with a `seed` at its pole of inaccessibility; it is adopted by
+  the wall loop it fills. Spaces sharing one wall loop (open plan, or joined
+  through a gap in the walls) get separators along their shared borders or
+  across the gap; a space mostly bounded by walls but open on one side (a
+  curtain-wall facade) is closed along its open edges. Wall loops no space
+  claims become rooms too (`metadata.ifcDerived: 'wall-loop'`).
+- **Floors.** Slab tops are the true walking surface (the extrusion's upper
+  end, or the mesh when the body is more than one extrusion) and thickness is
+  the IFC thickness. Structural floors (`FLOOR`/`BASESLAB`/unset) whose top
+  matches the level's main floor within 2 cm and that floor at least one room
+  whole (openings aside) become floor-plate templates: the
+  kernel re-derives the plate from the rooms and keeps the IFC top and
+  thickness (`referenceFloorElevation`, `foundation`). A part reaching more than
+  1 m² / 5 % past the rooms and walls stays a hand-drawn slab (`metadata.ifcSplit:
+  'outside-rooms'`). Other slabs stay hand-drawn with their holes, and rooms
+  standing on them point at them with `floor.sourceSlabId`; rooms with no slab
+  under them have `hasFloor: false`. Holes in room floors, and the unfloored
+  part of a room a plate only partly carries, become `floor-opening` nodes.
+  Levels are marked `floorOwnershipMigrated` so the load migration's legacy
+  floor guesses leave these decisions alone.
+- **Finishes.** Slabs up to 6 cm thick lying on a structural floor inside rooms
+  (Revit "Finish Floor" types) and `IfcCovering` `FLOORING` become the room's
+  `floor.finish` when one covers most of the room, and `floor.regions` for the
+  rest (a library material chosen from the material/type name — wood, tile,
+  marble, stone, concrete — else the surface colour), plus the `floorFinish`
+  label. A finish slab is removed only when all of it is represented. The
+  plate's top is the finish top and its thickness includes the finish.
+- **Ceilings.** `IfcCovering` `CEILING` becomes the automatic ceiling of the
+  room it covers, at the covering's underside, keeping the covering's own
+  holes (profile voids and `IfcRelVoidsElement` openings). Sloped coverings stay
+  imported meshes. When a file models ceilings, a
+  room without one gets `hasCeiling: false`; files without ceiling coverings
+  keep Pascal's default ceilings except for rooms without a floor.
+- **Doors and windows** carry `wallId` and `floorThresholdVersion: 1`.
+- **Site.** The site polygon is the `IfcSite` footprint when it holds the
+  model, else the imported extent plus 5 m.
+- **Pascal round trip.** Elements carrying a `Pascal` property set (written by
+  `@pascal-app/ifc-converter/export`) keep their node id (imported meshes
+  included) and skip wall cleanup
+  (merging, joins, duplicate-opening removal); storeys read the `GrossHeight`
+  quantity for the top storey's height.
+
 Browser callers use the default WebIFC WASM path (`/`). Node callers can pass
 `{ wasmPath: '/absolute/path/to/web-ifc/' }` in `ConversionOptions`.

package/dist/beam-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beam-geometry.d.ts","sourceRoot":"","sources":["../src/beam-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,kBAAkB,CAAA;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAErC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAyFrD"}
+{"version":3,"file":"beam-geometry.d.ts","sourceRoot":"","sources":["../src/beam-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,kBAAkB,CAAA;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAErC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CA0FrD"}

package/dist/beam-geometry.js

@@ -25,7 +25,8 @@ export function extractBeamGeometry(ifcApi, modelID, expressID, options) {
                     const sx = wx - options.origin[0] * options.unitFactor;
                     const sy = -wz - options.origin[1] * options.unitFactor;
                     const sz = wy - options.origin[2] * options.unitFactor - options.levelElevation;
-                    const position = options.swapYZ ? [sx, sz, sy] : [sx, sy, sz];
+                    // Pascal is Y-up right-handed: IFC north (+Y) is Pascal -Z.
+                    const position = options.swapYZ ? [sx, sz, -sy] : [sx, sy, sz];
                     if (!position.every(Number.isFinite))
                         throw new Error('Non-finite beam vertex');
                     const key = position.join(',');
@@ -41,7 +42,7 @@ export function extractBeamGeometry(ifcApi, modelID, expressID, options) {
                     m[4] * (m[1] * m[10] - m[9] * m[2]) +
                     m[8] * (m[1] * m[6] - m[5] * m[2]);
                 // Baking a reflection into the vertices also reverses the outward face winding.
-                const reverseWinding = determinant < 0 !== options.swapYZ;
+                const reverseWinding = determinant < 0;
                 for (let i = 0; i + 2 < indices.length; i += 3) {
                     const ids = [vertexIds[indices[i]], vertexIds[indices[i + 1]], vertexIds[indices[i + 2]]];
                     if (ids.some((id) => id === undefined))

package/dist/cleanup.d.ts

@@ -19,7 +19,14 @@ export type IfcConversionSimplificationStats = {
     mergedWallGroups: number;
     removedMergedWalls: number;
     removedDuplicateOpenings: number;
+    joinedWallEnds: number;
+    splitCrossingWalls: number;
 };
-export declare function simplifyConvertedSceneGraph(nodes: SceneNodes, options?: IfcConversionSimplificationOptions): IfcConversionSimplificationStats;
+/** Walls and openings a Pascal export wrote are kept exactly as they were authored. */
+export declare function isPascalAuthored(node: AnyNode | undefined): boolean;
+export declare function simplifyConvertedSceneGraph(nodes: SceneNodes, options?: IfcConversionSimplificationOptions, context?: {
+    wallConnections?: readonly (readonly [number, number])[];
+    wallLinings?: ReadonlyMap<number, number>;
+}): IfcConversionSimplificationStats;
 export {};
 //# sourceMappingURL=cleanup.d.ts.map

package/dist/cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAMb,MAAM,kBAAkB,CAAA;AAEzB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAGzC,MAAM,MAAM,kCAAkC,GAAG;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,wBAAwB,EAAE,MAAM,CAAA;CACjC,CAAA;AAseD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,kCAAuC,GAC/C,gCAAgC,CAoBlC"}
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAMb,MAAM,kBAAkB,CAAA;AAGzB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAGzC,MAAM,MAAM,kCAAkC,GAAG;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,wBAAwB,EAAE,MAAM,CAAA;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;CAC3B,CAAA;AA0DD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,WAIzD;AAgbD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,kCAAuC,EAChD,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC,GACL,gCAAgC,CAsBlC"}

package/dist/cleanup.js

@@ -1,4 +1,5 @@
 import { DEFAULT_WALL_HEIGHT, DEFAULT_WALL_THICKNESS, } from '@pascal-app/core';
+import { joinWallEnds, splitCrossingWalls } from './wall-joins';
 const MIN_WALL_LENGTH = 0.08;
 const WALL_ANGLE_BUCKET_RAD = Math.PI / 180;
 const DEFAULT_MAX_WALL_JOIN_GAP = 1.25;
@@ -23,6 +24,8 @@ function getInitialStats(nodes) {
         mergedWallGroups: 0,
         removedMergedWalls: 0,
         removedDuplicateOpenings: 0,
+        joinedWallEnds: 0,
+        splitCrossingWalls: 0,
     };
 }
 function finishStats(nodes, stats) {
@@ -32,6 +35,10 @@ function finishStats(nodes, stats) {
         windows: countNodes(nodes, 'window'),
     };
 }
+/** Walls and openings a Pascal export wrote are kept exactly as they were authored. */
+export function isPascalAuthored(node) {
+    return (typeof node?.metadata?.pascalNodeId === 'string');
+}
 function isOpeningNode(node) {
     return node?.type === 'door' || node?.type === 'window';
 }
@@ -92,7 +99,7 @@ function wallLength(wall) {
 }
 function pruneTinyWalls(nodes, stats) {
     for (const node of Object.values(nodes)) {
-        if (node.type !== 'wall')
+        if (node.type !== 'wall' || isPascalAuthored(node))
             continue;
         if (wallLength(node) >= MIN_WALL_LENGTH)
             continue;
@@ -352,7 +359,7 @@ function mergeWallCluster(nodes, cluster, stats) {
 }
 function mergeWallFragments(nodes, stats, options) {
     const segments = Object.values(nodes)
-        .filter((node) => node.type === 'wall')
+        .filter((node) => node.type === 'wall' && !isPascalAuthored(node))
         .map(toWallSegment)
         .filter((segment) => segment !== null);
     const groups = new Map();
@@ -412,7 +419,7 @@ function openingSignature(opening) {
 function dedupeOpenings(nodes, stats) {
     const byWall = new Map();
     for (const node of Object.values(nodes)) {
-        if (!isOpeningNode(node))
+        if (!isOpeningNode(node) || isPascalAuthored(node))
             continue;
         const wallId = getOpeningWallId(node, nodes);
         if (!wallId)
@@ -437,7 +444,7 @@ function dedupeOpenings(nodes, stats) {
         }
     }
 }
-export function simplifyConvertedSceneGraph(nodes, options = {}) {
+export function simplifyConvertedSceneGraph(nodes, options = {}, context = {}) {
     const stats = getInitialStats(nodes);
     if (options.enabled === false) {
         finishStats(nodes, stats);
@@ -450,6 +457,8 @@ export function simplifyConvertedSceneGraph(nodes, options = {}) {
     pruneTinyWalls(nodes, stats);
     mergeWallFragments(nodes, stats, resolvedOptions);
     syncWallOpeningChildren(nodes);
+    stats.joinedWallEnds = joinWallEnds(nodes, context.wallConnections, context.wallLinings);
+    stats.splitCrossingWalls = splitCrossingWalls(nodes);
     dedupeOpenings(nodes, stats);
     normalizeChildren(nodes);
     finishStats(nodes, stats);

package/dist/collections.d.ts

@@ -0,0 +1,4 @@
+import { type AnyNode, type Collection, type CollectionId } from '@pascal-app/core';
+import * as WebIFC from 'web-ifc';
+export declare function importCollections(api: WebIFC.IfcAPI, modelID: number, nodes: Record<string, AnyNode>, nodeIds: ReadonlyMap<number, string>): Record<CollectionId, Collection>;
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAGZ,KAAK,UAAU,EACf,KAAK,YAAY,EAGlB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,MAAM,MAAM,SAAS,CAAA;AAEjC,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CA0DlC"}

package/dist/collections.js

@@ -0,0 +1,66 @@
+import { COLLECTION_TEMPLATES, generateCollectionId, } from '@pascal-app/core';
+import * as WebIFC from 'web-ifc';
+export function importCollections(api, modelID, nodes, nodeIds) {
+    const groups = api.GetLineIDsWithType(modelID, WebIFC.IFCGROUP, true);
+    if (groups.size() === 0)
+        return {};
+    const properties = new Map();
+    const definitions = api.GetLineIDsWithType(modelID, WebIFC.IFCRELDEFINESBYPROPERTIES);
+    for (let i = 0; i < definitions.size(); i++) {
+        const rel = api.GetLine(modelID, definitions.get(i));
+        if (!rel.RelatingPropertyDefinition?.value)
+            continue;
+        const definition = api.GetLine(modelID, rel.RelatingPropertyDefinition.value);
+        if (definition?.Name?.value !== 'PascalCollection')
+            continue;
+        const values = {};
+        for (const ref of definition.HasProperties ?? []) {
+            const property = api.GetLine(modelID, ref.value);
+            if (property?.Name?.value)
+                values[property.Name.value] = property.NominalValue?.value;
+        }
+        for (const ref of rel.RelatedObjects ?? [])
+            properties.set(ref.value, values);
+    }
+    const members = new Map();
+    const assignments = api.GetLineIDsWithType(modelID, WebIFC.IFCRELASSIGNSTOGROUP, true);
+    for (let i = 0; i < assignments.size(); i++) {
+        const rel = api.GetLine(modelID, assignments.get(i));
+        const groupId = rel.RelatingGroup?.value;
+        if (!groupId)
+            continue;
+        const ids = members.get(groupId) ?? new Set();
+        for (const ref of rel.RelatedObjects ?? []) {
+            const id = nodeIds.get(ref.value);
+            if (id && nodes[id])
+                ids.add(id);
+        }
+        members.set(groupId, ids);
+    }
+    const collections = {};
+    for (let i = 0; i < groups.size(); i++) {
+        const expressId = groups.get(i);
+        const ids = members.get(expressId);
+        if (!ids?.size)
+            continue;
+        const group = api.GetLine(modelID, expressId);
+        const values = properties.get(expressId);
+        const storedId = values?.CollectionId;
+        const id = typeof storedId === 'string' &&
+            storedId.startsWith('collection_') &&
+            !Object.hasOwn(collections, storedId)
+            ? storedId
+            : generateCollectionId();
+        const template = values?.Template;
+        collections[id] = {
+            id,
+            name: (typeof group.Name?.value === 'string' && group.Name.value.trim()) || 'IFC group',
+            nodeIds: [...ids],
+            ...(typeof template === 'string' && Object.hasOwn(COLLECTION_TEMPLATES, template)
+                ? { template: template }
+                : {}),
+            ...(typeof values?.Color === 'string' ? { color: values.Color } : {}),
+        };
+    }
+    return collections;
+}

package/dist/export/door-operation.d.ts

@@ -0,0 +1,13 @@
+import type { DoorNode } from '@pascal-app/core';
+/**
+ * Pascal door family → IfcDoorTypeOperationEnum. The inverse of
+ * `doorStyleFromIfcOperation` (door-semantics.ts), so an exported door
+ * re-imports as the same family.
+ */
+export declare function doorOperationForIfc(door: DoorNode): {
+    operationType: string;
+    userDefined?: string;
+};
+/** Share of the leaf height that is glazed, for Pset_DoorCommon.GlazingAreaFraction. */
+export declare function doorGlazingFraction(door: DoorNode): number;
+//# sourceMappingURL=door-operation.d.ts.map

package/dist/export/door-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"door-operation.d.ts","sourceRoot":"","sources":["../../src/export/door-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CA0BA;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAQ1D"}

package/dist/export/door-operation.js

@@ -0,0 +1,45 @@
+/**
+ * Pascal door family → IfcDoorTypeOperationEnum. The inverse of
+ * `doorStyleFromIfcOperation` (door-semantics.ts), so an exported door
+ * re-imports as the same family.
+ */
+export function doorOperationForIfc(door) {
+    const doubleLeaf = (door.leafCount ?? 1) >= 2;
+    switch (door.doorType) {
+        case 'double':
+        case 'french':
+            return { operationType: 'DOUBLE_DOOR_SINGLE_SWING' };
+        case 'sliding':
+        case 'pocket':
+        case 'barn':
+            if (doubleLeaf)
+                return { operationType: 'DOUBLE_DOOR_SLIDING' };
+            return {
+                operationType: door.slideDirection === 'right' ? 'SLIDING_TO_RIGHT' : 'SLIDING_TO_LEFT',
+            };
+        case 'folding':
+            return { operationType: doubleLeaf ? 'DOUBLE_DOOR_FOLDING' : 'FOLDING_TO_LEFT' };
+        case 'garage-rollup':
+            return { operationType: 'ROLLINGUP' };
+        case 'garage-sectional':
+        case 'garage-tiltup':
+            return { operationType: 'USERDEFINED', userDefined: door.doorType };
+        default:
+            if (doubleLeaf)
+                return { operationType: 'DOUBLE_DOOR_SINGLE_SWING' };
+            return {
+                operationType: door.hingesSide === 'right' ? 'SINGLE_SWING_RIGHT' : 'SINGLE_SWING_LEFT',
+            };
+    }
+}
+/** Share of the leaf height that is glazed, for Pset_DoorCommon.GlazingAreaFraction. */
+export function doorGlazingFraction(door) {
+    const segments = door.segments ?? [];
+    const total = segments.reduce((sum, segment) => sum + Math.max(0, segment.heightRatio), 0);
+    const glass = segments
+        .filter((segment) => segment.type === 'glass')
+        .reduce((sum, segment) => sum + Math.max(0, segment.heightRatio), 0);
+    if (total > 0 && glass > 0)
+        return Math.min(1, glass / total);
+    return door.doorType === 'french' ? 1 : 0;
+}

package/dist/export/guid.d.ts

@@ -0,0 +1,15 @@
+export declare function isIfcGuid(value: unknown): value is string;
+/** Compress 16 GUID bytes into IFC's 22-character base-64 form. */
+export declare function compressGuidBytes(bytes: Uint8Array): string;
+/** Deterministic IFC GlobalId for a seed (a Pascal node id plus an optional role suffix). */
+export declare function ifcGuidFromSeed(seed: string): string;
+/**
+ * Hands out GlobalIds, reusing an imported element's original GUID the first
+ * time it is seen. Duplicated nodes copy metadata, so a second claim on the
+ * same imported GUID falls back to the node-derived one to stay unique.
+ */
+export declare class GuidRegistry {
+    private readonly used;
+    claim(seed: string, preferred?: unknown): string;
+}
+//# sourceMappingURL=guid.d.ts.map

package/dist/export/guid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../../src/export/guid.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AA+CD,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAS3D;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IAEzC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM;CAYjD"}

package/dist/export/guid.js

@@ -0,0 +1,80 @@
+const IFC_GUID_ALPHABET = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$';
+const IFC_GUID_PATTERN = /^[0-3][0-9A-Za-z_$]{21}$/;
+export function isIfcGuid(value) {
+    return typeof value === 'string' && IFC_GUID_PATTERN.test(value);
+}
+// cyrb128: a fast synchronous 128-bit string hash. Web Crypto digests are
+// async-only in browsers, and the GUID only needs to be stable and
+// collision-resistant across one model, not cryptographically strong.
+function hash128(input) {
+    let h1 = 1779033703;
+    let h2 = 3144134277;
+    let h3 = 1013904242;
+    let h4 = 2773480762;
+    for (let i = 0; i < input.length; i++) {
+        const k = input.charCodeAt(i);
+        h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+        h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+        h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+        h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+    }
+    h1 = Math.imul(h3 ^ (h1 >>> 18), 597399067);
+    h2 = Math.imul(h4 ^ (h2 >>> 22), 2869860233);
+    h3 = Math.imul(h1 ^ (h3 >>> 17), 951274213);
+    h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);
+    h1 ^= h2 ^ h3 ^ h4;
+    h2 ^= h1;
+    h3 ^= h1;
+    h4 ^= h1;
+    const bytes = new Uint8Array(16);
+    const view = new DataView(bytes.buffer);
+    view.setUint32(0, h1 >>> 0);
+    view.setUint32(4, h2 >>> 0);
+    view.setUint32(8, h3 >>> 0);
+    view.setUint32(12, h4 >>> 0);
+    // Mark as an RFC 4122 name-based (v5-style) UUID so tools that validate
+    // the underlying GUID accept it.
+    bytes[6] = (bytes[6] & 0x0f) | 0x50;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    return bytes;
+}
+function toBase64Digits(value, digits) {
+    let out = '';
+    for (let i = 0; i < digits; i++) {
+        out = IFC_GUID_ALPHABET[value % 64] + out;
+        value = Math.floor(value / 64);
+    }
+    return out;
+}
+/** Compress 16 GUID bytes into IFC's 22-character base-64 form. */
+export function compressGuidBytes(bytes) {
+    let out = toBase64Digits(bytes[0], 2);
+    for (let offset = 1; offset < 16; offset += 3) {
+        out += toBase64Digits((bytes[offset] << 16) | (bytes[offset + 1] << 8) | bytes[offset + 2], 4);
+    }
+    return out;
+}
+/** Deterministic IFC GlobalId for a seed (a Pascal node id plus an optional role suffix). */
+export function ifcGuidFromSeed(seed) {
+    return compressGuidBytes(hash128(`pascal:${seed}`));
+}
+/**
+ * Hands out GlobalIds, reusing an imported element's original GUID the first
+ * time it is seen. Duplicated nodes copy metadata, so a second claim on the
+ * same imported GUID falls back to the node-derived one to stay unique.
+ */
+export class GuidRegistry {
+    used = new Set();
+    claim(seed, preferred) {
+        if (isIfcGuid(preferred) && !this.used.has(preferred)) {
+            this.used.add(preferred);
+            return preferred;
+        }
+        let guid = ifcGuidFromSeed(seed);
+        for (let attempt = 1; this.used.has(guid); attempt++) {
+            guid = ifcGuidFromSeed(`${seed}#${attempt}`);
+        }
+        this.used.add(guid);
+        return guid;
+    }
+}

package/dist/export/ifc-model.d.ts

@@ -0,0 +1,87 @@
+import { GuidRegistry } from './guid';
+import { DERIVED, enumValue, int, type StepRef, type StepValue, StepWriter } from './step';
+export type Vec2 = [number, number];
+export type Vec3 = [number, number, number];
+/** A right-handed IFC frame: origin plus a rotation about +Z (plan angle, radians). */
+export interface PlanFrame {
+    origin: Vec3;
+    angle: number;
+}
+export declare const IDENTITY_FRAME: PlanFrame;
+export declare function frameToLocal(frame: PlanFrame, point: Vec3): Vec3;
+/** `child` expressed relative to `parent` (both in the same parent space). */
+export declare function relativeFrame(parent: PlanFrame, child: PlanFrame): PlanFrame;
+export declare function signedArea(points: readonly Vec2[]): number;
+/** Drop repeated and closing vertices; returns [] for degenerate rings. */
+export declare function cleanRing(points: readonly Vec2[]): Vec2[];
+export declare function orientRing(points: Vec2[], counterClockwise: boolean): Vec2[];
+export interface IfcColor {
+    rgb: Vec3;
+    opacity: number;
+}
+export interface TriangleSet {
+    /** Local coordinates, flat XYZ. */
+    positions: ArrayLike<number>;
+    indices: ArrayLike<number>;
+    color?: IfcColor;
+}
+/**
+ * IFC4 entity builders shared by the scene mapper. Keeps attribute order for
+ * each entity in one place; the mapper only deals with Pascal semantics.
+ */
+export declare class IfcModel {
+    readonly step: StepWriter;
+    readonly guids: GuidRegistry;
+    ownerHistory: StepRef | null;
+    bodyContext: StepRef;
+    axisContext: StepRef;
+    private readonly styleCache;
+    guid(seed: string, preferred?: unknown): string;
+    point2(p: Vec2): StepRef;
+    point3(p: Vec3): StepRef;
+    direction(d: readonly number[]): StepRef;
+    axis2Placement3D(frame: PlanFrame): StepRef;
+    localPlacement(relativeTo: StepRef | null, frame: PlanFrame): StepRef;
+    polyline2(points: readonly Vec2[], closed: boolean): StepRef;
+    /** Outer ring CCW, holes CW; rings must already be cleaned. */
+    polygonProfile(outer: Vec2[], holes?: Vec2[][]): StepRef;
+    rectangleProfile(xDim: number, yDim: number, center?: Vec2): StepRef;
+    circleProfile(radius: number): StepRef;
+    /** Vertical prism of `profile`, from local z = `bottom` upwards by `depth`. */
+    extrusion(profile: StepRef, bottom: number, depth: number, color?: IfcColor): StepRef;
+    triangulatedFaceSet(set: TriangleSet): StepRef | null;
+    private surfaceStyle;
+    styleItem(item: StepRef, color: IfcColor): void;
+    shape(representations: StepRef[]): StepRef;
+    bodyRepresentation(type: 'SweptSolid' | 'Tessellation', items: StepRef[]): StepRef;
+    axisRepresentation(curve: StepRef): StepRef;
+    rel(type: string, seed: string, ...args: StepValue[]): StepRef;
+    propertySet(seed: string, name: string, properties: Array<[string, StepValue]>, relatedObjects: StepRef[]): void;
+    lengthQuantities(seed: string, name: string, quantities: Array<[string, number]>, relatedObjects: StepRef[]): void;
+}
+export declare const label: (value: string) => {
+    readonly type: string;
+    readonly value: StepValue;
+};
+export declare const identifier: (value: string) => {
+    readonly type: string;
+    readonly value: StepValue;
+};
+export declare const text: (value: string) => {
+    readonly type: string;
+    readonly value: StepValue;
+};
+export declare const bool: (value: boolean) => {
+    readonly type: string;
+    readonly value: StepValue;
+};
+export declare const length: (value: number) => {
+    readonly type: string;
+    readonly value: StepValue;
+};
+export declare const ratio: (value: number) => {
+    readonly type: string;
+    readonly value: StepValue;
+};
+export { DERIVED, enumValue, int };
+//# sourceMappingURL=ifc-model.d.ts.map

package/dist/export/ifc-model.d.ts.map

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