@zudojs/core 0.0.1

package/dist/modules/moduleLifecycle/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Module Lifecycle
+ *
+ * Manages the lifecycle phases of loaded modules:
+ * initialize → start → stop → destroy.
+ */
+export { type ModuleLifecyclePhase, type ModuleLifecycleState, type ModuleLifecycleHooks, type ModuleLifecycleOptions, ModuleLifecycleError, type ModuleLifecycleResult, type LifecycleStateMap, } from "./moduleLifecycle.type.js";
+export { ensureStateSynchronized, getLifecycleState, requireLifecycleState, getAllLifecycleStates, isModuleInitialized, isModuleStarted, isModuleDestroyed, invokeLifecycleHook, canModuleEnterPhase, setLifecycleState, executeLifecyclePhase, } from "./moduleLifecycle.stateMachine.js";
+export { ModuleLifecycleManager, createModuleLifecycleManager, } from "./moduleLifecycle.lifecycle.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/moduleLifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleLifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC"}

package/dist/modules/moduleLifecycle/index.js

@@ -0,0 +1,10 @@
+/**
+ * Module Lifecycle
+ *
+ * Manages the lifecycle phases of loaded modules:
+ * initialize → start → stop → destroy.
+ */
+export { ModuleLifecycleError, } from "./moduleLifecycle.type.js";
+export { ensureStateSynchronized, getLifecycleState, requireLifecycleState, getAllLifecycleStates, isModuleInitialized, isModuleStarted, isModuleDestroyed, invokeLifecycleHook, canModuleEnterPhase, setLifecycleState, executeLifecyclePhase, } from "./moduleLifecycle.stateMachine.js";
+export { ModuleLifecycleManager, createModuleLifecycleManager, } from "./moduleLifecycle.lifecycle.js";
+//# sourceMappingURL=index.js.map

package/dist/modules/moduleLifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/moduleLifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAKL,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC"}

package/dist/modules/moduleLifecycle/moduleLifecycle.lifecycle.d.ts

@@ -0,0 +1,41 @@
+import type { ModuleId } from "../module.js";
+import type { ModuleRegistry } from "../moduleRegistry/index.js";
+import type { ModuleLoader } from "../moduleLoader/index.js";
+import type { ModuleLifecycleOptions, ModuleLifecycleResult } from "./moduleLifecycle.type.js";
+/**
+ * Module lifecycle manager.
+ * Initializes, starts, stops, and destroys modules in dependency order.
+ */
+export declare class ModuleLifecycleManager {
+    private readonly registry;
+    private readonly loader;
+    private readonly options;
+    private readonly states;
+    private operation;
+    constructor(registry: ModuleRegistry, loader: ModuleLoader, options?: ModuleLifecycleOptions);
+    initialize(): Promise<ModuleLifecycleResult>;
+    start(): Promise<ModuleLifecycleResult>;
+    stop(): Promise<ModuleLifecycleResult>;
+    destroy(): Promise<ModuleLifecycleResult>;
+    startApplication(): Promise<{
+        readonly initialized: ModuleLifecycleResult;
+        readonly started: ModuleLifecycleResult;
+    }>;
+    stopApplication(): Promise<{
+        readonly stopped: ModuleLifecycleResult;
+        readonly destroyed: ModuleLifecycleResult;
+    }>;
+    getState(moduleId: ModuleId): import("./moduleLifecycle.type.js").ModuleLifecycleState | undefined;
+    requireState(moduleId: ModuleId): import("./moduleLifecycle.type.js").ModuleLifecycleState;
+    getStates(): ReadonlyMap<ModuleId, import("./moduleLifecycle.type.js").ModuleLifecycleState>;
+    isInitialized(moduleId: ModuleId): boolean;
+    isStarted(moduleId: ModuleId): boolean;
+    isDestroyed(moduleId: ModuleId): boolean;
+    private createGraph;
+    private getStartupOrder;
+    private getShutdownOrder;
+    private runExclusive;
+}
+/** Creates a module lifecycle manager. */
+export declare function createModuleLifecycleManager(registry: ModuleRegistry, loader: ModuleLoader, options?: ModuleLifecycleOptions): ModuleLifecycleManager;
+//# sourceMappingURL=moduleLifecycle.lifecycle.d.ts.map

