@teqfw/di 1.2.0 → 2.0.0

package/src/Dto/Resolver/Config/Namespace.mjs

@@ -0,0 +1,48 @@
+// @ts-check
+
+/**
+ * DTO and factory for resolver namespace rule records.
+ */
+
+/**
+ * Runtime DTO for one namespace resolution rule.
+ */
+export class DTO {
+    /** @type {string|undefined} Namespace prefix in depId module name. */
+    prefix;
+    /** @type {string|undefined} Import target base for matched namespace. */
+    target;
+    /** @type {string|undefined} Default extension appended to matched module path. */
+    defaultExt;
+}
+
+/**
+ * Factory for resolver namespace DTO with optional immutability.
+ */
+export default class Factory {
+    /**
+     * Creates normalized resolver namespace DTO.
+     *
+     * @param {Partial<TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$>|Record<string, unknown>} [input] Source values.
+     * @param {{immutable?: boolean}|Record<string, unknown>} [options] Factory options.
+     * @returns {TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$}
+     */
+    create(input, options) {
+        /** @type {Partial<TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$>|Record<string, unknown>} */
+        const source = (input && (typeof input === 'object')) ? input : {};
+        /** @type {{immutable?: boolean}|Record<string, unknown>} */
+        const mode = (options && (typeof options === 'object')) ? options : {};
+
+        /** @type {TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$} */
+        const dto = new DTO();
+        dto.prefix = (typeof source.prefix === 'string') ? source.prefix : undefined;
+        dto.target = (typeof source.target === 'string') ? source.target : undefined;
+        dto.defaultExt = (typeof source.defaultExt === 'string') ? source.defaultExt : undefined;
+
+        if (mode.immutable === true) {
+            Object.freeze(dto);
+        }
+
+        return dto;
+    }
+}

package/src/Dto/Resolver/Config.mjs

@@ -0,0 +1,58 @@
+// @ts-check
+
+import TeqFw_Di_Dto_Resolver_Config_Namespace from './Config/Namespace.mjs';
+
+/**
+ * DTO and factory for resolver configuration records.
+ */
+
+/**
+ * Runtime DTO for resolver configuration.
+ */
+export class DTO {
+    /** @type {TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$[]} Namespace resolution rules. */
+    namespaces;
+    /** @type {string|undefined} Optional node_modules root prefix for npm modules. */
+    nodeModulesRoot;
+}
+
+/**
+ * Factory for resolver configuration DTO with optional immutability.
+ */
+export default class Factory {
+    /**
+     * Creates factory instance.
+     */
+    constructor() {
+        /** @type {TeqFw_Di_Dto_Resolver_Config_Namespace} Factory for namespace DTO records. */
+        const nsFactory = new TeqFw_Di_Dto_Resolver_Config_Namespace();
+
+        /**
+         * Creates normalized resolver configuration DTO.
+         *
+         * @param {Partial<TeqFw_Di_Dto_Resolver_Config$DTO>|Record<string, unknown>} [input] Source values.
+         * @param {{immutable?: boolean}|Record<string, unknown>} [options] Factory options.
+         * @returns {TeqFw_Di_Dto_Resolver_Config$DTO}
+         */
+        this.create = function (input, options) {
+            /** @type {Partial<TeqFw_Di_Dto_Resolver_Config$DTO>|Record<string, unknown>} */
+            const source = (input && (typeof input === 'object')) ? input : {};
+            /** @type {{immutable?: boolean}|Record<string, unknown>} */
+            const mode = (options && (typeof options === 'object')) ? options : {};
+
+            /** @type {TeqFw_Di_Dto_Resolver_Config$DTO} */
+            const dto = new DTO();
+            /** @type {unknown[]} */
+            const items = Array.isArray(source.namespaces) ? source.namespaces : [];
+            dto.namespaces = items.map((item) => nsFactory.create(item, mode));
+            dto.nodeModulesRoot = (typeof source.nodeModulesRoot === 'string') ? source.nodeModulesRoot : undefined;
+
+            if (mode.immutable === true) {
+                Object.freeze(dto.namespaces);
+                Object.freeze(dto);
+            }
+
+            return dto;
+        };
+    }
+}

