obsidian-dev-utils 101.6.0 → 101.7.0

package/dist/lib/cjs/obsidian/plugin/plugin-install-state.d.cts

@@ -0,0 +1,113 @@
+/// <reference path="../../library.d.cts" />
+/**
+ * @file
+ *
+ * How another plugin is present in this vault, and the one-click path to making it present.
+ *
+ * Shared by the two components that ask a user to bring another plugin in: `PluginSuggestionComponent`,
+ * which OFFERS one and keeps working without it, and `PluginGateComponent`, which REQUIRES one and
+ * does nothing until it is there. The offer and the requirement differ in what they do about the answer,
+ * not in how they read the state or how they install — so that part lives here rather than in both.
+ */
+import type { App } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { PluginNoticeComponent } from '../components/plugin-notice-component.cjs';
+/**
+ * How another plugin is currently present in the vault.
+ */
+export declare enum InstalledPluginState {
+    /**
+     * Installed and enabled — there is nothing to do.
+     */
+    Enabled = "enabled",
+    /**
+     * Installed but disabled. Only an enable is needed, so no download happens.
+     */
+    InstalledButDisabled = "installedButDisabled",
+    /**
+     * Not installed at all.
+     */
+    NotInstalled = "notInstalled"
+}
+/**
+ * Parameters for {@link getInstalledPluginState}.
+ */
+export interface GetInstalledPluginStateParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The `manifest.id` of the plugin to look for.
+     */
+    readonly pluginId: string;
+}
+/**
+ * Parameters for {@link getInstalledPluginVersion}.
+ */
+export interface GetInstalledPluginVersionParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The `manifest.id` of the plugin to look for.
+     */
+    readonly pluginId: string;
+}
+/**
+ * Parameters for {@link installAndEnablePlugin}.
+ */
+export interface InstallAndEnablePluginParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The `manifest.id` of the plugin to install and enable.
+     */
+    readonly pluginId: string;
+    /**
+     * The display name of the plugin, shown to the user.
+     */
+    readonly pluginName: string;
+    /**
+     * The notice component of the plugin doing the asking, used to report the outcome.
+     */
+    readonly pluginNoticeComponent: PluginNoticeComponent;
+}
+/**
+ * Resolves how another plugin is currently present in the vault.
+ *
+ * @param params - The {@link GetInstalledPluginStateParams}.
+ * @returns The {@link InstalledPluginState}.
+ */
+export declare function getInstalledPluginState(params: GetInstalledPluginStateParams): InstalledPluginState;
+/**
+ * Reads the version of another plugin as this vault has it installed, or `null` when it is not running.
+ *
+ * The version comes out of `app.plugins.manifests`, which is populated for every installed plugin at
+ * startup — so, unlike anything a plugin REGISTERS, it answers the same way no matter which plugin loaded
+ * first. That load-order independence is the whole reason a conflict is detected by version rather than by
+ * asking a registry.
+ *
+ * `null` for a plugin that is not installed OR is installed but disabled: a disabled plugin registers
+ * nothing, so for every question this answers the two cases are the same. An installed, enabled plugin
+ * whose manifest somehow carries no version reads as an empty string rather than `null`, which keeps
+ * "running, version unknown" distinguishable from "not running" — a caller comparing versions should fail
+ * closed on it rather than treat it as absent.
+ *
+ * @param params - The {@link GetInstalledPluginVersionParams}.
+ * @returns The installed version, or `null` when the plugin is not enabled.
+ */
+export declare function getInstalledPluginVersion(params: GetInstalledPluginVersionParams): null | string;
+/**
+ * Installs (when needed) and enables another plugin, reporting the outcome as a notice.
+ *
+ * A no-op when the plugin is already enabled, so a caller reacting to a click need not check first.
+ *
+ * @param params - The {@link InstallAndEnablePluginParams}.
+ * @returns A {@link Promise} that resolves once the plugin is enabled.
+ * @throws Whatever the install or enable threw, after reporting it as a notice — the caller decides
+ * whether a failure is worth more than the notice the user has already seen.
+ */
+export declare function installAndEnablePlugin(params: InstallAndEnablePluginParams): Promise<void>;

package/dist/lib/cjs/obsidian/plugin/plugin-lifecycle-events.cjs

