@teqfw/di 1.0.0 → 1.0.2

package/dist/esm.js

@@ -0,0 +1 @@
+var e={CA:"A",CF:"F",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 s(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 n(n){return"function"==typeof n?e.isClass(n)?function(e){const t=[],n=e.toString(),r=o.exec(n);return r&&t.push(...s(r[1])),t}(n):function(e){const o=[],n=e.toString(),r=t.exec(n);return r&&o.push(...s(r[2])),o}(n):[]}class r{constructor(){let t=!1;this.create=async function(o,s,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}=s;if(o.composition===e.CF){if("function"==typeof l){const s=n(l);s.length&&(c=`Deps for object '${o.origin}' are: ${JSON.stringify(s)}`,t&&console.log(c));const r={};for(const e of s)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 s;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 s=c.exec(t);if(s&&(o.isNodeModule=Boolean(s[1]),o.moduleName=s[2].replace(/^node:/,""),"."===s[4]||"#"===s[4]?"$"===s[6]||"$$"===s[6]?(o.composition=e.CF,o.exportName=s[5],o.life="$"===s[6]?e.LS:e.LI):(o.composition=e.CA,o.life=e.LS,o.exportName=""!==s[5]?s[5]:"default"):"$"===s[6]||"$$"===s[6]?(o.composition=e.CF,o.exportName="default",o.life="$"===s[6]?e.LS:e.LI):(o.composition=void 0,o.exportName=void 0,o.life=void 0),s[10]&&(o.wrappers=s[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 s;for(const e of t)if(e.canParse(o)){s=e.parse(o);break}return s||(s=e?.parse(o)),s},this.setDefaultChunk=function(t){e=t}}}class u{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=function(t,o){let s=t;for(const n of e)s=n.modify(s,t,o);return s}}}class f{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=async function(t,o,s){let n=t;for(const t of e)n=t.modify(n,o,s),n instanceof Promise&&(n=await n);return n}}}const d="ext",p="ns",h="root";class m{constructor(){const e={};let t=!1,o=[],s="/";this.addNamespaceRoot=function(s,n,r){const i=(t?n.replace(/^\\/,""):n).replace(/\\/g,"/"),c=t?`file://${i}`:i;e[s]={[d]:r??"js",[p]:s,[h]:c},o=Object.keys(e).sort((e,t)=>t.localeCompare(e))},this.resolve=function(t){let n,r,i;for(i of o)if(t.startsWith(i)){n=e[i][h],r=e[i].ext;break}if(n&&r){let e=t.replace(i,"");0===e.indexOf("_")&&(e=e.replace("_",""));const o=e.replaceAll("_",s);return`${n}${s}${o}.${r}`}return t},this.setWindowsEnv=function(e=!0){t=e,s=e?"\\":"/"}}}function g(e){return`${e.moduleName}#${e.exportName}`}class ${constructor(){let t=new r,o=!1,s=new l,n=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=[]){$(`Object '${o}' is requested.`);const l=s.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 n.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=()=>s,this.getPreProcessor=()=>i,this.getPostProcessor=()=>n,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 n=s.parse(t);if(n.life!==e.LS&&!n.isNodeModule)throw new Error(`Only node modules & singletons can be registered: '${t}'`);if(n.life===e.LS){const e=g(n);if(d[e])throw new Error(`'${t}' is already registered`);d[e]=o}else if(n.isNodeModule){const e=n.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=>s=e,this.setPreProcessor=e=>i=e,this.setPostProcessor=e=>n=e,this.setResolver=e=>h=e}}export{$ as default};

package/dist/umd.js

@@ -0,0 +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={CA:"A",CF:"F",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=[]){w(`Object '${o}' is requested.`);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}}});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teqfw/di",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Dependency Injection container for ES6 modules that works in both browser and Node.js apps.",
   "keywords": [
     "dependency injection",
@@ -20,7 +20,23 @@
     "email": "alex@flancer64.com",
     "url": "https://github.com/flancer64"
   },
-  "main": "src/Container.js",
+  "files": [
+    "dist/",
+    "src/",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "dist/umd.js",
+  "module": "dist/esm.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm.js",
+      "require": "./dist/umd.js"
+    },
+    "./pre/replace": {
+      "import": "./src/Pre/Replace.js"
+    }
+  },
   "type": "module",
   "repository": {
     "type": "git",

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

@@ -1,48 +0,0 @@
-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

@@ -1,6 +0,0 @@
-# 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

@@ -1,9 +0,0 @@
-# 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/PHILOSOPHY.md

@@ -1,175 +0,0 @@
-# Philosophy of the TeqFW Platform
-
-**The philosophy of Tequila Framework (TeqFW)** is my personal approach to organizing web application development. I,
-Alex Gusev, have shaped this approach based on my own experience, which focuses on **modular monoliths** with a single
-database. This document reflects that specific context and does not aim to be universal.
-
-Some of the principles presented may be applicable more broadly, while others may be irrelevant (or even
-counterproductive) outside monolithic architectures. It is important to keep this limitation in mind when interpreting
-the material.
-
-The document is intended to provide cognitive context for both human and artificial intelligences. It addresses both
-specific aspects of web development and more general software architecture issues, emphasizing the reduction of
-excessive complexity, improved structuring, and adaptability to changes.
-
-**Tequila Framework (TeqFW)** is not a finished product but an evolving experimental platform. It serves as a testbed
-for the principles outlined here and is actively used in development.
-
-## Core Principles of TeqFW
-
-1. **Use a Unified Development Language:** JavaScript (ES6+) is used on both the client and server sides, ensuring code
-   integrity, reducing duplication, and lowering cognitive load.
-
-2. **Enable Late Binding for Flexibility:** Dynamic dependency management through an object container and ES6 module
-   namespaces. This reduces tight coupling between modules, simplifies system expansion, and makes the code more
-   adaptable.
-
-3. **Design for Evolutionary Code Resilience:** Code is designed with inevitable changes in mind to minimize adaptation
-   costs and facilitate expansion without modifying existing components.
-
-4. **Separate Data and Logic Functionally:** Isolation of data structures (DTO) and logic handlers. This approach makes
-   code easier to test, maintain, and reuse.
-
-5. **Use Namespaces for Structure and Isolation:** Each type of entity—npm packages, ES6 modules, database tables, CLI
-   commands, or configurations—has its own namespace. This ensures clear project structure, reduces conflicts, and
-   simplifies code navigation.
-
-6. **Favor Pure JavaScript Without Compilation:** Using modern JavaScript (ES6+) without TypeScript or version
-   downgrading. The code remains transparent and accessible, simplifying maintenance, library integration, and speeding
-   up development.
-
-7. **Optimize Code and Docs for LLMs:** Code and documentation are organized to be easily analyzed and supplemented by
-   language models. Clear structure, standardized templates, and predictable conventions simplify automation and code
-   generation.
-
-## Principles in Detail
-
-### Use a Unified Development Language
-
-Using modern JavaScript (ES6+) at all application levels eliminates the need to switch between different languages and
-simplifies knowledge sharing among developers. This is especially important in small teams and projects with limited
-resources, where minimizing cognitive load accelerates work.
-
-Browsers support only JavaScript (among high-level languages), and thanks to Node.js, it has become widespread in server
-development. This enables writing **isomorphic code** that can be reused on both client and server sides, reducing logic
-duplication.
-
-A unified language simplifies code maintenance and accelerates the onboarding of new developers into the project.
-
-### Enable Late Binding for Flexibility
-
-Late binding ensures architectural flexibility by allowing dynamic dependency management without tight coupling between
-modules. Instead of direct imports, ES6 module namespaces and an object container are used to handle instantiation and
-component replacement at runtime.
-
-This approach reduces the risk of application "breakage" due to changes, simplifies system expansion, and makes the code
-more adaptable. Components can be replaced without deep refactoring, and the dependency mechanism remains transparent
-and predictable.
-
-Late binding also improves testability: modules can be replaced with stubs or alternative implementations, making it
-easier to isolate tests. In team development, this simplifies understanding of complex dependencies and makes system
-maintenance more manageable.
-
-### Design for Evolutionary Code Resilience
-
-Code is designed to adapt to inevitable changes in requirements, APIs, and data with minimal overhead. This is achieved
-through approaches that allow **expanding functionality without significant modifications to existing code**.
-
-Key techniques:
-
-- **Flexible input data processing.** Using function argument destructuring and the "ignore unknown attributes"
-  principle in data structures allows adding new parameters and properties without modifying existing handlers.
-- **Clear interaction contracts.** Separating interfaces from implementations reduces the impact of changes while
-  maintaining system predictability.
-- **Late binding.** Components depend on abstractions rather than specific implementations, enabling code adaptation
-  without directly modifying dependencies (see **Enable Late Binding for Flexibility** principle).
-
-These methods make the code less fragile and allow the system to evolve while reducing complexity and refactoring
-volume.
-
-### Separate Data and Logic Functionally
-
-Code is divided into **data structures (DTO) and logic handlers**, eliminating state within handlers and making them
-independent of data. DTOs contain all necessary information and are passed between handlers that perform operations on
-them.
-
-This approach offers several key advantages:
-
-- **Handlers can be singletons.** Since they do not store state, they are execution-context-independent and can be
-  shared across the entire application.
-- **The program consists of data processing nodes.** The code is structured as a set of functions that receive data,
-  process it, and pass it on.
-- **Changeability through pure logic.** Logic remains separate from data structures, allowing modifications without
-  affecting handlers and vice versa.
-- **Minimized side effects.** Handlers do not depend on global state, making the system more predictable.
-
-### Use Namespaces for Structure and Isolation
-
-Namespaces ensure a clear project structure and prevent conflicts by allowing each entity to reserve its name and build
-its own hierarchy. This principle applies at all levels:
-
-- **Packages and modules.** npm packages and ES6 modules are organized into predictable namespaces, avoiding dependency
-  conflicts.
-- **Files and classes.** File and class names reflect their purpose and relationships with other components, simplifying
-  project navigation and structure.
-- **Database tables.** Table names are structured to avoid collisions and logically group data.
-- **Endpoints and APIs.** Namespaces are used in routing and APIs, ensuring consistent addressing.
-- **Configurations and CLI commands.** Settings and commands are organized hierarchically to prevent duplication.
-
-Code is designed to operate in an environment with other code. Each unit within its namespace reserves a name and builds
-a downward hierarchy, creating a predictable interaction structure.
-
-### Favor Pure JavaScript Without Compilation
-
-Tequila Framework uses modern JavaScript (ES6+) without version downgrading or strict TypeScript typing. The code
-remains in its original form, making it transparent, accessible, and easy to maintain.
-
-Key characteristics:
-
-- **No compilation.** Developers work with pure JavaScript without intermediate transformations, speeding up debugging
-  and simplifying maintenance.
-- **JSDoc instead of TypeScript.** JSDoc annotations allow IDEs to understand data structures and provide
-  autocompletion, maintaining flexibility without strict typing.
-- **Maximum compatibility.** The code easily integrates with any libraries and tools, as it does not require adaptation
-  to strict type contracts.
-- **Fast development.** Changes are immediately reflected in the code without requiring a rebuild, increasing
-  development speed.
-
-### Optimize Code and Docs for LLMs
-
-Architecture, code, and documentation are designed for easy analysis and use by language models (LLM). This improves the
-efficiency of **automatic code completion, generation of template solutions, and integration with AI tools**.
-
-For this, the following practices are applied:
-
-- **Predictable project structure.** Clear file organization, logical naming, and standardized conventions.
-- **Unified code templates.** Repetitive structures and a predictable format help models understand and supplement the
-  code.
-- **Optimized abstraction depth.** Code is organized to maintain modularity while avoiding excessive nesting.
-- **Automated annotations.** JSDoc and standardized comments ensure precise code generation and documentation.
-
-This approach allows LLM agents to:
-
-- Quickly analyze code and suggest corrections.
-- Automatically supplement documentation and comment code.
-- Generate new modules according to the project's architectural standards.
-- Simplify CI/CD integration by checking code compliance with style and conventions.
-
-LLMs become part of the development process, helping not only with writing code but also keeping it up to date, reducing
-developers' routine workload.
-
-## Conclusion
-
-The principles outlined in this document form an approach to **modular monolith** development, focused on
-predictability, structure, and adaptability. They enable building architectures where code remains flexible,
-transparent, and easily extensible.
-
-These ideas do not require complex theoretical justifications or significant time investments for validation. They aim
-to simplify integration, reduce unnecessary complexity, and enhance the potential for automation. **Standardized
-structures, predictable namespaces, and development without transpilation** create an environment where the code is
-understandable both for developers and language models (LLM).
-
-The **Tequila Framework (TeqFW)** platform demonstrates these principles in action. While still evolving, it already
-supports real-world development. This approach may serve not only as a foundation for proprietary tools, but also as
-inspiration for rethinking conventional software architecture, prioritizing clarity, modularity, and adaptability over
-unnecessary complexity.

package/eslint.config.js

@@ -1,37 +0,0 @@
-// eslint.config.js
-import js from '@eslint/js';
-
-/** @type {import('eslint').Linter.FlatConfig[]} */
-export default [
-    js.configs.recommended,
-    {
-        languageOptions: {
-            ecmaVersion: 2022, // required for public class fields
-            sourceType: 'module',
-            globals: {
-                console: 'readonly',
-            },
-        },
-        rules: {
-            'camelcase': [
-                'warn',
-                {
-                    properties: 'never',
-                    ignoreDestructuring: true,
-                    allow: ['^([A-Z][a-zA-Z0-9]*_)+[A-Z][a-zA-Z0-9]*$'],
-                },
-            ],
-            'indent': ['error', 4],
-            'linebreak-style': ['error', 'unix'],
-            'quotes': ['error', 'single'],
-            'semi': ['error', 'always'],
-        },
-    },
-    // Special rule override for interface declarations
-    {
-        files: ['./src/Api/**/*.js'],
-        rules: {
-            'no-unused-vars': 'off',
-        },
-    },
-];

package/rollup.config.js

@@ -1,21 +0,0 @@
-import resolve from '@rollup/plugin-node-resolve';
-import terser from '@rollup/plugin-terser';
-
-export default {
-    input: 'src/Container.js',
-    output: [
-        {
-            file: 'dist/esm.js',
-            format: 'es'
-        },
-        {
-            file: 'dist/umd.js',
-            format: 'umd',
-            name: 'TeqFw_Di_Container',
-        }
-    ],
-    plugins: [
-        resolve(),
-        terser()
-    ]
-};

package/teqfw.json

@@ -1,8 +0,0 @@
-{
-  "@teqfw/di": {
-    "autoload": {
-      "ns": "TeqFw_Di_",
-      "path": "./src"
-    }
-  }
-}

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

@@ -1,98 +0,0 @@
-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

@@ -1,237 +0,0 @@
-/**
- * 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

@@ -1,138 +0,0 @@
-/**
- * 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

@@ -1,141 +0,0 @@
-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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1,10 +0,0 @@
-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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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)}`);
-        };
-    }
-}