obsidian-dev-utils 88.7.0 → 89.0.0

package/dist/lib/cjs/obsidian/components/notebook-navigator-menu-event-registrar-component.cjs

@@ -0,0 +1,297 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  globalThisRecord['__name'] ??= name;
+  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
+      }
+    );
+  }
+
+  const newFuncs = {
+    __extractDefault() {
+      return extractDefault;
+    },
+    process() {
+      const browserProcess = {
+        browser: true,
+        cwd() {
+          return '/';
+        },
+        env: {},
+        platform: 'android'
+      };
+      return browserProcess;
+    }
+  };
+
+  for (const key of Object.keys(newFuncs)) {
+    globalThisRecord[key] ??= newFuncs[key]?.();
+  }
+
+  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 notebook_navigator_menu_event_registrar_component_exports = {};
+__export(notebook_navigator_menu_event_registrar_component_exports, {
+  NotebookNavigatorMenuEventRegistrarComponent: () => NotebookNavigatorMenuEventRegistrarComponent
+});
+module.exports = __toCommonJS(notebook_navigator_menu_event_registrar_component_exports);
+var import_obsidian = require('obsidian');
+var import_disposable = require('../../disposable.cjs');
+var import_function = require('../../function.cjs');
+var import_notebook_navigator = require('../notebook-navigator.cjs');
+var import_layout_ready_component = require('./layout-ready-component.cjs');
+class NotebookNavigatorMenuEventRegistrarComponent extends import_layout_ready_component.LayoutReadyComponent {
+  /**
+   * The plugin's display name, which titles the parent entry.
+   */
+  pluginName;
+  /**
+   * The icon for the parent entry.
+   */
+  submenuIcon;
+  fileMenuEventHandlers = [];
+  filesMenuEventHandlers = [];
+  /**
+   * Creates a new Notebook Navigator menu event registrar.
+   *
+   * @param params - The parameters for the component.
+   */
+  constructor(params) {
+    super(params.app);
+    this.pluginName = params.pluginName;
+    this.submenuIcon = params.submenuIcon ?? "";
+  }
+  /**
+   * Accepts an editor-menu registration and does nothing with it.
+   *
+   * Notebook Navigator extends the file tree, not the editor — an editor menu there is Obsidian's
+   * own, which the handlers already reach through the workspace event. The registration is inert
+   * rather than refused so a handler that declares one is not a load-time error.
+   *
+   * @param _handler - The handler, deliberately unused.
+   * @returns A {@link DisposableEx} that has nothing to undo.
+   */
+  registerEditorMenuEventHandler(_handler) {
+    return new import_disposable.CallbackDisposable({ callback: import_function.noop });
+  }
+  /**
+   * Collects a single-file menu handler.
+   *
+   * @param handler - The handler to collect.
+   * @returns A {@link DisposableEx} that drops the handler again (or on component unload).
+   */
+  registerFileMenuEventHandler(handler) {
+    this.fileMenuEventHandlers.push(handler);
+    return this.registerDisposable(
+      new import_disposable.CallbackDisposable({
+        callback: () => {
+          this.fileMenuEventHandlers = this.fileMenuEventHandlers.filter((collected) => collected !== handler);
+        }
+      })
+    );
+  }
+  /**
+   * Collects a multi-file menu handler.
+   *
+   * @param handler - The handler to collect.
+   * @returns A {@link DisposableEx} that drops the handler again (or on component unload).
+   */
+  registerFilesMenuEventHandler(handler) {
+    this.filesMenuEventHandlers.push(handler);
+    return this.registerDisposable(
+      new import_disposable.CallbackDisposable({
+        callback: () => {
+          this.filesMenuEventHandlers = this.filesMenuEventHandlers.filter((collected) => collected !== handler);
+        }
+      })
+    );
+  }
+  /**
+   * Binds to Notebook Navigator once every plugin has loaded.
+   *
+   * Layout-ready rather than `onload`: plugin load order is not ours to choose, and Notebook
+   * Navigator's API only exists once its own plugin is up. When it is not installed the component
+   * stays dormant — enabling it later takes an Obsidian reload, exactly as it does for anything else
+   * that reads another plugin at startup.
+   */
+  onLayoutReady() {
+    const api = (0, import_notebook_navigator.resolveNotebookNavigatorApi)(this.app);
+    if (api === null) {
+      return;
+    }
+    this.register(api.menus.registerFileMenu((context) => {
+      this.handleFileMenu(context);
+    }));
+    this.register(api.menus.registerFolderMenu((context) => {
+      this.handleFolderMenu(context);
+    }));
+  }
+  /**
+   * Adds the plugin's entry, unless the handlers had nothing to contribute.
+   *
+   * The menu is populated TWICE, and both runs are needed: Notebook Navigator's `addItem` cannot be
+   * taken back once called, so the only way to keep an unrelated file's menu clean is to ask the
+   * handlers first, against a menu nobody sees. The gates they answer with are metadata reads, so the
+   * second run costs nothing and cannot disagree with the first.
+   *
+   * @param context - The Notebook Navigator menu being built.
+   * @param populate - Runs the collected handlers against a menu.
+   */
+  contribute(context, populate) {
+    const probeMenu = new import_obsidian.Menu();
+    populate(probeMenu);
+    if (probeMenu.items.length === 0) {
+      return;
+    }
+    context.addItem((item) => {
+      item.setTitle(this.pluginName).setIcon(this.submenuIcon);
+      populate(item.setSubmenu());
+    });
+  }
+  /**
+   * Handles a file menu, single or multi-selection.
+   *
+   * @param context - The Notebook Navigator menu being built.
+   */
+  handleFileMenu(context) {
+    const selectedFiles = [...context.selection.files];
+    this.contribute(
+      context,
+      context.selection.mode === "multiple" ? (menu) => {
+        this.runFilesMenuHandlers(menu, selectedFiles);
+      } : (menu) => {
+        this.runFileMenuHandlers(menu, context.file);
+      }
+    );
+  }
+  /**
+   * Handles a folder menu.
+   *
+   * A folder goes through the SINGLE-file handlers, because that is how Obsidian's own `file-menu`
+   * carries one — the event is typed {@link TAbstractFile}, and the folder handlers are the ones that
+   * narrow it.
+   *
+   * @param context - The Notebook Navigator menu being built.
+   */
+  handleFolderMenu(context) {
+    this.contribute(context, (menu) => {
+      this.runFileMenuHandlers(menu, context.folder);
+    });
+  }
+  /**
+   * Runs the single-file handlers against a menu.
+   *
+   * @param menu - The menu to populate.
+   * @param abstractFile - The file or folder the menu was raised on.
+   */
+  runFileMenuHandlers(menu, abstractFile) {
+    for (const handler of this.fileMenuEventHandlers) {
+      handler(menu, abstractFile, import_notebook_navigator.NOTEBOOK_NAVIGATOR_MENU_SOURCE);
+    }
+  }
+  /**
+   * Runs the multi-file handlers against a menu.
+   *
+   * @param menu - The menu to populate.
+   * @param abstractFiles - The files the menu was raised on.
+   */
+  runFilesMenuHandlers(menu, abstractFiles) {
+    for (const handler of this.filesMenuEventHandlers) {
+      handler(menu, abstractFiles, import_notebook_navigator.NOTEBOOK_NAVIGATOR_MENU_SOURCE);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NotebookNavigatorMenuEventRegistrarComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvbm90ZWJvb2stbmF2aWdhdG9yLW1lbnUtZXZlbnQtcmVnaXN0cmFyLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEJyaWRnZXMgdGhlIGZpbGUgYW5kIGZpbGVzIGNvbnRleHQtbWVudSBldmVudHMgaW50byBOb3RlYm9vayBOYXZpZ2F0b3IncyBvd24gbWVudXMuXG4gKlxuICogTm90ZWJvb2sgTmF2aWdhdG9yIGRyYXdzIGl0cyBvd24gZmlsZSB0cmVlIGFuZCBuZXZlciByYWlzZXMgT2JzaWRpYW4ncyBgZmlsZS1tZW51YCAvIGBmaWxlcy1tZW51YFxuICogd29ya3NwYWNlIGV2ZW50cywgc28gYSBwbHVnaW4ncyBjb250ZXh0LW1lbnUgaXRlbXMgdmFuaXNoIGZvciBhbnlvbmUgYnJvd3NpbmcgdGhyb3VnaCBpdC4gVGhpc1xuICogY29tcG9uZW50IGlzIGEge0BsaW5rIE1lbnVFdmVudFJlZ2lzdHJhcn0gYmFja2VkIGJ5IE5vdGVib29rIE5hdmlnYXRvcidzIGV4dGVuc2lvbiBBUEkgaW5zdGVhZCBvZlxuICogdGhlIHdvcmtzcGFjZSwgc28gdGhlIHZlcnkgc2FtZSBoYW5kbGVycyByZWFjaCBib3RoIHN1cmZhY2VzLlxuICovXG5cbmltcG9ydCB0eXBlIHtcbiAgQXBwLFxuICBJY29uTmFtZSxcbiAgTWVudSxcbiAgVEFic3RyYWN0RmlsZSxcbiAgVEZpbGVcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgeyBNZW51IGFzIE1lbnVJbXBsIH0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IERpc3Bvc2FibGVFeCB9IGZyb20gJy4uLy4uL2Rpc3Bvc2FibGUudHMnO1xuaW1wb3J0IHR5cGUge1xuICBFZGl0b3JNZW51RXZlbnRIYW5kbGVyLFxuICBGaWxlTWVudUV2ZW50SGFuZGxlcixcbiAgRmlsZXNNZW51RXZlbnRIYW5kbGVyLFxuICBNZW51RXZlbnRSZWdpc3RyYXJcbn0gZnJvbSAnLi4vbWVudS1ldmVudC1yZWdpc3RyYXIudHMnO1xuaW1wb3J0IHR5cGUge1xuICBOb3RlYm9va05hdmlnYXRvckZpbGVNZW51Q29udGV4dCxcbiAgTm90ZWJvb2tOYXZpZ2F0b3JGb2xkZXJNZW51Q29udGV4dCxcbiAgTm90ZWJvb2tOYXZpZ2F0b3JNZW51Q29udGV4dFxufSBmcm9tICcuLi9ub3RlYm9vay1uYXZpZ2F0b3IudHMnO1xuXG5pbXBvcnQgeyBDYWxsYmFja0Rpc3Bvc2FibGUgfSBmcm9tICcuLi8uLi9kaXNwb3NhYmxlLnRzJztcbmltcG9ydCB7IG5vb3AgfSBmcm9tICcuLi8uLi9mdW5jdGlvbi50cyc7XG5pbXBvcnQge1xuICBOT1RFQk9PS19OQVZJR0FUT1JfTUVOVV9TT1VSQ0UsXG4gIHJlc29sdmVOb3RlYm9va05hdmlnYXRvckFwaVxufSBmcm9tICcuLi9ub3RlYm9vay1uYXZpZ2F0b3IudHMnO1xuaW1wb3J0IHsgTGF5b3V0UmVhZHlDb21wb25lbnQgfSBmcm9tICcuL2xheW91dC1yZWFkeS1jb21wb25lbnQudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayBOb3RlYm9va05hdmlnYXRvck1lbnVFdmVudFJlZ2lzdHJhckNvbXBvbmVudH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTm90ZWJvb2tOYXZpZ2F0b3JNZW51RXZlbnRSZWdpc3RyYXJDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgYXBwbGljYXRpb24gaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogVGhlIHBsdWdpbidzIGRpc3BsYXkgbmFtZSwgd2hpY2ggdGl0bGVzIHRoZSBwYXJlbnQgZW50cnkuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBpY29uIGZvciB0aGUgcGFyZW50IGVudHJ5LlxuICAgKlxuICAgKiBAZGVmYXVsdCBgJydgIChubyBpY29uKVxuICAgKi9cbiAgcmVhZG9ubHkgc3VibWVudUljb24/OiBJY29uTmFtZSB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiB7QGxpbmsgTWVudUV2ZW50UmVnaXN0cmFyfSBiYWNrZWQgYnkgTm90ZWJvb2sgTmF2aWdhdG9yJ3MgbWVudS1leHRlbnNpb24gQVBJLlxuICpcbiAqIEhhbmRsZXJzIHJlZ2lzdGVyZWQgaGVyZSBhcmUgY29sbGVjdGVkIGVhZ2VybHkgYW5kIGJvdW5kIHRvIE5vdGVib29rIE5hdmlnYXRvciBvbmNlIHRoZSB3b3Jrc3BhY2VcbiAqIGxheW91dCBpcyByZWFkeS4gV2hlbiBOb3RlYm9vayBOYXZpZ2F0b3IgaXMgbm90IGluc3RhbGxlZCB0aGUgY29tcG9uZW50IHNpbXBseSBzdGF5cyBkb3JtYW50LlxuICpcbiAqIEV2ZXJ5IGNvbGxlY3RlZCBoYW5kbGVyIHdyaXRlcyBpbnRvIGEgcGx1Z2luLXRpdGxlZCBwYXJlbnQgZW50cnkncyBzdWJtZW51LCBzbyBhIGhhbmRsZXIgbXVzdCBOT1RcbiAqIGRlY2xhcmUgYSBzZWN0aW9uIHN1Ym1lbnUgb2YgaXRzIG93biBcdTIwMTQgYE1lbnUuc29ydCgpYCB3b3VsZCBmb2xkIHRoYXQgaW50byBhIHNlY29uZCwgbmVzdGVkXG4gKiBwbHVnaW4tdGl0bGVkIGVudHJ5LiBgQ29tbWFuZEhhbmRsZXJDb21wb25lbnRgIHRha2VzIGNhcmUgb2YgdGhpcyBieSBmb3JjaW5nXG4gKiBgQ29tbWFuZEhhbmRsZXJSZWdpc3RyYXRpb25Db250ZXh0LnNob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnVgIG9mZiBmb3IgdGhlIHN1cmZhY2VzIGl0IGZlZWRzIGhlcmUuXG4gKi9cbmV4cG9ydCBjbGFzcyBOb3RlYm9va05hdmlnYXRvck1lbnVFdmVudFJlZ2lzdHJhckNvbXBvbmVudCBleHRlbmRzIExheW91dFJlYWR5Q29tcG9uZW50IGltcGxlbWVudHMgTWVudUV2ZW50UmVnaXN0cmFyIHtcbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4ncyBkaXNwbGF5IG5hbWUsIHdoaWNoIHRpdGxlcyB0aGUgcGFyZW50IGVudHJ5LlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IHBsdWdpbk5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGljb24gZm9yIHRoZSBwYXJlbnQgZW50cnkuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgc3VibWVudUljb246IEljb25OYW1lO1xuXG4gIHByaXZhdGUgZmlsZU1lbnVFdmVudEhhbmRsZXJzOiBGaWxlTWVudUV2ZW50SGFuZGxlcltdID0gW107XG4gIHByaXZhdGUgZmlsZXNNZW51RXZlbnRIYW5kbGVyczogRmlsZXNNZW51RXZlbnRIYW5kbGVyW10gPSBbXTtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBOb3RlYm9vayBOYXZpZ2F0b3IgbWVudSBldmVudCByZWdpc3RyYXIuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIGNvbXBvbmVudC5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwYXJhbXM6IE5vdGVib29rTmF2aWdhdG9yTWVudUV2ZW50UmVnaXN0cmFyQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMpIHtcbiAgICBzdXBlcihwYXJhbXMuYXBwKTtcbiAgICB0aGlzLnBsdWdpbk5hbWUgPSBwYXJhbXMucGx1Z2luTmFtZTtcbiAgICB0aGlzLnN1Ym1lbnVJY29uID0gcGFyYW1zLnN1Ym1lbnVJY29uID8/ICcnO1xuICB9XG5cbiAgLyoqXG4gICAqIEFjY2VwdHMgYW4gZWRpdG9yLW1lbnUgcmVnaXN0cmF0aW9uIGFuZCBkb2VzIG5vdGhpbmcgd2l0aCBpdC5cbiAgICpcbiAgICogTm90ZWJvb2sgTmF2aWdhdG9yIGV4dGVuZHMgdGhlIGZpbGUgdHJlZSwgbm90IHRoZSBlZGl0b3IgXHUyMDE0IGFuIGVkaXRvciBtZW51IHRoZXJlIGlzIE9ic2lkaWFuJ3NcbiAgICogb3duLCB3aGljaCB0aGUgaGFuZGxlcnMgYWxyZWFkeSByZWFjaCB0aHJvdWdoIHRoZSB3b3Jrc3BhY2UgZXZlbnQuIFRoZSByZWdpc3RyYXRpb24gaXMgaW5lcnRcbiAgICogcmF0aGVyIHRoYW4gcmVmdXNlZCBzbyBhIGhhbmRsZXIgdGhhdCBkZWNsYXJlcyBvbmUgaXMgbm90IGEgbG9hZC10aW1lIGVycm9yLlxuICAgKlxuICAgKiBAcGFyYW0gX2hhbmRsZXIgLSBUaGUgaGFuZGxlciwgZGVsaWJlcmF0ZWx5IHVudXNlZC5cbiAgICogQHJldHVybnMgQSB7QGxpbmsgRGlzcG9zYWJsZUV4fSB0aGF0IGhhcyBub3RoaW5nIHRvIHVuZG8uXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJFZGl0b3JNZW51RXZlbnRIYW5kbGVyKF9oYW5kbGVyOiBFZGl0b3JNZW51RXZlbnRIYW5kbGVyKTogRGlzcG9zYWJsZUV4IHtcbiAgICByZXR1cm4gbmV3IENhbGxiYWNrRGlzcG9zYWJsZSh7IGNhbGxiYWNrOiBub29wIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIENvbGxlY3RzIGEgc2luZ2xlLWZpbGUgbWVudSBoYW5kbGVyLlxuICAgKlxuICAgKiBAcGFyYW0gaGFuZGxlciAtIFRoZSBoYW5kbGVyIHRvIGNvbGxlY3QuXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIERpc3Bvc2FibGVFeH0gdGhhdCBkcm9wcyB0aGUgaGFuZGxlciBhZ2FpbiAob3Igb24gY29tcG9uZW50IHVubG9hZCkuXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJGaWxlTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyOiBGaWxlTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgdGhpcy5maWxlTWVudUV2ZW50SGFuZGxlcnMucHVzaChoYW5kbGVyKTtcbiAgICByZXR1cm4gdGhpcy5yZWdpc3RlckRpc3Bvc2FibGUoXG4gICAgICBuZXcgQ2FsbGJhY2tEaXNwb3NhYmxlKHtcbiAgICAgICAgY2FsbGJhY2s6ICgpOiB2b2lkID0+IHtcbiAgICAgICAgICB0aGlzLmZpbGVNZW51RXZlbnRIYW5kbGVycyA9IHRoaXMuZmlsZU1lbnVFdmVudEhhbmRsZXJzLmZpbHRlcigoY29sbGVjdGVkKSA9PiBjb2xsZWN0ZWQgIT09IGhhbmRsZXIpO1xuICAgICAgICB9XG4gICAgICB9KVxuICAgICk7XG4gIH1cblxuICAvKipcbiAgICogQ29sbGVjdHMgYSBtdWx0aS1maWxlIG1lbnUgaGFuZGxlci5cbiAgICpcbiAgICogQHBhcmFtIGhhbmRsZXIgLSBUaGUgaGFuZGxlciB0byBjb2xsZWN0LlxuICAgKiBAcmV0dXJucyBBIHtAbGluayBEaXNwb3NhYmxlRXh9IHRoYXQgZHJvcHMgdGhlIGhhbmRsZXIgYWdhaW4gKG9yIG9uIGNvbXBvbmVudCB1bmxvYWQpLlxuICAgKi9cbiAgcHVibGljIHJlZ2lzdGVyRmlsZXNNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXI6IEZpbGVzTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgdGhpcy5maWxlc01lbnVFdmVudEhhbmRsZXJzLnB1c2goaGFuZGxlcik7XG4gICAgcmV0dXJuIHRoaXMucmVnaXN0ZXJEaXNwb3NhYmxlKFxuICAgICAgbmV3IENhbGxiYWNrRGlzcG9zYWJsZSh7XG4gICAgICAgIGNhbGxiYWNrOiAoKTogdm9pZCA9PiB7XG4gICAgICAgICAgdGhpcy5maWxlc01lbnVFdmVudEhhbmRsZXJzID0gdGhpcy5maWxlc01lbnVFdmVudEhhbmRsZXJzLmZpbHRlcigoY29sbGVjdGVkKSA9PiBjb2xsZWN0ZWQgIT09IGhhbmRsZXIpO1xuICAgICAgICB9XG4gICAgICB9KVxuICAgICk7XG4gIH1cblxuICAvKipcbiAgICogQmluZHMgdG8gTm90ZWJvb2sgTmF2aWdhdG9yIG9uY2UgZXZlcnkgcGx1Z2luIGhhcyBsb2FkZWQuXG4gICAqXG4gICAqIExheW91dC1yZWFkeSByYXRoZXIgdGhhbiBgb25sb2FkYDogcGx1Z2luIGxvYWQgb3JkZXIgaXMgbm90IG91cnMgdG8gY2hvb3NlLCBhbmQgTm90ZWJvb2tcbiAgICogTmF2aWdhdG9yJ3MgQVBJIG9ubHkgZXhpc3RzIG9uY2UgaXRzIG93biBwbHVnaW4gaXMgdXAuIFdoZW4gaXQgaXMgbm90IGluc3RhbGxlZCB0aGUgY29tcG9uZW50XG4gICAqIHN0YXlzIGRvcm1hbnQgXHUyMDE0IGVuYWJsaW5nIGl0IGxhdGVyIHRha2VzIGFuIE9ic2lkaWFuIHJlbG9hZCwgZXhhY3RseSBhcyBpdCBkb2VzIGZvciBhbnl0aGluZyBlbHNlXG4gICAqIHRoYXQgcmVhZHMgYW5vdGhlciBwbHVnaW4gYXQgc3RhcnR1cC5cbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBvbkxheW91dFJlYWR5KCk6IHZvaWQge1xuICAgIGNvbnN0IGFwaSA9IHJlc29sdmVOb3RlYm9va05hdmlnYXRvckFwaSh0aGlzLmFwcCk7XG4gICAgaWYgKGFwaSA9PT0gbnVsbCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIHRoaXMucmVnaXN0ZXIoYXBpLm1lbnVzLnJlZ2lzdGVyRmlsZU1lbnUoKGNvbnRleHQpID0+IHtcbiAgICAgIHRoaXMuaGFuZGxlRmlsZU1lbnUoY29udGV4dCk7XG4gICAgfSkpO1xuICAgIHRoaXMucmVnaXN0ZXIoYXBpLm1lbnVzLnJlZ2lzdGVyRm9sZGVyTWVudSgoY29udGV4dCkgPT4ge1xuICAgICAgdGhpcy5oYW5kbGVGb2xkZXJNZW51KGNvbnRleHQpO1xuICAgIH0pKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBBZGRzIHRoZSBwbHVnaW4ncyBlbnRyeSwgdW5sZXNzIHRoZSBoYW5kbGVycyBoYWQgbm90aGluZyB0byBjb250cmlidXRlLlxuICAgKlxuICAgKiBUaGUgbWVudSBpcyBwb3B1bGF0ZWQgVFdJQ0UsIGFuZCBib3RoIHJ1bnMgYXJlIG5lZWRlZDogTm90ZWJvb2sgTmF2aWdhdG9yJ3MgYGFkZEl0ZW1gIGNhbm5vdCBiZVxuICAgKiB0YWtlbiBiYWNrIG9uY2UgY2FsbGVkLCBzbyB0aGUgb25seSB3YXkgdG8ga2VlcCBhbiB1bnJlbGF0ZWQgZmlsZSdzIG1lbnUgY2xlYW4gaXMgdG8gYXNrIHRoZVxuICAgKiBoYW5kbGVycyBmaXJzdCwgYWdhaW5zdCBhIG1lbnUgbm9ib2R5IHNlZXMuIFRoZSBnYXRlcyB0aGV5IGFuc3dlciB3aXRoIGFyZSBtZXRhZGF0YSByZWFkcywgc28gdGhlXG4gICAqIHNlY29uZCBydW4gY29zdHMgbm90aGluZyBhbmQgY2Fubm90IGRpc2FncmVlIHdpdGggdGhlIGZpcnN0LlxuICAgKlxuICAgKiBAcGFyYW0gY29udGV4dCAtIFRoZSBOb3RlYm9vayBOYXZpZ2F0b3IgbWVudSBiZWluZyBidWlsdC5cbiAgICogQHBhcmFtIHBvcHVsYXRlIC0gUnVucyB0aGUgY29sbGVjdGVkIGhhbmRsZXJzIGFnYWluc3QgYSBtZW51LlxuICAgKi9cbiAgcHJpdmF0ZSBjb250cmlidXRlKGNvbnRleHQ6IE5vdGVib29rTmF2aWdhdG9yTWVudUNvbnRleHQsIHBvcHVsYXRlOiAobWVudTogTWVudSkgPT4gdm9pZCk6IHZvaWQge1xuICAgIGNvbnN0IHByb2JlTWVudSA9IG5ldyBNZW51SW1wbCgpO1xuICAgIHBvcHVsYXRlKHByb2JlTWVudSk7XG5cbiAgICBpZiAocHJvYmVNZW51Lml0ZW1zLmxlbmd0aCA9PT0gMCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGNvbnRleHQuYWRkSXRlbSgoaXRlbSkgPT4ge1xuICAgICAgaXRlbVxuICAgICAgICAuc2V0VGl0bGUodGhpcy5wbHVnaW5OYW1lKVxuICAgICAgICAuc2V0SWNvbih0aGlzLnN1Ym1lbnVJY29uKTtcbiAgICAgIHBvcHVsYXRlKGl0ZW0uc2V0U3VibWVudSgpKTtcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBIYW5kbGVzIGEgZmlsZSBtZW51LCBzaW5nbGUgb3IgbXVsdGktc2VsZWN0aW9uLlxuICAgKlxuICAgKiBAcGFyYW0gY29udGV4dCAtIFRoZSBOb3RlYm9vayBOYXZpZ2F0b3IgbWVudSBiZWluZyBidWlsdC5cbiAgICovXG4gIHByaXZhdGUgaGFuZGxlRmlsZU1lbnUoY29udGV4dDogTm90ZWJvb2tOYXZpZ2F0b3JGaWxlTWVudUNvbnRleHQpOiB2b2lkIHtcbiAgICBjb25zdCBzZWxlY3RlZEZpbGVzOiBURmlsZVtdID0gWy4uLmNvbnRleHQuc2VsZWN0aW9uLmZpbGVzXTtcbiAgICB0aGlzLmNvbnRyaWJ1dGUoXG4gICAgICBjb250ZXh0LFxuICAgICAgY29udGV4dC5zZWxlY3Rpb24ubW9kZSA9PT0gJ211bHRpcGxlJ1xuICAgICAgICA/IChtZW51OiBNZW51KTogdm9pZCA9PiB7XG4gICAgICAgICAgdGhpcy5ydW5GaWxlc01lbnVIYW5kbGVycyhtZW51LCBzZWxlY3RlZEZpbGVzKTtcbiAgICAgICAgfVxuICAgICAgICA6IChtZW51OiBNZW51KTogdm9pZCA9PiB7XG4gICAgICAgICAgdGhpcy5ydW5GaWxlTWVudUhhbmRsZXJzKG1lbnUsIGNvbnRleHQuZmlsZSk7XG4gICAgICAgIH1cbiAgICApO1xuICB9XG5cbiAgLyoqXG4gICAqIEhhbmRsZXMgYSBmb2xkZXIgbWVudS5cbiAgICpcbiAgICogQSBmb2xkZXIgZ29lcyB0aHJvdWdoIHRoZSBTSU5HTEUtZmlsZSBoYW5kbGVycywgYmVjYXVzZSB0aGF0IGlzIGhvdyBPYnNpZGlhbidzIG93biBgZmlsZS1tZW51YFxuICAgKiBjYXJyaWVzIG9uZSBcdTIwMTQgdGhlIGV2ZW50IGlzIHR5cGVkIHtAbGluayBUQWJzdHJhY3RGaWxlfSwgYW5kIHRoZSBmb2xkZXIgaGFuZGxlcnMgYXJlIHRoZSBvbmVzIHRoYXRcbiAgICogbmFycm93IGl0LlxuICAgKlxuICAgKiBAcGFyYW0gY29udGV4dCAtIFRoZSBOb3RlYm9vayBOYXZpZ2F0b3IgbWVudSBiZWluZyBidWlsdC5cbiAgICovXG4gIHByaXZhdGUgaGFuZGxlRm9sZGVyTWVudShjb250ZXh0OiBOb3RlYm9va05hdmlnYXRvckZvbGRlck1lbnVDb250ZXh0KTogdm9pZCB7XG4gICAgdGhpcy5jb250cmlidXRlKGNvbnRleHQsIChtZW51OiBNZW51KTogdm9pZCA9PiB7XG4gICAgICB0aGlzLnJ1bkZpbGVNZW51SGFuZGxlcnMobWVudSwgY29udGV4dC5mb2xkZXIpO1xuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIFJ1bnMgdGhlIHNpbmdsZS1maWxlIGhhbmRsZXJzIGFnYWluc3QgYSBtZW51LlxuICAgKlxuICAgKiBAcGFyYW0gbWVudSAtIFRoZSBtZW51IHRvIHBvcHVsYXRlLlxuICAgKiBAcGFyYW0gYWJzdHJhY3RGaWxlIC0gVGhlIGZpbGUgb3IgZm9sZGVyIHRoZSBtZW51IHdhcyByYWlzZWQgb24uXG4gICAqL1xuICBwcml2YXRlIHJ1bkZpbGVNZW51SGFuZGxlcnMobWVudTogTWVudSwgYWJzdHJhY3RGaWxlOiBUQWJzdHJhY3RGaWxlKTogdm9pZCB7XG4gICAgZm9yIChjb25zdCBoYW5kbGVyIG9mIHRoaXMuZmlsZU1lbnVFdmVudEhhbmRsZXJzKSB7XG4gICAgICBoYW5kbGVyKG1lbnUsIGFic3RyYWN0RmlsZSwgTk9URUJPT0tfTkFWSUdBVE9SX01FTlVfU09VUkNFKTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogUnVucyB0aGUgbXVsdGktZmlsZSBoYW5kbGVycyBhZ2FpbnN0IGEgbWVudS5cbiAgICpcbiAgICogQHBhcmFtIG1lbnUgLSBUaGUgbWVudSB0byBwb3B1bGF0ZS5cbiAgICogQHBhcmFtIGFic3RyYWN0RmlsZXMgLSBUaGUgZmlsZXMgdGhlIG1lbnUgd2FzIHJhaXNlZCBvbi5cbiAgICovXG4gIHByaXZhdGUgcnVuRmlsZXNNZW51SGFuZGxlcnMobWVudTogTWVudSwgYWJzdHJhY3RGaWxlczogVEFic3RyYWN0RmlsZVtdKTogdm9pZCB7XG4gICAgZm9yIChjb25zdCBoYW5kbGVyIG9mIHRoaXMuZmlsZXNNZW51RXZlbnRIYW5kbGVycykge1xuICAgICAgaGFuZGxlcihtZW51LCBhYnN0cmFjdEZpbGVzLCBOT1RFQk9PS19OQVZJR0FU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

package/dist/lib/cjs/obsidian/components/notebook-navigator-menu-event-registrar-component.d.cts

@@ -0,0 +1,139 @@
+/// <reference path="../../library.d.cts" />
+/**
+ * @file
+ *
+ * Bridges the file and files context-menu events into Notebook Navigator's own menus.
+ *
+ * Notebook Navigator draws its own file tree and never raises Obsidian's `file-menu` / `files-menu`
+ * workspace events, so a plugin's context-menu items vanish for anyone browsing through it. This
+ * component is a {@link MenuEventRegistrar} backed by Notebook Navigator's extension API instead of
+ * the workspace, so the very same handlers reach both surfaces.
+ */
+import type { App, IconName } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { DisposableEx } from '../../disposable.cjs';
+import type { EditorMenuEventHandler, FileMenuEventHandler, FilesMenuEventHandler, MenuEventRegistrar } from '../menu-event-registrar.cjs';
+import { LayoutReadyComponent } from './layout-ready-component.cjs';
+/**
+ * Parameters for {@link NotebookNavigatorMenuEventRegistrarComponent}.
+ */
+export interface NotebookNavigatorMenuEventRegistrarComponentConstructorParams {
+    /**
+     * The application instance.
+     */
+    readonly app: App;
+    /**
+     * The plugin's display name, which titles the parent entry.
+     */
+    readonly pluginName: string;
+    /**
+     * The icon for the parent entry.
+     *
+     * @default `''` (no icon)
+     */
+    readonly submenuIcon?: IconName | undefined;
+}
+/**
+ * {@link MenuEventRegistrar} backed by Notebook Navigator's menu-extension API.
+ *
+ * Handlers registered here are collected eagerly and bound to Notebook Navigator once the workspace
+ * layout is ready. When Notebook Navigator is not installed the component simply stays dormant.
+ *
+ * Every collected handler writes into a plugin-titled parent entry's submenu, so a handler must NOT
+ * declare a section submenu of its own — `Menu.sort()` would fold that into a second, nested
+ * plugin-titled entry. `CommandHandlerComponent` takes care of this by forcing
+ * `CommandHandlerRegistrationContext.shouldAddCommandToSubmenu` off for the surfaces it feeds here.
+ */
+export declare class NotebookNavigatorMenuEventRegistrarComponent extends LayoutReadyComponent implements MenuEventRegistrar {
+    /**
+     * The plugin's display name, which titles the parent entry.
+     */
+    protected readonly pluginName: string;
+    /**
+     * The icon for the parent entry.
+     */
+    protected readonly submenuIcon: IconName;
+    private fileMenuEventHandlers;
+    private filesMenuEventHandlers;
+    /**
+     * Creates a new Notebook Navigator menu event registrar.
+     *
+     * @param params - The parameters for the component.
+     */
+    constructor(params: NotebookNavigatorMenuEventRegistrarComponentConstructorParams);
+    /**
+     * Accepts an editor-menu registration and does nothing with it.
+     *
+     * Notebook Navigator extends the file tree, not the editor — an editor menu there is Obsidian's
+     * own, which the handlers already reach through the workspace event. The registration is inert
+     * rather than refused so a handler that declares one is not a load-time error.
+     *
+     * @param _handler - The handler, deliberately unused.
+     * @returns A {@link DisposableEx} that has nothing to undo.
+     */
+    registerEditorMenuEventHandler(_handler: EditorMenuEventHandler): DisposableEx;
+    /**
+     * Collects a single-file menu handler.
+     *
+     * @param handler - The handler to collect.
+     * @returns A {@link DisposableEx} that drops the handler again (or on component unload).
+     */
+    registerFileMenuEventHandler(handler: FileMenuEventHandler): DisposableEx;
+    /**
+     * Collects a multi-file menu handler.
+     *
+     * @param handler - The handler to collect.
+     * @returns A {@link DisposableEx} that drops the handler again (or on component unload).
+     */
+    registerFilesMenuEventHandler(handler: FilesMenuEventHandler): DisposableEx;
+    /**
+     * Binds to Notebook Navigator once every plugin has loaded.
+     *
+     * Layout-ready rather than `onload`: plugin load order is not ours to choose, and Notebook
+     * Navigator's API only exists once its own plugin is up. When it is not installed the component
+     * stays dormant — enabling it later takes an Obsidian reload, exactly as it does for anything else
+     * that reads another plugin at startup.
+     */
+    protected onLayoutReady(): void;
+    /**
+     * Adds the plugin's entry, unless the handlers had nothing to contribute.
+     *
+     * The menu is populated TWICE, and both runs are needed: Notebook Navigator's `addItem` cannot be
+     * taken back once called, so the only way to keep an unrelated file's menu clean is to ask the
+     * handlers first, against a menu nobody sees. The gates they answer with are metadata reads, so the
+     * second run costs nothing and cannot disagree with the first.
+     *
+     * @param context - The Notebook Navigator menu being built.
+     * @param populate - Runs the collected handlers against a menu.
+     */
+    private contribute;
+    /**
+     * Handles a file menu, single or multi-selection.
+     *
+     * @param context - The Notebook Navigator menu being built.
+     */
+    private handleFileMenu;
+    /**
+     * Handles a folder menu.
+     *
+     * A folder goes through the SINGLE-file handlers, because that is how Obsidian's own `file-menu`
+     * carries one — the event is typed {@link TAbstractFile}, and the folder handlers are the ones that
+     * narrow it.
+     *
+     * @param context - The Notebook Navigator menu being built.
+     */
+    private handleFolderMenu;
+    /**
+     * Runs the single-file handlers against a menu.
+     *
+     * @param menu - The menu to populate.
+     * @param abstractFile - The file or folder the menu was raised on.
+     */
+    private runFileMenuHandlers;
+    /**
+     * Runs the multi-file handlers against a menu.
+     *
+     * @param menu - The menu to populate.
+     * @param abstractFiles - The files the menu was raised on.
+     */
+    private runFilesMenuHandlers;
+}

package/dist/lib/cjs/obsidian/components/plugin-context-component.cjs

@@ -40,16 +40,11 @@ if you want to view the source, please visit the github repository of this plugi
     globalThisRecord[key] ??= newFuncs[key]?.();
   }
 
-  function name(obj) {
-    return obj;
-  }
-
   function extractDefault(module) {
     return module && module.__esModule && 'default' in module ? module.default : module;
   }
 
-  const OBSIDIAN_BUILT_IN_MODULE_NAMES = [
-  'obsidian',
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
   '@codemirror/autocomplete',
   '@codemirror/collab',
   '@codemirror/commands',
@@ -60,11 +55,12 @@ if you want to view the source, please visit the github repository of this plugi
   '@codemirror/text',
   '@codemirror/view',
   '@lezer/common',
+  '@lezer/highlight',
   '@lezer/lr',
-  '@lezer/highlight'];
-
+  'obsidian']
+  );
 
