@teqfw/di 0.36.0 → 1.0.1

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.

package/dist/esm.js

@@ -1 +1 @@
-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};
+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

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).TeqFw_Di_Container=t()}(this,(function(){"use strict";var e={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}}}));
+!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": "0.36.0",
+  "version": "1.0.1",
   "description": "Dependency Injection container for ES6 modules that works in both browser and Node.js apps.",
   "keywords": [
     "dependency injection",
@@ -20,7 +20,20 @@
     "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"
+    }
+  },
   "type": "module",
   "repository": {
     "type": "git",
@@ -29,18 +42,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"
+  },
+  "engines": {
+    "node": ">=20"
   },
-  "mocha": {
-    "spec": "./test/**/*.test.mjs",
-    "timeout": 5000
+  "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/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/RELEASE.md

@@ -1,116 +0,0 @@
-# @teqfw/di releases
-
-## 0.36.0 – New Preprocessor for Dynamic Dependency Rewriting
-
-- Introduced `TeqFw_Di_Pre_Replace`, a new preprocessor allowing runtime substitution of dependency identifiers before
-  object creation, enabling advanced customization scenarios.
-- Improved documentation (`README.md`): added concrete examples of mocking native Node.js modules during testing, better
-  illustrating the power of test mode and late binding.
-
-## 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/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,9 +0,0 @@
-{
-  "@teqfw/di": {
-    "autoload": {
-      "ns": "TeqFw_Di",
-      "path": "./src",
-      "ext": "js"
-    }
-  }
-}