@teqfw/di 0.35.0 → 1.0.0

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,48 @@
+name: npm publication
+
+on:
+  workflow_dispatch:
+  release:
+    types: [ created ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      # Checkout repository code
+      - uses: actions/checkout@v4
+
+      # Setup Node.js environment
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      # Install dependencies using package-lock.json
+      - run: npm ci
+
+      # Run unit tests
+      - run: npm run test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      # Checkout repository code again for a separate job
+      - uses: actions/checkout@v4
+
+      # Setup Node.js and configure npm registry
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+
+      # Install dependencies again
+      - run: npm ci
+
+      # Build a code for browsers
+      - run: npm run rollup
+
+      # Publish package to npm registry with authentication token
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.npm_token }}

package/AGENTS.md

@@ -0,0 +1,6 @@
+# AGENTS
+
+- Write all code comments, documentation, commit messages, and changelog entries in English.
+- Record every project change in `CHANGELOG.md` under a new version `X.Y.Z` (the exact number is assigned at release).
+- For the platform philosophy behind this library, see [PHILOSOPHY.md](./PHILOSOPHY.md).
+

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 1.0.0
+- Started changelog for version 1.0.0.
+- Added AGENTS.md with English-only guidelines and link to PHILOSOPHY.md.
+- Switched tests from Mocha to Node's built-in runner.
+- Updated package scripts and removed Mocha dependency.
+- Documented breaking changes for v1.0.0: the container can no longer access itself, configuration must occur in the Composition Root, and legacy versions live in the `forerunner` branch.
+

package/README.md

