typegpu 0.9.0 → 0.10.0

package/fullScreenTriangle-MdLGaAMR.js

@@ -0,0 +1,543 @@
+import { $n as getMetaData, At as stitch, Bn as isNaturallyEphemeral, Cn as isDisarray, Dn as undecorate, Jn as isWgslData, Kt as isWgsl, Mt as getResolutionCtx, O as coerceToSnippet, Un as isVec, Vn as isPtr, Vt as getOwnSnippet, W as vec3f, Wt as isKnownAtComptime, Y as vec4f, Yn as isWgslStruct, _n as MatrixColumnsAccess, ar as $getNameForward, bt as derefSnippet, cr as $internal, dn as isEphemeralSnippet, er as getName, fr as $resolve, kn as Void, lr as $ownSnippet, mn as snip, nn as MissingLinksError, nr as isNamable, qn as isWgslArray, rr as setName, sr as $gpuValueOf, tr as hasTinyestMetadata, vn as UnknownData, wn as isLooseData, z as vec2f } from "./operators-HTxa_0k9.js";
+import { c as getAttributesString, o as createIoSchema, r as accessProp, t as builtin } from "./builtin-ClEnM-Ye.js";
+
+//#region src/getGPUValue.ts
+function getGPUValue(object) {
+	return object?.[$gpuValueOf];
+}
+
+//#endregion
+//#region src/tgsl/accessIndex.ts
+const indexableTypeToResult = {
+	mat2x2f: vec2f,
+	mat3x3f: vec3f,
+	mat4x4f: vec4f
+};
+function accessIndex(target, indexArg) {
+	const index = typeof indexArg === "number" ? coerceToSnippet(indexArg) : indexArg;
+	if (isWgslArray(target.dataType) || isDisarray(target.dataType)) {
+		const elementType = target.dataType.elementType;
+		const isElementNatEph = isNaturallyEphemeral(elementType);
+		const isTargetEphemeral = isEphemeralSnippet(target);
+		const isIndexConstant = index.origin === "constant";
+		let origin;
+		if (target.origin === "constant-tgpu-const-ref") if (isIndexConstant) origin = isElementNatEph ? "constant" : "constant-tgpu-const-ref";
+		else origin = isElementNatEph ? "runtime" : "runtime-tgpu-const-ref";
+		else if (target.origin === "runtime-tgpu-const-ref") origin = isElementNatEph ? "runtime" : "runtime-tgpu-const-ref";
+		else if (!isTargetEphemeral && !isElementNatEph) origin = target.origin;
+		else if (isIndexConstant && target.origin === "constant") origin = "constant";
+		else origin = "runtime";
+		return snip(isKnownAtComptime(target) && isKnownAtComptime(index) ? target.value[index.value] : stitch`${target}[${index}]`, elementType, origin);
+	}
+	if (isVec(target.dataType)) return snip(isKnownAtComptime(target) && isKnownAtComptime(index) ? target.value[index.value] : stitch`${target}[${index}]`, target.dataType.primitive, target.origin === "constant" || target.origin === "constant-tgpu-const-ref" ? "constant" : "runtime");
+	if (isPtr(target.dataType)) return accessIndex(derefSnippet(target), index);
+	if (target.value instanceof MatrixColumnsAccess) {
+		const propType = indexableTypeToResult[target.value.matrix.dataType.type];
+		return snip(stitch`${target.value.matrix}[${index}]`, propType, target.origin);
+	}
+	if (target.dataType.type in indexableTypeToResult) throw new Error("The only way of accessing matrix elements in TypeGPU functions is through the 'columns' property.");
+	if (isKnownAtComptime(target) && isKnownAtComptime(index) || target.dataType === UnknownData) return coerceToSnippet(target.value[index.value]);
+	if (isWgslStruct(target.dataType) && isKnownAtComptime(index) && typeof index.value === "string") return accessProp(target, index.value);
+}
+
+//#endregion
+//#region src/core/valueProxyUtils.ts
+const valueProxyHandler = { get(target, prop) {
+	if (prop in target) return Reflect.get(target, prop);
+	if (prop === "toString" || prop === Symbol.toStringTag || prop === Symbol.toPrimitive) return () => target.toString();
+	if (typeof prop === "symbol") return;
+	const targetSnippet = getOwnSnippet(target);
+	const index = Number(prop);
+	if (!Number.isNaN(index)) {
+		const accessed = accessIndex(targetSnippet, index);
+		if (!accessed) return;
+		return new Proxy({
+			[$internal]: true,
+			[$resolve]: (ctx) => ctx.resolve(accessed.value, accessed.dataType),
+			[$ownSnippet]: accessed,
+			toString: () => `${String(target)}[${prop}]`
+		}, valueProxyHandler);
+	}
+	const accessed = accessProp(targetSnippet, String(prop));
+	if (!accessed) return;
+	return new Proxy({
+		[$internal]: true,
+		[$resolve]: (ctx) => ctx.resolve(accessed.value, accessed.dataType),
+		[$ownSnippet]: accessed,
+		toString: () => `${String(target)}.${prop}`
+	}, valueProxyHandler);
+} };
+function getGpuValueRecursively(value) {
+	let unwrapped = value;
+	while (true) {
+		const gpuValue = getGPUValue(unwrapped);
+		if (!gpuValue) break;
+		unwrapped = gpuValue;
+	}
+	return unwrapped;
+}
+
+//#endregion
+//#region src/core/resolve/externals.ts
+/**
+* Merges two external maps into one. If a key is present in both maps, the value from the new map is used.
+* If the external value is a namable object, it is given a name if it does not already have one.
+* @param existing - The existing external map.
+* @param newExternals - The new external map.
+*/
+function applyExternals(existing, newExternals) {
+	for (const [key, value] of Object.entries(newExternals)) {
+		existing[key] = value;
+		if (value && (typeof value === "object" || typeof value === "function") && getName(value) === void 0) setName(value, key);
+	}
+}
+function addArgTypesToExternals(implementation, argTypes, applyExternals) {
+	const argTypeNames = [...implementation.matchAll(/:\s*(?<arg>.*?)\s*[,)]/g)].map((found) => found ? found[1] : void 0);
+	applyExternals(Object.fromEntries(argTypes.flatMap((argType, i) => {
+		const argTypeName = argTypeNames ? argTypeNames[i] : void 0;
+		return isWgslStruct(argType) && argTypeName !== void 0 ? [[argTypeName, argType]] : [];
+	})));
+}
+function addReturnTypeToExternals(implementation, returnType, applyExternals) {
+	const matched = implementation.match(/->\s(?<output>[\w\d_]+)\s{/);
+	const outputName = matched ? matched[1]?.trim() : void 0;
+	if (isWgslStruct(returnType) && outputName && !/\s/g.test(outputName)) applyExternals({ [outputName]: returnType });
+}
+function identifierRegex(name) {
+	return new RegExp(`(?<![\\w\\$_.])${name.replaceAll(".", "\\.").replaceAll("$", "\\$")}(?![\\w\\$_])`, "g");
+}
+/**
+* Replaces all occurrences of external names in WGSL code with their resolved values.
+* It adds all necessary definitions to the resolution context.
+* @param ctx - The resolution context.
+* @param externalMap - The external map.
+* @param wgsl - The WGSL code.
+*
+* @returns The WGSL code with all external names replaced with their resolved values.
+*/
+function replaceExternalsInWgsl(ctx, externalMap, wgsl) {
+	return Object.entries(externalMap).reduce((acc, [externalName, external]) => {
+		const externalRegex = identifierRegex(externalName);
+		if (wgsl && externalName !== "Out" && externalName !== "In" && !externalRegex.test(wgsl)) console.warn(`The external '${externalName}' wasn't used in the resolved template.`);
+		if (isWgsl(external) || isLooseData(external) || hasTinyestMetadata(external)) return acc.replaceAll(externalRegex, ctx.resolve(external).value);
+		if (external !== null && typeof external === "object") {
+			const foundProperties = [...wgsl.matchAll(new RegExp(`${externalName.replaceAll(".", "\\.").replaceAll("$", "\\$")}\\.(?<prop>.*?)(?![\\w\\$_])`, "g"))].map((found) => found[1]);
+			return [...new Set(foundProperties)].reduce((innerAcc, prop) => prop && prop in external ? replaceExternalsInWgsl(ctx, { [`${externalName}.${prop}`]: external[prop] }, innerAcc) : innerAcc, acc);
+		}
+		console.warn(`During resolution, the external '${externalName}' has been omitted. Only TGPU resources, 'use gpu' functions, primitives, and plain JS objects can be used as externals.`);
+		return acc;
+	}, wgsl);
+}
+
+//#endregion
+//#region src/core/function/extractArgs.ts
+/**
+* Extracts info about arguments of a given WGSL function string.
+* @example
+* const code = `
+*   fn add(a: i32, ＠location(0) b: i32, c) -> i32 {
+*     return a + b + c;
+*   }`;
+*
+* extractArgs(code);
+* // {
+* //   args: [
+* //     { identifier: 'a', attributes: [], type: 'i32' },
+* //     { identifier: 'b', attributes: ['＠location(0)'], type: 'i32' },
+* //     { identifier: 'c', attributes: [], type: undefined }
+* //   ],
+* //   ret: { type: 'i32', attributes: [] },
+* //   range: { begin: 11, end: 51 }
+* // }
+*/
+function extractArgs(rawCode) {
+	const { strippedCode, argRange: range } = strip(rawCode);
+	const code = new ParsableString(strippedCode);
+	code.consume("(");
+	const args = [];
+	while (!code.isAt(")")) {
+		const attributes = [];
+		while (code.isAt("@")) {
+			code.parseUntil(closingParenthesis, parentheses);
+			code.consume(")");
+			attributes.push(code.lastParsed);
+		}
+		code.parseUntil(identifierEndSymbols);
+		const identifier = code.lastParsed;
+		let maybeType;
+		if (code.isAt(":")) {
+			code.consume(":");
+			code.parseUntil(typeEndSymbols, angleBrackets);
+			maybeType = code.lastParsed;
+		}
+		args.push({
+			identifier,
+			attributes,
+			type: maybeType
+		});
+		if (code.isAt(",")) code.consume(",");
+	}
+	code.consume(")");
+	let maybeRet;
+	if (code.isAt("->")) {
+		code.consume("->");
+		const attributes = [];
+		while (code.isAt("@")) {
+			code.parseUntil(closingParenthesis, parentheses);
+			code.consume(")");
+			attributes.push(code.lastParsed);
+		}
+		maybeRet = {
+			type: code.str.slice(code.pos),
+			attributes
+		};
+	}
+	return {
+		args,
+		ret: maybeRet,
+		range: {
+			begin: range[0],
+			end: range[1]
+		}
+	};
+}
+/**
+* Strips comments, whitespaces, the name and the body of the function.
+* @example
+* const code = `
+*    fn add( a,  // first argument
+*            ＠location(0) b : i32 ) -> i32   {
+*        return a + b; // returns the sum
+*  }`;
+*
+* strip(code); // "(a,@location(0)b:i32)->i32"
+*/
+function strip(rawCode) {
+	const code = new ParsableString(rawCode);
+	let strippedCode = "";
+	let argsStart;
+	while (!code.isFinished()) {
+		if (code.isAt(blankSpaces)) {
+			code.advanceBy(1);
+			continue;
+		}
+		if (code.isAt("//")) {
+			code.consume("//");
+			code.parseUntil(lineBreaks);
+			code.advanceBy(1);
+			continue;
+		}
+		if (code.isAt("/*")) {
+			code.parseUntil(openingCommentBlock, commentBlocks);
+			code.consume("*/");
+			continue;
+		}
+		if (code.isAt("{")) return {
+			strippedCode,
+			argRange: [argsStart, code.pos]
+		};
+		if (code.isAt("(") && argsStart === void 0) argsStart = code.pos;
+		if (argsStart !== void 0) strippedCode += code.str[code.pos];
+		code.advanceBy(1);
+	}
+	throw new Error("Invalid wgsl code!");
+}
+var ParsableString = class {
+	#parseStartPos;
+	#pos;
+	constructor(str) {
+		this.str = str;
+		this.#pos = 0;
+	}
+	get pos() {
+		return this.#pos;
+	}
+	/**
+	* This property is equivalent to the substring of `this.str`
+	* from the position of the last `parseUntil` call, to the current position.
+	*/
+	get lastParsed() {
+		if (this.#parseStartPos === void 0) throw new Error("Parse was not called yet!");
+		return this.str.slice(this.#parseStartPos, this.pos);
+	}
+	isFinished() {
+		return this.#pos >= this.str.length;
+	}
+	isAt(substr) {
+		if (typeof substr === "string") {
+			for (let i = 0; i < substr.length; i++) if (this.str[this.#pos + i] !== substr[i]) return false;
+			return true;
+		}
+		for (const elem of substr) if (this.isAt(elem)) return true;
+		return false;
+	}
+	/**
+	* @param toFind a set of strings either of which satisfy the search.
+	* @param brackets a pair of brackets that has to be closed for result to be valid. This includes the found character(s).
+	* @example
+	* // internal state:
+	* // '(@attribute(0) identifier: type)'
+	* //   ^
+	* this.parse(new Set(')'), ['(', ')']);
+	* // internal state:
+	* // '(@attribute(0) identifier: type)'
+	* //               ^
+	*/
+	parseUntil(toFind, brackets) {
+		this.#parseStartPos = this.#pos;
+		let openedBrackets = 0;
+		while (this.#pos < this.str.length) {
+			if (brackets && this.isAt(brackets[0])) openedBrackets += 1;
+			if (brackets && this.isAt(brackets[1])) openedBrackets -= 1;
+			if (openedBrackets === 0) {
+				if (this.isAt(toFind)) return this.#pos;
+			}
+			this.#pos += 1;
+		}
+		throw new Error("Reached the end of the string without finding a match!");
+	}
+	advanceBy(steps) {
+		this.#pos += steps;
+	}
+	consume(str) {
+		if (!this.isAt(str)) throw new Error(`Expected '${str}' at position ${this.#pos}, but found '${this.str.slice(this.#pos, this.#pos + str.length)}'`);
+		this.advanceBy(str.length);
+	}
+};
+const lineBreaks = new Set([
+	"\n",
+	"\v",
+	"\f",
+	"\r",
+	"…",
+	"\u2028",
+	"\u2029"
+]);
+const blankSpaces = new Set([
+	...lineBreaks,
+	" ",
+	"	",
+	"‎",
+	"‏"
+]);
+const closingParenthesis = new Set([")"]);
+const identifierEndSymbols = new Set([
+	":",
+	",",
+	")"
+]);
+const typeEndSymbols = new Set([",", ")"]);
+const openingCommentBlock = new Set(["*/"]);
+const parentheses = ["(", ")"];
+const angleBrackets = ["<", ">"];
+const commentBlocks = ["/*", "*/"];
+
+//#endregion
+//#region src/core/function/fnCore.ts
+function createFnCore(implementation, fnAttribute = "") {
+	/**
+	* External application has to be deferred until resolution because
+	* some externals can reference the owner function which has not been
+	* initialized yet (like when accessing the Output struct of a vertex
+	* entry fn).
+	*/
+	const externalsToApply = [];
+	return {
+		[$getNameForward]: typeof implementation === "function" ? implementation : void 0,
+		applyExternals(newExternals) {
+			externalsToApply.push(newExternals);
+		},
+		resolve(ctx, argTypes, returnType) {
+			const externalMap = {};
+			for (const externals of externalsToApply) applyExternals(externalMap, externals);
+			const id = ctx.getUniqueName(this);
+			if (typeof implementation === "string") {
+				if (!returnType) throw new Error("Explicit return type is required for string implementation");
+				const replacedImpl = replaceExternalsInWgsl(ctx, externalMap, implementation);
+				let header = "";
+				let body = "";
+				if (fnAttribute !== "") {
+					const input = isWgslStruct(argTypes[0]) ? `(in: ${ctx.resolve(argTypes[0]).value})` : "()";
+					const attributes = isWgslData(returnType) ? getAttributesString(returnType) : "";
+					header = `${input} ${returnType !== Void ? isWgslStruct(returnType) ? `-> ${ctx.resolve(returnType).value}` : `-> ${attributes !== "" ? attributes : "@location(0)"} ${ctx.resolve(returnType).value}` : ""} `;
+					body = replacedImpl;
+				} else {
+					const providedArgs = extractArgs(replacedImpl);
+					if (providedArgs.args.length !== argTypes.length) throw new Error(`WGSL implementation has ${providedArgs.args.length} arguments, while the shell has ${argTypes.length} arguments.`);
+					header = `(${providedArgs.args.map((argInfo, i) => `${argInfo.identifier}: ${checkAndReturnType(ctx, `parameter ${argInfo.identifier}`, argInfo.type, argTypes[i])}`).join(", ")}) ${returnType === Void ? "" : `-> ${checkAndReturnType(ctx, "return type", providedArgs.ret?.type, returnType)}`}`;
+					body = replacedImpl.slice(providedArgs.range.end);
+				}
+				ctx.addDeclaration(`${fnAttribute}fn ${id}${header}${body}`);
+				return snip(id, returnType, "runtime");
+			}
+			const pluginData = getMetaData(implementation);
+			const pluginExternals = typeof pluginData?.externals === "function" ? pluginData.externals() : 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" && fnAttribute !== "") applyExternals(externalMap, { [maybeSecondArg.name]: undecorate(returnType) });
+			const { head, body, returnType: actualReturnType } = ctx.fnToWgsl({
+				functionType: fnAttribute.includes("@compute") ? "compute" : fnAttribute.includes("@vertex") ? "vertex" : fnAttribute.includes("@fragment") ? "fragment" : "normal",
+				argTypes,
+				params: ast.params,
+				returnType,
+				body: ast.body,
+				externalMap
+			});
+			ctx.addDeclaration(`${fnAttribute}fn ${id}${ctx.resolve(head).value}${ctx.resolve(body).value}`);
+			return snip(id, actualReturnType, "runtime");
+		}
+	};
+}
+function checkAndReturnType(ctx, name, wgslType, jsType) {
+	const resolvedJsType = ctx.resolve(jsType).value.replace(/\s/g, "");
+	if (!wgslType) return resolvedJsType;
+	const resolvedWgslType = wgslType.replace(/\s/g, "");
+	if (resolvedWgslType !== resolvedJsType) throw new Error(`Type mismatch between TGPU shell and WGSL code string: ${name}, JS type "${resolvedJsType}", WGSL type "${resolvedWgslType}".`);
+	return wgslType;
+}
+
+//#endregion
+//#region src/core/function/templateUtils.ts
+function stripTemplate(arg, ...values) {
+	return isTemplateStringsArray(arg) ? templateLiteralIdentity(arg, ...values) : arg;
+}
+function isTemplateStringsArray(value) {
+	return Array.isArray(value) && "raw" in value && Array.isArray(value.raw) && value.raw.every((item) => typeof item === "string");
+}
+function templateLiteralIdentity(strings, ...values) {
+	return strings.slice(1).reduce((acc, elem, index) => `${acc}${values[index]}${elem}`, strings[0]);
+}
+
+//#endregion
+//#region src/core/slot/slot.ts
+function slot(defaultValue) {
+	return new TgpuSlotImpl(defaultValue);
+}
+var TgpuSlotImpl = class {
+	[$internal] = true;
+	resourceType = "slot";
+	constructor(defaultValue = void 0) {
+		this.defaultValue = defaultValue;
+	}
+	$name(label) {
+		setName(this, label);
+		return this;
+	}
+	areEqual(a, b) {
+		return Object.is(a, b);
+	}
+	toString() {
+		return `slot:${getName(this) ?? "<unnamed>"}`;
+	}
+	get [$gpuValueOf]() {
+		const ctx = getResolutionCtx();
+		if (!ctx) throw new Error(`Cannot access tgpu.slot's value outside of resolution.`);
+		return getGpuValueRecursively(ctx.unwrap(this));
+	}
+	get value() {
+		return this[$gpuValueOf];
+	}
+	get $() {
+		return this.value;
+	}
+};
+
+//#endregion
+//#region src/core/slot/internalSlots.ts
+const shaderStageSlot = slot(void 0);
+
+//#endregion
+//#region src/core/function/tgpuVertexFn.ts
+/**
+* Creates a shell of a typed entry function for the vertex shader stage. Any function
+* that implements this shell can run for each vertex, allowing the inner code to process
+* attributes and determine the final position of the vertex.
+*
+* @param options.in
+*   Vertex attributes and builtins to be made available to functions that implement this shell.
+* @param options.out
+*   A record containing the final position of the vertex, and any information
+*   passed onto the fragment shader stage.
+*/
+function vertexFn(options) {
+	if (Object.keys(options.out).length === 0) throw new Error(`A vertexFn output cannot be empty since it must include the 'position' builtin.`);
+	const shell = {
+		in: options.in,
+		out: options.out,
+		argTypes: options.in && Object.keys(options.in).length !== 0 ? [createIoSchema(options.in)] : [],
+		entryPoint: "vertex"
+	};
+	const call = (arg, ...values) => createVertexFn(shell, stripTemplate(arg, ...values));
+	return Object.assign(call, shell);
+}
+function isTgpuVertexFn(value) {
+	return value?.shell?.entryPoint === "vertex";
+}
+function createVertexFn(shell, implementation) {
+	const core = createFnCore(implementation, "@vertex ");
+	const inputType = shell.argTypes[0];
+	return {
+		shell,
+		$uses(newExternals) {
+			core.applyExternals(newExternals);
+			return this;
+		},
+		[$internal]: true,
+		[$getNameForward]: core,
+		$name(newLabel) {
+			setName(this, newLabel);
+			if (isNamable(inputType)) inputType.$name(`${newLabel}_Input`);
+			return this;
+		},
+		[$resolve](ctx) {
+			const outputWithLocation = createIoSchema(shell.out, ctx.varyingLocations).$name(`${getName(this) ?? ""}_Output`);
+			if (typeof implementation === "string") {
+				if (inputType) core.applyExternals({ In: inputType });
+				core.applyExternals({ Out: outputWithLocation });
+			}
+			return ctx.withSlots([[shaderStageSlot, "vertex"]], () => core.resolve(ctx, shell.argTypes, outputWithLocation));
+		},
+		toString() {
+			return `vertexFn:${getName(core) ?? "<unnamed>"}`;
+		}
+	};
+}
+
+//#endregion
+//#region src/common/fullScreenTriangle.ts
+/**
+* A vertex function that defines a single full-screen triangle out
+* of three points.
+*
+* @example
+* ```ts
+* import { common } from 'typegpu';
+*
+* const pipeline = root.createRenderPipeline({
+*   vertex: common.fullScreenTriangle,
+*   fragment: yourFragmentShader,
+* });
+*
+* pipeline.draw(3);
+* ```
+*/
+const fullScreenTriangle = vertexFn({
+	in: { vertexIndex: builtin.vertexIndex },
+	out: {
+		pos: builtin.position,
+		uv: vec2f
+	}
+})`{
+  const pos = array<vec2f, 3>(vec2f(-1, -1), vec2f(3, -1), vec2f(-1, 3));
+  const uv = array<vec2f, 3>(vec2f(0, 1), vec2f(2, 1), vec2f(0, -1));
+
+  return Out(vec4f(pos[in.vertexIndex], 0, 1), uv[in.vertexIndex]);
+}`;
+
+//#endregion
+export { slot as a, addArgTypesToExternals as c, replaceExternalsInWgsl as d, getGpuValueRecursively as f, shaderStageSlot as i, addReturnTypeToExternals as l, accessIndex as m, isTgpuVertexFn as n, stripTemplate as o, valueProxyHandler as p, vertexFn as r, createFnCore as s, fullScreenTriangle as t, applyExternals as u };
+//# sourceMappingURL=fullScreenTriangle-MdLGaAMR.js.map

package/fullScreenTriangle-MdLGaAMR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullScreenTriangle-MdLGaAMR.js","names":["#pos","#parseStartPos"],"sources":["../src/getGPUValue.ts","../src/tgsl/accessIndex.ts","../src/core/valueProxyUtils.ts","../src/core/resolve/externals.ts","../src/core/function/extractArgs.ts","../src/core/function/fnCore.ts","../src/core/function/templateUtils.ts","../src/core/slot/slot.ts","../src/core/slot/internalSlots.ts","../src/core/function/tgpuVertexFn.ts","../src/common/fullScreenTriangle.ts"],"sourcesContent":["import { $gpuValueOf } from './shared/symbols.ts';\nimport type { WithGPUValue } from './types.ts';\n\nexport function getGPUValue(\n  object: unknown,\n): unknown {\n  return (object as WithGPUValue<unknown>)?.[$gpuValueOf];\n}\n","import { stitch } from '../core/resolve/stitch.ts';\nimport {\n  isDisarray,\n  MatrixColumnsAccess,\n  UnknownData,\n} from '../data/dataTypes.ts';\nimport { derefSnippet } from '../data/ref.ts';\nimport {\n  isEphemeralSnippet,\n  type Origin,\n  snip,\n  type Snippet,\n} from '../data/snippet.ts';\nimport { vec2f, vec3f, vec4f } from '../data/vector.ts';\nimport {\n  type BaseData,\n  isNaturallyEphemeral,\n  isPtr,\n  isVec,\n  isWgslArray,\n  isWgslStruct,\n} from '../data/wgslTypes.ts';\nimport { isKnownAtComptime } from '../types.ts';\nimport { accessProp } from './accessProp.ts';\nimport { coerceToSnippet } from './generationHelpers.ts';\n\nconst indexableTypeToResult = {\n  mat2x2f: vec2f,\n  mat3x3f: vec3f,\n  mat4x4f: vec4f,\n} as const;\n\nexport function accessIndex(\n  target: Snippet,\n  indexArg: Snippet | number,\n): Snippet | undefined {\n  const index = typeof indexArg === 'number'\n    ? coerceToSnippet(indexArg)\n    : indexArg;\n\n  // array\n  if (isWgslArray(target.dataType) || isDisarray(target.dataType)) {\n    const elementType = target.dataType.elementType;\n    const isElementNatEph = isNaturallyEphemeral(elementType);\n    const isTargetEphemeral = isEphemeralSnippet(target);\n    const isIndexConstant = index.origin === 'constant';\n\n    let origin: Origin;\n\n    if (target.origin === 'constant-tgpu-const-ref') {\n      // Constant refs stay const unless the element/index forces runtime materialization\n      if (isIndexConstant) {\n        origin = isElementNatEph ? 'constant' : 'constant-tgpu-const-ref';\n      } else {\n        origin = isElementNatEph ? 'runtime' : 'runtime-tgpu-const-ref';\n      }\n    } else if (target.origin === 'runtime-tgpu-const-ref') {\n      // Runtime refs keep their ref semantics unless the element is ephemeral only\n      origin = isElementNatEph ? 'runtime' : 'runtime-tgpu-const-ref';\n    } else if (!isTargetEphemeral && !isElementNatEph) {\n      // Stable containers can forward their origin information\n      origin = target.origin;\n    } else if (isIndexConstant && target.origin === 'constant') {\n      // Plain constants indexed with constants stay constant\n      origin = 'constant';\n    } else {\n      // Everything else must be produced at runtime\n      origin = 'runtime';\n    }\n\n    return snip(\n      isKnownAtComptime(target) && isKnownAtComptime(index)\n        // oxlint-disable-next-line typescript/no-explicit-any it's fine, it's there\n        ? (target.value as any)[index.value as number]\n        : stitch`${target}[${index}]`,\n      elementType,\n      /* origin */ origin,\n    );\n  }\n\n  // vector\n  if (isVec(target.dataType)) {\n    return snip(\n      isKnownAtComptime(target) && isKnownAtComptime(index)\n        // oxlint-disable-next-line typescript/no-explicit-any it's fine, it's there\n        ? (target.value as any)[index.value as any]\n        : stitch`${target}[${index}]`,\n      target.dataType.primitive,\n      /* origin */ target.origin === 'constant' ||\n          target.origin === 'constant-tgpu-const-ref'\n        ? 'constant'\n        : 'runtime',\n    );\n  }\n\n  if (isPtr(target.dataType)) {\n    // Sometimes values that are typed as pointers aren't instances of `d.ref`, so we\n    // allow indexing as if it wasn't a pointer.\n    return accessIndex(derefSnippet(target), index);\n  }\n\n  // matrix.columns\n  if (target.value instanceof MatrixColumnsAccess) {\n    const propType = indexableTypeToResult[\n      (target.value.matrix.dataType as BaseData)\n        .type as keyof typeof indexableTypeToResult\n    ];\n\n    return snip(\n      stitch`${target.value.matrix}[${index}]`,\n      propType,\n      /* origin */ target.origin,\n    );\n  }\n\n  // matrix\n  if ((target.dataType as BaseData).type in indexableTypeToResult) {\n    throw new Error(\n      \"The only way of accessing matrix elements in TypeGPU functions is through the 'columns' property.\",\n    );\n  }\n\n  if (\n    (isKnownAtComptime(target) && isKnownAtComptime(index)) ||\n    target.dataType === UnknownData\n  ) {\n    // No idea what the type is, so we act on the snippet's value and try to guess\n    return coerceToSnippet(\n      // oxlint-disable-next-line typescript/no-explicit-any we're inspecting the value, and it could be any value\n      (target.value as any)[index.value as number],\n    );\n  }\n\n  if (\n    isWgslStruct(target.dataType) && isKnownAtComptime(index) &&\n    typeof index.value === 'string'\n  ) {\n    return accessProp(target, index.value);\n  }\n\n  return undefined;\n}\n","import type { Snippet } from '../data/snippet.ts';\nimport { getGPUValue } from '../getGPUValue.ts';\nimport { $internal, $ownSnippet, $resolve } from '../shared/symbols.ts';\nimport { accessIndex } from '../tgsl/accessIndex.ts';\nimport { accessProp } from '../tgsl/accessProp.ts';\nimport {\n  getOwnSnippet,\n  type SelfResolvable,\n  type WithOwnSnippet,\n} from '../types.ts';\n\nexport const valueProxyHandler: ProxyHandler<\n  SelfResolvable & WithOwnSnippet\n> = {\n  get(target, prop) {\n    if (prop in target) {\n      return Reflect.get(target, prop);\n    }\n\n    if (\n      prop === 'toString' ||\n      prop === Symbol.toStringTag ||\n      prop === Symbol.toPrimitive\n    ) {\n      return () => target.toString();\n    }\n\n    if (typeof prop === 'symbol') {\n      return undefined;\n    }\n\n    const targetSnippet = getOwnSnippet(target) as Snippet;\n\n    const index = Number(prop);\n    if (!Number.isNaN(index)) {\n      const accessed = accessIndex(targetSnippet, index);\n      if (!accessed) {\n        // Prop was not found, must be missing from this object\n        return undefined;\n      }\n\n      return new Proxy({\n        [$internal]: true,\n        [$resolve]: (ctx) => ctx.resolve(accessed.value, accessed.dataType),\n        [$ownSnippet]: accessed,\n        toString: () => `${String(target)}[${prop}]`,\n      }, valueProxyHandler);\n    }\n\n    const accessed = accessProp(targetSnippet, String(prop));\n    if (!accessed) {\n      // Prop was not found, must be missing from this object\n      return undefined;\n    }\n\n    return new Proxy({\n      [$internal]: true,\n      [$resolve]: (ctx) => ctx.resolve(accessed.value, accessed.dataType),\n      [$ownSnippet]: accessed,\n      toString: () => `${String(target)}.${prop}`,\n    }, valueProxyHandler);\n  },\n};\n\nexport function getGpuValueRecursively<T>(value: unknown): T {\n  let unwrapped = value;\n\n  while (true) {\n    const gpuValue = getGPUValue(unwrapped);\n    if (!gpuValue) {\n      break;\n    }\n    unwrapped = gpuValue;\n  }\n\n  return unwrapped as T;\n}\n","import { isLooseData } from '../../data/dataTypes.ts';\nimport { isWgslStruct } from '../../data/wgslTypes.ts';\nimport { getName, hasTinyestMetadata, setName } from '../../shared/meta.ts';\nimport { isWgsl, type ResolutionCtx } from '../../types.ts';\n\n/**\n * A key-value mapping where keys represent identifiers within shader code,\n * and values can be any type that can be resolved to a code string.\n */\nexport type ExternalMap = Record<string, unknown>;\n\n/**\n * Merges two external maps into one. If a key is present in both maps, the value from the new map is used.\n * If the external value is a namable object, it is given a name if it does not already have one.\n * @param existing - The existing external map.\n * @param newExternals - The new external map.\n */\nexport function applyExternals(\n  existing: ExternalMap,\n  newExternals: ExternalMap,\n) {\n  for (const [key, value] of Object.entries(newExternals)) {\n    existing[key] = value;\n\n    // Giving name to external value, if it does not already have one.\n    if (\n      value && (typeof value === 'object' || typeof value === 'function') &&\n      getName(value) === undefined\n    ) {\n      setName(value, key);\n    }\n  }\n}\n\nexport function addArgTypesToExternals(\n  implementation: string,\n  argTypes: unknown[],\n  applyExternals: (externals: ExternalMap) => void,\n) {\n  const argTypeNames = [\n    ...implementation.matchAll(/:\\s*(?<arg>.*?)\\s*[,)]/g),\n  ].map((found) => (found ? found[1] : undefined));\n\n  applyExternals(\n    Object.fromEntries(\n      argTypes.flatMap((argType, i) => {\n        const argTypeName = argTypeNames ? argTypeNames[i] : undefined;\n        return isWgslStruct(argType) && argTypeName !== undefined\n          ? [[argTypeName, argType]]\n          : [];\n      }),\n    ),\n  );\n}\n\nexport function addReturnTypeToExternals(\n  implementation: string,\n  returnType: unknown,\n  applyExternals: (externals: ExternalMap) => void,\n) {\n  const matched = implementation.match(/->\\s(?<output>[\\w\\d_]+)\\s{/);\n  const outputName = matched ? matched[1]?.trim() : undefined;\n\n  if (isWgslStruct(returnType) && outputName && !/\\s/g.test(outputName)) {\n    applyExternals({ [outputName]: returnType });\n  }\n}\n\nfunction identifierRegex(name: string) {\n  return new RegExp(\n    `(?<![\\\\w\\\\$_.])${\n      name.replaceAll('.', '\\\\.').replaceAll('$', '\\\\$')\n    }(?![\\\\w\\\\$_])`,\n    'g',\n  );\n}\n\n/**\n * Replaces all occurrences of external names in WGSL code with their resolved values.\n * It adds all necessary definitions to the resolution context.\n * @param ctx - The resolution context.\n * @param externalMap - The external map.\n * @param wgsl - The WGSL code.\n *\n * @returns The WGSL code with all external names replaced with their resolved values.\n */\nexport function replaceExternalsInWgsl(\n  ctx: ResolutionCtx,\n  externalMap: ExternalMap,\n  wgsl: string,\n): string {\n  return Object.entries(externalMap).reduce((acc, [externalName, external]) => {\n    const externalRegex = identifierRegex(externalName);\n    if (\n      wgsl &&\n      externalName !== 'Out' &&\n      externalName !== 'In' &&\n      !externalRegex.test(wgsl)\n    ) {\n      console.warn(\n        `The external '${externalName}' wasn't used in the resolved template.`,\n      );\n      // continue anyway, we still might need to resolve the external\n    }\n\n    if (\n      isWgsl(external) || isLooseData(external) || hasTinyestMetadata(external)\n    ) {\n      return acc.replaceAll(externalRegex, ctx.resolve(external).value);\n    }\n\n    if (external !== null && typeof external === 'object') {\n      const foundProperties = [\n        ...wgsl.matchAll(\n          new RegExp(\n            `${\n              externalName.replaceAll('.', '\\\\.').replaceAll('$', '\\\\$')\n            }\\\\.(?<prop>.*?)(?![\\\\w\\\\$_])`,\n            'g',\n          ),\n        ),\n      ].map((found) => found[1]);\n      const uniqueProperties = [...new Set(foundProperties)];\n\n      return uniqueProperties.reduce(\n        (innerAcc: string, prop) =>\n          prop && prop in external\n            ? replaceExternalsInWgsl(\n              ctx,\n              {\n                [`${externalName}.${prop}`]:\n                  external[prop as keyof typeof external],\n              },\n              innerAcc,\n            )\n            : innerAcc,\n        acc,\n      );\n    }\n\n    console.warn(\n      `During resolution, the external '${externalName}' has been omitted. Only TGPU resources, 'use gpu' functions, primitives, and plain JS objects can be used as externals.`,\n    );\n\n    return acc;\n  }, wgsl);\n}\n","interface FunctionArgsInfo {\n  args: ArgInfo[];\n  ret: ReturnInfo | undefined;\n  range: {\n    begin: number;\n    end: number;\n  };\n}\n\ninterface ArgInfo {\n  identifier: string;\n  attributes: string[];\n  type: string | undefined;\n}\n\ninterface ReturnInfo {\n  attributes: string[];\n  type: string;\n}\n\n/**\n * Extracts info about arguments of a given WGSL function string.\n * @example\n * const code = `\n *   fn add(a: i32, ＠location(0) b: i32, c) -> i32 {\n *     return a + b + c;\n *   }`;\n *\n * extractArgs(code);\n * // {\n * //   args: [\n * //     { identifier: 'a', attributes: [], type: 'i32' },\n * //     { identifier: 'b', attributes: ['＠location(0)'], type: 'i32' },\n * //     { identifier: 'c', attributes: [], type: undefined }\n * //   ],\n * //   ret: { type: 'i32', attributes: [] },\n * //   range: { begin: 11, end: 51 }\n * // }\n */\nexport function extractArgs(rawCode: string): FunctionArgsInfo {\n  const { strippedCode, argRange: range } = strip(rawCode);\n  const code = new ParsableString(strippedCode);\n  code.consume('(');\n\n  const args: ArgInfo[] = [];\n  while (!code.isAt(')')) {\n    // In each loop iteration, process all the attributes, the identifier and the potential type of a single argument.\n\n    const attributes = [];\n    while (code.isAt('@')) {\n      code.parseUntil(closingParenthesis, parentheses);\n      code.consume(')');\n      attributes.push(code.lastParsed);\n    }\n\n    code.parseUntil(identifierEndSymbols);\n    const identifier = code.lastParsed;\n\n    let maybeType: string | undefined;\n    if (code.isAt(':')) {\n      code.consume(':');\n      code.parseUntil(typeEndSymbols, angleBrackets);\n      maybeType = code.lastParsed;\n    }\n\n    args.push({\n      identifier,\n      attributes,\n      type: maybeType,\n    });\n\n    if (code.isAt(',')) {\n      code.consume(',');\n    }\n  }\n  code.consume(')');\n\n  let maybeRet: ReturnInfo | undefined;\n  if (code.isAt('->')) {\n    code.consume('->');\n\n    const attributes = [];\n    while (code.isAt('@')) {\n      code.parseUntil(closingParenthesis, parentheses);\n      code.consume(')');\n      attributes.push(code.lastParsed);\n    }\n\n    maybeRet = { type: code.str.slice(code.pos), attributes };\n  }\n\n  return {\n    args,\n    ret: maybeRet,\n    range: { begin: range[0], end: range[1] },\n  };\n}\n\n/**\n * Strips comments, whitespaces, the name and the body of the function.\n * @example\n * const code = `\n *    fn add( a,  // first argument\n *            ＠location(0) b : i32 ) -> i32   {\n *        return a + b; // returns the sum\n *  }`;\n *\n * strip(code); // \"(a,@location(0)b:i32)->i32\"\n */\nfunction strip(\n  rawCode: string,\n): { strippedCode: string; argRange: [number, number] } {\n  const code = new ParsableString(rawCode);\n  let strippedCode = '';\n  let argsStart: number | undefined;\n\n  while (!code.isFinished()) {\n    // parse character by character while ignoring comments and blankspaces until you find a `{`.\n\n    // skip any blankspace\n    if (code.isAt(blankSpaces)) {\n      code.advanceBy(1); // the blankspace character\n      continue;\n    }\n\n    // skip line comments\n    if (code.isAt('//')) {\n      code.consume('//');\n      code.parseUntil(lineBreaks);\n      code.advanceBy(1); // the line break\n      continue;\n    }\n\n    // skip block comments\n    if (code.isAt('/*')) {\n      code.parseUntil(openingCommentBlock, commentBlocks);\n      code.consume('*/');\n      continue;\n    }\n\n    if (code.isAt('{')) {\n      return {\n        strippedCode,\n        argRange: [argsStart as number, code.pos],\n      };\n    }\n\n    if (code.isAt('(') && argsStart === undefined) {\n      argsStart = code.pos;\n    }\n\n    if (argsStart !== undefined) {\n      strippedCode += code.str[code.pos];\n    }\n    code.advanceBy(1); // parsed character\n  }\n  throw new Error('Invalid wgsl code!');\n}\n\nclass ParsableString {\n  #parseStartPos: number | undefined;\n  #pos: number;\n  constructor(public readonly str: string) {\n    this.#pos = 0;\n  }\n\n  get pos(): number {\n    return this.#pos;\n  }\n\n  /**\n   * This property is equivalent to the substring of `this.str`\n   * from the position of the last `parseUntil` call, to the current position.\n   */\n  get lastParsed(): string {\n    if (this.#parseStartPos === undefined) {\n      throw new Error('Parse was not called yet!');\n    }\n    return this.str.slice(this.#parseStartPos, this.pos);\n  }\n\n  isFinished() {\n    return this.#pos >= this.str.length;\n  }\n\n  isAt(substr: string | Set<string>): boolean {\n    if (typeof substr === 'string') {\n      for (let i = 0; i < substr.length; i++) {\n        if (this.str[this.#pos + i] !== substr[i]) {\n          return false;\n        }\n      }\n      return true;\n    }\n    for (const elem of substr) {\n      if (this.isAt(elem)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * @param toFind a set of strings either of which satisfy the search.\n   * @param brackets a pair of brackets that has to be closed for result to be valid. This includes the found character(s).\n   * @example\n   * // internal state:\n   * // '(@attribute(0) identifier: type)'\n   * //   ^\n   * this.parse(new Set(')'), ['(', ')']);\n   * // internal state:\n   * // '(@attribute(0) identifier: type)'\n   * //               ^\n   */\n  parseUntil(\n    toFind: Set<string>,\n    brackets?: readonly [string, string],\n  ): number {\n    this.#parseStartPos = this.#pos;\n    let openedBrackets = 0;\n    while (this.#pos < this.str.length) {\n      if (brackets && this.isAt(brackets[0])) {\n        openedBrackets += 1;\n      }\n      if (brackets && this.isAt(brackets[1])) {\n        openedBrackets -= 1;\n      }\n      if (openedBrackets === 0) {\n        if (this.isAt(toFind)) {\n          return this.#pos;\n        }\n      }\n      this.#pos += 1;\n    }\n    throw new Error('Reached the end of the string without finding a match!');\n  }\n\n  advanceBy(steps: number) {\n    this.#pos += steps;\n  }\n\n  consume(str: string): void {\n    if (!this.isAt(str)) {\n      throw new Error(\n        `Expected '${str}' at position ${this.#pos}, but found '${\n          this.str.slice(this.#pos, this.#pos + str.length)\n        }'`,\n      );\n    }\n    this.advanceBy(str.length);\n  }\n}\n\nconst lineBreaks = new Set<string>([\n  '\\u000A', // line feed\n  '\\u000B', // vertical tab\n  '\\u000C', // form feed\n  '\\u000D', // carriage return\n  '\\u0085', // next line\n  '\\u2028', // line separator\n  '\\u2029', // paragraph separator\n]);\nconst blankSpaces = new Set<string>([\n  ...lineBreaks,\n  '\\u0020', // space\n  '\\u0009', // horizontal tab\n  '\\u200E', // left-to-right mark\n  '\\u200F', // right-to-left mark\n]);\nconst closingParenthesis = new Set<string>([')']);\nconst identifierEndSymbols = new Set([':', ',', ')']);\nconst typeEndSymbols = new Set([',', ')']);\nconst openingCommentBlock = new Set(['*/']);\n\nconst parentheses = ['(', ')'] as const;\nconst angleBrackets = ['<', '>'] as const;\nconst commentBlocks = ['/*', '*/'] as const;\n","import { getAttributesString } from '../../data/attributes.ts';\nimport { undecorate } from '../../data/dataTypes.ts';\nimport { type ResolvedSnippet, snip } from '../../data/snippet.ts';\nimport {\n  type BaseData,\n  isWgslData,\n  isWgslStruct,\n  Void,\n} from '../../data/wgslTypes.ts';\nimport { MissingLinksError } from '../../errors.ts';\nimport { getMetaData, getName } from '../../shared/meta.ts';\nimport { $getNameForward } from '../../shared/symbols.ts';\nimport type { ResolutionCtx } from '../../types.ts';\nimport {\n  applyExternals,\n  type ExternalMap,\n  replaceExternalsInWgsl,\n} from '../resolve/externals.ts';\nimport { extractArgs } from './extractArgs.ts';\nimport type { Implementation } from './fnTypes.ts';\n\nexport interface FnCore {\n  applyExternals: (newExternals: ExternalMap) => void;\n  resolve(\n    ctx: ResolutionCtx,\n    /**\n     * The argument types can be AutoStruct if they're determined based on usage\n     * (like in auto-entry functions).\n     */\n    argTypes: BaseData[],\n    /**\n     * The return type of the function. If undefined, the type should be inferred\n     * from the implementation (relevant for shellless functions).\n     */\n    returnType: BaseData | undefined,\n  ): ResolvedSnippet;\n}\n\nexport function createFnCore(\n  implementation: Implementation,\n  fnAttribute = '',\n): FnCore {\n  /**\n   * External application has to be deferred until resolution because\n   * some externals can reference the owner function which has not been\n   * initialized yet (like when accessing the Output struct of a vertex\n   * entry fn).\n   */\n  const externalsToApply: ExternalMap[] = [];\n\n  const core = {\n    // Making the implementation the holder of the name, as long as it's\n    // a function (and not a string implementation)\n    [$getNameForward]: typeof implementation === 'function'\n      ? implementation\n      : undefined,\n    applyExternals(newExternals: ExternalMap): void {\n      externalsToApply.push(newExternals);\n    },\n\n    resolve(\n      ctx: ResolutionCtx,\n      argTypes: BaseData[],\n      returnType: BaseData | undefined,\n    ): ResolvedSnippet {\n      const externalMap: ExternalMap = {};\n\n      for (const externals of externalsToApply) {\n        applyExternals(externalMap, externals);\n      }\n\n      const id = ctx.getUniqueName(this);\n\n      if (typeof implementation === 'string') {\n        if (!returnType) {\n          throw new Error(\n            'Explicit return type is required for string implementation',\n          );\n        }\n\n        const replacedImpl = replaceExternalsInWgsl(\n          ctx,\n          externalMap,\n          implementation,\n        );\n\n        let header = '';\n        let body = '';\n\n        if (fnAttribute !== '') {\n          const input = isWgslStruct(argTypes[0])\n            ? `(in: ${ctx.resolve(argTypes[0]).value})`\n            : '()';\n\n          const attributes = isWgslData(returnType)\n            ? getAttributesString(returnType)\n            : '';\n          const output = returnType !== Void\n            ? isWgslStruct(returnType)\n              ? `-> ${ctx.resolve(returnType).value}`\n              : `-> ${attributes !== '' ? attributes : '@location(0)'} ${\n                ctx.resolve(returnType).value\n              }`\n            : '';\n\n          header = `${input} ${output} `;\n          body = replacedImpl;\n        } else {\n          const providedArgs = extractArgs(replacedImpl);\n\n          if (providedArgs.args.length !== argTypes.length) {\n            throw new Error(\n              `WGSL implementation has ${providedArgs.args.length} arguments, while the shell has ${argTypes.length} arguments.`,\n            );\n          }\n\n          const input = providedArgs.args.map((argInfo, i) =>\n            `${argInfo.identifier}: ${\n              checkAndReturnType(\n                ctx,\n                `parameter ${argInfo.identifier}`,\n                argInfo.type,\n                argTypes[i],\n              )\n            }`\n          ).join(', ');\n\n          const output = returnType === Void ? '' : `-> ${\n            checkAndReturnType(\n              ctx,\n              'return type',\n              providedArgs.ret?.type,\n              returnType,\n            )\n          }`;\n\n          header = `(${input}) ${output}`;\n\n          body = replacedImpl.slice(providedArgs.range.end);\n        }\n\n        ctx.addDeclaration(`${fnAttribute}fn ${id}${header}${body}`);\n        return snip(id, returnType, /* origin */ 'runtime');\n      }\n\n      // get data generated by the plugin\n      const pluginData = getMetaData(implementation);\n\n      // Passing a record happens prior to version 0.9.0\n      // TODO: Support for this can be removed down the line\n      const pluginExternals = typeof pluginData?.externals === 'function'\n        ? pluginData.externals()\n        : pluginData?.externals;\n\n      if (pluginExternals) {\n        const missing = Object.fromEntries(\n          Object.entries(pluginExternals).filter(\n            ([name]) => !(name in externalMap),\n          ),\n        );\n\n        applyExternals(externalMap, missing);\n      }\n\n      const ast = pluginData?.ast;\n      if (!ast) {\n        throw new Error(\n          \"Missing metadata for tgpu.fn function body (either missing 'use gpu' directive, or misconfigured `unplugin-typegpu`)\",\n        );\n      }\n\n      // verify all required externals are present\n      const missingExternals = ast.externalNames.filter(\n        (name) => !(name in externalMap),\n      );\n      if (missingExternals.length > 0) {\n        throw new MissingLinksError(getName(this), missingExternals);\n      }\n\n      // If an entrypoint implementation has a second argument, it represents the output schema.\n      // We look at the identifier chosen by the user and add it to externals.\n      const maybeSecondArg = ast.params[1];\n      if (\n        maybeSecondArg && maybeSecondArg.type === 'i' && fnAttribute !== ''\n      ) {\n        applyExternals(\n          externalMap,\n          {\n            // oxlint-disable-next-line typescript/no-non-null-assertion entry functions cannot be shellless\n            [maybeSecondArg.name]: undecorate(returnType!),\n          },\n        );\n      }\n\n      // generate wgsl string\n\n      const { head, body, returnType: actualReturnType } = ctx.fnToWgsl({\n        functionType: fnAttribute.includes('@compute')\n          ? 'compute'\n          : fnAttribute.includes('@vertex')\n          ? 'vertex'\n          : fnAttribute.includes('@fragment')\n          ? 'fragment'\n          : 'normal',\n        argTypes,\n        params: ast.params,\n        returnType,\n        body: ast.body,\n        externalMap,\n      });\n\n      ctx.addDeclaration(\n        `${fnAttribute}fn ${id}${ctx.resolve(head).value}${\n          ctx.resolve(body).value\n        }`,\n      );\n\n      return snip(id, actualReturnType, /* origin */ 'runtime');\n    },\n  };\n\n  return core;\n}\n\nfunction checkAndReturnType(\n  ctx: ResolutionCtx,\n  name: string,\n  wgslType: string | undefined,\n  jsType: unknown,\n) {\n  const resolvedJsType = ctx.resolve(jsType).value.replace(/\\s/g, '');\n\n  if (!wgslType) {\n    return resolvedJsType;\n  }\n\n  const resolvedWgslType = wgslType.replace(/\\s/g, '');\n\n  if (resolvedWgslType !== resolvedJsType) {\n    throw new Error(\n      `Type mismatch between TGPU shell and WGSL code string: ${name}, JS type \"${resolvedJsType}\", WGSL type \"${resolvedWgslType}\".`,\n    );\n  }\n\n  return wgslType;\n}\n","import type { Implementation } from './fnTypes.ts';\n\nexport function stripTemplate(\n  arg: Implementation | TemplateStringsArray,\n  ...values: unknown[]\n): Implementation {\n  return isTemplateStringsArray(arg)\n    ? templateLiteralIdentity(arg, ...values)\n    : arg;\n}\n\nfunction isTemplateStringsArray(value: unknown): value is TemplateStringsArray {\n  return (\n    Array.isArray(value) &&\n    'raw' in value &&\n    Array.isArray(value.raw) &&\n    value.raw.every((item) => typeof item === 'string')\n  );\n}\n\nfunction templateLiteralIdentity(\n  strings: TemplateStringsArray,\n  ...values: unknown[]\n): string {\n  return strings\n    .slice(1)\n    .reduce(\n      (acc, elem, index) => `${acc}${values[index]}${elem}`,\n      strings[0] as string,\n    );\n}\n","import { getResolutionCtx } from '../../execMode.ts';\nimport { getName, setName } from '../../shared/meta.ts';\nimport type { GPUValueOf } from '../../shared/repr.ts';\nimport { $gpuValueOf, $internal } from '../../shared/symbols.ts';\nimport { getGpuValueRecursively } from '../valueProxyUtils.ts';\nimport type { TgpuSlot } from './slotTypes.ts';\n\n// ----------\n// Public API\n// ----------\n\nexport function slot<T>(defaultValue?: T): TgpuSlot<T> {\n  return new TgpuSlotImpl(defaultValue);\n}\n\n// --------------\n// Implementation\n// --------------\n\nclass TgpuSlotImpl<T> implements TgpuSlot<T> {\n  public readonly [$internal] = true;\n  public readonly resourceType = 'slot';\n\n  constructor(public defaultValue: T | undefined = undefined) {}\n\n  $name(label: string) {\n    setName(this, label);\n    return this;\n  }\n\n  areEqual(a: T, b: T): boolean {\n    return Object.is(a, b);\n  }\n\n  toString(): string {\n    return `slot:${getName(this) ?? '<unnamed>'}`;\n  }\n\n  get [$gpuValueOf](): GPUValueOf<T> {\n    const ctx = getResolutionCtx();\n    if (!ctx) {\n      throw new Error(`Cannot access tgpu.slot's value outside of resolution.`);\n    }\n\n    return getGpuValueRecursively(ctx.unwrap(this));\n  }\n\n  get value(): GPUValueOf<T> {\n    return this[$gpuValueOf];\n  }\n\n  get $(): GPUValueOf<T> {\n    return this.value;\n  }\n}\n","import type { ShaderStage } from '../../types.ts';\nimport { slot } from './slot.ts';\n\nexport const shaderStageSlot = slot<ShaderStage>(undefined);\n","import type {\n  AnyVertexInputBuiltin,\n  AnyVertexOutputBuiltin,\n  OmitBuiltins,\n} from '../../builtin.ts';\nimport type { UndecorateRecord } from '../../data/dataTypes.ts';\nimport type { ResolvedSnippet } from '../../data/snippet.ts';\nimport type {\n  BaseData,\n  Decorated,\n  Interpolate,\n  Location,\n} from '../../data/wgslTypes.ts';\nimport {\n  getName,\n  isNamable,\n  setName,\n  type TgpuNamable,\n} from '../../shared/meta.ts';\nimport { $getNameForward, $internal, $resolve } from '../../shared/symbols.ts';\nimport type { Prettify } from '../../shared/utilityTypes.ts';\nimport type { ResolutionCtx, SelfResolvable } from '../../types.ts';\nimport { shaderStageSlot } from '../slot/internalSlots.ts';\nimport { createFnCore, type FnCore } from './fnCore.ts';\nimport type {\n  BaseIOData,\n  Implementation,\n  InferIO,\n  IORecord,\n} from './fnTypes.ts';\nimport { createIoSchema, type IOLayoutToSchema } from './ioSchema.ts';\nimport { stripTemplate } from './templateUtils.ts';\n\n// ----------\n// Public API\n// ----------\n\ntype VertexInConstrained = IORecord<\n  BaseIOData | Decorated<BaseIOData, Location[]> | AnyVertexInputBuiltin\n>;\n\ntype VertexOutConstrained = IORecord<\n  | BaseIOData\n  | Decorated<BaseIOData, (Location | Interpolate)[]>\n  | AnyVertexOutputBuiltin\n>;\n\n/**\n * Describes a vertex entry function signature (its arguments, return type and attributes)\n */\ntype TgpuVertexFnShellHeader<\n  VertexIn extends TgpuVertexFn.In,\n  VertexOut extends TgpuVertexFn.Out,\n> = {\n  readonly in: VertexIn | undefined;\n  readonly out: VertexOut;\n  readonly argTypes: [IOLayoutToSchema<VertexIn>] | [];\n  readonly entryPoint: 'vertex';\n};\n\ntype CleanIO<T> = T extends Record<string, BaseData>\n  ? Prettify<UndecorateRecord<OmitBuiltins<T>>>\n  : Prettify<UndecorateRecord<OmitBuiltins<{ a: T }>>> extends\n    { a: infer Result } ? Result\n  : never;\n\n/**\n * Describes a vertex entry function signature (its arguments, return type and attributes).\n * Allows creating tgpu vertex functions by calling this shell\n * and passing the implementation (as WGSL string or JS function) as the argument.\n */\nexport interface TgpuVertexFnShell<\n  // We force the variance to be covariant, since shells are just containers of\n  // schemas that coincidentally can be called to create a vertex function.\n  // @ts-expect-error: We override the variance\n  out TIn extends TgpuVertexFn.In,\n  // @ts-expect-error: We override the variance\n  out TOut extends TgpuVertexFn.Out,\n> extends TgpuVertexFnShellHeader<TIn, TOut> {\n  (\n    implementation: (\n      input: InferIO<TIn>,\n      out: IOLayoutToSchema<TOut>,\n    ) => InferIO<TOut>,\n  ): TgpuVertexFn<CleanIO<TIn>, CleanIO<TOut>>;\n  (\n    implementation: string,\n  ): TgpuVertexFn<CleanIO<TIn>, CleanIO<TOut>>;\n  (\n    strings: TemplateStringsArray,\n    ...values: unknown[]\n  ): TgpuVertexFn<CleanIO<TIn>, CleanIO<TOut>>;\n}\n\nexport interface TgpuVertexFn<\n  // @ts-expect-error: We override the variance\n  in VertexIn extends TgpuVertexFn.In = Record<string, never>,\n  out VertexOut extends TgpuVertexFn.Out = TgpuVertexFn.Out,\n> extends TgpuNamable {\n  readonly [$internal]: true;\n  readonly shell: TgpuVertexFnShellHeader<VertexIn, VertexOut>;\n  $uses(dependencyMap: Record<string, unknown>): this;\n}\n\nexport declare namespace TgpuVertexFn {\n  type In = BaseData | Record<string, BaseData>;\n  type Out = Record<string, BaseData>;\n}\n\nexport function vertexFn<VertexOut extends VertexOutConstrained>(options: {\n  out: VertexOut;\n}): TgpuVertexFnShell<{}, VertexOut>;\n\nexport function vertexFn<\n  VertexIn extends VertexInConstrained,\n  // Not allowing single-value output, as it is better practice\n  // to properly label what the vertex shader is outputting.\n  VertexOut extends VertexOutConstrained,\n>(options: {\n  in: VertexIn;\n  out: VertexOut;\n}): TgpuVertexFnShell<VertexIn, VertexOut>;\n\n/**\n * Creates a shell of a typed entry function for the vertex shader stage. Any function\n * that implements this shell can run for each vertex, allowing the inner code to process\n * attributes and determine the final position of the vertex.\n *\n * @param options.in\n *   Vertex attributes and builtins to be made available to functions that implement this shell.\n * @param options.out\n *   A record containing the final position of the vertex, and any information\n *   passed onto the fragment shader stage.\n */\nexport function vertexFn<\n  VertexIn extends VertexInConstrained,\n  // Not allowing single-value output, as it is better practice\n  // to properly label what the vertex shader is outputting.\n  VertexOut extends VertexOutConstrained,\n>(options: {\n  in?: VertexIn;\n  out: VertexOut;\n}): TgpuVertexFnShell<VertexIn, VertexOut> {\n  if (Object.keys(options.out).length === 0) {\n    throw new Error(\n      `A vertexFn output cannot be empty since it must include the 'position' builtin.`,\n    );\n  }\n  const shell: TgpuVertexFnShellHeader<VertexIn, VertexOut> = {\n    in: options.in,\n    out: options.out,\n    argTypes: options.in && Object.keys(options.in).length !== 0\n      ? [createIoSchema(options.in)]\n      : [],\n    entryPoint: 'vertex',\n  };\n\n  const call = (\n    arg: Implementation | TemplateStringsArray,\n    ...values: unknown[]\n  ) => createVertexFn(shell, stripTemplate(arg, ...values));\n\n  return Object.assign(call, shell) as unknown as TgpuVertexFnShell<\n    VertexIn,\n    VertexOut\n  >;\n}\n\nexport function isTgpuVertexFn<\n  VertexIn extends VertexInConstrained,\n  VertexOut extends VertexOutConstrained,\n>(\n  value: unknown,\n): value is TgpuVertexFn<VertexIn, VertexOut> {\n  return (value as TgpuVertexFn<VertexIn, VertexOut>)?.shell?.entryPoint ===\n    'vertex';\n}\n\n// --------------\n// Implementation\n// --------------\n\nfunction createVertexFn(\n  shell: TgpuVertexFnShellHeader<VertexInConstrained, VertexOutConstrained>,\n  implementation: Implementation,\n): TgpuVertexFn<VertexInConstrained, VertexOutConstrained> {\n  type This =\n    & TgpuVertexFn<VertexInConstrained, VertexOutConstrained>\n    & SelfResolvable\n    & {\n      [$internal]: true;\n      [$getNameForward]: FnCore;\n    };\n\n  const core = createFnCore(implementation, '@vertex ');\n  const inputType = shell.argTypes[0];\n\n  const result: This = {\n    shell,\n\n    $uses(newExternals) {\n      core.applyExternals(newExternals);\n      return this;\n    },\n\n    [$internal]: true,\n    [$getNameForward]: core,\n    $name(newLabel: string): This {\n      setName(this, newLabel);\n      if (isNamable(inputType)) {\n        inputType.$name(`${newLabel}_Input`);\n      }\n      return this;\n    },\n\n    [$resolve](ctx: ResolutionCtx): ResolvedSnippet {\n      const outputWithLocation = createIoSchema(\n        shell.out,\n        ctx.varyingLocations,\n      ).$name(`${getName(this) ?? ''}_Output`);\n\n      if (typeof implementation === 'string') {\n        if (inputType) {\n          core.applyExternals({ In: inputType });\n        }\n        core.applyExternals({ Out: outputWithLocation });\n      }\n\n      return ctx.withSlots([[shaderStageSlot, 'vertex']], () =>\n        core.resolve(\n          ctx,\n          shell.argTypes,\n          outputWithLocation,\n        ));\n    },\n\n    toString() {\n      return `vertexFn:${getName(core) ?? '<unnamed>'}`;\n    },\n  };\n  return result;\n}\n","import { builtin } from '../builtin.ts';\nimport { vertexFn } from '../core/function/tgpuVertexFn.ts';\nimport { vec2f } from '../data/vector.ts';\n\n/**\n * A vertex function that defines a single full-screen triangle out\n * of three points.\n *\n * @example\n * ```ts\n * import { common } from 'typegpu';\n *\n * const pipeline = root.createRenderPipeline({\n *   vertex: common.fullScreenTriangle,\n *   fragment: yourFragmentShader,\n * });\n *\n * pipeline.draw(3);\n * ```\n */\nexport const fullScreenTriangle = vertexFn({\n  in: { vertexIndex: builtin.vertexIndex },\n  out: { pos: builtin.position, uv: vec2f },\n})`{\n  const pos = array<vec2f, 3>(vec2f(-1, -1), vec2f(3, -1), vec2f(-1, 3));\n  const uv = array<vec2f, 3>(vec2f(0, 1), vec2f(2, 1), vec2f(0, -1));\n\n  return Out(vec4f(pos[in.vertexIndex], 0, 1), uv[in.vertexIndex]);\n}`;\n"],"mappings":"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"}