@ifc-lite/viewer 1.14.2 → 1.14.4

package/src/lib/llm/types.ts

@@ -0,0 +1,150 @@
+/* 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/. */
+
+/**
+ * Types for the LLM chat integration.
+ */
+
+import type { RepairScope, ScriptDiagnostic } from './script-diagnostics.js';
+
+export type MessageRole = 'user' | 'assistant' | 'system';
+
+export interface ChatMessage {
+  id: string;
+  role: MessageRole;
+  content: string;
+  /** Timestamp in ms */
+  createdAt: number;
+  /** Parsed code blocks from assistant messages */
+  codeBlocks?: CodeBlock[];
+  /** Execution results for code blocks in this message */
+  execResults?: Map<number, CodeExecResult>;
+  /** Attached files (user messages only) */
+  attachments?: FileAttachment[];
+}
+
+export interface CodeBlock {
+  /** Index within the message */
+  index: number;
+  /** Language hint from the code fence (e.g. 'js', 'typescript') */
+  language: string;
+  /** The code content */
+  code: string;
+}
+
+export interface CodeExecResult {
+  status: 'running' | 'success' | 'error';
+  logs?: Array<{ level: string; args: unknown[] }>;
+  value?: unknown;
+  error?: string;
+  durationMs?: number;
+}
+
+export interface ScriptEditorSelection {
+  from: number;
+  to: number;
+}
+
+export interface ScriptEditorTextChange {
+  from: number;
+  to: number;
+  insert: string;
+}
+
+interface ScriptEditBase {
+  opId: string;
+  baseRevision: number;
+  groupId?: string;
+  scope?: RepairScope;
+  atomic?: boolean;
+  targetRootCause?: string;
+}
+
+export interface ScriptEditInsertOp extends ScriptEditBase {
+  type: 'insert';
+  at: number;
+  text: string;
+}
+
+export interface ScriptEditReplaceRangeOp extends ScriptEditBase {
+  type: 'replaceRange';
+  from: number;
+  to: number;
+  text: string;
+  expectedText?: string;
+}
+
+export interface ScriptEditReplaceSelectionOp extends ScriptEditBase {
+  type: 'replaceSelection';
+  text: string;
+}
+
+export interface ScriptEditAppendOp extends ScriptEditBase {
+  type: 'append';
+  text: string;
+}
+
+export interface ScriptEditReplaceAllOp extends ScriptEditBase {
+  type: 'replaceAll';
+  text: string;
+}
+
+export type ScriptEditOperation =
+  | ScriptEditInsertOp
+  | ScriptEditReplaceRangeOp
+  | ScriptEditReplaceSelectionOp
+  | ScriptEditAppendOp
+  | ScriptEditReplaceAllOp;
+
+export type ChatRepairReason = 'runtime' | 'preflight' | 'patch-conflict' | 'patch-apply';
+
+export interface ChatRepairRequest {
+  error: string;
+  reason: ChatRepairReason;
+  diagnostics?: ScriptDiagnostic[];
+  staleCodeBlock?: string;
+  includeSelection?: boolean;
+  requestedRepairScope?: RepairScope;
+  rootCauseKey?: string;
+}
+
+export interface FileAttachment {
+  id: string;
+  name: string;
+  type: string;
+  size: number;
+  /** Parsed CSV rows (if CSV file) */
+  csvData?: Record<string, string>[];
+  /** Column names (if CSV file) */
+  csvColumns?: string[];
+  /** Raw text content */
+  textContent?: string;
+  /** Base64-encoded image data (for image attachments) */
+  imageBase64?: string;
+  /** Whether this is an image attachment */
+  isImage?: boolean;
+}
+
+export type ModelTier = 'free' | 'pro';
+
+/** Relative cost indicator for paid models */
+export type ModelCost = '$' | '$$' | '$$$';
+
+export interface LLMModel {
+  id: string;
+  name: string;
+  provider: string;
+  tier: ModelTier;
+  contextWindow: number;
+  /** Whether this model accepts image inputs in chat content */
+  supportsImages: boolean;
+  /** Whether this model should receive uploaded file context */
+  supportsFileAttachments: boolean;
+  /** Notes shown in model selector */
+  notes?: string;
+  /** Relative cost indicator (pro models only) */
+  cost?: ModelCost;
+}
+
+export type ChatStatus = 'idle' | 'sending' | 'streaming' | 'error';

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

