@ifc-lite/viewer 1.17.6 → 1.19.0

package/src/lib/llm/system-prompt.ts

@@ -100,6 +100,69 @@ function buildIntentMethodSection(intent: LlmTaskIntent): string {
   return lines.join('\n');
 }
 
+function buildStoreCheatSheet(): string {
+  const storeNamespace = NAMESPACE_SCHEMAS.find((schema) => schema.name === 'store');
+  if (!storeNamespace) return '';
+
+  return [
+    '## BIM.STORE CHEAT SHEET',
+    '`bim.store.*` edits a parsed model in place — use it when the user already has',
+    'a model loaded and wants raw STEP-level edits, NOT when building a new model from',
+    'scratch (that\'s `bim.create`).',
+    '',
+    '- `addEntity(modelId, { type, attributes })` — inject a STEP entity. `attributes`',
+    '  follows EntityExtractor output: numbers → REAL/integer, `"#42"` → ref, `".AREA."` → enum,',
+    '  `null` → `$`, arrays → STEP list. Returns `{ modelId, expressId }`.',
+    '- `removeEntity(entity)` — tombstones existing source entities or forgets overlay-only ones.',
+    '- `setPositionalAttribute(entity, index, value)` — edit a non-IfcRoot attribute by',
+    '  zero-based STEP argument index. Use this for `IfcRectangleProfileDef.XDim` (index 3),',
+    '  `YDim` (index 4), `IfcCartesianPoint.Coordinates` (index 0), etc. Use `bim.mutate.setAttribute`',
+    '  for IfcRoot attributes (Name, Description, ObjectType, Tag).',
+    '- High-level builders anchor a new element to an existing IfcBuildingStorey:',
+    '    `addColumn(modelId, storeyId, { Position, Width, Depth, Height })`',
+    '    `addWall(modelId, storeyId, { Start, End, Thickness, Height })`',
+    '    `addBeam(modelId, storeyId, { Start, End, Width, Height })`',
+    '    `addSlab(modelId, storeyId, { Position, Width, Depth, Thickness })`             // rectangle',
+    '    `addSlab(modelId, storeyId, { Profile: "polygon", OuterCurve: [[x,y],…], Thickness })`',
+    '    `addRoof(modelId, storeyId, { … same shape as addSlab — emits .FLAT_ROOF. })`',
+    '    `addPlate(modelId, storeyId, { … same shape as addSlab — IfcPlate, PredefinedType? })`',
+    '    `addSpace(modelId, storeyId, { Position, Width, Depth, Height, LongName? })`     // room rectangle',
+    '    `addSpace(modelId, storeyId, { Profile: "polygon", OuterCurve, Height })`        // room polygon',
+    '    `addDoor(modelId, storeyId, { Position, Width, Height, FrameThickness?, OperationType? })`',
+    '    `addWindow(modelId, storeyId, { Position, Width, Height, FrameThickness?, PartitioningType? })`',
+    '    `addMember(modelId, storeyId, { Start, End, Width, Height, PredefinedType? })`   // brace/post/strut',
+    '  Each emits ~12 STEP entities (placement chain → profile → solid → representation +',
+    '  IfcRelContainedInSpatialStructure, except `addSpace` which uses IfcRelAggregates).',
+    '  Coords are storey-local metres. Polygon outlines need ≥3 points; the polyline is auto-closed.',
+    '- Edits accumulate in an overlay; they show up after `bim.export.ifc(bim.query.all())`',
+    '  or when the viewer next renders. Use `bim.mutate.undo(modelId)` to roll back.',
+    '',
+    'Canonical examples:',
+    '```js',
+    '// Resize a rectangular profile from 0.3×0.4 to 0.6×0.4',
+    'const profile = bim.query.byId("arch", 35);',
+    'bim.store.setPositionalAttribute(profile, 3, 0.6);   // XDim',
+    '',
+    '// Drop a wall on the first storey',
+    'const storeyId = bim.query.byType("IfcBuildingStorey")[0].ref.expressId;',
+    'bim.store.addWall("arch", storeyId, {',
+    '  Start: [0, 0, 0], End: [5, 0, 0],',
+    '  Thickness: 0.2, Height: 3, Name: "North Wall",',
+    '});',
+    '',
+    '// Add a custom IfcCartesianPoint, then reference it from another entity',
+    'const pt = bim.store.addEntity("arch", {',
+    '  type: "IfcCartesianPoint",',
+    '  attributes: [[1.0, 2.0, 0.0]],',
+    '});',
+    'console.log("Allocated", pt.expressId);',
+    '',
+    '// Drop an entity entirely',
+    'bim.store.removeEntity(unwantedRef);',
+    '```',
+  ].join('\n');
+}
+
 function buildCreateContractCheatSheet(): string {
   const createNamespace = NAMESPACE_SCHEMAS.find((schema) => schema.name === 'create');
   if (!createNamespace) return '## BIM.CREATE CONTRACT CHEAT SHEET';
@@ -280,6 +343,7 @@ export function buildSystemPrompt(
   const intent = inferPromptIntent(task);
   const intentSection = buildIntentMethodSection(intent);
   const createContractCheatSheet = buildCreateContractCheatSheet();
+  const storeCheatSheet = buildStoreCheatSheet();
   const placementSemantics = buildPlacementSemanticsSection();
   const inspectionGuidance = buildInspectionGuidance();
 
@@ -326,9 +390,11 @@ ${intentSection}
 4. Keep scripts concise — avoid unnecessary abstractions
 5. Coordinates are in meters. Z is up. Do NOT assume every create method is storey-relative — use the method-specific placement rules below.
 6. For create or explicit rewrite turns, wrap runnable code in a \`\`\`js\`\`\` fence. For repair turns, return exactly one \`\`\`ifc-script-edits\`\`\` fence containing SEARCH/REPLACE blocks and no \`\`\`js\`\`\` fence.
-7. If the user asks to modify existing data, use \`bim.mutate\` or \`bim.query\` — NOT \`bim.create\`
+7. If the user asks to modify existing data, use \`bim.mutate\`, \`bim.store\`, or \`bim.query\` — NOT \`bim.create\`
    - Use \`bim.mutate.setAttribute(entity, "Description", "...")\` for root IFC attributes like \`Name\`, \`Description\`, \`ObjectType\`, or \`Tag\`
    - Use \`bim.mutate.setProperty(entity, "Pset_Name", "PropName", value)\` only for IfcPropertySet or quantity data
+   - Use \`bim.store.setPositionalAttribute(entity, index, value)\` for positional STEP-argument edits (profile dimensions, \`IfcCartesianPoint.Coordinates\`, and other index-addressed attributes — even when they have a symbolic name) — see BIM.STORE CHEAT SHEET
+   - Use \`bim.store.addEntity\` / \`bim.store.removeEntity\` to inject or drop raw STEP entities in an already-loaded model. Do NOT use \`bim.create\` for these — \`bim.create\` builds a fresh project
    - Distinguish occurrence vs type edits: occurrence/entity-specific changes belong on the occurrence; shared defaults and inherited type properties belong on the related \`Ifc...Type\` entity
    - If CURRENT MODEL STATE marks a selection as \`kind=type\`, treat it as a type object and avoid describing it as one physical placed occurrence
    - When an occurrence is selected, inspect \`bim.query.typeProperties(entity)\` before editing inherited values; mutate the type entity when the intent is to change all occurrences that share that type
@@ -353,6 +419,8 @@ ${intentSection}
 
 ${createContractCheatSheet}
 
+${storeCheatSheet}
+
 ${placementSemantics}
 - \`addIfcDoor\` and \`addIfcWindow\` do not infer host-wall orientation. If you place them next to angled walls, they will stay world-aligned unless you build the wall void another way.
 - For storey-relative methods, \`Z=0\` usually means floor level of that storey.
@@ -393,6 +461,39 @@ for (let i = 0; i < storeyCount; i++) {
 - If repeated elements appear only at one level, you probably reused one storey reference instead of iterating over the intended storeys.
 - If repeated world-placement elements stack at the base level, first check whether their Z coordinates include the current storey elevation.
 
+## SCHEDULING / 4D (IfcTask, IfcWorkSchedule, IfcRelSequence)
+- ifc-lite ships a Gantt panel in the lower workspace that plays a construction-sequence animation driven by IfcTask dates and the products each task controls.
+- Creating a schedule from scratch:
+  \`\`\`js
+  const h = bim.create.project({ Name: "Demo" });
+  const storey = bim.create.addIfcBuildingStorey(h, { Name: "Ground", Elevation: 0 });
+  const wallA = bim.create.addIfcWall(h, storey, { Start: [0,0,0], End: [5,0,0], Thickness: 0.2, Height: 3 });
+
+  const schedule = bim.create.addIfcWorkSchedule(h, {
+    Name: "Construction schedule",
+    StartTime: "2024-05-01T08:00:00",
+    FinishTime: "2024-06-30T17:00:00",
+    PredefinedType: "PLANNED",
+  });
+  const task = bim.create.addIfcTask(h, {
+    Name: "Install wall A",
+    PredefinedType: "INSTALLATION",
+    ScheduleStart: "2024-05-06T08:00:00",
+    ScheduleFinish: "2024-05-10T17:00:00",
+    ScheduleDuration: "P5D",
+  });
+  bim.create.assignTasksToWorkSchedule(h, schedule, [task]);
+  bim.create.assignProductsToTask(h, task, [wallA]);   // products reveal in the 4D animation
+  // bim.create.addIfcRelSequence(h, prevTask, task, { SequenceType: "FINISH_START", TimeLag: "P2D" });
+  // bim.create.nestTasks(h, summaryTask, [task]);    // WBS hierarchy
+  \`\`\`
+- Dates are ISO 8601 (\`2024-05-01T08:00:00\`). Durations are ISO 8601 (\`P5D\`, \`PT8H\`).
+- IfcTask.PredefinedType is an enum — prefer CONSTRUCTION, INSTALLATION, DEMOLITION, RENOVATION over free strings.
+- For milestones (e.g. "handover"), set \`IsMilestone: true\` and omit or equate start/finish.
+- \`assignProductsToTask\` is the bridge that lets the 4D Gantt animation reveal/hide elements as time advances. Always bind tasks to the elements they construct when the user wants the viewport to animate.
+- Reading an existing schedule: \`bim.schedule.data()\` returns { workSchedules, tasks, sequences }. Use it to inspect or validate a construction plan.
+- **CSV / Excel / PDF → schedule workflow:** when the user attaches a spreadsheet or PDF with activities and dates, parse it with \`bim.files.csv(name)\` (for CSV) or \`bim.files.text(name)\` (for text-extracted PDF/Excel content converted upstream). Map each row to an \`addIfcTask(...)\` call and resolve the \`products\` column — an IFC type like \`IfcWall\` expands to every matching entity, a globalId maps to one specific entity — into \`expressId\`s to feed \`assignProductsToTask\`. The \`Construction schedule (4D)\` script template is a ready-made starting point.
+
 ## API REFERENCE
 ${apiRef}
 

package/src/lib/llm/types.ts

@@ -124,6 +124,12 @@ export interface FileAttachment {
   imageBase64?: string;
   /** Whether this is an image attachment */
   isImage?: boolean;
+  /** Base64-encoded PDF data (for PDF attachments — Anthropic native document blocks) */
+  pdfBase64?: string;
+  /** Whether this is a PDF attachment */
+  isPdf?: boolean;
+  /** Whether this is a binary spreadsheet (xlsx/xls/ods) that we can't parse here yet. */
+  isSpreadsheetBinary?: boolean;
 }
 
 export type ModelTier = 'free' | 'byok';

package/src/lib/recent-files.ts

@@ -24,8 +24,21 @@ export interface RecentFileEntry {
   name: string;
   size: number;
   timestamp: number;
+  /** Native filesystem path (Tauri only) — enables direct re-open from disk. */
+  path?: string;
+  /** Last-modified epoch in ms when known (Tauri stat). */
+  modifiedMs?: number | null;
 }
 
+// Input shape for `recordRecentFiles` — accepts the optional native fields
+// so callers can persist a path / modifiedMs without lying about the type.
+export type RecentFileInput = {
+  name: string;
+  size: number;
+  path?: string;
+  modifiedMs?: number | null;
+};
+
 // ── localStorage (metadata) ─────────────────────────────────────────────
 
 export function getRecentFiles(): RecentFileEntry[] {
@@ -33,17 +46,30 @@ export function getRecentFiles(): RecentFileEntry[] {
   catch { return []; }
 }
 
-export function recordRecentFiles(files: { name: string; size: number }[]) {
+// Path-aware dedup key: when a native filesystem path is available it
+// uniquely identifies the file (so `A/model.ifc` and `B/model.ifc` are
+// kept separate); otherwise fall back to the name (browser uploads
+// don't expose paths).
+function recentKey(f: { name: string; path?: string }): string {
+  return f.path ? `path:${f.path}` : `name:${f.name}`;
+}
+
+export function recordRecentFiles(files: RecentFileInput[]) {
   try {
-    const names = new Set(files.map(f => f.name));
-    const existing = getRecentFiles().filter(f => !names.has(f.name));
+    const incomingKeys = new Set(files.map(recentKey));
+    const existing = getRecentFiles().filter(f => !incomingKeys.has(recentKey(f)));
     const entries: RecentFileEntry[] = files.map(f => ({
       name: f.name,
       size: f.size,
       timestamp: Date.now(),
+      path: f.path,
+      modifiedMs: f.modifiedMs ?? null,
     }));
     localStorage.setItem(KEY, JSON.stringify([...entries, ...existing].slice(0, 10)));
-  } catch { /* noop */ }
+  } catch (err) {
+    // eslint-disable-next-line no-console
+    console.warn('[recent-files] failed to persist recent files metadata', err);
+  }
 }
 
 /** Format bytes into human-readable size */
@@ -104,6 +130,14 @@ export async function cacheFileBlobs(files: File[]): Promise<void> {
 
 /** Retrieve a cached file blob and reconstruct a File object. */
 export async function getCachedFile(target: string | RecentFileEntry): Promise<File | null> {
+  // Path-bearing entries (Tauri filesystem) are uniquely keyed by path
+  // in the recents list, but the IndexedDB cache is name-keyed. A
+  // name-only hit could resolve `A/model.ifc` to the cached blob from
+  // `B/model.ifc`, opening the wrong file silently. Defer to the
+  // caller's native re-open path instead.
+  if (typeof target !== 'string' && target.path) {
+    return null;
+  }
   const name = typeof target === 'string' ? target : target.name;
   try {
     const db = await openDB();

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;
   };
 };