@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/notebook-navigator.d.cts

@@ -0,0 +1,132 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * The slice of Notebook Navigator's public API this library talks to, and the runtime narrowing that
+ * gets hold of it.
+ *
+ * **Notebook Navigator draws its own file tree, so it never raises Obsidian's `file-menu` /
+ * `files-menu` workspace events** — which is why a plugin's context-menu items simply disappear for
+ * anyone browsing through it. What it offers instead is a documented extension API
+ * (`docs/api-reference.md` + `src/api/public/notebook-navigator.d.ts` in `johansan/notebook-navigator`,
+ * API 2.0.0), reachable at runtime as `app.plugins.getPlugin('notebook-navigator').api`.
+ *
+ * The types below are DECLARED HERE rather than imported: Notebook Navigator ships its `.d.ts` for
+ * download, not as an npm package, and depending on it would turn an optional integration into a
+ * build-time dependency. They are deliberately the narrowest shape this library uses — the API also
+ * carries `metadata`, `navigation`, `selection`, `tagCollections`, `propertyNodes` and an event bus,
+ * none of which apply to a file/folder command surface.
+ */
+import type { App, MenuItem, TFile, TFolder } from 'obsidian' with { 'resolution-mode': 'import' };
+/**
+ * Notebook Navigator's public API object, narrowed to what this library uses.
+ */
+export interface NotebookNavigatorApi {
+    /**
+     * The menu-extension namespace.
+     */
+    readonly menus: NotebookNavigatorMenus;
+}
+/**
+ * What `menus.registerFileMenu` hands a subscriber when a FILE is right-clicked.
+ *
+ * There is no `Menu` here — an item is contributed through `addItem` alone, which is why the
+ * file/files menu handlers cannot simply be forwarded to it and have to be bridged (see
+ * `components/notebook-navigator-menu-event-registrar-component.ts`).
+ */
+export interface NotebookNavigatorFileMenuContext extends NotebookNavigatorMenuContext {
+    /**
+     * The file that was right-clicked.
+     */
+    readonly file: TFile;
+    /**
+     * What the tree had selected when the menu was raised.
+     */
+    readonly selection: NotebookNavigatorFileMenuSelection;
+}
+/**
+ * The selection a file menu was raised on.
+ */
+export interface NotebookNavigatorFileMenuSelection {
+    /**
+     * Every selected file, which for `single` is just the right-clicked one.
+     */
+    readonly files: readonly TFile[];
+    /**
+     * Whether one file or several are selected.
+     */
+    readonly mode: NotebookNavigatorFileMenuSelectionMode;
+}
+/**
+ * Whether a file menu covers one file or a multi-selection.
+ */
+export type NotebookNavigatorFileMenuSelectionMode = 'multiple' | 'single';
+/**
+ * What `menus.registerFolderMenu` hands a subscriber when a FOLDER is right-clicked.
+ */
+export interface NotebookNavigatorFolderMenuContext extends NotebookNavigatorMenuContext {
+    /**
+     * The folder that was right-clicked.
+     */
+    readonly folder: TFolder;
+}
+/**
+ * What every Notebook Navigator menu context has in common: a way to add an item, and nothing else.
+ *
+ * The absence of a `Menu` is the whole shape of the integration problem — command handlers write into
+ * a `Menu`, so something has to sit between them and this.
+ */
+export interface NotebookNavigatorMenuContext {
+    /**
+     * Adds an item to the menu Notebook Navigator is building.
+     *
+     * @param callback - Receives the created item, to be configured in place.
+     */
+    addItem: (callback: (item: MenuItem) => void) => void;
+}
+/**
+ * Unregisters a menu extension. Notebook Navigator returns a bare function rather than a disposable,
+ * so it is registered with the bridging component's `register`.
+ */
+export type NotebookNavigatorMenuDispose = () => void;
+/**
+ * The `menus` namespace of Notebook Navigator's API.
+ *
+ * Only the file and folder registrars are declared: the tag and property registrars extend menus
+ * raised on things a file/folder command handler has no counterpart for.
+ */
+export interface NotebookNavigatorMenus {
+    /**
+     * Registers a contributor to the file context menu.
+     *
+     * @param callback - Invoked while the menu is being built.
+     * @returns A function that unregisters the contributor.
+     */
+    registerFileMenu: (callback: (context: NotebookNavigatorFileMenuContext) => void) => NotebookNavigatorMenuDispose;
+    /**
+     * Registers a contributor to the folder context menu.
+     *
+     * @param callback - Invoked while the menu is being built.
+     * @returns A function that unregisters the contributor.
+     */
+    registerFolderMenu: (callback: (context: NotebookNavigatorFolderMenuContext) => void) => NotebookNavigatorMenuDispose;
+}
+/**
+ * The `source` handed to the menu event handlers for a Notebook Navigator menu.
+ *
+ * Obsidian's own File Explorer sends `file-explorer-context-menu`; nothing in this library gates on
+ * the value, but the handlers are contracted to receive one, and a distinct string is what makes a
+ * handler able to tell the two surfaces apart.
+ */
+export declare const NOTEBOOK_NAVIGATOR_MENU_SOURCE = "notebook-navigator-context-menu";
+/**
+ * Notebook Navigator's plugin id, as its manifest declares it.
+ */
+export declare const NOTEBOOK_NAVIGATOR_PLUGIN_ID = "notebook-navigator";
+/**
+ * Gets Notebook Navigator's API, when it is installed, enabled and new enough.
+ *
+ * @param app - The application instance.
+ * @returns The API, or `null` when Notebook Navigator is not there to talk to.
+ */
+export declare function resolveNotebookNavigatorApi(app: App): NotebookNavigatorApi | null;

