@aura3d/engine 2.0.4 → 3.0.0

package/dist/lean/game.js

@@ -1,5 +1,6 @@
 import { createAuraApp as createProductApp } from "./product.js";
 import { createLeanGameInput, createLeanPlatformer } from "./ArcadeRuntime.js";
+import { createSdfFontAtlas, layoutSdfText, SDF_FONT_SCOPE_NOTE, SDF_SUPPORTED_GLYPHS } from "../rendering/index.js";
 export * from "./product.js";
 /**
  * Creates the deterministic arcade entry. Physical simulation is intentionally
@@ -29,9 +30,200 @@ export function createAuraApp(target, options) {
         }
     };
 }
+/**
+ * J3 camera rigs (F2 surface for lean, tree-shaken). Pure follow math — the
+ * route feeds the returned position into its own camera each frame.
+ */
+export function createLeanCameraRig(options = {}) {
+    const kind = options.kind ?? "side-view-follow";
+    const offset = options.offset ?? (kind === "top-down-follow" ? [0, 9, 0.001] : [0, 1.6, 6.4]);
+    const smoothing = Math.max(0.1, options.smoothing ?? 6);
+    let position = [offset[0], offset[1], offset[2]];
+    const target = (focus) => [
+        focus[0] + offset[0],
+        focus[1] + offset[1],
+        focus[2] + offset[2]
+    ];
+    return {
+        kind,
+        get position() {
+            return position;
+        },
+        follow(focus, dtSeconds) {
+            const goal = target(focus);
+            const alpha = 1 - Math.exp(-smoothing * Math.max(0, dtSeconds));
+            position = [
+                position[0] + (goal[0] - position[0]) * alpha,
+                position[1] + (goal[1] - position[1]) * alpha,
+                position[2] + (goal[2] - position[2]) * alpha
+            ];
+            return position;
+        },
+        snap(focus) {
+            position = target(focus);
+            return position;
+        }
+    };
+}
+/**
+ * J3 game feel (F3 surface for lean, tree-shaken). Trauma/screen-shake/hit-stop
+ * as pure state: routes add trauma on hits and apply the shake offset to their
+ * camera. No renderer coupling, deterministic for replays.
+ */
+export function createLeanGameFeel(options = {}) {
+    const traumaDecay = Math.max(0.1, options.traumaDecay ?? 1.6);
+    const maxShake = Math.max(0, options.maxShake ?? 0.25);
+    const hitStopDuration = Math.max(0, options.hitStopDuration ?? 0.06);
+    let trauma = 0;
+    let frozenTime = 0;
+    // Deterministic pseudo-random shake (seeded counter, not Math.random) so replays stay exact.
+    let shakeTick = 0;
+    const shakePhase = () => {
+        shakeTick += 1;
+        const a = Math.sin(shakeTick * 12.9898) * 43758.5453;
+        const b = Math.sin(shakeTick * 78.233) * 12543.1234;
+        return [a - Math.floor(a) - 0.5, b - Math.floor(b) - 0.5];
+    };
+    return {
+        addTrauma(amount) {
+            trauma = Math.min(1, Math.max(0, trauma + Math.max(0, amount)));
+            return trauma;
+        },
+        hitStop() {
+            frozenTime = hitStopDuration;
+        },
+        update(dtSeconds) {
+            const dt = Math.max(0, dtSeconds);
+            if (frozenTime > 0) {
+                frozenTime = Math.max(0, frozenTime - dt);
+                return { trauma, shake: [0, 0], frozen: frozenTime > 0 };
+            }
+            trauma = Math.max(0, trauma - traumaDecay * dt);
+            const magnitude = trauma * trauma * maxShake;
+            const [px, py] = shakePhase();
+            return { trauma, shake: [px * 2 * magnitude, py * 2 * magnitude], frozen: false };
+        },
+        snapshot() {
+            return { trauma, frozen: frozenTime > 0 };
+        }
+    };
+}
+/** J3 debug-draw toggle (tree-shaken). Routes gate collision-volume overlays on it. */
+export function createLeanDebugDraw(initial = false) {
+    let enabled = initial;
+    return {
+        get enabled() {
+            return enabled;
+        },
+        setEnabled(next) {
+            enabled = next;
+            return enabled;
+        },
+        toggle() {
+            enabled = !enabled;
+            return enabled;
+        }
+    };
+}
+/**
+ * J3 perf governor (J1 policy for lean, tree-shaken). Same two-rung headroom
+ * discipline as the engine governor, reduced to the knobs a lean route owns
+ * (resolution + particle scale). Engine routes use the full governor from
+ * `@aura3d/engine/production-runtime` instead.
+ */
+export function createLeanPerformanceGovernor(mode = "conservative") {
+    const resolutions = [1, 0.85, 0.7, 0.5];
+    const particles = [1, 0.7, 0.4, 0.2];
+    let settings = { resolutionScale: 1, particleScale: 1 };
+    let headroomFrames = 0;
+    const degraded = [];
+    const atFloor = () => settings.resolutionScale === 0.5 && settings.particleScale === 0.2;
+    return {
+        mode,
+        get settings() {
+            return settings;
+        },
+        get degraded() {
+            return degraded;
+        },
+        step(frameTimeMs) {
+            if (mode === "off")
+                return settings;
+            if (frameTimeMs > 16.7) {
+                headroomFrames = 0;
+                const steps = mode === "aggressive" ? 2 : 1;
+                for (let i = 0; i < steps && !atFloor(); i += 1) {
+                    if (settings.resolutionScale !== 0.5) {
+                        settings = {
+                            ...settings,
+                            resolutionScale: resolutions[Math.min(3, resolutions.indexOf(settings.resolutionScale) + 1)] ?? 0.5
+                        };
+                        degraded.push("resolutionScale");
+                    }
+                    else {
+                        settings = {
+                            ...settings,
+                            particleScale: particles[Math.min(3, particles.indexOf(settings.particleScale) + 1)] ?? 0.2
+                        };
+                        degraded.push("particleScale");
+                    }
+                }
+                return settings;
+            }
+            if (frameTimeMs <= 16.7 * 0.8) {
+                headroomFrames += 1;
+                const threshold = mode === "aggressive" ? 2 : 4;
+                if (headroomFrames >= threshold && (settings.resolutionScale !== 1 || settings.particleScale !== 1)) {
+                    headroomFrames = 0;
+                    if (settings.particleScale !== 1) {
+                        settings = {
+                            ...settings,
+                            particleScale: particles[Math.max(0, particles.indexOf(settings.particleScale) - 1)] ?? 1
+                        };
+                        degraded.push("recovered:particleScale");
+                    }
+                    else {
+                        settings = {
+                            ...settings,
+                            resolutionScale: resolutions[Math.max(0, resolutions.indexOf(settings.resolutionScale) - 1)] ?? 1
+                        };
+                        degraded.push("recovered:resolutionScale");
+                    }
+                }
+            }
+            else {
+                headroomFrames = 0;
+            }
+            return settings;
+        }
+    };
+}
+/**
+ * J3 text surface for lean (G1 SDF scope, tree-shaken). Pure atlas bake +
+ * quad layout over the uppercase-alphanumeric catalog; the native sampler +
+ * pixel proof remain G1 work, hence `pixelBacked: false` by construction.
+ */
+export function createLeanText(options = {}) {
+    const atlas = createSdfFontAtlas(options.atlas);
+    const baseLayout = options.layout;
+    return {
+        atlas,
+        supportedGlyphs: SDF_SUPPORTED_GLYPHS,
+        scopeNote: SDF_FONT_SCOPE_NOTE,
+        pixelBacked: false,
+        layout(text, layoutOptions) {
+            return layoutSdfText(text, atlas, { ...baseLayout, ...layoutOptions });
+        }
+    };
+}
 export const game = {
     input: createLeanGameInput,
     platformer: createLeanPlatformer,
+    cameraRig: createLeanCameraRig,
+    gameFeel: createLeanGameFeel,
+    debugDraw: createLeanDebugDraw,
+    performanceGovernor: createLeanPerformanceGovernor,
+    text: createLeanText,
     runtime: "lean-deterministic-arcade"
 };
 //# sourceMappingURL=game.js.map