package/dist/modules/moduleLifecycle/moduleLifecycle.lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLifecycle.lifecycle.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleLifecycle/moduleLifecycle.lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAO7D,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AAYnC;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,SAAS,CAA4B;IAE7C,YACE,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,sBAA2B,EAUrC;IAEY,UAAU,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAcxD;IAEY,KAAK,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAcnD;IAEY,IAAI,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAclD;IAEY,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAcrD;IAEY,gBAAgB,IAAI,OAAO,CAAC;QACvC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;QAC5C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;KACzC,CAAC,CAeD;IAEY,eAAe,IAAI,OAAO,CAAC;QACtC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;QACxC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;KAC3C,CAAC,CAID;IAEM,QAAQ,CACb,QAAQ,EAAE,QAAQ,GACjB,OAAO,2BAA2B,EAAE,oBAAoB,GAAG,SAAS,CAEtE;IACM,YAAY,CACjB,QAAQ,EAAE,QAAQ,GACjB,OAAO,2BAA2B,EAAE,oBAAoB,CAE1D;IACM,SAAS,IAAI,WAAW,CAC7B,QAAQ,EACR,OAAO,2BAA2B,EAAE,oBAAoB,CACzD,CAEA;IACM,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEhD;IACM,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE5C;IACM,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9C;IAED,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;YAOV,YAAY;CAc3B;AAED,0CAA0C;AAC1C,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,sBAA2B,GACnC,sBAAsB,CAExB"}

package/dist/modules/moduleLifecycle/moduleLifecycle.lifecycle.js

@@ -0,0 +1,116 @@
+import { createModuleDependencyGraph, resolveModuleStartupOrder, resolveModuleShutdownOrder, } from "../moduleDependency/index.js";
+import { ensureStateSynchronized, getLifecycleState, requireLifecycleState, getAllLifecycleStates, isModuleInitialized, isModuleStarted, isModuleDestroyed, executeLifecyclePhase, } from "./moduleLifecycle.stateMachine.js";
+/**
+ * Module lifecycle manager.
+ * Initializes, starts, stops, and destroys modules in dependency order.
+ */
+export class ModuleLifecycleManager {
+    registry;
+    loader;
+    options;
+    states = new Map();
+    operation;
+    constructor(registry, loader, options = {}) {
+        this.registry = registry;
+        this.loader = loader;
+        this.options = {
+            continueOnInitializeError: options.continueOnInitializeError ?? false,
+            continueOnStartError: options.continueOnStartError ?? false,
+            continueOnStopError: options.continueOnStopError ?? true,
+            continueOnDestroyError: options.continueOnDestroyError ?? true,
+        };
+    }
+    async initialize() {
+        return this.runExclusive(async () => {
+            ensureStateSynchronized(this.registry, this.states);
+            return executeLifecyclePhase(this.getStartupOrder(), "initialize", "initializing", "initialized", this.options.continueOnInitializeError, this.registry, this.loader, this.states);
+        });
+    }
+    async start() {
+        return this.runExclusive(async () => {
+            ensureStateSynchronized(this.registry, this.states);
+            return executeLifecyclePhase(this.getStartupOrder(), "start", "starting", "started", this.options.continueOnStartError, this.registry, this.loader, this.states);
+        });
+    }
+    async stop() {
+        return this.runExclusive(async () => {
+            ensureStateSynchronized(this.registry, this.states);
+            return executeLifecyclePhase(this.getShutdownOrder(), "stop", "stopping", "stopped", this.options.continueOnStopError, this.registry, this.loader, this.states);
+        });
+    }
+    async destroy() {
+        return this.runExclusive(async () => {
+            ensureStateSynchronized(this.registry, this.states);
+            return executeLifecyclePhase(this.getShutdownOrder(), "destroy", "destroying", "destroyed", this.options.continueOnDestroyError, this.registry, this.loader, this.states);
+        });
+    }
+    async startApplication() {
+        const initialized = await this.initialize();
+        if (initialized.failed.length > 0 &&
+            !this.options.continueOnInitializeError)
+            throw new Error("Application startup aborted because module initialization failed.");
+        const started = await this.start();
+        if (started.failed.length > 0 && !this.options.continueOnStartError)
+            throw new Error("Application startup aborted because module startup failed.");
+        return { initialized, started };
+    }
+    async stopApplication() {
+        const stopped = await this.stop();
+        const destroyed = await this.destroy();
+        return { stopped, destroyed };
+    }
+    getState(moduleId) {
+        return getLifecycleState(moduleId, this.states);
+    }
+    requireState(moduleId) {
+        return requireLifecycleState(moduleId, this.states);
+    }
+    getStates() {
+        return getAllLifecycleStates(this.states);
+    }
+    isInitialized(moduleId) {
+        return isModuleInitialized(moduleId, this.states);
+    }
+    isStarted(moduleId) {
+        return isModuleStarted(moduleId, this.states);
+    }
+    isDestroyed(moduleId) {
+        return isModuleDestroyed(moduleId, this.states);
+    }
+    createGraph() {
+        const nodes = this.registry.getAll().map((r) => ({
+            id: r.definition.id,
+            dependencies: this.registry.getDependencies(r.definition.id),
+        }));
+        return createModuleDependencyGraph(nodes);
+    }
+    getStartupOrder() {
+        const order = resolveModuleStartupOrder(this.createGraph());
+        return Object.freeze(order.filter((id) => this.registry.get(id)?.state === "loaded"));
+    }
+    getShutdownOrder() {
+        const order = resolveModuleShutdownOrder(this.createGraph());
+        return Object.freeze(order.filter((id) => this.registry.get(id)?.state === "loaded"));
+    }
+    async runExclusive(operation) {
+        while (this.operation)
+            await this.operation;
+        let resolveOperation;
+        const lock = new Promise((resolve) => {
+            resolveOperation = resolve;
+        });
+        this.operation = lock;
+        try {
+            return await operation();
+        }
+        finally {
+            resolveOperation?.();
+            this.operation = undefined;
+        }
+    }
+}
+/** Creates a module lifecycle manager. */
+export function createModuleLifecycleManager(registry, loader, options = {}) {
+    return new ModuleLifecycleManager(registry, loader, options);
+}
+//# sourceMappingURL=moduleLifecycle.lifecycle.js.map

