@aura3d/engine 3.0.0 → 4.0.0

package/dist/engine/agent-api/vfx/gameEffects.js

@@ -0,0 +1,244 @@
+// PR 0b-1 carve-out (CONTRACTS.md §3.2, GameRuntime.ts region) — verbatim move; 0 changed logic lines.
+import { addVec3, round, vec3 } from "../GameRuntime.js";
+import { material } from "../nodes/material.js";
+import { primitive } from "../nodes/primitives.js";
+import { prd07FlagOnFor, registerPendingGameEffects } from "./effects-api.js";
+/** §7.8 kind mapping — game-effects kind → AuraVfxKind preset name, plus the
+ * option translation (blue 0.6× block-spark; duration/radius → count/speed). */
+const GAME_TO_VFX = {
+    "hit-spark": { preset: "spark" },
+    "block-spark": { preset: "spark", color: [0.4, 0.7, 1], intensityScale: 0.6 },
+    "impact-decal": { preset: "impact-decal" },
+    "ground-dust": { preset: "dust" },
+    "dash-trail": { preset: "streak" },
+    "slash-trail": { preset: "streak" },
+    "impact-flash": { preset: "impact-flash" },
+    "aura-burst": { preset: "aura-burst" },
+    shockwave: { preset: "ring" },
+    "ring-shockwave": { preset: "ring" },
+    "super-flash": { preset: "super-flash" }
+};
+export function createGameEffects(options = {}) {
+    const poolSize = options.poolSize ?? 96;
+    const reducedMotion = options.reducedMotion ?? false;
+    const reducedFlash = options.reducedFlash ?? false;
+    const legacyPrimitiveNodes = options.legacyPrimitiveNodes ?? false;
+    let spawned = 0;
+    let effects = [];
+    // §6.3.4 bound state: when bound, spawn forwards to app.effects.spawn and
+    // the app's onFrame drives update(). The local pool is still maintained so
+    // snapshot()/update() semantics don't change for consumers (GameFeel ports).
+    let boundApp = options.app ? options.app : null;
+    let boundOff = null;
+    const boundSpawn = (kind, position, effectOptions) => {
+        const fx = boundApp?.effects;
+        if (!fx)
+            return;
+        const map = GAME_TO_VFX[kind];
+        fx.spawn(map.preset, position, {
+            color: effectOptions.color ?? map.color,
+            intensity: (effectOptions.intensity ?? 1) * (map.intensityScale ?? 1),
+            count: Math.max(4, Math.round((effectOptions.radius ?? defaultEffectRadius(kind)) * 32)),
+            seed: spawned
+        });
+    };
+    const snapshot = () => ({
+        kind: "aura-game-effects",
+        active: effects.length,
+        spawned,
+        pooled: poolSize,
+        reducedMotion,
+        reducedFlash,
+        effects: effects.map(publicGameEffectInstance)
+    });
+    const spawn = (kind, position, effectOptions = {}) => {
+        spawned += 1;
+        boundSpawn(kind, resolveEffectAttachmentPosition(effectOptions.attachment, position), effectOptions);
+        const flashLimited = reducedFlash && (kind === "impact-flash" || kind === "super-flash");
+        const motionLimited = reducedMotion && (kind === "dash-trail" || kind === "slash-trail" || kind === "shockwave" || kind === "ring-shockwave");
+        const attachment = effectOptions.attachment;
+        const effect = {
+            id: effectOptions.ownerId ? `${effectOptions.ownerId}:${kind}:${spawned}` : `${kind}:${spawned}`,
+            kind,
+            position: resolveEffectAttachmentPosition(attachment, position),
+            color: effectOptions.color ?? defaultEffectColor(kind),
+            intensity: Math.min(effectOptions.intensity ?? 1, flashLimited ? 0.35 : motionLimited ? 0.55 : Number.POSITIVE_INFINITY),
+            duration: Math.min(effectOptions.duration ?? defaultEffectDuration(kind), motionLimited ? 0.18 : Number.POSITIVE_INFINITY),
+            radius: effectOptions.radius ?? defaultEffectRadius(kind),
+            ownerId: effectOptions.ownerId,
+            attachmentId: attachment?.targetId ?? attachment?.id,
+            attachmentOffset: attachment?.offset,
+            attachment,
+            age: 0
+        };
+        if (effects.length >= poolSize)
+            effects.shift();
+        effects.push(effect);
+        return publicGameEffectInstance(effect);
+    };
+    const controller = {
+        spawn,
+        emit(combatEvents, effectOptions) {
+            const emitted = [];
+            for (const event of combatEvents) {
+                if (event.type === "hit")
+                    emitted.push(spawn("hit-spark", event.position, { ownerId: event.attackerId, ...effectOptions }));
+                if (event.type === "blocked")
+                    emitted.push(spawn("block-spark", event.position, { ownerId: event.attackerId, ...effectOptions }));
+                if (event.type === "push")
+                    emitted.push(spawn("ground-dust", event.position, { ownerId: event.attackerId, intensity: 0.45, duration: 0.14, ...effectOptions }));
+            }
+            return emitted;
+        },
+        hitSpark: (position, effectOptions) => spawn("hit-spark", position, effectOptions),
+        blockSpark: (position, effectOptions) => spawn("block-spark", position, effectOptions),
+        impactDecal: (position, effectOptions) => spawn("impact-decal", position, effectOptions),
+        groundDust: (position, effectOptions) => spawn("ground-dust", position, effectOptions),
+        dashTrail: (position, effectOptions) => spawn("dash-trail", position, effectOptions),
+        slashTrail: (position, effectOptions) => spawn("slash-trail", position, effectOptions),
+        impactFlash: (position, effectOptions) => spawn("impact-flash", position, effectOptions),
+        auraBurst: (position, effectOptions) => spawn("aura-burst", position, effectOptions),
+        shockwave: (position, effectOptions) => spawn("shockwave", position, effectOptions),
+        ringShockwave: (position, effectOptions) => spawn("ring-shockwave", position, effectOptions),
+        superFlash: (position, effectOptions) => spawn("super-flash", position, effectOptions),
+        update(dt) {
+            const seconds = Math.max(0, dt);
+            effects = effects
+                .map((effect) => ({
+                ...effect,
+                position: resolveEffectAttachmentPosition(effect.attachment, effect.position),
+                age: effect.age + seconds
+            }))
+                .filter((effect) => effect.age <= effect.duration);
+            return snapshot();
+        },
+        snapshot,
+        nodes() {
+            if (boundApp && !legacyPrimitiveNodes)
+                return [];
+            return effects.map(effectToSceneNode);
+        },
+        clear() {
+            effects = [];
+            boundApp?.effects?.clear();
+        }
+    };
+    // §6.3.4 adoption: explicit flag-on app binds now; otherwise (autoMount
+    // default) the controller registers in the realm pending list and the
+    // effects extension binds it when exactly one flag-on app is live.
+    const bind = (app) => {
+        boundApp = app;
+        boundOff = app.onFrame?.((frame) => controller.update(frame.dt)) ?? null;
+    };
+    if (options.app && prd07FlagOnFor(options.app)) {
+        bind(options.app);
+    }
+    else if (options.autoMount !== false && !boundApp) {
+        registerPendingGameEffects({ label: "game-effects", bind: (app) => bind(app) });
+    }
+    void boundOff;
+    return controller;
+}
+export function publicGameEffectInstance(effect) {
+    const { attachment: _attachment, ...publicEffect } = effect;
+    return { ...publicEffect };
+}
+export function resolveEffectAttachmentPosition(attachment, fallback) {
+    if (!attachment?.getPosition)
+        return fallback;
+    return addVec3(attachment.getPosition(), vec3(attachment.offset, [0, 0, 0]));
+}
+export function defaultEffectColor(kind) {
+    if (kind === "block-spark")
+        return "#8ee7ff";
+    if (kind === "impact-decal")
+        return "#ff8b5c";
+    if (kind === "ground-dust")
+        return "#c7b38f";
+    if (kind === "dash-trail")
+        return "#62f6c8";
+    if (kind === "slash-trail")
+        return "#d7fbff";
+    if (kind === "aura-burst")
+        return "#5cff87";
+    if (kind === "shockwave" || kind === "ring-shockwave")
+        return "#ffd166";
+    if (kind === "impact-flash" || kind === "super-flash")
+        return "#ffffff";
+    return "#ffb84d";
+}
+export function defaultEffectDuration(kind) {
+    if (kind === "impact-decal")
+        return 0.7;
+    if (kind === "ground-dust")
+        return 0.34;
+    if (kind === "dash-trail")
+        return 0.28;
+    if (kind === "slash-trail")
+        return 0.18;
+    if (kind === "aura-burst")
+        return 0.9;
+    if (kind === "shockwave" || kind === "ring-shockwave")
+        return 0.42;
+    if (kind === "impact-flash")
+        return 0.12;
+    if (kind === "super-flash")
+        return 0.2;
+    return 0.22;
+}
+export function defaultEffectRadius(kind) {
+    if (kind === "impact-decal")
+        return 0.42;
+    if (kind === "aura-burst")
+        return 1.4;
+    if (kind === "shockwave" || kind === "ring-shockwave")
+        return 1.05;
+    if (kind === "dash-trail")
+        return 0.52;
+    if (kind === "slash-trail")
+        return 0.62;
+    if (kind === "ground-dust")
+        return 0.36;
+    if (kind === "super-flash")
+        return 1.2;
+    return 0.28;
+}
+export function effectToSceneNode(effect) {
+    const life = Math.max(0, 1 - effect.age / Math.max(0.001, effect.duration));
+    const ring = effect.kind === "shockwave" || effect.kind === "ring-shockwave";
+    const trail = effect.kind === "dash-trail" || effect.kind === "slash-trail";
+    const scalarScale = Math.max(0.04, effect.radius * (ring ? 1.4 - life * 0.4 : life));
+    const trailScale = [
+        Math.max(0.08, effect.radius * life * 1.6),
+        Math.max(0.02, effect.radius * life * 0.18),
+        Math.max(0.04, effect.radius * life * 0.32)
+    ];
+    if (effect.kind === "aura-burst") {
+        return {
+            kind: "effect",
+            effect: "particles",
+            name: effect.id,
+            color: effect.color,
+            intensity: effect.intensity * life,
+            particleCount: Math.round(160 + effect.intensity * 220),
+            emitter: "swirl",
+            radius: effect.radius,
+            height: 1.4,
+            materialMode: "additive-glow"
+        };
+    }
+    return {
+        kind: "primitive",
+        primitive: ring ? "torus" : trail ? "box" : "sphere",
+        name: effect.id,
+        position: effect.position,
+        scale: trail ? trailScale : scalarScale,
+        material: {
+            color: effect.color,
+            emissive: effect.color,
+            emissiveIntensity: effect.intensity * life,
+            opacity: life
+        }
+    };
+}
+//# sourceMappingURL=gameEffects.js.map

