@3driseai/3drise-core 1.0.1

package/dist/services/CubeCameraManager.d.ts

@@ -0,0 +1,23 @@
+import * as THREE from 'three';
+export declare class CubeCameraManager {
+    private static instance;
+    private cubeCamera;
+    private scene;
+    private renderer;
+    private isUpdating;
+    private onUpdate;
+    constructor();
+    static getInstance(): CubeCameraManager;
+    static resetInstance(): void;
+    attach(scene: THREE.Scene, renderer: THREE.WebGLRenderer): void;
+    detach(): void;
+    setOnUpdate(callback: ((texture: THREE.Texture) => void) | null): void;
+    initCubeCamera(resolution?: number, position?: THREE.Vector3): THREE.CubeCamera | null;
+    updateEnvironment(): THREE.Texture | null;
+    clear(): void;
+    dispose(): void;
+    getCubeCamera(): THREE.CubeCamera | null;
+    hasCubeCamera(): boolean;
+}
+export declare const cubeCameraManager: CubeCameraManager;
+//# sourceMappingURL=CubeCameraManager.d.ts.map

package/dist/services/CubeCameraManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCameraManager.d.ts","sourceRoot":"","sources":["../../src/services/CubeCameraManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAQ;IAC/B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAQ;;IAExB,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAMvC,MAAM,CAAC,aAAa,IAAI,IAAI;IAG5B,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,aAAa,GAAG,IAAI;IAI/D,MAAM,IAAI,IAAI;IAKd,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAGtE,cAAc,CAAC,UAAU,GAAE,MAAY,EAAE,QAAQ,GAAE,KAAK,CAAC,OAAqC,GAAG,KAAK,CAAC,UAAU,GAAG,IAAI;IAQxH,iBAAiB,IAAI,KAAK,CAAC,OAAO,GAAG,IAAI;IA0BzC,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAMf,aAAa,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI;IAGxC,aAAa,IAAI,OAAO;CAG3B;AACD,eAAO,MAAM,iBAAiB,EAAE,iBAAmD,CAAC"}

package/dist/services/CubeCameraManager.js

@@ -0,0 +1,84 @@
+import * as THREE from 'three';
+import { createCubeCamera, updateCubeCamera, disposeCubeCamera, setSceneEnvironment, clearSceneEnvironment, } from '../utils/environmentUtils.js';
+import { updateSceneMaterials } from '../utils/materialUtils.js';
+export class CubeCameraManager {
+    static instance = null;
+    cubeCamera = null;
+    scene = null;
+    renderer = null;
+    isUpdating = false;
+    onUpdate = null;
+    constructor() { }
+    static getInstance() {
+        if (!CubeCameraManager.instance) {
+            CubeCameraManager.instance = new CubeCameraManager();
+        }
+        return CubeCameraManager.instance;
+    }
+    static resetInstance() {
+        CubeCameraManager.instance = null;
+    }
+    attach(scene, renderer) {
+        this.scene = scene;
+        this.renderer = renderer;
+    }
+    detach() {
+        this.dispose();
+        this.scene = null;
+        this.renderer = null;
+    }
+    setOnUpdate(callback) {
+        this.onUpdate = callback;
+    }
+    initCubeCamera(resolution = 512, position = new THREE.Vector3(0, 50, 0)) {
+        if (!this.scene)
+            return null;
+        if (this.cubeCamera)
+            disposeCubeCamera(this.cubeCamera, this.scene);
+        this.cubeCamera = createCubeCamera(this.scene, resolution, position);
+        return this.cubeCamera;
+    }
+    updateEnvironment() {
+        // console.log('Updating cube camera environment map...', {
+        //   hasCubeCamera: !!this.cubeCamera,
+        //   hasScene: !!this.scene,
+        //   hasRenderer: !!this.renderer,
+        //   isUpdating: this.isUpdating,
+        // });
+        if (!this.scene || !this.renderer)
+            return null;
+        if (!this.cubeCamera) {
+            this.initCubeCamera();
+        }
+        if (this.isUpdating)
+            return null;
+        try {
+            this.isUpdating = true;
+            const texture = updateCubeCamera(this.cubeCamera, this.renderer, this.scene);
+            setSceneEnvironment(this.scene, texture);
+            updateSceneMaterials(this.scene, texture);
+            this.onUpdate?.(texture);
+            return texture;
+        }
+        finally {
+            this.isUpdating = false;
+        }
+    }
+    clear() {
+        if (this.scene)
+            clearSceneEnvironment(this.scene);
+    }
+    dispose() {
+        if (this.cubeCamera && this.scene) {
+            disposeCubeCamera(this.cubeCamera, this.scene);
+        }
+        this.cubeCamera = null;
+    }
+    getCubeCamera() {
+        return this.cubeCamera;
+    }
+    hasCubeCamera() {
+        return this.cubeCamera !== null;
+    }
+}
+export const cubeCameraManager = CubeCameraManager.getInstance();

