@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/cjs/components/syntax-highlighting-component.d.cts

@@ -0,0 +1,149 @@
+/// <reference path="../library.d.cts" />
+/**
+ * @file
+ *
+ * Contains class {@link SyntaxHighlightingComponent} that registers syntax highlighting languages.
+ *
+ * Obsidian highlights code in two independent places, through two separate registries, and a plugin adding
+ * its own language usually has to touch both:
+ *
+ * - **Prism** (`prism.languages[language]`) highlights code in reading view and in every `<pre><code>` the
+ *   library renders — including the {@link CodeHighlighterComponent} settings field.
+ * - **The CodeMirror 5 mode registry** (`window.CodeMirror.modes[language]`) highlights a fenced code block
+ *   inside the editor.
+ *
+ * The CodeMirror 5 half looks like legacy that should be migrated to CodeMirror 6. **It is not** — verified
+ * against the Obsidian 1.13.4 runtime:
+ *
+ * - Obsidian's own CodeMirror 6 editor language is a bridged CodeMirror 5 mode:
+ *   `StreamLanguage.define(CodeMirror.getMode({}, { name: 'hypermd' }))`.
+ * - Obsidian registers that `hypermd` mode through `window.CodeMirror.defineMode` with
+ *   `fencedCodeBlockHighlighting: true`, and that option resolves each fence's language through the
+ *   **CodeMirror 5 mode registry**.
+ * - There is no public or internal CodeMirror 6 language-registration API for fences.
+ *
+ * So `window.CodeMirror.defineMode` is the sanctioned extension point, not legacy debt. Do not reopen this
+ * as a migration.
+ *
+ * Teardown REMOVES the mode rather than redefining it to `null`. Plugins predating this component redefined
+ * the mode to `null` on unload, because it was unclear whether CodeMirror's `getMode` needs the entry to
+ * stay present. It does not — verified against a live Obsidian 1.13.4 by
+ * `syntax-highlighting-component.obsidian.integration.test.ts`: after the entry is deleted, the fence
+ * renders its text with no error and drops back to the exact token count it had before the language was
+ * ever registered.
+ */
+import type { Grammar, PrismModule } from '@obsidian-typings/obsidian-public-latest' with { 'resolution-mode': 'import' };
+import { ComponentEx } from './component-ex.cjs';
+/**
+ * The loaded Prism module, handed to a grammar factory.
+ */
+export interface SyntaxHighlightingComponentGrammarFactoryParams {
+    /**
+     * The loaded Prism module.
+     */
+    readonly prism: PrismModule;
+    /**
+     * Returns the grammar of an already registered Prism language, for nesting into the built grammar.
+     *
+     * @param language - The language to look up.
+     * @returns The grammar of the language.
+     * @throws An {@link Error} if the language is not registered.
+     */
+    readonly requirePrismLanguage: (language: string) => Grammar;
+}
+/**
+ * A grammar, the name of an already registered language to alias, or a factory that builds the grammar from
+ * the loaded Prism module.
+ */
+export type SyntaxHighlightingComponentGrammarSource = ((params: SyntaxHighlightingComponentGrammarFactoryParams) => Grammar) | Grammar | string;
+/**
+ * Parameters for {@link SyntaxHighlightingComponent.registerCodeBlockLanguage}.
+ */
+export interface SyntaxHighlightingComponentRegisterCodeBlockLanguageParams {
+    /**
+     * The CodeMirror 5 mode name or MIME type the editor highlights the fence as, e.g. `text/typescript`.
+     */
+    readonly editorMode: string;
+    /**
+     * The fence language, e.g. the `foo` in a ` ```foo ` code block.
+     */
+    readonly language: string;
+    /**
+     * The grammar highlighting the fence in reading view. Omit when the fence is replaced in reading view —
+     * e.g. a fence rendered as a button.
+     */
+    readonly prismGrammar?: SyntaxHighlightingComponentGrammarSource | undefined;
+}
+/**
+ * Parameters for {@link SyntaxHighlightingComponent.registerPrismLanguage}.
+ */
+export interface SyntaxHighlightingComponentRegisterPrismLanguageParams {
+    /**
+     * The grammar to register.
+     */
+    readonly grammar: SyntaxHighlightingComponentGrammarSource;
+    /**
+     * The language to register the grammar as.
+     */
+    readonly language: string;
+}
+/**
+ * A component that registers and unregisters syntax highlighting languages.
+ *
+ * @remarks
+ * Every registration is undone when the component is unloaded: the previous entry is restored if the
+ * language was already registered, otherwise the entry is removed.
+ */
+export declare class SyntaxHighlightingComponent extends ComponentEx {
+    /**
+     * Registers a fenced code block language, highlighting it in the editor and, optionally, in reading view.
+     *
+     * @param params - The parameters for registering the language.
+     * @returns A {@link Promise} that resolves when the language is registered.
+     *
+     * @example
+     * ```ts
+     * await component.registerCodeBlockLanguage({
+     *   editorMode: 'text/typescript',
+     *   language: 'my-language',
+     *   prismGrammar: 'typescript'
+     * });
+     * ```
+     */
+    registerCodeBlockLanguage(params: SyntaxHighlightingComponentRegisterCodeBlockLanguageParams): Promise<void>;
+    /**
+     * Registers a Prism language, highlighting it everywhere Prism renders code — reading view and the
+     * {@link CodeHighlighterComponent} settings field.
+     *
+     * @param params - The parameters for registering the language.
+     * @returns A {@link Promise} that resolves when the language is registered.
+     *
+     * @example
+     * ```ts
+     * await component.registerPrismLanguage({
+     *   grammar: {
+     *     keyword: /\bfoo\b/
+     *   },
+     *   language: 'my-language'
+     * });
+     * ```
+     */
+    registerPrismLanguage(params: SyntaxHighlightingComponentRegisterPrismLanguageParams): Promise<void>;
+    /**
+     * Returns the grammar of an already registered Prism language.
+     *
+     * @param prism - The loaded Prism module.
+     * @param language - The language to look up.
+     * @returns The grammar of the language.
+     * @throws An {@link Error} if the language is not registered.
+     */
+    private requirePrismLanguage;
+    /**
+     * Resolves a grammar source into the grammar to register.
+     *
+     * @param prism - The loaded Prism module.
+     * @param grammarSource - The grammar source to resolve.
+     * @returns The resolved grammar.
+     */
+    private resolveGrammar;
+}

package/dist/lib/cjs/components/templates-language-component.cjs

