@derschmale/tiny-helix 0.1.0

package/dist/UniformBuffer.d.ts

@@ -0,0 +1,84 @@
+import { WebGPUContext } from "./WebGPUContext";
+import { Buffer } from "./Buffer";
+export declare enum BaseType {
+    Float16 = 0,
+    Float32 = 1,
+    Uint = 2,
+    Sint = 3,
+    Boolean = 4
+}
+export type UBOFieldData = number[] | Float32Array | Uint32Array | Int32Array;
+declare enum ContainerType {
+    Scalar = 0,
+    Vec = 1,
+    Matrix2 = 2,// a matrix of 2 vec[numElements]<baseType>
+    Matrix3 = 3,
+    Matrix4 = 4,
+    Array = 5
+}
+declare class MemberType {
+    baseType: BaseType;
+    containerType: ContainerType;
+    numElements: number;
+    constructor(baseType: BaseType, containerType: ContainerType, numElements: number);
+    get size(): number;
+    get alignment(): number;
+}
+interface Member {
+    type: MemberType;
+    offset: number;
+}
+export declare class UniformBufferLayoutBuilder {
+    private _size;
+    private _members;
+    withSize(size: number): this;
+    pushScalar(baseType: BaseType, name: string): this;
+    pushVec2(baseType: BaseType, name: string): this;
+    pushVec3(baseType: BaseType, name: string): this;
+    pushVec4(baseType: BaseType, name: string): this;
+    pushMatrix(baseType: BaseType, name: string, numRows: number, numCols: number): this;
+    build(): UniformBufferLayout;
+    private _pushField;
+}
+export declare class UniformBufferLayout {
+    readonly size: number;
+    private _members;
+    constructor(size: number, members: Map<string, Member>);
+    _writeScalar(name: string, value: number, target: DataView): void;
+    _writeVec(name: string, values: UBOFieldData, target: DataView): void;
+    _writeMatrix(name: string, values: UBOFieldData, target: DataView): void;
+    private _getMemberOrThrow;
+}
+export declare class UniformBuffer {
+    private _buffer;
+    private _layout;
+    private _dataInvalid;
+    private _data;
+    /**
+     * @internal
+     */
+    constructor(layout: UniformBufferLayout, ctx: WebGPUContext);
+    /**
+     * Sets the value of a scalar field.
+     * @param name Name of the scalar field.
+     * @param value Value to set.
+     */
+    setScalar(name: string, value: number): this;
+    /**
+     * Sets the values for a vector field.
+     * @param name Name of the vector field.
+     * @param values Array of values to set.
+     */
+    setVec(name: string, values: number[]): this;
+    /**
+     * Sets the values for a matrix field.
+     * @param name Name of the matrix field.
+     * @param values Array of values to set. The values are expected to be in column-major order.
+     */
+    setMatrix(name: string, values: UBOFieldData): this;
+    /**
+     * @internal
+     */
+    _getBuffer(ctx: WebGPUContext): Buffer;
+}
+export {};

package/dist/WebGPUContext.d.ts

@@ -0,0 +1,70 @@
+/// <reference types="@webgpu/types" />
+import { ColorSpace, TextureFormat } from "./enums";
+/**
+ * Options for initializing WebGPU context
+ */
+export interface WebGPUContextOptions {
+    /** The canvas element to render to */
+    canvas?: HTMLCanvasElement;
+    /** Power preference for adapter selection */
+    powerPreference?: GPUPowerPreference;
+    /** Required features for the device */
+    requiredFeatures?: GPUFeatureName[];
+    /** Required limits for the device */
+    requiredLimits?: Record<string, number>;
+    colorSpace?: ColorSpace;
+}
+/**
+ * Manages WebGPU adapter, device, and context initialization
+ */
+export declare class WebGPUContext {
+    private _adapter;
+    private _device;
+    private _context;
+    private _format;
+    private _canvas;
+    private _colorSpace;
+    /**
+     * Gets the WebGPU adapter. Throws if not initialized.
+     */
+    get adapter(): GPUAdapter;
+    /**
+     * Gets the WebGPU device. Throws if not initialized.
+     */
+    get device(): GPUDevice;
+    /**
+     * Gets the GPU canvas context. Throws if no canvas was configured.
+     */
+    get context(): GPUCanvasContext;
+    /**
+     * Gets the preferred texture format used by the configured canvas/context.
+     */
+    get format(): TextureFormat;
+    /**
+     * Gets the color space used by the configured canvas/context.
+     */
+    get colorSpace(): ColorSpace;
+    /**
+     * Gets the configured canvas element. Throws if none was provided during initialization.
+     */
+    get canvas(): HTMLCanvasElement;
+    /**
+     * Checks if WebGPU is supported in the current environment.
+     */
+    static isSupported(): boolean;
+    /**
+     * Initializes the WebGPU context and device.
+     * @param options - Configuration options such as canvas and adapter preferences
+     * @throws Error if WebGPU is not supported or initialization fails
+     */
+    initialize(options?: WebGPUContextOptions): Promise<void>;
+    /**
+     * Internal helper to fetch the current swapchain texture.
+     * @internal
+     */
+    getCurrentTexture(): GPUTexture;
+    /**
+     * Destroys the WebGPU context and releases resources
+     */
+    destroy(): void;
+}

package/dist/buffers/Buffer.d.ts

