typegpu 0.0.0-alpha.3 → 0.0.0-alpha.4

package/index.d.cts

@@ -1,7 +1,7 @@
-import { W as WgslResolvable, a as WgslSlot, b as WgslPlum, E as ExtractPlumValue, c as WgslSettable, U as Unsubscribe, A as AnyWgslData, d as WgslAllocatable, e as Wgsl, B as BufferUsage, f as WgslBindable, g as Eventual, I as InlineResolve, h as WgslFnArgument, R as ResolutionCtx, i as WgslValue, j as WgslIdentifier, k as WgslResolvableSlot, p as plum, l as plumFromEvent } from './types-DeF6xFAt.cjs';
-export { t as AnyWgslPointer, q as EventualGetter, S as SlotValuePair, r as WgslData, s as WgslPointer, u as isPointer, m as isResolvable, o as isSlot, n as isWgsl } from './types-DeF6xFAt.cjs';
-import { Parsed } from 'typed-binary';
-import { W as WgslStruct } from './struct-ER9XI7ad.cjs';
+import { W as WgslResolvable, a as WgslSlot, E as Eventual, b as Wgsl, I as InlineResolve, c as WgslRenderResource, T as TextureUsage, S as StorageTextureParams, A as AnyWgslTexelFormat, d as SampledTextureParams, e as AnyWgslPrimitive, f as WgslRenderResourceType, g as StorageTextureAccess, R as ResolutionCtx, h as WgslPlum, i as ExtractPlumValue, j as WgslSettable, U as Unsubscribe, k as AnyWgslData, l as WgslAllocatable, B as BufferUsage, m as WgslBindable, n as WgslFnArgument, o as WgslValue, p as WgslIdentifier, q as WgslResolvableSlot, r as plum, s as plumFromEvent } from './types-ENDwr_p9.cjs';
+export { O as AnyWgslPointer, Q as BuiltInPossibleTypes, X as Builtin, w as EventualGetter, x as SlotValuePair, M as WgslData, C as WgslDepthTextureType, F as WgslExternalTextureType, N as WgslPointer, y as WgslSamplerType, D as WgslStorageTextureType, z as WgslTypedTextureType, V as builtin, Y as getBuiltinInfo, Z as getUsedBuiltinsNamed, J as isDepthTextureType, L as isExternalTextureType, P as isPointer, t as isResolvable, G as isSamplerType, v as isSlot, K as isStorageTextureType, H as isTypedTextureType, u as isWgsl } from './types-ENDwr_p9.cjs';
+import { Parsed, AnySchema } from 'typed-binary';
+import { S as SimpleWgslData } from './std140-DRitCcmc.cjs';
 
 /**
  * An error that happens during resolution of WGSL code.
@@ -38,6 +38,65 @@ declare abstract class Callable<TArgs extends [...any[]], TReturn> extends Funct
 type ICallable<TArgs extends [...any[]], TReturn> = (...args: TArgs) => TReturn;
 type AsCallable<T, TArgs extends [...any[]], TReturn> = T & ICallable<TArgs, TReturn>;
 
+type PlumListener<T> = (newValue: T) => unknown;
+
+interface WgslCode extends WgslResolvable {
+    $name(label?: string | undefined): WgslCode;
+    with<T>(slot: WgslSlot<T>, value: Eventual<T>): BoundWgslCode;
+}
+type BoundWgslCode = Omit<WgslCode, '$name'>;
+declare function code(strings: TemplateStringsArray, ...params: (Wgsl | Wgsl[] | InlineResolve)[]): WgslCode;
+
+interface WgslSampler extends WgslRenderResource {
+    readonly descriptor: GPUSamplerDescriptor;
+    $name(label: string): WgslSampler;
+}
+declare function sampler(descriptor: GPUSamplerDescriptor): WgslSampler;
+
+interface WgslAnyTextureView extends WgslRenderResource {
+    readonly descriptor: GPUTextureViewDescriptor;
+    readonly texture: WgslAnyTexture;
+    readonly dataType: AnyWgslPrimitive | AnyWgslTexelFormat;
+    readonly access: StorageTextureAccess | undefined;
+}
+interface WgslAnyTexture {
+    readonly descriptor: Omit<GPUTextureDescriptor, 'usage'>;
+    get flags(): GPUTextureUsageFlags;
+}
+interface WgslTexture<TAllows extends TextureUsage = never> {
+    readonly descriptor: Omit<GPUTextureDescriptor, 'usage'>;
+    get label(): string | undefined;
+    get flags(): GPUTextureUsageFlags;
+    $name(label: string): WgslTexture<TAllows>;
+    $allowSampled(): WgslTexture<TAllows | 'sampled'>;
+    $allowStorage(): WgslTexture<TAllows | 'storage'>;
+    asStorage(params: StorageTextureParams): 'storage' extends TAllows ? WgslTextureView<AnyWgslTexelFormat, 'storage'> : null;
+    asSampled(params: SampledTextureParams): 'sampled' extends TAllows ? WgslTextureView<typeof params.dataType, 'sampled'> : null;
+}
+interface WgslTextureView<TData extends AnyWgslPrimitive | AnyWgslTexelFormat, TUsage extends TextureUsage> extends WgslRenderResource {
+    readonly texture: WgslTexture<TUsage>;
+    readonly descriptor: Omit<GPUTextureViewDescriptor, 'usage'>;
+    readonly type: WgslRenderResourceType;
+    readonly dataType: TData;
+    readonly access: StorageTextureAccess | undefined;
+    $name(label: string): WgslTextureView<TData, TUsage>;
+}
+interface WgslTextureExternal extends WgslRenderResource {
+    readonly descriptor: GPUExternalTextureDescriptor;
+}
+declare function texture<TUsage extends TextureUsage = never>(descriptor: Omit<GPUTextureDescriptor, 'usage'>): WgslTexture<TUsage>;
+declare function textureExternal(descriptor: GPUExternalTextureDescriptor): WgslTextureExternalImpl;
+declare class WgslTextureExternalImpl implements WgslTextureExternal {
+    readonly descriptor: GPUExternalTextureDescriptor;
+    private _label;
+    readonly type = "texture_external";
+    constructor(descriptor: GPUExternalTextureDescriptor);
+    get label(): string | undefined;
+    $name(label: string | undefined): this;
+    resolve(ctx: ResolutionCtx): string;
+}
+
+type SetPlumAction<T> = T | ((prev: T) => T);
 interface TypeGpuRuntime {
     readonly device: GPUDevice;
     /**
@@ -46,11 +105,15 @@ interface TypeGpuRuntime {
      */
     readonly commandEncoder: GPUCommandEncoder;
     readPlum<TPlum extends WgslPlum>(plum: TPlum): ExtractPlumValue<TPlum>;
