@aethervtt/shard-render 0.0.1

package/dist/readback.js

@@ -0,0 +1,95 @@
+const BYTES_PER_TEXEL = {
+  rgba8unorm: 4,
+  "rgba8unorm-srgb": 4,
+  bgra8unorm: 4,
+  "bgra8unorm-srgb": 4,
+  rgba16float: 8,
+  rgba32float: 16,
+  r32float: 4,
+  r32uint: 4,
+  rg16float: 4,
+  r16float: 2,
+  r8unorm: 1,
+  rg11b10ufloat: 4,
+  depth32float: 4
+};
+function halfToFloat(h) {
+  const s = h & 32768 ? -1 : 1;
+  const e = h >> 10 & 31;
+  const f = h & 1023;
+  if (e === 0) return s * 2 ** -14 * (f / 1024);
+  if (e === 31) return f ? Number.NaN : s * Number.POSITIVE_INFINITY;
+  return s * 2 ** (e - 15) * (1 + f / 1024);
+}
+function toFloats(src, format, count, out, o) {
+  switch (format) {
+    case "rgba16float": {
+      const h = new Uint16Array(src, 0, count * 4);
+      for (let i = 0; i < count * 4; i++) out[o + i] = halfToFloat(h[i]);
+      return;
+    }
+    case "rg16float": {
+      const h = new Uint16Array(src, 0, count * 2);
+      for (let i = 0; i < count; i++) {
+        out[o + i * 4] = halfToFloat(h[i * 2]);
+        out[o + i * 4 + 1] = halfToFloat(h[i * 2 + 1]);
+      }
+      return;
+    }
+    case "r16float": {
+      const h = new Uint16Array(src, 0, count);
+      for (let i = 0; i < count; i++) out[o + i * 4] = halfToFloat(h[i]);
+      return;
+    }
+    case "rgba32float":
+      out.set(new Float32Array(src, 0, count * 4), o);
+      return;
+    case "r32float":
+    case "depth32float": {
+      const f = new Float32Array(src, 0, count);
+      for (let i = 0; i < count; i++) out[o + i * 4] = f[i];
+      return;
+    }
+    case "r32uint": {
+      const u = new Uint32Array(src, 0, count);
+      for (let i = 0; i < count; i++) out[o + i * 4] = u[i];
+      return;
+    }
+    case "r8unorm": {
+      const b = new Uint8Array(src, 0, count);
+      for (let i = 0; i < count; i++) out[o + i * 4] = b[i] / 255;
+      return;
+    }
+    case "rg11b10ufloat": {
+      const u = new Uint32Array(src, 0, count);
+      for (let i = 0; i < count; i++) {
+        const v = u[i];
+        out[o + i * 4] = small(v & 2047, 6);
+        out[o + i * 4 + 1] = small(v >>> 11 & 2047, 6);
+        out[o + i * 4 + 2] = small(v >>> 22 & 1023, 5);
+      }
+      return;
+    }
+    default: {
+      const b = new Uint8Array(src, 0, count * 4);
+      const bgra = format.startsWith("bgra");
+      for (let i = 0; i < count; i++) {
+        out[o + i * 4] = b[i * 4 + (bgra ? 2 : 0)] / 255;
+        out[o + i * 4 + 1] = b[i * 4 + 1] / 255;
+        out[o + i * 4 + 2] = b[i * 4 + (bgra ? 0 : 2)] / 255;
+        out[o + i * 4 + 3] = b[i * 4 + 3] / 255;
+      }
+    }
+  }
+}
+function small(v, mantissaBits) {
+  const e = v >>> mantissaBits;
+  const m = v & (1 << mantissaBits) - 1;
+  if (e === 0) return 2 ** -14 * (m / (1 << mantissaBits));
+  if (e === 31) return m ? Number.NaN : Number.POSITIVE_INFINITY;
+  return 2 ** (e - 15) * (1 + m / (1 << mantissaBits));
+}
+export {
+  BYTES_PER_TEXEL,
+  toFloats
+};

