typegpu 0.11.6 → 0.11.7

package/bin.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import pkg from './package.json' with { type: 'json' };
+
+/**
+ * Used to extract the version of `typegpu` that was used to
+ * trigger the CLI, which then allows us to download the latest
+ * version matching the major and minor of the `typegpu` package.
+ */
+const versionPattern = /^(\d+)\.(\d+)\.(\d+)/;
+
+const result = versionPattern.exec(pkg.version);
+const [_, major, minor] = result;
+
+if (major === undefined || minor === undefined) {
+  throw new Error(`TypeGPU version doesn't match the expected major.minor.patch format`);
+}
+
+/**
+ * Targeting the latest version with the same major and minor as `typegpu`
+ */
+const semver = `^${major}.${minor}.0`;
+
+function asyncSpawn(...args) {
+  return new Promise((resolve, _reject) => {
+    const child = spawn(...args);
+
+    child.on('exit', (code, signal) => {
+      if (signal) {
+        process.kill(process.pid, signal);
+        process.exit(0);
+        return;
+      }
+
+      resolve(code);
+    });
+  });
+}
+
+(async () => {
+  const code = await asyncSpawn('npx', [`@typegpu/cli@${semver}`, ...process.argv.slice(2)], {
+    stdio: ['inherit', 'inherit', 'ignore'],
+  });
+
+  if (code !== 0) {
+    console.warn(
+      `Couldn't find @typegpu/cli version matching ${semver}, falling back to latest...`,
+    );
+    // Fallback to latest
+    const code = await asyncSpawn('npx', [`@typegpu/cli@latest`, ...process.argv.slice(2)], {
+      stdio: 'inherit',
+    });
+    process.exit(code ?? 0);
+  }
+
+  process.exit(code ?? 0);
+})();

package/builtin.d.ts

@@ -13,7 +13,9 @@ type BuiltinSampleMask = Decorated<U32, [Builtin<'sample_mask'>]>;
 type BuiltinLocalInvocationId = Decorated<Vec3u, [Builtin<'local_invocation_id'>]>;
 type BuiltinLocalInvocationIndex = Decorated<U32, [Builtin<'local_invocation_index'>]>;
 type BuiltinGlobalInvocationId = Decorated<Vec3u, [Builtin<'global_invocation_id'>]>;
+type BuiltinGlobalInvocationIndex = Decorated<U32, [Builtin<'global_invocation_index'>]>;
 type BuiltinWorkgroupId = Decorated<Vec3u, [Builtin<'workgroup_id'>]>;
+type BuiltinWorkgroupIndex = Decorated<U32, [Builtin<'workgroup_index'>]>;
 type BuiltinNumWorkgroups = Decorated<Vec3u, [Builtin<'num_workgroups'>]>;
 type BuiltinSubgroupInvocationId = Decorated<U32, [Builtin<'subgroup_invocation_id'>]>;
 type BuiltinSubgroupSize = Decorated<U32, [Builtin<'subgroup_size'>]>;