-    setPlum<TPlum extends WgslPlum & WgslSettable>(plum: TPlum, value: ExtractPlumValue<TPlum>): void;
-    onPlumChange<TValue>(plum: WgslPlum<TValue>, listener: () => unknown): Unsubscribe;
+    setPlum<TPlum extends WgslPlum & WgslSettable>(plum: TPlum, value: SetPlumAction<ExtractPlumValue<TPlum>>): void;
+    onPlumChange<TValue>(plum: WgslPlum<TValue>, listener: PlumListener<TValue>): Unsubscribe;
     writeBuffer<TValue extends AnyWgslData>(allocatable: WgslAllocatable<TValue>, data: Parsed<TValue>): void;
     readBuffer<TData extends AnyWgslData>(allocatable: WgslAllocatable<TData>): Promise<Parsed<TData>>;
     bufferFor(allocatable: WgslAllocatable): GPUBuffer;
+    textureFor(view: WgslAnyTexture | WgslAnyTextureView): GPUTexture;
+    viewFor(view: WgslAnyTextureView): GPUTextureView;
+    externalTextureFor(texture: WgslTextureExternal): GPUExternalTexture;
+    samplerFor(sampler: WgslSampler): GPUSampler;
     dispose(): void;
     /**
      * Causes all commands enqueued by pipelines to be
@@ -62,28 +125,25 @@ interface TypeGpuRuntime {
 }
 interface RenderPipelineOptions {
     vertex: {
-        args: Wgsl[];
-        code: Wgsl;
-        output: WgslStruct<Record<string, AnyWgslData>>;
-        buffersLayouts?: Iterable<GPUVertexBufferLayout | null>;
+        code: WgslCode | BoundWgslCode;
+        output: {
+            [K in symbol]: string;
+        } & {
+            [K in string]: AnyWgslData;
+        };
     };
     fragment: {
-        args: Wgsl[];
-        code: Wgsl;
-        output: Wgsl;
+        code: WgslCode | BoundWgslCode;
         target: Iterable<GPUColorTargetState | null>;
     };
     primitive: GPUPrimitiveState;
     externalLayouts?: GPUBindGroupLayout[];
-    externalDeclarations?: Wgsl[];
     label?: string;
 }
 interface ComputePipelineOptions {
+    code: WgslCode | BoundWgslCode;
     workgroupSize?: readonly [number, number?, number?];
-    args?: Wgsl[];
-    code: Wgsl;
     externalLayouts?: GPUBindGroupLayout[];
-    externalDeclarations?: Wgsl[];
     label?: string;
 }
 type RenderPipelineExecutorOptions = GPURenderPassDescriptor & {
@@ -92,7 +152,6 @@ type RenderPipelineExecutorOptions = GPURenderPassDescriptor & {
     firstVertex?: number;
     firstInstance?: number;
     externalBindGroups?: GPUBindGroup[];
-    externalVertexBuffers?: GPUBuffer[];
 };
 interface RenderPipelineExecutor {
     execute(options: RenderPipelineExecutorOptions): void;
@@ -104,6 +163,7 @@ type ComputePipelineExecutorOptions = {
 interface ComputePipelineExecutor {
     execute(options?: ComputePipelineExecutorOptions): void;
 }
+declare function deriveVertexFormat<TData extends SimpleWgslData<AnySchema>>(typeSchema: TData): GPUVertexFormat;
 
 interface NameRegistry {
     nameFor(item: WgslResolvable): string;
@@ -140,33 +200,30 @@ declare class ProgramBuilder {
     build(options: BuildOptions): Program;
 }
 
+type VariableScope = 'private' | 'workgroup';
 interface WgslVar<TDataType extends AnyWgslData> extends WgslResolvable {
     $name(label: string): WgslVar<TDataType>;
 }
 
-interface WgslBufferUsage<TData extends AnyWgslData, TUsage extends BufferUsage> extends WgslBindable<TData, TUsage> {
+interface WgslBufferUsage<TData extends AnyWgslData, TUsage extends BufferUsage = BufferUsage> extends WgslBindable<TData, TUsage> {
     $name(label: string): WgslBufferUsage<TData, TUsage>;
 }
 
+type UsageGuard<TUsage extends BufferUsage, TData extends AnyWgslData, TAllows> = TUsage extends TAllows ? WgslBufferUsage<TData, TUsage> : null;
 interface WgslBuffer<TData extends AnyWgslData, TAllows extends BufferUsage = never> extends WgslAllocatable<TData> {
     $name(label: string): WgslBuffer<TData, TAllows>;
     $allowUniform(): WgslBuffer<TData, TAllows | 'uniform'>;
-    $allowReadonlyStorage(): WgslBuffer<TData, TAllows | 'readonly_storage'>;
-    $allowMutableStorage(): WgslBuffer<TData, TAllows | 'mutable_storage'>;
+    $allowReadonly(): WgslBuffer<TData, TAllows | 'readonly'>;
+    $allowMutable(): WgslBuffer<TData, TAllows | 'mutable'>;
+    $allowVertex(stepMode: 'vertex' | 'instance'): WgslBuffer<TData, TAllows | 'vertex'>;
     $addFlags(flags: GPUBufferUsageFlags): WgslBuffer<TData, TAllows>;
-    asUniform(): 'uniform' extends TAllows ? WgslBufferUsage<TData, 'uniform'> : null;
-    asMutableStorage(): 'mutable_storage' extends TAllows ? WgslBufferUsage<TData, 'mutable_storage'> : null;
-    asReadonlyStorage(): 'readonly_storage' extends TAllows ? WgslBufferUsage<TData, 'readonly_storage'> : null;
+    asUniform(): UsageGuard<'uniform', TData, TAllows>;
+    asMutable(): UsageGuard<'mutable', TData, TAllows>;
+    asReadonly(): UsageGuard<'readonly', TData, TAllows>;
+    asVertex(): UsageGuard<'vertex', TData, TAllows>;
 }
 declare function buffer<TData extends AnyWgslData, TUsage extends BufferUsage = never>(typeSchema: TData, initial?: Parsed<TData> | WgslPlum<Parsed<TData>> | undefined): WgslBuffer<TData, TUsage>;
 
-interface WgslCode extends WgslResolvable {
-    $name(label?: string | undefined): WgslCode;
-    with<T>(slot: WgslSlot<T>, value: Eventual<T>): BoundWgslCode;
-}
-type BoundWgslCode = Omit<WgslCode, '$name'>;
-declare function code(strings: TemplateStringsArray, ...params: (Wgsl | Wgsl[] | InlineResolve)[]): WgslCode;
-
 interface WgslConst extends WgslResolvable {
     $name(label: string): WgslConst;
 }
@@ -232,7 +289,26 @@ declare const _default: typeof code & {
     slot: typeof slot;
     constant: typeof constant;
     declare: typeof declare;
-    var: <TDataType extends AnyWgslData>(dataType: TDataType, initialValue?: Wgsl) => WgslVar<TDataType>;
+    var: <TDataType extends AnyWgslData>(dataType: TDataType, initialValue?: Wgsl, scope?: VariableScope) => WgslVar<TDataType>;
+    sampler: typeof sampler;
+    texture: typeof texture;
+    textureExternal: typeof textureExternal;
+    builtin: {
+        readonly vertexIndex: symbol;
+        readonly instanceIndex: symbol;
+        readonly position: symbol;
+        readonly clipDistances: symbol;
+        readonly frontFacing: symbol;
+        readonly fragDepth: symbol;
+        readonly sampleIndex: symbol;
+        readonly sampleMask: symbol;
+        readonly fragment: symbol;
+        readonly localInvocationId: symbol;
+        readonly localInvocationIndex: symbol;
+        readonly globalInvocationId: symbol;
+        readonly workgroupId: symbol;
+        readonly numWorkgroups: symbol;
+    };
 };
 
 /**
@@ -269,4 +345,4 @@ type CreateRuntimeOptions = {
  */
 declare function createRuntime(options?: CreateRuntimeOptions | GPUDevice): Promise<TypeGpuRuntime>;
 
