compress-shader-literals 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonatan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# compress-shader-literals
+
+Local Vite plugin that minifies GLSL and WGSL shader strings at build time.
+
+Strips block comments, line comments, and redundant whitespace from shader template literals. Runs as a `pre` transform so the result feeds into esbuild minification.
+
+## Usage
+
+```js
+// vite.config.js
+import { compressShaderLiterals } from './compress-shader-literals/plugin.js';
+
+export default {
+  plugins: [compressShaderLiterals.vite({ outputRatio: true })],
+};
+```
+
+## Options
+
+| Option        | Default                      | Description                    |
+| ------------- | ---------------------------- | ------------------------------ |
+| `tags`        | `['glsl', 'wgsl', 'shader']` | Tag names to match             |
+| `include`     | `/\.[jt]sx?$/`               | Files to process               |
+| `exclude`     | `/node_modules/`, `/dist/`   | Files to skip                  |
+| `outputRatio` | `false`                      | Print size summary after build |
+
+## Supported syntax
+
+```ts
+// Tagged template literal
+const vert = wgsl`void main() { ... }`;
+
+// Comment-prefixed template literal
+const frag = /* glsl */ `void main() { ... }`;
+```
+
+## Test
+
+```sh
+node compress-shader-literals/run-test.js
+```
+
+Runs the transform against `src/core/shaders.ts` and prints bytes saved.

package/dist/index.js