@@ -0,0 +1,79 @@
+/// <reference types="@webgpu/types" />
+import { WebGPUContext } from "../WebGPUContext";
+import { IBuffer } from "./IBuffer";
+/**
+ * Buffer usage flags re-exported from the WebGPU API for convenience.
+ * Use these when constructing buffers with `BufferBuilder.withUsage()`.
+ */
+export declare enum BufferUsage {
+    MapRead,
+    MapWrite,
+    CopySrc,
+    CopyDst,
+    Index,
+    Vertex,
+    Uniform,
+    Storage,
+    Indirect,
+    QueryResolve
+}
+export declare enum TextureUsage {
+    CopySrc,
+    CopyDst,
+    TextureBinding,
+    StorageBinding,
+    RenderAttachment
+}
+/**
+ * Builder for creating GPU-backed buffers.
+ *
+ * Example:
+ * const buf = new BufferBuilder(ctx)
+ *   .withUsage(BufferUsage.Vertex | BufferUsage.CopyDst)
+ *   .withData(new Float32Array([...]).buffer)
+ *   .build();
+ */
+export declare class BufferBuilder {
+    private _ctx;
+    private _data?;
+    private _size;
+    private _keepData;
+    private _usage;
+    constructor(ctx: WebGPUContext);
+    /**
+     * Add usage flags for the GPU buffer.
+     */
+    withUsage(usage: BufferUsage): this;
+    /**
+     * Provide initial data for the buffer. If `keepOnCPU` is true the original
+     * ArrayBuffer is stored in the resulting `Buffer.data` field for readback or
+     * reuse.
+     */
+    withData(data: ArrayBufferLike, keepOnCPU?: boolean): this;
+    /**
+     * Specify a size for the buffer, used when not providing data.
+     */
+    withSize(size: number): this;
+    /**
+     * Create the GPU buffer and upload any provided data.
+     */
+    build(): Buffer;
+}
+/**
+ * Lightweight wrapper around a GPUBuffer. Exposes the original CPU-side data
+ * (when kept) and the underlying GPU buffer for low-level interop.
+ */
+export declare class Buffer implements IBuffer {
+    readonly _inner: GPUBuffer;
+    readonly data?: ArrayBufferLike;
+    /**
+     * Create a Buffer from an existing GPUBuffer.
+     * @param inner The underlying GPUBuffer.
+     * @param data Optional CPU-side copy of the buffer contents.
+     */
+    constructor(inner: GPUBuffer, data?: ArrayBufferLike);
+    /** Size of the GPU buffer in bytes. */
+    get size(): number;
+    _uploadData(ctx: WebGPUContext): void;
+    _getBufferResource(): GPUBindingResource;
+}

package/dist/buffers/BufferDataWriter.d.ts

@@ -0,0 +1,68 @@
+import { IndexedCollection } from "../utils/IndexedCollection";
+/**
+ * Utility for incrementally building binary data into an ArrayBuffer.
+ * Provides typed push helpers for common numeric types used in vertex/index buffers.
+ */
+export declare class BufferDataWriter {
+    private _buffer;
+    private _view;
+    private _offset;
+    /** Create a new writer with the given total byte size. */
+    constructor(byteSize: number);
+    /** Push an unsigned 8-bit integer. */
+    pushUint8(value: number): this;
+    /** Push two unsigned 8-bit integers. */
+    pushUint8x2(x: number, y: number): this;
+    /** Push four unsigned 8-bit integers. */
+    pushUint8x4(x: number, y: number, z: number, w: number): this;
+    /** Push a signed 8-bit integer. */
+    pushSint8(value: number): this;
+    /** Push two signed 8-bit integers. */
+    pushSint8x2(x: number, y: number): this;
+    /** Push four signed 8-bit integers. */
+    pushSint8x4(x: number, y: number, z: number, w: number): this;
+    /** Push an unsigned 16-bit integer (little-endian). */
+    pushUint16(value: number): this;
+    /** Push two unsigned 16-bit integers (little-endian). */
+    pushUint16x2(x: number, y: number): this;
+    /** Push four unsigned 16-bit integers (little-endian). */
+    pushUint16x4(x: number, y: number, z: number, w: number): this;
+    /** Push a signed 16-bit integer (little-endian). */
+    pushSint16(value: number): this;
+    /** Push two signed 16-bit integers (little-endian). */
+    pushSint16x2(x: number, y: number): this;
+    /** Push four signed 16-bit integers (little-endian). */
+    pushSint16x4(x: number, y: number, z: number, w: number): this;
+    /** Push a 16-bit float (little-endian). */
+    pushFloat16(value: number): this;
+    /** Push two 16-bit floats (little-endian). */
+    pushFloat16x2(x: number, y: number): this;
+    /** Push four 16-bit floats (little-endian). */
+    pushFloat16x4(x: number, y: number, z: number, w: number): this;
+    /** Push a 32-bit float (little-endian). */
+    pushFloat32(value: number): this;
+    /** Push two 32-bit floats (little-endian). */
+    pushFloat32x2(arr: [number, number] | IndexedCollection): this;
+    /** Push four 32-bit floats (little-endian). */
+    pushFloat32x3(arr: [number, number, number] | IndexedCollection): this;
+    /** Push an 8-bit float (little-endian). */
+    pushFloat32x4(arr: [number, number, number, number] | IndexedCollection): this;
+    /** Push an unsigned 32-bit integer (little-endian). */
+    pushUint32(value: number): this;
+    /** Push two unsigned 32-bit integers (little-endian). */
+    pushUint32x2(arr: [number, number] | Uint32Array): this;
+    /** Push three unsigned 32-bit integers (little-endian). */
+    pushUint32x3(arr: [number, number, number] | Uint32Array): this;
+    /** Push four unsigned 32-bit integers (little-endian). */
+    pushUint32x4(arr: [number, number, number, number] | Uint32Array): this;
+    /** Push a signed 32-bit integer (little-endian). */
+    pushSint32(value: number): this;
+    /** Push two signed 32-bit integers (little-endian). */
+    pushSint32x2(arr: [number, number] | Int32Array): this;
+    /** Push three signed 32-bit integers (little-endian). */
+    pushSint32x3(arr: [number, number, number] | Int32Array): this;
+    /** Push four signed 32-bit integers (little-endian). */
+    pushSint32x4(arr: [number, number, number, number] | Int32Array): this;
+    /** Returns the underlying ArrayBuffer containing all written data. */
+    get arrayBuffer(): ArrayBuffer;
+}

package/dist/buffers/IBuffer.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="@webgpu/types" />
+export interface IBuffer {
+    _getBufferResource(): GPUBindingResource;
+}

package/dist/buffers/UniformBuffer.d.ts

