@ifc-lite/viewer 1.7.0 → 1.9.0

package/src/lib/scripts/templates/mep-equipment-schedule.ts

@@ -0,0 +1,175 @@
+export {} // module boundary (stripped by transpiler)
+
+// ── MEP Equipment Schedule ──────────────────────────────────────────────
+// Stakeholder: HVAC / MEP Engineer
+//
+// Discovers all MEP/distribution elements in the model, extracts their
+// properties (manufacturer, model, capacity, pressure, flow rate), and
+// generates a structured equipment register. The UI's property panel
+// shows one element at a time — this script scans hundreds of elements
+// and builds the schedule that would otherwise require a spreadsheet.
+// ─────────────────────────────────────────────────────────────────────────
+
+// ── 1. Query all MEP-related IFC types ──────────────────────────────────
+const MEP_TYPES = [
+  // HVAC
+  'IfcAirTerminal', 'IfcAirTerminalBox', 'IfcFan', 'IfcCoil', 'IfcCompressor',
+  'IfcCondenser', 'IfcCooledBeam', 'IfcCoolingTower', 'IfcEvaporativeCooler',
+  'IfcEvaporator', 'IfcHeatExchanger', 'IfcHumidifier', 'IfcUnitaryEquipment',
+  'IfcBoiler', 'IfcChiller', 'IfcAirToAirHeatRecovery',
+  // Plumbing
+  'IfcSanitaryTerminal', 'IfcWasteTerminal', 'IfcFireSuppressionTerminal',
+  'IfcTank', 'IfcPump', 'IfcValve',
+  // Electrical
+  'IfcElectricDistributionBoard', 'IfcElectricGenerator', 'IfcElectricMotor',
+  'IfcTransformer', 'IfcSwitchingDevice', 'IfcOutlet', 'IfcLightFixture',
+  'IfcLamp', 'IfcJunctionBox',
+  // Generic distribution
+  'IfcDistributionElement', 'IfcDistributionControlElement',
+  'IfcDistributionFlowElement', 'IfcFlowTerminal', 'IfcFlowMovingDevice',
+  'IfcFlowController', 'IfcFlowStorageDevice', 'IfcFlowTreatmentDevice',
+  'IfcFlowFitting', 'IfcFlowSegment', 'IfcEnergyConversionDevice',
+  // Segments
+  'IfcDuctSegment', 'IfcPipeSegment', 'IfcCableCarrierSegment', 'IfcCableSegment',
+  'IfcDuctFitting', 'IfcPipeFitting', 'IfcCableCarrierFitting',
+  // Furnishing (often used for MEP equipment in some models)
+  'IfcFurnishingElement',
+]
+
+const elements = bim.query.byType(...MEP_TYPES)
+
+if (elements.length === 0) {
+  // Fall back: show what types ARE in the model so user can adapt
+  console.warn('No standard MEP element types found.')
+  console.log('')
+  console.log('Available types in this model:')
+  const all = bim.query.all()
+  const types: Record<string, number> = {}
+  for (const e of all) types[e.Type] = (types[e.Type] || 0) + 1
+  for (const [t, c] of Object.entries(types).sort((a, b) => b[1] - a[1])) {
+    console.log('  ' + t + ': ' + c)
+  }
+  console.log('')
+  console.log('Tip: edit MEP_TYPES at top of script to match your model\'s types.')
+  throw new Error('no MEP elements')
+}
+
+// ── 2. Group by IFC type ────────────────────────────────────────────────
+const byType: Record<string, BimEntity[]> = {}
+for (const e of elements) {
+  if (!byType[e.Type]) byType[e.Type] = []
+  byType[e.Type].push(e)
+}
+
+console.log('═══════════════════════════════════════')
+console.log('  MEP EQUIPMENT SCHEDULE')
+console.log('═══════════════════════════════════════')
+console.log('')
+console.log('Found ' + elements.length + ' MEP elements across ' + Object.keys(byType).length + ' types')
+
+// ── 3. Extract properties for each type ─────────────────────────────────
+// Properties of interest for MEP equipment
+const MEP_PROPS = [
+  'manufacturer', 'model', 'reference', 'status',
+  'capacity', 'power', 'voltage', 'current', 'frequency',
+  'flowrate', 'pressure', 'temperature',
+  'nominalcapacity', 'nominalpower',
+]
+
+interface EquipmentEntry {
+  entity: BimEntity
+  props: Record<string, string | number | boolean | null>
+}
+
+const schedule: Record<string, EquipmentEntry[]> = {}
+// Collect all unique property paths for CSV export columns
+const propertyColumns = new Set<string>()
+
+for (const [type, entities] of Object.entries(byType).sort((a, b) => b[1].length - a[1].length)) {
+  schedule[type] = []
+
+  // Cap property extraction at 200 per type
+  const sample = entities.length > 200 ? entities.slice(0, 200) : entities
+
+  for (const entity of sample) {
+    const entry: EquipmentEntry = { entity, props: {} }
+    const psets = bim.query.properties(entity)
+    for (const pset of psets) {
+      for (const p of pset.properties) {
+        const lower = p.name.toLowerCase()
+        if (MEP_PROPS.some(k => lower.includes(k)) && p.value !== null && p.value !== '') {
+          const path = pset.name + '.' + p.name
+          entry.props[path] = p.value
+          propertyColumns.add(path)
+        }
+      }
+    }
+    schedule[type].push(entry)
+  }
+}
+
+// ── 4. Print schedule ───────────────────────────────────────────────────
+for (const [type, entries] of Object.entries(schedule).sort((a, b) => b[1].length - a[1].length)) {
+  console.log('')
+  console.log('── ' + type + ' (' + byType[type].length + ') ──')
+
+  // Collect all property keys found in this type
+  const allKeys = new Set<string>()
+  for (const entry of entries) {
+    for (const key of Object.keys(entry.props)) allKeys.add(key)
+  }
+
+  if (allKeys.size === 0) {
+    // Show name grouping even without properties
+    const names: Record<string, number> = {}
+    for (const entry of entries) {
+      const key = entry.entity.Name || entry.entity.ObjectType || '<unnamed>'
+      names[key] = (names[key] || 0) + 1
+    }
+    for (const [name, count] of Object.entries(names).sort((a, b) => b[1] - a[1])) {
+      console.log('  ' + name + (count > 1 ? ' (x' + count + ')' : ''))
+    }
+  } else {
+    // Show first 10 entries with their properties
+    for (const entry of entries.slice(0, 10)) {
+      const label = entry.entity.Name || entry.entity.ObjectType || '<unnamed>'
+      console.log('  ' + label)
+      for (const [key, value] of Object.entries(entry.props)) {
+        console.log('    ' + key + ' = ' + value)
+      }
+    }
+    if (entries.length > 10) console.log('  ... and ' + (entries.length - 10) + ' more')
+  }
+}
+
+// ── 5. Color-code by system type ────────────────────────────────────────
+const palette = [
+  '#e74c3c', '#3498db', '#2ecc71', '#f39c12',
+  '#9b59b6', '#1abc9c', '#e67e22', '#34495e',
+]
+const batches: Array<{ entities: BimEntity[]; color: string }> = []
+let colorIdx = 0
+for (const [type, entities] of Object.entries(byType).sort((a, b) => b[1].length - a[1].length)) {
+  batches.push({ entities, color: palette[colorIdx % palette.length] })
+  colorIdx++
+}
+bim.viewer.colorizeAll(batches)
+bim.viewer.isolate(elements)
+
+// ── 6. Summary ──────────────────────────────────────────────────────────
+console.log('')
+console.log('── Type Summary ──')
+for (const [type, entities] of Object.entries(byType).sort((a, b) => b[1].length - a[1].length)) {
+  const color = palette[(Object.keys(byType).sort((a, b) => byType[b].length - byType[a].length).indexOf(type)) % palette.length]
+  console.log('  ' + type + ': ' + entities.length + '  ● ' + color)
+}
+
+// ── 7. Export ────────────────────────────────────────────────────────────
+const propCols = Array.from(propertyColumns).sort()
+bim.export.csv(elements, {
+  columns: ['Name', 'Type', 'ObjectType', 'GlobalId', 'Description', ...propCols],
+  filename: 'mep-equipment-schedule.csv'
+})
+console.log('')
+console.log('Exported ' + elements.length + ' MEP elements (' + (5 + propCols.length) + ' columns) to mep-equipment-schedule.csv')
+console.log('Elements are isolated and color-coded by type in 3D view')