package/dist/modules/moduleLifecycle/moduleLifecycle.lifecycle.js.map

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

package/dist/modules/moduleLifecycle/moduleLifecycle.stateMachine.d.ts

@@ -0,0 +1,21 @@
+import type { Module, ModuleId } from "../module.js";
+import type { ModuleContext } from "../moduleContext.context.js";
+import type { ModuleLifecycleHooks, ModuleLifecyclePhase, ModuleLifecycleState, LifecycleStateMap } from "./moduleLifecycle.type.js";
+import type { ModuleRegistry } from "../moduleRegistry/index.js";
+import type { ModuleLoader } from "../moduleLoader/index.js";
+/** Ensures lifecycle state is synchronized with the registry. */
+export declare function ensureStateSynchronized(registry: ModuleRegistry, states: LifecycleStateMap): void;
+export declare function getLifecycleState(moduleId: ModuleId, states: LifecycleStateMap): ModuleLifecycleState | undefined;
+export declare function requireLifecycleState(moduleId: ModuleId, states: LifecycleStateMap): ModuleLifecycleState;
+export declare function getAllLifecycleStates(states: LifecycleStateMap): ReadonlyMap<ModuleId, ModuleLifecycleState>;
+export declare function isModuleInitialized(moduleId: ModuleId, states: LifecycleStateMap): boolean;
+export declare function isModuleStarted(moduleId: ModuleId, states: LifecycleStateMap): boolean;
+export declare function isModuleDestroyed(moduleId: ModuleId, states: LifecycleStateMap): boolean;
+export declare function invokeLifecycleHook(module: Module, hook: keyof ModuleLifecycleHooks, context: ModuleContext): Promise<void>;
+export declare function canModuleEnterPhase(moduleId: ModuleId, hook: keyof ModuleLifecycleHooks, states: LifecycleStateMap): boolean;
+export declare function setLifecycleState(moduleId: ModuleId, phase: ModuleLifecyclePhase, states: LifecycleStateMap, error?: unknown): void;
+export declare function executeLifecyclePhase(order: readonly ModuleId[], hook: keyof ModuleLifecycleHooks, activePhase: ModuleLifecyclePhase, completedPhase: ModuleLifecyclePhase, continueOnError: boolean, registry: ModuleRegistry, loader: ModuleLoader, states: LifecycleStateMap): Promise<{
+    readonly completed: readonly ModuleId[];
+    readonly failed: readonly ModuleId[];
+}>;
+//# sourceMappingURL=moduleLifecycle.stateMachine.d.ts.map

