@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/sceneImport/materials/binding.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSharedMaterialBinding = createSharedMaterialBinding;
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+/** Build per-use state while preserving one shared Material Package reference. */
+function createSharedMaterialBinding(input) {
+    const binding = {
+        schema: helix_manifest_1.CONTINUUM_MATERIAL_BINDING_SCHEMA,
+        material: { ...input.material },
+        slot: input.slot,
+        tint: input.tint ? [...input.tint] : [1, 1, 1, 1],
+        opacity: input.opacity ?? 1,
+        roughnessScale: input.roughnessScale ?? 1,
+        metallicScale: input.metallicScale ?? 1,
+        normalScale: input.normalScale ?? 1,
+        emissiveScale: input.emissiveScale ?? 1,
+        uv: {
+            set: input.uv?.set ?? 0,
+            offset: input.uv?.offset ? [...input.uv.offset] : [0, 0],
+            scale: input.uv?.scale ? [...input.uv.scale] : [1, 1],
+            rotationDeg: input.uv?.rotationDeg ?? 0,
+            tiling: input.uv?.tiling ? [...input.uv.tiling] : [1, 1],
+        },
+        ...(input.samplerOverride
+            ? { samplerOverride: { ...input.samplerOverride } }
+            : {}),
+        ...(input.trimSheet
+            ? {
+                trimSheet: {
+                    ...input.trimSheet,
+                    offset: [...input.trimSheet.offset],
+                    scale: [...input.trimSheet.scale],
+                },
+            }
+            : {}),
+    };
+    const result = (0, helix_manifest_1.validateContinuumMaterialBinding)(binding);
+    if (!result.valid)
+        throw new TypeError(result.errors.join("; "));
+    return result.binding;
+}
+//# sourceMappingURL=binding.js.map

package/dist/sceneImport/materials/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../src/sceneImport/materials/binding.ts"],"names":[],"mappings":";;AAuBA,kEAoCC;AA3DD,mEAMwC;AAgBxC,kFAAkF;AAClF,SAAgB,2BAA2B,CACzC,KAAiC;IAEjC,MAAM,OAAO,GAA6B;QACxC,MAAM,EAAE,kDAAiC;QACzC,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE;QAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACjD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC;QAC3B,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC;QACzC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;QACvC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;QACnC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;QACvC,EAAE,EAAE;YACF,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;YACvB,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxD,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrD,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE,WAAW,IAAI,CAAC;YACvC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACzD;QACD,GAAG,CAAC,KAAK,CAAC,eAAe;YACvB,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,GAAG,KAAK,CAAC,eAAe,EAAE,EAAE;YACnD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC;gBACE,SAAS,EAAE;oBACT,GAAG,KAAK,CAAC,SAAS;oBAClB,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;oBACnC,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;iBAClC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,MAAM,GAAG,IAAA,iDAAgC,EAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/dist/sceneImport/materials/catalog.d.ts

@@ -0,0 +1,36 @@
+import type { ContinuumMaterialDefinition } from '@hypersoniclabs/helix-manifest';
+export type CanonicalMaterialFamily = 'plaster' | 'concrete' | 'wood' | 'metal' | 'glass' | 'brick' | 'stone' | 'tile' | 'fabric' | 'leather' | 'foliage';
+export type CanonicalMaterialCatalogEntry = {
+    id: string;
+    name: string;
+    family: CanonicalMaterialFamily;
+    tags: string[];
+    swatch: `#${string}`;
+    repeatPerMeter: number;
+    roughness: number;
+    metalness: number;
+    transmission?: number;
+    normalScale: number;
+    opacityMode: 'opaque' | 'mask' | 'blend';
+    surfaceModel: ContinuumMaterialDefinition['surfaceModel'];
+    requiredMaps: Array<'baseColor' | 'normal' | 'metallicRoughness' | 'occlusion'>;
+    provenance: {
+        kind: 'authored' | 'imported' | 'generated';
+        source: string;
+        sourceId: string;
+    };
+    legacy?: {
+        pack: 'helix-materials@0.2.3';
+        catalogId: string;
+        sourceProvider?: string;
+        sourceAssetId?: string;
+    };
+};
+/**
+ * Release-critical walking subset. This is metadata and provenance, not fake
+ * publication state: exact KTX2 object CIDs are supplied by the import recipe.
+ * U9 can pass the full 57-entry catalog through that same recipe.
+ */
+export declare const HELIX_OFFICIAL_MATERIAL_SUBSET: readonly CanonicalMaterialCatalogEntry[];
+/** Measured Pacifica legacy matches which are intentionally not a second family catalog. */
+export declare const HELIX_PACIFICA_MATERIAL_ADDITIONS: readonly CanonicalMaterialCatalogEntry[];

