@aura3d/rendering 3.0.1 → 4.0.2

package/dist/contracts/post.d.ts

@@ -0,0 +1,71 @@
+/**
+ * C-13 — post graph (rendering side, CONTRACTS.md). Provider: PRD 03. Flag: A3D_QR_POST.
+ */
+import type { RegistryEntry } from "./core.js";
+import type { FrameContributorContext } from "./frameGraph.js";
+import type { AuraToneMappingOperatorLike } from "./output.js";
+export type PostSpace = "linear-hdr" | "display";
+export type PostInsertAt = "after-depth" | "before-taa" | "after-taa" | "before-tonemap" | "after-tonemap";
+export interface PostPassDescriptor extends RegistryEntry {
+    readonly id: string;
+    readonly insertAt: PostInsertAt;
+    readonly space: PostSpace;
+    readonly inputs: readonly ("color" | "depth" | "velocity" | "normal" | "reactive")[];
+    readonly fragment: {
+        readonly glsl: string;
+        readonly wgsl?: string;
+    };
+    readonly uniforms?: (frame: FrameContributorContext) => Readonly<Record<string, number | readonly number[]>>;
+    readonly enabled?: (frame: FrameContributorContext) => boolean;
+    readonly gpuOnly: true;
+}
+/**
+ * §6.1 space rule: every insertion anchor before `after-tonemap` is
+ * `linear-hdr`; only `after-tonemap` passes may declare `display`. Violations
+ * throw `POSTPROCESS_SPACE_INVALID:<id>`.
+ */
+export declare function validatePostPassSpace(pass: Pick<PostPassDescriptor, "id" | "insertAt" | "space">): void;
+export declare function registerPostPass(pass: PostPassDescriptor): () => void;
+export declare function registeredPostPasses(): readonly PostPassDescriptor[];
+export interface PostGraphReport {
+    readonly stages: readonly {
+        readonly name: string;
+        readonly format: string;
+        readonly width: number;
+        readonly height: number;
+        readonly gpuMs?: number;
+    }[];
+    readonly skipped: readonly {
+        readonly name: string;
+        readonly reason: string;
+    }[];
+}
+export interface PostPipelineOptions {
+    readonly antiAliasing: "msaa" | "taa" | "smaa" | "fxaa" | "off";
+    readonly renderScale?: number;
+    readonly depthRange: {
+        readonly near: number;
+        readonly far: number;
+        readonly projection: "perspective" | "orthographic";
+    };
+    readonly ao?: unknown;
+    readonly ssr?: unknown;
+    readonly godRays?: unknown;
+    readonly taa?: unknown;
+    readonly dof?: unknown;
+    readonly motionBlur?: unknown;
+    readonly exposure: number;
+    readonly bloom?: unknown;
+    readonly toneMapping: AuraToneMappingOperatorLike;
+    readonly grade?: unknown;
+    readonly lut?: unknown;
+    readonly vignette?: unknown;
+    readonly filmGrain?: unknown;
+    readonly chromaticAberration?: unknown;
+    readonly dither: boolean;
+    readonly backgroundPassthrough?: boolean;
+    readonly customPasses?: readonly PostPassDescriptor[];
+    /** CCR-03-2: `output.autoExposure` typed in post/PostGraph.ts (AutoExposureOptionsV2 | false). */
+    readonly autoExposure?: unknown;
+}
+//# sourceMappingURL=post.d.ts.map

package/dist/contracts/post.d.ts.map

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

package/dist/contracts/post.js

