typegpu 0.11.3 → 0.11.5

package/data/dataIO.js

@@ -1,8 +1,13 @@
+import { getName } from "../shared/meta.js";
+import { isWgslArray } from "./wgslTypes.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";
 import { sizeOf } from "./sizeOf.js";
 import { mat2x2f, mat3x3f, mat4x4f } from "./matrix.js";
 import alignIO_default from "./alignIO.js";
+import { getCompiledWriter } from "./compiledIO.js";
+import { BufferReader, BufferWriter, getSystemEndianness } from "typed-binary";
 
 //#region src/data/dataIO.ts
 const dataWriters = {
@@ -553,6 +558,45 @@ function readData(input, schema) {
 	if (!reader) throw new Error(`Cannot read data of type '${schema.type}'.`);
 	return reader(input, schema);
 }
+const endianness = getSystemEndianness();
+function calculateOffsets(options, schema, data) {
+	const bufferSize = sizeOf(schema);
+	const startOffset = options?.startOffset ?? 0;
+	let naturalSize = void 0;
+	if (isWgslArray(schema) && Array.isArray(data)) naturalSize = data.length * roundUp(sizeOf(schema.elementType), alignmentOf(schema.elementType));
+	else if (ArrayBuffer.isView(data) || data instanceof ArrayBuffer) naturalSize = data.byteLength;
+	const naturalEndOffset = naturalSize !== void 0 ? Math.min(startOffset + naturalSize, bufferSize) : void 0;
+	return {
+		startOffset,
+		endOffset: options?.endOffset ?? naturalEndOffset ?? bufferSize
+	};
+}
+function writeToArrayBuffer(buffer, schema, data, options) {
+	const { startOffset, endOffset } = calculateOffsets(options, schema, data);
+	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(buffer).set(src.subarray(0, copyLen), startOffset);
+		return;
+	}
+	const dataView = new DataView(buffer);
+	const isLittleEndian = endianness === "little";
+	const compiledWriter = getCompiledWriter(schema);
+	if (compiledWriter) try {
+		compiledWriter(dataView, startOffset, data, isLittleEndian, endOffset);
+		return;
+	} catch (error) {
+		console.error(`Error when using compiled writer for data type '${schema.type}' (${getName(schema) ?? "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(buffer);
+	writer.seekTo(startOffset);
+	writeData(writer, schema, data);
+}
+function readFromArrayBuffer(buffer, schema) {
+	return readData(new BufferReader(buffer), schema);
+}
 
 //#endregion
-export { readData, writeData };
+export { calculateOffsets, readFromArrayBuffer, writeData, writeToArrayBuffer };

package/data/dataTypes.d.ts

@@ -26,7 +26,7 @@ interface Disarray<out TElement extends BaseData = BaseData> extends BaseData {
   readonly elementCount: number;
   readonly elementType: TElement;
   readonly [$repr]: Infer<TElement>[];
-  readonly [$inRepr]: InferInput<TElement>[] | TypedArrayFor<TElement>;
+  readonly [$inRepr]: readonly InferInput<TElement>[] | TypedArrayFor<TElement>;
   readonly [$reprPartial]: {
     idx: number;
     value: InferPartial<TElement>;

package/data/dataTypes.js

@@ -1,5 +1,4 @@
-import { $internal, isMarkedInternal } from "../shared/symbols.js";
-import { setName } from "../shared/meta.js";
+import { isMarkedInternal } from "../shared/symbols.js";
 import { vertexFormats } from "../shared/vertexFormat.js";
 import { isAlignAttrib, isDecorated, isLocationAttrib, isPtr, isSizeAttrib, isWgslData } from "./wgslTypes.js";
 
@@ -89,14 +88,6 @@ var MatrixColumnsAccess = class {
 		this.matrix = matrix;
 	}
 };
-var ConsoleLog = class {
-	[$internal] = true;
-	op;
-	constructor(op) {
-		this.op = op;
-		setName(this, "consoleLog");
-	}
-};
 
 //#endregion
-export { ConsoleLog, InfixDispatch, MatrixColumnsAccess, UnknownData, getCustomAlignment, getCustomLocation, getCustomSize, isData, isDisarray, isLooseData, isLooseDecorated, isUnstruct, undecorate, unptr };
+export { InfixDispatch, MatrixColumnsAccess, UnknownData, getCustomAlignment, getCustomLocation, getCustomSize, isData, isDisarray, isLooseData, isLooseDecorated, isUnstruct, undecorate, unptr };

package/data/partialIO.d.ts

@@ -0,0 +1,8 @@
+import { BaseData } from "./wgslTypes.js";
+import { InferPatch } from "../shared/repr.js";
+
+//#region src/data/partialIO.d.ts
+
+declare function patchArrayBuffer<T extends BaseData>(buffer: ArrayBuffer, schema: T, data: InferPatch<T>): void;
+//#endregion
+export { patchArrayBuffer };

package/data/partialIO.js

@@ -110,6 +110,11 @@ function getPatchInstructions(schema, data, targetBuffer) {
 	});
 	return instructions;
 }
+function patchArrayBuffer(buffer, schema, data) {
+	const instructions = getPatchInstructions(schema, data, buffer);
+	const mappedView = new Uint8Array(buffer);
+	for (const { data: data$1, gpuOffset } of instructions) mappedView.set(data$1, gpuOffset);
+}
 
 //#endregion
-export { convertPartialToPatch, getPatchInstructions };
+export { convertPartialToPatch, getPatchInstructions, patchArrayBuffer };

package/data/struct.js

@@ -1,7 +1,7 @@
 import { $internal } from "../shared/symbols.js";
 import { getName, setName } from "../shared/meta.js";
 import { schemaCallWrapper } from "./schemaCallWrapper.js";
-import { isValidProp } from "../nameRegistry.js";
+import { validateProp } from "../nameUtils.js";
 
 //#region src/data/struct.ts
 /**
@@ -23,7 +23,8 @@ function abstruct(props) {
 }
 function INTERNAL_createStruct(props, isAbstruct) {
 	Object.keys(props).forEach((key) => {
-		if (!isValidProp(key)) throw new Error(`Property key '${key}' is a reserved WGSL word. Choose a different name.`);
+		const result = /* @__PURE__ */ validateProp(key);
+		if (!result.success) throw new Error(`Invalid property key '${key}'${result.error ? `: ${result.error}` : ""}`);
 	});
 	const structSchema = (instanceProps) => Object.fromEntries(Object.entries(props).map(([key, schema]) => [key, schemaCallWrapper(schema, instanceProps?.[key])]));
 	Object.setPrototypeOf(structSchema, WgslStructImpl);

package/data/wgslTypes.d.ts

@@ -493,7 +493,7 @@ interface Vec2f extends BaseData, DualFn<((x: number, y: number) => v2f) & ((xy:
   readonly primitive: F32;
   readonly componentCount: 2;
   readonly [$repr]: v2f;
-  readonly [$inRepr]: v2f | [number, number] | Float32Array;
+  readonly [$inRepr]: v2f | readonly [number, number] | Float32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -506,7 +506,7 @@ interface Vec2h extends BaseData, DualFn<((x: number, y: number) => v2h) & ((xy:
   readonly primitive: F16;
   readonly componentCount: 2;
   readonly [$repr]: v2h;
-  readonly [$inRepr]: v2h | [number, number] | Float16Array;
+  readonly [$inRepr]: v2h | readonly [number, number] | Float16Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -519,7 +519,7 @@ interface Vec2i extends BaseData, DualFn<((x: number, y: number) => v2i) & ((xy:
   readonly primitive: I32;
   readonly componentCount: 2;
   readonly [$repr]: v2i;
-  readonly [$inRepr]: v2i | [number, number] | Int32Array;
+  readonly [$inRepr]: v2i | readonly [number, number] | Int32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -532,7 +532,7 @@ interface Vec2u extends BaseData, DualFn<((x: number, y: number) => v2u) & ((xy:
   readonly primitive: U32;
   readonly componentCount: 2;
   readonly [$repr]: v2u;
-  readonly [$inRepr]: v2u | [number, number] | Uint32Array;
+  readonly [$inRepr]: v2u | readonly [number, number] | Uint32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -556,7 +556,7 @@ interface Vec3f extends BaseData, DualFn<((x: number, y: number, z: number) => v
   readonly primitive: F32;
   readonly componentCount: 3;
   readonly [$repr]: v3f;
-  readonly [$inRepr]: v3f | [number, number, number] | Float32Array;
+  readonly [$inRepr]: v3f | readonly [number, number, number] | Float32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -569,7 +569,7 @@ interface Vec3h extends BaseData, DualFn<((x: number, y: number, z: number) => v
   readonly primitive: F16;
   readonly componentCount: 3;
   readonly [$repr]: v3h;
-  readonly [$inRepr]: v3h | [number, number, number] | Float16Array;
+  readonly [$inRepr]: v3h | readonly [number, number, number] | Float16Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -582,7 +582,7 @@ interface Vec3i extends BaseData, DualFn<((x: number, y: number, z: number) => v
   readonly primitive: I32;
   readonly componentCount: 3;
   readonly [$repr]: v3i;
-  readonly [$inRepr]: v3i | [number, number, number] | Int32Array;
+  readonly [$inRepr]: v3i | readonly [number, number, number] | Int32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -595,7 +595,7 @@ interface Vec3u extends BaseData, DualFn<((x: number, y: number, z: number) => v
   readonly primitive: U32;
   readonly componentCount: 3;
   readonly [$repr]: v3u;
-  readonly [$inRepr]: v3u | [number, number, number] | Uint32Array;
+  readonly [$inRepr]: v3u | readonly [number, number, number] | Uint32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -619,7 +619,7 @@ interface Vec4f extends BaseData, DualFn<((x: number, y: number, z: number, w: n
   readonly primitive: F32;
   readonly componentCount: 4;
   readonly [$repr]: v4f;
-  readonly [$inRepr]: v4f | [number, number, number, number] | Float32Array;
+  readonly [$inRepr]: v4f | readonly [number, number, number, number] | Float32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -632,7 +632,7 @@ interface Vec4h extends BaseData, DualFn<((x: number, y: number, z: number, w: n
   readonly primitive: F16;
   readonly componentCount: 4;
   readonly [$repr]: v4h;
-  readonly [$inRepr]: v4h | [number, number, number, number] | Float16Array;
+  readonly [$inRepr]: v4h | readonly [number, number, number, number] | Float16Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -645,7 +645,7 @@ interface Vec4i extends BaseData, DualFn<((x: number, y: number, z: number, w: n
   readonly primitive: I32;
   readonly componentCount: 4;
   readonly [$repr]: v4i;
-  readonly [$inRepr]: v4i | [number, number, number, number] | Int32Array;
+  readonly [$inRepr]: v4i | readonly [number, number, number, number] | Int32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -658,7 +658,7 @@ interface Vec4u extends BaseData, DualFn<((x: number, y: number, z: number, w: n
   readonly primitive: U32;
   readonly componentCount: 4;
   readonly [$repr]: v4u;
-  readonly [$inRepr]: v4u | [number, number, number, number] | Uint32Array;
+  readonly [$inRepr]: v4u | readonly [number, number, number, number] | Uint32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   readonly [$validVertexSchema]: true;
@@ -681,7 +681,7 @@ interface Mat2x2f extends BaseData {
   readonly type: 'mat2x2f';
   readonly primitive: F32;
   readonly [$repr]: m2x2f;
-  readonly [$inRepr]: m2x2f | number[] | Float32Array;
+  readonly [$inRepr]: m2x2f | readonly number[] | Float32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   (...elements: [number, number, number, number]): m2x2f;
@@ -696,7 +696,7 @@ interface Mat3x3f extends BaseData {
   readonly type: 'mat3x3f';
   readonly primitive: F32;
   readonly [$repr]: m3x3f;
-  readonly [$inRepr]: m3x3f | number[] | Float32Array;
+  readonly [$inRepr]: m3x3f | readonly number[] | Float32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   (...elements: [number, number, number, number, number, number, number, number, number]): m3x3f;
@@ -711,7 +711,7 @@ interface Mat4x4f extends BaseData {
   readonly type: 'mat4x4f';
   readonly primitive: F32;
   readonly [$repr]: m4x4f;
-  readonly [$inRepr]: m4x4f | number[] | Float32Array;
+  readonly [$inRepr]: m4x4f | readonly number[] | Float32Array;
   readonly [$validStorageSchema]: true;
   readonly [$validUniformSchema]: true;
   (...elements: [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number]): m4x4f;
@@ -738,7 +738,7 @@ interface WgslArray<out TElement extends BaseData = BaseData> extends BaseData {
   readonly elementCount: number;
   readonly elementType: TElement;
   readonly [$repr]: Infer<TElement>[];
-  readonly [$inRepr]: InferInput<TElement>[] | TypedArrayFor<TElement>;
+  readonly [$inRepr]: readonly InferInput<TElement>[] | TypedArrayFor<TElement>;
   readonly [$gpuRepr]: InferGPU<TElement>[];
   readonly [$reprPartial]: {
     idx: number;

package/index.d.ts

@@ -38,6 +38,8 @@ import { index_d_exports as index_d_exports$2 } from "./std/index.js";
 import { index_d_exports } from "./common/index.js";
 import { MissingBindGroupsError, MissingLinksError, MissingSlotValueError, MissingVertexBuffersError, NotUniformError, ResolutionError } from "./errors.js";
 import { WgslGenerator } from "./tgsl/wgslGenerator.js";
+import { readFromArrayBuffer, writeToArrayBuffer } from "./data/dataIO.js";
+import { patchArrayBuffer } from "./data/partialIO.js";
 import { TgpuRenderPipelineDescriptor } from "./indexNamedExports.js";
 
 //#region src/index.d.ts
@@ -68,4 +70,4 @@ declare const tgpu: {
   '~unstable': typeof tgpuUnstable_d_exports;
 };
 //#endregion
-export { AutoFragmentIn, AutoFragmentOut, _AutoVertexIn as AutoVertexIn, AutoVertexOut, BindLayoutEntry, ColorAttachment, Configurable, Eventual, ExtractBindGroupInputFromLayout, INTERNAL_GlobalExt, IndexFlag, InitFromDeviceOptions, InitOptions, LayoutEntryToInput, MissingBindGroupsError, MissingLinksError, MissingSlotValueError, MissingVertexBuffersError, Namespace, NotUniformError, RawCodeSnippetOrigin, RenderFlag, ResolutionError, SampledFlag, ShaderGenerator, Storage, StorageFlag, TextureProps, TgpuAccessor, TgpuBindGroup, TgpuBindGroupLayout, TgpuBuffer, TgpuBufferMutable, TgpuBufferReadonly, TgpuBufferUniform, TgpuComparisonSampler, TgpuComptime, TgpuComputeFn, TgpuComputeFnShell, TgpuComputePipeline, TgpuConst, TgpuDeclare, TgpuFixedComparisonSampler, TgpuFixedSampler, TgpuFn, TgpuFnShell, TgpuFragmentFn, TgpuFragmentFnShell, TgpuGenericFn, TgpuGuardedComputePipeline, TgpuLayoutComparisonSampler, TgpuLayoutEntry, TgpuLayoutExternalTexture, TgpuLayoutSampler, TgpuLayoutStorage, TgpuLayoutTexture, TgpuLayoutUniform, TgpuLazy, TgpuMutable, TgpuMutableAccessor, TgpuPrimitiveState, TgpuQuerySet, TgpuRawCodeSnippet, TgpuReadonly, TgpuRenderPipeline, TgpuRenderPipelineDescriptor, TgpuRoot, TgpuSampler, TgpuSlot, TgpuTexture, TgpuTextureView, TgpuUniform, TgpuVar, TgpuVertexFn, TgpuVertexFnShell, TgpuVertexLayout, Uniform, UniformFlag, ValidUsagesFor, ValidateBufferSchema, ValidateStorageSchema, ValidateUniformSchema, VariableScope, Vertex, VertexFlag, WgslGenerator, WithBinding, WithCompute, WithFragment, WithVertex, Withable, index_d_exports as common, index_d_exports$1 as d, tgpu as default, tgpu, isAccessor, isBuffer, isBufferShorthand, isComparisonSampler, isLazy, isMutableAccessor, isSampler, isSlot, isTexture, isTgpuComputeFn, isTgpuFn, isTgpuFragmentFn, isTgpuVertexFn, isUsableAsRender, isUsableAsSampled, isUsableAsStorage, isUsableAsUniform, isUsableAsVertex, isVariable, index_d_exports$2 as std };
+export { AutoFragmentIn, AutoFragmentOut, _AutoVertexIn as AutoVertexIn, AutoVertexOut, BindLayoutEntry, ColorAttachment, Configurable, Eventual, ExtractBindGroupInputFromLayout, INTERNAL_GlobalExt, IndexFlag, InitFromDeviceOptions, InitOptions, LayoutEntryToInput, MissingBindGroupsError, MissingLinksError, MissingSlotValueError, MissingVertexBuffersError, Namespace, NotUniformError, RawCodeSnippetOrigin, RenderFlag, ResolutionError, SampledFlag, ShaderGenerator, Storage, StorageFlag, TextureProps, TgpuAccessor, TgpuBindGroup, TgpuBindGroupLayout, TgpuBuffer, TgpuBufferMutable, TgpuBufferReadonly, TgpuBufferUniform, TgpuComparisonSampler, TgpuComptime, TgpuComputeFn, TgpuComputeFnShell, TgpuComputePipeline, TgpuConst, TgpuDeclare, TgpuFixedComparisonSampler, TgpuFixedSampler, TgpuFn, TgpuFnShell, TgpuFragmentFn, TgpuFragmentFnShell, TgpuGenericFn, TgpuGuardedComputePipeline, TgpuLayoutComparisonSampler, TgpuLayoutEntry, TgpuLayoutExternalTexture, TgpuLayoutSampler, TgpuLayoutStorage, TgpuLayoutTexture, TgpuLayoutUniform, TgpuLazy, TgpuMutable, TgpuMutableAccessor, TgpuPrimitiveState, TgpuQuerySet, TgpuRawCodeSnippet, TgpuReadonly, TgpuRenderPipeline, TgpuRenderPipelineDescriptor, TgpuRoot, TgpuSampler, TgpuSlot, TgpuTexture, TgpuTextureView, TgpuUniform, TgpuVar, TgpuVertexFn, TgpuVertexFnShell, TgpuVertexLayout, Uniform, UniformFlag, ValidUsagesFor, ValidateBufferSchema, ValidateStorageSchema, ValidateUniformSchema, VariableScope, Vertex, VertexFlag, WgslGenerator, WithBinding, WithCompute, WithFragment, WithVertex, Withable, index_d_exports as common, index_d_exports$1 as d, tgpu as default, tgpu, isAccessor, isBuffer, isBufferShorthand, isComparisonSampler, isLazy, isMutableAccessor, isSampler, isSlot, isTexture, isTgpuComputeFn, isTgpuFn, isTgpuFragmentFn, isTgpuVertexFn, isUsableAsRender, isUsableAsSampled, isUsableAsStorage, isUsableAsUniform, isUsableAsVertex, isVariable, patchArrayBuffer, readFromArrayBuffer, index_d_exports$2 as std, writeToArrayBuffer };

package/index.js

@@ -2,6 +2,8 @@ import { MissingBindGroupsError, MissingLinksError, MissingSlotValueError, Missi
 import { isAccessor, isLazy, isMutableAccessor, isSlot } from "./core/slot/slotTypes.js";
 import { shaderGenerator_members_exports } from "./tgsl/shaderGenerator_members.js";
 import { isTgpuFn } from "./core/function/tgpuFn.js";
+import { readFromArrayBuffer, writeToArrayBuffer } from "./data/dataIO.js";
+import { patchArrayBuffer } from "./data/partialIO.js";
 import { isUsableAsStorage } from "./extension.js";
 import { isUsableAsUniform } from "./core/buffer/bufferUsage.js";
 import { isBuffer, isUsableAsVertex } from "./core/buffer/buffer.js";
@@ -23,4 +25,4 @@ import { common_exports } from "./common/index.js";
 var src_default = tgpu_exports;
 
 //#endregion
-export { MissingBindGroupsError, MissingLinksError, MissingSlotValueError, MissingVertexBuffersError, NotUniformError, ResolutionError, shaderGenerator_members_exports as ShaderGenerator, WgslGenerator, common_exports as common, data_exports as d, src_default as default, isAccessor, isBuffer, isBufferShorthand, isComparisonSampler, isLazy, isMutableAccessor, isSampler, isSlot, isTexture, isTgpuComputeFn, isTgpuFn, isTgpuFragmentFn, isTgpuVertexFn, isUsableAsRender, isUsableAsSampled, isUsableAsStorage, isUsableAsUniform, isUsableAsVertex, isVariable, std_exports as std, tgpu_exports as tgpu };
+export { MissingBindGroupsError, MissingLinksError, MissingSlotValueError, MissingVertexBuffersError, NotUniformError, ResolutionError, shaderGenerator_members_exports as ShaderGenerator, WgslGenerator, common_exports as common, data_exports as d, src_default as default, isAccessor, isBuffer, isBufferShorthand, isComparisonSampler, isLazy, isMutableAccessor, isSampler, isSlot, isTexture, isTgpuComputeFn, isTgpuFn, isTgpuFragmentFn, isTgpuVertexFn, isUsableAsRender, isUsableAsSampled, isUsableAsStorage, isUsableAsUniform, isUsableAsVertex, isVariable, patchArrayBuffer, readFromArrayBuffer, std_exports as std, tgpu_exports as tgpu, writeToArrayBuffer };

package/indexNamedExports.d.ts

@@ -32,6 +32,8 @@ import { index_d_exports as index_d_exports$1 } from "./std/index.js";
 import { index_d_exports as index_d_exports$2 } from "./common/index.js";
 import { MissingBindGroupsError, MissingLinksError, MissingSlotValueError, MissingVertexBuffersError, NotUniformError, ResolutionError } from "./errors.js";
 import { WgslGenerator } from "./tgsl/wgslGenerator.js";
+import { readFromArrayBuffer, writeToArrayBuffer } from "./data/dataIO.js";
+import { patchArrayBuffer } from "./data/partialIO.js";
 
 //#region src/indexNamedExports.d.ts
 

package/{nameRegistry.js → nameUtils.js}

@@ -1,6 +1,4 @@
-import { invariant } from "./errors.js";
-
-//#region src/nameRegistry.ts
+//#region src/nameUtils.ts
 const bannedTokens = new Set([
 	"alias",
 	"break",
@@ -344,106 +342,64 @@ const builtins = new Set([
 	"quadSwapX",
 	"quadSwapY"
 ]);
+/* @__NO_SIDE_EFFECTS__ */
 function sanitizePrimer(primer) {
-	if (primer) return primer.replaceAll(/\s/g, "_").replaceAll(/[^\w\d]/g, "");
+	if (primer) {
+		const base = primer.replaceAll(/\s/g, "_").replaceAll(/[^\w\d]/g, "");
+		if (base === "_" || base === "" || base.startsWith("__")) return "item";
+		return base;
+	}
 	return "item";
 }
 /**
 * A function for checking whether an identifier needs renaming.
 * Throws if provided with an invalid identifier that cannot be easily renamed.
 * @example
-* isValidIdentifier("ident"); // true
-* isValidIdentifier("struct"); // false
-* isValidIdentifier("struct_1"); // false
-* isValidIdentifier("_"); // ERROR
-* isValidIdentifier("my variable"); // ERROR
+* validateIdentifier("ident"); // { success: true }
+* validateIdentifier("struct"); // { success: false, error: "Identifiers cannot start with reserved keywords." }
+* validateIdentifier("struct_1"); { success: false, error: "Identifiers cannot start with reserved keywords." }
+* validateIdentifier("_"); // { success: false }
+* validateIdentifier("my variable"); // { success: false, error: "Identifiers cannot contain whitespace." }
 */
-function isValidIdentifier(ident) {
-	if (ident === "_" || ident.startsWith("__") || /\s/.test(ident)) throw new Error(`Invalid identifier '${ident}'. Choose an identifier without whitespaces or leading underscores.`);
+/* @__NO_SIDE_EFFECTS__ */
+function validateIdentifier(ident) {
+	if (ident === "_") return { success: false };
+	if (/\s/.test(ident)) return {
+		success: false,
+		error: `Identifiers cannot contain whitespace.`
+	};
+	if (ident.startsWith("__")) return {
+		success: false,
+		error: `Identifiers cannot start with double underscores.`
+	};
 	const prefix = ident.split("_")[0];
-	return !bannedTokens.has(prefix) && !builtins.has(prefix);
+	if (bannedTokens.has(prefix) || builtins.has(prefix)) return {
+		success: false,
+		error: `Identifiers cannot start with reserved keywords.`
+	};
+	return { success: true };
 }
 /**
-* Same as `isValidIdentifier`, except does not check for builtin clashes.
+* Same as `validateIdentifier`, except does not check for builtin clashes.
 */
-function isValidProp(ident) {
-	if (ident === "_" || ident.startsWith("__") || /\s/.test(ident)) throw new Error(`Invalid identifier '${ident}'. Choose an identifier without whitespaces or leading underscores.`);
+/* @__NO_SIDE_EFFECTS__ */
+function validateProp(ident) {
+	if (ident === "_") return { success: false };
+	if (/\s/.test(ident)) return {
+		success: false,
+		error: `Identifiers cannot contain whitespace.`
+	};
+	if (ident.startsWith("__")) return {
+		success: false,
+		error: `Identifiers cannot start with double underscores.`
+	};
 	const prefix = ident.split("_")[0];
-	return !bannedTokens.has(prefix);
+	if (bannedTokens.has(prefix)) return {
+		success: false,
+		error: `Identifiers cannot start with reserved keywords.`
+	};
+	return { success: true };
 }
-var NameRegistryImpl = class {
-	#usedNames;
-	#scopeStack;
-	constructor() {
-		this.#usedNames = new Set([...bannedTokens, ...builtins]);
-		this.#scopeStack = [];
-	}
-	get #usedBlockScopeNames() {
-		return this.#scopeStack[this.#scopeStack.length - 1]?.usedBlockScopeNames;
-	}
-	makeUnique(primer, global) {
-		const sanitizedPrimer = sanitizePrimer(primer);
-		const name = this.getUniqueVariant(sanitizedPrimer);
-		if (global) this.#usedNames.add(name);
-		else this.#usedBlockScopeNames?.add(name);
-		return name;
-	}
-	#isUsedInBlocksBefore(name) {
-		const functionScopeIndex = this.#scopeStack.findLastIndex((scope) => scope.type === "functionScope");
-		return this.#scopeStack.slice(functionScopeIndex + 1).some((scope) => scope.usedBlockScopeNames.has(name));
-	}
-	makeValid(primer) {
-		if (isValidIdentifier(primer) && !this.#usedNames.has(primer) && !this.#isUsedInBlocksBefore(primer)) {
-			this.#usedBlockScopeNames?.add(primer);
-			return primer;
-		}
-		return this.makeUnique(primer, false);
-	}
-	isUsed(name) {
-		return this.#usedNames.has(name) || this.#isUsedInBlocksBefore(name);
-	}
-	pushFunctionScope() {
-		this.#scopeStack.push({ type: "functionScope" });
-		this.#scopeStack.push({
-			type: "blockScope",
-			usedBlockScopeNames: /* @__PURE__ */ new Set()
-		});
-	}
-	popFunctionScope() {
-		const functionScopeIndex = this.#scopeStack.findLastIndex((scope) => scope.type === "functionScope");
-		if (functionScopeIndex === -1) throw new Error("Tried to pop function scope when no scope was present.");
-		this.#scopeStack.splice(functionScopeIndex);
-	}
-	pushBlockScope() {
-		this.#scopeStack.push({
-			type: "blockScope",
-			usedBlockScopeNames: /* @__PURE__ */ new Set()
-		});
-	}
-	popBlockScope() {
-		invariant(this.#scopeStack[this.#scopeStack.length - 1]?.type === "blockScope", "Tried to pop block scope, but it is not present");
-		this.#scopeStack.pop();
-	}
-};
-var RandomNameRegistry = class extends NameRegistryImpl {
-	#lastUniqueId = 0;
-	getUniqueVariant(base) {
-		let name = `${base}_${this.#lastUniqueId++}`;
-		while (this.isUsed(name)) name = `${base}_${this.#lastUniqueId++}`;
-		return name;
-	}
-};
-var StrictNameRegistry = class extends NameRegistryImpl {
-	getUniqueVariant(base) {
-		let index = 0;
-		let name = base;
-		while (this.isUsed(name)) {
-			index++;
-			name = `${base}_${index}`;
-		}
-		return name;
-	}
-};
 
 //#endregion
-export { RandomNameRegistry, StrictNameRegistry, isValidProp };
+export { bannedTokens, builtins, sanitizePrimer, validateIdentifier, validateProp };

package/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.11.3";
+var version = "0.11.5";
 
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typegpu",
-  "version": "0.11.3",
+  "version": "0.11.5",
   "description": "A thin layer between JS and WebGPU/WGSL that improves development experience and allows for faster iteration.",
   "keywords": [
     "compute",