@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/cjs/metadata-cache.d.cts

@@ -0,0 +1,359 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * This module provides utility functions for working with the metadata cache in Obsidian.
+ */
+import type { RetryOptions } from '@mnaoumov/typescript-lib/async' with { 'resolution-mode': 'import' };
+import type { CustomArrayDict } from '@obsidian-typings/obsidian-public-latest' with { 'resolution-mode': 'import' };
+import type { App, CachedMetadata, Reference, TAbstractFile } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { PathOrFile } from './file-system.cjs';
+import type { CombinedFrontmatter } from './frontmatter.cjs';
+import type { ParseLinkFrontmatterReference, ParseLinkFrontmatterReferenceWithOffsets, ParseLinkReference } from './parse-link.cjs';
+/**
+ * A parsing feature that was applied when computing a {@link CachedMetadataEx}.
+ */
+export declare enum CachedMetadataExFeature {
+    /**
+     * The external links parsed from the note content body.
+     */
+    ExternalLinks = "ExternalLinks",
+    /**
+     * The external links parsed from single-link note frontmatter values.
+     */
+    FrontmatterExternalLinks = "FrontmatterExternalLinks",
+    /**
+     * The external links parsed from multi-link note frontmatter values.
+     */
+    MultiValueFrontmatterExternalLinks = "MultiValueFrontmatterExternalLinks",
+    /**
+     * The internal links parsed from multi-link note frontmatter values, which Obsidian does not natively cache.
+     */
+    MultiValueFrontmatterLinks = "MultiValueFrontmatterLinks",
+    /**
+     * Obsidian's native metadata parsing (internal links, embeds, frontmatter links).
+     */
+    Native = "Native"
+}
+/**
+ * An extended {@link CachedMetadata} that records which parsing {@link CachedMetadataExFeature}s were
+ * applied (via {@link CachedMetadataEx.features}) and carries the resulting external links. Each links
+ * array is populated only when its corresponding feature is present in {@link CachedMetadataEx.features}.
+ */
+export interface CachedMetadataEx extends CachedMetadata {
+    /**
+     * The external links parsed from the note content body. Populated only when
+     * {@link CachedMetadataExFeature.ExternalLinks} is applied.
+     */
+    externalLinks?: ParseLinkReference[];
+    /**
+     * The parsing features that were applied when computing this cache.
+     */
+    readonly features: CachedMetadataExFeature[];
+    /**
+     * The external links parsed from single-link (single-value) note frontmatter values. Populated only
+     * when {@link CachedMetadataExFeature.FrontmatterExternalLinks} is applied.
+     */
+    frontmatterExternalLinks?: ParseLinkFrontmatterReference[];
+    /**
+     * The external links parsed from multi-link (multi-value) note frontmatter values. Populated only when
+     * {@link CachedMetadataExFeature.MultiValueFrontmatterExternalLinks} is applied.
+     */
+    multiValueFrontmatterExternalLinks?: ParseLinkFrontmatterReferenceWithOffsets[];
+    /**
+     * The internal links parsed from multi-link (multi-value) note frontmatter values. Populated only when
+     * {@link CachedMetadataExFeature.MultiValueFrontmatterLinks} is applied.
+     */
+    multiValueFrontmatterLinks?: ParseLinkFrontmatterReferenceWithOffsets[];
+}
+/**
+ * Options for {@link getBacklinksForFileSafe}.
+ */
+export interface GetBacklinksForFileSafeOptions extends RetryOptions {
+    /**
+     * Whether to show a timeout notice.
+     *
+     * @default `true`
+     */
+    readonly shouldShowTimeoutNotice?: boolean;
+}
+/**
+ * Parameters for {@link getBacklinksForFileSafe}.
+ */
+export interface GetBacklinksForFileSafeParams extends GetBacklinksForFileSafeOptions {
+    /**
+     * The Obsidian application instance.
+     */
+    readonly app: App;
+    /**
+     * The path or file object.
+     */
+    readonly pathOrFile: PathOrFile;
+}
+/**
+ * Wrapper for the getBacklinksForFile method that provides a safe overload.
+ */
+export interface GetBacklinksForFileSafeWrapper {
+    /**
+     * Retrieves the backlinks for a file safely.
+     *
+     * @param pathOrFile - The path or file object.
+     * @returns A {@link Promise} that resolves to an array dictionary of backlinks.
+     */
+    safe: (pathOrFile: PathOrFile) => Promise<CustomArrayDict<Reference>>;
+}
+/**
+ * Options for {@link getCacheSafe}.
+ */
+export type GetCacheSafeOptions = ParseCacheOptions;
+/**
+ * Params for {@link getLinks}.
+ */
+export interface GetLinksParams {
+    /**
+     * The cached metadata to retrieve the links from.
+     */
+    readonly cache: CachedMetadata;
+    /**
+     * Whether to include the embeds (`cache.embeds`).
+     *
+     * @default `true`
+     */
+    readonly shouldIncludeEmbeds?: boolean;
+    /**
+     * Whether to include the external links parsed from the note body. Requires the cache to be a
+     * {@link CachedMetadataEx}.
+     *
+     * @default `false`
+     */
+    readonly shouldIncludeExternalLinks?: boolean;
+    /**
+     * Whether to include the external links parsed from single-link (single-value) note frontmatter
+     * values. Requires the cache to be a {@link CachedMetadataEx}.
+     *
+     * @default `false`
+     */
+    readonly shouldIncludeFrontmatterExternalLinks?: boolean;
+    /**
+     * Whether to include the frontmatter links (`cache.frontmatterLinks`).
+     *
+     * @default `true`
+     */
+    readonly shouldIncludeFrontmatterLinks?: boolean;
+    /**
+     * Whether to include the external links parsed from multi-link (multi-value) note frontmatter values,
+     * i.e. the offset-carrying frontmatter external links (narrowed via
+     * {@link isFrontmatterLinkCacheWithOffsets}). Requires the cache to be a {@link CachedMetadataEx}.
+     *
+     * @default `false`
+     */
+    readonly shouldIncludeMultiValueFrontmatterExternalLinks?: boolean;
+    /**
+     * Whether to include the internal links parsed from multi-link (multi-value) note frontmatter values.
+     * Requires the cache to be a {@link CachedMetadataEx}.
+     *
+     * @default `false`
+     */
+    readonly shouldIncludeMultiValueFrontmatterLinks?: boolean;
+    /**
+     * Whether to include the reference links (`cache.links`).
+     *
+     * @default `true`
+     */
+    readonly shouldIncludeReferences?: boolean;
+}
+/**
+ * Options for the parsing performed by {@link getCacheSafe} and {@link parseMetadata} beyond Obsidian's
+ * native metadata parsing. Each option is opt-in; enabling it adds the corresponding
+ * {@link CachedMetadataExFeature} and populates the matching links array.
+ */
+export interface ParseCacheOptions {
+    /**
+     * Whether to parse the external links from the note content body.
+     *
+     * @default `false`
+     */
+    readonly shouldParseExternalLinks?: boolean;
+    /**
+     * Whether to parse the external links from single-link (single-value) note frontmatter values.
+     *
+     * @default `false`
+     */
+    readonly shouldParseFrontmatterExternalLinks?: boolean;
+    /**
+     * Whether to parse the external links from multi-link (multi-value) note frontmatter values.
+     *
+     * @default `false`
+     */
+    readonly shouldParseMultiValueFrontmatterExternalLinks?: boolean;
+    /**
+     * Whether to parse the internal links from multi-link (multi-value) note frontmatter values.
+     *
+     * @default `false`
+     */
+    readonly shouldParseMultiValueFrontmatterLinks?: boolean;
+}
+/**
+ * Options for {@link parseMetadata}.
+ */
+export type ParseMetadataOptions = ParseCacheOptions;
+/**
+ * Parameters for {@link registerFileCacheForNonExistingFile}.
+ */
+export interface RegisterFileCacheForNonExistingFileParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The file cache to register.
+     */
+    readonly cache: CachedMetadata;
+    /**
+     * The path or file to register the file cache for.
+     */
+    readonly pathOrFile: PathOrFile;
+}
+/**
+ * The plugin id of the Advanced Metadata Cache plugin, the successor to Backlink Cache.
+ *
+ * Used by {@link hasBacklinkCachePlugin}. Note that {@link getBacklinksForFileSafe} does NOT need this id: it detects the cache by the {@link GetBacklinksForFileSafeWrapper.safe} overload grafted onto `MetadataCache.getBacklinksForFile`, which both plugins install and which names no plugin.
+ */
+export declare const ADVANCED_METADATA_CACHE_PLUGIN_ID = "advanced-metadata-cache";
+/**
+ * The plugin id of the retired Backlink Cache plugin, superseded by {@link ADVANCED_METADATA_CACHE_PLUGIN_ID}.
+ *
+ * Still recognized by {@link hasBacklinkCachePlugin}, deliberately. Removing a plugin from the community registry blocks new installs; it uninstalls nothing, so every existing user keeps it until they migrate by hand.
+ *
+ * It may be dropped when all three of the following hold, and not before: Advanced Metadata Cache is listed in the community registry, so migrating is possible at all; the final Backlink Cache handover release has been out for at least twelve months; and this library is cutting a major release anyway, because dropping the id silently un-gates canvas link handling for anyone who has not migrated. There is no cost pressure to drop it earlier - recognizing a dead id is one string comparison on a path that already reads a plugin registry.
+ */
+export declare const BACKLINK_CACHE_PLUGIN_ID = "backlink-cache";
+/**
+ * Ensures that the metadata cache is ready for all files.
+ *
+ * @param app - The Obsidian app instance.
+ * @returns A {@link Promise} that resolves when the metadata cache is ready.
+ */
+export declare function ensureMetadataCacheReady(app: App): Promise<void>;
+/**
+ * Retrieves the backlinks for a file or path.
+ * NOTE: The file may be non-existent.
+ *
+ * When a backlink-cache plugin has grafted its {@link GetBacklinksForFileSafeWrapper.safe} overload onto
+ * `MetadataCache.getBacklinksForFile`, that patched method answers. Otherwise the answer comes from a backlink
+ * index whose cost is proportional to the candidate notes rather than to every reference in the vault, and which
+ * gives the same references Obsidian's own `getBacklinksForFile` gives.
+ *
+ * @param app - The Obsidian application instance.
+ * @param pathOrFile - The path or file object.
+ * @returns The backlinks for the file.
+ */
+export declare function getBacklinksForFileOrPath(app: App, pathOrFile: PathOrFile): CustomArrayDict<Reference>;
+/**
+ * Retrieves the backlinks for a file safely.
+ *
+ * This is NOT a pure read. When no backlink-cache plugin supplies the `safe` overload, it verifies
+ * each backlink against the note's current text, and to do that it calls {@link saveNote} on every
+ * note that links to the file, which saves any open editor view of those notes that has unsaved
+ * changes. Call it from an explicit user action. Do not call it from an automatic trigger (a vault or
+ * metadata event, a save or render patch) that only decides whether to act. There, a forced save can
+ * race another plugin's in-flight editor change.
+ *
+ * @param params - The parameters for retrieving the backlinks.
+ * @returns A {@link Promise} that resolves to an array dictionary of backlinks.
+ */
+export declare function getBacklinksForFileSafe(params: GetBacklinksForFileSafeParams): Promise<CustomArrayDict<Reference>>;
+/**
+ * Retrieves the cached metadata for a given file or path.
+ *
+ * This is NOT a pure read: before it reads the cache, it calls {@link saveNote}, which saves any
+ * open editor view of the note that has unsaved changes. That save is why the cache matches what the
+ * user sees, and why a command that rewrites the note can use this safely without its rewrite being
+ * clobbered. It is also a write on the note. So do not call this from an automatic trigger (a vault
+ * or metadata event, a save or render patch, a layout hook) that only decides whether to act: a
+ * forced save one tick after another plugin has dispatched a change into the editor can leave
+ * Obsidian's editor rendering stale state. A read-only probe on the note's current text should use
+ * {@link parseMetadata} on that text instead. It needs no view, no cache and no save.
+ *
+ * @param app - The Obsidian app instance.
+ * @param fileOrPath - The file or path to retrieve the metadata for.
+ * @param options - The parse options controlling which additional links to parse.
+ * @returns The cached metadata for the file, or `null` if it doesn't exist.
+ */
+export declare function getCacheSafe(app: App, fileOrPath: PathOrFile, options?: GetCacheSafeOptions): Promise<CachedMetadataEx | null>;
+/**
+ * Retrieves the front matter from the metadata cache safely.
+ *
+ * It reads through {@link getCacheSafe}, so it saves any open editor view of the note that has
+ * unsaved changes. See {@link getCacheSafe} for when that save matters and what to use instead.
+ *
+ * @typeParam CustomFrontmatter - The type of custom front matter.
+ * @param app - The Obsidian app instance.
+ * @param pathOrFile - The path or file to retrieve the front matter from.
+ * @returns The combined front matter.
+ */
+export declare function getFrontmatterSafe<CustomFrontmatter = unknown>(app: App, pathOrFile: PathOrFile): Promise<CombinedFrontmatter<CustomFrontmatter>>;
+/**
+ * Retrieves the selected links from the provided cache.
+ *
+ * @param params - The parameters for retrieving the links.
+ * @returns An array of references representing the selected links.
+ */
+export declare function getLinks(params: GetLinksParams): Reference[];
+/**
+ * Determines whether a backlink cache plugin is currently loaded - either Advanced Metadata Cache ({@link ADVANCED_METADATA_CACHE_PLUGIN_ID}) or its retired predecessor Backlink Cache ({@link BACKLINK_CACHE_PLUGIN_ID}).
+ *
+ * Such a plugin grafts a drain-on-read backlink index onto the metadata cache and indexes canvas metadata, so a caller that compensates for Obsidian's own gaps can stand down while one is present. Both ids are recognized; {@link BACKLINK_CACHE_PLUGIN_ID} records when the retired one may be dropped.
+ *
+ * This reads the LOADED plugin instance rather than `app.plugins.enabledPlugins`, deliberately: the question is whether the plugin's patches are in place right now, and they are not until it has loaded. Plugins load in an unspecified order, so call this from a user-driven path rather than from plugin load - see rule L25 in `AGENTS.md`.
+ *
+ * @param app - The Obsidian app instance.
+ * @returns `true` if a backlink cache plugin is loaded, otherwise `false`.
+ */
+export declare function hasBacklinkCachePlugin(app: App): boolean;
+/**
+ * Determines whether a cache is a {@link CachedMetadataEx} (i.e. it was computed with external-link
+ * parsing enabled).
+ *
+ * @param cache - The cache to check.
+ * @returns `true` if the cache is a {@link CachedMetadataEx}, otherwise `false`.
+ */
+export declare function isCachedMetadataEx(cache: CachedMetadata): cache is CachedMetadataEx;
+/**
+ * Parses the metadata for a given string.
+ *
+ * @param app - The Obsidian app instance.
+ * @param $string - The string to parse the metadata for.
+ * @param options - The parse options controlling which additional links to parse.
+ * @returns The parsed metadata.
+ */
+export declare function parseMetadata(app: App, $string: string, options?: ParseMetadataOptions): Promise<CachedMetadataEx>;
+/**
+ * Registers the file cache for a non-existing file.
+ *
+ * @param params - The parameters for registering the file cache.
+ * @returns A {@link Disposable} that unregisters the file cache when disposed, for use with `using`.
+ */
+export declare function registerFileCacheForNonExistingFile(params: RegisterFileCacheForNonExistingFileParams): Disposable;
+/**
+ * Registers files in the Obsidian app.
+ *
+ * @param app - The Obsidian app instance.
+ * @param files - The files to register.
+ * @returns A {@link Disposable} that unregisters the files when disposed, for use with `using`.
+ */
+export declare function registerFiles(app: App, files: TAbstractFile[]): Disposable;
+/**
+ * Unregisters the file cache for a non-existing file.
+ *
+ * @param app - The Obsidian app instance.
+ * @param pathOrFile - The path or file to unregister the file cache for.
+ */
+export declare function unregisterFileCacheForNonExistingFile(app: App, pathOrFile: PathOrFile): void;
+/**
+ * Unregisters files from the Obsidian app.
+ *
+ * @param app - The Obsidian app instance.
+ * @param files - The files to unregister.
+ */
+export declare function unregisterFiles(app: App, files: TAbstractFile[]): void;