@@ -3,6 +3,11 @@
 ![npms.io](https://img.shields.io/npm/dm/@teqfw/di)
 ![jsdelivr](https://img.shields.io/jsdelivr/npm/hm/@teqfw/di)
 
+> [!IMPORTANT]
+> **Breaking Changes in v1.0.0**
+>
+> The library has been stable for a long time and is now promoted to its first major version. To improve security, the Object Container can no longer access itself, so all configuration must occur in the Composition Root. This restriction ensures that third-party plugins cannot override or modify the container's internal functionality. Legacy versions are maintained in the `forerunner` branch, and packages like `@teqfw/core` should depend on `@teqfw/di` versions below `1.0.0`.
+
 `@teqfw/di` is a lightweight dependency injection container for standard JavaScript, enabling late binding of code
 objects with minimal manual configuration. It integrates smoothly in both browser and Node.js environments, supporting
 flexibility, modularity, and easier testing for your applications.
@@ -124,7 +129,7 @@ const app = await container.get('App_Main$');
 
 ## Test Mode Support
 
-`@teqfw/di` supports a dedicated **test mode** to help with unit testing and dependency mocking.
+`@teqfw/di` supports a dedicated **test mode** to facilitate unit testing and dependency mocking.
 
 When test mode is enabled via `container.enableTestMode()`, you can manually register singleton dependencies using the
 `register(depId, obj)` method:
@@ -134,9 +139,31 @@ container.enableTestMode();
 container.register('App_Service_Customer$', mockCustomerService);
 ```
 
-This makes it easy to substitute real implementations with mocks or stubs during tests, without affecting production
-logic. Test mode safeguards this capability, ensuring that manual overrides are only permitted in designated test
-environments.
+This makes it easy to substitute real implementations with mocks or stubs during tests, without altering production
+logic. Overrides are allowed only in test mode, ensuring clean separation of concerns.
+
+### Mocking Node.js Built-in Modules
+
+A powerful feature of `@teqfw/di` is the ability to mock **Node.js built-in libraries** such as `fs`, `path`, or
+`process`. This is useful for isolating side effects and simulating system behavior:
+
+```js
+container.register('node:fs', {
+    existsSync: (path) => path.endsWith('.html'),
+});
+```
+
+You can also register mocks for custom logic or environment-specific behavior:
+
+```js
+container.register('node:path', {
+    join: (...args) => args.join('/'),
+    resolve: (p) => `/abs/${p}`,
+});
+```
+
+These mocks are injected transparently wherever such modules are used as dependencies, making it possible to write pure,
+isolated, and deterministic unit tests — even for logic that relies on the filesystem or path resolution.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teqfw/di",
-  "version": "0.35.0",
+  "version": "1.0.0",
   "description": "Dependency Injection container for ES6 modules that works in both browser and Node.js apps.",
   "keywords": [
     "dependency injection",
@@ -29,18 +29,20 @@
   "scripts": {
     "rollup": "rollup -c",
     "eslint": "eslint './src/**/*.js'",
-    "test": "mocha --recursive './test/**/*.test.mjs'"
+    "test": "node --test"
   },
   "devDependencies": {
-    "@eslint/js": "^9.25.0",
+    "@eslint/js": "^9.33.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-terser": "^0.4.4",
-    "eslint": "^9.25.0",
-    "mocha": "^11.1.0",
-    "rollup": "^4.36.0"
+    "eslint": "^9.33.0",
+    "rollup": "^4.47.1"
   },
-  "mocha": {
-    "spec": "./test/**/*.test.mjs",
-    "timeout": 5000
+  "engines": {
+    "node": ">=20"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://github.com/sponsors/teqfw"
   }
 }

package/src/Container.js

@@ -76,11 +76,6 @@ export default class TeqFw_Di_Container {
 
         this.get = async function (depId, stack = []) {
             log(`Object '${depId}' is requested.`);
-            // return the container itself if requested
-            if ((depId === Defs.ID) || (depId === Defs.ID_FQN)) {
-                log('Container itself is returned.');
-                return _regSingles[Defs.ID];
-            }
             // parse the `objectKey` and get the structured DTO
             const parsed = _parser.parse(depId);
             // modify the original key according to some rules (replacements, etc.)
@@ -188,8 +183,5 @@ export default class TeqFw_Di_Container {
         this.setPostProcessor = (data) => _postProcessor = data;
 
         this.setResolver = (data) => _resolver = data;
-
-        // MAIN
-        _regSingles[Defs.ID] = this;
     }
 };

package/src/Defs.js

@@ -5,9 +5,6 @@
 export default {
     CA: 'A', // composition: as-is
     CF: 'F', // composition: factory
-    // TODO: we don't need an access to the container itself.
-    ID: 'container', // default ID for container itself
-    ID_FQN: 'TeqFw_Di_Container$', // default Full Qualified Name for container itself
     LI: 'I', // lifestyle: instance
     LS: 'S', // lifestyle: singleton
 

package/src/Pre/Replace.js

@@ -0,0 +1,80 @@
+/**
+ * Pre-processor chunk that replaces module addresses during dependency resolution.
+ *
+ * This chunk allows dynamically overriding the module namespace used to resolve source code
+ * for a given dependency ID. Only the `moduleName` field of the `depId` is modified.
+ * All other metadata (such as lifestyle, export type, etc.) remains unchanged.
+ *
+ * This mechanism enables redirecting from one module implementation to another
+ * without changing aliases or component registration.
+ *
+ * Example:
+ *     Replace module path 'Fl32_Cms_Back_Api_Adapter' with 'App_Cms_Adapter_Custom',
+ *     while keeping the lifestyle and export configuration intact.
+ *
+ * @implements {TeqFw_Di_Api_Container_PreProcessor_Chunk}
+ */
+export default class TeqFw_Di_Pre_Replace {
+
+    constructor() {
+        // VARS
+
+        /**
+         * Mapping of source module namespaces to their replacements.
+         * Keys and values are strings without export/lifestyle suffixes.
+         *
+         * Example:
+         * {
+         *   'Fl32_Cms_Back_Api_Adapter': 'App_Cms_Adapter_Custom'
+         * }
+         *
+         * This means: when resolving a module with `moduleName === 'Fl32_Cms_Back_Api_Adapter'`,
+         * use source code from `'App_Cms_Adapter_Custom'` instead.
+         *
+         * @type {Object<string, string>}
+         */
+        const map = {};
+
+        // INSTANCE METHODS
+
+        /**
+         * Register a single module address replacement.
+         *
+         * @param {string} orig - Original module namespace (e.g. 'X_Y_Z')
+         * @param {string} alter - Replacement module namespace (e.g. 'A_B_C')
+         */
+        this.add = function (orig, alter) {
+            map[orig] = alter;
+        };
+
+        /* eslint-disable no-unused-vars */
+        /**
+         * Replace the `moduleName` of the dependency ID if a mapping exists.
+         *
+         * This function does not alter any other part of the `depId` (e.g. lifestyle, export kind).
+         *
+         * @param {TeqFw_Di_DepId} depId - Dependency ID after previous transformations.
+         * @param {TeqFw_Di_DepId} originalId - Original dependency ID before any processing.
+         * @param {string[]} stack - Stack of parent dependency IDs (for trace/debug).
+         * @returns {TeqFw_Di_DepId} - Transformed `depId` with updated `moduleName` if replaced.
+         */
+        this.modify = function (depId, originalId, stack) {
+            let module = depId.moduleName;
+            const seen = new Set();
+
+            while (map[module] && !seen.has(module)) {
+                seen.add(module);
+                module = map[module];
+            }
+
+            if (module !== depId.moduleName) {
+                return {
+                    ...depId,
+                    moduleName: module,
+                };
+            }
+
+            return depId;
+        };
+    }
+}

package/teqfw.json

@@ -1,9 +1,8 @@
 {
   "@teqfw/di": {
     "autoload": {
-      "ns": "TeqFw_Di",
-      "path": "./src",
-      "ext": "js"
+      "ns": "TeqFw_Di_",
+      "path": "./src"
     }
   }
 }

package/test/Container/A/Composer/A/SpecParser.test.mjs

@@ -0,0 +1,98 @@
+import parse from '../../../../../src/Container/A/Composer/A/SpecParser.js';
+import {describe, it} from 'node:test';
+import assert from 'node:assert';
+
+
+describe('TeqFw_Di_Container_A_Composer_A_SpecParser', () => {
+
+    it('parses not a function', async () => {
+        const deps = parse('namedSingleton');
+        assert(deps, []);
+    });
+
+    describe('parses an arrow function', () => {
+        it('w/o arguments', async () => {
+            const fn = () => {};
+            const deps = parse(fn);
+            assert(deps, []);
+        });
+        it('with simple arguments', async () => {
+            const fn = ({container, logger, config}) => {};
+            const deps = parse(fn);
+            assert(deps, []);
+        });
+        it('with complex arguments', async () => {
+            const fn = (
+                {
+                    Vnd_Pkg_Mod1,
+                    Vnd_Pkg_Mod2$,
+                    Vnd_Pkg_Mod3$$,
+                    'Vnd_Pkg_Mod4.exp': exp,
+                }
+            ) => {};
+            const deps = parse(fn);
+            assert(deps.length, 4);
+        });
+    });
+
+    describe('parses a regular function', () => {
+        it('w/o arguments', async () => {
+            const fn = function () {};
+            const deps = parse(fn);
+            assert(deps, []);
+        });
+        it('with simple arguments', async () => {
+            const fn = function ({container, logger, config}) {};
+            const deps = parse(fn);
+            assert(deps, []);
+        });
+        it('with complex arguments', async () => {
+            const fn = function (
+                {
+                    Vnd_Pkg_Mod1,
+                    Vnd_Pkg_Mod2$,
+                    Vnd_Pkg_Mod3$$,
+                    'Vnd_Pkg_Mod4.exp': exp,
+                }
+            ) {};
+            const deps = parse(fn);
+            assert(deps.length, 4);
+        });
+    });
+
+    describe('parses a class', () => {
+        it('w/o arguments', async () => {
+            const Clazz = class {
+                constructor() { }
+
+            };
+            const deps = parse(Clazz);
+            assert(deps, []);
+        });
+        it('with simple arguments', async () => {
+            const Clazz = class {
+                constructor({container, logger, config}) { }
+
+            };
+            const deps = parse(Clazz);
+            assert(deps, []);
+        });
+        it('with complex arguments', async () => {
+            const Clazz = class {
+                constructor(
+                    {
+                        Vnd_Pkg_Mod1,
+                        Vnd_Pkg_Mod2$,
+                        Vnd_Pkg_Mod3$$,
+                        'Vnd_Pkg_Mod4.exp': exp,
+                    }
+                ) { }
+
+            };
+            const deps = parse(Clazz);
+            assert(deps.length, 4);
+        });
+    });
+
+
+});

package/test/Container/A/Parser/Chunk/Def.test.mjs

@@ -0,0 +1,237 @@
+/**
+ * Default format for the objects:
+ *  - Ns_Module: es6 module
+ *  - Ns_Module$: default export, factory, singleton (the most frequently used case)
+ *  - Ns_Module$$: default export, factory, instance
+ *  - Ns_Module.default: default export, as-is, singleton
+ *  - Ns_Module.name: named export, as-is, singleton
+ *  - Ns_Module.name$: named export, factory, singleton (the most frequently used case)
+ *  - Ns_Module.name$$: named export, factory, instance
+ *  - Ns_Module$(proxy): default export, factory, singleton with one post wrapper
+ *  - Ns_Module$(proxy,factory): default export, factory, singleton with two post wrappers
+ */
+import DefChunk from '../../../../../src/Container/A/Parser/Chunk/Def.js';
+import {describe, it} from 'node:test';
+import assert from 'node:assert';
+import Defs from '../../../../../src/Defs.js';
+
+describe('TeqFw_Di_Container_A_Parser_Chunk_Def', () => {
+
+    const chunk = new DefChunk();
+
+    describe('should parse:', () => {
+
+        describe('default export:', () => {
+            it('es6 module (Ns_Module)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module');
+                assert.strictEqual(dto.composition, undefined);
+                assert.strictEqual(dto.exportName, undefined);
+                assert.strictEqual(dto.life, undefined);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton (Ns_Module$)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, instance (Ns_Module$$)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module$$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module$$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('default export, as-is, singleton (Ns_Module.)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.');
+                assert.strictEqual(dto.composition, Defs.CA);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton, wrapper (Ns_Module$(proxy))', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module$(proxy)');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module$(proxy)');
+                assert.strictEqual(dto.wrappers.length, 1);
+            });
+            it('factory, singleton, wrappers (Ns_Module$(proxy,factory))', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module$(proxy,factory)');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module$(proxy,factory)');
+                assert.strictEqual(dto.wrappers.length, 2);
+            });
+        });
+
+        describe('named export:', () => {
+            it('as-is, singleton (Ns_Module.name)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name');
+                assert.strictEqual(dto.composition, Defs.CA);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton (Ns_Module.name$)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, instance (Ns_Module.name$$)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name$$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name$$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton.wrapper (Ns_Module.name$(proxy))', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name$(proxy)');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name$(proxy)');
+                assert.strictEqual(dto.wrappers.length, 1);
+            });
+            it('factory, singleton.wrappers (Ns_Module.name$(proxy,factory))', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name$(proxy,factory)');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name$(proxy,factory)');
+                assert.strictEqual(dto.wrappers.length, 2);
+            });
+        });
+
+        describe('named export with "#" separator:', () => {
+            it('as-is, singleton (Ns_Module#name)', () => {
+                const dto = chunk.parse('Ns_Module#name');
+                assert.strictEqual(dto.composition, Defs.CA);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module#name');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton (Ns_Module#name$)', () => {
+                const dto = chunk.parse('Ns_Module#name$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module#name$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, instance (Ns_Module#name$$)', () => {
+                const dto = chunk.parse('Ns_Module#name$$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module#name$$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton with wrappers (Ns_Module#name$(proxy,factory))', () => {
+                const dto = chunk.parse('Ns_Module#name$(proxy,factory)');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module#name$(proxy,factory)');
+                assert.strictEqual(dto.wrappers.length, 2);
+            });
+        });
+
+        describe('nodejs package:', () => {
+            it('es6 module (node:pkg)', () => {
+                const dto = chunk.parse('node:pkg');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, undefined);
+                assert.strictEqual(dto.exportName, undefined);
+                assert.strictEqual(dto.life, undefined);
+                assert.strictEqual(dto.origin, 'node:pkg');
+            });
+            it('default export, singleton (node:pkg$$)', () => {
+                const dto = chunk.parse('node:pkg$$');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.origin, 'node:pkg$$');
+            });
+            it('named export (node:pkg.export)', () => {
+                const dto = chunk.parse('node:pkg.export');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, Defs.CA);
+                assert.strictEqual(dto.exportName, 'export');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.origin, 'node:pkg.export');
+            });
+            it('named export, factory (node:pkg.export$$)', () => {
+                const dto = chunk.parse('node:pkg.export$$');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'export');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.origin, 'node:pkg.export$$');
+            });
+            it('scoped package (node:@teqfw/db)', () => {
+                const dto = chunk.parse('node:@teqfw/db');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, '@teqfw/db');
+                assert.strictEqual(dto.composition, undefined);
+                assert.strictEqual(dto.exportName, undefined);
+                assert.strictEqual(dto.life, undefined);
+                assert.strictEqual(dto.origin, 'node:@teqfw/db');
+            });
+            it('scoped package export (node:@teqfw/db.export$$)', () => {
+                const dto = chunk.parse('node:@teqfw/db.export$$');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, '@teqfw/db');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'export');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.origin, 'node:@teqfw/db.export$$');
+            });
+        });
+    });
+
+});

package/test/Container/A/Parser/Chunk/V02X.test.mjs

@@ -0,0 +1,138 @@
+/**
+ * Default format for the objects:
+ *  - Ns_Module: es6 module
+ *  - Ns_Module$: default export, factory, singleton (the most frequently used case)
+ *  - Ns_Module$I: default export, factory, instance
+ *  - Ns_Module$AS: default export, as-is, singleton
+ *  - Ns_Module.name: named export, as-is, singleton
+ *  - Ns_Module.name$: named export, factory, singleton (the most frequently used case)
+ *  - Ns_Module.name$I: named export, factory, instance
+ */
+import DefChunk from '../../../../../src/Container/A/Parser/Chunk/V02X.js';
+import {describe, it} from 'node:test';
+import assert from 'node:assert';
+import Defs from '../../../../../src/Defs.js';
+
+describe('TeqFw_Di_Container_A_Parser_Chunk_V02X', () => {
+
+    const chunk = new DefChunk();
+
+    describe('should parse:', () => {
+
+        describe('default export:', () => {
+            it('es6 module (Ns_Module)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module');
+                assert.strictEqual(dto.composition, undefined);
+                assert.strictEqual(dto.exportName, undefined);
+                assert.strictEqual(dto.life, undefined);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton (Ns_Module$)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, instance (Ns_Module$I)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module$I');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module$I');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('default export, as-is, singleton (Ns_Module$AS)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module$AS');
+                assert.strictEqual(dto.composition, Defs.CA);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module$AS');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+        });
+
+        describe('named export:', () => {
+            it('as-is, singleton (Ns_Module.name)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name');
+                assert.strictEqual(dto.composition, Defs.CA);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, singleton (Ns_Module.name$)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name$');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name$');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+            it('factory, instance (Ns_Module.name$I)', () => {
+                /** @type {TeqFw_Di_DepId} */
+                const dto = chunk.parse('Ns_Module.name$I');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'name');
+                assert.strictEqual(dto.life, Defs.LI);
+                assert.strictEqual(dto.moduleName, 'Ns_Module');
+                assert.strictEqual(dto.origin, 'Ns_Module.name$I');
+                assert.strictEqual(dto.wrappers.length, 0);
+            });
+        });
+
+        describe('nodejs package:', () => {
+            it('es6 module (node:pkg)', () => {
+                const dto = chunk.parse('node:pkg');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, undefined);
+                assert.strictEqual(dto.exportName, undefined);
+                assert.strictEqual(dto.life, undefined);
+                assert.strictEqual(dto.origin, 'node:pkg');
+            });
+            it('default export, singleton (node:pkg$)', () => {
+                const dto = chunk.parse('node:pkg$');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'default');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.origin, 'node:pkg$');
+            });
+            it('named export (node:pkg.export)', () => {
+                const dto = chunk.parse('node:pkg.export');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, Defs.CA);
+                assert.strictEqual(dto.exportName, 'export');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.origin, 'node:pkg.export');
+            });
+            it('named export, factory (node:pkg.export$)', () => {
+                const dto = chunk.parse('node:pkg.export$');
+                assert.strictEqual(dto.isNodeModule, true);
+                assert.strictEqual(dto.moduleName, 'pkg');
+                assert.strictEqual(dto.composition, Defs.CF);
+                assert.strictEqual(dto.exportName, 'export');
+                assert.strictEqual(dto.life, Defs.LS);
+                assert.strictEqual(dto.origin, 'node:pkg.export$');
+            });
+        });
+    });
+
+});

package/test/Container.test.mjs

@@ -0,0 +1,141 @@
+import {dirname, join} from 'node:path';
+import assert from 'node:assert';
+import {describe, it} from 'node:test';
+import Container from '../src/Container.js';
+import Defs from '../src/Defs.js';
+
+const __dirname = dirname(import.meta.url);
+const ROOT = join(__dirname, '_data', 'Container');
+
+describe('TeqFw_Di_Container', () => {
+
+    describe('basic tests', () => {
+        it('has right classname', async () => {
+            const container = new Container();
+            assert.strictEqual(container.constructor.name, 'TeqFw_Di_Container');
+        });
+
+        it('has all expected public methods', async () => {
+            const container = new Container();
+            const methods = Object.getOwnPropertyNames(container)
+                .filter(p => (typeof container[p] === 'function'));
+            assert.deepStrictEqual(methods.sort(), [
+                'enableTestMode',
+                'get',
+                'getParser',
+                'getPostProcessor',
+                'getPreProcessor',
+                'getResolver',
+                'register',
+                'setDebug',
+                'setParser',
+                'setPostProcessor',
+                'setPreProcessor',
+                'setResolver',
+            ]);
+        });
+
+        it('does not contain itself inside', async () => {
+            const container = new Container();
+            await assert.rejects(
+                async () => {
+                    await container.get('container');
+                },
+                {
+                    code: 'ERR_MODULE_NOT_FOUND',
+                    message: /^Cannot find package 'container'/
+                }
+            );
+        });
+    });
+
+    describe('creates objects', () => {
+
+        it('default export singleton (App_Service$)', async () => {
+            const container = new Container();
+            container.setDebug(true);
+            const resolver = container.getResolver();
+            const src = join(ROOT, 'classes');
+            resolver.addNamespaceRoot('App_', src, 'js');
+            const dep = await container.get('App_Service$');
+            assert(dep);
+            assert(Object.isFrozen(dep));
+            dep({boobs: 'big'});
+        });
+
+    });
+
+    describe('prevents loops', () => {
+
+        it('simple loop', async () => {
+            const container = new Container();
+            container.setDebug(true);
+            const resolver = container.getResolver();
+            const src = join(ROOT, 'loop');
+            resolver.addNamespaceRoot('App_', src, 'js');
+            try {
+                await container.get('App_Service$');
+            } catch (e) {
+                assert(e);
+            }
+        });
+
+    });
+
+    describe('register()', () => {
+
+        it('registers a new singleton successfully when test mode is enabled', async () => {
+            const container = new Container();
+            container.enableTestMode();
+            const obj = {hello: 'world'};
+            container.register('My_Test_Module$', obj);
+            const instance = await container.get('My_Test_Module$');
+            assert.strictEqual(instance, obj);
+        });
+
+        it('throws if already registered, even in test mode', async () => {
+            const container = new Container();
+            container.enableTestMode();
+            const obj = {hello: 'again'};
+            container.register('My_Test_Module$', obj);
+            assert.throws(() => {
+                container.register('My_Test_Module$', {oops: true});
+            }, /already registered/);
+        });
+
+        it('throws if test mode is not enabled', () => {
+            const container = new Container();
+            const obj = {unauthorized: true};
+            assert.throws(() => {
+                container.register('My_Test_Module$', obj);
+            }, /Use enableTestMode\(\) to allow it/);
+        });
+
+        it('throws if depId is missing (in test mode)', () => {
+            const container = new Container();
+            container.enableTestMode();
+            assert.throws(() => {
+                container.register(undefined, {});
+            }, /required/);
+        });
+
+        it('throws if object is missing (in test mode)', () => {
+            const container = new Container();
+            container.enableTestMode();
+            assert.throws(() => {
+                container.register('My_Missing_Obj$', null);
+            }, /required/);
+        });
+
+        it('throws if trying to register a non-singleton (in test mode)', () => {
+            const container = new Container();
+            container.enableTestMode();
+            assert.throws(() => {
+                container.register('My_Test_Module$$', {notAllowed: true});
+            }, /Only node modules & singletons can be registered/);
+        });
+
+    });
+
+
+});

package/test/_data/Container/basic/Config.js

@@ -0,0 +1,3 @@
+export default {
+    appName: 'Test App',
+};

package/test/_data/Container/basic/Logger.js

@@ -0,0 +1,7 @@
+export default async function ({App_Config: config}) {
+    console.info(`Logger is created with config: '${JSON.stringify(config)}'`);
+    return {
+        error: (msg) => console.error(msg),
+        info: (msg) => console.info(msg),
+    };
+};

package/test/_data/Container/basic/Service.js

@@ -0,0 +1,10 @@
+export default async function (
+    {
+        App_Logger$: logger,
+        App_Config: config,
+    }
+) {
+    return function (opts) {
+        logger.info(`Service '${config.appName}' is running with: ${JSON.stringify(opts)}`);
+    };
+}

package/test/_data/Container/classes/Config.js

@@ -0,0 +1,3 @@
+export default {
+    appName: 'Test App',
+};

package/test/_data/Container/classes/Logger.js

@@ -0,0 +1,7 @@
+export default async function ({App_Config: config}) {
+    console.info(`Logger is created with config: '${JSON.stringify(config)}'`);
+    return {
+        error: (msg) => console.error(msg),
+        info: (msg) => console.info(msg),
+    };
+};

package/test/_data/Container/classes/Service.js

@@ -0,0 +1,15 @@
+export default class App_Service {
+    constructor(
+        {
+            App_Logger$: logger,
+            App_Config: config,
+            'node:http2': http2,
+        }
+    ) {
+        const {constants: {HTTP2_HEADER_CONTENT_TYPE}} = http2;
+        return function (opts) {
+            logger.info(`Service '${config.appName}' is running with: ${JSON.stringify(opts)}`);
+            logger.info(`Header: ${HTTP2_HEADER_CONTENT_TYPE}`);
+        };
+    }
+}

package/test/_data/Container/loop/Config.js

@@ -0,0 +1,7 @@
+export default class {
+    constructor({App_Service$}) {
+        return {
+            appName: 'Test App',
+        };
+    }
+};

package/test/_data/Container/loop/Logger.js

@@ -0,0 +1,7 @@
+export default async function ({App_Config$I: config}) {
+    console.info(`Logger is created with config: '${JSON.stringify(config)}'`);
+    return {
+        error: (msg) => console.error(msg),
+        info: (msg) => console.info(msg),
+    };
+};

package/test/_data/Container/loop/Service.js

@@ -0,0 +1,12 @@
+export default class App_Service {
+    constructor(
+        {
+            App_Logger$: logger,
+            App_Config: config,
+        }
+    ) {
+        return function (opts) {
+            logger.info(`Service '${config.appName}' is running with: ${JSON.stringify(opts)}`);
+        };
+    }
+}

package/test/_data/Container/node/Config.js

@@ -0,0 +1,3 @@
+export default {
+    appName: 'Test App',
+};

package/test/_data/Container/node/Logger.js

@@ -0,0 +1,7 @@
+export default async function ({App_Config: config}) {
+    console.info(`Logger is created with config: '${JSON.stringify(config)}'`);
+    return {
+        error: (msg) => console.error(msg),
+        info: (msg) => console.info(msg),
+    };
+};

package/test/_data/Container/node/Service.js

@@ -0,0 +1,12 @@
+export default class App_Service {
+    constructor(
+        {
+            App_Logger$: logger,
+            App_Config: config,
+        }
+    ) {
+        return function (opts) {
+            logger.info(`Service '${config.appName}' is running with: ${JSON.stringify(opts)}`);
+        };
+    }
+}

package/RELEASE.md

@@ -1,109 +0,0 @@
-# @teqfw/di releases
-
-## 0.35.0 – Support for Node.js Module Mocking in Test Mode
-
-- DI container (test mode): extended support to register not only singleton instances but also mock implementations of
-  native Node.js modules, enabling more flexible and robust unit testing.
-- Added missing property `TeqFw_Di_DepId.isNodeModule` to properly identify Node.js modules in the dependency resolution
-  process.
-- Improved documentation (`README.md` and `PHILOSOPHY.md`) to clarify the design philosophy of TeqFW and explain the
-  immutability and test mode features in greater detail.
-
-## 0.34.0 – Strict Mode and Test Support
-
-- Removed outdated interface `TeqFw_Di_Api_Container` and associated documentation.
-- Unified the `get()` and `compose()` methods for dependency retrieval.
-- Introduced strict mode by default: manual registration of dependencies is now **disabled** unless explicitly allowed.
-- Added `enableTestMode()` method to the container, enabling safe, test-specific manual registration of singleton
-  dependencies.
-- Improved error messages and safeguards against accidental overwrites in `register()`.
-- Updated internal naming and documentation for better clarity and alignment with the platform's principles.
-- Cleaned up ESLint and JSDoc inconsistencies in internal files.
-
-## 0.33.0 – Cleanup and Enhancements
-
-- Removed deprecated documentation.
-- Updated ESLint rules for consistency with current platform practices.
-- Introduced `#` as a separator (in addition to `.`) between namespace and export names.
-
-## 0.32.0 - added support for the `node:` prefix
-
-- **Added ability** to manually register objects in the container (`register`).
-- **Optimized dependency parsing**, added support for the `node:` prefix.
-- **Updated singleton handling**, fixed issues with `Defs.LS`.
-- **Added protection against object modification**, freezing objects when possible (`Object.freeze`).
-- **Updated dependencies** (Mocha, Rollup, Rollup plugins).
-
-## 0.31.0
-
-* Added optional `stack` parameter to the `get` method for improved dependency tracking and debugging.
-* Fixed browser example in the README by updating the usage of `window.TeqFw_Di_Container` for compatibility.
-
-## 0.30.2
-
-* Enhanced the README with updates from ChatGPT.
-* Unified JSDoc annotations.
-
-## 0.30.1
-
-* Improve the README.
-
-## 0.30.0
-
-* New format of the depId for default parser (`Ns_Module.export$$(post)`).
-* The rollup is added.
-
-## 0.22.0
-
-* Add Windows paths to the Resolver.
-
-## 0.21.1
-
-* Fix the dependency key signature in `TeqFw_Di_Container_A_Parser_Chunk_Def`.
-
-## 0.21.0
-
-* Restructured modules in the package.
-* Documentation update.
-
-## 0.20.1
-
-* Changed regex for parameter extraction in the Spec Analyzer.
-* Removed leading namespace separator in the Resolver.
-* Added `teqfw.json` descriptor to add npm-package to DI container as a sources root in `teqfw/web`.
-
-## 0.20.0
-
-* Fully redesigned package with simplified composition of objects in the container. Spec Analyzer is used instead of a
-  proxy object.
-
-## 0.12.1
-
-* Hotfix for Windows delimiters.
-
-## 0.12.0
-
-* Standardized comments style for improved code readability and maintenance.
-
-## 0.11.0
-
-* Restructure `/@teqfw/di/replace` node in `teqfw.json`.
-* Remove `TeqFw_Di_Shared_Api_Enum_Area` enumeration.
-* Fix example code (`npm run example`).
-
-## 0.10.0
-
-* Improve error messaging.
-* Use '.' instead of '#' in depIDs (Vnd_Plugin#export => Vnd_Plugin.export). Both variants are available for now.
-* Experimental proxy for deps are added (Vnd_Plugin.export@@).
-
-## 0.9.0
-
-* `TeqFw_Di_Shared_Api_Enum_Area` enumeration is added;
-
-## 0.8.0
-
-* docs for plugin's teq-descriptor (see in `main` branch);
-* use object notation instead of array notation in namespace replacement statements of
-  teq-descriptor (`@teqfw/di.replace` node format is changed in `./teqfw.json`);
-* array is used as a container for upline dependencies in the 'SpecProxy' (object was);

package/bin/release/clean.sh

@@ -1,14 +0,0 @@
-#!/usr/bin/env bash
-##
-# Clean development files from release branch
-##
-DIR_ROOT=${DIR_ROOT:-$(cd "$(dirname "$0")/../../" && pwd)}
-
-rm -fr "${DIR_ROOT}/demo/"
-rm -fr "${DIR_ROOT}/doc/"
-rm -fr "${DIR_ROOT}/docs/"
-rm -fr "${DIR_ROOT}/example/"
-rm -fr "${DIR_ROOT}/node_modules/"
-rm -fr "${DIR_ROOT}/package-lock.json"
-rm -fr "${DIR_ROOT}/test/"
-rm -fr "${DIR_ROOT}/tmp/"

package/dist/esm.js

@@ -1 +0,0 @@
-var e={CA:"A",CF:"F",ID:"container",ID_FQN:"TeqFw_Di_Container$",LI:"I",LS:"S",isClass(e){const t=Object.getOwnPropertyDescriptor(e,"prototype");return t&&!t.writable}};const t=/(function)*\s*\w*\s*\(\s*\{([^}]*)}/s,o=/constructor\s*\(\s*\{([^}]*)}/s;function n(e){const t=[];try{const o=new Function(`{${e}}`,"return");o(new Proxy({},{get:(e,o)=>t.push(o)}))}catch(t){throw new Error(`Cannot analyze the deps specification:${e}\n\nPlease, be sure that spec does not contain extra ')' in a comments.\n\nError: ${t}`)}return t}function s(s){return"function"==typeof s?e.isClass(s)?function(e){const t=[],s=e.toString(),r=o.exec(s);return r&&t.push(...n(r[1])),t}(s):function(e){const o=[],s=e.toString(),r=t.exec(s);return r&&o.push(...n(r[2])),o}(s):[]}class r{constructor(){let t=!1;this.create=async function(o,n,r,i){if(r.includes(o.origin))throw new Error(`Circular dependency for '${o.origin}'. Parents are: ${JSON.stringify(r)}`);if(o.exportName){const a=[...r,o.origin],{[o.exportName]:l}=n;if(o.composition===e.CF){if("function"==typeof l){const n=s(l);n.length&&(c=`Deps for object '${o.origin}' are: ${JSON.stringify(n)}`,t&&console.log(c));const r={};for(const e of n)r[e]=await i.get(e,a);const u=e.isClass(l)?new l(r):l(r);return u instanceof Promise?await u:u}return Object.assign({},l)}return l}return n;var c},this.setDebug=function(e){t=e}}}class i{exportName;composition;isNodeModule;life;moduleName;origin;wrappers=[]}const c=/^(node:)?(@?[A-Za-z0-9_-]+\/?[A-Za-z0-9_-]*)(([.#])?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?$/;class a{canParse(){return!0}parse(t){const o=new i;o.origin=t;const n=c.exec(t);if(n&&(o.isNodeModule=Boolean(n[1]),o.moduleName=n[2].replace(/^node:/,""),"."===n[4]||"#"===n[4]?"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName=n[5],o.life="$"===n[6]?e.LS:e.LI):(o.composition=e.CA,o.life=e.LS,o.exportName=""!==n[5]?n[5]:"default"):"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName="default",o.life="$"===n[6]?e.LS:e.LI):(o.composition=void 0,o.exportName=void 0,o.life=void 0),n[10]&&(o.wrappers=n[10].split(","))),o.composition===e.CA&&o.life===e.LI)throw new Error(`Export is not a function and should be used as a singleton only: '${o.origin}'.`);return o}}class l{constructor(){let e=new a;const t=[];this.addChunk=function(e){t.push(e)},this.parse=function(o){let n;for(const e of t)if(e.canParse(o)){n=e.parse(o);break}return n||(n=e?.parse(o)),n},this.setDefaultChunk=function(t){e=t}}}class u{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=function(t,o){let n=t;for(const s of e)n=s.modify(n,t,o);return n}}}class f{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=async function(t,o,n){let s=t;for(const t of e)s=t.modify(s,o,n),s instanceof Promise&&(s=await s);return s}}}const d="ext",p="ns",h="root";class m{constructor(){const e={};let t=!1,o=[],n="/";this.addNamespaceRoot=function(n,s,r){const i=(t?s.replace(/^\\/,""):s).replace(/\\/g,"/"),c=t?`file://${i}`:i;e[n]={[d]:r??"js",[p]:n,[h]:c},o=Object.keys(e).sort(((e,t)=>t.localeCompare(e)))},this.resolve=function(t){let s,r,i;for(i of o)if(t.startsWith(i)){s=e[i][h],r=e[i].ext;break}if(s&&r){let e=t.replace(i,"");0===e.indexOf("_")&&(e=e.replace("_",""));const o=e.replaceAll("_",n);return`${s}${n}${o}.${r}`}return t},this.setWindowsEnv=function(e=!0){t=e,n=e?"\\":"/"}}}function g(e){return`${e.moduleName}#${e.exportName}`}class ${constructor(){let t=new r,o=!1,n=new l,s=new f,i=new u,c=!1;const a={},d={},p={};let h=new m;function $(){o&&console.log(...arguments)}this.get=async function(o,r=[]){if($(`Object '${o}' is requested.`),o===e.ID||o===e.ID_FQN)return $("Container itself is returned."),d[e.ID];const l=n.parse(o),u=i.modify(l,r);if(u.life===e.LS){const e=g(u);if(d[e])return $(`Existing singleton '${e}' is returned.`),d[e]}if(u.isNodeModule&&c){const e=u.origin;if(p[e])return $(`Existing nodejs lib '${e}' is returned.`),p[e]}let f;a[u.moduleName]||($(`ES6 module '${u.moduleName}' is not resolved yet`),a[u.moduleName]=h.resolve(u.moduleName));const m=a[u.moduleName];try{f=await import(m),$(`ES6 module '${u.moduleName}' is loaded from '${m}'.`)}catch(e){throw console.error(e?.message,`Object key: "${o}".`,`Path: "${m}".`,`Stack: ${JSON.stringify(r)}`),e}let w=await t.create(u,f,r,this);var y;if(null===(y=w)||"object"!=typeof y&&"function"!=typeof y||"[object Module]"===Object.prototype.toString.call(y)||Object.isFrozen(y)||Object.freeze(w),w=await s.modify(w,u,r),$(`Object '${o}' is created.`),u.life===e.LS){const e=g(u);d[e]=w,$(`Object '${o}' is saved as singleton.`)}return w},this.enableTestMode=function(){c=!0,$("Test mode enabled")},this.getParser=()=>n,this.getPreProcessor=()=>i,this.getPostProcessor=()=>s,this.getResolver=()=>h,this.register=function(t,o){if(!c)throw new Error("Use enableTestMode() to allow it");if(!t||!o)throw new Error("Both params are required");const s=n.parse(t);if(s.life!==e.LS&&!s.isNodeModule)throw new Error(`Only node modules & singletons can be registered: '${t}'`);if(s.life===e.LS){const e=g(s);if(d[e])throw new Error(`'${t}' is already registered`);d[e]=o}else if(s.isNodeModule){const e=s.origin;if(p[e])throw new Error(`'${t}' is already registered`);p[e]=o}$(`'${t}' is registered`)},this.setDebug=function(e){o=e,t.setDebug(e)},this.setParser=e=>n=e,this.setPreProcessor=e=>i=e,this.setPostProcessor=e=>s=e,this.setResolver=e=>h=e,d[e.ID]=this}}export{$ as default};

package/dist/umd.js

@@ -1 +0,0 @@
-!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={CA:"A",CF:"F",ID:"container",ID_FQN:"TeqFw_Di_Container$",LI:"I",LS:"S",isClass(e){const t=Object.getOwnPropertyDescriptor(e,"prototype");return t&&!t.writable}};const t=/(function)*\s*\w*\s*\(\s*\{([^}]*)}/s,o=/constructor\s*\(\s*\{([^}]*)}/s;function n(e){const t=[];try{const o=new Function(`{${e}}`,"return");o(new Proxy({},{get:(e,o)=>t.push(o)}))}catch(t){throw new Error(`Cannot analyze the deps specification:${e}\n\nPlease, be sure that spec does not contain extra ')' in a comments.\n\nError: ${t}`)}return t}function s(s){return"function"==typeof s?e.isClass(s)?function(e){const t=[],s=e.toString(),r=o.exec(s);return r&&t.push(...n(r[1])),t}(s):function(e){const o=[],s=e.toString(),r=t.exec(s);return r&&o.push(...n(r[2])),o}(s):[]}class r{constructor(){let t=!1;this.create=async function(o,n,r,i){if(r.includes(o.origin))throw new Error(`Circular dependency for '${o.origin}'. Parents are: ${JSON.stringify(r)}`);if(o.exportName){const a=[...r,o.origin],{[o.exportName]:l}=n;if(o.composition===e.CF){if("function"==typeof l){const n=s(l);n.length&&(c=`Deps for object '${o.origin}' are: ${JSON.stringify(n)}`,t&&console.log(c));const r={};for(const e of n)r[e]=await i.get(e,a);const u=e.isClass(l)?new l(r):l(r);return u instanceof Promise?await u:u}return Object.assign({},l)}return l}return n;var c},this.setDebug=function(e){t=e}}}class i{exportName;composition;isNodeModule;life;moduleName;origin;wrappers=[]}const c=/^(node:)?(@?[A-Za-z0-9_-]+\/?[A-Za-z0-9_-]*)(([.#])?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?$/;class a{canParse(){return!0}parse(t){const o=new i;o.origin=t;const n=c.exec(t);if(n&&(o.isNodeModule=Boolean(n[1]),o.moduleName=n[2].replace(/^node:/,""),"."===n[4]||"#"===n[4]?"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName=n[5],o.life="$"===n[6]?e.LS:e.LI):(o.composition=e.CA,o.life=e.LS,o.exportName=""!==n[5]?n[5]:"default"):"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName="default",o.life="$"===n[6]?e.LS:e.LI):(o.composition=void 0,o.exportName=void 0,o.life=void 0),n[10]&&(o.wrappers=n[10].split(","))),o.composition===e.CA&&o.life===e.LI)throw new Error(`Export is not a function and should be used as a singleton only: '${o.origin}'.`);return o}}class l{constructor(){let e=new a;const t=[];this.addChunk=function(e){t.push(e)},this.parse=function(o){let n;for(const e of t)if(e.canParse(o)){n=e.parse(o);break}return n||(n=e?.parse(o)),n},this.setDefaultChunk=function(t){e=t}}}class u{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=function(t,o){let n=t;for(const s of e)n=s.modify(n,t,o);return n}}}class f{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=async function(t,o,n){let s=t;for(const t of e)s=t.modify(s,o,n),s instanceof Promise&&(s=await s);return s}}}const d="ext",p="ns",h="root";class m{constructor(){const e={};let t=!1,o=[],n="/";this.addNamespaceRoot=function(n,s,r){const i=(t?s.replace(/^\\/,""):s).replace(/\\/g,"/"),c=t?`file://${i}`:i;e[n]={[d]:r??"js",[p]:n,[h]:c},o=Object.keys(e).sort(((e,t)=>t.localeCompare(e)))},this.resolve=function(t){let s,r,i;for(i of o)if(t.startsWith(i)){s=e[i][h],r=e[i].ext;break}if(s&&r){let e=t.replace(i,"");0===e.indexOf("_")&&(e=e.replace("_",""));const o=e.replaceAll("_",n);return`${s}${n}${o}.${r}`}return t},this.setWindowsEnv=function(e=!0){t=e,n=e?"\\":"/"}}}function g(e){return`${e.moduleName}#${e.exportName}`}return class{constructor(){let t=new r,o=!1,n=new l,s=new f,i=new u,c=!1;const a={},d={},p={};let h=new m;function w(){o&&console.log(...arguments)}this.get=async function(o,r=[]){if(w(`Object '${o}' is requested.`),o===e.ID||o===e.ID_FQN)return w("Container itself is returned."),d[e.ID];const l=n.parse(o),u=i.modify(l,r);if(u.life===e.LS){const e=g(u);if(d[e])return w(`Existing singleton '${e}' is returned.`),d[e]}if(u.isNodeModule&&c){const e=u.origin;if(p[e])return w(`Existing nodejs lib '${e}' is returned.`),p[e]}let f;a[u.moduleName]||(w(`ES6 module '${u.moduleName}' is not resolved yet`),a[u.moduleName]=h.resolve(u.moduleName));const m=a[u.moduleName];try{f=await import(m),w(`ES6 module '${u.moduleName}' is loaded from '${m}'.`)}catch(e){throw console.error(e?.message,`Object key: "${o}".`,`Path: "${m}".`,`Stack: ${JSON.stringify(r)}`),e}let $=await t.create(u,f,r,this);var y;if(null===(y=$)||"object"!=typeof y&&"function"!=typeof y||"[object Module]"===Object.prototype.toString.call(y)||Object.isFrozen(y)||Object.freeze($),$=await s.modify($,u,r),w(`Object '${o}' is created.`),u.life===e.LS){const e=g(u);d[e]=$,w(`Object '${o}' is saved as singleton.`)}return $},this.enableTestMode=function(){c=!0,w("Test mode enabled")},this.getParser=()=>n,this.getPreProcessor=()=>i,this.getPostProcessor=()=>s,this.getResolver=()=>h,this.register=function(t,o){if(!c)throw new Error("Use enableTestMode() to allow it");if(!t||!o)throw new Error("Both params are required");const s=n.parse(t);if(s.life!==e.LS&&!s.isNodeModule)throw new Error(`Only node modules & singletons can be registered: '${t}'`);if(s.life===e.LS){const e=g(s);if(d[e])throw new Error(`'${t}' is already registered`);d[e]=o}else if(s.isNodeModule){const e=s.origin;if(p[e])throw new Error(`'${t}' is already registered`);p[e]=o}w(`'${t}' is registered`)},this.setDebug=function(e){o=e,t.setDebug(e)},this.setParser=e=>n=e,this.setPreProcessor=e=>i=e,this.setPostProcessor=e=>s=e,this.setResolver=e=>h=e,d[e.ID]=this}}}));