@djodjonx/neosyringe-plugin 0.0.1

package/README.md

@@ -0,0 +1,11 @@
+# @djodjonx/neosyringe-plugin
+
+The build plugin for NeoSyringe. Supports Vite, Rollup, Webpack, esbuild.
+
+## Installation
+
+```bash
+npm install -D @djodjonx/neosyringe-plugin
+```
+
+See [Documentation](https://djodjonx.github.io/neosyringe/guide/getting-started).

package/dist/index.cjs

@@ -0,0 +1,163 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let unplugin = require("unplugin");
+let typescript = require("typescript");
+typescript = __toESM(typescript);
+let _djodjonx_neosyringe_core_analyzer = require("@djodjonx/neosyringe-core/analyzer");
+let _djodjonx_neosyringe_core_generator = require("@djodjonx/neosyringe-core/generator");
+
+//#region src/index.ts
+/**
+* Registry of tokens that are registered in container files.
+* Used to validate useInterface<T>() calls in other files.
+*/
+const registeredTokens = /* @__PURE__ */ new Set();
+/**
+* Registry of tokens that are used (resolved) in non-container files.
+* Used to validate that all used tokens are registered.
+*/
+const usedTokens = /* @__PURE__ */ new Map();
+/**
+* Transforms useInterface<T>() calls into their tokenId string values.
+* This runs on ALL TypeScript files, not just container files.
+*
+* @param excludeRange - Optional range to exclude from transformation (used for defineBuilderConfig content)
+* @param collectUsedTokens - If true, collects used tokens for later validation
+*/
+function transformUseInterfaceCalls(code, id, compilerOptions, excludeRange, collectUsedTokens = false) {
+	if (!code.includes("useInterface")) return null;
+	const sourceFile = typescript.createSourceFile(id, code, typescript.ScriptTarget.Latest, true);
+	const compilerHost = typescript.createCompilerHost(compilerOptions);
+	const originalGetSourceFile = compilerHost.getSourceFile;
+	compilerHost.getSourceFile = (fileName, languageVersion) => {
+		if (fileName === id) return sourceFile;
+		return originalGetSourceFile(fileName, languageVersion);
+	};
+	const checker = typescript.createProgram([id], compilerOptions, compilerHost).getTypeChecker();
+	const replacements = [];
+	function visit(node) {
+		if (typescript.isCallExpression(node) && typescript.isIdentifier(node.expression) && node.expression.text === "useInterface" && node.typeArguments && node.typeArguments.length > 0) {
+			const nodeStart = node.getStart();
+			const nodeEnd = node.getEnd();
+			if (excludeRange && nodeStart >= excludeRange.start && nodeEnd <= excludeRange.end) {
+				typescript.forEachChild(node, visit);
+				return;
+			}
+			const typeArg = node.typeArguments[0];
+			const symbol = checker.getTypeFromTypeNode(typeArg).getSymbol();
+			if (symbol) {
+				const declarations = symbol.getDeclarations();
+				let tokenId;
+				if (declarations && declarations.length > 0) tokenId = (0, _djodjonx_neosyringe_core_analyzer.generateTokenId)(symbol, declarations[0].getSourceFile());
+				else tokenId = symbol.getName();
+				replacements.push({
+					start: nodeStart,
+					end: nodeEnd,
+					text: `"${tokenId}"`
+				});
+				if (collectUsedTokens && !usedTokens.has(tokenId)) {
+					const line = sourceFile.getLineAndCharacterOfPosition(nodeStart);
+					usedTokens.set(tokenId, {
+						file: id,
+						line: line.line + 1,
+						column: line.character + 1,
+						interfaceName: symbol.getName()
+					});
+				}
+			}
+		}
+		typescript.forEachChild(node, visit);
+	}
+	visit(sourceFile);
+	if (replacements.length === 0) return null;
+	let result = code;
+	for (const r of replacements.sort((a, b) => b.start - a.start)) result = result.slice(0, r.start) + r.text + result.slice(r.end);
+	return result;
+}
+/**
+* NeoSyringe build plugin for Vite, Rollup, Webpack, and other bundlers.
+*
+* Two transformations:
+* 1. Replaces `useInterface<T>()` calls with their tokenId strings (all files)
+* 2. Replaces `defineBuilderConfig` with generated container code (container files)
+*
+* @example
+* ```typescript
+* // vite.config.ts
+* import { neoSyringePlugin } from '@djodjonx/neosyringe/plugin';
+*
+* export default defineConfig({
+*   plugins: [neoSyringePlugin.vite()]
+* });
+* ```
+*/
+const neoSyringePlugin = (0, unplugin.createUnplugin)(() => {
+	return {
+		name: "neosyringe-plugin",
+		enforce: "pre",
+		transformInclude(id) {
+			return id.endsWith(".ts") || id.endsWith(".tsx");
+		},
+		transform(code, id) {
+			const configFile = typescript.findConfigFile(process.cwd(), typescript.sys.fileExists, "tsconfig.json");
+			if (!configFile) return;
+			const { config } = typescript.readConfigFile(configFile, typescript.sys.readFile);
+			const { options: compilerOptions } = typescript.parseJsonConfigFileContent(config, typescript.sys, process.cwd());
+			if (code.includes("defineBuilderConfig")) {
+				const graph = new _djodjonx_neosyringe_core_analyzer.Analyzer(typescript.createProgram([id], compilerOptions)).extract();
+				if (graph.nodes.size > 0 && graph.defineBuilderConfigStart !== void 0 && graph.defineBuilderConfigEnd !== void 0 && graph.variableStatementStart !== void 0) {
+					for (const tokenId of graph.nodes.keys()) registeredTokens.add(tokenId);
+					new _djodjonx_neosyringe_core_generator.GraphValidator().validate(graph);
+					const generator = new _djodjonx_neosyringe_core_generator.Generator(graph, true);
+					const containerClass = generator.generate();
+					const instantiation = generator.generateInstantiation();
+					const codeBeforeStatement = code.slice(0, graph.variableStatementStart);
+					const codeAfterDefineBuilder = code.slice(graph.defineBuilderConfigEnd);
+					const variableDeclaration = code.slice(graph.variableStatementStart, graph.defineBuilderConfigStart);
+					const codeWithContainer = codeBeforeStatement + containerClass + "\n" + variableDeclaration + instantiation + codeAfterDefineBuilder;
+					return transformUseInterfaceCalls(codeWithContainer, id, compilerOptions) || codeWithContainer;
+				}
+			}
+			return transformUseInterfaceCalls(code, id, compilerOptions, void 0, true);
+		},
+		buildEnd() {
+			const errors = [];
+			for (const [tokenId, usage] of usedTokens) if (!registeredTokens.has(tokenId)) errors.push(`[NeoSyringe] Unregistered token: useInterface<${usage.interfaceName}>() at ${usage.file}:${usage.line}:${usage.column}\n  Token "${tokenId}" is not registered in any container.\n  Add it to your defineBuilderConfig injections.`);
+			if (errors.length > 0) {
+				registeredTokens.clear();
+				usedTokens.clear();
+				throw new Error(`\n${"=".repeat(60)}\nNEO-SYRINGE: ${errors.length} unregistered token(s) found!\n${"=".repeat(60)}\n\n` + errors.join("\n\n") + `\n\n${"=".repeat(60)}\n`);
+			}
+			registeredTokens.clear();
+			usedTokens.clear();
+		}
+	};
+});
+
+//#endregion
+exports.neoSyringePlugin = neoSyringePlugin;

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import * as unplugin0 from "unplugin";
+
+//#region src/index.d.ts
+/**
+ * NeoSyringe build plugin for Vite, Rollup, Webpack, and other bundlers.
+ *
+ * Two transformations:
+ * 1. Replaces `useInterface<T>()` calls with their tokenId strings (all files)
+ * 2. Replaces `defineBuilderConfig` with generated container code (container files)
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { neoSyringePlugin } from '@djodjonx/neosyringe/plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [neoSyringePlugin.vite()]
+ * });
+ * ```
+ */
+declare const neoSyringePlugin: unplugin0.UnpluginInstance<unknown, boolean>;
+//#endregion
+export { neoSyringePlugin };

package/dist/index.d.mts

@@ -0,0 +1,23 @@
+import * as unplugin0 from "unplugin";
+
+//#region src/index.d.ts
+/**
+ * NeoSyringe build plugin for Vite, Rollup, Webpack, and other bundlers.
+ *
+ * Two transformations:
+ * 1. Replaces `useInterface<T>()` calls with their tokenId strings (all files)
+ * 2. Replaces `defineBuilderConfig` with generated container code (container files)
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { neoSyringePlugin } from '@djodjonx/neosyringe/plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [neoSyringePlugin.vite()]
+ * });
+ * ```
+ */
+declare const neoSyringePlugin: unplugin0.UnpluginInstance<unknown, boolean>;
+//#endregion
+export { neoSyringePlugin };

package/dist/index.mjs

@@ -0,0 +1,135 @@
+import { createUnplugin } from "unplugin";
+import * as ts from "typescript";
+import { Analyzer, generateTokenId } from "@djodjonx/neosyringe-core/analyzer";
+import { Generator, GraphValidator } from "@djodjonx/neosyringe-core/generator";
+
+//#region src/index.ts
+/**
+* Registry of tokens that are registered in container files.
+* Used to validate useInterface<T>() calls in other files.
+*/
+const registeredTokens = /* @__PURE__ */ new Set();
+/**
+* Registry of tokens that are used (resolved) in non-container files.
+* Used to validate that all used tokens are registered.
+*/
+const usedTokens = /* @__PURE__ */ new Map();
+/**
+* Transforms useInterface<T>() calls into their tokenId string values.
+* This runs on ALL TypeScript files, not just container files.
+*
+* @param excludeRange - Optional range to exclude from transformation (used for defineBuilderConfig content)
+* @param collectUsedTokens - If true, collects used tokens for later validation
+*/
+function transformUseInterfaceCalls(code, id, compilerOptions, excludeRange, collectUsedTokens = false) {
+	if (!code.includes("useInterface")) return null;
+	const sourceFile = ts.createSourceFile(id, code, ts.ScriptTarget.Latest, true);
+	const compilerHost = ts.createCompilerHost(compilerOptions);
+	const originalGetSourceFile = compilerHost.getSourceFile;
+	compilerHost.getSourceFile = (fileName, languageVersion) => {
+		if (fileName === id) return sourceFile;
+		return originalGetSourceFile(fileName, languageVersion);
+	};
+	const checker = ts.createProgram([id], compilerOptions, compilerHost).getTypeChecker();
+	const replacements = [];
+	function visit(node) {
+		if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "useInterface" && node.typeArguments && node.typeArguments.length > 0) {
+			const nodeStart = node.getStart();
+			const nodeEnd = node.getEnd();
+			if (excludeRange && nodeStart >= excludeRange.start && nodeEnd <= excludeRange.end) {
+				ts.forEachChild(node, visit);
+				return;
+			}
+			const typeArg = node.typeArguments[0];
+			const symbol = checker.getTypeFromTypeNode(typeArg).getSymbol();
+			if (symbol) {
+				const declarations = symbol.getDeclarations();
+				let tokenId;
+				if (declarations && declarations.length > 0) tokenId = generateTokenId(symbol, declarations[0].getSourceFile());
+				else tokenId = symbol.getName();
+				replacements.push({
+					start: nodeStart,
+					end: nodeEnd,
+					text: `"${tokenId}"`
+				});
+				if (collectUsedTokens && !usedTokens.has(tokenId)) {
+					const line = sourceFile.getLineAndCharacterOfPosition(nodeStart);
+					usedTokens.set(tokenId, {
+						file: id,
+						line: line.line + 1,
+						column: line.character + 1,
+						interfaceName: symbol.getName()
+					});
+				}
+			}
+		}
+		ts.forEachChild(node, visit);
+	}
+	visit(sourceFile);
+	if (replacements.length === 0) return null;
+	let result = code;
+	for (const r of replacements.sort((a, b) => b.start - a.start)) result = result.slice(0, r.start) + r.text + result.slice(r.end);
+	return result;
+}
+/**
+* NeoSyringe build plugin for Vite, Rollup, Webpack, and other bundlers.
+*
+* Two transformations:
+* 1. Replaces `useInterface<T>()` calls with their tokenId strings (all files)
+* 2. Replaces `defineBuilderConfig` with generated container code (container files)
+*
+* @example
+* ```typescript
+* // vite.config.ts
+* import { neoSyringePlugin } from '@djodjonx/neosyringe/plugin';
+*
+* export default defineConfig({
+*   plugins: [neoSyringePlugin.vite()]
+* });
+* ```
+*/
+const neoSyringePlugin = createUnplugin(() => {
+	return {
+		name: "neosyringe-plugin",
+		enforce: "pre",
+		transformInclude(id) {
+			return id.endsWith(".ts") || id.endsWith(".tsx");
+		},
+		transform(code, id) {
+			const configFile = ts.findConfigFile(process.cwd(), ts.sys.fileExists, "tsconfig.json");
+			if (!configFile) return;
+			const { config } = ts.readConfigFile(configFile, ts.sys.readFile);
+			const { options: compilerOptions } = ts.parseJsonConfigFileContent(config, ts.sys, process.cwd());
+			if (code.includes("defineBuilderConfig")) {
+				const graph = new Analyzer(ts.createProgram([id], compilerOptions)).extract();
+				if (graph.nodes.size > 0 && graph.defineBuilderConfigStart !== void 0 && graph.defineBuilderConfigEnd !== void 0 && graph.variableStatementStart !== void 0) {
+					for (const tokenId of graph.nodes.keys()) registeredTokens.add(tokenId);
+					new GraphValidator().validate(graph);
+					const generator = new Generator(graph, true);
+					const containerClass = generator.generate();
+					const instantiation = generator.generateInstantiation();
+					const codeBeforeStatement = code.slice(0, graph.variableStatementStart);
+					const codeAfterDefineBuilder = code.slice(graph.defineBuilderConfigEnd);
+					const variableDeclaration = code.slice(graph.variableStatementStart, graph.defineBuilderConfigStart);
+					const codeWithContainer = codeBeforeStatement + containerClass + "\n" + variableDeclaration + instantiation + codeAfterDefineBuilder;
+					return transformUseInterfaceCalls(codeWithContainer, id, compilerOptions) || codeWithContainer;
+				}
+			}
+			return transformUseInterfaceCalls(code, id, compilerOptions, void 0, true);
+		},
+		buildEnd() {
+			const errors = [];
+			for (const [tokenId, usage] of usedTokens) if (!registeredTokens.has(tokenId)) errors.push(`[NeoSyringe] Unregistered token: useInterface<${usage.interfaceName}>() at ${usage.file}:${usage.line}:${usage.column}\n  Token "${tokenId}" is not registered in any container.\n  Add it to your defineBuilderConfig injections.`);
+			if (errors.length > 0) {
+				registeredTokens.clear();
+				usedTokens.clear();
+				throw new Error(`\n${"=".repeat(60)}\nNEO-SYRINGE: ${errors.length} unregistered token(s) found!\n${"=".repeat(60)}\n\n` + errors.join("\n\n") + `\n\n${"=".repeat(60)}\n`);
+			}
+			registeredTokens.clear();
+			usedTokens.clear();
+		}
+	};
+});
+
+//#endregion
+export { neoSyringePlugin };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@djodjonx/neosyringe-plugin",
+  "version": "0.0.1",
+  "description": "NeoSyringe build plugin (Vite, Rollup, Webpack)",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "unplugin": "^2.0.0",
+    "@djodjonx/neosyringe-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "tsdown": "0.20.0-beta.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}