@aura3d/engine 2.0.4 → 3.0.1

package/dist/materials/GameReadyMaterialLibrary.js

@@ -0,0 +1,253 @@
+/**
+ * Game-ready material preset library (PART C2).
+ *
+ * Six compact presets tuned for real-time routes. Each preset carries its
+ * authoring parameters, a root-API example snippet, a tunables table, and
+ * probe metadata (geometry + environment + probe screenshot path).
+ *
+ * Claim boundary: these are parameter presets over the public material spec.
+ * The skin entry is a wrapped-diffuse approximation and is never presented
+ * as physical subsurface scattering.
+ */
+const REPORT_DIR = "tests/reports/game-ready-materials";
+export const GAME_READY_MATERIAL_PRESETS = [
+    {
+        id: "carPaint",
+        label: "Car paint (clearcoat + flake normal)",
+        kind: "carPaint",
+        features: ["clearcoat", "flake normal"],
+        parameters: {
+            baseColor: [0.62, 0.03, 0.06],
+            metallic: 0.65,
+            roughness: 0.32,
+            clearcoat: 1,
+            clearcoatRoughness: 0.06,
+            flakeNormalScale: 0.35,
+            flakeDensity: 0.6
+        },
+        exampleSnippet: [
+            'import { material, primitives, scene } from "../engine/index.js";',
+            "",
+            "// carPaint preset values: clearcoat shell over a metallic base,",
+            "// flakeNormalScale rides the normal slot as a fine sparkle normal.",
+            "const paint = material.clearcoatPaint({",
+            '  color: "#c1121f",',
+            "  roughness: 0.32,",
+            "  metallic: 0.65,",
+            "  clearcoat: 1,",
+            "  clearcoatRoughness: 0.06,",
+            "  normalScale: 0.35,",
+            "  envMapIntensity: 1.4",
+            "});",
+            "scene().add(primitives.sphere({ name: \"car body panel\", material: paint }));"
+        ].join("\n"),
+        tunables: [
+            { name: "clearcoat", default: 1, range: "0..1", effect: "Top-gloss shell strength; lower to dull the finish." },
+            { name: "clearcoatRoughness", default: 0.06, range: "0..0.3", effect: "Sharpness of clearcoat reflections." },
+            { name: "flakeNormalScale", default: 0.35, range: "0..1", effect: "Metallic-flake sparkle intensity via the flake normal." },
+            { name: "flakeDensity", default: 0.6, range: "0..1", effect: "Flake coverage; raise for glitter, lower for solid gloss." },
+            { name: "roughness", default: 0.32, range: "0.05..0.7", effect: "Base-coat spread under the clearcoat shell." },
+            { name: "metallic", default: 0.65, range: "0..1", effect: "Base-coat metalness; lower for candy/dielectric looks." }
+        ],
+        probe: { geometry: "beveled-cube", environmentId: "industrial-sunset-puresky", screenshot: `${REPORT_DIR}/carPaint.png` },
+        note: "Clearcoat shell plus flake normal; tune flakeDensity down under dim environments."
+    },
+    {
+        id: "skinSSS-approx",
+        label: "Skin (wrapped-diffuse approximation)",
+        kind: "skinSSS-approx",
+        features: ["wrapped diffuse", "thickness tint"],
+        parameters: {
+            baseColor: [0.85, 0.55, 0.42],
+            roughness: 0.55,
+            wrapDiffuse: 0.5,
+            thicknessTint: [0.98, 0.35, 0.25],
+            thicknessScale: 0.8
+        },
+        exampleSnippet: [
+            'import { material, primitives, scene } from "../engine/index.js";',
+            "",
+            "// skinSSS-approx preset values: wrapped-diffuse approximation with a",
+            "// warm thickness tint. Approximation only, not physical scattering.",
+            "const skin = material.pbr({",
+            '  color: "#d98c6b",',
+            "  roughness: 0.55,",
+            "  metallic: 0,",
+            '  emissive: "#fa5940",',
+            "  emissiveIntensity: 0.12,",
+            "  envMapIntensity: 0.5",
+            "});",
+            "// wrapDiffuse 0.5 softens the terminator; thicknessTint warms thin areas.",
+            "scene().add(primitives.sphere({ name: \"character head\", material: skin }));"
+        ].join("\n"),
+        tunables: [
+            { name: "wrapDiffuse", default: 0.5, range: "0..1", effect: "Light wrap around the terminator; higher looks softer." },
+            { name: "thicknessTint", default: "[0.98, 0.35, 0.25]", range: "color", effect: "Warm tint for thin areas (ears, nose, fingers)." },
+            { name: "thicknessScale", default: 0.8, range: "0..2", effect: "Strength of the thickness tint contribution." },
+            { name: "roughness", default: 0.55, range: "0.3..0.8", effect: "Skin sheen; lower reads oily, higher reads dry." },
+            { name: "emissiveIntensity", default: 0.12, range: "0..0.4", effect: "Stand-in glow for transmitted warmth; keep subtle." }
+        ],
+        probe: { geometry: "sphere", environmentId: "showroom-softboxes", screenshot: `${REPORT_DIR}/skinSSS-approx.png` },
+        note: "Wrapped-diffuse approximation only; never presented as physical scattering."
+    },
+    {
+        id: "glassThin",
+        label: "Thin glass (transmission, thin-walled)",
+        kind: "glassThin",
+        features: ["transmission", "thin-walled"],
+        parameters: {
+            baseColor: [0.75, 0.9, 0.95],
+            roughness: 0.05,
+            transmission: 0.9,
+            thickness: 0.02,
+            ior: 1.5,
+            opacity: 0.35
+        },
+        exampleSnippet: [
+            'import { material, primitives, scene } from "../engine/index.js";',
+            "",
+            "// glassThin preset values: high transmission with near-zero thickness",
+            "// for windows, visors, and display covers.",
+            "const thinGlass = material.clearGlass({",
+            '  color: "#bfe6f2",',
+            "  opacity: 0.35,",
+            "  transmission: 0.9,",
+            "  thickness: 0.02,",
+            "  roughness: 0.05",
+            "});",
+            "scene().add(primitives.box({ name: \"visor pane\", material: thinGlass }));"
+        ].join("\n"),
+        tunables: [
+            { name: "transmission", default: 0.9, range: "0..1", effect: "See-through strength; lower for smoked glass." },
+            { name: "thickness", default: 0.02, range: "0..0.1", effect: "Refraction volume; keep near zero for thin panes." },
+            { name: "roughness", default: 0.05, range: "0..0.4", effect: "Raise for frosted or dirty glass." },
+            { name: "ior", default: 1.5, range: "1..2.5", effect: "Index of refraction for edge bending." },
+            { name: "opacity", default: 0.35, range: "0..1", effect: "Blend fallback where transmission is unavailable." }
+        ],
+        probe: { geometry: "thin-pane", environmentId: "studio-small-08", screenshot: `${REPORT_DIR}/glassThin.png` },
+        note: "Thin-walled panes only; use the full glass preset for solid volumes."
+    },
+    {
+        id: "brushedMetal",
+        label: "Brushed metal (anisotropic)",
+        kind: "brushedMetal",
+        features: ["anisotropy", "brushed roughness"],
+        parameters: {
+            baseColor: [0.72, 0.74, 0.78],
+            metalness: 1,
+            roughness: 0.38,
+            anisotropy: 0.85,
+            anisotropyRotation: 1.5708,
+            brushScale: 42
+        },
+        exampleSnippet: [
+            'import { material, primitives, scene } from "../engine/index.js";',
+            "",
+            "// brushedMetal preset values: full metal with directional anisotropy",
+            "// so highlights stretch along the brush direction.",
+            "const brushed = material.pbr({",
+            '  color: "#b8bcc2",',
+            "  roughness: 0.38,",
+            "  metallic: 1,",
+            "  anisotropy: 0.85,",
+            "  anisotropyRotation: 1.5708,",
+            "  envMapIntensity: 1.3",
+            "});",
+            "scene().add(primitives.box({ name: \"brushed housing\", material: brushed }));"
+        ].join("\n"),
+        tunables: [
+            { name: "anisotropy", default: 0.85, range: "0..1", effect: "Highlight stretch along the brush direction." },
+            { name: "anisotropyRotation", default: 1.5708, range: "0..6.2832", effect: "Brush direction in radians." },
+            { name: "roughness", default: 0.38, range: "0.1..0.7", effect: "Brush coarseness; higher blurs the streak." },
+            { name: "brushScale", default: 42, range: "8..128", effect: "Procedural brush texture tiling density." },
+            { name: "envMapIntensity", default: 1.3, range: "0..3", effect: "Reflection punch under studio lighting." }
+        ],
+        probe: { geometry: "beveled-cube", environmentId: "showroom-softboxes", screenshot: `${REPORT_DIR}/brushedMetal.png` },
+        note: "Rotate anisotropyRotation to match the mesh UV brush direction."
+    },
+    {
+        id: "foliage",
+        label: "Foliage (alpha-cutout + translucency)",
+        kind: "foliage",
+        features: ["alpha-cutout", "translucency"],
+        parameters: {
+            baseColor: [0.25, 0.45, 0.18],
+            alphaMode: "mask",
+            alphaCutoff: 0.5,
+            translucency: 0.6,
+            translucencyColor: [0.55, 0.8, 0.3],
+            side: "double"
+        },
+        exampleSnippet: [
+            'import { material, primitives, scene } from "../engine/index.js";',
+            "",
+            "// foliage preset values: alpha-cutout cards with backlit translucency.",
+            "// alphaCutoff discards background texels; translucency lifts sun-side leaves.",
+            "const leaf = material.pbr({",
+            '  color: "#40732e",',
+            "  roughness: 0.85,",
+            "  metallic: 0,",
+            '  emissive: "#8ccc4d",',
+            "  emissiveIntensity: 0.25,",
+            "  opacity: 1",
+            "});",
+            "// Apply alphaMode mask with alphaCutoff 0.5 on the card texture,",
+            "// and translucency 0.6 toward the sun color for backlight.",
+            "scene().add(primitives.plane({ name: \"leaf card\", material: leaf }));"
+        ].join("\n"),
+        tunables: [
+            { name: "alphaCutoff", default: 0.5, range: "0..1", effect: "Cutout threshold; lower keeps soft edges, higher trims them." },
+            { name: "translucency", default: 0.6, range: "0..1", effect: "Backlight lift when the sun is behind the leaves." },
+            { name: "translucencyColor", default: "[0.55, 0.8, 0.3]", range: "color", effect: "Tint of transmitted backlight." },
+            { name: "roughness", default: 0.85, range: "0.5..1", effect: "Leaf matte response; rarely below 0.5 outdoors." },
+            { name: "side", default: "double", range: "front | double", effect: "Cards need double-sided rendering." }
+        ],
+        probe: { geometry: "card", environmentId: "showroom-softboxes", screenshot: `${REPORT_DIR}/foliage.png` },
+        note: "Cards only; pair with alphaCutoff-matched mip bias to avoid edge crawl."
+    },
+    {
+        id: "concreteAsphalt",
+        label: "Concrete / asphalt (roughness variation)",
+        kind: "concreteAsphalt",
+        features: ["roughness variation", "aggregate normal"],
+        parameters: {
+            baseColor: [0.32, 0.33, 0.35],
+            roughness: 0.85,
+            roughnessVariation: 0.25,
+            normalScale: 0.9,
+            aggregateScale: 18
+        },
+        exampleSnippet: [
+            'import { material, primitives, scene } from "../engine/index.js";',
+            "",
+            "// concreteAsphalt preset values: high roughness broken up by",
+            "// roughnessVariation so large ground planes avoid a flat CG look.",
+            "const asphalt = material.pbr({",
+            '  color: "#525458",',
+            "  roughness: 0.85,",
+            "  metallic: 0,",
+            "  normalScale: 0.9,",
+            "  envMapIntensity: 0.35",
+            "});",
+            "// roughnessVariation 0.25 modulates roughness per aggregate patch.",
+            "scene().add(primitives.plane({ name: \"road surface\", material: asphalt }));"
+        ].join("\n"),
+        tunables: [
+            { name: "roughnessVariation", default: 0.25, range: "0..0.5", effect: "Patch-to-patch roughness breakup; higher looks weathered." },
+            { name: "roughness", default: 0.85, range: "0.6..1", effect: "Mean roughness; rarely below 0.6 for ground." },
+            { name: "normalScale", default: 0.9, range: "0..1.5", effect: "Aggregate bump strength." },
+            { name: "aggregateScale", default: 18, range: "4..64", effect: "Aggregate grain tiling density." },
+            { name: "envMapIntensity", default: 0.35, range: "0..1", effect: "Keep low so ground stays matte under studio light." }
+        ],
+        probe: { geometry: "sphere", environmentId: "showroom-softboxes", screenshot: `${REPORT_DIR}/concreteAsphalt.png` },
+        note: "Variation is load-bearing: without it large planes read as flat CG."
+    }
+];
+export const GAME_READY_MATERIAL_IDS = GAME_READY_MATERIAL_PRESETS.map((preset) => preset.id);
+export function listGameReadyMaterials() {
+    return GAME_READY_MATERIAL_PRESETS;
+}
+export function findGameReadyMaterial(id) {
+    return GAME_READY_MATERIAL_PRESETS.find((preset) => preset.id === id);
+}
+//# sourceMappingURL=GameReadyMaterialLibrary.js.map