package/dist/render-scale.d.ts

@@ -0,0 +1,53 @@
+import { type World } from '@aethervtt/shard-core';
+export interface RenderScaleValue {
+    /** auto: the controller moves `scale` to hold the frame budget. fixed: `scale` stays as set. */
+    mode: 'auto' | 'fixed';
+    /** Render resolution as a fraction of the window's backing size. The controller writes it. */
+    scale: number;
+    /** Bounds for auto mode. */
+    min: number;
+    max: number;
+    /**
+     * Frame budget auto mode holds, in ms. 0 (the default): one refresh of the display
+     * (DisplayRate), so a 120 Hz screen gets 8.3 ms, but never faster than `maxHz`.
+     */
+    targetMs: number;
+    /** With targetMs 0: the fastest refresh rate worth holding; above it, frames get this budget. */
+    maxHz: number;
+    /** The budget auto mode is holding now, in ms. Read-only. */
+    budgetMs: number;
+    /** Contrast-adaptive sharpening of the upscale, 0–1. */
+    sharpen: number;
+    /** Window cameras the scale applied to last frame. Read-only. */
+    windowViews: number;
+    /** What auto mode measures: GPU frame time, the frame interval, or nothing. Read-only. */
+    signal: 'gpu' | 'frame' | 'none';
+    /** The smoothed measurement, in ms. Read-only. */
+    measuredMs: number;
+}
+export declare const RenderScale: import("@aethervtt/shard-core").ResourceDef<RenderScaleValue>;
+/** Scales snap to this (1 / STEPS), so the texture pool sees few sizes. */
+export declare const SCALE_STEP = 0.05;
+export declare const STEPS = 20;
+export declare const LOWEST = 0.25;
+export declare const HIGHEST = 2;
+/** A size at a render scale, in whole pixels. Scales outside 0.25–2 are clamped. */
+export declare function scaledSize(size: number, scale: number): number;
+/** The renderScale section of `render.describe`. */
+export declare function describeRenderScale(world: World): {
+    mode: "auto" | "fixed";
+    scale: number;
+    min: number;
+    max: number;
+    targetMs: number;
+    maxHz: number;
+    budgetMs: number;
+    displayHz: number | undefined;
+    sharpen: number;
+    signal: "frame" | "gpu" | "none";
+    measuredMs: number | undefined;
+    views: Record<string, {
+        render: [number, number];
+        display: [number, number];
+    }>;
+} | undefined;

package/dist/render-scale.js

@@ -0,0 +1,63 @@
+import { defineResource } from "@aethervtt/shard-core";
+import { DisplayRate } from "@aethervtt/shard-runtime";
+import { Views } from "./plugin.js";
+const RenderScale = defineResource("render/RenderScale", {
+  description: "Render resolution of window cameras (0051): the scene renders at scale \xD7 the window size and is upscaled, UI stays native. auto moves the scale between min and max to hold the frame budget: targetMs, or one display refresh (DisplayRate) when it is 0.",
+  init: () => ({
+    mode: "auto",
+    scale: 1,
+    min: 0.5,
+    max: 1,
+    targetMs: 0,
+    maxHz: 144,
+    budgetMs: 1e3 / 60,
+    sharpen: 0.25,
+    windowViews: 0,
+    signal: "none",
+    measuredMs: 0
+  })
+});
+const SCALE_STEP = 0.05;
+const STEPS = 20;
+const LOWEST = 0.25;
+const HIGHEST = 2;
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+function scaledSize(size, scale) {
+  return Math.max(1, Math.round(size * clamp(scale, LOWEST, HIGHEST)));
+}
+function describeRenderScale(world) {
+  const s = world.tryResource(RenderScale);
+  if (!s) return void 0;
+  const views = {};
+  for (const v of world.resource(Views).list) {
+    const cam = v.data.camera;
+    if (!cam || !v.target.renderScale) continue;
+    views[v.name] = {
+      render: [cam.width, cam.height],
+      display: [cam.displayWidth, cam.displayHeight]
+    };
+  }
+  return {
+    mode: s.mode,
+    scale: s.scale,
+    min: s.min,
+    max: s.max,
+    targetMs: s.targetMs,
+    maxHz: s.maxHz,
+    budgetMs: Math.round(s.budgetMs * 100) / 100,
+    displayHz: world.tryResource(DisplayRate)?.hz,
+    sharpen: s.sharpen,
+    signal: s.signal,
+    measuredMs: s.signal === "none" ? void 0 : Math.round(s.measuredMs * 100) / 100,
+    views
+  };
+}
+export {
+  HIGHEST,
+  LOWEST,
+  RenderScale,
+  SCALE_STEP,
+  STEPS,
+  describeRenderScale,
+  scaledSize
+};

