@ifc-lite/viewer 1.17.4 → 1.18.0

package/src/lib/scripts/templates/bim-globals.d.ts

@@ -23,18 +23,12 @@ interface BimEntity {
 
 interface BimPropertySet {
   name: string;
-  Name?: string;
-  globalId?: string;
-  GlobalId?: string;
   properties: Array<{ name: string; value: string | number | boolean | null }>;
-  Properties?: Array<{ name: string; value: string | number | boolean | null }>;
 }
 
 interface BimQuantitySet {
   name: string;
   quantities: Array<{ name: string; value: number | null }>;
-  Name?: string;
-  Quantities?: Array<{ name: string; value: number | null }>;
 }
 
 interface BimAttribute {
@@ -123,40 +117,6 @@ interface BimFileAttachment {
   hasTextContent: boolean;
 }
 
-type BimPoint3D = [number, number, number];
-type BimPoint2D = [number, number];
-
-interface BimPlacement3D {
-  Location: BimPoint3D;
-  Axis?: BimPoint3D;
-  RefDirection?: BimPoint3D;
-}
-
-type BimProfileDef =
-  | { ProfileType: 'AREA'; XDim: number; YDim: number }
-  | { ProfileType: 'AREA'; Radius: number; WallThickness?: number }
-  | { ProfileType: 'AREA'; OuterCurve: BimPoint2D[] }
-  | { ProfileType: 'AREA'; Shape: 'IfcTShapeProfileDef'; FlangeWidth: number; Depth: number; WebThickness: number; FlangeThickness: number; FilletRadius?: number }
-  | { ProfileType: 'AREA'; Shape: 'IfcUShapeProfileDef'; Depth: number; FlangeWidth: number; WebThickness: number; FlangeThickness: number; FilletRadius?: number }
-  | { ProfileType: 'AREA'; OverallWidth: number; OverallDepth: number; WebThickness: number; FlangeThickness: number; FilletRadius?: number }
-  | { ProfileType: 'AREA'; Depth: number; Width: number; Thickness: number; FilletRadius?: number }
-  | { ProfileType: 'AREA'; Depth: number; Width: number; WallThickness: number; Girth: number }
-  | { ProfileType: 'AREA'; XDim: number; YDim: number; WallThickness: number; InnerFilletRadius?: number; OuterFilletRadius?: number };
-
-type BimElementAttrs = {
-  Name?: string;
-  Description?: string;
-  ObjectType?: string;
-  Tag?: string;
-};
-
-type BimWallHostedOpening = BimElementAttrs & {
-  Position: BimPoint3D;
-  Width: number;
-  Height: number;
-  Thickness?: number;
-};
-
 // ── Namespace declarations ──────────────────────────────────────────────
 
 declare const bim: {
@@ -169,7 +129,7 @@ declare const bim: {
     /** Get active model ID */
     activeId(): string | null;
     /** Load IFC content into the 3D viewer for preview */
-    loadIfc(content: string, filename?: string): void;
+    loadIfc(content: string, filename: string): void;
   };
   /** Query entities */
   query: {
@@ -241,7 +201,7 @@ declare const bim: {
   };
   /** Property editing */
   mutate: {
-    /** Set an IfcPropertySet or quantity value */
+    /** Set an IfcPropertySet or quantity value (not a root IFC attribute) */
     setProperty(entity: unknown, psetName: string, propName: string, value: unknown): void;
     /** Set a root IFC attribute such as Name, Description, ObjectType, or Tag */
     setAttribute(entity: unknown, attrName: string, value: string): void;
@@ -252,6 +212,35 @@ declare const bim: {
     /** Redo undone mutation */
     redo(modelId: string): void;
   };
+  /** Document-level edits — add, remove, and edit positional STEP arguments on entities of a parsed model */
+  store: {
+    /** Inject a new entity into the active model. Returns an EntityRef for the freshly-allocated expressId. */
+    addEntity(modelId: string, def: { type: string; attributes: unknown[] }): { modelId: string; expressId: number };
+    /** Remove an entity. Tombstones existing entities; forgets overlay-only ones. Returns false if the id is unknown. */
+    removeEntity(entity: { modelId: string; expressId: number }): boolean;
+    /** Edit a non-IfcRoot attribute by zero-based STEP argument index (e.g. IfcRectangleProfileDef.XDim is index 3). */
+    setPositionalAttribute(entity: { modelId: string; expressId: number }, index: number, value: unknown): void;
+    /** Add an IfcColumn to a parsed model anchored to an existing IfcBuildingStorey. Returns the new column entity ref. */
+    addColumn(modelId: string, storeyExpressId: number, params: { Position: [number, number, number]; Width: number; Depth: number; Height: number; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add an IfcWall from Start to End anchored to an IfcBuildingStorey. Returns the new wall entity ref. */
+    addWall(modelId: string, storeyExpressId: number, params: { Start: [number, number, number]; End: [number, number, number]; Thickness: number; Height: number; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add an IfcSlab anchored to an IfcBuildingStorey. Two modes: rectangle (Position + Width + Depth) or polygon (OuterCurve = Array<[x, y]> with ≥3 points). */
+    addSlab(modelId: string, storeyExpressId: number, params: { Position: [number, number, number]; Width: number; Depth: number; Thickness: number; Profile?: "rectangle"; Name?: string; Description?: string; ObjectType?: string; Tag?: string } | { Profile: "polygon"; OuterCurve: Array<[number, number]>; Position?: [number, number, number]; Thickness: number; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add an IfcBeam from Start to End with a centred rectangular cross-section. */
+    addBeam(modelId: string, storeyExpressId: number, params: { Start: [number, number, number]; End: [number, number, number]; Width: number; Height: number; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add a free-standing IfcDoor anchored to an IfcBuildingStorey. */
+    addDoor(modelId: string, storeyExpressId: number, params: { Position: [number, number, number]; Width: number; Height: number; FrameThickness?: number; PredefinedType?: string; OperationType?: string; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add a free-standing IfcWindow anchored to an IfcBuildingStorey. */
+    addWindow(modelId: string, storeyExpressId: number, params: { Position: [number, number, number]; Width: number; Height: number; FrameThickness?: number; PredefinedType?: string; PartitioningType?: string; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add an IfcSpace (room) — rectangle or polygon footprint extruded by Height. */
+    addSpace(modelId: string, storeyExpressId: number, params: { Position: [number, number, number]; Width: number; Depth: number; Height: number; Profile?: "rectangle"; Name?: string; LongName?: string; Description?: string; ObjectType?: string } | { Profile: "polygon"; OuterCurve: Array<[number, number]>; Position?: [number, number, number]; Height: number; Name?: string; LongName?: string; Description?: string; ObjectType?: string }): { modelId: string; expressId: number };
+    /** Add an IfcRoof (flat-roof slab variant). Two modes: rectangle or polygon. */
+    addRoof(modelId: string, storeyExpressId: number, params: { Position: [number, number, number]; Width: number; Depth: number; Thickness: number; Profile?: "rectangle"; Name?: string; Description?: string; ObjectType?: string; Tag?: string } | { Profile: "polygon"; OuterCurve: Array<[number, number]>; Position?: [number, number, number]; Thickness: number; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add an IfcPlate (thin flat element). Two modes: rectangle or polygon. */
+    addPlate(modelId: string, storeyExpressId: number, params: { Position: [number, number, number]; Width: number; Depth: number; Thickness: number; Profile?: "rectangle"; PredefinedType?: string; Name?: string; Description?: string; ObjectType?: string; Tag?: string } | { Profile: "polygon"; OuterCurve: Array<[number, number]>; Position?: [number, number, number]; Thickness: number; PredefinedType?: string; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+    /** Add an IfcMember (generic structural member — brace, post, strut) from Start to End. */
+    addMember(modelId: string, storeyExpressId: number, params: { Start: [number, number, number]; End: [number, number, number]; Width: number; Height: number; PredefinedType?: string; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): { modelId: string; expressId: number };
+  };
   /** Lens visualization */
   lens: {
     /** Get built-in lens presets */
@@ -260,83 +249,105 @@ declare const bim: {
   /** IFC creation from scratch */
   create: {
     /** Create a new IFC project. Returns a creator handle (number). */
-    project(params?: { Name?: string; Description?: string; Schema?: string; LengthUnit?: string; Author?: string; Organization?: string }): number;
+    project(params: { Name?: string; Description?: string; Schema?: string; LengthUnit?: string; Author?: string; Organization?: string }): number;
+    /** Generate the IFC STEP file content. Returns { content, entities, stats }. */
+    toIfc(handle: number): { content: string; entities: Array<{ expressId: number; type: string; Name?: string }>; stats: { entityCount: number; fileSize: number } };
+    /** Assign a named colour to an element. Call before toIfc(). */
+    setColor(handle: number, elementId: number, name: string, rgb: unknown): void;
+    /** Create an IfcWorkSchedule. Returns schedule expressId. */
+    addIfcWorkSchedule(handle: number, params: { Name: string; StartTime: string; FinishTime?: string; CreationDate?: string; Description?: string; Identification?: string; Purpose?: string; Duration?: string; TotalFloat?: string; PredefinedType?: 'ACTUAL' | 'BASELINE' | 'PLANNED' | 'USERDEFINED' | 'NOTDEFINED' }): number;
+    /** Create an IfcWorkPlan (groups multiple schedules). Returns plan expressId. */
+    addIfcWorkPlan(handle: number, params: { Name: string; StartTime: string; FinishTime?: string; CreationDate?: string; Description?: string; Identification?: string; Purpose?: string; Duration?: string; PredefinedType?: 'ACTUAL' | 'BASELINE' | 'PLANNED' | 'USERDEFINED' | 'NOTDEFINED' }): number;
+    /** Create an IfcTask. Provide ScheduleStart + ScheduleFinish (or ScheduleDuration) for time fields. Returns task expressId. */
+    addIfcTask(handle: number, params: { Name: string; Description?: string; Identification?: string; LongDescription?: string; Status?: string; WorkMethod?: string; IsMilestone?: boolean; Priority?: number; ObjectType?: string; ScheduleStart?: string; ScheduleFinish?: string; ScheduleDuration?: string; ActualStart?: string; ActualFinish?: string; ActualDuration?: string; EarlyStart?: string; EarlyFinish?: string; LateStart?: string; LateFinish?: string; FreeFloat?: string; TotalFloat?: string; IsCritical?: boolean; DurationType?: 'WORKTIME' | 'ELAPSEDTIME' | 'NOTDEFINED'; Completion?: number; PredefinedType?: 'ATTENDANCE' | 'CONSTRUCTION' | 'DEMOLITION' | 'DISMANTLE' | 'DISPOSAL' | 'INSTALLATION' | 'LOGISTIC' | 'MAINTENANCE' | 'MOVE' | 'OPERATION' | 'REMOVAL' | 'RENOVATION' | 'USERDEFINED' | 'NOTDEFINED' | 'ADJUSTMENT' | 'CALIBRATION' | 'EMERGENCY' | 'INSPECTION' | 'SAFETY' | 'SHUTDOWN' | 'STARTUP' | 'TESTING' | 'TROUBLESHOOTING' }): number;
+    /** Link predecessor → successor tasks via IfcRelSequence. Returns relationship expressId. */
+    addIfcRelSequence(handle: number, predecessorTaskId: number, successorTaskId: number, params: { SequenceType?: 'START_START' | 'START_FINISH' | 'FINISH_START' | 'FINISH_FINISH' | 'USERDEFINED' | 'NOTDEFINED'; TimeLag?: string; LagDurationType?: 'WORKTIME' | 'ELAPSEDTIME' | 'NOTDEFINED'; UserDefinedSequenceType?: string }): number;
+    /** Canonical IfcRelAssignsToControl — bind IfcObjectDefinitions (tasks or sub-schedules) to an IfcControl (IfcWorkSchedule/IfcWorkPlan). Returns relationship expressId. */
+    addIfcRelAssignsToControl(handle: number, relatingControlId: number, relatedObjectIds: number[]): number;
+    /** Canonical IfcRelAssignsToProcess — bind products to an IfcProcess (task). Drives the 4D Gantt animation. Returns relationship expressId. */
+    addIfcRelAssignsToProcess(handle: number, relatingProcessId: number, relatedObjectIds: number[]): number;
+    /** Canonical IfcRelNests — nest child objects under a parent (task WBS hierarchy). Returns relationship expressId. */
+    addIfcRelNests(handle: number, relatingObjectId: number, relatedObjectIds: number[]): number;
+    /** Ergonomic alias for addIfcRelAssignsToControl — assign tasks to a work schedule. Returns relationship expressId. */
+    assignTasksToWorkSchedule(handle: number, scheduleId: number, taskIds: number[]): number;
+    /** Ergonomic alias for addIfcRelAssignsToControl — attach work schedules to a parent IfcWorkPlan. Returns relationship expressId. */
+    assignSchedulesToWorkPlan(handle: number, planId: number, scheduleIds: number[]): number;
+    /** Ergonomic alias for addIfcRelAssignsToProcess — bind products to a task. Returns relationship expressId. */
+    assignProductsToTask(handle: number, taskId: number, productIds: number[]): number;
+    /** Ergonomic alias for addIfcRelNests — nest child tasks under a summary parent. Returns relationship expressId. */
+    nestTasks(handle: number, parentTaskId: number, childTaskIds: number[]): number;
+    /** Create ANY IFC type extruded along a Start→End axis. Returns expressId. */
+    addAxisElement(handle: number, storeyId: number, params: unknown): number;
+    /** Create ANY IFC type with a profile at a placement. Returns expressId. */
+    addElement(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcBeam. Returns expressId. */
+    addIfcBeam(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcBuildingElementProxy. Returns expressId. */
+    addIfcBuildingElementProxy(handle: number, storeyId: number, params: unknown): number;
     /** Add a building storey. Returns storey expressId. */
-    addIfcBuildingStorey(handle: number, params: { Name?: string; Description?: string; Elevation: number }): number;
-    /** Add a wall to a storey. Returns wall expressId. */
-    addIfcWall(handle: number, storeyId: number, params: BimElementAttrs & { Start: [number,number,number]; End: [number,number,number]; Thickness: number; Height: number; Openings?: Array<{ Width: number; Height: number; Position: [number,number,number]; Name?: string }> }): number;
-    /** Add a slab to a storey. Returns slab expressId. */
-    addIfcSlab(handle: number, storeyId: number, params: BimElementAttrs & { Position: [number,number,number]; Thickness: number; Width?: number; Depth?: number; Profile?: [number,number][]; Openings?: Array<{ Width: number; Height: number; Position: [number,number,number]; Name?: string }> }): number;
-    /** Add a column to a storey. Returns column expressId. */
-    addIfcColumn(handle: number, storeyId: number, params: BimElementAttrs & { Position: [number,number,number]; Width: number; Depth: number; Height: number }): number;
-    /** Add a beam to a storey. Returns beam expressId. */
-    addIfcBeam(handle: number, storeyId: number, params: BimElementAttrs & { Start: [number,number,number]; End: [number,number,number]; Width: number; Height: number }): number;
-    /** Add a stair to a storey. Returns stair expressId. */
-    addIfcStair(handle: number, storeyId: number, params: BimElementAttrs & { Position: [number,number,number]; NumberOfRisers: number; RiserHeight: number; TreadLength: number; Width: number; Direction?: number }): number;
-    /** Add a roof to a storey. Returns roof expressId. */
-    addIfcRoof(handle: number, storeyId: number, params: BimElementAttrs & { Position: [number,number,number]; Width: number; Depth: number; Thickness: number; Slope?: number }): number;
+    addIfcBuildingStorey(handle: number, params: unknown): number;
+    /** Add IfcCircularColumn. Returns expressId. */
+    addIfcCircularColumn(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcColumn. Returns expressId. */
+    addIfcColumn(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcCurtainWall. Returns expressId. */
+    addIfcCurtainWall(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcDoor. Returns expressId. */
+    addIfcDoor(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcElementQuantity. Returns expressId. */
+    addIfcElementQuantity(handle: number, elementId: number, params: unknown): number;
+    /** Add IfcFooting. Returns expressId. */
+    addIfcFooting(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcFurnishingElement. Returns expressId. */
+    addIfcFurnishingElement(handle: number, storeyId: number, params: unknown): number;
     /** Add a dual-pitch gable roof. `Slope` is in radians. Returns roof expressId. */
-    addIfcGableRoof(handle: number, storeyId: number, params: BimElementAttrs & { Position: [number,number,number]; Width: number; Depth: number; Thickness: number; Slope: number; Overhang?: number }): number;
+    addIfcGableRoof(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcHollowCircularColumn. Returns expressId. */
+    addIfcHollowCircularColumn(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcIShapeBeam. Returns expressId. */
+    addIfcIShapeBeam(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcLShapeMember. Returns expressId. */
+    addIfcLShapeMember(handle: number, storeyId: number, params: unknown): number;
+    /** Associate a material with an element via IfcRelAssociatesMaterial (deferred to toIfc). Returns nothing. */
+    addIfcMaterial(handle: number, elementId: number, params: unknown): void;
+    /** Add IfcMember. Returns expressId. */
+    addIfcMember(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcPile. Returns expressId. */
+    addIfcPile(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcPlate. Returns expressId. */
+    addIfcPlate(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcPropertySet. Returns expressId. */
+    addIfcPropertySet(handle: number, elementId: number, params: unknown): number;
+    /** Add IfcRailing. Returns expressId. */
+    addIfcRailing(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcRamp. Returns expressId. */
+    addIfcRamp(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcRectangleHollowBeam. Returns expressId. */
+    addIfcRectangleHollowBeam(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcRoof. Returns expressId. */
+    addIfcRoof(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcSlab. Returns expressId. */
+    addIfcSlab(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcSpace. Returns expressId. */
+    addIfcSpace(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcStair. Returns expressId. */
+    addIfcStair(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcTShapeMember. Returns expressId. */
+    addIfcTShapeMember(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcUShapeMember. Returns expressId. */
+    addIfcUShapeMember(handle: number, storeyId: number, params: unknown): number;
+    /** Add IfcWall. Returns expressId. */
+    addIfcWall(handle: number, storeyId: number, params: unknown): number;
     /** Add a door hosted in a wall opening. Position is wall-local [alongWall, 0, baseHeight]. Returns door expressId. */
-    addIfcWallDoor(handle: number, wallId: number, params: BimWallHostedOpening & { PredefinedType?: string; OperationType?: string }): number;
+    addIfcWallDoor(handle: number, wallId: number, params: unknown): number;
     /** Add a window hosted in a wall opening. Position is wall-local [alongWall, 0, sillHeight]. Returns window expressId. */
-    addIfcWallWindow(handle: number, wallId: number, params: BimWallHostedOpening & { PartitioningType?: string }): number;
-    /** Add a door to a storey. Returns door expressId. */
-    addIfcDoor(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Height: number; Thickness?: number; PredefinedType?: string; OperationType?: string }): number;
-    /** Add a window to a storey. Returns window expressId. */
-    addIfcWindow(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Height: number; Thickness?: number; PartitioningType?: string }): number;
-    /** Add a ramp to a storey. Returns ramp expressId. */
-    addIfcRamp(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Length: number; Thickness: number; Rise?: number }): number;
-    /** Add a railing to a storey. Returns railing expressId. */
-    addIfcRailing(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; Height: number; Width?: number }): number;
-    /** Add a plate to a storey. Returns plate expressId. */
-    addIfcPlate(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Depth: number; Thickness: number; Profile?: BimPoint2D[] }): number;
-    /** Add a member to a storey. Returns member expressId. */
-    addIfcMember(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; Width: number; Height: number }): number;
-    /** Add a footing to a storey. Returns footing expressId. */
-    addIfcFooting(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Depth: number; Height: number; PredefinedType?: string }): number;
-    /** Add a pile to a storey. Returns pile expressId. */
-    addIfcPile(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Length: number; Diameter: number; IsRectangular?: boolean; RectangularDepth?: number }): number;
-    /** Add a space to a storey. Returns space expressId. */
-    addIfcSpace(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Depth: number; Height: number; LongName?: string; Profile?: BimPoint2D[] }): number;
-    /** Add a curtain wall to a storey. Returns curtain wall expressId. */
-    addIfcCurtainWall(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; Height: number; Thickness?: number }): number;
-    /** Add a furnishing element to a storey. Returns expressId. */
-    addIfcFurnishingElement(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Depth: number; Height: number; Direction?: number }): number;
-    /** Add a generic building element proxy to a storey. Returns expressId. */
-    addIfcBuildingElementProxy(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Width: number; Depth: number; Height: number; Profile?: BimPoint2D[]; ProxyType?: string }): number;
-    /** Add a circular column to a storey. Returns expressId. */
-    addIfcCircularColumn(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Radius: number; Height: number }): number;
-    /** Add an I-shape beam to a storey. Returns expressId. */
-    addIfcIShapeBeam(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; OverallWidth: number; OverallDepth: number; WebThickness: number; FlangeThickness: number; FilletRadius?: number }): number;
-    /** Add an L-shape member to a storey. Returns expressId. */
-    addIfcLShapeMember(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; Width: number; Depth: number; Thickness: number; FilletRadius?: number }): number;
-    /** Add a T-shape member to a storey. Returns expressId. */
-    addIfcTShapeMember(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; FlangeWidth: number; Depth: number; WebThickness: number; FlangeThickness: number; FilletRadius?: number }): number;
-    /** Add a U-shape member to a storey. Returns expressId. */
-    addIfcUShapeMember(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; Depth: number; FlangeWidth: number; WebThickness: number; FlangeThickness: number; FilletRadius?: number }): number;
-    /** Add a hollow circular column to a storey. Returns expressId. */
-    addIfcHollowCircularColumn(handle: number, storeyId: number, params: BimElementAttrs & { Position: BimPoint3D; Radius: number; WallThickness: number; Height: number }): number;
-    /** Add a rectangular hollow beam to a storey. Returns expressId. */
-    addIfcRectangleHollowBeam(handle: number, storeyId: number, params: BimElementAttrs & { Start: BimPoint3D; End: BimPoint3D; XDim: number; YDim: number; WallThickness: number; InnerFilletRadius?: number; OuterFilletRadius?: number }): number;
-    /** Create any IFC type with a profile at a placement. Returns expressId. */
-    addElement(handle: number, storeyId: number, params: { IfcType: string; Placement: BimPlacement3D; Profile: BimProfileDef; Depth: number; ExtrusionDirection?: BimPoint3D; PredefinedType?: string; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): number;
-    /** Create any IFC type extruded along a Start→End axis. Returns expressId. */
-    addAxisElement(handle: number, storeyId: number, params: { IfcType: string; Start: BimPoint3D; End: BimPoint3D; Profile: BimProfileDef; PredefinedType?: string; Name?: string; Description?: string; ObjectType?: string; Tag?: string }): number;
+    addIfcWallWindow(handle: number, wallId: number, params: unknown): number;
+    /** Add IfcWindow. Returns expressId. */
+    addIfcWindow(handle: number, storeyId: number, params: unknown): number;
     /** Create a profile from a ProfileDef union. Returns profile ID. */
-    createProfile(handle: number, profile: BimProfileDef): number;
+    createProfile(handle: number, profile: unknown): number;
     /** Get the world placement ID for use with addLocalPlacement. */
     getWorldPlacementId(handle: number): number;
-    /** Assign a named colour to an element. Call before toIfc(). */
-    setColor(handle: number, elementId: number, name: string, rgb: [number, number, number]): void;
-    /** Assign an IFC material (simple or layered) to an element. */
-    addIfcMaterial(handle: number, elementId: number, material: { Name: string; Category?: string; Layers?: Array<{ Name: string; Thickness: number; Category?: string; IsVentilated?: boolean }> }): void;
-    /** Attach a property set to an element. Returns pset expressId. */
-    addIfcPropertySet(handle: number, elementId: number, pset: { Name: string; Properties: Array<{ Name: string; NominalValue: string | number | boolean; Type?: string }> }): number;
-    /** Attach element quantities to an element. Returns qset expressId. */
-    addIfcElementQuantity(handle: number, elementId: number, qset: { Name: string; Quantities: Array<{ Name: string; Value: number; Kind: 'IfcQuantityLength' | 'IfcQuantityArea' | 'IfcQuantityVolume' | 'IfcQuantityCount' | 'IfcQuantityWeight' }> }): number;
-    /** Generate the IFC STEP file content. Returns { content, entities, stats }. */
-    toIfc(handle: number): { content: string; entities: Array<{ expressId: number; type: string; Name?: string }>; stats: { entityCount: number; fileSize: number } };
   };
   /** Uploaded file attachments */
   files: {
@@ -349,6 +360,17 @@ declare const bim: {
     /** Get parsed CSV column names for an uploaded attachment by file name */
     csvColumns(name: string): string[];
   };
+  /** 4D / IFC construction schedule reader (IfcTask, IfcWorkSchedule, IfcRelSequence) */
+  schedule: {
+    /** Full schedule extraction — tasks, dependencies, and work schedules. */
+    data(modelId?: string): { HasSchedule: boolean; WorkSchedules: Array<{ GlobalId: string; ExpressId: number; Name: string; Description?: string; Identification?: string; CreationDate?: string; StartTime?: string; FinishTime?: string; Purpose?: string; Duration?: string; PredefinedType?: string; Kind: 'WorkSchedule' | 'WorkPlan'; TaskGlobalIds: string[] }>; Tasks: Array<{ GlobalId: string; ExpressId: number; Name: string; Description?: string; ObjectType?: string; Identification?: string; LongDescription?: string; Status?: string; WorkMethod?: string; IsMilestone: boolean; Priority?: number; PredefinedType?: string; ParentTaskGlobalId?: string; ChildTaskGlobalIds: string[]; AssignedProductExpressIds: number[]; AssignedProductGlobalIds: string[]; ControllingScheduleGlobalIds: string[]; TaskTime?: { ScheduleStart?: string; ScheduleFinish?: string; ScheduleDuration?: string; ActualStart?: string; ActualFinish?: string; ActualDuration?: string; EarlyStart?: string; EarlyFinish?: string; LateStart?: string; LateFinish?: string; FreeFloat?: string; TotalFloat?: string; RemainingTime?: string; StatusTime?: string; IsCritical?: boolean; Completion?: number; DurationType?: 'WORKTIME' | 'ELAPSEDTIME' | 'NOTDEFINED' } }>; Sequences: Array<{ RelatingProcessGlobalId: string; RelatedProcessGlobalId: string; SequenceType: 'START_START' | 'START_FINISH' | 'FINISH_START' | 'FINISH_FINISH' | 'USERDEFINED' | 'NOTDEFINED'; UserDefinedSequenceType?: string; TimeLagSeconds?: number; TimeLagDuration?: string }> };
+    /** All IfcTask entities with their times and assigned products. */
+    tasks(modelId?: string): Array<{ GlobalId: string; ExpressId: number; Name: string; Description?: string; ObjectType?: string; Identification?: string; LongDescription?: string; Status?: string; WorkMethod?: string; IsMilestone: boolean; Priority?: number; PredefinedType?: string; ParentTaskGlobalId?: string; ChildTaskGlobalIds: string[]; AssignedProductExpressIds: number[]; AssignedProductGlobalIds: string[]; ControllingScheduleGlobalIds: string[]; TaskTime?: { ScheduleStart?: string; ScheduleFinish?: string; ScheduleDuration?: string; ActualStart?: string; ActualFinish?: string; ActualDuration?: string; EarlyStart?: string; EarlyFinish?: string; LateStart?: string; LateFinish?: string; FreeFloat?: string; TotalFloat?: string; RemainingTime?: string; StatusTime?: string; IsCritical?: boolean; Completion?: number; DurationType?: 'WORKTIME' | 'ELAPSEDTIME' | 'NOTDEFINED' } }>;
+    /** All IfcWorkSchedule and IfcWorkPlan containers. */
+    workSchedules(modelId?: string): Array<{ GlobalId: string; ExpressId: number; Name: string; Description?: string; Identification?: string; CreationDate?: string; StartTime?: string; FinishTime?: string; Purpose?: string; Duration?: string; PredefinedType?: string; Kind: 'WorkSchedule' | 'WorkPlan'; TaskGlobalIds: string[] }>;
+    /** All IfcRelSequence dependency edges (FS/SS/FF/SF, with optional IfcLagTime). */
+    sequences(modelId?: string): Array<{ RelatingProcessGlobalId: string; RelatedProcessGlobalId: string; SequenceType: 'START_START' | 'START_FINISH' | 'FINISH_START' | 'FINISH_FINISH' | 'USERDEFINED' | 'NOTDEFINED'; UserDefinedSequenceType?: string; TimeLagSeconds?: number; TimeLagDuration?: string }>;
+  };
   /** Data export */
   export: {
     /** Export entities to CSV string */
@@ -356,8 +378,8 @@ declare const bim: {
     /** Export entities to JSON array */
     json(entities: BimEntity[], columns: string[]): Record<string, unknown>[];
     /** Export entities to IFC STEP text. Pass filename to auto-download a valid .ifc file */
-    ifc(entities: BimEntity[], options?: { schema?: "IFC2X3" | "IFC4" | "IFC4X3"; filename?: string; includeMutations?: boolean; visibleOnly?: boolean }): string;
-    /** Trigger a browser file download with raw content */
+    ifc(entities: BimEntity[], options: { schema?: "IFC2X3" | "IFC4" | "IFC4X3"; filename?: string; includeMutations?: boolean; visibleOnly?: boolean }): string | Uint8Array;
+    /** Trigger a browser file download with the given content. mimeType defaults to text/plain. */
     download(content: string, filename: string, mimeType?: string): void;
   };
 };

package/src/lib/scripts/templates/construction-schedule.ts

@@ -0,0 +1,223 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+export {} // module boundary (stripped by transpiler)
+
+// ─────────────────────────────────────────────────────────────────────────
+// Construction schedule — build an IfcWorkSchedule + IfcTasks + sequences
+//
+// Two modes:
+//   1) Attach a construction sequence to the CURRENTLY LOADED model.
+//      The script reads CSV task rows (attached via the chat paperclip)
+//      and creates IfcTasks whose products are resolved by name/type.
+//
+//   2) No model loaded — generate a standalone demo IFC file with a few
+//      walls and a matching 4-task construction schedule.
+//
+// CSV expected columns (case-insensitive, any subset works):
+//   id, name, start, finish, duration, predecessor, products, predefinedType,
+//   isMilestone, isCritical, completion
+//
+// Dates are ISO 8601 (e.g. 2024-05-01T08:00:00).
+// Durations are ISO 8601 (e.g. P5D, PT8H).
+// `products` is a comma-separated list of IFC types (e.g. "IfcWall,IfcSlab")
+// OR entity globalIds; elements matching each row are assigned to that task.
+// `predecessor` is the `id` of the row that must finish before this one.
+// ─────────────────────────────────────────────────────────────────────────
+
+function toIso(v: string | undefined): string | undefined {
+  if (!v) return undefined
+  const s = String(v).trim()
+  if (!s) return undefined
+  // Accept "YYYY-MM-DD" → append midnight
+  if (/^\d{4}-\d{2}-\d{2}$/.test(s)) return `${s}T00:00:00`
+  return s
+}
+
+function toBool(v: unknown): boolean | undefined {
+  if (v === undefined || v === null || v === '') return undefined
+  const s = String(v).trim().toLowerCase()
+  if (s === 'true' || s === '1' || s === 'yes' || s === 'y') return true
+  if (s === 'false' || s === '0' || s === 'no' || s === 'n') return false
+  return undefined
+}
+
+function toNumber(v: unknown): number | undefined {
+  if (v === undefined || v === null || v === '') return undefined
+  const n = Number(v)
+  return Number.isFinite(n) ? n : undefined
+}
+
+// Canonicalize a column name so "Start Date", "start_date" and "start" all match.
+function findCol(cols: string[], ...aliases: string[]): string | null {
+  const norm = (s: string) => s.toLowerCase().replace(/[\s_-]+/g, '')
+  const wanted = aliases.map(norm)
+  for (const c of cols) if (wanted.includes(norm(c))) return c
+  return null
+}
+
+const files = bim.files.list()
+const csvFile = files.find((f) => f.name.toLowerCase().endsWith('.csv'))
+
+if (csvFile) {
+  // ─── Mode 1: attach schedule to currently loaded model ────────────────
+  const rows = bim.files.csv(csvFile.name) ?? []
+  const cols = bim.files.csvColumns(csvFile.name)
+  if (rows.length === 0) {
+    console.warn(`[schedule] ${csvFile.name} has no rows`)
+  } else {
+    console.log(`[schedule] loading ${rows.length} tasks from ${csvFile.name}`)
+  }
+
+  const idCol = findCol(cols, 'id', 'taskid')
+  const nameCol = findCol(cols, 'name', 'task', 'activity')
+  const startCol = findCol(cols, 'start', 'startdate', 'schedulestart')
+  const finishCol = findCol(cols, 'finish', 'end', 'enddate', 'schedulefinish')
+  const durCol = findCol(cols, 'duration', 'scheduleduration')
+  const predCol = findCol(cols, 'predecessor', 'depends', 'dependson')
+  const productsCol = findCol(cols, 'products', 'type', 'entities', 'targets')
+  const typeCol = findCol(cols, 'predefinedtype', 'kind')
+  const mileCol = findCol(cols, 'ismilestone', 'milestone')
+  const critCol = findCol(cols, 'iscritical', 'critical')
+  const compCol = findCol(cols, 'completion', 'percentcomplete', 'progress')
+
+  // Discover every loaded product once so we can resolve `products` values
+  // (IFC type OR globalId substring) into a list of expressIds.
+  const allProducts = bim.query.byType(
+    'IfcWall', 'IfcSlab', 'IfcColumn', 'IfcBeam', 'IfcRoof', 'IfcStair',
+    'IfcDoor', 'IfcWindow', 'IfcRailing', 'IfcFooting', 'IfcCurtainWall',
+    'IfcMember', 'IfcPlate', 'IfcFurnishingElement', 'IfcBuildingElementProxy',
+  )
+
+  // Minimum character count before we fall back to a globalId prefix match;
+  // avoids accidental wildcarding when the CSV column holds short tokens.
+  const MIN_GID_PREFIX_LEN = 4
+
+  function resolveProducts(spec: string | undefined): number[] {
+    if (!spec) return []
+    const parts = spec.split(/[,;]/).map((s) => s.trim()).filter(Boolean)
+    const ids = new Set<number>()
+    for (const part of parts) {
+      const upper = part.toUpperCase()
+      if (upper.startsWith('IFC')) {
+        // IFC type — match all loaded entities of that class
+        for (const e of allProducts) {
+          if (e.type.toUpperCase() === upper) ids.add(e.ref.expressId)
+        }
+      } else {
+        // Exact globalId match, OR prefix match when the token is long enough
+        // to uniquely identify an element (≥ 4 chars).
+        for (const e of allProducts) {
+          if (e.globalId === part) {
+            ids.add(e.ref.expressId)
+          } else if (part.length >= MIN_GID_PREFIX_LEN && e.globalId.startsWith(part)) {
+            ids.add(e.ref.expressId)
+          }
+        }
+      }
+    }
+    return Array.from(ids)
+  }
+
+  // We can't use bim.create on an existing model in this iteration — the
+  // creator produces a fresh IFC file. So we log what *would* be created
+  // and print a plan. The plan is directly feedable to a follow-up
+  // save/export workflow.
+  console.log('[schedule] plan:')
+  for (const row of rows) {
+    const id = idCol ? row[idCol] : '-'
+    const name = nameCol ? row[nameCol] : '(unnamed)'
+    const start = startCol ? toIso(row[startCol]) : undefined
+    const finish = finishCol ? toIso(row[finishCol]) : undefined
+    const dur = durCol ? row[durCol] : undefined
+    const pred = predCol ? row[predCol] : undefined
+    const prodSpec = productsCol ? row[productsCol] : undefined
+    const prodIds = resolveProducts(prodSpec)
+    const predefinedType = typeCol ? row[typeCol] : undefined
+    const isMilestone = mileCol ? toBool(row[mileCol]) : undefined
+    const isCritical = critCol ? toBool(row[critCol]) : undefined
+    const completion = compCol ? toNumber(row[compCol]) : undefined
+    console.log(
+      `  • [${id}] ${name}  ${start ?? '?'} → ${finish ?? dur ?? '?'}  ` +
+      `prod=${prodIds.length}  pred=${pred ?? '-'}  ` +
+      `type=${predefinedType ?? '-'}  mile=${isMilestone ?? '-'}  ` +
+      `crit=${isCritical ?? '-'}  comp=${completion ?? '-'}`,
+    )
+  }
+  console.log(
+    '[schedule] Attaching tasks to an existing IFC requires a separate ' +
+    'mutation workflow — ask the assistant to wire the plan into a fresh ' +
+    'IFC export using bim.create.* so the 4D Gantt panel can play it.',
+  )
+} else {
+  // ─── Mode 2: generate a demo IFC with walls + a matching schedule ─────
+  console.log('[schedule] No CSV attached — building demo model + schedule')
+
+  const h = bim.create.project({ Name: 'Demo with schedule', Schema: 'IFC4' })
+  const storey = bim.create.addIfcBuildingStorey(h, { Name: 'Ground', Elevation: 0 })
+
+  const wallA = bim.create.addIfcWall(h, storey, {
+    Name: 'Wall A', Start: [0, 0, 0], End: [5, 0, 0], Thickness: 0.2, Height: 3,
+  })
+  const wallB = bim.create.addIfcWall(h, storey, {
+    Name: 'Wall B', Start: [5, 0, 0], End: [5, 5, 0], Thickness: 0.2, Height: 3,
+  })
+  const wallC = bim.create.addIfcWall(h, storey, {
+    Name: 'Wall C', Start: [5, 5, 0], End: [0, 5, 0], Thickness: 0.2, Height: 3,
+  })
+  const wallD = bim.create.addIfcWall(h, storey, {
+    Name: 'Wall D', Start: [0, 5, 0], End: [0, 0, 0], Thickness: 0.2, Height: 3,
+  })
+
+  const schedule = bim.create.addIfcWorkSchedule(h, {
+    Name: 'Construction schedule',
+    StartTime: '2024-05-01T08:00:00',
+    FinishTime: '2024-05-20T17:00:00',
+    PredefinedType: 'PLANNED',
+  })
+
+  const tFoundation = bim.create.addIfcTask(h, {
+    Name: 'Site preparation',
+    PredefinedType: 'CONSTRUCTION',
+    ScheduleStart: '2024-05-01T08:00:00',
+    ScheduleFinish: '2024-05-03T17:00:00',
+    ScheduleDuration: 'P3D',
+    IsMilestone: false,
+  })
+  const tWallAB = bim.create.addIfcTask(h, {
+    Name: 'Install walls A+B',
+    PredefinedType: 'INSTALLATION',
+    ScheduleStart: '2024-05-06T08:00:00',
+    ScheduleFinish: '2024-05-10T17:00:00',
+    ScheduleDuration: 'P5D',
+  })
+  const tWallCD = bim.create.addIfcTask(h, {
+    Name: 'Install walls C+D',
+    PredefinedType: 'INSTALLATION',
+    ScheduleStart: '2024-05-13T08:00:00',
+    ScheduleFinish: '2024-05-17T17:00:00',
+    ScheduleDuration: 'P5D',
+    IsCritical: true,
+  })
+  const tHandover = bim.create.addIfcTask(h, {
+    Name: 'Handover',
+    PredefinedType: 'CONSTRUCTION',
+    ScheduleStart: '2024-05-20T08:00:00',
+    ScheduleFinish: '2024-05-20T17:00:00',
+    IsMilestone: true,
+  })
+
+  bim.create.assignTasksToWorkSchedule(h, schedule, [tFoundation, tWallAB, tWallCD, tHandover])
+  bim.create.assignProductsToTask(h, tWallAB, [wallA, wallB])
+  bim.create.assignProductsToTask(h, tWallCD, [wallC, wallD])
+
+  bim.create.addIfcRelSequence(h, tFoundation, tWallAB, { SequenceType: 'FINISH_START', TimeLag: 'P2D' })
+  bim.create.addIfcRelSequence(h, tWallAB, tWallCD, { SequenceType: 'FINISH_START' })
+  bim.create.addIfcRelSequence(h, tWallCD, tHandover, { SequenceType: 'FINISH_START' })
+
+  const result = bim.create.toIfc(h)
+  console.log(`[schedule] generated ${result.stats.entityCount} entities (${result.stats.fileSize} bytes)`)
+  bim.export.download(result.content, 'demo-with-schedule.ifc', 'model/ifc')
+  console.log('[schedule] downloaded demo-with-schedule.ifc — open it in this viewer to see the 4D Gantt panel animate the construction.')
+}

package/src/lib/scripts/templates.ts

@@ -24,6 +24,7 @@ import spaceValidation from './templates/space-validation.ts?raw';
 import federationCompare from './templates/federation-compare.ts?raw';
 import resetView from './templates/reset-view.ts?raw';
 import createBuilding from './templates/create-building.ts?raw';
+import constructionSchedule from './templates/construction-schedule.ts?raw';
 
 
 export interface ScriptTemplate {
@@ -86,6 +87,12 @@ export const SCRIPT_TEMPLATES: ScriptTemplate[] = [
       'Developer — generate a complete IFC file with walls, slab, columns, beams, stair, and parametric timber gridshell roof with diamond lattice',
     code: stripModuleLine(createBuilding),
   },
+  {
+    name: 'Construction schedule (4D)',
+    description:
+      'Scheduler — build an IfcWorkSchedule with IfcTasks, IfcRelSequence dependencies, and product assignments that drive the 4D Gantt animation. Accepts a CSV attachment for real task data.',
+    code: stripModuleLine(constructionSchedule),
+  },
   {
     name: 'Reset view',
     description: 'Utility — remove all color overrides and show all entities',

package/src/lib/search/common-ifc-types.ts

@@ -0,0 +1,36 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+/**
+ * Starter IFC type catalog used as a dropdown fallback when the active
+ * model's `entityIndex.byType` isn't yet populated (e.g. server-loaded
+ * stores without the on-demand maps). Once a model is loaded, the
+ * filter-schema layer surfaces only the types actually present so users
+ * don't waste time picking IfcBeam from a house model that doesn't have
+ * one.
+ */
+export const COMMON_IFC_TYPES: readonly string[] = [
+  'IfcWall',
+  'IfcWallStandardCase',
+  'IfcSlab',
+  'IfcBeam',
+  'IfcColumn',
+  'IfcDoor',
+  'IfcWindow',
+  'IfcRoof',
+  'IfcStair',
+  'IfcStairFlight',
+  'IfcRailing',
+  'IfcRamp',
+  'IfcSpace',
+  'IfcCovering',
+  'IfcCurtainWall',
+  'IfcFooting',
+  'IfcPlate',
+  'IfcMember',
+  'IfcOpeningElement',
+  'IfcBuildingElementProxy',
+  'IfcFurnishingElement',
+  'IfcDistributionElement',
+];