package/dist/modules/moduleLifecycle/moduleLifecycle.stateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLifecycle.stateMachine.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleLifecycle/moduleLifecycle.stateMachine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,iEAAiE;AACjE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAMN;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,iBAAiB,GACxB,oBAAoB,GAAG,SAAS,CAElC;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,iBAAiB,GACxB,oBAAoB,CAKtB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,GACxB,WAAW,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAE7C;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAGT;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAET;AACD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAET;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,oBAAoB,EAChC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,oBAAoB,EAChC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAmBT;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,iBAAiB,EACzB,KAAK,CAAC,EAAE,OAAO,GACd,IAAI,CAeN;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,IAAI,EAAE,MAAM,oBAAoB,EAChC,WAAW,EAAE,oBAAoB,EACjC,cAAc,EAAE,oBAAoB,EACpC,eAAe,EAAE,OAAO,EACxB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC;IACT,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;CACtC,CAAC,CAyCD"}

package/dist/modules/moduleLifecycle/moduleLifecycle.stateMachine.js

@@ -0,0 +1,107 @@
+import { ModuleLifecycleError } from "./moduleLifecycle.type.js";
+/** Ensures lifecycle state is synchronized with the registry. */
+export function ensureStateSynchronized(registry, states) {
+    for (const registration of registry.getAll()) {
+        const moduleId = registration.definition.id;
+        if (!states.has(moduleId))
+            states.set(moduleId, { moduleId, phase: "created" });
+    }
+}
+export function getLifecycleState(moduleId, states) {
+    return states.get(moduleId);
+}
+export function requireLifecycleState(moduleId, states) {
+    const state = getLifecycleState(moduleId, states);
+    if (!state)
+        throw new Error(`No lifecycle state exists for module "${moduleId}".`);
+    return state;
+}
+export function getAllLifecycleStates(states) {
+    return new Map(states);
+}
+export function isModuleInitialized(moduleId, states) {
+    const phase = getLifecycleState(moduleId, states)?.phase;
+    return phase === "initialized" || phase === "starting" || phase === "started";
+}
+export function isModuleStarted(moduleId, states) {
+    return getLifecycleState(moduleId, states)?.phase === "started";
+}
+export function isModuleDestroyed(moduleId, states) {
+    return getLifecycleState(moduleId, states)?.phase === "destroyed";
+}
+export async function invokeLifecycleHook(module, hook, context) {
+    const lifecycleModule = module;
+    const handler = lifecycleModule[hook];
+    if (typeof handler !== "function")
+        return;
+    await handler.call(module, context);
+}
+export function canModuleEnterPhase(moduleId, hook, states) {
+    const state = getLifecycleState(moduleId, states);
+    if (!state)
+        return false;
+    switch (hook) {
+        case "initialize":
+            return state.phase === "created";
+        case "start":
+            return state.phase === "initialized";
+        case "stop":
+            return state.phase === "started";
+        case "destroy":
+            return (state.phase === "stopped" ||
+                state.phase === "initialized" ||
+                state.phase === "created");
+        default:
+            return false;
+    }
+}
+export function setLifecycleState(moduleId, phase, states, error) {
+    const previous = states.get(moduleId);
+    const now = new Date();
+    states.set(moduleId, Object.freeze({
+        moduleId,
+        phase,
+        error,
+        initializedAt: phase === "initialized" ? now : previous?.initializedAt,
+        startedAt: phase === "started" ? now : previous?.startedAt,
+        stoppedAt: phase === "stopped" ? now : previous?.stoppedAt,
+        destroyedAt: phase === "destroyed" ? now : previous?.destroyedAt,
+    }));
+}
+export async function executeLifecyclePhase(order, hook, activePhase, completedPhase, continueOnError, registry, loader, states) {
+    const completed = [];
+    const failed = [];
+    for (const moduleId of order) {
+        const registration = registry.get(moduleId);
+        if (!registration?.instance)
+            continue;
+        const module = registration.instance;
+        const context = loader.getContext(moduleId);
+        if (!context) {
+            failed.push(moduleId);
+            setLifecycleState(moduleId, "failed", states);
+            if (!continueOnError)
+                throw new ModuleLifecycleError(moduleId, activePhase, new Error(`Module "${moduleId}" does not have a ModuleContext.`));
+            continue;
+        }
+        if (!canModuleEnterPhase(moduleId, hook, states))
+            continue;
+        setLifecycleState(moduleId, activePhase, states);
+        try {
+            await invokeLifecycleHook(module, hook, context);
+            setLifecycleState(moduleId, completedPhase, states);
+            completed.push(moduleId);
+        }
+        catch (error) {
+            setLifecycleState(moduleId, "failed", states, error);
+            failed.push(moduleId);
+            if (!continueOnError)
+                throw new ModuleLifecycleError(moduleId, activePhase, error);
+        }
+    }
+    return {
+        completed: Object.freeze([...completed]),
+        failed: Object.freeze([...failed]),
+    };
+}
+//# sourceMappingURL=moduleLifecycle.stateMachine.js.map