package/dist/shaders.d.ts

@@ -0,0 +1,122 @@
+import { type ShaderLibrary } from '@aethervtt/shard-shader';
+/** Per-view uniforms. A schema, so the WGSL struct and the CPU packing come from one place. */
+export declare const ViewUniform: import("@aethervtt/shard-core").ComponentDef<{
+    readonly viewProj: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly view: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly invViewProj: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly cameraPosition: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec3> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">);
+    /** Scene luminance to pre-exposed HDR: what the HDR target stores. */
+    readonly exposure: import("@aethervtt/shard-core").FieldType<number, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<number> | undefined) => import("@aethervtt/shard-core").FieldType<number, "f32">);
+    /** width, height, 1/width, 1/height. */
+    readonly viewport: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /** Cluster slices: near, far, slices / ln(far / near), debug mode (1 clusters, 2 cascades). */
+    readonly clusterParams: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /** Ambient luminance (cd/m²), linear color. */
+    readonly ambient: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec3> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">);
+    /** Environment: intensity (cd/m² per unit), cos and sin of its rotation, enabled (w). */
+    readonly envParams: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /** viewProj without the TAA jitter, this frame and last (motion vectors). */
+    readonly viewProjNoJitter: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly prevViewProj: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    /** TAA jitter in pixels (xy), frames rendered (z). */
+    readonly jitter: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /**
+     * Per directional light (column i): the atmosphere's transmittance (rgb) between the camera and
+     * that sun, applied to its light (spec 0044). All ones without an atmosphere.
+     */
+    readonly sunTransmittance: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+}>;
+export declare const viewLayout: import("@aethervtt/shard-shader").WgslLayout<{
+    readonly viewProj: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly view: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly invViewProj: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly cameraPosition: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec3> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">);
+    /** Scene luminance to pre-exposed HDR: what the HDR target stores. */
+    readonly exposure: import("@aethervtt/shard-core").FieldType<number, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<number> | undefined) => import("@aethervtt/shard-core").FieldType<number, "f32">);
+    /** width, height, 1/width, 1/height. */
+    readonly viewport: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /** Cluster slices: near, far, slices / ln(far / near), debug mode (1 clusters, 2 cascades). */
+    readonly clusterParams: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /** Ambient luminance (cd/m²), linear color. */
+    readonly ambient: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec3> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec3, "f32">);
+    /** Environment: intensity (cd/m² per unit), cos and sin of its rotation, enabled (w). */
+    readonly envParams: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /** viewProj without the TAA jitter, this frame and last (motion vectors). */
+    readonly viewProjNoJitter: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    readonly prevViewProj: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+    /** TAA jitter in pixels (xy), frames rendered (z). */
+    readonly jitter: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<import("@aethervtt/shard-core").Vec4> | undefined) => import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec4, "f32">);
+    /**
+     * Per directional light (column i): the atmosphere's transmittance (rgb) between the camera and
+     * that sun, applied to its light (spec 0044). All ones without an atmosphere.
+     */
+    readonly sunTransmittance: import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32"> & ((options?: import("@aethervtt/shard-core").FieldOptions<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]> | undefined) => import("@aethervtt/shard-core").FieldType<[number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number], "f32">);
+}>;
+export declare const materialLayout: import("@aethervtt/shard-shader").WgslLayout<{
+    baseColor: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Color, "f32">;
+    metallic: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    roughness: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    emissive: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Color, "f32">;
+    emissiveLuminance: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    doubleSided: import("@aethervtt/shard-core").FieldType<boolean, "u8">;
+    alphaMode: import("@aethervtt/shard-core").FieldType<"additive" | "alpha" | "mask" | "opaque" | "premultiplied", "u8">;
+    alphaCutoff: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    normalScale: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    occlusionStrength: import("@aethervtt/shard-core").FieldType<number, "f32">;
+    baseColorTexture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+        uv: import("@aethervtt/shard-core").FieldType<number, "u8">;
+        offset: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        scale: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        rotation: import("@aethervtt/shard-core").FieldType<number, "f32">;
+        wrap: import("@aethervtt/shard-core").FieldType<"clamp" | "mirror" | "repeat", "u8">;
+        filter: import("@aethervtt/shard-core").FieldType<"linear" | "nearest", "u8">;
+    }>, "object">;
+    metallicRoughnessTexture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+        uv: import("@aethervtt/shard-core").FieldType<number, "u8">;
+        offset: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        scale: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        rotation: import("@aethervtt/shard-core").FieldType<number, "f32">;
+        wrap: import("@aethervtt/shard-core").FieldType<"clamp" | "mirror" | "repeat", "u8">;
+        filter: import("@aethervtt/shard-core").FieldType<"linear" | "nearest", "u8">;
+    }>, "object">;
+    normalTexture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+        uv: import("@aethervtt/shard-core").FieldType<number, "u8">;
+        offset: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        scale: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        rotation: import("@aethervtt/shard-core").FieldType<number, "f32">;
+        wrap: import("@aethervtt/shard-core").FieldType<"clamp" | "mirror" | "repeat", "u8">;
+        filter: import("@aethervtt/shard-core").FieldType<"linear" | "nearest", "u8">;
+    }>, "object">;
+    occlusionTexture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+        uv: import("@aethervtt/shard-core").FieldType<number, "u8">;
+        offset: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        scale: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        rotation: import("@aethervtt/shard-core").FieldType<number, "f32">;
+        wrap: import("@aethervtt/shard-core").FieldType<"clamp" | "mirror" | "repeat", "u8">;
+        filter: import("@aethervtt/shard-core").FieldType<"linear" | "nearest", "u8">;
+    }>, "object">;
+    emissiveTexture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").InferFields<{
+        texture: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").AssetRef<"Texture"> | null, "object">;
+        uv: import("@aethervtt/shard-core").FieldType<number, "u8">;
+        offset: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        scale: import("@aethervtt/shard-core").FieldType<import("@aethervtt/shard-core").Vec2, "f32">;
+        rotation: import("@aethervtt/shard-core").FieldType<number, "f32">;
+        wrap: import("@aethervtt/shard-core").FieldType<"clamp" | "mirror" | "repeat", "u8">;
+        filter: import("@aethervtt/shard-core").FieldType<"linear" | "nearest", "u8">;
+    }>, "object">;
+}>;
+/**
+ * Engine shader modules. Shading is split in two, so every path can reuse every material: the
+ * surface stage (`shard::pbr::material`, hook `pbr_input`) produces a `PbrInput`; the lighting stage
+ * (`shard::pbr::lighting`) is the only code that evaluates lights. Views render pre-exposed HDR
+ * (radiance × exposure); the tonemap pass turns it into display values.
+ */
+export declare const ENGINE_SHADERS: Record<string, string>;
+/** Registers a group of engine WGSL modules. Each render feature registers its own. */
+export declare function registerShaders(library: ShaderLibrary, modules: Record<string, string>): void;
+/** Core render's WGSL. Features (atmosphere, post, deferred, ...) register theirs in their plugins. */
+export declare function registerEngineShaders(library: ShaderLibrary): void;