@@ -23,12 +23,87 @@ 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 {
+  name: string;
+  value: string;
+}
+
+interface BimClassification {
+  system?: string;
+  identification?: string;
+  name?: string;
+  location?: string;
+  description?: string;
+  path?: string[];
+}
+
+interface BimMaterialLayer {
+  materialName?: string;
+  thickness?: number;
+  isVentilated?: boolean;
+  name?: string;
+  category?: string;
+}
+
+interface BimMaterialProfile {
+  materialName?: string;
+  name?: string;
+  category?: string;
+}
+
+interface BimMaterialConstituent {
+  materialName?: string;
+  name?: string;
+  fraction?: number;
+  category?: string;
+}
+
+interface BimMaterial {
+  type: 'Material' | 'MaterialLayerSet' | 'MaterialProfileSet' | 'MaterialConstituentSet' | 'MaterialList';
+  name?: string;
+  description?: string;
+  layers?: BimMaterialLayer[];
+  profiles?: BimMaterialProfile[];
+  constituents?: BimMaterialConstituent[];
+  materials?: string[];
+}
+
+interface BimTypeProperties {
+  typeName: string;
+  typeId: number;
+  properties: BimPropertySet[];
+}
+
+interface BimDocument {
+  name?: string;
+  description?: string;
+  location?: string;
+  identification?: string;
+  purpose?: string;
+  intendedUse?: string;
+  revision?: string;
+  confidentiality?: string;
+}
+
+interface BimRelationships {
+  voids: Array<{ id: number; name?: string; type: string }>;
+  fills: Array<{ id: number; name?: string; type: string }>;
+  groups: Array<{ id: number; name?: string }>;
+  connections: Array<{ id: number; name?: string; type: string }>;
 }
 
 interface BimModelInfo {
@@ -39,6 +114,49 @@ interface BimModelInfo {
   fileSize: number;
 }
 
+interface BimFileAttachment {
+  name: string;
+  type: string;
+  size: number;
+  rowCount?: number;
+  columns?: string[];
+  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: {
@@ -61,10 +179,44 @@ declare const bim: {
     byType(...types: string[]): BimEntity[];
     /** Get entity by model ID and express ID */
     entity(modelId: string, expressId: number): BimEntity | null;
+    /** Get all named string/enum attributes for an entity */
+    attributes(entity: BimEntity): BimAttribute[];
     /** Get all IfcPropertySet data for an entity */
     properties(entity: BimEntity): BimPropertySet[];
     /** Get all IfcElementQuantity data for an entity */
     quantities(entity: BimEntity): BimQuantitySet[];
+    /** Get a single property value from an entity */
+    property(entity: BimEntity, psetName: string, propName: string): string | number | boolean | null;
+    /** Get classification references for an entity */
+    classifications(entity: BimEntity): BimClassification[];
+    /** Get material assignment for an entity */
+    materials(entity: BimEntity): BimMaterial | null;
+    /** Get type-level property sets for an entity */
+    typeProperties(entity: BimEntity): BimTypeProperties | null;
+    /** Get linked document references for an entity */
+    documents(entity: BimEntity): BimDocument[];
+    /** Get structural relationship summary for an entity */
+    relationships(entity: BimEntity): BimRelationships;
+    /** Get a single quantity value from an entity */
+    quantity(entity: BimEntity, qsetName: string, quantityName: string): number | null;
+    /** Get related entities by IFC relationship type */
+    related(entity: BimEntity, relType: string, direction: 'forward' | 'inverse'): BimEntity[];
+    /** Get the spatial container of an entity */
+    containedIn(entity: BimEntity): BimEntity | null;
+    /** Get entities contained in a spatial container */
+    contains(entity: BimEntity): BimEntity[];
+    /** Get the parent aggregate of an entity */
+    decomposedBy(entity: BimEntity): BimEntity | null;
+    /** Get aggregated children of an entity */
+    decomposes(entity: BimEntity): BimEntity[];
+    /** Get the containing building storey of an entity */
+    storey(entity: BimEntity): BimEntity | null;
+    /** Get the spatial/aggregation path from project to entity */
+    path(entity: BimEntity): BimEntity[];
+    /** List all building storeys */
+    storeys(): BimEntity[];
+    /** Get the current viewer selection as entities */
+    selection(): BimEntity[];
   };
   /** Viewer control */
   viewer: {
@@ -89,8 +241,10 @@ declare const bim: {
   };
   /** Property editing */
   mutate: {
-    /** Set a property value */
+    /** Set an IfcPropertySet or quantity value */
     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;
     /** Delete a property */
     deleteProperty(entity: unknown, psetName: string, propName: string): void;
     /** Undo last mutation */
@@ -110,17 +264,69 @@ declare const bim: {
     /** 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: { Start: [number,number,number]; End: [number,number,number]; Thickness: number; Height: number; Name?: string; Openings?: Array<{ Width: number; Height: number; Position: [number,number,number]; Name?: string }> }): number;
+    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: { Position: [number,number,number]; Thickness: number; Width?: number; Depth?: number; Profile?: [number,number][]; Name?: string; Openings?: Array<{ Width: number; Height: number; Position: [number,number,number]; Name?: string }> }): number;
+    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: { Position: [number,number,number]; Width: number; Depth: number; Height: number; Name?: string }): number;
+    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: { Start: [number,number,number]; End: [number,number,number]; Width: number; Height: number; Name?: string }): number;
+    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: { Position: [number,number,number]; NumberOfRisers: number; RiserHeight: number; TreadLength: number; Width: number; Direction?: number; Name?: string }): number;
+    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: { Position: [number,number,number]; Width: number; Depth: number; Thickness: number; Slope?: number; Name?: string }): number;
+    addIfcRoof(handle: number, storeyId: number, params: BimElementAttrs & { Position: [number,number,number]; Width: number; Depth: number; Thickness: number; Slope?: number }): 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;
+    /** 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;
+    /** 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;
+    /** Create a profile from a ProfileDef union. Returns profile ID. */
+    createProfile(handle: number, profile: BimProfileDef): 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. */
@@ -132,12 +338,25 @@ declare const bim: {
     /** 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: {
+    /** List uploaded file attachments available to scripts */
+    list(): BimFileAttachment[];
+    /** Get raw text content for an uploaded attachment by file name */
+    text(name: string): string | null;
+    /** Get parsed CSV/TSV rows for an uploaded attachment by file name */
+    csv(name: string): Record<string, string>[] | null;
+    /** Get parsed CSV column names for an uploaded attachment by file name */
+    csvColumns(name: string): string[];
+  };
   /** Data export */
   export: {
     /** Export entities to CSV string */
     csv(entities: BimEntity[], options: { columns: string[]; filename?: string; separator?: string }): string;
     /** 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 */
     download(content: string, filename: string, mimeType?: string): void;
   };

package/src/lib/scripts/templates/create-building.ts

@@ -249,7 +249,7 @@ bim.create.addIfcElementQuantity(h, stairId, {
 
 const ff = bim.create.addIfcBuildingStorey(h, { Name: 'First Floor', Elevation: 3 });
 
-// Floor slab at z = 3 with stair opening
+// Floor slab — position is relative to storey elevation (3m)
 // Opening must be long enough for headroom (≥ 2.1 m) over the ascending stair.
 // At the slab level the stair is still rising, so the opening needs to extend
 // back far enough that a person standing on a lower step has full clearance.
@@ -258,7 +258,7 @@ const stairOpenLen = 4.2;                          // ~1.5 × run ensures headro
 const stairOpenY = stairRunEnd - stairOpenLen / 2; // center near arrival end
 const ffSlab = bim.create.addIfcSlab(h, ff, {
   Name: 'First Floor Slab', Description: 'Reinforced concrete floor slab', ObjectType: 'Floor:Concrete - 300mm',
-  Position: [0, 0, 2.7], Thickness: 0.3, Width: 5, Depth: 8,
+  Position: [0, 0, -0.3], Thickness: 0.3, Width: 5, Depth: 8,
   Openings: [
     { Name: 'Stair Opening', Width: stairW + 0.2, Height: stairOpenLen, Position: [stairW / 2, stairOpenY, 0] },
   ],
@@ -282,31 +282,31 @@ bim.create.addIfcPropertySet(h, ffSlab, {
   ],
 });
 
-// Second floor walls — same footprint, window on east instead of door
+// Second floor walls — same footprint, Z=0 relative to storey elevation
 const ffSouthWall = bim.create.addIfcWall(h, ff, {
   Name: 'South Wall', Description: 'Exterior south façade', ObjectType: 'Basic Wall:Exterior - 200mm',
-  Start: [0, 0, 3], End: [5, 0, 3], Thickness: 0.2, Height: 3,
+  Start: [0, 0, 0], End: [5, 0, 0], Thickness: 0.2, Height: 3,
   Openings: [
     { Name: 'W-03 Window', Width: 1.2, Height: 1.5, Position: [1.5, 0, 0.9] },
   ],
 });
 const ffEastWall = bim.create.addIfcWall(h, ff, {
   Name: 'East Wall', Description: 'Exterior east façade', ObjectType: 'Basic Wall:Exterior - 200mm',
-  Start: [5, 0, 3], End: [5, 8, 3], Thickness: 0.2, Height: 3,
+  Start: [5, 0, 0], End: [5, 8, 0], Thickness: 0.2, Height: 3,
   Openings: [
     { Name: 'W-04 Window', Width: 1.4, Height: 1.5, Position: [3, 0, 0.9] },
   ],
 });
 const ffNorthWall = bim.create.addIfcWall(h, ff, {
   Name: 'North Wall', Description: 'Exterior north façade', ObjectType: 'Basic Wall:Exterior - 200mm',
-  Start: [5, 8, 3], End: [0, 8, 3], Thickness: 0.2, Height: 3,
+  Start: [5, 8, 0], End: [0, 8, 0], Thickness: 0.2, Height: 3,
   Openings: [
     { Name: 'W-05 Window', Width: 1.4, Height: 1.5, Position: [1.8, 0, 0.9] },
   ],
 });
 const ffWestWall = bim.create.addIfcWall(h, ff, {
   Name: 'West Wall', Description: 'Exterior west façade', ObjectType: 'Basic Wall:Exterior - 200mm',
-  Start: [0, 8, 3], End: [0, 0, 3], Thickness: 0.2, Height: 3,
+  Start: [0, 8, 0], End: [0, 0, 0], Thickness: 0.2, Height: 3,
 });
 
 for (const wId of [ffSouthWall, ffEastWall, ffNorthWall, ffWestWall]) {
@@ -350,21 +350,21 @@ for (const [wId, wName, wLen] of [
   });
 }
 
-// Second floor columns
+// Second floor columns — Z=0 relative to storey elevation
 for (const [cName, cx, cy] of columnPositions) {
   const colId = bim.create.addIfcColumn(h, ff, {
     Name: cName, Description: 'Reinforced concrete column', ObjectType: 'Column:Concrete 300x300',
-    Position: [cx, cy, 3], Width: 0.3, Depth: 0.3, Height: 3,
+    Position: [cx, cy, 0], Width: 0.3, Depth: 0.3, Height: 3,
   });
   bim.create.setColor(h, colId, 'Concrete - Light', [0.72, 0.72, 0.74]);
   bim.create.addIfcMaterial(h, colId, { Name: 'Reinforced Concrete C30/37', Category: 'Concrete' });
 }
 
-// Second floor beams
+// Second floor beams — Z=3 relative to storey elevation (→ world Z=6)
 for (const [bName, bStart, bEnd] of beamDefs) {
   const beamId = bim.create.addIfcBeam(h, ff, {
     Name: bName, Description: 'Steel I-beam', ObjectType: 'Beam:IPE 200',
-    Start: [bStart[0], bStart[1], 6], End: [bEnd[0], bEnd[1], 6], Width: 0.2, Height: 0.4,
+    Start: [bStart[0], bStart[1], 3], End: [bEnd[0], bEnd[1], 3], Width: 0.2, Height: 0.4,
   });
   bim.create.setColor(h, beamId, 'Steel - Grey', [0.55, 0.55, 0.58]);
   bim.create.addIfcMaterial(h, beamId, { Name: 'Structural Steel S235', Category: 'Steel' });
@@ -378,7 +378,7 @@ for (const [bName, bStart, bEnd] of beamDefs) {
 
 const ROOF_W = 5;           // building width (X)
 const ROOF_D = 8;           // building depth (Y)
-const WALL_H = 6;           // wall-top elevation (2 storeys × 3 m)
+const WALL_H = 3;           // wall-top relative to first floor storey (elevation 3)
 const CROWN  = 1.8;         // rise above walls
 const NU     = 10;          // grid divisions along X
 const NV     = 16;          // grid divisions along Y

package/src/main.tsx

@@ -8,11 +8,20 @@
 
 import React from 'react';
 import ReactDOM from 'react-dom/client';
+import { ClerkProvider } from '@clerk/clerk-react';
 import { App } from './App';
 import './index.css';
 
+const clerkPublishableKey = (import.meta.env.VITE_CLERK_PUBLISHABLE_KEY as string | undefined)?.trim();
+
 ReactDOM.createRoot(document.getElementById('root')!).render(
   <React.StrictMode>
-    <App />
+    {clerkPublishableKey ? (
+      <ClerkProvider publishableKey={clerkPublishableKey}>
+        <App />
+      </ClerkProvider>
+    ) : (
+      <App />
+    )}
   </React.StrictMode>
 );

package/src/sdk/adapters/export-adapter.test.ts

@@ -0,0 +1,24 @@
+/* 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/. */
+
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { resolveVisibilityFilterSets } from './export-adapter.js';
+import { LEGACY_MODEL_ID } from './model-compat.js';
+
+test('resolveVisibilityFilterSets honors legacy single-model hidden and isolated state', () => {
+  const state = {
+    models: new Map(),
+    hiddenEntities: new Set([11, 12]),
+    isolatedEntities: new Set([21, 22]),
+    hiddenEntitiesByModel: new Map(),
+    isolatedEntitiesByModel: new Map(),
+  };
+
+  const result = resolveVisibilityFilterSets(state as never, LEGACY_MODEL_ID, new Set([1, 2, 3]), 3);
+
+  assert.equal(result.visibleOnly, false);
+  assert.deepEqual([...result.hiddenEntityIds], [11, 12]);
+  assert.deepEqual(result.isolatedEntityIds ? [...result.isolatedEntityIds] : null, [21, 22]);
+});