package/dist/lib/cjs/obsidian-dev-utils-state.cjs

@@ -0,0 +1,199 @@
+/*
+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 obsidian_dev_utils_state_exports = {};
+__export(obsidian_dev_utils_state_exports, {
+  getObsidianDevUtilsState: () => getObsidianDevUtilsState,
+  resetObsidianDevUtilsState: () => resetObsidianDevUtilsState,
+  shareTypescriptLibStateWithObsidianDevUtilsState: () => shareTypescriptLibStateWithObsidianDevUtilsState
+});
+module.exports = __toCommonJS(obsidian_dev_utils_state_exports);
+var import_typescript_lib_state = require('@mnaoumov/typescript-lib/typescript-lib-state');
+var import_value_wrapper = require('@mnaoumov/typescript-lib/value-wrapper');
+const SHARED_WITH_TYPESCRIPT_LIB_STATE_KEYS = ["debug", "debuggers", "sharedAbortController"];
+function getObsidianDevUtilsState(key, defaultValue) {
+  return getObsidianDevUtilsBag()[key] ??= import_value_wrapper.ValueWrapper.of(defaultValue);
+}
+function resetObsidianDevUtilsState() {
+  globalThis.__obsidianDevUtils = {};
+}
+function shareTypescriptLibStateWithObsidianDevUtilsState() {
+  const bag = getObsidianDevUtilsBag();
+  const values = (0, import_typescript_lib_state.getTypescriptLibStateSlot)().values;
+  for (const key of SHARED_WITH_TYPESCRIPT_LIB_STATE_KEYS) {
+    const legacyWrapper = bag[key];
+    if (legacyWrapper) {
+      values[key] = legacyWrapper;
+      continue;
+    }
+    const wrapper = values[key];
+    if (wrapper) {
+      bag[key] = wrapper;
+    }
+  }
+}
+function getObsidianDevUtilsBag() {
+  const wrapper = globalThis;
+  wrapper.__obsidianDevUtils ??= {};
+  return wrapper.__obsidianDevUtils;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getObsidianDevUtilsState,
+  resetObsidianDevUtilsState,
+  shareTypescriptLibStateWithObsidianDevUtilsState
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL29ic2lkaWFuLWRldi11dGlscy1zdGF0ZS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFByb3ZpZGVzIGFjY2VzcyB0byBhIHByb2Nlc3Mtd2lkZSBzaGFyZWQtc3RhdGUgYmFnIHVzZWQgaW50ZXJuYWxseSBieSBgb2JzaWRpYW4tZGV2LXV0aWxzYC5cbiAqXG4gKiBUaGUgYmFnIGlzIHN0b3JlZCBvbiBgZ2xvYmFsVGhpcy5fX29ic2lkaWFuRGV2VXRpbHNgLCBpLmUuIG9uIHRoZSBnbG9iYWwgb2JqZWN0IG9mIHRoZSByZWFsbSBpblxuICogd2hpY2ggYG9ic2lkaWFuLWRldi11dGlsc2AgaXMgbG9hZGVkLiBCZWNhdXNlIGEgZnVuY3Rpb24ncyBgZ2xvYmFsVGhpc2AgcmVzb2x2ZXMgdG8gaXRzIGRlZmluaW5nXG4gKiByZWFsbSAobm90IHRoZSBjYWxsZXIncyksIGV2ZXJ5IGNvbnN1bWVyIHRoYXQgYnVuZGxlcyB0aGUgbGlicmFyeSBpbiB0aGUgbWFpbiBPYnNpZGlhbiByZW5kZXJlclxuICogc2hhcmVzIHRoZSBzYW1lIGJhZywgcmVnYXJkbGVzcyBvZiB3aGljaCB3aW5kb3cgaXMgY3VycmVudGx5IGFjdGl2ZS4gVGhpcyBpbnRlbnRpb25hbGx5IHJlcGxhY2VzXG4gKiB0aGUgcHJldmlvdXMgYEFwcGAtc2NvcGVkIHN0b3JhZ2UsIHNvIGNhbGxlcnMgbm8gbG9uZ2VyIG5lZWQgdG8gcGFzcyBhbiBgQXBwYCBpbnN0YW5jZS5cbiAqXG4gKiBUaGUgZ2VuZXJpYywgbm9uLU9ic2lkaWFuIHN0YXRlICh0aGUgZGVidWdnZXJzLCB0aGUgYGRlYnVnYCBpbnN0YW5jZSBhbmQgdGhlIHNoYXJlZCBhYm9ydCBjb250cm9sbGVyKSBsaXZlcyBpblxuICogYHR5cGVzY3JpcHQtbGliLXN0YXRlLnRzYCBpbnN0ZWFkLiB7QGxpbmsgc2hhcmVUeXBlc2NyaXB0TGliU3RhdGVXaXRoT2JzaWRpYW5EZXZVdGlsc1N0YXRlfSBsaW5rcyB0aGUgdHdvLCBzb1xuICogcGx1Z2lucyBidW5kbGluZyBhbiBvbGRlciBjb3B5IG9mIHRoaXMgbGlicmFyeSwgd2hpY2ggc3RpbGwga2VlcCB0aGF0IHN0YXRlIGhlcmUsIHNoYXJlIGl0IHdpdGggbmV3ZXIgb25lcy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEdlbmVyaWNPYmplY3QgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuXG5pbXBvcnQgeyBnZXRUeXBlc2NyaXB0TGliU3RhdGVTbG90IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGVzY3JpcHQtbGliLXN0YXRlJztcbmltcG9ydCB7IFZhbHVlV3JhcHBlciB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi92YWx1ZS13cmFwcGVyJztcblxuaW50ZXJmYWNlIE9ic2lkaWFuRGV2VXRpbHNXcmFwcGVyIHtcbiAgX19vYnNpZGlhbkRldlV0aWxzOiBHZW5lcmljT2JqZWN0O1xufVxuXG4vKipcbiAqIFRoZSBrZXlzIHdob3NlIHN0YXRlIG1vdmVkIGZyb20gYF9fb2JzaWRpYW5EZXZVdGlsc2AgdG8gdGhlIGdlbmVyaWMgc2hhcmVkIHN0YXRlLCBhbmQgd2hpY2ggb2xkZXIgY29waWVzIG9mXG4gKiB0aGlzIGxpYnJhcnkgc3RpbGwga2VlcCB1bmRlciBgX19vYnNpZGlhbkRldlV0aWxzYC5cbiAqL1xuY29uc3QgU0hBUkVEX1dJVEhfVFlQRVNDUklQVF9MSUJfU1RBVEVfS0VZUyA9IFsnZGVidWcnLCAnZGVidWdnZXJzJywgJ3NoYXJlZEFib3J0Q29udHJvbGxlciddIGFzIGNvbnN0O1xuXG4vKipcbiAqIFJldHJpZXZlcyBvciBjcmVhdGVzIGEgc2hhcmVkLXN0YXRlIHtAbGluayBWYWx1ZVdyYXBwZXJ9IGZvciBhIGdpdmVuIGtleSBvbiBgZ2xvYmFsVGhpcy5fX29ic2lkaWFuRGV2VXRpbHNgLlxuICpcbiAqIEB0eXBlUGFyYW0gVCAtIFRoZSB0eXBlIG9mIHRoZSBzaGFyZWQgc3RhdGUgdmFsdWUuXG4gKiBAcGFyYW0ga2V5IC0gVGhlIGtleSB0byBzdG9yZSBvciByZXRyaWV2ZSB0aGUgc2hhcmVkIHN0YXRlIHVuZGVyLlxuICogQHBhcmFtIGRlZmF1bHRWYWx1ZSAtIFRoZSBkZWZhdWx0IHZhbHVlIHRvIHVzZSBpZiB0aGUgc2hhcmVkIHN0YXRlIGRvZXMgbm90IGV4aXN0IHlldC5cbiAqIEByZXR1cm5zIFRoZSB7QGxpbmsgVmFsdWVXcmFwcGVyfSB0aGF0IHN0b3JlcyB0aGUgc2hhcmVkIHN0YXRlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlPFQ+KGtleTogc3RyaW5nLCBkZWZhdWx0VmFsdWU6IFQpOiBWYWx1ZVdyYXBwZXI8VD4ge1xuICByZXR1cm4gKGdldE9ic2lkaWFuRGV2VXRpbHNCYWcoKVtrZXldID8/PSBWYWx1ZVdyYXBwZXIub2YoZGVmYXVsdFZhbHVlKSkgYXMgVmFsdWVXcmFwcGVyPFQ+O1xufVxuXG4vKipcbiAqIENsZWFycyB0aGUgc2hhcmVkLXN0YXRlIGJhZyBvbiBgZ2xvYmFsVGhpcy5fX29ic2lkaWFuRGV2VXRpbHNgLlxuICpcbiAqIEludGVuZGVkIGZvciB0ZXN0IGlzb2xhdGlvbjogY2FsbCBpdCBiZWZvcmUgZWFjaCB0ZXN0IHNvIGFjY3VtdWxhdGVkIHN0YXRlIChkZWJ1Z2dlcnMsIHF1ZXVlcyxcbiAqIHJlZ2lzdGVyZWQgaGFuZGxlcnMsIGV0Yy4pIGRvZXMgbm90IGxlYWsgYmV0d2VlbiB0ZXN0cy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlKCk6IHZvaWQge1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW5tZC9uby1nbG9iYWwtdGhpcyAtLSBUaGUgc2hhcmVkIHN0YXRlIGludGVudGlvbmFsbHkgbGl2ZXMgb24gdGhlIHJlYWxtIGdsb2JhbC5cbiAgKGdsb2JhbFRoaXMgYXMgUGFydGlhbDxPYnNpZGlhbkRldlV0aWxzV3JhcHBlcj4pLl9fb2JzaWRpYW5EZXZVdGlscyA9IHt9O1xufVxuXG4vKipcbiAqIE1ha2VzIHRoZSBnZW5lcmljIHNoYXJlZCBzdGF0ZSBhbmQgYF9fb2JzaWRpYW5EZXZVdGlsc2AgaG9sZCB0aGUgc2FtZSB7QGxpbmsgVmFsdWVXcmFwcGVyfSBmb3IgZWFjaCBrZXkgdGhhdFxuICogbW92ZWQgYmV0d2VlbiB0aGVtLlxuICpcbiAqIEEgd3JhcHBlciBhbHJlYWR5IHVuZGVyIGBfX29ic2lkaWFuRGV2VXRpbHNgIHdpbnMsIGJlY2F1c2UgYW4gb2xkZXIgY29weSBvZiB0aGlzIGxpYnJhcnkgbG9hZGVkIGZpcnN0IGFuZCBpdHNcbiAqIGNhbGxlcnMgYWxyZWFkeSBob2xkIHRoYXQgaW5zdGFuY2UuIE90aGVyd2lzZSB0aGUgZ2VuZXJpYyB3cmFwcGVyIGlzIHB1Ymxpc2hlZCB1bmRlciBgX19vYnNpZGlhbkRldlV0aWxzYCwgZm9yXG4gKiBvbGRlciBjb3BpZXMgbG9hZGVkIGxhdGVyIGFuZCBmb3IgdGhlIGRldnRvb2xzIGNvbnNvbGUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzaGFyZVR5cGVzY3JpcHRMaWJTdGF0ZVdpdGhPYnNpZGlhbkRldlV0aWxzU3RhdGUoKTogdm9pZCB7XG4gIGNvbnN0IGJhZyA9IGdldE9ic2lkaWFuRGV2VXRpbHNCYWcoKTtcbiAgY29uc3QgdmFsdWVzID0gZ2V0VHlwZXNjcmlwdExpYlN0YXRlU2xvdCgpLnZhbHVlcztcbiAgZm9yIChjb25zdCBrZXkgb2YgU0hBUkVEX1dJVEhfVFlQRVNDUklQVF9MSUJfU1RBVEVfS0VZUykge1xuICAgIGNvbnN0IGxlZ2FjeVdyYXBwZXIgPSBiYWdba2V5XSBhcyB1bmRlZmluZWQgfCBWYWx1ZVdyYXBwZXI7XG4gICAgaWYgKGxlZ2FjeVdyYXBwZXIpIHtcbiAgICAgIHZhbHVlc1trZXldID0gbGVnYWN5V3JhcHBlcjtcbiAgICAgIGNvbnRpbnVlO1xuICAgIH1cblxuICAgIGNvbnN0IHdyYXBwZXIgPSB2YWx1ZXNba2V5XTtcbiAgICBpZiAod3JhcHBlcikge1xuICAgICAgYmFnW2tleV0gPSB3cmFwcGVyO1xuICAgIH1cbiAgfVxufVxuXG5mdW5jdGlvbiBnZXRPYnNpZGlhbkRldlV0aWxzQmFnKCk6IEdlbmVyaWNPYmplY3Qge1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW5tZC9uby1nbG9iYWwtdGhpcyAtLSBUaGUgc2hhcmVkIHN0YXRlIGludGVudGlvbmFsbHkgbGl2ZXMgb24gdGhlIHJlYWxtIGdsb2JhbC5cbiAgY29uc3Qgd3JhcHBlciA9IGdsb2JhbFRoaXMgYXMgUGFydGlhbDxPYnNpZGlhbkRldlV0aWxzV3JhcHBlcj47XG4gIHdyYXBwZXIuX19vYnNpZGlhbkRldlV0aWxzID8/PSB7fTtcbiAgcmV0dXJuIHdyYXBwZXIuX19vYnNpZGlhbkRldlV0aWxzO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFrQkEsa0NBQTBDO0FBQzFDLDJCQUE2QjtBQVU3QixNQUFNLHdDQUF3QyxDQUFDLFNBQVMsYUFBYSx1QkFBdUI7QUFVckYsU0FBUyx5QkFBNEIsS0FBYSxjQUFrQztBQUN6RixTQUFRLHVCQUF1QixFQUFFLEdBQUcsTUFBTSxrQ0FBYSxHQUFHLFlBQVk7QUFDeEU7QUFRTyxTQUFTLDZCQUFtQztBQUVqRCxFQUFDLFdBQWdELHFCQUFxQixDQUFDO0FBQ3pFO0FBVU8sU0FBUyxtREFBeUQ7QUFDdkUsUUFBTSxNQUFNLHVCQUF1QjtBQUNuQyxRQUFNLGFBQVMsdURBQTBCLEVBQUU7QUFDM0MsYUFBVyxPQUFPLHVDQUF1QztBQUN2RCxVQUFNLGdCQUFnQixJQUFJLEdBQUc7QUFDN0IsUUFBSSxlQUFlO0FBQ2pCLGFBQU8sR0FBRyxJQUFJO0FBQ2Q7QUFBQSxJQUNGO0FBRUEsVUFBTSxVQUFVLE9BQU8sR0FBRztBQUMxQixRQUFJLFNBQVM7QUFDWCxVQUFJLEdBQUcsSUFBSTtBQUFBLElBQ2I7QUFBQSxFQUNGO0FBQ0Y7QUFFQSxTQUFTLHlCQUF3QztBQUUvQyxRQUFNLFVBQVU7QUFDaEIsVUFBUSx1QkFBdUIsQ0FBQztBQUNoQyxTQUFPLFFBQVE7QUFDakI7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/obsidian-dev-utils-state.d.cts

@@ -0,0 +1,42 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Provides access to a process-wide shared-state bag used internally by `obsidian-dev-utils`.
+ *
+ * The bag is stored on `globalThis.__obsidianDevUtils`, i.e. on the global object of the realm in
+ * which `obsidian-dev-utils` is loaded. Because a function's `globalThis` resolves to its defining
+ * realm (not the caller's), every consumer that bundles the library in the main Obsidian renderer
+ * shares the same bag, regardless of which window is currently active. This intentionally replaces
+ * the previous `App`-scoped storage, so callers no longer need to pass an `App` instance.
+ *
+ * The generic, non-Obsidian state (the debuggers, the `debug` instance and the shared abort controller) lives in
+ * `typescript-lib-state.ts` instead. {@link shareTypescriptLibStateWithObsidianDevUtilsState} links the two, so
+ * plugins bundling an older copy of this library, which still keep that state here, share it with newer ones.
+ */
+import { ValueWrapper } from '@mnaoumov/typescript-lib/value-wrapper';
+/**
+ * Retrieves or creates a shared-state {@link ValueWrapper} for a given key on `globalThis.__obsidianDevUtils`.
+ *
+ * @typeParam T - The type of the shared state value.
+ * @param key - The key to store or retrieve the shared state under.
+ * @param defaultValue - The default value to use if the shared state does not exist yet.
+ * @returns The {@link ValueWrapper} that stores the shared state.
+ */
+export declare function getObsidianDevUtilsState<T>(key: string, defaultValue: T): ValueWrapper<T>;
+/**
+ * Clears the shared-state bag on `globalThis.__obsidianDevUtils`.
+ *
+ * Intended for test isolation: call it before each test so accumulated state (debuggers, queues,
+ * registered handlers, etc.) does not leak between tests.
+ */
+export declare function resetObsidianDevUtilsState(): void;
+/**
+ * Makes the generic shared state and `__obsidianDevUtils` hold the same {@link ValueWrapper} for each key that
+ * moved between them.
+ *
+ * A wrapper already under `__obsidianDevUtils` wins, because an older copy of this library loaded first and its
+ * callers already hold that instance. Otherwise the generic wrapper is published under `__obsidianDevUtils`, for
+ * older copies loaded later and for the devtools console.
+ */
+export declare function shareTypescriptLibStateWithObsidianDevUtilsState(): void;

