@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/parse-link.d.cts

@@ -0,0 +1,288 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * This module provides utilities for parsing markdown and wiki links into structured data, and for
+ * escaping, unescaping, and encoding link components.
+ */
+import type { FrontmatterLinkCache, Reference, ReferenceCache } from 'obsidian' with { 'resolution-mode': 'import' };
+/**
+ * The result of parsing the links from a note's frontmatter via {@link parseFrontmatterLinks}. Internal
+ * single-link frontmatter values are omitted, as Obsidian natively caches them.
+ */
+export interface ParseFrontmatterLinksResult {
+    /**
+     * The external links parsed from single-link (single-value) frontmatter values.
+     */
+    readonly frontmatterExternalLinks: ParseLinkFrontmatterReference[];
+    /**
+     * The external links parsed from multi-link (multi-value) frontmatter values.
+     */
+    readonly multiValueFrontmatterExternalLinks: ParseLinkFrontmatterReferenceWithOffsets[];
+    /**
+     * The internal links parsed from multi-link (multi-value) frontmatter values.
+     */
+    readonly multiValueFrontmatterLinks: ParseLinkFrontmatterReferenceWithOffsets[];
+}
+/**
+ * A {@link FrontmatterLinkCache} for a link parsed from a single-link frontmatter value via
+ * {@link parseLinks}. It carries the full {@link ParseLinkResult} so consumers can inspect the parse
+ * details without re-parsing the link. Use this when the whole frontmatter value is a single link.
+ */
+export interface ParseLinkFrontmatterReference extends FrontmatterLinkCache {
+    /**
+     * The result of parsing the link.
+     */
+    readonly parseLinkResult: ParseLinkResult;
+}
+/**
+ * A {@link ParseLinkFrontmatterReference} for a link parsed from a multi-link frontmatter value via
+ * {@link parseLinks}, additionally carrying the offsets of the link within the frontmatter value. Use
+ * this when the frontmatter value holds multiple links.
+ */
+export interface ParseLinkFrontmatterReferenceWithOffsets extends ParseLinkFrontmatterReference {
+    /**
+     * An end offset of the link in the frontmatter value.
+     */
+    endOffset: number;
+    /**
+     * A start offset of the link in the frontmatter value.
+     */
+    startOffset: number;
+}
+/**
+ * Options for {@link parseLink}. The same as {@link ParseLinksOptions}.
+ */
+export type ParseLinkOptions = ParseLinksOptions;
+/**
+ * A {@link ReferenceCache} for a link parsed from content via {@link parseLinks}. It carries the full
+ * {@link ParseLinkResult} so consumers can inspect the parse details without re-parsing the link.
+ */
+export interface ParseLinkReference extends ReferenceCache {
+    /**
+     * The result of parsing the link.
+     */
+    readonly parseLinkResult: ParseLinkResult;
+}
+/**
+ * A result of parsing a link.
+ */
+export interface ParseLinkResult {
+    /**
+     * An alias of the link.
+     *
+     * @example
+     * ```
+     * [\*alias\*](link.md) -> \*alias\*
+     * ```
+     */
+    readonly alias?: string;
+    /**
+     * An encoded URL of the link.
+     *
+     * @example
+     * ```
+     * [alias](<link with space.md>) -> link%20with%20space.md
+     * ```
+     */
+    readonly encodedUrl?: string;
+    /**
+     * An end offset of the link in the original text.
+     */
+    readonly endOffset: number;
+    /**
+     * Indicates if the link has angle brackets.
+     *
+     * @example
+     * ```
+     * [alias](<link.md>) -> true
+     * [alias](link.md) -> false
+     * ```
+     */
+    readonly hasAngleBrackets?: boolean;
+    /**
+     * Indicates if the link is an embed link.
+     *
+     * @example
+     * ```
+     * ![[alias]] -> true
+     * [[alias]] -> false
+     * ```
+     */
+    readonly isEmbed: boolean;
+    /**
+     * Indicates if the link is external.
+     *
+     * @example
+     * ```
+     * [alias](https://example.com) -> true
+     * [alias](file.md) -> false
+     * ```
+     */
+    readonly isExternal: boolean;
+    /**
+     * Indicates if the link is a `file://` URL.
+     *
+     * @example
+     * ```
+     * [alias](file:///C:/x.txt) -> true
+     * [alias](https://example.com) -> false
+     * ```
+     */
+    readonly isFileUrl: boolean;
+    /**
+     * Indicates if the link is a wikilink.
+     *
+     * @example
+     * ```
+     * [[alias]] -> true
+     * [alias](link.md) -> false
+     * ```
+     */
+    readonly isWikilink: boolean;
+    /**
+     * A raw link text.
+     *
+     * @example
+     * ```
+     * [alias](link.md) -> [alias](link.md)
+     * ```
+     */
+    readonly raw: string;
+    /**
+     * A start offset of the link in the original text.
+     */
+    readonly startOffset: number;
+    /**
+     * A title of the link.
+     *
+     * @example
+     * ```
+     * [alias](link.md "title") -> title
+     * ```
+     */
+    readonly title?: string;
+    /**
+     * An unescaped alias of the link.
+     *
+     * @example
+     * ```
+     * [\*alias\*](link.md) -> *alias*
+     * ```
+     */
+    readonly unescapedAlias?: string;
+    /**
+     * An URL of the link.
+     *
+     * @example
+     * ```
+     * [alias](link%20with%20space.md) -> link with space.md
+     * ```
+     */
+    readonly url: string;
+}
+/**
+ * Options for {@link parseLinks}.
+ */
+export interface ParseLinksOptions {
+    /**
+     * Whether to recognize GFM extended `www.` autolink literals (`www.example.com`, also inside
+     * `<...>`) as external links, as Obsidian does in a note's body. Obsidian does not link them in
+     * frontmatter values, so {@link parseFrontmatterLinks} turns this off.
+     *
+     * Defaults to `true`.
+     */
+    readonly shouldRecognizeWwwAutolinkLiterals?: boolean;
+}
+/**
+ * Params for {@link toParseLinkReference}.
+ */
+export interface ToParseLinkReferenceParams {
+    /**
+     * The content the parsed link's offsets index into. Used to compute the line and column.
+     */
+    readonly content: string;
+    /**
+     * The parsed link to wrap.
+     */
+    readonly parseLinkResult: ParseLinkResult;
+}
+/**
+ * Escapes the alias of a markdown link.
+ *
+ * @param alias - An alias of a markdown link.
+ * @returns An escaped alias.
+ *
+ * @example
+ * ```ts
+ * escapeAlias('**alias**') // '\\*\\*alias\\*\\*'
+ * ```
+ */
+export declare function escapeAlias(alias: string): string;
+/**
+ * Determines whether a reference is a {@link ParseLinkFrontmatterReference}.
+ *
+ * @param reference - The reference to check.
+ * @returns `true` if the reference is a {@link ParseLinkFrontmatterReference}, otherwise `false`.
+ */
+export declare function isParseLinkFrontmatterReference(reference: Reference): reference is ParseLinkFrontmatterReference;
+/**
+ * Determines whether a reference is a {@link ParseLinkReference}.
+ *
+ * @param reference - The reference to check.
+ * @returns `true` if the reference is a {@link ParseLinkReference}, otherwise `false`.
+ */
+export declare function isParseLinkReference(reference: Reference): reference is ParseLinkReference;
+/**
+ * Parses the links from a note's frontmatter. Each string value is parsed via {@link parseLinks}: a value
+ * that is a single link yields an entry without offsets, and a value that holds multiple links yields
+ * offset-carrying entries. Internal single-link values are omitted, as Obsidian natively caches them.
+ *
+ * @param frontmatter - The frontmatter to parse (a value, object, or array).
+ * @returns The parsed frontmatter links.
+ */
+export declare function parseFrontmatterLinks(frontmatter: unknown): ParseFrontmatterLinksResult;
+/**
+ * Parses a link into its components.
+ *
+ * @param $string - The link to parse.
+ * @param options - The parse options.
+ * @returns The parsed link.
+ */
+export declare function parseLink($string: string, options?: ParseLinkOptions): null | ParseLinkResult;
+/**
+ * Parses all links in a string.
+ *
+ * Besides markdown links, wikilinks and autolinks, the plain text between them is scanned for bare
+ * URLs with a scheme (`https://example.com`) and, unless turned off through
+ * {@link ParseLinksOptions.shouldRecognizeWwwAutolinkLiterals}, for GFM extended `www.` autolink
+ * literals (`www.example.com`). Such a literal is reported as an external link whose `url` carries the
+ * `http://` scheme Obsidian opens it with, so a link rebuilt from it stays external: a scheme-less
+ * `[alias](www.example.com)` is an internal link in Obsidian. A literal wrapped in `<...>` reports the
+ * brackets as part of `raw`, so replacing `raw` leaves no stray bracket behind.
+ *
+ * @param $string - The string to parse the links in.
+ * @param options - The parse options.
+ * @returns The parsed links.
+ */
+export declare function parseLinks($string: string, options?: ParseLinksOptions): ParseLinkResult[];
+/**
+ * Wraps a {@link ParseLinkResult} into a {@link ParseLinkReference} so it can flow through the
+ * reference-based file-change pipeline.
+ *
+ * @param params - The parameters for wrapping the parsed link.
+ * @returns The {@link ParseLinkReference}.
+ */
+export declare function toParseLinkReference(params: ToParseLinkReferenceParams): ParseLinkReference;
+/**
+ * Unescapes the alias of a markdown link.
+ *
+ * @param escapedAlias - An escaped alias.
+ * @returns An unescaped alias.
+ *
+ * @example
+ * ```ts
+ * unescapeAlias('\\*\\*alias\\*\\*') // '**alias**'
+ * ```
+ */
+export declare function unescapeAlias(escapedAlias: string): string;

