@devisfuture/electron-modular 1.0.10

package/dist/@core/decorators/inject.d.ts

@@ -0,0 +1,6 @@
+import "reflect-metadata/lite";
+import type { TProviderToken } from "../types/provider.js";
+type TInjectTokensMetadata = Record<number, TProviderToken>;
+export declare const Inject: (token: TProviderToken) => ParameterDecorator;
+export declare const getInjectedTokens: (target: Function) => TInjectTokensMetadata;
+export {};

package/dist/@core/decorators/inject.js

@@ -0,0 +1,15 @@
+import "reflect-metadata/lite";
+const INJECT_TOKENS_METADATA_KEY = "RgInjectTokens";
+export const Inject = (token) => {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey !== undefined) {
+            return;
+        }
+        const existingTokens = Reflect.getMetadata(INJECT_TOKENS_METADATA_KEY, target) ?? {};
+        existingTokens[parameterIndex] = token;
+        Reflect.defineMetadata(INJECT_TOKENS_METADATA_KEY, existingTokens, target);
+    };
+};
+export const getInjectedTokens = (target) => {
+    return Reflect.getMetadata(INJECT_TOKENS_METADATA_KEY, target) ?? {};
+};

package/dist/@core/decorators/injectable.d.ts

@@ -0,0 +1,2 @@
+import "reflect-metadata/lite";
+export declare const Injectable: () => ClassDecorator;

package/dist/@core/decorators/injectable.js

@@ -0,0 +1,6 @@
+import "reflect-metadata/lite";
+export const Injectable = () => {
+    return (target) => {
+        Reflect.defineMetadata("Injectable", true, target);
+    };
+};

package/dist/@core/decorators/ipc-handler.d.ts

@@ -0,0 +1,2 @@
+import "reflect-metadata/lite";
+export declare const IpcHandler: () => ClassDecorator;

package/dist/@core/decorators/ipc-handler.js

@@ -0,0 +1,6 @@
+import "reflect-metadata/lite";
+export const IpcHandler = () => {
+    return (target) => {
+        Reflect.defineMetadata("IpcHandler", true, target);
+    };
+};

package/dist/@core/decorators/rg-module.d.ts

@@ -0,0 +1,3 @@
+import "reflect-metadata/lite";
+import type { RgModuleMetadata } from "../types/module-metadata.js";
+export declare const RgModule: (options: RgModuleMetadata) => ClassDecorator;

package/dist/@core/decorators/rg-module.js

@@ -0,0 +1,6 @@
+import "reflect-metadata/lite";
+export const RgModule = (options) => {
+    return (target) => {
+        Reflect.defineMetadata("RgModule", options, target);
+    };
+};

package/dist/@core/decorators/window-manager.d.ts

@@ -0,0 +1,3 @@
+import "reflect-metadata/lite";
+import type { TParamsCreateWindow } from "../control-window/types.js";
+export declare const WindowManager: <P extends string>(options: TParamsCreateWindow<P>) => ClassDecorator;

package/dist/@core/decorators/window-manager.js

@@ -0,0 +1,6 @@
+import "reflect-metadata/lite";
+export const WindowManager = (options) => {
+    return (target) => {
+        Reflect.defineMetadata("WindowManager", options, target);
+    };
+};

package/dist/@core/errors/index.d.ts

@@ -0,0 +1,19 @@
+declare class BaseError extends Error {
+    constructor(msg: string, name: string);
+}
+export declare class ModuleNotRegisteredError extends BaseError {
+    constructor(m: string);
+}
+export declare class ProviderNotFoundError extends BaseError {
+    constructor(t: string, m: string);
+}
+export declare class ModuleDecoratorMissingError extends BaseError {
+    constructor(m: string);
+}
+export declare class InvalidProviderError extends BaseError {
+    constructor(m: string);
+}
+export declare class SettingsNotInitializedError extends BaseError {
+    constructor();
+}
+export {};

package/dist/@core/errors/index.js

@@ -0,0 +1,31 @@
+class BaseError extends Error {
+    constructor(msg, name) {
+        super(msg);
+        this.name = name;
+    }
+}
+export class ModuleNotRegisteredError extends BaseError {
+    constructor(m) {
+        super(`Module "${m}" is not registered in the container.`, "ModuleNotRegisteredError");
+    }
+}
+export class ProviderNotFoundError extends BaseError {
+    constructor(t, m) {
+        super(`Provider not found for token "${t}" in module "${m}" or its imports.`, "ProviderNotFoundError");
+    }
+}
+export class ModuleDecoratorMissingError extends BaseError {
+    constructor(m) {
+        super(`Module ${m} does not have the @RgModule decorator`, "ModuleDecoratorMissingError");
+    }
+}
+export class InvalidProviderError extends BaseError {
+    constructor(m) {
+        super(`Invalid provider definition registered in module ${m}`, "InvalidProviderError");
+    }
+}
+export class SettingsNotInitializedError extends BaseError {
+    constructor() {
+        super("App settings cache has not been initialized.", "SettingsNotInitializedError");
+    }
+}

