@zudojs/plugins 0.0.1

package/dist/pluginDependencies/dependencyResolver.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyResolver.core.d.ts","sourceRoot":"","sources":["../../src/pluginDependencies/dependencyResolver.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAMhF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAEpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAEpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACI,OAAO,CACZ,OAAO,EAAE,GAAG,CACV,MAAM,EACN;QACE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;QACpD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;KAC7D,CACF,GACA,oBAAoB,CAsCtB;IAED,OAAO,CAAC,GAAG;IAyCX,OAAO,CAAC,YAAY;CAcrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAW5E"}

package/dist/pluginDependencies/dependencyResolver.core.js

@@ -0,0 +1,88 @@
+import { PluginDependencyCycleError, PluginDependencyError, } from "@zudojs/errors";
+/**
+ * Resolves plugin dependencies and determines startup order.
+ */
+export class DependencyResolver {
+    /**
+     * Resolves dependencies for the given plugins.
+     */
+    resolve(plugins) {
+        const missing = [];
+        const cycles = [];
+        for (const [name, plugin] of plugins) {
+            for (const dep of plugin.dependencies ?? []) {
+                if (!plugins.has(dep.name)) {
+                    missing.push(dep.name);
+                }
+            }
+        }
+        if (missing.length > 0) {
+            return { ordered: [], missing, cycles };
+        }
+        const visited = new Set();
+        const visiting = new Set();
+        const order = [];
+        for (const name of plugins.keys()) {
+            if (!visited.has(name)) {
+                const cycle = this.dfs(name, plugins, visited, visiting, order);
+                if (cycle) {
+                    cycles.push(cycle);
+                }
+            }
+        }
+        if (cycles.length > 0) {
+            return { ordered: [], missing, cycles };
+        }
+        return {
+            ordered: Object.freeze(order),
+            missing,
+            cycles: Object.freeze(cycles),
+        };
+    }
+    dfs(name, plugins, visited, visiting, order) {
+        if (visiting.has(name)) {
+            const cycle = this.extractCycle(name, visiting);
+            return cycle;
+        }
+        if (visited.has(name)) {
+            return undefined;
+        }
+        visiting.add(name);
+        const plugin = plugins.get(name);
+        const deps = plugin?.dependencies ?? [];
+        for (const dep of deps) {
+            const cycle = this.dfs(dep.name, plugins, visited, visiting, order);
+            if (cycle) {
+                return cycle;
+            }
+        }
+        visiting.delete(name);
+        visited.add(name);
+        order.push(name);
+        return undefined;
+    }
+    extractCycle(entryPoint, visiting) {
+        const cycle = [entryPoint];
+        let current = entryPoint;
+        const entries = Array.from(visiting);
+        const startIndex = entries.indexOf(current);
+        for (let i = startIndex + 1; i < entries.length; i++) {
+            cycle.push(entries[i]);
+            current = entries[i];
+        }
+        cycle.push(entryPoint);
+        return cycle.join(" -> ");
+    }
+}
+/**
+ * Throws if the dependency resolution has errors.
+ */
+export function assertResolutionValid(resolution) {
+    if (resolution.missing.length > 0) {
+        throw new PluginDependencyError(resolution.missing[0], resolution.missing[0]);
+    }
+    if (resolution.cycles.length > 0) {
+        throw new PluginDependencyCycleError(resolution.cycles[0].split(" -> "));
+    }
+}
+//# sourceMappingURL=dependencyResolver.core.js.map

package/dist/pluginDependencies/dependencyResolver.core.js.map

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

package/dist/pluginDependencies/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/plugins/pluginDependencies
+ *
+ * Plugin dependency resolution, topological sorting, and cycle detection.
+ */
+export type { DependencyResolution } from "./dependencyResolver.core.js";
+export { DependencyResolver, assertResolutionValid, } from "./dependencyResolver.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pluginDependencies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/pluginDependencies/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/plugins/pluginDependencies
+ *
+ * Plugin dependency resolution, topological sorting, and cycle detection.
+ */
+export { DependencyResolver, assertResolutionValid, } from "./dependencyResolver.core.js";
+//# sourceMappingURL=index.js.map