package/dist/materials/GameReadyMaterialLibrary.js.map

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

package/dist/materials/MaterialValidation.d.ts

@@ -1,3 +1,4 @@
+import { type GameReadyMaterialPreset } from "./GameReadyMaterialLibrary.js";
 export interface ThreeCompatMaterialLibrarySummary {
     readonly materialCount: number;
     readonly textureBackedMaterialCount: number;
@@ -10,5 +11,25 @@ export interface ThreeCompatMaterialLibrarySummary {
     readonly missingTextureSetIds: readonly string[];
     readonly missingTextureSourcePaths: readonly string[];
 }
+export interface GameReadyMaterialValidationResult {
+    readonly id: string;
+    readonly kind: string;
+    readonly ok: boolean;
+    readonly issues: readonly string[];
+}
+export interface GameReadyMaterialLibraryValidation {
+    readonly presetCount: number;
+    readonly passingCount: number;
+    readonly failingIds: readonly string[];
+    readonly results: readonly GameReadyMaterialValidationResult[];
+}
+/**
+ * Validates one game-ready preset against its kind contract: required
+ * features present, parameters in range, snippet + tunables shipped, and the
+ * skin approximation never presented as physical scattering.
+ */
+export declare function validateGameReadyMaterialPreset(preset: GameReadyMaterialPreset): GameReadyMaterialValidationResult;
+/** Validates the full game-ready library: six kinds, unique ids, all passing. */
+export declare function validateGameReadyMaterialLibrary(presets?: readonly GameReadyMaterialPreset[]): GameReadyMaterialLibraryValidation;
 export declare function summarizeThreeCompatMaterialLibrary(): ThreeCompatMaterialLibrarySummary;
 //# sourceMappingURL=MaterialValidation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MaterialValidation.d.ts","sourceRoot":"","sources":["../../../../packages/materials/src/MaterialValidation.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;CACvD;AAED,wBAAgB,mCAAmC,IAAI,iCAAiC,CAoBvF"}
+{"version":3,"file":"MaterialValidation.d.ts","sourceRoot":"","sources":["../../../../packages/materials/src/MaterialValidation.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAIvG,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,iCAAiC,EAAE,CAAC;CAChE;AAUD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,uBAAuB,GAAG,iCAAiC,CAkElH;AAED,iFAAiF;AACjF,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,SAAS,uBAAuB,EAAgC,GACxE,kCAAkC,CAUpC;AAED,wBAAgB,mCAAmC,IAAI,iCAAiC,CAoBvF"}

package/dist/materials/MaterialValidation.js

@@ -1,7 +1,112 @@
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
+import { GAME_READY_MATERIAL_PRESETS } from "./GameReadyMaterialLibrary.js";
 import { listThreeCompatMaterialProofChannels, listThreeCompatPbrMaterials, THREE_COMPAT_REQUIRED_MATERIAL_CLASSES } from "./PBRMaterialLibrary.js";
 import { findThreeCompatTextureSet, THREE_COMPAT_TEXTURE_SETS } from "./TextureSet.js";
+function gameReadyNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function gameReadyColor(value) {
+    return Array.isArray(value) && value.length === 3 && value.every((channel) => typeof channel === "number") ? value : undefined;
+}
+/**
+ * Validates one game-ready preset against its kind contract: required
+ * features present, parameters in range, snippet + tunables shipped, and the
+ * skin approximation never presented as physical scattering.
+ */
+export function validateGameReadyMaterialPreset(preset) {
+    const issues = [];
+    const params = preset.parameters;
+    const inRange = (name, low, high) => {
+        const value = gameReadyNumber(params[name]);
+        if (value === undefined || value < low || value > high)
+            issues.push(`${String(name)} must be within ${low}..${high}`);
+    };
+    switch (preset.kind) {
+        case "carPaint": {
+            inRange("clearcoat", 0.9, 1);
+            inRange("clearcoatRoughness", 0, 0.15);
+            inRange("flakeNormalScale", 0, 1);
+            if ((gameReadyNumber(params.flakeNormalScale) ?? 0) <= 0)
+                issues.push("flakeNormalScale must be positive for the flake normal");
+            inRange("flakeDensity", 0, 1);
+            if ((gameReadyNumber(params.metallic) ?? 0) <= 0)
+                issues.push("metallic must be positive for the base coat");
+            break;
+        }
+        case "skinSSS-approx": {
+            inRange("wrapDiffuse", 0, 1);
+            if ((gameReadyNumber(params.wrapDiffuse) ?? 0) <= 0)
+                issues.push("wrapDiffuse must be positive for wrapped diffuse");
+            if (!gameReadyColor(params.thicknessTint))
+                issues.push("thicknessTint must be an [r, g, b] triple");
+            break;
+        }
+        case "glassThin": {
+            inRange("transmission", 0.5, 1);
+            inRange("thickness", 0, 0.05);
+            inRange("ior", 1, 2.5);
+            inRange("roughness", 0, 0.15);
+            break;
+        }
+        case "brushedMetal": {
+            if (gameReadyNumber(params.metalness) !== 1)
+                issues.push("metalness must equal 1 for brushed metal");
+            inRange("anisotropy", 0.5, 1);
+            if (gameReadyNumber(params.anisotropyRotation) === undefined)
+                issues.push("anisotropyRotation must be a finite radian value");
+            inRange("roughness", 0, 1);
+            break;
+        }
+        case "foliage": {
+            if (params.alphaMode !== "mask")
+                issues.push('alphaMode must equal "mask" for alpha-cutout foliage');
+            inRange("alphaCutoff", 0, 1);
+            if ((gameReadyNumber(params.alphaCutoff) ?? 0) <= 0)
+                issues.push("alphaCutoff must be positive for the cutout");
+            inRange("translucency", 0, 1);
+            if (!gameReadyColor(params.translucencyColor))
+                issues.push("translucencyColor must be an [r, g, b] triple");
+            break;
+        }
+        case "concreteAsphalt": {
+            inRange("roughness", 0.6, 1);
+            inRange("roughnessVariation", 0, 0.5);
+            if ((gameReadyNumber(params.roughnessVariation) ?? 0) <= 0)
+                issues.push("roughnessVariation must be positive for ground breakup");
+            inRange("normalScale", 0, 1.5);
+            break;
+        }
+    }
+    if (!preset.exampleSnippet.includes("material."))
+        issues.push("exampleSnippet must demonstrate the root material API");
+    if (preset.tunables.length === 0)
+        issues.push("tunables table must ship at least one tunable");
+    if (!preset.probe.screenshot)
+        issues.push("probe screenshot path must be set");
+    const claimText = `${preset.label}\n${preset.note}\n${preset.exampleSnippet}`;
+    if (/true\s+sss|real\s+sss|actual\s+sss|physical\s+subsurface\s+scattering/i.test(claimText)) {
+        issues.push("skin approximation must never be presented as physical scattering");
+    }
+    if (preset.kind === "skinSSS-approx" && !/approx/i.test(claimText)) {
+        issues.push("skin preset must be labeled as an approximation");
+    }
+    return { id: preset.id, kind: preset.kind, ok: issues.length === 0, issues };
+}
+/** Validates the full game-ready library: six kinds, unique ids, all passing. */
+export function validateGameReadyMaterialLibrary(presets = GAME_READY_MATERIAL_PRESETS) {
+    const results = presets.map(validateGameReadyMaterialPreset);
+    const failingIds = results.filter((result) => !result.ok).map((result) => result.id);
+    const ids = presets.map((preset) => preset.id);
+    if (new Set(ids).size !== ids.length)
+        failingIds.push("(duplicate-ids)");
+    const kinds = new Set(presets.map((preset) => preset.kind));
+    for (const kind of ["carPaint", "skinSSS-approx", "glassThin", "brushedMetal", "foliage", "concreteAsphalt"]) {
+        if (!kinds.has(kind))
+            failingIds.push(`(missing-kind:${kind})`);
+    }
+    return { presetCount: presets.length, passingCount: results.filter((result) => result.ok).length, failingIds, results };
+}
 export function summarizeThreeCompatMaterialLibrary() {
     const materials = listThreeCompatPbrMaterials();
     const classes = [...new Set(materials.map((material) => material.class))].sort();

package/dist/materials/MaterialValidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"MaterialValidation.js","sourceRoot":"","sources":["../../../../packages/materials/src/MaterialValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oCAAoC,EAAE,2BAA2B,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AACjJ,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAepF,MAAM,UAAU,mCAAmC;IACjD,MAAM,SAAS,GAAG,2BAA2B,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjF,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnG,MAAM,oBAAoB,GAAG,SAAS;SACnC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;SAChG,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC3K,OAAO;QACL,aAAa,EAAE,SAAS,CAAC,MAAM;QAC/B,0BAA0B,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM;QACxF,eAAe,EAAE,yBAAyB,CAAC,MAAM;QACjD,wBAAwB,EAAE,yBAAyB,CAAC,MAAM,GAAG,yBAAyB,CAAC,MAAM;QAC7F,OAAO;QACP,aAAa;QACb,sBAAsB,EAAE,sCAAsC,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC1H,oBAAoB,EAAE,oCAAoC,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClH,oBAAoB;QACpB,yBAAyB;KAC1B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"MaterialValidation.js","sourceRoot":"","sources":["../../../../packages/materials/src/MaterialValidation.ts"],"names":[],"mappings":"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"}

package/dist/materials/browser-index.d.ts

@@ -1,4 +1,6 @@
 export { findThreeCompatPbrMaterial, listThreeCompatMaterialProofChannels, listThreeCompatPbrMaterials, THREE_COMPAT_PBR_MATERIAL_LIBRARY, THREE_COMPAT_REQUIRED_MATERIAL_CLASSES } from "./PBRMaterialLibrary.js";
+export { findGameReadyMaterial, GAME_READY_MATERIAL_IDS, GAME_READY_MATERIAL_PRESETS, listGameReadyMaterials } from "./GameReadyMaterialLibrary.js";
+export type { GameReadyMaterialKind, GameReadyMaterialPreset, GameReadyMaterialProbe, GameReadyMaterialTunable } from "./GameReadyMaterialLibrary.js";
 export { findThreeCompatTextureSet, THREE_COMPAT_TEXTURE_SETS } from "./TextureSet.js";
 export { createThreeCompatMaterialPreviewScene, createThreeCompatMaterialPreviewTile } from "./MaterialPreviewScene.js";
 export type { ThreeCompatMaterialClass, ThreeCompatMaterialParameters, ThreeCompatMaterialPreset, ThreeCompatMaterialProofChannel } from "./MaterialPreset.js";

package/dist/materials/browser-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-index.d.ts","sourceRoot":"","sources":["../../../../packages/materials/src/browser-index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,oCAAoC,EACpC,2BAA2B,EAC3B,iCAAiC,EACjC,sCAAsC,EACvC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,qCAAqC,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAC;AACrH,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,yBAAyB,EACzB,+BAA+B,EAChC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAC7E,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"browser-index.d.ts","sourceRoot":"","sources":["../../../../packages/materials/src/browser-index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,oCAAoC,EACpC,2BAA2B,EAC3B,iCAAiC,EACjC,sCAAsC,EACvC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACjJ,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACnJ,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,qCAAqC,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAC;AACrH,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,yBAAyB,EACzB,+BAA+B,EAChC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAC7E,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/materials/browser-index.js

@@ -1,4 +1,5 @@
 export { findThreeCompatPbrMaterial, listThreeCompatMaterialProofChannels, listThreeCompatPbrMaterials, THREE_COMPAT_PBR_MATERIAL_LIBRARY, THREE_COMPAT_REQUIRED_MATERIAL_CLASSES } from "./PBRMaterialLibrary.js";
+export { findGameReadyMaterial, GAME_READY_MATERIAL_IDS, GAME_READY_MATERIAL_PRESETS, listGameReadyMaterials } from "./GameReadyMaterialLibrary.js";
 export { findThreeCompatTextureSet, THREE_COMPAT_TEXTURE_SETS } from "./TextureSet.js";
 export { createThreeCompatMaterialPreviewScene, createThreeCompatMaterialPreviewTile } from "./MaterialPreviewScene.js";
 export * from "./MaterialPresets.js";

package/dist/materials/browser-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-index.js","sourceRoot":"","sources":["../../../../packages/materials/src/browser-index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,oCAAoC,EACpC,2BAA2B,EAC3B,iCAAiC,EACjC,sCAAsC,EACvC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,qCAAqC,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAC;AAarH,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"browser-index.js","sourceRoot":"","sources":["../../../../packages/materials/src/browser-index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,oCAAoC,EACpC,2BAA2B,EAC3B,iCAAiC,EACjC,sCAAsC,EACvC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEjJ,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,qCAAqC,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAC;AAarH,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/materials/node.d.ts

@@ -1,4 +1,4 @@
 export * from "./browser-index.js";
-export { summarizeThreeCompatMaterialLibrary } from "./MaterialValidation.js";
-export type { ThreeCompatMaterialLibrarySummary } from "./MaterialValidation.js";
+export { summarizeThreeCompatMaterialLibrary, validateGameReadyMaterialLibrary, validateGameReadyMaterialPreset } from "./MaterialValidation.js";
+export type { GameReadyMaterialLibraryValidation, GameReadyMaterialValidationResult, ThreeCompatMaterialLibrarySummary } from "./MaterialValidation.js";
 //# sourceMappingURL=node.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../packages/materials/src/node.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../packages/materials/src/node.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mCAAmC,EAAE,gCAAgC,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AACjJ,YAAY,EAAE,kCAAkC,EAAE,iCAAiC,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/materials/node.js

@@ -1,3 +1,3 @@
 export * from "./browser-index.js";
-export { summarizeThreeCompatMaterialLibrary } from "./MaterialValidation.js";
+export { summarizeThreeCompatMaterialLibrary, validateGameReadyMaterialLibrary, validateGameReadyMaterialPreset } from "./MaterialValidation.js";
 //# sourceMappingURL=node.js.map

package/dist/materials/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../packages/materials/src/node.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../packages/materials/src/node.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mCAAmC,EAAE,gCAAgC,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/navigation-recast/index.d.ts

@@ -0,0 +1,116 @@
+import type * as Recast from "recast-navigation";
+export type NavigationVec3 = readonly [number, number, number];
+export type RecastModule = typeof import("recast-navigation");
+export type RecastGenerators = typeof import("recast-navigation/generators");
+export interface NavigationTriangleSoup {
+    readonly positions: readonly number[] | Float32Array;
+    readonly indices: readonly number[] | Uint32Array;
+}
+export interface RecastNavigationOptions {
+    readonly moduleLoader?: () => Promise<RecastModule>;
+    readonly generatorLoader?: () => Promise<RecastGenerators>;
+}
+export interface NavigationPathResult {
+    readonly success: boolean;
+    readonly points: readonly NavigationVec3[];
+    readonly error?: string;
+}
+/** Structural match for `AuraAssetRef<"navigation">` without coupling this optional package to the engine barrel. */
+export interface NavigationAssetRef {
+    readonly kind: "aura-asset-ref";
+    readonly id: string;
+    readonly type: "navigation";
+    readonly format: "navmesh";
+    readonly url: string;
+    readonly hash?: string;
+}
+export interface NavigationAssetFetchResponse {
+    readonly ok: boolean;
+    readonly status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export interface ImportNavigationAssetOptions {
+    readonly fetch?: (url: string) => Promise<NavigationAssetFetchResponse>;
+    readonly verifyHash?: boolean;
+}
+export interface NavigationCrowdAgentOptions {
+    readonly radius?: number;
+    readonly height?: number;
+    readonly maxAcceleration?: number;
+    readonly maxSpeed?: number;
+    readonly collisionQueryRange?: number;
+    readonly pathOptimizationRange?: number;
+    readonly separationWeight?: number;
+}
+export declare class RecastNavMeshHandle {
+    #private;
+    constructor(module: RecastModule, navMesh: Recast.NavMesh);
+    get disposed(): boolean;
+    computePath(start: NavigationVec3, end: NavigationVec3): NavigationPathResult;
+    createCrowd(maxAgents: number, maxAgentRadius: number): RecastCrowdHandle;
+    serialize(): Uint8Array;
+    /** Stable escape hatch. The handle retains ownership and frees this object. */
+    unsafeRecastNavMesh(): Recast.NavMesh;
+    dispose(): void;
+}
+/** Per-agent crowd telemetry (O1): real Detour agent state for engine crowds. */
+export interface RecastCrowdAgentState {
+    readonly position: NavigationVec3;
+    readonly velocity: NavigationVec3;
+    readonly speed: number;
+}
+export declare class RecastCrowdHandle {
+    #private;
+    /** Over-budget cap, fixed at construction. Adding past it throws fail-closed. */
+    readonly maxAgents: number;
+    constructor(module: RecastModule, navMesh: Recast.NavMesh, maxAgents: number, maxAgentRadius: number);
+    /** Live agent count against {@link maxAgents}. The root `crowds` builder reports this in diagnostics with a cap warning. */
+    count(): number;
+    addAgent(position: NavigationVec3, options?: NavigationCrowdAgentOptions): Recast.CrowdAgent;
+    requestMoveTarget(agent: Recast.CrowdAgent, target: NavigationVec3): boolean;
+    /** Root-facing alias for `requestMoveTarget`, matching the O1 `crowds.setTarget` builder name. */
+    setTarget(agent: Recast.CrowdAgent, target: NavigationVec3): boolean;
+    update(dt: number): void;
+    positions(): readonly NavigationVec3[];
+    /**
+     * Per-agent position + velocity + speed from the Detour crowd (O1 task 2).
+     *
+     * This is the data source the root `crowds` builder must feed its agents instead of
+     * the `sampleCrowdAnimation` fixture: the fixture sampler stays as the deterministic
+     * oracle for tests, but engine crowds render from these real positions.
+     */
+    agentStates(): readonly RecastCrowdAgentState[];
+    /** Stable escape hatch. The handle owns and destroys this crowd. */
+    unsafeRecastCrowd(): Recast.Crowd;
+    dispose(): void;
+}
+export declare class RecastTileCacheHandle {
+    #private;
+    readonly navMesh: RecastNavMeshHandle;
+    constructor(module: RecastModule, navMesh: Recast.NavMesh, tileCache: Recast.TileCache);
+    addCylinderObstacle(position: NavigationVec3, radius: number, height: number): Recast.Obstacle;
+    removeObstacle(obstacle: Recast.Obstacle): void;
+    update(maxIterations?: number): number;
+    serialize(): Uint8Array;
+    dispose(): void;
+}
+export declare class RecastNavigation {
+    #private;
+    constructor(module: RecastModule, generators: RecastGenerators);
+    generateSolo(input: NavigationTriangleSoup, config: Parameters<RecastGenerators["generateSoloNavMesh"]>[2]): RecastNavMeshHandle;
+    generateTileCache(input: NavigationTriangleSoup, config?: Parameters<RecastGenerators["generateTileCache"]>[2]): RecastTileCacheHandle;
+    import(bytes: Uint8Array): RecastNavMeshHandle;
+    importAsset(asset: NavigationAssetRef, options?: ImportNavigationAssetOptions): Promise<RecastNavMeshHandle>;
+    /** Stable typed escape hatch for Crowd, TileCache, and advanced Detour APIs. */
+    get rawModule(): RecastModule;
+}
+/**
+ * Fail-closed construction for the optional Recast/Detour peer (O1 checklist).
+ *
+ * Recast is optional navigation, never a silent fallback: when the peer module is
+ * absent the error names the missing package and the install step instead of
+ * resolving to a no-op navigator. The root `navigation` builder must surface this
+ * in diagnostics rather than reporting a successful bake.
+ */
+export declare function createRecastNavigation(options?: RecastNavigationOptions): Promise<RecastNavigation>;
+//# sourceMappingURL=index.d.ts.map

package/dist/navigation-recast/index.d.ts.map

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