@skenora/scene-plan 0.1.2

package/dist/description/example-recipes.js

@@ -0,0 +1,1097 @@
+import { validateFieldRule, } from "@skenora/contracts";
+import { SCENE_BLUEPRINT_SCHEMA, } from "../model/types.js";
+const parameter = (description, values = {}) => ({
+    type: "number",
+    description,
+    update: "parameter",
+    ...values,
+});
+const color = {
+    type: "object",
+    description: "Linear RGB",
+    required: ["r", "g", "b"],
+    additionalProperties: false,
+    properties: {
+        r: parameter("Linear red", { minimum: 0, maximum: 64 }),
+        g: parameter("Linear green", { minimum: 0, maximum: 64 }),
+        b: parameter("Linear blue", { minimum: 0, maximum: 64 }),
+    },
+};
+export const CLIPPING_SECTION_RECIPE_OPTIONS_RULE = {
+    type: "object",
+    description: "Create an ordinary clipped sphere Blueprint and an optional fitted companion cap",
+    additionalProperties: false,
+    properties: {
+        id: {
+            type: "string",
+            description: "Stable scene and generated-ID prefix",
+            minLength: 1,
+        },
+        radius: parameter("Sphere radius", {
+            minimum: 0.1,
+            maximum: 1000,
+            default: 1,
+            unit: "meters",
+            update: "rebuild",
+        }),
+        offset: parameter("Clip-plane offset along local Z", {
+            minimum: -1000,
+            maximum: 1000,
+            default: 0,
+            unit: "meters",
+        }),
+        side: {
+            type: "string",
+            description: "Retained local-Z half-space",
+            enum: ["positive", "negative"],
+            default: "positive",
+            update: "parameter",
+        },
+        edgeWidth: parameter("Cut-edge emission width", {
+            minimum: 0,
+            maximum: 100,
+            default: 0.035,
+            unit: "meters",
+        }),
+        edgeColor: color,
+        edgeIntensity: parameter("Cut-edge emission multiplier", {
+            minimum: 0,
+            maximum: 64,
+            default: 4,
+        }),
+        surfaceColor: color,
+        capColor: color,
+        cap: {
+            type: "boolean",
+            description: "Add an ordinary plane entity fitted to the initial spherical section",
+            default: true,
+            update: "rebuild",
+        },
+    },
+};
+export function createClippingSectionRecipe(options = {}) {
+    assertRecipeOptions(options, CLIPPING_SECTION_RECIPE_OPTIONS_RULE);
+    const id = normalizeRecipeId(options.id ?? "clipping-section");
+    const radius = options.radius ?? 1;
+    const offset = options.offset ?? 0;
+    if (Math.abs(offset) >= radius)
+        throw new Error("Clipping offset must remain inside the sphere radius");
+    const side = options.side ?? "positive";
+    const edgeColor = cloneColor(options.edgeColor, { r: 0.08, g: 1.2, b: 0.8 });
+    const surfaceColor = cloneColor(options.surfaceColor, {
+        r: 0.04,
+        g: 0.23,
+        b: 0.46,
+    });
+    const capColor = cloneColor(options.capColor, { r: 0.025, g: 0.12, b: 0.18 });
+    const includeCap = options.cap ?? true;
+    const capDiameter = Math.sqrt(radius * radius - offset * offset) * 2 * 0.995;
+    const capRadius = capDiameter / 2;
+    const capPoints = Array.from({ length: 48 }, (_, index) => {
+        const angle = (index / 48) * Math.PI * 2;
+        return {
+            x: Math.cos(angle) * capRadius,
+            y: 0,
+            z: Math.sin(angle) * capRadius,
+        };
+    });
+    const capZ = offset + (side === "positive" ? 0.001 : -0.001);
+    return {
+        schema: SCENE_BLUEPRINT_SCHEMA,
+        version: 1,
+        scene: { id, name: "Clipping Section" },
+        entities: [
+            {
+                id: `${id}-body`,
+                kind: "primitive",
+                primitive: "sphere",
+                diameter: radius * 2,
+            },
+            ...(includeCap
+                ? [
+                    {
+                        id: `${id}-cap`,
+                        kind: "shape",
+                        shape: "polygon",
+                        points: capPoints,
+                        closed: true,
+                        strokeColor: edgeColor,
+                        transform: {
+                            position: { x: 0, y: 0, z: capZ },
+                            rotationRadians: {
+                                x: side === "positive" ? Math.PI / 2 : -Math.PI / 2,
+                                y: 0,
+                                z: 0,
+                            },
+                        },
+                    },
+                ]
+                : []),
+        ],
+        materials: [
+            {
+                id: `${id}-surface`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: surfaceColor,
+                metallic: 0.15,
+                roughness: 0.27,
+                effects: {
+                    version: 2,
+                    clip: {
+                        planeNormal: { x: 0, y: 0, z: 1 },
+                        offset,
+                        side,
+                        space: "local",
+                        edgeWidth: options.edgeWidth ?? 0.035,
+                        edgeColor,
+                        edgeIntensity: options.edgeIntensity ?? 4,
+                    },
+                },
+                animations: [
+                    {
+                        version: 1,
+                        id: "clip-sweep",
+                        property: "clipOffset",
+                        from: offset,
+                        to: offset === 0 ? radius * 0.35 : offset * 0.5,
+                        durationMs: 900,
+                        easing: "easeInOut",
+                        loop: "ping-pong",
+                        autoStart: false,
+                    },
+                ],
+            },
+            ...(includeCap
+                ? [
+                    {
+                        id: `${id}-cap-surface`,
+                        creation: { version: 1, family: "pbr" },
+                        baseColor: capColor,
+                        emissiveColor: edgeColor,
+                        emissiveIntensity: 0.45,
+                        metallic: 0.25,
+                        roughness: 0.32,
+                        doubleSided: true,
+                    },
+                ]
+                : []),
+        ],
+        materialBindings: [
+            {
+                id: `${id}-body-surface`,
+                materialId: `${id}-surface`,
+                entityId: `${id}-body`,
+            },
+            ...(includeCap
+                ? [
+                    {
+                        id: `${id}-cap-binding`,
+                        materialId: `${id}-cap-surface`,
+                        entityId: `${id}-cap`,
+                        target: { nodeId: `${id}-cap-fill`, slot: 0 },
+                    },
+                ]
+                : []),
+        ],
+        camera: {
+            mode: "orbit",
+            position: { x: radius * 2.7, y: radius * 1.8, z: radius * -4.2 },
+            target: { x: 0, y: 0, z: 0 },
+        },
+        environment: {
+            enabled: false,
+            background: { mode: "color", color: "#050c13" },
+        },
+        lights: [
+            {
+                id: `${id}-fill`,
+                type: "hemispheric",
+                enabled: true,
+                intensity: 1.1,
+                color: { r: 0.75, g: 0.88, b: 1 },
+                rotation: { x: -Math.PI / 2, y: 0, z: 0 },
+            },
+        ],
+        postProcess: {
+            enabled: true,
+            antialiasing: "fxaa",
+            toneMappingEnabled: true,
+            toneMappingType: "aces",
+            exposure: 1,
+            glow: true,
+            depthOfField: false,
+            ssao: { enabled: false },
+        },
+    };
+}
+export const NEON_LED_RECIPE_OPTIONS_RULE = {
+    type: "object",
+    description: "Create an ordinary neon panel Blueprint using the public analytic surface effect and shared animation clock",
+    additionalProperties: false,
+    properties: {
+        id: {
+            type: "string",
+            description: "Stable scene and generated-ID prefix",
+            minLength: 1,
+        },
+        width: parameter("Panel width", {
+            minimum: 0.1,
+            maximum: 1000,
+            default: 3.2,
+            unit: "meters",
+            update: "rebuild",
+        }),
+        height: parameter("Panel height", {
+            minimum: 0.1,
+            maximum: 1000,
+            default: 2,
+            unit: "meters",
+            update: "rebuild",
+        }),
+        color,
+        intensity: parameter("Surface emission multiplier", {
+            minimum: 0,
+            maximum: 64,
+            default: 5,
+        }),
+        cellScale: parameter("Analytic cells per meter", {
+            minimum: 0.01,
+            maximum: 1000,
+            default: 4.5,
+            unit: "per-meter",
+        }),
+        lineWidth: parameter("Normalized analytic line half-width", {
+            minimum: 0.001,
+            maximum: 0.25,
+            default: 0.042,
+        }),
+        pulseStrength: parameter("Pulse modulation fraction", {
+            minimum: 0,
+            maximum: 1,
+            default: 0.4,
+        }),
+        pulseDurationMs: parameter("One pulse cycle", {
+            minimum: 100,
+            maximum: 60000,
+            default: 2400,
+            unit: "milliseconds",
+        }),
+        glow: {
+            type: "boolean",
+            description: "Enable the existing explicit scene glow pipeline",
+            default: true,
+        },
+    },
+};
+export function createNeonLedRecipe(options = {}) {
+    assertRecipeOptions(options, NEON_LED_RECIPE_OPTIONS_RULE);
+    const id = normalizeRecipeId(options.id ?? "neon-led");
+    const colorValue = cloneColor(options.color, { r: 0.06, g: 0.65, b: 1.4 });
+    return {
+        schema: SCENE_BLUEPRINT_SCHEMA,
+        version: 1,
+        scene: { id, name: "Neon LED" },
+        entities: [
+            {
+                id: `${id}-panel`,
+                kind: "primitive",
+                primitive: "plane",
+                width: options.width ?? 3.2,
+                height: options.height ?? 2,
+            },
+        ],
+        materials: [
+            {
+                id: `${id}-surface`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.003, g: 0.008, b: 0.018 },
+                metallic: 0.15,
+                roughness: 0.4,
+                doubleSided: true,
+                effects: {
+                    version: 2,
+                    neon: {
+                        color: colorValue,
+                        intensity: options.intensity ?? 5,
+                        scale: options.cellScale ?? 4.5,
+                        width: options.lineWidth ?? 0.042,
+                        plane: "xy",
+                        phase: 0,
+                        pulseStrength: options.pulseStrength ?? 0.4,
+                    },
+                },
+                animations: [
+                    {
+                        version: 1,
+                        id: "pulse",
+                        property: "neonPhase",
+                        from: 0,
+                        to: 1,
+                        durationMs: options.pulseDurationMs ?? 2400,
+                        easing: "linear",
+                        loop: "repeat",
+                        autoStart: true,
+                    },
+                ],
+            },
+        ],
+        materialBindings: [
+            {
+                id: `${id}-panel-surface`,
+                materialId: `${id}-surface`,
+                entityId: `${id}-panel`,
+            },
+        ],
+        camera: {
+            mode: "orbit",
+            position: { x: 0, y: 0, z: -4.8 },
+            target: { x: 0, y: 0, z: 0 },
+        },
+        environment: {
+            enabled: false,
+            background: { mode: "color", color: "#02050c" },
+        },
+        lights: [
+            {
+                id: `${id}-fill`,
+                type: "hemispheric",
+                enabled: true,
+                intensity: 0.16,
+                color: { r: 0.5, g: 0.65, b: 1 },
+                rotation: { x: -Math.PI / 2, y: 0, z: 0 },
+            },
+        ],
+        postProcess: {
+            enabled: true,
+            antialiasing: "fxaa",
+            toneMappingEnabled: true,
+            toneMappingType: "aces",
+            exposure: 1,
+            glow: options.glow ?? true,
+            bloom: false,
+            depthOfField: false,
+            ssao: { enabled: false },
+        },
+    };
+}
+export const PROCEDURAL_EARTH_RECIPE_OPTIONS_RULE = {
+    type: "object",
+    description: "Create a procedural planet from bounded generated albedo, night and cloud textures",
+    additionalProperties: false,
+    properties: {
+        id: { type: "string", description: "Stable scene prefix", minLength: 1 },
+        radius: parameter("Planet radius", {
+            minimum: 0.1,
+            maximum: 1000,
+            default: 1,
+            unit: "meters",
+            update: "rebuild",
+        }),
+        seed: {
+            type: "integer",
+            description: "Deterministic procedural seed",
+            minimum: -1e9,
+            maximum: 1e9,
+            default: 24051969,
+            update: "rebuild",
+        },
+        textureSize: {
+            type: "integer",
+            description: "Generated equirectangular texture height",
+            minimum: 32,
+            maximum: 512,
+            default: 128,
+            update: "rebuild",
+        },
+        cloudOpacity: parameter("Cloud shell opacity", {
+            minimum: 0,
+            maximum: 1,
+            default: 0.72,
+        }),
+    },
+};
+export function createProceduralEarthRecipe(options = {}) {
+    assertRecipeOptions(options, PROCEDURAL_EARTH_RECIPE_OPTIONS_RULE);
+    const id = normalizeRecipeId(options.id ?? "procedural-earth");
+    const radius = options.radius ?? 1;
+    const seed = options.seed ?? 24051969;
+    const height = options.textureSize ?? 128;
+    const generated = (kind, colorSpace) => ({
+        schema: "skenora.texture.program",
+        version: 1,
+        kind,
+        width: height * 2,
+        height,
+        format: "rgba8unorm",
+        colorSpace,
+        lifecycle: "static",
+        seed: seed + (kind === "planet-night" ? 17 : kind === "planet-clouds" ? 31 : 0),
+        scale: kind === "planet-clouds" ? 7 : 4.2,
+        octaves: kind === "planet-night" ? 4 : 5,
+    });
+    return {
+        schema: SCENE_BLUEPRINT_SCHEMA,
+        version: 1,
+        scene: { id, name: "Procedural Earth" },
+        entities: [
+            {
+                id: `${id}-surface`,
+                kind: "primitive",
+                primitive: "sphere",
+                diameter: radius * 2,
+            },
+            {
+                id: `${id}-clouds`,
+                kind: "primitive",
+                primitive: "sphere",
+                diameter: radius * 2.035,
+            },
+            {
+                id: `${id}-atmosphere`,
+                kind: "primitive",
+                primitive: "sphere",
+                diameter: radius * 2.11,
+            },
+        ],
+        materials: [
+            {
+                id: `${id}-planet-material`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.55, g: 0.65, b: 0.85 },
+                metallic: 0.04,
+                roughness: 0.7,
+                emissiveColor: { r: 1, g: 0.58, b: 0.12 },
+                emissiveIntensity: 0.72,
+                generatedTextures: {
+                    baseColor: generated("planet-albedo", "srgb"),
+                    emissive: generated("planet-night", "srgb"),
+                },
+            },
+            {
+                id: `${id}-cloud-material`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.88, g: 0.94, b: 1 },
+                roughness: 0.92,
+                metallic: 0,
+                alpha: options.cloudOpacity ?? 0.72,
+                transparencyMode: 2,
+                doubleSided: true,
+                generatedTextures: {
+                    opacity: generated("planet-clouds", "linear"),
+                },
+            },
+            {
+                id: `${id}-atmosphere-material`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.015, g: 0.06, b: 0.14 },
+                alpha: 0.12,
+                transparencyMode: 2,
+                roughness: 0.9,
+                metallic: 0,
+                doubleSided: true,
+                effects: {
+                    version: 1,
+                    rim: {
+                        color: { r: 0.05, g: 0.42, b: 1.6 },
+                        intensity: 3.2,
+                        power: 2.4,
+                    },
+                },
+            },
+        ],
+        materialBindings: [
+            {
+                id: `${id}-surface-binding`,
+                materialId: `${id}-planet-material`,
+                entityId: `${id}-surface`,
+            },
+            {
+                id: `${id}-cloud-binding`,
+                materialId: `${id}-cloud-material`,
+                entityId: `${id}-clouds`,
+            },
+            {
+                id: `${id}-atmosphere-binding`,
+                materialId: `${id}-atmosphere-material`,
+                entityId: `${id}-atmosphere`,
+            },
+        ],
+        camera: {
+            mode: "orbit",
+            position: { x: radius * 2.8, y: radius * 1.35, z: radius * -4.2 },
+            target: { x: 0, y: 0, z: 0 },
+        },
+        environment: {
+            enabled: false,
+            background: { mode: "color", color: "#01040b" },
+        },
+        lights: [
+            {
+                id: `${id}-sun`,
+                type: "directional",
+                enabled: true,
+                intensity: 3.2,
+                color: { r: 1, g: 0.9, b: 0.72 },
+                rotation: { x: -0.45, y: -0.8, z: 0 },
+            },
+            {
+                id: `${id}-space-fill`,
+                type: "hemispheric",
+                enabled: true,
+                intensity: 0.12,
+                color: { r: 0.15, g: 0.25, b: 0.55 },
+                rotation: { x: -Math.PI / 2, y: 0, z: 0 },
+            },
+        ],
+        postProcess: {
+            enabled: true,
+            antialiasing: "fxaa",
+            toneMappingEnabled: true,
+            toneMappingType: "aces",
+            exposure: 1.15,
+            glow: true,
+            bloom: false,
+            depthOfField: false,
+            ssao: { enabled: false },
+        },
+    };
+}
+export const LAVA_SURFACE_RECIPE_OPTIONS_RULE = {
+    type: "object",
+    description: "Create a bounded MaterialProgram V2 lava surface with trusted 3D noise and scalar PBR outputs",
+    additionalProperties: false,
+    properties: {
+        id: { type: "string", description: "Stable scene prefix", minLength: 1 },
+        radius: parameter("Lava sphere radius", {
+            minimum: 0.1,
+            maximum: 1000,
+            default: 1,
+            unit: "meters",
+            update: "rebuild",
+        }),
+        scale: parameter("Noise frequency", {
+            minimum: 0.1,
+            maximum: 64,
+            default: 4.8,
+        }),
+        emission: parameter("HDR fissure emission", {
+            minimum: 0,
+            maximum: 32,
+            default: 5.5,
+        }),
+        seed: {
+            type: "integer",
+            description: "Trusted noise seed",
+            minimum: -1e9,
+            maximum: 1e9,
+            default: 1337,
+            update: "rebuild",
+        },
+    },
+};
+export function createLavaSurfaceRecipe(options = {}) {
+    assertRecipeOptions(options, LAVA_SURFACE_RECIPE_OPTIONS_RULE);
+    const id = normalizeRecipeId(options.id ?? "lava-surface");
+    const radius = options.radius ?? 1;
+    const program = {
+        schema: "skenora.material.program",
+        version: 2,
+        parameters: {
+            scale: {
+                type: "number",
+                value: options.scale ?? 4.8,
+                minimum: 0.1,
+                maximum: 64,
+            },
+            emission: {
+                type: "number",
+                value: options.emission ?? 5.5,
+                minimum: 0,
+                maximum: 32,
+            },
+        },
+        nodes: [
+            {
+                id: "x",
+                type: "input.coordinate",
+                space: "local",
+                axis: "x",
+            },
+            {
+                id: "y",
+                type: "input.coordinate",
+                space: "local",
+                axis: "y",
+            },
+            {
+                id: "z",
+                type: "input.coordinate",
+                space: "local",
+                axis: "z",
+            },
+            { id: "scale", type: "parameter.number", parameter: "scale" },
+            {
+                id: "emission",
+                type: "parameter.number",
+                parameter: "emission",
+            },
+            { id: "zero", type: "value.number", value: 0 },
+            { id: "one", type: "value.number", value: 1 },
+            { id: "edge0", type: "value.number", value: 0.25 },
+            { id: "edge1", type: "value.number", value: 0.72 },
+            { id: "roughBase", type: "value.number", value: 0.84 },
+            { id: "roughDrop", type: "value.number", value: 0.58 },
+            { id: "metalScale", type: "value.number", value: 0.12 },
+            {
+                id: "rock",
+                type: "value.color",
+                value: { r: 0.008, g: 0.004, b: 0.006 },
+            },
+            {
+                id: "magma",
+                type: "value.color",
+                value: { r: 1.45, g: 0.13, b: 0.008 },
+            },
+            {
+                id: "fbm",
+                type: "noise.fbm3d",
+                x: "x",
+                y: "y",
+                z: "z",
+                scale: "scale",
+                octaves: 5,
+                seed: options.seed ?? 1337,
+            },
+            {
+                id: "cell",
+                type: "noise.voronoi3d",
+                x: "x",
+                y: "y",
+                z: "z",
+                scale: "scale",
+                seed: (options.seed ?? 1337) + 97,
+            },
+            { id: "crack", type: "math.subtract", a: "one", b: "cell" },
+            { id: "field", type: "math.multiply", a: "crack", b: "fbm" },
+            {
+                id: "heat",
+                type: "math.smoothstep",
+                edge0: "edge0",
+                edge1: "edge1",
+                input: "field",
+            },
+            {
+                id: "base",
+                type: "color.mix",
+                a: "rock",
+                b: "magma",
+                factor: "heat",
+            },
+            { id: "hot", type: "math.multiply", a: "heat", b: "emission" },
+            {
+                id: "emissive",
+                type: "color.scale",
+                color: "magma",
+                factor: "hot",
+            },
+            {
+                id: "roughDelta",
+                type: "math.multiply",
+                a: "heat",
+                b: "roughDrop",
+            },
+            {
+                id: "roughness",
+                type: "math.subtract",
+                a: "roughBase",
+                b: "roughDelta",
+            },
+            {
+                id: "metallic",
+                type: "math.multiply",
+                a: "heat",
+                b: "metalScale",
+            },
+        ],
+        outputs: {
+            baseColor: "base",
+            emissive: "emissive",
+            roughness: "roughness",
+            metallic: "metallic",
+        },
+    };
+    return {
+        schema: SCENE_BLUEPRINT_SCHEMA,
+        version: 1,
+        scene: { id, name: "Lava Surface" },
+        entities: [
+            {
+                id: `${id}-body`,
+                kind: "primitive",
+                primitive: "sphere",
+                diameter: radius * 2,
+            },
+        ],
+        materials: [
+            {
+                id: `${id}-material`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.01, g: 0.005, b: 0.008 },
+                roughness: 0.8,
+                metallic: 0,
+                program,
+            },
+        ],
+        materialBindings: [
+            {
+                id: `${id}-binding`,
+                materialId: `${id}-material`,
+                entityId: `${id}-body`,
+            },
+        ],
+        camera: {
+            mode: "orbit",
+            position: { x: radius * 2.5, y: radius * 1.3, z: radius * -4 },
+            target: { x: 0, y: 0, z: 0 },
+        },
+        environment: {
+            enabled: false,
+            background: { mode: "color", color: "#050003" },
+        },
+        lights: [
+            {
+                id: `${id}-fill`,
+                type: "hemispheric",
+                enabled: true,
+                intensity: 0.34,
+                color: { r: 0.35, g: 0.08, b: 0.05 },
+                rotation: { x: -Math.PI / 2, y: 0, z: 0 },
+            },
+        ],
+        postProcess: {
+            enabled: true,
+            antialiasing: "fxaa",
+            toneMappingEnabled: true,
+            toneMappingType: "aces",
+            exposure: 0.85,
+            glow: true,
+            bloom: false,
+            depthOfField: false,
+            ssao: { enabled: false },
+        },
+    };
+}
+export const GLASS_TRANSMISSION_RECIPE_OPTIONS_RULE = {
+    type: "object",
+    description: "Create a bounded scene-capture and blur RenderGraph attached to an owned glass surface",
+    additionalProperties: false,
+    properties: {
+        id: { type: "string", description: "Stable scene prefix", minLength: 1 },
+        radius: parameter("Glass sphere radius", {
+            minimum: 0.1,
+            maximum: 1000,
+            default: 1,
+            update: "rebuild",
+        }),
+        indexOfRefraction: parameter("Index of refraction", {
+            minimum: 1,
+            maximum: 3,
+            default: 1.46,
+        }),
+        intensity: parameter("Transmission intensity", {
+            minimum: 0,
+            maximum: 1,
+            default: 0.92,
+        }),
+        dispersion: parameter("Chromatic dispersion strength", {
+            minimum: 0,
+            maximum: 1,
+            default: 0.22,
+        }),
+        blurRadius: parameter("Two-pass blur radius", {
+            minimum: 1,
+            maximum: 24,
+            default: 7,
+            update: "rebuild",
+        }),
+    },
+};
+export function createGlassTransmissionRecipe(options = {}) {
+    assertRecipeOptions(options, GLASS_TRANSMISSION_RECIPE_OPTIONS_RULE);
+    const id = normalizeRecipeId(options.id ?? "glass-transmission");
+    const radius = options.radius ?? 1;
+    const graph = {
+        schema: "skenora.render.graph",
+        version: 1,
+        targets: [
+            {
+                id: "scene",
+                size: "half",
+                format: "rgba8unorm",
+                samples: 1,
+                depth: true,
+            },
+            {
+                id: "blur-x",
+                size: "half",
+                format: "rgba8unorm",
+                samples: 1,
+                depth: false,
+            },
+            {
+                id: "blur-y",
+                size: "half",
+                format: "rgba8unorm",
+                samples: 1,
+                depth: false,
+            },
+        ],
+        passes: [
+            {
+                id: "capture",
+                type: "scene.capture",
+                output: "scene",
+                clearColor: "#040712",
+            },
+            {
+                id: "blur-horizontal",
+                type: "blur.gaussian",
+                input: "scene",
+                output: "blur-x",
+                radius: options.blurRadius ?? 7,
+                direction: "horizontal",
+            },
+            {
+                id: "blur-vertical",
+                type: "blur.gaussian",
+                input: "blur-x",
+                output: "blur-y",
+                radius: options.blurRadius ?? 7,
+                direction: "vertical",
+            },
+            {
+                id: "transmission",
+                type: "glass.transmission",
+                input: "blur-y",
+                output: "surface",
+                indexOfRefraction: options.indexOfRefraction ?? 1.46,
+                intensity: options.intensity ?? 0.92,
+                dispersion: options.dispersion ?? 0.22,
+                tint: { r: 0.72, g: 0.9, b: 1 },
+            },
+        ],
+    };
+    return {
+        schema: SCENE_BLUEPRINT_SCHEMA,
+        version: 1,
+        scene: { id, name: "Glass Transmission" },
+        entities: [
+            {
+                id: `${id}-glass`,
+                kind: "primitive",
+                primitive: "sphere",
+                diameter: radius * 2,
+            },
+            {
+                id: `${id}-backdrop-panel`,
+                kind: "primitive",
+                primitive: "plane",
+                size: radius * 4.8,
+                transform: { position: { x: 0, y: 0, z: radius * 2.75 } },
+            },
+            {
+                id: `${id}-backdrop-a`,
+                kind: "primitive",
+                primitive: "torus",
+                diameter: radius * 1.7,
+                transform: {
+                    position: { x: -0.65, y: 0.25, z: radius * 1.6 },
+                    rotationRadians: { x: 0.3, y: 0.6, z: 0 },
+                },
+            },
+            {
+                id: `${id}-backdrop-b`,
+                kind: "primitive",
+                primitive: "box",
+                size: radius * 0.85,
+                transform: {
+                    position: { x: 0.75, y: -0.38, z: radius * 1.85 },
+                    rotationRadians: { x: 0.2, y: 0.55, z: 0.4 },
+                },
+            },
+            {
+                id: `${id}-backdrop-c`,
+                kind: "primitive",
+                primitive: "cylinder",
+                diameter: radius * 0.7,
+                height: radius * 1.55,
+                transform: {
+                    position: { x: 0.05, y: 0.65, z: radius * 2.1 },
+                    rotationRadians: { x: 0.5, y: 0, z: 0.7 },
+                },
+            },
+        ],
+        materials: [
+            {
+                id: `${id}-glass-material`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.72, g: 0.9, b: 1 },
+                metallic: 0,
+                roughness: 0.08,
+                alpha: 1,
+                transparencyMode: 0,
+                indexOfRefraction: options.indexOfRefraction ?? 1.46,
+                doubleSided: true,
+                renderGraph: graph,
+            },
+            {
+                id: `${id}-backdrop`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.015, g: 0.055, b: 0.16 },
+                emissiveColor: { r: 0.01, g: 0.04, b: 0.18 },
+                emissiveIntensity: 1.1,
+                metallic: 0.1,
+                roughness: 0.65,
+            },
+            {
+                id: `${id}-cyan`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.01, g: 0.55, b: 0.9 },
+                emissiveColor: { r: 0, g: 0.22, b: 0.8 },
+                emissiveIntensity: 2.2,
+                metallic: 0.35,
+                roughness: 0.22,
+            },
+            {
+                id: `${id}-magenta`,
+                creation: { version: 1, family: "pbr" },
+                baseColor: { r: 0.75, g: 0.015, b: 0.42 },
+                emissiveColor: { r: 0.6, g: 0.005, b: 0.2 },
+                emissiveIntensity: 1.8,
+                metallic: 0.25,
+                roughness: 0.28,
+            },
+        ],
+        materialBindings: [
+            {
+                id: `${id}-glass-binding`,
+                materialId: `${id}-glass-material`,
+                entityId: `${id}-glass`,
+            },
+            {
+                id: `${id}-backdrop-binding`,
+                materialId: `${id}-backdrop`,
+                entityId: `${id}-backdrop-panel`,
+            },
+            {
+                id: `${id}-a-binding`,
+                materialId: `${id}-cyan`,
+                entityId: `${id}-backdrop-a`,
+            },
+            {
+                id: `${id}-b-binding`,
+                materialId: `${id}-magenta`,
+                entityId: `${id}-backdrop-b`,
+            },
+            {
+                id: `${id}-c-binding`,
+                materialId: `${id}-cyan`,
+                entityId: `${id}-backdrop-c`,
+            },
+        ],
+        camera: {
+            mode: "orbit",
+            position: { x: radius * 2.55, y: radius * 1.45, z: radius * -5.2 },
+            target: { x: 0, y: 0, z: radius * 0.6 },
+        },
+        environment: {
+            enabled: false,
+            background: { mode: "color", color: "#030611" },
+        },
+        lights: [
+            {
+                id: `${id}-key`,
+                type: "directional",
+                enabled: true,
+                intensity: 2.8,
+                color: { r: 0.55, g: 0.75, b: 1 },
+                rotation: { x: -0.6, y: -0.8, z: 0 },
+            },
+            {
+                id: `${id}-fill`,
+                type: "hemispheric",
+                enabled: true,
+                intensity: 0.55,
+                color: { r: 0.42, g: 0.22, b: 0.65 },
+                rotation: { x: -Math.PI / 2, y: 0, z: 0 },
+            },
+        ],
+        postProcess: {
+            enabled: true,
+            antialiasing: "fxaa",
+            toneMappingEnabled: true,
+            toneMappingType: "aces",
+            exposure: 1,
+            glow: true,
+            bloom: false,
+            depthOfField: false,
+            ssao: { enabled: false },
+        },
+    };
+}
+export function describeSkenoraExampleRecipes() {
+    return [
+        {
+            id: "clipping-section-v1",
+            version: 1,
+            purpose: "Create a clipped sphere plus an optional ordinary fitted cap without hidden geometry ownership",
+            options: CLIPPING_SECTION_RECIPE_OPTIONS_RULE,
+        },
+        {
+            id: "neon-led-v1",
+            version: 1,
+            purpose: "Create an analytic neon panel whose explicit phase uses the shared material animation clock",
+            options: NEON_LED_RECIPE_OPTIONS_RULE,
+        },
+        {
+            id: "procedural-earth-v1",
+            version: 1,
+            purpose: "Create a generated-texture planet, cloud shell and bounded atmosphere composition",
+            options: PROCEDURAL_EARTH_RECIPE_OPTIONS_RULE,
+        },
+        {
+            id: "lava-surface-v1",
+            version: 1,
+            purpose: "Drive visible PBR color, emission, roughness and metallic channels from MaterialProgram V2",
+            options: LAVA_SURFACE_RECIPE_OPTIONS_RULE,
+        },
+        {
+            id: "glass-transmission-v1",
+            version: 1,
+            purpose: "Attach an inspectable bounded scene-capture and blur RenderGraph to one owned glass material",
+            options: GLASS_TRANSMISSION_RECIPE_OPTIONS_RULE,
+        },
+    ].map((recipe) => ({
+        ...structuredClone(recipe),
+        rules: [
+            "Expansion returns ordinary detached SceneBlueprint input and never mutates caller options.",
+            "Generated IDs are deterministic from the bounded id option; no resources, imports, shader source or network locators are added.",
+            "The clipping cap is an ordinary companion entity fitted only to the initial section. Changing clip offset later does not secretly move that entity.",
+            "Neon is surface emission. Glow is an explicit existing post-process setting and volumetric scattering is not claimed.",
+        ],
+    }));
+}
+function assertRecipeOptions(value, rule) {
+    const issues = validateFieldRule(value, rule);
+    if (issues.length)
+        throw new Error(`Invalid example recipe option: ${issues[0].path.join(".")}`);
+}
+function normalizeRecipeId(value) {
+    if (!/^[A-Za-z][A-Za-z0-9._:-]{0,80}$/u.test(value))
+        throw new Error("Recipe ID must be a stable ID of at most 81 characters");
+    return value;
+}
+function cloneColor(value, fallback) {
+    return structuredClone(value ?? fallback);
+}
+//# sourceMappingURL=example-recipes.js.map