@traceletdev/vite 0.5.0

package/README.md

@@ -0,0 +1,41 @@
+# @traceletdev/vite
+
+Tracelet plugin for Vite projects.
+
+## Installation
+
+```bash
+npm install -D @traceletdev/cli @traceletdev/vite
+```
+
+## Usage
+
+Add the plugin to your `vite.config.js`:
+
+```js
+import { defineConfig } from 'vite';
+import tracelet from '@traceletdev/vite';
+
+export default defineConfig({
+  plugins: [
+    // your other plugins
+    tracelet(),
+  ],
+});
+```
+
+The plugin automatically runs during builds and generates `.tracelet/stats.json` which is used by `tracelet lint` to check performance budgets.
+
+## How it works
+
+The plugin hooks into Vite's build process and:
+
+- Analyzes entry chunks during bundle generation
+- Calculates gzip-compressed JavaScript sizes
+- Identifies third-party JavaScript bundles
+- Generates statistics for tracelet linting
+
+## Configuration
+
+Ensure you have a `tracelet.config.json` file in your project root. See the [main tracelet documentation](../../README.md) for configuration options.
+

package/index.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const zlib = require('zlib');
+
+function writeStats(routes, _outDir) {
+  const outPath = path.join(process.cwd(), '.tracelet', 'stats.json');
+  try {
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, JSON.stringify({ routes }, null, 2));
+
+    console.log(`[tracelet] wrote stats to ${path.relative(process.cwd(), outPath)}`);
+  } catch (e) {
+    console.warn('[tracelet] failed to write stats:', e.message);
+  }
+}
+
+module.exports = function traceletPlugin() {
+  let resolvedOutDir = '';
+  return {
+    name: 'tracelet-plugin',
+    apply: 'build',
+    configResolved(cfg) {
+      resolvedOutDir = (cfg.build && cfg.build.outDir) || 'dist';
+    },
+    generateBundle(_, bundle) {
+      // Find entry chunks and sum sizes as a homepage surrogate
+      const routes = [];
+      let homeBytes = 0;
+      let thirdPartyBytes = 0;
+      for (const [fileName, chunk] of Object.entries(bundle)) {
+        if (chunk && chunk.type === 'chunk' && chunk.isEntry) {
+          // Compress chunk code directly (files not written yet in generateBundle)
+          const code = chunk.code || '';
+          const compressed = zlib.gzipSync(Buffer.from(code), { level: 6 });
+          const size = compressed.length;
+          homeBytes += size;
+          // Detect third-party: Vite often names vendor chunks as "vendor-*.js" or includes node_modules imports
+          if (
+            fileName.includes('vendor') ||
+            fileName.includes('chunk-vendor') ||
+            (chunk.imports && chunk.imports.some(imp => imp && imp.includes('node_modules')))
+          ) {
+            thirdPartyBytes += size;
+          }
+        }
+      }
+      routes.push({
+        path: '/',
+        jsGzipBytes: homeBytes,
+        thirdPartyJsBytes: thirdPartyBytes,
+      });
+      writeStats(routes, resolvedOutDir);
+    },
+  };
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@traceletdev/vite",
+  "version": "0.5.0",
+  "description": "Tracelet plugin for Vite - automatically collects route statistics during builds",
+  "type": "commonjs",
+  "main": "index.cjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@traceletdev/cli": "^0.5.0",
+    "vite": ">=4.0.0"
+  },
+  "keywords": [
+    "tracelet",
+    "vite",
+    "performance",
+    "plugin"
+  ],
+  "author": "Moiz Imran <moizwasti@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/traceletdev/tracelet.git",
+    "directory": "packages/tracelet-vite"
+  },
+  "files": [
+    "index.cjs",
+    "README.md"
+  ]
+}