@codefast/di 0.3.15 → 0.3.16-canary.1

package/dist/types.d.mts

@@ -2,21 +2,50 @@ import { Constructor } from "./constructor-type.mjs";
 import { Token } from "./token.mjs";
 
 //#region src/types.d.ts
-/** Token or class constructor used as a binding / injection / resolve key. */
+/**
+ * Token or class constructor used as a binding / injection / resolve key.
+ *
+ * @since 0.3.16-canary.0
+ */
 type DependencyKey = Token<unknown> | Constructor;
+/**
+ * @since 0.3.16-canary.0
+ */
 type BindingScope = "singleton" | "transient" | "scoped";
 declare const BINDING_ID_BRAND: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
 type BindingIdentifier = string & {
   readonly [BINDING_ID_BRAND]: true;
 };
+/**
+ * @since 0.3.16-canary.0
+ */
 type BindingKind = "class" | "dynamic" | "dynamic-async" | "resolved" | "resolved-async" | "constant" | "alias";
+/**
+ * @since 0.3.16-canary.0
+ */
 type ActivationHandler<Value> = (ctx: ResolutionContext, instance: Value) => Value | Promise<Value>;
+/**
+ * @since 0.3.16-canary.0
+ */
 type DeactivationHandler<Value> = (instance: Value) => void | Promise<void>;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ResolveOptions {
   name?: string;
+  /**
+   * Single-tag shorthand — semantics match including one pair in `tags`.
+   * Enables fast-path lookup alongside `tags`.
+   */
   tag?: readonly [tag: string, value: unknown];
   tags?: ReadonlyArray<readonly [tag: string, value: unknown]>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface MaterializationFrame {
   readonly tokenName: string;
   readonly scope: BindingScope;
@@ -27,22 +56,31 @@ interface MaterializationFrame {
     readonly tags: ReadonlyArray<readonly [tag: string, value: unknown]>;
   };
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ConstraintContext {
-  readonly resolutionPath: readonly string[];
-  readonly materializationStack: readonly MaterializationFrame[];
+  readonly resolutionPath: ReadonlyArray<string>;
+  readonly materializationStack: ReadonlyArray<MaterializationFrame>;
   readonly parent: MaterializationFrame | undefined;
-  readonly ancestors: readonly MaterializationFrame[];
+  readonly ancestors: ReadonlyArray<MaterializationFrame>;
   readonly currentResolveHint: ResolveOptions | undefined;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ResolutionContext {
   resolve<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value;
   resolveAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value>;
   resolveOptional<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value | undefined;
   resolveOptionalAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value | undefined>;
-  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value[];
-  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value[]>;
+  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Array<Value>;
+  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Array<Value>>;
   readonly graph: ConstraintContext;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 type TokenValue<Type> = Type extends Token<infer Value> ? Value : Type extends Constructor<infer Value> ? Value : never;
 //#endregion
 export { ActivationHandler, BindingIdentifier, BindingKind, BindingScope, ConstraintContext, type Constructor, DeactivationHandler, DependencyKey, MaterializationFrame, ResolutionContext, ResolveOptions, TokenValue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/di",
-  "version": "0.3.15",
+  "version": "0.3.16-canary.1",
   "description": "Lightweight dependency injection primitives for Codefast",
   "keywords": [
     "codefast",
@@ -170,14 +170,16 @@
     "access": "public"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
-    "@typescript/native-preview": "7.0.0-dev.20260502.1",
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "7.0.0-dev.20260509.2",
     "@vitest/coverage-v8": "^4.1.5",
     "expect-type": "^1.3.0",
+    "tsdown": "^0.22.0",
+    "tsx": "^4.21.0",
     "typescript": "^6.0.3",
     "unplugin-swc": "^1.5.9",
     "vitest": "^4.1.5",
-    "@codefast/typescript-config": "0.3.15"
+    "@codefast/typescript-config": "0.3.16-canary.1"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -186,9 +188,13 @@
     "build": "tsdown",
     "check-types": "tsgo --noEmit",
     "clean": "rm -rf dist",
-    "examples": "for file in examples/*/*.ts; do echo \"=== Running $file ===\"; tsx \"$file\"; echo \"\n\" || exit 1; done",
+    "examples": "for file in examples/*/*.ts; do echo \"=== Running $file ===\"; node --import tsx/esm \"$file\"; echo \"\n\" || exit 1; done",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
+    "test:e2e": "vitest run tests/e2e",
+    "test:integration": "vitest run tests/integration",
+    "test:type": "vitest run tests/types",
+    "test:unit": "vitest run tests/unit",
     "test:watch": "vitest"
   }
 }