package/dist/lib/cjs/obsidian-protocol-handler-registrar.cjs

@@ -0,0 +1,189 @@
+/*
+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 obsidian_protocol_handler_registrar_exports = {};
+__export(obsidian_protocol_handler_registrar_exports, {
+  PluginObsidianProtocolHandlerRegistrar: () => PluginObsidianProtocolHandlerRegistrar
+});
+module.exports = __toCommonJS(obsidian_protocol_handler_registrar_exports);
+var import_async = require('@mnaoumov/typescript-lib/async');
+class PluginObsidianProtocolHandlerRegistrar {
+  /**
+   * The Obsidian plugin instance the protocol handlers are registered with.
+   */
+  plugin;
+  /**
+   * Creates a new instance of the {@link PluginObsidianProtocolHandlerRegistrar} class.
+   *
+   * @param plugin - The plugin to register the protocol handler with.
+   */
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  /**
+   * Registers an Obsidian protocol handler.
+   *
+   * @param params - The parameters for the Obsidian protocol handler registration.
+   */
+  registerObsidianProtocolHandler(params) {
+    this.plugin.registerObsidianProtocolHandler(params.action, (obsidianProtocolData) => (0, import_async.normalizePromisable)(params.handler(obsidianProtocolData)));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PluginObsidianProtocolHandlerRegistrar
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL29ic2lkaWFuLXByb3RvY29sLWhhbmRsZXItcmVnaXN0cmFyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogT2JzaWRpYW4gcHJvdG9jb2wgaGFuZGxlciByZWdpc3RyYXJzLlxuICovXG5cbmltcG9ydCB0eXBlIHtcbiAgT2JzaWRpYW5Qcm90b2NvbERhdGEsXG4gIFBsdWdpblxufSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBub3JtYWxpemVQcm9taXNhYmxlIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2FzeW5jJztcblxuLyoqXG4gKiBBIHJlZ2lzdHJhciBmb3IgT2JzaWRpYW4gcHJvdG9jb2wgaGFuZGxlcnMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgT2JzaWRpYW5Qcm90b2NvbEhhbmRsZXJSZWdpc3RyYXIge1xuICAvKipcbiAgICogUmVnaXN0ZXJzIGFuIE9ic2lkaWFuIHByb3RvY29sIGhhbmRsZXIuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIE9ic2lkaWFuIHByb3RvY29sIGhhbmRsZXIgcmVnaXN0cmF0aW9uLlxuICAgKi9cbiAgcmVnaXN0ZXJPYnNpZGlhblByb3RvY29sSGFuZGxlcjogKHBhcmFtczogT2JzaWRpYW5Qcm90b2NvbEhhbmRsZXJSZWdpc3RyYXJSZWdpc3Rlck9ic2lkaWFuUHJvdG9jb2xIYW5kbGVyUGFyYW1zKSA9PiB2b2lkO1xufVxuXG5pbnRlcmZhY2UgT2JzaWRpYW5Qcm90b2NvbEhhbmRsZXJSZWdpc3RyYXJSZWdpc3Rlck9ic2lkaWFuUHJvdG9jb2xIYW5kbGVyUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBhY3Rpb24gdG8gcmVnaXN0ZXIgdGhlIGhhbmRsZXIgZm9yLlxuICAgKi9cbiAgcmVhZG9ubHkgYWN0aW9uOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBoYW5kbGVyIHRvIHJlZ2lzdGVyLlxuICAgKlxuICAgKiBAcGFyYW0gb2JzaWRpYW5Qcm90b2NvbERhdGEgLSBUaGUgZGF0YSBwYXNzZWQgdG8gdGhlIGhhbmRsZXIuXG4gICAqIEByZXR1cm5zIFRoZSByZXN1bHQgb2YgdGhlIGhhbmRsZXIuXG4gICAqL1xuICByZWFkb25seSBoYW5kbGVyOiAob2JzaWRpYW5Qcm90b2NvbERhdGE6IE9ic2lkaWFuUHJvdG9jb2xEYXRhKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xufVxuXG50eXBlIFBsdWdpbk9ic2lkaWFuUHJvdG9jb2xIYW5kbGVyUmVnaXN0cmFyUmVnaXN0ZXJPYnNpZGlhblByb3RvY29sSGFuZGxlclBhcmFtcyA9IE9ic2lkaWFuUHJvdG9jb2xIYW5kbGVyUmVnaXN0cmFyUmVnaXN0ZXJPYnNpZGlhblByb3RvY29sSGFuZGxlclBhcmFtcztcblxuLyoqXG4gKiBPYnNpZGlhbiBwcm90b2NvbCBoYW5kbGVyIHJlZ2lzdHJhciBpbiBhbiBPYnNpZGlhbiBwbHVnaW4uXG4gKi9cbmV4cG9ydCBjbGFzcyBQbHVnaW5PYnNpZGlhblByb3RvY29sSGFuZGxlclJlZ2lzdHJhciBpbXBsZW1lbnRzIE9ic2lkaWFuUHJvdG9jb2xIYW5kbGVyUmVnaXN0cmFyIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBwbHVnaW4gaW5zdGFuY2UgdGhlIHByb3RvY29sIGhhbmRsZXJzIGFyZSByZWdpc3RlcmVkIHdpdGguXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgcGx1Z2luOiBQbHVnaW47XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgaW5zdGFuY2Ugb2YgdGhlIHtAbGluayBQbHVnaW5PYnNpZGlhblByb3RvY29sSGFuZGxlclJlZ2lzdHJhcn0gY2xhc3MuXG4gICAqXG4gICAqIEBwYXJhbSBwbHVnaW4gLSBUaGUgcGx1Z2luIHRvIHJlZ2lzdGVyIHRoZSBwcm90b2NvbCBoYW5kbGVyIHdpdGguXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGx1Z2luOiBQbHVnaW4pIHtcbiAgICB0aGlzLnBsdWdpbiA9IHBsdWdpbjtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYW4gT2JzaWRpYW4gcHJvdG9jb2wgaGFuZGxlci5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgT2JzaWRpYW4gcHJvdG9jb2wgaGFuZGxlciByZWdpc3RyYXRpb24uXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJPYnNpZGlhblByb3RvY29sSGFuZGxlcihwYXJhbXM6IFBsdWdpbk9ic2lkaWFuUHJvdG9jb2xIYW5kbGVyUmVnaXN0cmFyUmVnaXN0ZXJPYnNpZGlhblByb3RvY29sSGFuZGxlclBhcmFtcyk6IHZvaWQge1xuICAgIHRoaXMucGx1Z2luLnJlZ2lzdGVyT2JzaWRpYW5Qcm90b2NvbEhhbmRsZXIocGFyYW1zLmFjdGlvbiwgKG9ic2lkaWFuUHJvdG9jb2xEYXRhKSA9PiBub3JtYWxpemVQcm9taXNhYmxlKHBhcmFtcy5oYW5kbGVyKG9ic2lkaWFuUHJvdG9jb2xEYXRhKSkpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBWUEsbUJBQW9DO0FBa0M3QixNQUFNLHVDQUFtRjtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSTNFO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1osWUFBWSxRQUFnQjtBQUNqQyxTQUFLLFNBQVM7QUFBQSxFQUNoQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9PLGdDQUFnQyxRQUEyRjtBQUNoSSxTQUFLLE9BQU8sZ0NBQWdDLE9BQU8sUUFBUSxDQUFDLDZCQUF5QixrQ0FBb0IsT0FBTyxRQUFRLG9CQUFvQixDQUFDLENBQUM7QUFBQSxFQUNoSjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/obsidian-protocol-handler-registrar.d.cts

@@ -0,0 +1,55 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Obsidian protocol handler registrars.
+ */
+import type { ObsidianProtocolData, Plugin } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { Promisable } from 'type-fest' with { 'resolution-mode': 'import' };
+/**
+ * A registrar for Obsidian protocol handlers.
+ */
+export interface ObsidianProtocolHandlerRegistrar {
+    /**
+     * Registers an Obsidian protocol handler.
+     *
+     * @param params - The parameters for the Obsidian protocol handler registration.
+     */
+    registerObsidianProtocolHandler: (params: ObsidianProtocolHandlerRegistrarRegisterObsidianProtocolHandlerParams) => void;
+}
+interface ObsidianProtocolHandlerRegistrarRegisterObsidianProtocolHandlerParams {
+    /**
+     * The action to register the handler for.
+     */
+    readonly action: string;
+    /**
+     * The handler to register.
+     *
+     * @param obsidianProtocolData - The data passed to the handler.
+     * @returns The result of the handler.
+     */
+    readonly handler: (obsidianProtocolData: ObsidianProtocolData) => Promisable<void>;
+}
+type PluginObsidianProtocolHandlerRegistrarRegisterObsidianProtocolHandlerParams = ObsidianProtocolHandlerRegistrarRegisterObsidianProtocolHandlerParams;
+/**
+ * Obsidian protocol handler registrar in an Obsidian plugin.
+ */
+export declare class PluginObsidianProtocolHandlerRegistrar implements ObsidianProtocolHandlerRegistrar {
+    /**
+     * The Obsidian plugin instance the protocol handlers are registered with.
+     */
+    protected readonly plugin: Plugin;
+    /**
+     * Creates a new instance of the {@link PluginObsidianProtocolHandlerRegistrar} class.
+     *
+     * @param plugin - The plugin to register the protocol handler with.
+     */
+    constructor(plugin: Plugin);
+    /**
+     * Registers an Obsidian protocol handler.
+     *
+     * @param params - The parameters for the Obsidian protocol handler registration.
+     */
+    registerObsidianProtocolHandler(params: PluginObsidianProtocolHandlerRegistrarRegisterObsidianProtocolHandlerParams): void;
+}
+export {};