@@ -0,0 +1,28 @@
+/**
+ * C-13 — post graph (rendering side, CONTRACTS.md). Provider: PRD 03. Flag: A3D_QR_POST.
+ */
+import { createRegistry } from "./core.js";
+/**
+ * §6.1 space rule: every insertion anchor before `after-tonemap` is
+ * `linear-hdr`; only `after-tonemap` passes may declare `display`. Violations
+ * throw `POSTPROCESS_SPACE_INVALID:<id>`.
+ */
+export function validatePostPassSpace(pass) {
+    const required = pass.insertAt === "after-tonemap" ? "display" : "linear-hdr";
+    if (pass.space !== required) {
+        throw new Error(`POSTPROCESS_SPACE_INVALID:${pass.id}`);
+    }
+}
+const postPasses = createRegistry("postPasses");
+export function registerPostPass(pass) {
+    if (pass.gpuOnly !== true)
+        throw new Error(`POSTPROCESS_PASS_NOT_GPU:${pass.id}`);
+    validatePostPassSpace(pass);
+    return postPasses.register(pass);
+}
+export function registeredPostPasses() {
+    return postPasses.all();
+}
+// RendererPostProcessOptions (Renderer.ts:378) additions (PR 0a): pipeline?: "v2" | "legacy"; v2?: PostPipelineOptions
+// RenderDevice.executePostGraph?(source: SceneTargets, options: PostPipelineOptions, output: RenderTarget | null): PostGraphReport  (optional member, PR 0a)
+//# sourceMappingURL=post.js.map

package/dist/contracts/post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/post.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAiBxC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA2D;IAC/F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAC9E,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAG,cAAc,CAAqB,YAAY,CAAC,CAAC;AAEpE,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAClF,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC;AAC1B,CAAC;AAaD,uHAAuH;AACvH,6JAA6J"}

package/dist/contracts/program.d.ts