package/src/Enum/Composition.mjs

@@ -0,0 +1,11 @@
+// @ts-check
+
+/**
+ * Composition mode enum used in dependency identity DTO.
+ */
+const TeqFw_Di_Enum_Composition = {
+    AS_IS: 'A',
+    FACTORY: 'F',
+};
+
+export default TeqFw_Di_Enum_Composition;

package/src/Enum/Life.mjs

@@ -0,0 +1,11 @@
+// @ts-check
+
+/**
+ * Lifecycle mode enum used in dependency identity DTO.
+ */
+const TeqFw_Di_Enum_Life = {
+    SINGLETON: 'S',
+    TRANSIENT: 'T',
+};
+
+export default TeqFw_Di_Enum_Life;

package/src/Enum/Platform.mjs

@@ -0,0 +1,12 @@
+// @ts-check
+
+/**
+ * Platform enum used to resolve module loading strategy.
+ */
+const TeqFw_Di_Enum_Platform = {
+    TEQ: 'teq',
+    NODE: 'node',
+    NPM: 'npm',
+};
+
+export default TeqFw_Di_Enum_Platform;

package/src/Internal/Logger.mjs

@@ -0,0 +1,54 @@
+// @ts-check
+
+/**
+ * Internal synchronous console logger.
+ *
+ * This module is internal infrastructure and must not be exposed as a public API.
+ */
+export default class TeqFw_Di_Internal_Logger {
+    /**
+     * @param {string} scope
+     */
+    constructor(scope = 'teqfw/di') {
+        /** @type {string} */
+        const prefix = `[${scope}]`;
+
+        /**
+         * @param {string} message
+         * @returns {void}
+         */
+        this.log = function (message) {
+            console.debug(`${prefix} ${message}`);
+        };
+
+        /**
+         * @param {string} message
+         * @param {unknown} [error]
+         * @returns {void}
+         */
+        this.error = function (message, error) {
+            console.error(`${prefix} ${message}`);
+            if (error instanceof Error) {
+                console.error(error.stack ?? error.message);
+                return;
+            }
+            if (error !== undefined) {
+                console.error(error);
+            }
+        };
+    }
+}
+
+/**
+ * No-op logger for disabled logging mode.
+ */
+export const TeqFw_Di_Internal_Logger_Noop = Object.freeze({
+    /**
+     * @returns {void}
+     */
+    log() {},
+    /**
+     * @returns {void}
+     */
+    error() {},
+});

package/types.d.ts