package/dist/lib/cjs/mobile-trusted-input.cjs

@@ -0,0 +1,185 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for("Symbol.asyncDispose");
+  symbolConstructor.dispose ??= symbolConstructor.for("Symbol.dispose");
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return "/";
+    },
+    env: {},
+    platform: "android"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+  if (existingProcess.versions?.node) {
+    return;
+  }
+  const existingProcessRecord = existingProcess;
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+  existingProcessRecord["browser"] = true;
+}
+
+function keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord["__name"] ??= keepName;
+  globalThisRecord["__extractDefault"] ??= extractDefault;
+  ensureBrowserProcess();
+  function extractDefault(module) {
+    return module && module.__esModule && "default" in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  require = Object.assign(
+    (id) => requirePatched(id),
+    originalRequire,
+    {
+      __isPatched: true
+    }
+  );
+  function extractDefault(module) {
+    return module && module.__esModule && "default" in module ? module.default : module;
+  }
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/autocomplete",
+    "@codemirror/collab",
+    "@codemirror/commands",
+    "@codemirror/language",
+    "@codemirror/lint",
+    "@codemirror/search",
+    "@codemirror/state",
+    "@codemirror/text",
+    "@codemirror/view",
+    "@lezer/common",
+    "@lezer/highlight",
+    "@lezer/lr",
+    "obsidian"
+  ]);
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/closebrackets",
+    "@codemirror/comment",
+    "@codemirror/fold",
+    "@codemirror/gutter",
+    "@codemirror/highlight",
+    "@codemirror/history",
+    "@codemirror/matchbrackets",
+    "@codemirror/panel",
+    "@codemirror/rangeset",
+    "@codemirror/rectangular-selection",
+    "@codemirror/stream-parser",
+    "@codemirror/tooltip"
+  ]);
+  function requirePatched(id) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+    if (globalThis.app.isMobile) {
+      if (id === "process" || id === "node:process") {
+        console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
+        return process;
+      }
+    } else {
+      const module = originalRequire?.(id);
+      if (module) {
+        return extractDefault(module);
+      }
+    }
+    console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Empty object is returned instead.`);
+    return {};
+  }
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mobile_trusted_input_exports = {};
+__export(mobile_trusted_input_exports, {
+  clickElement: () => clickElement,
+  clickMouse: () => clickMouse,
+  hoverElement: () => hoverElement,
+  moveMouse: () => moveMouse,
+  pressKey: () => pressKey,
+  typeIntoEditor: () => typeIntoEditor,
+  unhoverElement: () => unhoverElement
+});
+module.exports = __toCommonJS(mobile_trusted_input_exports);
+async function clickElement(params) {
+  await getSeamFunction("clickElement")(params);
+}
+async function clickMouse(params) {
+  await getSeamFunction("clickMouse")(params);
+}
+async function hoverElement(params) {
+  await getSeamFunction("hoverElement")(params);
+}
+async function moveMouse(params) {
+  await getSeamFunction("moveMouse")(params);
+}
+async function pressKey(params) {
+  await getSeamFunction("pressKey")(params);
+}
+async function typeIntoEditor(params) {
+  await getSeamFunction("typeIntoEditor")(params);
+}
+async function unhoverElement(params) {
+  await getSeamFunction("unhoverElement")(params);
+}
+function getSeamFunction(name) {
+  const holder = globalThis;
+  const seamFunction = holder.__obsidianIntegrationTesting?.trustedInput?.[name];
+  if (!seamFunction) {
+    throw new Error(
+      `Trusted input is unavailable on mobile: \`window.__obsidianIntegrationTesting.trustedInput.${name}\` is not installed. A phone has no in-renderer route to a trusted event, so the injection is a round-trip to the host over the \`obsidian-integration-testing\` Appium transport's channel \u2014 which means these helpers only work inside an app that harness bootstrapped.`
+    );
+  }
+  return seamFunction;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clickElement,
+  clickMouse,
+  hoverElement,
+  moveMouse,
+  pressKey,
+  typeIntoEditor,
+  unhoverElement
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL21vYmlsZS10cnVzdGVkLWlucHV0LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogTW9iaWxlLW9ubHkgdHJ1c3RlZCBpbnB1dCBoZWxwZXJzLiBUaGVyZSBpcyBubyBpbi1yZW5kZXJlciByb3V0ZSB0byBhIHRydXN0ZWQgZXZlbnQgb24gYSBwaG9uZSBcdTIwMTRcbiAqIGB3ZWJDb250ZW50cy5zZW5kSW5wdXRFdmVudGAgaXMgRWxlY3Ryb24tb25seSBhbmQgYSBkaXNwYXRjaGVkIGV2ZW50IGlzIHVudHJ1c3RlZCBcdTIwMTQgc28gdGhlIGluamVjdGlvblxuICogaGFzIHRvIGJlIGEgcm91bmQtdHJpcDogdGhlIHJlcXVlc3QgZ29lcyB0byB0aGUgaG9zdCBvdmVyIHRoZSBgb2JzaWRpYW4taW50ZWdyYXRpb24tdGVzdGluZ2AgaGFybmVzcydzXG4gKiBiaW5kaW5nIGNoYW5uZWwsIGFuZCB0aGUgaG9zdCBpbmplY3RzIGl0IGludG8gdGhlIFdlYlZpZXcgb3ZlciBDRFAgXHUyMDE0IGFzIGBJbnB1dC5kaXNwYXRjaFRvdWNoRXZlbnRgIGZvclxuICogYSB0YXAgYnV0IGBJbnB1dC5zeW50aGVzaXplVGFwR2VzdHVyZWAgZm9yIGEgbG9uZy1wcmVzcywgYmVjYXVzZSBgZGlzcGF0Y2hUb3VjaEV2ZW50YCBpbmplY3RzIHBhc3RcbiAqIEFuZHJvaWQncyBnZXN0dXJlIHJlY29nbml6ZXIgYW5kIHNvIGlzIGNsYXNzaWZpZWQgYXMgYSB0YXAgYXQgYW55IGR3ZWxsLlxuICpcbiAqIFRoYXQgY2hhbm5lbCBpcyBpbnN0YWxsZWQgYnkgdGhlIGhhcm5lc3MncyBBcHBpdW0gdHJhbnNwb3J0LCBzbyB0aGVzZSBoZWxwZXJzICoqZGVsZWdhdGUqKiB0byB0aGVcbiAqIGhhcm5lc3MgcmF0aGVyIHRoYW4gcmVpbXBsZW1lbnRpbmcgdGhlIHdpcmUgZm9ybWF0OiB0aGV5IGNhbGxcbiAqIGB3aW5kb3cuX19vYnNpZGlhbkludGVncmF0aW9uVGVzdGluZy50cnVzdGVkSW5wdXQuKmAsIHdoaWNoIGhvbGRzIHRoZSB2ZXJ5IGZ1bmN0aW9uIG9iamVjdHMgdGhlIGhhcm5lc3NcbiAqIHNlZWRzIGludG8gYW4gYGV2YWxJbk9ic2lkaWFuYCBjbG9zdXJlJ3MgYGxpYmAgYmFnLiBEZWxlZ2F0aW5nIGlzIHdoYXQga2VlcHMgdGhlIG1vYmlsZSBzZW1hbnRpY3MgXHUyMDE0XG4gKiB0YXAsIGxvbmctcHJlc3MgZm9yIGBidXR0b246ICdyaWdodCdgLCBhIHRocm93IGZvciBgJ21pZGRsZSdgLCB0aGUgYHByZXNzS2V5YCBrZXkgc2V0LCBhbmQgdGhlIHRocm93c1xuICogZm9yIHRoZSBgOmhvdmVyYCBoZWxwZXJzIFx1MjAxNCBpZGVudGljYWwgdG8gdGhlIGhhcm5lc3MncyBvd24gY29weSBmb3IgZnJlZSwgaW5zdGVhZCBvZiBhIHNlY29uZFxuICogaW1wbGVtZW50YXRpb24gdG8gaGFuZC1zeW5jLlxuICpcbiAqIFRoZSBuYW1lc3BhY2Ugc2hhcGUgaXMgZGVjbGFyZWQgKipsb2NhbGx5Kio6IHRoZSBoYXJuZXNzIG11c3QgbmV2ZXIgYmUgYSBkZXBlbmRlbmN5IG9mIHRoaXMgbGlicmFyeSwgaW5cbiAqIGVpdGhlciBkaXJlY3Rpb24sIGF0IHJ1bnRpbWUgb3IgaW4gdHlwZXMuXG4gKlxuICogKipDb25zZXF1ZW5jZSwgYW5kIGl0IGlzIGRlbGliZXJhdGU6KiogdGhlc2UgaGVscGVycyBvbmx5IHdvcmsgaW5zaWRlIGFuIGFwcCB0aGUgaGFybmVzcyBib290c3RyYXBwZWQuXG4gKiBPdXRzaWRlIG9uZSB0aGV5IHRocm93IGEgbWVzc2FnZSBzYXlpbmcgc28sIHJhdGhlciB0aGFuIHNpbGVudGx5IGRvaW5nIG5vdGhpbmcgXHUyMDE0IGEgbm8tb3Agd291bGQgcmVjcmVhdGVcbiAqIGV4YWN0bHkgdGhlIGZhbHNlLWNvbmZpZGVuY2UgZmFpbHVyZSB0cnVzdGVkIGlucHV0IGV4aXN0cyB0byBlbmQuIENvbnN1bWVycyB3YW50aW5nIHRoZSBwbGF0Zm9ybS1jb3JyZWN0XG4gKiBoZWxwZXIgc2hvdWxkIGltcG9ydCB0aGUge0BsaW5rIC4uL3RydXN0ZWQtaW5wdXQudHMgfCB0cnVzdGVkLWlucHV0fSBmYWNhZGUgaW5zdGVhZCBvZiB0aGlzIG1vZHVsZS5cbiAqXG4gKiBUaGUgcGFyYW1zIGFyZSBmb3J3YXJkZWQgdW50b3VjaGVkLCBgd2luZG93YCBpbmNsdWRlZCwgc28gdGhlIGhhcm5lc3MncyBvd24gcmVmdXNhbCBvZiBhbnkgd2luZG93IGJ1dFxuICogdGhlIG1haW4gb25lIGFwcGxpZXMgaGVyZSB0b286IE9ic2lkaWFuIE1vYmlsZSBoYXMgbm8gcG9wb3V0IHdpbmRvd3MgdG8gc2VuZCBpbnB1dCB0by5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIENsaWNrRWxlbWVudFBhcmFtcyxcbiAgQ2xpY2tNb3VzZVBhcmFtcyxcbiAgSG92ZXJFbGVtZW50UGFyYW1zLFxuICBNb3ZlTW91c2VQYXJhbXMsXG4gIFByZXNzS2V5UGFyYW1zLFxuICBUeXBlSW50b0VkaXRvclBhcmFtcyxcbiAgVW5ob3ZlckVsZW1lbnRQYXJhbXNcbiAgLy8gVGhlIHBhcmFtZXRlciBjb250cmFjdHMgbGl2ZSB3aXRoIHRoZSBkZXNrdG9wIHR3aW4gYW5kIGFyZSBzaGFyZWQgdmVyYmF0aW0sIHNvIHRoZSB0d28gcGxhdGZvcm1zXG4gIC8vIGNhbm5vdCBkcmlmdCBhcGFydCBvbiB3aGF0IGEgY2FsbGVyIHBhc3Nlcy4gQSB0eXBlLW9ubHkgaW1wb3J0IGxvYWRzIG5vdGhpbmcgYXQgcnVudGltZSwgc28gdGhpc1xuICAvLyBpbXBvcnQgbGVhdmVzIHRoZSBtb2R1bGUgbW9iaWxlLXNhZmUuXG59IGZyb20gJy4vZGVza3RvcC10cnVzdGVkLWlucHV0LnRzJztcblxuLyoqXG4gKiBUaGUgZ2xvYmFsIHRoZSBoYXJuZXNzIGJvb3RzdHJhcHMgaXRzIG5hbWVzcGFjZSBvbnRvLlxuICovXG5pbnRlcmZhY2UgT2JzaWRpYW5JbnRlZ3JhdGlvblRlc3RpbmdIb2xkZXIge1xuICBfX29ic2lkaWFuSW50ZWdyYXRpb25UZXN0aW5nOiBPYnNpZGlhbkludGVncmF0aW9uVGVzdGluZ05hbWVzcGFjZTtcbn1cblxuLyoqXG4gKiBUaGUgcGFydCBvZiB0aGUgaGFybmVzcyBuYW1lc3BhY2UgdGhpcyBtb2R1bGUgcmVhZHMuIEV2ZXJ5dGhpbmcgZWxzZSBvbiBpdCBpcyBub25lIG9mIHRoaXMgbW9kdWxlJ3NcbiAqIGJ1c2luZXNzLlxuICovXG5pbnRlcmZhY2UgT2JzaWRpYW5JbnRlZ3JhdGlvblRlc3RpbmdOYW1lc3BhY2Uge1xuICB0cnVzdGVkSW5wdXQ/OiBQYXJ0aWFsPFRydXN0ZWRJbnB1dFNlYW0+O1xufVxuXG4vKipcbiAqIFRoZSB0cnVzdGVkLWlucHV0IHNlYW0gdGhlIGBvYnNpZGlhbi1pbnRlZ3JhdGlvbi10ZXN0aW5nYCBoYXJuZXNzIHB1Ymxpc2hlcyBvbiBpdHMgbmFtZXNwYWNlLlxuICpcbiAqIERlY2xhcmVkIGhlcmUgcmF0aGVyIHRoYW4gaW1wb3J0ZWQ6IHRoZSBoYXJuZXNzIGlzIG5vdCBhIGRlcGVuZGVuY3kgb2YgdGhpcyBsaWJyYXJ5LiBJdCBtaXJyb3JzXG4gKiBgbmFtZXNwYWNlLWJvb3RzdHJhcC50c2AncyBgdHJ1c3RlZElucHV0YCBvYmplY3QsIGFuZCB0aGUgbWlycm9yaW5nIGlzIGJ5IGhhbmQgXHUyMDE0IHRoZSBzYW1lXG4gKiBiZWhhdmlvcmFsLXN5bmMgb2JsaWdhdGlvbiB0aGUgZGVza3RvcCB0d2luIGNhcnJpZXMuXG4gKi9cbmludGVyZmFjZSBUcnVzdGVkSW5wdXRTZWFtIHtcbiAgY2xpY2tFbGVtZW50OiAocGFyYW1zOiBDbGlja0VsZW1lbnRQYXJhbXMpID0+IFByb21pc2U8dm9pZD47XG4gIGNsaWNrTW91c2U6IChwYXJhbXM6IENsaWNrTW91c2VQYXJhbXMpID0+IFByb21pc2U8dm9pZD47XG4gIGhvdmVyRWxlbWVudDogKHBhcmFtczogSG92ZXJFbGVtZW50UGFyYW1zKSA9PiBQcm9taXNlPHZvaWQ+O1xuICBtb3ZlTW91c2U6IChwYXJhbXM6IE1vdmVNb3VzZVBhcmFtcykgPT4gUHJvbWlzZTx2b2lkPjtcbiAgcHJlc3NLZXk6IChwYXJhbXM6IFByZXNzS2V5UGFyYW1zKSA9PiBQcm9taXNlPHZvaWQ+O1xuICB0eXBlSW50b0VkaXRvcjogKHBhcmFtczogVHlwZUludG9FZGl0b3JQYXJhbXMpID0+IFByb21pc2U8dm9pZD47XG4gIHVuaG92ZXJFbGVtZW50OiAocGFyYW1zOiBVbmhvdmVyRWxlbWVudFBhcmFtcykgPT4gUHJvbWlzZTx2b2lkPjtcbn1cblxuLyoqXG4gKiBDbGlja3MgdGhlIGNlbnRlciBvZiBhbiBlbGVtZW50IHVzaW5nICoqdHJ1c3RlZCoqIHRvdWNoIGlucHV0LCBpbmplY3RlZCBpbnRvIHRoZSBXZWJWaWV3IGJ5IHRoZSBob3N0XG4gKiBvdmVyIENEUC5cbiAqXG4gKiBUaGUgZWxlbWVudC1yZWxhdGl2ZSBjb3VudGVycGFydCBvZiB7QGxpbmsgY2xpY2tNb3VzZX0uIGBidXR0b246ICdyaWdodCdgIGlzIHRoZSBsb25nLXByZXNzIHRoYXQgb3BlbnNcbiAqIE9ic2lkaWFuIE1vYmlsZSdzIGNvbnRleHQgbWVudTsgYCdtaWRkbGUnYCB0aHJvd3MsIGJlY2F1c2UgdG91Y2ggaGFzIG5vIGdlc3R1cmUgZm9yIGl0IGFuZCBpbnZlbnRpbmdcbiAqIG9uZSB3b3VsZCBiZSB3b3JzZSB0aGFuIHNheWluZyBzby5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGVsZW1lbnQgdG8gY2xpY2ssIHRoZSBidXR0b24gdG8gcHJlc3MgYW5kIGFueSBtb2RpZmllcnMgdG8gaG9sZC5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgb25jZSB0aGUgY2xpY2sgaGFzIGJlZW4gaW5qZWN0ZWQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBjbGlja0VsZW1lbnQocGFyYW1zOiBDbGlja0VsZW1lbnRQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgYXdhaXQgZ2V0U2VhbUZ1bmN0aW9uKCdjbGlja0VsZW1lbnQnKShwYXJhbXMpO1xufVxuXG4vKipcbiAqIENsaWNrcyBhdCB0aGUgZ2l2ZW4gdmlld3BvcnQgY29vcmRpbmF0ZXMgdXNpbmcgKip0cnVzdGVkKiogdG91Y2ggaW5wdXQsIGluamVjdGVkIGJ5IHRoZSBob3N0IG92ZXIgQ0RQLlxuICpcbiAqIFRoZSBjb29yZGluYXRlcyBhcmUgQ1NTIHBpeGVscyBpbiB0aGUgV2ViVmlldydzIG93biB2aWV3cG9ydCBcdTIwMTQgd2hpY2ggaXMgd2hhdCBDRFAgdGFrZXMgXHUyMDE0IHNvXG4gKiBgZGV2aWNlUGl4ZWxSYXRpb2AgbmV2ZXIgZW50ZXJzIHRoZSBwaWN0dXJlLlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgdmlld3BvcnQgY29vcmRpbmF0ZXMgdG8gY2xpY2sgYXQsIHRoZSBidXR0b24gdG8gcHJlc3MgYW5kIGFueSBtb2RpZmllcnMgdG8gaG9sZC5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgb25jZSB0aGUgY2xpY2sgaGFzIGJlZW4gaW5qZWN0ZWQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBjbGlja01vdXNlKHBhcmFtczogQ2xpY2tNb3VzZVBhcmFtcyk6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCBnZXRTZWFtRnVuY3Rpb24oJ2NsaWNrTW91c2UnKShwYXJhbXMpO1xufVxuXG4vKipcbiAqIEFsd2F5cyB0aHJvd3M6IGA6aG92ZXJgIGhhcyBubyB0b3VjaCBlcXVpdmFsZW50LlxuICpcbiAqIEEgc2lsZW50IG5vLW9wIGhlcmUgd291bGQgbGV0IGEgaG92ZXIgdGVzdCBwYXNzIG9uIGEgcGhvbmUgd2l0aG91dCBob3ZlcmluZyBhbnl0aGluZywgc28gdGhlIG1vYmlsZSBhcm1cbiAqIHJlZnVzZXMgaW5zdGVhZC4gR2F0ZSB0aGUgYXNzZXJ0aW9uIG9uIGBQbGF0Zm9ybS5pc0Rlc2t0b3BBcHBgLCBvciBkcml2ZSB0aGUgZWxlbWVudCB3aXRoXG4gKiB7QGxpbmsgY2xpY2tFbGVtZW50fS5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGVsZW1lbnQgdG8gaG92ZXIuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IG5ldmVyIHJlc29sdmVzIFx1MjAxNCB0aGUgY2FsbCB0aHJvd3MuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBob3ZlckVsZW1lbnQocGFyYW1zOiBIb3ZlckVsZW1lbnRQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgYXdhaXQgZ2V0U2VhbUZ1bmN0aW9uKCdob3ZlckVsZW1lbnQnKShwYXJhbXMpO1xufVxuXG4vKipcbiAqIEFsd2F5cyB0aHJvd3M6IGEgdG91Y2ggc2NyZWVuIGhhcyBubyBwZXJzaXN0ZW50IHBvaW50ZXIgdG8gbW92ZS5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHZpZXdwb3J0IGNvb3JkaW5hdGVzIHRvIG1vdmUgdG8uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IG5ldmVyIHJlc29sdmVzIFx1MjAxNCB0aGUgY2FsbCB0aHJvd3MuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBtb3ZlTW91c2UocGFyYW1zOiBNb3ZlTW91c2VQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgYXdhaXQgZ2V0U2VhbUZ1bmN0aW9uKCdtb3ZlTW91c2UnKShwYXJhbXMpO1xufVxuXG4vKipcbiAqIFByZXNzZXMgYSBzaW5nbGUga2V5IHVzaW5nICoqdHJ1c3RlZCoqIGtleWJvYXJkIGlucHV0LCBpbmplY3RlZCBieSB0aGUgaG9zdCBvdmVyIENEUC5cbiAqXG4gKiBOYW1lZCBrZXlzIChgJ0VudGVyJ2AsIGAnRXNjYXBlJ2AsIGAnVGFiJ2AsIGAnQmFja3NwYWNlJ2AsIGAnRGVsZXRlJ2AsIHRoZSBhcnJvd3MpIGFuZCBzaW5nbGUgcHJpbnRhYmxlXG4gKiBjaGFyYWN0ZXJzIGFyZSBzdXBwb3J0ZWQ7IGFueXRoaW5nIGVsc2UgdGhyb3dzIHJhdGhlciB0aGFuIHByZXNzaW5nIG5vdGhpbmcuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBrZXkgdG8gcHJlc3MgYW5kIGFueSBtb2RpZmllcnMgdG8gaG9sZC5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgb25jZSB0aGUga2V5IHByZXNzIGhhcyBiZWVuIGluamVjdGVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcHJlc3NLZXkocGFyYW1zOiBQcmVzc0tleVBhcmFtcyk6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCBnZXRTZWFtRnVuY3Rpb24oJ3ByZXNzS2V5JykocGFyYW1zKTtcbn1cblxuLyoqXG4gKiBUeXBlcyB0ZXh0IGludG8gYSBDb2RlTWlycm9yIGVkaXRvciB1c2luZyAqKnRydXN0ZWQqKiBrZXlib2FyZCBpbnB1dCwgaW5qZWN0ZWQgYnkgdGhlIGhvc3Qgb3ZlciBDRFAuXG4gKlxuICogRm9jdXNlcyB0aGUgZWRpdG9yIChjYXJldCB0byB0aGUgZW5kKSwgcHJlc3NlcyBldmVyeSBjb2RlIHBvaW50IG9mIHRoZSB0ZXh0LCB0aGVuIHBvbGxzIHVudGlsIHRoZVxuICogZG9jdW1lbnQgcmVmbGVjdHMgdGhlIGlucHV0IG9yIGEgYm91bmRlZCB0aW1lb3V0IGVsYXBzZXMuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBlZGl0b3IgdG8gdHlwZSBpbnRvIGFuZCB0aGUgdGV4dCB0byB0eXBlLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyBvbmNlIHRoZSBrZXlzdHJva2VzIGhhdmUgc2V0dGxlZC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHR5cGVJbnRvRWRpdG9yKHBhcmFtczogVHlwZUludG9FZGl0b3JQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgYXdhaXQgZ2V0U2VhbUZ1bmN0aW9uKCd0eXBlSW50b0VkaXRvcicpKHBhcmFtcyk7XG59XG5cbi8qKlxuICogQWx3YXlzIHRocm93cywgZm9yIHRoZSBzYW1lIHJlYXNvbiBhcyB7QGxpbmsgaG92ZXJFbGVtZW50fTogdGhlcmUgaXMgbm8gYDpob3ZlcmAgc3RhdGUgdG8gY2xlYXIuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBlbGVtZW50IHRvIG1vdmUgdGhlIHBvaW50ZXIgYXdheSBmcm9tLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCBuZXZlciByZXNvbHZlcyBcdTIwMTQgdGhlIGNhbGwgdGhyb3dzLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gdW5ob3ZlckVsZW1lbnQocGFyYW1zOiBVbmhvdmVyRWxlbWVudFBhcmFtcyk6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCBnZXRTZWFtRnVuY3Rpb24oJ3VuaG92ZXJFbGVtZW50JykocGFyYW1zKTtcbn1cblxuZnVuY3Rpb24gZ2V0U2VhbUZ1bmN0aW9uPEtleSBleHRlbmRzIGtleW9mIFRydXN0ZWRJbnB1dFNlYW0+KG5hbWU6IEtleSk6IFRydXN0ZWRJbnB1dFNlYW1bS2V5XSB7XG4gIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBvYnNpZGlhbm1kL25vLWdsb2JhbC10aGlzIC0tIFRoZSBoYXJuZXNzIGluc3RhbGxzIGl0cyBuYW1lc3BhY2Ugb24gdGhlIHJlYWxtIGdsb2JhbDsgdGhlcmUgaXMgbm93aGVyZSBlbHNlIHRvIHJlYWQgaXQgZnJvbS5cbiAgY29uc3QgaG9sZGVyID0gZ2xvYmFsVGhpcyBhcyBQYXJ0aWFsPE9ic2lkaWFuSW50ZWdyYXRpb25UZXN0aW5nSG9sZGVyPjtcbiAgY29uc3Qgc2VhbUZ1bmN0aW9uID0gaG9sZGVyLl9fb2JzaWRpYW5JbnRlZ3JhdGlvblRlc3Rpbmc/LnRydXN0ZWRJbnB1dD8uW25hbWVdO1xuICBpZiAoIXNlYW1GdW5jdGlvbikge1xuICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgIGBUcnVzdGVkIGlucHV0IGlzIHVuYXZhaWxhYmxlIG9uIG1vYmlsZTogXFxgd2luZG93Ll9fb2JzaWRpYW5JbnRlZ3JhdGlvblRlc3RpbmcudHJ1c3RlZElucHV0LiR7bmFtZX1cXGAgaXMgbm90IGluc3RhbGxlZC4gYFxuICAgICAgICArICdBIHBob25lIGhhcyBubyBpbi1yZW5kZXJlciByb3V0ZSB0byBhIHRydXN0ZWQgZXZlbnQsIHNvIHRoZSBpbmplY3Rpb24gaXMgYSByb3VuZC10cmlwIHRvIHRoZSBob3N0IG92ZXIgdGhlICdcbiAgICAgICAgKyAnYG9ic2lkaWFuLWludGVncmF0aW9uLXRlc3RpbmdgIEFwcGl1bSB0cmFuc3BvcnRcXCdzIGNoYW5uZWwgXHUyMDE0IHdoaWNoIG1lYW5zIHRoZXNlIGhlbHBlcnMgb25seSB3b3JrIGluc2lkZSBhbiBhcHAgdGhhdCAnXG4gICAgICAgICsgJ2hhcm5lc3MgYm9vdHN0cmFwcGVkLidcbiAgICApO1xuICB9XG5cbiAgcmV0dXJuIHNlYW1GdW5jdGlvbjtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFzRkEsZUFBc0IsYUFBYSxRQUEyQztBQUM1RSxRQUFNLGdCQUFnQixjQUFjLEVBQUUsTUFBTTtBQUM5QztBQVdBLGVBQXNCLFdBQVcsUUFBeUM7QUFDeEUsUUFBTSxnQkFBZ0IsWUFBWSxFQUFFLE1BQU07QUFDNUM7QUFZQSxlQUFzQixhQUFhLFFBQTJDO0FBQzVFLFFBQU0sZ0JBQWdCLGNBQWMsRUFBRSxNQUFNO0FBQzlDO0FBUUEsZUFBc0IsVUFBVSxRQUF3QztBQUN0RSxRQUFNLGdCQUFnQixXQUFXLEVBQUUsTUFBTTtBQUMzQztBQVdBLGVBQXNCLFNBQVMsUUFBdUM7QUFDcEUsUUFBTSxnQkFBZ0IsVUFBVSxFQUFFLE1BQU07QUFDMUM7QUFXQSxlQUFzQixlQUFlLFFBQTZDO0FBQ2hGLFFBQU0sZ0JBQWdCLGdCQUFnQixFQUFFLE1BQU07QUFDaEQ7QUFRQSxlQUFzQixlQUFlLFFBQTZDO0FBQ2hGLFFBQU0sZ0JBQWdCLGdCQUFnQixFQUFFLE1BQU07QUFDaEQ7QUFFQSxTQUFTLGdCQUFvRCxNQUFrQztBQUU3RixRQUFNLFNBQVM7QUFDZixRQUFNLGVBQWUsT0FBTyw4QkFBOEIsZUFBZSxJQUFJO0FBQzdFLE1BQUksQ0FBQyxjQUFjO0FBQ2pCLFVBQU0sSUFBSTtBQUFBLE1BQ1IsOEZBQThGLElBQUk7QUFBQSxJQUlwRztBQUFBLEVBQ0Y7QUFFQSxTQUFPO0FBQ1Q7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/mobile-trusted-input.d.cts

