ifcopenshell 0.0.0-stage → 0.9.0

package/dist/init.js

@@ -0,0 +1,137 @@
+import { EntityInstance } from './entity_instance.js';
+import { IfcOpenShellError, IfcOpenShellErrorCode, IfcOpenShellErrorKind, abortError, isIfcOpenShellAbortError, } from '@ifcopenshell/wasm/api';
+export { IfcOpenShellError, IfcOpenShellErrorCode, IfcOpenShellErrorKind, abortError, isIfcOpenShellAbortError, };
+/**
+ * Initialize the packaged or explicitly configured WASM runtime.
+ *
+ * Plugins are loaded lazily through {@link IfcOpenShell.loadPlugin}.
+ * File and Iterator support explicit disposal; other handles use GC cleanup.
+ *
+ * @param options Asset locations and optional plugin-loader overrides.
+ * @returns An initialized, frozen runtime facade.
+ */
+export function init(options = {}) {
+    if (initialization) {
+        if (Object.keys(options).length) {
+            return Promise.reject(new IfcOpenShellError('Runtime is already initializing or initialized; configure it only on the first init() call'));
+        }
+        return initialization;
+    }
+    initialization = initialize(options).then(value => {
+        ifcopenshell = value.raw;
+        fs = value.fs;
+        return value;
+    }).catch(error => {
+        initialization = undefined;
+        throw error;
+    });
+    return initialization;
+}
+/** Native module, available after awaiting init(). */
+export let ifcopenshell;
+/** Retrieve the loaded schema declaration by its full identifier. */
+export function schemaByName(name) {
+    return ifcopenshell.parse.schemaByName(name);
+}
+/** Emscripten filesystem, available after awaiting init(). */
+export let fs;
+let initialization;
+async function initialize(options) {
+    let assets;
+    if (options.wasmAssets) {
+        assets = options.wasmAssets;
+    }
+    else {
+        try {
+            assets = await resolveRuntime();
+        }
+        catch (error) {
+            throw new IfcOpenShellError('Failed to resolve packaged WASM assets', error);
+        }
+    }
+    const loader = options.pluginLoader ?? assets.pluginLoader;
+    validateAssets(assets);
+    let fs = null;
+    const initModule = (opts) => Promise.resolve(assets.initModule(opts)).then((mod) => {
+        fs = readFs(mod);
+        return mod;
+    });
+    const createModule = await resolveApiFactory(assets);
+    let raw;
+    try {
+        raw = await createModule(initModule, assets.wasmUrl, {
+            pluginBaseUrl: assets.pluginBaseUrl,
+            pluginManifest: assets.manifest,
+            pluginLoader: loader,
+        });
+    }
+    catch (error) {
+        throw new IfcOpenShellError('Failed to instantiate IfcOpenShell WASM', error);
+    }
+    const runtime = {
+        raw,
+        fs,
+        loadPlugin: (kind, id) => loadPlugin(raw, kind, id),
+        loadedPlugins: () => raw.loadedPlugins(),
+    };
+    raw.setInstanceFactory((handle) => new EntityInstance(handle));
+    return Object.freeze(runtime);
+}
+async function resolveRuntime() {
+    const wasm = await import('@ifcopenshell/wasm');
+    return await wasm.resolveWasmAssets();
+}
+async function resolveApiFactory(assets) {
+    if (typeof assets.createIfcOpenshellModule === 'function')
+        return assets.createIfcOpenshellModule;
+    const specifier = assets.apiModuleUrl;
+    try {
+        const mod = await import(/* @vite-ignore */ /* webpackIgnore: true */ specifier);
+        if (typeof mod.createIfcOpenshellModule !== 'function') {
+            throw new IfcOpenShellError(`${specifier} does not export createIfcOpenshellModule`);
+        }
+        return mod.createIfcOpenshellModule;
+    }
+    catch (error) {
+        throw new IfcOpenShellError(`Failed to load IfcOpenShell API module from ${specifier}`, error);
+    }
+}
+function validateAssets(assets) {
+    if (typeof assets?.initModule !== 'function') {
+        throw new IfcOpenShellError('wasmAssets.initModule must be the ifcopenshell_wasm.mjs module factory');
+    }
+    if (typeof assets.wasmUrl !== 'string' || assets.wasmUrl.length === 0) {
+        throw new IfcOpenShellError('wasmAssets.wasmUrl must point to ifcopenshell_wasm.wasm');
+    }
+    if (typeof assets.pluginBaseUrl !== 'string' || assets.pluginBaseUrl.length === 0) {
+        throw new IfcOpenShellError('wasmAssets.pluginBaseUrl must point to the plugin directory');
+    }
+    if (!assets.manifest || typeof assets.manifest !== 'object') {
+        throw new IfcOpenShellError('wasmAssets.manifest must be a plugin manifest object');
+    }
+    if (typeof assets.createIfcOpenshellModule !== 'function' &&
+        (typeof assets.apiModuleUrl !== 'string' || assets.apiModuleUrl.length === 0)) {
+        throw new IfcOpenShellError('wasmAssets must provide createIfcOpenshellModule or apiModuleUrl');
+    }
+}
+function readFs(mod) {
+    const fs = mod?.FS;
+    if (fs &&
+        typeof fs === 'object' &&
+        typeof fs.writeFile === 'function' &&
+        typeof fs.readFile === 'function') {
+        return fs;
+    }
+    return null;
+}
+async function loadPlugin(raw, kind, id) {
+    try {
+        await raw.loadPlugin(kind, id);
+    }
+    catch (error) {
+        const key = `${kind}:${id}`;
+        const suffix = error instanceof Error && error.message ? `: ${error.message}` : '';
+        throw new IfcOpenShellError(`Failed to load plugin ${key}${suffix}`, error);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/serializers/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Serializer APIs for exporting IFC geometry and data.
+ *
+ * @module Serializers
+ */
+import type { File } from '../file.js';
+/** Serializer progress in native processing order. */
+export interface OperationProgress {
+    phase: string;
+    message: string;
+    ratio?: number;
+    current?: number;
+}
+import type { Settings } from '../geom/settings.js';
+/** Formats supported by {@link exportToBuffer}. */
+export type SerializerFormat = 'obj' | 'svg' | 'ttl';
+/** Text buffers returned by a serializer; OBJ uses `secondary` for MTL data. */
+export interface ExportResult {
+    /** Primary serialized content. */
+    primary: string;
+    /** Secondary content, used for the OBJ material file. */
+    secondary: string;
+}
+/** Geometry loading, serializer, cancellation, and progress options. */
+export interface ExportOptions {
+    /** Previously loaded geometry kernel. Defaults to `passthrough`. */
+    kernel?: string;
+    /** Number of native geometry iterator threads. */
+    numThreads?: number;
+    /**
+     * Abort the export between geometry elements. Checked between synchronous
+     * native calls; it cannot interrupt one native call already in progress.
+     */
+    signal?: AbortSignal;
+    /** Receive write and completion progress events. */
+    onProgress?(progress: OperationProgress): void;
+}
+/**
+ * Serialize the file into in-memory text buffers. Load kernel, mapping and serializer plugins first.
+ *
+ * OBJ returns its material data in `secondary`; SVG and TTL return an empty
+ * secondary buffer. The function returns `null` when the native iterator
+ * cannot initialize and throws when a serializer or geometry element fails.
+ */
+export declare function exportToBuffer(file: File, geomSettings: Settings, format: SerializerFormat, options?: ExportOptions): Promise<ExportResult | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/serializers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializers/index.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErD,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAChD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,QAAQ,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyE9B"}

package/dist/serializers/index.js

@@ -0,0 +1,161 @@
+/**
+ * Serializer APIs for exporting IFC geometry and data.
+ *
+ * @module Serializers
+ */
+import { IfcOpenShellError, abortError, ifcopenshell, fs } from '../init.js';
+/**
+ * Serialize the file into in-memory text buffers. Load kernel, mapping and serializer plugins first.
+ *
+ * OBJ returns its material data in `secondary`; SVG and TTL return an empty
+ * secondary buffer. The function returns `null` when the native iterator
+ * cannot initialize and throws when a serializer or geometry element fails.
+ */
+export async function exportToBuffer(file, geomSettings, format, options = {}) {
+    if (format !== 'obj' && format !== 'svg' && format !== 'ttl') {
+        throw new IfcOpenShellError(`Unsupported serializer format: ${format}`);
+    }
+    throwIfAborted(options.signal);
+    const kernel = options.kernel ?? 'passthrough';
+    let obj = null;
+    let mtl = null;
+    let serializer = null;
+    let iterator = null;
+    let outputPath = null;
+    try {
+        if (format === 'obj') {
+            obj = ifcopenshell.geom.createBuffer();
+            mtl = ifcopenshell.geom.createBuffer();
+            serializer = ifcopenshell.geom.createGeometrySerializerByStream('obj', mtl, obj, geomSettings);
+        }
+        else {
+            outputPath = uniquePath(format);
+            serializer = ifcopenshell.geom.createGeometrySerializerByPath(format, outputPath, outputPath, geomSettings);
+        }
+        if (!serializer || serializer.ptr === 0)
+            throw new IfcOpenShellError(`Failed to create ${format} serializer`);
+        serializer.setFile(file);
+        serializer.writeHeader();
+        iterator = ifcopenshell.geom.createIterator(kernel, geomSettings, file, options.numThreads ?? 1);
+        if (!iterator || iterator.ptr === 0)
+            throw new IfcOpenShellError('Failed to create geometry iterator');
+        if (!iterator.initialize())
+            return null;
+        const preferTriangulation = serializer.isTesselated();
+        let written = 0;
+        do {
+            throwIfAborted(options.signal);
+            writeElement(iterator, serializer, preferTriangulation);
+            written++;
+            if (written % 16 === 0) {
+                options.onProgress?.({
+                    phase: 'write',
+                    message: `Exporting ${format}`,
+                    current: written,
+                    ratio: progressRatio(iterator.progress()),
+                });
+                await tick();
+            }
+        } while (iterator.next());
+        serializer.finalize();
+        if (format === 'obj') {
+            return {
+                primary: obj?.isReady() ? obj.getValue() : '',
+                secondary: mtl?.isReady() ? mtl.getValue() : '',
+            };
+        }
+        if (!fs)
+            throw new IfcOpenShellError(`Cannot read ${format} output without Emscripten FS`);
+        const bytes = fs.readFile(outputPath, { encoding: 'utf8' });
+        return { primary: typeof bytes === 'string' ? bytes : new TextDecoder().decode(bytes), secondary: '' };
+    }
+    finally {
+        release(iterator);
+        release(serializer);
+        release(obj);
+        release(mtl);
+        if (outputPath && fs) {
+            try {
+                fs.unlink(outputPath);
+            }
+            catch {
+                // ignore cleanup failure
+            }
+        }
+    }
+}
+function writeElement(iterator, serializer, preferTriangulation) {
+    const failures = [];
+    const tri = () => {
+        let item = null;
+        try {
+            item = iterator.getAsTriangulationElement();
+            if (!item || item.ptr === 0) {
+                failures.push(new IfcOpenShellError('Geometry iterator did not provide a triangulation element'));
+                return false;
+            }
+            serializer.writeTriangulationElement(item);
+            return true;
+        }
+        catch (error) {
+            failures.push(error);
+            return false;
+        }
+        finally {
+            release(item);
+        }
+    };
+    const brep = () => {
+        let item = null;
+        try {
+            item = iterator.getAsBrepElement();
+            if (!item || item.ptr === 0) {
+                failures.push(new IfcOpenShellError('Geometry iterator did not provide a BRep element'));
+                return false;
+            }
+            serializer.writeBrepElement(item);
+            return true;
+        }
+        catch (error) {
+            failures.push(error);
+            return false;
+        }
+        finally {
+            release(item);
+        }
+    };
+    const written = preferTriangulation ? tri() || brep() : brep() || tri();
+    if (!written) {
+        const cause = failures.length === 1
+            ? failures[0]
+            : new AggregateError(failures, 'Neither geometry representation could be serialized');
+        throw new IfcOpenShellError('Failed to serialize a geometry element as triangulation or BRep', cause);
+    }
+}
+function uniquePath(format) {
+    const stamp = `${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+    return `/ifcopenshell-js-${format}-${stamp}.${format}`;
+}
+function progressRatio(progress) {
+    if (!Number.isFinite(progress))
+        return 0;
+    if (progress > 1)
+        return Math.max(0, Math.min(1, progress / 100));
+    return Math.max(0, Math.min(1, progress));
+}
+function tick() {
+    return new Promise((resolve) => setTimeout(resolve, 0));
+}
+function release(handle) {
+    try {
+        handle?.destroy();
+    }
+    catch {
+        // ignore double destroy
+    }
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw abortError('IfcOpenShell operation was cancelled', signal.reason);
+}
+//# sourceMappingURL=index.js.map

package/dist/serializers/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+import type { IfcOpenshellModule } from '@ifcopenshell/wasm/api';
+export type { IfcOpenshellModule };
+/** Raw pointer address in WASM linear memory. */
+export type Ptr = number;
+/**
+ * Subset of the Emscripten MEMFS filesystem API exposed by the underlying
+ * WASM runtime. Used by higher-level wrappers (for example the SVG/TTL
+ * serializers) to read, write, and delete files inside the virtual
+ * filesystem that the C++ layer writes to.
+ */
+export interface EmscriptenFS {
+    /**
+     * Write data to a virtual filesystem path.
+     *
+     * @param path - Destination path inside MEMFS.
+     * @param data - String or byte view to write.
+     * @param opts - Optional flags (e.g. `{ flags: 'w' }`).
+     */
+    writeFile(path: string, data: string | ArrayBufferView | ArrayBuffer, opts?: {
+        flags?: string;
+    }): void;
+    /**
+     * Read a virtual filesystem file.
+     *
+     * When `opts.encoding === 'utf8'` the file is decoded to a string;
+     * otherwise a `Uint8Array` of the raw bytes is returned.
+     */
+    readFile(path: string, opts?: {
+        encoding?: string;
+        flags?: string;
+    }): string | Uint8Array;
+    /** Delete a virtual filesystem entry. */
+    unlink(path: string): void;
+    /** Return whether a path exists in MEMFS. */
+    analyzePath(path: string): {
+        exists: boolean;
+        object?: object;
+    };
+}
+/** Identifiers for the plugin kinds supported by the WASM loader. */
+export type PluginKind = 'schema' | 'kernel' | 'mapping' | 'tree' | 'document' | 'geometry_serializer';
+/** A single entry in the plugin manifest, describing a loadable side module. */
+export interface PluginEntry {
+    /** Relative path to the `.wasm` side module (resolved against `pluginBaseUrl`). */
+    wasm: string;
+    /** Plugin keys this entry depends on, e.g. `["kernel:occt"]`. */
+    depends?: string[];
+}
+/** The full plugin manifest (content of `ifcopenshell_plugins.json`). */
+export interface PluginManifest {
+    schema?: Record<string, PluginEntry>;
+    kernel?: Record<string, PluginEntry>;
+    mapping?: Record<string, PluginEntry>;
+    document?: Record<string, PluginEntry>;
+    geometry_serializer?: Record<string, PluginEntry>;
+    tree?: Record<string, PluginEntry>;
+}
+/** Recursive value accepted by an Emscripten module factory. */
+export type EmscriptenOption = null | boolean | number | string | EmscriptenOption[] | {
+    [key: string]: EmscriptenOption;
+} | ((path: string, prefix: string) => string);
+/** Emscripten module factory option map. */
+export type EmscriptenOptions = Record<string, EmscriptenOption>;
+/** Emscripten module factory — the default export of `ifcopenshell_wasm.mjs`. */
+export type EmscriptenModuleFactory = (options?: EmscriptenOptions) => Promise<object>;
+/** Generated API factory exported by `ifcopenshell_api.mjs`. */
+export type IfcOpenshellApiFactory = (initModule: EmscriptenModuleFactory, wasmUrl?: string, opts?: {
+    pluginBaseUrl?: string;
+    pluginManifest?: Record<string, Record<string, {
+        wasm: string;
+        depends?: string[];
+    }>>;
+    pluginLoader?: PluginLoader;
+}) => Promise<IfcOpenshellModule>;
+/**
+ * Custom plugin loader function.
+ *
+ * Override this to change how plugin `.wasm` bytes are fetched.
+ * The default loader uses `fetch()` in the browser and is filesystem-backed in Node.
+ */
+export type PluginLoader = (url: string, plugin: {
+    kind: string;
+    id: string;
+    entry: PluginEntry;
+}) => Promise<Uint8Array | ArrayBuffer | ArrayBufferView> | Uint8Array | ArrayBuffer | ArrayBufferView;
+/** Configuration for locating the WASM build artifacts. */
+export interface WasmAssets {
+    /** The Emscripten module factory (default export of `ifcopenshell_wasm.mjs`). */
+    initModule: EmscriptenModuleFactory;
+    /** URL or path to `ifcopenshell_wasm.wasm`. */
+    wasmUrl: string;
+    /** Base URL for resolving plugin `.wasm` paths from the manifest. */
+    pluginBaseUrl: string;
+    /** Parsed content of `ifcopenshell_plugins.json`. */
+    manifest: PluginManifest;
+    /** Environment-appropriate loader for plugin WASM files. */
+    pluginLoader?: PluginLoader;
+    /**
+     * URL or module specifier for the generated `ifcopenshell_api.mjs`.
+     * Required when `createIfcOpenshellModule` is not provided.
+     */
+    apiModuleUrl?: string;
+    /**
+     * Generated API factory. Bundler-friendly wasm packages should provide this
+     * so app bundles do not need runtime string imports for `ifcopenshell_api.mjs`.
+     */
+    createIfcOpenshellModule?: IfcOpenshellApiFactory;
+}
+/** Options for {@link init}. */
+export interface InitOptions {
+    /** WASM asset configuration. */
+    wasmAssets?: WasmAssets;
+    /** Custom plugin loader override. Defaults to the loader supplied by the asset descriptor. */
+    pluginLoader?: PluginLoader;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/util/color.d.ts

@@ -0,0 +1,34 @@
+/** RGB triplet with components normalized to the `[0, 1]` range. */
+export type RGB = [number, number, number];
+/**
+ * Generate a deterministic RGB color from a string hash.
+ *
+ * Uses an FNV-1a style hash so that the same input always maps to the same
+ * color — handy for assigning consistent display colors to IFC entity
+ * types (e.g. `hashColor('IfcWall')`).
+ *
+ * Components are returned in the `[0, 1]` range and deliberately biased
+ * away from pure black / pure white so they remain visible on both light
+ * and dark backgrounds.
+ *
+ * @param input - Arbitrary string to hash.
+ * @returns A deterministic `[r, g, b]` triplet in `[0, 1]`.
+ */
+export declare function hashColor(input: string): RGB;
+/**
+ * Resolve the display color for a mesh, preferring material colors
+ * defined on the IFC representation over a type-based hash color.
+ *
+ * The `colors` buffer follows the IfcOpenShell convention: each material
+ * contributes four consecutive floats (`[r, g, b, a]`), and `materialIds`
+ * maps each face item to a material index. When a material color is
+ * available it is used directly; otherwise the entity `type` is hashed to
+ * produce a stable fallback color.
+ *
+ * @param type        - IFC entity type name (e.g. `'IfcWall'`).
+ * @param materialIds - Per-face material indices (may be empty).
+ * @param colors      - Flat RGBA material color buffer (may be empty).
+ * @returns A `[r, g, b]` triplet in `[0, 1]`.
+ */
+export declare function meshColor(type: string, materialIds: ArrayLike<number>, colors: ArrayLike<number>): RGB;
+//# sourceMappingURL=color.d.ts.map

package/dist/util/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AACA,oEAAoE;AACpE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAM3C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAU5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAOtG"}

package/dist/util/color.js

@@ -0,0 +1,52 @@
+/** Minimum brightness floor and maximum lift applied to hashed colors. */
+const HASH_MIN = 0.25;
+const HASH_SPAN = 0.55;
+/**
+ * Generate a deterministic RGB color from a string hash.
+ *
+ * Uses an FNV-1a style hash so that the same input always maps to the same
+ * color — handy for assigning consistent display colors to IFC entity
+ * types (e.g. `hashColor('IfcWall')`).
+ *
+ * Components are returned in the `[0, 1]` range and deliberately biased
+ * away from pure black / pure white so they remain visible on both light
+ * and dark backgrounds.
+ *
+ * @param input - Arbitrary string to hash.
+ * @returns A deterministic `[r, g, b]` triplet in `[0, 1]`.
+ */
+export function hashColor(input) {
+    let h = 2166136261;
+    for (let i = 0; i < input.length; i++) {
+        h ^= input.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    const r = ((h >>> 0) & 0xff) / 255;
+    const g = ((h >>> 8) & 0xff) / 255;
+    const b = ((h >>> 16) & 0xff) / 255;
+    return [HASH_MIN + HASH_SPAN * r, HASH_MIN + HASH_SPAN * g, HASH_MIN + HASH_SPAN * b];
+}
+/**
+ * Resolve the display color for a mesh, preferring material colors
+ * defined on the IFC representation over a type-based hash color.
+ *
+ * The `colors` buffer follows the IfcOpenShell convention: each material
+ * contributes four consecutive floats (`[r, g, b, a]`), and `materialIds`
+ * maps each face item to a material index. When a material color is
+ * available it is used directly; otherwise the entity `type` is hashed to
+ * produce a stable fallback color.
+ *
+ * @param type        - IFC entity type name (e.g. `'IfcWall'`).
+ * @param materialIds - Per-face material indices (may be empty).
+ * @param colors      - Flat RGBA material color buffer (may be empty).
+ * @returns A `[r, g, b]` triplet in `[0, 1]`.
+ */
+export function meshColor(type, materialIds, colors) {
+    const materialId = materialIds.length > 0 ? materialIds[0] : -1;
+    const start = materialId >= 0 ? materialId * 4 : -1;
+    if (start >= 0 && colors.length >= start + 3) {
+        return [colors[start], colors[start + 1], colors[start + 2]];
+    }
+    return hashColor(type);
+}
+//# sourceMappingURL=color.js.map

package/dist/util/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAIA,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACnC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACnC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACpC,OAAO,CAAC,QAAQ,GAAG,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,WAA8B,EAAE,MAAyB;IAC/F,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/util/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility APIs for inspecting IFC entities and working with colors.
+ *
+ * @module Utilities
+ */
+export { hashColor, meshColor, type RGB, } from './color.js';
+export { formatAttributeValue, inspectEntity, type AttributeEntry, type EntityInspection, } from './inspect.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,KAAK,GAAG,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC"}

package/dist/util/index.js

@@ -0,0 +1,8 @@
+/**
+ * Utility APIs for inspecting IFC entities and working with colors.
+ *
+ * @module Utilities
+ */
+export { hashColor, meshColor, } from './color.js';
+export { formatAttributeValue, inspectEntity, } from './inspect.js';
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,GAEV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,aAAa,GAGd,MAAM,cAAc,CAAC"}

package/dist/util/inspect.d.ts

@@ -0,0 +1,15 @@
+import { type AttributeValueType } from '../entity_instance.js';
+import type { File } from '../file.js';
+export interface AttributeEntry {
+    name: string;
+    value: string;
+}
+export interface EntityInspection {
+    id: number;
+    type: string;
+    guid: string | null;
+    attributes: AttributeEntry[];
+}
+export declare function formatAttributeValue(value: AttributeValueType): string;
+export declare function inspectEntity(file: File, id: number): Promise<EntityInspection | null>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/util/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/util/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAKtE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAU5F"}