typegpu 0.11.3 → 0.11.5

package/README.md

@@ -1,7 +1,9 @@
 <div align="center">
 
-![TypeGPU (light mode)](/apps/typegpu-docs/public/typegpu-logo-light.svg#gh-light-mode-only)
-
+<picture>
+<source srcset="https://typegpu.com/typegpu-logo-dark.svg" media="(prefers-color-scheme: dark)" />
+<img src="https://typegpu.com/typegpu-logo-light.svg" />
+</picture>
 
 [Website](https://docs.swmansion.com/TypeGPU) —
 [Documentation](https://docs.swmansion.com/TypeGPU/getting-started)

package/core/buffer/buffer.js

@@ -1,15 +1,12 @@
 import { $internal } from "../../shared/symbols.js";
 import { getName, setName } from "../../shared/meta.js";
-import { isWgslArray, isWgslData } from "../../data/wgslTypes.js";
+import { isWgslData } from "../../data/wgslTypes.js";
 import { isGPUBuffer } from "../../types.js";
-import { alignmentOf } from "../../data/alignmentOf.js";
-import { roundUp } from "../../mathUtils.js";
 import { sizeOf } from "../../data/sizeOf.js";
 import { getCompiledWriter } from "../../data/compiledIO.js";
-import { readData, writeData } from "../../data/dataIO.js";
-import { convertPartialToPatch, getPatchInstructions } from "../../data/partialIO.js";
+import { calculateOffsets, readFromArrayBuffer, writeToArrayBuffer } from "../../data/dataIO.js";
+import { convertPartialToPatch, getPatchInstructions, patchArrayBuffer } from "../../data/partialIO.js";
 import { mutable, readonly, uniform } from "./bufferUsage.js";
-import { BufferReader, BufferWriter, getSystemEndianness } from "typed-binary";
 
 //#region src/core/buffer/buffer.ts
 const usageToUsageConstructor = {
@@ -27,7 +24,6 @@ function isBuffer(value) {
 function isUsableAsVertex(buffer) {
 	return !!buffer.usableAsVertex;
 }
-const endianness = getSystemEndianness();
 var TgpuBufferImpl = class {
 	[$internal] = true;
 	resourceType = "buffer";
@@ -74,7 +70,7 @@ var TgpuBufferImpl = class {
 			});
 			if (this.initial || this.#initialCallback) {
 				if (this.#initialCallback) this.#initialCallback(this);
-				else if (this.initial) this.#writeToTarget(this.#getMappedRange(), this.initial);
+				else if (this.initial) writeToArrayBuffer(this.#getMappedRange(), this.dataType, this.initial);
 				this.#unmapBuffer();
 			}
 		}
@@ -134,62 +130,30 @@ var TgpuBufferImpl = class {
 	compileWriter() {
 		getCompiledWriter(this.dataType);
 	}
-	#writeToTarget(target, data, options) {
-		const startOffset = options?.startOffset ?? 0;
-		const endOffset = options?.endOffset ?? target.byteLength;
-		if (data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {
-			const src = data instanceof ArrayBuffer ? new Uint8Array(data) : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-			const regionSize = endOffset - startOffset;
-			if (src.byteLength !== regionSize) console.warn(`Buffer size mismatch: expected ${regionSize} bytes, got ${src.byteLength}. ` + (src.byteLength < regionSize ? "Data truncated." : "Excess ignored."));
-			const copyLen = Math.min(src.byteLength, regionSize);
-			new Uint8Array(target).set(src.subarray(0, copyLen), startOffset);
-			return;
-		}
-		const dataView = new DataView(target);
-		const isLittleEndian = endianness === "little";
-		const compiledWriter = getCompiledWriter(this.dataType);
-		if (compiledWriter) try {
-			compiledWriter(dataView, startOffset, data, isLittleEndian, endOffset);
-			return;
-		} catch (error) {
-			console.error(`Error when using compiled writer for buffer ${getName(this) ?? "<unnamed>"} - this is likely a bug, please submit an issue at https://github.com/software-mansion/TypeGPU/issues\nUsing fallback writer instead.`, error);
-		}
-		const writer = new BufferWriter(target);
-		writer.seekTo(startOffset);
-		writeData(writer, this.dataType, data);
-	}
 	write(data, options) {
 		const gpuBuffer = this.buffer;
-		const bufferSize = sizeOf(this.dataType);
-		const startOffset = options?.startOffset ?? 0;
-		let naturalSize = void 0;
-		if (isWgslArray(this.dataType) && Array.isArray(data)) naturalSize = data.length * roundUp(sizeOf(this.dataType.elementType), alignmentOf(this.dataType.elementType));
-		else if (ArrayBuffer.isView(data) || data instanceof ArrayBuffer) naturalSize = data.byteLength;
-		const naturalEndOffset = naturalSize !== void 0 ? Math.min(startOffset + naturalSize, bufferSize) : void 0;
-		const size = (options?.endOffset ?? naturalEndOffset ?? bufferSize) - startOffset;
 		if (gpuBuffer.mapState === "mapped") {
 			const mapped = this.#getMappedRange();
 			if (data instanceof ArrayBuffer && data === mapped) return;
-			this.#writeToTarget(mapped, data, options);
+			writeToArrayBuffer(mapped, this.dataType, data, options);
 			return;
 		}
-		if (!(data instanceof ArrayBuffer && data === this.#hostBuffer)) this.#writeToTarget(this.#hostBuffer, data, options);
+		if (!(data instanceof ArrayBuffer && data === this.#hostBuffer)) writeToArrayBuffer(this.#hostBuffer, this.dataType, data, options);
+		const { startOffset, endOffset } = calculateOffsets(options, this.dataType, data);
+		const size = endOffset - startOffset;
 		this.#device.queue.writeBuffer(gpuBuffer, startOffset, this.#hostBuffer, startOffset, size);
 	}
 	/** @deprecated Use {@link patch} instead. */
 	writePartial(data) {
-		this.#applyInstructions(getPatchInstructions(this.dataType, convertPartialToPatch(this.dataType, data), this.#hostBuffer));
+		this.patch(convertPartialToPatch(this.dataType, data));
 	}
 	patch(data) {
-		this.#applyInstructions(getPatchInstructions(this.dataType, data, this.#hostBuffer));
-	}
-	#applyInstructions(instructions) {
 		const gpuBuffer = this.buffer;
-		if (gpuBuffer.mapState === "mapped") {
-			const mappedRange = this.#getMappedRange();
-			const mappedView = new Uint8Array(mappedRange);
-			for (const { data, gpuOffset } of instructions) mappedView.set(data, gpuOffset);
-		} else for (const { data, gpuOffset } of instructions) this.#device.queue.writeBuffer(gpuBuffer, gpuOffset, data);
+		if (gpuBuffer.mapState === "mapped") patchArrayBuffer(this.#getMappedRange(), this.dataType, data);
+		else {
+			const instructions = getPatchInstructions(this.dataType, data, this.#hostBuffer);
+			for (const { data: data$1, gpuOffset } of instructions) this.#device.queue.writeBuffer(gpuBuffer, gpuOffset, data$1);
+		}
 	}
 	clear() {
 		const gpuBuffer = this.buffer;
@@ -210,10 +174,10 @@ var TgpuBufferImpl = class {
 	}
 	async read() {
 		const gpuBuffer = this.buffer;
-		if (gpuBuffer.mapState === "mapped") return readData(new BufferReader(this.#getMappedRange()), this.dataType);
+		if (gpuBuffer.mapState === "mapped") return readFromArrayBuffer(this.#getMappedRange(), this.dataType);
 		if (gpuBuffer.usage & GPUBufferUsage.MAP_READ) {
 			await gpuBuffer.mapAsync(GPUMapMode.READ);
-			const res$1 = readData(new BufferReader(this.#getMappedRange()), this.dataType);
+			const res$1 = readFromArrayBuffer(this.#getMappedRange(), this.dataType);
 			this.#unmapBuffer();
 			return res$1;
 		}
@@ -225,7 +189,7 @@ var TgpuBufferImpl = class {
 		commandEncoder.copyBufferToBuffer(gpuBuffer, 0, stagingBuffer, 0, sizeOf(this.dataType));
 		this.#device.queue.submit([commandEncoder.finish()]);
 		await stagingBuffer.mapAsync(GPUMapMode.READ, 0, sizeOf(this.dataType));
-		const res = readData(new BufferReader(stagingBuffer.getMappedRange()), this.dataType);
+		const res = readFromArrayBuffer(stagingBuffer.getMappedRange(), this.dataType);
 		stagingBuffer.unmap();
 		stagingBuffer.destroy();
 		return res;

package/core/buffer/bufferUsage.js

@@ -36,7 +36,7 @@ var TgpuFixedBufferImpl = class {
 	}
 	[$resolve](ctx) {
 		const dataType = this.buffer.dataType;
-		const id = ctx.getUniqueName(this);
+		const id = ctx.makeUniqueIdentifier(getName(this), "global");
 		const { group, binding } = ctx.allocateFixedEntry(this.usage === "uniform" ? { uniform: dataType } : {
 			storage: dataType,
 			access: this.usage
@@ -103,7 +103,7 @@ var TgpuLaidOutBufferImpl = class {
 		setName(this, membership.key);
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		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};`);

package/core/constant/tgpuConstant.js

@@ -37,7 +37,7 @@ var TgpuConstImpl = class {
 		return this;
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		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};`);

package/core/function/fnCore.js

@@ -5,6 +5,7 @@ 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";
 import { extractArgs } from "./extractArgs.js";
 
@@ -29,21 +30,26 @@ function createFnCore(implementation, functionType, workgroupSize) {
 			else if (functionType === "vertex") attributes = `@vertex `;
 			else if (functionType === "fragment") attributes = `@fragment `;
 			for (const externals of externalsToApply) applyExternals(externalMap, externals);
-			const id = ctx.getUniqueName(this);
+			const id = ctx.makeUniqueIdentifier(getName(this), "global");
 			if (typeof implementation === "string") {
 				if (!returnType) throw new Error("Explicit return type is required for string implementation");
-				const validArgNames = entryInput ? Object.fromEntries(entryInput.positionalArgs.map((a) => [a.schemaKey, ctx.makeNameValid(a.schemaKey)])) : void 0;
-				if (validArgNames && Object.keys(validArgNames).length > 0) applyExternals(externalMap, { in: validArgNames });
+				if (entryInput) {
+					for (const arg of entryInput.positionalArgs) {
+						const result = /* @__PURE__ */ validateIdentifier(arg.schemaKey);
+						if (!result.success) throw new Error(`Invalid argument name "${arg.schemaKey}"${result.error ? `: ${result.error}` : ""}`);
+					}
+					applyExternals(externalMap, { in: Object.fromEntries(entryInput.positionalArgs.map((a) => [a.schemaKey, a.schemaKey])) });
+				}
 				const replacedImpl = replaceExternalsInWgsl(ctx, externalMap, implementation);
 				let header = "";
 				let body = "";
-				if (functionType !== "normal" && entryInput && validArgNames) {
+				if (functionType !== "normal" && entryInput) {
 					const { dataSchema, positionalArgs } = entryInput;
 					const parts = [];
 					if (dataSchema && isArgUsedInBody("in", replacedImpl)) parts.push(`in: ${ctx.resolve(dataSchema).value}`);
 					for (const a of positionalArgs) {
-						const argName = validArgNames[a.schemaKey] ?? "";
-						if (argName !== "" && isArgUsedInBody(argName, replacedImpl)) parts.push(`${getAttributesString(a.type)}${argName}: ${ctx.resolve(a.type).value}`);
+						const argName = a.schemaKey;
+						if (isArgUsedInBody(argName, replacedImpl)) parts.push(`${getAttributesString(a.type)}${argName}: ${ctx.resolve(a.type).value}`);
 					}
 					const input = `(${parts.join(", ")})`;
 					const attributes$1 = isWgslData(returnType) ? getAttributesString(returnType) : "";

package/core/function/tgpuFragmentFn.d.ts

@@ -2,9 +2,9 @@ import { TgpuNamable } from "../../shared/meta.js";
 import { $internal } from "../../shared/symbols.js";
 import { Prettify } from "../../shared/utilityTypes.js";
 import { AnyFragmentInputBuiltin, AnyFragmentOutputBuiltin, OmitBuiltins } from "../../builtin.js";
+import { InstanceToSchema } from "../../data/instanceToSchema.js";
 import { BaseIOData, IOLayout, IORecord, InferIO } from "./fnTypes.js";
 import { AnyAutoCustoms, AutoFragmentIn, AutoFragmentOut } from "./autoIO.js";
-import { InstanceToSchema } from "../../data/instanceToSchema.js";
 import { IOLayoutToSchema } from "./ioSchema.js";
 import { BaseData, Decorated, Interpolate, Location, Vec4f, Vec4i, Vec4u, WgslStruct } from "../../data/wgslTypes.js";
 import { UndecorateRecord } from "../../data/dataTypes.js";

package/core/pipeline/computePipeline.d.ts

@@ -3,8 +3,8 @@ import { $internal } from "../../shared/symbols.js";
 import { AnyComputeBuiltin } from "../../builtin.js";
 import "../querySet/querySet.js";
 import "../../data/snippet.js";
-import "../../tgsl/consoleLog/types.js";
 import { IORecord } from "../function/fnTypes.js";
+import "../../tgsl/consoleLog/types.js";
 import { TgpuComputeFn } from "../function/tgpuComputeFn.js";
 import "../slot/slotTypes.js";
 import { PrimitiveOffsetInfo } from "../../data/offsetUtils.js";

package/core/pipeline/computePipeline.js

@@ -3,10 +3,10 @@ import { PERF, getName, setName } from "../../shared/meta.js";
 import { Void } from "../../data/wgslTypes.js";
 import { snip } from "../../data/snippet.js";
 import { isGPUBuffer } from "../../types.js";
-import { namespace } from "../resolve/namespace.js";
 import { isBindGroup } from "../../tgpuBindGroupLayout.js";
 import { resolve } from "../../resolutionCtx.js";
 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";

package/core/pipeline/renderPipeline.js

@@ -7,12 +7,12 @@ import { isGPUBuffer } from "../../types.js";
 import { formatToWGSLType } from "../../data/vertexFormatData.js";
 import { sizeOf } from "../../data/sizeOf.js";
 import { isBuiltin } from "../../data/attributes.js";
-import { namespace } from "../resolve/namespace.js";
 import { isTexture, isTextureView } from "../texture/texture.js";
 import { isBindGroup, isBindGroupLayout } from "../../tgpuBindGroupLayout.js";
 import { connectAttributesToShader } from "../vertexLayout/connectAttributesToShader.js";
 import { resolve } from "../../resolutionCtx.js";
 import { isGPUCommandEncoder, isGPURenderBundleEncoder, isGPURenderPassEncoder } from "./typeGuards.js";
+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";

package/core/resolve/namespace.d.ts

@@ -2,13 +2,13 @@ import { $internal } from "../../shared/symbols.js";
 import { ResolvedSnippet } from "../../data/snippet.js";
 import { ShelllessRepository } from "../../tgsl/shellless.js";
 import { TgpuLazy, TgpuSlot } from "../slot/slotTypes.js";
-import { NameRegistry } from "../../nameRegistry.js";
 
 //#region src/core/resolve/namespace.d.ts
 type SlotToValueMap = Map<TgpuSlot<unknown>, unknown>;
 interface NamespaceInternal {
-  readonly nameRegistry: NameRegistry;
+  readonly takenGlobalIdentifiers: Set<string>;
   readonly shelllessRepo: ShelllessRepository;
+  readonly strategy: 'random' | 'strict';
   memoizedResolves: WeakMap<object, {
     slotToValueMap: SlotToValueMap;
     result: ResolvedSnippet;
@@ -17,18 +17,9 @@ interface NamespaceInternal {
     slotToValueMap: SlotToValueMap;
     result: unknown;
   }[]>;
-  listeners: { [K in keyof NamespaceEventMap]: Set<(event: NamespaceEventMap[K]) => void> };
 }
-type NamespaceEventMap = {
-  name: {
-    target: object;
-    name: string;
-  };
-};
-type DetachListener = () => void;
 interface Namespace {
   readonly [$internal]: NamespaceInternal;
-  on<TEvent extends keyof NamespaceEventMap>(event: TEvent, listener: (event: NamespaceEventMap[TEvent]) => void): DetachListener;
 }
 interface NamespaceOptions {
   names?: 'random' | 'strict' | undefined;

package/core/resolve/namespace.js

@@ -1,41 +1,24 @@
 import { $internal } from "../../shared/symbols.js";
-import { getName } from "../../shared/meta.js";
-import { RandomNameRegistry, StrictNameRegistry } from "../../nameRegistry.js";
+import { bannedTokens, builtins } from "../../nameUtils.js";
 import { ShelllessRepository } from "../../tgsl/shellless.js";
 
 //#region src/core/resolve/namespace.ts
 var NamespaceImpl = class {
 	[$internal];
-	constructor(nameRegistry) {
+	constructor(strategy) {
 		this[$internal] = {
-			nameRegistry,
+			strategy,
+			takenGlobalIdentifiers: new Set([...bannedTokens, ...builtins]),
 			shelllessRepo: new ShelllessRepository(),
 			memoizedResolves: /* @__PURE__ */ new WeakMap(),
-			memoizedLazy: /* @__PURE__ */ new WeakMap(),
-			listeners: { name: /* @__PURE__ */ new Set() }
+			memoizedLazy: /* @__PURE__ */ new WeakMap()
 		};
 	}
-	on(event, listener) {
-		if (event === "name") {
-			const listeners = this[$internal].listeners.name;
-			listeners.add(listener);
-			return () => listeners.delete(listener);
-		}
-		throw new Error(`Unsupported event: ${event}`);
-	}
 };
-function getUniqueName(namespace$1, resource) {
-	const name = namespace$1.nameRegistry.makeUnique(getName(resource), true);
-	for (const listener of namespace$1.listeners.name) listener({
-		target: resource,
-		name
-	});
-	return name;
-}
 function namespace(options) {
 	const { names = "strict" } = options ?? {};
-	return new NamespaceImpl(names === "strict" ? new StrictNameRegistry() : new RandomNameRegistry());
+	return new NamespaceImpl(names);
 }
 
 //#endregion
-export { getUniqueName, namespace };
+export { namespace };

package/core/resolve/resolveData.js

@@ -1,4 +1,5 @@
 import { $internal } from "../../shared/symbols.js";
+import { getName } from "../../shared/meta.js";
 import { isLooseData } from "../../data/dataTypes.js";
 import { assertExhaustive } from "../../shared/utilityTypes.js";
 import { formatToWGSLType } from "../../data/vertexFormatData.js";
@@ -61,7 +62,7 @@ function resolveStructProperty(ctx, [key, property]) {
 */
 function resolveStruct(ctx, struct) {
 	if (struct[$internal].isAbstruct) throw new Error("Cannot resolve abstract struct types to WGSL.");
-	const id = ctx.getUniqueName(struct);
+	const id = ctx.makeUniqueIdentifier(getName(struct), "global");
 	ctx.addDeclaration(`\
 struct ${id} {
 ${Object.entries(struct.propTypes).map((prop) => resolveStructProperty(ctx, prop)).join("")}\
@@ -84,7 +85,7 @@ ${Object.entries(struct.propTypes).map((prop) => resolveStructProperty(ctx, prop
 * ```
 */
 function resolveUnstruct(ctx, unstruct) {
-	const id = ctx.getUniqueName(unstruct);
+	const id = ctx.makeUniqueIdentifier(getName(unstruct), "global");
 	ctx.addDeclaration(`\
 struct ${id} {
 ${Object.entries(unstruct.propTypes).map((prop) => isAttribute(prop[1]) ? resolveStructProperty(ctx, [prop[0], formatToWGSLType[prop[1].format]]) : resolveStructProperty(ctx, prop)).join("")}

package/core/resolve/tgpuResolve.js

@@ -2,10 +2,10 @@ import { $internal, $resolve } from "../../shared/symbols.js";
 import { Void } from "../../data/wgslTypes.js";
 import { snip } from "../../data/snippet.js";
 import { applyExternals, replaceExternalsInWgsl } from "./externals.js";
-import { namespace } from "./namespace.js";
 import { isBindGroupLayout } from "../../tgpuBindGroupLayout.js";
 import { resolve } from "../../resolutionCtx.js";
 import { isPipeline } from "../pipeline/typeGuards.js";
+import { namespace } from "./namespace.js";
 
 //#region src/core/resolve/tgpuResolve.ts
 function resolveWithContext(arg0, options) {

package/core/root/init.d.ts

@@ -1,3 +1,4 @@
+import "../querySet/querySet.js";
 import "../buffer/bufferShorthand.js";
 import { LogGeneratorOptions } from "../../tgsl/consoleLog/types.js";
 import "../pipeline/computePipeline.js";

package/core/root/init.js

@@ -54,6 +54,12 @@ var TgpuGuardedComputePipelineImpl = class TgpuGuardedComputePipelineImpl {
 	with(bindGroupOrEncoder) {
 		return new TgpuGuardedComputePipelineImpl(this.#root, this.#pipeline.with(bindGroupOrEncoder), this.#sizeUniform, this.#workgroupSize);
 	}
+	withPerformanceCallback(callback) {
+		return new TgpuGuardedComputePipelineImpl(this.#root, this.#pipeline.withPerformanceCallback(callback), this.#sizeUniform, this.#workgroupSize);
+	}
+	withTimestampWrites(options) {
+		return new TgpuGuardedComputePipelineImpl(this.#root, this.#pipeline.withTimestampWrites(options), this.#sizeUniform, this.#workgroupSize);
+	}
 	dispatchThreads(...threads) {
 		const sanitizedSize = toVec3(threads);
 		const workgroupCount = ceil(vec3f(sanitizedSize).div(vec3f(this.#workgroupSize)));

package/core/root/rootTypes.d.ts

@@ -4,14 +4,14 @@ import { Assume, Mutable, OmitProps, Prettify } from "../../shared/utilityTypes.
 import { WgslComparisonSamplerProps, WgslSamplerProps } from "../../data/sampler.js";
 import { AnyComputeBuiltin, AnyFragmentInputBuiltin, OmitBuiltins } from "../../builtin.js";
 import { TgpuQuerySet } from "../querySet/querySet.js";
+import { InstanceToSchema } from "../../data/instanceToSchema.js";
 import { TgpuMutable, TgpuReadonly, TgpuUniform } from "../buffer/bufferShorthand.js";
-import { LogGeneratorOptions } from "../../tgsl/consoleLog/types.js";
 import { IORecord } from "../function/fnTypes.js";
+import { LogGeneratorOptions } from "../../tgsl/consoleLog/types.js";
 import { TgpuComputeFn } from "../function/tgpuComputeFn.js";
 import { Eventual, TgpuAccessor, TgpuMutableAccessor, TgpuSlot } from "../slot/slotTypes.js";
 import { TgpuComputePipeline } from "../pipeline/computePipeline.js";
 import { AnyAutoCustoms, AutoFragmentIn, AutoFragmentOut, AutoVertexIn, AutoVertexOut } from "../function/autoIO.js";
-import { InstanceToSchema } from "../../data/instanceToSchema.js";
 import { FragmentInConstrained, FragmentOutConstrained, TgpuFragmentFn, VertexOutToVarying } from "../function/tgpuFragmentFn.js";
 import { TgpuVertexFn } from "../function/tgpuVertexFn.js";
 import { AttribRecordToDefaultDataTypes, LayoutToAllowedAttribs } from "../vertexLayout/vertexAttribute.js";
@@ -40,6 +40,20 @@ interface TgpuGuardedComputePipeline<TArgs extends number[] = number[]> extends
    * Analogous to `TgpuComputePipeline.with(encoder)`.
    */
   with(encoder: GPUCommandEncoder): TgpuGuardedComputePipeline<TArgs>;
+  /**
+   * Returns a pipeline wrapper with the given performance callback attached.
+   * Analogous to `TgpuComputePipeline.withPerformanceCallback(callback)`.
+   */
+  withPerformanceCallback(callback: (start: bigint, end: bigint) => void | Promise<void>): TgpuGuardedComputePipeline<TArgs>;
+  /**
+   * Returns a pipeline wrapper with the given timestamp writes configuration.
+   * Analogous to `TgpuComputePipeline.withTimestampWrites(options)`.
+   */
+  withTimestampWrites(options: {
+    querySet: TgpuQuerySet<'timestamp'> | GPUQuerySet;
+    beginningOfPassWriteIndex?: number;
+    endOfPassWriteIndex?: number;
+  }): TgpuGuardedComputePipeline<TArgs>;
   /**
    * Dispatches the pipeline.
    * Unlike `TgpuComputePipeline.dispatchWorkgroups()`, this method takes in the
@@ -166,7 +180,7 @@ interface WithBinding extends Withable<WithBinding> {
   })): TgpuRenderPipeline<NormalizeOutput<TFragmentOut>> | TgpuRenderPipeline<Void>;
   /**
    * Creates a compute pipeline that executes the given callback in an exact number of threads.
-   * This is different from `withCompute(...).createPipeline()` in that it does a bounds check on the
+   * This is different from `createComputePipeline()` in that it does a bounds check on the
    * thread id, where as regular pipelines do not and work in units of workgroups.
    *
    * @param callback A function converted to WGSL and executed on the GPU.
@@ -473,10 +487,8 @@ interface TgpuRoot extends Unwrapper, WithBinding {
    * Typed wrapper around a GPUBuffer.
    *
    * @param typeSchema The type of data that this buffer will hold.
-   * @param initial The initial value of the buffer. (optional)
+   * @param initial Either initial value of the buffer, or an initializer to execute on the mapped buffer. (optional)
    */
-  createBuffer<TData extends AnyData>(typeSchema: ValidateBufferSchema<TData>, initializer: (buffer: TgpuBuffer<NoInfer<TData>>) => void): TgpuBuffer<TData>;
-  createBuffer<TData extends AnyData>(typeSchema: ValidateBufferSchema<TData>, initial?: InferInput<NoInfer<TData>>): TgpuBuffer<TData>;
   createBuffer<TData extends AnyData>(typeSchema: ValidateBufferSchema<TData>, initial?: ((buffer: TgpuBuffer<NoInfer<TData>>) => void) | InferInput<NoInfer<TData>>): TgpuBuffer<TData>;
   /**
    * Allocates memory on the GPU, allows passing data between host and shader.
@@ -494,10 +506,8 @@ interface TgpuRoot extends Unwrapper, WithBinding {
    * use {@link TgpuRoot.createBuffer}.
    *
    * @param typeSchema The type of data that this buffer will hold.
-   * @param initial The initial value of the buffer. (optional)
+   * @param initial Either initial value of the buffer, or an initializer to execute on the mapped buffer. (optional)
    */
-  createUniform<TData extends AnyWgslData>(typeSchema: ValidateUniformSchema<TData>, initializer: (buffer: TgpuBuffer<NoInfer<TData>>) => void): TgpuUniform<TData>;
-  createUniform<TData extends AnyWgslData>(typeSchema: ValidateUniformSchema<TData>, initial?: InferInput<NoInfer<TData>>): TgpuUniform<TData>;
   createUniform<TData extends AnyWgslData>(typeSchema: ValidateUniformSchema<TData>, initial?: ((buffer: TgpuBuffer<NoInfer<TData>>) => void) | InferInput<NoInfer<TData>>): TgpuUniform<TData>;
   /**
    * Allocates memory on the GPU, allows passing data between host and shader.
@@ -514,10 +524,8 @@ interface TgpuRoot extends Unwrapper, WithBinding {
    * use {@link TgpuRoot.createBuffer}.
    *
    * @param typeSchema The type of data that this buffer will hold.
-   * @param initial The initial value of the buffer. (optional)
+   * @param initial Either initial value of the buffer, or an initializer to execute on the mapped buffer. (optional)
    */
-  createMutable<TData extends AnyWgslData>(typeSchema: ValidateStorageSchema<TData>, initializer: (buffer: TgpuBuffer<NoInfer<TData>>) => void): TgpuMutable<TData>;
-  createMutable<TData extends AnyWgslData>(typeSchema: ValidateStorageSchema<TData>, initial?: InferInput<NoInfer<TData>>): TgpuMutable<TData>;
   createMutable<TData extends AnyWgslData>(typeSchema: ValidateStorageSchema<TData>, initial?: ((buffer: TgpuBuffer<NoInfer<TData>>) => void) | InferInput<NoInfer<TData>>): TgpuMutable<TData>;
   /**
    * Allocates memory on the GPU, allows passing data between host and shader.
@@ -534,10 +542,8 @@ interface TgpuRoot extends Unwrapper, WithBinding {
    * use {@link TgpuRoot.createBuffer}.
    *
    * @param typeSchema The type of data that this buffer will hold.
-   * @param initial The initial value of the buffer. (optional)
+   * @param initial Either initial value of the buffer, or an initializer to execute on the mapped buffer. (optional)
    */
-  createReadonly<TData extends AnyWgslData>(typeSchema: ValidateStorageSchema<TData>, initializer: (buffer: TgpuBuffer<NoInfer<TData>>) => void): TgpuReadonly<TData>;
-  createReadonly<TData extends AnyWgslData>(typeSchema: ValidateStorageSchema<TData>, initial?: InferInput<NoInfer<TData>>): TgpuReadonly<TData>;
   createReadonly<TData extends AnyWgslData>(typeSchema: ValidateStorageSchema<TData>, initial?: ((buffer: TgpuBuffer<NoInfer<TData>>) => void) | InferInput<NoInfer<TData>>): TgpuReadonly<TData>;
   /**
    * Allocates memory on the GPU, allows passing data between host and shader.

package/core/sampler/sampler.js

@@ -32,7 +32,7 @@ var TgpuLaidOutSamplerImpl = class {
 		setName(this, membership.key);
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		const id = ctx.makeUniqueIdentifier(getName(this), "global");
 		const group = ctx.allocateLayoutEntry(this.#membership.layout);
 		ctx.addDeclaration(`@group(${group}) @binding(${this.#membership.idx}) var ${id}: ${ctx.resolve(this.schema).value};`);
 		return snip(id, this.schema, "handle");
@@ -82,7 +82,7 @@ var TgpuFixedSamplerImpl = class {
 		this.#filtering = props.minFilter === "linear" || props.magFilter === "linear" || props.mipmapFilter === "linear";
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		const id = ctx.makeUniqueIdentifier(getName(this), "global");
 		const { group, binding } = ctx.allocateFixedEntry(this.schema.type === "sampler_comparison" ? { sampler: "comparison" } : { sampler: this.#filtering ? "filtering" : "non-filtering" }, this);
 		ctx.addDeclaration(`@group(${group}) @binding(${binding}) var ${id}: ${ctx.resolve(this.schema).value};`);
 		return snip(id, this.schema, "handle");

package/core/simulate/tgpuSimulate.js

@@ -1,8 +1,8 @@
 import { SimulationState } from "../../types.js";
 import { getResolutionCtx, provideCtx } from "../../execMode.js";
-import { namespace } from "../resolve/namespace.js";
 import wgslGenerator_default from "../../tgsl/wgslGenerator.js";
 import { ResolutionCtxImpl } from "../../resolutionCtx.js";
+import { namespace } from "../resolve/namespace.js";
 
 //#region src/core/simulate/tgpuSimulate.ts
 /**

package/core/slot/accessor.js

@@ -25,7 +25,7 @@ var AccessorBase = class {
 	constructor(schemaOrConstructor, defaultValue = void 0) {
 		this.schema = isData(schemaOrConstructor) ? schemaOrConstructor : schemaOrConstructor(0);
 		this.defaultValue = defaultValue;
-		this.slot = slot(defaultValue);
+		this.slot = (() => slot(defaultValue))();
 		this[$getNameForward] = this.slot;
 	}
 	get [$gpuValueOf]() {

package/core/texture/externalTexture.js

@@ -17,7 +17,7 @@ var TgpuExternalTextureImpl = class {
 		setName(this, membership.key);
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		const id = ctx.makeUniqueIdentifier(getName(this), "global");
 		const group = ctx.allocateLayoutEntry(this.#membership.layout);
 		ctx.addDeclaration(`@group(${group}) @binding(${this.#membership.idx}) var ${id}: ${ctx.resolve(this.schema).value};`);
 		return snip(id, textureExternal(), "handle");

package/core/texture/texture.js

@@ -246,7 +246,7 @@ var TgpuFixedTextureViewImpl = class {
 		return `textureView:${getName(this) ?? "<unnamed>"}`;
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		const id = ctx.makeUniqueIdentifier(getName(this), "global");
 		const { group, binding } = ctx.allocateFixedEntry(isWgslStorageTexture(this.schema) ? { storageTexture: this.schema } : {
 			texture: this.schema,
 			sampleType: this.#descriptor?.sampleType ?? this.schema.bindingSampleType[0]
@@ -269,7 +269,7 @@ var TgpuLaidOutTextureViewImpl = class {
 		return `textureView:${getName(this) ?? "<unnamed>"}`;
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		const id = ctx.makeUniqueIdentifier(getName(this), "global");
 		const group = ctx.allocateLayoutEntry(this.#membership.layout);
 		ctx.addDeclaration(`@group(${group}) @binding(${this.#membership.idx}) var ${id}: ${ctx.resolve(this.schema).value};`);
 		return snip(id, this.schema, "handle");

package/core/variable/tgpuVariable.js

@@ -42,7 +42,7 @@ var TgpuVarImpl = class {
 		this.#initialValue = initialValue;
 	}
 	[$resolve](ctx) {
-		const id = ctx.getUniqueName(this);
+		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};`);

package/data/autoStruct.js

@@ -1,6 +1,6 @@
 import { $internal, $resolve } from "../shared/symbols.js";
 import { getName, setName } from "../shared/meta.js";
-import { isValidProp } from "../nameRegistry.js";
+import { validateProp } from "../nameUtils.js";
 import { createIoSchema } from "../core/function/ioSchema.js";
 
 //#region src/data/autoStruct.ts
@@ -49,7 +49,8 @@ var AutoStruct = class {
 		if (!alloc) {
 			const wgslKey = key.replaceAll("$", "");
 			if (this.#usedWgslKeys.has(wgslKey)) throw new Error(`Property name '${wgslKey}' causes naming clashes. Choose a different name.`);
-			if (!isValidProp(wgslKey)) throw new Error(`Property key '${key}' is a reserved WGSL word. Choose a different name.`);
+			const result = /* @__PURE__ */ validateProp(wgslKey);
+			if (!result.success) throw new Error(`Invalid property key '${key}'${result.error ? `: ${result.error}` : ""}`);
 			this.#usedWgslKeys.add(wgslKey);
 			alloc = {
 				prop: wgslKey,

package/data/dataIO.d.ts

@@ -0,0 +1,11 @@
+import { BufferWriteOptions } from "../core/buffer/buffer.js";
+import { BaseData } from "./wgslTypes.js";
+import { Infer, InferInput } from "../shared/repr.js";
+import "typed-binary";
+
+//#region src/data/dataIO.d.ts
+
+declare function writeToArrayBuffer<T extends BaseData>(buffer: ArrayBuffer, schema: T, data: InferInput<T> | ArrayBuffer, options?: BufferWriteOptions): void;
+declare function readFromArrayBuffer<T extends BaseData>(buffer: ArrayBuffer, schema: T): Infer<T>;
+//#endregion
+export { readFromArrayBuffer, writeToArrayBuffer };