@mgz-app/viteforge 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,319 @@
+import dts from "vite-plugin-dts";
+import type { ConfigEnv, Plugin, PluginOption, UserConfig } from "vite";
+export interface ViteConfigOptions {
+    /**
+     * The root directory of the app
+     */
+    root?: string;
+    /**
+     * Development server port
+     * @default 4173
+     */
+    port?: number;
+    /**
+     * Preview server port
+     * @default 4174
+     */
+    previewPort?: number;
+    /**
+     * Output directory
+     * @default "./dist"
+     */
+    outDir?: string;
+    /**
+     * Cache directory
+     * @default "../../node_modules/.vite"
+     */
+    cacheDir?: string;
+    /**
+     * Whether to use single file build
+     * @default true for build, false for dev
+     */
+    singleFile?: boolean;
+    /**
+     * Whether to minify HTML
+     * @default true for build, false for dev
+     */
+    minifyHtml?: boolean;
+    /**
+     * Whether to minify JavaScript
+     * @default true for build, false for dev
+     */
+    minify?: boolean | "terser" | "esbuild";
+    /**
+     * Whether to use base64 asset plugin
+     * @default true
+     */
+    useBase64Assets?: boolean;
+    /**
+     * Whether to inject nonce for CSP
+     * @default true
+     */
+    useNonceInjection?: boolean;
+    /**
+     * Whether to calculate built size
+     * @default true
+     */
+    calculateBuiltSize?: boolean;
+    /**
+     * Whether in development mode (affects CSP)
+     * @default false
+     */
+    isDevMode?: boolean;
+    /**
+     * Additional plugins to add
+     */
+    additionalPlugins?: any[];
+}
+export declare const terserOptions: {
+    mangle: {
+        eval: boolean;
+        keep_fnames: boolean;
+        module: boolean;
+        toplevel: boolean;
+        safari10: boolean;
+    };
+    compress: {
+        drop_console: boolean;
+        drop_debugger: boolean;
+        passes: number;
+    };
+    format: {
+        comments: boolean;
+    };
+};
+/**
+ * Creates a base Vite configuration for applications.
+ */
+export declare function defineViteConfig(options?: ViteConfigOptions): (env: ConfigEnv) => UserConfig;
+/**
+ * Creates a Vite configuration preset for single-page applications.
+ * - Dev mode: No minification, readable output, fast HMR
+ * - Build mode: Full optimization with minification, single file output
+ */
+export declare function defineAppConfig(options?: ViteConfigOptions): (env: ConfigEnv) => UserConfig;
+/**
+ * Creates a Vite configuration preset for reusable packages.
+ * - Dev mode: No minification, readable output, fast HMR
+ * - Build mode: Full optimization with minification, single file output
+ */
+export declare function definePackageConfig(options?: ViteConfigOptions): (env: ConfigEnv) => UserConfig;
+/**
+ * Library build presets for different distribution targets
+ */
+export type LibraryPreset = "internal" | "npm-esm" | "npm-full" | "cdn" | "universal";
+export interface LibraryConfigOptions {
+    /**
+     * Package name (e.g., "@my-org/my-lib")
+     * Used for lib.name and test.name
+     */
+    name: string;
+    /**
+     * Entry point file
+     * @default "src/index.ts"
+     */
+    entry?: string;
+    /**
+     * External dependencies that should not be bundled.
+     * Can be strings or RegExp patterns.
+     * @example ["three", /^@some-org\//]
+     */
+    external?: (string | RegExp)[];
+    /**
+     * Test environment
+     * @default "node"
+     */
+    testEnvironment?: "node" | "jsdom";
+    /**
+     * Test setup files (relative paths from package root)
+     * @example ["./test/vitest.setup.ts", "../../test-utils/vitest-canvas-mock.ts"]
+     */
+    setupFiles?: string[];
+    /**
+     * Test timeout in milliseconds
+     * @default undefined (uses vitest default)
+     */
+    testTimeout?: number;
+    /**
+     * Whether tests should pass if no test files are found
+     * @default false
+     */
+    passWithNoTests?: boolean;
+    /**
+     * Additional plugins to add
+     */
+    additionalPlugins?: Plugin[];
+    /**
+     * Build behavior based on mode:
+     * - "mode-aware": sourcemap in dev only, minify in prod only (default)
+     * - "static": always sourcemap, never minify
+     * @default "mode-aware"
+     */
+    buildMode?: "mode-aware" | "static";
+    /**
+     * Enable base64 asset imports plugin.
+     * Allows importing files with ?base64 query to get base64 encoded content.
+     * Used for embedding WASM/JS files as base64 strings.
+     * @example import wasmBase64 from "./file.wasm?base64";
+     * @default false
+     */
+    useBase64Assets?: boolean;
+    /**
+     * Output directory
+     * @default "./build"
+     */
+    outDir?: string;
+    /**
+     * Library build preset. Determines which output formats are generated.
+     * - "internal": ES only (for monorepo internal use)
+     * - "npm-esm": ES + types (modern npm packages)
+     * - "npm-full": ES + CJS + types (maximum npm compatibility)
+     * - "cdn": UMD + IIFE minified (for script tags/CDN)
+     * - "universal": ALL formats (ES, CJS, UMD, IIFE + minified variants)
+     * @default "npm-full"
+     */
+    preset?: LibraryPreset;
+    /**
+     * Output formats for the library. Overrides preset if specified.
+     * @deprecated Use `preset` instead for standard configurations
+     */
+    formats?: ("es" | "cjs" | "umd" | "iife")[];
+    /**
+     * Global variable name for UMD/IIFE builds (e.g., "MyLibrary").
+     * Auto-generated from package name if not specified.
+     * Only used when UMD or IIFE formats are included.
+     * @example "Statecraft" for window.Statecraft
+     */
+    globalName?: string;
+    /**
+     * Whether to generate separate minified bundles for UMD/IIFE formats.
+     * Creates both index.umd.js and index.umd.min.js
+     * @default true when preset includes UMD/IIFE
+     */
+    minifiedBundles?: boolean;
+    /**
+     * Whether to roll up .d.ts files into a single file
+     * @default true
+     */
+    rollupTypes?: boolean;
+    /**
+     * Whether to always empty the output directory on build
+     * @default true
+     */
+    alwaysEmptyOutDir?: boolean;
+    /**
+     * Whether to preserve the module structure in the output.
+     * When true, Rollup emits one file per source module instead of bundling
+     * everything into a single chunk. This enables fine-grained tree-shaking
+     * in consuming bundlers.
+     *
+     * Only applies to ES and CJS formats (UMD/IIFE require bundling).
+     * @default false
+     */
+    preserveModules?: boolean;
+    /**
+     * Global variable mappings for UMD/IIFE external dependencies.
+     * Maps npm package names to the global variable they expose at runtime.
+     * @example { three: "THREE", react: "React", "react-dom": "ReactDOM" }
+     */
+    globals?: Record<string, string>;
+}
+/**
+ * Creates a Vite configuration preset for library packages.
+ * Supports all distribution formats.
+ *
+ * Features:
+ * - Automatic TypeScript declaration generation (dts plugin)
+ * - Multiple output formats: ES, CJS, UMD, IIFE
+ * - Preset system for common configurations
+ * - Separate minified bundles for CDN distribution
+ * - Proper file extensions (.mjs, .cjs, .umd.js, .iife.js)
+ * - Auto-generated global name for UMD/IIFE
+ * - External dependencies not bundled
+ * - Vitest configuration included
+ * - Mode-aware or static build options
+ *
+ * @example
+ * ```ts
+ * // Simple usage with preset (recommended)
+ * export default defineConfig(
+ *   defineLibraryConfig({
+ *     name: "my-lib",
+ *     preset: "npm-full"
+ *   })
+ * );
+ *
+ * // Universal distribution (all formats)
+ * export default defineConfig(
+ *   defineLibraryConfig({
+ *     name: "@my-org/model-loader",
+ *     preset: "universal",
+ *     globalName: "ModelLoader",
+ *     external: ["three"],
+ *     globals: { three: "THREE" }
+ *   })
+ * );
+ *
+ * // CDN-only distribution
+ * export default defineConfig(
+ *   defineLibraryConfig({
+ *     name: "@my-org/widget",
+ *     preset: "cdn",
+ *     globalName: "Widget"
+ *   })
+ * );
+ * ```
+ */
+export declare function defineLibraryConfig(options: LibraryConfigOptions): (env: ConfigEnv) => {
+    root: string;
+    cacheDir: string;
+    plugins: PluginOption[];
+    build: {
+        outDir: string;
+        emptyOutDir: boolean;
+        reportCompressedSize: boolean;
+        sourcemap: boolean;
+        minify: boolean | "terser";
+        terserOptions: {
+            mangle: {
+                eval: boolean;
+                keep_fnames: boolean;
+                module: boolean;
+                toplevel: boolean;
+                safari10: boolean;
+            };
+            compress: {
+                drop_console: boolean;
+                drop_debugger: boolean;
+                passes: number;
+            };
+            format: {
+                comments: boolean;
+            };
+        } | undefined;
+        commonjsOptions: {
+            transformMixedEsModules: boolean;
+        };
+        lib: {
+            entry: string;
+            name: string;
+            fileName: (format: string) => string;
+            formats: ("es" | "cjs" | "umd" | "iife")[];
+        };
+        rollupOptions: {
+            external: (string | RegExp)[];
+            output: {
+                preserveModules?: boolean | undefined;
+                preserveModulesRoot?: string | undefined;
+                globals: (id: string) => string;
+            };
+        };
+    };
+    test: Record<string, unknown>;
+};
+export * from "./plugins/index.js";
+export { resolve } from "path";
+export { defineConfig, mergeConfig } from "vite";
+export { dts };
+export type { Plugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}