@treasuryspatial/viewer-kit 0.2.31

package/dist/engine/types.d.ts

@@ -0,0 +1,284 @@
+export type AssetKind = "hdr" | "texture" | "cubeface";
+export type AssetResolverResult = {
+    url: string;
+    headers?: Record<string, string>;
+};
+export type AssetResolver = (src: string, kind: AssetKind) => Promise<AssetResolverResult>;
+export type ToneMappingMode = "neutral" | "aces" | "linear";
+export type RendererConfig = {
+    toneMapping?: ToneMappingMode;
+    toneMappingExposure?: number;
+    outputColorSpace?: "srgb" | "linear";
+    maxPixelRatio?: number;
+    antialias?: boolean;
+    alpha?: boolean;
+    preserveDrawingBuffer?: boolean;
+    shadowMap?: {
+        enabled?: boolean;
+        type?: "pcfsoft" | "pcf" | "basic";
+    };
+};
+export type SkyGradientConfig = {
+    topColor: string;
+    horizonColor: string;
+    sunPosition: [number, number, number];
+    sunIntensity: number;
+    sunSize: number;
+};
+export type SkyHdrConfig = {
+    src: string;
+    exposure?: number;
+    rotationY?: number;
+    rotation?: {
+        yaw?: number;
+        pitch?: number;
+        roll?: number;
+    };
+    showBackground?: boolean;
+    showLighting?: boolean;
+    pmremResolution?: 256 | 512 | 1024;
+    usePmrem?: boolean;
+};
+export type SkyCubeConfig = {
+    px: string;
+    nx: string;
+    py: string;
+    ny: string;
+    pz: string;
+    nz: string;
+    exposure?: number;
+    rotationY?: number;
+    rotation?: {
+        yaw?: number;
+        pitch?: number;
+        roll?: number;
+    };
+    showBackground?: boolean;
+    showLighting?: boolean;
+    pmremResolution?: 256 | 512 | 1024;
+    usePmrem?: boolean;
+};
+export type SkyDefinition = {
+    mode: "none";
+} | {
+    mode: "gradient";
+    gradient: SkyGradientConfig;
+} | {
+    mode: "hdr";
+    hdr: SkyHdrConfig;
+} | {
+    mode: "cube";
+    cube: SkyCubeConfig;
+};
+export type LightingRigConfig = {
+    rig?: "studio" | "neutral" | "gallery" | "none";
+    ambient?: {
+        color: string;
+        intensity: number;
+    };
+    hemisphere?: {
+        skyColor: string;
+        groundColor: string;
+        intensity: number;
+    };
+    key?: {
+        color: string;
+        intensity: number;
+        position: [number, number, number];
+        castShadow?: boolean;
+    };
+    fill?: {
+        color: string;
+        intensity: number;
+        position: [number, number, number];
+    };
+    shadow?: {
+        cameraSize?: number;
+        near?: number;
+        far?: number;
+        bias?: number;
+        radius?: number;
+        mapSize?: number;
+    };
+};
+export type PostFxConfig = {
+    ao?: {
+        enabled: boolean;
+        intensity?: number;
+        radius?: number;
+        distanceFalloff?: number;
+        halfRes?: boolean;
+        quality?: "low" | "medium" | "high";
+        color?: string;
+    };
+    bloom?: {
+        enabled: boolean;
+        intensity?: number;
+        radius?: number;
+        threshold?: number;
+        smoothing?: number;
+    };
+    vignette?: {
+        enabled: boolean;
+        offset?: number;
+        darkness?: number;
+    };
+};
+export type SceneExtrasConfig = {
+    grid?: boolean;
+    ground?: boolean;
+    axes?: boolean;
+    origin?: boolean;
+    lightTarget?: [number, number, number];
+    groundColor?: number;
+    groundRoughness?: number;
+    groundMetalness?: number;
+    groundSize?: number;
+    groundOffset?: number;
+    groundAutoScale?: number;
+    groundAutoScaleHdr?: number;
+    gridColor?: number;
+    gridColorSecondary?: number;
+    gridOpacity?: number;
+    gridDivisions?: number;
+    gridSize?: number;
+    gridAutoScale?: number;
+    gridAutoScaleHdr?: number;
+    gridHeightOffset?: number;
+    originHighlight?: boolean;
+    originLineColor?: number;
+    originLineLength?: number;
+    originLineThickness?: number;
+    axisLabelScale?: number;
+    axesLabels?: {
+        lowerCase?: boolean;
+        upperCase?: boolean;
+        offset?: number;
+        secondaryOffset?: number;
+    };
+    originColor?: number;
+    originSize?: number;
+    axesPosition?: [number, number, number];
+};
+export type RenderPresetDefinition = {
+    id: string;
+    label?: string;
+    materialsPresetId?: string;
+    renderer?: RendererConfig;
+    sky?: SkyDefinition;
+    lighting?: LightingRigConfig;
+    interiorLights?: Array<{
+        position: [number, number, number];
+        intensity: number;
+        color?: string;
+        distance?: number;
+    }>;
+    postfx?: PostFxConfig;
+    sceneExtras?: SceneExtrasConfig;
+};
+export type PresetCatalog = Record<string, RenderPresetDefinition>;
+export type ViewerSnapshot = {
+    capturedAt: string;
+    presetId: string;
+    renderer: {
+        toneMapping: string;
+        toneMappingExposure: number;
+        outputColorSpace: string;
+    };
+    environment: {
+        mode: "none" | "gradient" | "hdr" | "cube";
+        backgroundEnabled: boolean;
+        lightingEnabled: boolean;
+    };
+    postfx: {
+        aoEnabled: boolean;
+        bloomEnabled: boolean;
+        vignetteEnabled: boolean;
+    };
+};
+export type ViewerDebugInfo = {
+    presetId: string;
+    camera: CameraState;
+    canvas: {
+        width: number;
+        height: number;
+        clientWidth: number;
+        clientHeight: number;
+    };
+    renderer: {
+        toneMapping: string;
+        toneMappingExposure: number;
+        outputColorSpace: string;
+        pixelRatio: number;
+        clearColor: string;
+        clearAlpha: number;
+    };
+    renderInfo: {
+        calls: number;
+        triangles: number;
+        lines: number;
+        points: number;
+    };
+    scene: {
+        children: number;
+        rootChildren: number;
+        lights: number;
+    };
+    environment: {
+        mode: "none" | "gradient" | "hdr" | "cube";
+        backgroundEnabled: boolean;
+        lightingEnabled: boolean;
+    };
+    postfx: {
+        aoEnabled: boolean;
+        bloomEnabled: boolean;
+        vignetteEnabled: boolean;
+    };
+};
+export type CameraState = {
+    position: [number, number, number];
+    target: [number, number, number];
+    fov: number;
+    near?: number;
+    far?: number;
+};
+export type ViewerCreateOptions = {
+    container: HTMLElement;
+    presetId?: string;
+    presets?: PresetCatalog;
+    assetResolver?: AssetResolver;
+    renderer?: {
+        antialias?: boolean;
+        alpha?: boolean;
+        preserveDrawingBuffer?: boolean;
+    };
+    camera?: {
+        fov?: number;
+        near?: number;
+        far?: number;
+        position?: [number, number, number];
+        target?: [number, number, number];
+    };
+    usePostprocessing?: boolean;
+    hooks?: {
+        onReady?: (handle: ViewerHandle) => void;
+        onError?: (error: unknown) => void;
+    };
+};
+export type ViewerHandle = {
+    start(): void;
+    stop(): void;
+    resize(): void;
+    invalidate(): void;
+    dispose(): void;
+    setPreset(presetId: string): void;
+    setRuntimePreset(preset: RenderPresetDefinition): void;
+    setSceneRoot(root: unknown): void;
+    setCamera(state: Partial<CameraState>): void;
+    getCameraState(): CameraState;
+    capturePng(): Promise<Blob>;
+    getSnapshot(): ViewerSnapshot;
+    getDebugInfo?: () => ViewerDebugInfo;
+    getCanvas?: () => HTMLCanvasElement;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/types.d.ts.map

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

package/dist/engine/types.js

@@ -0,0 +1 @@
+export {};

package/dist/exports/download.d.ts

@@ -0,0 +1,2 @@
+export declare function downloadBlob(blob: Blob, filename: string): void;
+//# sourceMappingURL=download.d.ts.map

package/dist/exports/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/exports/download.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QASxD"}

package/dist/exports/download.js

@@ -0,0 +1,10 @@
+export function downloadBlob(blob, filename) {
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = filename;
+    document.body.appendChild(link);
+    link.click();
+    link.remove();
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+}

package/dist/exports/three-export.d.ts

@@ -0,0 +1,4 @@
+import * as THREE from "three";
+export type ExportFormat = "glb" | "obj";
+export declare function exportObject(object: THREE.Object3D, format: ExportFormat): Promise<Blob>;
+//# sourceMappingURL=three-export.d.ts.map

package/dist/exports/three-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-export.d.ts","sourceRoot":"","sources":["../../src/exports/three-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzC,wBAAsB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B9F"}

package/dist/exports/three-export.js

@@ -0,0 +1,25 @@
+export async function exportObject(object, format) {
+    if (format === "glb") {
+        const { GLTFExporter } = await import("three/examples/jsm/exporters/GLTFExporter.js");
+        const exporter = new GLTFExporter();
+        const arrayBuffer = await new Promise((resolve, reject) => {
+            exporter.parse(object, (result) => {
+                if (result instanceof ArrayBuffer) {
+                    resolve(result);
+                    return;
+                }
+                try {
+                    resolve(new TextEncoder().encode(JSON.stringify(result)).buffer);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            }, (error) => reject(error), { binary: true });
+        });
+        return new Blob([arrayBuffer], { type: "model/gltf-binary" });
+    }
+    const { OBJExporter } = await import("three/examples/jsm/exporters/OBJExporter.js");
+    const exporter = new OBJExporter();
+    const text = exporter.parse(object);
+    return new Blob([text], { type: "text/plain" });
+}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { ViewerCreateOptions, ViewerHandle, ViewerSnapshot, CameraState, RenderPresetDefinition, PresetCatalog, LightingRigConfig, PostFxConfig, SceneExtrasConfig, SkyDefinition, SkyHdrConfig, SkyCubeConfig, ViewerDebugInfo, } from "./engine/types";
+export type { CameraFrameConfig, CameraFrameMode, CameraNormalizationConfig, CameraNormalizationResult, } from "./camera";
+export { createViewer } from "./engine/createViewer";
+export { computeCameraFrame, normalizeObject3d } from "./camera";
+export { DEFAULT_PRESET_ID, DEFAULT_PRESETS } from "./presets/defaults";
+export { SCIENCE_PRESETS, SCIENCE_PRESET_SUMMARIES, SCIENCE_DEFAULT_PRESET_ID, buildViewerPresets, buildSciencePresets, } from "./presets/sciencePresets";
+export { listScienceSkyOptions, getScienceSkyOption } from "./sky/scienceSky";
+export type { ScienceSkyOption } from "./sky/scienceSky";
+export type { MaterialCatalogue, MaterialDefinition, MaterialId, MaterialColor, SurfaceMaterialConfig, MaterialsConfig, } from "./materials/types";
+export { getMaterialCatalogue, findMaterial, listMaterialsByCategory } from "./materials/catalogue";
+export { getRenderMaterialMetadata } from "./materials/renderMetadata";
+export { BASELINE_MATERIAL_PRESET_ID, MATERIAL_PRESET_DATA, listMaterialPresets, getMaterialPreset, resolveMaterialSlot, resolveMaterialPresetMaterials, } from "./materials/presets";
+export { applyMaterialsToGroup, buildSurfaceMaterial, buildCatalogMaterial, setTextureBaseUrl, } from "./materials/architectural";
+export * from "./uploads";
+export { exportObject } from "./exports/three-export";
+export type { ExportFormat } from "./exports/three-export";
+export { downloadBlob } from "./exports/download";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { createViewer } from "./engine/createViewer";
+export { computeCameraFrame, normalizeObject3d } from "./camera";
+export { DEFAULT_PRESET_ID, DEFAULT_PRESETS } from "./presets/defaults";
+export { SCIENCE_PRESETS, SCIENCE_PRESET_SUMMARIES, SCIENCE_DEFAULT_PRESET_ID, buildViewerPresets, buildSciencePresets, } from "./presets/sciencePresets";
+export { listScienceSkyOptions, getScienceSkyOption } from "./sky/scienceSky";
+export { getMaterialCatalogue, findMaterial, listMaterialsByCategory } from "./materials/catalogue";
+export { getRenderMaterialMetadata } from "./materials/renderMetadata";
+export { BASELINE_MATERIAL_PRESET_ID, MATERIAL_PRESET_DATA, listMaterialPresets, getMaterialPreset, resolveMaterialSlot, resolveMaterialPresetMaterials, } from "./materials/presets";
+export { applyMaterialsToGroup, buildSurfaceMaterial, buildCatalogMaterial, setTextureBaseUrl, } from "./materials/architectural";
+export * from "./uploads";
+export { exportObject } from "./exports/three-export";
+export { downloadBlob } from "./exports/download";

package/dist/materials/architectural.d.ts

@@ -0,0 +1,7 @@
+import * as THREE from "three";
+import type { MaterialId, MaterialsConfig, SurfaceMaterialConfig } from "./types";
+export declare const setTextureBaseUrl: (baseUrl?: string) => void;
+export declare function buildSurfaceMaterial(surface: "walls" | "floor" | "ceiling", config: SurfaceMaterialConfig): THREE.MeshStandardMaterial;
+export declare function buildCatalogMaterial(materialId: MaterialId, overrides?: Partial<SurfaceMaterialConfig>): THREE.MeshStandardMaterial;
+export declare function applyMaterialsToGroup(group: THREE.Group, materialsConfig?: MaterialsConfig | null, floorLevel?: number, ceilingHeight?: number): void;
+//# sourceMappingURL=architectural.d.ts.map

package/dist/materials/architectural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architectural.d.ts","sourceRoot":"","sources":["../../src/materials/architectural.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAalF,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,SAMjD,CAAC;AA0GF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,qBAAqB,8BAEzG;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,8BAiBtG;AA4BD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,EACxC,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAgCN"}

package/dist/materials/architectural.js

@@ -0,0 +1,187 @@
+import * as THREE from "three";
+import { findMaterial } from "./catalogue";
+import { getRenderMaterialMetadata } from "./renderMetadata";
+const clamp01 = (value) => Math.min(Math.max(value, 0), 1);
+const colorFromRGB = (rgb) => new THREE.Color(rgb.r / 255, rgb.g / 255, rgb.b / 255);
+const textureLoader = new THREE.TextureLoader();
+const textureCache = new Map();
+let textureBaseUrl = "";
+export const setTextureBaseUrl = (baseUrl) => {
+    if (!baseUrl) {
+        textureBaseUrl = "";
+        return;
+    }
+    textureBaseUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+};
+const resolveTexturePath = (path) => {
+    if (!textureBaseUrl)
+        return path;
+    if (path.startsWith("/"))
+        return `${textureBaseUrl}${path}`;
+    return path;
+};
+const loadTexture = (path, scale) => {
+    if (!path)
+        return undefined;
+    const resolved = resolveTexturePath(path);
+    const cached = textureCache.get(resolved);
+    if (cached)
+        return cached;
+    const texture = textureLoader.load(resolved, () => {
+        texture.needsUpdate = true;
+    });
+    texture.wrapS = THREE.RepeatWrapping;
+    texture.wrapT = THREE.RepeatWrapping;
+    if (scale) {
+        texture.repeat.set(scale[0], scale[1]);
+    }
+    texture.flipY = false;
+    textureCache.set(resolved, texture);
+    return texture;
+};
+const applyTexturesToMaterial = (material, textures) => {
+    if (!textures)
+        return;
+    let changed = false;
+    if (textures.albedo) {
+        const map = loadTexture(textures.albedo, textures.scale);
+        if (map) {
+            map.colorSpace = THREE.SRGBColorSpace;
+            material.map = map;
+            changed = true;
+        }
+    }
+    if (textures.normal) {
+        const map = loadTexture(textures.normal, textures.scale);
+        if (map) {
+            map.colorSpace = THREE.LinearSRGBColorSpace;
+            material.normalMap = map;
+            changed = true;
+        }
+    }
+    if (textures.roughness) {
+        const map = loadTexture(textures.roughness, textures.scale);
+        if (map) {
+            map.colorSpace = THREE.LinearSRGBColorSpace;
+            material.roughnessMap = map;
+            changed = true;
+        }
+    }
+    if (textures.ao) {
+        const map = loadTexture(textures.ao, textures.scale);
+        if (map) {
+            map.colorSpace = THREE.LinearSRGBColorSpace;
+            material.aoMap = map;
+            changed = true;
+        }
+    }
+    if (changed) {
+        material.needsUpdate = true;
+    }
+};
+const buildMaterial = (surface, config) => {
+    const isCustom = config.type === "custom";
+    const catalogueMaterial = !isCustom ? findMaterial(config.type) : undefined;
+    const renderMetadata = !isCustom ? getRenderMaterialMetadata(config.type) : undefined;
+    const hasAlbedoTexture = Boolean(renderMetadata?.textures?.albedo) || Boolean(catalogueMaterial?.pbr?.texture);
+    const baseColor = catalogueMaterial && hasAlbedoTexture
+        ? new THREE.Color(catalogueMaterial.pbr.baseColor)
+        : colorFromRGB(config.color);
+    const material = new THREE.MeshStandardMaterial({
+        color: baseColor.clone(),
+        roughness: clamp01(config.roughness ?? catalogueMaterial?.pbr.roughness ?? 0.6),
+        metalness: clamp01(catalogueMaterial?.pbr.metalness ?? 0),
+        emissive: new THREE.Color(catalogueMaterial?.pbr.emissive ?? "#ffffff"),
+        emissiveIntensity: clamp01(catalogueMaterial?.pbr.emissiveIntensity ?? 0.05),
+        depthWrite: true,
+        depthTest: true,
+        side: THREE.DoubleSide,
+    });
+    material.envMapIntensity = clamp01(config.reflectance ?? 0.5);
+    if (catalogueMaterial?.pbr.transparent || typeof catalogueMaterial?.pbr.opacity === "number") {
+        material.transparent = catalogueMaterial?.pbr.transparent ?? true;
+        material.opacity = clamp01(catalogueMaterial?.pbr.opacity ?? 1);
+        material.depthWrite = false;
+    }
+    if (!isCustom) {
+        if (renderMetadata?.doubleSided === false) {
+            material.side = THREE.FrontSide;
+        }
+        applyTexturesToMaterial(material, renderMetadata?.textures);
+    }
+    material.name = `${surface}-material`;
+    return material;
+};
+export function buildSurfaceMaterial(surface, config) {
+    return buildMaterial(surface, config);
+}
+export function buildCatalogMaterial(materialId, overrides) {
+    const definition = findMaterial(materialId);
+    const fallbackColor = definition?.baseline?.color ?? "#ffffff";
+    const color = overrides?.color ?? {
+        r: parseInt(fallbackColor.slice(1, 3), 16),
+        g: parseInt(fallbackColor.slice(3, 5), 16),
+        b: parseInt(fallbackColor.slice(5, 7), 16),
+    };
+    const config = {
+        type: materialId,
+        color,
+        reflectance: overrides?.reflectance ?? 0.5,
+        roughness: overrides?.roughness ?? definition?.pbr?.roughness ?? 0.6,
+        pattern: overrides?.pattern,
+        patternScale: overrides?.patternScale,
+    };
+    return buildMaterial(materialId, config);
+}
+const classifySurfaceWorld = (bboxWorld, floorY, ceilingY) => {
+    const dx = bboxWorld.max.x - bboxWorld.min.x;
+    const dy = bboxWorld.max.y - bboxWorld.min.y;
+    const dz = bboxWorld.max.z - bboxWorld.min.z;
+    const centerY = (bboxWorld.min.y + bboxWorld.max.y) / 2;
+    const midY = (floorY + ceilingY) / 2;
+    const isBroadHorizontal = dy <= 0.35 && dx >= 0.8 && dz >= 0.8;
+    if (isBroadHorizontal) {
+        return centerY <= midY ? "floor" : "ceiling";
+    }
+    const isSlabLike = dy <= 1.0 && dx >= 0.8 && dz >= 0.8;
+    if (isSlabLike) {
+        if (bboxWorld.max.y <= floorY + 0.6)
+            return "floor";
+        if (bboxWorld.min.y >= ceilingY - 0.6)
+            return "ceiling";
+        return centerY <= midY ? "floor" : "ceiling";
+    }
+    return "walls";
+};
+export function applyMaterialsToGroup(group, materialsConfig, floorLevel, ceilingHeight) {
+    if (!group || typeof group.traverse !== "function")
+        return;
+    const floorY = typeof floorLevel === "number" ? floorLevel : 0;
+    const ceilingY = typeof ceilingHeight === "number" ? floorY + ceilingHeight : undefined;
+    const materialSet = materialsConfig
+        ? {
+            walls: buildSurfaceMaterial("walls", materialsConfig.walls),
+            floor: buildSurfaceMaterial("floor", materialsConfig.floor),
+            ceiling: buildSurfaceMaterial("ceiling", materialsConfig.ceiling),
+        }
+        : null;
+    group.updateMatrixWorld(true);
+    group.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        child.castShadow = true;
+        child.receiveShadow = true;
+        child.geometry.computeBoundingBox();
+        const bbox = child.geometry.boundingBox;
+        const taggedMaterialId = typeof child.userData?.material === "string" ? child.userData.material : null;
+        if (taggedMaterialId && findMaterial(taggedMaterialId)) {
+            child.material = buildCatalogMaterial(taggedMaterialId);
+        }
+        else if (bbox && materialSet && typeof ceilingY === "number") {
+            const bboxWorld = bbox.clone().applyMatrix4(child.matrixWorld);
+            const surface = classifySurfaceWorld(bboxWorld, floorY, ceilingY);
+            child.material = materialSet[surface].clone();
+        }
+        child.geometry.computeVertexNormals();
+    });
+}