package/src/lib/scripts/templates/quantity-takeoff.ts

@@ -0,0 +1,145 @@
+export {} // module boundary (stripped by transpiler)
+
+// ── Quantity Takeoff ────────────────────────────────────────────────────
+// Stakeholder: Cost Estimator / Project Manager
+//
+// Aggregates quantities (area, volume, length, width, height) across all
+// structural and architectural element types. This combines what would
+// require opening the properties panel for each element individually,
+// manually recording numbers, and aggregating in a spreadsheet. The
+// script does it in seconds and exports a ready-to-use CSV.
+// ─────────────────────────────────────────────────────────────────────────
+
+const ELEMENT_TYPES = [
+  'IfcWall', 'IfcWallStandardCase',
+  'IfcSlab',
+  'IfcColumn',
+  'IfcBeam',
+  'IfcDoor', 'IfcDoorStandardCase',
+  'IfcWindow',
+  'IfcCovering',
+  'IfcCurtainWall',
+  'IfcRoof',
+  'IfcStair', 'IfcStairFlight',
+  'IfcRailing',
+  'IfcPlate',
+  'IfcMember',
+  'IfcFooting',
+  'IfcPile',
+]
+
+// Quantities we care about (case-insensitive matching)
+const QTY_KEYS = ['area', 'volume', 'length', 'width', 'height', 'netarea', 'netsidearea', 'netvolume', 'grossarea', 'grossvolume', 'perimeter']
+
+interface TypeTakeoff {
+  type: string
+  count: number
+  quantities: Record<string, { sum: number; count: number; unit: string }>
+}
+
+console.log('═══════════════════════════════════════')
+console.log('  QUANTITY TAKEOFF')
+console.log('═══════════════════════════════════════')
+console.log('')
+
+const takeoffs: TypeTakeoff[] = []
+let totalElements = 0
+// Collect all unique Qto set+quantity paths for CSV export columns
+const quantityColumns = new Set<string>()
+
+for (const ifcType of ELEMENT_TYPES) {
+  const entities = bim.query.byType(ifcType)
+  if (entities.length === 0) continue
+
+  totalElements += entities.length
+  const takeoff: TypeTakeoff = { type: ifcType, count: entities.length, quantities: {} }
+
+  // Sample all entities for quantities (cap at 500 to avoid timeout)
+  const sample = entities.length > 500 ? entities.slice(0, 500) : entities
+  const isSampled = entities.length > 500
+
+  for (const entity of sample) {
+    const qsets = bim.query.quantities(entity)
+    for (const qset of qsets) {
+      for (const q of qset.quantities) {
+        if (q.value === null || q.value === 0) continue
+        const lower = q.name.toLowerCase()
+        // Only aggregate quantities we care about
+        const match = QTY_KEYS.find(k => lower.includes(k))
+        if (!match) continue
+        const key = q.name
+        if (!takeoff.quantities[key]) takeoff.quantities[key] = { sum: 0, count: 0, unit: '' }
+        takeoff.quantities[key].sum += q.value
+        takeoff.quantities[key].count++
+        // Track the full path for CSV export
+        quantityColumns.add(qset.name + '.' + q.name)
+      }
+    }
+  }
+
+  // Scale up if sampled
+  if (isSampled) {
+    const factor = entities.length / sample.length
+    for (const q of Object.values(takeoff.quantities)) {
+      q.sum = q.sum * factor
+    }
+  }
+
+  takeoffs.push(takeoff)
+}
+
+if (takeoffs.length === 0) {
+  console.error('No elements with quantities found')
+  throw new Error('no quantities')
+}
+
+// ── Report ──────────────────────────────────────────────────────────────
+console.log('Scanned ' + totalElements + ' elements across ' + takeoffs.length + ' types')
+console.log('')
+
+for (const t of takeoffs.sort((a, b) => b.count - a.count)) {
+  console.log('── ' + t.type + ' (' + t.count + ') ──')
+  const qEntries = Object.entries(t.quantities).sort((a, b) => b[1].sum - a[1].sum)
+  if (qEntries.length === 0) {
+    console.log('  (no quantities defined)')
+  } else {
+    for (const [name, q] of qEntries) {
+      const avg = q.sum / q.count
+      console.log('  ' + name + ': total=' + q.sum.toFixed(2) + '  avg=' + avg.toFixed(2) + '  (from ' + q.count + ' entities)')
+    }
+  }
+  console.log('')
+}
+
+// ── Summary table ───────────────────────────────────────────────────────
+console.log('── Summary ──')
+console.log('Type                       | Count |    Area    |   Volume')
+console.log('---------------------------+-------+------------+-----------')
+for (const t of takeoffs.sort((a, b) => b.count - a.count)) {
+  // Find area and volume totals
+  let area = 0
+  let volume = 0
+  for (const [name, q] of Object.entries(t.quantities)) {
+    const lower = name.toLowerCase()
+    if (lower.includes('area') && !lower.includes('net')) area += q.sum
+    if (lower.includes('volume') && !lower.includes('net')) volume += q.sum
+  }
+  const typeStr = (t.type + '                           ').slice(0, 27)
+  const countStr = ('     ' + t.count).slice(-5)
+  const areaStr = area > 0 ? (area.toFixed(1) + ' m²') : '-'
+  const volStr = volume > 0 ? (volume.toFixed(2) + ' m³') : '-'
+  console.log(typeStr + '| ' + countStr + ' | ' + ('          ' + areaStr).slice(-10) + ' | ' + ('         ' + volStr).slice(-9))
+}
+
+// ── Export ───────────────────────────────────────────────────────────────
+// Build a flat entity list with quantities for CSV export
+const allElements = bim.query.byType(...ELEMENT_TYPES)
+if (allElements.length > 0) {
+  const qtyCols = Array.from(quantityColumns).sort()
+  bim.export.csv(allElements, {
+    columns: ['Name', 'Type', 'ObjectType', 'GlobalId', ...qtyCols],
+    filename: 'quantity-takeoff.csv'
+  })
+  console.log('')
+  console.log('Exported ' + allElements.length + ' elements (' + (4 + qtyCols.length) + ' columns) to quantity-takeoff.csv')
+}