package/dist/modules/moduleLifecycle/moduleLifecycle.stateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLifecycle.stateMachine.js","sourceRoot":"","sources":["../../../src/modules/moduleLifecycle/moduleLifecycle.stateMachine.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CACrC,QAAwB,EACxB,MAAyB;IAEzB,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAkB,EAClB,MAAyB;IAEzB,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAkB,EAClB,MAAyB;IAEzB,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QACR,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,IAAI,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAyB;IAEzB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,MAAyB;IAEzB,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IACzD,OAAO,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,SAAS,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAkB,EAClB,MAAyB;IAEzB,OAAO,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,KAAK,SAAS,CAAC;AAClE,CAAC;AACD,MAAM,UAAU,iBAAiB,CAC/B,QAAkB,EAClB,MAAyB;IAEzB,OAAO,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,KAAK,WAAW,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,IAAgC,EAChC,OAAsB;IAEtB,MAAM,eAAe,GAAG,MAAgD,CAAC;IACzE,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,OAAO,KAAK,UAAU;QAAE,OAAO;IAC1C,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,IAAgC,EAChC,MAAyB;IAEzB,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,KAAK,KAAK,aAAa,CAAC;QACvC,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;QACnC,KAAK,SAAS;YACZ,OAAO,CACL,KAAK,CAAC,KAAK,KAAK,SAAS;gBACzB,KAAK,CAAC,KAAK,KAAK,aAAa;gBAC7B,KAAK,CAAC,KAAK,KAAK,SAAS,CAC1B,CAAC;QACJ;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAkB,EAClB,KAA2B,EAC3B,MAAyB,EACzB,KAAe;IAEf,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,CACR,QAAQ,EACR,MAAM,CAAC,MAAM,CAAC;QACZ,QAAQ;QACR,KAAK;QACL,KAAK;QACL,aAAa,EAAE,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,aAAa;QACtE,SAAS,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS;QAC1D,SAAS,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS;QAC1D,WAAW,EAAE,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW;KACjE,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA0B,EAC1B,IAAgC,EAChC,WAAiC,EACjC,cAAoC,EACpC,eAAwB,EACxB,QAAwB,EACxB,MAAoB,EACpB,MAAyB;IAKzB,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,EAAE,QAAQ;YAAE,SAAS;QACtC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,eAAe;gBAClB,MAAM,IAAI,oBAAoB,CAC5B,QAAQ,EACR,WAAW,EACX,IAAI,KAAK,CAAC,WAAW,QAAQ,kCAAkC,CAAC,CACjE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC;YAAE,SAAS;QAE3D,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;YACpD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,IAAI,CAAC,eAAe;gBAClB,MAAM,IAAI,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QACxC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/modules/moduleLifecycle/moduleLifecycle.type.d.ts

