Rollup plugin

[iwoplaza]

Changes

• @typegpu/tgsl-tools no longer act on raw JS code as a string, but rather process an estree-compliant JavaScript AST. This allows the rollup plugin to plugin the ast it generated to transpile it to SMoL. The JIT is now responsible for generating an AST from the raw JS code with acorn.
• Anonymous functions (function() {}) are now supported as parameters to .implement and .procedure

Usage

// @ts-check
import { defineConfig } from 'vite';
import typegpu from 'rollup-plugin-typegpu';

export default defineConfig({
  plugins: [
    typegpu(),
  ],
});

Functionality

• Targets files that import typegpu or any submodule typegpu/*.
• Gathers how the tgpu object is imported, and how it is aliased.
• Augments every tgpu function creation with calls to $__ast and $uses.

Further work

• (rollup-plugin-typegpu) Check for the existence of $__ast and $uses on the callee at runtime before calling them. #417
• (rollup-plugin-typegpu) Remove unnecessary quotes from SMoL AST keys, further reducing the amount of characters. #416

[mhawryluk]

not sure what's the difference between these expressions vs declarations. couldn't find acorn docs, could you please link it if you have it?

[iwoplaza]

FunctionDeclaration nodes are statements, so when we just declare a function, instead of e.g., passing that declaration immediately as an argument. FunctionExpressions are the opposite.

Example of FunctionDeclaration:

function foo() {}

Example of FunctionExpression:

bar(function foo() {})
//  ^ here

[reczkok]

Great job 👏🆙

[mhawryluk]

LGTM 🚀