package/dist/lib/cjs/path-settings.cjs

@@ -0,0 +1,293 @@
+/*
+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 path_settings_exports = {};
+__export(path_settings_exports, {
+  PathSettings: () => PathSettings,
+  pathsValidator: () => pathsValidator
+});
+module.exports = __toCommonJS(path_settings_exports);
+var import_reg_exp = require('@mnaoumov/typescript-lib/reg-exp');
+var import_string = require('@mnaoumov/typescript-lib/string');
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_i18n = require('./i18n/i18n.cjs');
+class PathSetting {
+  constructor(type) {
+    this.type = type;
+    this.defaultRegExp = getDefaultRegExp(type);
+    this.regExp = this.defaultRegExp;
+  }
+  type;
+  get array() {
+    return this._array;
+  }
+  set array(value) {
+    this._array = value.filter(Boolean);
+    this.regExp = makeRegExp(this._array, this.defaultRegExp) ?? this.defaultRegExp;
+  }
+  _array = [];
+  defaultRegExp;
+  regExp;
+  isPathIgnored(path) {
+    switch (this.type) {
+      /* v8 ignore stop */
+      case "Exclude" /* Exclude */: {
+        return this.regExp.test(path);
+      }
+      case "Include" /* Include */: {
+        return !this.regExp.test(path);
+      }
+      default: {
+        (0, import_type_guards.assertNever)(this.type);
+      }
+    }
+  }
+}
+class PathSettings {
+  /**
+   * Gets the exclude paths.
+   *
+   * @returns The exclude paths.
+   */
+  get excludePaths() {
+    return this._excludePaths.array;
+  }
+  /**
+   * Sets the exclude paths.
+   *
+   * @param value - The exclude paths.
+   */
+  set excludePaths(value) {
+    this._excludePaths.array = value;
+  }
+  /**
+   * Gets the include paths.
+   *
+   * @returns The include paths.
+   */
+  get includePaths() {
+    return this._includePaths.array;
+  }
+  /**
+   * Sets the include paths.
+   *
+   * @param value - The include paths.
+   */
+  set includePaths(value) {
+    this._includePaths.array = value;
+  }
+  _excludePaths = new PathSetting("Exclude" /* Exclude */);
+  _includePaths = new PathSetting("Include" /* Include */);
+  /**
+   * Checks if a path is ignored by the include/exclude path settings.
+   *
+   * @param path - The path to check.
+   * @returns `true` if the path is ignored, `false` otherwise.
+   */
+  isPathIgnored(path) {
+    return this._includePaths.isPathIgnored(path) || this._excludePaths.isPathIgnored(path);
+  }
+}
+function pathsValidator(paths) {
+  for (const path of paths) {
+    if (path.startsWith("/") && path.endsWith("/") && !(0, import_reg_exp.isValidRegExp)(path.slice(1, -1))) {
+      return (0, import_i18n.t)(($) => $.obsidianDevUtils.pathSettings.invalidRegularExpression, { regExp: path });
+    }
+  }
+}
+function getDefaultRegExp(type) {
+  switch (type) {
+    /* v8 ignore stop */
+    case "Exclude" /* Exclude */: {
+      return import_reg_exp.NEVER_MATCH_REG_EXP;
+    }
+    case "Include" /* Include */: {
+      return import_reg_exp.ALWAYS_MATCH_REG_EXP;
+    }
+    default: {
+      (0, import_type_guards.assertNever)(type);
+    }
+  }
+}
+function makeRegExp(paths, defaultRegExp) {
+  if (paths.length === 0) {
+    return defaultRegExp;
+  }
+  const regExpStringCombined = paths.map((path) => {
+    if (path === "/") {
+      return defaultRegExp.source;
+    }
+    if (path.startsWith("/") && path.endsWith("/")) {
+      return path.slice(1, -1);
+    }
+    path = (0, import_string.trimEnd)({
+      $string: path,
+      suffix: "/"
+    });
+    return `^${(0, import_reg_exp.escapeRegExp)(path)}(/|$)`;
+  }).map((regExpString) => `(${regExpString})`).join("|");
+  try {
+    return new RegExp(regExpStringCombined);
+  } catch {
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PathSettings,
+  pathsValidator
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3BhdGgtc2V0dGluZ3MudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBUaGlzIG1vZHVsZSBwcm92aWRlcyBjbGFzc2VzIGFuZCB2YWxpZGF0b3JzIGZvciBtYW5hZ2luZyBpbmNsdWRlL2V4Y2x1ZGUgcGF0aCBzZXR0aW5ncy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IE1heWJlUmV0dXJuIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUnO1xuXG5pbXBvcnQge1xuICBBTFdBWVNfTUFUQ0hfUkVHX0VYUCxcbiAgZXNjYXBlUmVnRXhwLFxuICBpc1ZhbGlkUmVnRXhwLFxuICBORVZFUl9NQVRDSF9SRUdfRVhQXG59IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9yZWctZXhwJztcbmltcG9ydCB7IHRyaW1FbmQgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvc3RyaW5nJztcbmltcG9ydCB7IGFzc2VydE5ldmVyIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUtZ3VhcmRzJztcblxuaW1wb3J0IHsgdCB9IGZyb20gJy4vaTE4bi9pMThuLnRzJztcblxuZW51bSBQYXRoU2V0dGluZ1R5cGUge1xuICBFeGNsdWRlID0gJ0V4Y2x1ZGUnLFxuICBJbmNsdWRlID0gJ0luY2x1ZGUnXG59XG5cbmNsYXNzIFBhdGhTZXR0aW5nIHtcbiAgcHVibGljIGdldCBhcnJheSgpOiBzdHJpbmdbXSB7XG4gICAgcmV0dXJuIHRoaXMuX2FycmF5O1xuICB9XG5cbiAgcHVibGljIHNldCBhcnJheSh2YWx1ZTogc3RyaW5nW10pIHtcbiAgICB0aGlzLl9hcnJheSA9IHZhbHVlLmZpbHRlcihCb29sZWFuKTtcbiAgICB0aGlzLnJlZ0V4cCA9IG1ha2VSZWdFeHAodGhpcy5fYXJyYXksIHRoaXMuZGVmYXVsdFJlZ0V4cCkgPz8gdGhpcy5kZWZhdWx0UmVnRXhwO1xuICB9XG5cbiAgcHJpdmF0ZSBfYXJyYXk6IHN0cmluZ1tdID0gW107XG4gIHByaXZhdGUgcmVhZG9ubHkgZGVmYXVsdFJlZ0V4cDogUmVnRXhwO1xuICBwcml2YXRlIHJlZ0V4cDogUmVnRXhwO1xuXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcml2YXRlIHJlYWRvbmx5IHR5cGU6IFBhdGhTZXR0aW5nVHlwZSkge1xuICAgIHRoaXMuZGVmYXVsdFJlZ0V4cCA9IGdldERlZmF1bHRSZWdFeHAodHlwZSk7XG4gICAgdGhpcy5yZWdFeHAgPSB0aGlzLmRlZmF1bHRSZWdFeHA7XG4gIH1cblxuICBwdWJsaWMgaXNQYXRoSWdub3JlZChwYXRoOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgICAvKiB2OCBpZ25vcmUgc3RhcnQgLS0gQWxsIGJyYW5jaGVzIGNvdmVyZWQgYnV0IHY4IHJlcG9ydHMgc3dpdGNoIGFzIHBhcnRpYWwuICovXG4gICAgc3dpdGNoICh0aGlzLnR5cGUpIHtcbiAgICAgIC8qIHY4IGlnbm9yZSBzdG9wICovXG4gICAgICBjYXNlIFBhdGhTZXR0aW5nVHlwZS5FeGNsdWRlOiB7XG4gICAgICAgIHJldHVybiB0aGlzLnJlZ0V4cC50ZXN0KHBhdGgpO1xuICAgICAgfVxuICAgICAgY2FzZSBQYXRoU2V0dGluZ1R5cGUuSW5jbHVkZToge1xuICAgICAgICByZXR1cm4gIXRoaXMucmVnRXhwLnRlc3QocGF0aCk7XG4gICAgICB9XG4gICAgICBkZWZhdWx0OiB7XG4gICAgICAgIC8qIHY4IGlnbm9yZSBzdGFydCAtLSBFeGhhdXN0aXZlIHN3aXRjaCBndWFyZC4gKi9cbiAgICAgICAgYXNzZXJ0TmV2ZXIodGhpcy50eXBlKTtcbiAgICAgIH1cbiAgICAgICAgLyogdjggaWdub3JlIHN0b3AgKi9cbiAgICB9XG4gIH1cbn1cblxuLyoqXG4gKiBBIGNsYXNzIGZvciBtYW5hZ2luZyBpbmNsdWRlL2V4Y2x1ZGUgcGF0aCBzZXR0aW5ncy5cbiAqL1xuZXhwb3J0IGNsYXNzIFBhdGhTZXR0aW5ncyB7XG4gIC8qKlxuICAgKiBHZXRzIHRoZSBleGNsdWRlIHBhdGhzLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgZXhjbHVkZSBwYXRocy5cbiAgICovXG4gIHB1YmxpYyBnZXQgZXhjbHVkZVBhdGhzKCk6IHN0cmluZ1tdIHtcbiAgICByZXR1cm4gdGhpcy5fZXhjbHVkZVBhdGhzLmFycmF5O1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIGV4Y2x1ZGUgcGF0aHMuXG4gICAqXG4gICAqIEBwYXJhbSB2YWx1ZSAtIFRoZSBleGNsdWRlIHBhdGhzLlxuICAgKi9cbiAgcHVibGljIHNldCBleGNsdWRlUGF0aHModmFsdWU6IHN0cmluZ1tdKSB7XG4gICAgdGhpcy5fZXhjbHVkZVBhdGhzLmFycmF5ID0gdmFsdWU7XG4gIH1cblxuICAvKipcbiAgICogR2V0cyB0aGUgaW5jbHVkZSBwYXRocy5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIGluY2x1ZGUgcGF0aHMuXG4gICAqL1xuICBwdWJsaWMgZ2V0IGluY2x1ZGVQYXRocygpOiBzdHJpbmdbXSB7XG4gICAgcmV0dXJuIHRoaXMuX2luY2x1ZGVQYXRocy5hcnJheTtcbiAgfVxuXG4gIC8qKlxuICAgKiBTZXRzIHRoZSBpbmNsdWRlIHBhdGhzLlxuICAgKlxuICAgKiBAcGFyYW0gdmFsdWUgLSBUaGUgaW5jbHVkZSBwYXRocy5cbiAgICovXG4gIHB1YmxpYyBzZXQgaW5jbHVkZVBhdGhzKHZhbHVlOiBzdHJpbmdbXSkge1xuICAgIHRoaXMuX2luY2x1ZGVQYXRocy5hcnJheSA9IHZhbHVlO1xuICB9XG5cbiAgcHJpdmF0ZSByZWFkb25seSBfZXhjbHVkZVBhdGhzID0gbmV3IFBhdGhTZXR0aW5nKFBhdGhTZXR0aW5nVHlwZS5FeGNsdWRlKTtcbiAgcHJpdmF0ZSByZWFkb25seSBfaW5jbHVkZVBhdGhzID0gbmV3IFBhdGhTZXR0aW5nKFBhdGhTZXR0aW5nVHlwZS5JbmNsdWRlKTtcblxuICAvKipcbiAgICogQ2hlY2tzIGlmIGEgcGF0aCBpcyBpZ25vcmVkIGJ5IHRoZSBpbmNsdWRlL2V4Y2x1ZGUgcGF0aCBzZXR0aW5ncy5cbiAgICpcbiAgICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byBjaGVjay5cbiAgICogQHJldHVybnMgYHRydWVgIGlmIHRoZSBwYXRoIGlzIGlnbm9yZWQsIGBmYWxzZWAgb3RoZXJ3aXNlLlxuICAgKi9cbiAgcHVibGljIGlzUGF0aElnbm9yZWQocGF0aDogc3RyaW5nKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMuX2luY2x1ZGVQYXRocy5pc1BhdGhJZ25vcmVkKHBhdGgpIHx8IHRoaXMuX2V4Y2x1ZGVQYXRocy5pc1BhdGhJZ25vcmVkKHBhdGgpO1xuICB9XG59XG5cbi8qKlxuICogVmFsaWRhdGVzIGluY2x1ZGUvZXhjbHVkZSBwYXRoIGVudHJpZXMsIHJlcG9ydGluZyB0aGUgZmlyc3QgZW50cnkgdGhhdCBpcyBub3QgYSBwYXJzZWFibGUgcmVndWxhciBleHByZXNzaW9uLlxuICpcbiAqIEFuIGVudHJ5IHRoYXQgc3RhcnRzIGFuZCBlbmRzIHdpdGggYC9gIGlzIGEgcmVndWxhciBleHByZXNzaW9uIGxpdGVyYWw7IGV2ZXJ5IG90aGVyIGVudHJ5IGlzIGEgcGxhaW4gcGF0aCBhbmQgaXNcbiAqIGFsd2F5cyB2YWxpZC4gQW4gaW52YWxpZCBlbnRyeSBkb2VzIG5vdCB0aHJvdyB3aGVuIGFzc2lnbmVkIHRvIHtAbGluayBQYXRoU2V0dGluZ3N9IFx1MjAxNCB0aGUgd2hvbGUgbGlzdCBmYWxscyBiYWNrIHRvXG4gKiBpdHMgZGVmYXVsdCBwYXR0ZXJuIGluc3RlYWQgXHUyMDE0IHNvIHRoaXMgdmFsaWRhdG9yIGlzIHdoYXQgc3VyZmFjZXMgdGhlIHByb2JsZW0gdG8gdGhlIHVzZXIuXG4gKlxuICogQHBhcmFtIHBhdGhzIC0gVGhlIHBhdGggZW50cmllcyB0byB2YWxpZGF0ZS5cbiAqIEByZXR1cm5zIEEgbWVzc2FnZSBuYW1pbmcgdGhlIGZpcnN0IGludmFsaWQgZW50cnksIG9yIG5vdGhpbmcgd2hlbiBldmVyeSBlbnRyeSBpcyB2YWxpZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhdGhzVmFsaWRhdG9yKHBhdGhzOiBzdHJpbmdbXSk6IE1heWJlUmV0dXJuPHN0cmluZz4ge1xuICBmb3IgKGNvbnN0IHBhdGggb2YgcGF0aHMpIHtcbiAgICBpZiAocGF0aC5zdGFydHNXaXRoKCcvJykgJiYgcGF0aC5lbmRzV2l0aCgnLycpICYmICFpc1ZhbGlkUmVnRXhwKHBhdGguc2xpY2UoMSwgLTEpKSkge1xuICAgICAgcmV0dXJuIHQoKCQpID0+ICQub2JzaWRpYW5EZXZVdGlscy5wYXRoU2V0dGluZ3MuaW52YWxpZFJlZ3VsYXJFeHByZXNzaW9uLCB7IHJlZ0V4cDogcGF0aCB9KTtcbiAgICB9XG4gIH1cbn1cblxuZnVuY3Rpb24gZ2V0RGVmYXVsdFJlZ0V4cCh0eXBlOiBQYXRoU2V0dGluZ1R5cGUpOiBSZWdFeHAge1xuICAvKiB2OCBpZ25vcmUgc3RhcnQgLS0gQWxsIGJyYW5jaGVzIGNvdmVyZWQgYnV0IHY4IHJlcG9ydHMgc3dpdGNoIGFzIHBhcnRpYWwuICovXG4gIHN3aXRjaCAodHlwZSkge1xuICAgIC8qIHY4IGlnbm9yZSBzdG9wICovXG4gICAgY2FzZSBQYXRoU2V0dGluZ1R5cGUuRXhjbHVkZToge1xuICAgICAgcmV0dXJuIE5FVkVSX01BVENIX1JFR19FWFA7XG4gICAgfVxuICAgIGNhc2UgUGF0aFNldHRpbmdUeXBlLkluY2x1ZGU6IHtcbiAgICAgIHJldHVybiBBTFdBWVNfTUFUQ0hfUkVHX0VYUDtcbiAgICB9XG4gICAgZGVmYXVsdDoge1xuICAgICAgLyogdjggaWdub3JlIHN0YXJ0IC0tIEV4aGF1c3RpdmUgc3dpdGNoIGd1YXJkLiAqL1xuICAgICAgYXNzZXJ0TmV2ZXIodHlwZSk7XG4gICAgfVxuICAgICAgLyogdjggaWdub3JlIHN0b3AgKi9cbiAgfVxufVxuXG5mdW5jdGlvbiBtYWtlUmVnRXhwKHBhdGhzOiBzdHJpbmdbXSwgZGVmYXVsdFJlZ0V4cDogUmVnRXhwKTogbnVsbCB8IFJlZ0V4cCB7XG4gIGlmIChwYXRocy5sZW5ndGggPT09IDApIHtcbiAgICByZXR1cm4gZGVmYXVsdFJlZ0V4cDtcbiAgfVxuXG4gIGNvbnN0IHJlZ0V4cFN0cmluZ0NvbWJpbmVkID0gcGF0aHMubWFwKChwYXRoKSA9PiB7XG4gICAgaWYgKHBhdGggPT09ICcvJykge1xuICAgICAgcmV0dXJuIGRlZmF1bHRSZWdFeHAuc291cmNlO1xuICAgIH1cblxuICAgIGlmIChwYXRoLnN0YXJ0c1dpdGgoJy8nKSAmJiBwYXRoLmVuZHNXaXRoKCcvJykpIHtcbiAgICAgIHJldHVybiBwYXRoLnNsaWNlKDEsIC0xKTtcbiAgICB9XG5cbiAgICBwYXRoID0gdHJpbUVuZCh7XG4gICAgICAkc3RyaW5nOiBwYXRoLFxuICAgICAgc3VmZml4OiAnLydcbiAgICB9KTtcbiAgICByZXR1cm4gYF4ke2VzY2FwZVJlZ0V4cChwYXRoKX0oL3wkKWA7XG4gIH0pXG4gICAgLm1hcCgocmVnRXhwU3RyaW5nKSA9PiBgKCR7cmVnRXhwU3RyaW5nfSlgKVxuICAgIC5qb2luKCd8Jyk7XG5cbiAgdHJ5IHtcbiAgICByZXR1cm4gbmV3IFJlZ0V4cChyZWdFeHBTdHJpbmdDb21iaW5lZCk7XG4gIH0gY2F0Y2gge1xuICAgIC8vIEEgcGFydGlhbGx5IHR5cGVkIHJlZ2V4IGxpdGVyYWwgKGAvXkluYm94XFwvYCkgaXMgbm90IHBhcnNlYWJsZS5cbiAgICAvLyBSZXBvcnQgaXQgaW5zdGVhZCBvZiB0aHJvd2luZyBmcm9tIGEgc2V0dGluZ3Mgc2V0dGVyLCB3aGljaCB3b3VsZCBicmVhayBib3RoIHRoZSBzZXR0aW5ncyBVSSBhbmQgdGhlIHNhdmUgcGF0aC5cbiAgICByZXR1cm4gbnVsbDtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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

package/dist/lib/cjs/path-settings.d.cts

@@ -0,0 +1,56 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * This module provides classes and validators for managing include/exclude path settings.
+ */
+import type { MaybeReturn } from '@mnaoumov/typescript-lib/type' with { 'resolution-mode': 'import' };
+/**
+ * A class for managing include/exclude path settings.
+ */
+export declare class PathSettings {
+    /**
+     * Gets the exclude paths.
+     *
+     * @returns The exclude paths.
+     */
+    get excludePaths(): string[];
+    /**
+     * Sets the exclude paths.
+     *
+     * @param value - The exclude paths.
+     */
+    set excludePaths(value: string[]);
+    /**
+     * Gets the include paths.
+     *
+     * @returns The include paths.
+     */
+    get includePaths(): string[];
+    /**
+     * Sets the include paths.
+     *
+     * @param value - The include paths.
+     */
+    set includePaths(value: string[]);
+    private readonly _excludePaths;
+    private readonly _includePaths;
+    /**
+     * Checks if a path is ignored by the include/exclude path settings.
+     *
+     * @param path - The path to check.
+     * @returns `true` if the path is ignored, `false` otherwise.
+     */
+    isPathIgnored(path: string): boolean;
+}
+/**
+ * Validates include/exclude path entries, reporting the first entry that is not a parseable regular expression.
+ *
+ * An entry that starts and ends with `/` is a regular expression literal; every other entry is a plain path and is
+ * always valid. An invalid entry does not throw when assigned to {@link PathSettings} — the whole list falls back to
+ * its default pattern instead — so this validator is what surfaces the problem to the user.
+ *
+ * @param paths - The path entries to validate.
+ * @returns A message naming the first invalid entry, or nothing when every entry is valid.
+ */
+export declare function pathsValidator(paths: string[]): MaybeReturn<string>;