package/dist/sceneImport/materials/catalog.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELIX_PACIFICA_MATERIAL_ADDITIONS = exports.HELIX_OFFICIAL_MATERIAL_SUBSET = void 0;
+const imported = (entry) => {
+    const { sourceAssetId, ...material } = entry;
+    return {
+        ...material,
+        provenance: {
+            kind: 'imported',
+            source: 'helix-materials@0.2.3',
+            sourceId: sourceAssetId ?? material.id,
+        },
+        legacy: {
+            pack: 'helix-materials@0.2.3',
+            catalogId: material.id,
+            ...(sourceAssetId
+                ? { sourceProvider: 'ambientcg', sourceAssetId }
+                : {}),
+        },
+    };
+};
+/**
+ * Release-critical walking subset. This is metadata and provenance, not fake
+ * publication state: exact KTX2 object CIDs are supplied by the import recipe.
+ * U9 can pass the full 57-entry catalog through that same recipe.
+ */
+exports.HELIX_OFFICIAL_MATERIAL_SUBSET = [
+    {
+        id: 'smooth-plaster',
+        name: 'Smooth Plaster',
+        family: 'plaster',
+        tags: ['plaster', 'stucco', 'wall', 'ceiling', 'interior', 'exterior', 'smooth'],
+        swatch: '#dedbd3',
+        repeatPerMeter: 0.25,
+        roughness: 0.82,
+        metalness: 0,
+        normalScale: 0.45,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        // Factor-only base color; U9 deliberately shares raw-concrete normal/ORM
+        // objects at a low normal scale instead of inventing a plaster texture.
+        requiredMaps: ['normal', 'metallicRoughness', 'occlusion'],
+        provenance: {
+            kind: 'authored',
+            source: 'HELIX canonical material library',
+            sourceId: 'smooth-plaster',
+        },
+    },
+    imported({
+        id: 'raw-concrete',
+        name: 'Raw Concrete',
+        family: 'concrete',
+        tags: ['concrete', 'cement', 'wall', 'floor', 'industrial', 'rough', 'exterior'],
+        swatch: '#a29887',
+        repeatPerMeter: 0.1,
+        roughness: 0.75,
+        metalness: 0.02,
+        normalScale: 0.6,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Concrete048',
+    }),
+    imported({
+        id: 'light-oak',
+        name: 'Light Oak',
+        family: 'wood',
+        tags: ['wood', 'oak', 'floor', 'plank', 'warm', 'interior', 'light'],
+        swatch: '#cc9268',
+        repeatPerMeter: 0.12,
+        roughness: 0.7,
+        metalness: 0,
+        normalScale: 0.8,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'WoodFloor071',
+    }),
+    imported({
+        id: 'painted-metal',
+        name: 'Painted Metal',
+        family: 'metal',
+        tags: ['metal', 'painted', 'steel', 'industrial', 'appliance', 'clean'],
+        swatch: '#3f3f3f',
+        repeatPerMeter: 0.2,
+        roughness: 0.4,
+        metalness: 0.7,
+        normalScale: 0.4,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Metal046B',
+    }),
+    imported({
+        id: 'clear-glass',
+        name: 'Clear Glass',
+        family: 'glass',
+        tags: ['glass', 'window', 'transparent', 'clear', 'see-through'],
+        swatch: '#dfeef2',
+        repeatPerMeter: 0.1,
+        roughness: 0.02,
+        metalness: 0,
+        transmission: 0.95,
+        normalScale: 0,
+        opacityMode: 'blend',
+        surfaceModel: 'transparent-dielectric',
+        requiredMaps: [],
+    }),
+    imported({
+        id: 'weathered-brick',
+        name: 'Weathered Brick',
+        family: 'brick',
+        tags: ['brick', 'wall', 'masonry', 'rough', 'old', 'aged', 'weathered'],
+        swatch: '#a8705d',
+        repeatPerMeter: 0.14,
+        roughness: 0.88,
+        metalness: 0,
+        normalScale: 1.2,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Bricks051',
+    }),
+    imported({
+        id: 'granite',
+        name: 'Granite',
+        family: 'stone',
+        tags: ['stone', 'granite', 'floor', 'counter', 'polished', 'speckled', 'luxury'],
+        swatch: '#a1989a',
+        repeatPerMeter: 0.1,
+        roughness: 0.35,
+        metalness: 0.05,
+        normalScale: 0.4,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Granite005B',
+    }),
+    imported({
+        id: 'ceramic-tile',
+        name: 'Ceramic Tile',
+        family: 'tile',
+        tags: ['tile', 'ceramic', 'floor', 'bathroom', 'kitchen', 'grout', 'clean'],
+        swatch: '#ece8dd',
+        repeatPerMeter: 0.18,
+        roughness: 0.4,
+        metalness: 0,
+        normalScale: 0.7,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Tiles009',
+    }),
+    imported({
+        id: 'cloth-fabric',
+        name: 'Cloth',
+        family: 'fabric',
+        tags: ['fabric', 'cloth', 'upholstery', 'soft', 'interior', 'textile'],
+        swatch: '#8d8883',
+        repeatPerMeter: 0.3,
+        roughness: 0.9,
+        metalness: 0,
+        normalScale: 0.5,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Fabric061',
+    }),
+    imported({
+        id: 'leather',
+        name: 'Leather',
+        family: 'leather',
+        tags: ['leather', 'upholstery', 'furniture', 'interior', 'soft'],
+        swatch: '#553d35',
+        repeatPerMeter: 0.3,
+        roughness: 0.55,
+        metalness: 0,
+        normalScale: 0.4,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Leather028',
+    }),
+    imported({
+        id: 'grass',
+        name: 'Grass',
+        family: 'foliage',
+        tags: ['grass', 'foliage', 'ground', 'lawn', 'green', 'nature', 'outdoor'],
+        swatch: '#607f28',
+        repeatPerMeter: 0.12,
+        roughness: 0.95,
+        metalness: 0,
+        normalScale: 0.9,
+        opacityMode: 'mask',
+        surfaceModel: 'foliage',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Grass007',
+    }),
+];
+/** Measured Pacifica legacy matches which are intentionally not a second family catalog. */
+exports.HELIX_PACIFICA_MATERIAL_ADDITIONS = [
+    imported({
+        id: 'polished-concrete',
+        name: 'Polished Concrete',
+        family: 'concrete',
+        tags: ['concrete', 'polished', 'floor', 'mall', 'interior', 'smooth'],
+        swatch: '#aaa69d',
+        repeatPerMeter: 0.1,
+        roughness: 0.28,
+        metalness: 0.03,
+        normalScale: 0.35,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Concrete034',
+    }),
+    imported({
+        id: 'white-marble',
+        name: 'White Marble',
+        family: 'stone',
+        tags: ['marble', 'white', 'stone', 'floor', 'wall', 'mall', 'polished'],
+        swatch: '#dedbd2',
+        repeatPerMeter: 0.1,
+        roughness: 0.22,
+        metalness: 0.02,
+        normalScale: 0.35,
+        opacityMode: 'opaque',
+        surfaceModel: 'opaque',
+        requiredMaps: ['baseColor', 'normal', 'metallicRoughness', 'occlusion'],
+        sourceAssetId: 'Marble012',
+    }),
+];
+//# sourceMappingURL=catalog.js.map

