@polyfill-prune/vite-plugin 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# @polyfill-prune/vite-plugin
+
+## 0.1.0
+
+- Wrap the native library for development transforms, dependency optimization, and production chunks.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justinidlerz
+
+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

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# @polyfill-prune/vite-plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A polyfill pruning wrapper for Vite 6–8. Compatibility checks and AST rules run in the Rust API provided by `@polyfill-prune/core`. Requires Node.js >= 22.12.0 and compliance with the Node.js requirements of your Vite version.
+
+## Setup
+
+Install from the public npm registry with `pnpm add -D @polyfill-prune/vite-plugin`. To work from this repository, run `pnpm install && pnpm build`, followed by `pnpm example:vite`.
+
+```ts
+import { defineConfig } from 'vite';
+import polyfillPrune from '@polyfill-prune/vite-plugin';
+
+export default defineConfig({
+  build: { target: ['chrome100', 'safari15.4'] },
+  plugins: [polyfillPrune()],
+});
+```
+
+## Options
+
+| Option                      | Default                 | Description                                                                                          |
+| --------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------- |
+| `targets`                   | Resolved `build.target` | Explicit runtime target array; can override a build target that specifies only ES syntax             |
+| `keep`                      | `[]`                    | Preserve APIs and their descendants                                                                  |
+| `sourceMap`                 | `true`                  | Generate transformation maps for Vite to compose                                                     |
+| `filter(id)`                | JS/TS module extensions | Receives module IDs during development and chunk filenames during production builds                  |
+| `optimizeDeps`              | `true`                  | Run the core API during development dependency prebundling                                           |
+| `onResult(result, context)` | None                    | Receive each analysis result; context contains `filename` and `stage`; async callbacks are supported |
+
+`stage` is `dev`, `dependency`, or `build`. Virtual modules and requests with `?raw` or `?url` are skipped. If the filter captures mutable external state, use Vite's `--force` option to refresh the dependency cache after that state changes.
+
+## Execution stages
+
+| Scenario                         | Hook                 | Output                                                                     |
+| -------------------------------- | -------------------- | -------------------------------------------------------------------------- |
+| Development source               | `transform`, post    | Pruned code for requests and HMR updates                                   |
+| Vite 6/7 dependency optimization | esbuild `onLoad`     | Pruned JavaScript input passed to esbuild                                  |
+| Vite 8 dependency optimization   | Rolldown `transform` | Pruned code with source map chaining                                       |
+| Production build                 | `renderChunk`, pre   | Pruned bundled chunks used by subsequent minification and hash calculation |
+
+Production pruning runs on output chunks. If another output plugin injects polyfills after this plugin, adjust its hook order. Filtering chunk filenames does not filter individual source modules within those chunks.
+
+Only the `client` environment is processed. SSR, worker, and other environments are skipped. The development dependency cache includes targets, `keep`, the filter's source text, and core/data versions in the plugin identifier. In Vite 6/7, an earlier custom esbuild loader that handles a file prevents this plugin's `onLoad` hook from processing it again.
+
+The plugin removes only branches the core library can prove unnecessary. It does not guarantee removal of arbitrary bundled core-js code or custom installers. Syntax-only build targets such as `esnext` or `es2015` require an explicit `targets` option.

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin } from 'vite';
+import type { PruneOptions, PruneResult } from '@polyfill-prune/core';
+export interface PolyfillPruneOptions extends Omit<PruneOptions, 'filename' | 'targets'> {
+    /** Defaults to the resolved Vite build.target. Syntax-only targets require an override. */
+    targets?: string[];
+    /** Defaults to JS/TS module files. Receives module IDs in dev and chunk filenames in build. */
+    filter?: (id: string) => boolean;
+    /** Process dependency optimizer inputs during development. Default: true. */
+    optimizeDeps?: boolean;
+    onResult?: (result: PruneResult, context: {
+        filename: string;
+        stage: 'dev' | 'dependency' | 'build';
+    }) => void | Promise<void>;
+}
+export declare function polyfillPrune(options?: PolyfillPruneOptions): Plugin;
+export default polyfillPrune;

package/dist/index.js

