@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/cjs/components/rename-delete-handler-component.d.cts

@@ -0,0 +1,165 @@
+/// <reference path="../library.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for handling rename and delete events in Obsidian.
+ */
+import type { App } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { LinkUpdateProgressReporter } from '../link-update-progress.cjs';
+import type { ResourceLockComponent } from '../resource-lock.cjs';
+import type { AbortSignalComponent } from './abort-signal-component.cjs';
+import type { PluginNoticeComponent } from './plugin-notice-component.cjs';
+import { EmptyFolderBehavior } from '../vault.cjs';
+import { ComponentEx } from './component-ex.cjs';
+/**
+ * Parameters for {@link RenameDeleteHandlerSettings.getRescuePath}.
+ */
+export interface GetRescuePathParams {
+    /**
+     * The path of the attachment that is about to be stranded.
+     */
+    readonly attachmentPath: string;
+    /**
+     * The paths of the notes that still reference the attachment once the deletion is done. Never empty.
+     */
+    readonly survivingNotePaths: readonly string[];
+}
+/**
+ * Settings for the rename/delete handler.
+ */
+export interface RenameDeleteHandlerSettings {
+    /**
+     * A behavior of the rename/delete handler when deleting empty folders.
+     */
+    emptyFolderBehavior: EmptyFolderBehavior;
+    /**
+     * Where to move an attachment that a deletion would otherwise strand — one that survives because another
+     * note still references it, but is left sitting in a folder whose owning note is gone.
+     *
+     * Deciding the destination is the plugin's attachment-path policy, which is why the handler asks rather
+     * than guesses. Returning `null` — or not implementing this at all — keeps the attachment where it is,
+     * which is the behavior every consumer had before this member existed.
+     */
+    getRescuePath?: (params: GetRescuePathParams) => Promise<null | string>;
+    /**
+     * Whether the path is a note.
+     */
+    isNote: (path: string) => boolean;
+    /**
+     * Whether to ignore the path.
+     */
+    isPathIgnored: (path: string) => boolean;
+    /**
+     * Whether to delete conflicting attachments.
+     */
+    shouldDeleteConflictingAttachments: boolean;
+    /**
+     * Whether to handle deletions.
+     */
+    shouldHandleDeletions: boolean;
+    /**
+     * Whether to handle renames.
+     */
+    shouldHandleRenames: boolean;
+    /**
+     * Whether to rename attachment files when a note is renamed.
+     */
+    shouldRenameAttachmentFiles: boolean;
+    /**
+     * Whether to rename attachment folder when a note is renamed.
+     */
+    shouldRenameAttachmentFolder: boolean;
+    /**
+     * Whether to update file name aliases when a note is renamed.
+     */
+    shouldUpdateFileNameAliases: boolean;
+}
+interface RenameDeleteHandlerComponentConstructorParams {
+    readonly abortSignalComponent: AbortSignalComponent;
+    readonly app: App;
+    readonly linkUpdateProgressReporter?: LinkUpdateProgressReporter;
+    readonly pluginNoticeComponent: PluginNoticeComponent;
+    readonly resourceLockComponent: null | ResourceLockComponent;
+    readonly settingsBuilder: () => Partial<RenameDeleteHandlerSettings>;
+}
+/**
+ * Resolves the settings the handler runs with.
+ *
+ * There is exactly one contributor: the component's own `settingsBuilder`. Earlier versions aggregated a
+ * registry of contributors and OR-merged their answers, because several plugins could each register a
+ * handler against the one shared vault. They no longer do, so there is no longer any question of whose
+ * setting wins.
+ *
+ * What remains is defaulting: the builder returns a `Partial`, so the two predicates and the empty-folder
+ * behavior need a value when it does not supply one.
+ */
+declare class SettingsManager {
+    private readonly settingsBuilder;
+    constructor(settingsBuilder: () => Partial<RenameDeleteHandlerSettings>);
+    getSettings(): Partial<RenameDeleteHandlerSettings>;
+    isNoteEx(path: string): boolean;
+}
+/**
+ * Component that handles rename and delete events in Obsidian.
+ * It listens to rename and delete events and updates links accordingly.
+ * It also handles edge cases such as case-only renames and collisions with existing files.
+ */
+export declare class RenameDeleteHandlerComponent extends ComponentEx {
+    /**
+     * The abort signal component whose signal cancels in-flight rename operations.
+     */
+    protected readonly abortSignalComponent: AbortSignalComponent;
+    /**
+     * The Obsidian app instance.
+     */
+    protected readonly app: App;
+    /**
+     * An optional reporter invoked once per backlink file whose links are updated during a rename/move,
+     * with the running count of processed files and the total. When `null`, no progress is reported.
+     */
+    protected readonly linkUpdateProgressReporter: LinkUpdateProgressReporter | null;
+    /**
+     * The notice component used to report updated links to the user.
+     */
+    protected readonly pluginNoticeComponent: PluginNoticeComponent;
+    /**
+     * The resource lock component used to guard link updates, or `null` if none is used.
+     */
+    protected readonly resourceLockComponent: null | ResourceLockComponent;
+    /**
+     * Builds this plugin's rename/delete handler settings.
+     */
+    protected readonly settingsBuilder: () => Partial<RenameDeleteHandlerSettings>;
+    /**
+     * The manager that aggregates rename/delete handler settings across registered plugins.
+     */
+    protected readonly settingsManager: SettingsManager;
+    private readonly deletedMetadataCacheMap;
+    private readonly handledRenames;
+    private readonly interruptedRenamesMap;
+    /**
+     * Creates an instance of RenameDeleteHandlerComponent.
+     *
+     * @param params - The parameters for the RenameDeleteHandlerComponent.
+     */
+    constructor(params: RenameDeleteHandlerComponentConstructorParams);
+    /**
+     * Loads the component
+     */
+    onload(): void;
+    private handleDelete;
+    private handleMetadataDeleted;
+    private handleRename;
+    /**
+     * With link rewriting off, the handler's only remaining jobs are moving a NOTE's attachments and pruning
+     * the folder a moved file vacated. A non-note rename needs neither when empty folders are kept, so there
+     * is nothing to queue.
+     *
+     * @param settings - The aggregated rename/delete handler settings.
+     * @param oldPath - The path the file was renamed from.
+     * @param newPath - The path the file was renamed to.
+     * @returns `true` when the handler would do no work for this rename.
+     */
+    private isNoOpRename;
+}
+export { EmptyFolderBehavior } from '../vault.cjs';

