@aura3d/engine 1.0.0

package/dist/assets/AssetManager.js

@@ -0,0 +1,161 @@
+import { AssetCache } from "./AssetCache.js";
+import { AssetDependencyGraph } from "./AssetDependencyGraph.js";
+import { AssetHandle } from "./AssetHandle.js";
+import { AssetLoadError } from "./AssetLoader.js";
+import { AssetRegistry } from "./AssetRegistry.js";
+import { LoadContext } from "./LoadContext.js";
+export class AssetManager {
+    registry = new AssetRegistry();
+    cache = new AssetCache();
+    dependencies = new AssetDependencyGraph();
+    baseUrl;
+    defaultRetries;
+    defaultRetryDelayMs;
+    nextId = 1;
+    constructor(options = {}) {
+        this.baseUrl = options.baseUrl ?? "";
+        this.defaultRetries = Math.max(0, Math.trunc(options.retries ?? 0));
+        this.defaultRetryDelayMs = Math.max(0, options.retryDelayMs ?? 0);
+    }
+    register(loader) {
+        this.registry.register(loader);
+    }
+    async load(url, options = {}) {
+        const context = new LoadContext({
+            baseUrl: this.baseUrl,
+            signal: options.signal,
+            dependencyChain: options.dependencyChain,
+            manager: this
+        });
+        const resolvedUrl = context.resolve(url);
+        context.throwIfAborted(resolvedUrl);
+        const key = `${options.type ?? "auto"}:${resolvedUrl}`;
+        const cached = this.cache.get(key);
+        if (cached) {
+            return cached.retain();
+        }
+        const inFlight = this.cache.getInFlight(key);
+        if (inFlight) {
+            const handle = await this.awaitInFlight(inFlight, context, resolvedUrl);
+            return handle.retain();
+        }
+        const request = { url: resolvedUrl, type: options.type, signal: options.signal, onProgress: options.onProgress };
+        const loader = this.registry.find(request);
+        const promise = this.loadWithLoader(loader, request, context.child(resolvedUrl), {
+            retries: Math.max(0, Math.trunc(options.retries ?? this.defaultRetries)),
+            retryDelayMs: Math.max(0, options.retryDelayMs ?? this.defaultRetryDelayMs)
+        });
+        this.cache.setInFlight(key, promise);
+        return promise;
+    }
+    async release(handle) {
+        const remaining = await handle.release();
+        if (remaining > 0) {
+            return;
+        }
+        for (const dependencyId of this.dependencies.dependenciesOf(handle.id)) {
+            const dependencyKey = this.cache.keys().find((key) => this.cache.get(key)?.id === dependencyId);
+            const dependency = dependencyKey ? this.cache.get(dependencyKey) : undefined;
+            if (dependency && !dependency.disposed) {
+                await this.release(dependency);
+            }
+        }
+        const cacheKey = this.cache.keys().find((key) => this.cache.get(key)?.id === handle.id);
+        if (cacheKey) {
+            this.cache.delete(cacheKey);
+        }
+        this.dependencies.remove(handle.id);
+    }
+    async loadWithLoader(loader, request, context, retry) {
+        let attempt = 0;
+        while (true) {
+            context.throwIfAborted(request.url);
+            const dependencyHandles = [];
+            try {
+                const dependencyUrls = await loader.dependencies?.(request, context);
+                for (const dependencyUrl of dependencyUrls ?? []) {
+                    context.throwIfAborted(request.url);
+                    dependencyHandles.push(await context.loadDependency(dependencyUrl));
+                }
+                context.throwIfAborted(request.url);
+                const value = (await loader.load(request, context));
+                const handle = new AssetHandle({
+                    id: `asset-${this.nextId++}`,
+                    url: request.url,
+                    type: loader.type,
+                    value,
+                    dispose: (asset) => loader.dispose?.(asset)
+                });
+                this.dependencies.addNode(handle.id);
+                for (const dependency of dependencyHandles) {
+                    this.dependencies.addDependency(handle.id, dependency.id);
+                }
+                return handle;
+            }
+            catch (error) {
+                await this.releaseLoadedDependencies(dependencyHandles);
+                if (this.shouldRetry(error, context, attempt, retry.retries)) {
+                    attempt += 1;
+                    await this.waitForRetry(retry.retryDelayMs, context, request.url);
+                    continue;
+                }
+                if (error instanceof AssetLoadError) {
+                    throw error;
+                }
+                throw new AssetLoadError(`Failed to load asset ${request.url}`, request.url, context.dependencyChain, error);
+            }
+        }
+    }
+    async releaseLoadedDependencies(dependencyHandles) {
+        for (const dependency of [...dependencyHandles].reverse()) {
+            if (!dependency.disposed) {
+                await this.release(dependency);
+            }
+        }
+    }
+    async awaitInFlight(promise, context, url) {
+        if (!context.signal) {
+            return promise;
+        }
+        context.throwIfAborted(url);
+        return new Promise((resolve, reject) => {
+            const abort = () => {
+                reject(new AssetLoadError("Asset load aborted", url, context.dependencyChain, context.signal?.reason));
+            };
+            context.signal?.addEventListener("abort", abort, { once: true });
+            promise.then((handle) => {
+                context.signal?.removeEventListener("abort", abort);
+                resolve(handle);
+            }, (error) => {
+                context.signal?.removeEventListener("abort", abort);
+                reject(error);
+            });
+        });
+    }
+    shouldRetry(error, context, attempt, retries) {
+        if (attempt >= retries)
+            return false;
+        if (context.signal?.aborted)
+            return false;
+        if (error instanceof AssetLoadError && error.message === "Asset load aborted")
+            return false;
+        return true;
+    }
+    async waitForRetry(delayMs, context, url) {
+        context.throwIfAborted(url);
+        if (delayMs === 0)
+            return;
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                context.signal?.removeEventListener("abort", abort);
+                resolve();
+            }, delayMs);
+            const abort = () => {
+                clearTimeout(timeout);
+                reject(new AssetLoadError("Asset load aborted", url, context.dependencyChain, context.signal?.reason));
+            };
+            context.signal?.addEventListener("abort", abort, { once: true });
+        });
+    }
+}
+//# sourceMappingURL=AssetManager.js.map

