@aethervtt/shard-render 0.0.1 → 0.2.0

package/dist/forward.d.ts

@@ -1,7 +1,9 @@
 import { type World } from '@aethervtt/shard-core';
 import { GpuBuffer, type GpuContext } from '@aethervtt/shard-gpu';
 import { type Plugin } from '@aethervtt/shard-runtime';
+import type { BaselineViewLights } from './baseline/lights.js';
 import { ClusterBuffers, ViewLightList } from './clusters.js';
+import { DataStore } from './data-store.js';
 import { type ColorAttachment, type NodeContext, type RenderView } from './graph.js';
 import { type DrawList, Mesh3d, MeshMaterial } from './instances.js';
 import { MaterialPipelines } from './material-pipelines.js';
@@ -15,8 +17,12 @@ export interface ViewGpu {
     /** This frame's SSAO texture, when the camera has Ssao. */
     ao: GPUTexture | undefined;
     lightList: ViewLightList;
-    clusters: ClusterBuffers;
-    shadowData: GpuBuffer;
+    /** GPU clustering's buffers (full tier). */
+    clusters: ClusterBuffers | undefined;
+    /** Packed lights and cluster bits, binned on the CPU (baseline, 0064). */
+    baseline: BaselineViewLights | undefined;
+    /** Shadow cascades, spot and point matrices: `@data(uniform)`. */
+    shadowData: DataStore;
     cascades: Cascades;
     bindGroup: GPUBindGroup | undefined;
     bound: string;
@@ -24,7 +30,11 @@ export interface ViewGpu {
     clusterBound: string;
 }
 interface Layouts {
+    /** Group 0 as this frame binds it: `viewBase`, or with the interior bindings (0069) while on. */
     view: GPUBindGroupLayout;
+    viewBase: GPUBindGroupLayout;
+    /** Made on first use: few apps turn interior lighting on. */
+    viewInterior: GPUBindGroupLayout | undefined;
     pipeline: GPUPipelineLayout;
     cluster: GPUBindGroupLayout;
     clusterPipeline: GPUPipelineLayout;
@@ -58,13 +68,30 @@ export interface ForwardState {
     globals: GpuBuffer;
     globalsData: Float32Array;
     pipelines: MaterialPipelines;
+    /** The baseline tier's strategies (0064), loaded only on a baseline device. */
+    baseline: typeof import('./baseline/lights.js') | undefined;
     /** G-buffer color targets (the emissive format depends on the device). */
     gbufferTargets: GPUColorTargetState[];
     /** Whether GPU culling ran this frame (the cull node reads it). */
     cullerActive: boolean;
+    /** Interior lighting's mode this frame (0069): INTERIOR_SKY | INTERIOR_BLOCKED, or 0. */
+    interiorMode: number;
 }
 export declare const ForwardStateResource: import("@aethervtt/shard-core").ResourceDef<ForwardState>;
+export declare const forwardQueue: import("@aethervtt/shard-core").SystemDef<undefined>;
+/** `ViewUniform.pixelScale` for a camera: see the field. */
+export declare function viewPixelScale(cam: CameraData, out: Float32Array): Float32Array;
 export declare const upload: import("@aethervtt/shard-core").SystemDef<undefined>;
+export declare const VERTEX_BUFFERS: GPUVertexBufferLayout[];
+/** Interior lighting's defines (0069) by mode: sky visibility (1), wall-blocked lights (2). */
+export declare const INTERIOR_DEFINES: readonly [undefined, {
+    readonly SKY_VISIBILITY: true;
+}, {
+    readonly BLOCKED_LIGHTS: true;
+}, {
+    readonly SKY_VISIBILITY: true;
+    readonly BLOCKED_LIGHTS: true;
+}];
 export declare const PASS_OPAQUE = 0;
 export declare const PASS_TRANSPARENT = 1;
 export declare const PASS_GBUFFER = 3;
@@ -72,6 +99,15 @@ export declare const PASS_GBUFFER = 3;
 export declare const PASS_PREPASS = 5;
 /** Entity ids, normals, and depth for GPU picking (picking.ts). */
 export declare const PASS_PICK = 7;
+/** Ground bands (0057): forward shading, depth tested but not written. */
+export declare const PASS_GROUND = 9;
+/** Picking ground bands: they share their floor's depth, so equal depth passes. */
+export declare const PASS_PICK_GROUND = 11;
+/**
+ * Baseline (0064): opaque depth alone, single-sampled, drawn with the prepass's vertex stage. It
+ * stands in for resolving multisampled depth, which GLSL ES 3.00 can't read.
+ */
+export declare const PASS_DEPTH = 13;
 /**
  * The picking pass's color targets: entity id, and the world normal with the depth in w (0 where
  * nothing drew). Depth rides in a color target because depth formats only copy out whole.