package/src/lib/scripts/templates/reset-view.ts

@@ -0,0 +1,6 @@
+export {} // module boundary (stripped by transpiler)
+
+// Reset colors and visibility
+bim.viewer.resetColors()
+bim.viewer.resetVisibility()
+console.log('View reset — all colors and visibility restored')

package/src/lib/scripts/templates/space-validation.ts

@@ -0,0 +1,189 @@
+export {} // module boundary (stripped by transpiler)
+
+// ── Space & Room Validation ─────────────────────────────────────────────
+// Stakeholder: Facility Manager / Architect
+//
+// Validates IfcSpace entities for operations handover readiness. Checks
+// that every space has a Name, LongName, area and volume quantities,
+// and required properties. Generates a room schedule with measurements
+// and flags incomplete spaces. This would take hours of clicking through
+// individual spaces in the property panel.
+// ─────────────────────────────────────────────────────────────────────────
+
+bim.viewer.resetColors()
+bim.viewer.resetVisibility()
+
+const spaces = bim.query.byType('IfcSpace')
+
+if (spaces.length === 0) {
+  console.warn('No IfcSpace entities found in this model.')
+  console.log('')
+  console.log('This script validates room/space data. Models without')
+  console.log('IfcSpace entities are missing spatial programming data.')
+  console.log('')
+  // Show what spatial types exist
+  const spatialTypes = bim.query.byType('IfcBuildingStorey', 'IfcBuilding', 'IfcSite')
+  if (spatialTypes.length > 0) {
+    console.log('Spatial structure found:')
+    for (const e of spatialTypes) {
+      console.log('  ' + e.Type + ': ' + (e.Name || '<unnamed>'))
+    }
+  }
+  throw new Error('no spaces')
+}
+
+// ── 1. Extract space data ───────────────────────────────────────────────
+interface SpaceData {
+  entity: BimEntity
+  area: number | null
+  volume: number | null
+  perimeter: number | null
+  height: number | null
+  longName: string | null
+  category: string | null
+  occupancy: string | null
+  issues: string[]
+}
+
+const spaceData: SpaceData[] = []
+// Collect property/quantity paths for CSV export
+const spacePropPaths = new Set<string>()
+const spaceQtyPaths = new Set<string>()
+
+for (const space of spaces) {
+  const data: SpaceData = {
+    entity: space, area: null, volume: null, perimeter: null, height: null,
+    longName: null, category: null, occupancy: null, issues: []
+  }
+
+  // Extract quantities
+  const qsets = bim.query.quantities(space)
+  for (const qset of qsets) {
+    for (const q of qset.quantities) {
+      const lower = q.name.toLowerCase()
+      if (lower.includes('area') && !lower.includes('wall') && data.area === null) data.area = q.value
+      if (lower.includes('volume') && data.volume === null) data.volume = q.value
+      if (lower.includes('perimeter') && data.perimeter === null) data.perimeter = q.value
+      if (lower.includes('height') && data.height === null) data.height = q.value
+      if (q.value !== null && q.value !== 0) spaceQtyPaths.add(qset.name + '.' + q.name)
+    }
+  }
+
+  // Extract properties
+  const psets = bim.query.properties(space)
+  for (const pset of psets) {
+    for (const p of pset.properties) {
+      const lower = p.name.toLowerCase()
+      if (lower === 'longname' && p.value) data.longName = String(p.value)
+      if (lower === 'category' && p.value) data.category = String(p.value)
+      if (lower === 'occupancytype' && p.value) data.occupancy = String(p.value)
+      if (p.value !== null && p.value !== '') spacePropPaths.add(pset.name + '.' + p.name)
+    }
+  }
+
+  // Also check entity attributes
+  if (!data.longName && space.Description) data.longName = space.Description
+
+  // Check for issues
+  if (!space.Name || space.Name === '') data.issues.push('Missing Name')
+  if (!data.longName) data.issues.push('Missing LongName/Description')
+  if (data.area === null) data.issues.push('Missing Area')
+  if (data.volume === null) data.issues.push('Missing Volume')
+
+  spaceData.push(data)
+}
+
+// ── 2. Classify spaces ─────────────────────────────────────────────────
+const complete = spaceData.filter(s => s.issues.length === 0)
+const incomplete = spaceData.filter(s => s.issues.length > 0)
+
+// ── 3. Color-code ───────────────────────────────────────────────────────
+const batches: Array<{ entities: BimEntity[]; color: string }> = []
+if (complete.length > 0) batches.push({ entities: complete.map(s => s.entity), color: '#27ae60' })
+const minor = incomplete.filter(s => s.issues.length <= 2)
+const major = incomplete.filter(s => s.issues.length > 2)
+if (minor.length > 0) batches.push({ entities: minor.map(s => s.entity), color: '#f39c12' })
+if (major.length > 0) batches.push({ entities: major.map(s => s.entity), color: '#e74c3c' })
+if (batches.length > 0) bim.viewer.colorizeAll(batches)
+
+// ── 4. Report ───────────────────────────────────────────────────────────
+console.log('═══════════════════════════════════════')
+console.log('  SPACE & ROOM VALIDATION')
+console.log('═══════════════════════════════════════')
+console.log('')
+console.log('Spaces found: ' + spaces.length)
+console.log('  Complete:     ' + complete.length + '  ● green')
+console.log('  Minor issues: ' + minor.length + '  ● orange (1-2 issues)')
+console.log('  Major issues: ' + major.length + '  ● red (3+ issues)')
+
+// ── 5. Room schedule ────────────────────────────────────────────────────
+console.log('')
+console.log('── Room Schedule ──')
+console.log('Name                    | Area m²  | Volume m³ | Height m | Status')
+console.log('------------------------+----------+-----------+----------+-------')
+
+// Sort by name
+const sorted = [...spaceData].sort((a, b) => {
+  const nameA = a.entity.Name || 'zzz'
+  const nameB = b.entity.Name || 'zzz'
+  return nameA.localeCompare(nameB)
+})
+
+let totalArea = 0
+let totalVolume = 0
+
+for (const s of sorted) {
+  const name = ((s.entity.Name || '<unnamed>') + '                        ').slice(0, 24)
+  const area = s.area !== null ? (s.area.toFixed(1) + '    ').slice(0, 8) : '-       '
+  const vol = s.volume !== null ? (s.volume.toFixed(1) + '     ').slice(0, 9) : '-        '
+  const height = s.height !== null ? (s.height.toFixed(2) + '   ').slice(0, 8) : '-       '
+  const status = s.issues.length === 0 ? 'OK' : s.issues.length + ' issues'
+  console.log(name + '| ' + area + ' | ' + vol + ' | ' + height + ' | ' + status)
+  if (s.area !== null) totalArea += s.area
+  if (s.volume !== null) totalVolume += s.volume
+}
+
+console.log('------------------------+----------+-----------+----------+-------')
+console.log('TOTALS                  | ' + (totalArea.toFixed(1) + '    ').slice(0, 8) + ' | ' + (totalVolume.toFixed(1) + '     ').slice(0, 9) + ' |')
+
+// ── 6. Category breakdown ───────────────────────────────────────────────
+const categories: Record<string, { count: number; area: number }> = {}
+for (const s of spaceData) {
+  const cat = s.category || s.entity.ObjectType || 'Uncategorized'
+  if (!categories[cat]) categories[cat] = { count: 0, area: 0 }
+  categories[cat].count++
+  if (s.area !== null) categories[cat].area += s.area
+}
+
+if (Object.keys(categories).length > 1) {
+  console.log('')
+  console.log('── By Category ──')
+  for (const [cat, data] of Object.entries(categories).sort((a, b) => b[1].area - a[1].area)) {
+    console.log('  ' + cat + ': ' + data.count + ' spaces, ' + data.area.toFixed(1) + ' m²')
+  }
+}
+
+// ── 7. Issue details ────────────────────────────────────────────────────
+if (incomplete.length > 0) {
+  console.log('')
+  console.warn('── Incomplete Spaces ──')
+  const issueCount: Record<string, number> = {}
+  for (const s of incomplete) {
+    for (const issue of s.issues) {
+      issueCount[issue] = (issueCount[issue] || 0) + 1
+    }
+  }
+  for (const [issue, count] of Object.entries(issueCount).sort((a, b) => b[1] - a[1])) {
+    console.warn('  ' + issue + ': ' + count + ' spaces')
+  }
+}
+
+// ── 8. Export ────────────────────────────────────────────────────────────
+const spPropCols = Array.from(spacePropPaths).sort().slice(0, 15)
+const spQtyCols = Array.from(spaceQtyPaths).sort().slice(0, 15)
+bim.export.csv(spaces, {
+  columns: ['Name', 'Type', 'GlobalId', 'Description', 'ObjectType', ...spPropCols, ...spQtyCols],
+  filename: 'room-schedule.csv'
+})
+console.log('')
+console.log('Exported ' + spaces.length + ' spaces (' + (5 + spPropCols.length + spQtyCols.length) + ' columns) to room-schedule.csv')