@@ -32,7 +34,9 @@ declare const builtin: {
   readonly localInvocationId: BuiltinLocalInvocationId;
   readonly localInvocationIndex: BuiltinLocalInvocationIndex;
   readonly globalInvocationId: BuiltinGlobalInvocationId;
+  readonly globalInvocationIndex: BuiltinGlobalInvocationIndex;
   readonly workgroupId: BuiltinWorkgroupId;
+  readonly workgroupIndex: BuiltinWorkgroupIndex;
   readonly numWorkgroups: BuiltinNumWorkgroups;
   readonly subgroupInvocationId: BuiltinSubgroupInvocationId;
   readonly subgroupSize: BuiltinSubgroupSize;
@@ -40,7 +44,7 @@ declare const builtin: {
   readonly numSubgroups: BuiltinNumSubgroups;
 };
 type AnyBuiltin = (typeof builtin)[keyof typeof builtin];
-type AnyComputeBuiltin = BuiltinLocalInvocationId | BuiltinLocalInvocationIndex | BuiltinGlobalInvocationId | BuiltinWorkgroupId | BuiltinNumWorkgroups | BuiltinSubgroupInvocationId | BuiltinSubgroupSize | BuiltinSubgroupId | BuiltinNumSubgroups;
+type AnyComputeBuiltin = BuiltinLocalInvocationId | BuiltinLocalInvocationIndex | BuiltinGlobalInvocationId | BuiltinGlobalInvocationIndex | BuiltinWorkgroupId | BuiltinWorkgroupIndex | BuiltinNumWorkgroups | BuiltinSubgroupInvocationId | BuiltinSubgroupSize | BuiltinSubgroupId | BuiltinNumSubgroups;
 type AnyVertexInputBuiltin = BuiltinVertexIndex | BuiltinInstanceIndex;
 type AnyVertexOutputBuiltin = BuiltinClipDistances | BuiltinPosition;
 type AnyFragmentInputBuiltin = BuiltinPosition | BuiltinFrontFacing | BuiltinPrimitiveIndex | BuiltinSampleIndex | BuiltinSampleMask | BuiltinSubgroupInvocationId | BuiltinSubgroupSize;

package/builtin.js

@@ -25,7 +25,9 @@ const builtin = {
 	localInvocationId: defineBuiltin(vec3u, "local_invocation_id"),
 	localInvocationIndex: defineBuiltin(u32, "local_invocation_index"),
 	globalInvocationId: defineBuiltin(vec3u, "global_invocation_id"),
+	globalInvocationIndex: defineBuiltin(u32, "global_invocation_index"),
 	workgroupId: defineBuiltin(vec3u, "workgroup_id"),
+	workgroupIndex: defineBuiltin(u32, "workgroup_index"),
 	numWorkgroups: defineBuiltin(vec3u, "num_workgroups"),
 	subgroupInvocationId: defineBuiltin(u32, "subgroup_invocation_id"),
 	subgroupSize: defineBuiltin(u32, "subgroup_size"),

package/core/buffer/buffer.js

@@ -1,6 +1,6 @@
 import { $internal } from "../../shared/symbols.js";
-import { getName, setName } from "../../shared/meta.js";
 import { isWgslData } from "../../data/wgslTypes.js";
+import { getName, setName } from "../../shared/meta.js";
 import { isGPUBuffer } from "../../types.js";
 import { sizeOf } from "../../data/sizeOf.js";
 import { getCompiledWriter } from "../../data/compiledIO.js";

package/core/buffer/bufferUsage.js

@@ -1,6 +1,5 @@
 import { $getNameForward, $gpuValueOf, $internal, $ownSnippet, $resolve } from "../../shared/symbols.js";
 import { getName, setName } from "../../shared/meta.js";
-import { isNaturallyEphemeral } from "../../data/wgslTypes.js";
 import { snip } from "../../data/snippet.js";
 import { IllegalBufferAccessError } from "../../errors.js";
 import { getExecMode, inCodegenMode, isInsideTgpuFn } from "../../execMode.js";
@@ -13,11 +12,6 @@ import { isUsableAsStorage } from "../../extension.js";
 function isUsableAsUniform(buffer) {
 	return !!buffer.usableAsUniform;
 }
-const usageToVarTemplateMap = {
-	uniform: "uniform",
-	mutable: "storage, read_write",
-	readonly: "storage, read"
-};
 var TgpuFixedBufferImpl = class {
 	resourceType = "buffer-usage";
 	usage;
@@ -41,9 +35,14 @@ var TgpuFixedBufferImpl = class {
 			storage: dataType,
 			access: this.usage
 		}, this.buffer);
-		const usage = usageToVarTemplateMap[this.usage];
-		ctx.addDeclaration(`@group(${group}) @binding(${binding}) var<${usage}> ${id}: ${ctx.resolve(dataType).value};`);
-		return snip(id, dataType, isNaturallyEphemeral(dataType) ? "runtime" : this.usage);
+		return ctx.gen.declareGlobalVar({
+			group,
+			binding,
+			scope: this.usage,
+			id,
+			dataType,
+			init: void 0
+		});
 	}
 	toString() {
 		return `${this.usage}:${getName(this) ?? "<unnamed>"}`;
@@ -54,7 +53,7 @@ var TgpuFixedBufferImpl = class {
 		return new Proxy({
 			[$internal]: true,
 			get [$ownSnippet]() {
-				return snip(this, dataType, isNaturallyEphemeral(dataType) ? "runtime" : usage);
+				return snip(this, dataType, usage);
 			},
 			[$resolve]: (ctx) => ctx.resolve(this),
 			toString: () => `${this.usage}:${getName(this) ?? "<unnamed>"}.$`
@@ -105,9 +104,14 @@ var TgpuLaidOutBufferImpl = class {
 	[$resolve](ctx) {
 		const id = ctx.makeUniqueIdentifier(getName(this), "global");
 		const group = ctx.allocateLayoutEntry(this.#membership.layout);
-		const usage = usageToVarTemplateMap[this.usage];
-		ctx.addDeclaration(`@group(${group}) @binding(${this.#membership.idx}) var<${usage}> ${id}: ${ctx.resolve(this.dataType).value};`);
-		return snip(id, this.dataType, isNaturallyEphemeral(this.dataType) ? "runtime" : this.usage);
+		return ctx.gen.declareGlobalVar({
+			group,
+			binding: this.#membership.idx,
+			scope: this.usage,
+			id,
+			dataType: this.dataType,
+			init: void 0
+		});
 	}
 	toString() {
 		return `${this.usage}:${getName(this) ?? "<unnamed>"}`;
@@ -118,7 +122,7 @@ var TgpuLaidOutBufferImpl = class {
 		return new Proxy({
 			[$internal]: true,
 			get [$ownSnippet]() {
-				return snip(this, schema, isNaturallyEphemeral(schema) ? "runtime" : usage);
+				return snip(this, schema, usage);
 			},
 			[$resolve]: (ctx) => ctx.resolve(this),
 			toString: () => `${this.usage}:${getName(this) ?? "<unnamed>"}.$`

package/core/constant/tgpuConstant.js

@@ -1,6 +1,5 @@
 import { $gpuValueOf, $internal, $ownSnippet, $resolve } from "../../shared/symbols.js";
 import { getName, setName } from "../../shared/meta.js";
-import { isNaturallyEphemeral } from "../../data/wgslTypes.js";
 import { isData } from "../../data/dataTypes.js";
 import { snip } from "../../data/snippet.js";
 import { inCodegenMode } from "../../execMode.js";
@@ -38,10 +37,11 @@ var TgpuConstImpl = class {
 	}
 	[$resolve](ctx) {
 		const id = ctx.makeUniqueIdentifier(getName(this), "global");
-		const resolvedDataType = ctx.resolve(this.dataType).value;
-		const resolvedValue = ctx.resolve(this.#value, this.dataType).value;
-		ctx.addDeclaration(`const ${id}: ${resolvedDataType} = ${resolvedValue};`);
-		return snip(id, this.dataType, isNaturallyEphemeral(this.dataType) ? "constant" : "constant-tgpu-const-ref");
+		return ctx.gen.declareGlobalConst({
+			id,
+			dataType: this.dataType,
+			init: snip(this.#value, this.dataType, "constant")
+		});
 	}
 	toString() {
 		return `const:${getName(this) ?? "<unnamed>"}`;
@@ -51,7 +51,7 @@ var TgpuConstImpl = class {
 		return new Proxy({
 			[$internal]: true,
 			get [$ownSnippet]() {
-				return snip(this, dataType, isNaturallyEphemeral(dataType) ? "constant" : "constant-tgpu-const-ref");
+				return snip(this, dataType, "constant-immutable-def");
 			},
 			[$resolve]: (ctx) => ctx.resolve(this),
 			toString: () => `const:${getName(this) ?? "<unnamed>"}.$`

package/core/function/comptime.js

@@ -1,7 +1,7 @@
 import { $getNameForward, $gpuCallable, $internal } from "../../shared/symbols.js";
 import { setName } from "../../shared/meta.js";
 import { WgslTypeError } from "../../errors.js";
-import { isKnownAtComptime } from "../../types.js";
+import { NormalState, isKnownAtComptime } from "../../types.js";
 import { coerceToSnippet } from "../../tgsl/generationHelpers.js";
 
 //#region src/core/function/comptime.ts
@@ -35,9 +35,14 @@ function comptime(func) {
 	});
 	impl.toString = () => "comptime";
 	impl[$getNameForward] = func;
-	impl[$gpuCallable] = { call(_ctx, args) {
+	impl[$gpuCallable] = { call(ctx, args) {
 		if (!args.every((s) => isKnownAtComptime(s))) throw new WgslTypeError(`Called comptime function with runtime-known values: ${args.filter((s) => !isKnownAtComptime(s)).map((s) => `'${s.value}'`).join(", ")}`);
-		return coerceToSnippet(func(...args.map((s) => s.value)));
+		ctx.pushMode(new NormalState());
+		try {
+			return coerceToSnippet(func(...args.map((s) => s.value)));
+		} finally {
+			ctx.popMode();
+		}
 	} };
 	impl.$name = (label) => {
 		setName(func, label);

package/core/function/createCallableSchema.js

@@ -1,7 +1,7 @@
 import { $gpuCallable } from "../../shared/symbols.js";
-import { setName } from "../../shared/meta.js";
 import { isPtr } from "../../data/wgslTypes.js";
-import { snip } from "../../data/snippet.js";
+import { setName } from "../../shared/meta.js";
+import { noSideEffects, snip } from "../../data/snippet.js";
 import { NormalState, isKnownAtComptime } from "../../types.js";
 import { tryConvertSnippet } from "../../tgsl/conversion.js";
 
@@ -24,15 +24,17 @@ function callableSchema(options) {
 				if (!argType) throw new Error("Function called with invalid arguments");
 				return tryConvertSnippet(ctx, s, argType, false);
 			});
+			let result;
 			if (converted.every((s) => isKnownAtComptime(s))) {
 				ctx.pushMode(new NormalState());
 				try {
-					return snip(options.normalImpl(...converted.map((s) => s.value)), options.schema(), "constant");
+					result = snip(options.normalImpl(...converted.map((s) => s.value)), options.schema(), "constant");
 				} finally {
 					ctx.popMode("normal");
 				}
-			}
-			return options.codegenImpl(ctx, converted);
+			} else result = options.codegenImpl(ctx, converted);
+			if (!args.some((a) => a.possibleSideEffects)) return noSideEffects(result);
+			return result;
 		}
 	};
 	return impl;

package/core/function/dualImpl.js

@@ -1,6 +1,6 @@
 import { $gpuCallable } from "../../shared/symbols.js";
-import { setName } from "../../shared/meta.js";
 import { isPtr } from "../../data/wgslTypes.js";
+import { setName } from "../../shared/meta.js";
 import { snip } from "../../data/snippet.js";
 import { NormalState, isKnownAtComptime } from "../../types.js";
 import { tryConvertSnippet } from "../../tgsl/conversion.js";
@@ -18,7 +18,7 @@ function dualImpl(options) {
 		if (typeof options.normalImpl === "string") throw new MissingCpuImplError(options.normalImpl);
 		return options.normalImpl(...args);
 	});
-	setName(impl, options.name);
+	if (options.name) setName(impl, options.name);
 	impl.toString = () => options.name ?? "<unknown>";
 	impl[$gpuCallable] = {
 		get strictSignature() {

package/core/function/fnCore.js

@@ -1,9 +1,8 @@
 import { $getNameForward } from "../../shared/symbols.js";
-import { getMetaData, getName } from "../../shared/meta.js";
 import { Void, isWgslData, isWgslStruct } from "../../data/wgslTypes.js";
+import { getFunctionMetadata, getName } from "../../shared/meta.js";
 import { undecorate } from "../../data/dataTypes.js";
 import { snip } from "../../data/snippet.js";
-import { MissingLinksError } from "../../errors.js";
 import { getAttributesString } from "../../data/attributes.js";
 import { validateIdentifier } from "../../nameUtils.js";
 import { applyExternals, replaceExternalsInWgsl } from "../resolve/externals.js";
@@ -64,17 +63,17 @@ function createFnCore(implementation, functionType, workgroupSize) {
 				ctx.addDeclaration(`${attributes}fn ${id}${header}${body}`);
 				return snip(id, returnType, "runtime");
 			}
-			const pluginData = getMetaData(implementation);
-			const pluginExternals = typeof pluginData?.externals === "function" ? pluginData.externals() : pluginData?.externals;
+			const pluginData = getFunctionMetadata(implementation);
+			const pluginExternals = pluginData?.externals;
 			if (pluginExternals) applyExternals(externalMap, Object.fromEntries(Object.entries(pluginExternals).filter(([name]) => !(name in externalMap))));
 			const ast = pluginData?.ast;
 			if (!ast) throw new Error("Missing metadata for tgpu.fn function body (either missing 'use gpu' directive, or misconfigured `unplugin-typegpu`)");
-			const missingExternals = ast.externalNames.filter((name) => !(name in externalMap));
-			if (missingExternals.length > 0) throw new MissingLinksError(getName(this), missingExternals);
 			const maybeSecondArg = ast.params[1];
 			if (maybeSecondArg && maybeSecondArg.type === "i" && functionType !== "normal") applyExternals(externalMap, { [maybeSecondArg.name]: undecorate(returnType) });
-			const { code, returnType: actualReturnType } = ctx.fnToWgsl({
+			const { code, returnType: actualReturnType } = ctx.resolveFunction({
 				functionType,
+				name: id,
+				workgroupSize,
 				argTypes,
 				entryInput,
 				params: ast.params,
@@ -82,7 +81,7 @@ function createFnCore(implementation, functionType, workgroupSize) {
 				body: ast.body,
 				externalMap
 			});
-			ctx.addDeclaration(`${attributes}fn ${id}${code}`);
+			ctx.addDeclaration(code);
 			return snip(id, actualReturnType, "runtime");
 		}
 	};

package/core/function/tgpuComputeFn.js

@@ -1,6 +1,6 @@
 import { $getNameForward, $internal, $resolve } from "../../shared/symbols.js";
-import { getName, setName } from "../../shared/meta.js";
 import { Void } from "../../data/wgslTypes.js";
+import { getName, setName } from "../../shared/meta.js";
 import { separateBuiltins } from "./ioSchema.js";
 import { createFnCore } from "./fnCore.js";
 import { stripTemplate } from "./templateUtils.js";

package/core/function/tgpuFn.js

@@ -1,6 +1,6 @@
 import { $getNameForward, $internal, $providing, $resolve, isMarkedInternal } from "../../shared/symbols.js";
-import { getName, setName } from "../../shared/meta.js";
 import { Void } from "../../data/wgslTypes.js";
+import { getName, setName } from "../../shared/meta.js";
 import { ExecutionError } from "../../errors.js";
 import { isAccessor, isMutableAccessor } from "../slot/slotTypes.js";
 import { provideInsideTgpuFn } from "../../execMode.js";
@@ -157,7 +157,8 @@ function createGenericFn(inner, pairs) {
 		return inner(...args);
 	};
 	const genericFn = Object.assign(call, fnBase);
-	if (getName(inner)) setName(genericFn, getName(inner));
+	const innerName = getName(inner);
+	if (innerName) setName(genericFn, innerName);
 	Object.defineProperty(genericFn, "toString", { value() {
 		const fnLabel = getName(genericFn) ?? "<unnamed>";
 		if (pairs.length > 0) return `fn*:${fnLabel}[${pairs.map(stringifyPair).join(", ")}]`;

package/core/pipeline/computePipeline.js

@@ -1,6 +1,6 @@
 import { $getNameForward, $internal, $resolve } from "../../shared/symbols.js";
-import { PERF, getName, setName } from "../../shared/meta.js";
 import { Void } from "../../data/wgslTypes.js";
+import { PERF, getName, setName } from "../../shared/meta.js";
 import { snip } from "../../data/snippet.js";
 import { isGPUBuffer } from "../../types.js";
 import { isBindGroup } from "../../tgpuBindGroupLayout.js";
@@ -9,7 +9,7 @@ import { isGPUCommandEncoder, isGPUComputePassEncoder } from "./typeGuards.js";
 import { namespace } from "../resolve/namespace.js";
 import { applyBindGroups } from "./applyPipelineState.js";
 import { logDataFromGPU } from "../../tgsl/consoleLog/deserializers.js";
-import { wgslExtensionToFeatureName, wgslExtensions } from "../../wgslExtensions.js";
+import { wgslEnableExtensionToFeatureName, wgslEnableExtensions } from "../../wgslExtensions.js";
 import { resolveIndirectOffset } from "./pipelineUtils.js";
 import { createWithPerformanceCallback, createWithTimestampWrites, setupTimestampWrites, triggerPerformanceCallback } from "./timeable.js";
 
@@ -172,7 +172,7 @@ var ComputePipelineCore = class {
 	unwrap() {
 		if (this._memo === void 0) {
 			const device = this.root.device;
-			const enableExtensions = wgslExtensions.filter((extension) => this.root.enabledFeatures.has(wgslExtensionToFeatureName[extension]));
+			const enableExtensions = wgslEnableExtensions.filter((extension) => this.root.enabledFeatures.has(wgslEnableExtensionToFeatureName[extension]));
 			let resolutionResult;
 			let resolveMeasure;
 			const ns = namespace({ names: this.root.nameRegistrySetting });

package/core/pipeline/renderPipeline.js

@@ -1,6 +1,6 @@
 import { $getNameForward, $internal, $resolve } from "../../shared/symbols.js";
-import { PERF, getName, setName } from "../../shared/meta.js";
 import { Void, isWgslData } from "../../data/wgslTypes.js";
+import { PERF, getName, setName } from "../../shared/meta.js";
 import { getCustomLocation } from "../../data/dataTypes.js";
 import { snip } from "../../data/snippet.js";
 import { isGPUBuffer } from "../../types.js";
@@ -15,7 +15,7 @@ import { isGPUCommandEncoder, isGPURenderBundleEncoder, isGPURenderPassEncoder }
 import { namespace } from "../resolve/namespace.js";
 import { applyBindGroups, applyVertexBuffers } from "./applyPipelineState.js";
 import { logDataFromGPU } from "../../tgsl/consoleLog/deserializers.js";
-import { wgslExtensionToFeatureName, wgslExtensions } from "../../wgslExtensions.js";
+import { wgslEnableExtensionToFeatureName, wgslEnableExtensions } from "../../wgslExtensions.js";
 import { resolveIndirectOffset } from "./pipelineUtils.js";
 import { createWithPerformanceCallback, createWithTimestampWrites, setupTimestampWrites, triggerPerformanceCallback } from "./timeable.js";
 import { AutoFragmentFn, AutoVertexFn } from "../function/autoIO.js";
@@ -378,7 +378,7 @@ var RenderPipelineCore = class {
 		if (this._memo !== void 0) return this._memo;
 		const { root, descriptor: tgpuDescriptor } = this.options;
 		const device = root.device;
-		const enableExtensions = wgslExtensions.filter((extension) => root.enabledFeatures.has(wgslExtensionToFeatureName[extension]));
+		const enableExtensions = wgslEnableExtensions.filter((extension) => root.enabledFeatures.has(wgslEnableExtensionToFeatureName[extension]));
 		let resolutionResult;
 		let resolveMeasure;
 		const ns = namespace({ names: root.nameRegistrySetting });

package/core/rawCodeSnippet/tgpuRawCodeSnippet.d.ts

@@ -16,7 +16,7 @@ interface TgpuRawCodeSnippet<TDataType extends BaseData> {
   readonly [$gpuValueOf]: InferGPU<TDataType>;
   $uses(dependencyMap: Record<string, unknown>): this;
 }
-type RawCodeSnippetOrigin = Exclude<Origin, 'function' | 'this-function' | 'argument' | 'constant-ref'>;
+type RawCodeSnippetOrigin = Exclude<Origin, 'function' | 'local-def' | 'argument' | 'constant-immutable-def' | 'runtime-immutable-def'>;
 /**
  * An advanced API that creates a typed shader expression which
  * can be injected into the final shader bundle upon use.

package/core/resolve/externals.js

@@ -1,5 +1,5 @@
-import { getName, hasTinyestMetadata, setName } from "../../shared/meta.js";
 import { isWgslStruct } from "../../data/wgslTypes.js";
+import { getName, hasTinyestMetadata, setName } from "../../shared/meta.js";
 import { isLooseData } from "../../data/dataTypes.js";
 import { isWgsl } from "../../types.js";
 

package/core/resolve/tgpuResolve.d.ts

@@ -1,6 +1,6 @@
 import { ShaderGenerator } from "../../tgsl/shaderGenerator.js";
 import { Configurable } from "../root/rootTypes.js";
-import { WgslExtension } from "../../wgslExtensions.js";
+import { WgslEnableExtension } from "../../wgslExtensions.js";
 import { ResolvableObject, Wgsl } from "../../types.js";
 import { Namespace } from "./namespace.js";
 import { ResolutionResult } from "../../resolutionCtx.js";
@@ -27,7 +27,7 @@ interface TgpuResolveOptions {
   /**
    * List of WGSL shader extensions to enable.
    */
-  enableExtensions?: WgslExtension[] | undefined;
+  enableExtensions?: WgslEnableExtension[] | undefined;
   /**
    * **NOTE: This is an unstable API and may change in the future.**
    *

package/core/root/init.js

@@ -12,6 +12,7 @@ import { clearTextureUtilsCache } from "../texture/textureUtils.js";
 import { INTERNAL_createTexture, isTexture, isTextureView } from "../texture/texture.js";
 import { TgpuBindGroupImpl, isBindGroup, isBindGroupLayout } from "../../tgpuBindGroupLayout.js";
 import { ceil } from "../../std/numeric.js";
+import { allEq } from "../../std/boolean.js";
 import { isComputePipeline, isRenderPipeline } from "../pipeline/typeGuards.js";
 import { builtin } from "../../builtin.js";
 import { INTERNAL_createQuerySet, isQuerySet } from "../querySet/querySet.js";
@@ -22,7 +23,6 @@ import { applyBindGroups, applyVertexBuffers } from "../pipeline/applyPipelineSt
 import { INTERNAL_createComputePipeline } from "../pipeline/computePipeline.js";
 import { isVertexLayout } from "../vertexLayout/vertexLayout.js";
 import { INTERNAL_createRenderPipeline } from "../pipeline/renderPipeline.js";
-import { allEq } from "../../std/boolean.js";
 
 //#region src/core/root/init.ts
 /**

package/core/slot/accessor.js

@@ -51,7 +51,7 @@ var AccessorBase = class {
 		if (isTgpuFn(value) || hasTinyestMetadata(value)) return ctx.withResetIndentLevel(() => snip(`${ctx.resolve(value).value}()`, this.schema, "runtime"));
 		ctx.pushMode(new NormalState());
 		try {
-			return snip(schemaCallWrapper(this.schema, value), this.schema, "constant");
+			return snip(schemaCallWrapper(this.schema, value), this.schema, "constant", false);
 		} finally {
 			ctx.popMode("normal");
 		}

package/core/texture/texture.js

@@ -251,8 +251,14 @@ var TgpuFixedTextureViewImpl = class {
 			texture: this.schema,
 			sampleType: this.#descriptor?.sampleType ?? this.schema.bindingSampleType[0]
 		}, this);
-		ctx.addDeclaration(`@group(${group}) @binding(${binding}) var ${id}: ${ctx.resolve(this.schema).value};`);
-		return snip(id, this.schema, "handle");
+		return ctx.gen.declareGlobalVar({
+			group,
+			binding,
+			id,
+			dataType: this.schema,
+			scope: "handle",
+			init: void 0
+		});
 	}
 };
 var TgpuLaidOutTextureViewImpl = class {

package/core/variable/tgpuVariable.js

@@ -1,6 +1,5 @@
 import { $gpuValueOf, $internal, $ownSnippet, $resolve } from "../../shared/symbols.js";
 import { getName, setName } from "../../shared/meta.js";
-import { isNaturallyEphemeral } from "../../data/wgslTypes.js";
 import { snip } from "../../data/snippet.js";
 import { IllegalVarAccessError } from "../../errors.js";
 import { getExecMode, isInsideTgpuFn } from "../../execMode.js";
@@ -43,10 +42,13 @@ var TgpuVarImpl = class {
 	}
 	[$resolve](ctx) {
 		const id = ctx.makeUniqueIdentifier(getName(this), "global");
-		const pre = `var<${this.#scope}> ${id}: ${ctx.resolve(this.#dataType).value}`;
-		if (this.#initialValue) ctx.addDeclaration(`${pre} = ${ctx.resolve(this.#initialValue, this.#dataType).value};`);
-		else ctx.addDeclaration(`${pre};`);
-		return snip(id, this.#dataType, isNaturallyEphemeral(this.#dataType) ? "runtime" : this.#scope);
+		const init = this.#initialValue ? snip(this.#initialValue, this.#dataType, "constant") : void 0;
+		return ctx.gen.declareGlobalVar({
+			scope: this.#scope,
+			id,
+			dataType: this.#dataType,
+			init
+		});
 	}
 	$name(label) {
 		setName(this, label);
@@ -57,7 +59,7 @@ var TgpuVarImpl = class {
 	}
 	get [$gpuValueOf]() {
 		const dataType = this.#dataType;
-		const origin = isNaturallyEphemeral(dataType) ? "runtime" : this.#scope;
+		const origin = this.#scope;
 		return new Proxy({
 			[$internal]: true,
 			get [$ownSnippet]() {

package/core/vertexLayout/vertexLayout.js

@@ -1,7 +1,7 @@
 import { $internal } from "../../shared/symbols.js";
+import { isDecorated, isWgslStruct } from "../../data/wgslTypes.js";
 import { setName } from "../../shared/meta.js";
 import { kindToDefaultFormatMap, vertexFormats } from "../../shared/vertexFormat.js";
-import { isDecorated, isWgslStruct } from "../../data/wgslTypes.js";
 import { getCustomLocation, isLooseDecorated, isUnstruct } from "../../data/dataTypes.js";
 import { alignmentOf, customAlignmentOf } from "../../data/alignmentOf.js";
 import { roundUp } from "../../mathUtils.js";

package/data/alignmentOf.js

@@ -1,6 +1,6 @@
 import { isDecorated, isWgslArray, isWgslStruct } from "./wgslTypes.js";
-import { getCustomAlignment, isDisarray, isLooseDecorated, isUnstruct } from "./dataTypes.js";
 import { safeStringify } from "../shared/stringify.js";
+import { getCustomAlignment, isDisarray, isLooseDecorated, isUnstruct } from "./dataTypes.js";
 import { packedFormats } from "./vertexFormatData.js";
 
 //#region src/data/alignmentOf.ts

package/data/attributes.d.ts

@@ -2,7 +2,7 @@ import { Align, AnyWgslData, BaseData, Builtin, Decorated, FlatInterpolatableDat
 import { AnyData, AnyLooseData, IsLooseData, LooseDecorated, Undecorate } from "./dataTypes.js";
 
 //#region src/data/attributes.d.ts
-declare const builtinNames: readonly ["vertex_index", "instance_index", "clip_distances", "position", "front_facing", "frag_depth", "primitive_index", "sample_index", "sample_mask", "fragment", "local_invocation_id", "local_invocation_index", "global_invocation_id", "workgroup_id", "num_workgroups", "subgroup_invocation_id", "subgroup_size", "subgroup_id", "num_subgroups"];
+declare const builtinNames: readonly ["vertex_index", "instance_index", "clip_distances", "position", "front_facing", "frag_depth", "primitive_index", "sample_index", "sample_mask", "fragment", "local_invocation_id", "local_invocation_index", "global_invocation_id", "global_invocation_index", "workgroup_id", "workgroup_index", "num_workgroups", "subgroup_invocation_id", "subgroup_size", "subgroup_id", "num_subgroups"];
 type BuiltinName = (typeof builtinNames)[number];
 type AnyAttribute<AllowedBuiltins extends Builtin<BuiltinName> = Builtin<BuiltinName>> = Align<number> | Size<number> | Location | Interpolate | Invariant | AllowedBuiltins;
 type ExtractAttributes<T> = T extends {

package/data/dataIO.js

@@ -1,5 +1,5 @@
-import { getName } from "../shared/meta.js";
 import { isWgslArray } from "./wgslTypes.js";
+import { getName } from "../shared/meta.js";
 import { vec2f, vec2h, vec2i, vec2u, vec3f, vec3h, vec3i, vec3u, vec4f, vec4h, vec4i, vec4u } from "./vector.js";
 import { alignmentOf, customAlignmentOf } from "./alignmentOf.js";
 import { roundUp } from "../mathUtils.js";

package/data/dataTypes.d.ts

@@ -4,7 +4,6 @@ import { Prettify } from "../shared/utilityTypes.js";
 import "./sampler.js";
 import "./snippet.js";
 import { PackedData } from "./vertexFormatData.js";
-import "../types.js";
 import { AnyWgslData, BaseData, TypedArrayFor } from "./wgslTypes.js";
 import "./texture.js";
 import { Infer, InferGPURecord, InferInput, InferInputRecord, InferPartial, InferPartialRecord, InferPatch, InferPatchRecord, InferRecord, IsValidVertexSchema, MemIdentityRecord } from "../shared/repr.js";

package/data/dataTypes.js

@@ -1,6 +1,6 @@
 import { isMarkedInternal } from "../shared/symbols.js";
-import { vertexFormats } from "../shared/vertexFormat.js";
 import { isAlignAttrib, isDecorated, isLocationAttrib, isPtr, isSizeAttrib, isWgslData } from "./wgslTypes.js";
+import { vertexFormats } from "../shared/vertexFormat.js";
 
 //#region src/data/dataTypes.ts
 /**
@@ -72,16 +72,6 @@ function isData(value) {
 	return isWgslData(value) || isLooseData(value);
 }
 const UnknownData = Symbol("UNKNOWN");
-var InfixDispatch = class {
-	name;
-	lhs;
-	operator;
-	constructor(name, lhs, operator) {
-		this.name = name;
-		this.lhs = lhs;
-		this.operator = operator;
-	}
-};
 var MatrixColumnsAccess = class {
 	matrix;
 	constructor(matrix) {
@@ -90,4 +80,4 @@ var MatrixColumnsAccess = class {
 };
 
 //#endregion
-export { InfixDispatch, MatrixColumnsAccess, UnknownData, getCustomAlignment, getCustomLocation, getCustomSize, isData, isDisarray, isLooseData, isLooseDecorated, isUnstruct, undecorate, unptr };
+export { MatrixColumnsAccess, UnknownData, getCustomAlignment, getCustomLocation, getCustomSize, isData, isDisarray, isLooseData, isLooseDecorated, isUnstruct, undecorate, unptr };