@@ -0,0 +1,111 @@
+/// <reference types="@webgpu/types" />
+import { WebGPUContext } from "../WebGPUContext";
+import { IBuffer } from "./IBuffer";
+import { IndexedCollection } from "../utils/IndexedCollection";
+/**
+ * Primitive base types supported by the uniform buffer helpers.
+ * These correspond to WGSL scalar types used inside UBOs.
+ */
+export declare enum BaseType {
+    Float16 = 0,
+    Float32 = 1,
+    Uint = 2,
+    Sint = 3,
+    Boolean = 4
+}
+declare enum ContainerType {
+    Scalar = 0,
+    Vec = 1,
+    Matrix = 2,// a matrix of 2 vec[numElements]<baseType>
+    Array = 3
+}
+declare class MemberType {
+    baseType: BaseType;
+    containerType: ContainerType;
+    numRows: number;
+    numCols: number;
+    constructor(baseType: BaseType, containerType: ContainerType, numRows: number, numCols: number);
+    get size(): number;
+    get alignment(): number;
+}
+interface Member {
+    type: MemberType;
+    offset: number;
+}
+export declare class UniformBufferLayoutBuilder {
+    private _size;
+    private _members;
+    /**
+     * Reserve an explicit size for the resulting UBO layout. If not set the
+     * builder will compute a size that fits all declared members.
+     */
+    withSize(size: number): this;
+    pushScalar(baseType: BaseType, name: string): this;
+    pushVec2(baseType: BaseType, name: string): this;
+    pushVec3(baseType: BaseType, name: string): this;
+    pushVec4(baseType: BaseType, name: string): this;
+    pushMatrix(baseType: BaseType, numRows: number, numCols: number, name: string): this;
+    /**
+     * Finalize and return a `UniformBufferLayout` describing member offsets and total size.
+     */
+    build(): UniformBufferLayout;
+    private _pushField;
+}
+/**
+ * Describes the layout of a uniform buffer including member offsets and total size.
+ * Use `UniformBufferLayoutBuilder` to construct instances.
+ */
+export declare class UniformBufferLayout {
+    readonly size: number;
+    private _members;
+    constructor(size: number, members: Map<string, Member>);
+    /**
+     * Create typed DataViews for each member of the layout.
+     * @internal
+     */
+    _createDataViews(target: ArrayBuffer): Map<string, [Member, IndexedCollection]>;
+    private _getMemberOrThrow;
+}
+/**
+ * GPU-backed uniform buffer wrapper providing typed setters and an upload method.
+ * Use {@link TinyHelix.createUniformBuffer} to create instances.
+ */
+export declare class UniformBuffer implements IBuffer {
+    private _buffer;
+    private _data;
+    private _ctx;
+    private _dataViews;
+    /**
+     * Create a new UniformBuffer with the given layout and WebGPU context.
+     * @internal
+     */
+    constructor(layout: UniformBufferLayout, ctx: WebGPUContext);
+    /**
+     * Sets the value of a scalar field.
+     * @param name Name of the scalar field.
+     * @param value Value to set.
+     */
+    setScalar(name: string, value: number): this;
+    /**
+     * Sets the values for a vector field.
+     * @param name Name of the vector field.
+     * @param values Array of values to set.
+     */
+    setVec(name: string, values: number[] | IndexedCollection): this;
+    /**
+     * Sets the values for a matrix field.
+     * @param name Name of the matrix field.
+     * @param values Array of values to set. The values are expected to be in column-major order.
+     */
+    setMatrix(name: string, values: number[] | IndexedCollection): this;
+    /**
+     * Upload the current buffer contents to the GPU.
+     */
+    upload(): this;
+    /**
+     * Internal accessor returning the underlying Buffer wrapper.
+     * @internal
+     */
+    _getBufferResource(): GPUBindingResource;
+}
+export {};

package/dist/enums.d.ts

