@mnaoumov/obsidian-dev-toolkit 0.0.0 → 1.1.0

package/dist/lib/cjs/test-runners/vitest-config.d.cts

@@ -0,0 +1,200 @@
+/// <reference path="../index.d.cts" />
+/**
+ * @file
+ *
+ * Shared vitest configuration for Obsidian plugins.
+ *
+ * Every plugin in the workspace declares the same five vitest projects — `unit-tests` plus the
+ * `integration-tests:{no-app,desktop,desktop-performance,android}` family — with the same timeouts,
+ * `setupFiles`, and `globalSetup` wiring. Maintaining that per repo means a convention change costs one
+ * near-identical edit per plugin, and any repo that is missed drifts silently. This module owns that
+ * configuration once, so a plugin's `scripts/vitest-config.ts` collapses to a single call.
+ *
+ * The seam mirrors {@link https://www.npmjs.com/package/obsidian-dev-utils | the ESLint one}
+ * (`defineEslintConfigs`): the factory builds a context holding the standard projects, the caller edits
+ * it in place through {@link DefineObsidianPluginVitestConfigOptions.editContext}, and appends any
+ * project the base does not know about through
+ * {@link DefineObsidianPluginVitestConfigOptions.customProjects}.
+ */
+import type { VitestReporter } from '@mnaoumov/typescript-dev-toolkit/test-runners/vitest-config' with { 'resolution-mode': 'import' };
+import type { TestProjectConfiguration, TestProjectInlineConfiguration, ViteUserConfig } from 'vitest/config' with { 'resolution-mode': 'import' };
+import { DEFAULT_VITEST_REPORTERS } from '@mnaoumov/typescript-dev-toolkit/test-runners/vitest-config';
+/**
+ * The `test` section of a single vitest project entry.
+ */
+export type ObsidianPluginVitestProjectConfig = NonNullable<TestProjectInlineConfiguration['test']>;
+/**
+ * One entry of a vitest `reporters` list: the name of a built-in reporter or a reporter instance. The same shape as
+ * the library configuration's {@link VitestReporter}.
+ */
+export type ObsidianPluginVitestReporter = VitestReporter;
+export { DEFAULT_VITEST_REPORTERS };
+/**
+ * The per-test budget of the regular integration projects, in milliseconds.
+ *
+ * Exported because a repo that assembles its vitest projects by hand instead of through
+ * {@link defineObsidianPluginVitestConfig} still needs the same relationship to the per-eval cap, and
+ * restating the number there is how the two drift apart.
+ */
+export declare const INTEGRATION_TEST_TIMEOUT_IN_MILLISECONDS: number;
+/**
+ * The options for defining a plugin's vitest configuration.
+ */
+export interface DefineObsidianPluginVitestConfigOptions {
+    /**
+     * A function that builds projects the base configuration does not know about, such as a plugin's own
+     * `integration-tests:demo-vault` project. The returned projects are appended after the standard five.
+     *
+     * @param context - The vitest configuration context.
+     * @returns The extra projects.
+     */
+    readonly customProjects?: (context: ObsidianPluginVitestConfigContext) => TestProjectConfiguration[];
+    /**
+     * A function that edits the vitest configuration context before it is assembled into a configuration.
+     *
+     * @param context - The vitest configuration context.
+     */
+    readonly editContext?: (context: ObsidianPluginVitestConfigContext) => void;
+}
+/**
+ * The context for defining a plugin's vitest configuration.
+ *
+ * Every member is live: the arrays and objects it exposes are the very ones the assembled configuration
+ * is built from, so editing them in place through
+ * {@link DefineObsidianPluginVitestConfigOptions.editContext} is what customizes the result.
+ */
+export declare class ObsidianPluginVitestConfigContext {
+    /**
+     * The `integration-tests:android` project, running the mobile-only and cross-platform suites against an
+     * Android emulator through Appium.
+     */
+    readonly android: ObsidianPluginVitestProjectConfig;
+    /**
+     * The per-test budget of the Android integration project, in milliseconds. Booting an emulator and
+     * driving it over Appium is slower than the desktop path, hence its own constant.
+     *
+     * @default `60000`
+     */
+    readonly androidTimeoutInMilliseconds = 60000;
+    /**
+     * The per-test budget of the regular integration projects, in milliseconds.
+     *
+     * It deliberately CLEARS the transports' per-eval cap rather than matching it, so that a closure which
+     * outruns the cap fails with the harness's `EvalCapExceededError` — naming the cap and the remedy —
+     * instead of with vitest's anonymous timeout. Lowering it to the cap restores that blind spot.
+     *
+     * @default `45000`
+     */
+    readonly bigTimeoutInMilliseconds: number;
+    /**
+     * The coverage `exclude` globs. Push onto it to drop more files from the coverage report.
+     *
+     * Declaration files are excluded by default because the coverage `include` below is `src/**\/*.ts`,
+     * which a `.d.ts` matches. A declaration file emits no runtime code, so it reports 0% and no test can
+     * ever raise it — a plugin that grows one under `src/` silently loses its 100% gate, and the usual
+     * remedy of an inline `v8 ignore` comment does not apply to a type-only file.
+     */
+    readonly coverageExclude: string[];
+    /**
+     * The `integration-tests:desktop` project, running the desktop-only and cross-platform suites against a
+     * real desktop Obsidian over CDP.
+     */
+    readonly desktop: ObsidianPluginVitestProjectConfig;
+    /**
+     * The `integration-tests:desktop-performance` project, running the at-scale suites. It is declared for
+     * every plugin even when there is no such suite yet — `passWithNoTests` makes an empty project free,
+     * and the matching `test:integration:desktop:performance` script exists in every plugin built on this library.
+     *
+     * A plugin's `test:integration` aggregate leaves this project out on purpose, and it stays out even on a
+     * machine with a desktop Obsidian set up. The reason is the fixture rather than the cost: a perf suite
+     * needs its own generated, populated vault, sized through env vars, and the aggregate's small temporary
+     * vault is the wrong one. The 600 s below is a timeout, not a duration — measured end to end, most perf
+     * suites finish in seconds, and only one that generates tens of thousands of notes takes minutes.
+     *
+     * Its CDP transport's per-eval cap is raised to 600 s as well (the budget clears it by the usual
+     * margin), because a perf suite's whole measurement is typically ONE long in-page evaluation, which the
+     * transport's 30 s default killed as a bare `CDP command timed out … Runtime.evaluate` naming neither the
+     * wait nor the assertion. Three plugins had each hand-written this raise in their own `editContext`
+     * before it moved here. Unlike a raised desktop cap, which is a backstop rather than a budget a closure
+     * may spend, this one IS a budget: `no-over-cap-wait-in-eval-in-obsidian` reads it for these files and
+     * for no other.
+     *
+     * No routine command runs them, but something does: a weekly sweep runs every plugin's
+     * `test:integration:desktop:performance`, which is also how to reach them by hand. Adding them to that
+     * aggregate is drift, not a gap to close.
+     */
+    readonly desktopPerformance: ObsidianPluginVitestProjectConfig;
+    /**
+     * The unit test files that redefine `window`, `document`, `location` or `top`, which the `unit-tests`
+     * project's VM pool cannot run.
+     *
+     * Under `pool: 'vmThreads'` those four are non-configurable properties of the VM global, so
+     * `vi.stubGlobal('window', …)` or `Object.defineProperty(window, 'location', …)` throws
+     * `Cannot redefine property`. That is JS semantics, not a bug to route around. Every other global stays
+     * configurable and stubs normally.
+     *
+     * Push a file here and it leaves `unit-tests` for a sibling `unit-tests:global-stubs` project that is
+     * identical except for the pool, which is the default one. A plugin's `test` and `test:coverage` scripts
+     * name `unit-tests`, which also selects every `unit-tests:*` project, so the sibling runs and is covered
+     * without a script change. It is emitted only when this list is non-empty.
+     *
+     * To keep a whole suite on the default pool instead, set `unitTests.pool` to `'forks'` and say why.
+     */
+    readonly globalStubTestFiles: string[];
+    /**
+     * The multiplier applied to a project's test budget to get its hook budget. A hook typically populates
+     * and opens a vault, so it needs several times what a single test does.
+     *
+     * @default `4`
+     */
+    readonly hookTimeoutMultiplier = 4;
+    /**
+     * The `integration-tests:no-app` project, running the suites that need no Obsidian instance at all.
+     */
+    readonly noApp: ObsidianPluginVitestProjectConfig;
+    /**
+     * The per-eval cap the performance integration project gives its CDP transport, in milliseconds.
+     *
+     * @default `600000`
+     */
+    readonly performanceEvalCapInMilliseconds = 600000;
+    /**
+     * The per-test budget of the performance integration project, in milliseconds. A performance vault is
+     * pre-populated with tens of thousands of notes before Obsidian opens, so both its setup and its tests
+     * need far more time than the regular integration projects.
+     *
+     * Like the regular budget, it CLEARS the project's per-eval cap
+     * ({@link ObsidianPluginVitestConfigContext.performanceEvalCapInMilliseconds}) rather than matching it,
+     * so an evaluation that outruns the cap reports itself instead of dying as vitest's anonymous timeout.
+     *
+     * @default `615000`
+     */
+    readonly performanceTimeoutInMilliseconds: number;
+    /**
+     * The reporters the run prints through.
+     *
+     * Pinned rather than left to vitest, which resolves an unset `reporters` differently for a developer
+     * and for an AI coding session — see {@link DEFAULT_VITEST_REPORTERS} for the whole of why, and for
+     * what it deliberately leaves to vitest 5 itself.
+     *
+     * Push onto it to add a reporter beside the pinned one.
+     *
+     * @default {@link DEFAULT_VITEST_REPORTERS}
+     */
+    readonly reporters: ObsidianPluginVitestReporter[];
+    /**
+     * The `unit-tests` project, running the mocked-Obsidian suites in `jsdom`.
+     */
+    readonly unitTests: ObsidianPluginVitestProjectConfig;
+    /**
+     * Creates a new context seeded with the standard projects.
+     */
+    constructor();
+}
+/**
+ * Defines the vitest configuration for an Obsidian plugin.
+ *
+ * @param options - The options for defining the configuration.
+ * @returns The vitest configuration.
+ */
+export declare function defineObsidianPluginVitestConfig(options?: DefineObsidianPluginVitestConfigOptions): ViteUserConfig;

