lakutata 0.0.1

package/.idea/codeStyles/Project.xml

@@ -0,0 +1,18 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <JSCodeStyleSettings version="0">
+      <option name="USE_SEMICOLON_AFTER_STATEMENT" value="false" />
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="USE_DOUBLE_QUOTES" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="Remove" />
+    </JSCodeStyleSettings>
+    <TypeScriptCodeStyleSettings version="0">
+      <option name="USE_SEMICOLON_AFTER_STATEMENT" value="false" />
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="USE_DOUBLE_QUOTES" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="Remove" />
+    </TypeScriptCodeStyleSettings>
+  </code_scheme>
+</component>

package/.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="USE_PER_PROJECT_SETTINGS" value="true" />
+  </state>
+</component>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

package/.idea/lakutata.iml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/build" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/lakutata.iml" filepath="$PROJECT_DIR$/.idea/lakutata.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Lakutata
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+![lakutata](https://socialify.git.ci/lakutata/lakutata/image?description=1&descriptionEditable=An%20IoC-based%20universal%20application%20framework&font=Source%20Code%20Pro&forks=1&language=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Flakutata%2Flakutata%2Fmain%2Fassets%2Flogo.svg&name=1&pattern=Circuit%20Board&stargazers=1&theme=Auto)

package/build/Application-78a416de.d.ts

@@ -0,0 +1,387 @@
+import './tests/Test.spec.cjs';
+import { BaseObject } from './lib/base/BaseObject.cjs';
+import { Component } from './lib/base/Component.cjs';
+import { I as IDependencyInjectionContainer, N as NameAndRegistrationPair } from './DependencyInjectionContainer-f037ac36.js';
+import { LoadEntryCommonOptions } from './options/LoadEntryCommonOptions.cjs';
+import { LoadEntryClassOptions } from './options/LoadEntryClassOptions.cjs';
+import { IConstructor } from './interfaces/IConstructor.cjs';
+import { InjectionProperties } from './types/InjectionProperties.cjs';
+import { Logger } from './lib/components/Logger.cjs';
+import { DTO } from './lib/base/DTO.cjs';
+import { AsyncFunction } from './types/AsyncFunction.cjs';
+import { LoadComponentOptions } from './options/LoadComponentOptions.cjs';
+import { IPatRun } from './interfaces/IPatRun.cjs';
+
+/**
+ * 控制器基类
+ */
+declare class Controller extends Component {
+    protected readonly app: Application;
+    protected readonly module: Module;
+    protected readonly log: Logger;
+    /**
+     * Constructor
+     * @param properties
+     */
+    constructor(properties?: InjectionProperties);
+    /**
+     * 将动作转发至另一个控制器进行处理
+     * @param controllerConstructor
+     * @param subject
+     * @param configurableParams
+     */
+    forward<T extends Controller>(controllerConstructor: IConstructor<T>, subject: Record<string, any>, configurableParams?: Record<string, any>): Promise<any>;
+    /**
+     * 控制器动作执行前调用方法
+     * @param subject
+     * @param actionName
+     */
+    beforeAction(subject: Record<string, any>, actionName: string | symbol | number): Promise<boolean>;
+    /**
+     * 控制器动作执行后调用方法
+     * @param subject
+     * @param actionName
+     * @param actionResult
+     */
+    afterAction(subject: Record<string, any>, actionName: string | symbol | number, actionResult: any): Promise<any>;
+}
+
+type ControllerActionMapItem<T extends Controller = Controller> = {
+    pattern: Record<string, any>;
+    patternHash: string;
+    class: IConstructor<T>;
+    method: string | symbol | number;
+};
+
+declare class Container<T extends Module = Module> {
+    protected readonly __$$module?: Module;
+    protected readonly __$$parent?: Container;
+    protected readonly __$$dic: IDependencyInjectionContainer;
+    protected readonly __$$additionalPropertyMap: Map<string, any>;
+    protected readonly __$controllerActionMap: Map<string, ControllerActionMapItem>;
+    constructor(module?: T, parent?: Container);
+    /**
+     * 加载额外的信息至注入器
+     * @protected
+     */
+    protected additionalPropertiesInjector(): Record<string, any>;
+    /**
+     * 容器内对象销毁处理方法
+     * @param instance
+     * @protected
+     */
+    protected disposer<T extends BaseObject>(instance: T): Promise<void>;
+    /**
+     * 将构造函数转换为字符串
+     * @param constructor
+     */
+    static stringifyConstructor<T extends BaseObject>(constructor: IConstructor<T>): string;
+    /**
+     * 判断是否Controller类
+     * @param constructor
+     * @protected
+     */
+    protected isControllerConstructor(constructor: IConstructor<any>): boolean;
+    /**
+     * 将Controller注册至模块
+     * @param constructor
+     * @protected
+     */
+    protected registerControllerToModule(constructor: IConstructor<any>): void;
+    /**
+     * 根据Glob注册
+     * @param glob
+     * @param options
+     * @protected
+     */
+    protected getEntryConstructorsByGlob<T extends BaseObject>(glob: string, options: LoadEntryCommonOptions): Promise<NameAndRegistrationPair<any>>;
+    /**
+     * 将配置对象加载至注入项的构造函数元数据中
+     * @param name
+     * @param constructor
+     * @param config
+     * @protected
+     */
+    protected assignConfigToInjectConstructorMetadata<T extends BaseObject>(name: string, constructor: IConstructor<T>, config?: Record<string, any>): void;
+    /**
+     * 向容器中注册模块实例
+     * @param instance
+     * @protected
+     */
+    protected registerModule<T extends Module>(instance: T): void;
+    /**
+     * 载入注入项目
+     * @param options
+     */
+    load<T extends BaseObject>(options: Record<string, LoadEntryCommonOptions | LoadEntryClassOptions<T>>): Promise<void>;
+    /**
+     * 通过名称获取容器内的注册项目
+     * @param name 注册项目的名称
+     * @param configurableParams 获取时传入的配置参数对象，必须为在注册项目内使用了@Configurable()修饰器进行修饰的字段
+     */
+    get<T extends BaseObject>(name: string, configurableParams?: Record<string, any>): Promise<T>;
+    /**
+     * 通过构造函数获取容器内的注册项目
+     * @param constructor 注册项目的构造函数
+     * @param configurableParams 获取时传入的配置参数对象，必须为在注册项目内使用了@Configurable()修饰器进行修饰的字段
+     */
+    get<T extends BaseObject>(constructor: IConstructor<T>, configurableParams?: Record<string, any>): Promise<T>;
+    /**
+     * 注入指定字符串名称的对象
+     * @param name
+     * @param options
+     */
+    set<T extends BaseObject>(name: string, options: LoadEntryClassOptions<T>): Promise<string>;
+    /**
+     * 注入非指定字符串名称的构造函数对象
+     * @param constructor
+     * @param config
+     */
+    set<T extends BaseObject>(constructor: IConstructor<T>, config?: Record<string, any>): Promise<string>;
+    /**
+     * 注入并创建指定字符串名称的对象
+     * @param name
+     * @param options
+     */
+    createObject<T extends BaseObject>(name: string, options: LoadEntryClassOptions<T>): Promise<T>;
+    /**
+     * 注入并创建非指定字符串名称的构造函数对象
+     * @param constructor
+     * @param config
+     */
+    createObject<T extends BaseObject>(constructor: IConstructor<T>, config?: Record<string, any>): Promise<T>;
+    /**
+     * 以当前容器为父容器，创建一个作用域容器
+     * @param module
+     */
+    createScope(module?: Module): Container;
+    /**
+     * 销毁当前容器
+     */
+    destroy(): Promise<void>;
+}
+
+declare class LoadModuleOptions<T extends Module, U = IConstructor<T>> extends DTO {
+    /**
+     * 模块的构造函数
+     */
+    readonly class: U;
+    /**
+     * 需要传入的参数以索引签名的形式声明
+     */
+    [key: string]: any;
+}
+
+/**
+ * 模块基类
+ */
+declare class Module<TModule extends Module = any, TComponent extends Component = any, TBaseObject extends BaseObject = any, TController extends Controller = any> extends Component {
+    protected readonly __$$options: ModuleOptions<TModule>;
+    protected readonly __$$parentContainer: Container;
+    protected readonly __$$patternManager: IPatRun;
+    protected readonly __$$container: Container;
+    /**
+     * Constructor
+     * @param properties
+     */
+    constructor(properties?: InjectionProperties);
+    /**
+     * 模块初始化函数
+     * @protected
+     */
+    protected __init(): Promise<void>;
+    /**
+     * 内联载入配置对象
+     * @protected
+     */
+    protected configure(): Promise<ModuleOptions<TModule> | undefined>;
+    /**
+     * 内联对象元素加载集合
+     * @protected
+     */
+    protected entries(): Promise<Record<string, LoadEntryCommonOptions | LoadEntryClassOptions<TModule>>>;
+    /**
+     * 内联对象自动加载数组集合
+     * @protected
+     */
+    protected autoload(): Promise<(string | IConstructor<TBaseObject>)[]>;
+    /**
+     * 内联控制器加载数组集合
+     * @protected
+     */
+    protected controllers(): Promise<(string | IConstructor<TController>)[]>;
+    /**
+     * 内联组件加载配置
+     * @protected
+     */
+    protected components(): Promise<Record<string, IConstructor<TComponent> | LoadComponentOptions<TComponent>>>;
+    /**
+     * 内联模块加载配置
+     * @protected
+     */
+    protected modules(): Promise<Record<string, IConstructor<TModule> | LoadModuleOptions<TModule>>>;
+    /**
+     * 内联启动引导配置
+     * @protected
+     */
+    protected bootstrap<U extends Module>(): Promise<(string | IConstructor<TModule> | AsyncFunction<U, void>)[]>;
+    /**
+     * 合并配置项的配置
+     * @protected
+     */
+    protected mergeEntries<T extends Record<string, any>, U extends BaseObject, V = T | U>(oldEntries?: Record<string, V>, newEntries?: Record<string, V>): Promise<Record<string, V>>;
+    /**
+     * 向entries中添加自动加载的项目
+     * @param autoloadItems
+     * @param entries
+     * @protected
+     */
+    protected autoloadToEntries(autoloadItems: (string | IConstructor<any>)[], entries: Record<string, any>): void;
+    /**
+     * 执行启动引导
+     * @protected
+     */
+    protected __bootstrap(): Promise<void>;
+    /**
+     * 模块内部销毁函数
+     * @protected
+     */
+    protected __destroy(): Promise<void>;
+    /**
+     * 模块销毁函数
+     * @protected
+     */
+    protected destroy(): Promise<void>;
+    /**
+     * 按照注入名称获取对象
+     * @param name 注册项目的名称
+     * @param configurableParams 获取时传入的配置参数对象，必须为在注册项目内使用了@Configurable()修饰器进行修饰的字段
+     */
+    get<T extends BaseObject>(name: string, configurableParams?: Record<string, any>): Promise<T>;
+    /**
+     * 按照注入的构造函数获取对象（用于Glob加载的方式）
+     * @param constructor 注册项目的构造函数
+     * @param configurableParams 获取时传入的配置参数对象，必须为在注册项目内使用了@Configurable()修饰器进行修饰的字段
+     */
+    get<T extends BaseObject>(constructor: IConstructor<T>, configurableParams?: Record<string, any>): Promise<T>;
+    /**
+     * 注入指定字符串名称的对象
+     * @param name
+     * @param options
+     */
+    set<T extends BaseObject>(name: string, options: LoadEntryClassOptions<T>): Promise<void>;
+    /**
+     * 注入非指定字符串名称的构造函数对象
+     * @param constructor
+     * @param config
+     */
+    set<T extends BaseObject>(constructor: IConstructor<T>, config?: Record<string, any>): Promise<void>;
+    /**
+     * 注入并创建指定字符串名称的对象
+     * @param name
+     * @param options
+     */
+    createObject<T extends BaseObject>(name: string, options: LoadEntryClassOptions<T>): Promise<T>;
+    /**
+     * 注入并创建非指定字符串名称的构造函数对象
+     * @param constructor
+     * @param config
+     */
+    createObject<T extends BaseObject>(constructor: IConstructor<T>, config?: Record<string, any>): Promise<T>;
+    /**
+     * 创建一个当前模块的子作用域容器
+     */
+    createScope(): Container;
+    /**
+     * 获取当前的运行环境（开发环境/正式环境）
+     */
+    mode(): 'development' | 'production';
+    /**
+     * 执行模块的控制器调用
+     * @param subject 调用的数据对象
+     * @param configurableParams 注入至控制器的附加可配置项参数
+     */
+    invoke<T = any>(subject: Record<string, any>, configurableParams?: Record<string, any>): Promise<T>;
+}
+
+declare class ModuleOptions<U extends Module, T extends BaseObject = BaseObject> extends DTO {
+    /**
+     * 模块依赖注入对象配置
+     */
+    readonly entries?: Record<string, LoadEntryCommonOptions | LoadEntryClassOptions<T>>;
+    /**
+     * 自动对象加载配置
+     */
+    readonly autoload?: (string | IConstructor<T>)[];
+    /**
+     * 控制器加载配置
+     */
+    readonly controllers?: (string | IConstructor<Controller>)[];
+    /**
+     * 组件注入配置
+     */
+    readonly components?: Record<string, IConstructor<Component> | LoadComponentOptions<Component>>;
+    /**
+     * 子模块注入配置
+     */
+    readonly modules?: Record<string, IConstructor<Module> | LoadModuleOptions<Module>>;
+    /**
+     * 模块引导启动组件
+     */
+    readonly bootstrap?: (string | IConstructor<T> | AsyncFunction<U, void>)[];
+}
+
+declare class ApplicationOptions<T extends BaseObject = BaseObject> extends ModuleOptions<Application, T> {
+    /**
+     * 应用程序ID
+     */
+    readonly id: string;
+    /**
+     * 应用程序名称
+     */
+    readonly name: string;
+    /**
+     * 应用程序时区
+     */
+    readonly timezone?: string;
+    /**
+     * 运行环境（开发环境/正式环境）
+     */
+    readonly mode?: 'development' | 'production';
+}
+
+declare class Application extends Module {
+    /**
+     * 应用程序预设组件
+     * @protected
+     */
+    protected components(): Promise<Record<string, IConstructor<any> | LoadComponentOptions<any>>>;
+    /**
+     * 应用程序预设启动引导
+     * @protected
+     */
+    protected bootstrap<U extends Module>(): Promise<(string | IConstructor<any> | AsyncFunction<U, void>)[]>;
+    /**
+     * 执行应用程序
+     * @param options
+     */
+    static run(options: ApplicationOptions): Promise<Application>;
+    /**
+     * 应用程序ID
+     */
+    get appId(): string;
+    /**
+     * 应用程序名称
+     */
+    get appName(): string;
+    /**
+     * 应用程序时区
+     */
+    get timezone(): string;
+    /**
+     * 退出应用程序
+     */
+    exit(): void;
+}
+
+export { Application as A, ControllerActionMapItem as C, LoadModuleOptions as L, ModuleOptions as M, ApplicationOptions as a, Controller as b, Module as c, Container as d };