@asciiz/atoolkit 0.1.0

package/dist/awgpu_old/pipeline.js

@@ -0,0 +1,226 @@
+/**
+ * Format byte size lookup table for automatic stride and offset derivation.
+ */
+const VERTEX_FORMAT_SIZES = {
+    "float32": 4,
+    "float32x2": 8,
+    "float32x3": 12,
+    "float32x4": 16,
+    "uint32": 4,
+    "uint32x2": 8,
+    "uint32x4": 16,
+    "sint32": 4,
+    "sint32x2": 8,
+    "sint32x4": 16,
+    "unorm8x4": 4,
+    "snorm8x4": 4,
+    "uint8x4": 4,
+    "sint8x4": 4,
+    "unorm16x2": 4,
+    "snorm16x2": 4,
+    "uint16x2": 4,
+    "sint16x2": 4,
+    "unorm16x4": 8,
+    "snorm16x4": 8,
+    "uint16x4": 8,
+    "sint16x4": 8,
+    "float16x2": 4,
+    "float16x4": 8,
+};
+/**
+ * Derives GPUVertexBufferLayout with automatic cumulative offsets and 4-byte aligned arrayStride.
+ */
+export function createVertexLayout(attributes, stepMode = "vertex") {
+    let currentOffset = 0;
+    const resolvedAttributes = [];
+    for (const attr of attributes) {
+        const offset = attr.offset ?? currentOffset;
+        resolvedAttributes.push({
+            shaderLocation: attr.shaderLocation,
+            format: attr.format,
+            offset,
+        });
+        const size = VERTEX_FORMAT_SIZES[attr.format] ?? 4;
+        currentOffset = offset + size;
+    }
+    // Array stride aligned to 4 bytes
+    const arrayStride = Math.max(4, Math.ceil(currentOffset / 4) * 4);
+    return {
+        arrayStride,
+        stepMode,
+        attributes: resolvedAttributes,
+    };
+}
+function reportShaderMessages(module, stage, label, onMessage, diag) {
+    module.getCompilationInfo().then((info) => {
+        for (const msg of info.messages) {
+            const shaderMsg = {
+                type: msg.type,
+                stage,
+                message: msg.message,
+                lineNum: msg.lineNum,
+                linePos: msg.linePos,
+                offset: msg.offset,
+                length: msg.length,
+            };
+            onMessage?.(shaderMsg);
+            if (msg.type === "error") {
+                if (diag?.err) {
+                    diag.err({
+                        code: "SHADER_COMPILE_ERROR",
+                        raw: "[$stage$] Shader compilation error in $label$ line $lineNum$:$linePos$: $message$",
+                        data: { stage, label, lineNum: msg.lineNum, linePos: msg.linePos, message: msg.message },
+                    });
+                }
+                else if (!onMessage) {
+                    console.error(`[Pipeline] ${stage} shader error in ${label} line ${msg.lineNum}:${msg.linePos}: ${msg.message}`);
+                }
+            }
+            else if (msg.type === "warning") {
+                if (diag?.warn) {
+                    diag.warn({
+                        code: "SHADER_COMPILE_WARNING",
+                        raw: "[$stage$] Shader compilation warning in $label$ line $lineNum$:$linePos$: $message$",
+                        data: { stage, label, lineNum: msg.lineNum, linePos: msg.linePos, message: msg.message },
+                    });
+                }
+                else if (!onMessage) {
+                    console.warn(`[Pipeline] ${stage} shader warning in ${label} line ${msg.lineNum}:${msg.linePos}: ${msg.message}`);
+                }
+            }
+            else if (msg.type === "info") {
+                if (diag?.info) {
+                    diag.info({
+                        code: "SHADER_COMPILE_INFO",
+                        raw: "[$stage$] Shader compilation info in $label$ line $lineNum$:$linePos$: $message$",
+                        data: { stage, label, lineNum: msg.lineNum, linePos: msg.linePos, message: msg.message },
+                    });
+                }
+            }
+        }
+    });
+}
+/**
+ * WebGPU Render Pipeline wrapper supporting full shading as well as depth-only execution.
+ */
+export class RenderPipeline {
+    gpuPipeline;
+    label;
+    hasFragmentStage;
+    constructor(gpuPipeline, hasFragmentStage, label = "RenderPipeline") {
+        this.gpuPipeline = gpuPipeline;
+        this.hasFragmentStage = hasFragmentStage;
+        this.label = label;
+    }
+    /**
+     * Factory: Compiles shaders and instantiates GPURenderPipeline.
+     */
+    static create(device, descriptor) {
+        const label = descriptor.label ?? "RenderPipeline";
+        // 1. Vertex Shader Module
+        const vsModule = device.createShaderModule({
+            label: `${label}_VSModule`,
+            code: descriptor.vertex.code,
+        });
+        reportShaderMessages(vsModule, "vertex", `${label}_VSModule`, descriptor.onShaderMessage, descriptor.diag);
+        // 2. Pipeline Layout: explicit bind group layouts, custom layout, or auto
+        let pipelineLayout = descriptor.layout ?? "auto";
+        if (descriptor.bindGroupLayouts && descriptor.bindGroupLayouts.length > 0) {
+            let emptyLayout = null;
+            const sanitizedLayouts = descriptor.bindGroupLayouts.map((l) => {
+                if (!l) {
+                    if (!emptyLayout) {
+                        emptyLayout = device.createBindGroupLayout({ label: `${label}_EmptySlotLayout`, entries: [] });
+                    }
+                    return emptyLayout;
+                }
+                return l;
+            });
+            pipelineLayout = device.createPipelineLayout({
+                label: `${label}_PipelineLayout`,
+                bindGroupLayouts: sanitizedLayouts,
+            });
+        }
+        // 3. Build native descriptor
+        const nativeDesc = {
+            label,
+            layout: pipelineLayout,
+            vertex: {
+                module: vsModule,
+                entryPoint: descriptor.vertex.entryPoint ?? "vs_main",
+                buffers: descriptor.vertex.buffers ?? [],
+            },
+            primitive: descriptor.primitive ?? {
+                topology: "triangle-list",
+                cullMode: "back",
+                frontFace: "ccw",
+            },
+        };
+        if (descriptor.depthStencil) {
+            nativeDesc.depthStencil = descriptor.depthStencil;
+        }
+        if (descriptor.multisample) {
+            nativeDesc.multisample = descriptor.multisample;
+        }
+        // 4. Fragment Stage (Optional: omitted for depth-only passes such as z-prepasses or occluders)
+        const hasFragmentStage = !!descriptor.fragment;
+        if (descriptor.fragment) {
+            const fsCode = descriptor.fragment.code ?? descriptor.vertex.code;
+            const fsModule = fsCode === descriptor.vertex.code
+                ? vsModule
+                : device.createShaderModule({
+                    label: `${label}_FSModule`,
+                    code: fsCode,
+                });
+            if (fsModule !== vsModule) {
+                reportShaderMessages(fsModule, "fragment", `${label}_FSModule`, descriptor.onShaderMessage, descriptor.diag);
+            }
+            nativeDesc.fragment = {
+                module: fsModule,
+                entryPoint: descriptor.fragment.entryPoint ?? "fs_main",
+                targets: descriptor.fragment.targets,
+            };
+        }
+        const gpuPipeline = device.createRenderPipeline(nativeDesc);
+        return new RenderPipeline(gpuPipeline, hasFragmentStage, label);
+    }
+}
+/**
+ * WebGPU Compute Pipeline wrapper for compute shaders.
+ */
+export class ComputePipeline {
+    gpuPipeline;
+    label;
+    constructor(gpuPipeline, label = "ComputePipeline") {
+        this.gpuPipeline = gpuPipeline;
+        this.label = label;
+    }
+    /**
+     * Factory: Compiles compute shader and instantiates GPUComputePipeline.
+     */
+    static create(device, options) {
+        const label = options.label ?? "ComputePipeline";
+        const csModule = device.createShaderModule({
+            label: `${label}_CSModule`,
+            code: options.code,
+        });
+        reportShaderMessages(csModule, "compute", `${label}_CSModule`, options.onShaderMessage, options.diag);
+        let pipelineLayout = options.layout ?? "auto";
+        if (options.bindGroupLayouts && options.bindGroupLayouts.length > 0) {
+            pipelineLayout = device.createPipelineLayout({
+                label: `${label}_ComputeLayout`,
+                bindGroupLayouts: options.bindGroupLayouts,
+            });
+        }
+        const gpuPipeline = device.createComputePipeline({
+            label,
+            layout: pipelineLayout,
+            compute: {
+                module: csModule,
+                entryPoint: options.entryPoint ?? "cs_main",
+            },
+        });
+        return new ComputePipeline(gpuPipeline, label);
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/awgpu_old/pipeline.js.map

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

package/dist/awgpu_old/target.d.ts

@@ -0,0 +1,186 @@
+import type { Device } from "./device.js";
+/**
+ * GPU texture wrapper containing hardware texture, view, and metadata.
+ */
+export declare class Texture {
+    readonly gpuTexture: GPUTexture;
+    readonly gpuView: GPUTextureView;
+    width: number;
+    height: number;
+    depthOrArrayLayers: number;
+    readonly format: GPUTextureFormat;
+    readonly sampleCount: number;
+    readonly usage: GPUTextureUsageFlags;
+    readonly gpuOwned: boolean;
+    readonly label: string;
+    constructor(gpuTexture: GPUTexture, gpuView: GPUTextureView, width: number, height: number, format: GPUTextureFormat, usage: GPUTextureUsageFlags, options?: {
+        depthOrArrayLayers?: number;
+        sampleCount?: number;
+        gpuOwned?: boolean;
+        label?: string;
+    });
+    destroy(): void;
+    /**
+     * Creates 2D color or data texture.
+     */
+    static create2D(device: GPUDevice, options: {
+        width: number;
+        height: number;
+        format?: GPUTextureFormat;
+        usage?: GPUTextureUsageFlags;
+        sampleCount?: number;
+        label?: string;
+    }): Texture;
+    /**
+     * Creates 2D depth or depth-stencil texture.
+     */
+    static createDepth(device: GPUDevice, options: {
+        width: number;
+        height: number;
+        format?: GPUTextureFormat;
+        usage?: GPUTextureUsageFlags;
+        label?: string;
+    }): Texture;
+    /**
+     * Wraps existing GPUTexture and GPUTextureView.
+     */
+    static fromTexture(gpuTexture: GPUTexture, options?: {
+        view?: GPUTextureView;
+        label?: string;
+        gpuOwned?: boolean;
+    }): Texture;
+}
+/**
+ * GPU sampler wrapper supporting filtering and depth comparison.
+ */
+export declare class Sampler {
+    readonly gpuSampler: GPUSampler;
+    readonly label: string;
+    constructor(gpuSampler: GPUSampler, label?: string);
+    /**
+     * Creates standard trilinear or bilinear filtering sampler.
+     */
+    static createLinear(device: GPUDevice, label?: string): Sampler;
+    /**
+     * Creates point / nearest-neighbor sampler.
+     */
+    static createNearest(device: GPUDevice, label?: string): Sampler;
+    /**
+     * Creates hardware depth comparison sampler (e.g. for depth tests, shadow mapping, or depth peeling).
+     */
+    static createComparison(device: GPUDevice, options?: {
+        compare?: GPUCompareFunction;
+        label?: string;
+    }): Sampler;
+}
+export interface ColorAttachmentConfig {
+    texture: Texture | null;
+    clearColor?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    loadOp?: GPULoadOp;
+    storeOp?: GPUStoreOp;
+    resolveTarget?: Texture | null;
+}
+export interface DepthAttachmentConfig {
+    texture: Texture;
+    depthClearValue?: number;
+    depthLoadOp?: GPULoadOp;
+    depthStoreOp?: GPUStoreOp;
+    stencilClearValue?: number;
+    stencilLoadOp?: GPULoadOp;
+    stencilStoreOp?: GPUStoreOp;
+}
+/**
+ * Render destination descriptor supporting screen canvas, offscreen color buffers, MRT, and depth-only targets.
+ */
+export declare class RenderTarget {
+    readonly label: string;
+    readonly isScreen: boolean;
+    gfx?: Device;
+    width: number;
+    height: number;
+    colorAttachments: ColorAttachmentConfig[];
+    depthAttachment?: DepthAttachmentConfig;
+    private depthFormat?;
+    private colorFormat?;
+    private _cachedDescriptor?;
+    private _dirtyDescriptor;
+    constructor(label: string, width: number, height: number, options?: {
+        isScreen?: boolean;
+        gfx?: Device;
+        colorAttachments?: ColorAttachmentConfig[];
+        depthAttachment?: DepthAttachmentConfig;
+        depthFormat?: GPUTextureFormat;
+        colorFormat?: GPUTextureFormat;
+    });
+    /**
+     * Factory: Creates render target bound to canvas swapchain backbuffer.
+     * Set depthFormat: null to create a pure color screen target (e.g. for 2D/post-processing).
+     */
+    /**
+     * Factory: Creates render target bound to canvas swapchain backbuffer.
+     * Set depthFormat: null to create a pure color screen target (e.g. for 2D/post-processing).
+     */
+    static createScreen(gfx: Device, options?: {
+        depthFormat?: GPUTextureFormat | null;
+        clearColor?: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        label?: string;
+    }): RenderTarget;
+    /**
+     * Factory: Creates offscreen color and depth render target (e.g. for HDR, G-buffer, or RTT).
+     * Set depthFormat: null to create a pure color offscreen target.
+     */
+    static createOffscreen(device: GPUDevice, width: number, height: number, options?: {
+        colorFormat?: GPUTextureFormat;
+        depthFormat?: GPUTextureFormat | null;
+        clearColor?: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        label?: string;
+    }): RenderTarget;
+    /**
+     * Factory: Creates depth-only render target (e.g. for shadow maps or depth prepasses).
+     */
+    static createDepthOnly(device: GPUDevice, width: number, height: number, options?: {
+        depthFormat?: GPUTextureFormat;
+        label?: string;
+    }): RenderTarget;
+    /**
+     * Resizes internal textures when target dimensions change.
+     */
+    resize(device: GPUDevice, width: number, height: number): void;
+    /**
+     * Marks cached GPURenderPassDescriptor dirty, forcing rebuild on next pass.
+     */
+    invalidateDescriptor(): void;
+    /**
+     * Builds GPURenderPassDescriptor for command recording in active frame.
+     * Caches descriptor structure to eliminate per-frame object allocation.
+     * Supports optional per-pass loadOp and clear overrides for RTT chaining.
+     */
+    buildPassDescriptor(options?: {
+        loadOp?: GPULoadOp;
+        depthLoadOp?: GPULoadOp;
+        clearColor?: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        depthClearValue?: number;
+    }): GPURenderPassDescriptor;
+    destroy(): void;
+}
+//# sourceMappingURL=target.d.ts.map

package/dist/awgpu_old/target.d.ts.map

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