package/dist/lib/cjs/version.cjs

@@ -0,0 +1,262 @@
+/*
+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 = 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 version_exports = {};
+__export(version_exports, {
+  copyUpdatedManifest: () => copyUpdatedManifest,
+  parseVersionArguments: () => parseVersionArguments,
+  updateVersion: () => updateVersion
+});
+module.exports = __toCommonJS(version_exports);
+var import_fs = require('@mnaoumov/typescript-dev-toolkit/fs');
+var import_json = require('@mnaoumov/typescript-dev-toolkit/json');
+var import_root = require('@mnaoumov/typescript-dev-toolkit/root');
+var import_version = require('@mnaoumov/typescript-dev-toolkit/version');
+var import_path = require('@mnaoumov/typescript-lib/path');
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_node_fs = require('node:fs');
+var import_promises = require('node:fs/promises');
+var import_node_util = require('node:util');
+var import_demo_vault = require('./demo-vault.cjs');
+var import_obsidian_plugin_repo_paths = require('./obsidian-plugin-repo-paths.cjs');
+const DESKTOP_RELEASES_JSON_URL = "https://raw.githubusercontent.com/obsidianmd/obsidian-releases/master/desktop-releases.json";
+async function copyUpdatedManifest() {
+  await (0, import_promises.cp)(
+    (0, import_root.resolvePathFromRootSafe)({ path: import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.ManifestJson }),
+    (0, import_root.resolvePathFromRootSafe)({ path: (0, import_path.join)(import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.DistBuild, import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.ManifestJson) }),
+    { force: true }
+  );
+}
+function parseVersionArguments($arguments) {
+  const { positionals, values } = (0, import_node_util.parseArgs)({
+    allowPositionals: true,
+    // eslint-disable-next-line unicorn/name-replacements -- `args` is the option name Node's `parseArgs` reads.
+    args: $arguments,
+    options: {
+      ...import_version.VERSION_ARGUMENT_OPTIONS,
+      "min-app-version": { type: "string" },
+      "no-demo-vault": { type: "boolean" }
+    }
+  });
+  return {
+    options: {
+      ...(0, import_version.toUpdateVersionOptions)(values),
+      minAppVersion: values["min-app-version"],
+      shouldArchiveDemoVault: !(values["no-demo-vault"] ?? false)
+    },
+    versionUpdateType: positionals[0]
+  };
+}
+async function updateVersion(versionUpdateType, options = {}) {
+  const {
+    minAppVersion,
+    prepareGitHubRelease,
+    shouldArchiveDemoVault = true,
+    ...genericOptions
+  } = options;
+  await (0, import_version.updateVersion)(versionUpdateType, {
+    ...genericOptions,
+    getReleaseAssetPaths: getPluginReleaseAssetPaths,
+    async prepareGitHubRelease(newVersion) {
+      await prepareGitHubRelease?.(newVersion);
+      if (shouldArchiveDemoVault) {
+        await (0, import_demo_vault.archivePluginDemoVault)();
+      }
+    },
+    async updateVersionInExtraFiles(newVersion) {
+      await updateVersionInFilesForPlugin(newVersion, minAppVersion);
+    }
+  });
+}
+async function getLatestObsidianVersion() {
+  const response = await fetch(DESKTOP_RELEASES_JSON_URL);
+  const desktopReleasesJson = await response.json();
+  return (0, import_type_guards.ensureNonNullable)(desktopReleasesJson.latestVersion, "Could not find the latest desktop Obsidian version");
+}
+async function getPluginReleaseAssetPaths() {
+  const buildFolder = (0, import_root.resolvePathFromRootSafe)({ path: import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.DistBuild });
+  const fileNames = await (0, import_fs.readdirPosix)(buildFolder);
+  return fileNames.map((fileName) => (0, import_path.join)(buildFolder, fileName));
+}
+async function updateVersionInFilesForPlugin(newVersion, minAppVersion) {
+  const manifestBetaJsonPath = (0, import_root.resolvePathFromRootSafe)({ path: import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.ManifestBetaJson });
+  if ((0, import_version.isPreRelease)(newVersion)) {
+    await (0, import_promises.cp)(
+      (0, import_root.resolvePathFromRootSafe)({ path: import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.ManifestJson }),
+      manifestBetaJsonPath,
+      { force: true }
+    );
+    await (0, import_json.editJson)({
+      editFunction: (manifest) => {
+        manifest.version = newVersion;
+      },
+      path: import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.ManifestBetaJson
+    });
+  } else {
+    const resolvedMinAppVersion = minAppVersion ?? await getLatestObsidianVersion();
+    await (0, import_json.editJson)({
+      editFunction: (manifest) => {
+        manifest.minAppVersion = resolvedMinAppVersion;
+        manifest.version = newVersion;
+      },
+      path: import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.ManifestJson
+    });
+    await (0, import_json.editJson)({
+      editFunction: (versions) => {
+        versions[newVersion] = resolvedMinAppVersion;
+      },
+      path: import_obsidian_plugin_repo_paths.ObsidianPluginRepoPaths.VersionsJson
+    });
+    if ((0, import_node_fs.existsSync)(manifestBetaJsonPath)) {
+      await (0, import_promises.rm)(manifestBetaJsonPath);
+    }
+  }
+  await copyUpdatedManifest();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  copyUpdatedManifest,
+  parseVersionArguments,
+  updateVersion
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3ZlcnNpb24udHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBSZWxlYXNlcyBhbiBPYnNpZGlhbiBwbHVnaW46IHRoZSBnZW5lcmljIHJlbGVhc2UgZnJvbSBgQG1uYW91bW92L3R5cGVzY3JpcHQtZGV2LXRvb2xraXQvdmVyc2lvbmAsIHBsdXMgd2hhdCBvbmx5IGFcbiAqIHBsdWdpbiBoYXMgXHUyMDE0IGBtYW5pZmVzdC5qc29uYCAoYW5kIGBtYW5pZmVzdC1iZXRhLmpzb25gIGZvciBhIHByZS1yZWxlYXNlKSBhbmQgYHZlcnNpb25zLmpzb25gIGJ1bXBlZCB3aXRoIHRoZVxuICogcGx1Z2luJ3MgYG1pbkFwcFZlcnNpb25gLCB0aGUgdXBkYXRlZCBtYW5pZmVzdCBjb3BpZWQgaW50byBgZGlzdC9idWlsZGAsIHRoZSBkZW1vIHZhdWx0IGFyY2hpdmVkIGFzIGEgcmVsZWFzZVxuICogYXNzZXQsIGFuZCB0aGUgZmlsZXMgaW4gYGRpc3QvYnVpbGRgIGF0dGFjaGVkIHRvIHRoZSBHaXRIdWIgcmVsZWFzZSBpbnN0ZWFkIG9mIGFuIGBucG0gcGFja2AgdGFyYmFsbC5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIFBhcnNlZFZlcnNpb25Bcmd1bWVudHMgYXMgR2VuZXJpY1BhcnNlZFZlcnNpb25Bcmd1bWVudHMsXG4gIFVwZGF0ZVZlcnNpb25PcHRpb25zIGFzIEdlbmVyaWNVcGRhdGVWZXJzaW9uT3B0aW9uc1xufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1kZXYtdG9vbGtpdC92ZXJzaW9uJztcblxuaW1wb3J0IHsgcmVhZGRpclBvc2l4IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtZGV2LXRvb2xraXQvZnMnO1xuaW1wb3J0IHsgZWRpdEpzb24gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1kZXYtdG9vbGtpdC9qc29uJztcbmltcG9ydCB7IHJlc29sdmVQYXRoRnJvbVJvb3RTYWZlIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtZGV2LXRvb2xraXQvcm9vdCc7XG5pbXBvcnQge1xuICBpc1ByZVJlbGVhc2UsXG4gIHRvVXBkYXRlVmVyc2lvbk9wdGlvbnMsXG4gIHVwZGF0ZVZlcnNpb24gYXMgdXBkYXRlVmVyc2lvbkdlbmVyaWMsXG4gIFZFUlNJT05fQVJHVU1FTlRfT1BUSU9OU1xufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1kZXYtdG9vbGtpdC92ZXJzaW9uJztcbmltcG9ydCB7IGpvaW4gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvcGF0aCc7XG5pbXBvcnQgeyBlbnN1cmVOb25OdWxsYWJsZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi90eXBlLWd1YXJkcyc7XG5pbXBvcnQgeyBleGlzdHNTeW5jIH0gZnJvbSAnbm9kZTpmcyc7XG5pbXBvcnQge1xuICBjcCxcbiAgcm1cbn0gZnJvbSAnbm9kZTpmcy9wcm9taXNlcyc7XG5pbXBvcnQgeyBwYXJzZUFyZ3MgfSBmcm9tICdub2RlOnV0aWwnO1xuXG5pbXBvcnQgeyBhcmNoaXZlUGx1Z2luRGVtb1ZhdWx0IH0gZnJvbSAnLi9kZW1vLXZhdWx0LnRzJztcbmltcG9ydCB7IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzIH0gZnJvbSAnLi9vYnNpZGlhbi1wbHVnaW4tcmVwby1wYXRocy50cyc7XG5cbi8qKlxuICogVHlwZSByZXByZXNlbnRpbmcgdGhlIHN0cnVjdHVyZSBvZiBPYnNpZGlhbidzIGBkZXNrdG9wLXJlbGVhc2VzLmpzb25gIGZlZWQuXG4gKlxuICogVGhpcyBpcyB0aGUgZmVlZCB0aGUgZGVza3RvcCBhcHAgaXRzZWxmIHVwZGF0ZXMgZnJvbSwgc28gaXQgaXMgdGhlIG9ubHkgc291cmNlIHRoYXQgc3RhdGVzIGEgdmVyc2lvblxuICogZGVza3RvcCB1c2VycyBjYW4gYWN0dWFsbHkgcnVuLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlc2t0b3BSZWxlYXNlc0pzb24ge1xuICAvKipcbiAgICogVGhlIGxhdGVzdCBPYnNpZGlhbiB2ZXJzaW9uIGF2YWlsYWJsZSBmb3IgZGVza3RvcC5cbiAgICovXG4gIGxhdGVzdFZlcnNpb246IHN0cmluZztcbn1cblxuLyoqXG4gKiBUeXBlIHJlcHJlc2VudGluZyB0aGUgbWFuaWZlc3QgZmlsZSBmb3JtYXQgZm9yIE9ic2lkaWFuIHBsdWdpbnMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTWFuaWZlc3Qge1xuICAvKipcbiAgICogQSBtaW5pbXVtIE9ic2lkaWFuIHZlcnNpb24gcmVxdWlyZWQgZm9yIHRoZSBwbHVnaW4uXG4gICAqL1xuICBtaW5BcHBWZXJzaW9uOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEEgdmVyc2lvbiBvZiB0aGUgcGx1Z2luLlxuICAgKi9cbiAgdmVyc2lvbjogc3RyaW5nO1xufVxuLyoqXG4gKiBUaGUgcmVzdWx0IG9mIHBhcnNpbmcgdGhlIGNvbW1hbmQtbGluZSBhcmd1bWVudHMgZm9yIGEgcGx1Z2luIHJlbGVhc2UuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUGFyc2VkVmVyc2lvbkFyZ3VtZW50cyBleHRlbmRzIEdlbmVyaWNQYXJzZWRWZXJzaW9uQXJndW1lbnRzIHtcbiAgLyoqXG4gICAqIFRoZSB7QGxpbmsgVXBkYXRlVmVyc2lvbk9wdGlvbnN9IHBhcnNlZCBmcm9tIHRoZSBmbGFncy5cbiAgICovXG4gIHJlYWRvbmx5IG9wdGlvbnM6IFVwZGF0ZVZlcnNpb25PcHRpb25zO1xufVxuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHtAbGluayB1cGRhdGVWZXJzaW9ufTogdGhlIGdlbmVyaWMgcmVsZWFzZSBvcHRpb25zIHBsdXMgdGhlIHBsdWdpbidzIG93bi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBVcGRhdGVWZXJzaW9uT3B0aW9ucyBleHRlbmRzIEdlbmVyaWNVcGRhdGVWZXJzaW9uT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBBbiBleHBsaWNpdCBgbWluQXBwVmVyc2lvbmAgdG8gd3JpdGUgaW50byB0aGUgcGx1Z2luJ3MgYG1hbmlmZXN0Lmpzb25gIGFuZCBpdHMgbmV3IGB2ZXJzaW9ucy5qc29uYFxuICAgKiBlbnRyeS4gV2hlbiBzZXQsIGl0IGlzIHVzZWQgdmVyYmF0aW0gYW5kIHRoZSBsYXRlc3QgT2JzaWRpYW4gZGVza3RvcCB2ZXJzaW9uIGlzIG5vdCBmZXRjaGVkIGF0IGFsbC5cbiAgICpcbiAgICogU2V0IHRoaXMgd2hlbiB0aGUgcGx1Z2luIGhhcyBhIGtub3duIG1pbmltdW0gaXQgYWN0dWFsbHkgcmVxdWlyZXMsIHJhdGhlciB0aGFuIHRyYWNraW5nIHdoYXRldmVyXG4gICAqIE9ic2lkaWFuIHJlbGVhc2VkIG1vc3QgcmVjZW50bHkuIE9ubHkgYXBwbGllcyB0byBub24tcHJlLXJlbGVhc2UgdmVyc2lvbnMgKGEgcHJlLXJlbGVhc2UgY29waWVzIHRoZVxuICAgKiBleGlzdGluZyBgbWFuaWZlc3QuanNvbmAgYW5kIG5ldmVyIHdyaXRlcyBgbWluQXBwVmVyc2lvbmApLlxuICAgKlxuICAgKiBAZGVmYXVsdCB0aGUgbGF0ZXN0IE9ic2lkaWFuIGRlc2t0b3AgdmVyc2lvblxuICAgKi9cbiAgcmVhZG9ubHkgbWluQXBwVmVyc2lvbj86IHN0cmluZyB8IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogV2hldGhlciB0byBhcmNoaXZlIHRoZSBwbHVnaW4ncyBkZW1vIHZhdWx0IChgZGVtby12YXVsdC9gIGluIHRoZSByZXBvIHJvb3QpIGFzIGEgcmVsZWFzZSBhcnRpZmFjdC4gSWdub3JlZFxuICAgKiB3aGVuIHRoZSByZXBvIGhhcyBubyBgZGVtby12YXVsdC9gIGZvbGRlci5cbiAgICpcbiAgICogQGRlZmF1bHQgYHRydWVgXG4gICAqL1xuICByZWFkb25seSBzaG91bGRBcmNoaXZlRGVtb1ZhdWx0PzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBUaGUgZmVlZCB0aGUgT2JzaWRpYW4gZGVza3RvcCBhcHAgdXBkYXRlcyBmcm9tLlxuICpcbiAqIERlbGliZXJhdGVseSBOT1QgdGhlIEdpdEh1YiBgcmVsZWFzZXMvbGF0ZXN0YCBBUEk6IHRoYXQgZW5kcG9pbnQgcmV0dXJucyB0aGUgbmV3ZXN0IHJlbGVhc2Ugb2YgYW55IGtpbmRcbiAqIGluIGBvYnNpZGlhbm1kL29ic2lkaWFuLXJlbGVhc2VzYCwgaW5jbHVkaW5nIG9uZSB3aG9zZSBvbmx5IGFzc2V0IGlzIHRoZSBBbmRyb2lkIEFQSywgd2hpY2ggbm8gZGVza3RvcFxuICogdXNlciBjYW4gaW5zdGFsbC4gU2VlIHtAbGluayBnZXRMYXRlc3RPYnNpZGlhblZlcnNpb259LlxuICovXG5jb25zdCBERVNLVE9QX1JFTEVBU0VTX0pTT05fVVJMID0gJ2h0dHBzOi8vcmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbS9vYnNpZGlhbm1kL29ic2lkaWFuLXJlbGVhc2VzL21hc3Rlci9kZXNrdG9wLXJlbGVhc2VzLmpzb24nO1xuXG4vKipcbiAqIENvcGllcyB0aGUgdXBkYXRlZCBtYW5pZmVzdCBmaWxlIHRvIHRoZSBkaXN0cmlidXRpb24gYnVpbGQgZm9sZGVyLlxuICpcbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgY29weSBvcGVyYXRpb24gaXMgY29tcGxldGUuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBjb3B5VXBkYXRlZE1hbmlmZXN0KCk6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCBjcChcbiAgICByZXNvbHZlUGF0aEZyb21Sb290U2FmZSh7IHBhdGg6IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hbmlmZXN0SnNvbiB9KSxcbiAgICByZXNvbHZlUGF0aEZyb21Sb290U2FmZSh7IHBhdGg6IGpvaW4oT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuRGlzdEJ1aWxkLCBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYW5pZmVzdEpzb24pIH0pLFxuICAgIHsgZm9yY2U6IHRydWUgfVxuICApO1xufVxuXG4vKipcbiAqIFBhcnNlcyB0aGUgY29tbWFuZC1saW5lIGFyZ3VtZW50cyBmb3IgYSBwbHVnaW4gcmVsZWFzZTogZXZlcnkgZmxhZyB0aGUgZ2VuZXJpYyBgcGFyc2VWZXJzaW9uQXJndW1lbnRzYFxuICogcmVjb2duaXplcywgcGx1cyB0d28gb2YgdGhlIHBsdWdpbidzIG93bjpcbiAqIC0gYC0tbWluLWFwcC12ZXJzaW9uPTx4Lnkuej5gIFx1MjAxNCB3cml0ZSB0aGlzIGBtaW5BcHBWZXJzaW9uYCBpbnRvIHRoZSBwbHVnaW4ncyBgbWFuaWZlc3QuanNvbmAgYW5kIGl0cyBuZXdcbiAqICAgYHZlcnNpb25zLmpzb25gIGVudHJ5IGluc3RlYWQgb2YgdHJhY2tpbmcgdGhlIGxhdGVzdCBPYnNpZGlhbiBkZXNrdG9wIHZlcnNpb24uXG4gKiAtIGAtLW5vLWRlbW8tdmF1bHRgIFx1MjAxNCBza2lwIGFyY2hpdmluZyB0aGUgcGx1Z2luJ3MgZGVtbyB2YXVsdCAoYGRlbW8tdmF1bHQvYCkgYXMgYSByZWxlYXNlIGFydGlmYWN0LlxuICpcbiAqIEBwYXJhbSAkYXJndW1lbnRzIC0gVGhlIGNvbW1hbmQtbGluZSBhcmd1bWVudHMgdG8gcGFyc2UgKHR5cGljYWxseSBgcHJvY2Vzcy5hcmd2LnNsaWNlKDIpYCkuXG4gKiBAcmV0dXJucyBUaGUge0BsaW5rIFBhcnNlZFZlcnNpb25Bcmd1bWVudHN9IGNvbnRhaW5pbmcgdGhlIHZlcnNpb24gdXBkYXRlIHR5cGUgYW5kIHRoZSBvcHRpb25zLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VWZXJzaW9uQXJndW1lbnRzKCRhcmd1bWVudHM6IHN0cmluZ1tdKTogUGFyc2VkVmVyc2lvbkFyZ3VtZW50cyB7XG4gIGNvbnN0IHsgcG9zaXRpb25hbHMsIHZhbHVlcyB9ID0gcGFyc2VBcmdzKHtcbiAgICBhbGxvd1Bvc2l0aW9uYWxzOiB0cnVlLFxuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSB1bmljb3JuL25hbWUtcmVwbGFjZW1lbnRzIC0tIGBhcmdzYCBpcyB0aGUgb3B0aW9uIG5hbWUgTm9kZSdzIGBwYXJzZUFyZ3NgIHJlYWRzLlxuICAgIGFyZ3M6ICRhcmd1bWVudHMsXG4gICAgb3B0aW9uczoge1xuICAgICAgLi4uVkVSU0lPTl9BUkdVTUVOVF9PUFRJT05TLFxuICAgICAgJ21pbi1hcHAtdmVyc2lvbic6IHsgdHlwZTogJ3N0cmluZycgfSxcbiAgICAgICduby1kZW1vLXZhdWx0JzogeyB0eXBlOiAnYm9vbGVhbicgfVxuICAgIH1cbiAgfSk7XG5cbiAgcmV0dXJuIHtcbiAgICBvcHRpb25zOiB7XG4gICAgICAuLi50b1VwZGF0ZVZlcnNpb25PcHRpb25zKHZhbHVlcyksXG4gICAgICBtaW5BcHBWZXJzaW9uOiB2YWx1ZXNbJ21pbi1hcHAtdmVyc2lvbiddLFxuICAgICAgc2hvdWxkQXJjaGl2ZURlbW9WYXVsdDogISh2YWx1ZXNbJ25vLWRlbW8tdmF1bHQnXSA/PyBmYWxzZSlcbiAgICB9LFxuICAgIHZlcnNpb25VcGRhdGVUeXBlOiBwb3NpdGlvbmFsc1swXVxuICB9O1xufVxuXG4vKipcbiAqIFJlbGVhc2VzIHRoZSBwbHVnaW4uIFNlZSB0aGUgYEBmaWxlYCBvdmVydmlldyBmb3Igd2hhdCBpdCBhZGRzIHRvIHRoZSBnZW5lcmljIHJlbGVhc2UuXG4gKlxuICogQHBhcmFtIHZlcnNpb25VcGRhdGVUeXBlIC0gVGhlIHR5cGUgb2YgdmVyc2lvbiB1cGRhdGUgdG8gcGVyZm9ybSAobWFqb3IsIG1pbm9yLCBwYXRjaCwgcHJlbWFqb3IsIHByZW1pbm9yLCBwcmVwYXRjaCwgcHJlcmVsZWFzZSwgb3IgeC55LnpbLXN1ZmZpeF0pLlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUge0BsaW5rIFVwZGF0ZVZlcnNpb25PcHRpb25zfSBjb250cm9sbGluZyB0aGUgcmVsZWFzZSBiZWhhdmlvci5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgcmVsZWFzZSBpcyBjb21wbGV0ZS5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHVwZGF0ZVZlcnNpb24odmVyc2lvblVwZGF0ZVR5cGU/OiBzdHJpbmcsIG9wdGlvbnM6IFVwZGF0ZVZlcnNpb25PcHRpb25zID0ge30pOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3Qge1xuICAgIG1pbkFwcFZlcnNpb24sXG4gICAgcHJlcGFyZUdpdEh1YlJlbGVhc2UsXG4gICAgc2hvdWxkQXJjaGl2ZURlbW9WYXVsdCA9IHRydWUsXG4gICAgLi4uZ2VuZXJpY09wdGlvbnNcbiAgfSA9IG9wdGlvbnM7XG5cbiAgYXdhaXQgdXBkYXRlVmVyc2lvbkdlbmVyaWModmVyc2lvblVwZGF0ZVR5cGUsIHtcbiAgICAuLi5nZW5lcmljT3B0aW9ucyxcbiAgICBnZXRSZWxlYXNlQXNzZXRQYXRoczogZ2V0UGx1Z2luUmVsZWFzZUFzc2V0UGF0aHMsXG4gICAgYXN5bmMgcHJlcGFyZUdpdEh1YlJlbGVhc2UobmV3VmVyc2lvbjogc3RyaW5nKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgICBhd2FpdCBwcmVwYXJlR2l0SHViUmVsZWFzZT8uKG5ld1ZlcnNpb24pO1xuICAgICAgaWYgKHNob3VsZEFyY2hpdmVEZW1vVmF1bHQpIHtcbiAgICAgICAgYXdhaXQgYXJjaGl2ZVBsdWdpbkRlbW9WYXVsdCgpO1xuICAgICAgfVxuICAgIH0sXG4gICAgYXN5bmMgdXBkYXRlVmVyc2lvbkluRXh0cmFGaWxlcyhuZXdWZXJzaW9uOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICAgIGF3YWl0IHVwZGF0ZVZlcnNpb25JbkZpbGVzRm9yUGx1Z2luKG5ld1ZlcnNpb24sIG1pbkFwcFZlcnNpb24pO1xuICAgIH1cbiAgfSk7XG59XG5cbi8qKlxuICogRmV0Y2hlcyB0aGUgbGF0ZXN0IHZlcnNpb24gb2YgT2JzaWRpYW4gdGhhdCB0aGUgZGVza3RvcCBhcHAgY2FuIGFjdHVhbGx5IHJ1bi5cbiAqXG4gKiBSZWFkcyB7QGxpbmsgREVTS1RPUF9SRUxFQVNFU19KU09OX1VSTH0sIG5vdCB0aGUgR2l0SHViIGByZWxlYXNlcy9sYXRlc3RgIEFQSS4gVGhlIEFQSSByZXR1cm5zIHRoZSBuZXdlc3RcbiAqIHJlbGVhc2Ugb2YgQU5ZIGtpbmQsIHNvIHdoZW5ldmVyIGEgbW9iaWxlLW9ubHkgcmVsZWFzZSAoYW4gQVBLLW9ubHkgYXNzZXQpIGlzIG5ld2VyIHRoYW4gdGhlIGRlc2t0b3Agb25lLFxuICogaXQgcmVwb3J0cyBhIHZlcnNpb24gdGhhdCBkb2VzIG5vdCBleGlzdCBmb3IgZGVza3RvcC4gQSBwbHVnaW4gcmVsZWFzZWQgaW4gdGhhdCB3aW5kb3cgZ2V0cyBhXG4gKiBgbWluQXBwVmVyc2lvbmAgbm8gZGVza3RvcCB1c2VyIGNhbiBzYXRpc2Z5LCBhbmQgT2JzaWRpYW4gc2lsZW50bHkga2VlcHMgb2ZmZXJpbmcgdGhlbSB0aGUgcHJldmlvdXNcbiAqIHJlbGVhc2UgaW5zdGVhZCBcdTIwMTQgdGhlIHJlbGVhc2Ugc3VjY2VlZHMgYW5kIHJlYWNoZXMgbm9ib2R5LlxuICpcbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgdG8gdGhlIGxhdGVzdCBPYnNpZGlhbiB2ZXJzaW9uIGF2YWlsYWJsZSBmb3IgZGVza3RvcC5cbiAqL1xuYXN5bmMgZnVuY3Rpb24gZ2V0TGF0ZXN0T2JzaWRpYW5WZXJzaW9uKCk6IFByb21pc2U8c3RyaW5nPiB7XG4gIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBuby1yZXN0cmljdGVkLWdsb2JhbHMgLS0gV2UgcnVuIHRoaXMgb3V0c2lkZSBvZiBPYnNpZGlhbiwgc28gd2UgZG9uJ3QgaGF2ZSBgcmVxdWVzdFVybCgpYC5cbiAgY29uc3QgcmVzcG9uc2UgPSBhd2FpdCBmZXRjaChERVNLVE9QX1JFTEVBU0VTX0pTT05fVVJMKTtcbiAgY29uc3QgZGVza3RvcFJlbGVhc2VzSnNvbiA9IGF3YWl0IHJlc3BvbnNlLmpzb24oKSBhcyBQYXJ0aWFsPERlc2t0b3BSZWxlYXNlc0pzb24+O1xuICByZXR1cm4gZW5zdXJlTm9uTnVsbGFibGUoZGVza3RvcFJlbGVhc2VzSnNvbi5sYXRlc3RWZXJzaW9uLCAnQ291bGQgbm90IGZpbmQgdGhlIGxhdGVzdCBkZXNrdG9wIE9ic2lkaWFuIHZlcnNpb24nKTtcbn1cbi8qKlxuICogVGhlIHBsdWdpbidzIHJlbGVhc2UgYXNzZXRzOiBldmVyeSBmaWxlIGluIGBkaXN0L2J1aWxkYC5cbiAqXG4gKiBAcmV0dXJucyBUaGUgYXNzZXQgcGF0aHMuXG4gKi9cbmFzeW5jIGZ1bmN0aW9uIGdldFBsdWdpblJlbGVhc2VBc3NldFBhdGhzKCk6IFByb21pc2U8c3RyaW5nW10+IHtcbiAgY29uc3QgYnVpbGRGb2xkZXIgPSByZXNvbHZlUGF0aEZyb21Sb290U2FmZSh7IHBhdGg6IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLkRpc3RCdWlsZCB9KTtcbiAgY29uc3QgZmlsZU5hbWVzID0gYXdhaXQgcmVhZGRpclBvc2l4KGJ1aWxkRm9sZGVyKTtcbiAgcmV0dXJuIGZpbGVOYW1lcy5tYXAoKGZpbGVOYW1lKSA9PiBqb2luKGJ1aWxkRm9sZGVyLCBmaWxlTmFtZSkpO1xufVxuXG5hc3luYyBmdW5jdGlvbiB1cGRhdGVWZXJzaW9uSW5GaWxlc0ZvclBsdWdpbihuZXdWZXJzaW9uOiBzdHJpbmcsIG1pbkFwcFZlcnNpb246IHN0cmluZyB8IHVuZGVmaW5lZCk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCBtYW5pZmVzdEJldGFKc29uUGF0aCA9IHJlc29sdmVQYXRoRnJvbVJvb3RTYWZlKHsgcGF0aDogT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFuaWZlc3RCZXRhSnNvbiB9KTtcbiAgaWYgKGlzUHJlUmVsZWFzZShuZXdWZXJzaW9uKSkge1xuICAgIGF3YWl0IGNwKFxuICAgICAgcmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmUoeyBwYXRoOiBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYW5pZmVzdEpzb24gfSksXG4gICAgICBtYW5pZmVzdEJldGFKc29uUGF0aCxcbiAgICAgIHsgZm9yY2U6IHRydWUgfVxuICAgICk7XG4gICAgYXdhaXQgZWRpdEpzb248TWFuaWZlc3Q+KHtcbiAgICAgIGVkaXRGdW5jdGlvbjogKG1hbmlmZXN0KSA9PiB7XG4gICAgICAgIG1hbmlmZXN0LnZlcnNpb24gPSBuZXdWZXJzaW9uO1xuICAgICAgfSxcbiAgICAgIHBhdGg6IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hbmlmZXN0QmV0YUpzb25cbiAgICB9KTtcbiAgfSBlbHNlIHtcbiAgICBjb25zdCByZXNvbHZlZE1pbkFwcFZlcnNpb24gPSBtaW5BcHBWZXJzaW9uID8/IGF3YWl0IGdldExhdGVzdE9ic2lkaWFuVmVyc2lvbigpO1xuXG4gICAgYXdhaXQgZWRpdEpzb248TWFuaWZlc3Q+KHtcbiAgICAgIGVkaXRGdW5jdGlvbjogKG1hbmlmZXN0KSA9PiB7XG4gICAgICAgIG1hbmlmZXN0Lm1pbkFwcFZlcnNpb24gPSByZXNvbHZlZE1pbkFwcFZlcnNpb247XG4gICAgICAgIG1hbmlmZXN0LnZlcnNpb24gPSBuZXdWZXJzaW9uO1xuICAgICAgfSxcbiAgICAgIHBhdGg6IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hbmlmZXN0SnNvblxuICAgIH0pO1xuXG4gICAgYXdhaXQgZWRpdEpzb248UmVjb3JkPHN0cmluZywgc3RyaW5nPj4oe1xuICAgICAgZWRpdEZ1bmN0aW9uOiAodmVyc2lvbnMpID0+IHtcbiAgICAgICAgdmVyc2lvbnNbbmV3VmVyc2lvbl0gPSByZXNvbHZlZE1pbkFwcFZlcnNpb247XG4gICAgICB9LFxuICAgICAgcGF0aDogT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuVmVyc2lvbnNKc29uXG4gICAgfSk7XG5cbiAgICBpZiAoZXhpc3RzU3luYyhtYW5pZmVzdEJldGFKc29uUGF0aCkpIHtcbiAgICAgIGF3YWl0IHJtKG1hbmlmZXN0QmV0YUpzb25QYXRoKTtcbiAgICB9XG4gIH1cblxuICBhd2FpdCBjb3B5VXBkYXRlZE1hbmlmZXN0KCk7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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QUFVO0FBQUEsTUFDckI7QUFBQSxNQUNBLE1BQU0sMERBQXdCO0FBQUEsSUFDaEMsQ0FBQztBQUFBLEVBQ0gsT0FBTztBQUNMLFVBQU0sd0JBQXdCLGlCQUFpQixNQUFNLHlCQUF5QjtBQUU5RSxjQUFNLHNCQUFtQjtBQUFBLE1BQ3ZCLGNBQWMsQ0FBQyxhQUFhO0FBQzFCLGlCQUFTLGdCQUFnQjtBQUN6QixpQkFBUyxVQUFVO0FBQUEsTUFDckI7QUFBQSxNQUNBLE1BQU0sMERBQXdCO0FBQUEsSUFDaEMsQ0FBQztBQUVELGNBQU0sc0JBQWlDO0FBQUEsTUFDckMsY0FBYyxDQUFDLGFBQWE7QUFDMUIsaUJBQVMsVUFBVSxJQUFJO0FBQUEsTUFDekI7QUFBQSxNQUNBLE1BQU0sMERBQXdCO0FBQUEsSUFDaEMsQ0FBQztBQUVELFlBQUksMkJBQVcsb0JBQW9CLEdBQUc7QUFDcEMsZ0JBQU0sb0JBQUcsb0JBQW9CO0FBQUEsSUFDL0I7QUFBQSxFQUNGO0FBRUEsUUFBTSxvQkFBb0I7QUFDNUI7IiwKICAibmFtZXMiOiBbInVwZGF0ZVZlcnNpb25HZW5lcmljIl0KfQo=

package/dist/lib/cjs/version.d.cts

@@ -0,0 +1,92 @@
+/// <reference path="./index.d.cts" />
+/**
+ * @file
+ *
+ * Releases an Obsidian plugin: the generic release from `@mnaoumov/typescript-dev-toolkit/version`, plus what only a
+ * plugin has — `manifest.json` (and `manifest-beta.json` for a pre-release) and `versions.json` bumped with the
+ * plugin's `minAppVersion`, the updated manifest copied into `dist/build`, the demo vault archived as a release
+ * asset, and the files in `dist/build` attached to the GitHub release instead of an `npm pack` tarball.
+ */
+import type { ParsedVersionArguments as GenericParsedVersionArguments, UpdateVersionOptions as GenericUpdateVersionOptions } from '@mnaoumov/typescript-dev-toolkit/version' with { 'resolution-mode': 'import' };
+/**
+ * Type representing the structure of Obsidian's `desktop-releases.json` feed.
+ *
+ * This is the feed the desktop app itself updates from, so it is the only source that states a version
+ * desktop users can actually run.
+ */
+export interface DesktopReleasesJson {
+    /**
+     * The latest Obsidian version available for desktop.
+     */
+    latestVersion: string;
+}
+/**
+ * Type representing the manifest file format for Obsidian plugins.
+ */
+export interface Manifest {
+    /**
+     * A minimum Obsidian version required for the plugin.
+     */
+    minAppVersion: string;
+    /**
+     * A version of the plugin.
+     */
+    version: string;
+}
+/**
+ * The result of parsing the command-line arguments for a plugin release.
+ */
+export interface ParsedVersionArguments extends GenericParsedVersionArguments {
+    /**
+     * The {@link UpdateVersionOptions} parsed from the flags.
+     */
+    readonly options: UpdateVersionOptions;
+}
+/**
+ * Options for {@link updateVersion}: the generic release options plus the plugin's own.
+ */
+export interface UpdateVersionOptions extends GenericUpdateVersionOptions {
+    /**
+     * An explicit `minAppVersion` to write into the plugin's `manifest.json` and its new `versions.json`
+     * entry. When set, it is used verbatim and the latest Obsidian desktop version is not fetched at all.
+     *
+     * Set this when the plugin has a known minimum it actually requires, rather than tracking whatever
+     * Obsidian released most recently. Only applies to non-pre-release versions (a pre-release copies the
+     * existing `manifest.json` and never writes `minAppVersion`).
+     *
+     * @default the latest Obsidian desktop version
+     */
+    readonly minAppVersion?: string | undefined;
+    /**
+     * Whether to archive the plugin's demo vault (`demo-vault/` in the repo root) as a release artifact. Ignored
+     * when the repo has no `demo-vault/` folder.
+     *
+     * @default `true`
+     */
+    readonly shouldArchiveDemoVault?: boolean;
+}
+/**
+ * Copies the updated manifest file to the distribution build folder.
+ *
+ * @returns A {@link Promise} that resolves when the copy operation is complete.
+ */
+export declare function copyUpdatedManifest(): Promise<void>;
+/**
+ * Parses the command-line arguments for a plugin release: every flag the generic `parseVersionArguments`
+ * recognizes, plus two of the plugin's own:
+ * - `--min-app-version=<x.y.z>` — write this `minAppVersion` into the plugin's `manifest.json` and its new
+ *   `versions.json` entry instead of tracking the latest Obsidian desktop version.
+ * - `--no-demo-vault` — skip archiving the plugin's demo vault (`demo-vault/`) as a release artifact.
+ *
+ * @param $arguments - The command-line arguments to parse (typically `process.argv.slice(2)`).
+ * @returns The {@link ParsedVersionArguments} containing the version update type and the options.
+ */
+export declare function parseVersionArguments($arguments: string[]): ParsedVersionArguments;
+/**
+ * Releases the plugin. See the `@file` overview for what it adds to the generic release.
+ *
+ * @param versionUpdateType - The type of version update to perform (major, minor, patch, premajor, preminor, prepatch, prerelease, or x.y.z[-suffix]).
+ * @param options - The {@link UpdateVersionOptions} controlling the release behavior.
+ * @returns A {@link Promise} that resolves when the release is complete.
+ */
+export declare function updateVersion(versionUpdateType?: string, options?: UpdateVersionOptions): Promise<void>;