package/dist/pluginDependencies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pluginDependencies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/pluginDiagnostics/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/plugins/pluginDiagnostics
+ *
+ * Plugin health checks and diagnostic reporting.
+ */
+export type { PluginHealthStatus, PluginHealth, PluginDiagnostic, PluginDiagnosticReport, } from "./pluginDiagnostic.core.js";
+export { createHealthyHealth, createDegradedHealth, createUnhealthyHealth, buildDiagnosticReport, } from "./pluginDiagnostic.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pluginDiagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/pluginDiagnostics/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/plugins/pluginDiagnostics
+ *
+ * Plugin health checks and diagnostic reporting.
+ */
+export { createHealthyHealth, createDegradedHealth, createUnhealthyHealth, buildDiagnosticReport, } from "./pluginDiagnostic.core.js";
+//# sourceMappingURL=index.js.map

package/dist/pluginDiagnostics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pluginDiagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/pluginDiagnostics/pluginDiagnostic.core.d.ts

@@ -0,0 +1,55 @@
+import type { Plugin } from "../pluginTypes/plugin.type.js";
+import type { PluginMetadata } from "../pluginTypes/pluginMetadata.type.js";
+import type { PluginState } from "../pluginTypes/pluginState.type.js";
+/**
+ * Plugin health status.
+ */
+export type PluginHealthStatus = "healthy" | "degraded" | "unhealthy";
+/**
+ * Plugin health information.
+ */
+export interface PluginHealth {
+    readonly status: PluginHealthStatus;
+    readonly details?: unknown;
+}
+/**
+ * Individual plugin diagnostic information.
+ */
+export interface PluginDiagnostic {
+    readonly plugin: PluginMetadata;
+    readonly state: PluginState;
+    readonly health: PluginHealth;
+    readonly dependencies: readonly string[];
+    readonly optionalDependencies: readonly string[];
+}
+/**
+ * Complete plugin system diagnostic report.
+ */
+export interface PluginDiagnosticReport {
+    readonly plugins: readonly PluginDiagnostic[];
+    readonly total: number;
+    readonly healthy: number;
+    readonly degraded: number;
+    readonly unhealthy: number;
+    readonly failed: number;
+}
+/**
+ * Creates a default healthy status for a plugin.
+ */
+export declare function createHealthyHealth(): PluginHealth;
+/**
+ * Creates a degraded health status for a plugin.
+ */
+export declare function createDegradedHealth(details?: unknown): PluginHealth;
+/**
+ * Creates an unhealthy health status for a plugin.
+ */
+export declare function createUnhealthyHealth(details?: unknown): PluginHealth;
+/**
+ * Builds a diagnostic report from registered plugins.
+ */
+export declare function buildDiagnosticReport(plugins: Array<{
+    readonly plugin: Plugin;
+    readonly state: PluginState;
+}>): PluginDiagnosticReport;
+//# sourceMappingURL=pluginDiagnostic.core.d.ts.map

package/dist/pluginDiagnostics/pluginDiagnostic.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginDiagnostic.core.d.ts","sourceRoot":"","sources":["../../src/pluginDiagnostics/pluginDiagnostic.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAEpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAEpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAErE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,CAAC,GACD,sBAAsB,CAoCxB"}

package/dist/pluginDiagnostics/pluginDiagnostic.core.js

