@teqfw/di 2.5.0 → 2.5.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2.5.1 - 2026-04-12 - Documentation refresh and dependency fix
+
+* Fixed named-only `__deps__` resolution in the container and updated the related tests.
+* Rewrote the README and refreshed the `ai/` agent documentation for the current release line.
+* Updated package version metadata to `2.5.1`.
+
 ## 2.5.0 - 2026-04-04 - Parser and documentation refinement
 
 * Clarified JSDoc typing and module headers to align with TeqFW specifications.

package/README.md

@@ -3,141 +3,65 @@
 ![npms.io](https://img.shields.io/npm/dm/@teqfw/di)
 ![jsdelivr](https://img.shields.io/jsdelivr/npm/hm/@teqfw/di)
 
-**Runtime dependency linker for JavaScript applications designed for development with LLM agents.**
+**Deterministic runtime dependency linker for ES modules, built for pure JavaScript applications with explicit contracts.**
 
-`@teqfw/di` is the core infrastructure of the **Tequila Framework (TeqFW)** — an architectural approach for building web applications in which **humans design system architecture and specifications, while LLM agents generate and maintain the implementation.**
+`@teqfw/di` is a runtime container for JavaScript applications that want **late binding**, **explicit dependency declarations**, and **deterministic runtime linking** instead of application-level wiring through static imports.
 
-Instead of wiring modules through static imports, TeqFW applications declare **explicit dependency contracts**, and the container performs **deterministic runtime linking**.
+It is the reference implementation of the **Tequila Framework (TeqFW)** method: a way to structure modular monolith and isomorphic web applications around **Canonical Dependency Codes (CDC)** and module-level dependency descriptors (`__deps__`).
 
-The result is an application architecture that is easier to:
+In practice, "reference implementation of a method" means this package is not only a container library. It is also the concrete runtime model for a broader way of structuring JavaScript applications around explicit contracts, namespace-based addressing, and late binding.
 
-- analyze
-- generate
-- refactor
-- extend
+This package is designed primarily for:
 
-— both for **human developers and AI agents**.
+- modular monolith web applications;
+- isomorphic JavaScript systems that share code between browser and server;
+- pure JavaScript + JSDoc codebases;
+- projects developed or maintained with significant LLM-agent involvement.
 
-## The Shift in Software Development
+## Why Use It
 
-Large language models are becoming a permanent part of the development process.
+`@teqfw/di` provides:
 
-However, most software architectures were designed for **human-written code**, not for **code generated and maintained by AI agents**.
+- deterministic runtime linking of ES modules;
+- explicit dependency contracts through CDC and `__deps__`;
+- namespace-based module resolution;
+- lifecycle control for singleton and new-instance dependencies;
+- immutable linked objects;
+- wrapper-based extension points for cross-cutting behavior.
 
-Typical JavaScript applications rely on:
+The result is an application structure that is easier to analyze, test, replace, and evolve when dependency relationships need to remain explicit.
 
-- static imports
-- implicit dependency graphs
-- tight coupling to file structure
-- constructor-based dependency inference
+## How It Fits in JavaScript
 
-These patterns work well for humans but are difficult for automated agents to reason about reliably.
+This approach is unusual in mainstream JavaScript.
 
-**TeqFW proposes a different architecture.**
+Most JavaScript and TypeScript projects express dependency structure through some mix of:
 
-Modules declare **explicit dependency contracts**, and a runtime container resolves those contracts deterministically.
+- static imports;
+- framework conventions;
+- TypeScript-first source architecture;
+- decorators or metadata-driven injection;
+- framework-managed DI.
 
-This transforms the dependency graph into something that can be **analyzed, generated and modified programmatically.**
+`@teqfw/di` makes a different tradeoff. It favors **explicit runtime contracts** over hidden or inferred wiring. Instead of relying on TypeScript metadata or decorator-driven injection, modules declare dependencies directly as data and the container resolves them deterministically at runtime.
 
-## What This Library Provides
+That tradeoff is intentional.
 
-`@teqfw/di` implements the runtime container that enables this architecture.
+TypeScript has had a major influence on the JavaScript ecosystem, and that influence has been broadly positive. At the same time, JavaScript itself continues to evolve every year, steadily narrowing part of the gap in developer ergonomics and language expressiveness.
 
-It provides:
+For TypeScript-first ecosystems, other DI approaches are often a more natural fit because those ecosystems already rely on compile-time metadata, annotations, and framework or container conventions. TeqFW targets a different design space: **pure JavaScript + JSDoc**, isomorphic runtime behavior, and codebases where a single explicit structural representation is more valuable than TypeScript-oriented convenience.
 
-- deterministic runtime linking of ES modules
-- explicit dependency contracts (**CDC — Canonical Dependency Codes**)
-- module dependency descriptors (`__deps__`)
-- namespace-based module resolution
-- runtime lifecycle management
-- wrapper-based behavioral extensions
+This is not presented as the only correct way to structure JavaScript. It is a deliberate alternative for projects that benefit from stronger runtime explicitness and machine-reconstructible structure.
 
-The container acts as a **runtime linker for JavaScript applications**.
+## Comparison
 
-## Designed for Development with LLM Agents
-
-When software is generated or maintained by LLM agents, several structural problems appear.
-
-| Problem          | Traditional Architecture | TeqFW Approach     |
-| ---------------- | ------------------------ | ------------------ |
-| Dependencies     | implicit imports         | explicit contracts |
-| Dependency graph | implicit                 | deterministic      |
-| Refactoring      | fragile                  | stable             |
-| Testing          | manual wiring            | container driven   |
-| AI compatibility | accidental               | intentional        |
-
-TeqFW structures the application so that **LLM agents can reliably understand and modify the system.**
-
-## Agent-Driven Implementation
-
-Starting from version **2.0.0**, the source code of this library is **written primarily by Codex agents**.
-
-The development workflow follows **specification-driven development**:
-
-1. The human architect defines **product specifications**
-2. LLM agents generate the implementation
-3. The generated code is reviewed and integrated
-
-This workflow follows the **ADSM methodology (Agent-Driven Software Management)** developed by **Alex Gusev**.
-
-Earlier versions of the library (<2.0.0) were written manually.
-The current version demonstrates how software can be developed using **human-defined architecture and AI-generated code**.
-
-## Learn the Architecture (Interactive Onboarding)
-
-Understanding this architecture can take time.
-
-To make onboarding easier, an **interactive AI assistant** [is available](https://fly.wiredgeese.com/flancer/gpt/teqfw/guide/di/).
-
-The assistant can explain:
-
-- how the container works
-- what Canonical Dependency Codes are
-- how modules declare dependencies
-- how runtime linking works
-- how to integrate the library in real applications
-
-The assistant acts as **interactive documentation** for the project.
-
-Custom onboarding assistants like this can also be created **as a service** for other projects and libraries.
-
-## Agent Interface (Documentation for LLM Agents)
-
-This package includes **agent interface documentation** intended for LLM agents that use the library as an npm dependency.
-
-These documents are distributed inside the package in:
-
-```txt
-./ai/
-```
-
-The files in this directory describe the **public interface of the package in an agent-friendly form**.
-
-They explain:
-
-- the container API
-- dependency descriptors (`__deps__`)
-- Canonical Dependency Codes (CDC)
-- dependency resolution behavior
-- integration patterns
-
-Human developers typically read the README and source code, while **LLM agents can rely on the documentation in `./ai/`.**
-
-## Tequila Framework Philosophy
-
-`@teqfw/di` is the core building block of the **Tequila Framework (TeqFW)** ecosystem.
-
-TeqFW is based on several architectural principles:
-
-- runtime late binding between components
-- namespace-based module organization
-- modular monolith architecture
-- pure JavaScript without compilation
-- system structures optimized for collaboration with LLM agents
-
-Full philosophy:
-
-`PHILOSOPHY.md`
+| Concern | Common TS/JS Approach | `@teqfw/di` |
+| --- | --- | --- |
+| Dependency structure | static imports, decorators, framework wiring | explicit CDC + `__deps__` |
+| Resolution model | partly implicit or framework-driven | deterministic runtime linking |
+| Structural source of truth | spread across code, metadata, config | declared in module contracts |
+| Best fit | TypeScript-first applications | pure JavaScript + JSDoc, isomorphic modular systems |
+| LLM readability | mixed, often indirect | intentionally explicit |
 
 ## Installation
 
@@ -145,17 +69,9 @@ Full philosophy:
 npm install @teqfw/di
 ```
 
-## Quick Example
-
-### Define modules
+## Quick Start
 
-`src/App/Child.mjs`
-
-```javascript
-export default function App_Child() {
-  return { name: "child" };
-}
-```
+Define one helper module and one module that declares its dependency explicitly.
 
 `src/App/Helper/Cast.mjs`
 
@@ -174,28 +90,20 @@ export const __deps__ = {
   cast: "App_Helper_Cast$",
 };
 
-export default class RuntimeWrapper {
-  constructor() {
-    return {
-      mode: "runtime-wrapper",
-    };
-  }
-}
-
-export class Factory {
+export default class App_Root {
   constructor({ cast }) {
-    this.configure = function (params = {}) {
-      return {
-        name: "factory",
-        cast,
-        params,
-      };
+    return {
+      configure(params = {}) {
+        return {
+          name: cast(params.name ?? "app"),
+        };
+      },
     };
   }
 }
 ```
 
-### Configure container
+Configure the container and request the dependency:
 
 ```javascript
 import path from "node:path";
@@ -206,116 +114,57 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 const container = new Container();
-
 container.addNamespaceRoot("App_", path.resolve(__dirname, "./src/App"), ".mjs");
 
-const factory = await container.get("App_Root__Factory$");
+const app = await container.get("App_Root$");
 
-console.log(factory.configure().mode);
+console.log(app.configure({ name: 123 }).name);
+// "123"
 ```
 
-The container:
+In this flow the container:
+
+- parses the dependency request;
+- resolves the module through the registered namespace root;
+- reads `__deps__` for the selected export;
+- recursively links dependencies;
+- returns a frozen linked object.
 
-- loads modules
-- resolves dependency contracts
-- constructs the object graph
-- returns **frozen linked objects**
+## Core Concepts
 
-## Dependency Contracts (`__deps__`)
+### `__deps__`
 
-Modules declare dependencies using a static export descriptor.
+For a single-export module, dependencies can be declared in shorthand form:
 
 ```javascript
 export const __deps__ = {
-  default: {
-    localName: "Dependency_CDC",
-  },
-  Factory: {
-    localName: "Dependency_CDC",
-  },
+  localName: "Dependency_CDC",
 };
 ```
 
 Rules:
 
-- the canonical form is hierarchical and keyed by export name
-- each export entry maps constructor argument names to CDC dependency identifiers
-- if `__deps__` is absent — module has no dependencies
-- a flat `__deps__` object is a shorthand allowed only for limited single-export cases
-- dependencies are resolved recursively
+- the canonical form is hierarchical and keyed by export name;
+- each export entry maps constructor argument names to CDC strings;
+- if `__deps__` is absent, the export has no declared dependencies;
+- a flat `__deps__` object is shorthand for limited single-export cases.
 
-Canonical example:
+Canonical export-scoped form:
 
 ```javascript
 export const __deps__ = {
   default: {
-    cast: "Fl32_Web_Helper_Cast$",
+    localName: "Dependency_CDC",
   },
   Factory: {
-    cast: "Fl32_Web_Helper_Cast$",
+    localName: "Dependency_CDC",
   },
 };
-
-export default class RuntimeWrapper {
-  constructor() {
-    return {
-      mode: "runtime-wrapper",
-    };
-  }
-}
-
-export class Factory {
-  constructor({ cast }) {
-    this.configure = function (params = {}) {
-      // DI-managed component
-    };
-  }
-}
 ```
 
-In this pattern:
+### CDC
 
-- the default export is the runtime wrapper or module shell
-- the named `Factory` export is the DI-managed component
-- `__deps__` applies to the export selected by the CDC, such as `App_Module__Factory$`
-
-Shorthand example for a single-export module:
-
-```javascript
-export const __deps__ = {
-  cast: "Fl32_Web_Helper_Cast$",
-};
-
-export default class RuntimeWrapper {
-  constructor() {
-    return {
-      mode: "runtime-wrapper",
-    };
-  }
-}
-```
-
-Empty descriptor example:
-
-```javascript
-export default class App_Empty {
-  constructor() {
-    this.ready = function () {
-      return true;
-    };
-  }
-}
-```
-
-In this pattern:
-
-- the module has no declared dependencies
-- `__deps__` is omitted entirely
-- the empty form is valid and intentionally explicit through omission
-
-## Canonical Dependency Codes (CDC)
-
-CDC identifiers describe **how dependencies should be resolved**.
+A **Canonical Dependency Code** is the string contract used to request a dependency.
 
 General form:
 
@@ -326,89 +175,80 @@ General form:
 Examples:
 
 ```txt
-App_Service
 App_Service$
-App_Service__build$$
-App_Service$$_wrapLog_wrapTrace
+App_Service__Factory$$
 node:fs
-npm:@humanfs/core
-node:worker_threads
 npm:lodash
 ```
 
 Where:
 
-- `node:` platform prefix for Node.js built-in modules
-- `npm:` platform prefix for npm packages
-- `$` singleton lifecycle
-- `$$` new instance lifecycle
-- wrappers modify runtime behavior
+- `__Factory` selects a named export;
+- `$` means singleton lifecycle;
+- `$$` means new instance lifecycle;
+- `node:` and `npm:` address platform-specific modules.
 
-## Public API
+### Namespace Root
+
+A namespace root maps a CDC prefix to a module-specifier base:
 
 ```javascript
-const container = new Container();
+container.addNamespaceRoot("App_", "/abs/path/to/src/App", ".mjs");
 ```
 
-Configuration methods (before first `get`):
-
-- `setParser(parser)`
-- `addNamespaceRoot(prefix, target, defaultExt)`
-- `addPreprocess(fn)`
-- `addPostprocess(fn)`
-- `enableLogging()`
-- `enableTestMode()`
-- `register(cdc, mock)`
+This lets the container translate logical module names such as `App_Root__Factory$` into concrete ES module files or URL-based module specifiers.
 
-Dependency resolution:
+In Node.js, that often means filesystem-backed module roots:
 
 ```javascript
-await container.get(cdc);
+container.addNamespaceRoot("App_", "/project/src/App", ".mjs");
 ```
 
-Behavior:
+In a web-oriented or isomorphic application, it can also mean URL-backed roots for browser imports:
 
-- deterministic linking
-- fail-fast resolution pipeline
-- immutable returned objects
-- container enters failed state on fatal errors
+```javascript
+container.addNamespaceRoot("App_", "https://cdn.example.com/app", ".mjs");
+container.addNamespaceRoot("Web_", "//cdn.example.com/web", ".mjs");
+```
 
-## Wrappers
+This keeps dependency addressing stable while allowing the same logical naming model to work across shared application code, browser-facing modules, and different runtime environments.
 
-Wrappers allow cross-cutting behavior to be applied declaratively.
+## Public API
 
-Example CDC:
+Create a container:
 
-```txt
-App_Service$$_log_trace
+```javascript
+const container = new Container();
 ```
 
-Wrappers can implement:
+Configure it before the first `get(...)`:
 
-- logging
-- metrics
-- tracing
-- security checks
-- behavioral instrumentation
-
-This acts as a lightweight **DI-level AOP mechanism.**
+- `setParser(parser)`
+- `addNamespaceRoot(prefix, target, defaultExt)`
+- `addPreprocess(fn)`
+- `addPostprocess(fn)`
+- `enableLogging()`
+- `enableTestMode()`
+- `register(cdc, mock)`
 
-Platform-specific examples:
+Resolve dependencies:
 
-```txt
-node:worker_threads
-npm:@humanfs/core
+```javascript
+await container.get(cdc);
 ```
 
+The container is builder-configurable until the first `get(...)`. After that point configuration is locked.
+
 ## Test Mode
 
+Test mode allows registered mocks to be resolved before module instantiation:
+
 ```javascript
 container.enableTestMode();
-
 container.register("App_Service$", mockService);
 ```
 
-Mocks are resolved before module instantiation.
+This keeps replacement explicit and local to container configuration.
 
 ## Browser Usage
 
@@ -420,24 +260,59 @@ Mocks are resolved before module instantiation.
 </script>
 ```
 
-## Documentation
+## LLM-Oriented Development
+
+This package is designed for codebases where LLM agents participate in implementation and maintenance.
+
+That affects the architecture directly. In many human-oriented JavaScript codebases, local explicitness is treated as extra ceremony. Here it is a deliberate tradeoff: dependency structure stays visible where it is needed, instead of being inferred from decorators, reflection, framework conventions, or scattered configuration.
+
+This increases local structural surface area, but it reduces ambiguity. For LLM-driven maintenance, that makes dependency structure easier to reconstruct, edit, and verify from source code alone.
+
+## When This Fits
+
+This approach is a good fit when you want:
+
+- a modular monolith with explicit component boundaries;
+- shared JavaScript code across browser and Node.js;
+- runtime late binding instead of static application wiring;
+- explicit, machine-readable dependency structure;
+- a pure JavaScript + JSDoc stack instead of TypeScript-first architecture.
+
+## When It Probably Does Not
+
+This approach is probably a poor fit when:
+
+- your project is deeply committed to TypeScript-first conventions;
+- you prefer decorator-based or framework-managed injection;
+- your team values minimal local ceremony over explicit structural contracts;
+- you do not need isomorphic runtime structure or late binding;
+- the codebase is optimized only for human authorship and not for machine-assisted maintenance.
+
+## Documentation for Agents
+
+This package includes a machine-oriented package interface under `./ai/`.
+
+Those files are intended for system prompts, examples, and agent consumption. They describe:
 
-Detailed documentation lives in `ctx/`:
+- container usage;
+- dependency descriptors;
+- CDC behavior;
+- integration patterns.
 
-- `ctx/docs/product/overview.md`
-- `ctx/docs/product/default-cdc-profile.md`
-- `ctx/docs/architecture/cdc-profile/default/grammar.md`
-- `ctx/docs/architecture/cdc-profile/default/transformation.md`
-- `ctx/docs/architecture/cdc-profile/default/validation.md`
-- `ctx/docs/code/components/container.md`
+In other words, the package ships a human-facing README and a machine-oriented interface for agents that need to use it as a dependency.
 
-## Author
+## Further Reading
 
-**Alex Gusev**
+- Product overview: `ctx/docs/product/overview.md`
+- Product scope and boundaries: `ctx/docs/product/scope.md`
+- Default CDC profile and compatibility surface: `ctx/docs/product/default-cdc-profile.md`
+- Architecture overview: `ctx/docs/architecture/overview.md`
+- Runtime linking model: `ctx/docs/architecture/linking-model.md`
+- Container implementation contract: `ctx/docs/code/components/container.md`
+- Project philosophy and intended application domain: `PHILOSOPHY.md`
 
-Creator of:
+## TeqFW Context
 
-- **Tequila Framework (TeqFW)**
-- **ADSM (Agent-Driven Software Management)**
+`@teqfw/di` is the core building block of the Tequila Framework (TeqFW).
 
-The project explores how software architecture evolves when **LLM agents become active participants in the development process**.
+TeqFW is aimed at building modular monolith web applications with a unified JavaScript codebase across browser and server runtimes. The method favors late binding, namespace-based structure, explicit contracts, and source artifacts that remain legible to both humans and LLM agents.

package/ai/AGENTS.md

@@ -6,7 +6,7 @@ Version: 20260331
 
 This directory provides the **Agent Interface** of the package. It contains a compact usage-oriented description intended for LLM agents that use the package as a dependency. The documents describe how the package is applied by external code and exclude development methodology, repository organization, testing infrastructure, and other internal aspects of the project.
 
-The package implements a **dependency container for ES modules** based on runtime late binding. Dependencies between modules are resolved by the container using structured dependency identifiers and deterministic namespace resolution rules rather than static imports. The container dynamically loads ES modules, instantiates exported factories, and returns linked objects according to dependency identifier semantics.
+The package implements a **deterministic runtime dependency linker for ES modules** based on late binding. Dependencies between modules are resolved by the container using structured dependency identifiers and namespace resolution rules rather than application-level static imports. The container dynamically loads ES modules, instantiates exports according to CDC semantics, and returns linked frozen values.
 
 ## When to Use This Package
 
@@ -17,9 +17,18 @@ This package should be used when a system requires the following capabilities:
 - deterministic dependency resolution
 - controlled instantiation of components
 - modules that remain environment-agnostic across Node.js and browser runtimes
+- explicit machine-readable dependency structure for agent-assisted maintenance
 
 The container serves as the **composition root** of the application. Application modules declare dependencies and receive instantiated objects from the container rather than resolving dependencies directly.
 
+This package is primarily a fit for:
+
+- modular monolith web applications
+- isomorphic JavaScript systems with shared browser/server code
+- pure JavaScript + JSDoc codebases
+
+It is usually not a natural fit for TypeScript-first architectures built around decorators, metadata, or framework-managed DI conventions.
+
 ## Architectural Model
 
 The system is based on four mechanisms:
@@ -42,6 +51,7 @@ In this model:
 - ES modules provide implementations.
 - CDC identifiers define dependency contracts.
 - the container performs deterministic runtime linking.
+- linked values are frozen before they are returned.
 
 This mechanism separates module implementation from dependency binding and allows systems to assemble component graphs dynamically while preserving deterministic behavior.
 
@@ -59,6 +69,13 @@ Agents should read the documents in this directory in the following order:
 
 This sequence reflects the intended agent workflow: contract surface first, then architectural model, operational mechanism, dependency addressing, extension points, and practical usage.
 
+Agents that need a working integration should prefer:
+
+1. `package-api.ts` for the programmatic surface,
+2. `usage.md` for examples,
+3. `dependency-id.md` for CDC details,
+4. `container.md` for behavioral guarantees.
+
 ## Interface Scope
 
 The documents in this directory define the supported usage semantics of the package. Behaviors not described here should be treated as undefined and should not be inferred. The interface intentionally contains only the information required to correctly apply the package in external code.
@@ -73,3 +90,5 @@ The package follows architectural principles used in the **Tequila Framework (Te
 - development in modern JavaScript without compilation
 
 Understanding the broader TeqFW ecosystem is not required to use the package, but the container follows the same architectural philosophy.
+
+For agent usage, this directory is the package's machine-oriented interface. Prefer these documents over inferring behavior from repository-level prose.

package/ai/concepts.md

@@ -47,9 +47,9 @@ The identifier syntax and resolution rules are described in **dependency-id.md**
 
 ## Namespaces
 
-Namespaces provide deterministic mapping between logical identifiers and module locations. Each package defines a namespace root that corresponds to a directory containing source modules.
+Namespaces provide deterministic mapping between logical identifiers and module locations. Each package defines one or more namespace roots that map a CDC prefix to a module-specifier base.
 
-The container resolves identifiers by applying namespace rules that translate identifier prefixes into filesystem paths. This mechanism allows modules to be referenced through stable logical names instead of file paths.
+The container resolves identifiers by applying namespace rules that translate identifier prefixes into module specifiers. In Node.js this often means filesystem-backed paths. In browser-oriented or isomorphic systems this may also mean URL-based import roots.
 
 Namespace resolution ensures:
 

package/ai/container.md

@@ -42,6 +42,7 @@ The container exposes a minimal public interface used by application code and co
 
 The core operations are:
 
+- **addNamespaceRoot(prefix, target, defaultExt)** — register namespace resolution rule for Teq modules.
 - **register(identifier, value)** — register a predefined dependency or instance in the container.
 - **get(identifier)** — resolve a dependency identifier and return the linked object.
 - **addPreprocess(handler)** — register a handler that can transform dependency identifiers before resolution.
@@ -49,6 +50,8 @@ The core operations are:
 
 The exact semantics of dependency identifiers are defined in **dependency-id.md**. Dependency descriptors are export-scoped: canonical descriptors are hierarchical and keyed by export name, while flat descriptors are shorthand for limited single-export cases.
 
+`addNamespaceRoot(prefix, target, defaultExt)` accepts a module-specifier base. The `target` may point to a filesystem-backed path or to a URL-backed import base depending on runtime environment.
+
 ## Container State Model
 
 The container operates in three states:

package/ai/dependency-id.md

@@ -48,7 +48,7 @@ If no platform prefix is present, the identifier refers to an application module
 
 ## Module Identification
 
-The **ModuleName** identifies the module that provides the dependency. Module identifiers use namespace-based naming and are translated into filesystem paths according to namespace resolution rules described in **container.md**.
+The **ModuleName** identifies the module that provides the dependency. Module identifiers use namespace-based naming and are translated into module specifiers according to namespace resolution rules described in **container.md**.
 
 Identifier segments separated by underscores correspond to directory boundaries in the module path.
 
@@ -58,12 +58,14 @@ Example:
 App_Service_User
 ```
 
-maps to a module located at:
+maps to a module path such as:
 
 ```txt
 AppRoot/Service/User.js
 ```
 
+In URL-backed namespace configurations the same logical name may instead map to a URL-based module specifier with the same segment structure.
+
 ## Export Selection
 
 A CDC may reference either the default export of a module or a named export.

package/ai/package-api.ts

@@ -267,14 +267,14 @@ export const PACKAGE_API: PackageApiContract = {
             kind: 'module-contract',
             summary: 'Shape expected from application modules resolved by the container.',
             fields: {
-                __deps__: 'Optional export-scoped dependency descriptor. Canonical form is hierarchical: Record<exportName, Record<dependencyKey, CDC string>>. A flat Record<dependencyKey, CDC string> is shorthand for limited single-export cases.',
+                __deps__: 'Optional dependency descriptor. Accepted forms are: absent/empty, a flat Record<dependencyKey, CDC string> for a dependency-free default export or limited single-export shorthand, or a hierarchical Record<exportName, Record<dependencyKey, CDC string>> for named exports.',
                 moduleNamespace: 'Whole ES module namespace object returned for as-is CDC without selected export.',
                 defaultExport: 'Used when the parsed DepId selects exportName="default" for factory composition.',
                 namedExports: 'May be selected via __ExportName for factory composition and may also provide wrapper functions.',
                 wrapperExport: 'Named export whose identifier appears in depId.wrappers; it must be synchronous and unary.',
             },
             notes: [
-                'The current runtime accepts both export-scoped hierarchical descriptors and the flat shorthand form for limited single-export cases.',
+                'The runtime accepts hierarchical descriptors for named exports and the flat shorthand form for dependency-free default exports or limited single-export cases.',
                 'Wrapper functions are exported by the same resolved module namespace, not registered globally in the container.',
             ],
         },

package/ai/usage.md

@@ -14,46 +14,26 @@ Modules intended for container linking may expose a default export, a named expo
 
 Dependencies are injected into the constructor as a single structured object. In TeqFW-style modules the public API is defined inside the constructor through assignments to `this`, while internal state may be held in constructor-local variables captured by closures.
 
-Example module:
+Minimal single-export example:
 
 ```js
 // @ts-check
 
 export const __deps__ = {
-  default: {
-    cast: "Fl32_Web_Helper_Cast$",
-  },
-  Factory: {
-    cast: "Fl32_Web_Helper_Cast$",
-  },
+  cast: "App_Helper_Cast$",
 };
 
-/**
- * Runtime wrapper that can hold non-DI behavior.
- */
-
-export default class RuntimeWrapper {
-  constructor() {
-    return proxy;
-  }
-}
-
-/**
- * @typedef {Object} App_Factory$Deps
- * @property {object} cast
- */
-
-export class Factory {
+export default class App_Root {
   /**
-   * @param {App_Factory$Deps} deps
+   * @param {{cast: (value: unknown) => string}} deps
    */
   constructor({ cast }) {
-    this.configure = function (params = {}) {
-      return {
-        mode: "factory",
-        cast,
-        params,
-      };
+    return {
+      configure(params = {}) {
+        return {
+          name: cast(params.name ?? "app"),
+        };
+      },
     };
   }
 }
@@ -64,12 +44,10 @@ Dependency module:
 ```js
 // @ts-check
 
-export default class App_Child {
-  constructor() {
-    this.getName = function () {
-      return "child";
-    };
-  }
+export default function App_Helper_Cast() {
+  return function cast(value) {
+    return String(value);
+  };
 }
 ```
 
@@ -78,10 +56,41 @@ Rules:
 - the canonical form of `__deps__` is hierarchical and keyed by export name
 - each export entry maps constructor dependency names to CDC identifiers
 - if `__deps__` is absent the module has no dependencies
-- a flat `__deps__` object is shorthand for limited single-export cases
+- a flat `__deps__` object is shorthand for a dependency-free default export or limited single-export cases
+- a named export may declare dependencies without requiring a `default` entry
 - dependencies are resolved recursively before instantiation
 
-When the CDC selects `App_Module$`, the container uses the default export. When the CDC selects `App_Module__Factory$`, the container uses the named `Factory` export. In the first case the default export can act as a runtime wrapper or module shell; in the second case the named export is the DI-managed component that receives `__deps__.Factory`.
+When the CDC selects `App_Module$`, the container uses the default export. When the CDC selects `App_Module__Factory$`, the container uses the named export `Factory`.
+
+Canonical export-scoped form:
+
+```js
+export const __deps__ = {
+  default: {
+    cast: "App_Helper_Cast$",
+  },
+  Factory: {
+    cast: "App_Helper_Cast$",
+  },
+};
+
+export default class RuntimeWrapper {
+  constructor() {
+    return {mode: "wrapper"};
+  }
+}
+
+export class Factory {
+  constructor({ cast }) {
+    this.configure = function (params = {}) {
+      return {
+        mode: "factory",
+        name: cast(params.name ?? "app"),
+      };
+    };
+  }
+}
+```
 
 ## Container Configuration
 
@@ -102,6 +111,13 @@ container.addNamespaceRoot("App_", path.resolve(__dirname, "./src/App"), ".mjs")
 
 Configuration must be completed before the first dependency resolution.
 
+Browser-oriented or isomorphic configuration may also use URL-based import roots:
+
+```js
+container.addNamespaceRoot("App_", "https://cdn.example.com/app", ".mjs");
+container.addNamespaceRoot("Web_", "//cdn.example.com/web", ".mjs");
+```
+
 ## Resolving Dependencies
 
 Dependencies are obtained using CDC identifiers.
@@ -122,8 +138,7 @@ The container:
 Example usage:
 
 ```js
-console.log(root.getName());
-console.log(root.getChild().getName());
+console.log(root.configure({name: 123}).name);
 console.log(Object.isFrozen(root));
 ```
 
@@ -207,14 +222,14 @@ export const __deps__ = {
 
 export default class RuntimeWrapper {
   constructor() {
-    return proxy;
+    return {mode: "wrapper"};
   }
 }
 
 export class Factory {
   constructor({ cast }) {
     this.configure = function (params = {}) {
-      return { cast, params };
+      return {cast, params};
     };
   }
 }
@@ -236,7 +251,7 @@ Some single-export modules may use a flat `__deps__` object as shorthand.
 
 ```js
 export const __deps__ = {
-  cast: "Fl32_Web_Helper_Cast$",
+  cast: "App_Helper_Cast$",
 };
 ```
 

package/dist/esm.js

@@ -1 +1 @@
-var e=Object.freeze({AS_IS:"A",FACTORY:"F"});var t=Object.freeze({SINGLETON:"S",TRANSIENT:"T"});var o=Object.freeze({TEQ:"teq",NODE:"node",NPM:"npm"});const r=o.TEQ,n=e.AS_IS,i=new Set(Object.values(o)),s=new Set(Object.values(e)),a=new Set(Object.values(t));let l=class{moduleName;platform;exportName;composition;life;wrappers;origin},c=class{create(e){const t=e&&"object"==typeof e?e:{},o=new l;o.moduleName="string"==typeof t.moduleName?t.moduleName:"";const c="string"==typeof t.platform?t.platform:void 0;o.platform=c&&i.has(c)?c:r;let p=null;null===t.exportName?p=null:"string"==typeof t.exportName&&(p=t.exportName),o.exportName=p;const f="string"==typeof t.composition?t.composition:void 0;o.composition=f&&s.has(f)?f:n;const u="string"==typeof t.life?t.life:void 0;return o.life=u&&a.has(u)?u:null,o.wrappers=Array.isArray(t.wrappers)?t.wrappers.filter(e=>"string"==typeof e):[],o.origin="string"==typeof t.origin?t.origin:"",Object.freeze(o.wrappers),Object.freeze(o)}};class p{constructor(){const r=new c;let n=null;this.parse=function(i){if(n&&n.log(`Parser.parse: input='${i}'.`),"string"!=typeof i)throw new Error("CDC must be a string.");if(0===i.length)throw new Error("CDC must be non-empty.");if(!/^[\x00-\x7F]+$/.test(i))throw new Error("CDC must be ASCII.");const s=i;let a=i,l=o.TEQ;if(a.startsWith("node:"))l=o.NODE,a=a.slice(5);else if(a.startsWith("npm:"))l=o.NPM,a=a.slice(4);else if(a.startsWith("teq:"))throw new Error("Explicit teq: prefix is forbidden.");if(0===a.length)throw new Error("moduleName must be non-empty.");let c=null,p=!1,f=[],u=a;const m=u.match(/(\${1,3})(?:_[a-z][0-9A-Za-z]*)*$/);if(m){const e=m[1],o=m[0].slice(e.length);if(p=!0,"$"===e)c=t.SINGLETON;else if("$$"===e)c=t.TRANSIENT;else{if("$$$"!==e)throw new Error("Lifecycle marker is invalid.");c=null}u=u.slice(0,m.index),o.length>0&&(f=o.slice(1).split("_"))}else{if(a.includes("$"))throw new Error("Invalid lifecycle encoding.");if(l!==o.NODE&&/(?:^|[^_])_[a-z][0-9A-Za-z]*$/.test(a))throw new Error("Wrapper without lifecycle is forbidden.")}const d=u.indexOf("__"),g=u.lastIndexOf("__");if(-1!==d&&d!==g)throw new Error("Export delimiter must appear at most once.");if(u.startsWith("__")||u.endsWith("__"))throw new Error("Malformed export segment.");let w=u,h=null;if(-1!==d){if(w=u.slice(0,d),h=u.slice(d+2),!h)throw new Error("Export must be non-empty.");if(h.includes("_"))throw new Error("Export must not contain _.");if(h.includes("$"))throw new Error("Export must not contain $.")}if(!w)throw new Error("moduleName must be non-empty.");if(w.startsWith("_")||w.startsWith("$"))throw new Error("moduleName must not start with _ or $.");if(w.includes("__"))throw new Error("moduleName must not contain __.");if(w.includes("$"))throw new Error("moduleName must not contain $.");if(l!==o.NPM){if(l===o.NODE){if(!/^[A-Za-z_][$0-9A-Za-z_/-]*$/.test(w))throw new Error("node moduleName must satisfy the built-in specifier form.")}else if(!/^[A-Za-z_][$0-9A-Za-z_]*$/.test(w))throw new Error("moduleName must satisfy the canonical identifier form.")}else if(!/^[@A-Za-z_][$0-9A-Za-z_./-]*$/.test(w))throw new Error("npm moduleName must satisfy the package specifier form.");let y=e.AS_IS;null!==h?y=e.FACTORY:p&&(y=e.FACTORY,h="default");const $=r.create({moduleName:w,platform:l,exportName:h,composition:y,life:c,wrappers:f,origin:s});return n&&n.log(`Parser.parse: produced='${$.platform}::${$.moduleName}'.`),$},this.setLogger=function(e){n=e}}}let f=class{prefix;target;defaultExt},u=class{create(e){const t=e&&"object"==typeof e?e:{},o=new f;return o.prefix="string"==typeof t.prefix?t.prefix:void 0,o.target="string"==typeof t.target?t.target:void 0,o.defaultExt="string"==typeof t.defaultExt?t.defaultExt:void 0,Object.freeze(o)}};class m{namespaces;nodeModulesRoot}class d{constructor(){const e=new u;this.create=function(t){const o=t&&"object"==typeof t?t:{},r=new m,n=Array.isArray(o.namespaces)?o.namespaces:[];return r.namespaces=n.map(t=>e.create(t)),r.nodeModulesRoot="string"==typeof o.nodeModulesRoot?o.nodeModulesRoot:void 0,Object.freeze(r.namespaces),Object.freeze(r)}}}class g{constructor({config:e,importFn:t=e=>import(e),logger:o=null}){const r=new Map,n=e;let i;const s=t,a=o,l=function(e,t){if("node"===e){const e=`node:${t}`;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("npm"===e){const e=t;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("teq"!==e)throw new Error(`Unsupported platform: ${e}`);const o=function(e){let t=null,o=-1;const r=i.namespaces;for(const n of r){const r=e.startsWith(n.prefix);a&&a.log(`Resolver.namespace: prefix='${n.prefix}' match=${String(r)} module='${e}'.`),r&&n.prefix.length>o&&(t=n,o=n.prefix.length)}if(!t)throw new Error(`Namespace rule is not found for '${e}'.`);return t}(t),r=t.slice(o.prefix.length).split("_").join("/"),n=(s=r,(l=o.defaultExt)?s.endsWith(l)?s:`${s}${l}`:s);var s,l;const c=function(e,t){return e?e.endsWith("/")?`${e}${t}`:`${e}/${t}`:t}(o.target,n);return a&&a.log(`Resolver.specifier: module='${t}' -> '${c}'.`),c};this.resolve=async function(e){var t;await Promise.resolve(),i||(i={nodeModulesRoot:(t=n).nodeModulesRoot,namespaces:t.namespaces.map(e=>({prefix:e.prefix,target:e.target,defaultExt:e.defaultExt}))});const o=e.platform,c=e.moduleName,p=`${o}::${c}`;if(r.has(p))return a&&a.log(`Resolver.cache: hit key='${p}'.`),r.get(p);a&&a.log(`Resolver.cache: miss key='${p}'.`);const f=(async()=>{const e=l(o,c);return a&&a.log(`Resolver.import: '${e}'.`),s(e)})();r.set(p,f);try{return await f}catch(e){throw r.delete(p),a&&a.error(`Resolver.cache: evict key='${p}' after failure.`,e),e}}}}class w{constructor({parser:e,resolver:t,logger:o=null}){const r=o,n=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")},i=async function(o,s,a,l){const c=n(o);if(a.has(c)){const e=[...l,c].join(" -> ");throw new Error(`Cyclic dependency detected: ${e}`)}const p=n(o);if(!s.has(p)){a.add(c),l.push(c);try{const n=await t.resolve(o);r&&r.log(`GraphResolver.walk: resolved '${p}'.`),s.set(p,{depId:o,namespace:n});const c=Reflect.get(n,"__deps__");if(void 0===c)return;let f=c;if(null!==c&&"object"==typeof c&&!Array.isArray(c)){const e=null===o.exportName?"default":o.exportName,t=Reflect.get(c,e);null==t||"object"!=typeof t||Array.isArray(t)||(f=t)}for(const[,t]of Object.entries(f)){const o=t,n=e.parse(o);r&&r.log(`GraphResolver.walk: edge '${p}' -> '${n.platform}::${n.moduleName}'.`),await i(n,s,a,l)}}finally{l.pop(),a.delete(c)}}};this.resolve=async function(e){const t=new Map,o=new Set;return await i(e,t,o,[]),t}}}class h{constructor(){this.instantiate=function(t,o,r){const n=function(e,t){if(null===e.exportName)return t;if(!(e.exportName in t))throw new Error(`Export '${e.exportName}' is not found in module namespace.`);return t[e.exportName]}(t,o);if(t.composition===e.AS_IS)return n;if(t.composition===e.FACTORY){if("function"!=typeof n)throw new Error("Factory composition requires a callable export.");const e=n;let t;if(function(e){try{return Reflect.construct(String,[],e),!0}catch{return!1}}(e)){t=new e(r)}else{t=e(r)}if(t instanceof Promise)throw new Error("Factory composition must return synchronously (non-Promise).");return t}throw new Error(`Unsupported composition mode: ${String(t.composition)}.`)}}}class y{constructor(o=null){const r=new Map,n=o;this.apply=function(o,i){if(o.composition!==e.FACTORY)return n&&n.log(`Lifecycle.apply: composition='${o.composition}' cache=skip.`),i();if(o.life===t.TRANSIENT)return n&&n.log("Lifecycle.apply: transient cache=skip."),i();if(o.life===t.SINGLETON){const e=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")}(o);if(r.has(e))return n&&n.log(`Lifecycle.cache: hit key='${e}'.`),r.get(e);n&&n.log(`Lifecycle.cache: miss key='${e}', create.`);const t=i();return r.set(e,t),n&&n.log(`Lifecycle.cache: stored key='${e}'.`),t}return n&&n.log("Lifecycle.apply: no lifecycle marker cache=skip."),i()}}}class ${constructor(){const e=function(e){return"function"==typeof e};this.execute=function(t,o,r){let n=o;const i=t.wrappers;for(const t of i){if(!(t in r))throw new Error(`Wrapper '${t}' is not found in module namespace.`);const o=r[t];if(!e(o))throw new Error(`Wrapper '${t}' must be callable.`);if(n=o(n),n instanceof Promise)throw new Error(`Wrapper '${t}' must return synchronously (non-Promise).`)}return n}}}class N{constructor(e="teqfw/di"){const t=`[${e}]`;this.log=function(e){console.debug(`${t} ${e}`)},this.error=function(e,o){console.error(`${t} ${e}`),o instanceof Error?console.error(o.stack??o.message):void 0!==o&&console.error(o)}}}const x=Object.freeze({log(){},error(){}});class E{constructor(){let e="notConfigured";const t=[],o=[],r=[],n=new Map,i=new WeakMap;let s=!1,a=!1,l=new p;const c=new d;let f,u,m,E=x;const C=new h,b=new $,v=function(e){const t=null===e.exportName?"":e.exportName,o=null===e.life?"":e.life,r=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,t,e.composition,o,r].join("::")},A=function(e){return v(e)},_=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;if("[object Module]"===Object.prototype.toString.call(e))return e;if(Object.isFrozen(e))return e;try{Object.freeze(e)}catch(e){E.log(`Container.freeze: skipped (${String(e)}).`)}return e},j=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;const o=e;if(i.has(o))return i.get(o);try{return Reflect.get(o,"then"),e}catch{const e=new Proxy(o,{get(e,t,o){if("then"!==t)return Reflect.get(e,t,o)}});return i.set(o,e),e}},I=function(){if("notConfigured"!==e)throw new Error("Container configuration is locked.")},R=function(e){a&&E.log(`Container.builder: ${e}`)};this.addPreprocess=function(e){I(),R("addPreprocess()."),t.push(e)},this.addPostprocess=function(e){I(),R("addPostprocess()."),o.push(e)},this.setParser=function(e){I(),l=e,"function"==typeof l.setLogger&&l.setLogger(a?E:null),R("setParser().")},this.addNamespaceRoot=function(e,t,o){I(),R(`addNamespaceRoot('${e}').`),r.push({prefix:e,target:t,defaultExt:o})},this.enableTestMode=function(){I(),R("enableTestMode()."),s=!0},this.enableLogging=function(){I(),a||(a=!0,E=new N,"function"==typeof l.setLogger&&l.setLogger(E),E.log("Container.builder: enableLogging()."))},this.register=function(e,t){if(I(),R(`register('${e}').`),!0!==s)throw new Error("Container test mode is disabled.");const o=l.parse(e);n.set(A(o),t)},this.get=async function(i){if("failed"===e)throw E.error(`Container.get: rejected in failed state cdc='${i}'.`),new Error("Container is in failed state.");let a="start";try{E.log(`Container.get: cdc='${i}'.`),function(){if("notConfigured"!==e)return;E.log("Container.transition: notConfigured -> operational."),e="operational";const t=c.create({namespaces:r});"function"==typeof l.setLogger&&l.setLogger(E),f=new g({config:t,logger:E}),u=new w({parser:l,resolver:f,logger:E}),m=new y(E)}(),E.log(`Container.state: '${e}'.`),a="parse",E.log("Container.pipeline: parse:entry.");const p=l.parse(i);E.log(`Container.pipeline: parse:exit '${p.platform}::${p.moduleName}'.`),a="preprocess",E.log("Container.pipeline: preprocess:entry.");const d=function(e){let o=e;for(const e of t)o=e(o);return o}(p);if(E.log(`Container.pipeline: preprocess:exit '${d.platform}::${d.moduleName}'.`),!0===s){a="mock",E.log("Container.pipeline: mock-lookup:entry.");const e=A(d);if(n.has(e)){E.log(`Container.pipeline: mock-lookup:hit '${e}'.`),a="freeze",E.log("Container.pipeline: freeze:entry.");const t=_(n.get(e));return E.log("Container.pipeline: freeze:exit."),E.log("Container.pipeline: return:success."),j(t)}E.log(`Container.pipeline: mock-lookup:miss '${e}'.`)}else E.log("Container.pipeline: mock-lookup:disabled.");a="resolve",E.log("Container.pipeline: resolve:entry.");const h=await u.resolve(d);E.log(`Container.pipeline: resolve:exit nodes=${h.size}.`);const $=new Map,N=function(e){if($.has(e))return $.get(e);if(!h.has(e))throw new Error(`Resolved graph node is missing for '${e}'.`);const t=h.get(e);a="lifecycle",E.log(`Container.pipeline: lifecycle:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const r=m.apply(t.depId,function(){a="instantiate",E.log(`Container.pipeline: instantiate:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const e={},r=function(e,t){const o=Reflect.get(e,"__deps__");if(void 0===o)return{};if(null!==o&&"object"==typeof o&&!Array.isArray(o)){const e=null===t.exportName?"default":t.exportName,r=Reflect.get(o,e);if(null!=r&&"object"==typeof r&&!Array.isArray(r))return r}return o}(t.namespace,t.depId);for(const[t,o]of Object.entries(r)){const r=o,n=l.parse(r);e[t]=N(v(n))}const n=C.instantiate(t.depId,t.namespace,e);E.log(`Container.pipeline: instantiate:exit '${t.depId.platform}::${t.depId.moduleName}'.`),a="postprocess",E.log(`Container.pipeline: postprocess:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const i=function(e){let t=e;for(const e of o)t=e(t);return t}(n);E.log(`Container.pipeline: postprocess:exit '${t.depId.platform}::${t.depId.moduleName}'.`);const s=b.execute(t.depId,i,t.namespace);a="freeze",E.log(`Container.pipeline: freeze:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const c=_(s);return E.log(`Container.pipeline: freeze:exit '${t.depId.platform}::${t.depId.moduleName}'.`),c});return E.log(`Container.pipeline: lifecycle:exit '${t.depId.platform}::${t.depId.moduleName}'.`),$.set(e,r),r},x=N(v(d));return E.log("Container.pipeline: return:success."),j(x)}catch(t){throw E.error(`Container.pipeline: failed at stage='${a}'.`,t),E.log("Container.transition: operational -> failed."),e="failed",t}}}}export{E as default};
+var e=Object.freeze({AS_IS:"A",FACTORY:"F"});var t=Object.freeze({SINGLETON:"S",TRANSIENT:"T"});var r=Object.freeze({TEQ:"teq",NODE:"node",NPM:"npm"});const o=r.TEQ,n=e.AS_IS,i=new Set(Object.values(r)),s=new Set(Object.values(e)),a=new Set(Object.values(t));let l=class{moduleName;platform;exportName;composition;life;wrappers;origin},c=class{create(e){const t=e&&"object"==typeof e?e:{},r=new l;r.moduleName="string"==typeof t.moduleName?t.moduleName:"";const c="string"==typeof t.platform?t.platform:void 0;r.platform=c&&i.has(c)?c:o;let p=null;null===t.exportName?p=null:"string"==typeof t.exportName&&(p=t.exportName),r.exportName=p;const f="string"==typeof t.composition?t.composition:void 0;r.composition=f&&s.has(f)?f:n;const u="string"==typeof t.life?t.life:void 0;return r.life=u&&a.has(u)?u:null,r.wrappers=Array.isArray(t.wrappers)?t.wrappers.filter(e=>"string"==typeof e):[],r.origin="string"==typeof t.origin?t.origin:"",Object.freeze(r.wrappers),Object.freeze(r)}};class p{constructor(){const o=new c;let n=null;this.parse=function(i){if(n&&n.log(`Parser.parse: input='${i}'.`),"string"!=typeof i)throw new Error("CDC must be a string.");if(0===i.length)throw new Error("CDC must be non-empty.");if(!/^[\x00-\x7F]+$/.test(i))throw new Error("CDC must be ASCII.");const s=i;let a=i,l=r.TEQ;if(a.startsWith("node:"))l=r.NODE,a=a.slice(5);else if(a.startsWith("npm:"))l=r.NPM,a=a.slice(4);else if(a.startsWith("teq:"))throw new Error("Explicit teq: prefix is forbidden.");if(0===a.length)throw new Error("moduleName must be non-empty.");let c=null,p=!1,f=[],u=a;const d=u.match(/(\${1,3})(?:_[a-z][0-9A-Za-z]*)*$/);if(d){const e=d[1],r=d[0].slice(e.length);if(p=!0,"$"===e)c=t.SINGLETON;else if("$$"===e)c=t.TRANSIENT;else{if("$$$"!==e)throw new Error("Lifecycle marker is invalid.");c=null}u=u.slice(0,d.index),r.length>0&&(f=r.slice(1).split("_"))}else{if(a.includes("$"))throw new Error("Invalid lifecycle encoding.");if(l!==r.NODE&&/(?:^|[^_])_[a-z][0-9A-Za-z]*$/.test(a))throw new Error("Wrapper without lifecycle is forbidden.")}const m=u.indexOf("__"),g=u.lastIndexOf("__");if(-1!==m&&m!==g)throw new Error("Export delimiter must appear at most once.");if(u.startsWith("__")||u.endsWith("__"))throw new Error("Malformed export segment.");let w=u,h=null;if(-1!==m){if(w=u.slice(0,m),h=u.slice(m+2),!h)throw new Error("Export must be non-empty.");if(h.includes("_"))throw new Error("Export must not contain _.");if(h.includes("$"))throw new Error("Export must not contain $.")}if(!w)throw new Error("moduleName must be non-empty.");if(w.startsWith("_")||w.startsWith("$"))throw new Error("moduleName must not start with _ or $.");if(w.includes("__"))throw new Error("moduleName must not contain __.");if(w.includes("$"))throw new Error("moduleName must not contain $.");if(l!==r.NPM){if(l===r.NODE){if(!/^[A-Za-z_][$0-9A-Za-z_/-]*$/.test(w))throw new Error("node moduleName must satisfy the built-in specifier form.")}else if(!/^[A-Za-z_][$0-9A-Za-z_]*$/.test(w))throw new Error("moduleName must satisfy the canonical identifier form.")}else if(!/^[@A-Za-z_][$0-9A-Za-z_./-]*$/.test(w))throw new Error("npm moduleName must satisfy the package specifier form.");let y=e.AS_IS;null!==h?y=e.FACTORY:p&&(y=e.FACTORY,h="default");const $=o.create({moduleName:w,platform:l,exportName:h,composition:y,life:c,wrappers:f,origin:s});return n&&n.log(`Parser.parse: produced='${$.platform}::${$.moduleName}'.`),$},this.setLogger=function(e){n=e}}}let f=class{prefix;target;defaultExt},u=class{create(e){const t=e&&"object"==typeof e?e:{},r=new f;return r.prefix="string"==typeof t.prefix?t.prefix:void 0,r.target="string"==typeof t.target?t.target:void 0,r.defaultExt="string"==typeof t.defaultExt?t.defaultExt:void 0,Object.freeze(r)}};class d{namespaces;nodeModulesRoot}class m{constructor(){const e=new u;this.create=function(t){const r=t&&"object"==typeof t?t:{},o=new d,n=Array.isArray(r.namespaces)?r.namespaces:[];return o.namespaces=n.map(t=>e.create(t)),o.nodeModulesRoot="string"==typeof r.nodeModulesRoot?r.nodeModulesRoot:void 0,Object.freeze(o.namespaces),Object.freeze(o)}}}class g{constructor({config:e,importFn:t=e=>import(e),logger:r=null}){const o=new Map,n=e;let i;const s=t,a=r,l=function(e,t){if("node"===e){const e=`node:${t}`;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("npm"===e){const e=t;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("teq"!==e)throw new Error(`Unsupported platform: ${e}`);const r=function(e){let t=null,r=-1;const o=i.namespaces;for(const n of o){const o=e.startsWith(n.prefix);a&&a.log(`Resolver.namespace: prefix='${n.prefix}' match=${String(o)} module='${e}'.`),o&&n.prefix.length>r&&(t=n,r=n.prefix.length)}if(!t)throw new Error(`Namespace rule is not found for '${e}'.`);return t}(t),o=t.slice(r.prefix.length).split("_").join("/"),n=(s=o,(l=r.defaultExt)?s.endsWith(l)?s:`${s}${l}`:s);var s,l;const c=function(e,t){return e?e.endsWith("/")?`${e}${t}`:`${e}/${t}`:t}(r.target,n);return a&&a.log(`Resolver.specifier: module='${t}' -> '${c}'.`),c};this.resolve=async function(e){var t;await Promise.resolve(),i||(i={nodeModulesRoot:(t=n).nodeModulesRoot,namespaces:t.namespaces.map(e=>({prefix:e.prefix,target:e.target,defaultExt:e.defaultExt}))});const r=e.platform,c=e.moduleName,p=`${r}::${c}`;if(o.has(p))return a&&a.log(`Resolver.cache: hit key='${p}'.`),o.get(p);a&&a.log(`Resolver.cache: miss key='${p}'.`);const f=(async()=>{const e=l(r,c);return a&&a.log(`Resolver.import: '${e}'.`),s(e)})();o.set(p,f);try{return await f}catch(e){throw o.delete(p),a&&a.error(`Resolver.cache: evict key='${p}' after failure.`,e),e}}}}class w{constructor({parser:e,resolver:t,logger:r=null}){const o=r,n=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")},i=async function(r,s,a,l){const c=n(r);if(a.has(c)){const e=[...l,c].join(" -> ");throw new Error(`Cyclic dependency detected: ${e}`)}const p=n(r);if(!s.has(p)){a.add(c),l.push(c);try{const n=await t.resolve(r);o&&o.log(`GraphResolver.walk: resolved '${p}'.`),s.set(p,{depId:r,namespace:n});const c=Reflect.get(n,"__deps__");if(void 0===c)return;let f={};if(null===c||"object"!=typeof c||Array.isArray(c))throw new Error("__deps__ must be a plain object.");const u=null===r.exportName?"default":r.exportName,d=Reflect.get(c,u);if(null==d||"object"!=typeof d||Array.isArray(d)){if("default"===u){const e=Object.values(c);if(e.every(e=>"string"==typeof e))f=c;else if(!e.every(e=>null!==e&&"object"==typeof e&&!Array.isArray(e)))throw new Error("__deps__ must be either flat or export-scoped.")}}else{if(!Object.values(d).every(e=>"string"==typeof e))throw new Error("__deps__ export entries must map dependency names to CDC strings.");f=d}for(const[,t]of Object.entries(f)){const r=t,n=e.parse(r);o&&o.log(`GraphResolver.walk: edge '${p}' -> '${n.platform}::${n.moduleName}'.`),await i(n,s,a,l)}}finally{l.pop(),a.delete(c)}}};this.resolve=async function(e){const t=new Map,r=new Set;return await i(e,t,r,[]),t}}}class h{constructor(){this.instantiate=function(t,r,o){const n=function(e,t){if(null===e.exportName)return t;if(!(e.exportName in t))throw new Error(`Export '${e.exportName}' is not found in module namespace.`);return t[e.exportName]}(t,r);if(t.composition===e.AS_IS)return n;if(t.composition===e.FACTORY){if("function"!=typeof n)throw new Error("Factory composition requires a callable export.");const e=n;let t;if(function(e){try{return Reflect.construct(String,[],e),!0}catch{return!1}}(e)){t=new e(o)}else{t=e(o)}if(t instanceof Promise)throw new Error("Factory composition must return synchronously (non-Promise).");return t}throw new Error(`Unsupported composition mode: ${String(t.composition)}.`)}}}class y{constructor(r=null){const o=new Map,n=r;this.apply=function(r,i){if(r.composition!==e.FACTORY)return n&&n.log(`Lifecycle.apply: composition='${r.composition}' cache=skip.`),i();if(r.life===t.TRANSIENT)return n&&n.log("Lifecycle.apply: transient cache=skip."),i();if(r.life===t.SINGLETON){const e=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")}(r);if(o.has(e))return n&&n.log(`Lifecycle.cache: hit key='${e}'.`),o.get(e);n&&n.log(`Lifecycle.cache: miss key='${e}', create.`);const t=i();return o.set(e,t),n&&n.log(`Lifecycle.cache: stored key='${e}'.`),t}return n&&n.log("Lifecycle.apply: no lifecycle marker cache=skip."),i()}}}class ${constructor(){const e=function(e){return"function"==typeof e};this.execute=function(t,r,o){let n=r;const i=t.wrappers;for(const t of i){if(!(t in o))throw new Error(`Wrapper '${t}' is not found in module namespace.`);const r=o[t];if(!e(r))throw new Error(`Wrapper '${t}' must be callable.`);if(n=r(n),n instanceof Promise)throw new Error(`Wrapper '${t}' must return synchronously (non-Promise).`)}return n}}}class x{constructor(e="teqfw/di"){const t=`[${e}]`;this.log=function(e){console.debug(`${t} ${e}`)},this.error=function(e,r){console.error(`${t} ${e}`),r instanceof Error?console.error(r.stack??r.message):void 0!==r&&console.error(r)}}}const N=Object.freeze({log(){},error(){}});class E{constructor(){let e="notConfigured";const t=[],r=[],o=[],n=new Map,i=new WeakMap;let s=!1,a=!1,l=new p;const c=new m;let f,u,d,E=N;const _=new h,b=new $,C=function(e){const t=null===e.exportName?"":e.exportName,r=null===e.life?"":e.life,o=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,t,e.composition,r,o].join("::")},v=function(e){return C(e)},j=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;if("[object Module]"===Object.prototype.toString.call(e))return e;if(Object.isFrozen(e))return e;try{Object.freeze(e)}catch(e){E.log(`Container.freeze: skipped (${String(e)}).`)}return e},A=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;const r=e;if(i.has(r))return i.get(r);try{return Reflect.get(r,"then"),e}catch{const e=new Proxy(r,{get(e,t,r){if("then"!==t)return Reflect.get(e,t,r)}});return i.set(r,e),e}},I=function(){if("notConfigured"!==e)throw new Error("Container configuration is locked.")},O=function(e){a&&E.log(`Container.builder: ${e}`)};this.addPreprocess=function(e){I(),O("addPreprocess()."),t.push(e)},this.addPostprocess=function(e){I(),O("addPostprocess()."),r.push(e)},this.setParser=function(e){I(),l=e,"function"==typeof l.setLogger&&l.setLogger(a?E:null),O("setParser().")},this.addNamespaceRoot=function(e,t,r){I(),O(`addNamespaceRoot('${e}').`),o.push({prefix:e,target:t,defaultExt:r})},this.enableTestMode=function(){I(),O("enableTestMode()."),s=!0},this.enableLogging=function(){I(),a||(a=!0,E=new x,"function"==typeof l.setLogger&&l.setLogger(E),E.log("Container.builder: enableLogging()."))},this.register=function(e,t){if(I(),O(`register('${e}').`),!0!==s)throw new Error("Container test mode is disabled.");const r=l.parse(e);n.set(v(r),t)},this.get=async function(i){if("failed"===e)throw E.error(`Container.get: rejected in failed state cdc='${i}'.`),new Error("Container is in failed state.");let a="start";try{E.log(`Container.get: cdc='${i}'.`),function(){if("notConfigured"!==e)return;E.log("Container.transition: notConfigured -> operational."),e="operational";const t=c.create({namespaces:o});"function"==typeof l.setLogger&&l.setLogger(E),f=new g({config:t,logger:E}),u=new w({parser:l,resolver:f,logger:E}),d=new y(E)}(),E.log(`Container.state: '${e}'.`),a="parse",E.log("Container.pipeline: parse:entry.");const p=l.parse(i);E.log(`Container.pipeline: parse:exit '${p.platform}::${p.moduleName}'.`),a="preprocess",E.log("Container.pipeline: preprocess:entry.");const m=function(e){let r=e;for(const e of t)r=e(r);return r}(p);if(E.log(`Container.pipeline: preprocess:exit '${m.platform}::${m.moduleName}'.`),!0===s){a="mock",E.log("Container.pipeline: mock-lookup:entry.");const e=v(m);if(n.has(e)){E.log(`Container.pipeline: mock-lookup:hit '${e}'.`),a="freeze",E.log("Container.pipeline: freeze:entry.");const t=j(n.get(e));return E.log("Container.pipeline: freeze:exit."),E.log("Container.pipeline: return:success."),A(t)}E.log(`Container.pipeline: mock-lookup:miss '${e}'.`)}else E.log("Container.pipeline: mock-lookup:disabled.");a="resolve",E.log("Container.pipeline: resolve:entry.");const h=await u.resolve(m);E.log(`Container.pipeline: resolve:exit nodes=${h.size}.`);const $=new Map,x=function(e){if($.has(e))return $.get(e);if(!h.has(e))throw new Error(`Resolved graph node is missing for '${e}'.`);const t=h.get(e);a="lifecycle",E.log(`Container.pipeline: lifecycle:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const o=d.apply(t.depId,function(){a="instantiate",E.log(`Container.pipeline: instantiate:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const e={},o=function(e,t){const r=Reflect.get(e,"__deps__");if(void 0===r)return{};if(null===r||"object"!=typeof r||Array.isArray(r))throw new Error("__deps__ must be a plain object.");const o=null===t.exportName?"default":t.exportName,n=Reflect.get(r,o);if(null!=n&&"object"==typeof n&&!Array.isArray(n)){if(!Object.values(n).every(e=>"string"==typeof e))throw new Error("__deps__ export entries must map dependency names to CDC strings.");return n}if("default"===o){const e=Object.values(r);if(e.every(e=>"string"==typeof e))return r;if(e.every(e=>null!==e&&"object"==typeof e&&!Array.isArray(e)))return{};throw new Error("__deps__ must be either flat or export-scoped.")}return{}}(t.namespace,t.depId);for(const[t,r]of Object.entries(o)){const o=r,n=l.parse(o);e[t]=x(C(n))}const n=_.instantiate(t.depId,t.namespace,e);E.log(`Container.pipeline: instantiate:exit '${t.depId.platform}::${t.depId.moduleName}'.`),a="postprocess",E.log(`Container.pipeline: postprocess:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const i=function(e){let t=e;for(const e of r)t=e(t);return t}(n);E.log(`Container.pipeline: postprocess:exit '${t.depId.platform}::${t.depId.moduleName}'.`);const s=b.execute(t.depId,i,t.namespace);a="freeze",E.log(`Container.pipeline: freeze:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const c=j(s);return E.log(`Container.pipeline: freeze:exit '${t.depId.platform}::${t.depId.moduleName}'.`),c});return E.log(`Container.pipeline: lifecycle:exit '${t.depId.platform}::${t.depId.moduleName}'.`),$.set(e,o),o},N=x(C(m));return E.log("Container.pipeline: return:success."),A(N)}catch(t){throw E.error(`Container.pipeline: failed at stage='${a}'.`,t),E.log("Container.transition: operational -> failed."),e="failed",t}}}}export{E as default};

package/dist/umd.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).TeqFw_Di_Container=t()}(this,function(){"use strict";var e=Object.freeze({AS_IS:"A",FACTORY:"F"});var t=Object.freeze({SINGLETON:"S",TRANSIENT:"T"});var o=Object.freeze({TEQ:"teq",NODE:"node",NPM:"npm"});const r=o.TEQ,n=e.AS_IS,i=new Set(Object.values(o)),s=new Set(Object.values(e)),a=new Set(Object.values(t));let l=class{moduleName;platform;exportName;composition;life;wrappers;origin},c=class{create(e){const t=e&&"object"==typeof e?e:{},o=new l;o.moduleName="string"==typeof t.moduleName?t.moduleName:"";const c="string"==typeof t.platform?t.platform:void 0;o.platform=c&&i.has(c)?c:r;let p=null;null===t.exportName?p=null:"string"==typeof t.exportName&&(p=t.exportName),o.exportName=p;const f="string"==typeof t.composition?t.composition:void 0;o.composition=f&&s.has(f)?f:n;const u="string"==typeof t.life?t.life:void 0;return o.life=u&&a.has(u)?u:null,o.wrappers=Array.isArray(t.wrappers)?t.wrappers.filter(e=>"string"==typeof e):[],o.origin="string"==typeof t.origin?t.origin:"",Object.freeze(o.wrappers),Object.freeze(o)}};class p{constructor(){const r=new c;let n=null;this.parse=function(i){if(n&&n.log(`Parser.parse: input='${i}'.`),"string"!=typeof i)throw new Error("CDC must be a string.");if(0===i.length)throw new Error("CDC must be non-empty.");if(!/^[\x00-\x7F]+$/.test(i))throw new Error("CDC must be ASCII.");const s=i;let a=i,l=o.TEQ;if(a.startsWith("node:"))l=o.NODE,a=a.slice(5);else if(a.startsWith("npm:"))l=o.NPM,a=a.slice(4);else if(a.startsWith("teq:"))throw new Error("Explicit teq: prefix is forbidden.");if(0===a.length)throw new Error("moduleName must be non-empty.");let c=null,p=!1,f=[],u=a;const d=u.match(/(\${1,3})(?:_[a-z][0-9A-Za-z]*)*$/);if(d){const e=d[1],o=d[0].slice(e.length);if(p=!0,"$"===e)c=t.SINGLETON;else if("$$"===e)c=t.TRANSIENT;else{if("$$$"!==e)throw new Error("Lifecycle marker is invalid.");c=null}u=u.slice(0,d.index),o.length>0&&(f=o.slice(1).split("_"))}else{if(a.includes("$"))throw new Error("Invalid lifecycle encoding.");if(l!==o.NODE&&/(?:^|[^_])_[a-z][0-9A-Za-z]*$/.test(a))throw new Error("Wrapper without lifecycle is forbidden.")}const m=u.indexOf("__"),g=u.lastIndexOf("__");if(-1!==m&&m!==g)throw new Error("Export delimiter must appear at most once.");if(u.startsWith("__")||u.endsWith("__"))throw new Error("Malformed export segment.");let h=u,w=null;if(-1!==m){if(h=u.slice(0,m),w=u.slice(m+2),!w)throw new Error("Export must be non-empty.");if(w.includes("_"))throw new Error("Export must not contain _.");if(w.includes("$"))throw new Error("Export must not contain $.")}if(!h)throw new Error("moduleName must be non-empty.");if(h.startsWith("_")||h.startsWith("$"))throw new Error("moduleName must not start with _ or $.");if(h.includes("__"))throw new Error("moduleName must not contain __.");if(h.includes("$"))throw new Error("moduleName must not contain $.");if(l!==o.NPM){if(l===o.NODE){if(!/^[A-Za-z_][$0-9A-Za-z_/-]*$/.test(h))throw new Error("node moduleName must satisfy the built-in specifier form.")}else if(!/^[A-Za-z_][$0-9A-Za-z_]*$/.test(h))throw new Error("moduleName must satisfy the canonical identifier form.")}else if(!/^[@A-Za-z_][$0-9A-Za-z_./-]*$/.test(h))throw new Error("npm moduleName must satisfy the package specifier form.");let y=e.AS_IS;null!==w?y=e.FACTORY:p&&(y=e.FACTORY,w="default");const $=r.create({moduleName:h,platform:l,exportName:w,composition:y,life:c,wrappers:f,origin:s});return n&&n.log(`Parser.parse: produced='${$.platform}::${$.moduleName}'.`),$},this.setLogger=function(e){n=e}}}let f=class{prefix;target;defaultExt},u=class{create(e){const t=e&&"object"==typeof e?e:{},o=new f;return o.prefix="string"==typeof t.prefix?t.prefix:void 0,o.target="string"==typeof t.target?t.target:void 0,o.defaultExt="string"==typeof t.defaultExt?t.defaultExt:void 0,Object.freeze(o)}};class d{namespaces;nodeModulesRoot}class m{constructor(){const e=new u;this.create=function(t){const o=t&&"object"==typeof t?t:{},r=new d,n=Array.isArray(o.namespaces)?o.namespaces:[];return r.namespaces=n.map(t=>e.create(t)),r.nodeModulesRoot="string"==typeof o.nodeModulesRoot?o.nodeModulesRoot:void 0,Object.freeze(r.namespaces),Object.freeze(r)}}}class g{constructor({config:e,importFn:t=e=>import(e),logger:o=null}){const r=new Map,n=e;let i;const s=t,a=o,l=function(e,t){if("node"===e){const e=`node:${t}`;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("npm"===e){const e=t;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("teq"!==e)throw new Error(`Unsupported platform: ${e}`);const o=function(e){let t=null,o=-1;const r=i.namespaces;for(const n of r){const r=e.startsWith(n.prefix);a&&a.log(`Resolver.namespace: prefix='${n.prefix}' match=${String(r)} module='${e}'.`),r&&n.prefix.length>o&&(t=n,o=n.prefix.length)}if(!t)throw new Error(`Namespace rule is not found for '${e}'.`);return t}(t),r=t.slice(o.prefix.length).split("_").join("/"),n=(s=r,(l=o.defaultExt)?s.endsWith(l)?s:`${s}${l}`:s);var s,l;const c=function(e,t){return e?e.endsWith("/")?`${e}${t}`:`${e}/${t}`:t}(o.target,n);return a&&a.log(`Resolver.specifier: module='${t}' -> '${c}'.`),c};this.resolve=async function(e){var t;await Promise.resolve(),i||(i={nodeModulesRoot:(t=n).nodeModulesRoot,namespaces:t.namespaces.map(e=>({prefix:e.prefix,target:e.target,defaultExt:e.defaultExt}))});const o=e.platform,c=e.moduleName,p=`${o}::${c}`;if(r.has(p))return a&&a.log(`Resolver.cache: hit key='${p}'.`),r.get(p);a&&a.log(`Resolver.cache: miss key='${p}'.`);const f=(async()=>{const e=l(o,c);return a&&a.log(`Resolver.import: '${e}'.`),s(e)})();r.set(p,f);try{return await f}catch(e){throw r.delete(p),a&&a.error(`Resolver.cache: evict key='${p}' after failure.`,e),e}}}}class h{constructor({parser:e,resolver:t,logger:o=null}){const r=o,n=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")},i=async function(o,s,a,l){const c=n(o);if(a.has(c)){const e=[...l,c].join(" -> ");throw new Error(`Cyclic dependency detected: ${e}`)}const p=n(o);if(!s.has(p)){a.add(c),l.push(c);try{const n=await t.resolve(o);r&&r.log(`GraphResolver.walk: resolved '${p}'.`),s.set(p,{depId:o,namespace:n});const c=Reflect.get(n,"__deps__");if(void 0===c)return;let f=c;if(null!==c&&"object"==typeof c&&!Array.isArray(c)){const e=null===o.exportName?"default":o.exportName,t=Reflect.get(c,e);null==t||"object"!=typeof t||Array.isArray(t)||(f=t)}for(const[,t]of Object.entries(f)){const o=t,n=e.parse(o);r&&r.log(`GraphResolver.walk: edge '${p}' -> '${n.platform}::${n.moduleName}'.`),await i(n,s,a,l)}}finally{l.pop(),a.delete(c)}}};this.resolve=async function(e){const t=new Map,o=new Set;return await i(e,t,o,[]),t}}}class w{constructor(){this.instantiate=function(t,o,r){const n=function(e,t){if(null===e.exportName)return t;if(!(e.exportName in t))throw new Error(`Export '${e.exportName}' is not found in module namespace.`);return t[e.exportName]}(t,o);if(t.composition===e.AS_IS)return n;if(t.composition===e.FACTORY){if("function"!=typeof n)throw new Error("Factory composition requires a callable export.");const e=n;let t;if(function(e){try{return Reflect.construct(String,[],e),!0}catch{return!1}}(e)){t=new e(r)}else{t=e(r)}if(t instanceof Promise)throw new Error("Factory composition must return synchronously (non-Promise).");return t}throw new Error(`Unsupported composition mode: ${String(t.composition)}.`)}}}class y{constructor(o=null){const r=new Map,n=o;this.apply=function(o,i){if(o.composition!==e.FACTORY)return n&&n.log(`Lifecycle.apply: composition='${o.composition}' cache=skip.`),i();if(o.life===t.TRANSIENT)return n&&n.log("Lifecycle.apply: transient cache=skip."),i();if(o.life===t.SINGLETON){const e=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")}(o);if(r.has(e))return n&&n.log(`Lifecycle.cache: hit key='${e}'.`),r.get(e);n&&n.log(`Lifecycle.cache: miss key='${e}', create.`);const t=i();return r.set(e,t),n&&n.log(`Lifecycle.cache: stored key='${e}'.`),t}return n&&n.log("Lifecycle.apply: no lifecycle marker cache=skip."),i()}}}class ${constructor(){const e=function(e){return"function"==typeof e};this.execute=function(t,o,r){let n=o;const i=t.wrappers;for(const t of i){if(!(t in r))throw new Error(`Wrapper '${t}' is not found in module namespace.`);const o=r[t];if(!e(o))throw new Error(`Wrapper '${t}' must be callable.`);if(n=o(n),n instanceof Promise)throw new Error(`Wrapper '${t}' must return synchronously (non-Promise).`)}return n}}}class N{constructor(e="teqfw/di"){const t=`[${e}]`;this.log=function(e){console.debug(`${t} ${e}`)},this.error=function(e,o){console.error(`${t} ${e}`),o instanceof Error?console.error(o.stack??o.message):void 0!==o&&console.error(o)}}}const x=Object.freeze({log(){},error(){}});return class{constructor(){let e="notConfigured";const t=[],o=[],r=[],n=new Map,i=new WeakMap;let s=!1,a=!1,l=new p;const c=new m;let f,u,d,E=x;const C=new w,b=new $,v=function(e){const t=null===e.exportName?"":e.exportName,o=null===e.life?"":e.life,r=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,t,e.composition,o,r].join("::")},_=function(e){return v(e)},A=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;if("[object Module]"===Object.prototype.toString.call(e))return e;if(Object.isFrozen(e))return e;try{Object.freeze(e)}catch(e){E.log(`Container.freeze: skipped (${String(e)}).`)}return e},j=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;const o=e;if(i.has(o))return i.get(o);try{return Reflect.get(o,"then"),e}catch{const e=new Proxy(o,{get(e,t,o){if("then"!==t)return Reflect.get(e,t,o)}});return i.set(o,e),e}},I=function(){if("notConfigured"!==e)throw new Error("Container configuration is locked.")},R=function(e){a&&E.log(`Container.builder: ${e}`)};this.addPreprocess=function(e){I(),R("addPreprocess()."),t.push(e)},this.addPostprocess=function(e){I(),R("addPostprocess()."),o.push(e)},this.setParser=function(e){I(),l=e,"function"==typeof l.setLogger&&l.setLogger(a?E:null),R("setParser().")},this.addNamespaceRoot=function(e,t,o){I(),R(`addNamespaceRoot('${e}').`),r.push({prefix:e,target:t,defaultExt:o})},this.enableTestMode=function(){I(),R("enableTestMode()."),s=!0},this.enableLogging=function(){I(),a||(a=!0,E=new N,"function"==typeof l.setLogger&&l.setLogger(E),E.log("Container.builder: enableLogging()."))},this.register=function(e,t){if(I(),R(`register('${e}').`),!0!==s)throw new Error("Container test mode is disabled.");const o=l.parse(e);n.set(_(o),t)},this.get=async function(i){if("failed"===e)throw E.error(`Container.get: rejected in failed state cdc='${i}'.`),new Error("Container is in failed state.");let a="start";try{E.log(`Container.get: cdc='${i}'.`),function(){if("notConfigured"!==e)return;E.log("Container.transition: notConfigured -> operational."),e="operational";const t=c.create({namespaces:r});"function"==typeof l.setLogger&&l.setLogger(E),f=new g({config:t,logger:E}),u=new h({parser:l,resolver:f,logger:E}),d=new y(E)}(),E.log(`Container.state: '${e}'.`),a="parse",E.log("Container.pipeline: parse:entry.");const p=l.parse(i);E.log(`Container.pipeline: parse:exit '${p.platform}::${p.moduleName}'.`),a="preprocess",E.log("Container.pipeline: preprocess:entry.");const m=function(e){let o=e;for(const e of t)o=e(o);return o}(p);if(E.log(`Container.pipeline: preprocess:exit '${m.platform}::${m.moduleName}'.`),!0===s){a="mock",E.log("Container.pipeline: mock-lookup:entry.");const e=_(m);if(n.has(e)){E.log(`Container.pipeline: mock-lookup:hit '${e}'.`),a="freeze",E.log("Container.pipeline: freeze:entry.");const t=A(n.get(e));return E.log("Container.pipeline: freeze:exit."),E.log("Container.pipeline: return:success."),j(t)}E.log(`Container.pipeline: mock-lookup:miss '${e}'.`)}else E.log("Container.pipeline: mock-lookup:disabled.");a="resolve",E.log("Container.pipeline: resolve:entry.");const w=await u.resolve(m);E.log(`Container.pipeline: resolve:exit nodes=${w.size}.`);const $=new Map,N=function(e){if($.has(e))return $.get(e);if(!w.has(e))throw new Error(`Resolved graph node is missing for '${e}'.`);const t=w.get(e);a="lifecycle",E.log(`Container.pipeline: lifecycle:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const r=d.apply(t.depId,function(){a="instantiate",E.log(`Container.pipeline: instantiate:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const e={},r=function(e,t){const o=Reflect.get(e,"__deps__");if(void 0===o)return{};if(null!==o&&"object"==typeof o&&!Array.isArray(o)){const e=null===t.exportName?"default":t.exportName,r=Reflect.get(o,e);if(null!=r&&"object"==typeof r&&!Array.isArray(r))return r}return o}(t.namespace,t.depId);for(const[t,o]of Object.entries(r)){const r=o,n=l.parse(r);e[t]=N(v(n))}const n=C.instantiate(t.depId,t.namespace,e);E.log(`Container.pipeline: instantiate:exit '${t.depId.platform}::${t.depId.moduleName}'.`),a="postprocess",E.log(`Container.pipeline: postprocess:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const i=function(e){let t=e;for(const e of o)t=e(t);return t}(n);E.log(`Container.pipeline: postprocess:exit '${t.depId.platform}::${t.depId.moduleName}'.`);const s=b.execute(t.depId,i,t.namespace);a="freeze",E.log(`Container.pipeline: freeze:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const c=A(s);return E.log(`Container.pipeline: freeze:exit '${t.depId.platform}::${t.depId.moduleName}'.`),c});return E.log(`Container.pipeline: lifecycle:exit '${t.depId.platform}::${t.depId.moduleName}'.`),$.set(e,r),r},x=N(v(m));return E.log("Container.pipeline: return:success."),j(x)}catch(t){throw E.error(`Container.pipeline: failed at stage='${a}'.`,t),E.log("Container.transition: operational -> failed."),e="failed",t}}}}});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).TeqFw_Di_Container=t()}(this,function(){"use strict";var e=Object.freeze({AS_IS:"A",FACTORY:"F"});var t=Object.freeze({SINGLETON:"S",TRANSIENT:"T"});var r=Object.freeze({TEQ:"teq",NODE:"node",NPM:"npm"});const o=r.TEQ,n=e.AS_IS,i=new Set(Object.values(r)),s=new Set(Object.values(e)),a=new Set(Object.values(t));let l=class{moduleName;platform;exportName;composition;life;wrappers;origin},c=class{create(e){const t=e&&"object"==typeof e?e:{},r=new l;r.moduleName="string"==typeof t.moduleName?t.moduleName:"";const c="string"==typeof t.platform?t.platform:void 0;r.platform=c&&i.has(c)?c:o;let p=null;null===t.exportName?p=null:"string"==typeof t.exportName&&(p=t.exportName),r.exportName=p;const f="string"==typeof t.composition?t.composition:void 0;r.composition=f&&s.has(f)?f:n;const u="string"==typeof t.life?t.life:void 0;return r.life=u&&a.has(u)?u:null,r.wrappers=Array.isArray(t.wrappers)?t.wrappers.filter(e=>"string"==typeof e):[],r.origin="string"==typeof t.origin?t.origin:"",Object.freeze(r.wrappers),Object.freeze(r)}};class p{constructor(){const o=new c;let n=null;this.parse=function(i){if(n&&n.log(`Parser.parse: input='${i}'.`),"string"!=typeof i)throw new Error("CDC must be a string.");if(0===i.length)throw new Error("CDC must be non-empty.");if(!/^[\x00-\x7F]+$/.test(i))throw new Error("CDC must be ASCII.");const s=i;let a=i,l=r.TEQ;if(a.startsWith("node:"))l=r.NODE,a=a.slice(5);else if(a.startsWith("npm:"))l=r.NPM,a=a.slice(4);else if(a.startsWith("teq:"))throw new Error("Explicit teq: prefix is forbidden.");if(0===a.length)throw new Error("moduleName must be non-empty.");let c=null,p=!1,f=[],u=a;const d=u.match(/(\${1,3})(?:_[a-z][0-9A-Za-z]*)*$/);if(d){const e=d[1],r=d[0].slice(e.length);if(p=!0,"$"===e)c=t.SINGLETON;else if("$$"===e)c=t.TRANSIENT;else{if("$$$"!==e)throw new Error("Lifecycle marker is invalid.");c=null}u=u.slice(0,d.index),r.length>0&&(f=r.slice(1).split("_"))}else{if(a.includes("$"))throw new Error("Invalid lifecycle encoding.");if(l!==r.NODE&&/(?:^|[^_])_[a-z][0-9A-Za-z]*$/.test(a))throw new Error("Wrapper without lifecycle is forbidden.")}const m=u.indexOf("__"),g=u.lastIndexOf("__");if(-1!==m&&m!==g)throw new Error("Export delimiter must appear at most once.");if(u.startsWith("__")||u.endsWith("__"))throw new Error("Malformed export segment.");let w=u,h=null;if(-1!==m){if(w=u.slice(0,m),h=u.slice(m+2),!h)throw new Error("Export must be non-empty.");if(h.includes("_"))throw new Error("Export must not contain _.");if(h.includes("$"))throw new Error("Export must not contain $.")}if(!w)throw new Error("moduleName must be non-empty.");if(w.startsWith("_")||w.startsWith("$"))throw new Error("moduleName must not start with _ or $.");if(w.includes("__"))throw new Error("moduleName must not contain __.");if(w.includes("$"))throw new Error("moduleName must not contain $.");if(l!==r.NPM){if(l===r.NODE){if(!/^[A-Za-z_][$0-9A-Za-z_/-]*$/.test(w))throw new Error("node moduleName must satisfy the built-in specifier form.")}else if(!/^[A-Za-z_][$0-9A-Za-z_]*$/.test(w))throw new Error("moduleName must satisfy the canonical identifier form.")}else if(!/^[@A-Za-z_][$0-9A-Za-z_./-]*$/.test(w))throw new Error("npm moduleName must satisfy the package specifier form.");let y=e.AS_IS;null!==h?y=e.FACTORY:p&&(y=e.FACTORY,h="default");const $=o.create({moduleName:w,platform:l,exportName:h,composition:y,life:c,wrappers:f,origin:s});return n&&n.log(`Parser.parse: produced='${$.platform}::${$.moduleName}'.`),$},this.setLogger=function(e){n=e}}}let f=class{prefix;target;defaultExt},u=class{create(e){const t=e&&"object"==typeof e?e:{},r=new f;return r.prefix="string"==typeof t.prefix?t.prefix:void 0,r.target="string"==typeof t.target?t.target:void 0,r.defaultExt="string"==typeof t.defaultExt?t.defaultExt:void 0,Object.freeze(r)}};class d{namespaces;nodeModulesRoot}class m{constructor(){const e=new u;this.create=function(t){const r=t&&"object"==typeof t?t:{},o=new d,n=Array.isArray(r.namespaces)?r.namespaces:[];return o.namespaces=n.map(t=>e.create(t)),o.nodeModulesRoot="string"==typeof r.nodeModulesRoot?r.nodeModulesRoot:void 0,Object.freeze(o.namespaces),Object.freeze(o)}}}class g{constructor({config:e,importFn:t=e=>import(e),logger:r=null}){const o=new Map,n=e;let i;const s=t,a=r,l=function(e,t){if("node"===e){const e=`node:${t}`;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("npm"===e){const e=t;return a&&a.log(`Resolver.specifier: module='${t}' -> '${e}'.`),e}if("teq"!==e)throw new Error(`Unsupported platform: ${e}`);const r=function(e){let t=null,r=-1;const o=i.namespaces;for(const n of o){const o=e.startsWith(n.prefix);a&&a.log(`Resolver.namespace: prefix='${n.prefix}' match=${String(o)} module='${e}'.`),o&&n.prefix.length>r&&(t=n,r=n.prefix.length)}if(!t)throw new Error(`Namespace rule is not found for '${e}'.`);return t}(t),o=t.slice(r.prefix.length).split("_").join("/"),n=(s=o,(l=r.defaultExt)?s.endsWith(l)?s:`${s}${l}`:s);var s,l;const c=function(e,t){return e?e.endsWith("/")?`${e}${t}`:`${e}/${t}`:t}(r.target,n);return a&&a.log(`Resolver.specifier: module='${t}' -> '${c}'.`),c};this.resolve=async function(e){var t;await Promise.resolve(),i||(i={nodeModulesRoot:(t=n).nodeModulesRoot,namespaces:t.namespaces.map(e=>({prefix:e.prefix,target:e.target,defaultExt:e.defaultExt}))});const r=e.platform,c=e.moduleName,p=`${r}::${c}`;if(o.has(p))return a&&a.log(`Resolver.cache: hit key='${p}'.`),o.get(p);a&&a.log(`Resolver.cache: miss key='${p}'.`);const f=(async()=>{const e=l(r,c);return a&&a.log(`Resolver.import: '${e}'.`),s(e)})();o.set(p,f);try{return await f}catch(e){throw o.delete(p),a&&a.error(`Resolver.cache: evict key='${p}' after failure.`,e),e}}}}class w{constructor({parser:e,resolver:t,logger:r=null}){const o=r,n=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")},i=async function(r,s,a,l){const c=n(r);if(a.has(c)){const e=[...l,c].join(" -> ");throw new Error(`Cyclic dependency detected: ${e}`)}const p=n(r);if(!s.has(p)){a.add(c),l.push(c);try{const n=await t.resolve(r);o&&o.log(`GraphResolver.walk: resolved '${p}'.`),s.set(p,{depId:r,namespace:n});const c=Reflect.get(n,"__deps__");if(void 0===c)return;let f={};if(null===c||"object"!=typeof c||Array.isArray(c))throw new Error("__deps__ must be a plain object.");const u=null===r.exportName?"default":r.exportName,d=Reflect.get(c,u);if(null==d||"object"!=typeof d||Array.isArray(d)){if("default"===u){const e=Object.values(c);if(e.every(e=>"string"==typeof e))f=c;else if(!e.every(e=>null!==e&&"object"==typeof e&&!Array.isArray(e)))throw new Error("__deps__ must be either flat or export-scoped.")}}else{if(!Object.values(d).every(e=>"string"==typeof e))throw new Error("__deps__ export entries must map dependency names to CDC strings.");f=d}for(const[,t]of Object.entries(f)){const r=t,n=e.parse(r);o&&o.log(`GraphResolver.walk: edge '${p}' -> '${n.platform}::${n.moduleName}'.`),await i(n,s,a,l)}}finally{l.pop(),a.delete(c)}}};this.resolve=async function(e){const t=new Map,r=new Set;return await i(e,t,r,[]),t}}}class h{constructor(){this.instantiate=function(t,r,o){const n=function(e,t){if(null===e.exportName)return t;if(!(e.exportName in t))throw new Error(`Export '${e.exportName}' is not found in module namespace.`);return t[e.exportName]}(t,r);if(t.composition===e.AS_IS)return n;if(t.composition===e.FACTORY){if("function"!=typeof n)throw new Error("Factory composition requires a callable export.");const e=n;let t;if(function(e){try{return Reflect.construct(String,[],e),!0}catch{return!1}}(e)){t=new e(o)}else{t=e(o)}if(t instanceof Promise)throw new Error("Factory composition must return synchronously (non-Promise).");return t}throw new Error(`Unsupported composition mode: ${String(t.composition)}.`)}}}class y{constructor(r=null){const o=new Map,n=r;this.apply=function(r,i){if(r.composition!==e.FACTORY)return n&&n.log(`Lifecycle.apply: composition='${r.composition}' cache=skip.`),i();if(r.life===t.TRANSIENT)return n&&n.log("Lifecycle.apply: transient cache=skip."),i();if(r.life===t.SINGLETON){const e=function(e){const t=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,null===e.exportName?"":e.exportName,e.composition,null===e.life?"":e.life,t].join("::")}(r);if(o.has(e))return n&&n.log(`Lifecycle.cache: hit key='${e}'.`),o.get(e);n&&n.log(`Lifecycle.cache: miss key='${e}', create.`);const t=i();return o.set(e,t),n&&n.log(`Lifecycle.cache: stored key='${e}'.`),t}return n&&n.log("Lifecycle.apply: no lifecycle marker cache=skip."),i()}}}class ${constructor(){const e=function(e){return"function"==typeof e};this.execute=function(t,r,o){let n=r;const i=t.wrappers;for(const t of i){if(!(t in o))throw new Error(`Wrapper '${t}' is not found in module namespace.`);const r=o[t];if(!e(r))throw new Error(`Wrapper '${t}' must be callable.`);if(n=r(n),n instanceof Promise)throw new Error(`Wrapper '${t}' must return synchronously (non-Promise).`)}return n}}}class x{constructor(e="teqfw/di"){const t=`[${e}]`;this.log=function(e){console.debug(`${t} ${e}`)},this.error=function(e,r){console.error(`${t} ${e}`),r instanceof Error?console.error(r.stack??r.message):void 0!==r&&console.error(r)}}}const N=Object.freeze({log(){},error(){}});return class{constructor(){let e="notConfigured";const t=[],r=[],o=[],n=new Map,i=new WeakMap;let s=!1,a=!1,l=new p;const c=new m;let f,u,d,E=N;const _=new h,b=new $,C=function(e){const t=null===e.exportName?"":e.exportName,r=null===e.life?"":e.life,o=Array.isArray(e.wrappers)?e.wrappers.join("|"):"";return[e.platform,e.moduleName,t,e.composition,r,o].join("::")},v=function(e){return C(e)},j=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;if("[object Module]"===Object.prototype.toString.call(e))return e;if(Object.isFrozen(e))return e;try{Object.freeze(e)}catch(e){E.log(`Container.freeze: skipped (${String(e)}).`)}return e},A=function(e){if(null==e)return e;const t=typeof e;if("object"!==t&&"function"!==t)return e;const r=e;if(i.has(r))return i.get(r);try{return Reflect.get(r,"then"),e}catch{const e=new Proxy(r,{get(e,t,r){if("then"!==t)return Reflect.get(e,t,r)}});return i.set(r,e),e}},I=function(){if("notConfigured"!==e)throw new Error("Container configuration is locked.")},O=function(e){a&&E.log(`Container.builder: ${e}`)};this.addPreprocess=function(e){I(),O("addPreprocess()."),t.push(e)},this.addPostprocess=function(e){I(),O("addPostprocess()."),r.push(e)},this.setParser=function(e){I(),l=e,"function"==typeof l.setLogger&&l.setLogger(a?E:null),O("setParser().")},this.addNamespaceRoot=function(e,t,r){I(),O(`addNamespaceRoot('${e}').`),o.push({prefix:e,target:t,defaultExt:r})},this.enableTestMode=function(){I(),O("enableTestMode()."),s=!0},this.enableLogging=function(){I(),a||(a=!0,E=new x,"function"==typeof l.setLogger&&l.setLogger(E),E.log("Container.builder: enableLogging()."))},this.register=function(e,t){if(I(),O(`register('${e}').`),!0!==s)throw new Error("Container test mode is disabled.");const r=l.parse(e);n.set(v(r),t)},this.get=async function(i){if("failed"===e)throw E.error(`Container.get: rejected in failed state cdc='${i}'.`),new Error("Container is in failed state.");let a="start";try{E.log(`Container.get: cdc='${i}'.`),function(){if("notConfigured"!==e)return;E.log("Container.transition: notConfigured -> operational."),e="operational";const t=c.create({namespaces:o});"function"==typeof l.setLogger&&l.setLogger(E),f=new g({config:t,logger:E}),u=new w({parser:l,resolver:f,logger:E}),d=new y(E)}(),E.log(`Container.state: '${e}'.`),a="parse",E.log("Container.pipeline: parse:entry.");const p=l.parse(i);E.log(`Container.pipeline: parse:exit '${p.platform}::${p.moduleName}'.`),a="preprocess",E.log("Container.pipeline: preprocess:entry.");const m=function(e){let r=e;for(const e of t)r=e(r);return r}(p);if(E.log(`Container.pipeline: preprocess:exit '${m.platform}::${m.moduleName}'.`),!0===s){a="mock",E.log("Container.pipeline: mock-lookup:entry.");const e=v(m);if(n.has(e)){E.log(`Container.pipeline: mock-lookup:hit '${e}'.`),a="freeze",E.log("Container.pipeline: freeze:entry.");const t=j(n.get(e));return E.log("Container.pipeline: freeze:exit."),E.log("Container.pipeline: return:success."),A(t)}E.log(`Container.pipeline: mock-lookup:miss '${e}'.`)}else E.log("Container.pipeline: mock-lookup:disabled.");a="resolve",E.log("Container.pipeline: resolve:entry.");const h=await u.resolve(m);E.log(`Container.pipeline: resolve:exit nodes=${h.size}.`);const $=new Map,x=function(e){if($.has(e))return $.get(e);if(!h.has(e))throw new Error(`Resolved graph node is missing for '${e}'.`);const t=h.get(e);a="lifecycle",E.log(`Container.pipeline: lifecycle:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const o=d.apply(t.depId,function(){a="instantiate",E.log(`Container.pipeline: instantiate:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const e={},o=function(e,t){const r=Reflect.get(e,"__deps__");if(void 0===r)return{};if(null===r||"object"!=typeof r||Array.isArray(r))throw new Error("__deps__ must be a plain object.");const o=null===t.exportName?"default":t.exportName,n=Reflect.get(r,o);if(null!=n&&"object"==typeof n&&!Array.isArray(n)){if(!Object.values(n).every(e=>"string"==typeof e))throw new Error("__deps__ export entries must map dependency names to CDC strings.");return n}if("default"===o){const e=Object.values(r);if(e.every(e=>"string"==typeof e))return r;if(e.every(e=>null!==e&&"object"==typeof e&&!Array.isArray(e)))return{};throw new Error("__deps__ must be either flat or export-scoped.")}return{}}(t.namespace,t.depId);for(const[t,r]of Object.entries(o)){const o=r,n=l.parse(o);e[t]=x(C(n))}const n=_.instantiate(t.depId,t.namespace,e);E.log(`Container.pipeline: instantiate:exit '${t.depId.platform}::${t.depId.moduleName}'.`),a="postprocess",E.log(`Container.pipeline: postprocess:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const i=function(e){let t=e;for(const e of r)t=e(t);return t}(n);E.log(`Container.pipeline: postprocess:exit '${t.depId.platform}::${t.depId.moduleName}'.`);const s=b.execute(t.depId,i,t.namespace);a="freeze",E.log(`Container.pipeline: freeze:entry '${t.depId.platform}::${t.depId.moduleName}'.`);const c=j(s);return E.log(`Container.pipeline: freeze:exit '${t.depId.platform}::${t.depId.moduleName}'.`),c});return E.log(`Container.pipeline: lifecycle:exit '${t.depId.platform}::${t.depId.moduleName}'.`),$.set(e,o),o},N=x(C(m));return E.log("Container.pipeline: return:success."),A(N)}catch(t){throw E.error(`Container.pipeline: failed at stage='${a}'.`,t),E.log("Container.transition: operational -> failed."),e="failed",t}}}}});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teqfw/di",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Dependency Injection container for ES6 modules that works in both browser and Node.js apps.",
   "keywords": [
     "dependency injection",

package/src/Container/Resolve/GraphResolver.mjs

@@ -81,12 +81,24 @@ export default class TeqFw_Di_Container_Resolve_GraphResolver {
                 const depsDecl = Reflect.get(namespace, '__deps__');
                 if (depsDecl === undefined) return;
                 /** @type {Record<string, unknown>} */
-                let depsMap = /** @type {Record<string, unknown>} */ (depsDecl);
-                if ((depsDecl !== null) && (typeof depsDecl === 'object') && !Array.isArray(depsDecl)) {
-                    const exportName = depId.exportName === null ? 'default' : depId.exportName;
-                    const exportScoped = Reflect.get(/** @type {object} */ (depsDecl), exportName);
-                    if ((exportScoped !== undefined) && (exportScoped !== null) && (typeof exportScoped === 'object') && !Array.isArray(exportScoped)) {
-                        depsMap = /** @type {Record<string, unknown>} */ (exportScoped);
+                let depsMap = {};
+                if ((depsDecl === null) || (typeof depsDecl !== 'object') || Array.isArray(depsDecl)) {
+                    throw new Error('__deps__ must be a plain object.');
+                }
+                const exportName = depId.exportName === null ? 'default' : depId.exportName;
+                const exportScoped = Reflect.get(/** @type {object} */ (depsDecl), exportName);
+                if ((exportScoped !== undefined) && (exportScoped !== null) && (typeof exportScoped === 'object') && !Array.isArray(exportScoped)) {
+                    const values = Object.values(/** @type {Record<string, unknown>} */ (exportScoped));
+                    if (!values.every((value) => typeof value === 'string')) {
+                        throw new Error('__deps__ export entries must map dependency names to CDC strings.');
+                    }
+                    depsMap = /** @type {Record<string, unknown>} */ (exportScoped);
+                } else if (exportName === 'default') {
+                    const values = Object.values(/** @type {Record<string, unknown>} */ (depsDecl));
+                    if (values.every((value) => typeof value === 'string')) {
+                        depsMap = /** @type {Record<string, unknown>} */ (depsDecl);
+                    } else if (!values.every((value) => (value !== null) && (typeof value === 'object') && !Array.isArray(value))) {
+                        throw new Error('__deps__ must be either flat or export-scoped.');
                     }
                 }
                 for (const [, cdc] of Object.entries(depsMap)) {

package/src/Container.mjs

@@ -179,14 +179,29 @@ export default class TeqFw_Di_Container {
             /** @type {unknown} */
             const deps = Reflect.get(namespace, '__deps__');
             if (deps === undefined) return {};
-            if ((deps !== null) && (typeof deps === 'object') && !Array.isArray(deps)) {
-                const exportName = depId.exportName === null ? 'default' : depId.exportName;
-                const exportScoped = Reflect.get(/** @type {object} */ (deps), exportName);
-                if ((exportScoped !== undefined) && (exportScoped !== null) && (typeof exportScoped === 'object') && !Array.isArray(exportScoped)) {
-                    return /** @type {Record<string, unknown>} */ (exportScoped);
+            if ((deps === null) || (typeof deps !== 'object') || Array.isArray(deps)) {
+                throw new Error('__deps__ must be a plain object.');
+            }
+            const exportName = depId.exportName === null ? 'default' : depId.exportName;
+            const exportScoped = Reflect.get(/** @type {object} */ (deps), exportName);
+            if ((exportScoped !== undefined) && (exportScoped !== null) && (typeof exportScoped === 'object') && !Array.isArray(exportScoped)) {
+                const values = Object.values(/** @type {Record<string, unknown>} */ (exportScoped));
+                if (!values.every((value) => typeof value === 'string')) {
+                    throw new Error('__deps__ export entries must map dependency names to CDC strings.');
+                }
+                return /** @type {Record<string, unknown>} */ (exportScoped);
+            }
+            if (exportName === 'default') {
+                const values = Object.values(/** @type {Record<string, unknown>} */ (deps));
+                if (values.every((value) => typeof value === 'string')) {
+                    return /** @type {Record<string, unknown>} */ (deps);
+                }
+                if (values.every((value) => (value !== null) && (typeof value === 'object') && !Array.isArray(value))) {
+                    return {};
                 }
+                throw new Error('__deps__ must be either flat or export-scoped.');
             }
-            return /** @type {Record<string, unknown>} */ (deps);
+            return {};
         };
 
         /**