package/dist/engine/agent-api/vfx/gameEffects.js.map

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

package/dist/engine/agent-api/vfx/index.d.ts

@@ -0,0 +1,7 @@
+export { attachVfxBridge, type VfxBridge } from "./bridge.js";
+export { createAppEffects, createEffectsExtension, registerPrd07System, prd07SystemFor } from "./effects-api.js";
+export { createAtmosphereExtension } from "./atmosphere-api.js";
+export { collectEffectsSection, collectAtmosphereSection } from "./diagnostics.js";
+export { registerPrd07LookLintRules } from "./lookLint.js";
+export { AURA_VFX_BUILTIN_SEQUENCES, validateVfxAtlasManifest, vfxAtlasPageForTier, type AuraVfxAtlasManifest, type AuraVfxAtlasPage, type AuraVfxAtlasSequenceEntry, type AuraVfxBuiltinSequence } from "./atlas.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/agent-api/vfx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/vfx/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC5B,MAAM,SAAS,CAAC"}

package/dist/engine/agent-api/vfx/index.js

@@ -0,0 +1,8 @@
+// PRD-07 lane barrel — engine-side vfx/atmosphere surface.
+export { attachVfxBridge } from "./bridge.js";
+export { createAppEffects, createEffectsExtension, registerPrd07System, prd07SystemFor } from "./effects-api.js";
+export { createAtmosphereExtension } from "./atmosphere-api.js";
+export { collectEffectsSection, collectAtmosphereSection } from "./diagnostics.js";
+export { registerPrd07LookLintRules } from "./lookLint.js";
+export { AURA_VFX_BUILTIN_SEQUENCES, validateVfxAtlasManifest, vfxAtlasPageForTier } from "./atlas.js";
+//# sourceMappingURL=index.js.map