@@ -0,0 +1,47 @@
+/**
+ * Creates a default healthy status for a plugin.
+ */
+export function createHealthyHealth() {
+    return { status: "healthy" };
+}
+/**
+ * Creates a degraded health status for a plugin.
+ */
+export function createDegradedHealth(details) {
+    return { status: "degraded", ...(details !== undefined ? { details } : {}) };
+}
+/**
+ * Creates an unhealthy health status for a plugin.
+ */
+export function createUnhealthyHealth(details) {
+    return { status: "unhealthy", ...(details !== undefined ? { details } : {}) };
+}
+/**
+ * Builds a diagnostic report from registered plugins.
+ */
+export function buildDiagnosticReport(plugins) {
+    const pluginDiagnostics = plugins.map(({ plugin, state }) => ({
+        plugin: plugin.metadata,
+        state,
+        health: state === "started"
+            ? createHealthyHealth()
+            : state === "failed"
+                ? createUnhealthyHealth()
+                : createDegradedHealth(),
+        dependencies: plugin.dependencies?.map((d) => d.name) ?? [],
+        optionalDependencies: plugin.optionalDependencies?.map((d) => d.name) ?? [],
+    }));
+    const healthy = pluginDiagnostics.filter((d) => d.health.status === "healthy").length;
+    const degraded = pluginDiagnostics.filter((d) => d.health.status === "degraded").length;
+    const unhealthy = pluginDiagnostics.filter((d) => d.health.status === "unhealthy").length;
+    const failed = pluginDiagnostics.filter((d) => d.state === "failed").length;
+    return {
+        plugins: Object.freeze(pluginDiagnostics),
+        total: pluginDiagnostics.length,
+        healthy,
+        degraded,
+        unhealthy,
+        failed,
+    };
+}
+//# sourceMappingURL=pluginDiagnostic.core.js.map

package/dist/pluginDiagnostics/pluginDiagnostic.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginDiagnostic.core.js","sourceRoot":"","sources":["../../src/pluginDiagnostics/pluginDiagnostic.core.ts"],"names":[],"mappings":"AAkDA;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAiB;IACpD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAiB;IACrD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAGE;IAEF,MAAM,iBAAiB,GAAuB,OAAO,CAAC,GAAG,CACvD,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,KAAK;QACL,MAAM,EACJ,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,mBAAmB,EAAE;YACvB,CAAC,CAAC,KAAK,KAAK,QAAQ;gBAClB,CAAC,CAAC,qBAAqB,EAAE;gBACzB,CAAC,CAAC,oBAAoB,EAAE;QAC9B,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE;QAC3D,oBAAoB,EAClB,MAAM,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE;KACxD,CAAC,CACH,CAAC;IAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CACrC,CAAC,MAAM,CAAC;IACT,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CACtC,CAAC,MAAM,CAAC;IACT,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CACvC,CAAC,MAAM,CAAC;IACT,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACzC,KAAK,EAAE,iBAAiB,CAAC,MAAM;QAC/B,OAAO;QACP,QAAQ;QACR,SAAS;QACT,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/pluginEvents/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/plugins/pluginEvents
+ *
+ * Plugin lifecycle event types and event names.
+ */
+export type { PluginLifecycleEvent } from "./pluginEvent.core.js";
+export { PLUGIN_EVENTS, createPluginLifecycleEvent, } from "./pluginEvent.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pluginEvents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EACL,aAAa,EACb,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/pluginEvents/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/plugins/pluginEvents
+ *
+ * Plugin lifecycle event types and event names.
+ */
+export { PLUGIN_EVENTS, createPluginLifecycleEvent, } from "./pluginEvent.core.js";
+//# sourceMappingURL=index.js.map

package/dist/pluginEvents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pluginEvents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,aAAa,EACb,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/pluginEvents/pluginEvent.core.d.ts