package/dist/lean/game.js.map

@@ -1 +1 @@
-{"version":3,"file":"game.js","sourceRoot":"","sources":["../../../../packages/lean/src/game.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,gBAAgB,EAIlC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EAGrB,MAAM,oBAAoB,CAAC;AAE5B,cAAc,cAAc,CAAC;AAO7B;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB,EAAE,OAAiC;IACxF,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;QACrD,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IACH,OAAO;QACL,GAAG,IAAI;QACP,KAAK,CAAC,YAAY;YAChB,MAAM,KAAK,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO;YACL,gBAAgB,EAAE,CAAC;YACnB,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,KAAK,EAAE,mBAAmB;IAC1B,UAAU,EAAE,oBAAoB;IAChC,OAAO,EAAE,2BAA2B;CAC5B,CAAC"}
+{"version":3,"file":"game.js","sourceRoot":"","sources":["../../../../packages/lean/src/game.ts"],"names":[],"mappings":"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"}

package/dist/materials/GameReadyMaterialLibrary.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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.
+ */
+export type GameReadyMaterialKind = "carPaint" | "skinSSS-approx" | "glassThin" | "brushedMetal" | "foliage" | "concreteAsphalt";
+export interface GameReadyMaterialTunable {
+    readonly name: string;
+    readonly default: number | string;
+    readonly range: string;
+    readonly effect: string;
+}
+export interface GameReadyMaterialProbe {
+    readonly geometry: "sphere" | "beveled-cube" | "thin-pane" | "card";
+    readonly environmentId: string;
+    readonly screenshot: string;
+}
+export interface GameReadyMaterialPreset {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: GameReadyMaterialKind;
+    readonly features: readonly string[];
+    readonly parameters: Readonly<Record<string, number | string | readonly number[]>>;
+    readonly exampleSnippet: string;
+    readonly tunables: readonly GameReadyMaterialTunable[];
+    readonly probe: GameReadyMaterialProbe;
+    readonly note: string;
+}
+export declare const GAME_READY_MATERIAL_PRESETS: readonly GameReadyMaterialPreset[];
+export declare const GAME_READY_MATERIAL_IDS: readonly string[];
+export declare function listGameReadyMaterials(): readonly GameReadyMaterialPreset[];
+export declare function findGameReadyMaterial(id: string): GameReadyMaterialPreset | undefined;
+//# sourceMappingURL=GameReadyMaterialLibrary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameReadyMaterialLibrary.d.ts","sourceRoot":"","sources":["../../../../packages/materials/src/GameReadyMaterialLibrary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,cAAc,GACd,SAAS,GACT,iBAAiB,CAAC;AAEtB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACnF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAID,eAAO,MAAM,2BAA2B,EAAE,SAAS,uBAAuB,EAwOzE,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAA2D,CAAC;AAEjH,wBAAgB,sBAAsB,IAAI,SAAS,uBAAuB,EAAE,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAErF"}

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"}