package/dist/assets/AssetManager.js.map

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

package/dist/assets/AssetRegistry.d.ts

@@ -0,0 +1,10 @@
+import type { AssetLoadRequest, AssetLoader } from "./AssetLoader";
+export declare class AssetRegistry {
+    private readonly loaders;
+    register(loader: AssetLoader): void;
+    unregister(type: string): boolean;
+    get(type: string): AssetLoader;
+    find(request: AssetLoadRequest): AssetLoader;
+    list(): readonly string[];
+}
+//# sourceMappingURL=AssetRegistry.d.ts.map

package/dist/assets/AssetRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetRegistry.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/AssetRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEnE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAQnC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAS9B,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW;IAc5C,IAAI,IAAI,SAAS,MAAM,EAAE;CAG1B"}

package/dist/assets/AssetRegistry.js

@@ -0,0 +1,34 @@
+export class AssetRegistry {
+    loaders = new Map();
+    register(loader) {
+        if (this.loaders.has(loader.type)) {
+            throw new Error(`Asset loader type already registered: ${loader.type}`);
+        }
+        this.loaders.set(loader.type, loader);
+    }
+    unregister(type) {
+        return this.loaders.delete(type);
+    }
+    get(type) {
+        const loader = this.loaders.get(type);
+        if (!loader) {
+            throw new Error(`No asset loader registered for type: ${type}`);
+        }
+        return loader;
+    }
+    find(request) {
+        if (request.type) {
+            return this.get(request.type);
+        }
+        for (const loader of this.loaders.values()) {
+            if (loader.canLoad(request)) {
+                return loader;
+            }
+        }
+        throw new Error(`No asset loader can load ${request.url}`);
+    }
+    list() {
+        return [...this.loaders.keys()];
+    }
+}
+//# sourceMappingURL=AssetRegistry.js.map

package/dist/assets/AssetRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetRegistry.js","sourceRoot":"","sources":["../../../../packages/assets/src/AssetRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACP,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE1D,QAAQ,CAAC,MAAmB;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,OAAyB;QAC5B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/assets/AssetRenderDefaults.d.ts

