@codefluss/vite-config-lib 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,49 @@
+# @codefluss/vite-config-lib
+
+Shared Vite configuration for building Codefluss plugin libraries.
+
+## Installation
+
+```bash
+pnpm add @codefluss/vite-config-lib -D
+```
+
+## Usage
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import { createLibConfig } from '@codefluss/vite-config-lib';
+
+export default defineConfig(
+  createLibConfig({
+    entry: './src/index.ts',
+    name: 'my-plugin',
+  })
+);
+```
+
+## Features
+
+- Pre-configured React plugin
+- TypeScript declaration generation via `vite-plugin-dts`
+- Library mode settings optimized for plugins
+- ESM output format
+
+## Configuration Options
+
+| Option    | Type       | Description                        |
+| --------- | ---------- | ---------------------------------- |
+| `entry`   | `string`   | Entry point for the library        |
+| `name`    | `string`   | Library name for UMD builds        |
+| `formats` | `string[]` | Output formats (default: `['es']`) |
+
+## Dependencies
+
+- `vite` ^7.2.7
+- `@vitejs/plugin-react` ^5.1.2
+- `vite-plugin-dts` ^4.5.4
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@codefluss/vite-config-lib",
+  "version": "0.0.1-alpha.1",
+  "type": "module",
+  "description": "Shared Vite configuration for library builds",
+  "main": "./vite.config.base.ts",
+  "types": "./vite.config.base.ts",
+  "exports": {
+    ".": {
+      "types": "./vite.config.base.ts",
+      "default": "./vite.config.base.ts"
+    }
+  },
+  "files": [
+    "vite.config.base.ts"
+  ],
+  "dependencies": {
+    "@vitejs/plugin-react": "^5.1.2",
+    "vite": "^7.2.7",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "vite",
+    "config",
+    "library",
+    "shared"
+  ],
+  "author": "Codefluss",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {}
+}

package/vite.config.base.ts

@@ -0,0 +1,195 @@
+import type { UserConfig, PluginOption } from 'vite';
+import react from '@vitejs/plugin-react';
+import dts from 'vite-plugin-dts';
+import { resolve } from 'path';
+
+/**
+ * Configuration options for creating a library build with Vite
+ */
+export interface LibraryConfigOptions {
+  /**
+   * Library name for UMD/IIFE builds (e.g., 'PluginCanvas2D')
+   */
+  libraryName: string;
+
+  /**
+   * Entry point relative to package root (default: 'src/index.ts')
+   */
+  entry?: string;
+
+  /**
+   * Output formats (default: ['es', 'cjs'])
+   * - 'es' for ESM (.mjs)
+   * - 'cjs' for CommonJS (.js)
+   */
+  formats?: ('es' | 'cjs' | 'umd' | 'iife')[];
+
+  /**
+   * External dependencies to exclude from bundle
+   * Common React dependencies are automatically included
+   */
+  external?: string[];
+
+  /**
+   * Additional global variable mappings for UMD/IIFE builds
+   */
+  globals?: Record<string, string>;
+
+  /**
+   * Enable sourcemaps (default: true)
+   */
+  sourcemap?: boolean;
+
+  /**
+   * Enable minification with Terser (default: true)
+   */
+  minify?: boolean | 'terser' | 'esbuild';
+
+  /**
+   * DTS plugin configuration
+   */
+  dts?: {
+    /**
+     * Include patterns (default: ['src/**\/*.ts', 'src/**\/*.tsx'])
+     */
+    include?: string[];
+
+    /**
+     * Exclude patterns (default: ['src/**\/*.test.ts', 'src/**\/*.test.tsx'])
+     */
+    exclude?: string[];
+
+    /**
+     * Skip TypeScript diagnostics (useful for React 19 + R3F compatibility)
+     */
+    skipDiagnostics?: boolean;
+  };
+
+  /**
+   * Additional Vite plugins
+   */
+  plugins?: PluginOption[];
+
+  /**
+   * Override any Vite config option
+   */
+  viteConfigOverrides?: Partial<UserConfig>;
+}
+
+/**
+ * Creates a Vite configuration for library builds with sensible defaults
+ *
+ * Features:
+ * - React plugin with automatic JSX runtime
+ * - TypeScript declaration files with vite-plugin-dts
+ * - Dual format output (ESM + CJS) by default
+ * - React, React-DOM externalized automatically
+ * - Sourcemaps and minification enabled by default
+ * - Tree-shaking friendly builds
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { createLibraryConfig } from '@codefluss/vite-config-lib';
+ *
+ * export default createLibraryConfig({
+ *   libraryName: 'PluginCanvas2D',
+ *   external: ['fabric', 'zustand'],
+ * });
+ * ```
+ */
+export function createLibraryConfig(options: LibraryConfigOptions): UserConfig {
+  const {
+    libraryName,
+    entry = 'src/index.ts',
+    formats = ['es', 'cjs'],
+    external = [],
+    globals = {},
+    sourcemap = true,
+    minify = 'terser',
+    dts: dtsConfig = {},
+    plugins = [],
+    viteConfigOverrides = {},
+  } = options;
+
+  // Standard React externals (always excluded from bundles)
+  const standardExternals = [
+    'react',
+    'react-dom',
+    'react/jsx-runtime',
+  ];
+
+  // Combine standard externals with custom externals
+  const allExternals = [...new Set([...standardExternals, ...external])];
+
+  // Standard globals for UMD/IIFE builds
+  const standardGlobals: Record<string, string> = {
+    react: 'React',
+    'react-dom': 'ReactDOM',
+    ...globals,
+  };
+
+  // DTS plugin configuration with defaults
+  const dtsPluginConfig = {
+    insertTypesEntry: true,
+    include: dtsConfig.include ?? ['src/**/*.ts', 'src/**/*.tsx'],
+    exclude: dtsConfig.exclude ?? ['src/**/*.test.ts', 'src/**/*.test.tsx'],
+    skipDiagnostics: dtsConfig.skipDiagnostics ?? false,
+  };
+
+  // Base configuration
+  const config: UserConfig = {
+    plugins: [
+      react(),
+      dts(dtsPluginConfig),
+      ...plugins,
+    ],
+    build: {
+      lib: {
+        entry: resolve(process.cwd(), entry),
+        name: libraryName,
+        formats,
+        fileName: (format) => {
+          // ESM -> .mjs, CJS -> .js, others use default
+          if (format === 'es') return 'index.mjs';
+          if (format === 'cjs') return 'index.js';
+          return `index.${format}.js`;
+        },
+      },
+      rollupOptions: {
+        external: allExternals,
+        output: {
+          globals: standardGlobals,
+        },
+      },
+      sourcemap,
+      minify,
+    },
+  };
+
+  // Apply overrides (deep merge)
+  const mergedLib = {
+    ...config.build?.lib,
+    ...viteConfigOverrides.build?.lib,
+  };
+
+  return {
+    ...config,
+    ...viteConfigOverrides,
+    plugins: [...(config.plugins ?? []), ...(viteConfigOverrides.plugins ?? [])],
+    build: {
+      ...config.build,
+      ...viteConfigOverrides.build,
+      lib: (mergedLib.entry ? mergedLib : config.build?.lib) as any,
+      rollupOptions: {
+        ...config.build?.rollupOptions,
+        ...viteConfigOverrides.build?.rollupOptions,
+        external: viteConfigOverrides.build?.rollupOptions?.external ?? allExternals,
+        output: {
+          ...config.build?.rollupOptions?.output,
+          ...viteConfigOverrides.build?.rollupOptions?.output,
+        },
+      },
+    },
+  };
+}