@@ -0,0 +1,276 @@
+/*
+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 templates_language_component_exports = {};
+__export(templates_language_component_exports, {
+  TemplatesLanguageComponent: () => TemplatesLanguageComponent
+});
+module.exports = __toCommonJS(templates_language_component_exports);
+var import_syntax_highlighting_component = require('./syntax-highlighting-component.cjs');
+const DEFAULT_FORMAT_PATTERN = /[a-zA-Z0-9_-]+/;
+const DEFAULT_TOKEN_PATTERN = /^[a-zA-Z0-9_]+/;
+const FORMAT_DELIMITER_PATTERN = /^:/;
+const PLACEHOLDER_PATTERN = /\{\{.+?\}\}/;
+const PREFIX_PATTERN = /^\{\{/;
+const SUFFIX_PATTERN = /\}\}$/;
+class TemplatesLanguageComponent extends import_syntax_highlighting_component.SyntaxHighlightingComponent {
+  extraGrammar;
+  formatSource;
+  language;
+  tokenPattern;
+  /**
+   * Creates a new instance of the {@link TemplatesLanguageComponent} class.
+   *
+   * @param params - The parameters for the component.
+   */
+  constructor(params) {
+    super();
+    this.extraGrammar = params.extraGrammar;
+    this.formatSource = params.formatSource ?? DEFAULT_FORMAT_PATTERN;
+    this.language = params.language;
+    this.tokenPattern = params.tokenPattern ?? DEFAULT_TOKEN_PATTERN;
+  }
+  /**
+   * Registers the language.
+   *
+   * @returns A {@link Promise} that resolves when the language is registered.
+   */
+  async onloadAsync() {
+    await this.registerPrismLanguage({
+      // The factory form is used unconditionally.
+      // The base resolves either form, so branching on whether this consumer needs Prism would buy nothing.
+      grammar: (factoryParams) => this.buildGrammar(factoryParams),
+      language: this.language
+    });
+  }
+  /**
+   * Builds the grammar this component registers.
+   *
+   * @param factoryParams - The Prism module and language lookup handed to a grammar factory.
+   * @returns The grammar.
+   */
+  // eslint-disable-next-line obsidian-dev-utils/params-options-name-match -- This implements the exported grammar-factory signature of the base class, so it takes that seam's own parameter type rather than one named after this method.
+  buildGrammar(factoryParams) {
+    const formatToken = this.resolveFormatToken(factoryParams);
+    const grammar = this.formatSource instanceof RegExp ? {
+      expression: this.buildPlaceholderToken({
+        formatToken,
+        pattern: PLACEHOLDER_PATTERN
+      })
+    } : {
+      expression: this.buildPlaceholderToken({
+        formatToken: null,
+        pattern: buildPattern([this.tokenPattern])
+      }),
+      expressionWithFormat: this.buildPlaceholderToken({
+        formatToken,
+        pattern: buildPattern([this.tokenPattern, FORMAT_DELIMITER_PATTERN, formatToken.pattern])
+      })
+    };
+    if (this.extraGrammar !== void 0) {
+      Object.assign(grammar, this.extraGrammar);
+    }
+    return grammar;
+  }
+  /**
+   * Builds the token describing a whole placeholder.
+   *
+   * @param params - The resolved format token and the placeholder's extent pattern.
+   * @returns The placeholder token.
+   */
+  buildPlaceholderToken(params) {
+    const prefixToken = {
+      alias: "regex",
+      pattern: PREFIX_PATTERN
+    };
+    const tokenToken = {
+      alias: "number",
+      pattern: this.tokenPattern
+    };
+    const suffixToken = {
+      alias: "regex",
+      pattern: SUFFIX_PATTERN
+    };
+    return {
+      greedy: true,
+      inside: {
+        /* eslint-disable perfectionist/sort-objects -- Prism matches the entries in order, so the order is behavior. */
+        prefix: prefixToken,
+        token: tokenToken,
+        ...params.formatToken !== null && {
+          formatDelimiter: {
+            alias: "regex",
+            pattern: FORMAT_DELIMITER_PATTERN
+          },
+          format: params.formatToken
+        },
+        suffix: suffixToken
+        /* eslint-enable perfectionist/sort-objects -- Prism matches the entries in order, so the order is behavior. */
+      },
+      pattern: params.pattern
+    };
+  }
+  /**
+   * Resolves the configured format source into the Prism token describing the format half.
+   *
+   * @param factoryParams - The Prism module and language lookup handed to a grammar factory.
+   * @returns The format token.
+   */
+  // eslint-disable-next-line obsidian-dev-utils/params-options-name-match -- Forwards the base class's exported grammar-factory parameter type to a caller-supplied factory, so it cannot take a type named after this method.
+  resolveFormatToken(factoryParams) {
+    if (this.formatSource instanceof RegExp) {
+      return {
+        alias: "string",
+        pattern: this.formatSource
+      };
+    }
+    return typeof this.formatSource === "function" ? this.formatSource(factoryParams) : this.formatSource;
+  }
+}
+function buildPattern(parts) {
+  return new RegExp([PREFIX_PATTERN, ...parts, SUFFIX_PATTERN].map((part) => getUnanchoredSource(part)).join(""));
+}
+function getUnanchoredSource(pattern) {
+  let source = pattern.source;
+  if (source.startsWith("^")) {
+    source = source.slice(1);
+  }
+  if (source.endsWith("$") && !source.endsWith(String.raw`\$`)) {
+    source = source.slice(0, -1);
+  }
+  return source;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TemplatesLanguageComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvdGVtcGxhdGVzLWxhbmd1YWdlLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIGNsYXNzIHtAbGluayBUZW1wbGF0ZXNMYW5ndWFnZUNvbXBvbmVudH0gdGhhdCByZWdpc3RlcnMgYSBQcmlzbSBsYW5ndWFnZSBoaWdobGlnaHRpbmdcbiAqIGB7e3Rva2VufX1gIC8gYHt7dG9rZW46Zm9ybWF0fX1gIHBsYWNlaG9sZGVycy5cbiAqXG4gKiAqKlRoZSBsYW5ndWFnZSBpcyBPYnNpZGlhbiBjb3JlJ3Mgb3duLCBub3QgYW4gaW52ZW50aW9uIG9mIHRoaXMgbGlicmFyeS4qKiBge3t0b2tlbjpmb3JtYXR9fWAgaXMgdGhlIHN5bnRheCBjb3JlJ3NcbiAqICoqVGVtcGxhdGVzKiogcGx1Z2luIGRlZmluZXMsIHZlcmlmaWVkIGluIHRoZSBzaGlwcGVkIGFwcCByYXRoZXIgdGhhbiByZWNhbGxlZCBcdTIwMTQgYG9ic2lkaWFuLmFzYXIvaTE4bi5qc2AsXG4gKiB0aGUgYHRlbXBsYXRlczpgIGJsb2NrOlxuICpcbiAqIGBgYHRleHRcbiAqIG9wdGlvblRlbXBsYXRlRGF0ZUZvcm1hdERlc2NyaXB0aW9uOiAgJ3t7ZGF0ZX19IGluIHRoZSB0ZW1wbGF0ZSBmaWxlIHdpbGwgYmUgcmVwbGFjZWQgd2l0aCB0aGlzIHZhbHVlLidcbiAqIG9wdGlvblRlbXBsYXRlRGF0ZUZvcm1hdERlc2NyaXB0aW9uMjogJ1lvdSBjYW4gYWxzbyB1c2Uge3tkYXRlOllZWVktTU0tRER9fSB0byBvdmVycmlkZSB0aGUgZm9ybWF0IG9uY2UuJ1xuICogb3B0aW9uVGVtcGxhdGVUaW1lRm9ybWF0RGVzY3JpcHRpb246ICAne3t0aW1lfX0gaW4gdGhlIHRlbXBsYXRlIGZpbGUgd2lsbCBiZSByZXBsYWNlZCB3aXRoIHRoaXMgdmFsdWUuJ1xuICogb3B0aW9uVGVtcGxhdGVUaW1lRm9ybWF0RGVzY3JpcHRpb24yOiAnWW91IGNhbiBhbHNvIHVzZSB7e3RpbWU6SEg6bW19fSB0byBvdmVycmlkZSB0aGUgZm9ybWF0IG9uY2UuJ1xuICogYGBgXG4gKlxuICogVGhhdCBtYXR0ZXJzIGZvciBhbnlvbmUgdGVtcHRlZCB0byBjaGFuZ2UgdGhlIGRlbGltaXRlcnM6IHRoZXkgYXJlIG5vdCBvdXJzIHRvIGNoYW5nZS4gQSBwbHVnaW4gZXh0ZW5kc1xuICogY29yZSdzIGxhbmd1YWdlIHdpdGggaXRzIG93biB0b2tlbiB2b2NhYnVsYXJ5LCBpdCBkb2VzIG5vdCBkZWZpbmUgYSBjb21wZXRpbmcgb25lLlxuICpcbiAqICoqQmV3YXJlIHRoZSBuZWFyLW1pc3Mgb24gdGhhdCBldmlkZW5jZS4qKiBBIGdyZXAgZm9yIGB7ey4uLn19YCBhY3Jvc3MgdGhlIGFwcCBidW5kbGUgcmV0dXJucyBtYW55IGhpdHNcbiAqIHRoYXQgcHJvdmUgbm90aGluZywgYmVjYXVzZSBPYnNpZGlhbidzIFVJIHN0cmluZ3MgYXJlIGkxOG5leHQgYW5kIGB7ey4uLn19YCBpcyBpMThuZXh0J3Mgb3duIGludGVycG9sYXRpb25cbiAqIHN5bnRheC4gVGhlIGxvYWQtYmVhcmluZyBoaXQgaXMgdGhlIGB0ZW1wbGF0ZXM6YCBibG9jayBxdW90ZWQgYWJvdmUgXHUyMDE0IHRoZSBjb3JlIHBsdWdpbidzIHVzZXItZmFjaW5nXG4gKiBzZXR0aW5ncyBkZXNjcmlwdGlvbi4gUmVhZCB0aGF0IGJsb2NrOyBkbyBub3QgY291bnQgYnJhY2VzLlxuICpcbiAqIFdoYXQgYSBjb25zdW1lciB2YXJpZXMgaXMgb25seSBpdHMgKip2b2NhYnVsYXJ5KiosIHdoaWNoIGlzIHdoeSB0aGlzIGNvbXBvbmVudCBpcyBwYXJhbWV0ZXJpemVkIHJhdGhlclxuICogdGhhbiBmaXhlZDogdGhlIGxhbmd1YWdlIGlkIGl0IHJlZ2lzdGVycyB1bmRlciwgdGhlIGNoYXJhY3RlcnMgYSB0b2tlbiBuYW1lIG1heSBjb250YWluLCB0aGUgc2hhcGUgb2YgdGhlXG4gKiBmb3JtYXQgaGFsZiwgYW5kIGFueSBleHRyYSB0b3AtbGV2ZWwgdG9rZW5zIGl0cyBvd24gdGVtcGxhdGUgZGlhbGVjdCBuZWVkcy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIEdyYW1tYXIsXG4gIFByaXNtVG9rZW5PYmplY3Rcbn0gZnJvbSAnQG9ic2lkaWFuLXR5cGluZ3Mvb2JzaWRpYW4tcHVibGljLWxhdGVzdCc7XG5cbmltcG9ydCB0eXBlIHsgU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50R3JhbW1hckZhY3RvcnlQYXJhbXMgfSBmcm9tICcuL3N5bnRheC1oaWdobGlnaHRpbmctY29tcG9uZW50LnRzJztcblxuaW1wb3J0IHsgU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50IH0gZnJvbSAnLi9zeW50YXgtaGlnaGxpZ2h0aW5nLWNvbXBvbmVudC50cyc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgdGhlIHtAbGluayBUZW1wbGF0ZXNMYW5ndWFnZUNvbXBvbmVudH0gY29uc3RydWN0b3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVGVtcGxhdGVzTGFuZ3VhZ2VDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIC8qKlxuICAgKiBFeHRyYSB0b3AtbGV2ZWwgZW50cmllcyBtZXJnZWQgaW50byB0aGUgYnVpbHQgZ3JhbW1hciwgZm9yIGEgZGlhbGVjdCB3aG9zZSB0ZW1wbGF0ZXMgY2Fycnkgc3ludGF4XG4gICAqIGJleW9uZCB0aGUgcGxhY2Vob2xkZXJzIHRoZW1zZWx2ZXMgXHUyMDE0IGEgcGF0aCBzZXBhcmF0b3IsIHNheS4gT21pdCB3aGVuIHRoZXJlIGlzIG5vbmUuXG4gICAqL1xuICByZWFkb25seSBleHRyYUdyYW1tYXI/OiBHcmFtbWFyIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBUaGUgZm9ybWF0IGhhbGYgb2YgYSBge3t0b2tlbjpmb3JtYXR9fWAgcGxhY2Vob2xkZXIuXG4gICAqXG4gICAqIERlZmF1bHRzIHRvIGEgc2NhbGFyIHdvcmQsIHdoaWNoIGlzIGNvcmUncyBvd24gc2hhcGUuXG4gICAqL1xuICByZWFkb25seSBmb3JtYXRTb3VyY2U/OiBUZW1wbGF0ZXNMYW5ndWFnZUNvbXBvbmVudEZvcm1hdFNvdXJjZSB8IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogVGhlIGxhbmd1YWdlIHRvIHJlZ2lzdGVyIHRoZSBncmFtbWFyIGFzLCBlLmcuIGBteS1wbHVnaW4tdGVtcGxhdGVgLlxuICAgKi9cbiAgcmVhZG9ubHkgbGFuZ3VhZ2U6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGNoYXJhY3RlcnMgYSB0b2tlbiBuYW1lIG1heSBjb250YWluLCBhbmNob3JlZCBhdCB0aGUgc3RhcnQgb2YgdGhlIHBsYWNlaG9sZGVyIGJvZHkuXG4gICAqXG4gICAqIERlZmF1bHRzIHRvIHdvcmQgY2hhcmFjdGVycy4gQSBkaWFsZWN0IHdob3NlIHRva2VuIG5hbWVzIGNhcnJ5IG1vcmUgXHUyMDE0IGEgY29tbWEtc2VwYXJhdGVkIGFyZ3VtZW50IGxpc3QsXG4gICAqIHNheSBcdTIwMTQgd2lkZW5zIGl0IGhlcmUuXG4gICAqL1xuICByZWFkb25seSB0b2tlblBhdHRlcm4/OiBSZWdFeHAgfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogVGhlIGZvcm1hdCBoYWxmIG9mIGEgYHt7dG9rZW46Zm9ybWF0fX1gIHBsYWNlaG9sZGVyLlxuICpcbiAqIC0gQSB7QGxpbmsgUmVnRXhwfSBkZXNjcmliZXMgYSAqKnNjYWxhcioqIGZvcm1hdCBcdTIwMTQgY29yZSdzIG93biBzaGFwZSwgZS5nLiB0aGUgYFlZWVktTU0tRERgIG9mXG4gKiAgIGB7e2RhdGU6WVlZWS1NTS1ERH19YCBcdTIwMTQgYW5kIGlzIHdyYXBwZWQgaW50byBhIGBzdHJpbmdgLWFsaWFzZWQgdG9rZW4uXG4gKiAtIEEge0BsaW5rIFByaXNtVG9rZW5PYmplY3R9IGRlc2NyaWJlcyBhICoqc3RydWN0dXJlZCoqIGZvcm1hdCwgdXNlZCB2ZXJiYXRpbSwgc28gYSBkaWFsZWN0IHdob3NlIGZvcm1hdFxuICogICBoYWxmIGlzIGFuIG9iamVjdCByYXRoZXIgdGhhbiBhIHdvcmQgY2FuIHN1cHBseSBpdHMgb3duIGBpbnNpZGVgIGdyYW1tYXIgYW5kIGV4dGVudCBgcGF0dGVybmAuXG4gKiAtIEEgKipmYWN0b3J5KiogaXMgdGhlIHN0cnVjdHVyZWQgZm9ybSBmb3IgYSBkaWFsZWN0IHRoYXQgbXVzdCBuZXN0IGFuIGFscmVhZHkgcmVnaXN0ZXJlZCBQcmlzbSBsYW5ndWFnZVxuICogICBpbnRvIHRoYXQgYGluc2lkZWAgXHUyMDE0IGl0IHJlY2VpdmVzIHRoZSBsb2FkZWQgUHJpc20gbW9kdWxlLCBzbyB0aGUgY29uc3VtZXIgbmV2ZXIgY2FsbHMgYGxvYWRQcmlzbWAuXG4gKi9cbmV4cG9ydCB0eXBlIFRlbXBsYXRlc0xhbmd1YWdlQ29tcG9uZW50Rm9ybWF0U291cmNlID1cbiAgfCAoKHBhcmFtczogU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50R3JhbW1hckZhY3RvcnlQYXJhbXMpID0+IFByaXNtVG9rZW5PYmplY3QpXG4gIHwgUHJpc21Ub2tlbk9iamVjdFxuICB8IFJlZ0V4cDtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgVGVtcGxhdGVzTGFuZ3VhZ2VDb21wb25lbnQuYnVpbGRQbGFjZWhvbGRlclRva2VufS5cbiAqL1xuaW50ZXJmYWNlIFRlbXBsYXRlc0xhbmd1YWdlQ29tcG9uZW50QnVpbGRQbGFjZWhvbGRlclRva2VuUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBQcmlzbSB0b2tlbiBkZXNjcmliaW5nIHRoZSBmb3JtYXQgaGFsZiwgb3IgYG51bGxgIGZvciBhIHBsYWNlaG9sZGVyIHRoYXQgY2FycmllcyBub25lLlxuICAgKi9cbiAgcmVhZG9ubHkgZm9ybWF0VG9rZW46IG51bGwgfCBQcmlzbVRva2VuT2JqZWN0O1xuXG4gIC8qKlxuICAgKiBUaGUgZXh0ZW50IG9mIHRoZSB3aG9sZSBwbGFjZWhvbGRlci5cbiAgICovXG4gIHJlYWRvbmx5IHBhdHRlcm46IFJlZ0V4cDtcbn1cblxuLyoqXG4gKiBUaGUgc2NhbGFyIGZvcm1hdCBoYWxmLCBtYXRjaGluZyBjb3JlJ3Mgb3duIGB7e2RhdGU6WVlZWS1NTS1ERH19YCBzaGFwZS5cbiAqL1xuY29uc3QgREVGQVVMVF9GT1JNQVRfUEFUVEVSTiA9IC9bYS16QS1aMC05Xy1dKy87XG5cbi8qKlxuICogVGhlIGNoYXJhY3RlcnMgYSB0b2tlbiBuYW1lIG1heSBjb250YWluLCBhbmNob3JlZCBhdCB0aGUgc3RhcnQgb2YgdGhlIHBsYWNlaG9sZGVyIGJvZHkuXG4gKi9cbmNvbnN0IERFRkFVTFRfVE9LRU5fUEFUVEVSTiA9IC9eW2EtekEtWjAtOV9dKy87XG5cbi8qKlxuICogVGhlIGA6YCBzZXBhcmF0aW5nIGEgdG9rZW4gZnJvbSBpdHMgZm9ybWF0LlxuICpcbiAqIFRoZSB0aHJlZSBkZWxpbWl0ZXIgcGF0dGVybnMgYXJlIGFuY2hvcmVkIGJlY2F1c2UgUHJpc20gdHJpZXMgZXZlcnkgYGluc2lkZWAgZW50cnkgYXQgZXZlcnkgcG9zaXRpb24gb2YgdGhlXG4gKiB0ZXh0IHN0aWxsIHVuY2xhaW1lZCwgbm90IG9ubHkgYXQgaXRzIGVkZ2VzLiBVbmFuY2hvcmVkLCBhIHN0cnVjdHVyZWQgZm9ybWF0J3Mgb3duIGA6YCByZWFkIGFzIGEgc2Vjb25kXG4gKiBkZWxpbWl0ZXIsIGFuZCBhIGB7e2AgLyBgfX1gIG5lc3RlZCBpbiBpdHMgc3RyaW5nIHJlYWQgYXMgYW5vdGhlciBwbGFjZWhvbGRlcidzLlxuICovXG5jb25zdCBGT1JNQVRfREVMSU1JVEVSX1BBVFRFUk4gPSAvXjovO1xuXG4vKipcbiAqIEEgd2hvbGUgcGxhY2Vob2xkZXIsIGxhemlseSBtYXRjaGVkIHNvIGFkamFjZW50IHBsYWNlaG9sZGVycyBkbyBub3QgbWVyZ2UgaW50byBvbmUuXG4gKi9cbmNvbnN0IFBMQUNFSE9MREVSX1BBVFRFUk4gPSAvXFx7XFx7Lis/XFx9XFx9LztcblxuLyoqXG4gKiBUaGUgb3BlbmluZyBge3tgLCBhbmNob3JlZCBhdCB0aGUgc3RhcnQgb2YgdGhlIHBsYWNlaG9sZGVyLlxuICovXG5jb25zdCBQUkVGSVhfUEFUVEVSTiA9IC9eXFx7XFx7LztcblxuLyoqXG4gKiBUaGUgY2xvc2luZyBgfX1gLCBhbmNob3JlZCBhdCB0aGUgZW5kIG9mIHRoZSBwbGFjZWhvbGRlci5cbiAqL1xuY29uc3QgU1VGRklYX1BBVFRFUk4gPSAvXFx9XFx9JC87XG5cbi8qKlxuICogUmVnaXN0ZXJzIGEgUHJpc20gbGFuZ3VhZ2UgaGlnaGxpZ2h0aW5nIHRoZSBge3t0b2tlbn19YCAvIGB7e3Rva2VuOmZvcm1hdH19YCBwbGFjZWhvbGRlcnMgb2YgYSBwbHVnaW4nc1xuICogdG9rZW5pemVkLXN0cmluZyB0ZW1wbGF0ZXMuXG4gKlxuICogQHJlbWFya3NcbiAqIFRoZSBsYW5ndWFnZSBpcyBub3QgYSBjb2RlIGZlbmNlIFx1MjAxNCBpdCBpcyByZW5kZXJlZCBieSB0aGUgYENvZGVIaWdobGlnaHRlckNvbXBvbmVudGAgZmllbGRzIG9mIGEgc2V0dGluZ3NcbiAqIHRhYiwgc28gb25seSB0aGUgUHJpc20gaGFsZiBvZiB7QGxpbmsgU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50fSBpcyB1c2VkLiBSZWdpc3RyYXRpb24gaXMgdW5kb25lIHdoZW5cbiAqIHRoZSBjb21wb25lbnQgdW5sb2FkcywgYXMgaXQgaXMgZm9yIGV2ZXJ5IHJlZ2lzdHJhdGlvbiB0aGF0IGJhc2UgbWFrZXMuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzXG4gKiB0aGlzLmFkZENoaWxkKG5ldyBUZW1wbGF0ZXNMYW5ndWFnZUNvbXBvbmVudCh7IGxhbmd1YWdlOiAnbXktcGx1Z2luLXRlbXBsYXRlJyB9KSk7XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGNsYXNzIFRlbXBsYXRlc0xhbmd1YWdlQ29tcG9uZW50IGV4dGVuZHMgU3ludGF4SGlnaGxpZ2h0aW5nQ29tcG9uZW50IHtcbiAgcHJpdmF0ZSByZWFkb25seSBleHRyYUdyYW1tYXI6IEdyYW1tYXIgfCB1bmRlZmluZWQ7XG4gIHByaXZhdGUgcmVhZG9ubHkgZm9ybWF0U291cmNlOiBUZW1wbGF0ZXNMYW5ndWFnZUNvbXBvbmVudEZvcm1hdFNvdXJjZTtcbiAgcHJpdmF0ZSByZWFkb25seSBsYW5ndWFnZTogc3RyaW5nO1xuICBwcml2YXRlIHJlYWRvbmx5IHRva2VuUGF0dGVybjogUmVnRXhwO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IGluc3RhbmNlIG9mIHRoZSB7QGxpbmsgVGVtcGxhdGVzTGFuZ3VhZ2VDb21wb25lbnR9IGNsYXNzLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBUZW1wbGF0ZXNMYW5ndWFnZUNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLmV4dHJhR3JhbW1hciA9IHBhcmFtcy5leHRyYUdyYW1tYXI7XG4gICAgdGhpcy5mb3JtYXRTb3VyY2UgPSBwYXJhbXMuZm9ybWF0U291cmNlID8/IERFRkFVTFRfRk9STUFUX1BBVFRFUk47XG4gICAgdGhpcy5sYW5ndWFnZSA9IHBhcmFtcy5sYW5ndWFnZTtcbiAgICB0aGlzLnRva2VuUGF0dGVybiA9IHBhcmFtcy50b2tlblBhdHRlcm4gPz8gREVGQVVMVF9UT0tFTl9QQVRURVJOO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyB0aGUgbGFuZ3VhZ2UuXG4gICAqXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgbGFuZ3VhZ2UgaXMgcmVnaXN0ZXJlZC5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBhc3luYyBvbmxvYWRBc3luYygpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBhd2FpdCB0aGlzLnJlZ2lzdGVyUHJpc21MYW5ndWFnZSh7XG4gICAgICAvLyBUaGUgZmFjdG9yeSBmb3JtIGlzIHVzZWQgdW5jb25kaXRpb25hbGx5LlxuICAgICAgLy8gVGhlIGJhc2UgcmVzb2x2ZXMgZWl0aGVyIGZvcm0sIHNvIGJyYW5jaGluZyBvbiB3aGV0aGVyIHRoaXMgY29uc3VtZXIgbmVlZHMgUHJpc20gd291bGQgYnV5IG5vdGhpbmcuXG4gICAgICBncmFtbWFyOiAoZmFjdG9yeVBhcmFtcykgPT4gdGhpcy5idWlsZEdyYW1tYXIoZmFjdG9yeVBhcmFtcyksXG4gICAgICBsYW5ndWFnZTogdGhpcy5sYW5ndWFnZVxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEJ1aWxkcyB0aGUgZ3JhbW1hciB0aGlzIGNvbXBvbmVudCByZWdpc3RlcnMuXG4gICAqXG4gICAqIEBwYXJhbSBmYWN0b3J5UGFyYW1zIC0gVGhlIFByaXNtIG1vZHVsZSBhbmQgbGFuZ3VhZ2UgbG9va3VwIGhhbmRlZCB0byBhIGdyYW1tYXIgZmFjdG9yeS5cbiAgICogQHJldHVybnMgVGhlIGdyYW1tYXIuXG4gICAqL1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW4tZGV2LXV0aWxzL3BhcmFtcy1vcHRpb25zLW5hbWUtbWF0Y2ggLS0gVGhpcyBpbXBsZW1lbnRzIHRoZSBleHBvcnRlZCBncmFtbWFyLWZhY3Rvcnkgc2lnbmF0dXJlIG9mIHRoZSBiYXNlIGNsYXNzLCBzbyBpdCB0YWtlcyB0aGF0IHNlYW0ncyBvd24gcGFyYW1ldGVyIHR5cGUgcmF0aGVyIHRoYW4gb25lIG5hbWVkIGFmdGVyIHRoaXMgbWV0aG9kLlxuICBwcml2YXRlIGJ1aWxkR3JhbW1hcihmYWN0b3J5UGFyYW1zOiBTeW50YXhIaWdobGlnaHRpbmdDb21wb25lbnRHcmFtbWFyRmFjdG9yeVBhcmFtcyk6IEdyYW1tYXIge1xuICAgIGNvbnN0IGZvcm1hdFRva2VuID0gdGhpcy5yZXNvbHZlRm9ybWF0VG9rZW4oZmFjdG9yeVBhcmFtcyk7XG5cbiAgICAvLyBBIHNjYWxhciBmb3JtYXQgaGFsZiBmaXRzIGluc2lkZSBPTkUgbGF6aWx5LW1hdGNoZWQgcGxhY2Vob2xkZXIgdG9rZW4uXG4gICAgLy8gVGhhdCBpcyB0aGUgc2hhcGUgY29yZSdzIG93biBge3tkYXRlOllZWVktTU0tRER9fWAgaGFzLlxuICAgIC8vIEl0IGlzIGFsc28gdGhlIHNoYXBlIGV2ZXJ5IGNvbnN1bWVyIGhhZCBiZWZvcmUgdGhpcyBjb21wb25lbnQgZXhpc3RlZCwgc28gZW1pdHRpbmcgZXhhY3RseSBpdCBsZWF2ZXMgdGhlbSB1bmNoYW5nZWQuXG4gICAgLy9cbiAgICAvLyBBIHN0cnVjdHVyZWQgZm9ybWF0IGhhbGYgZG9lcyBub3QgZml0IHRoYXQgc2hhcGUsIHNpbmNlIGl0cyBleHRlbnQgaXMgZGVzY3JpYmVkIGJ5IGl0cyBvd24gcGF0dGVybi5cbiAgICAvLyBUaGUgd2l0aC1mb3JtYXQgY2FzZSB0aGVyZWZvcmUgbmVlZHMgYSBwYXR0ZXJuIGJ1aWx0IGZyb20gdGhhdCBleHRlbnQuXG4gICAgLy8gVGhlIHdpdGhvdXQtZm9ybWF0IGNhc2UgbmVlZHMgb25lIHRoYXQgc3RvcHMgYmVmb3JlIHRoZSBkZWxpbWl0ZXIsIHNvIHRoZSB0d28gY2Fubm90IGNsYWltIHRoZSBzYW1lIHRleHQuXG4gICAgY29uc3QgZ3JhbW1hcjogR3JhbW1hciA9IHRoaXMuZm9ybWF0U291cmNlIGluc3RhbmNlb2YgUmVnRXhwXG4gICAgICA/IHtcbiAgICAgICAgZXhwcmVzc2lvbjogdGhpcy5idWlsZFBsYWNlaG9sZGVyVG9rZW4oe1xuICAgICAgICAgIGZvcm1hdFRva2VuLFxuICAgICAgICAgIHBhdHRlcm46IFBMQUNFSE9MREVSX1BBVFRFUk5cbiAgICAgICAgfSlcbiAgICAgIH1cbiAgICAgIDoge1xuICAgICAgICBleHByZXNzaW9uOiB0aGlzLmJ1aWxkUGxhY2Vob2xkZXJUb2tlbih7XG4gICAgICAgICAgZm9ybWF0VG9rZW46IG51bGwsXG4gICAgICAgICAgcGF0dGVybjogYnVpbGRQYXR0ZXJuKFt0aGlzLnRva2VuUGF0dGVybl0pXG4gICAgICAgIH0pLFxuICAgICAgICBleHByZXNzaW9uV2l0aEZvcm1hdDogdGhpcy5idWlsZFBsYWNlaG9sZGVyVG9rZW4oe1xuICAgICAgICAgIGZvcm1hdFRva2VuLFxuICAgICAgICAgIHBhdHRlcm46IGJ1aWxkUGF0dGVybihbdGhpcy50b2tlblBhdHRlcm4sIEZPUk1BVF9ERUxJTUlURVJfUEFUVEVSTiwgZm9ybWF0VG9rZW4ucGF0dGVybl0pXG4gICAgICAgIH0pXG4gICAgICB9O1xuXG4gICAgLy8gTWVyZ2VkIHJhdGhlciB0aGFuIHNwcmVhZCwgYmVjYXVzZSBzcHJlYWRpbmcgYSBgR3JhbW1hcmAgd2lkZW5zIGV2ZXJ5IG9wdGlvbmFsIG1lbWJlciBvZlxuICAgIC8vIGBHcmFtbWFyUmVzdGAgdG8gYWRtaXQgYHVuZGVmaW5lZGAsIHdoaWNoIGBleGFjdE9wdGlvbmFsUHJvcGVydHlUeXBlc2AgdGhlbiByZWZ1c2VzLlxuICAgIGlmICh0aGlzLmV4dHJhR3JhbW1hciAhPT0gdW5kZWZpbmVkKSB7XG4gICAgICBPYmplY3QuYXNzaWduKGdyYW1tYXIsIHRoaXMuZXh0cmFHcmFtbWFyKTtcbiAgICB9XG5cbiAgICByZXR1cm4gZ3JhbW1hcjtcbiAgfVxuXG4gIC8qKlxuICAgKiBCdWlsZHMgdGhlIHRva2VuIGRlc2NyaWJpbmcgYSB3aG9sZSBwbGFjZWhvbGRlci5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSByZXNvbHZlZCBmb3JtYXQgdG9rZW4gYW5kIHRoZSBwbGFjZWhvbGRlcidzIGV4dGVudCBwYXR0ZXJuLlxuICAgKiBAcmV0dXJucyBUaGUgcGxhY2Vob2xkZXIgdG9rZW4uXG4gICAqL1xuICBwcml2YXRlIGJ1aWxkUGxhY2Vob2xkZXJUb2tlbihwYXJhbXM6IFRlbXBsYXRlc0xhbmd1YWdlQ29tcG9uZW50QnVpbGRQbGFjZWhvbGRlclRva2VuUGFyYW1zKTogUHJpc21Ub2tlbk9iamVjdCB7XG4gICAgY29uc3QgcHJlZml4VG9rZW4gPSB7XG4gICAgICBhbGlhczogJ3JlZ2V4JyxcbiAgICAgIHBhdHRlcm46IFBSRUZJWF9QQVRURVJOXG4gICAgfTtcbiAgICBjb25zdCB0b2tlblRva2VuID0ge1xuICAgICAgYWxpYXM6ICdudW1iZXInLFxuICAgICAgcGF0dGVybjogdGhpcy50b2tlblBhdHRlcm5cbiAgICB9O1xuICAgIGNvbnN0IHN1ZmZpeFRva2VuID0ge1xuICAgICAgYWxpYXM6ICdyZWdleCcsXG4gICAgICBwYXR0ZXJuOiBTVUZGSVhfUEFUVEVSTlxuICAgIH07XG5cbiAgICByZXR1cm4ge1xuICAgICAgZ3JlZWR5OiB0cnVlLFxuICAgICAgaW5zaWRlOiB7XG4gICAgICAgIC8qIGVzbGludC1kaXNhYmxlIHBlcmZlY3Rpb25pc3Qvc29ydC1vYmplY3RzIC0tIFByaXNtIG1hdGNoZXMgdGhlIGVudHJpZXMgaW4gb3JkZXIsIHNvIHRoZSBvcmRlciBpcyBiZWhhdmlvci4gKi9cbiAgICAgICAgcHJlZml4OiBwcmVmaXhUb2tlbixcbiAgICAgICAgdG9rZW46IHRva2VuVG9rZW4sXG4gICAgICAgIC4uLihwYXJhbXMuZm9ybWF0VG9rZW4gIT09IG51bGwgJiYge1xuICAgICAgICAgIGZvcm1hdERlbGltaXRlcjoge1xuICAgICAgICAgICAgYWxpYXM6ICdyZWdleCcsXG4gICAgICAgICAgICBwYXR0ZXJuOiBGT1JNQVRfREVMSU1JVEVSX1BBVFRFUk5cbiAgICAgICAgICB9LFxuICAgICAgICAgIGZvcm1hdDogcGFyYW1zLmZvcm1hdFRva2VuXG4gICAgICAgIH0pLFxuICAgICAgICBzdWZmaXg6IHN1ZmZpeFRva2VuXG4gICAgICAgIC8qIGVzbGludC1lbmFibGUgcGVyZmVjdGlvbmlzdC9zb3J0LW9iamVjdHMgLS0gUHJpc20gbWF0Y2hlcyB0aGUgZW50cmllcyBpbiBvcmRlciwgc28gdGhlIG9yZGVyIGlzIGJlaGF2aW9yLiAqL1xuICAgICAgfSxcbiAgICAgIHBhdHRlcm46IHBhcmFtcy5wYXR0ZXJuXG4gICAgfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXNvbHZlcyB0aGUgY29uZmlndXJlZCBmb3JtYXQgc291cmNlIGludG8gdGhlIFByaXNtIHRva2VuIGRlc2NyaWJpbmcgdGhlIGZvcm1hdCBoYWxmLlxuICAgKlxuICAgKiBAcGFyYW0gZmFjdG9yeVBhcmFtcyAtIFRoZSBQcmlzbSBtb2R1bGUgYW5kIGxhbmd1YWdlIGxvb2t1cCBoYW5kZWQgdG8gYSBncmFtbWFyIGZhY3RvcnkuXG4gICAqIEByZXR1cm5zIFRoZSBmb3JtYXQgdG9rZW4uXG4gICAqL1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW4tZGV2LXV0aWxzL3BhcmFtcy1vcHRpb25zLW5hbWUtbWF0Y2ggLS0gRm9yd2FyZHMgdGhlIGJhc2UgY2xhc3MncyBleHBvcnRlZCBncmFtbWFyLWZhY3RvcnkgcGFyYW1ldGVyIHR5cGUgdG8gYSBjYWxsZXItc3VwcGxpZWQgZmFjdG9yeSwgc28gaXQgY2Fubm90IHRha2UgYSB0eXBlIG5hbWVkIGFmdGVyIHRoaXMgbWV0aG9kLlxuICBwcml2YXRlIHJlc29sdmVGb3JtYXRUb2tlbihmYWN0b3J5UGFyYW1zOiBTeW50YXhIaWdobGlnaHRpbmdDb21wb25lbnRHcmFtbWFyRmFjdG9yeVBhcmFtcyk6IFByaXNtVG9rZW5PYmplY3Qge1xuICAgIGlmICh0aGlzLmZvcm1hdFNvdXJjZSBpbnN0YW5jZW9mIFJlZ0V4cCkge1xuICAgICAgcmV0dXJuIHtcbiAgICAgICAgYWxpYXM6ICdzdHJpbmcnLFxuICAgICAgICBwYXR0ZXJuOiB0aGlzLmZvcm1hdFNvdXJjZVxuICAgICAgfTtcbiAgICB9XG5cbiAgICByZXR1cm4gdHlwZW9mIHRoaXMuZm9ybWF0U291cmNlID09PSAnZnVuY3Rpb24nID8gdGhpcy5mb3JtYXRTb3VyY2UoZmFjdG9yeVBhcmFtcykgOiB0aGlzLmZvcm1hdFNvdXJjZTtcbiAgfVxufVxuXG4vKipcbiAqIEJ1aWxkcyBhIHBsYWNlaG9sZGVyIGV4dGVudCBwYXR0ZXJuIGZyb20gdGhlIHBhcnRzIHRoYXQgc2l0IGJldHdlZW4gdGhlIGRlbGltaXRlcnMuXG4gKlxuICogQSBwYXJ0IGFuY2hvcmVkIHdpdGggYSBsZWFkaW5nIGBeYCBvciBhIHRyYWlsaW5nIGAkYCBcdTIwMTQgYXMgYSBwYXR0ZXJuIG1lYW50IGZvciBhIG5lc3RlZCBgaW5zaWRlYCBlbnRyeSBpcyBcdTIwMTQgaXNcbiAqIHNwbGljZWQgaW4gd2l0aG91dCB0aGF0IGFuY2hvciwgc2luY2UgaXQgbGFuZHMgaW4gdGhlIG1pZGRsZSBvZiB0aGUgYnVpbHQgcGF0dGVybiByYXRoZXIgdGhhbiBhdCBpdHMgZWRnZS5cbiAqIFRoZSBkZWxpbWl0ZXJzIHRoZW1zZWx2ZXMgYXJlIHN1Y2ggcGFydHMuXG4gKlxuICogQHBhcmFtIHBhcnRzIC0gVGhlIHBhdHRlcm5zIGJldHdlZW4gdGhlIG9wZW5pbmcgYHt7YCBhbmQgdGhlIGNsb3NpbmcgYH19YC5cbiAqIEByZXR1cm5zIFRoZSBwYXR0ZXJuLlxuICovXG5mdW5jdGlvbiBidWlsZFBhdHRlcm4ocGFydHM6IHJlYWRvbmx5IFJlZ0V4cFtdKTogUmVnRXhwIHtcbiAgcmV0dXJuIG5ldyBSZWdFeHAoW1BSRUZJWF9QQVRURVJOLCAuLi5wYXJ0cywgU1VGRklYX1BBVFRFUk5dLm1hcCgocGFydCkgPT4gZ2V0VW5hbmNob3JlZFNvdXJjZShwYXJ0KSkuam9pbignJykpO1xufVxuXG4vKipcbiAqIEdldHMgdGhlIHNvdXJjZSBvZiBhIHBhdHRlcm4gd2l0aG91dCBpdHMgbGVhZGluZyBgXmAgb3IgaXRzIHRyYWlsaW5nIHVuZXNjYXBlZCBgJGAuXG4gKlxuICogQHBhcmFtIHBhdHRlcm4gLSBUaGUgcGF0dGVybi5cbiAqIEByZXR1cm5zIFRoZSB1bmFuY2hvcmVkIHNvdXJjZS5cbiAqL1xuZnVuY3Rpb24gZ2V0VW5hbmNob3JlZFNvdXJjZShwYXR0ZXJuOiBSZWdFeHApOiBzdHJpbmcge1xuICBsZXQgc291cmNlID0gcGF0dGVybi5zb3VyY2U7XG4gIGlmIChzb3VyY2Uuc3RhcnRzV2l0aCgnXicpKSB7XG4gICAgc291cmNlID0gc291cmNlLnNsaWNlKDEpO1xuICB9XG4gIGlmIChzb3VyY2UuZW5kc1dpdGgoJyQnKSAmJiAhc291cmNlLmVuZHNXaXRoKFN0cmluZy5yYXdgXFwkYCkpIHtcbiAgICBzb3VyY2UgPSBzb3VyY2Uuc2xpY2UoMCwgLTEpO1xuICB9XG4gIHJldHVybiBzb3VyY2U7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBcUNBLDJDQUE0QztBQWtFNUMsTUFBTSx5QkFBeUI7QUFLL0IsTUFBTSx3QkFBd0I7QUFTOUIsTUFBTSwyQkFBMkI7QUFLakMsTUFBTSxzQkFBc0I7QUFLNUIsTUFBTSxpQkFBaUI7QUFLdkIsTUFBTSxpQkFBaUI7QUFnQmhCLE1BQU0sbUNBQW1DLGlFQUE0QjtBQUFBLEVBQ3pEO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1YsWUFBWSxRQUFxRDtBQUN0RSxVQUFNO0FBQ04sU0FBSyxlQUFlLE9BQU87QUFDM0IsU0FBSyxlQUFlLE9BQU8sZ0JBQWdCO0FBQzNDLFNBQUssV0FBVyxPQUFPO0FBQ3ZCLFNBQUssZUFBZSxPQUFPLGdCQUFnQjtBQUFBLEVBQzdDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT0EsTUFBc0IsY0FBNkI7QUFDakQsVUFBTSxLQUFLLHNCQUFzQjtBQUFBO0FBQUE7QUFBQSxNQUcvQixTQUFTLENBQUMsa0JBQWtCLEtBQUssYUFBYSxhQUFhO0FBQUEsTUFDM0QsVUFBVSxLQUFLO0FBQUEsSUFDakIsQ0FBQztBQUFBLEVBQ0g7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU1Es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

package/dist/lib/cjs/components/templates-language-component.d.cts

@@ -0,0 +1,124 @@
+/// <reference path="../library.d.cts" />
+/**
+ * @file
+ *
+ * Contains class {@link TemplatesLanguageComponent} that registers a Prism language highlighting
+ * `{{token}}` / `{{token:format}}` placeholders.
+ *
+ * **The language is Obsidian core's own, not an invention of this library.** `{{token:format}}` is the syntax core's
+ * **Templates** plugin defines, verified in the shipped app rather than recalled — `obsidian.asar/i18n.js`,
+ * the `templates:` block:
+ *
+ * ```text
+ * optionTemplateDateFormatDescription:  '{{date}} in the template file will be replaced with this value.'
+ * optionTemplateDateFormatDescription2: 'You can also use {{date:YYYY-MM-DD}} to override the format once.'
+ * optionTemplateTimeFormatDescription:  '{{time}} in the template file will be replaced with this value.'
+ * optionTemplateTimeFormatDescription2: 'You can also use {{time:HH:mm}} to override the format once.'
+ * ```
+ *
+ * That matters for anyone tempted to change the delimiters: they are not ours to change. A plugin extends
+ * core's language with its own token vocabulary, it does not define a competing one.
+ *
+ * **Beware the near-miss on that evidence.** A grep for `{{...}}` across the app bundle returns many hits
+ * that prove nothing, because Obsidian's UI strings are i18next and `{{...}}` is i18next's own interpolation
+ * syntax. The load-bearing hit is the `templates:` block quoted above — the core plugin's user-facing
+ * settings description. Read that block; do not count braces.
+ *
+ * What a consumer varies is only its **vocabulary**, which is why this component is parameterized rather
+ * than fixed: the language id it registers under, the characters a token name may contain, the shape of the
+ * format half, and any extra top-level tokens its own template dialect needs.
+ */
+import type { Grammar, PrismTokenObject } from '@obsidian-typings/obsidian-public-latest' with { 'resolution-mode': 'import' };
+import type { SyntaxHighlightingComponentGrammarFactoryParams } from './syntax-highlighting-component.cjs';
+import { SyntaxHighlightingComponent } from './syntax-highlighting-component.cjs';
+/**
+ * Parameters for the {@link TemplatesLanguageComponent} constructor.
+ */
+export interface TemplatesLanguageComponentConstructorParams {
+    /**
+     * Extra top-level entries merged into the built grammar, for a dialect whose templates carry syntax
+     * beyond the placeholders themselves — a path separator, say. Omit when there is none.
+     */
+    readonly extraGrammar?: Grammar | undefined;
+    /**
+     * The format half of a `{{token:format}}` placeholder.
+     *
+     * Defaults to a scalar word, which is core's own shape.
+     */
+    readonly formatSource?: TemplatesLanguageComponentFormatSource | undefined;
+    /**
+     * The language to register the grammar as, e.g. `my-plugin-template`.
+     */
+    readonly language: string;
+    /**
+     * The characters a token name may contain, anchored at the start of the placeholder body.
+     *
+     * Defaults to word characters. A dialect whose token names carry more — a comma-separated argument list,
+     * say — widens it here.
+     */
+    readonly tokenPattern?: RegExp | undefined;
+}
+/**
+ * The format half of a `{{token:format}}` placeholder.
+ *
+ * - A {@link RegExp} describes a **scalar** format — core's own shape, e.g. the `YYYY-MM-DD` of
+ *   `{{date:YYYY-MM-DD}}` — and is wrapped into a `string`-aliased token.
+ * - A {@link PrismTokenObject} describes a **structured** format, used verbatim, so a dialect whose format
+ *   half is an object rather than a word can supply its own `inside` grammar and extent `pattern`.
+ * - A **factory** is the structured form for a dialect that must nest an already registered Prism language
+ *   into that `inside` — it receives the loaded Prism module, so the consumer never calls `loadPrism`.
+ */
+export type TemplatesLanguageComponentFormatSource = ((params: SyntaxHighlightingComponentGrammarFactoryParams) => PrismTokenObject) | PrismTokenObject | RegExp;
+/**
+ * Registers a Prism language highlighting the `{{token}}` / `{{token:format}}` placeholders of a plugin's
+ * tokenized-string templates.
+ *
+ * @remarks
+ * The language is not a code fence — it is rendered by the `CodeHighlighterComponent` fields of a settings
+ * tab, so only the Prism half of {@link SyntaxHighlightingComponent} is used. Registration is undone when
+ * the component unloads, as it is for every registration that base makes.
+ *
+ * @example
+ * ```ts
+ * this.addChild(new TemplatesLanguageComponent({ language: 'my-plugin-template' }));
+ * ```
+ */
+export declare class TemplatesLanguageComponent extends SyntaxHighlightingComponent {
+    private readonly extraGrammar;
+    private readonly formatSource;
+    private readonly language;
+    private readonly tokenPattern;
+    /**
+     * Creates a new instance of the {@link TemplatesLanguageComponent} class.
+     *
+     * @param params - The parameters for the component.
+     */
+    constructor(params: TemplatesLanguageComponentConstructorParams);
+    /**
+     * Registers the language.
+     *
+     * @returns A {@link Promise} that resolves when the language is registered.
+     */
+    onloadAsync(): Promise<void>;
+    /**
+     * Builds the grammar this component registers.
+     *
+     * @param factoryParams - The Prism module and language lookup handed to a grammar factory.
+     * @returns The grammar.
+     */
+    private buildGrammar;
+    /**
+     * Builds the token describing a whole placeholder.
+     *
+     * @param params - The resolved format token and the placeholder's extent pattern.
+     * @returns The placeholder token.
+     */
+    private buildPlaceholderToken;
+    /**
+     * Resolves the configured format source into the Prism token describing the format half.
+     *
+     * @param factoryParams - The Prism module and language lookup handed to a grammar factory.
+     * @returns The format token.
+     */
+    private resolveFormatToken;
+}