@@ -0,0 +1,132 @@
+// src/plugin.js
+import { createFilter } from "@rollup/pluginutils";
+import MagicString from "magic-string";
+import { createUnplugin } from "unplugin";
+
+// src/core.js
+import { parse } from "@babel/parser";
+import _traverse from "@babel/traverse";
+var traverse = _traverse.default || _traverse;
+function extractShaderLiterals(code, tags = ["glsl", "wgsl", "shader"]) {
+  const tagSet = new Set(tags);
+  const literals = [];
+  try {
+    const ast = parse(code, {
+      sourceType: "module",
+      plugins: ["typescript", "jsx", "decorators-legacy"],
+      allowReturnOutsideFunction: true
+    });
+    traverse(ast, {
+      TaggedTemplateExpression(path) {
+        const { tag, quasi } = path.node;
+        let tagName = null;
+        if (tag.type === "Identifier" && tagSet.has(tag.name)) {
+          tagName = tag.name;
+        } else if (tag.type === "MemberExpression" && tag.property.type === "Identifier" && tagSet.has(tag.property.name)) {
+          tagName = tag.property.name;
+        }
+        if (tagName) {
+          literals.push({
+            tag: tagName,
+            value: quasi.quasis.map((q) => q.value.raw).join(""),
+            start: quasi.start,
+            end: quasi.end
+          });
+        }
+      },
+      TemplateLiteral(path) {
+        const node = path.node;
+        const leadingComments = node.leadingComments || path.parentPath?.node?.leadingComments || [];
+        for (const comment of leadingComments) {
+          if (!comment || comment.type !== "CommentBlock")
+            continue;
+          const m = comment.value.match(/^\s*(glsl|wgsl|shader)\s*$/);
+          if (m) {
+            literals.push({
+              tag: m[1],
+              value: node.quasis.map((q) => q.value.raw).join(""),
+              start: node.start,
+              end: node.end
+            });
+            break;
+          }
+        }
+      }
+    });
+  } catch (e) {}
+  return literals;
+}
+function minifyShader(src) {
+  return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "").replace(/[ \t]+/g, " ").replace(/\n{2,}/g, `
+`).trim();
+}
+
+// src/plugin.js
+function fmtBytes(bytes) {
+  const units = ["B", "KB", "MB", "GB"];
+  let v = bytes;
+  let u = 0;
+  while (v >= 1024 && u < units.length - 1) {
+    v /= 1024;
+    u++;
+  }
+  return `${v.toFixed(2)} ${units[u]}`;
+}
+function printRatio(beforeBytes, afterBytes, files) {
+  const saved = beforeBytes - afterBytes;
+  const pct = beforeBytes === 0 ? 0 : saved / beforeBytes * 100;
+  console.log(`
+compress-shader-literals`);
+  console.log("────────────────────────");
+  console.log(`${fmtBytes(beforeBytes)} → ${fmtBytes(afterBytes)}`);
+  console.log(`saved: ${fmtBytes(saved)} (${pct.toFixed(2)}% smaller)`);
+  console.log(`shaders: ${files}
+`);
+}
+var compressShaderLiterals = createUnplugin((options = {}) => {
+  const tags = options.tags || ["glsl", "wgsl", "shader"];
+  const filter = createFilter(options.include || [/\.[jt]sx?$/], options.exclude || [/node_modules/, /dist/]);
+  const stats = { before: 0, after: 0, files: 0 };
+  return {
+    name: "compress-shader-literals",
+    enforce: "pre",
+    transform(code, id) {
+      if (!filter(id))
+        return null;
+      if (!tags.some((tag) => code.includes(tag)))
+        return null;
+      const literals = extractShaderLiterals(code, tags);
+      if (literals.length === 0)
+        return null;
+      const ms = new MagicString(code);
+      let hasChanges = false;
+      for (const literal of literals) {
+        const minified = minifyShader(literal.value);
+        if (literal.value !== minified) {
+          ms.overwrite(literal.start, literal.end, `\`${minified}\``);
+          hasChanges = true;
+        }
+      }
+      if (!hasChanges)
+        return null;
+      const resultCode = ms.toString();
+      if (options.outputRatio) {
+        stats.before += Buffer.byteLength(code);
+        stats.after += Buffer.byteLength(resultCode);
+        stats.files += 1;
+      }
+      return {
+        code: resultCode,
+        map: ms.generateMap({ hires: true, source: id })
+      };
+    },
+    buildEnd() {
+      if (options.outputRatio && stats.files > 0) {
+        printRatio(stats.before, stats.after, stats.files);
+      }
+    }
+  };
+});
+export {
+  compressShaderLiterals
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "compress-shader-literals",
+  "version": "0.0.3",
+  "type": "module",
+  "description": "Size matters. Minify GLSL/WGSL shader template literals at build time — universal plugin for Vite, Rollup, webpack, esbuild & more.",
+  "keywords": [
+    "shader",
+    "glsl",
+    "wgsl",
+    "minify",
+    "compress",
+    "webgl",
+    "webgpu",
+    "vite-plugin",
+    "rollup-plugin",
+    "webpack-plugin",
+    "esbuild-plugin",
+    "unplugin"
+  ],
+  "license": "MIT",
+  "author": "jayF0x",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jayf0x/compress-shader-literals"
+  },
+  "homepage": "https://github.com/jayF0x/compress-shader-literals#readme",
+  "bugs": {
+    "url": "https://github.com/jayF0x/compress-shader-literals/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "bun build src/plugin.js --outdir dist --entry-naming index.js --target node --format esm --external @babel/parser --external @babel/traverse --external @rollup/pluginutils --external magic-string --external unplugin && node scripts/compress-dist.js",
+    "test": "bun test",
+    "test:run": "bun test",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "npm:deploy": "bash ./scripts/publish-npm.sh",
+    "rm:stalepr": "git branch -vv | grep '\\[gone\\]' | awk '{print $1}' | xargs git branch -D"
+  },
+  "dependencies": {
+    "@babel/parser": "^8.0.0",
+    "@babel/traverse": "^8.0.0",
+    "@rollup/pluginutils": "^5.4.0",
+    "magic-string": "^0.30.21",
+    "unplugin": "^3.0.0"
+  },
+  "devDependencies": {
+    "@trivago/prettier-plugin-sort-imports": "^5.0.0",
+    "prettier": "^3.0.0"
+  }
+}