package/src/lib/scripts/templates/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["bim-globals.d.ts", "*.ts"],
+  "exclude": ["tsconfig.json"]
+}

package/src/lib/scripts/templates.ts

@@ -0,0 +1,86 @@
+/* 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/. */
+
+/**
+ * Built-in script templates for the script editor.
+ *
+ * Templates are real .ts files in ./templates/ that are type-checked
+ * against the bim-globals.d.ts declaration. They are loaded as raw
+ * strings via Vite's ?raw import and served to the sandbox transpiler.
+ *
+ * Each template targets a specific stakeholder and combines multiple
+ * API calls into automated workflows that go beyond what the UI can
+ * do through manual clicking.
+ */
+
+// Raw source imports — Vite returns the file content as a string
+import dataQualityAudit from './templates/data-quality-audit.ts?raw';
+import fireSafetyCheck from './templates/fire-safety-check.ts?raw';
+import quantityTakeoff from './templates/quantity-takeoff.ts?raw';
+import envelopeCheck from './templates/envelope-check.ts?raw';
+import mepEquipmentSchedule from './templates/mep-equipment-schedule.ts?raw';
+import spaceValidation from './templates/space-validation.ts?raw';
+import federationCompare from './templates/federation-compare.ts?raw';
+import resetView from './templates/reset-view.ts?raw';
+
+export interface ScriptTemplate {
+  name: string;
+  description: string;
+  code: string;
+}
+
+/** Strip the `export {}` module boundary line that enables type checking */
+function stripModuleLine(raw: string): string {
+  return raw.replace(/^export \{\}[^\n]*\n\n?/, '');
+}
+
+export const SCRIPT_TEMPLATES: ScriptTemplate[] = [
+  {
+    name: 'Data quality audit',
+    description:
+      'BIM Manager — scan all entities for missing names, properties, and quantities; score model completeness; color-code by data quality',
+    code: stripModuleLine(dataQualityAudit),
+  },
+  {
+    name: 'Fire safety compliance',
+    description:
+      'Architect — check fire ratings across walls, doors, and slabs; flag load-bearing elements without ratings; export non-compliant list',
+    code: stripModuleLine(fireSafetyCheck),
+  },
+  {
+    name: 'Quantity takeoff',
+    description:
+      'Cost Estimator — aggregate area, volume, and length quantities across all element types; generate material takeoff table and CSV',
+    code: stripModuleLine(quantityTakeoff),
+  },
+  {
+    name: 'Envelope & thermal check',
+    description:
+      'Energy Consultant — identify external elements, check thermal transmittance values, isolate building envelope, flag missing data',
+    code: stripModuleLine(envelopeCheck),
+  },
+  {
+    name: 'MEP equipment schedule',
+    description:
+      'HVAC Engineer — discover all distribution elements, extract equipment properties, generate schedule, isolate and color by system',
+    code: stripModuleLine(mepEquipmentSchedule),
+  },
+  {
+    name: 'Space & room validation',
+    description:
+      'Facility Manager — validate IfcSpace entities for area, volume, naming; generate room schedule with totals; flag incomplete spaces',
+    code: stripModuleLine(spaceValidation),
+  },
+  {
+    name: 'Federation comparison',
+    description:
+      'Project Manager — compare multiple loaded models side by side: entity counts, type coverage, naming consistency, coordination issues',
+    code: stripModuleLine(federationCompare),
+  },
+  {
+    name: 'Reset view',
+    description: 'Utility — remove all color overrides and show all entities',
+    code: stripModuleLine(resetView),
+  },
+];