package/dist/sceneImport/materials/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/sceneImport/materials/catalog.ts"],"names":[],"mappings":";;;AA0CA,MAAM,QAAQ,GAAG,CACf,KAEC,EAC8B,EAAE;IACjC,MAAM,EAAE,aAAa,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC7C,OAAO;QACL,GAAG,QAAQ;QACX,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,uBAAuB;YAC/B,QAAQ,EAAE,aAAa,IAAI,QAAQ,CAAC,EAAE;SACvC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,uBAAuB;YAC7B,SAAS,EAAE,QAAQ,CAAC,EAAE;YACtB,GAAG,CAAC,aAAa;gBACf,CAAC,CAAC,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE;gBAChD,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACU,QAAA,8BAA8B,GAA6C;IACtF;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC;QAChF,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,yEAAyE;QACzE,wEAAwE;QACxE,YAAY,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QAC1D,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,kCAAkC;YAC1C,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,QAAQ,CAAC;QACP,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC;QAChF,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,aAAa;KAC7B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC;QACpE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,cAAc;KAC9B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC;QACvE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,WAAW;KAC3B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,CAAC;QAChE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,CAAC;QACZ,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,OAAO;QACpB,YAAY,EAAE,wBAAwB;QACtC,YAAY,EAAE,EAAE;KACjB,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC;QACvE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,WAAW;KAC3B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC;QAChF,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,aAAa;KAC7B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;QAC3E,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,UAAU;KAC1B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC;QACtE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,WAAW;KAC3B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC;QAChE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,YAAY;KAC5B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;QAC1E,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,UAAU;KAC1B,CAAC;CACM,CAAC;AAEX,4FAA4F;AAC/E,QAAA,iCAAiC,GAA6C;IACzF,QAAQ,CAAC;QACP,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC;QACrE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,aAAa;KAC7B,CAAC;IACF,QAAQ,CAAC;QACP,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;QACvE,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACvE,aAAa,EAAE,WAAW;KAC3B,CAAC;CACM,CAAC"}