@@ -0,0 +1,34 @@
+import type { PluginMetadata } from "../pluginTypes/pluginMetadata.type.js";
+import type { PluginState } from "../pluginTypes/pluginState.type.js";
+/**
+ * Event payload for plugin lifecycle events.
+ */
+export interface PluginLifecycleEvent {
+    readonly plugin: PluginMetadata;
+    readonly state: PluginState;
+    readonly previousState?: PluginState;
+    readonly timestamp: number;
+    readonly error?: unknown;
+}
+/**
+ * Event names emitted during plugin lifecycle.
+ */
+export declare const PLUGIN_EVENTS: {
+    readonly REGISTERED: "plugin:registered";
+    readonly INSTALLING: "plugin:installing";
+    readonly INSTALLED: "plugin:installed";
+    readonly INITIALIZING: "plugin:initializing";
+    readonly INITIALIZED: "plugin:initialized";
+    readonly STARTING: "plugin:starting";
+    readonly STARTED: "plugin:started";
+    readonly STOPPING: "plugin:stopping";
+    readonly STOPPED: "plugin:stopped";
+    readonly FAILED: "plugin:failed";
+    readonly DISPOSING: "plugin:disposing";
+    readonly DISPOSED: "plugin:disposed";
+};
+/**
+ * Creates a plugin lifecycle event.
+ */
+export declare function createPluginLifecycleEvent(plugin: PluginMetadata, state: PluginState, previousState?: PluginState, error?: unknown): PluginLifecycleEvent;
+//# sourceMappingURL=pluginEvent.core.d.ts.map

package/dist/pluginEvents/pluginEvent.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginEvent.core.d.ts","sourceRoot":"","sources":["../../src/pluginEvents/pluginEvent.core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;IAErC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;aACxB,UAAU,EAAE,mBAAmB;aAC/B,UAAU,EAAE,mBAAmB;aAC/B,SAAS,EAAE,kBAAkB;aAC7B,YAAY,EAAE,qBAAqB;aACnC,WAAW,EAAE,oBAAoB;aACjC,QAAQ,EAAE,iBAAiB;aAC3B,OAAO,EAAE,gBAAgB;aACzB,QAAQ,EAAE,iBAAiB;aAC3B,OAAO,EAAE,gBAAgB;aACzB,MAAM,EAAE,eAAe;aACvB,SAAS,EAAE,kBAAkB;aAC7B,QAAQ,EAAE,iBAAiB;CACnB,CAAC;AAEX;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,WAAW,EAClB,aAAa,CAAC,EAAE,WAAW,EAC3B,KAAK,CAAC,EAAE,OAAO,GACd,oBAAoB,CAQtB"}

package/dist/pluginEvents/pluginEvent.core.js

@@ -0,0 +1,30 @@
+/**
+ * Event names emitted during plugin lifecycle.
+ */
+export const PLUGIN_EVENTS = {
+    REGISTERED: "plugin:registered",
+    INSTALLING: "plugin:installing",
+    INSTALLED: "plugin:installed",
+    INITIALIZING: "plugin:initializing",
+    INITIALIZED: "plugin:initialized",
+    STARTING: "plugin:starting",
+    STARTED: "plugin:started",
+    STOPPING: "plugin:stopping",
+    STOPPED: "plugin:stopped",
+    FAILED: "plugin:failed",
+    DISPOSING: "plugin:disposing",
+    DISPOSED: "plugin:disposed",
+};
+/**
+ * Creates a plugin lifecycle event.
+ */
+export function createPluginLifecycleEvent(plugin, state, previousState, error) {
+    return {
+        plugin,
+        state,
+        ...(previousState !== undefined ? { previousState } : {}),
+        timestamp: Date.now(),
+        ...(error !== undefined ? { error } : {}),
+    };
+}
+//# sourceMappingURL=pluginEvent.core.js.map