package/dist/engine/agent-api/vfx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/vfx/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAE,eAAe,EAAkB,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EAKpB,MAAM,SAAS,CAAC"}

package/dist/engine/agent-api/vfx/lookLint.d.ts

@@ -0,0 +1,2 @@
+export declare function registerPrd07LookLintRules(): void;
+//# sourceMappingURL=lookLint.d.ts.map

package/dist/engine/agent-api/vfx/lookLint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookLint.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/vfx/lookLint.ts"],"names":[],"mappings":"AAqEA,wBAAgB,0BAA0B,IAAI,IAAI,CAMjD"}

package/dist/engine/agent-api/vfx/lookLint.js

@@ -0,0 +1,66 @@
+// PRD-07 P1-T18 — look-lint rule `look/fake-effect-names` (PRD-07 §6.8).
+// Lane 07 owns this code (C-34) and its registration replaces the lane-13
+// default, so it must keep that default's coverage (#879). It flags:
+// (a) any node, including groups and their children, whose name matches the
+//     PRD-13 research §4.4 fake-effect names / stems (`isFakeEffectName`);
+// (b) `primitive` nodes named like VFX — the tell that a scene fakes an
+//     effect with geometry;
+// (c) `effect` nodes whose effect kind never produced pixels this frame
+//     (`capabilities.effectsPixelBacked`).
+// One finding per node; a node is reported at most once.
+import { registerLookLintRule } from "../../contracts/looks.js";
+// Pure data + matcher (no registration side effects). Imported by module path,
+// not through `lanes/prd13`, so loading lane 07 never installs lane 13.
+import { isFakeEffectName } from "../looks/fakeEffectNames.js";
+const FAKE_NAME = /spark|smoke|fire|rain|snow|explosion|trail|fog|sky/i;
+/** Every node in scene order, groups included (fake names hide on either). */
+function allNodes(nodes) {
+    const out = [];
+    const walk = (list) => {
+        for (const node of list) {
+            out.push(node);
+            if (node.kind === "group" && Array.isArray(node.children))
+                walk(node.children);
+        }
+    };
+    walk(nodes);
+    return out;
+}
+function finding(message, name) {
+    return { code: "look/fake-effect-names", message, severity: "warning", nodes: [name] };
+}
+function lintScene(scene, ctx) {
+    const findings = [];
+    const pixelBacked = ctx.capabilities?.effectsPixelBacked ?? [];
+    for (const node of allNodes((scene.nodes ?? []))) {
+        const name = node.name ?? "";
+        if (node.kind === "primitive") {
+            const fake = name.match(FAKE_NAME)?.[0]?.toLowerCase();
+            if (fake) {
+                findings.push(finding(`primitive node "${name}" names "${fake}" — use an effect node (${fake === "rain" || fake === "snow" ? fake : "particles"}) so the effect produces pixels`, name));
+                continue;
+            }
+        }
+        if (node.kind === "effect") {
+            const effect = node.effect ?? "";
+            if (effect && !pixelBacked.includes(effect)) {
+                findings.push(finding(`effect node "${name}" (${effect}) produced no pixels — it is not in capabilities.effectsPixelBacked`, name));
+                continue;
+            }
+        }
+        if (isFakeEffectName(node.name)) {
+            findings.push(finding(`${node.kind ?? "node"} "${name}" imitates an engine feature (research §4.4 fake-effect name) — use the real feature`, name));
+        }
+    }
+    return findings;
+}
+export function registerPrd07LookLintRules() {
+    try {
+        registerLookLintRule({ code: "look/fake-effect-names", owner: "prd07", run: (scene, ctx) => lintScene(scene, ctx) });
+    }
+    catch (error) {
+        if (!(error instanceof Error && error.message.startsWith("LOOK_RULE_DUPLICATE")))
+            throw error;
+    }
+}
+//# sourceMappingURL=lookLint.js.map