@@ -0,0 +1,94 @@
+import type { ModuleId } from "../module.js";
+import type { ModuleContext } from "../moduleContext.context.js";
+/**
+ * Lifecycle phases supported by the module system.
+ */
+export type ModuleLifecyclePhase = "created" | "initializing" | "initialized" | "starting" | "started" | "stopping" | "stopped" | "destroying" | "destroyed" | "failed";
+/**
+ * Runtime lifecycle state for a module.
+ */
+export interface ModuleLifecycleState {
+    readonly moduleId: ModuleId;
+    readonly phase: ModuleLifecyclePhase;
+    readonly error?: unknown;
+    readonly initializedAt?: Date;
+    readonly startedAt?: Date;
+    readonly stoppedAt?: Date;
+    readonly destroyedAt?: Date;
+}
+/**
+ * Lifecycle hooks supported by a module.
+ *
+ * Modules can implement any subset of these hooks.
+ */
+export interface ModuleLifecycleHooks {
+    /**
+     * Called before the module starts accepting work.
+     */
+    initialize?(context: ModuleContext): void | Promise<void>;
+    /**
+     * Called after all modules have initialized.
+     *
+     * This is useful when a module needs other modules to
+     * already be initialized before it becomes active.
+     */
+    start?(context: ModuleContext): void | Promise<void>;
+    /**
+     * Called when the application begins shutting down.
+     */
+    stop?(context: ModuleContext): void | Promise<void>;
+    /**
+     * Called after the module has stopped.
+     *
+     * This is the place for final resource cleanup.
+     */
+    destroy?(context: ModuleContext): void | Promise<void>;
+}
+/**
+ * Options controlling module lifecycle behavior.
+ */
+export interface ModuleLifecycleOptions {
+    /**
+     * Whether initialization should continue when one module fails.
+     *
+     * Defaults to false.
+     */
+    readonly continueOnInitializeError?: boolean;
+    /**
+     * Whether startup should continue when one module fails.
+     *
+     * Defaults to false.
+     */
+    readonly continueOnStartError?: boolean;
+    /**
+     * Whether shutdown should continue when one module fails.
+     *
+     * Defaults to true.
+     */
+    readonly continueOnStopError?: boolean;
+    /**
+     * Whether destruction should continue when one module fails.
+     *
+     * Defaults to true.
+     */
+    readonly continueOnDestroyError?: boolean;
+}
+import { ModuleLifecycleError as BaseModuleLifecycleError } from "@zudojs/errors";
+/**
+ * Error thrown when a module lifecycle operation fails.
+ */
+export declare class ModuleLifecycleError extends BaseModuleLifecycleError {
+    constructor(moduleId: ModuleId, phase: ModuleLifecyclePhase, cause: unknown);
+}
+/**
+ * Result of a lifecycle operation.
+ */
+export interface ModuleLifecycleResult {
+    readonly completed: readonly ModuleId[];
+    readonly failed: readonly ModuleId[];
+}
+/**
+ * Internal lifecycle state map.
+ */
+export type LifecycleStateMap = Map<ModuleId, ModuleLifecycleState>;
+//# sourceMappingURL=moduleLifecycle.type.d.ts.map

package/dist/modules/moduleLifecycle/moduleLifecycle.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLifecycle.type.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleLifecycle/moduleLifecycle.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,cAAc,GACd,aAAa,GACb,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IAErC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEzB,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;IAE9B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAE1B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAE1B,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;OAIG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED,OAAO,EAAE,oBAAoB,IAAI,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAElF;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,wBAAwB;IAChE,YACE,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,OAAO,EAUf;CACF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAExC,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/modules/moduleLifecycle/moduleLifecycle.type.js

@@ -0,0 +1,11 @@
+import { ModuleLifecycleError as BaseModuleLifecycleError } from "@zudojs/errors";
+/**
+ * Error thrown when a module lifecycle operation fails.
+ */
+export class ModuleLifecycleError extends BaseModuleLifecycleError {
+    constructor(moduleId, phase, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(moduleId, phase, `Module "${moduleId}" failed during ${phase}: ${message}`, cause);
+    }
+}
+//# sourceMappingURL=moduleLifecycle.type.js.map