@@ -0,0 +1,13 @@
+import type { CameraFrameViewport, PerspectiveCameraFrameOptions, RendererPostProcessOptions, RendererShadowOptions } from "@aura3d/rendering";
+export type AssetRenderLightingPreset = "studioProduct" | "outdoorDay" | "interiorGallery" | "gameNight";
+export interface AssetRenderDefaults {
+    readonly viewport: CameraFrameViewport;
+    readonly camera: "auto-frame";
+    readonly frame: PerspectiveCameraFrameOptions;
+    readonly lighting: AssetRenderLightingPreset;
+    readonly shadows: RendererShadowOptions;
+    readonly postprocess: RendererPostProcessOptions;
+}
+export declare const DEFAULT_ASSET_RENDER_VIEWPORT: CameraFrameViewport;
+export declare function createAssetRenderDefaults(lighting?: AssetRenderLightingPreset): AssetRenderDefaults;
+//# sourceMappingURL=AssetRenderDefaults.d.ts.map

package/dist/assets/AssetRenderDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetRenderDefaults.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/AssetRenderDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/I,MAAM,MAAM,yBAAyB,GAAG,eAAe,GAAG,YAAY,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAEzG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CAClD;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,QAAQ,GAAE,yBAA2C,GAAG,mBAAmB,CAgBpH"}

package/dist/assets/AssetRenderDefaults.js

@@ -0,0 +1,23 @@
+import { createLightingDefault } from "../rendering/index.js";
+export const DEFAULT_ASSET_RENDER_VIEWPORT = {
+    width: 960,
+    height: 540
+};
+export function createAssetRenderDefaults(lighting = "studioProduct") {
+    const defaults = createLightingDefault(lighting);
+    return {
+        viewport: DEFAULT_ASSET_RENDER_VIEWPORT,
+        camera: "auto-frame",
+        frame: {
+            paddingRatio: 0.16,
+            yawRadians: -0.38,
+            pitchRadians: -0.16,
+            nearPadding: 0.18,
+            farPadding: 2.4
+        },
+        lighting,
+        shadows: defaults.shadow,
+        postprocess: defaults.postprocess
+    };
+}
+//# sourceMappingURL=AssetRenderDefaults.js.map

package/dist/assets/AssetRenderDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetRenderDefaults.js","sourceRoot":"","sources":["../../../../packages/assets/src/AssetRenderDefaults.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAa1D,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,GAAG;CACZ,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,WAAsC,eAAe;IAC7F,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO;QACL,QAAQ,EAAE,6BAA6B;QACvC,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE;YACL,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,CAAC,IAAI;YACjB,YAAY,EAAE,CAAC,IAAI;YACnB,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,GAAG;SAChB;QACD,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,MAAM;QACxB,WAAW,EAAE,QAAQ,CAAC,WAAW;KAClC,CAAC;AACJ,CAAC"}

package/dist/assets/AudioLoader.d.ts

@@ -0,0 +1,17 @@
+import type { AssetLoadRequest, AssetLoader } from "./AssetLoader";
+import type { LoadContext } from "./LoadContext";
+export interface AudioDecodeContext {
+    decodeAudioData(data: ArrayBuffer): Promise<AudioBuffer> | AudioBuffer;
+}
+export interface AudioAsset {
+    readonly url: string;
+    readonly buffer: AudioBuffer;
+}
+export declare class AudioLoader implements AssetLoader<AudioAsset> {
+    readonly type = "audio";
+    private readonly audioContext;
+    constructor(audioContext: AudioDecodeContext);
+    canLoad(request: AssetLoadRequest): boolean;
+    load(request: AssetLoadRequest, context: LoadContext): Promise<AudioAsset>;
+}
+//# sourceMappingURL=AudioLoader.d.ts.map

package/dist/assets/AudioLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioLoader.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/AudioLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;CACxE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,qBAAa,WAAY,YAAW,WAAW,CAAC,UAAU,CAAC;IACzD,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;gBAEtC,YAAY,EAAE,kBAAkB;IAI5C,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAIrC,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAejF"}

package/dist/assets/AudioLoader.js

@@ -0,0 +1,23 @@
+export class AudioLoader {
+    type = "audio";
+    audioContext;
+    constructor(audioContext) {
+        this.audioContext = audioContext;
+    }
+    canLoad(request) {
+        return /\.(?:mp3|wav|ogg|m4a|aac)(?:\?.*)?$/i.test(request.url);
+    }
+    async load(request, context) {
+        context.throwIfAborted(request.url);
+        if (typeof fetch !== "function") {
+            throw new Error("AudioLoader requires fetch");
+        }
+        const response = await fetch(request.url, { signal: request.signal });
+        if (!response.ok) {
+            throw new Error(`Audio request failed with ${response.status}`);
+        }
+        const buffer = await this.audioContext.decodeAudioData(await response.arrayBuffer());
+        return { url: request.url, buffer };
+    }
+}
+//# sourceMappingURL=AudioLoader.js.map