@@ -1,24 +1,61 @@
-type TeqFw_Di_Container_A_Composer = InstanceType<typeof import("./src/Container/A/Composer.js").default>;
-type TeqFw_Di_Container_A_Composer_A_SpecParser = import("./src/Container/A/Composer/A/SpecParser.js").default;
-type TeqFw_Di_Container_A_Parser_Chunk_Def = InstanceType<typeof import("./src/Container/A/Parser/Chunk/Def.js").default>;
-type TeqFw_Di_Container_A_Parser_Chunk_V02X = InstanceType<typeof import("./src/Container/A/Parser/Chunk/V02X.js").default>;
-type TeqFw_Di_Container_Parser = InstanceType<typeof import("./src/Container/Parser.js").default>;
-type TeqFw_Di_Container_PostProcessor = InstanceType<typeof import("./src/Container/PostProcessor.js").default>;
-type TeqFw_Di_Container_PreProcessor = InstanceType<typeof import("./src/Container/PreProcessor.js").default>;
-type TeqFw_Di_Container_Resolver = InstanceType<typeof import("./src/Container/Resolver.js").default>;
+type TeqFw_Di_Def_Parser = InstanceType<typeof import("./src/Def/Parser.mjs").default>;
+type TeqFw_Di_Config_NamespaceRegistry = InstanceType<typeof import("./src/Config/NamespaceRegistry.mjs").default>;
+export type TeqFw_Di_Container = InstanceType<typeof import("./src/Container.mjs").default>;
+export type TeqFw_Di_Container_Instantiate_ExportSelector = InstanceType<
+  typeof import("./src/Container/Instantiate/ExportSelector.mjs").default
+>;
+export type TeqFw_Di_Container_Instantiate_Instantiator = InstanceType<
+  typeof import("./src/Container/Instantiate/Instantiator.mjs").default
+>;
+export type TeqFw_Di_Container_Lifecycle_Registry = InstanceType<
+  typeof import("./src/Container/Lifecycle/Registry.mjs").default
+>;
+export type TeqFw_Di_Container_Resolve_GraphResolver = InstanceType<
+  typeof import("./src/Container/Resolve/GraphResolver.mjs").default
+>;
+export type TeqFw_Di_Container_Wrapper_Executor = InstanceType<
+  typeof import("./src/Container/Wrapper/Executor.mjs").default
+>;
+type TeqFw_Di_DepId = InstanceType<typeof import("./src/Dto/DepId.mjs").default>;
+type TeqFw_Di_Dto_Resolver_Config = InstanceType<typeof import("./src/Dto/Resolver/Config.mjs").default>;
+type TeqFw_Di_Dto_Resolver_Config_Namespace = InstanceType<
+  typeof import("./src/Dto/Resolver/Config/Namespace.mjs").default
+>;
+type TeqFw_Di_Resolver = InstanceType<typeof import("./src/Container/Resolver.mjs").default>;
 
-declare global {
-  type TeqFw_Di_Api_Container_Parser = InstanceType<typeof import("./src/Api/Container/Parser.js").default>;
-  type TeqFw_Di_Api_Container_Parser_Chunk = InstanceType<typeof import("./src/Api/Container/Parser/Chunk.js").default>;
-  type TeqFw_Di_Api_Container_PostProcessor = InstanceType<typeof import("./src/Api/Container/PostProcessor.js").default>;
-  type TeqFw_Di_Api_Container_PostProcessor_Chunk = InstanceType<typeof import("./src/Api/Container/PostProcessor/Chunk.js").default>;
-  type TeqFw_Di_Api_Container_PreProcessor = InstanceType<typeof import("./src/Api/Container/PreProcessor.js").default>;
-  type TeqFw_Di_Api_Container_PreProcessor_Chunk = InstanceType<typeof import("./src/Api/Container/PreProcessor/Chunk.js").default>;
-  type TeqFw_Di_Api_Container_Resolver = InstanceType<typeof import("./src/Api/Container/Resolver.js").default>;
-  type TeqFw_Di_Container = InstanceType<typeof import("./src/Container.js").default>;
-  type TeqFw_Di_Defs = import("./src/Defs.js").default;
-  type TeqFw_Di_DepId = InstanceType<typeof import("./src/DepId.js").default>;
-  type TeqFw_Di_Pre_Replace = InstanceType<typeof import("./src/Pre/Replace.js").default>;
-}
+export type TeqFw_Di_DepId$DTO = typeof import("./src/Dto/DepId.mjs").DTO;
+export type TeqFw_Di_DepId$DTO$ = InstanceType<TeqFw_Di_DepId$DTO>;
+export type TeqFw_Di_Dto_Resolver_Config$DTO = typeof import("./src/Dto/Resolver/Config.mjs").DTO;
+export type TeqFw_Di_Dto_Resolver_Config$DTO$ = InstanceType<TeqFw_Di_Dto_Resolver_Config$DTO>;
+export type TeqFw_Di_Dto_Resolver_Config_Namespace$DTO = typeof import("./src/Dto/Resolver/Config/Namespace.mjs").DTO;
+export type TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$ = InstanceType<TeqFw_Di_Dto_Resolver_Config_Namespace$DTO>;
 
 export {};
