@teqfw/di 2.0.3 → 2.0.5

package/src/Container.mjs

@@ -1,7 +1,7 @@
 // @ts-check
 
 import TeqFw_Di_Def_Parser from './Def/Parser.mjs';
-import TeqFw_Di_Dto_Resolver_Config from './Dto/Resolver/Config.mjs';
+import {Factory as TeqFw_Di_Dto_Resolver_Config_Factory} from './Dto/Resolver/Config.mjs';
 import TeqFw_Di_Resolver from './Container/Resolver.mjs';
 import TeqFw_Di_Container_Resolve_GraphResolver from './Container/Resolve/GraphResolver.mjs';
 import TeqFw_Di_Container_Instantiate_Instantiator from './Container/Instantiate/Instantiator.mjs';
@@ -19,6 +19,9 @@ import TeqFw_Di_Internal_Logger, {TeqFw_Di_Internal_Logger_Noop} from './Interna
  * Executes immutable linking pipeline:
  * parse -> preprocess -> resolve graph -> instantiate -> postprocess ->
  * lifecycle -> freeze -> return.
+ *
+ * @LLM-DOC
+ * Spec: ./ctx/docs/code/components/container.md
  */
 export default class TeqFw_Di_Container {
     /**
@@ -31,7 +34,7 @@ export default class TeqFw_Di_Container {
         const preprocess = [];
         /** @type {((value: unknown) => unknown)[]} */
         const postprocess = [];
-        /** @type {TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$[]} */
+        /** @type {TeqFw_Di_Dto_Resolver_Config_Namespace$DTO[]} */
         const namespaceRoots = [];
         /** @type {Map<string, unknown>} */
         const mockRegistry = new Map();
@@ -40,8 +43,8 @@ export default class TeqFw_Di_Container {
 
         /** @type {TeqFw_Di_Def_Parser} */
         let parser = new TeqFw_Di_Def_Parser();
-        /** @type {TeqFw_Di_Dto_Resolver_Config} */
-        const configFactory = new TeqFw_Di_Dto_Resolver_Config();
+        /** @type {TeqFw_Di_Dto_Resolver_Config$Factory} */
+        const configFactory = new TeqFw_Di_Dto_Resolver_Config_Factory();
         /** @type {TeqFw_Di_Resolver|undefined} */
         let resolver;
         /** @type {TeqFw_Di_Container_Resolve_GraphResolver|undefined} */
@@ -169,7 +172,7 @@ export default class TeqFw_Di_Container {
             state = 'operational';
             const resolverConfig = configFactory.create({
                 namespaces: namespaceRoots,
-            }, {immutable: true});
+            });
             if (typeof parser.setLogger === 'function') parser.setLogger(logger);
             resolver = new TeqFw_Di_Resolver({config: resolverConfig, logger});
             graphResolver = new TeqFw_Di_Container_Resolve_GraphResolver({parser, resolver, logger});
@@ -271,7 +274,7 @@ export default class TeqFw_Di_Container {
          * Resolves dependency by CDC and returns frozen linked value.
          *
          * @param {string} cdc
-         * @returns {Promise<unknown>}
+         * @returns {Promise<any>}
          */
         this.get = async function (cdc) {
             if (state === 'failed') {

package/src/Def/Parser.mjs

@@ -3,23 +3,23 @@
 import TeqFw_Di_Enum_Composition from '../Enum/Composition.mjs';
 import TeqFw_Di_Enum_Life from '../Enum/Life.mjs';
 import TeqFw_Di_Enum_Platform from '../Enum/Platform.mjs';
-import TeqFw_Di_Dto_DepId from '../Dto/DepId.mjs';
+import {Factory as TeqFw_Di_Dto_DepId_Factory} from '../Dto/DepId.mjs';
 
 /**
- * Parser for CDC identifiers into immutable dependency identity DTO.
- */
+ * Parser for CDC identifiers into frozen dependency identity DTO.
+*/
 export default class TeqFw_Di_Def_Parser {
     /**
      * Creates parser instance.
      */
     constructor() {
-        /** @type {TeqFw_Di_DepId} Factory used to construct dependency identity DTO. */
-        const depIdFactory = new TeqFw_Di_Dto_DepId();
+        /** @type {TeqFw_Di_Dto_DepId$Factory} Factory used to construct dependency identity DTO. */
+        const depIdFactory = new TeqFw_Di_Dto_DepId_Factory();
         /** @type {{log(message: string): void}|null} */
         let logger = null;
 
         /**
-         * Parses one CDC identifier and returns normalized immutable dependency DTO.
+         * Parses one CDC identifier and returns normalized frozen dependency DTO.
          *
          * @param {string} cdc CDC identifier string.
          * @returns {TeqFw_Di_DepId$DTO}
@@ -128,7 +128,7 @@ export default class TeqFw_Di_Def_Parser {
                 life,
                 wrappers,
                 origin,
-            }, {immutable: true});
+            });
             if (logger) logger.log(`Parser.parse: produced='${depId.platform}::${depId.moduleName}'.`);
             return depId;
         };

package/src/Dto/DepId.mjs

@@ -5,7 +5,7 @@ import TeqFw_Di_Enum_Life from '../Enum/Life.mjs';
 import TeqFw_Di_Enum_Platform from '../Enum/Platform.mjs';
 
 /**
- * DTO and factory for dependency identity records.
+ * DTO for dependency identity records and its factory.
  */
 
 /** @type {typeof TeqFw_Di_Enum_Platform[keyof typeof TeqFw_Di_Enum_Platform]} */
@@ -23,7 +23,7 @@ const LIFE_VALUES = new Set(Object.values(TeqFw_Di_Enum_Life));
 /**
  * Runtime DTO for parsed dependency identity.
  */
-export class DTO {
+export default class DTO {
     /** @type {string} Resolved module namespace. */
     moduleName;
 
@@ -47,17 +47,16 @@ export class DTO {
 }
 
 /**
- * Factory for dependency identity DTO with optional immutability.
+ * Factory for immutable dependency identity DTO.
  */
-export default class Factory {
+export class Factory {
     /**
-     * Creates normalized dependency identity DTO.
+     * Creates normalized frozen dependency identity DTO.
      *
      * @param {unknown} [input]
-     * @param {{immutable?: boolean}} [options]
      * @returns {TeqFw_Di_DepId$DTO}
      */
-    create(input, options) {
+    create(input) {
         /** @type {Record<string, unknown>} */
         const source = (input && typeof input === 'object')
             ? /** @type {Record<string, unknown>} */ (input)
@@ -121,11 +120,7 @@ export default class Factory {
                 ? source.origin
                 : '';
 
-        if (options?.immutable === true) {
-            Object.freeze(dto.wrappers);
-            Object.freeze(dto);
-        }
-
-        return dto;
+        Object.freeze(dto.wrappers);
+        return Object.freeze(dto);
     }
 }

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

@@ -1,48 +1,43 @@
 // @ts-check
 
 /**
- * DTO and factory for resolver namespace rule records.
+ * DTO for resolver namespace rule records and its factory.
  */
 
 /**
  * Runtime DTO for one namespace resolution rule.
  */
-export class DTO {
+export default 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.
+ * Factory for immutable resolver namespace DTO.
  */
-export default class Factory {
+export class Factory {
     /**
-     * Creates normalized resolver namespace DTO.
+     * Creates normalized frozen 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$}
+     * @param {Partial<TeqFw_Di_Dto_Resolver_Config_Namespace$DTO>|Record<string, unknown>} [input] Source values.
+     * @returns {TeqFw_Di_Dto_Resolver_Config_Namespace$DTO}
      */
-    create(input, options) {
-        /** @type {Partial<TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$>|Record<string, unknown>} */
+    create(input) {
+        /** @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$} */
+        /** @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;
+        return Object.freeze(dto);
     }
 }

package/src/Dto/Resolver/Config.mjs

@@ -1,58 +1,52 @@
 // @ts-check
 
-import TeqFw_Di_Dto_Resolver_Config_Namespace from './Config/Namespace.mjs';
+import {Factory as TeqFw_Di_Dto_Resolver_Config_Namespace_Factory} from './Config/Namespace.mjs';
 
 /**
- * DTO and factory for resolver configuration records.
+ * DTO for resolver configuration records and its factory.
  */
 
 /**
  * Runtime DTO for resolver configuration.
  */
-export class DTO {
-    /** @type {TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$[]} Namespace resolution rules. */
+export default 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.
+ * Factory for immutable resolver configuration DTO.
  */
-export default class Factory {
+export 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();
+        /** @type {TeqFw_Di_Dto_Resolver_Config_Namespace_Factory} */
+        const nsFactory = new TeqFw_Di_Dto_Resolver_Config_Namespace_Factory();
 
         /**
-         * Creates normalized resolver configuration DTO.
+         * Creates normalized frozen 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) {
+        this.create = function (input) {
             /** @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.namespaces = items.map((item) => nsFactory.create(item));
             dto.nodeModulesRoot = (typeof source.nodeModulesRoot === 'string') ? source.nodeModulesRoot : undefined;
 
-            if (mode.immutable === true) {
-                Object.freeze(dto.namespaces);
-                Object.freeze(dto);
-            }
-
-            return dto;
+            Object.freeze(dto.namespaces);
+            return Object.freeze(dto);
         };
     }
 }

package/src/Enum/Composition.mjs

@@ -8,4 +8,4 @@ const TeqFw_Di_Enum_Composition = {
     FACTORY: 'F',
 };
 
-export default TeqFw_Di_Enum_Composition;
+export default Object.freeze(TeqFw_Di_Enum_Composition);

package/src/Enum/Life.mjs

@@ -8,4 +8,4 @@ const TeqFw_Di_Enum_Life = {
     TRANSIENT: 'T',
 };
 
-export default TeqFw_Di_Enum_Life;
+export default Object.freeze(TeqFw_Di_Enum_Life);

package/src/Enum/Platform.mjs

@@ -9,4 +9,4 @@ const TeqFw_Di_Enum_Platform = {
     NPM: 'npm',
 };
 
-export default TeqFw_Di_Enum_Platform;
+export default Object.freeze(TeqFw_Di_Enum_Platform);

package/types.d.ts

@@ -8,14 +8,17 @@ declare global {
   type TeqFw_Di_Container_Wrapper_Executor = import("./src/Container/Wrapper/Executor.mjs").default;
   type TeqFw_Di_Def_Parser = import("./src/Def/Parser.mjs").default;
   type TeqFw_Di_DepId = import("./src/Dto/DepId.mjs").default;
-  type TeqFw_Di_DepId$DTO = import("./src/Dto/DepId.mjs").DTO;
+  type TeqFw_Di_DepId$DTO = import("./src/Dto/DepId.mjs").default;
+  type TeqFw_Di_DepId$Factory = InstanceType<typeof import("./src/Dto/DepId.mjs").Factory>;
   type TeqFw_Di_Dto_DepId = import("./src/Dto/DepId.mjs").default;
-  type TeqFw_Di_Dto_DepId$DTO = import("./src/Dto/DepId.mjs").DTO;
+  type TeqFw_Di_Dto_DepId$DTO = import("./src/Dto/DepId.mjs").default;
+  type TeqFw_Di_Dto_DepId$Factory = InstanceType<typeof import("./src/Dto/DepId.mjs").Factory>;
   type TeqFw_Di_Dto_Resolver_Config = 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$DTO = import("./src/Dto/Resolver/Config.mjs").default;
+  type TeqFw_Di_Dto_Resolver_Config$Factory = InstanceType<typeof import("./src/Dto/Resolver/Config.mjs").Factory>;
   type TeqFw_Di_Dto_Resolver_Config_Namespace = import("./src/Dto/Resolver/Config/Namespace.mjs").default;
-  type TeqFw_Di_Dto_Resolver_Config_Namespace$DTO = import("./src/Dto/Resolver/Config/Namespace.mjs").DTO;
-  type TeqFw_Di_Dto_Resolver_Config_Namespace$DTO$ = import("./src/Dto/Resolver/Config/Namespace.mjs").DTO;
+  type TeqFw_Di_Dto_Resolver_Config_Namespace$DTO = import("./src/Dto/Resolver/Config/Namespace.mjs").default;
+  type TeqFw_Di_Dto_Resolver_Config_Namespace$Factory = InstanceType<typeof import("./src/Dto/Resolver/Config/Namespace.mjs").Factory>;
   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;

package/jsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "checkJs": true,
-    "forceConsistentCasingInFileNames": true,
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "noEmit": true,
-    "skipLibCheck": true,
-    "target": "ESNext"
-  },
-  "include": ["src", "test", "types.d.ts"]
-}