package/dist/assets/AudioLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioLoader.js","sourceRoot":"","sources":["../../../../packages/assets/src/AudioLoader.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,OAAO,CAAC;IAEP,YAAY,CAAqB;IAElD,YAAY,YAAgC;QAC1C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,OAAyB;QAC/B,OAAO,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAyB,EAAE,OAAoB;QACxD,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QACrF,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/assets/BlenderExportValidation.d.ts

@@ -0,0 +1,64 @@
+export type BlenderExportValidationStatus = "pass" | "warn" | "fail";
+export interface BlenderExportFixtureManifest {
+    readonly schemaVersion: "blender-export-fixtures";
+    readonly sourceName: string;
+    readonly sourceRepository: string;
+    readonly sourceRevision: string;
+    readonly sourceReadme: string;
+    readonly sourceEvidence: string;
+    readonly fixtures: readonly BlenderExportFixture[];
+}
+export interface BlenderExportFixture {
+    readonly id: string;
+    readonly name: string;
+    readonly path: string;
+    readonly upstreamPath: string;
+    readonly sourceSha256: string;
+    readonly license: string;
+    readonly expectedGeneratorPattern: string;
+    readonly tags: readonly string[];
+}
+export interface BlenderExportFixtureInput extends BlenderExportFixture {
+    readonly sourceText: string;
+}
+export interface BlenderExportValidationReport {
+    readonly schemaVersion: "blender-export-validation";
+    readonly generatedAt: string;
+    readonly sourceManifest: Omit<BlenderExportFixtureManifest, "fixtures"> & {
+        readonly fixtureCount: number;
+    };
+    readonly summary: Record<BlenderExportValidationStatus, number> & {
+        readonly fixtureCount: number;
+    };
+    readonly fixtures: readonly BlenderExportValidationFixtureResult[];
+}
+export interface BlenderExportValidationFixtureResult {
+    readonly id: string;
+    readonly name: string;
+    readonly path: string;
+    readonly upstreamPath: string;
+    readonly sourceSha256: string;
+    readonly license: string;
+    readonly tags: readonly string[];
+    readonly generator: string;
+    readonly status: BlenderExportValidationStatus;
+    readonly metrics: {
+        readonly scenes: number;
+        readonly meshes: number;
+        readonly materials: number;
+        readonly textures: number;
+        readonly images: number;
+        readonly animations: number;
+        readonly renderables: number;
+    };
+    readonly diagnostics: readonly BlenderExportValidationDiagnostic[];
+}
+export interface BlenderExportValidationDiagnostic {
+    readonly code: string;
+    readonly severity: "info" | "warning" | "error";
+    readonly message: string;
+    readonly nextAction: string;
+}
+export declare function createBlenderExportValidationReport(manifest: BlenderExportFixtureManifest, fixtureInputs: readonly BlenderExportFixtureInput[], generatedAt?: string): Promise<BlenderExportValidationReport>;
+export declare function assertValidBlenderExportFixtureManifest(manifest: BlenderExportFixtureManifest): BlenderExportFixtureManifest;
+//# sourceMappingURL=BlenderExportValidation.d.ts.map

package/dist/assets/BlenderExportValidation.d.ts.map

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

package/dist/assets/BlenderExportValidation.js