package/dist/@core/types/constructor.d.ts

@@ -0,0 +1 @@
+export type Constructor<T = any> = new (...args: any[]) => T;

package/dist/@core/types/constructor.js

@@ -0,0 +1 @@
+export {};

package/dist/@core/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { Constructor } from "./constructor.js";
+export type { TIpcHandlerInterface, TParamOnInit } from "./ipc-handler.js";
+export type { RgModuleMetadata } from "./module-metadata.js";
+export type { TProviderToken, TClassProvider, TFactoryProvider, TValueProvider, TExistingProvider, TProvider, } from "./provider.js";
+export type { TWindowFactory, TWindowCreate } from "./window-factory.js";
+export type { WindowManagerOptions, TWindowManagerWithHandlers, } from "./window-manager.js";
+export type { TMetadataWindow } from "./window-metadata.js";

package/dist/@core/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/@core/types/ipc-handler.d.ts

@@ -0,0 +1,7 @@
+import type { TWindowFactory } from "./window-factory.js";
+export type TParamOnInit<N = string> = {
+    getWindow: (name?: N) => TWindowFactory;
+};
+export type TIpcHandlerInterface = {
+    onInit: (data: TParamOnInit) => void;
+};

package/dist/@core/types/ipc-handler.js

@@ -0,0 +1 @@
+export {};

package/dist/@core/types/module-metadata.d.ts

@@ -0,0 +1,10 @@
+import type { TIpcHandlerInterface } from "./ipc-handler.js";
+import type { Constructor } from "./constructor.js";
+import type { TProvider, TProviderToken } from "./provider.js";
+export type RgModuleMetadata = {
+    imports?: Constructor[];
+    ipc?: (new (...args: any[]) => TIpcHandlerInterface)[];
+    windows?: Constructor[];
+    providers?: TProvider[];
+    exports?: TProviderToken[];
+};

package/dist/@core/types/module-metadata.js

@@ -0,0 +1 @@
+export {};

package/dist/@core/types/provider.d.ts

@@ -0,0 +1,21 @@
+import type { Constructor } from "./constructor.js";
+export type TProviderToken<T = any> = Constructor<T> | string | symbol;
+export type TClassProvider<T = any> = {
+    provide: TProviderToken<T>;
+    useClass: Constructor<T>;
+    inject?: TProviderToken[];
+};
+export type TFactoryProvider<T = any> = {
+    provide: TProviderToken<T>;
+    useFactory: (...args: any[]) => T;
+    inject?: TProviderToken[];
+};
+export type TValueProvider<T = any> = {
+    provide: TProviderToken<T>;
+    useValue: T;
+};
+export type TExistingProvider<T = any> = {
+    provide: TProviderToken<T>;
+    useExisting: TProviderToken<T>;
+};
+export type TProvider<T = any> = Constructor<T> | TClassProvider<T> | TFactoryProvider<T> | TValueProvider<T> | TExistingProvider<T>;

package/dist/@core/types/provider.js

@@ -0,0 +1 @@
+export {};

package/dist/@core/types/window-factory.d.ts

@@ -0,0 +1,6 @@
+import { BrowserWindow } from "electron";
+import type { TParamsCreateWindow } from "../control-window/types.js";
+export type TWindowCreate = (options?: TParamsCreateWindow) => Promise<BrowserWindow | undefined>;
+export type TWindowFactory = {
+    create: TWindowCreate;
+};

package/dist/@core/types/window-factory.js

@@ -0,0 +1 @@
+import { BrowserWindow } from "electron";

package/dist/@core/types/window-manager.d.ts

@@ -0,0 +1,10 @@
+import type { BrowserWindowConstructorOptions } from "electron";
+import type { TParamsCreateWindow } from "../control-window/types.js";
+export type WindowManagerOptions = TParamsCreateWindow & {
+    options: BrowserWindowConstructorOptions;
+};
+type TWindowEventHandler = (...args: any[]) => void;
+export type TWindowManagerWithHandlers = {
+    [key: `on${string}`]: TWindowEventHandler | undefined;
+};
+export {};

package/dist/@core/types/window-manager.js

@@ -0,0 +1 @@
+export {};

package/dist/@core/types/window-metadata.d.ts

@@ -0,0 +1,6 @@
+import type { TParamsCreateWindow } from "../control-window/types.js";
+import type { Constructor } from "./constructor.js";
+export type TMetadataWindow = {
+    metadata: TParamsCreateWindow;
+    windowClass: Constructor;
+};

package/dist/@core/types/window-metadata.js

@@ -0,0 +1 @@
+export {};

package/dist/@core/utils/dependency-tokens.d.ts

@@ -0,0 +1,4 @@
+import "reflect-metadata/lite";
+import type { Constructor } from "../types/constructor.js";
+import type { TProviderToken } from "../types/provider.js";
+export declare const getDependencyTokens: (target: Constructor) => TProviderToken[];

