@goodie-ts/vite-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GOOD Code ApS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { DiPluginOptions } from './options.js';
+export { diPlugin } from './plugin.js';
+//# 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":"AAEA,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// @goodie-ts/vite-plugin — Phase 4: Vite integration for compile-time DI
+export { diPlugin } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAGzE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,21 @@
+/** User-facing options for the Vite DI plugin. */
+export interface DiPluginOptions {
+    /** Path to tsconfig.json (relative to Vite root or absolute). Defaults to `"tsconfig.json"`. */
+    tsConfigPath?: string;
+    /** Path for the generated output file (relative to Vite root or absolute). Defaults to `"src/AppContext.generated.ts"`. */
+    outputPath?: string;
+    /** Source file globs to scan. Passed through to the transformer. */
+    include?: string[];
+    /** Debounce interval in ms for watch-mode rebuilds. Defaults to `100`. */
+    debounceMs?: number;
+}
+/** Resolved (absolute) options used internally by the plugin. */
+export interface ResolvedOptions {
+    tsConfigPath: string;
+    outputPath: string;
+    include: string[] | undefined;
+    debounceMs: number;
+}
+/** Resolve user options against the Vite project root, applying defaults. */
+export declare function resolveOptions(userOptions: DiPluginOptions | undefined, viteRoot: string): ResolvedOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2HAA2H;IAC3H,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,WAAW,EAAE,eAAe,GAAG,SAAS,EACxC,QAAQ,EAAE,MAAM,GACf,eAAe,CAajB"}

package/dist/options.js