package/dist/pluginEvents/pluginEvent.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginEvent.core.js","sourceRoot":"","sources":["../../src/pluginEvents/pluginEvent.core.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,mBAAmB;IAC/B,SAAS,EAAE,kBAAkB;IAC7B,YAAY,EAAE,qBAAqB;IACnC,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,kBAAkB;IAC7B,QAAQ,EAAE,iBAAiB;CACnB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAsB,EACtB,KAAkB,EAClB,aAA2B,EAC3B,KAAe;IAEf,OAAO;QACL,MAAM;QACN,KAAK;QACL,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/pluginIntegration/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/plugins/pluginIntegration
+ *
+ * Plugin context factory and integration helpers.
+ */
+export { createPluginContext } from "./pluginContext.core.js";
+export type { PluginContext } from "../pluginTypes/pluginContext.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pluginIntegration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/pluginIntegration/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/plugins/pluginIntegration
+ *
+ * Plugin context factory and integration helpers.
+ */
+export { createPluginContext } from "./pluginContext.core.js";
+//# sourceMappingURL=index.js.map

package/dist/pluginIntegration/index.js.map

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

package/dist/pluginIntegration/pluginContext.core.d.ts

@@ -0,0 +1,20 @@
+import type { PluginMetadata } from "../pluginTypes/pluginMetadata.type.js";
+import type { PluginContext } from "../pluginTypes/pluginContext.type.js";
+import type { PluginContainer } from "../pluginTypes/pluginContext.type.js";
+import type { PluginConfig } from "../pluginTypes/pluginContext.type.js";
+import type { PluginLogger } from "../pluginTypes/pluginContext.type.js";
+import type { PluginEvents } from "../pluginTypes/pluginContext.type.js";
+/**
+ * Options for creating a plugin context.
+ */
+export interface CreatePluginContextOptions {
+    readonly container?: PluginContainer;
+    readonly config?: PluginConfig;
+    readonly logger?: PluginLogger;
+    readonly events?: PluginEvents;
+}
+/**
+ * Creates a plugin context for testing and basic usage.
+ */
+export declare function createPluginContext(plugin: PluginMetadata, options?: CreatePluginContextOptions): PluginContext;
+//# sourceMappingURL=pluginContext.core.d.ts.map

package/dist/pluginIntegration/pluginContext.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContext.core.d.ts","sourceRoot":"","sources":["../../src/pluginIntegration/pluginContext.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,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;CAChC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,0BAA+B,GACvC,aAAa,CAkBf"}

package/dist/pluginIntegration/pluginContext.core.js

@@ -0,0 +1,22 @@
+/**
+ * Creates a plugin context for testing and basic usage.
+ */
+export function createPluginContext(plugin, options = {}) {
+    const abortController = new AbortController();
+    const disposables = [];
+    return {
+        plugin,
+        signal: abortController.signal,
+        container: options.container,
+        config: options.config,
+        logger: options.logger,
+        events: options.events,
+        onDispose(handler) {
+            disposables.push({ dispose: handler });
+        },
+        registerDisposable(disposable) {
+            disposables.push(disposable);
+        },
+    };
+}
+//# sourceMappingURL=pluginContext.core.js.map

package/dist/pluginIntegration/pluginContext.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContext.core.js","sourceRoot":"","sources":["../../src/pluginIntegration/pluginContext.core.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAsB,EACtB,OAAO,GAA+B,EAAE;IAExC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,WAAW,GAA+C,EAAE,CAAC;IAEnE,OAAO;QACL,MAAM;QACN,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,CAAC,OAAO;YACf,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,kBAAkB,CAAC,UAAU;YAC3B,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/pluginLifecycle/pluginLifecycle.core.d.ts