@@ -0,0 +1,143 @@
+import { GLTFLoader } from "./GLTFLoader.js";
+import { LoadContext } from "./LoadContext.js";
+export async function createBlenderExportValidationReport(manifest, fixtureInputs, generatedAt = new Date().toISOString()) {
+    assertValidBlenderExportFixtureManifest(manifest);
+    const inputById = new Map(fixtureInputs.map((fixture) => [fixture.id, fixture]));
+    const fixtures = await Promise.all(manifest.fixtures.map(async (fixture) => validateFixture(fixture, inputById.get(fixture.id))));
+    return {
+        schemaVersion: "blender-export-validation",
+        generatedAt,
+        sourceManifest: {
+            schemaVersion: manifest.schemaVersion,
+            sourceName: manifest.sourceName,
+            sourceRepository: manifest.sourceRepository,
+            sourceRevision: manifest.sourceRevision,
+            sourceReadme: manifest.sourceReadme,
+            sourceEvidence: manifest.sourceEvidence,
+            fixtureCount: manifest.fixtures.length
+        },
+        summary: {
+            fixtureCount: fixtures.length,
+            pass: fixtures.filter((fixture) => fixture.status === "pass").length,
+            warn: fixtures.filter((fixture) => fixture.status === "warn").length,
+            fail: fixtures.filter((fixture) => fixture.status === "fail").length
+        },
+        fixtures
+    };
+}
+export function assertValidBlenderExportFixtureManifest(manifest) {
+    if (manifest.schemaVersion !== "blender-export-fixtures") {
+        throw new Error("Blender export fixture manifest schemaVersion must be blender-export-fixtures");
+    }
+    if (!manifest.sourceRepository || !/^https:\/\/github\.com\/KhronosGroup\/Vulkan-Samples-Assets/.test(manifest.sourceRepository)) {
+        throw new Error("Blender export fixture manifest must reference KhronosGroup/Vulkan-Samples-Assets");
+    }
+    if (!/^[0-9a-f]{40}$/i.test(manifest.sourceRevision)) {
+        throw new Error("Blender export fixture manifest sourceRevision must be a git SHA");
+    }
+    if (manifest.fixtures.length < 2) {
+        throw new Error("Blender export validation requires multiple fixtures");
+    }
+    const ids = new Set();
+    for (const fixture of manifest.fixtures) {
+        if (ids.has(fixture.id)) {
+            throw new Error(`Blender export fixture id is duplicated: ${fixture.id}`);
+        }
+        ids.add(fixture.id);
+        if (!fixture.path.endsWith(".gltf") && !fixture.path.endsWith(".glb")) {
+            throw new Error(`Blender export fixture ${fixture.id} must be a glTF or GLB file`);
+        }
+        if (!/^[0-9a-f]{64}$/i.test(fixture.sourceSha256)) {
+            throw new Error(`Blender export fixture ${fixture.id} sourceSha256 must be a SHA-256 digest`);
+        }
+        if (!fixture.expectedGeneratorPattern) {
+            throw new Error(`Blender export fixture ${fixture.id} must define expectedGeneratorPattern`);
+        }
+    }
+    return manifest;
+}
+async function validateFixture(fixture, input) {
+    if (!input) {
+        return failureFixture(fixture, "ASSET_BLENDER_EXPORT_SOURCE_MISSING", "Fixture source text was not provided to the validation runner.");
+    }
+    try {
+        const json = JSON.parse(input.sourceText);
+        const generator = json.asset?.generator ?? "";
+        const diagnostics = [];
+        if (!new RegExp(fixture.expectedGeneratorPattern, "i").test(generator)) {
+            diagnostics.push({
+                code: "ASSET_BLENDER_EXPORT_GENERATOR_MISMATCH",
+                severity: "error",
+                message: `Expected generator matching ${fixture.expectedGeneratorPattern}, got ${generator || "missing"}.`,
+                nextAction: "Replace the fixture with a confirmed Blender-exported glTF file or update the manifest evidence."
+            });
+        }
+        const asset = await new GLTFLoader().load({ url: dataGLTF(input.sourceText) }, new LoadContext());
+        return resultForAsset(fixture, asset, generator, diagnostics);
+    }
+    catch (error) {
+        return failureFixture(fixture, "ASSET_BLENDER_EXPORT_LOAD_FAILED", error instanceof Error ? error.message : String(error));
+    }
+}
+function resultForAsset(fixture, asset, generator, diagnostics) {
+    const renderables = asset.createScene().collectRenderables().length;
+    const status = diagnostics.some((diagnostic) => diagnostic.severity === "error") ? "fail" : diagnostics.length > 0 ? "warn" : "pass";
+    return {
+        id: fixture.id,
+        name: fixture.name,
+        path: fixture.path,
+        upstreamPath: fixture.upstreamPath,
+        sourceSha256: fixture.sourceSha256,
+        license: fixture.license,
+        tags: fixture.tags,
+        generator,
+        status,
+        metrics: {
+            scenes: asset.scenes.length,
+            meshes: asset.meshes.length,
+            materials: asset.materials.length,
+            textures: asset.textures.length,
+            images: asset.images.length,
+            animations: asset.animations.length,
+            renderables
+        },
+        diagnostics: diagnostics.length > 0 ? diagnostics : [{
+                code: "ASSET_BLENDER_EXPORT_VALIDATED",
+                severity: "info",
+                message: "Fixture was confirmed as Blender-exported glTF and loaded through Aura3D's glTF loader.",
+                nextAction: "Keep this fixture current when changing loader validation, importer settings, or fixture source revision."
+            }]
+    };
+}
+function failureFixture(fixture, code, message) {
+    return {
+        id: fixture.id,
+        name: fixture.name,
+        path: fixture.path,
+        upstreamPath: fixture.upstreamPath,
+        sourceSha256: fixture.sourceSha256,
+        license: fixture.license,
+        tags: fixture.tags,
+        generator: "",
+        status: "fail",
+        metrics: {
+            scenes: 0,
+            meshes: 0,
+            materials: 0,
+            textures: 0,
+            images: 0,
+            animations: 0,
+            renderables: 0
+        },
+        diagnostics: [{
+                code,
+                severity: "error",
+                message,
+                nextAction: "Fix or replace this Blender-export fixture before marking Blender-export validation complete."
+            }]
+    };
+}
+function dataGLTF(source) {
+    return `data:model/gltf+json,${encodeURIComponent(source)}`;
+}
+//# sourceMappingURL=BlenderExportValidation.js.map