+
+declare global {
+  type TeqFw_Di_Container = InstanceType<typeof import("./src/Container.mjs").default>;
+  type TeqFw_Di_Config_NamespaceRegistry = InstanceType<typeof import("./src/Config/NamespaceRegistry.mjs").default>;
+  type TeqFw_Di_Def_Parser = InstanceType<typeof import("./src/Def/Parser.mjs").default>;
+  type TeqFw_Di_DepId = InstanceType<typeof import("./src/Dto/DepId.mjs").default>;
+  type TeqFw_Di_DepId$DTO = import("./src/Dto/DepId.mjs").DTO;
+  type TeqFw_Di_Dto_Resolver_Config = InstanceType<typeof import("./src/Dto/Resolver/Config.mjs").default>;
+  type TeqFw_Di_Dto_Resolver_Config$DTO = import("./src/Dto/Resolver/Config.mjs").DTO;
+  type TeqFw_Di_Dto_Resolver_Config_Namespace = InstanceType<
+    typeof import("./src/Dto/Resolver/Config/Namespace.mjs").default
+  >;
+  type TeqFw_Di_Dto_Resolver_Config_Namespace$DTO = typeof import("./src/Dto/Resolver/Config/Namespace.mjs").DTO;
+  type TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$ = InstanceType<TeqFw_Di_Dto_Resolver_Config_Namespace$DTO>;
+  type TeqFw_Di_Enum_Composition = typeof import("./src/Enum/Composition.mjs").default;
+  type TeqFw_Di_Enum_Life = typeof import("./src/Enum/Life.mjs").default;
+  type TeqFw_Di_Enum_Platform = typeof import("./src/Enum/Platform.mjs").default;
+  type TeqFw_Di_Container_Resolve_GraphResolver = InstanceType<
+    typeof import("./src/Container/Resolve/GraphResolver.mjs").default
+  >;
+  type TeqFw_Di_Container_Lifecycle_Registry = InstanceType<
+    typeof import("./src/Container/Lifecycle/Registry.mjs").default
+  >;
+  type TeqFw_Di_Container_Wrapper_Executor = InstanceType<
+    typeof import("./src/Container/Wrapper/Executor.mjs").default
+  >;
+  type TeqFw_Di_Resolver = InstanceType<typeof import("./src/Container/Resolver.mjs").default>;
+}

package/src/Api/Container/Parser/Chunk.js

@@ -1,23 +0,0 @@
-/**
- * Interface for one chunk of the runtime dependency ID parser.
- *
- * This is not executable code, it is just for documentation purposes (similar to .h files in the C/C++ language).
- * @interface
- */
-export default class TeqFw_Di_Api_Container_Parser_Chunk {
-
-    /**
-     * Returns 'true' if this chunk can parse the given dependency ID.
-     *
-     * @param {string} depId
-     * @returns {boolean}
-     */
-    canParse(depId) {};
-
-    /**
-     * Parses a string ID for a runtime dependency and returns structured data (DTO).
-     * @param {string} depId
-     * @returns {TeqFw_Di_DepId}
-     */
-    parse(depId) {}
-};

package/src/Api/Container/Parser.js

@@ -1,28 +0,0 @@
-/**
- * Interface for the parser of the runtime dependency ID.
- *
- * This is not executable code, it is just for documentation purposes (similar to .h files in the C/C++ language).
- * @interface
- */
-export default class TeqFw_Di_Api_Container_Parser {
-    /**
-     * Adds the given chunk to the parser.
-     *
-     * @param {TeqFw_Di_Api_Container_Parser_Chunk} chunk
-     */
-    addChunk(chunk) {}
-
-    /**
-     * Parse given dependency ID and return structured data as DTO.
-     * @param {string} depId
-     * @returns {TeqFw_Di_DepId}
-     */
-    parse(depId) {}
-
-    /**
-     * Sets the default chunk of the parser.
-     *
-     * @param {TeqFw_Di_Api_Container_Parser_Chunk} chunk
-     */
-    setDefaultChunk(chunk) {}
-}

