@codefast/di 0.3.16-canary.1 → 0.3.16-canary.3

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @codefast/di
 
+## 0.3.16-canary.3
+
+### Patch Changes
+
+- [`2a82188`](https://github.com/codefastlabs/codefast/commit/2a82188264c204b0b519b3324402ae962594d29b) Thanks [@thevuong](https://github.com/thevuong)! - feat(dev): enable source condition for zero-rebuild HMR in apps/docs
+
+- [`bed2f30`](https://github.com/codefastlabs/codefast/commit/bed2f30df74128fe3b1a98dd9d03f6bb96099164) Thanks [@thevuong](https://github.com/thevuong)! - feat(web): refactor theme management to color scheme system
+
+## 0.3.16-canary.2
+
+### Patch Changes
+
+- [`1ad2cb7`](https://github.com/codefastlabs/codefast/commit/1ad2cb73a3f6f8bff2b001e9df2f2492efd89aa2) Thanks [@thevuong](https://github.com/thevuong)! - chore: align package config globs
+
+- [`4fda78b`](https://github.com/codefastlabs/codefast/commit/4fda78b20f98646d114cfddb09e66af609a625a2) Thanks [@thevuong](https://github.com/thevuong)! - fix: support Node 26 mirror export verification
+
+- [`1b0df2e`](https://github.com/codefastlabs/codefast/commit/1b0df2e55140c927b7f3ba39ccdcb4cba87ec7ff) Thanks [@thevuong](https://github.com/thevuong)! - refactor(di): clarify contextual names
+
 ## 0.3.16-canary.1
 
 ## 0.3.16-canary.0

package/README.md

@@ -181,7 +181,7 @@ Start with `container.bind(key)` and chain a strategy, then optional constraints
 | `.toDynamicAsync(factory)`        | Async factory `(ctx: ResolutionContext) => Promise<Value>`.                                                 |
 | `.toResolved(factory, deps)`      | Factory with a typed dependency tuple; dependencies are resolved in order.                                  |
 | `.toResolvedAsync(factory, deps)` | Like `toResolved`, but the factory returns a `Promise`.                                                     |
-| `.toAlias(targetToken)`           | Redirect resolution to another token; the alias follows the target’s materialization.                       |
+| `.toAlias(targetToken)`           | Redirect resolution to another token; the alias follows the target’s resolution.                            |
 
 ```typescript
 container.bind(AppConfigToken).toConstantValue({ port: 3000 });
@@ -271,7 +271,7 @@ Built-in predicates (all from `@codefast/di/constraints`):
 | ----------------------------------- | -------------------------------------------------------------------------- |
 | `whenParentIs(key)`                 | The direct parent binding was registered for `key`.                        |
 | `whenNoParentIs(key)`               | There is no parent, or the parent is not registered for `key`.             |
-| `whenAnyAncestorIs(key)`            | Any ancestor on the materialization stack was registered for `key`.        |
+| `whenAnyAncestorIs(key)`            | Any ancestor on the resolution stack was registered for `key`.             |
 | `whenNoAncestorIs(key)`             | No ancestor was registered for `key`.                                      |
 | `whenParentNamed(name)`             | The immediate parent binding’s slot name is `name`.                        |
 | `whenAnyAncestorNamed(name)`        | Some ancestor’s slot name is `name`.                                       |
@@ -645,7 +645,7 @@ The root entry re-exports the full façade (`package.json` → `"."`). Subpaths
 | `@codefast/di/decorators/injectable`           | `injectable`, `createAutoRegisterRegistry`, `AutoRegisterRegistry`                                                                                                   |
 | `@codefast/di/decorators/lifecycle-decorators` | `postConstruct`, `preDestroy`                                                                                                                                        |
 | `@codefast/di/dependency-graph`                | `buildDependencyGraph`, `ContainerGraphJson`, `GraphOptions`, …                                                                                                      |
-| `@codefast/di/environment`                     | `runWithContainer`, `getActiveContainer`, `DefaultResolutionContext`, `ResolverCallbacks`, `buildMaterializationFrame`                                               |
+| `@codefast/di/environment`                     | `runWithContainer`, `getActiveContainer`, `DefaultResolutionContext`, `ResolverCallbacks`, `buildResolutionFrame`                                                    |
 | `@codefast/di/errors`                          | Full `DiError` hierarchy                                                                                                                                             |
 | `@codefast/di/graph-adapters/cytoscape`        | `toCytoscapeGraph`                                                                                                                                                   |
 | `@codefast/di/graph-adapters/dot`              | `toDotGraph`                                                                                                                                                         |
@@ -659,7 +659,7 @@ The root entry re-exports the full façade (`package.json` → `"."`). Subpaths
 | `@codefast/di/metadata/symbol-metadata-reader` | `SymbolMetadataReader`, `defaultMetadataReader`                                                                                                                      |
 | `@codefast/di/module`                          | `Module`, `AsyncModule`, `SyncModule`, `isSyncModule`, builders                                                                                                      |
 | `@codefast/di/registry`                        | `BindingRegistry`                                                                                                                                                    |
-| `@codefast/di/resolve-options`                 | `injectableSlotToResolveOptions`, `slotKeyToResolveOptions`                                                                                                          |
+| `@codefast/di/resolve-options`                 | `injectionSlotToResolveOptions`, `bindingSlotToResolveOptions`                                                                                                       |
 | `@codefast/di/resolver`                        | `DependencyResolver`                                                                                                                                                 |
 | `@codefast/di/scope`                           | `ScopeManager`                                                                                                                                                       |
 | `@codefast/di/token`                           | `token`, `Token`, `tokenName`, …                                                                                                                                     |

package/dist/binding-select.d.mts

@@ -8,7 +8,7 @@ import { Binding } from "./binding.mjs";
  *
  * @since 0.3.16-canary.0
  */
-declare function selectBinding(bindings: ReadonlyArray<Binding>, hint: ResolveOptions | undefined, ctx: ConstraintContext, tName: string): Binding | undefined;
+declare function selectBinding(bindings: ReadonlyArray<Binding>, hint: ResolveOptions | undefined, ctx: ConstraintContext, tokenDisplayName: string): Binding | undefined;
 /**
  * Select all candidates matching hint + predicates.
  *

package/dist/binding-select.mjs

@@ -6,11 +6,11 @@ import { AmbiguousBindingError } from "./errors.mjs";
 *
 * @since 0.3.16-canary.0
 */
-function selectBinding(bindings, hint, ctx, tName) {
+function selectBinding(bindings, hint, ctx, tokenDisplayName) {
 	const candidates = filterBindings(bindings, hint, ctx);
 	if (candidates.length === 0) return;
 	if (candidates.length === 1) return candidates[0];
-	throw new AmbiguousBindingError(tName, candidates.map((c) => c.id));
+	throw new AmbiguousBindingError(tokenDisplayName, candidates.map((c) => c.id));
 }
 /**
 * Select all candidates matching hint + predicates.
@@ -20,10 +20,10 @@ function selectBinding(bindings, hint, ctx, tName) {
 function selectAllBindings(bindings, hint, ctx) {
 	return filterBindings(bindings, hint, ctx, "all");
 }
-function filterBindings(bindings, hint, ctx, mode = "single") {
+function filterBindings(bindings, hint, ctx, selectionMode = "single") {
 	if (hint === void 0) {
 		const resultWithoutHint = [];
-		if (mode === "all") {
+		if (selectionMode === "all") {
 			for (const binding of bindings) if (matchesPredicate(binding, ctx)) resultWithoutHint.push(binding);
 		} else for (const binding of bindings) {
 			const slot = binding.slot;
@@ -32,7 +32,7 @@ function filterBindings(bindings, hint, ctx, mode = "single") {
 		return resultWithoutHint;
 	}
 	const result = [];
-	for (const binding of bindings) if ((mode === "all" ? matchesSlotForResolveAll(binding, hint) : matchesSlot(binding, hint)) && matchesPredicate(binding, ctx)) result.push(binding);
+	for (const binding of bindings) if ((selectionMode === "all" ? matchesSlotForResolveAll(binding, hint) : matchesSlot(binding, hint)) && matchesPredicate(binding, ctx)) result.push(binding);
 	return result;
 }
 function matchesSlotForResolveAll(binding, hint) {

package/dist/binding.d.mts

@@ -1,34 +1,38 @@
 import { Constructor } from "./constructor-type.mjs";
 import { Token } from "./token.mjs";
-import { ActivationHandler, BindingIdentifier, BindingScope, ConstraintContext, DeactivationHandler, DependencyKey, ResolutionContext, TokenValue } from "./types.mjs";
+import { ActivationHandler, BindingIdentifier, BindingScope, BindingTag, ConstraintContext, DeactivationHandler, DependencyKey, ResolutionContext, TokenValue } from "./types.mjs";
 import { InjectionDescriptor } from "./decorators/inject.mjs";
 
 //#region src/binding.d.ts
 /**
  * @since 0.3.16-canary.0
  */
-interface SlotKey {
+interface BindingSlot {
   readonly name: string | undefined;
-  readonly tags: ReadonlyArray<readonly [tag: string, value: unknown]>;
+  readonly tags: ReadonlyArray<BindingTag>;
 }
 /**
  * @since 0.3.16-canary.0
  */
-declare function slotKeyEquals(a: SlotKey, b: SlotKey): boolean;
+declare function bindingSlotEquals(left: BindingSlot, right: BindingSlot): boolean;
 /**
  * @since 0.3.16-canary.0
  */
-declare const DEFAULT_SLOT: SlotKey;
+declare const DEFAULT_BINDING_SLOT: {
+  name: undefined;
+  tags: never[];
+};
 /**
  * @since 0.3.16-canary.0
  */
-declare function slotKeyToString(slot: SlotKey): string;
+declare function bindingSlotToString(slot: BindingSlot): string;
 interface BindingBase<Value> {
   readonly id: BindingIdentifier;
   readonly token: Token<Value> | Constructor<Value>;
-  readonly slot: SlotKey;
+  readonly slot: BindingSlot;
   readonly predicate?: (ctx: ConstraintContext) => boolean;
 }
+type BindingBaseKeys = keyof BindingBase<unknown>;
 /**
  * @since 0.3.16-canary.0
  */
@@ -107,11 +111,23 @@ type Binding<Value = unknown> = ClassBinding<Value> | DynamicBinding<Value> | Dy
  *
  * @since 0.3.16-canary.0
  */
-type PartialBinding<Value> = Omit<ClassBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<DynamicBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<DynamicAsyncBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<ResolvedBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<ResolvedAsyncBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<ConstantBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<AliasBinding<Value>, "id" | "token" | "slot" | "predicate">;
+type PartialBinding<Value> = Omit<ClassBinding<Value>, BindingBaseKeys> | Omit<DynamicBinding<Value>, BindingBaseKeys> | Omit<DynamicAsyncBinding<Value>, BindingBaseKeys> | Omit<ResolvedBinding<Value>, BindingBaseKeys> | Omit<ResolvedAsyncBinding<Value>, BindingBaseKeys> | Omit<ConstantBinding<Value>, BindingBaseKeys> | Omit<AliasBinding<Value>, BindingBaseKeys>;
 /**
  * @since 0.3.16-canary.0
  */
 declare function generateBindingId(): BindingIdentifier;
+/**
+ * Common slot-constraint + id methods shared by all concrete binding builders.
+ *
+ * @since 0.3.16-canary.0
+ */
+interface SlotConstrainedBuilder {
+  when(predicate: (ctx: ConstraintContext) => boolean): this;
+  whenNamed(name: string): this;
+  whenTagged(tag: string, value: unknown): this;
+  whenDefault(): this;
+  id(): BindingIdentifier;
+}
 /**
  * @since 0.3.16-canary.0
  */
@@ -128,38 +144,22 @@ interface BindToBuilder<Value> {
 /**
  * @since 0.3.16-canary.0
  */
-interface BindingBuilder<Value> {
-  when(predicate: (ctx: ConstraintContext) => boolean): this;
-  whenNamed(name: string): this;
-  whenTagged(tag: string, value: unknown): this;
-  whenDefault(): this;
+interface BindingBuilder<Value> extends SlotConstrainedBuilder {
   singleton(): SingletonBindingBuilder<Value>;
   transient(): TransientBindingBuilder<Value>;
   scoped(): ScopedBindingBuilder<Value>;
-  id(): BindingIdentifier;
 }
 /**
  * @since 0.3.16-canary.0
  */
-interface ConstantBindingBuilder<Value> {
-  when(predicate: (ctx: ConstraintContext) => boolean): this;
-  whenNamed(name: string): this;
-  whenTagged(tag: string, value: unknown): this;
-  whenDefault(): this;
+interface ConstantBindingBuilder<Value> extends SlotConstrainedBuilder {
   onActivation(fn: ActivationHandler<Value>): SingletonLifecycleBuilder<Value>;
   onDeactivation(fn: DeactivationHandler<Value>): SingletonLifecycleBuilder<Value>;
-  id(): BindingIdentifier;
 }
 /**
  * @since 0.3.16-canary.0
  */
-interface AliasBindingBuilder {
-  when(predicate: (ctx: ConstraintContext) => boolean): this;
-  whenNamed(name: string): this;
-  whenTagged(tag: string, value: unknown): this;
-  whenDefault(): this;
-  id(): BindingIdentifier;
-}
+interface AliasBindingBuilder extends SlotConstrainedBuilder {}
 /**
  * @since 0.3.16-canary.0
  */
@@ -188,4 +188,4 @@ interface SingletonLifecycleBuilder<Value> {
   id(): BindingIdentifier;
 }
 //#endregion
-export { AliasBinding, AliasBindingBuilder, BindToBuilder, Binding, BindingBuilder, ClassBinding, ConstantBinding, ConstantBindingBuilder, DEFAULT_SLOT, DynamicAsyncBinding, DynamicBinding, PartialBinding, ResolvedAsyncBinding, ResolvedBinding, ScopedBindingBuilder, SingletonBindingBuilder, SingletonLifecycleBuilder, SlotKey, TransientBindingBuilder, generateBindingId, slotKeyEquals, slotKeyToString };
+export { AliasBinding, AliasBindingBuilder, BindToBuilder, Binding, BindingBuilder, BindingSlot, ClassBinding, ConstantBinding, ConstantBindingBuilder, DEFAULT_BINDING_SLOT, DynamicAsyncBinding, DynamicBinding, PartialBinding, ResolvedAsyncBinding, ResolvedBinding, ScopedBindingBuilder, SingletonBindingBuilder, SingletonLifecycleBuilder, SlotConstrainedBuilder, TransientBindingBuilder, bindingSlotEquals, bindingSlotToString, generateBindingId };

package/dist/binding.mjs

@@ -2,27 +2,27 @@
 /**
 * @since 0.3.16-canary.0
 */
-function slotKeyEquals(a, b) {
-	if (a.name !== b.name) return false;
-	if (a.tags.length !== b.tags.length) return false;
-	for (const [tagKey, tagValue] of a.tags) if (!b.tags.some(([k, v]) => k === tagKey && Object.is(v, tagValue))) return false;
+function bindingSlotEquals(left, right) {
+	if (left.name !== right.name) return false;
+	if (left.tags.length !== right.tags.length) return false;
+	for (const [tagKey, tagValue] of left.tags) if (!right.tags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue))) return false;
 	return true;
 }
 /**
 * @since 0.3.16-canary.0
 */
-const DEFAULT_SLOT = {
+const DEFAULT_BINDING_SLOT = {
 	name: void 0,
 	tags: []
 };
 /**
 * @since 0.3.16-canary.0
 */
-function slotKeyToString(slot) {
+function bindingSlotToString(slot) {
 	if (slot.name === void 0 && slot.tags.length === 0) return "default";
 	const parts = [];
 	if (slot.name !== void 0) parts.push(`name:${slot.name}`);
-	for (const [k, v] of slot.tags) parts.push(`tag:${k}=${String(v)}`);
+	for (const [tagKey, tagValue] of slot.tags) parts.push(`tag:${tagKey}=${String(tagValue)}`);
 	return parts.join(",");
 }
 let _idCounter = 0;
@@ -33,4 +33,4 @@ function generateBindingId() {
 	return String(++_idCounter);
 }
 //#endregion
-export { DEFAULT_SLOT, generateBindingId, slotKeyEquals, slotKeyToString };
+export { DEFAULT_BINDING_SLOT, bindingSlotEquals, bindingSlotToString, generateBindingId };

package/dist/constraints.d.mts

@@ -1,6 +1,6 @@
 import { Constructor } from "./constructor-type.mjs";
 import { Token } from "./token.mjs";
-import { ConstraintContext } from "./types.mjs";
+import { BindingTag, ConstraintContext } from "./types.mjs";
 
 //#region src/constraints.d.ts
 /**
@@ -42,7 +42,7 @@ declare function whenAnyAncestorTagged(tag: string, value: unknown): (constraint
  *
  * @since 0.3.16-canary.1
  */
-declare function whenParentTaggedAll(tags: ReadonlyArray<readonly [tag: string, value: unknown]>): (constraintContext: ConstraintContext) => boolean;
+declare function whenParentTaggedAll(tags: ReadonlyArray<BindingTag>): (constraintContext: ConstraintContext) => boolean;
 /**
  * Matches when at least one ancestor slot carries **all** of the given tag pairs.
  * Equivalent to AND-composing multiple `whenAnyAncestorTagged` calls but evaluates
@@ -50,6 +50,6 @@ declare function whenParentTaggedAll(tags: ReadonlyArray<readonly [tag: string,
  *
  * @since 0.3.16-canary.1
  */
-declare function whenAnyAncestorTaggedAll(tags: ReadonlyArray<readonly [tag: string, value: unknown]>): (constraintContext: ConstraintContext) => boolean;
+declare function whenAnyAncestorTaggedAll(tags: ReadonlyArray<BindingTag>): (constraintContext: ConstraintContext) => boolean;
 //#endregion
 export { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll };

package/dist/constraints.mjs

@@ -67,7 +67,7 @@ function whenParentTaggedAll(tags) {
 		const { parent } = constraintContext;
 		if (parent === void 0) return false;
 		const { tags: parentTags } = parent.slot;
-		return tags.every(([tagKey, tagValue]) => parentTags.some(([k, v]) => k === tagKey && Object.is(v, tagValue)));
+		return tags.every(([tagKey, tagValue]) => parentTags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue)));
 	};
 }
 /**
@@ -80,7 +80,7 @@ function whenParentTaggedAll(tags) {
 function whenAnyAncestorTaggedAll(tags) {
 	return (constraintContext) => constraintContext.ancestors.some((frame) => {
 		const { tags: frameTags } = frame.slot;
-		return tags.every(([tagKey, tagValue]) => frameTags.some(([k, v]) => k === tagKey && Object.is(v, tagValue)));
+		return tags.every(([tagKey, tagValue]) => frameTags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue)));
 	});
 }
 //#endregion