package/dist/sceneImport/materials/index.d.ts

@@ -0,0 +1,4 @@
+export * from './binding';
+export * from './catalog';
+export * from './matcher';
+export * from './recipe';

package/dist/sceneImport/materials/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./binding"), exports);
+__exportStar(require("./catalog"), exports);
+__exportStar(require("./matcher"), exports);
+__exportStar(require("./recipe"), exports);
+//# sourceMappingURL=index.js.map

package/dist/sceneImport/materials/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sceneImport/materials/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,2CAAyB"}

package/dist/sceneImport/materials/matcher.d.ts

@@ -0,0 +1,33 @@
+import type { CanonicalMaterialCatalogEntry } from './catalog';
+export declare const MATERIAL_AUTO_REPLACE_CONFIDENCE = 0.78;
+export declare const MATERIAL_REVIEW_CONFIDENCE = 0.58;
+export type SourceMaterialDescription = {
+    semanticName: string;
+    baseColor?: `#${string}`;
+    roughness?: number;
+    metalness?: number;
+    opacityMode?: 'opaque' | 'mask' | 'blend';
+    maps: Array<'baseColor' | 'normal' | 'metallicRoughness' | 'occlusion' | 'emissive'>;
+    shaderGraph: 'portable-pbr' | 'procedural' | 'layered' | 'unknown';
+};
+export type MaterialMatchAlternative = {
+    materialId: string;
+    score: number;
+    signals: {
+        semantic: number;
+        color: number;
+        roughness: number;
+        metalness: number;
+        opacity: number;
+        maps: number;
+    };
+};
+export type MaterialMatch = {
+    action: 'use-canonical' | 'review' | 'preserve-source';
+    confidence: number;
+    material?: CanonicalMaterialCatalogEntry;
+    alternatives: MaterialMatchAlternative[];
+    preserveSourceRendition: boolean;
+    reason: string;
+};
+export declare function matchCanonicalMaterial(source: SourceMaterialDescription, catalog: readonly CanonicalMaterialCatalogEntry[]): MaterialMatch;

