Assistant answers: fire ratings and room areas

/**
 * A FireRating value as minutes, and how it was read. Files write it as '2HR', '2 hr', '2 hours', '120', '120 min', 'REI 120',
 * 'EI60', '1-hour', 'R90' or just a number. A bare number is hours when it is 4 or less (nobody rates a wall 4 minutes), else minutes;
 * the answer says `assumed` so the assistant can say so. null when it does not read as a rating at all.
 */
export function parseFireRating(raw) {
  if (raw === null || raw === undefined || raw === '') return null;
  const s = String(raw).trim().toLowerCase().replace(/[–—]/g, '-');
  if (!s || /^(none|n\/?a|no|0|-)$/.test(s)) return /^0$/.test(s) ? { minutes: 0, how: 'unit-less zero' } : null;
  let m = s.match(/(\d+(?:[.,]\d+)?)\s*[- ]?\s*(hours?|hrs?|h)\b/);
  if (m) return { minutes: Math.round(parseFloat(m[1].replace(',', '.')) * 60), how: 'hours' };
  m = s.match(/(\d+(?:[.,]\d+)?)\s*[- ]?\s*(minutes?|mins?|m)\b/);
  if (m) return { minutes: Math.round(parseFloat(m[1].replace(',', '.'))), how: 'minutes' };
  m = s.match(/\b(?:rei|ei|re|r|e|i)\s*[- ]?(\d{1,3})\b/);   // European classes: R 90, EI 60, REI 120 are minutes
  if (m) return { minutes: parseInt(m[1], 10), how: 'class (minutes)' };
  m = s.match(/^(\d+(?:[.,]\d+)?)$/);
  if (m) { const n = parseFloat(m[1].replace(',', '.')); return n <= 4 ? { minutes: Math.round(n * 60), how: 'bare number read as hours', assumed: true } : { minutes: Math.round(n), how: 'bare number read as minutes', assumed: true }; }
  return null;
}

const want = a.minutes !== undefined ? a.minutes : a.hours !== undefined ? a.hours * 60 : null;
if (want === null) throw bad('Give hours (for example 2) or minutes (for example 120).', ['Call bim_walls_find {hours: 2}.']);
const fields = fireRatingFields(ix);
if (!fields.length) throw new ToolError('not_found', 'No element in this model has a FireRating property.', { next: ['Ask the person where the ratings are kept, then call bim_elements_find {rules: [{field: "p:<Set>.<Property>", op: "is", value: "<rating>"}]}.'] });
const rules = [{ field: 'cls', op: 'is', value: a.class || 'IfcWall' }];
if (a.storey) rules.push({ field: 'storey', op: 'is', value: a.storey });
const walls = find(ix, { rules });
const hit = [], unreadable = [];
let unrated = 0;
for (const k of walls) {
  const id = k - ix.keyBase;
  let raw = null;
  for (const f of fields) { const v = ix.value(f.id, id); if (v !== undefined && v !== '') { raw = v; break; } }
  if (raw === null) { unrated++; continue; }
  const p = parseFireRating(raw);
  if (!p) { unreadable.push({ id: k, name: ix.value('name', id) ?? null, value: String(raw).slice(0, 60) }); continue; }
  if (a.match === 'at_least' ? p.minutes >= want : p.minutes === want) hit.push({ key: k, value: String(raw).slice(0, 60), minutes: p.minutes, assumed: !!p.assumed });

const k = a.unit === 'sqft' ? SQFT : 1;
const lo = a.over !== undefined ? a.over * k : -Infinity, hi = a.under !== undefined ? a.under * k : Infinity;
const rows = roomAreas(ix, m).filter((r) => (!a.storey || r.storey === a.storey));
const noArea = rows.filter((r) => typeof r.area !== 'number');
const hit = rows.filter((r) => typeof r.area === 'number' && r.area < hi && r.area > lo).sort((x, y) => x.area - y.area);
const pg = page(hit, a), shown = show(a, hit.map((r) => r.key));
const notes = [];
if (noArea.length) notes.push(noArea.length + ' room(s) have no area and are not in the answer.');
if (hit.some((r) => r.areaFrom === 'shape')) notes.push('Some areas are measured from the room shape, not stated in the file.');
return {
  model: app.name(), rooms: rows.length, total: hit.length, returned: pg.returned, next: pg.next, selected: shown, noArea: noArea.length, notes,
  limits: { under_m2: hi === Infinity ? null : r2(hi), over_m2: lo === -Infinity ? null : r2(lo), unit: a.unit || 'm2' },
  rooms_found: pg.rows.map((r) => ({ id: r.key, number: r.number, name: r.name, storey: r.storey, area_m2: r2(r.area), area_sqft: r2(r.area / SQFT), areaFrom: r.areaFrom })),