@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/components/plugin-suggestion-component.cjs

@@ -0,0 +1,302 @@
+/*
+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 ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+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;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+
+  // 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
+    }
+  );
+
+  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_suggestion_component_exports = {};
+__export(plugin_suggestion_component_exports, {
+  PluginSuggestionComponent: () => PluginSuggestionComponent,
+  SuggestedPluginState: () => SuggestedPluginState
+});
+module.exports = __toCommonJS(plugin_suggestion_component_exports);
+var import_async = require('@mnaoumov/typescript-lib/async');
+var import_obsidian = require('obsidian');
+var import_css_class = require('../css-class.cjs');
+var import_i18n = require('../i18n/i18n.cjs');
+var import_plugin_install_state = require('../plugin/plugin-install-state.cjs');
+var import_component_ex = require('./component-ex.cjs');
+var import_layout_ready_component = require('./layout-ready-component.cjs');
+const SuggestedPluginState = import_plugin_install_state.InstalledPluginState;
+class PluginSuggestionComponent extends import_component_ex.ComponentEx {
+  app;
+  isSuggestionDeclined;
+  pluginNoticeComponent;
+  pluginSettingsComponent;
+  reason;
+  setSuggestionDeclined;
+  suggestedPluginId;
+  suggestedPluginName;
+  /**
+   * Creates an instance of {@link PluginSuggestionComponent}.
+   *
+   * @param params - The constructor parameters.
+   */
+  constructor(params) {
+    super();
+    this.app = params.app;
+    this.pluginNoticeComponent = params.pluginNoticeComponent;
+    this.pluginSettingsComponent = params.pluginSettingsComponent;
+    this.reason = params.reason;
+    this.suggestedPluginId = params.suggestedPluginId;
+    this.suggestedPluginName = params.suggestedPluginName;
+    this.isSuggestionDeclined = params.isSuggestionDeclined;
+    this.setSuggestionDeclined = params.setSuggestionDeclined;
+  }
+  /**
+   * Resolves how the suggested plugin is currently present in the vault.
+   *
+   * @returns The {@link SuggestedPluginState}.
+   */
+  getSuggestedPluginState() {
+    return (0, import_plugin_install_state.getInstalledPluginState)({
+      app: this.app,
+      pluginId: this.suggestedPluginId
+    });
+  }
+  /**
+   * Installs (when needed) and enables the suggested plugin, reporting the outcome as a notice.
+   *
+   * @returns A {@link Promise} that resolves once the plugin is enabled, or once the failure has been
+   * reported.
+   */
+  async installAndEnableSuggestedPlugin() {
+    if (this.getSuggestedPluginState() === SuggestedPluginState.Enabled) {
+      return;
+    }
+    await (0, import_plugin_install_state.installAndEnablePlugin)({
+      app: this.app,
+      pluginId: this.suggestedPluginId,
+      pluginName: this.suggestedPluginName,
+      pluginNoticeComponent: this.pluginNoticeComponent
+    });
+    await this.setSuggestionDeclined(false);
+  }
+  /**
+   * Loads the component, showing the suggestion notice once the layout is ready AND the host's settings
+   * have been read from disk.
+   *
+   * Both waits matter, and neither implies the other:
+   *
+   * - Layout-ready, because plugins load in an unspecified order, so the suggested plugin may well be
+   *   enabled a moment after this one. Checking earlier would suggest installing something the user
+   *   already has.
+   * - Settings-loaded, because {@link PluginSuggestionComponentConstructorParams.isSuggestionDeclined}
+   *   reads a setting of the host, and the host's settings component is a SIBLING whose own async load is
+   *   still in flight here. On a layout that is already ready — a runtime enable from the Community
+   *   Plugins tab, or a re-enable after an update — the layout-ready callback fires immediately, so the
+   *   read would see the default `false` and ask again a user who has already declined.
+   */
+  onload() {
+    this.addChild(
+      new import_layout_ready_component.CallbackLayoutReadyComponent(this.app, async () => {
+        await this.pluginSettingsComponent.whenLoadedFromFile();
+        if (this.isUnloaded()) {
+          return;
+        }
+        this.showSuggestionNotice();
+      })
+    );
+  }
+  /**
+   * Renders the suggestion banner into a settings-tab container, with a button that installs and enables
+   * the suggested plugin.
+   *
+   * Renders nothing when the suggested plugin is already enabled. Unlike the notice, the banner ignores a
+   * previous decline — the user is looking at these settings right now, which is a fresher signal than an
+   * answer they gave earlier.
+   *
+   * @param containerEl - The element to render the banner into.
+   */
+  renderBanner(containerEl) {
+    const state = this.getSuggestedPluginState();
+    if (state === SuggestedPluginState.Enabled) {
+      return;
+    }
+    const bannerEl = containerEl.createDiv({
+      cls: [import_css_class.CssClass.LibraryName, import_css_class.CssClass.PluginSuggestionBanner]
+    });
+    bannerEl.createDiv({ text: this.reason });
+    new import_obsidian.ButtonComponent(bannerEl).setButtonText(this.getActionButtonText(state)).setCta().onClick((0, import_async.convertAsyncToSync)(async () => {
+      await this.installAndEnableSuggestedPlugin();
+    }));
+  }
+  getActionButtonText(state) {
+    return (0, import_i18n.t)(
+      ($) => state === SuggestedPluginState.InstalledButDisabled ? $.obsidianDevUtils.pluginSuggestion.enable : $.obsidianDevUtils.pluginSuggestion.install
+    );
+  }
+  showSuggestionNotice() {
+    const state = this.getSuggestedPluginState();
+    if (state === SuggestedPluginState.Enabled || this.isSuggestionDeclined()) {
+      return;
+    }
+    const fragment = createFragment((fragmentEl) => {
+      fragmentEl.createDiv({ text: this.reason });
+      const buttonsEl = fragmentEl.createDiv();
+      new import_obsidian.ButtonComponent(buttonsEl).setButtonText(this.getActionButtonText(state)).setCta().onClick((0, import_async.convertAsyncToSync)(async () => {
+        await this.installAndEnableSuggestedPlugin();
+      }));
+      new import_obsidian.ButtonComponent(buttonsEl).setButtonText((0, import_i18n.t)(($) => $.obsidianDevUtils.pluginSuggestion.notNow)).onClick((0, import_async.convertAsyncToSync)(async () => {
+        await this.setSuggestionDeclined(true);
+      }));
+    });
+    this.pluginNoticeComponent.showNotice(fragment, { shouldHideOnClick: false });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PluginSuggestionComponent,
+  SuggestedPluginState
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvcGx1Z2luLXN1Z2dlc3Rpb24tY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgc3VnZ2VzdHMgaW5zdGFsbGluZyBhbm90aGVyIGNvbW11bml0eSBwbHVnaW4gdGhlIGhvc3QgcGx1Z2luIG5lZWRzIGluIG9yZGVyIHRvIG9mZmVyXG4gKiBzb21lIG9mIGl0cyBiZWhhdmlvci5cbiAqXG4gKiBBIHN1Z2dlc3Rpb24gaXMgbm90IGEgZGVwZW5kZW5jeSBcdTIwMTQgYnV0IGEgZGVwZW5kZW5jeSBpcyBub3cgYSB0aGluZyB0aGlzIGxpYnJhcnkgSEFTLCBzbyB0aGUgY2hvaWNlXG4gKiBiZXR3ZWVuIHRoZW0gaXMgYSByZWFsIG9uZS4gVXNlIGEgc3VnZ2VzdGlvbiB3aGVuIHRoZSBvdGhlciBwbHVnaW4gQUREUyBzb21ldGhpbmc6IHRoZSBob3N0IGtlZXBzXG4gKiB3b3JraW5nIHdpdGhvdXQgaXQsIHNpbXBseSB1bmFibGUgdG8gb2ZmZXIgd2hhdGV2ZXIgdGhhdCBwbHVnaW4gb3ducywgYW5kIHRoaXMgY29tcG9uZW50IGFza3Mgb25jZVxuICogd2hldGhlciB0aGUgdXNlciB3b3VsZCBsaWtlIGl0IGluc3RhbGxlZC4gVXNlIGBQbHVnaW5HYXRlQ29tcG9uZW50YCB3aGVuIHRoZSBob3N0J3MgYWR2ZXJ0aXNlZFxuICogYmVoYXZpb3IgaXMgbm90IHRoZXJlIGF0IGFsbCB3aXRob3V0IHRoZSBvdGhlciBwbHVnaW4uXG4gKlxuICogVGhpcyBmaWxlIHVzZWQgdG8gYXJndWUgdGhlIHN0cm9uZ2VyIHBvc2l0aW9uIFx1MjAxNCB0aGF0IHJlcXVpcmluZyBhbm90aGVyIHBsdWdpbiBzaG91bGQgbm90IGV4aXN0LCBiZWNhdXNlXG4gKiBcImludmVudGluZyBvbmUgYnkgcmVmdXNpbmcgdG8gbG9hZCB3b3VsZCBwdW5pc2ggdGhlIHVzZXIgZm9yIHNvbWV0aGluZyB0aGV5IG5ldmVyIGFncmVlZCB0b1wiLiBUaGF0IHdhc1xuICogd3JvbmcgYWJvdXQgd2hpY2ggb3B0aW9uIHB1bmlzaGVzIHRoZSB1c2VyLCBhbmQgdGhlIGNvdW50ZXItY2FzZSBpcyB3b3J0aCBrZWVwaW5nIHJhdGhlciB0aGFuIHF1aWV0bHlcbiAqIGRlbGV0aW5nLiBBIGxvYWQtYmVhcmluZyBwbHVnaW4gdGhlIHVzZXIgY2Fubm90IGlkZW50aWZ5IGlzIG5vdCBhIG5ldXRyYWwgb3V0Y29tZTogbW9udGhzIGxhdGVyIHRoZXlcbiAqIG1lZXQgaXQgaW4gdGhlaXIgcGx1Z2luIGxpc3QsIG5vdGhpbmcgaW4gT2JzaWRpYW4ncyBtYW5pZmVzdCBmb3JtYXQgc2F5cyBhbnl0aGluZyBkZXBlbmRzIG9uIGl0LCB0aGV5XG4gKiByZW1vdmUgaXQsIGFuZCB0aGUgZGFtYWdlIHN1cmZhY2VzIHdlZWtzIGFmdGVyIHRoYXQgd2l0aCBubyB3YXkgdG8gY29ubmVjdCB0aGUgdHdvLiBCZXNpZGUgdGhhdCwgYVxuICogbWFuZGF0b3J5IGRlcGVuZGVuY3kgdGhhdCBzdGF5cyBlbmFibGVkLWJ1dC1pbmVydCwgbmFtZXMgd2hhdCBpdCBpcyB3YWl0aW5nIGZvciwgaW5zdGFsbHMgaXQgaW4gb25lXG4gKiBjbGljayBhbmQgcmVzdW1lcyB3aXRob3V0IGEgcmVzdGFydCBpcyBub3QgYSBwdW5pc2htZW50IFx1MjAxNCBpdCBpcyB0aGUgc2FtZSBpbmZvcm1hdGlvbiwgZGVsaXZlcmVkIHdoaWxlXG4gKiB0aGUgdXNlciBjYW4gc3RpbGwgYWN0IG9uIGl0LlxuICpcbiAqIFRoZSBhc2sgaXMgc3VyZmFjZWQgdHdpY2UsIGRlbGliZXJhdGVseSwgYmVjYXVzZSB0aGUgdHdvIHBsYWNlbWVudHMgYW5zd2VyIGRpZmZlcmVudCBxdWVzdGlvbnM6XG4gKiBhIG5vdGljZSBvbiBsb2FkIChcInlvdSBhcmUgbWlzc2luZyBzb21ldGhpbmcgeW91IHByb2JhYmx5IHdhbnRcIikgYW5kIGEgc2V0dGluZ3MtdGFiIGJhbm5lciAoXCJ0aGVcbiAqIHNldHRpbmdzIHlvdSBjYW1lIGxvb2tpbmcgZm9yIGxpdmUgaW4gYW5vdGhlciBwbHVnaW5cIikuIERlY2xpbmluZyBzaWxlbmNlcyBvbmx5IHRoZSBub3RpY2UgXHUyMDE0IGEgdXNlclxuICogd2hvIG9wZW5zIHRoZSBzZXR0aW5ncyB0YWIgaXMgYXNraW5nIGFib3V0IHRoZSBmZWF0dXJlIHJpZ2h0IHRoZW4sIHNvIHRoZSBiYW5uZXIgc3RheXMuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBjb252ZXJ0QXN5bmNUb1N5bmMgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYXN5bmMnO1xuaW1wb3J0IHsgQnV0dG9uQ29tcG9uZW50IH0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IFBsdWdpbk5vdGljZUNvbXBvbmVudCB9IGZyb20gJy4vcGx1Z2luLW5vdGljZS1jb21wb25lbnQudHMnO1xuaW1wb3J0IHR5cGUgeyBQbHVnaW5TZXR0aW5nc0NvbXBvbmVudEJhc2UgfSBmcm9tICcuL3BsdWdpbi1zZXR0aW5ncy1jb21wb25lbnQudHMnO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyB0IH0gZnJvbSAnLi4vaTE4bi9pMThuLnRzJztcbmltcG9ydCB7XG4gIGdldEluc3RhbGxlZFBsdWdpblN0YXRlLFxuICBpbnN0YWxsQW5kRW5hYmxlUGx1Z2luLFxuICBJbnN0YWxsZWRQbHVnaW5TdGF0ZVxufSBmcm9tICcuLi9wbHVnaW4vcGx1Z2luLWluc3RhbGwtc3RhdGUudHMnO1xuaW1wb3J0IHsgQ29tcG9uZW50RXggfSBmcm9tICcuL2NvbXBvbmVudC1leC50cyc7XG5pbXBvcnQgeyBDYWxsYmFja0xheW91dFJlYWR5Q29tcG9uZW50IH0gZnJvbSAnLi9sYXlvdXQtcmVhZHktY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBIb3cgdGhlIHN1Z2dlc3RlZCBwbHVnaW4gaXMgY3VycmVudGx5IHByZXNlbnQgaW4gdGhlIHZhdWx0LlxuICpcbiAqIFRoZSBzYW1lIHRocmVlIHN0YXRlcyBhIG1hbmRhdG9yeSBkZXBlbmRlbmN5IGlzIGluLCBzbyB0aGlzIGlzIHtAbGluayBJbnN0YWxsZWRQbHVnaW5TdGF0ZX0gdW5kZXIgdGhlXG4gKiBuYW1lIHRoaXMgY29tcG9uZW50IGhhcyBhbHdheXMgdXNlZCBcdTIwMTQgb25lIGVudW0sIHNvIGEgY2FsbGVyIGhvbGRpbmcgYSBzdGF0ZSBmcm9tIGVpdGhlciBjb21wb25lbnQgY2FuXG4gKiBjb21wYXJlIGl0IGFnYWluc3QgZWl0aGVyIG5hbWUuXG4gKi9cbmV4cG9ydCBjb25zdCBTdWdnZXN0ZWRQbHVnaW5TdGF0ZSA9IEluc3RhbGxlZFBsdWdpblN0YXRlO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgUGx1Z2luU3VnZ2VzdGlvbkNvbXBvbmVudH0gY29uc3RydWN0b3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUGx1Z2luU3VnZ2VzdGlvbkNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogV2hldGhlciB0aGUgdXNlciBoYXMgYWxyZWFkeSBkZWNsaW5lZCB0aGlzIHN1Z2dlc3Rpb24uXG4gICAqXG4gICAqIFN0b3JhZ2UgYmVsb25ncyB0byB0aGUgaG9zdCBwbHVnaW4gKHR5cGljYWxseSBvbmUgb2YgaXRzIHNldHRpbmdzKSwgYmVjYXVzZSB0aGlzIGNvbXBvbmVudCBoYXMgbm9cbiAgICogYGRhdGEuanNvbmAgb2YgaXRzIG93biBhbmQgYSBkZWNsaW5lIGhhcyB0byBvdXRsaXZlIGEgcmVsb2FkLlxuICAgKlxuICAgKiBPbmx5IGV2ZXIgY2FsbGVkIG9uY2Uge0BsaW5rIHBsdWdpblNldHRpbmdzQ29tcG9uZW50fSByZXBvcnRzIGl0cyBzZXR0aW5ncyBsb2FkZWQsIHNvIGFuIGltcGxlbWVudGF0aW9uXG4gICAqIHJlYWRpbmcgYSBzZXR0aW5nIGlzIGd1YXJhbnRlZWQgdG8gcmVhZCB0aGUgc3RvcmVkIHZhbHVlIHJhdGhlciB0aGFuIGl0cyBkZWZhdWx0LlxuICAgKlxuICAgKiBAcmV0dXJucyBgdHJ1ZWAgd2hlbiB0aGUgc3VnZ2VzdGlvbiBoYXMgYmVlbiBkZWNsaW5lZC5cbiAgICovXG4gIHJlYWRvbmx5IGlzU3VnZ2VzdGlvbkRlY2xpbmVkOiAoKSA9PiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgbm90aWNlIGNvbXBvbmVudCBvZiB0aGUgcGx1Z2luIG1ha2luZyB0aGUgc3VnZ2VzdGlvbiwgdXNlZCB0byBzaG93IHRoZSBzdWdnZXN0aW9uIGFuZCBpdHNcbiAgICogb3V0Y29tZS5cbiAgICovXG4gIHJlYWRvbmx5IHBsdWdpbk5vdGljZUNvbXBvbmVudDogUGx1Z2luTm90aWNlQ29tcG9uZW50O1xuXG4gIC8qKlxuICAgKiBUaGUgc2V0dGluZ3MgY29tcG9uZW50IGhvbGRpbmcgd2hhdGV2ZXIge0BsaW5rIGlzU3VnZ2VzdGlvbkRlY2xpbmVkfSByZWFkcy5cbiAgICpcbiAgICogVGFrZW4gYXMgYSB3aG9sZSBjb21wb25lbnQgcmF0aGVyIHRoYW4gYXMgYSBiYXJlIFwicmVhZHlcIiBmbGFnIHNvIHRoZSBob3N0IGNhbm5vdCBmb3JnZXQgdG8gd2lyZSB0aGVcbiAgICogd2FpdDogdGhlIG5vdGljZSBpcyBkZWNpZGVkIG9ubHkgYWZ0ZXIgdGhpcyBjb21wb25lbnQgaGFzIHJlYWQgYGRhdGEuanNvbmAuIFNlZVxuICAgKiB7QGxpbmsgUGx1Z2luU2V0dGluZ3NDb21wb25lbnRCYXNlLndoZW5Mb2FkZWRGcm9tRmlsZX0gZm9yIHdoeSB0aGUgcmVhZCBjYW5ub3Qgc2ltcGx5IGhhcHBlbiBhdFxuICAgKiBsYXlvdXQtcmVhZHkuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5TZXR0aW5nc0NvbXBvbmVudDogUGx1Z2luU2V0dGluZ3NDb21wb25lbnRCYXNlPG9iamVjdD47XG5cbiAgLyoqXG4gICAqIFRoZSBsb2NhbGl6ZWQgc2VudGVuY2UgZXhwbGFpbmluZyB3aGF0IHRoZSBob3N0IHBsdWdpbiBjYW5ub3QgZG8gd2l0aG91dCB0aGUgc3VnZ2VzdGVkIHBsdWdpbi4gVGhlXG4gICAqIGhvc3QgcGx1Z2luIG93bnMgdGhpcyBzdHJpbmc6IG9ubHkgaXQga25vd3Mgd2hpY2ggb2YgaXRzIGZlYXR1cmVzIGFyZSBhZmZlY3RlZC5cbiAgICovXG4gIHJlYWRvbmx5IHJlYXNvbjogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBSZWNvcmRzIHRoZSB1c2VyJ3MgYW5zd2VyIHRvIHRoZSBzdWdnZXN0aW9uLlxuICAgKlxuICAgKiBAcGFyYW0gaXNEZWNsaW5lZCAtIGB0cnVlYCB3aGVuIHRoZSB1c2VyIGRlY2xpbmVkLlxuICAgKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIG9uY2UgdGhlIGFuc3dlciBpcyBwZXJzaXN0ZWQuXG4gICAqL1xuICByZWFkb25seSBzZXRTdWdnZXN0aW9uRGVjbGluZWQ6IChpc0RlY2xpbmVkOiBib29sZWFuKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBUaGUgaWQgb2YgdGhlIHN1Z2dlc3RlZCBwbHVnaW4sIGFzIGxpc3RlZCBpbiBPYnNpZGlhbidzIGNvbW11bml0eSBwbHVnaW4gcmVnaXN0cnkuXG4gICAqL1xuICByZWFkb25seSBzdWdnZXN0ZWRQbHVnaW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZGlzcGxheSBuYW1lIG9mIHRoZSBzdWdnZXN0ZWQgcGx1Z2luLCBzaG93biB0byB0aGUgdXNlci5cbiAgICovXG4gIHJlYWRvbmx5IHN1Z2dlc3RlZFBsdWdpbk5hbWU6IHN0cmluZztcbn1cblxuLyoqXG4gKiBIb3cgdGhlIHN1Z2dlc3RlZCBwbHVnaW4gaXMgY3VycmVudGx5IHByZXNlbnQgaW4gdGhlIHZhdWx0LlxuICovXG5leHBvcnQgdHlwZSBTdWdnZXN0ZWRQbHVnaW5TdGF0ZSA9IEluc3RhbGxlZFBsdWdpblN0YXRlO1xuXG4vKipcbiAqIFN1Z2dlc3RzIGluc3RhbGxpbmcgYW5vdGhlciBjb21tdW5pdHkgcGx1Z2luLCB2aWEgYSBsb2FkLXRpbWUgbm90aWNlIGFuZCBhIHNldHRpbmdzLXRhYiBiYW5uZXIuXG4gKi9cbmV4cG9ydCBjbGFzcyBQbHVnaW5TdWdnZXN0aW9uQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICBwcml2YXRlIHJlYWRvbmx5IGFwcDogQXBwO1xuICBwcml2YXRlIHJlYWRvbmx5IGlzU3VnZ2VzdGlvbkRlY2xpbmVkOiAoKSA9PiBib29sZWFuO1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpbk5vdGljZUNvbXBvbmVudDogUGx1Z2luTm90aWNlQ29tcG9uZW50O1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpblNldHRpbmdzQ29tcG9uZW50OiBQbHVnaW5TZXR0aW5nc0NvbXBvbmVudEJhc2U8b2JqZWN0PjtcbiAgcHJpdmF0ZSByZWFkb25seSByZWFzb246IHN0cmluZztcbiAgcHJpdmF0ZSByZWFkb25seSBzZXRTdWdnZXN0aW9uRGVjbGluZWQ6IChpc0RlY2xpbmVkOiBib29sZWFuKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuICBwcml2YXRlIHJlYWRvbmx5IHN1Z2dlc3RlZFBsdWdpbklkOiBzdHJpbmc7XG4gIHByaXZhdGUgcmVhZG9ubHkgc3VnZ2VzdGVkUGx1Z2luTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGFuIGluc3RhbmNlIG9mIHtAbGluayBQbHVnaW5TdWdnZXN0aW9uQ29tcG9uZW50fS5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBjb25zdHJ1Y3RvciBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogUGx1Z2luU3VnZ2VzdGlvbkNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLmFwcCA9IHBhcmFtcy5hcHA7XG4gICAgdGhpcy5wbHVnaW5Ob3RpY2VDb21wb25lbnQgPSBwYXJhbXMucGx1Z2luTm90aWNlQ29tcG9uZW50O1xuICAgIHRoaXMucGx1Z2luU2V0dGluZ3NDb21wb25lbnQgPSBwYXJhbXMucGx1Z2luU2V0dGluZ3NDb21wb25lbnQ7XG4gICAgdGhpcy5yZWFzb24gPSBwYXJhbXMucmVhc29uO1xuICAgIHRoaXMuc3VnZ2VzdGVkUGx1Z2luSWQgPSBwYXJhbXMuc3VnZ2VzdGVkUGx1Z2luSWQ7XG4gICAgdGhpcy5zdWdnZXN0ZWRQbHVnaW5OYW1lID0gcGFyYW1zLnN1Z2dlc3RlZFBsdWdpbk5hbWU7XG4gICAgdGhpcy5pc1N1Z2dlc3Rpb25EZWNsaW5lZCA9IHBhcmFtcy5pc1N1Z2dlc3Rpb25EZWNsaW5lZDtcbiAgICB0aGlzLnNldFN1Z2dlc3Rpb25EZWNsaW5lZCA9IHBhcmFtcy5zZXRTdWdnZXN0aW9uRGVjbGluZWQ7XG4gIH1cblxuICAvKipcbiAgICogUmVzb2x2ZXMgaG93IHRoZSBzdWdnZXN0ZWQgcGx1Z2luIGlzIGN1cnJlbnRseSBwcmVzZW50IGluIHRoZSB2YXVsdC5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHtAbGluayBTdWdnZXN0ZWRQbHVnaW5TdGF0ZX0uXG4gICAqL1xuICBwdWJsaWMgZ2V0U3VnZ2VzdGVkUGx1Z2luU3RhdGUoKTogU3VnZ2VzdGVkUGx1Z2luU3RhdGUge1xuICAgIHJldHVybiBnZXRJbnN0YWxsZWRQbHVnaW5TdGF0ZSh7XG4gICAgICBhcHA6IHRoaXMuYXBwLFxuICAgICAgcGx1Z2luSWQ6IHRoaXMuc3VnZ2VzdGVkUGx1Z2luSWRcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbnN0YWxscyAod2hlbiBuZWVkZWQpIGFuZCBlbmFibGVzIHRoZSBzdWdnZXN0ZWQgcGx1Z2luLCByZXBvcnRpbmcgdGhlIG91dGNvbWUgYXMgYSBub3RpY2UuXG4gICAqXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgb25jZSB0aGUgcGx1Z2luIGlzIGVuYWJsZWQsIG9yIG9uY2UgdGhlIGZhaWx1cmUgaGFzIGJlZW5cbiAgICogcmVwb3J0ZWQuXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgaW5zdGFsbEFuZEVuYWJsZVN1Z2dlc3RlZFBsdWdpbigpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBpZiAodGhpcy5nZXRTdWdnZXN0ZWRQbHVnaW5TdGF0ZSgpID09PSBTdWdnZXN0ZWRQbHVnaW5TdGF0ZS5FbmFibGVkKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgYXdhaXQgaW5zdGFsbEFuZEVuYWJsZVBsdWdpbih7XG4gICAgICBhcHA6IHRoaXMuYXBwLFxuICAgICAgcGx1Z2luSWQ6IHRoaXMuc3VnZ2VzdGVkUGx1Z2luSWQsXG4gICAgICBwbHVnaW5OYW1lOiB0aGlzLnN1Z2dlc3RlZFBsdWdpbk5hbWUsXG4gICAgICBwbHVnaW5Ob3RpY2VDb21wb25lbnQ6IHRoaXMucGx1Z2luTm90aWNlQ29tcG9uZW50XG4gICAgfSk7XG5cbiAgICAvLyBPbmx5IGFmdGVyIHRoZSBpbnN0YWxsIGFjdHVhbGx5IHN1Y2NlZWRlZCBcdTIwMTQgYGluc3RhbGxBbmRFbmFibGVQbHVnaW5gIHJldGhyb3dzIG9uIGZhaWx1cmUsIHNvIGFcbiAgICAvLyBmYWlsZWQgYXR0ZW1wdCBsZWF2ZXMgYSBwcmV2aW91cyBkZWNsaW5lIHN0YW5kaW5nIHJhdGhlciB0aGFuIHNpbGVudGx5IGNsZWFyaW5nIGl0LlxuICAgIGF3YWl0IHRoaXMuc2V0U3VnZ2VzdGlvbkRlY2xpbmVkKGZhbHNlKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBMb2FkcyB0aGUgY29tcG9uZW50LCBzaG93aW5nIHRoZSBzdWdnZXN0aW9uIG5vdGljZSBvbmNlIHRoZSBsYXlvdXQgaXMgcmVhZHkgQU5EIHRoZSBob3N0J3Mgc2V0dGluZ3NcbiAgICogaGF2ZSBiZWVuIHJlYWQgZnJvbSBkaXNrLlxuICAgKlxuICAgKiBCb3RoIHdhaXRzIG1hdHRlciwgYW5kIG5laXRoZXIgaW1wbGllcyB0aGUgb3RoZXI6XG4gICAqXG4gICAqIC0gTGF5b3V0LXJlYWR5LCBiZWNhdXNlIHBsdWdpbnMgbG9hZCBpbiBhbiB1bnNwZWNpZmllZCBvcmRlciwgc28gdGhlIHN1Z2dlc3RlZCBwbHVnaW4gbWF5IHdlbGwgYmVcbiAgICogICBlbmFibGVkIGEgbW9tZW50IGFmdGVyIHRoaXMgb25lLiBDaGVja2luZyBlYXJsaWVyIHdvdWxkIHN1Z2dlc3QgaW5zdGFsbGluZyBzb21ldGhpbmcgdGhlIHVzZXJcbiAgICogICBhbHJlYWR5IGhhcy5cbiAgICogLSBTZXR0aW5ncy1sb2FkZWQsIGJlY2F1c2Uge0BsaW5rIFBsdWdpblN1Z2dlc3Rpb25Db21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcy5pc1N1Z2dlc3Rpb25EZWNsaW5lZH1cbiAgICogICByZWFkcyBhIHNldHRpbmcgb2YgdGhlIGhvc3QsIGFuZCB0aGUgaG9zdCdzIHNldHRpbmdzIGNvbXBvbmVudCBpcyBhIFNJQkxJTkcgd2hvc2Ugb3duIGFzeW5jIGxvYWQgaXNcbiAgICogICBzdGlsbCBpbiBmbGlnaHQgaGVyZS4gT24gYSBsYXlvdXQgdGhhdCBpcyBhbHJlYWR5IHJlYWR5IFx1MjAxNCBhIHJ1bnRpbWUgZW5hYmxlIGZyb20gdGhlIENvbW11bml0eVxuICAgKiAgIFBsdWdpbnMgdGFiLCBvciBhIHJlLWVuYWJsZSBhZnRlciBhbiB1cGRhdGUgXHUyMDE0IHRoZSBsYXlvdXQtcmVhZHkgY2FsbGJhY2sgZmlyZXMgaW1tZWRpYXRlbHksIHNvIHRoZVxuICAgKiAgIHJlYWQgd291bGQgc2VlIHRoZSBkZWZhdWx0IGBmYWxzZWAgYW5kIGFzayBhZ2FpbiBhIHVzZXIgd2hvIGhhcyBhbHJlYWR5IGRlY2xpbmVkLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIG9ubG9hZCgpOiB2b2lkIHtcbiAgICB0aGlzLmFkZENoaWxkKFxuICAgICAgbmV3IENhbGxiYWNrTGF5b3V0UmVhZHlDb21wb25lbnQodGhpcy5hcHAsIGFzeW5jICgpID0+IHtcbiAgICAgICAgYXdhaXQgdGhpcy5wbHVnaW5TZXR0aW5nc0NvbXBvbmVudC53aGVuTG9hZGVkRnJvbUZpbGUoKTtcbiAgICAgICAgaWYgKHRoaXMuaXNVbmxvYWRlZCgpKSB7XG4gICAgICAgICAgcmV0dXJuO1xuICAgICAgICB9XG5cbiAgICAgICAgdGhpcy5zaG93U3VnZ2VzdGlvbk5vdGljZSgpO1xuICAgICAgfSlcbiAgICApO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlbmRlcnMgdGhlIHN1Z2dlc3Rpb24gYmFubmVyIGludG8gYSBzZXR0aW5ncy10YWIgY29udGFpbmVyLCB3aXRoIGEgYnV0dG9uIHRoYXQgaW5zdGFsbHMgYW5kIGVuYWJsZXNcbiAgICogdGhlIHN1Z2dlc3RlZCBwbHVnaW4uXG4gICAqXG4gICAqIFJlbmRlcnMgbm90aGluZyB3aGVuIHRoZSBzdWdnZXN0ZWQgcGx1Z2luIGlzIGFscmVhZHkgZW5hYmxlZC4gVW5saWtlIHRoZSBub3RpY2UsIHRoZSBiYW5uZXIgaWdub3JlcyBhXG4gICAqIHByZXZpb3VzIGRlY2xpbmUgXHUyMDE0IHRoZSB1c2VyIGlzIGxvb2tpbmcgYXQgdGhlc2Ugc2V0dGluZ3MgcmlnaHQgbm93LCB3aGljaCBpcyBhIGZyZXNoZXIgc2lnbmFsIHRoYW4gYW5cbiAgICogYW5zd2VyIHRoZXkgZ2F2ZSBlYXJsaWVyLlxuICAgKlxuICAgKiBAcGFyYW0gY29udGFpbmVyRWwgLSBUaGUgZWxlbWVudCB0byByZW5kZXIgdGhlIGJhbm5lciBpbnRvLlxuICAgKi9cbiAgcHVibGljIHJlbmRlckJhbm5lcihjb250YWluZXJFbDogSFRNTEVsZW1lbnQpOiB2b2lkIHtcbiAgICBjb25zdCBzdGF0ZSA9IHRoaXMuZ2V0U3VnZ2VzdGVkUGx1Z2luU3RhdGUoKTtcbiAgICBpZiAoc3RhdGUgPT09IFN1Z2dlc3RlZFBsdWdpblN0YXRlLkVuYWJsZWQpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBjb25zdCBiYW5uZXJFbCA9IGNvbnRhaW5lckVsLmNyZWF0ZURpdih7XG4gICAgICBjbHM6IFtDc3NDbGFzcy5MaWJyYXJ5TmFtZSwgQ3NzQ2xhc3MuUGx1Z2luU3VnZ2VzdGlvbkJhbm5lcl1cbiAgICB9KTtcbiAgICBiYW5uZXJFbC5jcmVhdGVEaXYoeyB0ZXh0OiB0aGlzLnJlYXNvbiB9KTtcblxuICAgIG5ldyBCdXR0b25Db21wb25lbnQoYmFubmVyRWwpXG4gICAgICAuc2V0QnV0dG9uVGV4dCh0aGlzLmdldEFjdGlvbkJ1dHRvblRleHQoc3RhdGUpKVxuICAgICAgLnNldEN0YSgpXG4gICAgICAub25DbGljayhjb252ZXJ0QXN5bmNUb1N5bmMoYXN5bmMgKCkgPT4ge1xuICAgICAgICBhd2FpdCB0aGlzLmluc3RhbGxBbmRFbmFibGVTdWdnZXN0ZWRQbHVnaW4oKTtcbiAgICAgIH0pKTtcbiAgfVxuXG4gIHByaXZhdGUgZ2V0QWN0aW9uQnV0dG9uVGV4dChzdGF0ZTogU3VnZ2VzdGVkUGx1Z2luU3RhdGUpOiBzdHJpbmcge1xuICAgIHJldHVybiB0KCgkKSA9PlxuICAgICAgc3RhdGUgPT09IFN1Z2dlc3RlZFBsdWdpblN0YXRlLkluc3RhbGxlZEJ1dERpc2FibGVkXG4gICAgICAgID8gJC5vYnNpZGlhbkRldlV0aWxzLnBsdWdpblN1Z2dlc3Rpb24uZW5hYmxlXG4gICAgICAgIDogJC5vYnNpZGlhbkRldlV0aWxzLnBsdWdpblN1Z2dlc3Rpb24uaW5zdGFsbFxuICAgICk7XG4gIH1cblxuICBwcml2YXRlIHNob3dTdWdnZXN0aW9uTm90aWNlKCk6IHZvaWQge1xuICAgIGNvbnN0IHN0YXRlID0gdGhpcy5nZXRTdWdnZXN0ZWRQbHVnaW5TdGF0ZSgpO1xuICAgIGlmIChzdGF0ZSA9PT0gU3VnZ2VzdGVkUGx1Z2luU3RhdGUuRW5hYmxlZCB8fCB0aGlzLmlzU3VnZ2VzdGlvbkRlY2xpbmVkKCkpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBjb25zdCBmcmFnbWVudCA9IGNyZWF0ZUZyYWdtZW50KChmcmFnbWVudEVsKSA9PiB7XG4gICAgICBmcmFnbWVudEVsLmNyZWF0ZURpdih7IHRleHQ6IHRoaXMucmVhc29uIH0pO1xuICAgICAgY29uc3QgYnV0dG9uc0VsID0gZnJhZ21lbnRFbC5jcmVhdGVEaXYoKTtcblxuICAgICAgbmV3IEJ1dHRvbkNvbXBvbmVudChidXR0b25zRWwpXG4gICAgICAgIC5zZXRCdXR0b25UZXh0KHRoaXMuZ2V0QWN0aW9uQnV0dG9uVGV4dChzdGF0ZSkpXG4gICAgICAgIC5zZXRDdGEoKVxuICAgICAgICAub25DbGljayhjb252ZXJ0QXN5bmNUb1N5bmMoYXN5bmMgKCkgPT4ge1xuICAgICAgICAgIGF3YWl0IHRoaXMuaW5zdGFsbEFuZEVuYWJsZVN1Z2dlc3RlZFBsdWdpbigpO1xuICAgICAgICB9KSk7XG5cbiAgICAgIG5ldyBCdXR0b25Db21wb25lbnQoYnV0dG9uc0VsKVxuICAgICAgICAuc2V0QnV0dG9uVGV4dCh0KCgkKSA9PiAkLm9ic2lkaWFuRGV2VXRpbHMucGx1Z2luU3VnZ2VzdGlvbi5ub3ROb3cpKVxuICAgICAgICAub25DbGljayhjb252ZXJ0QXN5bmNUb1N5bmMoYXN5bmMgKCkgPT4ge1xuICAgICAgICAgIGF3YWl0IHRoaXMuc2V0U3VnZ2VzdGlvbkRlY2xpbmVkKHRydWUpO1xuICAgICAgICB9KSk7XG4gICAgfSk7XG5cbiAgICB0aGlzLnBsdWdpbk5vdGljZUNvbXBvbmVudC5zaG93Tm90aWNlKGZyYWdtZW50LCB7IHNob3VsZEhpZGVPbkNsaWNrOiBmYWxzZSB9KTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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

package/dist/lib/cjs/components/plugin-suggestion-component.d.cts

@@ -0,0 +1,162 @@
+/// <reference path="../library.d.cts" />
+/**
+ * @file
+ *
+ * Component that suggests installing another community plugin the host plugin needs in order to offer
+ * some of its behavior.
+ *
+ * A suggestion is not a dependency — but a dependency is now a thing this library HAS, so the choice
+ * between them is a real one. Use a suggestion when the other plugin ADDS something: the host keeps
+ * working without it, simply unable to offer whatever that plugin owns, and this component asks once
+ * whether the user would like it installed. Use `PluginGateComponent` when the host's advertised
+ * behavior is not there at all without the other plugin.
+ *
+ * This file used to argue the stronger position — that requiring another plugin should not exist, because
+ * "inventing one by refusing to load would punish the user for something they never agreed to". That was
+ * wrong about which option punishes the user, and the counter-case is worth keeping rather than quietly
+ * deleting. A load-bearing plugin the user cannot identify is not a neutral outcome: months later they
+ * meet it in their plugin list, nothing in Obsidian's manifest format says anything depends on it, they
+ * remove it, and the damage surfaces weeks after that with no way to connect the two. Beside that, a
+ * mandatory dependency that stays enabled-but-inert, names what it is waiting for, installs it in one
+ * click and resumes without a restart is not a punishment — it is the same information, delivered while
+ * the user can still act on it.
+ *
+ * The ask is surfaced twice, deliberately, because the two placements answer different questions:
+ * a notice on load ("you are missing something you probably want") and a settings-tab banner ("the
+ * settings you came looking for live in another plugin"). Declining silences only the notice — a user
+ * who opens the settings tab is asking about the feature right then, so the banner stays.
+ */
+import type { App } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { Promisable } from 'type-fest' with { 'resolution-mode': 'import' };
+import type { PluginNoticeComponent } from './plugin-notice-component.cjs';
+import type { PluginSettingsComponentBase } from './plugin-settings-component.cjs';
+import { InstalledPluginState } from '../plugin/plugin-install-state.cjs';
+import { ComponentEx } from './component-ex.cjs';
+/**
+ * How the suggested plugin is currently present in the vault.
+ *
+ * The same three states a mandatory dependency is in, so this is {@link InstalledPluginState} under the
+ * name this component has always used — one enum, so a caller holding a state from either component can
+ * compare it against either name.
+ */
+export declare const SuggestedPluginState: typeof InstalledPluginState;
+/**
+ * Parameters for the {@link PluginSuggestionComponent} constructor.
+ */
+export interface PluginSuggestionComponentConstructorParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * Whether the user has already declined this suggestion.
+     *
+     * Storage belongs to the host plugin (typically one of its settings), because this component has no
+     * `data.json` of its own and a decline has to outlive a reload.
+     *
+     * Only ever called once {@link pluginSettingsComponent} reports its settings loaded, so an implementation
+     * reading a setting is guaranteed to read the stored value rather than its default.
+     *
+     * @returns `true` when the suggestion has been declined.
+     */
+    readonly isSuggestionDeclined: () => boolean;
+    /**
+     * The notice component of the plugin making the suggestion, used to show the suggestion and its
+     * outcome.
+     */
+    readonly pluginNoticeComponent: PluginNoticeComponent;
+    /**
+     * The settings component holding whatever {@link isSuggestionDeclined} reads.
+     *
+     * Taken as a whole component rather than as a bare "ready" flag so the host cannot forget to wire the
+     * wait: the notice is decided only after this component has read `data.json`. See
+     * {@link PluginSettingsComponentBase.whenLoadedFromFile} for why the read cannot simply happen at
+     * layout-ready.
+     */
+    readonly pluginSettingsComponent: PluginSettingsComponentBase<object>;
+    /**
+     * The localized sentence explaining what the host plugin cannot do without the suggested plugin. The
+     * host plugin owns this string: only it knows which of its features are affected.
+     */
+    readonly reason: string;
+    /**
+     * Records the user's answer to the suggestion.
+     *
+     * @param isDeclined - `true` when the user declined.
+     * @returns A {@link Promise} that resolves once the answer is persisted.
+     */
+    readonly setSuggestionDeclined: (isDeclined: boolean) => Promisable<void>;
+    /**
+     * The id of the suggested plugin, as listed in Obsidian's community plugin registry.
+     */
+    readonly suggestedPluginId: string;
+    /**
+     * The display name of the suggested plugin, shown to the user.
+     */
+    readonly suggestedPluginName: string;
+}
+/**
+ * How the suggested plugin is currently present in the vault.
+ */
+export type SuggestedPluginState = InstalledPluginState;
+/**
+ * Suggests installing another community plugin, via a load-time notice and a settings-tab banner.
+ */
+export declare class PluginSuggestionComponent extends ComponentEx {
+    private readonly app;
+    private readonly isSuggestionDeclined;
+    private readonly pluginNoticeComponent;
+    private readonly pluginSettingsComponent;
+    private readonly reason;
+    private readonly setSuggestionDeclined;
+    private readonly suggestedPluginId;
+    private readonly suggestedPluginName;
+    /**
+     * Creates an instance of {@link PluginSuggestionComponent}.
+     *
+     * @param params - The constructor parameters.
+     */
+    constructor(params: PluginSuggestionComponentConstructorParams);
+    /**
+     * Resolves how the suggested plugin is currently present in the vault.
+     *
+     * @returns The {@link SuggestedPluginState}.
+     */
+    getSuggestedPluginState(): SuggestedPluginState;
+    /**
+     * Installs (when needed) and enables the suggested plugin, reporting the outcome as a notice.
+     *
+     * @returns A {@link Promise} that resolves once the plugin is enabled, or once the failure has been
+     * reported.
+     */
+    installAndEnableSuggestedPlugin(): Promise<void>;
+    /**
+     * Loads the component, showing the suggestion notice once the layout is ready AND the host's settings
+     * have been read from disk.
+     *
+     * Both waits matter, and neither implies the other:
+     *
+     * - Layout-ready, because plugins load in an unspecified order, so the suggested plugin may well be
+     *   enabled a moment after this one. Checking earlier would suggest installing something the user
+     *   already has.
+     * - Settings-loaded, because {@link PluginSuggestionComponentConstructorParams.isSuggestionDeclined}
+     *   reads a setting of the host, and the host's settings component is a SIBLING whose own async load is
+     *   still in flight here. On a layout that is already ready — a runtime enable from the Community
+     *   Plugins tab, or a re-enable after an update — the layout-ready callback fires immediately, so the
+     *   read would see the default `false` and ask again a user who has already declined.
+     */
+    onload(): void;
+    /**
+     * Renders the suggestion banner into a settings-tab container, with a button that installs and enables
+     * the suggested plugin.
+     *
+     * Renders nothing when the suggested plugin is already enabled. Unlike the notice, the banner ignores a
+     * previous decline — the user is looking at these settings right now, which is a fresher signal than an
+     * answer they gave earlier.
+     *
+     * @param containerEl - The element to render the banner into.
+     */
+    renderBanner(containerEl: HTMLElement): void;
+    private getActionButtonText;
+    private showSuggestionNotice;
+}