package/dist/sceneImport/materials/matcher.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MATERIAL_REVIEW_CONFIDENCE = exports.MATERIAL_AUTO_REPLACE_CONFIDENCE = void 0;
+exports.matchCanonicalMaterial = matchCanonicalMaterial;
+exports.MATERIAL_AUTO_REPLACE_CONFIDENCE = 0.78;
+exports.MATERIAL_REVIEW_CONFIDENCE = 0.58;
+const TOKEN_ALIASES = {
+    cement: 'concrete',
+    stucco: 'plaster',
+    pane: 'glass',
+    window: 'glass',
+    steel: 'metal',
+    aluminium: 'metal',
+    aluminum: 'metal',
+    textile: 'fabric',
+    lawn: 'grass',
+    leaf: 'foliage',
+    leaves: 'foliage',
+};
+function tokens(value) {
+    return new Set(value
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean)
+        .flatMap((token) => [token, TOKEN_ALIASES[token]].filter((item) => Boolean(item))));
+}
+function semanticScore(source, candidate) {
+    const sourceTokens = tokens(source.semanticName);
+    const candidateTokens = tokens([candidate.id, candidate.name, candidate.family, ...candidate.tags].join(' '));
+    const overlap = [...sourceTokens].filter((token) => candidateTokens.has(token)).length;
+    if (overlap === 0)
+        return 0;
+    const coverage = overlap / Math.max(1, sourceTokens.size);
+    const exactFamily = sourceTokens.has(candidate.family) ? 0.2 : 0;
+    return Math.min(1, coverage * 0.8 + exactFamily);
+}
+function parseHex(value) {
+    const match = /^#([0-9a-f]{6})$/i.exec(value);
+    if (!match)
+        return undefined;
+    const number = Number.parseInt(match[1], 16);
+    return [(number >> 16) / 255, ((number >> 8) & 255) / 255, (number & 255) / 255];
+}
+function colorScore(source, candidate) {
+    if (!source)
+        return 0.5;
+    const a = parseHex(source);
+    const b = parseHex(candidate);
+    if (!a || !b)
+        return 0;
+    const distance = Math.sqrt(a.reduce((sum, channel, index) => sum + (channel - b[index]) ** 2, 0));
+    return Math.max(0, 1 - distance / Math.sqrt(3));
+}
+function scalarScore(source, candidate) {
+    return source === undefined ? 0.5 : Math.max(0, 1 - Math.abs(source - candidate));
+}
+function mapScore(source, candidate) {
+    if (candidate.requiredMaps.length === 0)
+        return source.maps.length === 0 ? 1 : 0.5;
+    const available = new Set(source.maps);
+    return candidate.requiredMaps.filter((role) => available.has(role)).length / candidate.requiredMaps.length;
+}
+function score(source, candidate) {
+    const signals = {
+        semantic: semanticScore(source, candidate),
+        color: colorScore(source.baseColor, candidate.swatch),
+        roughness: scalarScore(source.roughness, candidate.roughness),
+        metalness: scalarScore(source.metalness, candidate.metalness),
+        opacity: source.opacityMode === undefined ? 0.5 : source.opacityMode === candidate.opacityMode ? 1 : 0,
+        maps: mapScore(source, candidate),
+    };
+    const weighted = signals.semantic * 0.42 +
+        signals.color * 0.18 +
+        signals.roughness * 0.12 +
+        signals.metalness * 0.12 +
+        signals.opacity * 0.08 +
+        signals.maps * 0.08;
+    return { materialId: candidate.id, score: Number(weighted.toFixed(6)), signals };
+}
+function matchCanonicalMaterial(source, catalog) {
+    if (catalog.length === 0)
+        throw new Error('material catalog cannot be empty');
+    const alternatives = catalog
+        .map((candidate) => score(source, candidate))
+        .sort((a, b) => b.score - a.score || a.materialId.localeCompare(b.materialId))
+        .slice(0, 3);
+    const best = alternatives[0];
+    const material = catalog.find((candidate) => candidate.id === best.materialId);
+    if (source.shaderGraph !== 'portable-pbr') {
+        return {
+            action: 'preserve-source',
+            confidence: best.score,
+            material,
+            alternatives,
+            preserveSourceRendition: true,
+            reason: `Source shader graph is ${source.shaderGraph}; portable PBR equivalence is not proven.`,
+        };
+    }
+    if (best.score >= exports.MATERIAL_AUTO_REPLACE_CONFIDENCE) {
+        return {
+            action: 'use-canonical',
+            confidence: best.score,
+            material,
+            alternatives,
+            preserveSourceRendition: true,
+            reason: 'Portable PBR source exceeded the automatic proxy threshold; its source rendition remains available until exact CID/provenance equivalence or explicit replacement is proven.',
+        };
+    }
+    if (best.score >= exports.MATERIAL_REVIEW_CONFIDENCE) {
+        return {
+            action: 'review',
+            confidence: best.score,
+            material,
+            alternatives,
+            preserveSourceRendition: true,
+            reason: 'Candidate is plausible but remains source-backed until explicit review.',
+        };
+    }
+    return {
+        action: 'preserve-source',
+        confidence: best.score,
+        alternatives,
+        preserveSourceRendition: true,
+        reason: 'No canonical material exceeded the minimum review threshold.',
+    };
+}
+//# sourceMappingURL=matcher.js.map

