{"id":22648,"library":"vite-plugin-entry-shaking-debugger","title":"Vite Plugin Entry Shaking Debugger","description":"Debugger for vite-plugin-entry-shaking, a Vite plugin that improves tree shaking for re-exported entry points. Version 2.0.2 requires vite >=5.1.0 and vite-plugin-entry-shaking >=0.5.2 (peer dependency). Release cadence follows the main plugin with patch releases. Key differentiator: provides detailed logging and analysis of entry shaking transformations, helping developers identify why certain exports aren't being tree-shaken. Ships TypeScript types. ESM-only.","status":"active","version":"2.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/Dschungelabenteuer/vite-plugin-entry-shaking","tags":["javascript","vite","vite-plugin","entry","tree shaking","debugger","typescript"],"install":[{"cmd":"npm install vite-plugin-entry-shaking-debugger","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-entry-shaking-debugger","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-entry-shaking-debugger","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency, vite >=5.1.0 required for plugin compatibility","package":"vite","optional":false},{"reason":"peer dependency, version 0.5.2+ required. This debugger is a companion plugin.","package":"vite-plugin-entry-shaking","optional":false}],"imports":[{"note":"This package does not export the plugin itself; it's a debugger that augments the main plugin. Enable via debug: true in the main plugin config.","wrong":"const EntryShakingPlugin = require('vite-plugin-entry-shaking')","symbol":"EntryShakingPlugin","correct":"import { EntryShakingPlugin } from 'vite-plugin-entry-shaking'"},{"note":"This package is auto-invoked when imported; no named exports. Just import the package to enable debug features.","wrong":"import { debugger } from 'vite-plugin-entry-shaking-debugger'","symbol":"vite-plugin-entry-shaking-debugger","correct":"import 'vite-plugin-entry-shaking-debugger'"},{"note":"Type imports come from main plugin package, not debugger.","wrong":"import { EntryShakingPluginOptions } from 'vite-plugin-entry-shaking-debugger'","symbol":"type: EntryShakingPluginOptions","correct":"import type { EntryShakingPluginOptions } from 'vite-plugin-entry-shaking'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite';\nimport { EntryShakingPlugin } from 'vite-plugin-entry-shaking';\nimport 'vite-plugin-entry-shaking-debugger'; // enables debug mode\n\nexport default defineConfig({\n  plugins: [\n    EntryShakingPlugin({\n      targets: ['./src/entries/index.ts'],\n      debug: true, // verbose logging for tree shaking analysis\n    }),\n  ],\n});","lang":"typescript","description":"Configures Vite with entry shaking plugin and debugger, enabling verbose logging to analyze tree shaking behavior."},"warnings":[{"fix":"Add 'import \"vite-plugin-entry-shaking-debugger\"' to your vite config file.","message":"Debugger must be imported as a side-effect import. If not imported, setting 'debug: true' on the main plugin does nothing.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Upgrade to vite-plugin-entry-shaking-debugger@2 and ensure vite-plugin-entry-shaking@0.5+.","message":"v1.x debugger versions are deprecated and not compatible with vite-plugin-entry-shaking >=0.5.0.","severity":"deprecated","affected_versions":"1.x"},{"fix":"Update peer dependencies: vite >=5.1.0, vite-plugin-entry-shaking >=0.5.0.","message":"Version 2.0.0 dropped support for vite-plugin-entry-shaking <0.5.0 and vite <5.1.0.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Use VITE_NODE_ENV=development or run 'vite' (not 'vite build') to see debug output.","message":"The debugger only works in development mode; production builds ignore the setting.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'npm install -D vite-plugin-entry-shaking-debugger' or check package.json dependencies.","cause":"Package not installed or not properly resolved.","error":"Error: Cannot find module 'vite-plugin-entry-shaking-debugger'"},{"fix":"Ensure you have imported 'vite-plugin-entry-shaking-debugger' and that you are using vite-plugin-entry-shaking@0.5+.","cause":"Debugger import missing or incorrect version of vite-plugin-entry-shaking.","error":"TypeError: plugin.debug is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}