package/src/Api/Container/PostProcessor/Chunk.js

@@ -1,17 +0,0 @@
-/**
- * Interface for one chunk of the post-processor that modifies result.
- *
- * This is not executable code, it is just for documentation purposes (similar to .h files in the C/C++ language).
- * @interface
- */
-export default class TeqFw_Di_Api_Container_PostProcessor_Chunk {
-
-    /**
-     * Modify result before returning to the caller.
-     * @param {*} obj - created object
-     * @param {TeqFw_Di_DepId} originalId - original `depId` DTO
-     * @param {string[]} stack - stack of parents depIds
-     * @returns {*} modified object
-     */
-    modify(obj, originalId, stack) {}
-};

package/src/Api/Container/PostProcessor.js

@@ -1,25 +0,0 @@
-/**
- * Interface for the post-processor of the result object.
- *
- * This is not executable code, it is just for documentation purposes (similar to .h files in the C/C++ language).
- * @interface
- */
-export default class TeqFw_Di_Api_Container_PostProcessor {
-    /**
-     * Adds the given chunk to the parser.
-     *
-     * @param {TeqFw_Di_Api_Container_PostProcessor_Chunk} chunk
-     */
-    addChunk(chunk) {}
-
-    /**
-     * Modifies the result of the object composition.
-     *
-     * @param {*} obj - The result object to be modified.
-     * @param {TeqFw_Di_DepId} depId - The original depID DTO.
-     * @param {string[]} - The stack of parent IDs.
-     * @returns {Promise<*>}
-     */
-    modify(obj, depId, stack) {}
-
-}

package/src/Api/Container/PreProcessor/Chunk.js

@@ -1,17 +0,0 @@
-/**
- * Interface for one chunk of the pre-processor that modify initial `depId`.
- *
- * This is not executable code, it is just for documentation purposes (similar to .h files in the C/C++ language).
- * @interface
- */
-export default class TeqFw_Di_Api_Container_PreProcessor_Chunk {
-
-    /**
-     * Modify runtime dependency ID before creating any object.
-     * @param {TeqFw_Di_DepId} depId - `depId` DTO after all previous pre-processing steps
-     * @param {TeqFw_Di_DepId} originalId - original `depId` DTO
-     * @param {string[]} stack - stack of parents depIds
-     * @returns {TeqFw_Di_DepId}
-     */
-    modify(depId, originalId, stack) {}
-};

package/src/Api/Container/PreProcessor.js

@@ -1,23 +0,0 @@
-/**
- * Interface for the pre-processor of the runtime dependency ID.
- *
- * This is not executable code, it is just for documentation purposes (similar to .h files in the C/C++ language).
- * @interface
- */
-export default class TeqFw_Di_Api_Container_PreProcessor {
-    /**
-     * Adds the given chunk to the parser.
-     *
-     * @param {TeqFw_Di_Api_Container_PreProcessor_Chunk} chunk
-     */
-    addChunk(chunk) {}
-
-    /**
-     * Modify parsed depID and return it.
-     * @param {TeqFw_Di_DepId} depId - The depID as DTO.
-     * @param {string[]} stack - The stack of parent IDs.
-     * @returns {TeqFw_Di_DepId} -
-     */
-    modify(depId, stack) {}
-
-}

package/src/Api/Container/Resolver.js

@@ -1,16 +0,0 @@
-/**
- * Interface for the resolver to map a module name of the dependency ID into the path to the sources.
- *
- * This is not executable code, it is just for documentation purposes (similar to .h files in the C/C++ language).
- * @interface
- */
-export default class TeqFw_Di_Api_Container_Resolver {
-
-    /**
-     * Convert the module name to the path of the source files .
-     * @param {string} moduleName 'Vendor_Package_Module'
-     * @returns {string} '/home/user/app/node_modules/@vendor/package/src/Module.js'
-     */
-    resolve(moduleName) {}
-
-}