package/src/sdk/BimProvider.tsx

@@ -0,0 +1,50 @@
+/* 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/. */
+
+/**
+ * BimProvider — React context for the SDK's BimContext.
+ *
+ * Wraps useBimHost() and makes the `bim` object available to all children
+ * via useBim(). This enables gradual migration: components can progressively
+ * switch from direct Zustand store calls to SDK calls.
+ *
+ * Usage:
+ *   <BimProvider>
+ *     <App />
+ *   </BimProvider>
+ *
+ *   // In any component:
+ *   const bim = useBim();
+ *   const walls = bim.query().byType('IfcWall').toArray();
+ */
+
+import { createContext, useContext, type ReactNode } from 'react';
+import type { BimContext } from '@ifc-lite/sdk';
+import { useBimHost } from './useBimHost.js';
+
+const BimReactContext = createContext<BimContext | null>(null);
+
+/** Provider that initializes the SDK and makes it available via useBim() */
+export function BimProvider({ children }: { children: ReactNode }) {
+  const bim = useBimHost();
+  return (
+    <BimReactContext.Provider value={bim}>
+      {children}
+    </BimReactContext.Provider>
+  );
+}
+
+/**
+ * Access the BimContext from any component.
+ * Must be rendered inside a <BimProvider>.
+ *
+ * @throws if used outside a BimProvider
+ */
+export function useBim(): BimContext {
+  const ctx = useContext(BimReactContext);
+  if (!ctx) {
+    throw new Error('useBim() must be used within a <BimProvider>');
+  }
+  return ctx;
+}