@@ -0,0 +1,158 @@
+export declare enum ColorSpace {
+    sRGB = "srgb",
+    DisplayP3 = "display-p3"
+}
+export declare enum FilterMode {
+    Nearest = "nearest",
+    Linear = "linear"
+}
+export declare enum AddressMode {
+    ClampToEdge = "clamp-to-edge",
+    Repeat = "repeat",
+    MirrorRepeat = "mirror-repeat"
+}
+/**
+ * Face culling modes used by the render pipeline primitive state.
+ */
+export declare enum CullMode {
+    None = "none",
+    Front = "front",
+    Back = "back"
+}
+export declare enum TextureFormat {
+    R8Unorm = "r8unorm",
+    R8Snorm = "r8snorm",
+    R8Uint = "r8uint",
+    R8Sint = "r8sint",
+    R16Unorm = "r16unorm",
+    R16Snorm = "r16snorm",
+    R16Uint = "r16uint",
+    R16Sint = "r16sint",
+    R16Float = "r16float",
+    RG8Unorm = "rg8unorm",
+    RG8Snorm = "rg8snorm",
+    RG8Uint = "rg8uint",
+    RG8Sint = "rg8sint",
+    R32Uint = "r32uint",
+    R32Sint = "r32sint",
+    R32Float = "r32float",
+    RG16Unorm = "rg16unorm",
+    RG16Snorm = "rg16snorm",
+    RG16Uint = "rg16uint",
+    RG16Sint = "rg16sint",
+    RG16Float = "rg16float",
+    Rgba8Unorm = "rgba8unorm",
+    Rgba8UnormSrgb = "rgba8unorm-srgb",
+    Rgba8Snorm = "rgba8snorm",
+    Rgba8Uint = "rgba8uint",
+    Rgba8Sint = "rgba8sint",
+    Bgra8Unorm = "bgra8unorm",
+    Bgra8UnormSrgb = "bgra8unorm-srgb",
+    Rgb9e5Ufloat = "rgb9e5ufloat",
+    Rgb10a2Uint = "rgb10a2uint",
+    Rgb10a2Unorm = "rgb10a2unorm",
+    Rg11b10Ufloat = "rg11b10ufloat",
+    RG32Uint = "rg32uint",
+    RG32Sint = "rg32sint",
+    RG32Float = "rg32float",
+    Rgba16Unorm = "rgba16unorm",
+    Rgba16Snorm = "rgba16snorm",
+    Rgba16Uint = "rgba16uint",
+    Rgba16Sint = "rgba16sint",
+    Rgba16Float = "rgba16float",
+    Rgba32Uint = "rgba32uint",
+    Rgba32Sint = "rgba32sint",
+    Rgba32Float = "rgba32float",
+    Stencil8 = "stencil8",
+    Depth16Unorm = "depth16unorm",
+    Depth24Plus = "depth24plus",
+    Depth24PlusStencil8 = "depth24plus-stencil8",
+    Depth32Float = "depth32float",
+    Depth32FloatStencil8 = "depth32float-stencil8",
+    Bc1RgbaUnorm = "bc1-rgba-unorm",
+    Bc1RgbaUnormSrgb = "bc1-rgba-unorm-srgb",
+    Bc2RgbaUnorm = "bc2-rgba-unorm",
+    Bc2RgbaUnormSrgb = "bc2-rgba-unorm-srgb",
+    Bc3RgbaUnorm = "bc3-rgba-unorm",
+    Bc3RgbaUnormSrgb = "bc3-rgba-unorm-srgb",
+    Bc4RUnorm = "bc4-r-unorm",
+    Bc4RSnorm = "bc4-r-snorm",
+    Bc5RgUnorm = "bc5-rg-unorm",
+    Bc5RgSnorm = "bc5-rg-snorm",
+    Bc6hRgbUfloat = "bc6h-rgb-ufloat",
+    Bc6hRgbFloat = "bc6h-rgb-float",
+    Bc7RgbaUnorm = "bc7-rgba-unorm",
+    Bc7RgbaUnormSrgb = "bc7-rgba-unorm-srgb",
+    Etc2Rgb8Unorm = "etc2-rgb8unorm",
+    Etc2Rgb8UnormSrgb = "etc2-rgb8unorm-srgb",
+    Etc2Rgb8A1Unorm = "etc2-rgb8a1unorm",
+    Etc2Rgb8A1UnormSrgb = "etc2-rgb8a1unorm-srgb",
+    Etc2Rgba8Unorm = "etc2-rgba8unorm",
+    Etc2Rgba8UnormSrgb = "etc2-rgba8unorm-srgb",
+    EacR11Unorm = "eac-r11unorm",
+    EacR11Snorm = "eac-r11snorm",
+    EacRg11Unorm = "eac-rg11unorm",
+    EacRg11Snorm = "eac-rg11snorm",
+    Astc4x4Unorm = "astc-4x4-unorm",
+    Astc4x4UnormSrgb = "astc-4x4-unorm-srgb",
+    Astc5x4Unorm = "astc-5x4-unorm",
+    Astc5x4UnormSrgb = "astc-5x4-unorm-srgb",
+    Astc5x5Unorm = "astc-5x5-unorm",
+    Astc5x5UnormSrgb = "astc-5x5-unorm-srgb",
+    Astc6x5Unorm = "astc-6x5-unorm",
+    Astc6x5UnormSrgb = "astc-6x5-unorm-srgb",
+    Astc6x6Unorm = "astc-6x6-unorm",
+    Astc6x6UnormSrgb = "astc-6x6-unorm-srgb",
+    Astc8x5Unorm = "astc-8x5-unorm",
+    Astc8x5UnormSrgb = "astc-8x5-unorm-srgb",
+    Astc8x6Unorm = "astc-8x6-unorm",
+    Astc8x6UnormSrgb = "astc-8x6-unorm-srgb",
+    Astc8x8Unorm = "astc-8x8-unorm",
+    Astc8x8UnormSrgb = "astc-8x8-unorm-srgb",
+    Astc10x5Unorm = "astc-10x5-unorm",
+    Astc10x5UnormSrgb = "astc-10x5-unorm-srgb",
+    Astc10x6Unorm = "astc-10x6-unorm",
+    Astc10x6UnormSrgb = "astc-10x6-unorm-srgb",
+    Astc10x8Unorm = "astc-10x8-unorm",
+    Astc10x8UnormSrgb = "astc-10x8-unorm-srgb",
+    Astc10x10Unorm = "astc-10x10-unorm",
+    Astc10x10UnormSrgb = "astc-10x10-unorm-srgb",
+    Astc12x10Unorm = "astc-12x10-unorm",
+    Astc12x10UnormSrgb = "astc-12x10-unorm-srgb",
+    Astc12x12Unorm = "astc-12x12-unorm",
+    Astc12x12UnormSrgb = "astc-12x12-unorm-srgb"
+}
+export declare enum BlendFactor {
+    Zero = "zero",
+    One = "one",
+    SrcColor = "src",
+    OneMinusSrcColor = "one-minus-src",
+    SrcAlpha = "src-alpha",
+    OneMinusSrcAlpha = "one-minus-src-alpha",
+    DstColor = "dst",
+    OneMinusDstColor = "one-minus-dst",
+    DstAlpha = "dst-alpha",
+    OneMinusDstAlpha = "one-minus-dst-alpha",
+    SrcAlphaSaturated = "src-alpha-saturated",
+    Constant = "constant",
+    OneMinusConstant = "one-minus-constant",
+    Src1Color = "src1",
+    OneMinusSrc1Color = "one-minus-src1",
+    Src1Alpha = "src1-alpha",
+    OneMinusSrc1Alpha = "one-minus-src1-alpha"
+}
+export declare enum CompareFunction {
+    Never = "never",
+    Less = "less",
+    Equal = "equal",
+    LessEqual = "less-equal",
+    Greater = "greater",
+    NotEqual = "not-equal",
+    GreaterEqual = "greater-equal",
+    Always = "always"
+}
+export declare enum StorageAccess {
+    ReadWrite = "read-write",
+    Read = "read-only",
+    Write = "write-only"
+}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * tiny-helix: A TypeScript library for WebGPU
+ * @packageDocumentation
+ */
+export { TinyHelix, type TinyHelixOptions } from "./TinyHelix";
+export { WebGPUContext, type WebGPUContextOptions } from "./WebGPUContext";
+import { TinyHelix } from "./TinyHelix";
+export default TinyHelix;
+export * from "./BindGroup";
+export * from "./BlendMode";
+export * from "./CommandEncoder";
+export * from "./ComputePass";
+export * from "./ComputePipeline";
+export * from "./enums";
+export * from "./Mesh";
+export * from "./RenderPass";
+export * from "./RenderPipeline";
+export * from "./RenderTarget";
+export * from "./Sampler";
+export * from "./Shader";
+export * from "./Texture";
+export * from "./buffers/Buffer";
+export * from "./buffers/UniformBuffer";
+export * from "./buffers/BufferDataWriter";

