ts-ioc-container 50.2.0 → 50.2.2

package/README.md

@@ -29,16 +29,11 @@ no global container objects.
 - can inject [lazy dependencies](#lazy)
 - composable provider and registration pipelines
 - custom injectors, hooks, and provider behavior
-- product behavior covered by executable specs
-
 ## Content
 
 - [Setup](#setup)
 - [Quickstart](#quickstart)
 - [Cheatsheet](#cheatsheet)
-- [Specs-driven workflow](#specs-driven-workflow)
-  - [Product capability map](#product-capability-map)
-  - [Acceptance specs](#acceptance-specs)
 - [tsyringe alternative](https://igorbabkin.github.io/ts-ioc-container/tsyringe-alternative)
 - [Inversify and Awilix alternative](https://igorbabkin.github.io/ts-ioc-container/inversify-awilix-alternative)
 - [Recipes](#recipes)
@@ -102,25 +97,39 @@ And `tsconfig.json` should have next options:
 ## Quickstart
 
 ```typescript
-import 'reflect-metadata';
-import { Container, register, bindTo, singleton } from 'ts-ioc-container';
+import { bindTo, Container, inject, register, Registration as R, singleton, SingleToken } from 'ts-ioc-container';
 
-@register(bindTo('ILogger'), singleton())
-class Logger {
+interface ILogger {
+  log(message: string): void;
+}
+
+const ILoggerToken = new SingleToken<ILogger>('ILogger');
+
+@register(bindTo(ILoggerToken), singleton())
+class Logger implements ILogger {
   log(message: string) {
     console.log(message);
   }
 }
 
 class App {
-  constructor(private logger = container.resolve<Logger>('ILogger')) {}
+  constructor(@inject(ILoggerToken) private logger: ILogger) {}
   start() {
     this.logger.log('hello');
   }
 }
 
-const container = new Container({ tags: ['application'] }).addRegistration(Logger);
-container.resolve(App).start();
+describe('Quickstart', function () {
+  it('should resolve App with injected Logger', function () {
+    const container = new Container({ tags: ['application'] }).addRegistration(R.fromClass(Logger));
+
+    const app = container.resolve(App);
+    app.start();
+
+    expect(app).toBeInstanceOf(App);
+  });
+});
+
 ```
 
 ## Cheatsheet
@@ -144,42 +153,6 @@ container.resolve(App).start();
 > for `R.fromValue(...)` and `R.fromFn(...)` (which have no class to decorate)
 > or for third-party classes you don't own.
 
-## Specs-driven workflow
-
-Public behavior is described as product capabilities before it is implemented.
-The repository keeps the same chain visible in specs, tests, docs, and this
-README:
-
-```text
-Business capability -> user story -> acceptance criteria -> executable spec test -> docs and ADRs
-```
-
-- ADRs in `docs/adr/` explain durable architecture and process decisions.
-- Specs in `specs/` describe epics, stories, use cases, and acceptance criteria.
-- Acceptance tests in `__tests__/specs/` execute the public contract.
-- README examples in `__tests__/readme/` stay executable and are rendered from `.readme.hbs.md`.
-
-### Product capability map
-
-| Capability              | User outcome                                                               | Spec                                     | Acceptance test                                   |
-| ----------------------- | -------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------- |
-| Dependency resolution   | Resolve dependencies by key, class, token, or constructor injection.       | `specs/epics/dependency-resolution.md`   | `__tests__/specs/dependency-resolution.spec.ts`   |
-| Scoped lifecycle        | Isolate application, request, transaction, page, or widget lifecycles.     | `specs/epics/scoped-lifecycle.md`        | `__tests__/specs/scoped-lifecycle.spec.ts`        |
-| Dependency registration | Describe classes, values, factories, keys, aliases, and scoped services.   | `specs/epics/dependency-registration.md` | `__tests__/specs/dependency-registration.spec.ts` |
-| Provider behavior       | Cache, decorate, delay, restrict, or parameterize dependency creation.     | `specs/epics/provider-behavior.md`       | `__tests__/specs/provider-behavior.spec.ts`       |
-| Token-based injection   | Make dependency requests explicit, typed, reusable, and composable.        | `specs/epics/token-based-injection.md`   | `__tests__/specs/token-based-injection.spec.ts`   |
-| Injector strategies     | Support metadata, simple container, proxy, and custom injection styles.    | `specs/epics/injector-strategies.md`     | `__tests__/specs/injector-strategies.spec.ts`     |
-| Lifecycle hooks         | Run initialization, cleanup, property injection, and custom hook behavior. | `specs/epics/lifecycle-hooks.md`         | `__tests__/specs/lifecycle-hooks.spec.ts`         |
-| Container modules       | Package container configuration by feature, environment, or lifecycle.     | `specs/epics/container-modules.md`       | `__tests__/specs/container-modules.spec.ts`       |
-| Metadata utilities      | Attach labels, tags, and reusable method behavior to application code.     | `specs/epics/metadata-utilities.md`      | `__tests__/specs/metadata-utilities.spec.ts`      |
-| Errors and boundaries   | Make misconfiguration and unsupported usage diagnosable.                   | `specs/epics/errors-and-boundaries.md`   | `__tests__/specs/errors-and-boundaries.spec.ts`   |
-
-### Acceptance specs
-
-Use `pnpm run test:spec` to run only the executable acceptance specs. These
-tests are intentionally product-facing; lower-level regression and implementation
-tests stay in the feature folders under `__tests__/`.
-
 ## Recipes
 
 ### Express/Next handler (per-request scope)
@@ -2603,6 +2576,9 @@ Sometimes you want to register provider with certain key. This is what `key` is
 - by default, key is class name
 - you can assign the same key to different registrations
 
+> [!TIP]
+> Prefer `SingleToken<T>` over plain string literals as registration keys. Tokens are type-safe, rename-friendly, and prevent typos that only surface at runtime.
+
 ```typescript
 import {
   bindTo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "50.2.0",
+  "version": "50.2.2",
   "description": "Fast, lightweight TypeScript dependency injection container with a clean API, scoped lifecycles, decorators, tokens, hooks, lazy injection, customizable providers, and no global container objects.",
   "workspaces": [
     "docs"