package/dist/engine/agent-api/vfx/lookLint.js.map

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

package/dist/engine/agent-api/world/biomes.d.ts

@@ -0,0 +1,130 @@
+/**
+ * PRD-10 §7.1.2 — biome rigs and environment defaults.
+ *
+ * `BIOME_RIGS` encodes the §6.3 table verbatim: sky (C-21 `AuraSkySpec`),
+ * environment source (C-09), sun/key, shadows (C-11), fog (C-21
+ * `AuraHeightFogSpec`), post (C-13 preset + overrides). Where the table omits
+ * a value (e.g. sun azimuth, interior key intensity), the value is marked
+ * "lane default" inline; it is tuned only via §16 visual review.
+ *
+ * Rules every rig enforces (§6.3):
+ * - `ambientPolicy: "ibl-only"` — a biome never relies on a flat ambient.
+ * - Shadow strength 1.0 (contrast comes from IBL fill).
+ * - Fog colour `"sky"` = derived from the sky horizon at the view azimuth.
+ * - Every rig has a Low-tier variant: 1 cascade fewer, half shadow distance,
+ *   no volumetric, 128² PMREM (applied by `describeBiome`).
+ */
+import type { AuraSkySpec, AuraHeightFogSpec } from "../../contracts/atmosphere.js";
+import type { AuraPostPresetId } from "../../contracts/post.js";
+import type { AuraColor, AuraAssetRef } from "../index.js";
+import type { AuraBiomeId, AuraBiomeRig } from "../../contracts/world.js";
+import type { AuraTiered, AuraWorldNodeBase, AuraWorldQualityTier } from "./types.js";
+export interface AuraBiomeSunSpec {
+    readonly elevationDeg: number;
+    readonly azimuthDeg: number;
+    readonly intensity: number;
+    readonly colorTemperatureK?: number;
+    readonly color?: AuraColor;
+    readonly castShadow?: boolean;
+}
+export type AuraBiomeEnvironmentSpec = {
+    readonly source: "sky-capture";
+    readonly intensity: number;
+    readonly faceSize: AuraTiered<64 | 128 | 256>;
+} | {
+    readonly source: "hdri";
+    readonly hdri: AuraAssetRef<"texture">;
+    readonly intensity: number;
+    readonly rotationDeg: number;
+} | {
+    readonly source: "room";
+    readonly colorTemperatureK: number;
+    readonly intensity: number;
+} | {
+    readonly source: "space-bake";
+    readonly intensity: number;
+};
+export interface AuraBiomePostOverrides {
+    readonly exposureEv?: number;
+    readonly bloomThreshold?: number;
+    readonly bloomStrength?: number;
+    readonly grade?: "neutral" | "warm" | "cool" | "teal-orange" | "low-contrast";
+}
+/** Superset of the frozen C-26 `AuraBiomeRig`: every C-26 field keeps its contract type. */
+export interface AuraBiomeRigDetail extends AuraBiomeRig {
+    readonly sky: AuraSkySpec | null;
+    readonly fog: AuraHeightFogSpec | null;
+    readonly post: AuraPostPresetId;
+    readonly environment: AuraBiomeEnvironmentSpec["source"];
+    readonly environmentSpec: AuraBiomeEnvironmentSpec;
+    readonly sunDetail: AuraBiomeSunSpec | null;
+    readonly shadows: {
+        readonly cascades: AuraTiered<1 | 2 | 3 | 4>;
+        readonly maxDistance: AuraTiered<number>;
+        readonly strength: number;
+        readonly softness: number;
+    };
+    readonly postOverrides: AuraBiomePostOverrides;
+    readonly practicalScale: number;
+    readonly ambientPolicy: "ibl-only";
+}
+export interface AuraBiomeOverrides {
+    readonly sun?: Partial<AuraBiomeSunSpec>;
+    readonly environment?: Partial<AuraBiomeEnvironmentSpec>;
+    readonly fog?: Partial<AuraHeightFogSpec> | null;
+    readonly post?: AuraBiomePostOverrides & {
+        readonly preset?: AuraPostPresetId;
+    };
+    readonly practicalScale?: number;
+}
+export interface AuraBiomeNode extends AuraWorldNodeBase {
+    readonly kind: "biome";
+    /** Stable node id (diagnostics + biome records); auto-assigned at build. */
+    readonly id: string;
+    readonly biome: AuraBiomeId;
+    readonly scope?: "all" | "environment";
+    readonly overrides?: AuraBiomeOverrides;
+}
+export interface AuraTimeOfDayOptions extends AuraWorldNodeBase {
+    /** Stable node id (diagnostics + frame records); auto-assigned at build. */
+    readonly id?: string;
+    readonly hour: number;
+    readonly mode?: "solar" | "arc";
+    readonly latitudeDeg?: number;
+    readonly dayOfYear?: number;
+    readonly northOffsetDeg?: number;
+    readonly maxElevationDeg?: number;
+    readonly keyframes?: readonly {
+        readonly hour: number;
+        readonly biome: AuraBiomeId;
+        readonly overrides?: AuraBiomeOverrides;
+    }[];
+    readonly ibl?: {
+        readonly recapture?: boolean;
+        readonly thresholdDeg?: number;
+        readonly crossfadeSeconds?: number;
+    };
+    readonly stars?: boolean;
+}
+export interface AuraTimeOfDayNode extends AuraWorldNodeBase {
+    readonly kind: "time-of-day";
+    readonly id: string;
+    readonly options: AuraTimeOfDayOptions;
+}
+/**
+ * §6.3 rig table. Azimuths and intensities the table does not specify are lane
+ * defaults; adjust them only through the §16 visual review.
+ */
+export declare const BIOME_RIGS: Readonly<Record<AuraBiomeId, AuraBiomeRigDetail>>;
+/** Resolve an `AuraTiered` value against a quality tier (exact, else nearest lower, else lowest defined). */
+export declare function resolveTiered<T>(value: AuraTiered<T>, tier: AuraWorldQualityTier): T;
+/** Pure, deterministic, frozen — the same object reference every call. */
+export declare function describeBiome(id: AuraBiomeId, tier?: AuraWorldQualityTier): AuraBiomeRigDetail;
+export declare function listBiomes(): readonly AuraBiomeId[];
+/**
+ * Merge `AuraBiomeOverrides` onto a rig (§7.1.2). Per-group shallow merge; `fog: null`
+ * clears fog entirely (overrides switch off the fog field). Returns a fresh,
+ * deep-frozen rig — the base `BIOME_RIGS` entries are never mutated.
+ */
+export declare function applyBiomeOverrides(rig: AuraBiomeRigDetail, overrides: AuraBiomeOverrides | undefined): AuraBiomeRigDetail;
+//# sourceMappingURL=biomes.d.ts.map

package/dist/engine/agent-api/world/biomes.d.ts.map

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