package/dist/services/FontManager.d.ts

@@ -0,0 +1,32 @@
+export interface FontInfo {
+    name: string;
+    displayName: string;
+    googleFont: string;
+    threejsFont?: string;
+    category: 'sans-serif' | 'serif' | 'display' | 'monospace';
+    isLoaded: boolean;
+}
+declare class FontManager {
+    private static instance;
+    private fonts;
+    private loadingPromises;
+    private readonly CURATED_FONTS;
+    constructor();
+    static getInstance(): FontManager;
+    getAllFonts(): FontInfo[];
+    getFont(name: string): FontInfo | undefined;
+    getBitmapFont(name: string): string | undefined;
+    get3DFont(name: string): string | undefined;
+    getFontsByCategory(category: FontInfo['category']): FontInfo[];
+    isFontLoaded(name: string): boolean;
+    getDefaultFont(): FontInfo;
+    loadFont(name: string): Promise<void>;
+    getFontOptions(): Array<{
+        value: string;
+        label: string;
+        category: string;
+    }>;
+}
+export declare const fontManager: FontManager;
+export default FontManager;
+//# sourceMappingURL=FontManager.d.ts.map

package/dist/services/FontManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontManager.d.ts","sourceRoot":"","sources":["../../src/services/FontManager.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3D,QAAQ,EAAE,OAAO,CAAC;CACrB;AAmBD,cAAM,WAAW;IACb,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAQ;IAC/B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAgB5B;;IAMF,MAAM,CAAC,WAAW,IAAI,WAAW;IAKjC,WAAW,IAAI,QAAQ,EAAE;IACzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAC3C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAC/C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAC3C,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,QAAQ,EAAE;IAC9D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IACnC,cAAc,IAAI,QAAQ;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,cAAc,IAAI,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CAGb;AACD,eAAO,MAAM,WAAW,EAAE,WAAuC,CAAC;AAClE,eAAe,WAAW,CAAC"}

package/dist/services/FontManager.js