@@ -0,0 +1,158 @@
+/**
+ * C-02 — ProgramFeatures, ShaderFeature/chunk registry, ProgramCache (CONTRACTS.md).
+ * Provider: PRD 01. File: packages/rendering/src/contracts/program.ts.
+ */
+import type { RegistryEntry, ContractSlot, QrFlags, PrdId } from "./core.js";
+import type { RenderItem } from "./renderItem.js";
+import type { AuraQualityTierSettings } from "./quality.js";
+import type { UniformValue, RenderDevice, RenderShaderProgram } from "../RenderDevice.js";
+export interface TextureSlotFeature {
+    readonly uvSet: 0 | 1;
+    readonly transform: boolean;
+}
+export type ShadowReceiveFeature = {
+    readonly cascades: 0 | 1 | 2 | 3 | 4;
+    readonly pcfTaps: 1 | 4 | 9;
+    readonly localShadows: number;
+    readonly contact: boolean;
+};
+export interface ProgramFeatures {
+    readonly pass: "forward" | "depth" | "distance" | "velocity";
+    readonly target: "glsl300es" | "wgsl";
+    readonly lighting: "lit" | "unlit";
+    readonly maps: {
+        readonly baseColor?: TextureSlotFeature;
+        readonly normal?: TextureSlotFeature;
+        readonly metallicRoughness?: TextureSlotFeature;
+        readonly occlusion?: TextureSlotFeature;
+        readonly emissive?: TextureSlotFeature;
+    };
+    readonly extensions: readonly MaterialExtensionFeature[];
+    readonly alphaMode: "opaque" | "mask" | "blend";
+    readonly doubleSided: boolean;
+    readonly vertexColors: boolean;
+    readonly flatShading: boolean;
+    readonly skinning?: {
+        readonly influences: 4 | 8;
+        readonly palette: "uniform" | "texture";
+    };
+    readonly morph?: {
+        readonly targetBucket: 4 | 8 | 16 | 32;
+        readonly normals: boolean;
+        readonly tangents: boolean;
+    };
+    readonly instancing?: {
+        readonly color: boolean;
+        readonly emissive?: boolean;
+    };
+    readonly drawId?: "multi-draw" | "uniform";
+    readonly lights: {
+        readonly dir: 0 | 1 | 2 | 4 | 8;
+        readonly point: 0 | 1 | 2 | 4 | 8;
+        readonly spot: 0 | 1 | 2 | 4 | 8;
+        readonly rect: 0 | 1 | 2 | 4;
+        readonly clustered: boolean;
+        readonly hemisphere: boolean;
+    };
+    readonly shadows: ShadowReceiveFeature;
+    readonly environment: "none" | "pmrem-cube" | "equirect";
+    readonly fog: "none" | "linear" | "exp2" | "height" | "volumetric";
+    readonly diffuseModel: "lambert" | "burley";
+    readonly specularAntialiasing: boolean;
+    readonly backgroundCoverage: boolean;
+    /** Open feature bits contributed by registered ShaderFeatures; key = ShaderFeature.id. */
+    readonly features: Readonly<Record<string, string | number | boolean>>;
+}
+export interface MaterialExtensionFeature {
+    readonly lobe: string;
+    readonly maps: readonly string[];
+    readonly bits: Readonly<Record<string, string | number | boolean>>;
+}
+export declare function computeProgramKey(features: ProgramFeatures): string;
+export interface ShaderChunk {
+    readonly name: string;
+    readonly owner: PrdId;
+    readonly glsl: string;
+    readonly wgsl?: string;
+    readonly stage: "vertex" | "fragment" | "both";
+    readonly requires?: readonly string[];
+}
+export interface ShaderFeature extends RegistryEntry {
+    readonly id: string;
+    /** Return the feature bit value for this draw, or undefined when inactive. Must be pure. */
+    select(input: ShaderFeatureSelectInput): string | number | boolean | undefined;
+    defines(value: string | number | boolean): Readonly<Record<string, string | number | true>>;
+    readonly chunks: readonly string[];
+    readonly hooks: readonly ShaderHookPoint[];
+    bindUniforms?(value: string | number | boolean, item: RenderItem, set: (name: string, v: UniformValue) => void): void;
+}
+export type ShaderHookPoint = "vertex:pars" | "vertex:deform" | "vertex:world" | "vertex:end" | "fragment:pars" | "fragment:alpha" | "fragment:normal" | "fragment:material" | "fragment:lights" | "fragment:indirect" | "fragment:emissive" | "fragment:fog" | "fragment:end";
+export interface ShaderFeatureSelectInput {
+    readonly item: RenderItem;
+    readonly pass: ProgramFeatures["pass"];
+    readonly tier: AuraQualityTierSettings;
+    readonly flags: QrFlags;
+}
+/** Registries are real in PR 0a: they store and validate; the generator stays pending until PRD 01. */
+export declare function registerShaderChunk(chunk: ShaderChunk): void;
+export declare function registerShaderFeature(feature: ShaderFeature): () => void;
+export declare function shaderChunk(name: string): ShaderChunk | undefined;
+/**
+ * #198 (QR-11 Q-01-4): read-only enumeration of every registered chunk, in
+ * registration order — for the WGSL-twin manifest parity report
+ * (`program/chunks/manifest.ts`) and the C-02 "every registered chunk
+ * compiles" check. Returns a snapshot; registering later does not mutate it.
+ */
+export declare function allShaderChunks(): readonly ShaderChunk[];
+/** Registered features, ordered for hook splicing: (order ?? 0, id). */
+export declare function shaderFeaturesFor(flags: QrFlags): readonly ShaderFeature[];
+export interface GeneratedProgram {
+    readonly key: string;
+    readonly vertex: string;
+    readonly fragment: string;
+    readonly defines: Readonly<Record<string, string | number | true>>;
+}
+export type ProgramGeneratorImpl = (features: ProgramFeatures) => GeneratedProgram;
+/** PRD 01's program/ProgramGenerator.ts installs the real C-02 generator (lane 01). */
+export declare function installProgramGenerator(impl: ProgramGeneratorImpl): void;
+export declare function generateProgram(features: ProgramFeatures): GeneratedProgram;
+export interface ProgramHandle {
+    readonly key: string;
+    readonly status: "pending" | "ready" | "failed";
+    readonly program?: RenderShaderProgram;
+    readonly error?: string;
+}
+export interface ProgramCacheLike {
+    acquire(features: ProgramFeatures): ProgramHandle;
+    precompile(list: readonly ProgramFeatures[]): Promise<void>;
+    stats(): {
+        readonly compiled: number;
+        readonly pending: number;
+        readonly failed: number;
+        readonly compileMsTotal: number;
+        readonly compiledSinceReady?: number;
+    };
+    /** T0-06: resets the per-frame sync-compile bound; called once per render. */
+    beginFrame?(): void;
+    /** T0-06: marks the ready barrier; compiles after it count `compiledSinceReady`. */
+    markReady?(): void;
+    dispose(): void;
+}
+/** Optional C-36 sink for generator/cache degradations (`extension-lobe-pending`, `program-compile-failed`). */
+export interface ProgramDegradationLike {
+    readonly code: string;
+    readonly message: string;
+    readonly ownerPrd?: number;
+}
+/**
+ * C-02 cache options. `flags` makes the real generator resolve registered
+ * ShaderFeatures and C-03 lobes (without it no feature chunk is ever spliced —
+ * T0-05); `onDegradation` receives C-36 entries.
+ */
+export interface ProgramCacheSlotOptions {
+    readonly parallelCompile?: boolean;
+    readonly flags?: QrFlags;
+    readonly onDegradation?: (degradation: ProgramDegradationLike) => void;
+}
+export declare const programCacheSlot: ContractSlot<(device: RenderDevice, o?: ProgramCacheSlotOptions) => ProgramCacheLike>;
+//# sourceMappingURL=program.d.ts.map