package/src/Container/A/Composer/A/SpecParser.js

@@ -1,86 +0,0 @@
-/**
- * This function analyses specification of dependencies extracted from the text definition of the function itself.
- *
- * This is a local module and is used only inside the `TeqFw_Di_Container_A_Composer` space.
- *
- * @namespace TeqFw_Di_Container_A_Composer_A_SpecParser
- */
-import Defs from '../../../../Defs.js';
-
-// VARS
-const FUNC = /(function)*\s*\w*\s*\(\s*\{([^}]*)}/s;
-const CLASS = /constructor\s*\(\s*\{([^}]*)}/s;
-
-// FUNCS
-
-/**
- * Internal function to analyze extracted parameters.
- *
- * @param {string} params
- * @returns {string[]}
- * @private
- */
-function _analyze(params) {
-    const res = [];
-    // create wrapper for arguments and collect dependencies using Proxy
-    try {
-        const fn = new Function(`{${params}}`, 'return');
-        const spec = new Proxy({}, {
-            get: (target, prop) => res.push(prop),
-        });
-        // run wrapper and return dependencies
-        fn(spec);
-    } catch (e) {
-        const msg = `Cannot analyze the deps specification:${params}\n`
-            + '\nPlease, be sure that spec does not contain extra \')\' in a comments.'
-            + `\n\nError: ${e}`;
-        throw new Error(msg);
-    }
-    return res;
-}
-
-/**
- * @param {Function|Object} exp
- * @returns {string[]}
- */
-function _analyzeClass(exp) {
-    const res = [];
-    // extract arguments from constructor
-    const def = exp.toString();
-    const parts = CLASS.exec(def);
-    if (parts) {
-        res.push(..._analyze(parts[1]));
-    } // else: constructor does not have arguments
-    return res;
-}
-
-/**
- * @param {Function|Object} exp
- * @returns {string[]}
- */
-function _analyzeFunc(exp) {
-    const res = [];
-    // extract arguments from factory function
-    const def = exp.toString();
-    const parts = FUNC.exec(def);
-    if (parts) {
-        res.push(..._analyze(parts[2]));
-    } // else: constructor does not have arguments
-    return res;
-}
-
-// MAIN
-/**
- * @param {Function|Object} exp
- * @returns {string[]}
- */
-export default function (exp) {
-    if (typeof exp === 'function') {
-        if (Defs.isClass(exp)) {
-            return _analyzeClass(exp);
-        } else {
-            return _analyzeFunc(exp);
-        }
-    } else
-        return [];
-}

package/src/Container/A/Composer.js