-export { AnyWgslData, type AsCallable, BufferUsage, type ComputePipelineExecutor, type ComputePipelineExecutorOptions, type ComputePipelineOptions, type CreateRuntimeOptions, Eventual, type ICallable, InlineResolve, MissingSlotValueError, type Program, ProgramBuilder, RandomNameRegistry, RecursiveDataTypeError, type RenderPipelineExecutor, type RenderPipelineExecutorOptions, type RenderPipelineOptions, ResolutionCtx, ResolutionError, StrictNameRegistry, type TypeGpuRuntime, Wgsl, WgslAllocatable, WgslBindable, type WgslBuffer, type WgslCode, type WgslConst, type WgslFn$1 as WgslFn, WgslFnArgument, type WgslFn as WgslFnExperimental, WgslPlum, WgslResolvable, WgslResolvableSlot, WgslSettable, WgslSlot, WgslValue, type WgslVar, createRuntime, _default as wgsl };
+export { AnyWgslData, AnyWgslPrimitive, AnyWgslTexelFormat, type AsCallable, BufferUsage, type ComputePipelineExecutor, type ComputePipelineExecutorOptions, type ComputePipelineOptions, type CreateRuntimeOptions, Eventual, type ICallable, InlineResolve, MissingSlotValueError, type Program, ProgramBuilder, RandomNameRegistry, RecursiveDataTypeError, type RenderPipelineExecutor, type RenderPipelineExecutorOptions, type RenderPipelineOptions, ResolutionCtx, ResolutionError, SampledTextureParams, type SetPlumAction, StorageTextureAccess, StorageTextureParams, StrictNameRegistry, TextureUsage, type TypeGpuRuntime, Wgsl, WgslAllocatable, WgslBindable, type WgslBuffer, type WgslBufferUsage, type WgslCode, type WgslConst, type WgslFn$1 as WgslFn, WgslFnArgument, type WgslFn as WgslFnExperimental, WgslPlum, WgslRenderResource, WgslRenderResourceType, WgslResolvable, WgslResolvableSlot, type WgslSampler, WgslSettable, WgslSlot, type WgslTexture, type WgslTextureView, WgslValue, type WgslVar, createRuntime, deriveVertexFormat, _default as wgsl };

