@tapez/core 0.0.0-alpha.0 → 0.0.0-alpha.2

package/dist/schemas.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Renderer-owned tapez schemas — shared GPU structs used by the rendering engine.
+ * Widgets import these via @import in their WGSL shaders.
+ */
+import * as tapez from './index';
+export declare const CameraUniform: tapez.TapezStruct<{
+    boundsMin: tapez.TapezVector;
+    boundsMax: tapez.TapezVector;
+    viewport: tapez.TapezVector;
+    zoom: tapez.TapezScalar;
+    dpr: tapez.TapezScalar;
+}>;
+export declare const Theme: tapez.TapezStruct<{
+    bg: tapez.TapezVector;
+    text: tapez.TapezVector;
+    bids: tapez.TapezVector;
+    bidsSecondary: tapez.TapezVector;
+    asks: tapez.TapezVector;
+    asksSecondary: tapez.TapezVector;
+    accent: tapez.TapezVector;
+    accentSecondary: tapez.TapezVector;
+}>;
+export declare const BgColorUniforms: tapez.TapezStruct<{
+    color: tapez.TapezVector;
+}>;
+export declare const TextParams: tapez.TapezStruct<{
+    distance_range: tapez.TapezScalar;
+    screen_px_range: tapez.TapezScalar;
+    atlas_size: tapez.TapezScalar;
+    em_size: tapez.TapezScalar;
+}>;
+export declare const GlyphData: tapez.TapezStruct<{
+    uv_rect: tapez.TapezVector;
+    plane_rect: tapez.TapezVector;
+}>;
+export declare const TEXT_INSTANCE_STRIDE: tapez.TapezConst<tapez.TapezScalar>;
+export declare const IndirectDraw: tapez.TapezStruct<{
+    vertexCount: tapez.TapezScalar;
+    instanceCount: tapez.TapezScalar;
+    firstVertex: tapez.TapezScalar;
+    firstInstance: tapez.TapezScalar;
+}>;
+export declare const PriceFeed: tapez.TapezStruct<{
+    price: tapez.TapezScalar;
+    direction: tapez.TapezScalar;
+    _pad0: tapez.TapezScalar;
+    _pad1: tapez.TapezScalar;
+}>;
+export declare const LineConfig: tapez.TapezStruct<{
+    lineWidthPx: tapez.TapezScalar;
+    _pad0: tapez.TapezScalar;
+    _pad1: tapez.TapezScalar;
+    _pad2: tapez.TapezScalar;
+}>;
+export declare const MarkerConfig: tapez.TapezStruct<{
+    heightPx: tapez.TapezScalar;
+    _pad0: tapez.TapezScalar;
+    _pad1: tapez.TapezScalar;
+    _pad2: tapez.TapezScalar;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAMhC,eAAO,MAAM,aAAa;;;;;;EAMxB,CAAA;AAMF,eAAO,MAAM,KAAK;;;;;;;;;EAShB,CAAA;AAMF,eAAO,MAAM,eAAe;;EAE1B,CAAA;AAMF,eAAO,MAAM,UAAU;;;;;EAKrB,CAAA;AAEF,eAAO,MAAM,SAAS;;;EAGpB,CAAA;AAEF,eAAO,MAAM,oBAAoB,qCAA+C,CAAA;AAMhF,eAAO,MAAM,YAAY;;;;;EAKvB,CAAA;AAMF,eAAO,MAAM,SAAS;;;;;EAKpB,CAAA;AAMF,eAAO,MAAM,UAAU;;;;;EAKrB,CAAA;AAMF,eAAO,MAAM,YAAY;;;;;EAKvB,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,85 @@
+/**
+ * Renderer-owned tapez schemas — shared GPU structs used by the rendering engine.
+ * Widgets import these via @import in their WGSL shaders.
+ */
+import * as tapez from './index';
+// ---------------------------------------------------------------------------
+// Camera
+// ---------------------------------------------------------------------------
+export const CameraUniform = tapez.struct('CameraUniform', {
+    boundsMin: tapez.vec2f,
+    boundsMax: tapez.vec2f,
+    viewport: tapez.vec2f,
+    zoom: tapez.f32,
+    dpr: tapez.f32,
+});
+// ---------------------------------------------------------------------------
+// Theme — 8 named colors
+// ---------------------------------------------------------------------------
+export const Theme = tapez.struct('Theme', {
+    bg: tapez.vec4f,
+    text: tapez.vec4f,
+    bids: tapez.vec4f,
+    bidsSecondary: tapez.vec4f,
+    asks: tapez.vec4f,
+    asksSecondary: tapez.vec4f,
+    accent: tapez.vec4f,
+    accentSecondary: tapez.vec4f,
+});
+// ---------------------------------------------------------------------------
+// Background color
+// ---------------------------------------------------------------------------
+export const BgColorUniforms = tapez.struct('Uniforms', {
+    color: tapez.vec4f,
+});
+// ---------------------------------------------------------------------------
+// MSDF text rendering
+// ---------------------------------------------------------------------------
+export const TextParams = tapez.struct('TextParams', {
+    distance_range: tapez.f32,
+    screen_px_range: tapez.f32,
+    atlas_size: tapez.f32,
+    em_size: tapez.f32,
+});
+export const GlyphData = tapez.struct('GlyphData', {
+    uv_rect: tapez.vec4f,
+    plane_rect: tapez.vec4f,
+});
+export const TEXT_INSTANCE_STRIDE = tapez.const('INSTANCE_STRIDE', tapez.u32, 9);
+// ---------------------------------------------------------------------------
+// Indirect draw (generic GPU pattern)
+// ---------------------------------------------------------------------------
+export const IndirectDraw = tapez.struct('IndirectDraw', {
+    vertexCount: tapez.u32,
+    instanceCount: tapez.u32,
+    firstVertex: tapez.u32,
+    firstInstance: tapez.u32,
+});
+// ---------------------------------------------------------------------------
+// Price feed (used by chart entities)
+// ---------------------------------------------------------------------------
+export const PriceFeed = tapez.struct('PriceFeed', {
+    price: tapez.f32,
+    direction: tapez.u32,
+    _pad0: tapez.f32,
+    _pad1: tapez.f32,
+});
+// ---------------------------------------------------------------------------
+// Line config (used by price line entity)
+// ---------------------------------------------------------------------------
+export const LineConfig = tapez.struct('LineConfig', {
+    lineWidthPx: tapez.f32,
+    _pad0: tapez.f32,
+    _pad1: tapez.f32,
+    _pad2: tapez.f32,
+});
+// ---------------------------------------------------------------------------
+// Marker config (used by price marker entity)
+// ---------------------------------------------------------------------------
+export const MarkerConfig = tapez.struct('MarkerConfig', {
+    heightPx: tapez.f32,
+    _pad0: tapez.f32,
+    _pad1: tapez.f32,
+    _pad2: tapez.f32,
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/struct.d.ts

@@ -0,0 +1,47 @@
+/**
+ * TapeZ struct definition — the core of the schema system.
+ *
+ * Usage:
+ *   const MyConfig = tapez.struct('MyConfig', {
+ *     midPrice: tapez.f32,
+ *     rowHeight: tapez.f32,
+ *     decimals: tapez.u32,
+ *   })
+ *
+ *   MyConfig.byteSize    // 12
+ *   MyConfig.offsets      // { midPrice: 0, rowHeight: 4, decimals: 8 }
+ *   MyConfig.toWGSL()    // "struct MyConfig {\n  midPrice: f32,\n  ..."
+ */
+import type { TapezType } from './types';
+import { type StructLayout } from './layout';
+export interface TapezStruct<F extends Record<string, TapezType> = Record<string, TapezType>> extends TapezType {
+    readonly kind: 'struct';
+    /** Struct name (used in WGSL output) */
+    readonly name: string;
+    /** Field type definitions, keyed by name */
+    readonly fields: F;
+    /** Byte offset of each field */
+    readonly offsets: {
+        readonly [K in keyof F]: number;
+    };
+    /** Field names in definition order */
+    readonly fieldOrder: readonly (keyof F & string)[];
+    /** Full computed layout with per-field metadata */
+    readonly layout: StructLayout;
+    /** Generate WGSL struct declaration */
+    toWGSL(): string;
+    /**
+     * Create a new struct with specified fields wrapped in atomic<>.
+     * Same memory layout — atomic<u32> and u32 are identical in size/alignment.
+     * Only u32 and i32 fields can be made atomic.
+     */
+    withAtomics<K extends keyof F & string>(name: string, atomicFields: K[]): TapezStruct<F>;
+}
+/**
+ * Define a GPU struct schema.
+ *
+ * Fields are laid out in definition order following WGSL alignment rules.
+ * The returned object is frozen and can be shared across entities.
+ */
+export declare function struct<F extends Record<string, TapezType>>(name: string, fields: F): TapezStruct<F>;
+//# sourceMappingURL=struct.d.ts.map

package/dist/struct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct.d.ts","sourceRoot":"","sources":["../src/struct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,SAAS,CAAA;AAErD,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AAMnF,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAC1F,SAAQ,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAClB,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;KAAE,CAAA;IACrD,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAA;IAClD,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,uCAAuC;IACvC,MAAM,IAAI,MAAM,CAAA;IAChB;;;;OAIG;IACH,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,CAAC,EAAE,GAChB,WAAW,CAAC,CAAC,CAAC,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACxD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,GACR,WAAW,CAAC,CAAC,CAAC,CAoDhB"}

package/dist/struct.js

@@ -0,0 +1,81 @@
+/**
+ * TapeZ struct definition — the core of the schema system.
+ *
+ * Usage:
+ *   const MyConfig = tapez.struct('MyConfig', {
+ *     midPrice: tapez.f32,
+ *     rowHeight: tapez.f32,
+ *     decimals: tapez.u32,
+ *   })
+ *
+ *   MyConfig.byteSize    // 12
+ *   MyConfig.offsets      // { midPrice: 0, rowHeight: 4, decimals: 8 }
+ *   MyConfig.toWGSL()    // "struct MyConfig {\n  midPrice: f32,\n  ..."
+ */
+import { atomic } from './types';
+import { computeStructLayout } from './layout';
+/**
+ * Define a GPU struct schema.
+ *
+ * Fields are laid out in definition order following WGSL alignment rules.
+ * The returned object is frozen and can be shared across entities.
+ */
+export function struct(name, fields) {
+    const fieldOrder = Object.keys(fields);
+    const fieldEntries = fieldOrder.map((k) => {
+        const t = fields[k];
+        if (!t)
+            throw new Error(`struct ${name}: missing field type for "${k}"`);
+        return { name: k, type: t };
+    });
+    const layout = computeStructLayout(fieldEntries);
+    const offsets = {};
+    for (const k of fieldOrder) {
+        const off = layout.offsets[k];
+        if (off === undefined)
+            throw new Error(`struct ${name}: missing offset for "${k}"`);
+        offsets[k] = off;
+    }
+    const result = {
+        kind: 'struct',
+        wgslType: name,
+        name,
+        byteSize: layout.byteSize,
+        alignment: layout.alignment,
+        fields,
+        offsets,
+        fieldOrder,
+        layout,
+        toWGSL() {
+            return structToWGSL(result);
+        },
+        withAtomics(atomicName, atomicFields) {
+            const atomicSet = new Set(atomicFields);
+            const newFields = {};
+            for (const k of fieldOrder) {
+                const fieldType = fields[k];
+                if (!fieldType)
+                    throw new Error(`withAtomics: missing field "${k}"`);
+                if (atomicSet.has(k)) {
+                    if (fieldType.kind !== 'scalar') {
+                        throw new Error(`withAtomics: field "${k}" is not a scalar (got ${fieldType.kind})`);
+                    }
+                    newFields[k] = atomic(fieldType);
+                }
+                else {
+                    newFields[k] = fieldType;
+                }
+            }
+            return struct(atomicName, newFields);
+        }
+    };
+    return Object.freeze(result);
+}
+// ---------------------------------------------------------------------------
+// WGSL emission
+// ---------------------------------------------------------------------------
+function structToWGSL(s) {
+    const lines = s.layout.fields.map((f) => `  ${f.name}: ${f.type.wgslType},`);
+    return `struct ${s.name} {\n${lines.join('\n')}\n}`;
+}
+//# sourceMappingURL=struct.js.map

package/dist/struct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct.js","sourceRoot":"","sources":["../src/struct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,mBAAmB,EAAuC,MAAM,UAAU,CAAA;AAgCnF;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CACpB,IAAY,EACZ,MAAS;IAET,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAyB,CAAA;IAC9D,MAAM,YAAY,GAAwC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7E,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,6BAA6B,CAAC,GAAG,CAAC,CAAA;QACxE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAEhD,MAAM,OAAO,GAAG,EAAgC,CAAA;IAChD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC7B,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,yBAAyB,CAAC,GAAG,CAAC,CAClF;QAAC,OAAkC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;IAC/C,CAAC;IAED,MAAM,MAAM,GAAmB;QAC7B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM;QACN,OAAO;QACP,UAAU;QACV,MAAM;QACN,MAAM;YACJ,OAAO,YAAY,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;QACD,WAAW,CACT,UAAkB,EAClB,YAAiB;YAEjB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,YAAY,CAAC,CAAA;YAC/C,MAAM,SAAS,GAAG,EAA+B,CAAA;YACjD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;gBAC3B,IAAI,CAAC,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,GAAG,CAAC,CAAA;gBACpE,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrB,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAChC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,0BAA0B,SAAS,CAAC,IAAI,GAAG,CAAC,CAAA;oBACtF,CAAC;oBACD,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,SAAmC,CAAC,CAAA;gBAC5D,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;gBAC1B,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC,UAAU,EAAE,SAAc,CAAC,CAAA;QAC3C,CAAC;KACF,CAAA;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,YAAY,CAAC,CAAc;IAClC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;IACzF,OAAO,UAAU,CAAC,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAA;AACrD,CAAC"}

package/dist/typed-buffer.d.ts

@@ -0,0 +1,117 @@
+/**
+ * TypedBuffer — GPU buffer backed by a tapez type.
+ *
+ * Accepts any TapezType: scalars, vectors, arrays, structs.
+ * For structs, provides named field setters/getters with dirty tracking.
+ * For all types, provides the raw GPUBuffer, typed array views, and lifecycle.
+ *
+ * Usage:
+ *   // Struct — named setters
+ *   const config = TypedBuffer.createUniform(device, MyStruct, 'config')
+ *   config.set.midPrice(1.5)
+ *   config.writeIfDirty(queue)
+ *
+ *   // Array — raw typed array access
+ *   const rows = TypedBuffer.createStorage(device, tapez.arrayOf(tapez.f32, 4096), 'rows')
+ *   rows.raw.f32.set(myData)
+ *   rows.write(queue)
+ *
+ *   // Indirect draw
+ *   const indirect = TypedBuffer.createIndirect(device, IndirectDraw, 'indirect')
+ */
+import { DirtyUniformBuffer } from './gpu-buffer-utils';
+import type { TapezType, TapezScalar, TapezAtomic } from './types';
+import type { TapezVector } from './vectors';
+import type { TapezStruct } from './struct';
+/** Maps a TapezType to its TypeScript setter value type */
+type SetterValue<T extends TapezType> = T extends TapezScalar | TapezAtomic ? number : T extends TapezVector ? number[] | Float32Array | Uint32Array | Int32Array : number[] | Float32Array;
+/** Setter functions keyed by field name */
+type Setters<F extends Record<string, TapezType>> = {
+    readonly [K in keyof F]: (value: SetterValue<F[K]>) => void;
+};
+/** Getter functions keyed by field name */
+type Getters<F extends Record<string, TapezType>> = {
+    readonly [K in keyof F]: () => SetterValue<F[K]>;
+};
+/** Extract the fields type from a TapezStruct, or never */
+type FieldsOf<T extends TapezType> = T extends TapezStruct<infer F> ? F : never;
+export interface TypedBufferBase {
+    readonly buffer: GPUBuffer;
+    readonly byteSize: number;
+    readonly isDirty: boolean;
+    markDirty(): void;
+    writeIfDirty(queue: GPUQueue): void;
+    write(queue: GPUQueue): void;
+    writeRaw(queue: GPUQueue, data: BufferSource | SharedArrayBuffer, bufferOffset?: number, dataOffset?: number, size?: number): void;
+    copyTo(encoder: GPUCommandEncoder, dest: TypedBufferBase, srcOffset?: number, dstOffset?: number, size?: number): void;
+    copyFrom(encoder: GPUCommandEncoder, src: TypedBufferBase, srcOffset?: number, dstOffset?: number, size?: number): void;
+    drawIndirect(pass: GPURenderPassEncoder, offset?: number): void;
+    dispatchIndirect(pass: GPUComputePassEncoder, offset?: number): void;
+    mapRead(): Promise<ArrayBuffer>;
+    unmap(): void;
+    destroy(): void;
+}
+export declare class TypedBuffer<T extends TapezType = TapezType> implements TypedBufferBase {
+    /** The underlying DirtyUniformBuffer (provides typed array views: .f32, .u32, .i32) */
+    readonly raw: DirtyUniformBuffer;
+    /** The tapez type this buffer was created from */
+    readonly type: T;
+    /**
+     * Named field setters. Only available for struct types.
+     * For non-struct buffers this is an empty object.
+     */
+    readonly set: T extends TapezStruct<infer F> ? Setters<F> : Record<string, never>;
+    /**
+     * Named field getters. Only available for struct types.
+     * For non-struct buffers this is an empty object.
+     */
+    readonly get: T extends TapezStruct<infer F> ? Getters<F> : Record<string, never>;
+    private constructor();
+    /** The raw GPUBuffer — for texture/sampler bind group entries only */
+    get buffer(): GPUBuffer;
+    /** Total byte size of the buffer */
+    get byteSize(): number;
+    /** Whether any values have changed since last write */
+    get isDirty(): boolean;
+    /** Force dirty state (for external invalidation) */
+    markDirty(): void;
+    /** Upload to GPU only if dirty, then clear dirty flag */
+    writeIfDirty(queue: GPUQueue): void;
+    /** Upload to GPU unconditionally */
+    write(queue: GPUQueue): void;
+    /**
+     * Bulk set multiple struct fields at once.
+     * Only available for struct-typed buffers.
+     */
+    writeFields(values: Partial<{
+        [K in keyof FieldsOf<T>]: SetterValue<FieldsOf<T>[K]>;
+    }>): void;
+    /** Destroy the underlying GPU buffer */
+    destroy(): void;
+    /** Write raw data to this buffer via queue.writeBuffer */
+    writeRaw(queue: GPUQueue, data: BufferSource | SharedArrayBuffer, bufferOffset?: number, dataOffset?: number, size?: number): void;
+    /** Copy data from this buffer to another TypedBuffer */
+    copyTo(encoder: GPUCommandEncoder, dest: TypedBuffer, srcOffset?: number, dstOffset?: number, size?: number): void;
+    /** Copy data from another TypedBuffer into this buffer */
+    copyFrom(encoder: GPUCommandEncoder, src: TypedBuffer, srcOffset?: number, dstOffset?: number, size?: number): void;
+    /** Use this buffer for drawIndirect */
+    drawIndirect(pass: GPURenderPassEncoder, offset?: number): void;
+    /** Use this buffer for dispatchWorkgroupsIndirect */
+    dispatchIndirect(pass: GPUComputePassEncoder, offset?: number): void;
+    /** Map buffer for reading (for readback buffers). Returns the mapped ArrayBuffer. */
+    mapRead(): Promise<ArrayBuffer>;
+    /** Unmap a previously mapped buffer */
+    unmap(): void;
+    /** Create a buffer with explicit usage flags. Accepts any TapezType. */
+    static create<T extends TapezType>(device: GPUDevice, type: T, label: string, usage: GPUBufferUsageFlags): TypedBuffer<T>;
+    /** Create a uniform buffer (UNIFORM | STORAGE | COPY_DST) */
+    static createUniform<T extends TapezType>(device: GPUDevice, type: T, label: string): TypedBuffer<T>;
+    /** Create a storage buffer (STORAGE | COPY_DST). Pass extraFlags for COPY_SRC etc. */
+    static createStorage<T extends TapezType>(device: GPUDevice, type: T, label: string, extraFlags?: GPUBufferUsageFlags): TypedBuffer<T>;
+    /** Create an indirect draw/dispatch buffer (INDIRECT | STORAGE | COPY_DST) */
+    static createIndirect<T extends TapezType>(device: GPUDevice, type: T, label: string): TypedBuffer<T>;
+    /** Create a readback buffer (MAP_READ | COPY_DST). For GPU→CPU data transfer. */
+    static createReadback<T extends TapezType>(device: GPUDevice, type: T, label: string): TypedBuffer<T>;
+}
+export {};
+//# sourceMappingURL=typed-buffer.d.ts.map

package/dist/typed-buffer.d.ts.map

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