Configuration

/**
 * Creates a Vite plugin for inspecting plugin transformations
 * @param options - Configuration options for the plugin
 * @returns Configured Vite plugin instance
 */
function Inspect(options?: ViteInspectOptions): Plugin;

import { defineConfig } from 'vite';
import Inspect from 'vite-plugin-inspect';

// Basic usage with defaults
export default defineConfig({
  plugins: [
    Inspect()
  ],
});

// Development-only inspection
export default defineConfig({
  plugins: [
    Inspect({
      dev: true,
      build: false,
      silent: false
    })
  ],
});

// Build inspection with custom output
export default defineConfig({
  plugins: [
    Inspect({
      dev: false,
      build: true,
      outputDir: '.vite-inspect-build',
      open: true
    })
  ],
});

interface ViteInspectOptions {
  /** Enable the inspect plugin in dev mode (could be some performance overhead) @default true */
  dev?: boolean;
  /** Enable the inspect plugin in build mode, and output the report to `.vite-inspect` @default false */
  build?: boolean;
  /** @deprecated use `dev` or `build` option instead. */
  enabled?: boolean;
  /** Directory for build inspector UI output, only work in build mode @default '.vite-inspect' */
  outputDir?: string;
  /** Filter for modules to be inspected */
  include?: FilterPattern;
  /** Filter for modules to not be inspected */
  exclude?: FilterPattern;
  /** Base URL for inspector UI @default read from Vite's config */
  base?: string;
  /** Print URL output silently in the terminal @default false */
  silent?: boolean;
  /** Automatically open inspect page @default false */  
  open?: boolean;
  /** Remove version query `?v=xxx` and treat them as the same module @default true */
  removeVersionQuery?: boolean;
  /** Enable embedded mode @default false */
  embedded?: boolean;
}

/**
 * Pattern type for filtering modules by path or name
 * Can be string, regex, array of patterns, or null to disable filtering
 */
type FilterPattern = ReadonlyArray<string | RegExp> | string | RegExp | null;

// String patterns
Inspect({
  include: "src/**/*.vue",
  exclude: "node_modules/**"
})

// Regex patterns  
Inspect({
  include: /\.(vue|tsx?)$/,
  exclude: /node_modules/
})

// Multiple patterns
Inspect({
  include: ["src/**/*.vue", "src/**/*.ts"],
  exclude: ["node_modules/**", "dist/**"]
})

Inspect({
  dev: true,        // Enable in dev mode
  build: false,     // Disable in build mode  
  silent: false,    // Show console messages
  open: false       // Don't auto-open browser
})

Inspect({
  dev: false,
  build: true,
  outputDir: '.vite-inspect',
  open: true
})

// Include only Vue and TypeScript files
Inspect({
  include: ["**/*.vue", "**/*.ts", "**/*.tsx"]
})

// Exclude node_modules and test files
Inspect({
  exclude: ["node_modules/**", "**/*.test.ts", "**/*.spec.ts"]
})

// Complex filtering
Inspect({
  include: /src\//,
  exclude: [/node_modules/, /\.test\./, /\.spec\./]
})

Inspect({
  removeVersionQuery: true  // Default: treat file.js?v=123 same as file.js
})

Inspect({
  base: '/my-app/',  // Inspector available at /my-app/__inspect/
})

Inspect({
  silent: true  // Suppress URL and status messages
})

Inspect({
  open: true,  // Auto-open inspector page
  dev: true    // Only works in dev mode
})

Inspect({
  embedded: true  // Enable embedded mode
})