@@ -0,0 +1,15 @@
+import type { Plugin } from "../pluginTypes/plugin.type.js";
+import type { PluginContext } from "../pluginTypes/pluginContext.type.js";
+import type { RegisteredPlugin } from "../pluginRegistry/pluginRegistry.core.js";
+/**
+ * Executes plugin lifecycle phases with state management and event emission.
+ */
+export declare class LifecycleController {
+    install<TPlugin extends Plugin>(registered: RegisteredPlugin<TPlugin>, context: PluginContext): Promise<void>;
+    initialize<TPlugin extends Plugin>(registered: RegisteredPlugin<TPlugin>, context: PluginContext): Promise<void>;
+    start<TPlugin extends Plugin>(registered: RegisteredPlugin<TPlugin>, context: PluginContext): Promise<void>;
+    stop<TPlugin extends Plugin>(registered: RegisteredPlugin<TPlugin>, context: PluginContext): Promise<void>;
+    dispose<TPlugin extends Plugin>(registered: RegisteredPlugin<TPlugin>, context: PluginContext): Promise<void>;
+    private ensureTransition;
+}
+//# sourceMappingURL=pluginLifecycle.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pluginLifecycle.core.d.ts","sourceRoot":"","sources":["../../src/pluginLifecycle/pluginLifecycle.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAgCjF;;GAEG;AACH,qBAAa,mBAAmB;IACjB,OAAO,CAAC,OAAO,SAAS,MAAM,EACzC,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAqCf;IAEY,UAAU,CAAC,OAAO,SAAS,MAAM,EAC5C,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAqCf;IAEY,KAAK,CAAC,OAAO,SAAS,MAAM,EACvC,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Bf;IAEY,IAAI,CAAC,OAAO,SAAS,MAAM,EACtC,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Bf;IAEY,OAAO,CAAC,OAAO,SAAS,MAAM,EACzC,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,EACrC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Cf;IAED,OAAO,CAAC,gBAAgB;CAczB"}

package/dist/pluginLifecycle/pluginLifecycle.core.js