@@ -0,0 +1,161 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+function keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  globalThisRecord['__name'] ??= keepName;
+  const originalRequire = require;
+  if (originalRequire && !originalRequire.__isPatched) {
+    // eslint-disable-next-line no-global-assign, no-implicit-globals -- We need to patch the `require()` function.
+    require = Object.assign(
+      (id) => requirePatched(id),
+      originalRequire,
+      {
+        __isPatched: true
+      }
+    );
+  }
+
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
+  '@codemirror/autocomplete',
+  '@codemirror/collab',
+  '@codemirror/commands',
+  '@codemirror/language',
+  '@codemirror/lint',
+  '@codemirror/search',
+  '@codemirror/state',
+  '@codemirror/text',
+  '@codemirror/view',
+  '@lezer/common',
+  '@lezer/highlight',
+  '@lezer/lr',
+  'obsidian']
+  );
+
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
+  '@codemirror/closebrackets',
+  '@codemirror/comment',
+  '@codemirror/fold',
+  '@codemirror/gutter',
+  '@codemirror/highlight',
+  '@codemirror/history',
+  '@codemirror/matchbrackets',
+  '@codemirror/panel',
+  '@codemirror/rangeset',
+  '@codemirror/rectangular-selection',
+  '@codemirror/stream-parser',
+  '@codemirror/tooltip']
+  );
+
+  function requirePatched(id) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/no-global-this  -- Need access to app. Actively use globalThis.
+    if (globalThis.app.isMobile) {
+      if (id === 'process' || id === 'node:process') {
+        // eslint-disable-next-line no-console -- Valid usage.
+        console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
+
+        return process;
+      }
+    } else {
+      const module = originalRequire?.(id);
+      if (module) {
+        return extractDefault(module);
+      }
+    }
+
+    // eslint-disable-next-line no-console -- Valid usage.
+    console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Empty object is returned instead.`);
+    return {};
+  }
+})();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var plugin_lifecycle_events_exports = {};
+__export(plugin_lifecycle_events_exports, {
+  PLUGIN_LOADED_EVENT_NAME: () => PLUGIN_LOADED_EVENT_NAME,
+  PLUGIN_UNLOADED_EVENT_NAME: () => PLUGIN_UNLOADED_EVENT_NAME,
+  triggerPluginLifecycleEvent: () => triggerPluginLifecycleEvent
+});
+module.exports = __toCommonJS(plugin_lifecycle_events_exports);
+const PLUGIN_LOADED_EVENT_NAME = "obsidian-dev-utils:plugin-loaded";
+const PLUGIN_UNLOADED_EVENT_NAME = "obsidian-dev-utils:plugin-unloaded";
+function triggerPluginLifecycleEvent(params) {
+  params.app.workspace.trigger(params.name, params.payload);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PLUGIN_LOADED_EVENT_NAME,
+  PLUGIN_UNLOADED_EVENT_NAME,
+  triggerPluginLifecycleEvent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL3BsdWdpbi9wbHVnaW4tbGlmZWN5Y2xlLWV2ZW50cy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBsaWZlY3ljbGUgYnJvYWRjYXN0IGV2ZXJ5IHtAbGluayBQbHVnaW5CYXNlfSBtYWtlczogYG9ic2lkaWFuLWRldi11dGlsczpwbHVnaW4tbG9hZGVkYCB3aGVuIGl0IGhhc1xuICogZmluaXNoZWQgbG9hZGluZyBhbmQgYG9ic2lkaWFuLWRldi11dGlsczpwbHVnaW4tdW5sb2FkZWRgIHdoZW4gaXQgZ29lcyBhd2F5LlxuICpcbiAqIE9ic2lkaWFuIGdpdmVzIGEgcGx1Z2luIG5vIHdheSB0byBsZWFybiB0aGF0IEFOT1RIRVIgcGx1Z2luIHdhcyBlbmFibGVkIG9yIGRpc2FibGVkIFx1MjAxNCB0aGVyZSBpcyBubyBzdWNoXG4gKiBldmVudCBvbiBgYXBwLnBsdWdpbnNgLCBhbmQgYSBwbHVnaW4ncyBvd24gYEV2ZW50c2Agc291cmNlIGNhbm5vdCBoZWxwIGEgbGlzdGVuZXIgdGhhdCBkb2VzIG5vdCB5ZXQgaG9sZFxuICogdGhlIGluc3RhbmNlLiBTbyB0aGUgYnJvYWRjYXN0IGdvZXMgdGhyb3VnaCBgYXBwLndvcmtzcGFjZWAsIHdoaWNoIGlzIG9uZSBvYmplY3QgZXZlcnkgcGx1Z2luIGluIHRoZVxuICogdmF1bHQgY2FuIHJlYWNoLiBEZWxpYmVyYXRlbHkgTk9UIHRoZSBgZ2xvYmFsVGhpcy5fX29ic2lkaWFuRGV2VXRpbHNgIGJhZyB0aGUgcmVzdCBvZiB0aGUgbGlicmFyeSBzaGFyZXNcbiAqIGl0cyBzdGF0ZSB0aHJvdWdoOiBhIGxpc3RlbmVyIHRoZXJlIG5lZWRzIGl0cyBvd24gY29weSBvZiB0aGlzIGxpYnJhcnksIGFuZCB0aGVzZSBldmVudHMgYXJlIG1lYW50IHRvIGJlXG4gKiBjb25zdW1hYmxlIGJ5IGFueSBwbHVnaW4gYXQgYWxsLlxuICpcbiAqIFRoZSBuYW1lcyBhcmUgcGFzdCB0ZW5zZSBiZWNhdXNlIGEgYnJvYWRjYXN0IHN0YXRlcyBzb21ldGhpbmcgdGhhdCBoYXMgYWxyZWFkeSBoYXBwZW5lZC4gYGxvYWRlZGAgaW5cbiAqIHBhcnRpY3VsYXIgY2FycmllcyBhIGd1YXJhbnRlZTogaXQgaXMgdHJpZ2dlcmVkIG9ubHkgYWZ0ZXIgZXZlcnkgQVBJIHRoZSBwbHVnaW4gZGVjbGFyZXMgaGFzIGJlZW5cbiAqIHB1Ymxpc2hlZCwgc28gYSBsaXN0ZW5lciBtYXkgY2FsbCB0aGVtIGltbWVkaWF0ZWx5LlxuICpcbiAqIEJvdGggdGhlIGV2ZW50IG5hbWVzIGFuZCB7QGxpbmsgUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXlsb2FkfSBhcmUgYSBDUk9TUy1WRVJTSU9OIENPTlRSQUNULiBDb3BpZXMgb2ZcbiAqIHRoaXMgbGlicmFyeSBhdCBkaWZmZXJlbnQgdmVyc2lvbnMgcHVibGlzaCBhbmQgY29uc3VtZSB0aGVtIHNpZGUgYnkgc2lkZSBpbiBvbmUgdmF1bHQsIHNvIG5laXRoZXIgbWF5XG4gKiBjaGFuZ2UgaW5jb21wYXRpYmx5OiBwbGFpbiBkYXRhIG9ubHksIGFuZCBuZXcgcGF5bG9hZCBmaWVsZHMgb25seSBldmVyIGFkZGVkLlxuICovXG5cbmltcG9ydCB0eXBlIHsgQXBwIH0gZnJvbSAnb2JzaWRpYW4nO1xuXG4vKipcbiAqIFRoZSBuYW1lIG9mIGVpdGhlciBsaWZlY3ljbGUgZXZlbnQuXG4gKi9cbmV4cG9ydCB0eXBlIFBsdWdpbkxpZmVjeWNsZUV2ZW50TmFtZSA9IHR5cGVvZiBQTFVHSU5fTE9BREVEX0VWRU5UX05BTUUgfCB0eXBlb2YgUExVR0lOX1VOTE9BREVEX0VWRU5UX05BTUU7XG5cbi8qKlxuICogVGhlIHBheWxvYWQgb2Yge0BsaW5rIFBMVUdJTl9MT0FERURfRVZFTlRfTkFNRX0gYW5kIHtAbGluayBQTFVHSU5fVU5MT0FERURfRVZFTlRfTkFNRX0uXG4gKlxuICogUGxhaW4gZGF0YSBieSBkZXNpZ24gXHUyMDE0IG5vIGNsYXNzIGluc3RhbmNlcyBhbmQgbm8gdHlwZXMgb3duZWQgYnkgdGhpcyBsaWJyYXJ5IFx1MjAxNCBiZWNhdXNlIGl0IGNyb3NzZXNcbiAqIGJldHdlZW4gaW5kZXBlbmRlbnRseSBidW5kbGVkIGNvcGllcyBvZiBpdCwgYW5kIGJldHdlZW4gcGx1Z2lucyB0aGF0IGRvIG5vdCB1c2UgaXQgYXQgYWxsLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFBsdWdpbkxpZmVjeWNsZUV2ZW50UGF5bG9hZCB7XG4gIC8qKlxuICAgKiBUaGUgY29udHJhY3QgdmVyc2lvbnMgdGhlIHBsdWdpbiBwdWJsaXNoZWQsIGVtcHR5IHdoZW4gaXQgcHVibGlzaGVzIG5vIEFQSS5cbiAgICpcbiAgICogQW4gYXJyYXkgcmF0aGVyIHRoYW4gYSBzaW5nbGUgdmVyc2lvbiBiZWNhdXNlIGEgcHJvdmlkZXIgbWF5IHB1Ymxpc2ggc2V2ZXJhbCBjb250cmFjdCB2ZXJzaW9ucyBzaWRlIGJ5XG4gICAqIHNpZGUsIHNvIGNvbnN1bWVycyBwaW5uZWQgdG8gYW4gb2xkZXIgcmFuZ2Uga2VlcCB3b3JraW5nIGFjcm9zcyBhIGJyZWFraW5nIGNoYW5nZS5cbiAgICpcbiAgICogVGhlIEFQSSBvYmplY3RzIHRoZW1zZWx2ZXMgYXJlIGRlbGliZXJhdGVseSBOT1QgaGVyZS4gQSBoYW5kbGUgZGVsaXZlcmVkIGJ5IGEgb25lLXNob3QgZXZlbnQgaXMgYVxuICAgKiBwcm9iZTogaXQgYW5zd2VycyBcIm5vd1wiIGFuZCBuZXZlciBzYXlzIHdoZW4gXCJub3dcIiBjaGFuZ2VkLCBhbmQgb25lIHRoYXQgb3V0bGl2ZXMgdGhlIHByb3ZpZGVyIGlzXG4gICAqIGV4YWN0bHkgdGhlIHN0YWxlIGhhbmRsZSB0aGUgcGx1Z2luLWFwaSByZWdpc3RyeSdzIHJldm9jYWJsZSBoYW5kbGVzIGV4aXN0IHRvIHByZXZlbnQuIFJlYWNoIHRoZSBBUElcbiAgICogdGhyb3VnaCBgd2F0Y2hQbHVnaW5BcGlgIGluc3RlYWQsIHdob3NlIHJlZmVyZW5jZSBzdGF5cyBjb3JyZWN0IGFjcm9zcyB1bmxvYWQgYW5kIHJlLWVuYWJsZS5cbiAgICovXG4gIHJlYWRvbmx5IGFwaVZlcnNpb25zOiByZWFkb25seSBzdHJpbmdbXTtcblxuICAvKipcbiAgICogVGhlIGlkcyBvZiB0aGUgcGx1Z2lucyB0aGlzIG9uZSBkZWNsYXJlcyBhcyBtYW5kYXRvcnkgZGVwZW5kZW5jaWVzLCBlbXB0eSB3aGVuIGl0IGRlY2xhcmVzIG5vbmUuXG4gICAqXG4gICAqIFByZXNlbnQgc28gdGhlIHJlbGF0aW9uc2hpcCBjYW4gYmUgcmVhZCBmcm9tIHRoZSBPVEhFUiBlbmQ6IGEgcHJvdmlkZXIgaGFzIG5vIHdheSB0byBhc2sgd2hvIGRlcGVuZHNcbiAgICogb24gaXQgXHUyMDE0IHRoZSByZWdpc3RyeSBvbmx5IGFuc3dlcnMgY29uc3VtZXItdG8tcHJvdmlkZXIgXHUyMDE0IGFuZCBcIndoaWNoIGluc3RhbGxlZCBwbHVnaW5zIG5lZWQgdGhpcyBvbmVcIlxuICAgKiBpcyB3aGF0IGxldHMgYSBwcm92aWRlcidzIHNldHRpbmdzIHRhYiB0ZWxsIHRoZSB1c2VyIHdoeSBpdCBpcyBpbiB0aGVpciB2YXVsdCBhdCBhbGwuXG4gICAqL1xuICByZWFkb25seSBkZXBlbmRlbmN5UGx1Z2luSWRzOiByZWFkb25seSBzdHJpbmdbXTtcblxuICAvKipcbiAgICogVGhlIHBsdWdpbidzIGBtYW5pZmVzdC5pZGAuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgcGx1Z2luJ3MgYG1hbmlmZXN0Lm5hbWVgLCBmb3IgZGlzcGxheS5cbiAgICovXG4gIHJlYWRvbmx5IHBsdWdpbk5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHBsdWdpbidzIGBtYW5pZmVzdC52ZXJzaW9uYC5cbiAgICovXG4gIHJlYWRvbmx5IHBsdWdpblZlcnNpb246IHN0cmluZztcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgdHJpZ2dlclBsdWdpbkxpZmVjeWNsZUV2ZW50fS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUcmlnZ2VyUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXJhbXMge1xuICAvKipcbiAgICogVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZSB3aG9zZSB3b3Jrc3BhY2UgY2FycmllcyB0aGUgYnJvYWRjYXN0LlxuICAgKi9cbiAgcmVhZG9ubHkgYXBwOiBBcHA7XG5cbiAgLyoqXG4gICAqIFRoZSBldmVudCB0byB0cmlnZ2VyLlxuICAgKi9cbiAgcmVhZG9ubHkgbmFtZTogUGx1Z2luTGlmZWN5Y2xlRXZlbnROYW1lO1xuXG4gIC8qKlxuICAgKiBUaGUgcGF5bG9hZCBkZXNjcmliaW5nIHRoZSBwbHVnaW4uXG4gICAqL1xuICByZWFkb25seSBwYXlsb2FkOiBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWQ7XG59XG5cbi8qKlxuICogVHJpZ2dlcmVkIG9uY2UgYSBwbHVnaW4gaGFzIGZpbmlzaGVkIGxvYWRpbmcgQU5EIHB1Ymxpc2hlZCBldmVyeSBBUEkgaXQgZGVjbGFyZXMsIHNvIGEgbGlzdGVuZXIgbWF5IGNhbGxcbiAqIHRob3NlIEFQSXMgaW1tZWRpYXRlbHkuXG4gKlxuICogTmFtZXNwYWNlZCBieSB0aGUgcGFja2FnZSBuYW1lIHJhdGhlciB0aGFuIGJ5IGFuIGFiYnJldmlhdGlvbiBvZiBpdDogdGhlIGV2ZW50IGlzIGdsb2JhbCB0byB0aGUgdmF1bHRcbiAqIGFuZCBhaW1lZCBhdCBwbHVnaW4gYXV0aG9ycyB3aG8gaGF2ZSBuZXZlciBoZWFyZCBvZiB0aGlzIGxpYnJhcnksIHNvIHRoZSBwcmVmaXggaGFzIHRvIGlkZW50aWZ5IGl0c2VsZi5cbiAqL1xuZXhwb3J0IGNvbnN0IFBMVUdJTl9MT0FERURfRVZFTlRfTkFNRSA9ICdvYnNpZGlhbi1kZXYtdXRpbHM6cGx1Z2luLWxvYWRlZCc7XG5cbi8qKlxuICogVHJpZ2dlcmVkIGFzIGEgcGx1Z2luIHVubG9hZHMgXHUyMDE0IHdoZXRoZXIgdGhlIHVzZXIgZGlzYWJsZWQgaXQsIHVuaW5zdGFsbGVkIGl0LCBvciBPYnNpZGlhbiBpcyBzaHV0dGluZ1xuICogZG93bi4gSXRzIEFQSXMgYXJlIHJldm9rZWQgYnkgdGhlIHRpbWUgYSBsaXN0ZW5lciBydW5zLlxuICovXG5leHBvcnQgY29uc3QgUExVR0lOX1VOTE9BREVEX0VWRU5UX05BTUUgPSAnb2JzaWRpYW4tZGV2LXV0aWxzOnBsdWdpbi11bmxvYWRlZCc7XG5cbmRlY2xhcmUgbW9kdWxlICdvYnNpZGlhbicge1xuICBpbnRlcmZhY2UgV29ya3NwYWNlIHtcbiAgICAvKipcbiAgICAgKiBTdWJzY3JpYmVzIHRvIGEgcGx1Z2luIGZpbmlzaGluZyBpdHMgbG9hZCwgb3IgdG8gb25lIHVubG9hZGluZy5cbiAgICAgKlxuICAgICAqIEBwYXJhbSBuYW1lIC0gU2hvdWxkIGJlIHtAbGluayBQTFVHSU5fTE9BREVEX0VWRU5UX05BTUV9IG9yIHtAbGluayBQTFVHSU5fVU5MT0FERURfRVZFTlRfTkFNRX0uXG4gICAgICogQHBhcmFtIGNhbGxiYWNrIC0gVGhlIGNhbGxiYWNrIHJlY2VpdmluZyB0aGUgcGx1Z2luJ3MgcGF5bG9hZC5cbiAgICAgKiBAcGFyYW0gY29udGV4dCAtIFRoZSBjb250ZXh0IHBhc3NlZCBhcyBgdGhpc2AgdG8gdGhlIGBjYWxsYmFja2AgZnVuY3Rpb24uXG4gICAgICogQHJldHVybnMgVGhlIGV2ZW50IHJlZmVyZW5jZS5cbiAgICAgKi9cbiAgICBvbihuYW1lOiBQbHVnaW5MaWZlY3ljbGVFdmVudE5hbWUsIGNhbGxiYWNrOiAocGF5bG9hZDogUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXlsb2FkKSA9PiB1bmtub3duLCBjb250ZXh0PzogdW5rbm93bik6IEV2ZW50UmVmO1xuICB9XG59XG5cbi8qKlxuICogVHJpZ2dlcnMgb25lIG9mIHRoZSB0d28gbGlmZWN5Y2xlIGV2ZW50cyBvbiB0aGUgYXBwJ3Mgd29ya3NwYWNlLlxuICpcbiAqIEEgdGhpbiB0eXBlZCB3cmFwcGVyIG92ZXIgYFdvcmtzcGFjZS50cmlnZ2VyYCwgd2hpY2ggYWNjZXB0cyBhbnkgZXZlbnQgbmFtZSBhbmQgYW55IGFyZ3VtZW50cywgc28gdGhhdFxuICogdGhlIG9uZSBwbGFjZSBhIHBheWxvYWQgaXMgY29uc3RydWN0ZWQgaXMgY2hlY2tlZCBhZ2FpbnN0IHtAbGluayBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWR9LlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIFRyaWdnZXJQbHVnaW5MaWZlY3ljbGVFdmVudFBhcmFtc30uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0cmlnZ2VyUGx1Z2luTGlmZWN5Y2xlRXZlbnQocGFyYW1zOiBUcmlnZ2VyUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXJhbXMpOiB2b2lkIHtcbiAgcGFyYW1zLmFwcC53b3Jrc3BhY2UudHJpZ2dlcihwYXJhbXMubmFtZSwgcGFyYW1zLnBheWxvYWQpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBcUdPLE1BQU0sMkJBQTJCO0FBTWpDLE1BQU0sNkJBQTZCO0FBd0JuQyxTQUFTLDRCQUE0QixRQUFpRDtBQUMzRixTQUFPLElBQUksVUFBVSxRQUFRLE9BQU8sTUFBTSxPQUFPLE9BQU87QUFDMUQ7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/obsidian/plugin/plugin-lifecycle-events.d.cts

@@ -0,0 +1,119 @@
+/// <reference path="../../library.d.cts" />
+/**
+ * @file
+ *
+ * The lifecycle broadcast every {@link PluginBase} makes: `obsidian-dev-utils:plugin-loaded` when it has
+ * finished loading and `obsidian-dev-utils:plugin-unloaded` when it goes away.
+ *
+ * Obsidian gives a plugin no way to learn that ANOTHER plugin was enabled or disabled — there is no such
+ * event on `app.plugins`, and a plugin's own `Events` source cannot help a listener that does not yet hold
+ * the instance. So the broadcast goes through `app.workspace`, which is one object every plugin in the
+ * vault can reach. Deliberately NOT the `globalThis.__obsidianDevUtils` bag the rest of the library shares
+ * its state through: a listener there needs its own copy of this library, and these events are meant to be
+ * consumable by any plugin at all.
+ *
+ * The names are past tense because a broadcast states something that has already happened. `loaded` in
+ * particular carries a guarantee: it is triggered only after every API the plugin declares has been
+ * published, so a listener may call them immediately.
+ *
+ * Both the event names and {@link PluginLifecycleEventPayload} are a CROSS-VERSION CONTRACT. Copies of
+ * this library at different versions publish and consume them side by side in one vault, so neither may
+ * change incompatibly: plain data only, and new payload fields only ever added.
+ */
+import type { App } from 'obsidian' with { 'resolution-mode': 'import' };
+/**
+ * The name of either lifecycle event.
+ */
+export type PluginLifecycleEventName = typeof PLUGIN_LOADED_EVENT_NAME | typeof PLUGIN_UNLOADED_EVENT_NAME;
+/**
+ * The payload of {@link PLUGIN_LOADED_EVENT_NAME} and {@link PLUGIN_UNLOADED_EVENT_NAME}.
+ *
+ * Plain data by design — no class instances and no types owned by this library — because it crosses
+ * between independently bundled copies of it, and between plugins that do not use it at all.
+ */
+export interface PluginLifecycleEventPayload {
+    /**
+     * The contract versions the plugin published, empty when it publishes no API.
+     *
+     * An array rather than a single version because a provider may publish several contract versions side by
+     * side, so consumers pinned to an older range keep working across a breaking change.
+     *
+     * The API objects themselves are deliberately NOT here. A handle delivered by a one-shot event is a
+     * probe: it answers "now" and never says when "now" changed, and one that outlives the provider is
+     * exactly the stale handle the plugin-api registry's revocable handles exist to prevent. Reach the API
+     * through `watchPluginApi` instead, whose reference stays correct across unload and re-enable.
+     */
+    readonly apiVersions: readonly string[];
+    /**
+     * The ids of the plugins this one declares as mandatory dependencies, empty when it declares none.
+     *
+     * Present so the relationship can be read from the OTHER end: a provider has no way to ask who depends
+     * on it — the registry only answers consumer-to-provider — and "which installed plugins need this one"
+     * is what lets a provider's settings tab tell the user why it is in their vault at all.
+     */
+    readonly dependencyPluginIds: readonly string[];
+    /**
+     * The plugin's `manifest.id`.
+     */
+    readonly pluginId: string;
+    /**
+     * The plugin's `manifest.name`, for display.
+     */
+    readonly pluginName: string;
+    /**
+     * The plugin's `manifest.version`.
+     */
+    readonly pluginVersion: string;
+}
+/**
+ * Parameters for {@link triggerPluginLifecycleEvent}.
+ */
+export interface TriggerPluginLifecycleEventParams {
+    /**
+     * The Obsidian app instance whose workspace carries the broadcast.
+     */
+    readonly app: App;
+    /**
+     * The event to trigger.
+     */
+    readonly name: PluginLifecycleEventName;
+    /**
+     * The payload describing the plugin.
+     */
+    readonly payload: PluginLifecycleEventPayload;
+}
+/**
+ * Triggered once a plugin has finished loading AND published every API it declares, so a listener may call
+ * those APIs immediately.
+ *
+ * Namespaced by the package name rather than by an abbreviation of it: the event is global to the vault
+ * and aimed at plugin authors who have never heard of this library, so the prefix has to identify itself.
+ */
+export declare const PLUGIN_LOADED_EVENT_NAME = "obsidian-dev-utils:plugin-loaded";
+/**
+ * Triggered as a plugin unloads — whether the user disabled it, uninstalled it, or Obsidian is shutting
+ * down. Its APIs are revoked by the time a listener runs.
+ */
+export declare const PLUGIN_UNLOADED_EVENT_NAME = "obsidian-dev-utils:plugin-unloaded";
+declare module 'obsidian' {
+    interface Workspace {
+        /**
+         * Subscribes to a plugin finishing its load, or to one unloading.
+         *
+         * @param name - Should be {@link PLUGIN_LOADED_EVENT_NAME} or {@link PLUGIN_UNLOADED_EVENT_NAME}.
+         * @param callback - The callback receiving the plugin's payload.
+         * @param context - The context passed as `this` to the `callback` function.
+         * @returns The event reference.
+         */
+        on(name: PluginLifecycleEventName, callback: (payload: PluginLifecycleEventPayload) => unknown, context?: unknown): EventRef;
+    }
+}
+/**
+ * Triggers one of the two lifecycle events on the app's workspace.
+ *
+ * A thin typed wrapper over `Workspace.trigger`, which accepts any event name and any arguments, so that
+ * the one place a payload is constructed is checked against {@link PluginLifecycleEventPayload}.
+ *
+ * @param params - The {@link TriggerPluginLifecycleEventParams}.
+ */
+export declare function triggerPluginLifecycleEvent(params: TriggerPluginLifecycleEventParams): void;