typegpu 0.10.2 → 0.11.0

package/types.d.ts

@@ -1,6 +1,7 @@
 import { $cast, $gpuCallable, $internal } from "./shared/symbols.js";
 import { MapValueToSnippet, ResolvedSnippet, Snippet } from "./data/snippet.js";
 import { TgpuBufferUsage } from "./core/buffer/bufferUsage.js";
+import { SeparatedEntryArgs } from "./core/function/fnTypes.js";
 import { TgpuComputeFn } from "./core/function/tgpuComputeFn.js";
 import { TgpuVar } from "./core/variable/tgpuVariable.js";
 import { Eventual, SlotValuePair, TgpuAccessor, TgpuSlot } from "./core/slot/slotTypes.js";
@@ -11,6 +12,7 @@ import { TgpuRenderPipeline } from "./core/pipeline/renderPipeline.js";
 import { TgpuSampler } from "./core/sampler/sampler.js";
 import { TgpuExternalTexture } from "./core/texture/externalTexture.js";
 import { TgpuBindGroupLayout, TgpuLayoutEntry } from "./tgpuBindGroupLayout.js";
+import { ShaderGenerator } from "./tgsl/shaderGenerator.js";
 import { TgpuBuffer } from "./core/buffer/buffer.js";
 import { TgpuDeclare } from "./core/declare/tgpuDeclare.js";
 import { TgpuFn } from "./core/function/tgpuFn.js";
@@ -37,6 +39,11 @@ interface FnToWgslOptions {
   body: Block;
   params: FuncParameter[];
   externalMap: Record<string, unknown>;
+  /**
+   * For entry functions: positional args and optional data struct.
+   * When provided, takes precedence over `argTypes` for WGSL header generation.
+   */
+  entryInput?: SeparatedEntryArgs | undefined;
 }
 type ItemLayer = {
   type: 'item';
@@ -152,12 +159,12 @@ declare class CodegenState {
   readonly type: "codegen";
 }
 declare class SimulationState {
+  readonly type: "simulate";
   readonly buffers: Map<TgpuBuffer<BaseData>, unknown>;
   readonly vars: {
     private: Map<TgpuVar, unknown>;
     workgroup: Map<TgpuVar, unknown>;
   };
-  readonly type: "simulate";
   constructor(buffers: Map<TgpuBuffer<BaseData>, unknown>, vars: {
     private: Map<TgpuVar, unknown>;
     workgroup: Map<TgpuVar, unknown>;
@@ -175,6 +182,7 @@ interface ResolutionCtx {
   };
   readonly mode: ExecState;
   readonly enableExtensions: WgslExtension[] | undefined;
+  readonly gen: ShaderGenerator;
   addDeclaration(declaration: string): void;
   withResetIndentLevel<T>(callback: () => T): T;
   /**
@@ -203,10 +211,12 @@ interface ResolutionCtx {
    *
    * @param item The value to resolve
    * @param schema Additional information about the item's data type
-   * @param exact Should the inferred value of the resulting code be typed exactly as `schema` (true),
-   *              or is being assignable to `schema` enough (false). Default is false.
    */
-  resolve(item: unknown, schema?: BaseData | UnknownData, exact?: boolean): ResolvedSnippet;
+  resolve(item: unknown, schema?: BaseData | UnknownData): ResolvedSnippet;
+  /**
+   * Equivalent to `snip(ctx.resolve(snippet.value, snippet.dataType).value, snippet.dataType, snippet.origin)`.
+   */
+  resolveSnippet(snippet: Snippet): ResolvedSnippet;
   fnToWgsl(options: FnToWgslOptions): {
     head: Wgsl;
     body: Wgsl;

package/types.js

@@ -2,7 +2,6 @@ import { $cast, $gpuCallable, $ownSnippet, $resolve } from "./shared/symbols.js"
 import { isWgslData } from "./data/wgslTypes.js";
 import { UnknownData } from "./data/dataTypes.js";
 import { isLazy, isProviding, isSlot } from "./core/slot/slotTypes.js";
-
 //#region src/types.ts
 var NormalState = class {
 	type = "normal";
@@ -12,6 +11,8 @@ var CodegenState = class {
 };
 var SimulationState = class {
 	type = "simulate";
+	buffers;
+	vars;
 	constructor(buffers, vars) {
 		this.buffers = buffers;
 		this.vars = vars;
@@ -38,6 +39,5 @@ function isWgsl(value) {
 function isGPUBuffer(value) {
 	return !!value && typeof value === "object" && "getMappedRange" in value && "mapAsync" in value;
 }
-
 //#endregion
-export { CodegenState, NormalState, SimulationState, getOwnSnippet, hasCast, isGPUBuffer, isGPUCallable, isKnownAtComptime, isSelfResolvable, isWgsl };
+export { CodegenState, NormalState, SimulationState, getOwnSnippet, hasCast, isGPUBuffer, isGPUCallable, isKnownAtComptime, isSelfResolvable, isWgsl };

package/wgslExtensions.js

@@ -13,6 +13,5 @@ const wgslExtensionToFeatureName = {
 	subgroups: "subgroups",
 	primitive_index: "primitive-index"
 };
-
 //#endregion
-export { wgslExtensionToFeatureName, wgslExtensions };
+export { wgslExtensionToFeatureName, wgslExtensions };