@esauflores/plugin-sdk 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,429 @@
+// plugin-sdk: a plugin system for Bun and Node 24+. Its only dependency is @standard-schema/spec (types only).
+//
+// Lifecycle:  register/load → setup (all, in dependency order) → start (all) → stop (reverse order) → dispose
+import { HookBus } from "./hooks.js";
+import { isPlugin, parseWith, PluginError, TimeoutError, } from "./types.js";
+export * from "./types.js";
+export { HookBus, } from "./hooks.js";
+/** Identity helper for type inference. Untyped hooks/services; see `definePluginFor` for app-typed plugins. */
+export function definePlugin(plugin) {
+    return plugin;
+}
+/**
+ * Returns a `definePlugin` bound to your app's hook and service maps:
+ *   export const definePlugin = definePluginFor<MyHooks, MyServices>();
+ */
+export function definePluginFor() {
+    return (plugin) => plugin;
+}
+const HOST = "<host>";
+/**
+ * The host is single-use: once stopped it can't be started again. To reload plugins,
+ * create a new host (or restart the process; ES modules can't be unloaded).
+ */
+export class PluginHost {
+    app;
+    /** Host-owned view of the hook bus: emit hooks from your app through this. */
+    hooks;
+    #apiVersion;
+    #manifestKey;
+    #log;
+    #timeoutMs;
+    #failure;
+    #hookErrors;
+    #entries = new Map();
+    #services = new Map();
+    #listeners = new Set();
+    #order = [];
+    #phase = "idle";
+    #starting;
+    #stopping;
+    constructor(options) {
+        this.app = options.app;
+        this.hooks = new HookBus(options.hookSchemas, (error) => this.#onHookError(error));
+        this.#apiVersion = options.apiVersion ?? 1;
+        this.#manifestKey = options.manifestKey ?? options.app.name;
+        this.#log = options.logger ?? console;
+        this.#timeoutMs = options.timeoutMs ?? 10_000;
+        this.#failure = options.failure ?? "isolate";
+        this.#hookErrors = options.hookErrors ?? "log";
+    }
+    get phase() {
+        return this.#phase;
+    }
+    /** Adds a plugin object directly (local plugins, or ones you imported yourself). */
+    register(plugin, options) {
+        this.#add(plugin, options, "inline");
+        return this;
+    }
+    /**
+     * Loads installed plugin packages, resolving from `cwd`'s node_modules upwards.
+     * Imports run in parallel; plugins are registered in the order given.
+     * Under "isolate", a package that fails to load is listed as failed and skipped.
+     */
+    async load(specs, { cwd = process.cwd() } = {}) {
+        this.#assertPhase("idle", "load plugins");
+        // Imported lazily so the core never pulls in node:fs unless you load packages.
+        const { loadPluginPackage } = await import("./loader.js");
+        const normalized = specs.map((spec) => (typeof spec === "string" ? [spec, undefined] : spec));
+        const results = await Promise.allSettled(normalized.map(([specifier]) => loadPluginPackage(specifier, { cwd, apiVersion: this.#apiVersion, manifestKey: this.#manifestKey })));
+        for (const [i, result] of results.entries()) {
+            const [specifier, options] = normalized[i];
+            if (result.status === "fulfilled") {
+                this.#add(result.value, options, specifier);
+                continue;
+            }
+            if (this.#failure === "strict")
+                throw result.reason;
+            this.#log.error(result.reason);
+            if (!this.#entries.has(specifier)) {
+                this.#entries.set(specifier, {
+                    ...newEntry({ name: specifier, setup() { } }, options, specifier),
+                    state: "failed",
+                    reason: result.reason instanceof Error ? result.reason.message : String(result.reason),
+                    error: result.reason,
+                    tornDown: true,
+                });
+            }
+        }
+        return this;
+    }
+    /** Sets up every plugin, then starts every plugin, both in dependency order. */
+    start() {
+        this.#assertPhase("idle", "start");
+        this.#phase = "starting";
+        this.#starting = this.#start();
+        return this.#starting;
+    }
+    /** Stops started plugins in reverse order and tears everything down. Safe to call repeatedly or mid-start. */
+    stop() {
+        this.#stopping ??= (async () => {
+            await this.#starting?.catch(() => { });
+            await this.#shutdown();
+        })();
+        return this.#stopping;
+    }
+    /** Services provided by the host are usable by every plugin without declaring a dependency. */
+    provide(key, value) {
+        this.#provide(HOST, key, value);
+    }
+    service(key) {
+        return this.#services.get(key)?.value;
+    }
+    list() {
+        return [...this.#entries.values()].map(info);
+    }
+    get(name) {
+        const entry = this.#entries.get(name);
+        return entry && info(entry);
+    }
+    onStateChange(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    async #start() {
+        try {
+            const { order, unresolved } = resolveOrder([...this.#entries.values()].map((e) => e.plugin));
+            this.#order = order;
+            for (const name of unresolved) {
+                await this.#fail(this.#entries.get(name), "disabled", "setup", `dependency cycle among: ${unresolved.join(", ")}`);
+            }
+            for (const entry of this.#ordered("registered")) {
+                if (this.#stopping)
+                    return;
+                const blocker = this.#blockingDependency(entry, "setup");
+                if (blocker)
+                    await this.#fail(entry, "disabled", "setup", blocker);
+                else
+                    await this.#run(entry, "setup");
+            }
+            for (const entry of this.#ordered("setup")) {
+                if (this.#stopping)
+                    return;
+                const blocker = this.#blockingDependency(entry, "started");
+                if (blocker)
+                    await this.#fail(entry, "disabled", "start", blocker);
+                else
+                    await this.#run(entry, "start");
+            }
+            this.#phase = "started";
+        }
+        catch (error) {
+            await this.#shutdown();
+            throw error;
+        }
+    }
+    async #shutdown() {
+        if (this.#phase === "stopped")
+            return;
+        this.#phase = "stopping";
+        for (const name of [...this.#order].reverse()) {
+            const entry = this.#entries.get(name);
+            if (entry.state !== "started" && entry.state !== "setup")
+                continue;
+            await this.#stopEntry(entry, entry.state === "started");
+            this.#setState(entry, "stopped");
+        }
+        this.#phase = "stopped";
+    }
+    /** Aborts the signal, calls stop() if the plugin started, then tears it down. */
+    async #stopEntry(entry, callStop) {
+        entry.controller.abort(new Error("plugin is stopping"));
+        if (callStop && entry.plugin.stop) {
+            try {
+                await withTimeout(() => entry.plugin.stop(entry.ctx), this.#timeoutMs);
+            }
+            catch (error) {
+                entry.error = error;
+                this.#log.error(new PluginError(entry.plugin.name, "stop", "stop failed", { cause: error }));
+            }
+        }
+        await this.#teardown(entry);
+    }
+    async #onHookError(error) {
+        if (this.#hookErrors === "throw")
+            throw error;
+        this.#log.error(error);
+        const entry = this.#entries.get(error.plugin);
+        if (this.#hookErrors === "disable" && this.#phase === "started" && entry?.state === "started") {
+            await this.#disableAtRuntime(entry, error);
+        }
+    }
+    /** Stops a running plugin as failed, and the started plugins that depend on it (directly or not) as disabled. */
+    async #disableAtRuntime(culprit, error) {
+        const affected = new Set([culprit.plugin.name]);
+        // #order lists dependencies first, so one pass collects every transitive dependent.
+        for (const name of this.#order) {
+            if (this.#entries.get(name).plugin.dependsOn?.some((dep) => affected.has(dep)))
+                affected.add(name);
+        }
+        for (const name of [...this.#order].reverse()) {
+            const entry = this.#entries.get(name);
+            if (!affected.has(name) || entry.state !== "started")
+                continue;
+            // State changes first, so a concurrent hook error doesn't stop the same plugin twice.
+            if (entry === culprit) {
+                entry.reason = `disabled at runtime: ${error.reason}`;
+                entry.error = error;
+                this.#setState(entry, "failed");
+            }
+            else {
+                entry.reason = `dependency "${culprit.plugin.name}" is failed`;
+                this.#setState(entry, "disabled");
+                this.#log.warn(`[${name}] ${entry.reason}`);
+            }
+            await this.#stopEntry(entry, true);
+        }
+    }
+    *#ordered(state) {
+        for (const name of this.#order) {
+            const entry = this.#entries.get(name);
+            if (entry.state === state)
+                yield entry;
+        }
+    }
+    #blockingDependency(entry, needed) {
+        for (const dep of entry.plugin.dependsOn ?? []) {
+            const target = this.#entries.get(dep);
+            if (!target)
+                return `missing dependency "${dep}"`;
+            if (target.state !== needed)
+                return `dependency "${dep}" is ${target.state}`;
+        }
+        return undefined;
+    }
+    async #run(entry, phase) {
+        // Before the context exists, so ctx.options is the parsed value.
+        if (phase === "setup" && entry.plugin.optionsSchema) {
+            try {
+                entry.options = await parseWith(entry.plugin.optionsSchema, entry.options);
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                await this.#fail(entry, "failed", "setup", `invalid options: ${detail}`, error);
+                return;
+            }
+        }
+        const ctx = (entry.ctx ??= this.#createContext(entry));
+        const { plugin } = entry;
+        try {
+            await withTimeout(() => (phase === "setup" ? plugin.setup(ctx) : plugin.start?.(ctx)), this.#timeoutMs, entry.controller);
+        }
+        catch (error) {
+            await this.#fail(entry, "failed", phase, `${phase} failed: ${error instanceof Error ? error.message : String(error)}`, error);
+            return;
+        }
+        this.#setState(entry, phase === "setup" ? "setup" : "started");
+    }
+    /** Tears the plugin down and records why. Under "strict", also throws (and #start shuts everything down). */
+    async #fail(entry, state, phase, reason, error) {
+        entry.reason = reason;
+        entry.error = error;
+        await this.#teardown(entry);
+        this.#setState(entry, state);
+        const err = new PluginError(entry.plugin.name, phase, reason, error === undefined ? undefined : { cause: error });
+        if (this.#failure === "strict")
+            throw err;
+        if (state === "failed")
+            this.#log.error(err);
+        else
+            this.#log.warn(err.message);
+    }
+    async #teardown(entry) {
+        if (entry.tornDown)
+            return;
+        entry.tornDown = true;
+        if (!entry.controller.signal.aborted)
+            entry.controller.abort(new Error("plugin was torn down"));
+        for (const dispose of entry.disposers.splice(0).reverse()) {
+            try {
+                await withTimeout(dispose, this.#timeoutMs);
+            }
+            catch (error) {
+                this.#log.error(new PluginError(entry.plugin.name, "dispose", "disposer failed", { cause: error }));
+            }
+        }
+        this.hooks.removeOwner(entry.plugin.name);
+        for (const [key, service] of this.#services) {
+            if (service.owner === entry.plugin.name)
+                this.#services.delete(key);
+        }
+    }
+    #createContext(entry) {
+        const { name } = entry.plugin;
+        const allowed = new Set([name, HOST, ...(entry.plugin.dependsOn ?? []), ...(entry.plugin.optionalDependsOn ?? [])]);
+        const lookup = (key) => {
+            const service = this.#services.get(key);
+            if (service && !allowed.has(service.owner)) {
+                throw new PluginError(name, "service", `uses "${key}" from "${service.owner}" without listing "${service.owner}" in dependsOn`);
+            }
+            return service;
+        };
+        const tag = `[${this.app.name}:${name}]`;
+        return {
+            name,
+            options: entry.options,
+            app: this.app,
+            signal: entry.controller.signal,
+            log: {
+                debug: (...args) => this.#log.debug(tag, ...args),
+                info: (...args) => this.#log.info(tag, ...args),
+                warn: (...args) => this.#log.warn(tag, ...args),
+                error: (...args) => this.#log.error(tag, ...args),
+            },
+            hooks: this.hooks.scope(name),
+            provide: (key, value) => this.#provide(name, key, value),
+            use: (key) => {
+                const service = lookup(key);
+                if (!service)
+                    throw new PluginError(name, "service", `service "${key}" is not provided`);
+                return service.value;
+            },
+            tryUse: (key) => lookup(key)?.value,
+            onDispose: (fn) => {
+                if (entry.tornDown)
+                    throw new PluginError(name, "dispose", "onDispose called after the plugin was torn down");
+                entry.disposers.push(fn);
+            },
+        };
+    }
+    #provide(owner, key, value) {
+        const existing = this.#services.get(key);
+        if (existing) {
+            throw new PluginError(owner, "service", `service "${key}" is already provided by "${existing.owner}"`);
+        }
+        this.#services.set(key, { owner, value });
+    }
+    #add(plugin, options, source) {
+        this.#assertPhase("idle", "register plugins");
+        if (!isPlugin(plugin))
+            throw new PluginError(source, "register", "not a valid plugin (expected { name, setup })");
+        const existing = this.#entries.get(plugin.name);
+        if (existing)
+            throw new PluginError(plugin.name, "register", `already registered (from ${existing.source})`);
+        this.#entries.set(plugin.name, newEntry(plugin, options, source));
+    }
+    #setState(entry, state) {
+        const previous = entry.state;
+        entry.state = state;
+        for (const listener of this.#listeners) {
+            try {
+                listener(info(entry), previous);
+            }
+            catch (error) {
+                this.#log.error("onStateChange listener threw", error);
+            }
+        }
+    }
+    #assertPhase(expected, action) {
+        if (this.#phase !== expected)
+            throw new Error(`Cannot ${action}: host is ${this.#phase}`);
+    }
+}
+/**
+ * Orders plugins so dependencies come first. Ties keep registration order, so the
+ * result is deterministic. Dependencies that aren't registered are ignored here
+ * (the host reports them); plugins in, or blocked by, a cycle end up in `unresolved`.
+ */
+function resolveOrder(plugins) {
+    const names = new Set(plugins.map((p) => p.name));
+    const pending = plugins.map((p) => ({
+        name: p.name,
+        deps: [...(p.dependsOn ?? []), ...(p.optionalDependsOn ?? [])].filter((d) => names.has(d)),
+    }));
+    const done = new Set();
+    const order = [];
+    for (let i = 0; i < pending.length;) {
+        if (pending[i].deps.every((d) => done.has(d))) {
+            const [node] = pending.splice(i, 1);
+            order.push(node.name);
+            done.add(node.name);
+            i = 0;
+        }
+        else {
+            i++;
+        }
+    }
+    return { order, unresolved: pending.map((n) => n.name) };
+}
+/** Rejects after `ms` (and aborts `controller`). The underlying work can't be cancelled, only abandoned. */
+async function withTimeout(fn, ms, controller) {
+    if (!(ms > 0) || !Number.isFinite(ms))
+        return await fn();
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            const error = new TimeoutError(ms);
+            controller?.abort(error);
+            reject(error);
+        }, ms);
+    });
+    try {
+        return await Promise.race([Promise.resolve().then(fn), timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function newEntry(plugin, options, source) {
+    return {
+        plugin,
+        options,
+        source,
+        state: "registered",
+        controller: new AbortController(),
+        disposers: [],
+        tornDown: false,
+    };
+}
+function info(entry) {
+    return {
+        name: entry.plugin.name,
+        version: entry.plugin.version,
+        source: entry.source,
+        state: entry.state,
+        reason: entry.reason,
+        error: entry.error,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,EAAE;AACF,8GAA8G;AAE9G,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAOL,QAAQ,EAER,SAAS,EAET,WAAW,EAMX,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,OAAO,GAUR,MAAM,YAAY,CAAC;AAEpB,+GAA+G;AAC/G,MAAM,UAAU,YAAY,CAC1B,MAAwC;IAExC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAkC,MAAoC,EAAgC,EAAE,CAC7G,MAAM,CAAC;AACX,CAAC;AAED,MAAM,IAAI,GAAG,QAAQ,CAAC;AAetB;;;GAGG;AACH,MAAM,OAAO,UAAU;IACZ,GAAG,CAAU;IACtB,8EAA8E;IACrE,KAAK,CAAa;IAElB,WAAW,CAAS;IACpB,YAAY,CAAS;IACrB,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,QAAQ,CAAgB;IACxB,WAAW,CAAkB;IAE7B,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAC;IACpC,SAAS,GAAG,IAAI,GAAG,EAA6C,CAAC;IACjE,UAAU,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE/C,MAAM,GAAa,EAAE,CAAC;IACtB,MAAM,GAAc,MAAM,CAAC;IAC3B,SAAS,CAAiB;IAC1B,SAAS,CAAiB;IAE1B,YAAY,OAAuB;QACjC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,CAAI,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;IACjD,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,oFAAoF;IACpF,QAAQ,CAAW,MAA0B,EAAE,OAAW;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAErC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,KAA4B,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,GAAqB,EAAE;QACrF,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAE1C,+EAA+E;QAC/E,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAE1D,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,SAAS,CAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAC7B,iBAAiB,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CACpG,CACF,CAAC;QAEF,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAE3C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;gBAC5C,SAAS;YACX,CAAC;YAED,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;oBAC3B,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,KAAI,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC;oBAChE,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;oBACtF,KAAK,EAAE,MAAM,CAAC,MAAM;oBACpB,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gFAAgF;IAChF,KAAK;QACH,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAE/B,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,8GAA8G;IAC9G,IAAI;QACF,IAAI,CAAC,SAAS,KAAK,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACtC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACzB,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,+FAA+F;IAC/F,OAAO,CAA6B,GAAM,EAAE,KAAW;QACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAA6B,GAAM;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAyB,CAAC;IAC5D,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEtC,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,QAAuB;QACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE9B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7F,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YAEpB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,MAAM,IAAI,CAAC,KAAK,CACd,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,EACxB,UAAU,EACV,OAAO,EACP,2BAA2B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnD,CAAC;YACJ,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChD,IAAI,IAAI,CAAC,SAAS;oBAAE,OAAO;gBAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACzD,IAAI,OAAO;oBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;;oBAC9D,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACvC,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3C,IAAI,IAAI,CAAC,SAAS;oBAAE,OAAO;gBAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAC3D,IAAI,OAAO;oBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;;oBAC9D,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YAEvB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QAEtC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QAEzB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;YACvC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO;gBAAE,SAAS;YAEnE,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;YACxD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,UAAU,CAAC,KAAY,EAAE,QAAiB;QAC9C,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAExD,IAAI,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAK,CAAC,KAAK,CAAC,GAAI,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAkB;QACnC,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO;YAAE,MAAM,KAAK,CAAC;QAE9C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9F,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,iHAAiH;IACjH,KAAK,CAAC,iBAAiB,CAAC,OAAc,EAAE,KAAkB;QACxD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAEhD,oFAAoF;QACpF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtG,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,SAAS;YAE/D,sFAAsF;YACtF,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,KAAK,CAAC,MAAM,GAAG,wBAAwB,KAAK,CAAC,MAAM,EAAE,CAAC;gBACtD,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;gBACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,MAAM,GAAG,eAAe,OAAO,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC;gBAC/D,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,CAAC,QAAQ,CAAC,KAAkB;QAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;YACvC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;gBAAE,MAAM,KAAK,CAAC;QACzC,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,KAAY,EAAE,MAAmB;QACnD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEtC,IAAI,CAAC,MAAM;gBAAE,OAAO,uBAAuB,GAAG,GAAG,CAAC;YAClD,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM;gBAAE,OAAO,eAAe,GAAG,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/E,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAY,EAAE,KAAwB;QAC/C,iEAAiE;QACjE,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,KAAK,CAAC,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;gBAChF,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,WAAW,CACf,GAAG,EAAE,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,EACnE,IAAI,CAAC,UAAU,EACf,KAAK,CAAC,UAAU,CACjB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,KAAK,CACd,KAAK,EACL,QAAQ,EACR,KAAK,EACL,GAAG,KAAK,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC5E,KAAK,CACN,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,6GAA6G;IAC7G,KAAK,CAAC,KAAK,CACT,KAAY,EACZ,KAA4B,EAC5B,KAAiB,EACjB,MAAc,EACd,KAAe;QAEf,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACtB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE7B,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClH,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;QAE1C,IAAI,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;;YACxC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAY;QAC1B,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO;QAC3B,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAEhG,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACtG,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,cAAc,CAAC,KAAY;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEpH,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAExC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,WAAW,CACnB,IAAI,EACJ,SAAS,EACT,SAAS,GAAG,WAAW,OAAO,CAAC,KAAK,sBAAsB,OAAO,CAAC,KAAK,gBAAgB,CACxF,CAAC;YACJ,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC;QAEzC,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;YAC/B,GAAG,EAAE;gBACH,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBACjD,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAC/C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAC/C,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;aAClD;YACD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YAC7B,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC;YACxD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;gBACX,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC5B,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,GAAG,mBAAmB,CAAC,CAAC;gBAEzF,OAAO,OAAO,CAAC,KAAY,CAAC;YAC9B,CAAC;YACD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAY;YAC1C,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE;gBAChB,IAAI,KAAK,CAAC,QAAQ;oBAAE,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,iDAAiD,CAAC,CAAC;gBAE9G,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,GAAW,EAAE,KAAc;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,GAAG,6BAA6B,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;QACzG,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAgB,EAAE,MAAc;QACnD,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAE9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,+CAA+C,CAAC,CAAC;QAElH,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,QAAQ;YAAE,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,4BAA4B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAE7G,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,SAAS,CAAC,KAAY,EAAE,KAAkB;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;QAC7B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY,CAAC,QAAmB,EAAE,MAAc;QAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,OAA0B;IAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC3F,CAAC,CAAC,CAAC;IACJ,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;QACpC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEpB,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;aAAM,CAAC;YACN,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,4GAA4G;AAC5G,KAAK,UAAU,WAAW,CAAI,EAAwB,EAAE,EAAU,EAAE,UAA4B;IAC9F,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,MAAM,EAAE,EAAE,CAAC;IAEzD,IAAI,KAAgD,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAEnC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,OAAgB,EAAE,MAAc;IAChE,OAAO;QACL,MAAM;QACN,OAAO;QACP,MAAM;QACN,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,IAAI,eAAe,EAAE;QACjC,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,KAAY;IACxB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;QACvB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;AACJ,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,12 @@
+import { type Plugin } from "./types.ts";
+/**
+ * Finds an installed plugin package, checks its manifest, and imports its entry.
+ * Doesn't use require.resolve / import.meta.resolve, which behave differently
+ * across runtimes and with ESM-only packages.
+ */
+export declare function loadPluginPackage(specifier: string, opts: {
+    cwd: string;
+    apiVersion: number;
+    manifestKey: string;
+}): Promise<Plugin>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAOA,OAAO,EAAyB,KAAK,MAAM,EAAuB,MAAM,YAAY,CAAC;AAErF;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,MAAM,CAAC,CAyCjB"}

package/dist/loader.js

@@ -0,0 +1,78 @@
+// The only module that touches the filesystem. index.ts imports it lazily from
+// PluginHost.load(), so the core runs without Node APIs when you only use register().
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { readFile, stat } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { isPlugin, PluginError } from "./types.js";
+/**
+ * Finds an installed plugin package, checks its manifest, and imports its entry.
+ * Doesn't use require.resolve / import.meta.resolve, which behave differently
+ * across runtimes and with ESM-only packages.
+ */
+export async function loadPluginPackage(specifier, opts) {
+    const fail = (message, cause) => new PluginError(specifier, "load", message, cause === undefined ? undefined : { cause });
+    const dir = await findPackageDir(specifier, opts.cwd);
+    if (!dir)
+        throw fail(`package not found from ${opts.cwd} (is it installed?)`);
+    let pkg;
+    try {
+        pkg = JSON.parse(await readFile(join(dir, "package.json"), "utf8"));
+    }
+    catch (error) {
+        throw fail(`could not read ${join(dir, "package.json")}`, error);
+    }
+    const manifest = pkg[opts.manifestKey];
+    if (!manifest || typeof manifest !== "object") {
+        throw fail(`not a plugin: package.json has no "${opts.manifestKey}" field`);
+    }
+    if (manifest.apiVersion !== opts.apiVersion) {
+        const declared = typeof manifest.apiVersion === "number" ? `v${manifest.apiVersion}` : "no version";
+        throw fail(`targets plugin API ${declared}, but this host supports v${opts.apiVersion}`);
+    }
+    if (typeof manifest.entry !== "string") {
+        throw fail(`manifest "${opts.manifestKey}" has no "entry" (e.g. "./dist/index.js")`);
+    }
+    const entry = resolve(dir, manifest.entry);
+    let mod;
+    try {
+        mod = await import(__rewriteRelativeImportExtension(pathToFileURL(entry).href));
+    }
+    catch (error) {
+        throw fail(`failed to import ${entry}`, error);
+    }
+    const plugin = mod.default ?? mod.plugin;
+    if (!isPlugin(plugin))
+        throw fail(`${entry} must export a plugin ({ name, setup }) as its default export`);
+    return plugin;
+}
+async function findPackageDir(specifier, cwd) {
+    if (specifier.startsWith(".") || isAbsolute(specifier)) {
+        const dir = resolve(cwd, specifier);
+        return (await isFile(join(dir, "package.json"))) ? dir : undefined;
+    }
+    // Same lookup Node does: node_modules in cwd, then each parent directory.
+    for (let dir = resolve(cwd);; dir = dirname(dir)) {
+        const candidate = join(dir, "node_modules", specifier);
+        if (await isFile(join(candidate, "package.json")))
+            return candidate;
+        if (dirname(dir) === dir)
+            return undefined;
+    }
+}
+async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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