package/dist/lib/cjs/components/rmdir-guard-component.cjs

@@ -0,0 +1,190 @@
+/*
+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"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord["__name"] ??= keepName;
+  globalThisRecord["__extractDefault"] ??= extractDefault;
+  ensureBrowserProcess();
+  function extractDefault(module) {
+    return module && module.__esModule && "default" in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  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 = /* @__PURE__ */ 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 = /* @__PURE__ */ 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);
+    }
+    if (globalThis.app.isMobile) {
+      if (id === "process" || id === "node:process") {
+        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);
+      }
+    }
+    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 rmdir_guard_component_exports = {};
+__export(rmdir_guard_component_exports, {
+  NOT_EMPTY_DIRECTORY_ERROR_CODE: () => NOT_EMPTY_DIRECTORY_ERROR_CODE,
+  RmdirGuardComponent: () => RmdirGuardComponent
+});
+module.exports = __toCommonJS(rmdir_guard_component_exports);
+var import_vault = require('../vault.cjs');
+var import_monkey_around_component = require('./monkey-around-component.cjs');
+const NOT_EMPTY_DIRECTORY_ERROR_CODE = "ENOTEMPTY";
+class RmdirGuardComponent extends import_monkey_around_component.MonkeyAroundComponent {
+  /**
+   * Creates a new instance of the {@link RmdirGuardComponent} class.
+   *
+   * @param app - The Obsidian app instance whose vault adapter to guard.
+   */
+  constructor(app) {
+    super();
+    this.app = app;
+  }
+  app;
+  /**
+   * Installs the `rmdir` guard. The patch is uninstalled when this component unloads.
+   */
+  onload() {
+    this.registerMethodPatch({
+      $object: this.app.vault.adapter,
+      methodName: "rmdir",
+      patchHandler: async ({
+        fallback,
+        originalArguments: [normalizedPath, recursive],
+        originalMethodBound
+      }) => {
+        if (recursive) {
+          await fallback();
+          return;
+        }
+        const stats = await this.app.vault.adapter.stat(normalizedPath);
+        if (stats?.type !== "folder") {
+          await fallback();
+          return;
+        }
+        if (!await (0, import_vault.isEmptyFolder)(this.app, normalizedPath)) {
+          throw Object.assign(new Error(`Directory ${normalizedPath} is not empty`), {
+            code: NOT_EMPTY_DIRECTORY_ERROR_CODE,
+            path: normalizedPath
+          });
+        }
+        await originalMethodBound(normalizedPath, true);
+      }
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NOT_EMPTY_DIRECTORY_ERROR_CODE,
+  RmdirGuardComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvcm1kaXItZ3VhcmQtY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgY2xhc3Mge0BsaW5rIFJtZGlyR3VhcmRDb21wb25lbnR9IHRoYXQgbWFrZXMgdGhlIGByZWN1cnNpdmVgIGZsYWcgb2ZcbiAqIHtAbGluayBodHRwczovL2RvY3Mub2JzaWRpYW4ubWQvUmVmZXJlbmNlL1R5cGVTY3JpcHQrQVBJL0RhdGFBZGFwdGVyL3JtZGlyIHwgRGF0YUFkYXB0ZXIucm1kaXJ9IG1lYW4gd2hhdCBpdCBzYXlzLlxuICovXG5cbmltcG9ydCB0eXBlIHsgQXBwIH0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgeyBpc0VtcHR5Rm9sZGVyIH0gZnJvbSAnLi4vdmF1bHQudHMnO1xuaW1wb3J0IHsgTW9ua2V5QXJvdW5kQ29tcG9uZW50IH0gZnJvbSAnLi9tb25rZXktYXJvdW5kLWNvbXBvbmVudC50cyc7XG5cbi8qKlxuICogVGhlIGBjb2RlYCBjYXJyaWVkIGJ5IHRoZSBlcnJvciB0aHJvd24gd2hlbiBhIG5vbi1yZWN1cnNpdmUgYHJtZGlyYCBpcyByZWZ1c2VkIGJlY2F1c2UgdGhlIGZvbGRlciBoYXMgY2hpbGRyZW4uXG4gKlxuICogTWF0Y2hlcyB0aGUgUE9TSVgvTm9kZSBlcnJvciBjb2RlIGEgY29ycmVjdCBub24tcmVjdXJzaXZlIGRpcmVjdG9yeSByZW1vdmFsIHByb2R1Y2VzLCBzbyBhIGNhbGxlciBhbHJlYWR5XG4gKiBicmFuY2hpbmcgb24gYGVycm9yLmNvZGVgIGtlZXBzIHdvcmtpbmcuIENoZWNrIHRoZSBgY29kZWAsIG5ldmVyIGBpbnN0YW5jZW9mYCBcdTIwMTQgZXZlcnkgcGx1Z2luIGJ1bmRsZXMgaXRzIG93blxuICogY29weSBvZiB0aGlzIGxpYnJhcnksIHNvIHRoZSBlcnJvciBtYXkgY3Jvc3MgYSBjb3B5IGJvdW5kYXJ5LlxuICovXG5leHBvcnQgY29uc3QgTk9UX0VNUFRZX0RJUkVDVE9SWV9FUlJPUl9DT0RFID0gJ0VOT1RFTVBUWSc7XG5cbi8qKlxuICogTWFrZXMgYGFwcC52YXVsdC5hZGFwdGVyLnJtZGlyKHBhdGgsIGZhbHNlKWAgYmVoYXZlIGFzIGl0cyBuYW1lIHByb21pc2VzOiBhIG5vbi1yZWN1cnNpdmUgY2FsbCBvbiBhIGZvbGRlclxuICogdGhhdCBzdGlsbCBoYXMgY2hpbGRyZW4gdGhyb3dzIGluc3RlYWQgb2YgZGVsZXRpbmcgdGhlbS5cbiAqXG4gKiBAcmVtYXJrc1xuICogT2JzaWRpYW4ncyBhZGFwdGVycyBkbyBub3QgaG9ub3IgYHJlY3Vyc2l2ZTogZmFsc2VgLCBhbmQgdGhleSBnZXQgaXQgd3JvbmcgaW4gb3Bwb3NpdGUgZGlyZWN0aW9uczpcbiAqXG4gKiAtIGBDYXBhY2l0b3JBZGFwdGVyYCAobW9iaWxlKSBkb2VzIG5vdCBhY2NlcHQgdGhlIGFyZ3VtZW50IGF0IGFsbCBcdTIwMTQgaXQgYWx3YXlzIHJlbW92ZXMgcmVjdXJzaXZlbHksIHNvIGFcbiAqICAgbm9uLXJlY3Vyc2l2ZSBjYWxsIHNpbGVudGx5IGRlbGV0ZXMgdGhlIGZvbGRlciBhbmQgZXZlcnl0aGluZyB1bmRlciBpdC4gVGhpcyBpcyB0aGUgZGF0YS1sb3NzIGZvb3RndW4uXG4gKiAtIGBGaWxlU3lzdGVtQWRhcHRlcmAgKGRlc2t0b3ApIGZvcndhcmRzIGl0IHRvIGBmcy5wcm9taXNlcy5ybShwYXRoLCB7IHJlY3Vyc2l2ZSB9KWAsIHdoaWNoIHRocm93c1xuICogICBgRVJSX0ZTX0VJU0RJUmAgZm9yICphbnkqIGRpcmVjdG9yeSB3aGVuIGByZWN1cnNpdmVgIGlzIGBmYWxzZWAgXHUyMDE0IHNvIHRoZSBub24tcmVjdXJzaXZlIGNhbGwgbmV2ZXJcbiAqICAgc3VjY2VlZHMsIG5vdCBldmVuIG9uIGFuIGVtcHR5IGZvbGRlci5cbiAqXG4gKiBXaGlsZSBsb2FkZWQsIHRoaXMgY29tcG9uZW50IGdpdmVzIGJvdGggcGxhdGZvcm1zIHRoZSBzYW1lLCBjb3JyZWN0IGJlaGF2aW9yOiBhIG5vbi1lbXB0eSBmb2xkZXIgaXNcbiAqIHJlZnVzZWQgd2l0aCBhbiB7QGxpbmsgTk9UX0VNUFRZX0RJUkVDVE9SWV9FUlJPUl9DT0RFfSBlcnJvciBhbmQgbm90aGluZyBpcyBkZWxldGVkOyBhbiBlbXB0eSBmb2xkZXIgaXNcbiAqIHJlbW92ZWQuIEVtcHRpbmVzcyBpcyBkZWNpZGVkIGZyb20gdGhlIGFkYXB0ZXIgKHZpYSB7QGxpbmsgaXNFbXB0eUZvbGRlcn0pLCBub3QgZnJvbSB0aGUgdmF1bHQgaW5kZXggXHUyMDE0IHRoZVxuICogaW5kZXggb21pdHMgZG90LXByZWZpeGVkIGFuZCBvdGhlcndpc2UgaGlkZGVuIGVudHJpZXMsIHNvIGEgZm9sZGVyIGhvbGRpbmcgb25seSBoaWRkZW4gZmlsZXMgcmVhZHMgYXMgZW1wdHlcbiAqIHRoZXJlIGFuZCB0aGUgZ3VhcmQgd291bGQgd2F2ZSB0aHJvdWdoIGV4YWN0bHkgdGhlIGRlbGV0aW9uIGl0IGV4aXN0cyB0byBwcmV2ZW50LlxuICpcbiAqIEEgZm9sZGVyIHByb3ZlbiBlbXB0eSBpcyByZW1vdmVkIGJ5IGZvcndhcmRpbmcgdG8gdGhlIG9yaWdpbmFsIG1ldGhvZCB3aXRoIGByZWN1cnNpdmU6IHRydWVgLiBUaGF0IGlzIG5vdFxuICogbWVyZWx5IGRlZmVuc2l2ZTogaXQgaXMgd2hhdCBtYWtlcyB0aGUgZW1wdHktZm9sZGVyIGNhc2Ugc3VjY2VlZCBvbiBkZXNrdG9wLCB3aGVyZSB0aGUgbm9uLXJlY3Vyc2l2ZSBjYWxsXG4gKiB3b3VsZCBvdGhlcndpc2UgdGhyb3cuXG4gKlxuICogQ2FsbHMgdGhhdCBhbHJlYWR5IHBhc3MgYHJlY3Vyc2l2ZTogdHJ1ZWAsIGFuZCBjYWxscyB3aG9zZSB0YXJnZXQgaXMgbm90IGEgZm9sZGVyIChhIGZpbGUsIGEgbWlzc2luZyBwYXRoKSxcbiAqIGFyZSBwYXNzZWQgdGhyb3VnaCB1bnRvdWNoZWQgYW5kIGtlZXAgdGhlaXIgbmF0aXZlIGJlaGF2aW9yLlxuICpcbiAqIExvYWRpbmcgdGhlIGd1YXJkIG1vcmUgdGhhbiBvbmNlIGlzIHNhZmUsIGFuZCBpdCBkZWxpYmVyYXRlbHkgY2FycmllcyAqKm5vIHBhdGNoIHRva2VuKiouIEV2ZXJ5IHBsdWdpblxuICogYnVuZGxlcyBpdHMgb3duIGNvcHkgb2YgdGhpcyBsaWJyYXJ5IGFuZCB0aGV5IGFsbCBwYXRjaCB0aGUgb25lIHNoYXJlZCBhZGFwdGVyLCBzbyBzZXZlcmFsIGd1YXJkcyBkbyBzdGFja1xuICogXHUyMDE0IGJ1dCB0aGUgb3BlcmF0aW9uIGlzIGlkZW1wb3RlbnQgKHByb3ZlIGVtcHR5LCB0aGVuIGRlbGV0ZSksIHNvIHN0YWNraW5nIGNoYW5nZXMgbm90aGluZzogdGhlIG91dGVybW9zdFxuICogZ3VhcmQgZWl0aGVyIHRocm93cyBvciBmb3J3YXJkcyB3aXRoIGByZWN1cnNpdmU6IHRydWVgLCB3aGljaCBldmVyeSBndWFyZCBiZW5lYXRoIHBhc3NlcyBzdHJhaWdodCB0aHJvdWdoLlxuICogVGhleSBjYW4gYWxzbyBiZSB1bmxvYWRlZCBpbiBhbnkgb3JkZXIgYW5kIHRoZSBtZXRob2Qgc3RheXMgZ3VhcmRlZCB1bnRpbCB0aGUgbGFzdCBvbmUgZ29lcywgYmVjYXVzZVxuICogYG1vbmtleS1hcm91bmRgIG5ldXRyYWxpemVzIGFuIHVubG9hZGVkIHdyYXBwZXIgaW4gcGxhY2UgcmF0aGVyIHRoYW4gc3BsaWNpbmcgaXQgb3V0LiBBIHRva2VuIHdvdWxkIG9ubHlcbiAqIG1vdmUgdGhlIGRlY2lzaW9uIHRvIHRoZSBpbm5lcm1vc3QgZ3VhcmQgXHUyMDE0IGFuIGVxdWFsbHkgYXJiaXRyYXJ5IGNob2ljZSBcdTIwMTQgd2hpbGUgYWRkaW5nIGEgcGF0aCBvbiB3aGljaCBhXG4gKiBndWFyZCBkZWNsaW5lcyB0byBndWFyZC4gRm9yIGEgZGF0YS1sb3NzIGd1YXJkIHRoYXQgdHJhZGUgaXMgbm90IHdvcnRoIG1ha2luZy4gQ29udHJhc3RcbiAqIGBSZW5hbWVEZWxldGVIYW5kbGVyQ29tcG9uZW50YCwgd2hpY2ggZG9lcyBuZWVkIG9uZTogc3VwcHJlc3NpbmcgYHJ1bkFzeW5jTGlua1VwZGF0ZWAgaXMgbm90IGlkZW1wb3RlbnQsXG4gKiBzbyB0d28gb2YgdGhvc2Ugd291bGQgY29uZmxpY3QuXG4gKlxuICogVGhpcyBjb21wb25lbnQgaXMgZGVsaWJlcmF0ZWx5ICoqb3B0LWluKio6IGBhcHAudmF1bHQuYWRhcHRlcmAgaXMgc2hhcmVkIGJ5IHRoZSB3aG9sZSBhcHAsIHNvIGEgbGlicmFyeSB0aGF0XG4gKiBpbnN0YWxsZWQgdGhpcyBwYXRjaCBvbiBpdHMgb3duIHdvdWxkIGNoYW5nZSBgcm1kaXJgIHNlbWFudGljcyBmb3IgZXZlcnkgb3RoZXIgcGx1Z2luLCBpbmNsdWRpbmcgdGhlIG9uZXNcbiAqIHRoYXQgbmV2ZXIgYXNrZWQgZm9yIGl0LiBBIHBsdWdpbiB0aGF0IGRlbGV0ZXMgZm9sZGVycyBvcHRzIGluIGZvciBpdHNlbGY6XG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzXG4gKiB0aGlzLmFkZENoaWxkKG5ldyBSbWRpckd1YXJkQ29tcG9uZW50KHRoaXMuYXBwKSk7XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGNsYXNzIFJtZGlyR3VhcmRDb21wb25lbnQgZXh0ZW5kcyBNb25rZXlBcm91bmRDb21wb25lbnQge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBpbnN0YW5jZSBvZiB0aGUge0BsaW5rIFJtZGlyR3VhcmRDb21wb25lbnR9IGNsYXNzLlxuICAgKlxuICAgKiBAcGFyYW0gYXBwIC0gVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZSB3aG9zZSB2YXVsdCBhZGFwdGVyIHRvIGd1YXJkLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByb3RlY3RlZCByZWFkb25seSBhcHA6IEFwcCkge1xuICAgIHN1cGVyKCk7XG4gIH1cblxuICAvKipcbiAgICogSW5zdGFsbHMgdGhlIGBybWRpcmAgZ3VhcmQuIFRoZSBwYXRjaCBpcyB1bmluc3RhbGxlZCB3aGVuIHRoaXMgY29tcG9uZW50IHVubG9hZHMuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgb25sb2FkKCk6IHZvaWQge1xuICAgIHRoaXMucmVnaXN0ZXJNZXRob2RQYXRjaCh7XG4gICAgICAkb2JqZWN0OiB0aGlzLmFwcC52YXVsdC5hZGFwdGVyLFxuICAgICAgbWV0aG9kTmFtZTogJ3JtZGlyJyxcbiAgICAgIHBhdGNoSGFuZGxlcjogYXN5bmMgKHtcbiAgICAgICAgZmFsbGJhY2ssXG4gICAgICAgIG9yaWdpbmFsQXJndW1lbnRzOiBbbm9ybWFsaXplZFBhdGgsIHJlY3Vyc2l2ZV0sXG4gICAgICAgIG9yaWdpbmFsTWV0aG9kQm91bmRcbiAgICAgIH0pID0+IHtcbiAgICAgICAgaWYgKHJlY3Vyc2l2ZSkge1xuICAgICAgICAgIGF3YWl0IGZhbGxiYWNrKCk7XG4gICAgICAgICAgcmV0dXJuO1xuICAgICAgICB9XG5cbiAgICAgICAgY29uc3Qgc3RhdHMgPSBhd2FpdCB0aGlzLmFwcC52YXVsdC5hZGFwdGVyLnN0YXQobm9ybWFsaXplZFBhdGgpO1xuICAgICAgICBpZiAoc3RhdHM/LnR5cGUgIT09ICdmb2xkZXInKSB7XG4gICAgICAgICAgYXdhaXQgZmFsbGJhY2soKTtcbiAgICAgICAgICByZXR1cm47XG4gICAgICAgIH1cblxuICAgICAgICBpZiAoIWF3YWl0IGlzRW1wdHlGb2xkZXIodGhpcy5hcHAsIG5vcm1hbGl6ZWRQYXRoKSkge1xuICAgICAgICAgIHRocm93IE9iamVjdC5hc3NpZ24obmV3IEVycm9yKGBEaXJlY3RvcnkgJHtub3JtYWxpemVkUGF0aH0gaXMgbm90IGVtcHR5YCksIHtcbiAgICAgICAgICAgIGNvZGU6IE5PVF9FTVBUWV9ESVJFQ1RPUllfRVJST1JfQ09ERSxcbiAgICAgICAgICAgIHBhdGg6IG5vcm1hbGl6ZWRQYXRoXG4gICAgICAgICAgfSk7XG4gICAgICAgIH1cblxuICAgICAgICAvLyBUaGUgZm9sZGVyIGlzIHByb3ZlbiBlbXB0eSwgc28gYSByZWN1cnNpdmUgcmVtb3ZhbCBpcyBlcXVpdmFsZW50IC0tIGFuZCwgdW5saWtlIHRoZSBub24tcmVjdXJzaXZlXG4gICAgICAgIC8vIG9uZSwgaXQgYWN0dWFsbHkgd29ya3Mgb24gdGhlIGRlc2t0b3AgYWRhcHRlci5cbiAgICAgICAgYXdhaXQgb3JpZ2luYWxNZXRob2RCb3VuZChub3JtYWxpemVkUGF0aCwgdHJ1ZSk7XG4gICAgICB9XG4gICAgfSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQVNBLG1CQUE4QjtBQUM5QixxQ0FBc0M7QUFTL0IsTUFBTSxpQ0FBaUM7QUFnRHZDLE1BQU0sNEJBQTRCLHFEQUFzQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU10RCxZQUErQixLQUFVO0FBQzlDLFVBQU07QUFEOEI7QUFBQSxFQUV0QztBQUFBLEVBRnNDO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPdEIsU0FBZTtBQUM3QixTQUFLLG9CQUFvQjtBQUFBLE1BQ3ZCLFNBQVMsS0FBSyxJQUFJLE1BQU07QUFBQSxNQUN4QixZQUFZO0FBQUEsTUFDWixjQUFjLE9BQU87QUFBQSxRQUNuQjtBQUFBLFFBQ0EsbUJBQW1CLENBQUMsZ0JBQWdCLFNBQVM7QUFBQSxRQUM3QztBQUFBLE1BQ0YsTUFBTTtBQUNKLFlBQUksV0FBVztBQUNiLGdCQUFNLFNBQVM7QUFDZjtBQUFBLFFBQ0Y7QUFFQSxjQUFNLFFBQVEsTUFBTSxLQUFLLElBQUksTUFBTSxRQUFRLEtBQUssY0FBYztBQUM5RCxZQUFJLE9BQU8sU0FBUyxVQUFVO0FBQzVCLGdCQUFNLFNBQVM7QUFDZjtBQUFBLFFBQ0Y7QUFFQSxZQUFJLENBQUMsVUFBTSw0QkFBYyxLQUFLLEtBQUssY0FBYyxHQUFHO0FBQ2xELGdCQUFNLE9BQU8sT0FBTyxJQUFJLE1BQU0sYUFBYSxjQUFjLGVBQWUsR0FBRztBQUFBLFlBQ3pFLE1BQU07QUFBQSxZQUNOLE1BQU07QUFBQSxVQUNSLENBQUM7QUFBQSxRQUNIO0FBSUEsY0FBTSxvQkFBb0IsZ0JBQWdCLElBQUk7QUFBQSxNQUNoRDtBQUFBLElBQ0YsQ0FBQztBQUFBLEVBQ0g7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/cjs/components/rmdir-guard-component.d.cts

@@ -0,0 +1,76 @@
+/// <reference path="../library.d.cts" />
+/**
+ * @file
+ *
+ * Contains class {@link RmdirGuardComponent} that makes the `recursive` flag of
+ * {@link https://docs.obsidian.md/Reference/TypeScript+API/DataAdapter/rmdir | DataAdapter.rmdir} mean what it says.
+ */
+import type { App } from 'obsidian' with { 'resolution-mode': 'import' };
+import { MonkeyAroundComponent } from './monkey-around-component.cjs';
+/**
+ * The `code` carried by the error thrown when a non-recursive `rmdir` is refused because the folder has children.
+ *
+ * Matches the POSIX/Node error code a correct non-recursive directory removal produces, so a caller already
+ * branching on `error.code` keeps working. Check the `code`, never `instanceof` — every plugin bundles its own
+ * copy of this library, so the error may cross a copy boundary.
+ */
+export declare const NOT_EMPTY_DIRECTORY_ERROR_CODE = "ENOTEMPTY";
+/**
+ * Makes `app.vault.adapter.rmdir(path, false)` behave as its name promises: a non-recursive call on a folder
+ * that still has children throws instead of deleting them.
+ *
+ * @remarks
+ * Obsidian's adapters do not honor `recursive: false`, and they get it wrong in opposite directions:
+ *
+ * - `CapacitorAdapter` (mobile) does not accept the argument at all — it always removes recursively, so a
+ *   non-recursive call silently deletes the folder and everything under it. This is the data-loss footgun.
+ * - `FileSystemAdapter` (desktop) forwards it to `fs.promises.rm(path, { recursive })`, which throws
+ *   `ERR_FS_EISDIR` for *any* directory when `recursive` is `false` — so the non-recursive call never
+ *   succeeds, not even on an empty folder.
+ *
+ * While loaded, this component gives both platforms the same, correct behavior: a non-empty folder is
+ * refused with an {@link NOT_EMPTY_DIRECTORY_ERROR_CODE} error and nothing is deleted; an empty folder is
+ * removed. Emptiness is decided from the adapter (via {@link isEmptyFolder}), not from the vault index — the
+ * index omits dot-prefixed and otherwise hidden entries, so a folder holding only hidden files reads as empty
+ * there and the guard would wave through exactly the deletion it exists to prevent.
+ *
+ * A folder proven empty is removed by forwarding to the original method with `recursive: true`. That is not
+ * merely defensive: it is what makes the empty-folder case succeed on desktop, where the non-recursive call
+ * would otherwise throw.
+ *
+ * Calls that already pass `recursive: true`, and calls whose target is not a folder (a file, a missing path),
+ * are passed through untouched and keep their native behavior.
+ *
+ * Loading the guard more than once is safe, and it deliberately carries **no patch token**. Every plugin
+ * bundles its own copy of this library and they all patch the one shared adapter, so several guards do stack
+ * — but the operation is idempotent (prove empty, then delete), so stacking changes nothing: the outermost
+ * guard either throws or forwards with `recursive: true`, which every guard beneath passes straight through.
+ * They can also be unloaded in any order and the method stays guarded until the last one goes, because
+ * `monkey-around` neutralizes an unloaded wrapper in place rather than splicing it out. A token would only
+ * move the decision to the innermost guard — an equally arbitrary choice — while adding a path on which a
+ * guard declines to guard. For a data-loss guard that trade is not worth making. Contrast
+ * `RenameDeleteHandlerComponent`, which does need one: suppressing `runAsyncLinkUpdate` is not idempotent,
+ * so two of those would conflict.
+ *
+ * This component is deliberately **opt-in**: `app.vault.adapter` is shared by the whole app, so a library that
+ * installed this patch on its own would change `rmdir` semantics for every other plugin, including the ones
+ * that never asked for it. A plugin that deletes folders opts in for itself:
+ *
+ * @example
+ * ```ts
+ * this.addChild(new RmdirGuardComponent(this.app));
+ * ```
+ */
+export declare class RmdirGuardComponent extends MonkeyAroundComponent {
+    protected readonly app: App;
+    /**
+     * Creates a new instance of the {@link RmdirGuardComponent} class.
+     *
+     * @param app - The Obsidian app instance whose vault adapter to guard.
+     */
+    constructor(app: App);
+    /**
+     * Installs the `rmdir` guard. The patch is uninstalled when this component unloads.
+     */
+    onload(): void;
+}