di-craft 0.0.21 → 0.0.22

package/README.md

@@ -19,35 +19,10 @@
   </a>
 </p>
 
-## Contents
-
-- [Quick start](#quick-start)
-- [Philosophy](#philosophy)
-- [Features](#features)
-- [Install](#install)
-- [Core concepts](#core-concepts)
-  - [Tokens](#tokens)
-  - [Providers](#providers)
-  - [Annotation-based class providers](#annotation-based-class-providers)
-  - [Optional dependencies](#optional-dependencies)
-  - [Container](#container)
-  - [Scopes](#scopes)
-  - [Disposal](#disposal)
-  - [Child containers](#child-containers)
-  - [Cycle detection](#cycle-detection)
-  - [Async dependencies](#async-dependencies)
-- [Adapters](#adapters)
-  - [Next.js App Router](#nextjs-app-router)
-- [Dependency injection vs service location](#dependency-injection-vs-service-location)
-- [Error handling](#error-handling)
-- [API reference](#api-reference)
-- [License](#license)
-
-## Quick start
-
-Declare typed tokens, describe how each one is built with a provider, then create
-a container and resolve from it. Dependencies are wired explicitly through the
-`deps` map and resolved for you.
+## Quick Start
+
+Declare typed tokens, describe how each value is built, then resolve at the
+composition root.
 
 ```ts
 import {
@@ -58,15 +33,44 @@ import {
   type Provider,
 } from "di-craft";
 
-const CONFIG = createToken<Config>("config");
-const LOGGER = createToken<Logger>("logger");
-const USERS = createToken<UserService>("users");
+type Config = {
+  readonly logPrefix: string;
+};
+
+class Logger {
+  private readonly prefix: string;
+
+  constructor(prefix: string) {
+    this.prefix = prefix;
+  }
+
+  info(message: string): string {
+    return `${this.prefix}: ${message}`;
+  }
+}
+
+class UserService {
+  private readonly logger: Logger;
 
-const providers: Provider[] = [
-  provideValue(CONFIG, loadConfig()),
+  constructor(logger: Logger) {
+    this.logger = logger;
+  }
+
+  list(): readonly string[] {
+    this.logger.info("list users");
+    return ["Ada", "Grace"];
+  }
+}
+
+const CONFIG = createToken<Config>("CONFIG");
+const LOGGER = createToken<Logger>("LOGGER");
+const USERS = createToken<UserService>("USERS");
+
+const providers: readonly Provider[] = [
+  provideValue(CONFIG, { logPrefix: "users" }),
   provideFactory(LOGGER, {
     deps: { config: CONFIG },
-    useFactory: ({ config }) => new Logger(config.level),
+    useFactory: ({ config }) => new Logger(config.logPrefix),
   }),
   provideFactory(USERS, {
     deps: { logger: LOGGER },
@@ -75,19 +79,10 @@ const providers: Provider[] = [
 ];
 
 const container = createContainer(providers);
-
-const users = container.get(USERS); // UserService, fully typed
+const users = container.get(USERS); // UserService
 ```
 
-## Philosophy
-
-Dependency injection without hidden magic — no `reflect-metadata`, no runtime
-type guessing, and no framework coupling. You work with just **tokens**,
-**providers**, a **container**, **scopes**, and **cycle detection**. Standard
-JavaScript decorators are available as optional sugar for class providers, but
-they still use explicit tokens.
-
-## Features
+## Why di-craft
 
 - Zero runtime dependencies
 - Type-safe tokens and factories
@@ -95,11 +90,10 @@ they still use explicit tokens.
 - Optional Next.js App Router / React Server Components adapter
 - Optional dependencies via `optional()`
 - Singleton, transient, and scoped lifetimes
-- Hierarchical child containers
+- Hierarchical child containers for request-like lifecycles
 - Deterministic disposal with `onDispose` hooks
 - Circular dependency detection
-- Tree-shakable, tiny bundle size
-- ESM-only, ships with TypeScript declarations
+- Tree-shakable, ESM-only, ships with TypeScript declarations
 
 ## Install
 
@@ -110,57 +104,36 @@ pnpm add di-craft
 yarn add di-craft
 ```
 
-Requires Node.js `>= 20`. This package is ESM-only — import it with `import`;
-CommonJS code can load it with a dynamic `import()`.
-
-## Core concepts
-
-### Tokens
-
-A token is a unique, type-carrying key. Identity is based on an internal `symbol`,
-**not** on the name — two tokens with the same name are still different.
-
-```ts
-const PORT = createToken<number>("port");
-
-PORT.name; // "port" — used only for error messages
-```
-
-The type argument flows everywhere: providers must produce a matching value, and
-`container.get(PORT)` returns `number`.
+Requires Node.js `>= 20`. This package is ESM-only.
 
-### Providers
-
-A provider tells the container how to produce the value for a token.
-
-`provideValue` — register an existing value:
+## Core API
 
 ```ts
-provideValue(PORT, 3000);
+import {
+  Scopes,
+  createChildContainer,
+  createContainer,
+  createToken,
+  optional,
+  provideFactory,
+  provideValue,
+} from "di-craft";
 ```
 
-`provideFactory` — build the value lazily, with optional dependencies and scope:
+Core concepts are documented in [docs/core.md](./docs/core.md).
 
-```ts
-provideFactory(HTTP, {
-  deps: { config: CONFIG }, // optional, keyed map of tokens
-  scope: "singleton", // optional, defaults to "singleton"
-  useFactory: ({ config }) => new HttpClient(config.apiUrl),
-});
-```
-
-The keys in `deps` become the keys of the object passed to `useFactory`, each
-resolved to its token's type.
+Typed examples are available in [examples/typed-docs](./examples/typed-docs):
 
-### Annotation-based class providers
+- [basic container](./examples/typed-docs/core/basic.ts)
+- [scopes and child containers](./examples/typed-docs/core/scopes.ts)
+- [annotation-based providers](./examples/typed-docs/annotations/injectable.ts)
+- [Next.js request scope](./examples/typed-docs/next/request-scope.ts)
+- [Next.js state hydration](./examples/typed-docs/next/hydration.ts)
 
-If you write services as classes, you can attach provider metadata to the class
-with standard JavaScript decorators, then turn the class into a normal provider
-with `provideInjectable`.
+## Annotation-Based Providers
 
-`@Injectable(options)` marks a class as a provider for `options.token`.
-`deps` is an ordered list of constructor dependencies. `scope` and
-`onDispose` behave exactly like they do in `provideFactory`.
+`@Injectable` lets class-based services describe their token, constructor
+dependencies, scope, and disposal hook next to the class.
 
 ```ts
 import {
@@ -168,27 +141,23 @@ import {
   Scopes,
   createContainer,
   createToken,
-  optional,
   provideInjectable,
   provideValue,
 } from "di-craft";
 
-const CONFIG = createToken<Config>("config");
-const LOGGER = createToken<Logger>("logger");
-const USERS = createToken<UserService>("users");
+const LOGGER = createToken<Logger>("LOGGER");
+const USERS = createToken<UserService>("USERS");
 
 @Injectable({
   token: USERS,
-  deps: [LOGGER, optional(CONFIG)],
+  deps: [LOGGER],
   scope: Scopes.Scoped,
 })
 class UserService {
   private readonly logger: Logger;
-  private readonly config: Config | undefined;
 
-  constructor(logger: Logger, config: Config | undefined) {
+  constructor(logger: Logger) {
     this.logger = logger;
-    this.config = config;
   }
 }
 
@@ -196,265 +165,16 @@ const container = createContainer([
   provideValue(LOGGER, new Logger()),
   provideInjectable(UserService),
 ]);
-
-const users = container.get(USERS); // UserService
-```
-
-`@Injectable` is the only annotation needed for class injection. It produces a
-regular factory provider internally, so all existing container behavior still
-applies: optional dependencies, scopes, child containers, disposal hooks,
-overrides, and cycle detection.
-
-di-craft does not use `reflect-metadata` or parameter decorators. Constructor
-types are erased by JavaScript at runtime, so dependency tokens stay explicit
-instead of being guessed from TypeScript types.
-
-### Optional dependencies
-
-Wrap a token with `optional` to mark a dependency as not required. When no
-provider for it is registered anywhere in the container chain, the factory
-receives `undefined` instead of the resolution throwing `MissingProviderError`.
-The inferred type is widened to `T | undefined`, so TypeScript forces you to
-handle the absent case:
-
-```ts
-import { optional, provideFactory } from "di-craft";
-
-provideFactory(USERS, {
-  deps: { logger: optional(LOGGER) }, // LOGGER may or may not be registered
-  useFactory: ({ logger }) => {
-    logger?.info("creating users service"); // logger: Logger | undefined
-    return new UsersService();
-  },
-});
-```
-
-The same descriptor works at the top level — `optional` can be passed anywhere a
-dependency is accepted, including `container.get`:
-
-```ts
-const logger = container.get(optional(LOGGER)); // Logger | undefined
-```
-
-Optional only affects the token itself: if a provider _is_ registered, it is
-resolved normally and its own errors (cycles, missing nested deps) still surface.
-
-### Container
-
-The container holds your providers and resolves values on demand. Create one
-from a list of providers (all optional), then add more, check, resolve, and
-dispose:
-
-- `register(provider, options?)` — add a provider at any time.
-- `has(token)` — whether a provider for the token is registered.
-- `get(token)` — resolve the value, building and caching it as its scope dictates.
-  Accepts `optional(token)` to get `undefined` instead of throwing when absent.
-- `dispose()` — run `onDispose` hooks and release tracked instances owned by this
-  container.
-
-```ts
-const container = createContainer(providers); // providers are optional
-
-container.register(provideValue(PORT, 3000)); // register more at any time
-container.has(PORT); // true
-container.get(PORT); // 3000
-await container.dispose(); // clears tracked instances and awaits disposal hooks
-```
-
-Registering the same token twice throws `DuplicateProviderError`. To replace an
-existing provider on purpose (handy for tests, mocks, and environment-specific
-overrides), pass `{ allowOverride: true }`:
-
-```ts
-container.register(provideValue(API, fakeApi), { allowOverride: true });
-```
-
-Overriding a token whose value was already resolved as a singleton drops the
-cached instance, so the next `get` rebuilds it from the new provider. If that
-resolved instance has an `onDispose` hook, the override throws
-`InvalidProviderError` instead of silently dropping it — call `dispose()` first
-so the resource is released, then register the replacement.
-
-### Scopes
-
-| Scope                 | Behavior                                                                                                                                     |
-| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| `singleton` (default) | The factory runs once; the same instance is returned every time.                                                                              |
-| `transient`           | The factory runs on every `get`, producing a fresh instance.                                                                                  |
-| `scoped`              | One instance per container. In a child container each child gets its own instance, while the provider can still be declared once on the parent. |
-
-Use the `Scopes` helper for autocompletion, or pass the plain string — both work:
-
-```ts
-import { Scopes, provideFactory } from "di-craft";
-
-provideFactory(ID, {
-  scope: Scopes.Transient, // or scope: "transient"
-  useFactory: () => crypto.randomUUID(),
-});
-
-container.get(ID) !== container.get(ID); // true
-```
-
-A provider may only depend on dependencies that live **at least as long** as
-itself, so a longer-lived instance never captures a shorter-lived one. A
-transient may depend on anything; a scoped may depend on scoped or singleton; a
-singleton may depend only on singletons (and values). Violating this throws
-`InvalidProviderError` at resolution. A transient that depends on a singleton, for
-example, reuses the shared singleton instance.
-
-### Disposal
-
-Factory providers can declare an `onDispose` hook to release resources (database
-pools, sockets, timers, subscriptions). Calling `container.dispose()` runs the
-hooks for every resolved cached instance owned by that container and releases the
-container's tracked instances:
-
-```ts
-const DB = createToken<Pool>("db");
-
-const container = createContainer([
-  provideFactory(DB, {
-    useFactory: () => createPool(url),
-    onDispose: (pool) => pool.end(), // may be sync or async
-  }),
-]);
-
-container.get(DB);
-
-await container.dispose(); // clears tracked instances and awaits disposal hooks
-```
-
-Details:
-
-- Hooks run in reverse creation order (dependents before their dependencies).
-- `dispose()` returns a promise and awaits async hooks.
-- Instances are removed from the cache before hooks run, making disposal
-  idempotent and re-entrancy safe.
-- Only resolved cached instances owned by that container are disposed: singletons
-  owned by that container and scoped instances created for that container.
-  Transient and never-resolved instances are not tracked.
-- `onDispose` is only meaningful for cached instances. Declaring it on a
-  `transient` provider throws `InvalidProviderError`, since transient instances
-  are never tracked and the hook could never run.
-
-### Child containers
-
-`createChildContainer(parent, providers?)` creates a child that inherits
-everything from its parent but can add or override providers locally. This is the
-typical pattern for per-request isolation on a server: shared services live on
-the root, request-specific values live on a short-lived child.
-
-```ts
-const root = createContainer([
-  provideFactory(LOGGER, { useFactory: () => console }), // singleton, shared
-  provideFactory(HANDLER, {
-    scope: Scopes.Scoped, // one instance per child
-    deps: { request: REQUEST },
-    useFactory: ({ request }) => createHandler(request),
-  }),
-]);
-
-function handle(request: Request) {
-  const child = createChildContainer(root, [provideValue(REQUEST, request)]);
-
-  child.get(LOGGER); // same logger as the root and every other child
-  child.get(HANDLER); // a fresh handler, unique to this child
-
-  return child.dispose(); // release only this child's instances
-}
-```
-
-How resolution works across the chain:
-
-- A token is looked up in the child first, then walks up to the parent.
-- `singleton` is cached on the container that **owns** the provider, so it is
-  shared by the whole subtree.
-- `scoped` is cached on the **requesting** child, so each child gets its own
-  instance — even when the provider is declared once on the parent.
-- A `scoped` provider resolves its dependencies from the requesting child, so it
-  can depend on values registered only in that child (like `REQUEST`).
-- `dispose()` only releases the container it is called on; it does not cascade to
-  parents or children.
-
-### Cycle detection
-
-If providers form a dependency cycle, resolution throws `CircularDependencyError`
-with the full path instead of overflowing the stack.
-
-```ts
-// A -> B -> A
-container.get(A); // throws: Circular dependency detected: A -> B -> A
-```
-
-### Async dependencies
-
-di-craft resolves synchronously by design — there is no `getAsync`, and async
-never colors the rest of your graph. Asynchronous values are handled with one of
-two patterns, which together cover the vast majority of cases.
-
-**Resolve first, then register.** Do the async work at your composition root and
-register the resolved value. Simplest and most common:
-
-```ts
-const db = await connectDatabase(config);
-container.register(provideValue(DB, db));
 ```
 
-**Promise as value (lazy).** Register a factory that returns a promise. The
-container caches it like any other singleton, so the async work runs once and
-every consumer awaits the same promise:
-
-```ts
-const POOL = createToken<Promise<Pool>>("pool");
-
-container.register(provideFactory(POOL, { useFactory: () => createPool() }));
+Annotations are only syntax sugar over normal providers. There is no
+`reflect-metadata`, parameter decorators, runtime type guessing, or global
+container.
 
-const pool = await container.get(POOL);
-```
+## Next.js App Router
 
-A factory that depends on `POOL` receives the promise and awaits it itself:
-
-```ts
-provideFactory(USERS, {
-  deps: { pool: POOL },
-  useFactory: async ({ pool }) => new UsersRepo(await pool),
-});
-// USERS is now Token<Promise<UsersRepo>> — consumers await it too.
-```
-
-When using `Promise<T>` as the token value, disposal hooks receive the promise
-itself. Await it inside `onDispose` if cleanup needs the resolved value:
-
-```ts
-const POOL = createToken<Promise<Pool>>("pool");
-
-provideFactory(POOL, {
-  useFactory: () => createPool(),
-  onDispose: async (poolPromise) => {
-    const pool = await poolPromise;
-    await pool.end();
-  },
-});
-```
-
-## Adapters
-
-Adapters are optional framework integrations built around the core container.
-They live behind subpath exports, so the root import stays framework-agnostic:
-
-```ts
-import { createContainer } from "di-craft"; // core only
-```
-
-### Next.js App Router
-
-The Next adapter helps connect di-craft to the App Router request lifecycle
-without making React or Next.js part of the core import.
-
-Use `di-craft/next/server` from a server-only composition file. Pass React's
-`cache` function so React/Next owns request memoization while di-craft owns only
-the dependency graph:
+The Next adapter lives behind subpath exports, so React and Next.js are not part
+of the core import.
 
 ```ts
 // app/di.server.ts
@@ -463,11 +183,7 @@ import { cache } from "react";
 import { provideValue } from "di-craft";
 import { createNextDi } from "di-craft/next/server";
 
-export const {
-  getRequestContainer,
-  getRootContainer,
-  runWithRequestContainer,
-} = createNextDi({
+export const { getRequestContainer, runWithRequestContainer } = createNextDi({
   cache,
   providers,
   requestProviders: () => [
@@ -476,7 +192,7 @@ export const {
 });
 ```
 
-Then resolve dependencies in Server Components at the composition edge:
+Resolve dependencies in Server Components at the composition edge:
 
 ```ts
 import { getRequestContainer } from "./di.server";
@@ -488,15 +204,11 @@ export default async function Page() {
 }
 ```
 
-Next.js does not expose a general "RSC render is finished" hook, so the adapter
-does not pretend it can automatically dispose a cached Server Component request
-container. If you own the lifecycle, for example in a Route Handler, Server
-Action, test, or job, use `runWithRequestContainer`. It creates a fresh child
-container and disposes it in a `finally` block:
+For Route Handlers, Server Actions, tests, or jobs where you own the lifecycle,
+use `runWithRequestContainer`. It creates a fresh child container and disposes it
+in a `finally` block.
 
 ```ts
-import { runWithRequestContainer } from "./di.server";
-
 export async function GET() {
   return runWithRequestContainer({
     run: async (container) => {
@@ -508,151 +220,38 @@ export async function GET() {
 }
 ```
 
-State hydration is explicit. The server reads serializable snapshots with
-`di-craft/next/server`; the client restores them with `di-craft/next/client`.
-The DI container itself is never hydrated.
-
-Import boundary-specific runtime helpers from their own subpath:
-
-- `di-craft/next/server` — `createNextDi`, `dehydrate`, server-only adapter types.
-- `di-craft/next/client` — `hydrate`, client-boundary hydration types.
-- Shared hydration contracts like `Hydratable`, `HydrationSchema`, and
-  `HydrationSnapshot` are exported from both subpaths for convenience.
+State hydration is explicit:
 
-```ts
-import {
-  dehydrate,
-  type Hydratable,
-  type HydrationSchema,
-} from "di-craft/next/server";
-
-class UserState implements Hydratable<UserSnapshot> {
-  dehydrate(): UserSnapshot {
-    return { users: this.users };
-  }
-
-  hydrate(snapshot: UserSnapshot): void {
-    this.users = snapshot.users;
-  }
-}
-
-const hydration = {
-  user: USER_STATE,
-} satisfies HydrationSchema;
-const snapshot = dehydrate({
-  container: getRequestContainer(),
-  schema: hydration,
-});
+```txt
+server DI container -> serializable snapshot -> client state
 ```
 
-```ts
-"use client";
-
-import { hydrate } from "di-craft/next/client";
-
-hydrate({
-  container: clientContainer,
-  schema: hydration,
-  snapshot,
-});
-```
-
-## Dependency injection vs service location
-
-di-craft is built for **dependency injection**: dependencies are declared up
-front and handed to your code. The opposite is **service location**, where code
-reaches into a container at runtime to pull what it needs, hiding its real
-dependencies.
-
-Two habits keep usage canonical: call `container.get()` only at the **composition
-root** (entrypoint, framework hooks, route handlers), and never pass the
-container into your classes or functions. di-craft enforces the key half for you
-— **a factory only ever receives its declared `deps`, never the container** — so
-a provider physically cannot locate arbitrary services.
-
-```ts
-// Dependency injection — deps are explicit, the class never sees the container.
-provideFactory(USERS, {
-  deps: { repo: REPO, logger: LOGGER },
-  useFactory: ({ repo, logger }) => new UserService(repo, logger),
-});
-
-const users = container.get(USERS); // resolved at the root, then injected down
-```
-
-```ts
-// Service location (anti-pattern) — the container is smuggled into domain code.
-class UserService {
-  constructor(private container: Container) {}
-
-  list() {
-    const repo = this.container.get(REPO); // hidden, runtime-only dependency
-  }
-}
-```
-
-The second form compiles, but it hides dependencies and defeats DI. No runtime
-flag can forbid it — `get()` is the same call the composition root relies on — so
-keep resolution at the edges by convention, or enforce it with a lint rule that
-allows `.get()` only in your composition-root files.
+The DI container itself is never hydrated.
 
-## Error handling
+Runtime subpaths:
 
-All errors extend the shared `DiError` base class, so you can catch any container
-error with a single check:
+| Export                 | Description                                            |
+| ---------------------- | ------------------------------------------------------ |
+| `di-craft/next/server` | `createNextDi`, `dehydrate`, server-side adapter types |
+| `di-craft/next/client` | `hydrate`, client-boundary hydration types             |
 
-```ts
-import { DiError, MissingProviderError } from "di-craft";
+## API Reference
 
-try {
-  container.get(SOME_TOKEN);
-} catch (error) {
-  if (error instanceof MissingProviderError) {
-    // a specific failure
-  }
-
-  if (error instanceof DiError) {
-    // any di-craft error
-  }
-}
-```
-
-| Error                     | Thrown when                                                                                                                                                 |
-| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `MissingProviderError`    | A token is resolved but no provider is registered.                                                                                                           |
-| `DuplicateProviderError`  | A token is registered more than once.                                                                                                                        |
-| `CircularDependencyError` | Providers form a dependency cycle.                                                                                                                           |
-| `InvalidDependencyError`  | A declared dependency token is missing/undefined.                                                                                                            |
-| `InvalidProviderError`    | A provider is misconfigured (`onDispose` on a transient, or a dependency with a shorter lifetime than its consumer) or an override would drop a live disposable instance. |
-
-## API reference
-
-| Export                                     | Description                                                                 |
-| ------------------------------------------ | --------------------------------------------------------------------------- |
-| `createToken<T>(name)`                     | Create a unique, typed token.                                                |
-| `provideValue(token, value)`               | Provider that returns an existing value.                                     |
-| `provideFactory(token, options)`           | Provider that builds a value via a factory.                                  |
-| `@Injectable(options)`                     | Mark a class as a token-backed injectable provider.                          |
-| `provideInjectable(class)`                 | Create a factory provider from an injectable class.                           |
-| `optional(token)`                          | Mark a dependency as optional (resolves to `undefined` when absent).         |
-| `createContainer(providers?)`              | Create a container, optionally seeded with providers.                        |
-| `createChildContainer(parent, providers?)` | Create a child container that inherits from `parent`.                        |
-| `Scopes`                                   | Object of scope values (`Scopes.Singleton`, `Scopes.Transient`, `Scopes.Scoped`). |
-
-Exported types: `Container`, `Token`, `Provider`, `ValueProvider`,
-`FactoryProvider`, `Dependency`, `OptionalDependency`, `Scope`, `DisposeHook`,
-`RegisterOptions`.
+| Export                                     | Description                                                         |
+| ------------------------------------------ | ------------------------------------------------------------------- |
+| `createToken<T>(name)`                     | Create a unique, typed token                                        |
+| `provideValue(token, value)`               | Register an existing value                                          |
+| `provideFactory(token, options)`           | Register a lazy factory with optional dependencies, scope, disposal |
+| `@Injectable(options)`                     | Mark a class as a token-backed injectable provider                  |
+| `provideInjectable(class)`                 | Create a factory provider from an injectable class                  |
+| `optional(token)`                          | Mark a dependency as optional                                       |
+| `createContainer(providers?)`              | Create a container                                                  |
+| `createChildContainer(parent, providers?)` | Create a child container that inherits from `parent`                |
+| `Scopes`                                   | `Singleton`, `Transient`, and `Scoped` scope constants              |
 
 Exported errors: `DiError`, `MissingProviderError`, `DuplicateProviderError`,
 `CircularDependencyError`, `InvalidDependencyError`, `InvalidProviderError`.
 
-Subpath exports:
-
-| Export                      | Description                                             |
-| --------------------------- | ------------------------------------------------------- |
-| `di-craft/next/server`      | Next.js server adapter for request-scoped containers.   |
-| `di-craft/next/client`      | Client-boundary helpers for restoring state snapshots.  |
-
 ## License
 
 [MIT](./LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "di-craft",
-	"version": "0.0.21",
+	"version": "0.0.22",
 	"description": "A tiny, type-safe dependency injection container for TypeScript with an optional Next.js App Router adapter",
 	"license": "MIT",
 	"author": {
@@ -39,11 +39,12 @@
 		"build": "tsdown",
 		"test": "bun test",
 		"typecheck": "tsc --noEmit -p tsconfig.src.json && tsc --noEmit -p tsconfig.test.json",
+		"typecheck:examples": "tsc --noEmit -p tsconfig.examples.json",
 		"lint": "biome check .",
 		"format": "biome check --write .",
 		"publint": "publint",
 		"pre-commit-hooks": "simple-git-hooks",
-		"checks": "bun run lint && bun run typecheck && bun run test && bun run build && bun run publint"
+		"checks": "bun run lint && bun run typecheck && bun run typecheck:examples && bun run test && bun run build && bun run publint"
 	},
 	"simple-git-hooks": {
 		"pre-commit": "bun run lint && bun run typecheck"
@@ -53,6 +54,7 @@
 		"di container",
 		"dependency-injection",
 		"dependency injection",
+		"dependency injection container",
 		"ioc",
 		"inversion of control",
 		"ioc container",
@@ -69,6 +71,7 @@
 		"rsc",
 		"server components",
 		"request scope",
+		"request scoped",
 		"ssr",
 		"state hydration",
 		"next adapter"