package/dist/modules/moduleLifecycle/moduleLifecycle.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLifecycle.type.js","sourceRoot":"","sources":["../../../src/modules/moduleLifecycle/moduleLifecycle.type.ts"],"names":[],"mappings":"AAuGA,OAAO,EAAE,oBAAoB,IAAI,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAElF;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,wBAAwB;IAChE,YACE,QAAkB,EAClB,KAA2B,EAC3B,KAAc;QAEd,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,KAAK,CACH,QAAQ,EACR,KAAK,EACL,WAAW,QAAQ,mBAAmB,KAAK,KAAK,OAAO,EAAE,EACzD,KAAK,CACN,CAAC;IACJ,CAAC;CACF"}

package/dist/modules/moduleLoader/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Module Loader
+ *
+ * Loads module definitions, resolves dependencies,
+ * and instantiates module instances.
+ */
+export { type ModuleLoaderOptions, type ModuleLoadResult, ModuleLoadError, } from "./moduleLoader.type.js";
+export { ModuleLoader, createModuleLoader } from "./moduleLoader.loader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/moduleLoader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleLoader/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/modules/moduleLoader/index.js

@@ -0,0 +1,9 @@
+/**
+ * Module Loader
+ *
+ * Loads module definitions, resolves dependencies,
+ * and instantiates module instances.
+ */
+export { ModuleLoadError, } from "./moduleLoader.type.js";
+export { ModuleLoader, createModuleLoader } from "./moduleLoader.loader.js";
+//# sourceMappingURL=index.js.map

package/dist/modules/moduleLoader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/moduleLoader/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/modules/moduleLoader/moduleLoader.loader.d.ts

@@ -0,0 +1,36 @@
+import type { Module, ModuleId } from "../module.js";
+import type { ModuleContext } from "../moduleContext.context.js";
+import type { ModuleRegistry } from "../moduleRegistry/index.js";
+import type { ModuleLoaderOptions, ModuleLoadResult } from "./moduleLoader.type.js";
+/**
+ * Default module loader.
+ *
+ * Reads definitions from registry, builds dependency graph,
+ * validates, resolves startup order, instantiates modules.
+ */
+export declare class ModuleLoader {
+    private readonly application;
+    private readonly configuration;
+    private readonly logger;
+    private readonly registry;
+    private readonly allowExplicitLoad;
+    private readonly contexts;
+    constructor(registry: ModuleRegistry, options: ModuleLoaderOptions);
+    /** Loads every module whose definition has autoLoad enabled. */
+    loadAll(): Promise<ModuleLoadResult>;
+    /** Loads a specific module and all of its required dependencies. */
+    load(moduleId: ModuleId): Promise<Module>;
+    private loadDefinitions;
+    private createGraph;
+    private collectDependencies;
+    private instantiate;
+    private createModuleLogger;
+    private isExplicitlyRequested;
+    getContext(moduleId: ModuleId): ModuleContext | undefined;
+    requireContext(moduleId: ModuleId): ModuleContext;
+    getContexts(): ReadonlyMap<ModuleId, ModuleContext>;
+    isLoaded(moduleId: ModuleId): boolean;
+}
+/** Creates a module loader. */
+export declare function createModuleLoader(registry: ModuleRegistry, options: ModuleLoaderOptions): ModuleLoader;
+//# sourceMappingURL=moduleLoader.loader.d.ts.map

package/dist/modules/moduleLoader/moduleLoader.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoader.loader.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleLoader/moduleLoader.loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAWjE,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAGhC;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D,YAAmB,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,EAMxE;IAED,gEAAgE;IACnD,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAKhD;IAED,oEAAoE;IACvD,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBrD;YAEa,eAAe;IAoD7B,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,mBAAmB;YAkBb,WAAW;IAsCzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,qBAAqB;IAOtB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CAE/D;IAEM,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAIvD;IAEM,WAAW,IAAI,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAEzD;IACM,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE3C;CACF;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAEd"}