@@ -0,0 +1,76 @@
+const loadGoogleFont = (fontUrl) => {
+    return new Promise((resolve, reject) => {
+        if (typeof document === 'undefined') {
+            resolve();
+            return;
+        }
+        if (document.querySelector(`link[href="${fontUrl}"]`)) {
+            resolve();
+            return;
+        }
+        const link = document.createElement('link');
+        link.rel = 'stylesheet';
+        link.href = fontUrl;
+        link.onload = () => resolve();
+        link.onerror = () => reject(new Error(`Failed to load font: ${fontUrl}`));
+        document.head.appendChild(link);
+    });
+};
+class FontManager {
+    static instance = null;
+    fonts = new Map();
+    loadingPromises = new Map();
+    CURATED_FONTS = [
+        { name: 'roboto', displayName: 'Roboto', googleFont: 'https://fonts.gstatic.com/s/roboto/v30/KFOmCnqEu92Fr1Me5WZLCzYlKw.ttf', threejsFont: 'https://threejs.org/examples/fonts/droid/droid_sans_regular.typeface.json', category: 'sans-serif' },
+        { name: 'opensans', displayName: 'Open Sans', googleFont: 'https://fonts.gstatic.com/s/opensans/v34/memSYaGs126MiZpBA-UvWbX2vVnXBbObj2OVZyOOSr4dVJWUgsjZ0C4nY1M2xLER.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'sans-serif' },
+        { name: 'lato', displayName: 'Lato', googleFont: 'https://fonts.gstatic.com/s/lato/v24/S6uyw4BMUTPHvxk6XweuBCY.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'sans-serif' },
+        { name: 'poppins', displayName: 'Poppins', googleFont: 'https://fonts.gstatic.com/s/poppins/v20/pxiEyp8kv8JHgFVrFJDUc1NECPY.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'sans-serif' },
+        { name: 'merriweather', displayName: 'Merriweather', googleFont: 'https://fonts.gstatic.com/s/merriweather/v30/u-440qyriQwlOrhSvowK_l5OeyxNV-bnrw.ttf', threejsFont: 'https://threejs.org/examples/fonts/droid/droid_serif_regular.typeface.json', category: 'serif' },
+        { name: 'playfair', displayName: 'Playfair Display', googleFont: 'https://fonts.gstatic.com/s/playfairdisplay/v30/nuFvD-vYSZviVYUb_rj3ij__anPXJzDwcbmjWBN2PKdFvUDQZNLo_U2r.ttf', threejsFont: 'https://threejs.org/examples/fonts/droid/droid_serif_bold.typeface.json', category: 'serif' },
+        { name: 'bebas', displayName: 'Bebas Neue', googleFont: 'https://fonts.gstatic.com/s/bebasneue/v10/JTUSjIg69CK48gW7PXooxW5rygbi49c.ttf', threejsFont: 'https://threejs.org/examples/fonts/gentilis_bold.typeface.json', category: 'display' },
+        { name: 'lobster', displayName: 'Lobster', googleFont: 'https://fonts.gstatic.com/s/lobster/v30/neILzCirqoswsqX9_oWsMqEzSJQ.ttf', threejsFont: 'https://threejs.org/examples/fonts/gentilis_regular.typeface.json', category: 'display' },
+        { name: 'robotomono', displayName: 'Roboto Mono', googleFont: 'https://fonts.gstatic.com/s/robotomono/v23/L0xuDF4xlVMF-BfR8bXMIhJHg45mwgGEFl0_3vuPQ--5Ip2sSQ.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'monospace' },
+        { name: 'jetbrainsmono', displayName: 'JetBrains Mono', googleFont: 'https://fonts.gstatic.com/s/jetbrainsmono/v18/tDbY2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yK1jPVmUsaaDhw.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'monospace' },
+        { name: 'courierprime', displayName: 'Courier Prime', googleFont: 'https://fonts.gstatic.com/s/courierprime/v9/u-450q2lgwslOqpF_6gQ8kELWwZjW-_-tvg.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'monospace' },
+        { name: 'ubuntumono', displayName: 'Ubuntu Mono', googleFont: 'https://fonts.gstatic.com/s/ubuntumono/v17/KFOjCneDtsqEr0keqCMhbBc9AMX6lJBP.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'monospace' },
+        { name: 'ptmono', displayName: 'PT Mono', googleFont: 'https://fonts.gstatic.com/s/ptmono/v13/9oRONYoBnWILk-9ArCg5MtPyAcg.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'monospace' },
+        { name: 'cousine', displayName: 'Cousine', googleFont: 'https://fonts.gstatic.com/s/cousine/v27/d6lIkaiiRdih4SpPzSMlzTbtz9k.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'monospace' },
+        { name: 'novamono', displayName: 'Nova Mono', googleFont: 'https://fonts.gstatic.com/s/novamono/v18/Cn-0JtiGWQ5Ajb--MRKfYGxYrdM9Sg.ttf', threejsFont: 'https://threejs.org/examples/fonts/helvetiker_regular.typeface.json', category: 'monospace' },
+    ];
+    constructor() {
+        this.CURATED_FONTS.forEach(fontData => {
+            this.fonts.set(fontData.name, { ...fontData, isLoaded: false });
+        });
+    }
+    static getInstance() {
+        if (!FontManager.instance)
+            FontManager.instance = new FontManager();
+        return FontManager.instance;
+    }
+    getAllFonts() { return Array.from(this.fonts.values()); }
+    getFont(name) { return this.fonts.get(name); }
+    getBitmapFont(name) { return this.fonts.get(name)?.googleFont; }
+    get3DFont(name) { return this.fonts.get(name)?.threejsFont; }
+    getFontsByCategory(category) { return Array.from(this.fonts.values()).filter(f => f.category === category); }
+    isFontLoaded(name) { return this.fonts.get(name)?.isLoaded || false; }
+    getDefaultFont() { return this.fonts.get('roboto'); }
+    async loadFont(name) {
+        const font = this.fonts.get(name);
+        if (!font)
+            throw new Error(`Font not found: ${name}`);
+        if (font.isLoaded)
+            return;
+        if (this.loadingPromises.has(name))
+            return this.loadingPromises.get(name);
+        const promise = loadGoogleFont(font.googleFont)
+            .then(() => { font.isLoaded = true; this.loadingPromises.delete(name); })
+            .catch(error => { this.loadingPromises.delete(name); throw error; });
+        this.loadingPromises.set(name, promise);
+        return promise;
+    }
+    getFontOptions() {
+        return Array.from(this.fonts.values()).map(f => ({ value: f.name, label: f.displayName, category: f.category }));
+    }
+}
+export const fontManager = FontManager.getInstance();
+export default FontManager;

package/dist/services/MaterialCompiler.d.ts

@@ -0,0 +1,30 @@
+import type { UniformDefinition } from "../types/types";
+import type { Asset } from "../types/users";
+export interface MaterialAsset extends Asset {
+    uniforms: UniformDefinition[];
+    vertex: string;
+    fragment: string;
+}
+/**
+ * Check if an asset is a compilable material asset
+ */
+export declare function isMaterialAsset(asset: Asset): asset is MaterialAsset;
+/**
+ * Compile a single material asset and register it with MaterialRegistry
+ * Returns true if compilation was successful, false if skipped or failed
+ */
+export declare function compileMaterialAsset(asset: MaterialAsset): boolean;
+/**
+ * Compile all material assets from an array of assets
+ * Returns the count of newly compiled materials
+ */
+export declare function compileAllMaterialAssets(assets: Asset[]): number;
+/**
+ * Check if a material has already been compiled
+ */
+export declare function isMaterialCompiled(assetId: string): boolean;
+/**
+ * Clear compiled materials cache (useful for testing or reloading)
+ */
+export declare function clearCompiledMaterials(): void;
+//# sourceMappingURL=MaterialCompiler.d.ts.map

package/dist/services/MaterialCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialCompiler.d.ts","sourceRoot":"","sources":["../../src/services/MaterialCompiler.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,MAAM,WAAW,aAAc,SAAQ,KAAK;IACxC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,aAAa,CAKpE;AACD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAmClE;AACD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAWhE;AACD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AACD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/services/MaterialCompiler.js

@@ -0,0 +1,91 @@
+/**
+ * MaterialCompiler - Deferred material shader compilation
+ *
+ * This service handles compiling material assets' shaders and registering them
+ * with the MaterialRegistry. It's designed to be called lazily (e.g., when
+ * entering Studio) rather than on user data fetch.
+ */
+import { createCustomShaderMaterial } from "../shaders/CustomShaderMaterial.js";
+import { MaterialRegistryAPI } from "./MaterialRegistry.js";
+import { uniformConverter } from "./UniformConverter.js";
+import { createUniformsText } from "../utils/utils.js";
+// Track which materials have been compiled to avoid recompilation
+const compiledMaterials = new Set();
+``;
+/**
+ * Check if an asset is a compilable material asset
+ */
+export function isMaterialAsset(asset) {
+    return (asset.type === 'material' &&
+        Array.isArray(asset.uniforms) &&
+        typeof asset.vertex === 'string' &&
+        typeof asset.fragment === 'string');
+}
+/**
+ * Compile a single material asset and register it with MaterialRegistry
+ * Returns true if compilation was successful, false if skipped or failed
+ */
+export function compileMaterialAsset(asset) {
+    // Skip if already compiled
+    if (compiledMaterials.has(asset.id)) {
+        return false;
+    }
+    try {
+        const compiledShaders = {
+            vertex: createUniformsText(asset.uniforms) + '\n' + asset.vertex,
+            fragment: createUniformsText(asset.uniforms) + '\n' + asset.fragment
+        };
+        const settings = {};
+        asset.uniforms.forEach((uniform) => {
+            settings[uniform.name] = uniform.defaultValue;
+        });
+        const uniforms = uniformConverter.convertToUniforms(settings);
+        const material = createCustomShaderMaterial({
+            uniforms,
+            vertexShader: compiledShaders.vertex,
+            fragmentShader: compiledShaders.fragment
+        });
+        const variant = {
+            name: asset.name,
+            description: asset.description || '',
+            materialClass: material,
+            defaultSettings: settings,
+        };
+        MaterialRegistryAPI.addCustomMaterial(variant);
+        compiledMaterials.add(asset.id);
+        console.log(`[MaterialCompiler] Compiled material: ${asset.name}`);
+        return true;
+    }
+    catch (error) {
+        console.error(`[MaterialCompiler] Failed to compile material ${asset.name}:`, error);
+        return false;
+    }
+}
+/**
+ * Compile all material assets from an array of assets
+ * Returns the count of newly compiled materials
+ */
+export function compileAllMaterialAssets(assets) {
+    let compiledCount = 0;
+    for (const asset of assets) {
+        if (isMaterialAsset(asset)) {
+            if (compileMaterialAsset(asset)) {
+                compiledCount++;
+            }
+        }
+    }
+    console.log(`[MaterialCompiler] Compiled ${compiledCount} new materials`);
+    return compiledCount;
+}
+/**
+ * Check if a material has already been compiled
+ */
+export function isMaterialCompiled(assetId) {
+    return compiledMaterials.has(assetId);
+}
+/**
+ * Clear compiled materials cache (useful for testing or reloading)
+ */
+export function clearCompiledMaterials() {
+    compiledMaterials.clear();
+}

package/dist/services/MaterialRegistry.d.ts

@@ -0,0 +1,85 @@
+import type { Material } from 'three';
+import type { UniformDefinition } from "../types/types";
+import { MaterialType } from "../types";
+export interface ShaderSource {
+    vertex: string;
+    fragment: string;
+    uniforms: UniformDefinition[];
+}
+export interface MaterialVariant {
+    name: string;
+    description: string;
+    materialClass: any;
+    defaultSettings?: Record<string, any>;
+    useCases?: string[];
+    textureProperties?: string[];
+    _shaderSource?: ShaderSource;
+}
+export interface MaterialDefinition {
+    name: string;
+    description: string;
+    defaultVariant: string;
+    useCases?: string[];
+    variants: Record<string, MaterialVariant>;
+}
+export interface UniformInfo {
+    value: any;
+    type: 'float' | 'vec2' | 'vec3' | 'color' | 'texture' | 'boolean' | 'int';
+    min?: number;
+    max?: number;
+    step?: number;
+}
+export interface MaterialInstance {
+    material: Material;
+    settings: Record<string, any>;
+    uniforms: Record<string, UniformInfo>;
+    type: MaterialType;
+    variant: string;
+}
+declare const MaterialRegistry: Record<MaterialType, MaterialDefinition>;
+export declare const MaterialRegistryAPI: {
+    getTypes(): string[];
+    getVariants(type: any): any[];
+    getMaterialByMaterialClass(materialClass: any): any;
+    getTypeDefinition(type: any): any;
+    getVariantDefinition(variant: any): any;
+    getTypeFromVariantName(variantName: any): string;
+    /**
+     * Get texture properties for a material variant from the registry definition.
+     * Returns the explicitly defined textureProperties array, or falls back to
+     * heuristic detection from defaultSettings keys containing 'map' or 'texture'.
+     */
+    getTextureProperties(variant: any): any;
+    /**
+     * Get available color properties for a material variant
+     * Returns property paths like ['color'], ['color', 'specular', 'emissive'], or ['uniforms.uColor']
+     */
+    getColorProperties(variant: any): any[];
+    createMaterial(variant: any): {
+        material: any;
+        uniforms: {};
+        settings: any;
+        type: any;
+        variant: any;
+    };
+    updateUniforms(materialInstance: any, newUniforms: any): void;
+    applySettings(material: any, settings: any): void;
+    releaseMaterial(materialInstance: any): void;
+    addCustomMaterial(variant: any): void;
+    /**
+     * Register a user-created shader asset as a variant under the 'shaders' type.
+     * If a variant with the same name already exists, it will be updated.
+     */
+    registerUserShader(asset: any): void;
+    /**
+     * Unregister a user-created shader variant by name.
+     */
+    unregisterUserShader(name: any): void;
+    /**
+     * Get all registered user shader variant names.
+     */
+    getUserShaderVariants(): string[];
+};
+export { MaterialRegistry };
+export default MaterialRegistryAPI;
+//# sourceMappingURL=MaterialRegistry.d.ts.map

package/dist/services/MaterialRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialRegistry.d.ts","sourceRoot":"","sources":["../../src/services/MaterialRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAKtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,GAAG,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,GAAG,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB;AAMD,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAa,CAAC;AAkG7E,eAAO,MAAM,mBAAmB;;;;;;;IAoD5B;;;;OAIG;;IAuBH;;;OAGG;;;;;;;;;;;;;IAmHH;;;OAGG;;IA4BH;;OAEG;;IAYH;;OAEG;;CAIN,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,eAAe,mBAAmB,CAAC"}