package/dist/@core/utils/dependency-tokens.js

@@ -0,0 +1,23 @@
+import "reflect-metadata/lite";
+import { getInjectedTokens } from "../decorators/inject.js";
+const dependencyTokensCache = new WeakMap();
+export const getDependencyTokens = (target) => {
+    const cached = dependencyTokensCache.get(target);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const paramTypes = (Reflect.getMetadata("design:paramtypes", target) ??
+        []);
+    const injectedTokens = getInjectedTokens(target);
+    const injectedIndexes = Object.keys(injectedTokens).map(Number);
+    const maxIndex = Math.max(paramTypes.length - 1, ...injectedIndexes, -1);
+    if (maxIndex < 0) {
+        dependencyTokensCache.set(target, paramTypes);
+        return paramTypes;
+    }
+    const tokens = Array.from({ length: maxIndex + 1 }, (_, index) => {
+        return injectedTokens[index] ?? paramTypes[index];
+    });
+    dependencyTokensCache.set(target, tokens);
+    return tokens;
+};

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+export declare const folders: {
+    distRenderer: string;
+    distMain: string;
+};

package/dist/config.js

@@ -0,0 +1,4 @@
+export const folders = {
+    distRenderer: "dist-renderer",
+    distMain: "dist-main",
+};

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export * from "./@core/container.js";
+export * from "./@core/bootstrap/bootstrap.js";
+export * from "./@core/bootstrap/initialize-module.js";
+export * from "./@core/bootstrap/instantiate-module.js";
+export * from "./@core/bootstrap/register-imports.js";
+export * from "./@core/bootstrap/register-ipc-handlers.js";
+export * from "./@core/bootstrap/register-providers.js";
+export * from "./@core/bootstrap/register-windows.js";
+export * from "./@core/bootstrap/settings.js";
+export * from "./@core/bootstrap/initialize-ipc/handlers.js";
+export * from "./@core/bootstrap/initialize-ipc/window-creator.js";
+export * from "./@core/bootstrap/initialize-ipc/window-event-listeners.js";
+export * from "./@core/bootstrap/initialize-ipc/window-instance-creator.js";
+export * from "./@core/control-window/cache.js";
+export * from "./@core/control-window/create.js";
+export * from "./@core/control-window/destroy.js";
+export * from "./@core/control-window/receive.js";
+export * from "./@core/control-window/types.js";
+export * from "./@core/decorators/inject.js";
+export * from "./@core/decorators/injectable.js";
+export * from "./@core/decorators/ipc-handler.js";
+export * from "./@core/decorators/rg-module.js";
+export * from "./@core/decorators/window-manager.js";
+export * from "./@core/types/index.js";
+export * from "./@core/utils/dependency-tokens.js";
+export * from "./@core/errors/index.js";

package/dist/index.js

@@ -0,0 +1,34 @@
+// Container
+export * from "./@core/container.js";
+// Bootstrap
+export * from "./@core/bootstrap/bootstrap.js";
+export * from "./@core/bootstrap/initialize-module.js";
+export * from "./@core/bootstrap/instantiate-module.js";
+export * from "./@core/bootstrap/register-imports.js";
+export * from "./@core/bootstrap/register-ipc-handlers.js";
+export * from "./@core/bootstrap/register-providers.js";
+export * from "./@core/bootstrap/register-windows.js";
+export * from "./@core/bootstrap/settings.js";
+// Initialize IPC
+export * from "./@core/bootstrap/initialize-ipc/handlers.js";
+export * from "./@core/bootstrap/initialize-ipc/window-creator.js";
+export * from "./@core/bootstrap/initialize-ipc/window-event-listeners.js";
+export * from "./@core/bootstrap/initialize-ipc/window-instance-creator.js";
+// Control Window
+export * from "./@core/control-window/cache.js";
+export * from "./@core/control-window/create.js";
+export * from "./@core/control-window/destroy.js";
+export * from "./@core/control-window/receive.js";
+export * from "./@core/control-window/types.js";
+// Decorators
+export * from "./@core/decorators/inject.js";
+export * from "./@core/decorators/injectable.js";
+export * from "./@core/decorators/ipc-handler.js";
+export * from "./@core/decorators/rg-module.js";
+export * from "./@core/decorators/window-manager.js";
+// Types
+export * from "./@core/types/index.js";
+// Utils
+export * from "./@core/utils/dependency-tokens.js";
+// Errors
+export * from "./@core/errors/index.js";

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@devisfuture/electron-modular",
+  "version": "1.0.10",
+  "description": "Core module system, DI container, IPC handlers, and window utilities for Electron main process.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trae-op/electron-modular.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "electron": ">=36"
+  },
+  "dependencies": {
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "electron": "^36.4.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "keywords": [
+    "electron",
+    "di",
+    "ipc",
+    "windows",
+    "decorators",
+    "container"
+  ],
+  "license": "MIT"
+}