@tecp/di 1.0.0

package/README.md

@@ -0,0 +1,92 @@
+# @tecp/di
+
+A lightweight, zero-dependency Dependency Injection container for TypeScript.
+
+## Install
+
+```bash
+pnpm add @tecp/di
+```
+
+## Usage
+
+### Decorator registration
+
+```ts
+import { di, singleton, transient } from '@tecp/di';
+
+@singleton()
+class DbService {
+  query(sql: string) {
+    return `result of ${sql}`;
+  }
+}
+
+@transient()
+class RequestContext {
+  id = Math.random();
+}
+
+const a = di(DbService);
+const b = di(DbService);
+console.log(a === b); // true
+
+const c = di(RequestContext);
+const d = di(RequestContext);
+console.log(c === d); // false
+```
+
+### Manual registration
+
+```ts
+import { di, regSingleton, regTransient } from '@tecp/di';
+
+class Logger {
+  log(msg: string) {
+    console.log(msg);
+  }
+}
+
+regSingleton(Logger);
+const l1 = di(Logger);
+const l2 = di(Logger);
+console.log(l1 === l2); // true
+```
+
+### Value and factory providers
+
+```ts
+import { di, regSingleton, regTransient } from '@tecp/di';
+
+const CONFIG = Symbol('config');
+
+regSingleton({ token: CONFIG, useValue: { db: 'sqlite' } });
+console.log(di(CONFIG)); // { db: 'sqlite' }
+
+let n = 0;
+const COUNTER = Symbol('counter');
+regTransient({ token: COUNTER, useFactory: () => ++n });
+console.log(di(COUNTER)); // 1
+console.log(di(COUNTER)); // 2
+```
+
+### Testing
+
+```ts
+import { di, regSingleton, clearRegistry } from '@tecp/di';
+
+clearRegistry(); // reset all registrations
+```
+
+## API
+
+| Function | Description |
+|---|---|
+| `regSingleton(provider)` | Register a singleton provider |
+| `regTransient(provider)` | Register a transient provider |
+| `di(token)` | Resolve a token to its instance |
+| `singleton()` | Decorator — registers class as singleton |
+| `transient()` | Decorator — registers class as transient |
+| `clearRegistry()` | Reset all registrations |
+
+A provider can be a class constructor or a `FullProvider` object with `token`, `useClass`, `useValue`, `useFactory`, and `isSingleton` fields.

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@tecp/di",
+  "version": "1.0.0",
+  "description": "",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "^11.0.6",
+      "onFail": "download"
+    }
+  },
+  "type": "module",
+  "devDependencies": {
+    "@biomejs/biome": "2.4.15",
+    "@types/node": "25.9.1",
+    "tsx": "4.22.3",
+    "typescript": "6.0.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.build.json",
+    "test": "node --import tsx --test \"./**/*.test.ts\""
+  }
+}