@macroforge/vite-plugin 0.1.42 → 0.1.43

package/dist/index.d.ts

@@ -1,186 +0,0 @@
-/**
- * @module @macroforge/vite-plugin
- *
- * Vite plugin for Macroforge compile-time TypeScript macro expansion.
- *
- * This plugin integrates Macroforge's Rust-based macro expander into the Vite build pipeline,
- * enabling compile-time code generation through `@derive` decorators. It processes TypeScript
- * files during the build, expands macros, generates type definitions, and emits metadata.
- *
- * @example
- * ```typescript
- * // vite.config.ts
- * import { defineConfig } from 'vite';
- * import macroforgePlugin from '@macroforge/vite-plugin';
- *
- * export default defineConfig({
- *   plugins: [
- *     macroforgePlugin({
- *       generateTypes: true,
- *       typesOutputDir: 'src/types/generated',
- *       emitMetadata: true,
- *     }),
- *   ],
- * });
- * ```
- *
- * @packageDocumentation
- */
-import { Plugin } from "vite";
-/**
- * Configuration options for the Macroforge Vite plugin.
- *
- * @public
- * @example
- * ```typescript
- * const options: NapiMacrosPluginOptions = {
- *   include: ['src/**\/*.ts'],
- *   exclude: ['**\/*.test.ts'],
- *   generateTypes: true,
- *   typesOutputDir: 'src/types/generated',
- *   emitMetadata: true,
- *   metadataOutputDir: 'src/macros/metadata',
- * };
- * ```
- */
-export interface NapiMacrosPluginOptions {
-    /**
-     * Glob patterns, regular expressions, or arrays of either to specify which files
-     * should be processed by the macro expander.
-     *
-     * @remarks
-     * If not specified, all `.ts` and `.tsx` files (excluding `node_modules`) are processed.
-     *
-     * @example
-     * ```typescript
-     * include: ['src/**\/*.ts', /components\/.*\.tsx$/]
-     * ```
-     */
-    include?: string | RegExp | (string | RegExp)[];
-    /**
-     * Glob patterns, regular expressions, or arrays of either to specify which files
-     * should be excluded from macro processing.
-     *
-     * @remarks
-     * Files in `node_modules` are always excluded by default.
-     *
-     * @example
-     * ```typescript
-     * exclude: ['**\/*.test.ts', '**\/*.spec.ts']
-     * ```
-     */
-    exclude?: string | RegExp | (string | RegExp)[];
-    /**
-     * Whether to generate TypeScript declaration files (`.d.ts`) for transformed code.
-     *
-     * @remarks
-     * When enabled, the plugin uses the TypeScript compiler to emit declaration files
-     * based on the macro-expanded code. This ensures type definitions accurately reflect
-     * the generated code.
-     *
-     * @default true
-     */
-    generateTypes?: boolean;
-    /**
-     * Output directory for generated TypeScript declaration files.
-     *
-     * @remarks
-     * Path is relative to the project root. The directory structure of the source files
-     * is preserved within this output directory.
-     *
-     * @default "src/macros/generated"
-     *
-     * @example
-     * ```typescript
-     * // Source: src/models/User.ts
-     * // Output: src/types/generated/models/User.d.ts
-     * typesOutputDir: 'src/types/generated'
-     * ```
-     */
-    typesOutputDir?: string;
-    /**
-     * Whether to emit macro intermediate representation (IR) metadata as JSON files.
-     *
-     * @remarks
-     * The metadata contains information about which macros were applied, their configurations,
-     * and the transformation results. This can be useful for debugging, tooling integration,
-     * or build analysis.
-     *
-     * @default true
-     */
-    emitMetadata?: boolean;
-    /**
-     * Output directory for macro IR metadata JSON files.
-     *
-     * @remarks
-     * Path is relative to the project root. If not specified, defaults to the same
-     * directory as `typesOutputDir`. Metadata files are named with a `.macro-ir.json` suffix.
-     *
-     * @default Same as `typesOutputDir`
-     *
-     * @example
-     * ```typescript
-     * // Source: src/models/User.ts
-     * // Output: src/macros/metadata/models/User.macro-ir.json
-     * metadataOutputDir: 'src/macros/metadata'
-     * ```
-     */
-    metadataOutputDir?: string;
-}
-/**
- * Creates a Vite plugin for Macroforge compile-time macro expansion.
- *
- * @remarks
- * This is the main entry point for integrating Macroforge into a Vite build pipeline.
- * The plugin:
- *
- * 1. **Runs early** (`enforce: "pre"`) to transform code before other plugins
- * 2. **Processes TypeScript files** (`.ts` and `.tsx`) excluding `node_modules`
- * 3. **Expands macros** using the Macroforge Rust binary via `expandSync()`
- * 4. **Generates type definitions** for transformed code (optional, default: enabled)
- * 5. **Emits metadata** about macro transformations (optional, default: enabled)
- *
- * **Plugin Lifecycle:**
- * - `configResolved`: Initializes project root, loads config, and attempts to load Rust binary
- * - `transform`: Processes each TypeScript file through the macro expander
- *
- * **Error Handling:**
- * - If the Rust binary is not available, files pass through unchanged
- * - Macro expansion errors are reported via Vite's `this.error()` mechanism
- * - TypeScript emission errors are logged as warnings
- *
- * @param options - Plugin configuration options
- *
- * @returns A Vite plugin instance
- *
- * @public
- *
- * @example
- * ```typescript
- * // Basic usage
- * import macroforgePlugin from '@macroforge/vite-plugin';
- *
- * export default defineConfig({
- *   plugins: [macroforgePlugin()],
- * });
- * ```
- *
- * @example
- * ```typescript
- * // With custom options
- * import macroforgePlugin from '@macroforge/vite-plugin';
- *
- * export default defineConfig({
- *   plugins: [
- *     macroforgePlugin({
- *       generateTypes: true,
- *       typesOutputDir: 'src/types/generated',
- *       emitMetadata: false,
- *     }),
- *   ],
- * });
- * ```
- */
-declare function napiMacrosPlugin(options?: NapiMacrosPluginOptions): Plugin;
-export default napiMacrosPlugin;
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA4D9B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAEhD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAEhD;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA0OD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,iBAAS,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAwUvE;AAED,eAAe,gBAAgB,CAAC"}