package/dist/main.js

@@ -0,0 +1,2 @@
+(()=>{"use strict";var n,t,i,r,o,x,e;!function(n){n.None="none",n.Front="front",n.Back="back"}(n||(n={})),(e=t||(t={}))[e.MapRead=GPUBufferUsage.MAP_READ]="MapRead",e[e.MapWrite=GPUBufferUsage.MAP_WRITE]="MapWrite",e[e.CopySrc=GPUBufferUsage.COPY_SRC]="CopySrc",e[e.CopyDst=GPUBufferUsage.COPY_DST]="CopyDst",e[e.Index=GPUBufferUsage.INDEX]="Index",e[e.Vertex=GPUBufferUsage.VERTEX]="Vertex",e[e.Uniform=GPUBufferUsage.UNIFORM]="Uniform",e[e.Storage=GPUBufferUsage.STORAGE]="Storage",e[e.Indirect=GPUBufferUsage.INDIRECT]="Indirect",e[e.QueryResolve=GPUBufferUsage.QUERY_RESOLVE]="QueryResolve",function(n){n.Uint16="uint16",n.Uint32="uint32"}(i||(i={})),function(n){n.TriangleList="triangle-list",n.TriangleStrip="triangle-strip",n.LineList="line-list",n.LineStrip="line-strip",n.PointList="point-list"}(r||(r={})),function(n){n.Clockwise="cw",n.CounterClockwise="ccw"}(o||(o={})),function(n){n.Uint8="uint8",n.Uint8x2="uint8x2",n.Uint8x4="uint8x4",n.Sint8="sint8",n.Sint8x2="sint8x2",n.Sint8x4="sint8x4",n.Unorm8="unorm8",n.Unorm8x2="unorm8x2",n.Unorm8x4="unorm8x4",n.Snorm8="snorm8",n.Snorm8x2="snorm8x2",n.Snorm8x4="snorm8x4",n.Uint16="uint16",n.Uint16x2="uint16x2",n.Uint16x4="uint16x4",n.Sint16="sint16",n.Sint16x2="sint16x2",n.Sint16x4="sint16x4",n.Unorm16="unorm16",n.Unorm16x2="unorm16x2",n.Unorm16x4="unorm16x4",n.Snorm16="snorm16",n.Snorm16x2="snorm16x2",n.Snorm16x4="snorm16x4",n.Float16="float16",n.Float16x2="float16x2",n.Float16x4="float16x4",n.Float32="float32",n.Float32x2="float32x2",n.Float32x3="float32x3",n.Float32x4="float32x4",n.Uint32="uint32",n.Uint32x2="uint32x2",n.Uint32x3="uint32x3",n.Uint32x4="uint32x4",n.Sint32="sint32",n.Sint32x2="sint32x2",n.Sint32x3="sint32x3",n.Sint32x4="sint32x4",n.Unorm10_10_10_2="unorm10-10-10-2",n.Unorm8x4_bgra="unorm8x4-bgra"}(x||(x={}))})();
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","mappings":"mBAKA,IAAYA,ECHA,ECEAC,EAoBAC,EAQAC,EAKAC,EDnCAC,GDGZ,SAAYL,GACR,cACA,gBACA,aACH,CAJD,CAAYA,IAAAA,EAAQ,MCHRK,EAAA,MAAW,KACnB,UAAUC,eAAeC,UAAQ,UACjC,aAAWD,eAAeE,WAAS,WACnC,YAAUF,eAAeG,UAAQ,UACjC,YAAUH,eAAeI,UAAQ,UACjC,UAAQJ,eAAeK,OAAK,QAC5B,WAASL,eAAeM,QAAM,SAC9B,YAAUN,eAAeO,SAAO,UAChC,YAAUP,eAAeQ,SAAO,UAChC,aAAWR,eAAeS,UAAQ,WAClC,iBAAeT,eAAeU,eAAa,eCR/C,SAAYf,GACR,kBACA,iBACH,CAHD,CAAYA,IAAAA,EAAW,KAoBvB,SAAYC,GACR,+BACA,iCACA,uBACA,yBACA,wBACH,CAND,CAAYA,IAAAA,EAAY,KAQxB,SAAYC,GACR,iBACA,wBACH,CAHD,CAAYA,IAAAA,EAAS,KAKrB,SAAYC,GACR,gBACA,oBACA,oBACA,gBACA,oBACA,oBACA,kBACA,sBACA,sBACA,kBACA,sBACA,sBACA,kBACA,sBACA,sBACA,kBACA,sBACA,sBACA,oBACA,wBACA,wBACA,oBACA,wBACA,wBACA,oBACA,wBACA,wBACA,oBACA,wBACA,wBACA,wBACA,kBACA,sBACA,sBACA,sBACA,kBACA,sBACA,sBACA,sBACA,oCACA,+BACH,CA1CD,CAAYA,IAAAA,EAAY,I","sources":["./src/RenderPipeline.ts","./src/Buffer.ts","./src/Mesh.ts"],"sourcesContent":["import {Shader} from \"./Shader\";\r\nimport {mapUndefined} from \"./utils/mapUndefined\";\r\nimport {WebGPUContext} from \"./WebGPUContext\";\r\nimport {Mesh} from \"./Mesh\";\r\n\r\nexport enum CullMode {\r\n    None = 'none',\r\n    Front = 'front',\r\n    Back = 'back'\r\n}\r\n\r\nexport class RenderPipelineBuilder {\r\n    private _shader?: Shader;\r\n    private _colorTargets: GPUColorTargetState[] = [];\r\n    private _defaultColorState: GPUColorTargetState;\r\n    private _ctx: WebGPUContext;\r\n    private _vertexEntry: string | undefined = undefined;\r\n    private _fragmentEntry: string | undefined = undefined;\r\n    private _label: string | undefined = undefined;\r\n    private _overrideConstants: Record<string, number> = {};\r\n    private _cullMode: CullMode = CullMode.Back;\r\n    private _mesh: Mesh | undefined = undefined;\r\n\r\n    constructor(ctx: WebGPUContext) {\r\n        this._ctx = ctx;\r\n        this._defaultColorState = {\r\n            format: ctx.format,\r\n            blend: undefined,\r\n            writeMask: GPUColorWrite.ALL\r\n        }\r\n    }\r\n\r\n    withLabel(label: string): this {\r\n        this._label = label;\r\n        return this;\r\n    }\r\n\r\n    withCullMode(value: CullMode): this {\r\n        this._cullMode = value;\r\n        return this;\r\n    }\r\n\r\n    withMesh(mesh: Mesh): this {\r\n        this._mesh = mesh;\r\n        return this;\r\n    }\r\n\r\n    withShader(shader: Shader): this {\r\n        this._shader = shader;\r\n        return this;\r\n    }\r\n\r\n    withVertexShader(entry: string): this {\r\n        this._vertexEntry = entry;\r\n        return this;\r\n    }\r\n\r\n    withFragmentShader(entry: string): this {\r\n        this._fragmentEntry = entry;\r\n        return this;\r\n    }\r\n\r\n    withColorTarget(format: GPUTextureFormat): this {\r\n        this._colorTargets.push({\r\n            format,\r\n            blend: undefined,\r\n            writeMask: GPUColorWrite.ALL\r\n        });\r\n        return this;\r\n    }\r\n\r\n    withOverrideConstant(id: string, value: number): this {\r\n        this._overrideConstants[id] = value;\r\n        return this;\r\n    }\r\n\r\n    withBlendMode(): this {\r\n        this.lastColorTarget.blend = undefined;\r\n        return this;\r\n    }\r\n\r\n    build(): RenderPipeline {\r\n        if (!this._shader) {\r\n            throw new Error(\"Shader not specified. Use withShader() to set the shader to use.\");\r\n        }\r\n\r\n        const shader = this._shader!;\r\n\r\n        if (this._vertexEntry === undefined) {\r\n            throw new Error(\"Shader does not contain a vertex entry point. Use ShaderBuilder.withVertexShader() to set one.\");\r\n        }\r\n\r\n        const colorTargets = this._colorTargets.length ? this._colorTargets : [this._defaultColorState];\r\n        const primitive: GPUPrimitiveState | undefined = mapUndefined(this._mesh, mesh => ({\r\n            topology: mesh.topology,\r\n            frontFace: mesh.frontFace,\r\n            cullMode: this._cullMode,\r\n        }));\r\n\r\n        const buffers = mapUndefined(this._mesh, mesh => {\r\n            const buffers: GPUVertexBufferLayout[] = [];\r\n            for (let i = 0; i < mesh.numStreams; ++i) {\r\n               const attributes = mesh.getStreamAttributes(i)\r\n                    .filter(attr => shader.hasVertexAttribute(attr.name))\r\n                    .map(attr => ({\r\n                        shaderLocation: shader.getVertexAttributeLocation(attr.name)!,\r\n                        offset: attr.offset,\r\n                        format: attr.format,\r\n                    }));\r\n\r\n                buffers.push({\r\n                    arrayStride: mesh.getStreamStride(i),\r\n                    stepMode: 'vertex',\r\n                    attributes\r\n                });\r\n            }\r\n            return buffers;\r\n        });\r\n\r\n        const desc: GPURenderPipelineDescriptor = {\r\n            label: this._label,\r\n            layout: shader.layout ?? \"auto\",\r\n            primitive,\r\n            vertex: {\r\n                buffers,\r\n                module: shader.inner,\r\n                entryPoint: this._vertexEntry!,\r\n                constants: this._overrideConstants\r\n            },\r\n            fragment: mapUndefined(this._fragmentEntry, entry => ({\r\n                module: shader.inner,\r\n                entryPoint: entry,\r\n                targets: colorTargets,\r\n                constants: this._overrideConstants\r\n            }))\r\n        }\r\n\r\n        const inner = this._ctx.device.createRenderPipeline(desc);\r\n\r\n        return new RenderPipeline(inner, shader);\r\n    }\r\n\r\n    private get lastColorTarget(): GPUColorTargetState {\r\n        return this._colorTargets.length ? this._colorTargets[this._colorTargets.length - 1] : this._defaultColorState;\r\n    }\r\n}\r\n\r\n/**\r\n * Lightweight wrapper around GPURenderPipeline. Provides an internal accessor for low-level interop.\r\n */\r\nexport class RenderPipeline {\r\n    private _inner: GPURenderPipeline;\r\n    private _shader: Shader;\r\n\r\n    constructor(inner: GPURenderPipeline, shader: Shader) {\r\n        this._inner = inner;\r\n        this._shader = shader;\r\n    }\r\n\r\n    /**\r\n     * Internal accessor for the underlying GPURenderPipeline. Not intended for public use.\r\n     * @internal\r\n     */\r\n    get inner(): GPURenderPipeline {\r\n        return this._inner;\r\n    }\r\n\r\n    public getVertexAttributeLocation(name: string): number | undefined {\r\n        return this._shader.getVertexAttributeLocation(name);\r\n    }\r\n}","import {WebGPUContext} from \"./WebGPUContext\";\r\n\r\nexport enum BufferUsage {\r\n    MapRead = GPUBufferUsage.MAP_READ,\r\n    MapWrite = GPUBufferUsage.MAP_WRITE,\r\n    CopySrc = GPUBufferUsage.COPY_SRC,\r\n    CopyDst = GPUBufferUsage.COPY_DST,\r\n    Index = GPUBufferUsage.INDEX,\r\n    Vertex = GPUBufferUsage.VERTEX,\r\n    Uniform = GPUBufferUsage.UNIFORM,\r\n    Storage = GPUBufferUsage.STORAGE,\r\n    Indirect = GPUBufferUsage.INDIRECT,\r\n    QueryResolve = GPUBufferUsage.QUERY_RESOLVE\r\n}\r\n\r\nexport class BufferBuilder {\r\n    private _ctx: WebGPUContext;\r\n    private _data?: ArrayBufferLike;\r\n    private _size = 0;\r\n    private _keepData = false;\r\n    private _usage: number = 0;\r\n\r\n    constructor(ctx: WebGPUContext) {\r\n        this._ctx = ctx;\r\n    }\r\n\r\n    withUsage(usage: BufferUsage): this\r\n    {\r\n        this._usage |= usage;\r\n        return this;\r\n    }\r\n\r\n    withData(data: ArrayBufferLike, keepOnCPU: boolean = false) {\r\n        this._data = data;\r\n        this._keepData = keepOnCPU;\r\n        return this;\r\n    }\r\n\r\n    build(): Buffer {\r\n        const data = this._keepData? this._data : undefined;\r\n        const buffer = this._ctx.device.createBuffer({\r\n            size: this._size,\r\n            usage: this._usage\r\n        });\r\n        if (this._data) {\r\n            this._ctx.device.queue.writeBuffer(\r\n                buffer,\r\n                0,\r\n                this._data,\r\n                0,\r\n                this._data.byteLength\r\n            );\r\n        }\r\n        return new Buffer(buffer, data);\r\n    }\r\n}\r\n\r\nexport class Buffer {\r\n    private _data?: ArrayBufferLike;\r\n    private _inner: GPUBuffer;\r\n\r\n    constructor(inner: GPUBuffer, data?: ArrayBufferLike) {\r\n        this._inner = inner;\r\n        this._data = data;\r\n    }\r\n\r\n    get inner(): GPUBuffer { return this._inner; }\r\n    get data(): ArrayBufferLike | undefined { return this._data; }\r\n}","import {Buffer, BufferBuilder, BufferUsage} from \"./Buffer\";\r\nimport {WebGPUContext} from \"./WebGPUContext\";\r\nimport {mapUndefined} from \"./utils/mapUndefined\";\r\n\r\nexport enum IndexFormat {\r\n    Uint16 = 'uint16',\r\n    Uint32 = 'uint32'\r\n}\r\n\r\nclass IndexBuffer {\r\n    buffer: Buffer;\r\n    format: IndexFormat;\r\n    count: number;\r\n\r\n    constructor(data: Uint16Array | Uint32Array, ctx: WebGPUContext, keepData: boolean = false) {\r\n        this.format = data instanceof Uint16Array ? IndexFormat.Uint16 : IndexFormat.Uint32;\r\n        this.count = data.length;\r\n        this.buffer = new BufferBuilder(ctx)\r\n            .withData(data.buffer, keepData)\r\n            .withUsage(BufferUsage.CopyDst | BufferUsage.Index)\r\n            .build();\r\n    }\r\n}\r\n\r\nexport enum MeshTopology {\r\n    TriangleList = 'triangle-list',\r\n    TriangleStrip = 'triangle-strip',\r\n    LineList = 'line-list',\r\n    LineStrip = 'line-strip',\r\n    PointList = 'point-list'\r\n}\r\n\r\nexport enum FrontFace {\r\n    Clockwise = 'cw',\r\n    CounterClockwise = 'ccw'\r\n}\r\n\r\nexport enum VertexFormat {\r\n    Uint8 = 'uint8',\r\n    Uint8x2 = 'uint8x2',\r\n    Uint8x4 = 'uint8x4',\r\n    Sint8 = 'sint8',\r\n    Sint8x2 = 'sint8x2',\r\n    Sint8x4 = 'sint8x4',\r\n    Unorm8 = 'unorm8',\r\n    Unorm8x2 = 'unorm8x2',\r\n    Unorm8x4 = 'unorm8x4',\r\n    Snorm8 = 'snorm8',\r\n    Snorm8x2 = 'snorm8x2',\r\n    Snorm8x4 = 'snorm8x4',\r\n    Uint16 = 'uint16',\r\n    Uint16x2 = 'uint16x2',\r\n    Uint16x4 = 'uint16x4',\r\n    Sint16 = 'sint16',\r\n    Sint16x2 = 'sint16x2',\r\n    Sint16x4 = 'sint16x4',\r\n    Unorm16 = 'unorm16',\r\n    Unorm16x2 = 'unorm16x2',\r\n    Unorm16x4 = 'unorm16x4',\r\n    Snorm16 = 'snorm16',\r\n    Snorm16x2 = 'snorm16x2',\r\n    Snorm16x4 = 'snorm16x4',\r\n    Float16 = 'float16',\r\n    Float16x2 = 'float16x2',\r\n    Float16x4 = 'float16x4',\r\n    Float32 = 'float32',\r\n    Float32x2 = 'float32x2',\r\n    Float32x3 = 'float32x3',\r\n    Float32x4 = 'float32x4',\r\n    Uint32 = 'uint32',\r\n    Uint32x2 = 'uint32x2',\r\n    Uint32x3 = 'uint32x3',\r\n    Uint32x4 = 'uint32x4',\r\n    Sint32 = 'sint32',\r\n    Sint32x2 = 'sint32x2',\r\n    Sint32x3 = 'sint32x3',\r\n    Sint32x4 = 'sint32x4',\r\n    Unorm10_10_10_2 = 'unorm10-10-10-2',\r\n    Unorm8x4_bgra = 'unorm8x4-bgra'\r\n}\r\n\r\nfunction vertexFormatByteSize(format: VertexFormat): number {\r\n    switch (format) {\r\n        case VertexFormat.Uint8:\r\n        case VertexFormat.Sint8:\r\n        case VertexFormat.Unorm8:\r\n        case VertexFormat.Snorm8:\r\n            return 1;\r\n        case VertexFormat.Uint8x2:\r\n        case VertexFormat.Sint8x2:\r\n        case VertexFormat.Unorm8x2:\r\n        case VertexFormat.Snorm8x2:\r\n        case VertexFormat.Uint16:\r\n        case VertexFormat.Sint16:\r\n        case VertexFormat.Unorm16:\r\n        case VertexFormat.Snorm16:\r\n        case VertexFormat.Float16:\r\n            return 2;\r\n        case VertexFormat.Uint8x4:\r\n        case VertexFormat.Sint8x4:\r\n        case VertexFormat.Unorm8x4:\r\n        case VertexFormat.Snorm8x4:\r\n        case VertexFormat.Uint16x2:\r\n        case VertexFormat.Sint16x2:\r\n        case VertexFormat.Unorm16x2:\r\n        case VertexFormat.Snorm16x2:\r\n        case VertexFormat.Float16x2:\r\n        case VertexFormat.Float32:\r\n        case VertexFormat.Uint32:\r\n        case VertexFormat.Sint32:\r\n        case VertexFormat.Unorm10_10_10_2:\r\n        case VertexFormat.Unorm8x4_bgra:\r\n            return 4;\r\n        case VertexFormat.Uint16x4:\r\n        case VertexFormat.Sint16x4:\r\n        case VertexFormat.Unorm16x4:\r\n        case VertexFormat.Snorm16x4:\r\n        case VertexFormat.Float16x4:\r\n        case VertexFormat.Float32x2:\r\n        case VertexFormat.Uint32x2:\r\n        case VertexFormat.Sint32x2:\r\n            return 8;\r\n        case VertexFormat.Float32x3:\r\n        case VertexFormat.Uint32x3:\r\n        case VertexFormat.Sint32x3:\r\n            return 12;\r\n\r\n        case VertexFormat.Float32x4:\r\n        case VertexFormat.Uint32x4:\r\n        case VertexFormat.Sint32x4:\r\n            return 16;\r\n    }\r\n}\r\n\r\nexport type VertexAttribute = {\r\n    name: string;\r\n    format: VertexFormat;\r\n    offset: number;\r\n}\r\n\r\nclass VertexStream {\r\n    stride: number = 0;\r\n    attributes: VertexAttribute[] = [];\r\n    buffer?: Buffer;\r\n\r\n    pushAttribute(name: string, format: VertexFormat) {\r\n\r\n        this.attributes.push({name, format, offset: this.stride});\r\n        this.stride += vertexFormatByteSize(format);\r\n    }\r\n}\r\n\r\nexport class MeshBuilder {\r\n    private _topology: MeshTopology = MeshTopology.TriangleList;\r\n    private _frontFace: FrontFace = FrontFace.CounterClockwise;\r\n    private _streams: VertexStream[] = [new VertexStream()];\r\n    private _ctx: WebGPUContext;\r\n    private _indexBuffer?: IndexBuffer;\r\n    private _numVertices: number = 0;\r\n\r\n    constructor(ctx: WebGPUContext) {\r\n        this._ctx = ctx;\r\n    }\r\n\r\n    pushStream(data: ArrayBufferLike, keepOnCPU: boolean = false): this {\r\n        const stream = this._streams[this._streams.length - 1];\r\n        stream.buffer = new BufferBuilder(this._ctx)\r\n            .withData(data, keepOnCPU)\r\n            .withUsage(BufferUsage.Vertex | BufferUsage.CopyDst)\r\n            .build();\r\n\r\n        const numVertices = data.byteLength / stream.stride;\r\n        console.assert(this._streams.length == 0 || numVertices == this._numVertices, \"All vertex buffers must have the same number of vertices.\")\r\n        this._numVertices = numVertices;\r\n\r\n        this._streams.push(new VertexStream());\r\n        return this;\r\n    }\r\n\r\n    pushAttribute(name: string, format: VertexFormat): this {\r\n        const streamIndex = this._streams.length - 1;\r\n        const stream = this._streams[streamIndex];\r\n        stream.pushAttribute(name, format);\r\n        return this;\r\n    }\r\n\r\n    withFrontFace(value: FrontFace): this {\r\n        this._frontFace = value;\r\n        return this;\r\n    }\r\n\r\n    withTopology(value: MeshTopology): this {\r\n        this._topology = value;\r\n        return this;\r\n    }\r\n\r\n    withIndexData(data: Uint16Array | Uint32Array, keepOnCPU: boolean = false): this {\r\n        this._indexBuffer = mapUndefined(data, data => new IndexBuffer(data, this._ctx, keepOnCPU));\r\n        return this;\r\n    }\r\n\r\n    build(): Mesh {\r\n        // remove the last stream, it's empty\r\n        this._streams.pop();\r\n\r\n        return new Mesh(\r\n            this._topology,\r\n            this._frontFace,\r\n            this._numVertices,\r\n            this._streams,\r\n            this._indexBuffer,\r\n        );\r\n    }\r\n}\r\n\r\nexport class Mesh {\r\n    private _topology: MeshTopology;\r\n    private _frontFace: FrontFace;\r\n    private _streams: VertexStream[] = [];\r\n    private _indexBuffer?: IndexBuffer;\r\n    private _numVertices: number;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    constructor(topology: MeshTopology, frontFace: FrontFace, numVertices: number, streams: VertexStream[], indexBuffer?: IndexBuffer) {\r\n        this._topology = topology;\r\n        this._frontFace = frontFace;\r\n        this._streams = streams;\r\n        this._numVertices = numVertices;\r\n        this._indexBuffer = indexBuffer;\r\n    }\r\n\r\n    get topology(): MeshTopology {\r\n        return this._topology;\r\n    }\r\n\r\n    get frontFace(): FrontFace {\r\n        return this._frontFace;\r\n    }\r\n\r\n    get numStreams() {\r\n        return this._streams.length;\r\n    }\r\n\r\n    get numVertices() {\r\n        return this._numVertices;\r\n    }\r\n\r\n    getVertexBuffer(streamIndex: number): Buffer {\r\n        return this._streams[streamIndex].buffer!;\r\n    }\r\n\r\n    getStreamStride(streamIndex: number): number {\r\n        return this._streams[streamIndex].stride;\r\n    }\r\n\r\n    getStreamAttributes(streamIndex: number): VertexAttribute[] {\r\n        return this._streams[streamIndex].attributes;\r\n    }\r\n\r\n    get indexBuffer(): Buffer | undefined {\r\n        return this._indexBuffer?.buffer;\r\n    }\r\n\r\n    get indexFormat(): IndexFormat {\r\n        return this._indexBuffer?.format ?? IndexFormat.Uint16;\r\n    }\r\n\r\n    get numIndices(): number {\r\n        return this._indexBuffer?.count ?? 0;\r\n    }\r\n}"],"names":["CullMode","IndexFormat","MeshTopology","FrontFace","VertexFormat","BufferUsage","GPUBufferUsage","MAP_READ","MAP_WRITE","COPY_SRC","COPY_DST","INDEX","VERTEX","UNIFORM","STORAGE","INDIRECT","QUERY_RESOLVE"],"ignoreList":[],"sourceRoot":""}