@@ -0,0 +1,19 @@
+import path from 'node:path';
+const DEFAULT_TSCONFIG = 'tsconfig.json';
+const DEFAULT_OUTPUT = 'src/AppContext.generated.ts';
+const DEFAULT_DEBOUNCE_MS = 100;
+/** Resolve user options against the Vite project root, applying defaults. */
+export function resolveOptions(userOptions, viteRoot) {
+    const opts = userOptions ?? {};
+    return {
+        tsConfigPath: opts.tsConfigPath
+            ? path.resolve(viteRoot, opts.tsConfigPath)
+            : path.resolve(viteRoot, DEFAULT_TSCONFIG),
+        outputPath: opts.outputPath
+            ? path.resolve(viteRoot, opts.outputPath)
+            : path.resolve(viteRoot, DEFAULT_OUTPUT),
+        include: opts.include,
+        debounceMs: opts.debounceMs ?? DEFAULT_DEBOUNCE_MS,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAsB7B,MAAM,gBAAgB,GAAG,eAAe,CAAC;AACzC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AACrD,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAC5B,WAAwC,EACxC,QAAgB;IAEhB,MAAM,IAAI,GAAG,WAAW,IAAI,EAAE,CAAC;IAE/B,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC7B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC;YAC3C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QAC5C,UAAU,EAAE,IAAI,CAAC,UAAU;YACzB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC;QAC1C,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,mBAAmB;KACnD,CAAC;AACJ,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vite';
+import type { DiPluginOptions } from './options.js';
+/**
+ * Vite plugin that runs the @goodie compile-time DI transformer.
+ *
+ * - On `buildStart`: full transform, throws on error (aborts build).
+ * - On `handleHotUpdate`: debounced rebuild on `.ts` changes, logs errors without crashing.
+ */
+export declare function diPlugin(userOptions?: DiPluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIpD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,GAAG,MAAM,CAsE9D"}

package/dist/plugin.js

@@ -0,0 +1,73 @@
+import path from 'node:path';
+import { resolveOptions } from './options.js';
+import { runRebuild } from './rebuild.js';
+/**
+ * Vite plugin that runs the @goodie compile-time DI transformer.
+ *
+ * - On `buildStart`: full transform, throws on error (aborts build).
+ * - On `handleHotUpdate`: debounced rebuild on `.ts` changes, logs errors without crashing.
+ */
+export function diPlugin(userOptions) {
+    let resolved;
+    let debounceTimer;
+    return {
+        name: 'goodie',
+        enforce: 'pre',
+        configResolved(config) {
+            resolved = resolveOptions(userOptions, config.root);
+        },
+        buildStart() {
+            const outcome = runRebuild(resolved);
+            if (outcome.success) {
+                const count = outcome.result.beans.length;
+                const warnings = outcome.result.warnings;
+                console.log(`[goodie] Transform complete: ${count} bean(s) registered.`);
+                for (const w of warnings) {
+                    console.warn(`[goodie] Warning: ${w}`);
+                }
+            }
+            else {
+                throw outcome.error;
+            }
+        },
+        handleHotUpdate(ctx) {
+            const filePath = ctx.file;
+            // Only process .ts files
+            if (!filePath.endsWith('.ts'))
+                return;
+            // Skip the generated output file to prevent infinite loops
+            const normalizedOutput = path.normalize(resolved.outputPath);
+            const normalizedFile = path.normalize(filePath);
+            if (normalizedFile === normalizedOutput)
+                return;
+            // Debounced rebuild
+            if (debounceTimer !== undefined) {
+                clearTimeout(debounceTimer);
+            }
+            const { server } = ctx;
+            debounceTimer = setTimeout(() => {
+                debounceTimer = undefined;
+                const outcome = runRebuild(resolved);
+                if (outcome.success) {
+                    const count = outcome.result.beans.length;
+                    console.log(`[goodie] Rebuild complete: ${count} bean(s) registered.`);
+                    for (const w of outcome.result.warnings) {
+                        console.warn(`[goodie] Warning: ${w}`);
+                    }
+                }
+                else {
+                    console.error(`[goodie] Rebuild failed: ${outcome.error.message}`);
+                    server.ws.send({
+                        type: 'error',
+                        err: {
+                            message: outcome.error.message,
+                            stack: outcome.error.stack ?? '',
+                            plugin: 'goodie',
+                        },
+                    });
+                }
+            }, resolved.debounceMs);
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/rebuild.d.ts

@@ -0,0 +1,17 @@
+import type { TransformResult } from '@goodie-ts/transformer';
+import type { ResolvedOptions } from './options.js';
+export type RebuildSuccess = {
+    success: true;
+    result: TransformResult;
+};
+export type RebuildFailure = {
+    success: false;
+    error: Error;
+};
+export type RebuildOutcome = RebuildSuccess | RebuildFailure;
+/**
+ * Run the full DI transform pipeline, returning a discriminated union.
+ * This is the single swap-point for incremental rebuilds later.
+ */
+export declare function runRebuild(options: ResolvedOptions): RebuildOutcome;
+//# sourceMappingURL=rebuild.d.ts.map

package/dist/rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild.d.ts","sourceRoot":"","sources":["../src/rebuild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,cAAc,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAiBnE"}

package/dist/rebuild.js

@@ -0,0 +1,25 @@
+import { TransformerError, transform } from '@goodie-ts/transformer';
+/**
+ * Run the full DI transform pipeline, returning a discriminated union.
+ * This is the single swap-point for incremental rebuilds later.
+ */
+export function runRebuild(options) {
+    try {
+        const result = transform({
+            tsConfigFilePath: options.tsConfigPath,
+            outputPath: options.outputPath,
+            include: options.include,
+        });
+        return { success: true, result };
+    }
+    catch (error) {
+        if (error instanceof TransformerError) {
+            return { success: false, error };
+        }
+        return {
+            success: false,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+//# sourceMappingURL=rebuild.js.map

package/dist/rebuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild.js","sourceRoot":"","sources":["../src/rebuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAOrE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAwB;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC;YACvB,gBAAgB,EAAE,OAAO,CAAC,YAAY;YACtC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SACjE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@goodie-ts/vite-plugin",
+  "version": "0.1.0",
+  "description": "Vite plugin for goodie-ts compile-time dependency injection",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GOOD-Code-ApS/goodie.git",
+    "directory": "packages/vite-plugin"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@goodie-ts/transformer": "0.1.0"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "devDependencies": {
+    "vite": "^6.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}