@ifc-lite/sdk 1.14.2 → 1.14.3

package/dist/namespaces/bcf.js

@@ -1,42 +1,215 @@
 /* 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/. */
-// Dynamic import helper
+// ============================================================================
+// Dynamic import
+// ============================================================================
 async function loadBCF() {
     const name = '@ifc-lite/bcf';
     return import(/* webpackIgnore: true */ name);
 }
-/** bim.bcf — BCF (BIM Collaboration Format) */
+// ============================================================================
+// BCFNamespace
+// ============================================================================
+/** bim.bcf — BIM Collaboration Format (topics, viewpoints, comments, I/O) */
 export class BCFNamespace {
+    // --------------------------------------------------------------------------
+    // Project management
+    // --------------------------------------------------------------------------
     /** Create a new BCF project. */
-    async createProject(name) {
+    async createProject(options) {
         const mod = await loadBCF();
-        return mod.createBCFProject({ name });
+        return mod.createBCFProject(options);
     }
-    /** Create a topic. */
+    // --------------------------------------------------------------------------
+    // Topic (issue) management
+    // --------------------------------------------------------------------------
+    /** Create a new topic (issue). */
     async createTopic(options) {
         const mod = await loadBCF();
-        return mod.createBCFTopic(options);
+        return mod.createBCFTopic({
+            title: options.title,
+            description: options.description,
+            author: options.author,
+            topicType: options.topicType,
+            topicStatus: options.status,
+            priority: options.priority,
+            assignedTo: options.assignedTo,
+            dueDate: options.dueDate,
+            labels: options.labels,
+        });
     }
-    /** Create a comment. */
+    /** Add a topic to a project. */
+    async addTopic(project, topic) {
+        const mod = await loadBCF();
+        mod.addTopicToProject(project, topic);
+    }
+    /** Update the status of a topic. */
+    async updateTopicStatus(topic, status, modifiedAuthor) {
+        const mod = await loadBCF();
+        mod.updateTopicStatus(topic, status, modifiedAuthor);
+    }
+    // --------------------------------------------------------------------------
+    // Comments
+    // --------------------------------------------------------------------------
+    /** Create a new comment. */
     async createComment(options) {
         const mod = await loadBCF();
         return mod.createBCFComment(options);
     }
-    /** Read a BCF file. */
+    /** Add a comment to a topic. */
+    async addComment(topic, comment) {
+        const mod = await loadBCF();
+        mod.addCommentToTopic(topic, comment);
+    }
+    // --------------------------------------------------------------------------
+    // Viewpoints
+    // --------------------------------------------------------------------------
+    /** Create a BCF viewpoint from viewer camera/section state. */
+    async createViewpoint(options) {
+        const mod = await loadBCF();
+        if (!options)
+            return mod.createViewpoint({});
+        // Map SDK's GlobalId (IFC convention) to BCF library's guid-based lists
+        const comps = options.components;
+        const bcfOptions = {};
+        if (options.camera)
+            bcfOptions.camera = options.camera;
+        if (options.sectionPlane)
+            bcfOptions.sectionPlane = options.sectionPlane;
+        if (comps?.selection) {
+            bcfOptions.selectedGuids = comps.selection.map(c => c.GlobalId);
+        }
+        if (comps?.visibility) {
+            if (comps.visibility.defaultVisibility) {
+                // Default visible → exceptions are hidden
+                bcfOptions.hiddenGuids = comps.visibility.exceptions?.map(c => c.GlobalId);
+            }
+            else {
+                // Default hidden → exceptions are visible (isolation mode)
+                bcfOptions.visibleGuids = comps.visibility.exceptions?.map(c => c.GlobalId);
+            }
+        }
+        if (comps?.coloring) {
+            bcfOptions.coloredGuids = comps.coloring.map(g => ({
+                color: g.color,
+                guids: g.components.map(c => c.GlobalId),
+            }));
+        }
+        return mod.createViewpoint(bcfOptions);
+    }
+    /** Add a viewpoint to a topic. */
+    async addViewpoint(topic, viewpoint) {
+        const mod = await loadBCF();
+        mod.addViewpointToTopic(topic, viewpoint);
+    }
+    /** Extract viewer state from a BCF viewpoint. */
+    async extractViewpointState(viewpoint) {
+        const mod = await loadBCF();
+        return mod.extractViewpointState(viewpoint);
+    }
+    // --------------------------------------------------------------------------
+    // Camera conversion helpers
+    // --------------------------------------------------------------------------
+    /** Convert viewer camera state to BCF perspective camera. */
+    async cameraToPerspective(camera) {
+        const mod = await loadBCF();
+        return mod.cameraToPerspective(camera);
+    }
+    /** Convert viewer camera state to BCF orthogonal camera. */
+    async cameraToOrthogonal(camera) {
+        const mod = await loadBCF();
+        return mod.cameraToOrthogonal(camera);
+    }
+    /** Convert BCF perspective camera to viewer camera state. */
+    async perspectiveToCamera(perspective) {
+        const mod = await loadBCF();
+        return mod.perspectiveToCamera(perspective);
+    }
+    /** Convert BCF orthogonal camera to viewer camera state. */
+    async orthogonalToCamera(orthogonal) {
+        const mod = await loadBCF();
+        return mod.orthogonalToCamera(orthogonal);
+    }
+    // --------------------------------------------------------------------------
+    // Section plane conversion
+    // --------------------------------------------------------------------------
+    /** Convert viewer section plane to BCF clipping plane. */
+    async sectionPlaneToClippingPlane(section) {
+        const mod = await loadBCF();
+        return mod.sectionPlaneToClippingPlane(section);
+    }
+    /** Convert BCF clipping plane to viewer section plane. */
+    async clippingPlaneToSectionPlane(clippingPlane) {
+        const mod = await loadBCF();
+        return mod.clippingPlaneToSectionPlane(clippingPlane);
+    }
+    // --------------------------------------------------------------------------
+    // I/O — Read / Write BCF files
+    // --------------------------------------------------------------------------
+    /** Read a BCF file (ZIP archive) into a BCF project structure. */
     async read(data) {
         const mod = await loadBCF();
         return mod.readBCF(data);
     }
-    /** Write a BCF project to a downloadable Blob. */
+    /** Write a BCF project to a downloadable Blob (ZIP archive). */
     async write(project) {
         const mod = await loadBCF();
         return mod.writeBCF(project);
     }
-    /** Generate a new IFC GUID. */
-    async generateGuid() {
+    // --------------------------------------------------------------------------
+    // IDS → BCF conversion
+    // --------------------------------------------------------------------------
+    /** Convert an IDS validation report into BCF issues (one topic per failed spec). */
+    async createFromIDSReport(report, options) {
+        const mod = await loadBCF();
+        return mod.createBCFFromIDSReport(report, options);
+    }
+    // --------------------------------------------------------------------------
+    // GUID utilities
+    // --------------------------------------------------------------------------
+    /** Generate a new IFC GUID (22-char base64). */
+    async generateIfcGuid() {
         const mod = await loadBCF();
         return mod.generateIfcGuid();
     }
+    /** Generate a new UUID (36-char). */
+    async generateUuid() {
+        const mod = await loadBCF();
+        return mod.generateUuid();
+    }
+    /** Convert UUID to IFC GUID. */
+    async uuidToIfcGuid(uuid) {
+        const mod = await loadBCF();
+        return mod.uuidToIfcGuid(uuid);
+    }
+    /** Convert IFC GUID to UUID. */
+    async ifcGuidToUuid(guid) {
+        const mod = await loadBCF();
+        return mod.ifcGuidToUuid(guid);
+    }
+    /** Validate whether a string is a valid IFC GUID. */
+    async isValidIfcGuid(guid) {
+        const mod = await loadBCF();
+        return mod.isValidIfcGuid(guid);
+    }
+    /** Validate whether a string is a valid UUID. */
+    async isValidUuid(uuid) {
+        const mod = await loadBCF();
+        return mod.isValidUuid(uuid);
+    }
+    // --------------------------------------------------------------------------
+    // Color utilities
+    // --------------------------------------------------------------------------
+    /** Parse ARGB hex color string (BCF format) to RGBA values. */
+    async parseARGBColor(argb) {
+        const mod = await loadBCF();
+        return mod.parseARGBColor(argb);
+    }
+    /** Create ARGB hex color string (BCF format) from RGBA values. */
+    async toARGBColor(r, g, b, a) {
+        const mod = await loadBCF();
+        return mod.toARGBColor(r, g, b, a);
+    }
 }
 //# sourceMappingURL=bcf.js.map

package/dist/namespaces/bcf.js.map

@@ -1 +1 @@
-{"version":3,"file":"bcf.js","sourceRoot":"","sources":["../../src/namespaces/bcf.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAyB/D,wBAAwB;AACxB,KAAK,UAAU,OAAO;IACpB,MAAM,IAAI,GAAG,eAAe,CAAC;IAC7B,OAAO,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAqC,CAAC;AACpF,CAAC;AAID,+CAA+C;AAC/C,MAAM,OAAO,YAAY;IACvB,gCAAgC;IAChC,KAAK,CAAC,aAAa,CAAC,IAAa;QAC/B,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAQ,GAAG,CAAC,gBAA0B,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,WAAW,CAAC,OAAqB;QACrC,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAQ,GAAG,CAAC,cAAwB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,aAAa,CAAC,OAAuB;QACzC,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAQ,GAAG,CAAC,gBAA0B,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,IAAI,CAAC,IAAwB;QACjC,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAQ,GAAG,CAAC,OAAiB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC1B,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAQ,GAAG,CAAC,QAAkB,CAAC,OAAO,CAAkB,CAAC;IAC3D,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,YAAY;QAChB,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAQ,GAAG,CAAC,eAAgC,EAAE,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"bcf.js","sourceRoot":"","sources":["../../src/namespaces/bcf.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/bsdd.d.ts

@@ -0,0 +1,140 @@
+/**
+ * bim.bsdd — buildingSMART Data Dictionary (bSDD) integration
+ *
+ * Provides access to the bSDD REST API for discovering schema-defined
+ * property sets, properties, and classifications for IFC entity types.
+ *
+ * The bSDD is the canonical source for IFC property definitions,
+ * quantity sets, and related dictionaries (Uniclass, OmniClass, etc.).
+ *
+ * @see https://app.swaggerhub.com/apis/buildingSMART/Dictionaries/v1
+ */
+/** A property definition from the bSDD for a given IFC class */
+export interface BsddClassProperty {
+    /** Property name, e.g. "IsExternal" */
+    name: string;
+    /** URI of the property definition */
+    uri: string;
+    /** Human-readable description */
+    description: string | null;
+    /** bSDD data type, e.g. "Boolean", "Real", "String" */
+    dataType: string | null;
+    /** Name of the property set this property belongs to (null = entity attribute) */
+    propertySet: string | null;
+    /** Allowed values (enum constraints) */
+    allowedValues: Array<{
+        uri?: string;
+        value: string;
+        description?: string;
+    }> | null;
+    /** Units (e.g. ["m"], ["m²"]) */
+    units: string[] | null;
+    /** Whether this property is from the IFC standard dictionary */
+    isIfcStandard: boolean;
+}
+/** Full class information from the bSDD */
+export interface BsddClassInfo {
+    /** Class URI */
+    uri: string;
+    /** IFC entity code, e.g. "IfcWall" */
+    code: string;
+    /** Human-readable name */
+    name: string;
+    /** Class description / definition */
+    definition: string | null;
+    /** Parent class URI */
+    parentClassUri: string | null;
+    /** Properties defined for this class */
+    classProperties: BsddClassProperty[];
+    /** Related IFC entity names */
+    relatedIfcEntityNames: string[] | null;
+}
+/** Lightweight search result from bSDD */
+export interface BsddSearchResult {
+    uri: string;
+    code: string;
+    name: string;
+    definition: string | null;
+    dictionaryUri: string;
+}
+export interface BsddOptions {
+    /**
+     * Base URL for the bSDD API.
+     * Default: 'https://api.bsdd.buildingsmart.org'
+     *
+     * Override this if you use a proxy (e.g. '/api/bsdd' for same-origin proxy).
+     */
+    apiBase?: string;
+    /** Cache TTL in milliseconds. Default: 600000 (10 minutes) */
+    cacheTtlMs?: number;
+}
+/**
+ * bim.bsdd — buildingSMART Data Dictionary lookup
+ *
+ * Discover schema-defined properties, quantities, and classifications
+ * for any IFC entity type from the bSDD REST API.
+ *
+ * ```ts
+ * const info = await bim.bsdd.fetchClassInfo('IfcWall');
+ * for (const prop of info.classProperties) {
+ *   console.log(prop.propertySet, prop.name, prop.dataType);
+ * }
+ * ```
+ */
+export declare class BsddNamespace {
+    private apiBase;
+    private cache;
+    private cacheTtl;
+    constructor(options?: BsddOptions);
+    /** Build the bSDD class URI for an IFC entity type. */
+    ifcClassUri(ifcType: string): string;
+    /** Build the bSDD search URL for an IFC entity type (for browser links). */
+    ifcClassUrl(ifcType: string): string;
+    /**
+     * Fetch full class info (including properties) for an IFC entity type.
+     *
+     * Results are cached for 10 minutes (configurable).
+     * Returns null if the bSDD has no data for this type.
+     */
+    fetchClassInfo(ifcType: string): Promise<BsddClassInfo | null>;
+    /**
+     * Fetch class info by full bSDD URI (not just IFC type name).
+     * Useful for non-IFC dictionaries (Uniclass, OmniClass, etc.).
+     */
+    fetchClassByUri(classUri: string): Promise<BsddClassInfo | null>;
+    /**
+     * Search bSDD for classes related to an IFC entity type across all dictionaries.
+     *
+     * Returns lightweight results. Use `fetchClassByUri()` on a specific result
+     * to get full property details.
+     */
+    searchRelatedClasses(ifcType: string): Promise<BsddSearchResult[]>;
+    /**
+     * Free-text search across all bSDD dictionaries.
+     */
+    search(query: string): Promise<BsddSearchResult[]>;
+    /**
+     * Get only the property sets (Pset_*) for an IFC type.
+     * Groups properties by their propertySet name.
+     */
+    getPropertySets(ifcType: string): Promise<Map<string, BsddClassProperty[]>>;
+    /**
+     * Get only the quantity sets (Qto_*) for an IFC type.
+     * Groups quantities by their propertySet name.
+     */
+    getQuantitySets(ifcType: string): Promise<Map<string, BsddClassProperty[]>>;
+    /**
+     * Get entity-level attributes (properties with no propertySet).
+     */
+    getEntityAttributes(ifcType: string): Promise<BsddClassProperty[]>;
+    /** Map bSDD dataType string to a human-friendly label. */
+    dataTypeLabel(dt: string | null): string;
+    /** Clear the bSDD cache. */
+    clearCache(): void;
+    /** Get cache statistics. */
+    cacheStats(): {
+        entries: number;
+        oldestMs: number;
+    };
+}
+//# sourceMappingURL=bsdd.d.ts.map

package/dist/namespaces/bsdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsdd.d.ts","sourceRoot":"","sources":["../../src/namespaces/bsdd.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/bsdd.js

@@ -0,0 +1,278 @@
+/* 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/. */
+// ============================================================================
+// Internal cache & helpers
+// ============================================================================
+const IFC_DICTIONARY_URI = 'https://identifier.buildingsmart.org/uri/buildingsmart/ifc/4.3';
+// Cache helpers — operate on instance-scoped cache passed as argument
+function getCached(cache, key, ttl) {
+    const entry = cache.get(key);
+    if (entry && Date.now() - entry.ts < ttl)
+        return entry.data;
+    if (entry)
+        cache.delete(key);
+    return null;
+}
+function setCache(cache, key, data) {
+    cache.set(key, { data, ts: Date.now() });
+}
+async function fetchJson(url) {
+    const res = await fetch(url, {
+        headers: { Accept: 'application/json' },
+    });
+    if (!res.ok)
+        throw new Error(`bSDD API ${res.status}: ${res.statusText}`);
+    return res.json();
+}
+function mapProperty(p, isIfcStandard) {
+    return {
+        name: String(p.name ?? p.propertyCode ?? ''),
+        uri: String(p.propertyUri ?? p.uri ?? ''),
+        description: p.description ? String(p.description) : null,
+        dataType: p.dataType ? String(p.dataType) : null,
+        propertySet: p.propertySet ? String(p.propertySet) : null,
+        allowedValues: Array.isArray(p.allowedValues)
+            ? p.allowedValues.map((v) => ({
+                uri: v.uri ? String(v.uri) : undefined,
+                value: String(v.value ?? ''),
+                description: v.description ? String(v.description) : undefined,
+            }))
+            : null,
+        units: Array.isArray(p.units) ? p.units : null,
+        isIfcStandard,
+    };
+}
+function mapClassResponse(raw, isIfcStandard) {
+    const props = raw.classProperties;
+    return {
+        uri: String(raw.uri ?? ''),
+        code: String(raw.code ?? raw.name ?? ''),
+        name: String(raw.name ?? ''),
+        definition: raw.definition ? String(raw.definition) : null,
+        parentClassUri: raw.parentClassReference
+            ? String(raw.parentClassReference.uri ?? '')
+            : null,
+        relatedIfcEntityNames: raw.relatedIfcEntityNames,
+        classProperties: (props ?? []).map((p) => mapProperty(p, isIfcStandard)),
+    };
+}
+// ============================================================================
+// BsddNamespace
+// ============================================================================
+/**
+ * bim.bsdd — buildingSMART Data Dictionary lookup
+ *
+ * Discover schema-defined properties, quantities, and classifications
+ * for any IFC entity type from the bSDD REST API.
+ *
+ * ```ts
+ * const info = await bim.bsdd.fetchClassInfo('IfcWall');
+ * for (const prop of info.classProperties) {
+ *   console.log(prop.propertySet, prop.name, prop.dataType);
+ * }
+ * ```
+ */
+export class BsddNamespace {
+    apiBase;
+    cache = new Map();
+    cacheTtl;
+    constructor(options) {
+        this.apiBase = options?.apiBase ?? 'https://api.bsdd.buildingsmart.org';
+        this.cacheTtl = options?.cacheTtlMs ?? 10 * 60 * 1000;
+    }
+    // --------------------------------------------------------------------------
+    // URI helpers
+    // --------------------------------------------------------------------------
+    /** Build the bSDD class URI for an IFC entity type. */
+    ifcClassUri(ifcType) {
+        return `${IFC_DICTIONARY_URI}/class/${ifcType}`;
+    }
+    /** Build the bSDD search URL for an IFC entity type (for browser links). */
+    ifcClassUrl(ifcType) {
+        return `https://search.bsdd.buildingsmart.org/uri/buildingsmart/ifc/4.3/class/${ifcType}`;
+    }
+    // --------------------------------------------------------------------------
+    // Class info
+    // --------------------------------------------------------------------------
+    /**
+     * Fetch full class info (including properties) for an IFC entity type.
+     *
+     * Results are cached for 10 minutes (configurable).
+     * Returns null if the bSDD has no data for this type.
+     */
+    async fetchClassInfo(ifcType) {
+        const uri = this.ifcClassUri(ifcType);
+        const cached = getCached(this.cache, uri, this.cacheTtl);
+        if (cached)
+            return cached;
+        try {
+            const raw = await fetchJson(`${this.apiBase}/api/Class/v1?Uri=${encodeURIComponent(uri)}&IncludeClassProperties=true&IncludeClassRelations=true`);
+            let info = mapClassResponse(raw, true);
+            // Fallback: if inline classProperties came back empty, try paginated endpoint
+            if (info.classProperties.length === 0) {
+                const propsRaw = await fetchJson(`${this.apiBase}/api/Class/Properties/v1?ClassUri=${encodeURIComponent(uri)}`).catch(() => null);
+                if (propsRaw) {
+                    const propsList = propsRaw.classProperties;
+                    if (propsList && propsList.length > 0) {
+                        info = { ...info, classProperties: propsList.map((p) => mapProperty(p, true)) };
+                    }
+                }
+            }
+            setCache(this.cache, uri, info);
+            return info;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Fetch class info by full bSDD URI (not just IFC type name).
+     * Useful for non-IFC dictionaries (Uniclass, OmniClass, etc.).
+     */
+    async fetchClassByUri(classUri) {
+        const cached = getCached(this.cache, classUri, this.cacheTtl);
+        if (cached)
+            return cached;
+        try {
+            const raw = await fetchJson(`${this.apiBase}/api/Class/v1?Uri=${encodeURIComponent(classUri)}&IncludeClassProperties=true`);
+            const info = mapClassResponse(raw, false);
+            setCache(this.cache, classUri, info);
+            return info;
+        }
+        catch {
+            return null;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Search
+    // --------------------------------------------------------------------------
+    /**
+     * Search bSDD for classes related to an IFC entity type across all dictionaries.
+     *
+     * Returns lightweight results. Use `fetchClassByUri()` on a specific result
+     * to get full property details.
+     */
+    async searchRelatedClasses(ifcType) {
+        try {
+            const raw = await fetchJson(`${this.apiBase}/api/Class/Search/v1?SearchText=${encodeURIComponent(ifcType)}&RelatedIfcEntities=${encodeURIComponent(ifcType)}`);
+            return (raw.classes ?? []).map((c) => ({
+                uri: String(c.uri ?? ''),
+                code: String(c.code ?? c.name ?? ''),
+                name: String(c.name ?? ''),
+                definition: c.definition ? String(c.definition) : null,
+                dictionaryUri: String(c.dictionaryUri ?? ''),
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Free-text search across all bSDD dictionaries.
+     */
+    async search(query) {
+        try {
+            const raw = await fetchJson(`${this.apiBase}/api/Class/Search/v1?SearchText=${encodeURIComponent(query)}`);
+            return (raw.classes ?? []).map((c) => ({
+                uri: String(c.uri ?? ''),
+                code: String(c.code ?? c.name ?? ''),
+                name: String(c.name ?? ''),
+                definition: c.definition ? String(c.definition) : null,
+                dictionaryUri: String(c.dictionaryUri ?? ''),
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Property helpers
+    // --------------------------------------------------------------------------
+    /**
+     * Get only the property sets (Pset_*) for an IFC type.
+     * Groups properties by their propertySet name.
+     */
+    async getPropertySets(ifcType) {
+        const info = await this.fetchClassInfo(ifcType);
+        if (!info)
+            return new Map();
+        const result = new Map();
+        for (const prop of info.classProperties) {
+            const pset = prop.propertySet;
+            if (!pset || pset.startsWith('Qto_'))
+                continue;
+            const list = result.get(pset);
+            if (list)
+                list.push(prop);
+            else
+                result.set(pset, [prop]);
+        }
+        return result;
+    }
+    /**
+     * Get only the quantity sets (Qto_*) for an IFC type.
+     * Groups quantities by their propertySet name.
+     */
+    async getQuantitySets(ifcType) {
+        const info = await this.fetchClassInfo(ifcType);
+        if (!info)
+            return new Map();
+        const result = new Map();
+        for (const prop of info.classProperties) {
+            const pset = prop.propertySet;
+            if (!pset || !pset.startsWith('Qto_'))
+                continue;
+            const list = result.get(pset);
+            if (list)
+                list.push(prop);
+            else
+                result.set(pset, [prop]);
+        }
+        return result;
+    }
+    /**
+     * Get entity-level attributes (properties with no propertySet).
+     */
+    async getEntityAttributes(ifcType) {
+        const info = await this.fetchClassInfo(ifcType);
+        if (!info)
+            return [];
+        return info.classProperties.filter((p) => p.propertySet === null);
+    }
+    // --------------------------------------------------------------------------
+    // Data type helpers
+    // --------------------------------------------------------------------------
+    /** Map bSDD dataType string to a human-friendly label. */
+    dataTypeLabel(dt) {
+        if (!dt)
+            return 'String';
+        const lower = dt.toLowerCase();
+        if (lower === 'boolean')
+            return 'Boolean';
+        if (lower === 'real' || lower === 'number')
+            return 'Real';
+        if (lower === 'integer')
+            return 'Integer';
+        if (lower === 'string' || lower === 'character')
+            return 'String';
+        return dt;
+    }
+    // --------------------------------------------------------------------------
+    // Cache management
+    // --------------------------------------------------------------------------
+    /** Clear the bSDD cache. */
+    clearCache() {
+        this.cache.clear();
+    }
+    /** Get cache statistics. */
+    cacheStats() {
+        let oldest = Date.now();
+        for (const entry of this.cache.values()) {
+            if (entry.ts < oldest)
+                oldest = entry.ts;
+        }
+        return { entries: this.cache.size, oldestMs: this.cache.size > 0 ? Date.now() - oldest : 0 };
+    }
+}
+//# sourceMappingURL=bsdd.js.map