package/dist/assets/BlenderExportValidation.js.map

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

package/dist/assets/CarConceptMaterialStability.d.ts

@@ -0,0 +1,28 @@
+import type { Material } from "@aura3d/rendering";
+import type { GLTFMaterialRenderStateOverride } from "./GLTFRenderResources";
+export type CarConceptMaterialStabilityProfile = "gallery" | "cinematic";
+export interface CarConceptMaterialBaseline {
+    readonly roughness?: number;
+    readonly metallic?: number;
+    readonly clearcoat?: number;
+}
+export interface CarConceptMaterialStabilityOptions {
+    readonly materialKey?: string;
+    readonly sourceMaterialName?: string;
+    readonly nodeName?: string;
+    readonly profile?: CarConceptMaterialStabilityProfile;
+    readonly baseline?: CarConceptMaterialBaseline;
+    readonly roughnessScale?: number;
+    readonly metallicScale?: number;
+    readonly clearcoatBoost?: number;
+}
+export type CarConceptMaterialVisualRole = "body-primary-paint" | "body-secondary-paint" | "roof-panel" | "side-panel" | "pillar-trim" | "dark-trim" | "glass" | "light-lens" | "license-plate" | "tire" | "wheel-metal" | "brake" | "interior" | "mechanical" | "unclassified";
+export interface CarConceptMaterialVisualRoleContext {
+    readonly materialKey?: string;
+    readonly sourceMaterialName?: string;
+    readonly nodeName?: string;
+}
+export declare function carConceptMaterialRenderStateOverrides(context?: "product-configurator" | "current-routes-flagship"): readonly GLTFMaterialRenderStateOverride[];
+export declare function applyCarConceptMaterialStability(material: Material, options?: CarConceptMaterialStabilityOptions): void;
+export declare function carConceptMaterialVisualRole(context: CarConceptMaterialVisualRoleContext): CarConceptMaterialVisualRole;
+//# sourceMappingURL=CarConceptMaterialStability.d.ts.map

package/dist/assets/CarConceptMaterialStability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarConceptMaterialStability.d.ts","sourceRoot":"","sources":["../../../../packages/assets/src/CarConceptMaterialStability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAA6B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,MAAM,kCAAkC,GAAG,SAAS,GAAG,WAAW,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,kCAAkC,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AA4WD,MAAM,MAAM,4BAA4B,GACpC,oBAAoB,GACpB,sBAAsB,GACtB,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,WAAW,GACX,OAAO,GACP,YAAY,GACZ,eAAe,GACf,MAAM,GACN,aAAa,GACb,OAAO,GACP,UAAU,GACV,YAAY,GACZ,cAAc,CAAC;AAEnB,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,sCAAsC,CACpD,OAAO,GAAE,sBAAsB,GAAG,yBAAkD,GACnF,SAAS,+BAA+B,EAAE,CAyB5C;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,kCAAuC,GAC/C,IAAI,CAON;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,4BAA4B,CAuB9B"}