@zenbujs/core 0.0.9 → 0.0.13

package/dist/{runtime-BQWntcOb.d.mts → runtime-fnPDZFYM.d.mts}

@@ -1,4 +1,12 @@
+import { n as ContentScriptSpec, t as AdviceSpec } from "./advice-config-BiYhyeTz.mjs";
+
 //#region src/runtime.d.ts
+/**
+ * The synthetic plugin name used for everything that ships inside
+ * `@zenbujs/core`. Mirrors the `core` DB section so RPC, events, and the
+ * database all use the same top-level namespace.
+ */
+declare const CORE_PLUGIN_NAME = "core";
 type CleanupReason = "reload" | "shutdown";
 type SetupCleanup = ((reason: CleanupReason) => void | Promise<void>) | void;
 type SetupFn = () => SetupCleanup;
@@ -7,6 +15,15 @@ interface ServiceSlot {
   instance: Service | null;
   ServiceClass: ServiceConstructor;
   status: "blocked" | "evaluating" | "ready" | "failed";
+  /**
+   * Absolute directory of the plugin that owns this service file, resolved
+   * once at `runtime.register` time from the registering module's
+   * `import.meta.url`. `null` for core-package services that are not
+   * declared inside any plugin (`@zenbujs/core/services/*`). Read by
+   * `Service#advise` / `Service#contentScript` to anchor relative paths
+   * without forcing user code to pass `import.meta`.
+   */
+  pluginDir: string | null;
 }
 type AnyServiceClass = (abstract new (...args: any[]) => Service) & {
   key: string;
@@ -56,6 +73,40 @@ declare abstract class Service {
     ctx: ResolveCtx<TDeps>; /** @internal */
     __setupCleanups: Map<string, (reason: CleanupReason) => void | Promise<void>>;
     evaluate(): void | Promise<void>;
+    /**
+     * Register advice (component wrap/replace, function before/after/around)
+     * targeting another plugin's exports. The owning plugin's root directory
+     * is resolved automatically from this service's slot, so relative
+     * `modulePath` values just work.
+     *
+     *   this.setup("wrap-counter", () =>
+     *     this.advise({
+     *       view: "app",
+     *       moduleId: "App.tsx",
+     *       name: "Counter",
+     *       type: "around",
+     *       modulePath: "src/content/wrap-counter.tsx",
+     *       exportName: "WrapCounter",
+     *     }),
+     *   )
+     *
+     * Returns an unregister function — wrap the call in `this.setup(...)`
+     * so cleanup runs on hot reload.
+     */
+    advise(spec: AdviceSpec): () => void;
+    /**
+     * Inject a content script into a view. Same plugin-root resolution
+     * rules as `advise`.
+     *
+     *   this.setup("inject", () =>
+     *     this.injectContentScript({
+     *       view: "*",
+     *       modulePath: "src/content/toolbar.tsx",
+     *     }),
+     *   )
+     */
+    injectContentScript(spec: ContentScriptSpec): () => void; /** @internal */
+    __getPluginDir(method: string): string;
     setup(key: string, fn: SetupFn): void;
     /**
      * Run `fn` and return its result. Historically reported a boot-trace span;
@@ -77,6 +128,41 @@ declare abstract class Service {
   /** @internal */
   __setupCleanups: Map<string, (reason: CleanupReason) => void | Promise<void>>;
   evaluate(): void | Promise<void>;
+  /**
+   * Register advice (component wrap/replace, function before/after/around)
+   * targeting another plugin's exports. The owning plugin's root directory
+   * is resolved automatically from this service's slot, so relative
+   * `modulePath` values just work.
+   *
+   *   this.setup("wrap-counter", () =>
+   *     this.advise({
+   *       view: "app",
+   *       moduleId: "App.tsx",
+   *       name: "Counter",
+   *       type: "around",
+   *       modulePath: "src/content/wrap-counter.tsx",
+   *       exportName: "WrapCounter",
+   *     }),
+   *   )
+   *
+   * Returns an unregister function — wrap the call in `this.setup(...)`
+   * so cleanup runs on hot reload.
+   */
+  advise(spec: AdviceSpec): () => void;
+  /**
+   * Inject a content script into a view. Same plugin-root resolution
+   * rules as `advise`.
+   *
+   *   this.setup("inject", () =>
+   *     this.injectContentScript({
+   *       view: "*",
+   *       modulePath: "src/content/toolbar.tsx",
+   *     }),
+   *   )
+   */
+  injectContentScript(spec: ContentScriptSpec): () => void;
+  /** @internal */
+  __getPluginDir(method: string): string;
   setup(key: string, fn: SetupFn): void;
   /**
    * Run `fn` and return its result. Historically reported a boot-trace span;
@@ -126,7 +212,15 @@ declare class ServiceRuntime {
     key: string;
   }, cb: (instance: T | undefined) => void): () => void;
   private fireSubscribers;
-  buildRouter(): Record<string, Record<string, (...args: any[]) => any>>;
+  /**
+   * Build a 3-level router keyed by plugin name → service key → method.
+   * Mirrors how the database is sectioned (`root.<plugin>.<field>`) so a
+   * service's RPC surface lives under its owning plugin's namespace
+   * instead of polluting the top level. Core services bucket under
+   * `"core"` because the core package is registered as a synthetic
+   * plugin (see `getPluginRegistry`).
+   */
+  buildRouter(): Record<string, Record<string, Record<string, (...args: any[]) => any>>>;
   onReconciled(cb: (changedKeys: string[]) => void): () => void;
   private resolveDepSlot;
   private injectCtx;
@@ -183,7 +277,10 @@ declare function registerPlugin(record: PluginRecord): void;
 declare function unregisterPlugin(name: string): void;
 /**
  * Replace the entire plugin set in one shot. The loader uses this on every
- * barrel regeneration so removed plugins disappear cleanly.
+ * barrel regeneration so removed plugins disappear cleanly. The synthetic
+ * `core` plugin is always reseeded after the clear so user records cannot
+ * accidentally evict it (and a user record named `"core"` is rejected so
+ * the namespace stays unambiguous).
  */
 declare function replacePlugins(records: PluginRecord[]): void;
 declare function getPlugins(): PluginRecord[];
@@ -215,4 +312,4 @@ declare function getConfig(): ConfigSnapshot;
  */
 declare function subscribeConfig(callback: (snapshot: ConfigSnapshot) => void): () => void;
 //#endregion
-export { unregisterPlugin as _, ServiceConstructor as a, getConfig as c, getSplashPath as d, registerAppEntrypoint as f, subscribeConfig as g, runtime as h, Service as i, getPlugin as l, replacePlugins as m, ConfigSnapshot as n, ServiceRuntime as o, registerPlugin as p, PluginRecord as r, getAppEntrypoint as s, CleanupReason as t, getPlugins as u };
+export { subscribeConfig as _, Service as a, getAppEntrypoint as c, getPlugins as d, getSplashPath as f, runtime as g, replacePlugins as h, PluginRecord as i, getConfig as l, registerPlugin as m, CleanupReason as n, ServiceConstructor as o, registerAppEntrypoint as p, ConfigSnapshot as r, ServiceRuntime as s, CORE_PLUGIN_NAME as t, getPlugin as u, unregisterPlugin as v };

package/dist/runtime.d.mts

@@ -1,2 +1,2 @@
-import { _ as unregisterPlugin, a as ServiceConstructor, c as getConfig, d as getSplashPath, f as registerAppEntrypoint, g as subscribeConfig, h as runtime, i as Service, l as getPlugin, m as replacePlugins, n as ConfigSnapshot, o as ServiceRuntime, p as registerPlugin, r as PluginRecord, s as getAppEntrypoint, t as CleanupReason, u as getPlugins } from "./runtime-BQWntcOb.mjs";
-export { CleanupReason, ConfigSnapshot, PluginRecord, Service, ServiceConstructor, ServiceRuntime, getAppEntrypoint, getConfig, getPlugin, getPlugins, getSplashPath, registerAppEntrypoint, registerPlugin, replacePlugins, runtime, subscribeConfig, unregisterPlugin };
+import { _ as subscribeConfig, a as Service, c as getAppEntrypoint, d as getPlugins, f as getSplashPath, g as runtime, h as replacePlugins, i as PluginRecord, l as getConfig, m as registerPlugin, n as CleanupReason, o as ServiceConstructor, p as registerAppEntrypoint, r as ConfigSnapshot, s as ServiceRuntime, t as CORE_PLUGIN_NAME, u as getPlugin, v as unregisterPlugin } from "./runtime-fnPDZFYM.mjs";
+export { CORE_PLUGIN_NAME, CleanupReason, ConfigSnapshot, PluginRecord, Service, ServiceConstructor, ServiceRuntime, getAppEntrypoint, getConfig, getPlugin, getPlugins, getSplashPath, registerAppEntrypoint, registerPlugin, replacePlugins, runtime, subscribeConfig, unregisterPlugin };