@@ -1,69 +0,0 @@
-/**
- * The composer creates requested objects. It uses the container to create dependencies.
- *
- * @namespace TeqFw_Di_Container_A_Composer
- */
-import Defs from '../../Defs.js';
-import specParser from './Composer/A/SpecParser.js';
-
-export default class TeqFw_Di_Container_A_Composer {
-
-    constructor() {
-        // VARS
-        let _debug = false;
-
-        // FUNCS
-        function log(msg) {
-            if (_debug) console.log(msg);
-        }
-
-        // INSTANCE METHODS
-
-        /**
-         * Returns or creates and returns the requested object.
-         *
-         * @param {TeqFw_Di_DepId} depId
-         * @param {object} module - imported es6 module
-         * @param {string[]} stack - array of the parent objects IDs to prevent dependency loop
-         * @param {TeqFw_Di_Container} container - to create dependencies for requested object
-         * @returns {Promise<*>}
-         */
-        this.create = async function (depId, module, stack, container) {
-            if (stack.includes(depId.origin))
-                throw new Error(`Circular dependency for '${depId.origin}'. Parents are: ${JSON.stringify(stack)}`);
-            if (depId.exportName) {
-                // use export from the es6-module
-                const stackNew = [...stack, depId.origin];
-                const {[depId.exportName]: exp} = module;
-                if (depId.composition === Defs.CF) {
-                    if (typeof exp === 'function') {
-                        // create deps for factory function
-                        const deps = specParser(exp);
-                        if (deps.length) log(`Deps for object '${depId.origin}' are: ${JSON.stringify(deps)}`);
-                        const spec = {};
-                        for (const dep of deps)
-                            spec[dep] = await container.get(dep, stackNew);
-                        // create a new object with the factory function
-                        const res = (Defs.isClass(exp)) ? new exp(spec) : exp(spec);
-                        if (res instanceof Promise)
-                            return await res;
-                        else
-                            return res;
-                    } else
-                        // just clone the export
-                        return Object.assign({}, exp);
-                } else
-                    // just return the export (w/o factory function)
-                    return exp;
-            } else {
-                return module;
-            }
-        };
-
-        this.setDebug = function (data) {
-            _debug = data;
-        };
-
-        // MAIN
-    }
-};

package/src/Container/A/Parser/Chunk/Def.js

@@ -1,69 +0,0 @@
-/**
- * Default parser for object keys in format:
- *   - Ns_Module.export$$(post)
- *   - node:package.export$$(post)
- *   - node:@scope/package.export$$(post)
- *
- * @namespace TeqFw_Di_Container_A_Parser_Chunk_Def
- */
-import Dto from '../../../../DepId.js';
-import Defs from '../../../../Defs.js';
-
-// VARS
-/** @type {RegExp} expression for a default object key */
-const REGEXP = /^(node:)?(@?[A-Za-z0-9_-]+\/?[A-Za-z0-9_-]*)(([.#])?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?$/;
-
-/**
- * @implements TeqFw_Di_Api_Container_Parser_Chunk
- */
-export default class TeqFw_Di_Container_A_Parser_Chunk_Def {
-
-    canParse() {
-        // the default parser always tries to parse the depId
-        return true;
-    }
-
-    parse(objectKey) {
-        const res = new Dto();
-        res.origin = objectKey;
-        const parts = REGEXP.exec(objectKey);
-        if (parts) {
-            res.isNodeModule = Boolean(parts[1]); // Detect 'node:' prefix
-            res.moduleName = parts[2].replace(/^node:/, ''); // Remove 'node:' prefix
-
-            if ((parts[4] === '.') || (parts[4] === '#')) {
-                // Ns_Module.export or node:package.export
-                if ((parts[6] === '$') || (parts[6] === '$$')) {
-                    res.composition = Defs.CF;
-                    res.exportName = parts[5];
-                    res.life = (parts[6] === '$') ? Defs.LS : Defs.LI;
-                } else {
-                    res.composition = Defs.CA;
-                    res.life = Defs.LS;
-                    res.exportName = (parts[5] !== '') ? parts[5] : 'default';
-                }
-            } else if ((parts[6] === '$') || parts[6] === '$$') {
-                // Ns_Module$$ or node:package$$
-                res.composition = Defs.CF;
-                res.exportName = 'default';
-                res.life = (parts[6] === '$') ? Defs.LS : Defs.LI;
-            } else {
-                // Ns_Module or node:package (ES6 module)
-                res.composition = undefined;
-                res.exportName = undefined;
-                res.life = undefined;
-            }
-
-            // Wrappers handling
-            if (parts[10]) {
-                res.wrappers = parts[10].split(',');
-            }
-        }
-
-        // Ensure singletons for non-factory exports
-        if ((res.composition === Defs.CA) && (res.life === Defs.LI))
-            throw new Error(`Export is not a function and should be used as a singleton only: '${res.origin}'.`);
-
-        return res;
-    }
-}