@codefast/di 0.3.16-canary.3 → 0.4.0-canary.5

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @codefast/di
 
+## 0.4.0-canary.5
+
+## 0.4.0-canary.4
+
+### Patch Changes
+
+- [#495](https://github.com/codefastlabs/codefast/pull/495) [`a66946d`](https://github.com/codefastlabs/codefast/commit/a66946d7b4f249927caea567232a9c05cd861020) Thanks [@thevuong](https://github.com/thevuong)! - Drop redundant type assertions in the container, resolver, decorators, and module wiring — behavior is unchanged; the types now flow without casts.
+
+- [#495](https://github.com/codefastlabs/codefast/pull/495) [`fa338d6`](https://github.com/codefastlabs/codefast/commit/fa338d61fbfafb94beaa4d05d93d01e2c005cc91) Thanks [@thevuong](https://github.com/thevuong)! - Normalize import statement order and package.json key order repo-wide via the new oxfmt `sortImports`/`sortPackageJson` settings — purely mechanical, no runtime behavior change.
+
 ## 0.3.16-canary.3
 
 ### Patch Changes

package/README.md

@@ -62,7 +62,7 @@ Type-safe, ESM-only dependency injection for modern TypeScript — built on TC39
 
 ## Requirements
 
-- Node.js `>= 22.0.0` (see `package.json` → `engines`)
+- Node.js `>= 24.0.0` (see `package.json` → `engines`)
 - TypeScript `>= 5.2` with native Stage 3 decorators (TypeScript `5.9+` recommended for best inference, consistent with other Codefast packages)
 
 Enable native decorators in `tsconfig.json` — do **not** enable `experimentalDecorators`:
@@ -203,14 +203,9 @@ container.bind(DbToken).toDynamicAsync(async (ctx) => {
 
 container
   .bind(UserServiceToken)
-  .toResolved((repository, config) => new UserService(repository, config), [
-    UserRepository,
-    AppConfigToken,
-  ] as const);
+  .toResolved((repository, config) => new UserService(repository, config), [UserRepository, AppConfigToken] as const);
 
-container
-  .bind(MetricsToken)
-  .toResolvedAsync(async (db) => new MetricsCollector(db), [DbToken] as const);
+container.bind(MetricsToken).toResolvedAsync(async (db) => new MetricsCollector(db), [DbToken] as const);
 
 container.bind(LegacyServiceToken).toAlias(NewServiceToken);
 ```
@@ -602,12 +597,7 @@ All errors extend `DiError` and expose a stable `code` property.
 | `TokenNotBoundError`            | `"TOKEN_NOT_BOUND"`             | Required token has no binding                                           |
 
 ```typescript
-import {
-  AmbiguousBindingError,
-  DiError,
-  ScopeViolationError,
-  TokenNotBoundError,
-} from "@codefast/di";
+import { AmbiguousBindingError, DiError, ScopeViolationError, TokenNotBoundError } from "@codefast/di";
 
 try {
   container.resolve(ServiceToken);
@@ -615,9 +605,7 @@ try {
   if (error instanceof TokenNotBoundError) {
     console.error(`Not registered: ${error.tokenName}`);
   } else if (error instanceof ScopeViolationError) {
-    console.error(
-      `Scope violation: ${error.details.consumerToken} → ${error.details.dependencyToken}`,
-    );
+    console.error(`Scope violation: ${error.details.consumerToken} → ${error.details.dependencyToken}`);
   } else if (error instanceof AmbiguousBindingError) {
     console.error(`Ambiguous: ${error.tokenName}`, error.candidateIds);
   } else if (error instanceof DiError) {

package/dist/container.d.mts

@@ -2,10 +2,10 @@ import { Constructor } from "./constructor-type.mjs";
 import { Token } from "./token.mjs";
 import { ActivationHandler, BindingIdentifier, DeactivationHandler, ResolveOptions } from "./types.mjs";
 import { BindToBuilder } from "./binding.mjs";
-import { AsyncModule, SyncModule } from "./module.mjs";
-import { BindingSnapshot, ContainerSnapshot } from "./inspector.mjs";
-import { ContainerGraphJson, GraphOptions } from "./dependency-graph.mjs";
 import { AutoRegisterRegistry } from "./decorators/injectable.mjs";
+import { ContainerGraphJson, GraphOptions } from "./dependency-graph.mjs";
+import { BindingSnapshot, ContainerSnapshot } from "./inspector.mjs";
+import { AsyncModule, SyncModule } from "./module.mjs";
 
 //#region src/container.d.ts
 /**

package/dist/container.mjs

@@ -2,17 +2,17 @@ import { effectiveBindingScope } from "./binding-scope.mjs";
 import { AsyncModuleLoadError, CircularDependencyError, DisposedContainerError, InternalError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError } from "./errors.mjs";
 import { DEFAULT_BINDING_SLOT, generateBindingId } from "./binding.mjs";
 import { tokenName } from "./token.mjs";
-import { BindingRegistry } from "./registry.mjs";
-import { ScopeManager } from "./scope.mjs";
-import { LifecycleManager } from "./lifecycle.mjs";
 import { bindingSlotToResolveOptions, injectionSlotToResolveOptions } from "./resolve-options.mjs";
-import { DependencyResolver } from "./resolver.mjs";
-import { Inspector } from "./inspector.mjs";
+import { normalizeToDescriptor } from "./decorators/inject.mjs";
 import { buildDependencyGraph } from "./dependency-graph.mjs";
-import { defaultMetadataReader } from "./metadata/symbol-metadata-reader.mjs";
+import { Inspector } from "./inspector.mjs";
+import { LifecycleManager } from "./lifecycle.mjs";
 import { MetadataReaderToken } from "./metadata/metadata-reader-token.mjs";
-import { normalizeToDescriptor } from "./decorators/inject.mjs";
+import { defaultMetadataReader } from "./metadata/symbol-metadata-reader.mjs";
 import { isSyncModule } from "./module.mjs";
+import { BindingRegistry } from "./registry.mjs";
+import { DependencyResolver } from "./resolver.mjs";
+import { ScopeManager } from "./scope.mjs";
 //#region src/container.ts
 var DefaultContainer = class DefaultContainer {
 	_disposed = false;

package/dist/decorators/inject.mjs

@@ -1,7 +1,7 @@
 import { InternalError, MissingContainerContextError } from "../errors.mjs";
 import { getActiveContainer } from "../environment.mjs";
-import { injectionSlotToResolveOptions } from "../resolve-options.mjs";
 import { INJECT_ACCESSOR_KEY } from "../metadata/metadata-keys.mjs";
+import { injectionSlotToResolveOptions } from "../resolve-options.mjs";
 //#region src/decorators/inject.ts
 /**
 * @since 0.3.16-canary.0
@@ -83,7 +83,7 @@ function buildInjectionDescriptor(token, options) {
 function inject(token, options) {
 	const descriptor = buildInjectionDescriptor(token, options);
 	const decoratorFn = (_target, context) => {
-		if (context.static === true) throw new InternalError("@inject() on static accessors is not supported; only instance accessors participate in runWithContainer-based property injection.");
+		if (context.static) throw new InternalError("@inject() on static accessors is not supported; only instance accessors participate in runWithContainer-based property injection.");
 		const meta = context.metadata;
 		if (!Array.isArray(meta[INJECT_ACCESSOR_KEY])) meta[INJECT_ACCESSOR_KEY] = [];
 		meta[INJECT_ACCESSOR_KEY].push({

package/dist/decorators/lifecycle-decorators.mjs

@@ -9,7 +9,7 @@ function appendUniqueMethod(metadata, phase, methodName) {
 */
 function postConstruct() {
 	return function(target, context) {
-		if (context.static === true) throw new InternalError("@postConstruct() applies to instance methods only; static methods are not invoked during instance lifecycle.");
+		if (context.static) throw new InternalError("@postConstruct() applies to instance methods only; static methods are not invoked during instance lifecycle.");
 		const methodName = String(context.name);
 		const meta = context.metadata;
 		if (!meta[LIFECYCLE_KEY]) meta[LIFECYCLE_KEY] = {
@@ -24,7 +24,7 @@ function postConstruct() {
 */
 function preDestroy() {
 	return function(target, context) {
-		if (context.static === true) throw new InternalError("@preDestroy() applies to instance methods only; static methods are not invoked during instance teardown.");
+		if (context.static) throw new InternalError("@preDestroy() applies to instance methods only; static methods are not invoked during instance teardown.");
 		const methodName = String(context.name);
 		const meta = context.metadata;
 		if (!meta[LIFECYCLE_KEY]) meta[LIFECYCLE_KEY] = {

package/dist/dependency-graph.d.mts

@@ -1,6 +1,6 @@
 import { BindingScope } from "./types.mjs";
-import { BindingRegistry } from "./registry.mjs";
 import { MetadataReader } from "./metadata/metadata-types.mjs";
+import { BindingRegistry } from "./registry.mjs";
 
 //#region src/dependency-graph.d.ts
 /**

package/dist/index.d.mts

@@ -5,11 +5,11 @@ import { InjectOptions, InjectableDependency, InjectionDescriptor, inject, injec
 import { AliasBindingBuilder, BindToBuilder, BindingBuilder, ConstantBindingBuilder, ScopedBindingBuilder, SingletonBindingBuilder, SingletonLifecycleBuilder, SlotConstrainedBuilder, TransientBindingBuilder } from "./binding.mjs";
 import { effectiveBindingScope } from "./binding-scope.mjs";
 import { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll } from "./constraints.mjs";
-import { AsyncModule, AsyncModuleBuilder, Module, ModuleBuilder, SyncModule, isSyncModule } from "./module.mjs";
-import { BindingSnapshot, ContainerSnapshot } from "./inspector.mjs";
+import { AutoRegisterRegistry, InjectableOptions, createAutoRegisterRegistry, injectable } from "./decorators/injectable.mjs";
 import { MetadataReader, MutableLifecycleMetadata } from "./metadata/metadata-types.mjs";
 import { ContainerGraphJson, GraphEdge, GraphNode, GraphOptions } from "./dependency-graph.mjs";
-import { AutoRegisterRegistry, InjectableOptions, createAutoRegisterRegistry, injectable } from "./decorators/injectable.mjs";
+import { BindingSnapshot, ContainerSnapshot } from "./inspector.mjs";
+import { AsyncModule, AsyncModuleBuilder, Module, ModuleBuilder, SyncModule, isSyncModule } from "./module.mjs";
 import { Container, ContainerStatic } from "./container.mjs";
 import { postConstruct, preDestroy } from "./decorators/lifecycle-decorators.mjs";
 import { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationDetails, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError } from "./errors.mjs";

package/dist/index.mjs

@@ -3,8 +3,8 @@ import { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, As
 import { isToken, token, tokenName } from "./token.mjs";
 import { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll } from "./constraints.mjs";
 import { bindingSlotToResolveOptions, injectionSlotToResolveOptions } from "./resolve-options.mjs";
-import { MetadataReaderToken } from "./metadata/metadata-reader-token.mjs";
 import { inject, injectAll, isInjectionDescriptor, optional } from "./decorators/inject.mjs";
+import { MetadataReaderToken } from "./metadata/metadata-reader-token.mjs";
 import { AsyncModule, Module, SyncModule, isSyncModule } from "./module.mjs";
 import { Container } from "./container.mjs";
 import { createAutoRegisterRegistry, injectable } from "./decorators/injectable.mjs";

package/dist/module.mjs

@@ -36,7 +36,7 @@ const Module = {
 * @since 0.3.16-canary.0
 */
 function isSyncModule(module) {
-	return module[SYNC_MODULE_BRAND] === true;
+	return module[SYNC_MODULE_BRAND];
 }
 //#endregion
 export { AsyncModule, Module, SyncModule, isSyncModule };

package/dist/resolver.d.mts

@@ -2,9 +2,9 @@ import { Constructor } from "./constructor-type.mjs";
 import { Token } from "./token.mjs";
 import { ResolutionFrame, ResolveOptions } from "./types.mjs";
 import { Binding } from "./binding.mjs";
+import { MetadataReader } from "./metadata/metadata-types.mjs";
 import { BindingRegistry } from "./registry.mjs";
 import { ScopeManager } from "./scope.mjs";
-import { MetadataReader } from "./metadata/metadata-types.mjs";
 import { Container } from "./container.mjs";
 import { LifecycleManager } from "./lifecycle.mjs";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/di",
-  "version": "0.3.16-canary.3",
+  "version": "0.4.0-canary.5",
   "description": "Lightweight dependency injection primitives for Codefast",
   "keywords": [
     "codefast",
@@ -198,15 +198,15 @@
   "devDependencies": {
     "@babel/plugin-proposal-decorators": "8.0.0-rc.6",
     "@rolldown/plugin-babel": "^0.2.3",
-    "@types/node": "^25.9.1",
-    "@typescript/native-preview": "7.0.0-dev.20260526.1",
-    "@vitest/coverage-v8": "^4.1.7",
+    "@types/node": "^25.9.3",
+    "@typescript/native-preview": "7.0.0-dev.20260611.2",
+    "@vitest/coverage-v8": "^4.1.8",
     "expect-type": "^1.3.0",
-    "tsdown": "^0.22.0",
-    "tsx": "^4.22.3",
+    "tsdown": "^0.22.2",
+    "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7",
-    "@codefast/typescript-config": "0.3.16-canary.3"
+    "vitest": "^4.1.8",
+    "@codefast/typescript-config": "0.4.0-canary.5"
   },
   "engines": {
     "node": ">=24.0.0"

package/src/binding-select.ts

@@ -1,6 +1,6 @@
 import type { Binding } from "#/binding";
-import type { BindingTag, ConstraintContext, ResolveOptions } from "#/types";
 import { AmbiguousBindingError } from "#/errors";
+import type { BindingTag, ConstraintContext, ResolveOptions } from "#/types";
 
 /**
  * Select a single candidate from a list of bindings using slot matching + predicates.
@@ -70,10 +70,7 @@ function filterBindings(
 
   const result: Array<Binding> = [];
   for (const binding of bindings) {
-    const slotMatched =
-      selectionMode === "all"
-        ? matchesSlotForResolveAll(binding, hint)
-        : matchesSlot(binding, hint);
+    const slotMatched = selectionMode === "all" ? matchesSlotForResolveAll(binding, hint) : matchesSlot(binding, hint);
     if (slotMatched && matchesPredicate(binding, ctx)) {
       result.push(binding);
     }
@@ -84,9 +81,7 @@ function filterBindings(
 function matchesSlotForResolveAll(binding: Binding, hint: ResolveOptions | undefined): boolean {
   const hasExplicitSlotFilter =
     hint !== undefined &&
-    (hint.name !== undefined ||
-      (hint.tags !== undefined && hint.tags.length > 0) ||
-      hint.tag !== undefined);
+    (hint.name !== undefined || (hint.tags !== undefined && hint.tags.length > 0) || hint.tag !== undefined);
   if (!hasExplicitSlotFilter) {
     return true;
   }
@@ -140,11 +135,7 @@ function matchHintTag(
   hintTags: ReadonlyArray<BindingTag> | undefined,
   singleHintTag: BindingTag | undefined,
 ): boolean {
-  if (
-    singleHintTag !== undefined &&
-    singleHintTag[0] === tagKey &&
-    Object.is(singleHintTag[1], tagValue)
-  ) {
+  if (singleHintTag !== undefined && singleHintTag[0] === tagKey && Object.is(singleHintTag[1], tagValue)) {
     return true;
   }
   if (hintTags === undefined || hintTags.length === 0) {

package/src/binding.ts

@@ -1,3 +1,5 @@
+import type { InjectionDescriptor } from "#/decorators/inject";
+import type { Token } from "#/token";
 import type {
   ActivationHandler,
   BindingIdentifier,
@@ -10,8 +12,6 @@ import type {
   TokenValue,
   ConstraintContext,
 } from "#/types";
-import type { Token } from "#/token";
-import type { InjectionDescriptor } from "#/decorators/inject";
 
 // ── BindingSlot ───────────────────────────────────────────────────────────────────
 
@@ -34,11 +34,7 @@ export function bindingSlotEquals(left: BindingSlot, right: BindingSlot): boolea
     return false;
   }
   for (const [tagKey, tagValue] of left.tags) {
-    if (
-      !right.tags.some(
-        ([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue),
-      )
-    ) {
+    if (!right.tags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue))) {
       return false;
     }
   }

package/src/constraints.ts

@@ -1,6 +1,6 @@
-import type { BindingTag, ConstraintContext, Constructor } from "#/types";
 import type { Token } from "#/token";
 import { tokenName } from "#/token";
+import type { BindingTag, ConstraintContext, Constructor } from "#/types";
 
 function tokenNameOf(token: Token<unknown> | Constructor): string {
   return tokenName(token);
@@ -9,25 +9,19 @@ function tokenNameOf(token: Token<unknown> | Constructor): string {
 /**
  * @since 0.3.16-canary.0
  */
-export function whenParentIs(
-  token: Token<unknown> | Constructor,
-): (constraintContext: ConstraintContext) => boolean {
+export function whenParentIs(token: Token<unknown> | Constructor): (constraintContext: ConstraintContext) => boolean {
   const tokenDisplayName = tokenNameOf(token);
   return (constraintContext) =>
-    constraintContext.parent !== undefined &&
-    constraintContext.parent.tokenName === tokenDisplayName;
+    constraintContext.parent !== undefined && constraintContext.parent.tokenName === tokenDisplayName;
 }
 
 /**
  * @since 0.3.16-canary.0
  */
-export function whenNoParentIs(
-  token: Token<unknown> | Constructor,
-): (constraintContext: ConstraintContext) => boolean {
+export function whenNoParentIs(token: Token<unknown> | Constructor): (constraintContext: ConstraintContext) => boolean {
   const tokenDisplayName = tokenNameOf(token);
   return (constraintContext) =>
-    constraintContext.parent === undefined ||
-    constraintContext.parent.tokenName !== tokenDisplayName;
+    constraintContext.parent === undefined || constraintContext.parent.tokenName !== tokenDisplayName;
 }
 
 /**
@@ -38,9 +32,7 @@ export function whenAnyAncestorIs(
 ): (constraintContext: ConstraintContext) => boolean {
   const tokenDisplayName = tokenNameOf(token);
   return (constraintContext) =>
-    constraintContext.ancestors.some(
-      (ancestorFrame) => ancestorFrame.tokenName === tokenDisplayName,
-    );
+    constraintContext.ancestors.some((ancestorFrame) => ancestorFrame.tokenName === tokenDisplayName);
 }
 
 /**
@@ -51,55 +43,39 @@ export function whenNoAncestorIs(
 ): (constraintContext: ConstraintContext) => boolean {
   const tokenDisplayName = tokenNameOf(token);
   return (constraintContext) =>
-    constraintContext.ancestors.every(
-      (ancestorFrame) => ancestorFrame.tokenName !== tokenDisplayName,
-    );
+    constraintContext.ancestors.every((ancestorFrame) => ancestorFrame.tokenName !== tokenDisplayName);
 }
 
 /**
  * @since 0.3.16-canary.0
  */
 export function whenParentNamed(name: string): (constraintContext: ConstraintContext) => boolean {
-  return (constraintContext) =>
-    constraintContext.parent !== undefined && constraintContext.parent.slot.name === name;
+  return (constraintContext) => constraintContext.parent !== undefined && constraintContext.parent.slot.name === name;
 }
 
 /**
  * @since 0.3.16-canary.0
  */
-export function whenAnyAncestorNamed(
-  name: string,
-): (constraintContext: ConstraintContext) => boolean {
-  return (constraintContext) =>
-    constraintContext.ancestors.some((ancestorFrame) => ancestorFrame.slot.name === name);
+export function whenAnyAncestorNamed(name: string): (constraintContext: ConstraintContext) => boolean {
+  return (constraintContext) => constraintContext.ancestors.some((ancestorFrame) => ancestorFrame.slot.name === name);
 }
 
 /**
  * @since 0.3.16-canary.0
  */
-export function whenParentTagged(
-  tag: string,
-  value: unknown,
-): (constraintContext: ConstraintContext) => boolean {
+export function whenParentTagged(tag: string, value: unknown): (constraintContext: ConstraintContext) => boolean {
   return (constraintContext) =>
     constraintContext.parent !== undefined &&
-    constraintContext.parent.slot.tags.some(
-      ([tagKey, tagValue]) => tagKey === tag && Object.is(tagValue, value),
-    );
+    constraintContext.parent.slot.tags.some(([tagKey, tagValue]) => tagKey === tag && Object.is(tagValue, value));
 }
 
 /**
  * @since 0.3.16-canary.0
  */
-export function whenAnyAncestorTagged(
-  tag: string,
-  value: unknown,
-): (constraintContext: ConstraintContext) => boolean {
+export function whenAnyAncestorTagged(tag: string, value: unknown): (constraintContext: ConstraintContext) => boolean {
   return (constraintContext) =>
     constraintContext.ancestors.some((ancestorFrame) =>
-      ancestorFrame.slot.tags.some(
-        ([tagKey, tagValue]) => tagKey === tag && Object.is(tagValue, value),
-      ),
+      ancestorFrame.slot.tags.some(([tagKey, tagValue]) => tagKey === tag && Object.is(tagValue, value)),
     );
 }
 
@@ -120,9 +96,7 @@ export function whenParentTaggedAll(
     }
     const { tags: parentTags } = parent.slot;
     return tags.every(([tagKey, tagValue]) =>
-      parentTags.some(
-        ([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue),
-      ),
+      parentTags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue)),
     );
   };
 }
@@ -141,9 +115,7 @@ export function whenAnyAncestorTaggedAll(
     constraintContext.ancestors.some((frame) => {
       const { tags: frameTags } = frame.slot;
       return tags.every(([tagKey, tagValue]) =>
-        frameTags.some(
-          ([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue),
-        ),
+        frameTags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue)),
       );
     });
 }