package/dist/sceneImport/materials/matcher.js.map

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

package/dist/sceneImport/materials/recipe.d.ts

@@ -0,0 +1,30 @@
+import { type ContinuumMaterialDefinition, type ContinuumMaterialTextureSet, type ContinuumMaterialVariant, type ContinuumPackage, type ContinuumPackageVersion } from '@hypersoniclabs/helix-manifest';
+import type { CanonicalMaterialCatalogEntry } from './catalog';
+export type CanonicalMaterialArtifactInput = {
+    /** Optional archival/source maps; runtime variants below must be KTX2. */
+    sourceTextures?: ContinuumMaterialTextureSet;
+    variants: ContinuumMaterialVariant[];
+    sourceFallback?: ContinuumMaterialDefinition['sourceFallback'];
+};
+export type MaterialPackageRecipeInput = {
+    entry: CanonicalMaterialCatalogEntry;
+    /** Existing registry identity during migration; otherwise derived from the canonical catalog id. */
+    packageId?: string;
+    version: string;
+    artifacts: CanonicalMaterialArtifactInput;
+};
+export type MaterialPackageRecipe = {
+    package: ContinuumPackage;
+    definition: ContinuumMaterialDefinition;
+    packageVersion: ContinuumPackageVersion;
+    definitionBytes: Uint8Array;
+    definitionCid: string;
+    packageVersionCid: string;
+};
+/**
+ * Deterministic publication intent. It emits no URLs and performs no upload;
+ * the backend seals the exact objects and Package Version later.
+ */
+export declare function buildMaterialPackageRecipe(input: MaterialPackageRecipeInput): MaterialPackageRecipe;
+/** Same normalized input always produces the same ordered package/CID set. */
+export declare function buildMaterialBulkRecipe(inputs: readonly MaterialPackageRecipeInput[]): MaterialPackageRecipe[];