@pascal-app/core 1.0.3 → 1.0.5

package/dist/material-library.js

@@ -1,4 +1,6 @@
-import { MaterialTarget as MaterialTargetSchema, } from './schema/material.js';
+import { MaterialProperties, MaterialTarget as MaterialTargetSchema, } from './schema/material.js';
+// The library's kinds and surfaces, kept apart so a tool contract names them without the catalog.
+export { MATERIAL_CATEGORIES, MATERIAL_SURFACES, } from './material-kinds.js';
 const WALL_TARGETS = [
     MaterialTargetSchema.enum.wall,
     MaterialTargetSchema.enum.chimney,
@@ -29,32 +31,6 @@ const ROOF_TARGETS = [
     MaterialTargetSchema.enum.dormer,
 ];
 const CEILING_TARGETS = [MaterialTargetSchema.enum.ceiling];
-export const MATERIAL_CATEGORIES = [
-    'colors',
-    'wood',
-    'stone',
-    'brick',
-    'tile',
-    'wallpaper',
-    'concrete',
-    'metal',
-    'plastic',
-    'fabric',
-    'carpet',
-    'leather',
-    'roofing',
-    'ground',
-    'glass',
-    'other',
-];
-export const MATERIAL_SURFACES = [
-    'floor',
-    'wall',
-    'ceiling',
-    'roof',
-    'furniture',
-    'outdoor',
-];
 export const MATERIAL_CATALOG = [
     {
         id: 'wood-finewood27',
@@ -63,6 +39,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall', 'furniture'],
         description: 'Fine wood finish',
         previewThumbnailUrl: '/material/wood/finewood_27/finewood_27_thumb.webp',
+        previewColor: '#a7753f',
         preset: {
             maps: {
                 albedoMap: '/material/wood/finewood_27/finewood_27_basecolor_512.ktx2',
@@ -101,6 +78,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Wood plank finish',
         previewThumbnailUrl: '/material/wood/floor_plank_1/floor_plank_1_thumb.webp',
+        previewColor: '#bf8552',
         preset: {
             maps: {
                 albedoMap: '/material/wood/floor_plank_1/floor_plank_1_basecolor_512.ktx2',
@@ -138,6 +116,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/hungarian_parquet_10/hungarian_parquet_10_thumb.webp',
+        previewColor: '#a87d50',
         preset: {
             maps: {
                 albedoMap: '/material/wood/hungarian_parquet_10/hungarian_parquet_10_basecolor_512.ktx2',
@@ -175,6 +154,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/hungarian_parquet_2/hungarian_parquet_2_thumb.webp',
+        previewColor: '#673021',
         preset: {
             maps: {
                 albedoMap: '/material/wood/hungarian_parquet_2/hungarian_parquet_2_basecolor_512.ktx2',
@@ -212,6 +192,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/square_parquet_21/square_parquet_21_thumb.webp',
+        previewColor: '#3f220f',
         preset: {
             maps: {
                 albedoMap: '/material/wood/square_parquet_21/square_parquet_21_basecolor_512.ktx2',
@@ -249,6 +230,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/square_wood_parquet_23/square_wood_parquet_23_thumb.webp',
+        previewColor: '#7e4108',
         preset: {
             maps: {
                 albedoMap: '/material/wood/square_wood_parquet_23/square_wood_parquet_23_basecolor_512.ktx2',
@@ -286,6 +268,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall', 'furniture'],
         description: 'Fine wood finish',
         previewThumbnailUrl: '/material/wood/wood_fine/wood_fine_thumb.webp',
+        previewColor: '#ba9a80',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wood_fine/wood_fine_basecolor_512.ktx2',
@@ -323,6 +306,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall', 'furniture'],
         description: 'Fine wood finish',
         previewThumbnailUrl: '/material/wood/wood_fine_11/wood_fine_11_thumb.webp',
+        previewColor: '#f59d52',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wood_fine_11/wood_fine_11_basecolor_512.ktx2',
@@ -360,6 +344,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall', 'furniture'],
         description: 'Fine wood finish',
         previewThumbnailUrl: '/material/wood/wood_fine_13/wood_fine_13_thumb.webp',
+        previewColor: '#e5a76f',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wood_fine_13/wood_fine_13_basecolor_512.ktx2',
@@ -397,6 +382,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall', 'furniture'],
         description: 'Fine wood finish',
         previewThumbnailUrl: '/material/wood/wood_fine_2/wood_fine_2_thumb.webp',
+        previewColor: '#dcb791',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wood_fine_2/wood_fine_2_basecolor_512.ktx2',
@@ -434,6 +420,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall', 'furniture'],
         description: 'Fine wood finish',
         previewThumbnailUrl: '/material/wood/wood_fine_22/wood_fine_22_thumb.webp',
+        previewColor: '#bfa67e',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wood_fine_22/wood_fine_22_basecolor_512.ktx2',
@@ -471,6 +458,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall', 'furniture'],
         description: 'Fine wood finish',
         previewThumbnailUrl: '/material/wood/wood_fine_24/wood_fine_24_thumb.webp',
+        previewColor: '#a43c28',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wood_fine_24/wood_fine_24_basecolor_512.ktx2',
@@ -508,6 +496,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/wood_parquet_14/wood_parquet_14_thumb.webp',
+        previewColor: '#e3d4c2',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wood_parquet_14/wood_parquet_14_basecolor_512.ktx2',
@@ -547,6 +536,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/wooden_parquet_11/wooden_parquet_11_thumb.webp',
+        previewColor: '#59392d',
         preset: {
             maps: {
                 albedoMap: '/material/wood/wooden_parquet_11/wooden_parquet_11_basecolor_512.ktx2',
@@ -584,6 +574,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/woodparquet_121/woodparquet_121_thumb.webp',
+        previewColor: '#8f7247',
         preset: {
             maps: {
                 albedoMap: '/material/wood/woodparquet_121/woodparquet_121_basecolor_512.ktx2',
@@ -622,6 +613,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/woodparquet_56/woodparquet_56_thumb.webp',
+        previewColor: '#ba8b5d',
         preset: {
             maps: {
                 albedoMap: '/material/wood/woodparquet_56/woodparquet_56_basecolor_512.ktx2',
@@ -661,6 +653,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/woodparquet_65/woodparquet_65_thumb.webp',
+        previewColor: '#9f7841',
         preset: {
             maps: {
                 albedoMap: '/material/wood/woodparquet_65/woodparquet_65_basecolor_512.ktx2',
@@ -700,6 +693,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Parquet wood finish',
         previewThumbnailUrl: '/material/wood/woodparquet_99/woodparquet_99_thumb.webp',
+        previewColor: '#b69573',
         preset: {
             maps: {
                 albedoMap: '/material/wood/woodparquet_99/woodparquet_99_basecolor_512.ktx2',
@@ -739,6 +733,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Wood plank finish',
         previewThumbnailUrl: '/material/wood/woodplank_19/woodplank_19_thumb.webp',
+        previewColor: '#8f7b5f',
         preset: {
             maps: {
                 albedoMap: '/material/wood/woodplank_19/woodplank_19_basecolor_512.ktx2',
@@ -777,6 +772,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Wood plank finish',
         previewThumbnailUrl: '/material/wood/woodplank_48/woodplank_48_thumb.webp',
+        previewColor: '#89664d',
         preset: {
             maps: {
                 albedoMap: '/material/wood/woodplank_48/woodplank_48_basecolor_512.ktx2',
@@ -815,6 +811,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Floor tile finish',
         previewThumbnailUrl: '/material/flooring/tile_quarry/tile_quarry_thumb.webp',
+        previewColor: '#484946',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/tile_quarry/tile_quarry_basecolor_512.ktx2',
@@ -853,6 +850,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'floor', 'outdoor'],
         description: 'Brick finish',
         previewThumbnailUrl: '/material/flooring/brick_wall_rustic/brick_wall_rustic_thumb.webp',
+        previewColor: '#9b6f57',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/brick_wall_rustic/brick_wall_rustic_basecolor_512.ktx2',
@@ -892,6 +890,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'floor', 'outdoor'],
         description: 'Brick finish',
         previewThumbnailUrl: '/material/flooring/brick_wall_aged/brick_wall_aged_thumb.webp',
+        previewColor: '#be9877',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/brick_wall_aged/brick_wall_aged_basecolor_512.ktx2',
@@ -931,6 +930,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'floor', 'outdoor'],
         description: 'Brick finish',
         previewThumbnailUrl: '/material/flooring/brick_wall_weathered/brick_wall_weathered_thumb.webp',
+        previewColor: '#86513c',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/brick_wall_weathered/brick_wall_weathered_basecolor_512.ktx2',
@@ -969,6 +969,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'furniture'],
         description: 'Panel finish',
         previewThumbnailUrl: '/material/flooring/garage_panel/garage_panel_thumb.webp',
+        previewColor: '#d7dad7',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/garage_panel/garage_panel_basecolor_512.ktx2',
@@ -1006,6 +1007,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Stone flooring finish',
         previewThumbnailUrl: '/material/flooring/green_labradorite/green_labradorite_thumb.webp',
+        previewColor: '#313828',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/green_labradorite/green_labradorite_basecolor_512.ktx2',
@@ -1043,6 +1045,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['outdoor', 'floor'],
         description: 'Ground surface finish',
         previewThumbnailUrl: '/material/flooring/ground_earth/ground_earth_thumb.webp',
+        previewColor: '#716c62',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/ground_earth/ground_earth_basecolor_512.ktx2',
@@ -1082,6 +1085,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'outdoor'],
         description: 'Pool tile finish',
         previewThumbnailUrl: '/material/flooring/pool_tiles/pool_tiles_thumb.webp',
+        previewColor: '#79b4ce',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/pool_tiles/pool_tiles_basecolor_512.ktx2',
@@ -1119,6 +1123,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Tile flooring finish',
         previewThumbnailUrl: '/material/flooring/tiles_checker/tiles_checker_thumb.webp',
+        previewColor: '#bab4b0',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/tiles_checker/tiles_checker_basecolor_512.ktx2',
@@ -1156,6 +1161,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Tile flooring finish',
         previewThumbnailUrl: '/material/flooring/tiles_grid/tiles_grid_thumb.webp',
+        previewColor: '#828282',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/tiles_grid/tiles_grid_basecolor_512.ktx2',
@@ -1193,6 +1199,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'floor', 'outdoor'],
         description: 'Stone finish',
         previewThumbnailUrl: '/material/flooring/stone_wall/stone_wall_thumb.webp',
+        previewColor: '#b2845c',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/stone_wall/stone_wall_basecolor_512.ktx2',
@@ -1230,6 +1237,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Wood-look ceramic flooring finish',
         previewThumbnailUrl: '/material/flooring/wooden_ceramic_3/wooden_ceramic_3_thumb.webp',
+        previewColor: '#977459',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/wooden_ceramic_3/wooden_ceramic_3_basecolor_512.ktx2',
@@ -1267,6 +1275,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Ceramic flooring finish',
         previewThumbnailUrl: '/material/flooring/ceramic_mosaic/ceramic_mosaic_thumb.webp',
+        previewColor: '#b9b6ae',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/ceramic_mosaic/ceramic_mosaic_basecolor_512.ktx2',
@@ -1306,6 +1315,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Terrazzo flooring finish',
         previewThumbnailUrl: '/material/flooring/terrazzo/terrazzo_thumb.webp',
+        previewColor: '#939e9f',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/terrazzo/terrazzo_basecolor_512.ktx2',
@@ -1344,6 +1354,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Floor tile finish',
         previewThumbnailUrl: '/material/flooring/tile_stone/tile_stone_thumb.webp',
+        previewColor: '#d1d0c9',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/tile_stone/tile_stone_basecolor_512.ktx2',
@@ -1382,6 +1393,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Floor tile finish',
         previewThumbnailUrl: '/material/flooring/tile_terracotta/tile_terracotta_thumb.webp',
+        previewColor: '#6e6b65',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/tile_terracotta/tile_terracotta_basecolor_512.ktx2',
@@ -1420,6 +1432,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Green quartzite flooring finish',
         previewThumbnailUrl: '/material/flooring/green_glass_quartzite/green_glass_quartzite_thumb.webp',
+        previewColor: '#5d6957',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/green_glass_quartzite/green_glass_quartzite_basecolor_512.ktx2',
@@ -1457,6 +1470,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Dark ceramic flooring finish',
         previewThumbnailUrl: '/material/flooring/dark_ceramic_grunge/dark_ceramic_grunge_thumb.webp',
+        previewColor: '#535351',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/dark_ceramic_grunge/dark_ceramic_grunge_basecolor_512.ktx2',
@@ -1496,6 +1510,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Light ceramic flooring finish',
         previewThumbnailUrl: '/material/flooring/light_ceramic_grunge/light_ceramic_grunge_thumb.webp',
+        previewColor: '#9c9b95',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/light_ceramic_grunge/light_ceramic_grunge_basecolor_512.ktx2',
@@ -1535,6 +1550,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'White marble flooring finish',
         previewThumbnailUrl: '/material/flooring/statuaretto/statuaretto_thumb.webp',
+        previewColor: '#bcbec2',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/statuaretto/statuaretto_basecolor_512.ktx2',
@@ -1572,6 +1588,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Floor tile finish',
         previewThumbnailUrl: '/material/flooring/tile_mosaic/tile_mosaic_thumb.webp',
+        previewColor: '#d1ccbe',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/tile_mosaic/tile_mosaic_basecolor_512.ktx2',
@@ -1611,6 +1628,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Floor tile finish',
         previewThumbnailUrl: '/material/flooring/tile_pattern/tile_pattern_thumb.webp',
+        previewColor: '#999287',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/tile_pattern/tile_pattern_basecolor_512.ktx2',
@@ -1650,6 +1668,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Wood-look ceramic flooring finish',
         previewThumbnailUrl: '/material/flooring/wooden_ceramic_2/wooden_ceramic_2_thumb.webp',
+        previewColor: '#786250',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/wooden_ceramic_2/wooden_ceramic_2_basecolor_512.ktx2',
@@ -1687,6 +1706,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor'],
         description: 'Wood parquet flooring finish',
         previewThumbnailUrl: '/material/flooring/woodparquet/woodparquet_thumb.webp',
+        previewColor: '#bea27e',
         preset: {
             maps: {
                 albedoMap: '/material/flooring/woodparquet/woodparquet_basecolor_512.ktx2',
@@ -1726,6 +1746,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['roof'],
         description: 'Classic roof shingle finish',
         previewThumbnailUrl: '/material/roofing/roof_shingles_classic/roof_shingles_classic_thumb.webp',
+        previewColor: '#9e5b46',
         preset: {
             maps: {
                 albedoMap: '/material/roofing/roof_shingles_classic/roof_shingles_classic_basecolor_512.ktx2',
@@ -1765,6 +1786,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['roof'],
         description: 'Clay roof tile finish',
         previewThumbnailUrl: '/material/roofing/roof_tiles_clay/roof_tiles_clay_thumb.webp',
+        previewColor: '#765241',
         preset: {
             maps: {
                 albedoMap: '/material/roofing/roof_tiles_clay/roof_tiles_clay_basecolor_512.ktx2',
@@ -1804,6 +1826,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['roof'],
         description: 'Terracotta roof tile finish',
         previewThumbnailUrl: '/material/roofing/roof_tiles_terracotta/roof_tiles_terracotta_thumb.webp',
+        previewColor: '#494b4d',
         preset: {
             maps: {
                 albedoMap: '/material/roofing/roof_tiles_terracotta/roof_tiles_terracotta_basecolor_512.ktx2',
@@ -1836,6 +1859,46 @@ export const MATERIAL_CATALOG = [
             },
         },
     },
+    {
+        id: 'roof-greyshingles',
+        label: 'Grey Shingles',
+        category: 'roofing',
+        surfaces: ['roof'],
+        description: 'Grey composition shingle finish',
+        previewThumbnailUrl: '/material/roofing/roof_shingles_grey/roof_shingles_grey_thumb.webp',
+        previewColor: '#505050',
+        preset: {
+            maps: {
+                albedoMap: '/material/roofing/roof_shingles_grey/roof_shingles_grey_basecolor_512.webp',
+                aoMap: '/material/roofing/roof_shingles_classic/roof_shingles_classic_ao_512.ktx2',
+                metalnessMap: '/material/roofing/roof_shingles_classic/roof_shingles_classic_metallic_512.ktx2',
+                normalMap: '/material/roofing/roof_shingles_classic/roof_shingles_classic_normal_512.ktx2',
+                roughnessMap: '/material/roofing/roof_shingles_classic/roof_shingles_classic_roughness_512.ktx2',
+            },
+            mapProperties: {
+                color: '#ffffff',
+                roughness: 1,
+                metalness: 0.1,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0,
+                transparent: false,
+                flipY: false,
+                bumpScale: 1,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
     {
         id: 'roof-weatheredshingles',
         label: 'Weathered Shingles',
@@ -1843,6 +1906,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['roof'],
         description: 'Weathered roof shingle finish',
         previewThumbnailUrl: '/material/roofing/roof_shingles_weathered/roof_shingles_weathered_thumb.webp',
+        previewColor: '#a15e49',
         preset: {
             maps: {
                 albedoMap: '/material/roofing/roof_shingles_weathered/roof_shingles_weathered_basecolor_512.ktx2',
@@ -3391,6 +3455,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture', 'wall'],
         description: 'Natural linen weave',
         previewThumbnailUrl: '/material/fabric/linen_hikari_fabric/linen_hikari_fabric_thumb.webp',
+        previewColor: '#aaa49f',
         preset: {
             maps: {
                 albedoMap: '/material/fabric/linen_hikari_fabric/linen_hikari_fabric_basecolor_512.ktx2',
@@ -3427,6 +3492,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture', 'wall'],
         description: 'Plain cotton weave',
         previewThumbnailUrl: '/material/fabric/blue_cotton/blue_cotton_thumb.webp',
+        previewColor: '#528bc1',
         preset: {
             maps: {
                 albedoMap: '/material/fabric/blue_cotton/blue_cotton_basecolor_512.ktx2',
@@ -3465,6 +3531,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture'],
         description: 'Velvet with a soft sheen',
         previewThumbnailUrl: '/material/fabric/red_velvet/red_velvet_thumb.webp',
+        previewColor: '#781113',
         preset: {
             maps: {
                 albedoMap: '/material/fabric/red_velvet/red_velvet_basecolor_512.ktx2',
@@ -3503,6 +3570,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture'],
         description: 'Matte wool felt',
         previewThumbnailUrl: '/material/fabric/white_wool/white_wool_thumb.webp',
+        previewColor: '#d2d2d2',
         preset: {
             maps: {
                 albedoMap: '/material/fabric/white_wool/white_wool_basecolor_512.ktx2',
@@ -3541,6 +3609,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture'],
         description: 'Matte suede nap',
         previewThumbnailUrl: '/material/fabric/suede/suede_thumb.webp',
+        previewColor: '#c8be98',
         preset: {
             maps: {
                 albedoMap: '/material/fabric/suede/suede_basecolor_512.ktx2',
@@ -3579,6 +3648,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture'],
         description: 'Looped bouclé upholstery',
         previewThumbnailUrl: '/material/fabric/wool_boucle/wool_boucle_thumb.webp',
+        previewColor: '#776d60',
         preset: {
             maps: {
                 albedoMap: '/material/fabric/wool_boucle/wool_boucle_basecolor_512.ktx2',
@@ -3615,6 +3685,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture'],
         description: 'Smooth black leather',
         previewThumbnailUrl: '/material/leather/black_leather/black_leather_thumb.webp',
+        previewColor: '#2b2b2b',
         preset: {
             maps: {
                 albedoMap: '/material/leather/black_leather/black_leather_basecolor_512.ktx2',
@@ -3652,6 +3723,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture'],
         description: 'Pebbled calf leather',
         previewThumbnailUrl: '/material/leather/calf_leather/calf_leather_thumb.webp',
+        previewColor: '#78411a',
         preset: {
             maps: {
                 albedoMap: '/material/leather/calf_leather/calf_leather_basecolor_512.ktx2',
@@ -3690,6 +3762,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'ceiling'],
         description: 'Smooth painted plaster wall',
         previewThumbnailUrl: '/material/concrete/plaster_painted/plaster_painted_thumb.webp',
+        previewColor: '#c8c5bd',
         preset: {
             maps: {
                 albedoMap: '/material/concrete/plaster_painted/plaster_painted_basecolor_512.ktx2',
@@ -3728,6 +3801,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['floor', 'wall'],
         description: 'Polished concrete floor',
         previewThumbnailUrl: '/material/concrete/concrete_polished/concrete_polished_thumb.webp',
+        previewColor: '#6d6b69',
         preset: {
             maps: {
                 albedoMap: '/material/concrete/concrete_polished/concrete_polished_basecolor_512.ktx2',
@@ -3765,6 +3839,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'floor', 'outdoor'],
         description: 'Board-formed raw concrete',
         previewThumbnailUrl: '/material/concrete/concrete_raw/concrete_raw_thumb.webp',
+        previewColor: '#a5a5a5',
         preset: {
             maps: {
                 albedoMap: '/material/concrete/concrete_raw/concrete_raw_basecolor_512.ktx2',
@@ -3803,6 +3878,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'floor'],
         description: 'Smooth cast concrete plate',
         previewThumbnailUrl: '/material/concrete/concrete_plate/concrete_plate_thumb.webp',
+        previewColor: '#ababab',
         preset: {
             maps: {
                 albedoMap: '/material/concrete/concrete_plate/concrete_plate_basecolor_512.ktx2',
@@ -3841,6 +3917,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'outdoor'],
         description: 'Exterior stucco render',
         previewThumbnailUrl: '/material/concrete/white_stucco/white_stucco_thumb.webp',
+        previewColor: '#cccccc',
         preset: {
             maps: {
                 albedoMap: '/material/concrete/white_stucco/white_stucco_basecolor_512.ktx2',
@@ -3879,6 +3956,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['wall', 'ceiling'],
         description: 'Smooth prepared drywall ready for paint',
         previewThumbnailUrl: '/material/concrete/prepared_drywall/prepared_drywall_thumb.webp',
+        previewColor: '#b1b1b1',
         preset: {
             maps: {
                 albedoMap: '/material/concrete/prepared_drywall/prepared_drywall_basecolor_512.ktx2',
@@ -3917,6 +3995,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture', 'wall'],
         description: 'Warm copper',
         previewThumbnailUrl: '/material/metal/copper_metal/copper_metal_thumb.webp',
+        previewColor: '#cb845d',
         preset: {
             maps: {
                 albedoMap: '/material/metal/copper_metal/copper_metal_basecolor_512.ktx2',
@@ -3955,6 +4034,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture', 'wall'],
         description: 'Polished stainless steel',
         previewThumbnailUrl: '/material/metal/polished_metal/polished_metal_thumb.webp',
+        previewColor: '#f2f4f3',
         preset: {
             maps: {
                 albedoMap: '/material/metal/polished_metal/polished_metal_basecolor_512.ktx2',
@@ -3994,6 +4074,7 @@ export const MATERIAL_CATALOG = [
         surfaces: ['furniture', 'wall'],
         description: 'Brushed stainless steel',
         previewThumbnailUrl: '/material/metal/stainless_steel_brushed/stainless_steel_brushed_thumb.webp',
+        previewColor: '#636363',
         preset: {
             maps: {
                 albedoMap: '/material/metal/stainless_steel_brushed/stainless_steel_brushed_basecolor_512.ktx2',
@@ -4094,6 +4175,503 @@ export const MATERIAL_CATALOG = [
             },
         },
     },
+    /* ── Siding ────────────────────────────────────────────────────────────────
+     * The catalog shipped no siding finish at all — no lap, no clapboard, no
+     * board-and-batten — so imported exterior walls could be color-true only as
+     * flat paint. One white seamless albedo per profile,
+     * tinted per entry via mapProperties.color (same mechanism the flat color
+     * presets use), keeps this to two textures for twelve finishes.
+     */
+    {
+        id: 'siding-lap-white',
+        label: 'Lap siding — white',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted white',
+        previewColor: '#e9e9e9',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#e9e9e9',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-greige',
+        label: 'Lap siding — greige',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted greige',
+        previewColor: '#c8c1b8',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#c8c1b8',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-gray',
+        label: 'Lap siding — gray',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted gray',
+        previewColor: '#8b8a86',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#8b8a86',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-sage',
+        label: 'Lap siding — sage',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted sage',
+        previewColor: '#bcc5b2',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#bcc5b2',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-cedar',
+        label: 'Lap siding — cedar',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, stained cedar',
+        previewColor: '#b5825a',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#b5825a',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-forest',
+        label: 'Lap siding — forest',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted forest',
+        previewColor: '#4f6b57',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#4f6b57',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-navy',
+        label: 'Lap siding — navy',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted navy',
+        previewColor: '#2f4865',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#2f4865',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-yellow',
+        label: 'Lap siding — yellow',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted yellow',
+        previewColor: '#f2e3b3',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#f2e3b3',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-nearblack',
+        label: 'Lap siding — nearblack',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted nearblack',
+        previewColor: '#232322',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#5c5c59',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-lap-clay',
+        label: 'Lap siding — clay',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior clapboard lap siding, painted clay',
+        previewColor: '#8f4a2e',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/lap_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#8f4a2e',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-batten-cream',
+        label: 'Board & batten — cream',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior board-and-batten siding, painted cream',
+        previewColor: '#efe3cc',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/batten_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#efe3cc',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-batten-sand',
+        label: 'Board & batten — sand',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior board-and-batten siding, painted sand',
+        previewColor: '#ddccae',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/batten_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#ddccae',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-batten-charcoal',
+        label: 'Board & batten — charcoal',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior board-and-batten siding, painted charcoal',
+        previewColor: '#4e5257',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/batten_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#4e5257',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
+    {
+        id: 'siding-batten-olive',
+        label: 'Board & batten — olive',
+        category: 'wood',
+        surfaces: ['wall', 'outdoor'],
+        description: 'Exterior board-and-batten siding, painted olive',
+        previewColor: '#8d9368',
+        preset: {
+            maps: {
+                albedoMap: '/material/siding/batten_albedo_512.webp',
+            },
+            mapProperties: {
+                color: '#8d9368',
+                roughness: 0.85,
+                metalness: 0,
+                repeatX: 1,
+                repeatY: 1,
+                rotation: 0,
+                wrapS: 'Repeat',
+                wrapT: 'Repeat',
+                normalScaleX: 1,
+                normalScaleY: 1,
+                emissiveIntensity: 1,
+                displacementScale: 0.02,
+                bumpScale: 1,
+                transparent: false,
+                flipY: true,
+                emissiveColor: '#000000',
+                aoMapIntensity: 1,
+                side: 0,
+                opacity: 1,
+                lightMapIntensity: 1,
+            },
+        },
+    },
 ];
 const STATIC_CATALOG_IDS = new Set(MATERIAL_CATALOG.map((item) => item.id));
 // Embedder-registered library materials (user/community/workspace). Core stays
@@ -4144,6 +4722,10 @@ export function getMaterialsForCategory(category) {
     }
     return items;
 }
+/** A community material's id (`mtl_…`, as the host's database mints them), well formed. */
+export function isCommunityMaterialId(id) {
+    return /^mtl_[\w-]+$/.test(id);
+}
 export function getCatalogMaterialById(id) {
     if (!id)
         return undefined;
@@ -4180,6 +4762,19 @@ export function parseMaterialRef(ref) {
         return { kind: 'scene', id: scene };
     return null;
 }
+const MATERIAL_COLOR = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
+/**
+ * A plain CSS hex colour (`#rgb` / `#rrggbb`) stored where a `MaterialRef`
+ * goes, e.g. a slot value: it paints that flat colour, as
+ * `material: { properties: { color } }` does. Lowercased, or null.
+ */
+export function parseMaterialColor(value) {
+    return typeof value === 'string' && MATERIAL_COLOR.test(value) ? value.toLowerCase() : null;
+}
+/** The flat material a plain colour stored as a material ref paints. */
+export function materialColorPaint(color) {
+    return { properties: MaterialProperties.parse({ color }) };
+}
 export function getMaterialPresetByRef(materialRef) {
     const materialId = getLibraryMaterialIdFromRef(materialRef);
     if (!materialId)