package/index.d.ts

@@ -1,7 +1,7 @@
-import { W as WgslResolvable, a as WgslSlot, b as WgslPlum, E as ExtractPlumValue, c as WgslSettable, U as Unsubscribe, A as AnyWgslData, d as WgslAllocatable, e as Wgsl, B as BufferUsage, f as WgslBindable, g as Eventual, I as InlineResolve, h as WgslFnArgument, R as ResolutionCtx, i as WgslValue, j as WgslIdentifier, k as WgslResolvableSlot, p as plum, l as plumFromEvent } from './types-DeF6xFAt.js';
-export { t as AnyWgslPointer, q as EventualGetter, S as SlotValuePair, r as WgslData, s as WgslPointer, u as isPointer, m as isResolvable, o as isSlot, n as isWgsl } from './types-DeF6xFAt.js';
-import { Parsed } from 'typed-binary';
-import { W as WgslStruct } from './struct-udnQvwHG.js';
+import { W as WgslResolvable, a as WgslSlot, E as Eventual, b as Wgsl, I as InlineResolve, c as WgslRenderResource, T as TextureUsage, S as StorageTextureParams, A as AnyWgslTexelFormat, d as SampledTextureParams, e as AnyWgslPrimitive, f as WgslRenderResourceType, g as StorageTextureAccess, R as ResolutionCtx, h as WgslPlum, i as ExtractPlumValue, j as WgslSettable, U as Unsubscribe, k as AnyWgslData, l as WgslAllocatable, B as BufferUsage, m as WgslBindable, n as WgslFnArgument, o as WgslValue, p as WgslIdentifier, q as WgslResolvableSlot, r as plum, s as plumFromEvent } from './types-ENDwr_p9.js';
+export { O as AnyWgslPointer, Q as BuiltInPossibleTypes, X as Builtin, w as EventualGetter, x as SlotValuePair, M as WgslData, C as WgslDepthTextureType, F as WgslExternalTextureType, N as WgslPointer, y as WgslSamplerType, D as WgslStorageTextureType, z as WgslTypedTextureType, V as builtin, Y as getBuiltinInfo, Z as getUsedBuiltinsNamed, J as isDepthTextureType, L as isExternalTextureType, P as isPointer, t as isResolvable, G as isSamplerType, v as isSlot, K as isStorageTextureType, H as isTypedTextureType, u as isWgsl } from './types-ENDwr_p9.js';
+import { Parsed, AnySchema } from 'typed-binary';
+import { S as SimpleWgslData } from './std140-Cv7GDE9w.js';
 
 /**
  * An error that happens during resolution of WGSL code.
@@ -38,6 +38,65 @@ declare abstract class Callable<TArgs extends [...any[]], TReturn> extends Funct
 type ICallable<TArgs extends [...any[]], TReturn> = (...args: TArgs) => TReturn;
 type AsCallable<T, TArgs extends [...any[]], TReturn> = T & ICallable<TArgs, TReturn>;
 
+type PlumListener<T> = (newValue: T) => unknown;
+
+interface WgslCode extends WgslResolvable {
+    $name(label?: string | undefined): WgslCode;
+    with<T>(slot: WgslSlot<T>, value: Eventual<T>): BoundWgslCode;
+}
+type BoundWgslCode = Omit<WgslCode, '$name'>;
+declare function code(strings: TemplateStringsArray, ...params: (Wgsl | Wgsl[] | InlineResolve)[]): WgslCode;
+
+interface WgslSampler extends WgslRenderResource {
+    readonly descriptor: GPUSamplerDescriptor;
+    $name(label: string): WgslSampler;
+}
+declare function sampler(descriptor: GPUSamplerDescriptor): WgslSampler;
+
+interface WgslAnyTextureView extends WgslRenderResource {
+    readonly descriptor: GPUTextureViewDescriptor;
+    readonly texture: WgslAnyTexture;
+    readonly dataType: AnyWgslPrimitive | AnyWgslTexelFormat;
+    readonly access: StorageTextureAccess | undefined;
+}
+interface WgslAnyTexture {
+    readonly descriptor: Omit<GPUTextureDescriptor, 'usage'>;
+    get flags(): GPUTextureUsageFlags;
+}
+interface WgslTexture<TAllows extends TextureUsage = never> {
+    readonly descriptor: Omit<GPUTextureDescriptor, 'usage'>;
+    get label(): string | undefined;
+    get flags(): GPUTextureUsageFlags;
+    $name(label: string): WgslTexture<TAllows>;
+    $allowSampled(): WgslTexture<TAllows | 'sampled'>;
+    $allowStorage(): WgslTexture<TAllows | 'storage'>;
+    asStorage(params: StorageTextureParams): 'storage' extends TAllows ? WgslTextureView<AnyWgslTexelFormat, 'storage'> : null;
+    asSampled(params: SampledTextureParams): 'sampled' extends TAllows ? WgslTextureView<typeof params.dataType, 'sampled'> : null;
+}
+interface WgslTextureView<TData extends AnyWgslPrimitive | AnyWgslTexelFormat, TUsage extends TextureUsage> extends WgslRenderResource {
+    readonly texture: WgslTexture<TUsage>;
+    readonly descriptor: Omit<GPUTextureViewDescriptor, 'usage'>;
+    readonly type: WgslRenderResourceType;
+    readonly dataType: TData;
+    readonly access: StorageTextureAccess | undefined;
+    $name(label: string): WgslTextureView<TData, TUsage>;
+}
+interface WgslTextureExternal extends WgslRenderResource {
+    readonly descriptor: GPUExternalTextureDescriptor;
+}
+declare function texture<TUsage extends TextureUsage = never>(descriptor: Omit<GPUTextureDescriptor, 'usage'>): WgslTexture<TUsage>;
+declare function textureExternal(descriptor: GPUExternalTextureDescriptor): WgslTextureExternalImpl;
+declare class WgslTextureExternalImpl implements WgslTextureExternal {
+    readonly descriptor: GPUExternalTextureDescriptor;
+    private _label;
+    readonly type = "texture_external";
+    constructor(descriptor: GPUExternalTextureDescriptor);
+    get label(): string | undefined;
+    $name(label: string | undefined): this;
+    resolve(ctx: ResolutionCtx): string;
+}
+
+type SetPlumAction<T> = T | ((prev: T) => T);
 interface TypeGpuRuntime {
     readonly device: GPUDevice;
     /**
@@ -46,11 +105,15 @@ interface TypeGpuRuntime {
      */
     readonly commandEncoder: GPUCommandEncoder;
     readPlum<TPlum extends WgslPlum>(plum: TPlum): ExtractPlumValue<TPlum>;
