@codefast/di 0.3.15 → 0.3.16-canary.0

package/dist/metadata/symbol-metadata-reader.mjs

@@ -1,5 +1,8 @@
 import { INJECTABLE_KEY, INJECT_ACCESSOR_KEY, LIFECYCLE_KEY, constructorMetadataMap, lifecycleByConstructorMetadataMap, lifecycleMetadataMap } from "./metadata-keys.mjs";
 //#region src/metadata/symbol-metadata-reader.ts
+/**
+* @since 0.3.16-canary.0
+*/
 var SymbolMetadataReader = class {
 	getConstructorMetadata(target) {
 		const fromWeakMap = constructorMetadataMap.get(target);
@@ -33,6 +36,9 @@ var SymbolMetadataReader = class {
 		return meta[INJECT_ACCESSOR_KEY];
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 const defaultMetadataReader = new SymbolMetadataReader();
 //#endregion
 export { SymbolMetadataReader, defaultMetadataReader };

package/dist/module.d.mts

@@ -5,34 +5,58 @@ import { BindToBuilder } from "./binding.mjs";
 //#region src/module.d.ts
 declare const SYNC_MODULE_BRAND: unique symbol;
 declare const ASYNC_MODULE_BRAND: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface SyncModule {
   readonly name: string;
   readonly [SYNC_MODULE_BRAND]: true;
   readonly _setup: (builder: ModuleBuilder) => void;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface AsyncModule {
   readonly name: string;
   readonly [ASYNC_MODULE_BRAND]: true;
   readonly _setup: (builder: AsyncModuleBuilder) => Promise<void>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ModuleBuilder {
   bind<const Value>(token: Token<Value> | Constructor<Value>): BindToBuilder<Value>;
   import(...modules: SyncModule[]): void;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface AsyncModuleBuilder {
   bind<const Value>(token: Token<Value> | Constructor<Value>): BindToBuilder<Value>;
   import(...modules: Array<SyncModule | AsyncModule>): void;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const SyncModule: {
   create(name: string, setup: (builder: ModuleBuilder) => void): SyncModule;
 };
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const AsyncModule: {
   create(name: string, setup: (builder: AsyncModuleBuilder) => Promise<void>): AsyncModule;
 };
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const Module: {
   create(name: string, setup: (builder: ModuleBuilder) => void): SyncModule;
   createAsync(name: string, setup: (builder: AsyncModuleBuilder) => Promise<void>): AsyncModule;
 };
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function isSyncModule(m: SyncModule | AsyncModule): m is SyncModule;
 //#endregion
 export { AsyncModule, AsyncModuleBuilder, Module, ModuleBuilder, SyncModule, isSyncModule };

package/dist/module.mjs

@@ -1,6 +1,9 @@
 //#region src/module.ts
 const SYNC_MODULE_BRAND = Symbol("di:sync-module");
 const ASYNC_MODULE_BRAND = Symbol("di:async-module");
+/**
+* @since 0.3.16-canary.0
+*/
 const SyncModule = { create(name, setup) {
 	return {
 		name,
@@ -8,6 +11,9 @@ const SyncModule = { create(name, setup) {
 		_setup: setup
 	};
 } };
+/**
+* @since 0.3.16-canary.0
+*/
 const AsyncModule = { create(name, setup) {
 	return {
 		name,
@@ -15,6 +21,9 @@ const AsyncModule = { create(name, setup) {
 		_setup: setup
 	};
 } };
+/**
+* @since 0.3.16-canary.0
+*/
 const Module = {
 	create(name, setup) {
 		return SyncModule.create(name, setup);
@@ -23,6 +32,9 @@ const Module = {
 		return AsyncModule.create(name, setup);
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 function isSyncModule(m) {
 	return m[SYNC_MODULE_BRAND] === true;
 }

package/dist/registry.d.mts

@@ -4,6 +4,9 @@ import { BindingIdentifier } from "./types.mjs";
 import { Binding } from "./binding.mjs";
 
 //#region src/registry.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class BindingRegistry {
   private readonly _bindings;
   private readonly _byId;

package/dist/registry.mjs

@@ -1,5 +1,8 @@
 import { slotKeyEquals } from "./binding.mjs";
 //#region src/registry.ts
+/**
+* @since 0.3.16-canary.0
+*/
 var BindingRegistry = class {
 	_bindings = /* @__PURE__ */ new Map();
 	_byId = /* @__PURE__ */ new Map();

package/dist/resolve-options.d.mts

@@ -5,6 +5,8 @@ import { SlotKey } from "./binding.mjs";
 /**
  * Builds a {@link ResolveOptions} safe for `exactOptionalPropertyTypes`:
  * omits keys instead of assigning `undefined`.
+ *
+ * @since 0.3.16-canary.0
  */
 declare function injectableSlotToResolveOptions(slot: {
   readonly name?: string;
@@ -12,6 +14,8 @@ declare function injectableSlotToResolveOptions(slot: {
 }): ResolveOptions | undefined;
 /**
  * Hint from a binding {@link SlotKey} (tags may be empty; omits when nothing to match).
+ *
+ * @since 0.3.16-canary.0
  */
 declare function slotKeyToResolveOptions(slot: SlotKey): ResolveOptions | undefined;
 //#endregion

package/dist/resolve-options.mjs

@@ -2,6 +2,8 @@
 /**
 * Builds a {@link ResolveOptions} safe for `exactOptionalPropertyTypes`:
 * omits keys instead of assigning `undefined`.
+*
+* @since 0.3.16-canary.0
 */
 function injectableSlotToResolveOptions(slot) {
 	const options = {};
@@ -11,6 +13,8 @@ function injectableSlotToResolveOptions(slot) {
 }
 /**
 * Hint from a binding {@link SlotKey} (tags may be empty; omits when nothing to match).
+*
+* @since 0.3.16-canary.0
 */
 function slotKeyToResolveOptions(slot) {
 	const options = {};

package/dist/resolver.d.mts

@@ -8,6 +8,9 @@ import { Container } from "./container.mjs";
 import { LifecycleManager } from "./lifecycle.mjs";
 
 //#region src/resolver.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class DependencyResolver {
   private readonly _registry;
   private readonly _scope;

package/dist/resolver.mjs

@@ -15,6 +15,9 @@ const ROOT_CONSTRAINT_CONTEXT = {
 	ancestors: EMPTY_FRAME_LIST,
 	currentResolveHint: void 0
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var DependencyResolver = class {
 	_frameByBindingId = /* @__PURE__ */ new Map();
 	_syncResolutionContextPool = [];

package/dist/scope.d.mts

@@ -1,6 +1,9 @@
 import { BindingIdentifier } from "./types.mjs";
 
 //#region src/scope.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class ScopeManager {
   private readonly _singletons;
   private readonly _inflight;

package/dist/scope.mjs

@@ -1,5 +1,8 @@
 import { MissingScopeContextError } from "./errors.mjs";
 //#region src/scope.ts
+/**
+* @since 0.3.16-canary.0
+*/
 var ScopeManager = class {
 	_singletons = /* @__PURE__ */ new Map();
 	_inflight = /* @__PURE__ */ new Map();

package/dist/token.d.mts

@@ -2,12 +2,24 @@ import { Constructor } from "./constructor-type.mjs";
 
 //#region src/token.d.ts
 declare const TOKEN_BRAND: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface Token<Value> {
   readonly name: string;
   readonly [TOKEN_BRAND]: Value;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function token<Value>(name: string): Token<Value>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function tokenName(t: Token<unknown> | Constructor): string;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function isToken(value: unknown): value is Token<unknown>;
 //#endregion
 export { Token, isToken, token, tokenName };

package/dist/token.mjs

@@ -1,11 +1,20 @@
 //#region src/token.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function token(name) {
 	return { name };
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function tokenName(t) {
 	if (typeof t === "function") return t.name;
 	return t.name;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function isToken(value) {
 	return typeof value === "object" && value !== null && "name" in value && typeof value["name"] === "string" && typeof value !== "function";
 }

package/dist/types.d.mts

@@ -2,21 +2,46 @@ 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;
   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,6 +52,9 @@ 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[];
@@ -34,6 +62,9 @@ interface ConstraintContext {
   readonly ancestors: readonly 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>;
@@ -43,6 +74,9 @@ interface ResolutionContext {
   resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<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.0",
   "description": "Lightweight dependency injection primitives for Codefast",
   "keywords": [
     "codefast",
@@ -171,13 +171,13 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "@typescript/native-preview": "7.0.0-dev.20260502.1",
+    "@typescript/native-preview": "7.0.0-dev.20260504.1",
     "@vitest/coverage-v8": "^4.1.5",
     "expect-type": "^1.3.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.0"
   },
   "engines": {
     "node": ">=22.0.0"