@@ -0,0 +1,128 @@
+import { VALID_STATE_TRANSITIONS } from "../pluginTypes/pluginState.type.js";
+import { PluginStateError } from "@zudojs/errors";
+import { PLUGIN_EVENTS, createPluginLifecycleEvent, } from "../pluginEvents/pluginEvent.core.js";
+/**
+ * Emits a plugin lifecycle event if the context supports events.
+ */
+function emitLifecycleEvent(context, eventName, pluginName, state, previousState, error) {
+    if (!context.events?.emit) {
+        return;
+    }
+    const event = createPluginLifecycleEvent({ name: pluginName }, state, previousState, error);
+    context.events.emit(eventName, event);
+}
+/**
+ * Executes plugin lifecycle phases with state management and event emission.
+ */
+export class LifecycleController {
+    async install(registered, context) {
+        const name = registered.plugin.metadata.name;
+        const from = registered.state;
+        this.ensureTransition(registered, "installing");
+        registered.setState("installing");
+        emitLifecycleEvent(context, PLUGIN_EVENTS.INSTALLING, name, "installing", from);
+        try {
+            await registered.plugin.install?.(context, registered.options);
+            this.ensureTransition(registered, "installed");
+            registered.setState("installed");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.INSTALLED, name, "installed", "installing");
+        }
+        catch (error) {
+            registered.setState("failed");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.FAILED, name, "failed", from, error);
+            throw error;
+        }
+    }
+    async initialize(registered, context) {
+        const name = registered.plugin.metadata.name;
+        const from = registered.state;
+        this.ensureTransition(registered, "initializing");
+        registered.setState("initializing");
+        emitLifecycleEvent(context, PLUGIN_EVENTS.INITIALIZING, name, "initializing", from);
+        try {
+            await registered.plugin.initialize?.(context);
+            this.ensureTransition(registered, "initialized");
+            registered.setState("initialized");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.INITIALIZED, name, "initialized", "initializing");
+        }
+        catch (error) {
+            registered.setState("failed");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.FAILED, name, "failed", from, error);
+            throw error;
+        }
+    }
+    async start(registered, context) {
+        const name = registered.plugin.metadata.name;
+        const from = registered.state;
+        this.ensureTransition(registered, "starting");
+        registered.setState("starting");
+        emitLifecycleEvent(context, PLUGIN_EVENTS.STARTING, name, "starting", from);
+        try {
+            await registered.plugin.start?.(context);
+            this.ensureTransition(registered, "started");
+            registered.setState("started");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.STARTED, name, "started", "starting");
+        }
+        catch (error) {
+            registered.setState("failed");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.FAILED, name, "failed", from, error);
+            throw error;
+        }
+    }
+    async stop(registered, context) {
+        const name = registered.plugin.metadata.name;
+        const from = registered.state;
+        this.ensureTransition(registered, "stopping");
+        registered.setState("stopping");
+        emitLifecycleEvent(context, PLUGIN_EVENTS.STOPPING, name, "stopping", from);
+        try {
+            await registered.plugin.stop?.(context);
+            this.ensureTransition(registered, "stopped");
+            registered.setState("stopped");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.STOPPED, name, "stopped", "stopping");
+        }
+        catch (error) {
+            registered.setState("failed");
+            emitLifecycleEvent(context, PLUGIN_EVENTS.FAILED, name, "failed", from, error);
+            throw error;
+        }
+    }
+    async dispose(registered, context) {
+        const name = registered.plugin.metadata.name;
+        const from = registered.state;
+        this.ensureTransition(registered, "disposing");
+        registered.setState("disposing");
+        emitLifecycleEvent(context, PLUGIN_EVENTS.DISPOSING, name, "disposing", from);
+        const errors = [];
+        for (const disposable of registered.disposables) {
+            try {
+                await disposable.dispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        try {
+            await registered.plugin.dispose?.(context);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        registered.setState("disposed");
+        emitLifecycleEvent(context, PLUGIN_EVENTS.DISPOSED, name, "disposed", "disposing");
+        if (errors.length > 0) {
+            throw errors[0];
+        }
+    }
+    ensureTransition(registered, to) {
+        const from = registered.state;
+        if (from === to) {
+            return;
+        }
+        const valid = VALID_STATE_TRANSITIONS[from]?.includes(to) ?? false;
+        if (!valid) {
+            throw new PluginStateError(registered.plugin.metadata.name, from, to);
+        }
+    }
+}
+//# sourceMappingURL=pluginLifecycle.core.js.map

package/dist/pluginLifecycle/pluginLifecycle.core.js.map

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

package/dist/pluginManager/pluginManager.core.d.ts

@@ -0,0 +1,22 @@
+import type { Plugin } from "../pluginTypes/plugin.type.js";
+import type { PluginContext } from "../pluginTypes/pluginContext.type.js";
+import type { PluginDiagnosticReport } from "../pluginDiagnostics/pluginDiagnostic.core.js";
+/**
+ * Plugin manager coordinates registration, dependency resolution, lifecycle, and disposal.
+ */
+export declare class PluginManager {
+    private readonly registry;
+    private readonly resolver;
+    private readonly lifecycle;
+    private readonly plugins;
+    constructor();
+    register<TPlugin extends Plugin>(plugin: TPlugin): void;
+    get<TPlugin extends Plugin>(name: string): TPlugin | undefined;
+    has(name: string): boolean;
+    list(): readonly Plugin[];
+    start(context: PluginContext): Promise<void>;
+    stop(context: PluginContext): Promise<void>;
+    diagnostics(): PluginDiagnosticReport;
+    private toDependencyMap;
+}
+//# sourceMappingURL=pluginManager.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pluginManager.core.d.ts","sourceRoot":"","sources":["../../src/pluginManager/pluginManager.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAwB1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAE5F;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,cAIC;IAEM,QAAQ,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAU7D;IAEM,GAAG,CAAC,OAAO,SAAS,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEpE;IAEM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhC;IAEM,IAAI,IAAI,SAAS,MAAM,EAAE,CAE/B;IAEY,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCxD;IAEY,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBvD;IAEM,WAAW,IAAI,sBAAsB,CAO3C;IAED,OAAO,CAAC,eAAe;CAwBxB"}