-    setPlum<TPlum extends WgslPlum & WgslSettable>(plum: TPlum, value: ExtractPlumValue<TPlum>): void;
-    onPlumChange<TValue>(plum: WgslPlum<TValue>, listener: () => unknown): Unsubscribe;
+    setPlum<TPlum extends WgslPlum & WgslSettable>(plum: TPlum, value: SetPlumAction<ExtractPlumValue<TPlum>>): void;
+    onPlumChange<TValue>(plum: WgslPlum<TValue>, listener: PlumListener<TValue>): Unsubscribe;
     writeBuffer<TValue extends AnyWgslData>(allocatable: WgslAllocatable<TValue>, data: Parsed<TValue>): void;
     readBuffer<TData extends AnyWgslData>(allocatable: WgslAllocatable<TData>): Promise<Parsed<TData>>;
     bufferFor(allocatable: WgslAllocatable): GPUBuffer;
+    textureFor(view: WgslAnyTexture | WgslAnyTextureView): GPUTexture;
+    viewFor(view: WgslAnyTextureView): GPUTextureView;
+    externalTextureFor(texture: WgslTextureExternal): GPUExternalTexture;
+    samplerFor(sampler: WgslSampler): GPUSampler;
     dispose(): void;
     /**
      * Causes all commands enqueued by pipelines to be
@@ -62,28 +125,25 @@ interface TypeGpuRuntime {
 }
 interface RenderPipelineOptions {
     vertex: {
-        args: Wgsl[];
-        code: Wgsl;
-        output: WgslStruct<Record<string, AnyWgslData>>;
-        buffersLayouts?: Iterable<GPUVertexBufferLayout | null>;
+        code: WgslCode | BoundWgslCode;
+        output: {
+            [K in symbol]: string;
+        } & {
+            [K in string]: AnyWgslData;
+        };
     };
     fragment: {
-        args: Wgsl[];
-        code: Wgsl;
-        output: Wgsl;
+        code: WgslCode | BoundWgslCode;
         target: Iterable<GPUColorTargetState | null>;
     };
     primitive: GPUPrimitiveState;
     externalLayouts?: GPUBindGroupLayout[];
-    externalDeclarations?: Wgsl[];
     label?: string;
 }
 interface ComputePipelineOptions {
+    code: WgslCode | BoundWgslCode;
     workgroupSize?: readonly [number, number?, number?];
-    args?: Wgsl[];
-    code: Wgsl;
     externalLayouts?: GPUBindGroupLayout[];
-    externalDeclarations?: Wgsl[];
     label?: string;
 }
 type RenderPipelineExecutorOptions = GPURenderPassDescriptor & {
@@ -92,7 +152,6 @@ type RenderPipelineExecutorOptions = GPURenderPassDescriptor & {
     firstVertex?: number;
     firstInstance?: number;
     externalBindGroups?: GPUBindGroup[];
-    externalVertexBuffers?: GPUBuffer[];
 };
 interface RenderPipelineExecutor {
     execute(options: RenderPipelineExecutorOptions): void;
@@ -104,6 +163,7 @@ type ComputePipelineExecutorOptions = {
 interface ComputePipelineExecutor {
     execute(options?: ComputePipelineExecutorOptions): void;
 }
+declare function deriveVertexFormat<TData extends SimpleWgslData<AnySchema>>(typeSchema: TData): GPUVertexFormat;
 
 interface NameRegistry {
     nameFor(item: WgslResolvable): string;
@@ -140,33 +200,30 @@ declare class ProgramBuilder {
     build(options: BuildOptions): Program;
 }
 
+type VariableScope = 'private' | 'workgroup';
 interface WgslVar<TDataType extends AnyWgslData> extends WgslResolvable {
     $name(label: string): WgslVar<TDataType>;
 }
 
-interface WgslBufferUsage<TData extends AnyWgslData, TUsage extends BufferUsage> extends WgslBindable<TData, TUsage> {
+interface WgslBufferUsage<TData extends AnyWgslData, TUsage extends BufferUsage = BufferUsage> extends WgslBindable<TData, TUsage> {
     $name(label: string): WgslBufferUsage<TData, TUsage>;
 }
 
+type UsageGuard<TUsage extends BufferUsage, TData extends AnyWgslData, TAllows> = TUsage extends TAllows ? WgslBufferUsage<TData, TUsage> : null;
 interface WgslBuffer<TData extends AnyWgslData, TAllows extends BufferUsage = never> extends WgslAllocatable<TData> {
     $name(label: string): WgslBuffer<TData, TAllows>;
     $allowUniform(): WgslBuffer<TData, TAllows | 'uniform'>;
-    $allowReadonlyStorage(): WgslBuffer<TData, TAllows | 'readonly_storage'>;
-    $allowMutableStorage(): WgslBuffer<TData, TAllows | 'mutable_storage'>;
+    $allowReadonly(): WgslBuffer<TData, TAllows | 'readonly'>;
+    $allowMutable(): WgslBuffer<TData, TAllows | 'mutable'>;
+    $allowVertex(stepMode: 'vertex' | 'instance'): WgslBuffer<TData, TAllows | 'vertex'>;
     $addFlags(flags: GPUBufferUsageFlags): WgslBuffer<TData, TAllows>;
-    asUniform(): 'uniform' extends TAllows ? WgslBufferUsage<TData, 'uniform'> : null;
-    asMutableStorage(): 'mutable_storage' extends TAllows ? WgslBufferUsage<TData, 'mutable_storage'> : null;
-    asReadonlyStorage(): 'readonly_storage' extends TAllows ? WgslBufferUsage<TData, 'readonly_storage'> : null;
+    asUniform(): UsageGuard<'uniform', TData, TAllows>;
+    asMutable(): UsageGuard<'mutable', TData, TAllows>;
+    asReadonly(): UsageGuard<'readonly', TData, TAllows>;
+    asVertex(): UsageGuard<'vertex', TData, TAllows>;
 }
 declare function buffer<TData extends AnyWgslData, TUsage extends BufferUsage = never>(typeSchema: TData, initial?: Parsed<TData> | WgslPlum<Parsed<TData>> | undefined): WgslBuffer<TData, TUsage>;
 
-interface WgslCode extends WgslResolvable {
-    $name(label?: string | undefined): WgslCode;
-    with<T>(slot: WgslSlot<T>, value: Eventual<T>): BoundWgslCode;
-}
-type BoundWgslCode = Omit<WgslCode, '$name'>;
-declare function code(strings: TemplateStringsArray, ...params: (Wgsl | Wgsl[] | InlineResolve)[]): WgslCode;
-
 interface WgslConst extends WgslResolvable {
     $name(label: string): WgslConst;
 }
@@ -232,7 +289,26 @@ declare const _default: typeof code & {
     slot: typeof slot;
     constant: typeof constant;
     declare: typeof declare;
-    var: <TDataType extends AnyWgslData>(dataType: TDataType, initialValue?: Wgsl) => WgslVar<TDataType>;
+    var: <TDataType extends AnyWgslData>(dataType: TDataType, initialValue?: Wgsl, scope?: VariableScope) => WgslVar<TDataType>;
+    sampler: typeof sampler;
+    texture: typeof texture;
+    textureExternal: typeof textureExternal;
+    builtin: {
+        readonly vertexIndex: symbol;
+        readonly instanceIndex: symbol;
+        readonly position: symbol;
+        readonly clipDistances: symbol;
+        readonly frontFacing: symbol;
+        readonly fragDepth: symbol;
+        readonly sampleIndex: symbol;
+        readonly sampleMask: symbol;
+        readonly fragment: symbol;
+        readonly localInvocationId: symbol;
+        readonly localInvocationIndex: symbol;
+        readonly globalInvocationId: symbol;
+        readonly workgroupId: symbol;
+        readonly numWorkgroups: symbol;
+    };
 };
 
 /**
@@ -269,4 +345,4 @@ type CreateRuntimeOptions = {
  */
 declare function createRuntime(options?: CreateRuntimeOptions | GPUDevice): Promise<TypeGpuRuntime>;
 
