@breadstone-infrastructure/utilities 0.0.12-beta.0

package/Cli/ProgramCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramCommands.d.ts","sourceRoot":"","sources":["../../src/Cli/ProgramCommands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAsBnE;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAIpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA+B;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,YAAY,CAA4B;IAMhD;;;;OAIG;gBACgB,IAAI,CAAC,EAAE,YAAY;IAqBtC;;;;;;;OAOG;IACI,QAAQ,CAAC,QAAQ,SAAS,KAAK,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,sBAAsB,CAAC,EAAE,MAAM,qBAAqB,CAAC,QAAQ,CAAC,GAAG,IAAI;IAU1K;;;;;OAKG;IAEU,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvD;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IA+B1D;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAarD;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC,OAAO,CAAC,aAAa;CAaxB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAkBpF"}

package/Cli/ProgramCommands.js

@@ -0,0 +1,173 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgramCommands = void 0;
+exports.convertKeysToCamelCase = convertKeysToCamelCase;
+const argparse_1 = require("argparse");
+/**
+ * @private
+ */
+class ProgramCommands {
+    // #region Fields
+    _commandTypes;
+    _commandInstances;
+    _parser;
+    _currentCommand;
+    _currentArgs;
+    // #endregion
+    // #region Ctor
+    /**
+     * Constructs a new instance of the `ProgramCommands` class.
+     *
+     * @public
+     */
+    constructor(init) {
+        this._commandTypes = [];
+        this._commandInstances = [];
+        this._parser = new argparse_1.ArgumentParser({
+            description: init?.description,
+            epilog: init?.epilog,
+            // eslint-disable-next-line camelcase
+            add_help: init?.addHelp,
+            // eslint-disable-next-line camelcase
+            prefix_chars: init?.prefixChars ?? '-',
+            prog: init?.prog,
+            usage: init?.usage
+        });
+        this._currentCommand = null;
+        this._currentArgs = null;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Register a command.
+     *
+     * @public
+     * @param commandName - The command name.
+     * @param commandType - The command type to register.
+     * @param commandInstanceFactory - The optional factory to instaiate the command.
+     */
+    register(commandName, commandType, commandInstanceFactory) {
+        this._commandTypes.push({
+            name: commandName,
+            type: commandType,
+            factory: commandInstanceFactory ?? (() => [])
+        });
+        return this;
+    }
+    /**
+     * Initalize a command.
+     *
+     * @public
+     * @param command - The optional command to parse.
+     */
+    async initalize(command) {
+        command ??= this.ensureCommand();
+        const entry = this._commandTypes.find((x) => x.name === command);
+        if (entry) {
+            const args = entry.factory();
+            const instance = new entry.type(...args);
+            await instance.initalize();
+            this._commandInstances.push({
+                type: entry.type,
+                instance: instance,
+                config: args[0]
+            });
+        }
+    }
+    /**
+     * Parse the command from argv.
+     *
+     * @public
+     * @param command - The optional command to parse.
+     * @param args - The optional arguments to parse.
+     */
+    parse(command, args) {
+        const allArgs = process.argv.slice(2);
+        command ??= allArgs.splice(0, 1).join();
+        args ??= allArgs.splice(0, process.argv.length);
+        if (command.startsWith('-')) {
+            throw new Error('The command is missing or invalid.');
+        }
+        const entry = this._commandInstances.find((x) => x.instance.name === command);
+        if (entry) {
+            this._currentCommand = command;
+            this._currentArgs = entry.instance.args ?? [];
+            this._currentArgs.forEach((x) => {
+                if (typeof x.alias === 'string') {
+                    this._parser.add_argument(x.alias, x.options);
+                }
+                else {
+                    this._parser.add_argument(x.alias[0], x.alias[1], x.options);
+                }
+            });
+            // why we need to convert keys to camel case? because argparse sucks and uses snake_case.
+            const parserArgs = convertKeysToCamelCase(this._parser.parse_args(args));
+            entry.instance.configure(parserArgs);
+            return;
+        }
+        throw new CommandNotFoundError(command, this._commandTypes.map((x) => x.name));
+    }
+    /**
+     * Execute a command.
+     *
+     * @public
+     */
+    async execute() {
+        const entry = this._commandInstances.find((x) => x.instance.name === this._currentCommand);
+        if (entry) {
+            return entry.instance.execute();
+        }
+        return {
+            canceled: true,
+            error: new CommandNotFoundError(this._currentCommand ?? '', this._commandTypes.map((x) => x.name))
+        };
+    }
+    /**
+     * Dispose a command.
+     *
+     * @public
+     */
+    async dispose() {
+        for (const entry of this._commandInstances) {
+            // eslint-disable-next-line no-await-in-loop
+            await entry.instance.dispose();
+        }
+    }
+    ensureCommand() {
+        const args = process.argv.slice(2);
+        const command = args.splice(0, 1).join();
+        if (command.startsWith('-')) {
+            throw new Error('The command is missing or invalid.');
+        }
+        return command;
+    }
+}
+exports.ProgramCommands = ProgramCommands;
+/**
+ * Converts object keys from snake_case to camelCase.
+ *
+ * @param obj - The object to be converted.
+ * @returns A new object with camelCase keys.
+ */
+function convertKeysToCamelCase(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map((item) => typeof item === 'object' && item !== null ? convertKeysToCamelCase(item) : item);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (typeof obj === 'object' && obj !== null) {
+        const newObject = {};
+        for (const [key, value] of Object.entries(obj)) {
+            const camelCaseKey = key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+            newObject[camelCaseKey] = typeof value === 'object' && value !== null ? convertKeysToCamelCase(value) : value;
+        }
+        return newObject;
+    }
+    return obj;
+}
+class CommandNotFoundError extends Error {
+    constructor(command, commands) {
+        super(`The command '${command}' was not found. Available commands: ${commands.join(', ')}`);
+    }
+}
+//# sourceMappingURL=ProgramCommands.js.map

package/Cli/ProgramCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramCommands.js","sourceRoot":"","sources":["../../src/Cli/ProgramCommands.ts"],"names":[],"mappings":"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"}

package/Cli/ProgramConfig.d.ts

@@ -0,0 +1,24 @@
+import type { IProgramConfig } from './Interfaces/IProgramConfig';
+/**
+ * The program configuration.
+ *
+ * @private
+ */
+export declare class ProgramConfig<TConfig extends Record<string, unknown>> implements IProgramConfig<TConfig> {
+    private readonly _config;
+    /**
+     * Constructs a new instance of the `ProgramConfig` class.
+     *
+     * @public
+     */
+    constructor();
+    /**
+     * Returns the configuration.
+     *
+     * @public
+     * @readonly
+     */
+    get config(): TConfig;
+    assign(value?: Partial<TConfig>): TConfig;
+}
+//# sourceMappingURL=ProgramConfig.d.ts.map

package/Cli/ProgramConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramConfig.d.ts","sourceRoot":"","sources":["../../src/Cli/ProgramConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE;;;;GAIG;AACH,qBAAa,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,YAAW,cAAc,CAAC,OAAO,CAAC;IAIlG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAMlC;;;;OAIG;;IASH;;;;;OAKG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAMM,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;CAenD"}

package/Cli/ProgramConfig.js

@@ -0,0 +1,51 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgramConfig = void 0;
+const String_1 = require("../System/String");
+// #endregion
+/**
+ * The program configuration.
+ *
+ * @private
+ */
+class ProgramConfig {
+    // #region Fields
+    _config;
+    // #endregion
+    // #region Ctor
+    /**
+     * Constructs a new instance of the `ProgramConfig` class.
+     *
+     * @public
+     */
+    constructor() {
+        this._config = Object.create({});
+    }
+    // #endregion
+    // #region Properties
+    /**
+     * Returns the configuration.
+     *
+     * @public
+     * @readonly
+     */
+    get config() {
+        return this._config;
+    }
+    // #endregion
+    // #region Methods
+    assign(value) {
+        if (value) {
+            Object.keys(value).forEach((key) => {
+                if (Object.keys(this._config).length > 0) {
+                    // @ts-ignore fix suppressImplicitAnyIndexErrors
+                    this._config[String_1.StringExtensions.firstCharToLowerCase(key)] = value[key];
+                }
+            });
+        }
+        return this._config;
+    }
+}
+exports.ProgramConfig = ProgramConfig;
+//# sourceMappingURL=ProgramConfig.js.map

package/Cli/ProgramConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramConfig.js","sourceRoot":"","sources":["../../src/Cli/ProgramConfig.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAElB,6CAAoD;AAGpD,aAAa;AAEb;;;;GAIG;AACH,MAAa,aAAa;IAEtB,iBAAiB;IAEA,OAAO,CAAU;IAElC,aAAa;IAEb,eAAe;IAEf;;;;OAIG;IACH;QACI,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB;;;;;OAKG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,aAAa;IAEb,kBAAkB;IAEX,MAAM,CAAC,KAAwB;QAClC,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvC,gDAAgD;oBAChD,IAAI,CAAC,OAAO,CAAC,yBAAgB,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC1E,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CAIJ;AApDD,sCAoDC"}

package/Cli/ProgramDoneFn.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @public
+ */
+export type ProgramDoneFn = (error: Error | null, stdout: string, stderr: string) => void;
+//# sourceMappingURL=ProgramDoneFn.d.ts.map

package/Cli/ProgramDoneFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramDoneFn.d.ts","sourceRoot":"","sources":["../../src/Cli/ProgramDoneFn.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC"}

package/Cli/ProgramDoneFn.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ProgramDoneFn.js.map

package/Cli/ProgramDoneFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramDoneFn.js","sourceRoot":"","sources":["../../src/Cli/ProgramDoneFn.ts"],"names":[],"mappings":""}

package/Compiler/TypeScript.d.ts

@@ -0,0 +1,19 @@
+import { type CompilerOptions, Project, type SourceFile } from 'ts-morph';
+/**
+ * TypeScript utility functions.
+ */
+export declare namespace TypeScript {
+    interface ICompileResult {
+        program: Project;
+        files: Array<SourceFile>;
+    }
+    /**
+     * Compiles an array of files or file using ts-morph.
+     *
+     * @public
+     * @param filePaths - The path(s) to the file(s).
+     * @param options - The compiler options.
+     */
+    function compile(filePaths: string | Array<string>, options?: CompilerOptions): ICompileResult;
+}
+//# sourceMappingURL=TypeScript.d.ts.map

package/Compiler/TypeScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScript.d.ts","sourceRoot":"","sources":["../../src/Compiler/TypeScript.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAc,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAwBpG;;GAEG;AACH,yBAAiB,UAAU,CAAC;IAExB,UAAiB,cAAc;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;KAC5B;IAUD;;;;;;OAMG;IACH,SAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAE,eAAgC,GAAG,cAAc,CAYpH;CA6KJ"}

package/Compiler/TypeScript.js

@@ -0,0 +1,166 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeScript = void 0;
+// Import { type Block, parse } from 'comment-parser';
+const ts_morph_1 = require("ts-morph");
+// #endregion
+/**
+ * The most general version of compiler options.
+ */
+const defaultOptions = {
+    noEmitOnError: false,
+    allowJs: true,
+    maxNodeModuleJsDepth: 3,
+    experimentalDecorators: true,
+    target: ts_morph_1.ScriptTarget.Latest,
+    downlevelIteration: true,
+    module: ts_morph_1.ModuleKind.ESNext,
+    strictNullChecks: true,
+    esModuleInterop: true,
+    noEmit: true,
+    allowSyntheticDefaultImports: true,
+    allowUnreachableCode: true,
+    allowUnusedLabels: true,
+    skipLibCheck: true
+};
+/**
+ * TypeScript utility functions.
+ */
+var TypeScript;
+(function (TypeScript) {
+    // Export interface IReadJsDocTagsResult {
+    //     Program: Project;
+    //     JsDocTags : Array<{
+    //         Ref: JSDoc;
+    //         Parsed: Array<Block>;
+    //     }>;
+    // }
+    /**
+     * Compiles an array of files or file using ts-morph.
+     *
+     * @public
+     * @param filePaths - The path(s) to the file(s).
+     * @param options - The compiler options.
+     */
+    function compile(filePaths, options = defaultOptions) {
+        filePaths = Array.isArray(filePaths) ? filePaths : [filePaths];
+        const project = new ts_morph_1.Project({
+            // TsConfigFilePath: 'tsconfig.json',
+            compilerOptions: options
+        });
+        const sourceFiles = filePaths.map((filePath) => project.addSourceFileAtPath(filePath));
+        return {
+            program: project,
+            files: sourceFiles
+        };
+    }
+    TypeScript.compile = compile;
+    // /**
+    //   * Reads a TypeScript file and returns its JSDoc tags.
+    //   *
+    //   * @public
+    //   * @param filePath - The path to the file.
+    //   * @param options - The compiler options.
+    //   */
+    // Export function readJsDocTags(filePath: string, options: CompilerOptions = defaultOptions): IReadJsDocTagsResult {
+    //     Const project = new Project({
+    //         CompilerOptions: options
+    //     });
+    //     Const sourceFile = project.addSourceFileAtPath(filePath);
+    //     If (!sourceFile) {
+    //         Throw new Error(`File not found: ${filePath}`);
+    //     }
+    //     Const jsDocTags: Array<{
+    //         Ref: JSDoc;
+    //         Parsed: Array<Block>;
+    //     }> = [];
+    //     // Function shouldCollect(kind: NodeKind): boolean {
+    //     //     Return filterKinds.includes('all') || filterKinds.includes(kind);
+    //     // }
+    //     Function visit(node: Node): void {
+    //         If (Node.isJSDoc(node)) {
+    //             JsDocTags.push({
+    //                 Ref: node,
+    //                 Parsed: parse(node.getText())
+    //             });
+    //         }
+    //         If ((node as any).jsDoc) {
+    //             (node as any).jsDoc?.forEach((jsDoc: any) => {
+    //                 JsDocTags.push({
+    //                     Ref: jsDoc,
+    //                     Parsed: parse(jsDoc.getText())
+    //                 });
+    //             });
+    //         }
+    //         Node.forEachChild(visit);
+    //     }
+    //     Function collectJsDocTagsFromType(type: Type): void {
+    //         Const symbol = type.getSymbol();
+    //         If (!symbol) {
+    //             Return;
+    //         }
+    //         Symbol.getDeclarations().forEach((declaration) => {
+    //             If (Node.isClassDeclaration(declaration)) {
+    //                 CollectJsDocTagsFromClass(declaration);
+    //             } else if (Node.isInterfaceDeclaration(declaration)) {
+    //                 Declaration.getJsDocs().forEach((jsDoc) => {
+    //                     JsDocTags.push({
+    //                         Ref: jsDoc,
+    //                         Parsed: parse(jsDoc.getText())
+    //                     });
+    //                 });
+    //             } else if (Node.isTypeAliasDeclaration(declaration)) {
+    //                 Const aliasType = declaration.getType();
+    //                 CollectJsDocTagsFromType(aliasType);
+    //             }
+    //         });
+    //     }
+    //     Function collectJsDocTagsFromClass(classDeclaration: ClassDeclaration): void {
+    //         If (classDeclaration.getName() === 'LitElement') {
+    //             Return;
+    //         }
+    //         ClassDeclaration.getJsDocs().forEach((jsDoc) => {
+    //             JsDocTags.push({
+    //                 Ref: jsDoc,
+    //                 Parsed: parse(jsDoc.getText())
+    //             });
+    //         });
+    //         ClassDeclaration.getProperties().forEach((property) => {
+    //             Property.getJsDocs().forEach((jsDoc) => {
+    //                 JsDocTags.push({
+    //                     Ref: jsDoc,
+    //                     Parsed: parse(jsDoc.getText())
+    //                 });
+    //             });
+    //         });
+    //         ClassDeclaration.getMethods().forEach((method) => {
+    //             Method.getJsDocs().forEach((jsDoc) => {
+    //                 JsDocTags.push({
+    //                     Ref: jsDoc,
+    //                     Parsed: parse(jsDoc.getText())
+    //                 });
+    //             });
+    //         });
+    //         Const baseTypes = classDeclaration.getBaseTypes();
+    //         BaseTypes.forEach(collectJsDocTagsFromType);
+    //         // Handle mixins if any
+    //         Const heritageClauses = classDeclaration.getHeritageClauses();
+    //         HeritageClauses.forEach((clause) => {
+    //             Clause.getTypeNodes().forEach((typeNode) => {
+    //                 Const type = typeNode.getType();
+    //                 CollectJsDocTagsFromType(type);
+    //             });
+    //         });
+    //     }
+    //     SourceFile.getClasses().forEach((classDeclaration) => {
+    //         CollectJsDocTagsFromClass(classDeclaration);
+    //     });
+    //     SourceFile.forEachChild(visit);
+    //     Return {
+    //         Program: project,
+    //         JsDocTags: jsDocTags
+    //     };
+    // }
+})(TypeScript || (exports.TypeScript = TypeScript = {}));
+//# sourceMappingURL=TypeScript.js.map

package/Compiler/TypeScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScript.js","sourceRoot":"","sources":["../../src/Compiler/TypeScript.ts"],"names":[],"mappings":"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"}

package/DI/Container.d.ts

@@ -0,0 +1,73 @@
+import 'reflect-metadata';
+/**
+ * Represents a token that can be used for dependency injection.
+ * The token can be either a `Function` or a `string`.
+ *
+ * @template T The type of the token.
+ * @public
+ */
+export type Token<T> = (new (...args: Array<any>) => T) | string;
+/**
+ * Represents a dependency injection container.
+ *
+ * @public
+ */
+export declare class Container {
+    private static _instance;
+    private readonly _registry;
+    /**
+     * Constructs a new instance of the `Container` class.
+     *
+     * @protected
+     */
+    protected constructor();
+    /**
+     * Gets the singleton instance of the `Container` class.
+     *
+     * @public
+     * @static
+     * @readonly
+     */
+    static get instance(): Container;
+    /**
+     * Registers a class for the specified token.
+     *
+     * @public
+     * @param token - The token to register. Can be a `Function` or `string`.
+     * @param clazz - The class to associate with the token. If not provided, the token itself will be used as the class.
+     */
+    provide<T>(token: Token<T>, clazz?: Token<T>): this;
+    /**
+     * Registers a factory function for the specified token.
+     *
+     * @public
+     * @param token - The token to register. Can be a `Function` or `string`.
+     * @param factory - The factory function to produce the instance.
+     */
+    provideFactory<T>(token: Token<T>, factory: (c: Container) => T): this;
+    /**
+     * Registers a static value or object for the specified token.
+     *
+     * @public
+     * @param token - The token to register. Can be a `Function` or `string`.
+     * @param value - The static value or object to register.
+     */
+    provideValue<T>(token: Token<T>, value: T): this;
+    /**
+     * Resolves an instance for the specified token.
+     *
+     * @public
+     * @param token - The token to resolve. Can be a `Function` or `string`.
+     * @returns The resolved instance.
+     * @throws Error if no instance is found for the token.
+     */
+    get<T = any>(token: Token<T>): T;
+    /**
+     * Reads type information from metadata and resolves dependencies.
+     *
+     * @private
+     * @param clazz - The class to resolve constructor parameters for.
+     */
+    private getInjectedParams;
+}
+//# sourceMappingURL=Container.d.ts.map

package/DI/Container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/DI/Container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAe1B;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,SAAS;IAIlB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAMlE;;;;OAIG;IACH,SAAS;IAQT;;;;;;OAMG;IACH,WAAkB,QAAQ,IAAI,SAAS,CAMtC;IAMD;;;;;;OAMG;IACI,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAgB1D;;;;;;OAMG;IACI,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,IAAI;IAS7E;;;;;;OAMG;IACI,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IASvD;;;;;;;OAOG;IACI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IA+BvC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;CAY5B"}