-  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = [
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
   '@codemirror/closebrackets',
   '@codemirror/comment',
   '@codemirror/fold',
@@ -76,11 +72,11 @@ if you want to view the source, please visit the github repository of this plugi
   '@codemirror/rangeset',
   '@codemirror/rectangular-selection',
   '@codemirror/stream-parser',
-  '@codemirror/tooltip'];
-
+  '@codemirror/tooltip']
+  );
 
   function requirePatched(id) {
-    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id)) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
       return originalRequire?.(id);
     }
 
@@ -89,8 +85,8 @@ if you want to view the source, please visit the github repository of this plugi
       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.`);
-        // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
-        return globalThis.process;
+
+        return process;
       }
     } else {
       const module = originalRequire?.(id);
@@ -168,4 +164,4 @@ class PluginContextComponent extends import_component_ex.ComponentEx {
 0 && (module.exports = {
   PluginContextComponent
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvcGx1Z2luLWNvbnRleHQtY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgaW5pdGlhbGl6ZXMgdGhlIHBsdWdpbiBjb250ZXh0LCBkZWJ1ZyBjb250cm9sbGVyLCBhbmQgbGlicmFyeSBzdHlsZXMuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IExpYnJhcnkgfSBmcm9tICcuLi8uLi9saWJyYXJ5LnRzJztcbmltcG9ydCB7XG4gIGluaXREZWJ1Z0NvbnRyb2xsZXIsXG4gIGluaXRQbHVnaW5Db250ZXh0XG59IGZyb20gJy4uL3BsdWdpbi9wbHVnaW4tY29udGV4dC50cyc7XG5pbXBvcnQgeyBBbGxXaW5kb3dzRXZlbnRDb21wb25lbnQgfSBmcm9tICcuL2FsbC13aW5kb3dzLWV2ZW50LWNvbXBvbmVudC50cyc7XG5pbXBvcnQgeyBDb21wb25lbnRFeCB9IGZyb20gJy4vY29tcG9uZW50LWV4LnRzJztcblxuaW50ZXJmYWNlIFBsdWdpbkNvbnRleHRDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIHJlYWRvbmx5IGFwcDogQXBwO1xuICByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nO1xufVxuXG4vKipcbiAqIEluaXRpYWxpemVzIHBsdWdpbiBjb250ZXh0IChwbHVnaW4gSUQsIGRlYnVnIGNvbnRyb2xsZXIsIGxpYnJhcnkgc3R5bGVzKSBvbiBsb2FkLlxuICovXG5leHBvcnQgY2xhc3MgUGx1Z2luQ29udGV4dENvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudEV4IHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgYXBwOiBBcHA7XG5cbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4gSUQgdXNlZCB0byBpbml0aWFsaXplIHRoZSBwbHVnaW4gY29udGV4dCBhbmQgZGVidWcgY29udHJvbGxlci5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IHBsdWdpbiBjb250ZXh0IGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBjb25zdHJ1Y3RvciBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogUGx1Z2luQ29udGV4dENvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLmFwcCA9IHBhcmFtcy5hcHA7XG4gICAgdGhpcy5wbHVnaW5JZCA9IHBhcmFtcy5wbHVnaW5JZDtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbml0aWFsaXplcyB0aGUgcGx1Z2luIGNvbnRleHQgYW5kIGRlYnVnIGNvbnRyb2xsZXIuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgb25sb2FkKCk6IHZvaWQge1xuICAgIGluaXRQbHVnaW5Db250ZXh0KHRoaXMucGx1Z2luSWQpO1xuICAgIC8vIFJlc2V0IG9uIHVubG9hZCBzbyBhIHBsdWdpbiByZWxvYWQgY2FuIHJlLWluaXRpYWxpemUgd2l0aG91dCB0cmlwcGluZyB0aGUgb25jZS1vbmx5IGBMaWJyYXJ5LmluaXRgIGd1YXJkLlxuICAgIHRoaXMucmVnaXN0ZXIoKCkgPT4ge1xuICAgICAgTGlicmFyeS5yZXNldFRvRGVmYXVsdCgpO1xuICAgIH0pO1xuICAgIHRoaXMuYWRkQ2hpbGQobmV3IEFsbFdpbmRvd3NFdmVudENvbXBvbmVudCh0aGlzLmFwcCkpLnJlZ2lzdGVyQWxsV2luZG93c0hhbmRsZXIoKHdpbikgPT4ge1xuICAgICAgaW5pdERlYnVnQ29udHJvbGxlcih3aW4sIHRoaXMpO1xuICAgIH0pO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFRQSxxQkFBd0I7QUFDeEIsNEJBR087QUFDUCx5Q0FBeUM7QUFDekMsMEJBQTRCO0FBVXJCLE1BQU0sK0JBQStCLGdDQUFZO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFJbkM7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1osWUFBWSxRQUFpRDtBQUNsRSxVQUFNO0FBQ04sU0FBSyxNQUFNLE9BQU87QUFDbEIsU0FBSyxXQUFXLE9BQU87QUFBQSxFQUN6QjtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS2dCLFNBQWU7QUFDN0IsaURBQWtCLEtBQUssUUFBUTtBQUUvQixTQUFLLFNBQVMsTUFBTTtBQUNsQiw2QkFBUSxlQUFlO0FBQUEsSUFDekIsQ0FBQztBQUNELFNBQUssU0FBUyxJQUFJLDREQUF5QixLQUFLLEdBQUcsQ0FBQyxFQUFFLDBCQUEwQixDQUFDLFFBQVE7QUFDdkYscURBQW9CLEtBQUssSUFBSTtBQUFBLElBQy9CLENBQUM7QUFBQSxFQUNIO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvcGx1Z2luLWNvbnRleHQtY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgaW5pdGlhbGl6ZXMgdGhlIHBsdWdpbiBjb250ZXh0LCBkZWJ1ZyBjb250cm9sbGVyLCBhbmQgbGlicmFyeSBzdHlsZXMuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IExpYnJhcnkgfSBmcm9tICcuLi8uLi9saWJyYXJ5LnRzJztcbmltcG9ydCB7XG4gIGluaXREZWJ1Z0NvbnRyb2xsZXIsXG4gIGluaXRQbHVnaW5Db250ZXh0XG59IGZyb20gJy4uL3BsdWdpbi9wbHVnaW4tY29udGV4dC50cyc7XG5pbXBvcnQgeyBBbGxXaW5kb3dzRXZlbnRDb21wb25lbnQgfSBmcm9tICcuL2FsbC13aW5kb3dzLWV2ZW50LWNvbXBvbmVudC50cyc7XG5pbXBvcnQgeyBDb21wb25lbnRFeCB9IGZyb20gJy4vY29tcG9uZW50LWV4LnRzJztcblxuaW50ZXJmYWNlIFBsdWdpbkNvbnRleHRDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIHJlYWRvbmx5IGFwcDogQXBwO1xuICByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nO1xufVxuXG4vKipcbiAqIEluaXRpYWxpemVzIHBsdWdpbiBjb250ZXh0IChwbHVnaW4gSUQsIGRlYnVnIGNvbnRyb2xsZXIsIGxpYnJhcnkgc3R5bGVzKSBvbiBsb2FkLlxuICovXG5leHBvcnQgY2xhc3MgUGx1Z2luQ29udGV4dENvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudEV4IHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgYXBwOiBBcHA7XG5cbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4gSUQgdXNlZCB0byBpbml0aWFsaXplIHRoZSBwbHVnaW4gY29udGV4dCBhbmQgZGVidWcgY29udHJvbGxlci5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IHBsdWdpbiBjb250ZXh0IGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBjb25zdHJ1Y3RvciBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogUGx1Z2luQ29udGV4dENvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLmFwcCA9IHBhcmFtcy5hcHA7XG4gICAgdGhpcy5wbHVnaW5JZCA9IHBhcmFtcy5wbHVnaW5JZDtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbml0aWFsaXplcyB0aGUgcGx1Z2luIGNvbnRleHQgYW5kIGRlYnVnIGNvbnRyb2xsZXIuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgb25sb2FkKCk6IHZvaWQge1xuICAgIGluaXRQbHVnaW5Db250ZXh0KHRoaXMucGx1Z2luSWQpO1xuICAgIC8vIFJlc2V0IG9uIHVubG9hZCBzbyBhIHBsdWdpbiByZWxvYWQgY2FuIHJlLWluaXRpYWxpemUgd2l0aG91dCB0cmlwcGluZyB0aGUgb25jZS1vbmx5IGBMaWJyYXJ5LmluaXRgIGd1YXJkLlxuICAgIHRoaXMucmVnaXN0ZXIoKCkgPT4ge1xuICAgICAgTGlicmFyeS5yZXNldFRvRGVmYXVsdCgpO1xuICAgIH0pO1xuICAgIHRoaXMuYWRkQ2hpbGQobmV3IEFsbFdpbmRvd3NFdmVudENvbXBvbmVudCh0aGlzLmFwcCkpLnJlZ2lzdGVyQWxsV2luZG93c0hhbmRsZXIoKHdpbikgPT4ge1xuICAgICAgaW5pdERlYnVnQ29udHJvbGxlcih3aW4sIHRoaXMpO1xuICAgIH0pO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQVFBLHFCQUF3QjtBQUN4Qiw0QkFHTztBQUNQLHlDQUF5QztBQUN6QywwQkFBNEI7QUFVckIsTUFBTSwrQkFBK0IsZ0NBQVk7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUluQztBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPWixZQUFZLFFBQWlEO0FBQ2xFLFVBQU07QUFDTixTQUFLLE1BQU0sT0FBTztBQUNsQixTQUFLLFdBQVcsT0FBTztBQUFBLEVBQ3pCO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLZ0IsU0FBZTtBQUM3QixpREFBa0IsS0FBSyxRQUFRO0FBRS9CLFNBQUssU0FBUyxNQUFNO0FBQ2xCLDZCQUFRLGVBQWU7QUFBQSxJQUN6QixDQUFDO0FBQ0QsU0FBSyxTQUFTLElBQUksNERBQXlCLEtBQUssR0FBRyxDQUFDLEVBQUUsMEJBQTBCLENBQUMsUUFBUTtBQUN2RixxREFBb0IsS0FBSyxJQUFJO0FBQUEsSUFDL0IsQ0FBQztBQUFBLEVBQ0g7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K