@@ -0,0 +1,106 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import * as vite from 'vite';
+import { prune, version } from '@polyfill-prune/core';
+export function polyfillPrune(options = {}) {
+    let config;
+    let targets;
+    let active = true;
+    const accepts = (id) => !id.includes('\0') &&
+        !/[?&](raw|url)(?:&|$)/.test(id) &&
+        (options.filter?.(id) ?? /\.[cm]?[jt]sx?(?:\?|$)/.test(id));
+    async function transform(code, id, stage) {
+        if (!active || !accepts(id))
+            return null;
+        const result = await prune(code, {
+            targets,
+            filename: id.split('?')[0],
+            keep: options.keep,
+            sourceMap: options.sourceMap,
+        });
+        for (const diagnostic of result.diagnostics) {
+            config.logger.warn(`[polyfill-prune] ${id}: ${diagnostic}`);
+        }
+        await options.onResult?.(result, { filename: id, stage });
+        return result.changed ? { code: result.code, map: result.map } : null;
+    }
+    // The optimizer hashes plugin names. Include native/data versions and options
+    // after config resolution so a target change cannot reuse stale dependency code.
+    const optimizer = {
+        name: 'polyfill-prune:dependencies',
+        transform: (code, id) => transform(code, id, 'dependency'),
+    };
+    const legacyOptimizer = {
+        name: 'polyfill-prune:dependencies',
+        setup(build) {
+            build.onLoad({ filter: /\.[cm]?js$/, namespace: 'file' }, async ({ path }) => {
+                if (!active || !accepts(path))
+                    return;
+                const result = await transform(await readFile(path, 'utf8'), path, 'dependency');
+                if (!result)
+                    return;
+                const comment = '//# source' + 'MappingURL=data:application/json;base64,';
+                const map = result.map
+                    ? `\n${comment}${Buffer.from(JSON.stringify(result.map)).toString('base64')}`
+                    : '';
+                return { contents: result.code + map, loader: 'js', resolveDir: dirname(path) };
+            });
+        },
+    };
+    return {
+        name: '@polyfill-prune/vite-plugin',
+        enforce: 'post',
+        applyToEnvironment(environment) {
+            return environment.name === 'client';
+        },
+        configEnvironment(name, _, env) {
+            if (name !== 'client' || env.command !== 'serve' || options.optimizeDeps === false)
+                return;
+            return 'rolldownVersion' in vite
+                ? { optimizeDeps: { rolldownOptions: { plugins: [optimizer] } } }
+                : { optimizeDeps: { esbuildOptions: { plugins: [legacyOptimizer] } } };
+        },
+        async configResolved(resolved) {
+            config = resolved;
+            active = !resolved.build.ssr && !resolved.isWorker;
+            if (!active)
+                return;
+            const target = options.targets ?? resolved.build.target;
+            targets = typeof target === 'string' ? [target] : target || [];
+            // Rust owns target parsing and validates even when no module needs pruning.
+            await prune('', { targets, sourceMap: false });
+            const fingerprint = createHash('sha256')
+                .update(JSON.stringify({
+                targets,
+                keep: options.keep,
+                sourceMap: options.sourceMap,
+                filter: options.filter?.toString(),
+                version: version(),
+            }))
+                .digest('hex');
+            optimizer.name += `:${fingerprint}`;
+            legacyOptimizer.name = optimizer.name;
+        },
+        transform: {
+            order: 'post',
+            handler(code, id, transformOptions) {
+                if (config.command !== 'serve' ||
+                    transformOptions?.ssr ||
+                    this.environment?.config.consumer === 'server')
+                    return null;
+                return transform(code, id, 'dev');
+            },
+        },
+        renderChunk: {
+            order: 'pre',
+            handler(code, chunk) {
+                if (config.command !== 'build' || this.environment?.config.consumer === 'server')
+                    return null;
+                return transform(code, chunk.fileName, 'build');
+            },
+        },
+    };
+}
+export default polyfillPrune;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAgBtD,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,IAAI,MAAsB,CAAC;IAC3B,IAAI,OAAiB,CAAC;IACtB,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,EAAE,CAC7B,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClB,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9D,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,EAAU,EAAE,KAAqC;QACtF,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE;YAC/B,OAAO;YACP,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,UAAU,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,CAAC;IAED,8EAA8E;IAC9E,iFAAiF;IACjF,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,6BAA6B;QACnC,SAAS,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,YAAY,CAAC;KAC3E,CAAC;IACF,MAAM,eAAe,GAAG;QACtB,IAAI,EAAE,6BAA6B;QACnC,KAAK,CAAC,KAYL;YACC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC3E,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;oBAAE,OAAO;gBACtC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;gBACjF,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACpB,MAAM,OAAO,GAAG,YAAY,GAAG,0CAA0C,CAAC;gBAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG;oBACpB,CAAC,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;oBAC7E,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAClF,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE,MAAM;QACf,kBAAkB,CAAC,WAAW;YAC5B,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC;QACvC,CAAC;QACD,iBAAiB,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG;YAC5B,IAAI,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,YAAY,KAAK,KAAK;gBAAE,OAAO;YAC3F,OAAO,iBAAiB,IAAI,IAAI;gBAC9B,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE;gBACjE,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC;QAC3E,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,QAAQ;YAC3B,MAAM,GAAG,QAAQ,CAAC;YAClB,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACnD,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;YACxD,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;YAC/D,4EAA4E;YAC5E,MAAM,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC;iBACrC,MAAM,CACL,IAAI,CAAC,SAAS,CAAC;gBACb,OAAO;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE;gBAClC,OAAO,EAAE,OAAO,EAAE;aACnB,CAAC,CACH;iBACA,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,SAAS,CAAC,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;YACpC,eAAe,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;QACxC,CAAC;QACD,SAAS,EAAE;YACT,KAAK,EAAE,MAAM;YACb,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,gBAAgB;gBAChC,IACE,MAAM,CAAC,OAAO,KAAK,OAAO;oBAC1B,gBAAgB,EAAE,GAAG;oBACrB,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,KAAK,QAAQ;oBAE9C,OAAO,IAAI,CAAC;gBACd,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;SACF;QACD,WAAW,EAAE;YACX,KAAK,EAAE,KAAK;YACZ,OAAO,CAAC,IAAI,EAAE,KAAK;gBACjB,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,KAAK,QAAQ;oBAC9E,OAAO,IAAI,CAAC;gBACd,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,eAAe,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@polyfill-prune/vite-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Vite integration for the polyfill-prune Rust library",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@polyfill-prune/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "vite": ">=6 <9"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.0",
+    "typescript": "^5.9.3",
+    "vite": "^8.2.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Justinidlerz/polyfill-prune.git",
+    "directory": "packages/vite-plugin"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
 }