@zudojs/plugins 0.0.1

package/dist/pluginManager/pluginManager.core.js

@@ -0,0 +1,110 @@
+import { PluginRegistryImpl } from "../pluginRegistry/pluginRegistry.core.js";
+import { DependencyResolver, assertResolutionValid, } from "../pluginDependencies/dependencyResolver.core.js";
+import { LifecycleController } from "../pluginLifecycle/pluginLifecycle.core.js";
+import { PluginAlreadyRegisteredError, PluginDependencyCycleError, PluginDependencyError, PluginInitializationError, PluginNotFoundError, PluginRegistrationError, } from "@zudojs/errors";
+import { PLUGIN_EVENTS } from "../pluginEvents/pluginEvent.core.js";
+import { buildDiagnosticReport, createHealthyHealth, createUnhealthyHealth, } from "../pluginDiagnostics/pluginDiagnostic.core.js";
+/**
+ * Plugin manager coordinates registration, dependency resolution, lifecycle, and disposal.
+ */
+export class PluginManager {
+    registry;
+    resolver;
+    lifecycle;
+    plugins = new Map();
+    constructor() {
+        this.registry = new PluginRegistryImpl();
+        this.resolver = new DependencyResolver();
+        this.lifecycle = new LifecycleController();
+    }
+    register(plugin) {
+        try {
+            this.registry.register(plugin);
+            this.plugins.set(plugin.metadata.name, plugin);
+        }
+        catch (error) {
+            throw new PluginRegistrationError(error.message, plugin.metadata.name);
+        }
+    }
+    get(name) {
+        return this.registry.get(name)?.plugin;
+    }
+    has(name) {
+        return this.registry.has(name);
+    }
+    list() {
+        return this.registry.list().map((r) => r.plugin);
+    }
+    async start(context) {
+        const resolution = this.resolver.resolve(this.toDependencyMap());
+        assertResolutionValid(resolution);
+        const ordered = resolution.ordered;
+        for (const name of ordered) {
+            const registered = this.registry.get(name);
+            if (!registered || registered.state === "disposed") {
+                continue;
+            }
+            await this.lifecycle.install(registered, context);
+        }
+        for (const name of ordered) {
+            const registered = this.registry.get(name);
+            if (!registered || registered.state === "disposed") {
+                continue;
+            }
+            if (registered.state === "installed") {
+                await this.lifecycle.initialize(registered, context);
+            }
+        }
+        for (const name of ordered) {
+            const registered = this.registry.get(name);
+            if (!registered || registered.state === "disposed") {
+                continue;
+            }
+            if (registered.state === "initialized") {
+                await this.lifecycle.start(registered, context);
+            }
+        }
+    }
+    async stop(context) {
+        const plugins = this.registry.list();
+        const reversed = [...plugins].reverse();
+        for (const registered of reversed) {
+            if (registered.state === "started") {
+                try {
+                    await this.lifecycle.stop(registered, context);
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        for (const registered of reversed) {
+            if (registered.state === "stopped" || registered.state === "failed") {
+                try {
+                    await this.lifecycle.dispose(registered, context);
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+    }
+    diagnostics() {
+        const plugins = this.registry.list().map((registered) => ({
+            plugin: registered.plugin,
+            state: registered.state,
+        }));
+        return buildDiagnosticReport(plugins);
+    }
+    toDependencyMap() {
+        const map = new Map();
+        for (const [name, plugin] of this.plugins) {
+            map.set(name, {
+                dependencies: plugin.dependencies,
+                optionalDependencies: plugin.optionalDependencies,
+            });
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=pluginManager.core.js.map

package/dist/pluginManager/pluginManager.core.js.map

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

package/dist/pluginRegistry/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/plugins/pluginRegistry
+ *
+ * Plugin registry for storing and retrieving registered plugins.
+ */
+export type { PluginRegistry, RegisteredPlugin, } from "./pluginRegistry.core.js";
+export { PluginRegistryImpl } from "./pluginRegistry.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/pluginRegistry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pluginRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/pluginRegistry/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/plugins/pluginRegistry
+ *
+ * Plugin registry for storing and retrieving registered plugins.
+ */
+export { PluginRegistryImpl } from "./pluginRegistry.core.js";
+//# sourceMappingURL=index.js.map

package/dist/pluginRegistry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pluginRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/pluginRegistry/pluginRegistry.core.d.ts

@@ -0,0 +1,41 @@
+import type { Plugin } from "../pluginTypes/plugin.type.js";
+import type { PluginState } from "../pluginTypes/pluginState.type.js";
+/**
+ * Internal representation of a registered plugin.
+ */
+export interface RegisteredPlugin<TPlugin extends Plugin = Plugin> {
+    readonly plugin: TPlugin;
+    state: PluginState;
+    readonly options?: unknown;
+    readonly disposables: Array<{
+        dispose(): void | Promise<void>;
+    }>;
+    registerDisposable(disposable: {
+        dispose(): void | Promise<void>;
+    }): void;
+    setState(state: PluginState): void;
+}
+/**
+ * Plugin registry interface.
+ */
+export interface PluginRegistry {
+    register<TPlugin extends Plugin>(plugin: TPlugin, options?: TPlugin extends Plugin<infer TOptions> ? TOptions : unknown): void;
+    get<TPlugin extends Plugin>(name: string): RegisteredPlugin<TPlugin> | undefined;
+    has(name: string): boolean;
+    list(): readonly RegisteredPlugin[];
+    remove(name: string): boolean;
+    clear(): void;
+}
+/**
+ * Default plugin registry implementation.
+ */
+export declare class PluginRegistryImpl implements PluginRegistry {
+    private readonly plugins;
+    register<TPlugin extends Plugin>(plugin: TPlugin, options?: TPlugin extends Plugin<infer TOptions> ? TOptions : unknown): void;
+    get<TPlugin extends Plugin>(name: string): RegisteredPlugin<TPlugin> | undefined;
+    has(name: string): boolean;
+    list(): readonly RegisteredPlugin[];
+    remove(name: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=pluginRegistry.core.d.ts.map

package/dist/pluginRegistry/pluginRegistry.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginRegistry.core.d.ts","sourceRoot":"","sources":["../../src/pluginRegistry/pluginRegistry.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAOtE;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IAC/D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,KAAK,EAAE,WAAW,CAAC;IAEnB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;IAEjE,kBAAkB,CAAC,UAAU,EAAE;QAAE,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAE1E,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,SAAS,MAAM,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG,OAAO,GACpE,IAAI,CAAC;IAER,GAAG,CAAC,OAAO,SAAS,MAAM,EACxB,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAC;IAEpC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IAE7D,QAAQ,CAAC,OAAO,SAAS,MAAM,EACpC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG,OAAO,GACpE,IAAI,CAuBN;IAEM,GAAG,CAAC,OAAO,SAAS,MAAM,EAC/B,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,OAAO,CAAC,GAAG,SAAS,CAEvC;IAEM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhC;IAEM,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAEzC;IAEM,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYnC;IAEM,KAAK,IAAI,IAAI,CAEnB;CACF"}

package/dist/pluginRegistry/pluginRegistry.core.js

@@ -0,0 +1,51 @@
+import { PluginAlreadyRegisteredError, PluginNotFoundError, PluginStateError, } from "@zudojs/errors";
+/**
+ * Default plugin registry implementation.
+ */
+export class PluginRegistryImpl {
+    plugins = new Map();
+    register(plugin, options) {
+        const name = plugin.metadata.name;
+        if (this.plugins.has(name)) {
+            throw new PluginAlreadyRegisteredError(name);
+        }
+        const disposables = [];
+        const registered = {
+            plugin,
+            state: "registered",
+            options,
+            disposables,
+            registerDisposable(disposable) {
+                disposables.push(disposable);
+            },
+            setState(state) {
+                registered.state = state;
+            },
+        };
+        this.plugins.set(name, registered);
+    }
+    get(name) {
+        return this.plugins.get(name);
+    }
+    has(name) {
+        return this.plugins.has(name);
+    }
+    list() {
+        return Object.freeze(Array.from(this.plugins.values()));
+    }
+    remove(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            return false;
+        }
+        if (plugin.state !== "registered" && plugin.state !== "disposed") {
+            throw new PluginStateError(name, plugin.state, "disposed");
+        }
+        this.plugins.delete(name);
+        return true;
+    }
+    clear() {
+        this.plugins.clear();
+    }
+}
+//# sourceMappingURL=pluginRegistry.core.js.map

package/dist/pluginRegistry/pluginRegistry.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginRegistry.core.js","sourceRoot":"","sources":["../../src/pluginRegistry/pluginRegistry.core.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAyCxB;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,GAAkC,IAAI,GAAG,EAAE,CAAC;IAE7D,QAAQ,CACb,MAAe,EACf,OAAqE;QAErE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAElC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,WAAW,GAA+C,EAAE,CAAC;QAEnE,MAAM,UAAU,GAA8B;YAC5C,MAAM;YACN,KAAK,EAAE,YAAY;YACnB,OAAO;YACP,WAAW;YACX,kBAAkB,CAAC,UAAU;gBAC3B,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,CAAC;YACD,QAAQ,CAAC,KAAK;gBACZ,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;YAC3B,CAAC;SACF,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IAEM,GAAG,CACR,IAAY;QAEZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAA0C,CAAC;IACzE,CAAC;IAEM,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAEM,IAAI;QACT,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEM,MAAM,CAAC,IAAY;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,KAAK,YAAY,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACjE,MAAM,IAAI,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/pluginTypes/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @zudojs/plugins/pluginTypes
+ *
+ * Core types for the Zudojs plugin system.
+ */
+export type { PluginState } from "./pluginState.type.js";
+export type { PluginMetadata } from "./pluginMetadata.type.js";
+export type { PluginDependency } from "./pluginDependency.type.js";
+export type { PluginContext, PluginContainer, PluginConfig, PluginLogger, PluginEvents, } from "./pluginContext.type.js";
+export type { Plugin } from "./plugin.type.js";
+export type { PluginErrorOptions } from "@zudojs/errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/pluginTypes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pluginTypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/pluginTypes/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/plugins/pluginTypes
+ *
+ * Core types for the Zudojs plugin system.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/pluginTypes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pluginTypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/pluginTypes/plugin.type.d.ts

@@ -0,0 +1,17 @@
+import type { PluginMetadata } from "./pluginMetadata.type.js";
+import type { PluginDependency } from "./pluginDependency.type.js";
+import type { PluginContext } from "./pluginContext.type.js";
+/**
+ * Plugin interface definition.
+ */
+export interface Plugin<TOptions = unknown> {
+    readonly metadata: PluginMetadata;
+    readonly dependencies?: readonly PluginDependency[];
+    readonly optionalDependencies?: readonly PluginDependency[];
+    install?(context: PluginContext, options: TOptions): void | Promise<void>;
+    initialize?(context: PluginContext): void | Promise<void>;
+    start?(context: PluginContext): void | Promise<void>;
+    stop?(context: PluginContext): void | Promise<void>;
+    dispose?(context: PluginContext): void | Promise<void>;
+}
+//# sourceMappingURL=plugin.type.d.ts.map

package/dist/pluginTypes/plugin.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.type.d.ts","sourceRoot":"","sources":["../../src/pluginTypes/plugin.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,QAAQ,GAAG,OAAO;IACxC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAEpD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE5D,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E,UAAU,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,KAAK,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD"}

package/dist/pluginTypes/plugin.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.type.js.map

package/dist/pluginTypes/plugin.type.js.map

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

package/dist/pluginTypes/pluginContext.type.d.ts

@@ -0,0 +1,45 @@
+import type { PluginMetadata } from "./pluginMetadata.type.js";
+/**
+ * Minimal container interface for plugin context.
+ */
+export interface PluginContainer {
+    register(token: unknown, provider: unknown): void;
+}
+/**
+ * Minimal config interface for plugin context.
+ */
+export interface PluginConfig {
+    get(key: string): unknown;
+}
+/**
+ * Minimal logger interface for plugin context.
+ */
+export interface PluginLogger {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Minimal events interface for plugin context.
+ */
+export interface PluginEvents {
+    on(event: string, handler: (event: unknown) => void): void;
+    off(event: string, handler: (event: unknown) => void): void;
+    emit(event: string, payload: unknown): void;
+}
+/**
+ * Controlled context provided to plugins during lifecycle operations.
+ */
+export interface PluginContext {
+    readonly plugin: PluginMetadata;
+    readonly container?: PluginContainer;
+    readonly config?: PluginConfig;
+    readonly logger?: PluginLogger;
+    readonly events?: PluginEvents;
+    readonly signal: AbortSignal;
+    onDispose(handler: () => void | Promise<void>): void;
+    registerDisposable(disposable: {
+        dispose(): void | Promise<void>;
+    }): void;
+}
+//# sourceMappingURL=pluginContext.type.d.ts.map

package/dist/pluginTypes/pluginContext.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContext.type.d.ts","sourceRoot":"","sources":["../../src/pluginTypes/pluginContext.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAE5D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IAErC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAE/B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAE/B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAE/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAErD,kBAAkB,CAAC,UAAU,EAAE;QAAE,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E"}

package/dist/pluginTypes/pluginContext.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pluginContext.type.js.map

package/dist/pluginTypes/pluginContext.type.js.map

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

package/dist/pluginTypes/pluginDependency.type.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Plugin dependency declaration.
+ */
+export interface PluginDependency {
+    readonly name: string;
+    readonly version?: string;
+    readonly optional?: boolean;
+}
+//# sourceMappingURL=pluginDependency.type.d.ts.map

package/dist/pluginTypes/pluginDependency.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginDependency.type.d.ts","sourceRoot":"","sources":["../../src/pluginTypes/pluginDependency.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/pluginTypes/pluginDependency.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pluginDependency.type.js.map

package/dist/pluginTypes/pluginDependency.type.js.map

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

package/dist/pluginTypes/pluginMetadata.type.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plugin metadata identifying a plugin uniquely.
+ */
+export interface PluginMetadata {
+    readonly name: string;
+    readonly version?: string;
+    readonly description?: string;
+    readonly author?: string;
+    readonly homepage?: string;
+    readonly keywords?: readonly string[];
+    readonly capabilities?: readonly string[];
+}
+//# sourceMappingURL=pluginMetadata.type.d.ts.map

package/dist/pluginTypes/pluginMetadata.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginMetadata.type.d.ts","sourceRoot":"","sources":["../../src/pluginTypes/pluginMetadata.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C"}

package/dist/pluginTypes/pluginMetadata.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pluginMetadata.type.js.map

package/dist/pluginTypes/pluginMetadata.type.js.map

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

package/dist/pluginTypes/pluginState.type.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plugin lifecycle states.
+ */
+export type PluginState = "registered" | "installing" | "installed" | "initializing" | "initialized" | "starting" | "started" | "stopping" | "stopped" | "disposing" | "disposed" | "failed";
+/**
+ * Valid state transitions for the plugin state machine.
+ */
+export declare const VALID_STATE_TRANSITIONS: Readonly<Record<PluginState, readonly PluginState[]>>;
+/**
+ * Determines whether a state transition is valid.
+ */
+export declare function isValidTransition(from: PluginState, to: PluginState): boolean;
+//# sourceMappingURL=pluginState.type.d.ts.map

package/dist/pluginTypes/pluginState.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginState.type.d.ts","sourceRoot":"","sources":["../../src/pluginTypes/pluginState.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,cAAc,GACd,aAAa,GACb,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAC5C,MAAM,CAAC,WAAW,EAAE,SAAS,WAAW,EAAE,CAAC,CAcnC,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAE7E"}

package/dist/pluginTypes/pluginState.type.js

@@ -0,0 +1,24 @@
+/**
+ * Valid state transitions for the plugin state machine.
+ */
+export const VALID_STATE_TRANSITIONS = {
+    registered: ["installing"],
+    installing: ["installed", "failed"],
+    installed: ["initializing", "stopping"],
+    initializing: ["initialized", "failed"],
+    initialized: ["starting", "stopping"],
+    starting: ["started", "failed"],
+    started: ["stopping"],
+    stopping: ["stopped", "failed"],
+    stopped: ["disposing", "starting"],
+    disposing: ["disposed", "failed"],
+    disposed: [],
+    failed: ["disposing"],
+};
+/**
+ * Determines whether a state transition is valid.
+ */
+export function isValidTransition(from, to) {
+    return VALID_STATE_TRANSITIONS[from]?.includes(to) ?? false;
+}
+//# sourceMappingURL=pluginState.type.js.map

package/dist/pluginTypes/pluginState.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginState.type.js","sourceRoot":"","sources":["../../src/pluginTypes/pluginState.type.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAEhC;IACF,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;IACnC,SAAS,EAAE,CAAC,cAAc,EAAE,UAAU,CAAC;IACvC,YAAY,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;IACvC,WAAW,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;IACrC,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC/B,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC/B,OAAO,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;IAClC,SAAS,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IACjC,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,CAAC,WAAW,CAAC;CACb,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB,EAAE,EAAe;IAClE,OAAO,uBAAuB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AAC9D,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@zudojs/plugins",
+  "version": "0.0.1",
+  "description": "Plugin system for extending Zudojs applications with modular capabilities.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@zudojs/errors": "0.0.1",
+    "@zudojs/constants": "0.0.1",
+    "@zudojs/types": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "plugins",
+    "extensions"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}