-export { AnyWgslData, type AsCallable, BufferUsage, type ComputePipelineExecutor, type ComputePipelineExecutorOptions, type ComputePipelineOptions, type CreateRuntimeOptions, Eventual, type ICallable, InlineResolve, MissingSlotValueError, type Program, ProgramBuilder, RandomNameRegistry, RecursiveDataTypeError, type RenderPipelineExecutor, type RenderPipelineExecutorOptions, type RenderPipelineOptions, ResolutionCtx, ResolutionError, StrictNameRegistry, type TypeGpuRuntime, Wgsl, WgslAllocatable, WgslBindable, type WgslBuffer, type WgslCode, type WgslConst, type WgslFn$1 as WgslFn, WgslFnArgument, type WgslFn as WgslFnExperimental, WgslPlum, WgslResolvable, WgslResolvableSlot, WgslSettable, WgslSlot, WgslValue, type WgslVar, createRuntime, _default as wgsl };
+export { AnyWgslData, AnyWgslPrimitive, AnyWgslTexelFormat, type AsCallable, BufferUsage, type ComputePipelineExecutor, type ComputePipelineExecutorOptions, type ComputePipelineOptions, type CreateRuntimeOptions, Eventual, type ICallable, InlineResolve, MissingSlotValueError, type Program, ProgramBuilder, RandomNameRegistry, RecursiveDataTypeError, type RenderPipelineExecutor, type RenderPipelineExecutorOptions, type RenderPipelineOptions, ResolutionCtx, ResolutionError, SampledTextureParams, type SetPlumAction, StorageTextureAccess, StorageTextureParams, StrictNameRegistry, TextureUsage, type TypeGpuRuntime, Wgsl, WgslAllocatable, WgslBindable, type WgslBuffer, type WgslBufferUsage, type WgslCode, type WgslConst, type WgslFn$1 as WgslFn, WgslFnArgument, type WgslFn as WgslFnExperimental, WgslPlum, WgslRenderResource, WgslRenderResourceType, WgslResolvable, WgslResolvableSlot, type WgslSampler, WgslSettable, WgslSlot, type WgslTexture, type WgslTextureView, WgslValue, type WgslVar, createRuntime, deriveVertexFormat, _default as wgsl };