@@ -0,0 +1,98 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Mobile-only trusted input helpers. There is no in-renderer route to a trusted event on a phone —
+ * `webContents.sendInputEvent` is Electron-only and a dispatched event is untrusted — so the injection
+ * has to be a round-trip: the request goes to the host over the `obsidian-integration-testing` harness's
+ * binding channel, and the host injects it into the WebView over CDP — as `Input.dispatchTouchEvent` for
+ * a tap but `Input.synthesizeTapGesture` for a long-press, because `dispatchTouchEvent` injects past
+ * Android's gesture recognizer and so is classified as a tap at any dwell.
+ *
+ * That channel is installed by the harness's Appium transport, so these helpers **delegate** to the
+ * harness rather than reimplementing the wire format: they call
+ * `window.__obsidianIntegrationTesting.trustedInput.*`, which holds the very function objects the harness
+ * seeds into an `evalInObsidian` closure's `lib` bag. Delegating is what keeps the mobile semantics —
+ * tap, long-press for `button: 'right'`, a throw for `'middle'`, the `pressKey` key set, and the throws
+ * for the `:hover` helpers — identical to the harness's own copy for free, instead of a second
+ * implementation to hand-sync.
+ *
+ * The namespace shape is declared **locally**: the harness must never be a dependency of this library, in
+ * either direction, at runtime or in types.
+ *
+ * **Consequence, and it is deliberate:** these helpers only work inside an app the harness bootstrapped.
+ * Outside one they throw a message saying so, rather than silently doing nothing — a no-op would recreate
+ * exactly the false-confidence failure trusted input exists to end. Consumers wanting the platform-correct
+ * helper should import the {@link ../trusted-input.ts | trusted-input} facade instead of this module.
+ *
+ * The params are forwarded untouched, `window` included, so the harness's own refusal of any window but
+ * the main one applies here too: Obsidian Mobile has no popout windows to send input to.
+ */
+import type { ClickElementParams, ClickMouseParams, HoverElementParams, MoveMouseParams, PressKeyParams, TypeIntoEditorParams, UnhoverElementParams } from './desktop-trusted-input.cjs';
+/**
+ * Clicks the center of an element using **trusted** touch input, injected into the WebView by the host
+ * over CDP.
+ *
+ * The element-relative counterpart of {@link clickMouse}. `button: 'right'` is the long-press that opens
+ * Obsidian Mobile's context menu; `'middle'` throws, because touch has no gesture for it and inventing
+ * one would be worse than saying so.
+ *
+ * @param params - The element to click, the button to press and any modifiers to hold.
+ * @returns A {@link Promise} that resolves once the click has been injected.
+ */
+export declare function clickElement(params: ClickElementParams): Promise<void>;
+/**
+ * Clicks at the given viewport coordinates using **trusted** touch input, injected by the host over CDP.
+ *
+ * The coordinates are CSS pixels in the WebView's own viewport — which is what CDP takes — so
+ * `devicePixelRatio` never enters the picture.
+ *
+ * @param params - The viewport coordinates to click at, the button to press and any modifiers to hold.
+ * @returns A {@link Promise} that resolves once the click has been injected.
+ */
+export declare function clickMouse(params: ClickMouseParams): Promise<void>;
+/**
+ * Always throws: `:hover` has no touch equivalent.
+ *
+ * A silent no-op here would let a hover test pass on a phone without hovering anything, so the mobile arm
+ * refuses instead. Gate the assertion on `Platform.isDesktopApp`, or drive the element with
+ * {@link clickElement}.
+ *
+ * @param params - The element to hover.
+ * @returns A {@link Promise} that never resolves — the call throws.
+ */
+export declare function hoverElement(params: HoverElementParams): Promise<void>;
+/**
+ * Always throws: a touch screen has no persistent pointer to move.
+ *
+ * @param params - The viewport coordinates to move to.
+ * @returns A {@link Promise} that never resolves — the call throws.
+ */
+export declare function moveMouse(params: MoveMouseParams): Promise<void>;
+/**
+ * Presses a single key using **trusted** keyboard input, injected by the host over CDP.
+ *
+ * Named keys (`'Enter'`, `'Escape'`, `'Tab'`, `'Backspace'`, `'Delete'`, the arrows) and single printable
+ * characters are supported; anything else throws rather than pressing nothing.
+ *
+ * @param params - The key to press and any modifiers to hold.
+ * @returns A {@link Promise} that resolves once the key press has been injected.
+ */
+export declare function pressKey(params: PressKeyParams): Promise<void>;
+/**
+ * Types text into a CodeMirror editor using **trusted** keyboard input, injected by the host over CDP.
+ *
+ * Focuses the editor (caret to the end), presses every code point of the text, then polls until the
+ * document reflects the input or a bounded timeout elapses.
+ *
+ * @param params - The editor to type into and the text to type.
+ * @returns A {@link Promise} that resolves once the keystrokes have settled.
+ */
+export declare function typeIntoEditor(params: TypeIntoEditorParams): Promise<void>;
+/**
+ * Always throws, for the same reason as {@link hoverElement}: there is no `:hover` state to clear.
+ *
+ * @param params - The element to move the pointer away from.
+ * @returns A {@link Promise} that never resolves — the call throws.
+ */
+export declare function unhoverElement(params: UnhoverElementParams): Promise<void>;