@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/templater.cjs

@@ -0,0 +1,303 @@
+/*
+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 templater_exports = {};
+__export(templater_exports, {
+  TEMPLATER_PLUGIN_ID: () => TEMPLATER_PLUGIN_ID,
+  TemplaterActiveFileProvider: () => TemplaterActiveFileProvider,
+  TemplaterRunMode: () => TemplaterRunMode,
+  TemplaterUnavailabilityReason: () => TemplaterUnavailabilityReason,
+  TemplaterUnavailableError: () => TemplaterUnavailableError,
+  getTemplaterFunctions: () => getTemplaterFunctions,
+  getTemplaterRenderTargetFile: () => getTemplaterRenderTargetFile,
+  parseTemplate: () => parseTemplate,
+  requireTemplaterApi: () => requireTemplaterApi,
+  resolveTemplaterApi: () => resolveTemplaterApi
+});
+module.exports = __toCommonJS(templater_exports);
+var import_active_file_provider = require('./active-file-provider.cjs');
+var import_file_system = require('./file-system.cjs');
+const TEMPLATER_PLUGIN_ID = "templater-obsidian";
+var TemplaterRunMode = /* @__PURE__ */ ((TemplaterRunMode2) => {
+  TemplaterRunMode2[TemplaterRunMode2["CreateNewFromTemplate"] = 0] = "CreateNewFromTemplate";
+  TemplaterRunMode2[TemplaterRunMode2["AppendActiveFile"] = 1] = "AppendActiveFile";
+  TemplaterRunMode2[TemplaterRunMode2["OverwriteFile"] = 2] = "OverwriteFile";
+  TemplaterRunMode2[TemplaterRunMode2["OverwriteActiveFile"] = 3] = "OverwriteActiveFile";
+  TemplaterRunMode2[TemplaterRunMode2["DynamicProcessor"] = 4] = "DynamicProcessor";
+  TemplaterRunMode2[TemplaterRunMode2["StartupTemplate"] = 5] = "StartupTemplate";
+  return TemplaterRunMode2;
+})(TemplaterRunMode || {});
+var TemplaterUnavailabilityReason = /* @__PURE__ */ ((TemplaterUnavailabilityReason2) => {
+  TemplaterUnavailabilityReason2["NotLoaded"] = "notLoaded";
+  TemplaterUnavailabilityReason2["ShapeChanged"] = "shapeChanged";
+  return TemplaterUnavailabilityReason2;
+})(TemplaterUnavailabilityReason || {});
+class TemplaterActiveFileProvider extends import_active_file_provider.AppActiveFileProvider {
+  /**
+   * Gets the file the innermost in-flight {@link parseTemplate} render is for, or the workspace's active
+   * file when there is no render in flight.
+   *
+   * @returns The active file, or `null` if there is none.
+   */
+  getActiveFile() {
+    return getTemplaterRenderTargetFile() ?? super.getActiveFile();
+  }
+}
+class TemplaterUnavailableError extends Error {
+  /**
+   * Which of the two failures occurred.
+   */
+  reason;
+  /**
+   * Creates a {@link TemplaterUnavailableError}.
+   *
+   * @param reason - Why the API is unavailable.
+   */
+  constructor(reason) {
+    super(`The internal API of the plugin "${TEMPLATER_PLUGIN_ID}" is unavailable: ${reason}.`);
+    this.name = "TemplaterUnavailableError";
+    this.reason = reason;
+  }
+}
+async function getTemplaterFunctions(params) {
+  const {
+    app,
+    shouldReuseCurrent = true,
+    targetPathOrFile
+  } = params;
+  const api = requireTemplaterApi(app);
+  if (shouldReuseCurrent && api.current_functions_object) {
+    return api.current_functions_object;
+  }
+  const targetFile = (0, import_file_system.getFile)({
+    app,
+    pathOrFile: targetPathOrFile
+  });
+  const config = api.create_running_config(void 0, targetFile, 5 /* StartupTemplate */);
+  return await api.functions_generator.generate_object(config);
+}
+function getTemplaterRenderTargetFile() {
+  return renderTargetFiles.at(-1) ?? null;
+}
+async function parseTemplate(params) {
+  const {
+    app,
+    targetPathOrFile,
+    templatePathOrFile
+  } = params;
+  const templateFile = (0, import_file_system.getFile)({
+    app,
+    pathOrFile: templatePathOrFile
+  });
+  const targetFile = (0, import_file_system.getFile)({
+    app,
+    pathOrFile: targetPathOrFile
+  });
+  const api = requireTemplaterApi(app);
+  renderTargetFiles.push(targetFile);
+  try {
+    return await api.read_and_parse_template({
+      // eslint-disable-next-line camelcase -- Templater API.
+      run_mode: 4 /* DynamicProcessor */,
+      // eslint-disable-next-line camelcase -- Templater API.
+      target_file: targetFile,
+      // eslint-disable-next-line camelcase -- Templater API.
+      template_file: templateFile
+    });
+  } finally {
+    renderTargetFiles.pop();
+  }
+}
+function requireTemplaterApi(app) {
+  if (!app.plugins.getPlugin(TEMPLATER_PLUGIN_ID)) {
+    throw new TemplaterUnavailableError("notLoaded" /* NotLoaded */);
+  }
+  const api = resolveTemplaterApi(app);
+  if (!api) {
+    throw new TemplaterUnavailableError("shapeChanged" /* ShapeChanged */);
+  }
+  return api;
+}
+function resolveTemplaterApi(app) {
+  const plugin = app.plugins.getPlugin(TEMPLATER_PLUGIN_ID);
+  if (!plugin || !("templater" in plugin)) {
+    return null;
+  }
+  const templater = plugin.templater;
+  return isTemplaterApi(templater) ? templater : null;
+}
+const renderTargetFiles = [];
+function isTemplaterApi(value) {
+  if (typeof value !== "object" || value === null || !("create_running_config" in value) || typeof value.create_running_config !== "function" || !("read_and_parse_template" in value) || typeof value.read_and_parse_template !== "function" || !("functions_generator" in value)) {
+    return false;
+  }
+  const functionsGenerator = value.functions_generator;
+  return typeof functionsGenerator === "object" && functionsGenerator !== null && "generate_object" in functionsGenerator && typeof functionsGenerator.generate_object === "function";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TEMPLATER_PLUGIN_ID,
+  TemplaterActiveFileProvider,
+  TemplaterRunMode,
+  TemplaterUnavailabilityReason,
+  TemplaterUnavailableError,
+  getTemplaterFunctions,
+  getTemplaterRenderTargetFile,
+  parseTemplate,
+  requireTemplaterApi,
+  resolveTemplaterApi
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3RlbXBsYXRlci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBzbGljZSBvZiBUZW1wbGF0ZXIncyBJTlRFUk5BTCBBUEkgdGhpcyBsaWJyYXJ5IHRhbGtzIHRvLCBhbmQgdGhlIHJ1bnRpbWUgbmFycm93aW5nIHRoYXQgZ2V0cyBob2xkXG4gKiBvZiBpdC5cbiAqXG4gKiAqKlRlbXBsYXRlciBwdWJsaXNoZXMgbm8gQVBJLioqIFJlbmRlcmluZyBhIHRlbXBsYXRlIGFnYWluc3QgYSBmaWxlIGFuZCBnZXR0aW5nIHRoZSByZXN1bHRpbmcgc3RyaW5nXG4gKiBiYWNrIGlzIG9ubHkgcmVhY2hhYmxlIHRocm91Z2ggdW5kb2N1bWVudGVkIGludGVybmFscyBoYW5naW5nIG9mZlxuICogYGFwcC5wbHVnaW5zLmdldFBsdWdpbigndGVtcGxhdGVyLW9ic2lkaWFuJykudGVtcGxhdGVyYCBcdTIwMTQgYGNyZWF0ZV9ydW5uaW5nX2NvbmZpZ2AsXG4gKiBgZnVuY3Rpb25zX2dlbmVyYXRvci5nZW5lcmF0ZV9vYmplY3RgLCBgcmVhZF9hbmRfcGFyc2VfdGVtcGxhdGVgLCBhbmQgYSBgUnVuTW9kZWAgZW51bS4gRXZlcnkgcGx1Z2luXG4gKiB0aGF0IHdhbnRzIGl0IHJlLWRlcml2ZXMgdGhlIHNhbWUgcmV2ZXJzZSBlbmdpbmVlcmluZywgd2hpY2ggaXMgd2h5IGl0IGxpdmVzIGhlcmUgaW5zdGVhZC5cbiAqXG4gKiAqKlRoaXMgbW9kdWxlIGlzIGV4cGxpY2l0bHkgQkVTVC1FRkZPUlQuKiogTm90aGluZyBpdCBiaW5kcyB0byBpcyBkb2N1bWVudGVkIG9yIGNvdmVyZWQgYnkgVGVtcGxhdGVyJ3NcbiAqIHNlbWFudGljIHZlcnNpb25pbmcsIHNvIGEgVGVtcGxhdGVyIHJlbGVhc2UgbWF5IHJlbmFtZSBvciByZXNoYXBlIGFueSBvZiBpdCB3aXRob3V0IHdhcm5pbmcuIFRoZSBzaGFwZXNcbiAqIGJlbG93IHdlcmUgcmVhZCBmcm9tIFRlbXBsYXRlciBgMi4yNC4zYC4gVHdvIGRlbGliZXJhdGUgY29uc2VxdWVuY2VzIGZvbGxvdzpcbiAqXG4gKiAtIHtAbGluayByZXNvbHZlVGVtcGxhdGVyQXBpfSByZXR1cm5zIGBudWxsYCBcdTIwMTQgYSBUZW1wbGF0ZXIgdG9vIG9sZCwgdG9vIG5ldyBvciB0b28gYnJva2VuIHRvIHRhbGsgdG9cbiAqICAgcmVhZHMgYXMgXCJub3QgdGhlcmVcIiBhbmQgdGhlIGludGVncmF0aW9uIHN0YXlzIGRvcm1hbnQuXG4gKiAtIHtAbGluayByZXF1aXJlVGVtcGxhdGVyQXBpfSB0aHJvd3MgYSB7QGxpbmsgVGVtcGxhdGVyVW5hdmFpbGFibGVFcnJvcn0gdGhhdCBOQU1FUyB0aGUgcGx1Z2luIGFuZCB0aGVcbiAqICAgcmVhc29uLCByYXRoZXIgdGhhbiBsZXR0aW5nIGEgYENhbm5vdCByZWFkIHByb3BlcnRpZXMgb2YgdW5kZWZpbmVkYCBzdXJmYWNlIGZyb20gc29tZXdoZXJlIGluc2lkZVxuICogICBUZW1wbGF0ZXIuXG4gKlxuICogVGhlIHR5cGVzIGFyZSBERUNMQVJFRCBIRVJFIHJhdGhlciB0aGFuIGltcG9ydGVkLCBhbmQgbmFycm93ZWQgdG8gdGhlIG1lbWJlcnMgYWN0dWFsbHkgY2FsbGVkOiBUZW1wbGF0ZXJcbiAqIHNoaXBzIG5vIG5wbSB0eXBlcyBwYWNrYWdlLCBhbmQgZGVwZW5kaW5nIG9uIGl0IHdvdWxkIHR1cm4gYW4gb3B0aW9uYWwgaW50ZWdyYXRpb24gaW50byBhIGJ1aWxkLXRpbWVcbiAqIGRlcGVuZGVuY3kuXG4gKlxuICogVGhlIHNlY29uZCB0aGluZyB0aGlzIG1vZHVsZSBzdXBwbGllcyBpcyBhbiBhY3RpdmUtZmlsZSBhbnN3ZXIuIFdoaWxlIGEgdGVtcGxhdGUgcmVuZGVycyxcbiAqIGBhcHAud29ya3NwYWNlLmdldEFjdGl2ZUZpbGUoKWAgc3RpbGwgcG9pbnRzIGF0IHdoYXRldmVyIHRoZSB1c2VyIGhhcHBlbnMgdG8gaGF2ZSBvcGVuIFx1MjAxNCBOT1QgYXQgdGhlIGZpbGVcbiAqIHRoZSB0ZW1wbGF0ZSBpcyBiZWluZyByZW5kZXJlZCBmb3IgXHUyMDE0IHNvIGEgcGx1Z2luJ3Mgb3duIGhlbHBlciBjYWxsZWQgZnJvbSBpbnNpZGUgYSB0ZW1wbGF0ZSByZXNvbHZlc1xuICogbGlua3MgYWdhaW5zdCB0aGUgd3Jvbmcgbm90ZS4ge0BsaW5rIFRlbXBsYXRlckFjdGl2ZUZpbGVQcm92aWRlcn0gYW5zd2VycyB3aXRoIHRoZSByZW5kZXIgdGFyZ2V0IGZvciB0aGVcbiAqIGR1cmF0aW9uIG9mIGEge0BsaW5rIHBhcnNlVGVtcGxhdGV9IGNhbGwgYW5kIGZhbGxzIGJhY2sgdG8gdGhlIHdvcmtzcGFjZSBvdGhlcndpc2UuIE5vdGUgdGhpcyBpcyBhYm91dFxuICogdGhlIENPTlNVTUVSJ3MgaGVscGVyczogVGVtcGxhdGVyJ3Mgb3duIGB0cC5maWxlLipgIGFscmVhZHkgcmVzb2x2ZXMgdGhyb3VnaCB0aGUgcnVubmluZyBjb25maWcnc1xuICogYHRhcmdldF9maWxlYCBhbmQgbmVlZHMgbm8gaGVscC5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIEFwcCxcbiAgVEZpbGVcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IFBhdGhPckZpbGUgfSBmcm9tICcuL2ZpbGUtc3lzdGVtLnRzJztcblxuaW1wb3J0IHsgQXBwQWN0aXZlRmlsZVByb3ZpZGVyIH0gZnJvbSAnLi9hY3RpdmUtZmlsZS1wcm92aWRlci50cyc7XG5pbXBvcnQgeyBnZXRGaWxlIH0gZnJvbSAnLi9maWxlLXN5c3RlbS50cyc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGdldFRlbXBsYXRlckZ1bmN0aW9uc30uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgR2V0VGVtcGxhdGVyRnVuY3Rpb25zUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogV2hldGhlciB0byByZXR1cm4gVGVtcGxhdGVyJ3MgYGN1cnJlbnRfZnVuY3Rpb25zX29iamVjdGAgd2hlbiBpdCBhbHJlYWR5IGhhcyBvbmUsIGluc3RlYWQgb2ZcbiAgICogZ2VuZXJhdGluZyBhIGZyZXNoIG9iamVjdC4gUmV1c2UgaXMgY2hlYXBlciBhbmQgZ2l2ZXMgdGhlIG9iamVjdCBvZiB0aGUgcmVuZGVyIGN1cnJlbnRseSBpbiBmbGlnaHQ7XG4gICAqIHBhc3MgYGZhbHNlYCB0byBmb3JjZSBhIG5ldyBvbmUgYnVpbHQgZm9yIGB0YXJnZXRQYXRoT3JGaWxlYC5cbiAgICpcbiAgICogQGRlZmF1bHQgYHRydWVgXG4gICAqL1xuICByZWFkb25seSBzaG91bGRSZXVzZUN1cnJlbnQ/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgZmlsZSB0aGUgZ2VuZXJhdGVkIGZ1bmN0aW9ucyBzaG91bGQgcmVzb2x2ZSBhZ2FpbnN0IFx1MjAxNCB3aGF0IGB0cC5maWxlLipgIHJlcG9ydHMuXG4gICAqL1xuICByZWFkb25seSB0YXJnZXRQYXRoT3JGaWxlOiBQYXRoT3JGaWxlO1xufVxuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayBwYXJzZVRlbXBsYXRlfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQYXJzZVRlbXBsYXRlUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogVGhlIGZpbGUgdGhlIHRlbXBsYXRlIGlzIHJlbmRlcmVkIEZPUi4gSXQgaXMgd2hhdCBgdHAuZmlsZS4qYCByZXNvbHZlcyB0byBpbnNpZGUgdGhlIHRlbXBsYXRlLCBhbmRcbiAgICogd2hhdCB7QGxpbmsgVGVtcGxhdGVyQWN0aXZlRmlsZVByb3ZpZGVyfSByZXBvcnRzIGZvciB0aGUgZHVyYXRpb24gb2YgdGhlIGNhbGwuXG4gICAqL1xuICByZWFkb25seSB0YXJnZXRQYXRoT3JGaWxlOiBQYXRoT3JGaWxlO1xuXG4gIC8qKlxuICAgKiBUaGUgdGVtcGxhdGUgZmlsZSB0byByZW5kZXIuXG4gICAqL1xuICByZWFkb25seSB0ZW1wbGF0ZVBhdGhPckZpbGU6IFBhdGhPckZpbGU7XG59XG5cbi8qKlxuICogVGVtcGxhdGVyJ3MgaW50ZXJuYWwgQVBJIG9iamVjdCwgbmFycm93ZWQgdG8gdGhlIG1lbWJlcnMgdGhpcyBsaWJyYXJ5IGNhbGxzLlxuICpcbiAqIEl0cyBtZW1iZXJzIGFyZSBgc25ha2VfY2FzZWAgYmVjYXVzZSBUZW1wbGF0ZXIncyBhcmU7IHRoZXkgYXJlIHRyYW5zY3JpYmVkIHJhdGhlciB0aGFuIHJlbmFtZWQgc28gdGhlXG4gKiBzaGFwZSBjYW4gYmUgY2hlY2tlZCBhZ2FpbnN0IFRlbXBsYXRlcidzIHNvdXJjZSBhdCBhIGdsYW5jZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUZW1wbGF0ZXJBcGkge1xuICAvKipcbiAgICogQnVpbGRzIHRoZSB7QGxpbmsgVGVtcGxhdGVyUnVubmluZ0NvbmZpZ30gdGhhdCBkZXNjcmliZXMgb25lIHJlbmRlci5cbiAgICpcbiAgICogQHBhcmFtIHRlbXBsYXRlRmlsZSAtIFRoZSB0ZW1wbGF0ZSBiZWluZyByZW5kZXJlZCwgb3IgYHVuZGVmaW5lZGAgd2hlbiB0aGVyZSBpcyBub25lIChhcyB3aGVuIG9ubHlcbiAgICogdGhlIGZ1bmN0aW9ucyBvYmplY3QgaXMgd2FudGVkKS5cbiAgICogQHBhcmFtIHRhcmdldEZpbGUgLSBUaGUgZmlsZSB0aGUgcmVuZGVyIGlzIGZvci5cbiAgICogQHBhcmFtIHJ1bk1vZGUgLSBXaGljaCB7QGxpbmsgVGVtcGxhdGVyUnVuTW9kZX0gdGhlIHJlbmRlciBpcy5cbiAgICogQHJldHVybnMgVGhlIHJ1bm5pbmcgY29uZmlnLlxuICAgKi9cbiAgY3JlYXRlX3J1bm5pbmdfY29uZmlnOiAodGVtcGxhdGVGaWxlOiBURmlsZSB8IHVuZGVmaW5lZCwgdGFyZ2V0RmlsZTogVEZpbGUsIHJ1bk1vZGU6IFRlbXBsYXRlclJ1bk1vZGUpID0+IFRlbXBsYXRlclJ1bm5pbmdDb25maWc7XG5cbiAgLyoqXG4gICAqIFRoZSBmdW5jdGlvbnMgb2JqZWN0IChgdHBgKSBvZiB0aGUgcmVuZGVyIGN1cnJlbnRseSBpbiBmbGlnaHQsIHdoZW4gdGhlcmUgaXMgb25lLlxuICAgKi9cbiAgY3VycmVudF9mdW5jdGlvbnNfb2JqZWN0Pzogb2JqZWN0IHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBCdWlsZHMgdGhlIGZ1bmN0aW9ucyBvYmplY3QgKGB0cGApIGEgdGVtcGxhdGUgaXMgZXZhbHVhdGVkIGFnYWluc3QuXG4gICAqL1xuICBmdW5jdGlvbnNfZ2VuZXJhdG9yOiBUZW1wbGF0ZXJGdW5jdGlvbnNHZW5lcmF0b3I7XG5cbiAgLyoqXG4gICAqIFJlYWRzIHRoZSBjb25maWcncyBgdGVtcGxhdGVfZmlsZWAgYW5kIHJlbmRlcnMgaXQsIHJldHVybmluZyB0aGUgcmVzdWx0aW5nIHRleHQuXG4gICAqXG4gICAqIEBwYXJhbSBjb25maWcgLSBUaGUge0BsaW5rIFRlbXBsYXRlclJ1bm5pbmdDb25maWd9IGRlc2NyaWJpbmcgdGhlIHJlbmRlci4gVGVtcGxhdGVyIHRocm93cyB3aGVuIGl0c1xuICAgKiBgdGVtcGxhdGVfZmlsZWAgaXMgbm90IGEgYFRGaWxlYC5cbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gcmVzb2x2aW5nIHRvIHRoZSByZW5kZXJlZCB0ZXh0LlxuICAgKi9cbiAgcmVhZF9hbmRfcGFyc2VfdGVtcGxhdGU6IChjb25maWc6IFRlbXBsYXRlclJ1bm5pbmdDb25maWcpID0+IFByb21pc2U8c3RyaW5nPjtcbn1cblxuLyoqXG4gKiBUaGUgYGZ1bmN0aW9uc19nZW5lcmF0b3JgIGhhbGYgb2Yge0BsaW5rIFRlbXBsYXRlckFwaX0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVGVtcGxhdGVyRnVuY3Rpb25zR2VuZXJhdG9yIHtcbiAgLyoqXG4gICAqIEJ1aWxkcyB0aGUgZnVuY3Rpb25zIG9iamVjdCAoYHRwYCkgZm9yIGEgcnVubmluZyBjb25maWcuXG4gICAqXG4gICAqIEBwYXJhbSBjb25maWcgLSBUaGUge0BsaW5rIFRlbXBsYXRlclJ1bm5pbmdDb25maWd9IHRvIGJ1aWxkIGZvci5cbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gcmVzb2x2aW5nIHRvIHRoZSBmdW5jdGlvbnMgb2JqZWN0LlxuICAgKi9cbiAgZ2VuZXJhdGVfb2JqZWN0OiAoY29uZmlnOiBUZW1wbGF0ZXJSdW5uaW5nQ29uZmlnKSA9PiBQcm9taXNlPG9iamVjdD47XG59XG5cbi8qKlxuICogT25lIFRlbXBsYXRlciByZW5kZXIsIGFzIFRlbXBsYXRlcidzIGBjcmVhdGVfcnVubmluZ19jb25maWdgIGRlc2NyaWJlcyBpdC5cbiAqXG4gKiBJdHMgbWVtYmVycyBhcmUgYHNuYWtlX2Nhc2VgIGJlY2F1c2UgVGVtcGxhdGVyJ3MgYXJlLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRlbXBsYXRlclJ1bm5pbmdDb25maWcge1xuICAvKipcbiAgICogVGhlIGZpbGUgVGVtcGxhdGVyIGNvbnNpZGVycyBhY3RpdmUuIFRlbXBsYXRlciBmaWxscyB0aGlzIGluIGl0c2VsZiBmcm9tXG4gICAqIGB3b3Jrc3BhY2UuYWN0aXZlRWRpdG9yPy5maWxlID8/IHdvcmtzcGFjZS5nZXRBY3RpdmVGaWxlKClgOyBpdCBpcyBvcHRpb25hbCBoZXJlIGJlY2F1c2UgYVxuICAgKiBoYW5kLWJ1aWx0IGNvbmZpZyBtYXkgb21pdCBpdC5cbiAgICovXG4gIGFjdGl2ZV9maWxlPzogbnVsbCB8IFRGaWxlIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBXaGljaCB7QGxpbmsgVGVtcGxhdGVyUnVuTW9kZX0gdGhlIHJlbmRlciBpcy5cbiAgICovXG4gIHJ1bl9tb2RlOiBUZW1wbGF0ZXJSdW5Nb2RlO1xuXG4gIC8qKlxuICAgKiBUaGUgZmlsZSB0aGUgcmVuZGVyIGlzIGZvciBcdTIwMTQgd2hhdCBgdHAuZmlsZS4qYCByZXNvbHZlcyB0by5cbiAgICovXG4gIHRhcmdldF9maWxlOiBURmlsZTtcblxuICAvKipcbiAgICogVGhlIHRlbXBsYXRlIGJlaW5nIHJlbmRlcmVkLCB3aGVuIHRoZXJlIGlzIG9uZS5cbiAgICovXG4gIHRlbXBsYXRlX2ZpbGU/OiBURmlsZSB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBUZW1wbGF0ZXIncyBwbHVnaW4gaWQsIGFzIGl0cyBtYW5pZmVzdCBkZWNsYXJlcyBpdC5cbiAqL1xuZXhwb3J0IGNvbnN0IFRFTVBMQVRFUl9QTFVHSU5fSUQgPSAndGVtcGxhdGVyLW9ic2lkaWFuJztcblxuLyogZXNsaW50LWRpc2FibGUgbm8tbWFnaWMtbnVtYmVycyAtLSBUaGVzZSBhcmUgVGVtcGxhdGVyJ3Mgb3duIGBSdW5Nb2RlYCB2YWx1ZXMsIHRyYW5zY3JpYmVkLiAqL1xuLyoqXG4gKiBUZW1wbGF0ZXIncyBgUnVuTW9kZWAgZW51bSwgd2hpY2ggc2F5cyB3aGF0IGtpbmQgb2YgcmVuZGVyIGEge0BsaW5rIFRlbXBsYXRlclJ1bm5pbmdDb25maWd9IGRlc2NyaWJlcy5cbiAqXG4gKiBUaGUgbnVtZXJpYyB2YWx1ZXMgQVJFIFRlbXBsYXRlcidzLCBhbmQgdGhlIG1lbWJlcnMgYXJlIGxpc3RlZCBpbiBpdHMgZGVjbGFyYXRpb24gb3JkZXIgc28gdGhlIHR3byBjYW5cbiAqIGJlIGNvbXBhcmVkIGxpbmUgZm9yIGxpbmUuIFRoZXkgYXJlIHdyaXR0ZW4gb3V0IGV4cGxpY2l0bHkgYWxsIHRoZSBzYW1lLCBiZWNhdXNlIHRoZXkgY3Jvc3MgaW50b1xuICogVGVtcGxhdGVyIGFzIGludGVnZXJzIFx1MjAxNCBuZXZlciByZW51bWJlciB0aGVtLlxuICovXG5leHBvcnQgZW51bSBUZW1wbGF0ZXJSdW5Nb2RlIHtcbiAgLyoqXG4gICAqIFJlbmRlciB0aGUgdGVtcGxhdGUgaW50byBhIG5ld2x5IGNyZWF0ZWQgZmlsZS5cbiAgICovXG4gIENyZWF0ZU5ld0Zyb21UZW1wbGF0ZSA9IDAsXG5cbiAgLyoqXG4gICAqIFJlbmRlciB0aGUgdGVtcGxhdGUgYW5kIGFwcGVuZCB0aGUgcmVzdWx0IHRvIHRoZSBhY3RpdmUgZmlsZS5cbiAgICovXG4gIEFwcGVuZEFjdGl2ZUZpbGUgPSAxLFxuXG4gIC8qKlxuICAgKiBSZW5kZXIgdGhlIHRlbXBsYXRlIGFuZCBvdmVyd3JpdGUgYSBnaXZlbiBmaWxlIHdpdGggdGhlIHJlc3VsdC5cbiAgICovXG4gIE92ZXJ3cml0ZUZpbGUgPSAyLFxuXG4gIC8qKlxuICAgKiBSZW5kZXIgdGhlIHRlbXBsYXRlIGFuZCBvdmVyd3JpdGUgdGhlIGFjdGl2ZSBmaWxlIHdpdGggdGhlIHJlc3VsdC5cbiAgICovXG4gIE92ZXJ3cml0ZUFjdGl2ZUZpbGUgPSAzLFxuXG4gIC8qKlxuICAgKiBSZW5kZXIgdGhlIHRlbXBsYXRlIG9uIGRlbWFuZCwgZm9yIGEgY2FsbGVyIHRoYXQgd2FudHMgdGhlIHJlc3VsdGluZyB0ZXh0IHJhdGhlciB0aGFuIGEgZmlsZVxuICAgKiB3cml0dGVuLiBUaGlzIGlzIHdoYXQge0BsaW5rIHBhcnNlVGVtcGxhdGV9IHVzZXMuXG4gICAqL1xuICBEeW5hbWljUHJvY2Vzc29yID0gNCxcblxuICAvKipcbiAgICogUmVuZGVyIHRoZSB0ZW1wbGF0ZSBhcyBhIHN0YXJ0dXAgdGVtcGxhdGUuIHtAbGluayBnZXRUZW1wbGF0ZXJGdW5jdGlvbnN9IHVzZXMgaXQgZm9yIHRoZSB0aHJvd2F3YXlcbiAgICogY29uZmlnIGl0IGJ1aWxkcywgYmVjYXVzZSB0aGF0IGNvbmZpZyByZW5kZXJzIG5vdGhpbmcuXG4gICAqL1xuICBTdGFydHVwVGVtcGxhdGUgPSA1XG59XG4vKiBlc2xpbnQtZW5hYmxlIG5vLW1hZ2ljLW51bWJlcnMgLS0gVGhlc2UgYXJlIFRlbXBsYXRlcidzIG93biBgUnVuTW9kZWAgdmFsdWVzLCB0cmFuc2NyaWJlZC4gKi9cblxuLyoqXG4gKiBXaHkgVGVtcGxhdGVyJ3MgaW50ZXJuYWwgQVBJIGNvdWxkIG5vdCBiZSBoYW5kZWQgb3Zlci5cbiAqL1xuZXhwb3J0IGVudW0gVGVtcGxhdGVyVW5hdmFpbGFiaWxpdHlSZWFzb24ge1xuICAvKipcbiAgICogVGVtcGxhdGVyIGlzIG5vdCBpbnN0YWxsZWQsIG9yIGlzIGluc3RhbGxlZCBidXQgZGlzYWJsZWQuIE9ic2lkaWFuJ3MgYGdldFBsdWdpbmAgY2Fubm90IHRlbGwgdGhlIHR3b1xuICAgKiBhcGFydCBcdTIwMTQgaXQgcmV0dXJucyBub3RoaW5nIGVpdGhlciB3YXkuXG4gICAqL1xuICBOb3RMb2FkZWQgPSAnbm90TG9hZGVkJyxcblxuICAvKipcbiAgICogVGVtcGxhdGVyIGlzIGxvYWRlZCwgYnV0IGRvZXMgbm90IGV4cG9zZSB0aGUgaW50ZXJuYWxzIHRoaXMgbGlicmFyeSBjYWxscyBcdTIwMTQgaXQgaXMgdG9vIG9sZCwgdG9vIG5ldyxcbiAgICogb3IgaGFzIGJlZW4gcmVzaGFwZWQuXG4gICAqL1xuICBTaGFwZUNoYW5nZWQgPSAnc2hhcGVDaGFuZ2VkJ1xufVxuXG4vKipcbiAqIEFjdGl2ZS1maWxlIHByb3ZpZGVyIHRoYXQgYW5zd2VycyB3aXRoIHRoZSBmaWxlIGEge0BsaW5rIHBhcnNlVGVtcGxhdGV9IHJlbmRlciBpcyBjdXJyZW50bHkgZm9yLFxuICogZmFsbGluZyBiYWNrIHRvIHRoZSB3b3Jrc3BhY2UncyBhY3RpdmUgZmlsZSB3aGVuIG5vIHJlbmRlciBpcyBpbiBmbGlnaHQuXG4gKlxuICogVGhpcyBpcyB0aGUgcGllY2UgdGhhdCBtYWtlcyBhIGNvbnN1bWVyJ3Mgb3duIHRlbXBsYXRlIGhlbHBlcnMgcmVzb2x2ZSBhZ2FpbnN0IHRoZSByaWdodCBub3RlOiBkdXJpbmcgYVxuICogcmVuZGVyIHRoZSB3b3Jrc3BhY2Ugc3RpbGwgaGFzIHdoYXRldmVyIHRoZSB1c2VyIHdhcyBsb29raW5nIGF0IG9wZW4sIHdoaWNoIGlzIHJhcmVseSB0aGUgdGFyZ2V0LlxuICovXG5leHBvcnQgY2xhc3MgVGVtcGxhdGVyQWN0aXZlRmlsZVByb3ZpZGVyIGV4dGVuZHMgQXBwQWN0aXZlRmlsZVByb3ZpZGVyIHtcbiAgLyoqXG4gICAqIEdldHMgdGhlIGZpbGUgdGhlIGlubmVybW9zdCBpbi1mbGlnaHQge0BsaW5rIHBhcnNlVGVtcGxhdGV9IHJlbmRlciBpcyBmb3IsIG9yIHRoZSB3b3Jrc3BhY2UncyBhY3RpdmVcbiAgICogZmlsZSB3aGVuIHRoZXJlIGlzIG5vIHJlbmRlciBpbiBmbGlnaHQuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBhY3RpdmUgZmlsZSwgb3IgYG51bGxgIGlmIHRoZXJlIGlzIG5vbmUuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgZ2V0QWN0aXZlRmlsZSgpOiBudWxsIHwgVEZpbGUge1xuICAgIHJldHVybiBnZXRUZW1wbGF0ZXJSZW5kZXJUYXJnZXRGaWxlKCkgPz8gc3VwZXIuZ2V0QWN0aXZlRmlsZSgpO1xuICB9XG59XG5cbi8qKlxuICogVGhyb3duIHdoZW4gVGVtcGxhdGVyJ3MgaW50ZXJuYWwgQVBJIGNhbm5vdCBiZSBoYW5kZWQgb3ZlciwgY2FycnlpbmcgdGhlXG4gKiB7QGxpbmsgVGVtcGxhdGVyVW5hdmFpbGFiaWxpdHlSZWFzb259IHRoYXQgc2F5cyB3aHkuXG4gKi9cbmV4cG9ydCBjbGFzcyBUZW1wbGF0ZXJVbmF2YWlsYWJsZUVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogV2hpY2ggb2YgdGhlIHR3byBmYWlsdXJlcyBvY2N1cnJlZC5cbiAgICovXG4gIHB1YmxpYyByZWFkb25seSByZWFzb246IFRlbXBsYXRlclVuYXZhaWxhYmlsaXR5UmVhc29uO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEge0BsaW5rIFRlbXBsYXRlclVuYXZhaWxhYmxlRXJyb3J9LlxuICAgKlxuICAgKiBAcGFyYW0gcmVhc29uIC0gV2h5IHRoZSBBUEkgaXMgdW5hdmFpbGFibGUuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocmVhc29uOiBUZW1wbGF0ZXJVbmF2YWlsYWJpbGl0eVJlYXNvbikge1xuICAgIHN1cGVyKGBUaGUgaW50ZXJuYWwgQVBJIG9mIHRoZSBwbHVnaW4gXCIke1RFTVBMQVRFUl9QTFVHSU5fSUR9XCIgaXMgdW5hdmFpbGFibGU6ICR7cmVhc29ufS5gKTtcbiAgICB0aGlzLm5hbWUgPSAnVGVtcGxhdGVyVW5hdmFpbGFibGVFcnJvcic7XG4gICAgdGhpcy5yZWFzb24gPSByZWFzb247XG4gIH1cbn1cblxuLyoqXG4gKiBHZXRzIFRlbXBsYXRlcidzIGZ1bmN0aW9ucyBvYmplY3QgXHUyMDE0IHRoZSBgdHBgIGEgdGVtcGxhdGUgaXMgZXZhbHVhdGVkIGFnYWluc3QgXHUyMDE0IHNvIGEgY2FsbGVyIGNhbiBpbnZva2VcbiAqIGB0cC5kYXRlLm5vdygpYCwgYHRwLmZpbGUudGl0bGVgIGFuZCB0aGUgcmVzdCBvdXRzaWRlIGEgdGVtcGxhdGUuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSB7QGxpbmsgR2V0VGVtcGxhdGVyRnVuY3Rpb25zUGFyYW1zfS5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHJlc29sdmluZyB0byB0aGUgZnVuY3Rpb25zIG9iamVjdC5cbiAqIEB0aHJvd3MgQSB7QGxpbmsgVGVtcGxhdGVyVW5hdmFpbGFibGVFcnJvcn0gd2hlbiBUZW1wbGF0ZXIgaXMgbm90IGxvYWRlZCBvciBpdHMgc2hhcGUgaGFzIGNoYW5nZWQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBnZXRUZW1wbGF0ZXJGdW5jdGlvbnMocGFyYW1zOiBHZXRUZW1wbGF0ZXJGdW5jdGlvbnNQYXJhbXMpOiBQcm9taXNlPG9iamVjdD4ge1xuICBjb25zdCB7XG4gICAgYXBwLFxuICAgIHNob3VsZFJldXNlQ3VycmVudCA9IHRydWUsXG4gICAgdGFyZ2V0UGF0aE9yRmlsZVxuICB9ID0gcGFyYW1zO1xuICBjb25zdCBhcGkgPSByZXF1aXJlVGVtcGxhdGVyQXBpKGFwcCk7XG5cbiAgaWYgKHNob3VsZFJldXNlQ3VycmVudCAmJiBhcGkuY3VycmVudF9mdW5jdGlvbnNfb2JqZWN0KSB7XG4gICAgcmV0dXJuIGFwaS5jdXJyZW50X2Z1bmN0aW9uc19vYmplY3Q7XG4gIH1cblxuICBjb25zdCB0YXJnZXRGaWxlID0gZ2V0RmlsZSh7XG4gICAgYXBwLFxuICAgIHBhdGhPckZpbGU6IHRhcmdldFBhdGhPckZpbGVcbiAgfSk7XG4gIGNvbnN0IGNvbmZpZyA9IGFwaS5jcmVhdGVfcnVubmluZ19jb25maWcodW5kZWZpbmVkLCB0YXJnZXRGaWxlLCBUZW1wbGF0ZXJSdW5Nb2RlLlN0YXJ0dXBUZW1wbGF0ZSk7XG4gIHJldHVybiBhd2FpdCBhcGkuZnVuY3Rpb25zX2dlbmVyYXRvci5nZW5lcmF0ZV9vYmplY3QoY29uZmlnKTtcbn1cblxuLyoqXG4gKiBHZXRzIHRoZSBmaWxlIHRoZSBpbm5lcm1vc3QgaW4tZmxpZ2h0IHtAbGluayBwYXJzZVRlbXBsYXRlfSByZW5kZXIgaXMgZm9yLlxuICpcbiAqIFJlbmRlcnMgbmVzdCBcdTIwMTQgYSB0ZW1wbGF0ZSBtYXkgcmVuZGVyIGFub3RoZXIgXHUyMDE0IHNvIHRoZSBjYWxscyBmb3JtIGEgc3RhY2sgYW5kIHRoaXMgcmVwb3J0cyB0aGUgdG9wIG9mXG4gKiBpdC4gT3V0c2lkZSBhbnkgcmVuZGVyIGl0IGlzIGBudWxsYC5cbiAqXG4gKiBAcmV0dXJucyBUaGUgcmVuZGVyIHRhcmdldCwgb3IgYG51bGxgIHdoZW4gbm8gcmVuZGVyIGlzIGluIGZsaWdodC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFRlbXBsYXRlclJlbmRlclRhcmdldEZpbGUoKTogbnVsbCB8IFRGaWxlIHtcbiAgcmV0dXJuIHJlbmRlclRhcmdldEZpbGVzLmF0KC0xKSA/PyBudWxsO1xufVxuXG4vKipcbiAqIFJlbmRlcnMgYSBUZW1wbGF0ZXIgdGVtcGxhdGUgYWdhaW5zdCBhIHRhcmdldCBmaWxlIGFuZCByZXR1cm5zIHRoZSByZXN1bHRpbmcgdGV4dCwgd2l0aG91dCB3cml0aW5nXG4gKiBhbnl0aGluZy5cbiAqXG4gKiBGb3IgdGhlIGR1cmF0aW9uIG9mIHRoZSBjYWxsIHtAbGluayBnZXRUZW1wbGF0ZXJSZW5kZXJUYXJnZXRGaWxlfSBhbmRcbiAqIHtAbGluayBUZW1wbGF0ZXJBY3RpdmVGaWxlUHJvdmlkZXJ9IHJlcG9ydCBgdGFyZ2V0UGF0aE9yRmlsZWAsIHNvIGEgY29uc3VtZXIncyBvd24gaGVscGVycyBpbnZva2VkIGZyb21cbiAqIGluc2lkZSB0aGUgdGVtcGxhdGUgcmVzb2x2ZSBhZ2FpbnN0IGl0IHJhdGhlciB0aGFuIGFnYWluc3Qgd2hhdGV2ZXIgdGhlIHVzZXIgaGFzIG9wZW4uXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSB7QGxpbmsgUGFyc2VUZW1wbGF0ZVBhcmFtc30uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSByZXNvbHZpbmcgdG8gdGhlIHJlbmRlcmVkIHRleHQuXG4gKiBAdGhyb3dzIEEge0BsaW5rIFRlbXBsYXRlclVuYXZhaWxhYmxlRXJyb3J9IHdoZW4gVGVtcGxhdGVyIGlzIG5vdCBsb2FkZWQgb3IgaXRzIHNoYXBlIGhhcyBjaGFuZ2VkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcGFyc2VUZW1wbGF0ZShwYXJhbXM6IFBhcnNlVGVtcGxhdGVQYXJhbXMpOiBQcm9taXNlPHN0cmluZz4ge1xuICBjb25zdCB7XG4gICAgYXBwLFxuICAgIHRhcmdldFBhdGhPckZpbGUsXG4gICAgdGVtcGxhdGVQYXRoT3JGaWxlXG4gIH0gPSBwYXJhbXM7XG4gIGNvbnN0IHRlbXBsYXRlRmlsZSA9IGdldEZpbGUoe1xuICAgIGFwcCxcbiAgICBwYXRoT3JGaWxlOiB0ZW1wbGF0ZVBhdGhPckZpbGVcbiAgfSk7XG4gIGNvbnN0IHRhcmdldEZpbGUgPSBnZXRGaWxlKHtcbiAgICBhcHAsXG4gICAgcGF0aE9yRmlsZTogdGFyZ2V0UGF0aE9yRmlsZVxuICB9KTtcbiAgY29uc3QgYXBpID0gcmVxdWlyZVRlbXBsYXRlckFwaShhcHApO1xuXG4gIHJlbmRlclRhcmdldEZpbGVzLnB1c2godGFyZ2V0RmlsZSk7XG4gIHRyeSB7XG4gICAgcmV0dXJuIGF3YWl0IGFwaS5yZWFkX2FuZF9wYXJzZV90ZW1wbGF0ZSh7XG4gICAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgY2FtZWxjYXNlIC0tIFRlbXBsYXRlciBBUEkuXG4gICAgICBydW5fbW9kZTogVGVtcGxhdGVyUnVuTW9kZS5EeW5hbWljUHJvY2Vzc29yLFxuICAgICAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIGNhbWVsY2FzZSAtLSBUZW1wbGF0ZXIgQVBJLlxuICAgICAgdGFyZ2V0X2ZpbGU6IHRhcmdldEZpbGUsXG4gICAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgY2FtZWxjYXNlIC0tIFRlbXBsYXRlciBBUEkuXG4gICAgICB0ZW1wbGF0ZV9maWxlOiB0ZW1wbGF0ZUZpbGVcbiAgICB9KTtcbiAgfSBmaW5hbGx5IHtcbiAgICByZW5kZXJUYXJnZXRGaWxlcy5wb3AoKTtcbiAgfVxufVxuXG4vKipcbiAqIEdldHMgVGVtcGxhdGVyJ3MgaW50ZXJuYWwgQVBJLCB0aHJvd2luZyB3aGVuIGl0IGNhbm5vdCBiZSBoYWQuXG4gKlxuICogVXNlIHRoaXMgd2hlcmUgdGhlIGNhbGxlciBjYW5ub3QgY2Fycnkgb24gd2l0aG91dCBUZW1wbGF0ZXIgXHUyMDE0IHRoZSBlcnJvciBuYW1lcyB0aGUgcGx1Z2luIGFuZCBzYXlzIHdoaWNoXG4gKiBvZiB0aGUgdHdvIGZhaWx1cmVzIG9jY3VycmVkLiBVc2Uge0BsaW5rIHJlc29sdmVUZW1wbGF0ZXJBcGl9IGluc3RlYWQgd2hlcmUgdGhlIGludGVncmF0aW9uIGlzIG9wdGlvbmFsLlxuICpcbiAqIEBwYXJhbSBhcHAgLSBUaGUgT2JzaWRpYW4gYXBwIGluc3RhbmNlLlxuICogQHJldHVybnMgVGVtcGxhdGVyJ3MgaW50ZXJuYWwgQVBJLlxuICogQHRocm93cyBBIHtAbGluayBUZW1wbGF0ZXJVbmF2YWlsYWJsZUVycm9yfSB3aGVuIFRlbXBsYXRlciBpcyBub3QgbG9hZGVkIG9yIGl0cyBzaGFwZSBoYXMgY2hhbmdlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlcXVpcmVUZW1wbGF0ZXJBcGkoYXBwOiBBcHApOiBUZW1wbGF0ZXJBcGkge1xuICBpZiAoIWFwcC5wbHVnaW5zLmdldFBsdWdpbihURU1QTEFURVJfUExVR0lOX0lEKSkge1xuICAgIHRocm93IG5ldyBUZW1wbGF0ZXJVbmF2YWlsYWJsZUVycm9yKFRlbXBsYXRlclVuYXZhaWxhYmlsaXR5UmVhc29uLk5vdExvYWRlZCk7XG4gIH1cblxuICBjb25zdCBhcGkgPSByZXNvbHZlVGVtcGxhdGVyQXBpKGFwcCk7XG4gIGlmICghYXBpKSB7XG4gICAgdGhyb3cgbmV3IFRlbXBsYXRlclVuYXZhaWxhYmxlRXJyb3IoVGVtcGxhdGVyVW5hdmFpbGFiaWxpdHlSZWFzb24uU2hhcGVDaGFuZ2VkKTtcbiAgfVxuXG4gIHJldHVybiBhcGk7XG59XG5cbi8qKlxuICogR2V0cyBUZW1wbGF0ZXIncyBpbnRlcm5hbCBBUEksIHdoZW4gVGVtcGxhdGVyIGlzIGluc3RhbGxlZCwgZW5hYmxlZCBhbmQgc3RpbGwgdGhlIHNoYXBlIHRoaXMgbGlicmFyeVxuICogZXhwZWN0cy5cbiAqXG4gKiBAcGFyYW0gYXBwIC0gVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAqIEByZXR1cm5zIFRoZSBpbnRlcm5hbCBBUEksIG9yIGBudWxsYCB3aGVuIFRlbXBsYXRlciBpcyBub3QgdGhlcmUgdG8gdGFsayB0by5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVUZW1wbGF0ZXJBcGkoYXBwOiBBcHApOiBudWxsIHwgVGVtcGxhdGVyQXBpIHtcbiAgY29uc3QgcGx1Z2luID0gYXBwLnBsdWdpbnMuZ2V0UGx1Z2luKFRFTVBMQVRFUl9QTFVHSU5fSUQpO1xuICBpZiAoIXBsdWdpbiB8fCAhKCd0ZW1wbGF0ZXInIGluIHBsdWdpbikpIHtcbiAgICByZXR1cm4gbnVsbDtcbiAgfVxuXG4gIGNvbnN0IHRlbXBsYXRlcjogdW5rbm93biA9IHBsdWdpbi50ZW1wbGF0ZXI7XG4gIHJldHVybiBpc1RlbXBsYXRlckFwaSh0ZW1wbGF0ZXIpID8gdGVtcGxhdGVyIDogbnVsbDtcbn1cblxuLypcbiAqIFRoZSBzdGFjayBvZiBmaWxlcyBpbi1mbGlnaHQgYHBhcnNlVGVtcGxhdGVgIGNhbGxzIGFyZSByZW5kZXJpbmcgZm9yLCBpbm5lcm1vc3QgbGFzdC4gQSBzdGFjayByYXRoZXJcbiAqIHRoYW4gYSBzaW5nbGUgc2xvdCBiZWNhdXNlIGEgdGVtcGxhdGUgbWF5IHJlbmRlciBhbm90aGVyLCBhbmQgYW4gYXJyYXkgcmF0aGVyIHRoYW4gYSByZWFzc2lnbmVkXG4gKiB2YXJpYWJsZSBiZWNhdXNlIHB1c2hpbmcgYW5kIHBvcHBpbmcgYSBgY29uc3RgIG5lZWRzIG5vIHdyaXRlIHRvIGFuIG91dGVyIGJpbmRpbmcgYWNyb3NzIGFuIGBhd2FpdGAuXG4gKi9cbmNvbnN0IHJlbmRlclRhcmdldEZpbGVzOiBURmlsZVtdID0gW107XG5cbi8qKlxuICogQ2hlY2tzIHRoYXQgYSB2YWx1ZSBpcyBUZW1wbGF0ZXIncyBpbnRlcm5hbCBBUEksIGJ5IHRoZSBtZW1iZXJzIHRoaXMgbGlicmFyeSBhY3R1YWxseSBjYWxscy5cbiAqXG4gKiBBIHByZWRpY2F0ZSByYXRoZXIgdGhhbiBhIGNhc3Qgb24gcHVycG9zZTogYHRlbXBsYXRlcmAgaXMgbm90IHBhcnQgb2YgT2JzaWRpYW4ncyBgUGx1Z2luYCB0eXBlLCBzbyB0aGVcbiAqIHZhbHVlIGFycml2ZXMgYXMgYHVua25vd25gIGFuZCB0aGUgb25seSBob25lc3Qgd2F5IHRvIHR5cGUgaXQgaXMgdG8gVkVSSUZZIGl0LiBBIFRlbXBsYXRlciB0aGF0IHJlbmFtZXNcbiAqIG9uZSBvZiB0aGVzZSB0aGVyZWZvcmUgcmVhZHMgYXMgXCJub3QgdGhlcmVcIiwgaW5zdGVhZCBvZiB0aHJvd2luZyBmcm9tIGluc2lkZSBhIHJlbmRlci5cbiAqXG4gKiBAcGFyYW0gdmFsdWUgLSBUaGUgY2FuZGlkYXRlIGB0ZW1wbGF0ZXJgIG9iamVjdC5cbiAqIEByZXR1cm5zIFdoZXRoZXIgaXQgY2FycmllcyBldmVyeSBtZW1iZXIgdGhpcyBsaWJyYXJ5IGNhbGxzLlxuICovXG5mdW5jdGlvbiBpc1RlbXBsYXRlckFwaSh2YWx1ZTogdW5rbm93bik6IHZhbHVlIGlzIFRlbXBsYXRlckFwaSB7XG4gIGlmICh0eXBlb2YgdmFsdWUgIT09ICdvYmplY3QnIHx8IHZhbHVlID09PSBudWxsIHx8ICEoJ2NyZWF0ZV9ydW5uaW5nX2NvbmZpZycgaW4gdmFsdWUpIHx8IHR5cGVvZiB2YWx1ZS5jcmVhdGVfcnVubmluZ19jb25maWcgIT09ICdmdW5jdGlvbicgfHwgISgncmVhZF9hbmRfcGFyc2VfdGVtcGxhdGUnIGluIHZhbHVlKSB8fCB0eXBlb2YgdmFsdWUucmVhZF9hbmRfcGFyc2VfdGVtcGxhdGUgIT09ICdmdW5jdGlvbicgfHwgISgnZnVuY3Rpb25zX2dlbmVyYXRvcicgaW4gdmFsdWUpKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG5cbiAgY29uc3QgZnVuY3Rpb25zR2VuZXJhdG9yOiB1bmtub3duID0gdmFsdWUuZnVuY3Rpb25zX2dlbmVyYXRvcjtcbiAgcmV0dXJuIHR5cGVvZiBmdW5jdGlvbnNHZW5lcmF0b3IgPT09ICdvYmplY3QnICYmIGZ1bmN0aW9uc0dlbmVyYXRvciAhPT0gbnVsbCAmJiAnZ2VuZXJhdGVfb2JqZWN0JyBpbiBmdW5jdGlvbnNHZW5lcmF0b3IgJiYgdHlwZW9mIGZ1bmN0aW9uc0dlbmVyYXRvci5nZW5lcmF0ZV9vYmplY3QgPT09ICdmdW5jdGlvbic7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFB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QUUsZUFBZSxTQUFTO0FBQ3ZDLFdBQU87QUFBQSxFQUNUO0FBRUEsUUFBTSxZQUFxQixPQUFPO0FBQ2xDLFNBQU8sZUFBZSxTQUFTLElBQUksWUFBWTtBQUNqRDtBQU9BLE1BQU0sb0JBQTZCLENBQUM7QUFZcEMsU0FBUyxlQUFlLE9BQXVDO0FBQzdELE1BQUksT0FBTyxVQUFVLFlBQVksVUFBVSxRQUFRLEVBQUUsMkJBQTJCLFVBQVUsT0FBTyxNQUFNLDBCQUEwQixjQUFjLEVBQUUsNkJBQTZCLFVBQVUsT0FBTyxNQUFNLDRCQUE0QixjQUFjLEVBQUUseUJBQXlCLFFBQVE7QUFDaFIsV0FBTztBQUFBLEVBQ1Q7QUFFQSxRQUFNLHFCQUE4QixNQUFNO0FBQzFDLFNBQU8sT0FBTyx1QkFBdUIsWUFBWSx1QkFBdUIsUUFBUSxxQkFBcUIsc0JBQXNCLE9BQU8sbUJBQW1CLG9CQUFvQjtBQUMzSzsiLAogICJuYW1lcyI6IFsiVGVtcGxhdGVyUnVuTW9kZSIsICJUZW1wbGF0ZXJVbmF2YWlsYWJpbGl0eVJlYXNvbiJdCn0K

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

@@ -0,0 +1,284 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * The slice of Templater's INTERNAL API this library talks to, and the runtime narrowing that gets hold
+ * of it.
+ *
+ * **Templater publishes no API.** Rendering a template against a file and getting the resulting string
+ * back is only reachable through undocumented internals hanging off
+ * `app.plugins.getPlugin('templater-obsidian').templater` — `create_running_config`,
+ * `functions_generator.generate_object`, `read_and_parse_template`, and a `RunMode` enum. Every plugin
+ * that wants it re-derives the same reverse engineering, which is why it lives here instead.
+ *
+ * **This module is explicitly BEST-EFFORT.** Nothing it binds to is documented or covered by Templater's
+ * semantic versioning, so a Templater release may rename or reshape any of it without warning. The shapes
+ * below were read from Templater `2.24.3`. Two deliberate consequences follow:
+ *
+ * - {@link resolveTemplaterApi} returns `null` — a Templater too old, too new or too broken to talk to
+ *   reads as "not there" and the integration stays dormant.
+ * - {@link requireTemplaterApi} throws a {@link TemplaterUnavailableError} that NAMES the plugin and the
+ *   reason, rather than letting a `Cannot read properties of undefined` surface from somewhere inside
+ *   Templater.
+ *
+ * The types are DECLARED HERE rather than imported, and narrowed to the members actually called: Templater
+ * ships no npm types package, and depending on it would turn an optional integration into a build-time
+ * dependency.
+ *
+ * The second thing this module supplies is an active-file answer. While a template renders,
+ * `app.workspace.getActiveFile()` still points at whatever the user happens to have open — NOT at the file
+ * the template is being rendered for — so a plugin's own helper called from inside a template resolves
+ * links against the wrong note. {@link TemplaterActiveFileProvider} answers with the render target for the
+ * duration of a {@link parseTemplate} call and falls back to the workspace otherwise. Note this is about
+ * the CONSUMER's helpers: Templater's own `tp.file.*` already resolves through the running config's
+ * `target_file` and needs no help.
+ */
+import type { App, TFile } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { PathOrFile } from './file-system.cjs';
+import { AppActiveFileProvider } from './active-file-provider.cjs';
+/**
+ * Parameters for {@link getTemplaterFunctions}.
+ */
+export interface GetTemplaterFunctionsParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * Whether to return Templater's `current_functions_object` when it already has one, instead of
+     * generating a fresh object. Reuse is cheaper and gives the object of the render currently in flight;
+     * pass `false` to force a new one built for `targetPathOrFile`.
+     *
+     * @default `true`
+     */
+    readonly shouldReuseCurrent?: boolean;
+    /**
+     * The file the generated functions should resolve against — what `tp.file.*` reports.
+     */
+    readonly targetPathOrFile: PathOrFile;
+}
+/**
+ * Parameters for {@link parseTemplate}.
+ */
+export interface ParseTemplateParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The file the template is rendered FOR. It is what `tp.file.*` resolves to inside the template, and
+     * what {@link TemplaterActiveFileProvider} reports for the duration of the call.
+     */
+    readonly targetPathOrFile: PathOrFile;
+    /**
+     * The template file to render.
+     */
+    readonly templatePathOrFile: PathOrFile;
+}
+/**
+ * Templater's internal API object, narrowed to the members this library calls.
+ *
+ * Its members are `snake_case` because Templater's are; they are transcribed rather than renamed so the
+ * shape can be checked against Templater's source at a glance.
+ */
+export interface TemplaterApi {
+    /**
+     * Builds the {@link TemplaterRunningConfig} that describes one render.
+     *
+     * @param templateFile - The template being rendered, or `undefined` when there is none (as when only
+     * the functions object is wanted).
+     * @param targetFile - The file the render is for.
+     * @param runMode - Which {@link TemplaterRunMode} the render is.
+     * @returns The running config.
+     */
+    create_running_config: (templateFile: TFile | undefined, targetFile: TFile, runMode: TemplaterRunMode) => TemplaterRunningConfig;
+    /**
+     * The functions object (`tp`) of the render currently in flight, when there is one.
+     */
+    current_functions_object?: object | undefined;
+    /**
+     * Builds the functions object (`tp`) a template is evaluated against.
+     */
+    functions_generator: TemplaterFunctionsGenerator;
+    /**
+     * Reads the config's `template_file` and renders it, returning the resulting text.
+     *
+     * @param config - The {@link TemplaterRunningConfig} describing the render. Templater throws when its
+     * `template_file` is not a `TFile`.
+     * @returns A {@link Promise} resolving to the rendered text.
+     */
+    read_and_parse_template: (config: TemplaterRunningConfig) => Promise<string>;
+}
+/**
+ * The `functions_generator` half of {@link TemplaterApi}.
+ */
+export interface TemplaterFunctionsGenerator {
+    /**
+     * Builds the functions object (`tp`) for a running config.
+     *
+     * @param config - The {@link TemplaterRunningConfig} to build for.
+     * @returns A {@link Promise} resolving to the functions object.
+     */
+    generate_object: (config: TemplaterRunningConfig) => Promise<object>;
+}
+/**
+ * One Templater render, as Templater's `create_running_config` describes it.
+ *
+ * Its members are `snake_case` because Templater's are.
+ */
+export interface TemplaterRunningConfig {
+    /**
+     * The file Templater considers active. Templater fills this in itself from
+     * `workspace.activeEditor?.file ?? workspace.getActiveFile()`; it is optional here because a
+     * hand-built config may omit it.
+     */
+    active_file?: null | TFile | undefined;
+    /**
+     * Which {@link TemplaterRunMode} the render is.
+     */
+    run_mode: TemplaterRunMode;
+    /**
+     * The file the render is for — what `tp.file.*` resolves to.
+     */
+    target_file: TFile;
+    /**
+     * The template being rendered, when there is one.
+     */
+    template_file?: TFile | undefined;
+}
+/**
+ * Templater's plugin id, as its manifest declares it.
+ */
+export declare const TEMPLATER_PLUGIN_ID = "templater-obsidian";
+/**
+ * Templater's `RunMode` enum, which says what kind of render a {@link TemplaterRunningConfig} describes.
+ *
+ * The numeric values ARE Templater's, and the members are listed in its declaration order so the two can
+ * be compared line for line. They are written out explicitly all the same, because they cross into
+ * Templater as integers — never renumber them.
+ */
+export declare enum TemplaterRunMode {
+    /**
+     * Render the template into a newly created file.
+     */
+    CreateNewFromTemplate = 0,
+    /**
+     * Render the template and append the result to the active file.
+     */
+    AppendActiveFile = 1,
+    /**
+     * Render the template and overwrite a given file with the result.
+     */
+    OverwriteFile = 2,
+    /**
+     * Render the template and overwrite the active file with the result.
+     */
+    OverwriteActiveFile = 3,
+    /**
+     * Render the template on demand, for a caller that wants the resulting text rather than a file
+     * written. This is what {@link parseTemplate} uses.
+     */
+    DynamicProcessor = 4,
+    /**
+     * Render the template as a startup template. {@link getTemplaterFunctions} uses it for the throwaway
+     * config it builds, because that config renders nothing.
+     */
+    StartupTemplate = 5
+}
+/**
+ * Why Templater's internal API could not be handed over.
+ */
+export declare enum TemplaterUnavailabilityReason {
+    /**
+     * Templater is not installed, or is installed but disabled. Obsidian's `getPlugin` cannot tell the two
+     * apart — it returns nothing either way.
+     */
+    NotLoaded = "notLoaded",
+    /**
+     * Templater is loaded, but does not expose the internals this library calls — it is too old, too new,
+     * or has been reshaped.
+     */
+    ShapeChanged = "shapeChanged"
+}
+/**
+ * Active-file provider that answers with the file a {@link parseTemplate} render is currently for,
+ * falling back to the workspace's active file when no render is in flight.
+ *
+ * This is the piece that makes a consumer's own template helpers resolve against the right note: during a
+ * render the workspace still has whatever the user was looking at open, which is rarely the target.
+ */
+export declare class TemplaterActiveFileProvider extends AppActiveFileProvider {
+    /**
+     * Gets the file the innermost in-flight {@link parseTemplate} render is for, or the workspace's active
+     * file when there is no render in flight.
+     *
+     * @returns The active file, or `null` if there is none.
+     */
+    getActiveFile(): null | TFile;
+}
+/**
+ * Thrown when Templater's internal API cannot be handed over, carrying the
+ * {@link TemplaterUnavailabilityReason} that says why.
+ */
+export declare class TemplaterUnavailableError extends Error {
+    /**
+     * Which of the two failures occurred.
+     */
+    readonly reason: TemplaterUnavailabilityReason;
+    /**
+     * Creates a {@link TemplaterUnavailableError}.
+     *
+     * @param reason - Why the API is unavailable.
+     */
+    constructor(reason: TemplaterUnavailabilityReason);
+}
+/**
+ * Gets Templater's functions object — the `tp` a template is evaluated against — so a caller can invoke
+ * `tp.date.now()`, `tp.file.title` and the rest outside a template.
+ *
+ * @param params - The {@link GetTemplaterFunctionsParams}.
+ * @returns A {@link Promise} resolving to the functions object.
+ * @throws A {@link TemplaterUnavailableError} when Templater is not loaded or its shape has changed.
+ */
+export declare function getTemplaterFunctions(params: GetTemplaterFunctionsParams): Promise<object>;
+/**
+ * Gets the file the innermost in-flight {@link parseTemplate} render is for.
+ *
+ * Renders nest — a template may render another — so the calls form a stack and this reports the top of
+ * it. Outside any render it is `null`.
+ *
+ * @returns The render target, or `null` when no render is in flight.
+ */
+export declare function getTemplaterRenderTargetFile(): null | TFile;
+/**
+ * Renders a Templater template against a target file and returns the resulting text, without writing
+ * anything.
+ *
+ * For the duration of the call {@link getTemplaterRenderTargetFile} and
+ * {@link TemplaterActiveFileProvider} report `targetPathOrFile`, so a consumer's own helpers invoked from
+ * inside the template resolve against it rather than against whatever the user has open.
+ *
+ * @param params - The {@link ParseTemplateParams}.
+ * @returns A {@link Promise} resolving to the rendered text.
+ * @throws A {@link TemplaterUnavailableError} when Templater is not loaded or its shape has changed.
+ */
+export declare function parseTemplate(params: ParseTemplateParams): Promise<string>;
+/**
+ * Gets Templater's internal API, throwing when it cannot be had.
+ *
+ * Use this where the caller cannot carry on without Templater — the error names the plugin and says which
+ * of the two failures occurred. Use {@link resolveTemplaterApi} instead where the integration is optional.
+ *
+ * @param app - The Obsidian app instance.
+ * @returns Templater's internal API.
+ * @throws A {@link TemplaterUnavailableError} when Templater is not loaded or its shape has changed.
+ */
+export declare function requireTemplaterApi(app: App): TemplaterApi;
+/**
+ * Gets Templater's internal API, when Templater is installed, enabled and still the shape this library
+ * expects.
+ *
+ * @param app - The Obsidian app instance.
+ * @returns The internal API, or `null` when Templater is not there to talk to.
+ */
+export declare function resolveTemplaterApi(app: App): null | TemplaterApi;