package/dist/contracts/program.d.ts.map

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

package/dist/contracts/program.js

@@ -0,0 +1,128 @@
+/**
+ * C-02 — ProgramFeatures, ShaderFeature/chunk registry, ProgramCache (CONTRACTS.md).
+ * Provider: PRD 01. File: packages/rendering/src/contracts/program.ts.
+ */
+/** Deterministic, order-independent program key: canonical JSON with sorted keys at every level. */
+function stableSerialize(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(stableSerialize).join(",")}]`;
+    }
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableSerialize(v)}`).join(",")}}`;
+}
+export function computeProgramKey(features) {
+    return stableSerialize(features);
+}
+import { createRegistry } from "./core.js";
+const shaderChunks = new Map();
+const shaderFeatures = createRegistry("shaderFeatures");
+/** Registries are real in PR 0a: they store and validate; the generator stays pending until PRD 01. */
+export function registerShaderChunk(chunk) {
+    if (shaderChunks.has(chunk.name)) {
+        throw new Error(`SHADER_CHUNK_DUPLICATE:${chunk.name}`);
+    }
+    shaderChunks.set(chunk.name, chunk);
+}
+export function registerShaderFeature(feature) {
+    return shaderFeatures.register(feature);
+}
+export function shaderChunk(name) {
+    return shaderChunks.get(name);
+}
+/**
+ * #198 (QR-11 Q-01-4): read-only enumeration of every registered chunk, in
+ * registration order — for the WGSL-twin manifest parity report
+ * (`program/chunks/manifest.ts`) and the C-02 "every registered chunk
+ * compiles" check. Returns a snapshot; registering later does not mutate it.
+ */
+export function allShaderChunks() {
+    return [...shaderChunks.values()];
+}
+/** Registered features, ordered for hook splicing: (order ?? 0, id). */
+export function shaderFeaturesFor(flags) {
+    return shaderFeatures.active(flags);
+}
+let programGeneratorImpl;
+/** PRD 01's program/ProgramGenerator.ts installs the real C-02 generator (lane 01). */
+export function installProgramGenerator(impl) {
+    programGeneratorImpl = impl;
+}
+export function generateProgram(features) {
+    if (programGeneratorImpl === undefined) {
+        throw new Error(`PROGRAM_GENERATOR_PENDING:${computeProgramKey(features)}`);
+    }
+    return programGeneratorImpl(features);
+}
+import { defineContractSlot } from "./core.js";
+import { createLeanCoreShaderLibrary, DEFAULT_UNLIT_SHADER_NAME, DEFAULT_DEPTH_SHADER_NAME } from "../ShaderLibraryCore.js";
+import { DEFAULT_PBR_SHADER_NAME } from "../PBRMaterial.js";
+/**
+ * PR 0a stub: wraps the existing ShaderLibrary lookups and ignores registered
+ * features. Depth/distance passes map to the lean depth shader, unlit to the
+ * lean unlit shader, everything else to the default PBR program.
+ */
+function shaderNameFor(features) {
+    if (features.pass === "depth" || features.pass === "distance")
+        return DEFAULT_DEPTH_SHADER_NAME;
+    if (features.lighting === "unlit")
+        return DEFAULT_UNLIT_SHADER_NAME;
+    return DEFAULT_PBR_SHADER_NAME;
+}
+class StubProgramCache {
+    device;
+    library = null;
+    /** 01-HANG: one program per key — the stub used to compile on every acquire (per draw, per frame). */
+    entries = new Map();
+    compiled = 0;
+    failed = 0;
+    compileMsTotal = 0;
+    constructor(device) {
+        this.device = device;
+    }
+    getLibrary() {
+        if (!this.library)
+            this.library = createLeanCoreShaderLibrary();
+        return this.library;
+    }
+    acquire(features) {
+        const key = computeProgramKey(features);
+        const cached = this.entries.get(key);
+        if (cached)
+            return cached;
+        let handle;
+        try {
+            const started = Date.now();
+            const program = this.device.createShaderProgram(this.getLibrary().compileSource(shaderNameFor(features)));
+            this.compiled += 1;
+            this.compileMsTotal += Date.now() - started;
+            handle = { key, status: "ready", program };
+        }
+        catch (error) {
+            this.failed += 1;
+            handle = { key, status: "failed", error: error instanceof Error ? error.message : String(error) };
+        }
+        this.entries.set(key, handle);
+        return handle;
+    }
+    async precompile(list) {
+        for (const features of list) {
+            this.acquire(features);
+        }
+    }
+    stats() {
+        return { compiled: this.compiled, pending: 0, failed: this.failed, compileMsTotal: this.compileMsTotal };
+    }
+    dispose() {
+        for (const handle of this.entries.values())
+            handle.program?.dispose?.();
+        this.entries.clear();
+        this.library = null;
+    }
+}
+export const programCacheSlot = defineContractSlot("C-02", "prd01", "A3D_QR_CORE", (device) => new StubProgramCache(device));
+//# sourceMappingURL=program.js.map

package/dist/contracts/program.js.map

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

package/dist/contracts/quality.d.ts

@@ -0,0 +1,93 @@
+/**
+ * C-27 — QualityTier settings (CONTRACTS.md). Provider: PRD 11. Flag: A3D_QR_TIERS.
+ * Engine re-export lives in packages/engine/src/contracts/quality re-exports? —
+ * consumers import from @aura3d/rendering/contracts.
+ */
+export type AuraQualityTier = "low" | "medium" | "high" | "ultra";
+export type AuraFeatureLevel = "off" | "low" | "medium" | "high";
+export interface AuraQualityTierSettings {
+    readonly maxPixelRatio: number;
+    readonly minRenderScale: number;
+    readonly targetFrameMs: number;
+    readonly msaaSamples: 0 | 4;
+    readonly postAntiAlias: "fxaa" | "none" | "taa";
+    readonly shadow: {
+        readonly mapSize: 1024 | 2048 | 4096;
+        readonly cascades: 1 | 2 | 3 | 4;
+        readonly filter: "pcf2" | "pcf3" | "pcf5";
+        readonly localShadowLights: number;
+        readonly contact: boolean;
+    };
+    readonly maxLightsPerPixel: 4 | 8 | 16 | 32;
+    readonly ambientOcclusion: AuraFeatureLevel;
+    readonly ssr: AuraFeatureLevel;
+    readonly bloomMipLevels: 3 | 5 | 6;
+    readonly volumetricFog: "analytic" | "froxel-medium" | "froxel-high";
+    readonly froxelGrid: readonly [number, number, number] | null;
+    readonly particleBudget: number;
+    readonly softParticles: boolean;
+    readonly lodBias: number;
+    readonly primitiveSegments: "half" | "full";
+    readonly maxTextureSize: 1024 | 2048 | 4096;
+    readonly textureBudgetBytes: number;
+    readonly anisotropy: 2 | 4 | 8 | 16;
+    readonly environmentSize: 128 | 256 | 512 | 1024;
+    readonly drawBudget: number;
+}
+/**
+ * Frozen QUALITY_TIERS: PRD 11 §6.3 table values with the R9, R10 and R11
+ * corrections. `targetFrameMs` uses the desktop value; the governor applies
+ * 33.3 on mobile.
+ */
+export declare const QUALITY_TIERS: Readonly<Record<AuraQualityTier, AuraQualityTierSettings>>;
+/** Validates every override key; any invalid value throws QUALITY_OVERRIDE_INVALID:<field>. */
+export declare function resolveTierSettings(tier: AuraQualityTier, overrides?: Partial<AuraQualityTierSettings>): AuraQualityTierSettings;
+export declare function nextLowerTier(tier: AuraQualityTier): AuraQualityTier | null;
+export interface AuraTierDecision {
+    readonly tier: AuraQualityTier;
+    readonly source: "explicit" | "url" | "cache" | "classified" | "calibrated" | "default";
+    readonly reason: string;
+}
+export interface AuraQualityController {
+    readonly tier: AuraQualityTier;
+    readonly settings: AuraQualityTierSettings;
+    readonly decision: AuraTierDecision;
+    set(tier: AuraQualityTier, overrides?: Partial<AuraQualityTierSettings>): Promise<void>;
+    lock(): void;
+    unlock(): void;
+    forceRenderScale(scale: number | "floor" | null): void;
+    onChange(l: (e: {
+        readonly from: AuraQualityTier;
+        readonly to: AuraQualityTier;
+        readonly reason: string;
+    }) => void): () => void;
+}
+/**
+ * PR 0a stub controller: "auto" resolves to "high" on desktop and "medium" when
+ * matchMedia("(pointer: coarse)"), decision.source "default". set() updates
+ * settings and emits onChange; consumers re-read settings at their next
+ * resolve. forceRenderScale records the request (the engine seam applies it
+ * through the existing canvas sizing in PR 0b).
+ */
+export declare class StubQualityController implements AuraQualityController {
+    private current;
+    private overrides;
+    private locked;
+    private scale;
+    private readonly listeners;
+    readonly decision: AuraTierDecision;
+    constructor(requested?: AuraQualityTier | "auto", overrides?: Partial<AuraQualityTierSettings>, coarsePointer?: boolean);
+    get tier(): AuraQualityTier;
+    get settings(): AuraQualityTierSettings;
+    set(tier: AuraQualityTier, overrides?: Partial<AuraQualityTierSettings>): Promise<void>;
+    lock(): void;
+    unlock(): void;
+    forceRenderScale(scale: number | "floor" | null): void;
+    get renderScale(): number | "floor" | null;
+    onChange(l: (e: {
+        readonly from: AuraQualityTier;
+        readonly to: AuraQualityTier;
+        readonly reason: string;
+    }) => void): () => void;
+}
+//# sourceMappingURL=quality.d.ts.map

package/dist/contracts/quality.d.ts.map

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