@mnaoumov/obsidian-dev-toolkit 2.1.0 → 3.0.0

package/dist/lib/esm/bundlers/obsidian-plugin-build.d.mts

@@ -0,0 +1,217 @@
+/// <reference path="../library-references.d.mts" />
+/**
+ * @file
+ *
+ * The bundler-independent half of building an Obsidian plugin: which modules stay external, where the
+ * output goes, what the output folder holds besides the bundle, and how a development build reaches the
+ * vault. Every bundler adapter in this folder (esbuild, rollup, vite, webpack, parcel) is a thin layer over
+ * it, so all of them produce the same `main.js` + `styles.css` + `manifest.json` layout.
+ */
+/**
+ * Enumeration representing the build modes.
+ */
+export declare enum BuildMode {
+    /**
+    Development mode for building the plugin
+     */
+    Development = 0,
+    /**
+    Production mode for building the plugin
+     */
+    Production = 1
+}
+/**
+ * The modules Obsidian supplies at runtime. A plugin must never bundle its own copy of them: a second copy
+ * of the API breaks `instanceof` against the running one, and a second CodeMirror breaks every extension.
+ *
+ * `esbuild` and `eslint` are here because a plugin that imports one of the toolkit's build-time modules
+ * would otherwise drag either into `main.js`.
+ */
+export declare const OBSIDIAN_PLUGIN_RUNTIME_MODULES: readonly string[];
+/**
+ * The module ids an Obsidian plugin bundle leaves to `require()` at runtime: the
+ * {@link OBSIDIAN_PLUGIN_RUNTIME_MODULES} and the Node builtins. Every `node:`-prefixed id is external too,
+ * which a bundler takes as a pattern (esbuild's `node:*`) or through {@link isObsidianPluginExternal}.
+ */
+export declare const OBSIDIAN_PLUGIN_EXTERNALS: readonly string[];
+/**
+ * A CSS file a bundler emitted, as {@link mergeCssAssets} sees it.
+ */
+export interface CssAsset {
+    /**
+     * The file name relative to the output folder.
+     */
+    readonly fileName: string;
+    /**
+     * The file's contents.
+     */
+    readonly source: string;
+}
+/**
+ * What {@link mergeCssAssets} decided.
+ */
+export interface MergeCssAssetsResult {
+    /**
+     * The file names to drop from the output, because their contents moved into `styles.css`. Includes
+     * `styles.css` itself when the bundler already emitted one, so it is always written afresh.
+     */
+    readonly fileNamesToRemove: readonly string[];
+    /**
+     * The contents of `styles.css`, or `undefined` when there is nothing to do: the bundle has no CSS at all,
+     * or its one CSS file already is `styles.css`.
+     */
+    readonly stylesCss: string | undefined;
+}
+/**
+ * Where a plugin build writes its output and what it builds.
+ */
+export interface ObsidianPluginBuildContext {
+    /**
+     * The absolute path of the folder the build writes `main.js`, `styles.css` and `manifest.json` into.
+     */
+    readonly distFolder: string;
+    /**
+     * The absolute path of the plugin's entry point, `src/main.ts`.
+     */
+    readonly entryPoint: string;
+    /**
+     * Whether this is a production build.
+     */
+    readonly isProductionBuild: boolean;
+    /**
+     * The absolute path of the emitted `main.js`.
+     */
+    readonly mainJsPath: string;
+    /**
+     * The Obsidian configuration folder a development build is deployed into, or an empty string when none
+     * is configured.
+     */
+    readonly obsidianConfigFolder: string;
+    /**
+     * The plugin's folder name inside `<vault>/.obsidian/plugins`, which is the package name.
+     */
+    readonly pluginName: string;
+    /**
+     * How a development build is reloaded in Obsidian once it is deployed.
+     */
+    readonly reload: ObsidianPluginReload;
+}
+/**
+ * Where a development build is deployed and how Obsidian picks it up. Every bundler adapter takes these.
+ */
+export interface ObsidianPluginDeploymentOptions {
+    /**
+     * A folder for Obsidian configuration. Defaults to the `OBSIDIAN_CONFIG_FOLDER` environment variable,
+     * read from the process or from a `.env` file in the project root.
+     */
+    readonly obsidianConfigFolder?: string;
+    /**
+     * How a development build is reloaded in Obsidian once it is copied into the vault. Defaults to
+     * `'hot-reload-plugin'`.
+     */
+    readonly reload?: ObsidianPluginReload;
+}
+/**
+ * How a development build is reloaded in Obsidian once it is copied into the vault.
+ *
+ * - `'hot-reload-plugin'`: the build writes the `.hotreload` marker, and `npm run dev` opens the vault in an
+ *   Obsidian instance it owns, with the HotReload plugin installed and enabled there.
+ * - `'obsidian-cli'`: every rebuild runs `obsidian plugin:reload` against the Obsidian you already have open,
+ *   through the Obsidian CLI (Settings → General → Command line interface). No HotReload, no second instance.
+ * - `false`: the build is copied into the vault and nothing reloads it.
+ */
+export type ObsidianPluginReload = 'hot-reload-plugin' | 'obsidian-cli' | false;
+/**
+ * Options for {@link resolveObsidianPluginBuildContext}.
+ */
+export interface ResolveObsidianPluginBuildContextParams extends ObsidianPluginDeploymentOptions {
+    /**
+     * The output folder. Defaults to `dist/build` for a production build and `dist/dev` for a development
+     * one.
+     */
+    readonly distFolder?: string;
+    /**
+     * The build mode.
+     */
+    readonly mode: BuildMode;
+}
+/**
+ * Removes the output folder of a build and creates it empty again.
+ *
+ * @param distFolder - The output folder.
+ * @returns A {@link Promise} that resolves once the folder exists and is empty.
+ */
+export declare function cleanObsidianPluginDistFolder(distFolder: string): Promise<void>;
+/**
+ * Puts the files a plugin folder needs besides the bundle into the output folder: `manifest.json`, and for
+ * a development build reloaded by the HotReload plugin the empty `.hotreload` marker it watches for.
+ *
+ * @param context - The build context.
+ * @returns A {@link Promise} that resolves once the files are written.
+ */
+export declare function completeObsidianPluginDistFolder(context: ObsidianPluginBuildContext): Promise<void>;
+/**
+ * Builds the banner placed at the top of `main.js`.
+ *
+ * @param bundlerName - The bundler's name, as the banner states it.
+ * @returns The banner, a block comment followed by a newline.
+ */
+export declare function getObsidianPluginBanner(bundlerName: string): string;
+/**
+ * Resolves the default output folder of a build: `dist/build` for a production build, `dist/dev` for a
+ * development one.
+ *
+ * @param mode - The build mode.
+ * @returns The absolute path of the output folder.
+ */
+export declare function getObsidianPluginDistFolder(mode: BuildMode): string;
+/**
+ * Resolves the plugin's entry point, `src/main.ts`.
+ *
+ * @returns The absolute path of the entry point.
+ */
+export declare function getObsidianPluginEntryPoint(): string;
+/**
+ * Tells whether a file name is a CSS file.
+ *
+ * @param fileName - The file name.
+ * @returns `true` for a `.css` file.
+ */
+export declare function isCssFileName(fileName: string): boolean;
+/**
+ * Tells whether a module id is one an Obsidian plugin bundle must leave external: one of
+ * {@link OBSIDIAN_PLUGIN_EXTERNALS}, a subpath of one (`@codemirror/view/dist/index.js`, `fs/promises`),
+ * or any `node:`-prefixed id.
+ *
+ * @param moduleId - The module id as written in the importing file.
+ * @returns `true` when the bundle must leave the module to `require()` at runtime.
+ */
+export declare function isObsidianPluginExternal(moduleId: string): boolean;
+/**
+ * Decides how the CSS a bundler emitted becomes the one `styles.css` Obsidian loads.
+ *
+ * Obsidian reads a plugin's stylesheet from `styles.css` and nothing else, while a bundler names the CSS
+ * after the entry (`main.css`), after the package, or with a content hash. A lone CSS file is renamed; when
+ * there are several, they are concatenated in the order given.
+ *
+ * @param cssAssets - The CSS files the bundler emitted, in output order.
+ * @returns What to write as `styles.css` and which emitted files to drop.
+ */
+export declare function mergeCssAssets(cssAssets: readonly CssAsset[]): MergeCssAssetsResult;
+/**
+ * Resolves a path against the project root.
+ *
+ * @param path - The path, relative to the project root or absolute.
+ * @returns The absolute path.
+ */
+export declare function resolveFromRoot(path: string): string;
+/**
+ * Resolves where a plugin build writes its output, which entry point it builds and which vault a
+ * development build is deployed into.
+ *
+ * Loads the project's `.env` file first, so `OBSIDIAN_CONFIG_FOLDER` can live there.
+ *
+ * @param params - The {@link ResolveObsidianPluginBuildContextParams}.
+ * @returns A {@link Promise} that resolves to the {@link ObsidianPluginBuildContext}.
+ */
+export declare function resolveObsidianPluginBuildContext(params: ResolveObsidianPluginBuildContextParams): Promise<ObsidianPluginBuildContext>;

package/dist/lib/esm/bundlers/obsidian-plugin-build.mjs

@@ -0,0 +1,166 @@
+/*
+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 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;
+}
+
+ensureBrowserProcess();
+})();
+
+import { readPackageJson } from "@mnaoumov/typescript-dev-toolkit/npm";
+import { resolvePathFromRoot } from "@mnaoumov/typescript-dev-toolkit/root";
+import {
+  basename,
+  join
+} from "@mnaoumov/typescript-lib/path";
+import { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import { existsSync } from "node:fs";
+import {
+  cp,
+  mkdir,
+  rm,
+  writeFile
+} from "node:fs/promises";
+import { builtinModules } from "node:module";
+import process, { loadEnvFile } from "node:process";
+import { ObsidianPluginRepoPaths } from "../obsidian-plugin-repo-paths.mjs";
+var BuildMode = /* @__PURE__ */ ((BuildMode2) => {
+  BuildMode2[BuildMode2["Development"] = 0] = "Development";
+  BuildMode2[BuildMode2["Production"] = 1] = "Production";
+  return BuildMode2;
+})(BuildMode || {});
+const OBSIDIAN_PLUGIN_RUNTIME_MODULES = [
+  "obsidian",
+  "electron",
+  "@codemirror/autocomplete",
+  "@codemirror/collab",
+  "@codemirror/commands",
+  "@codemirror/language",
+  "@codemirror/lint",
+  "@codemirror/search",
+  "@codemirror/state",
+  "@codemirror/view",
+  "@lezer/common",
+  "@lezer/highlight",
+  "@lezer/lr",
+  "esbuild",
+  "eslint"
+];
+const OBSIDIAN_PLUGIN_EXTERNALS = [
+  ...OBSIDIAN_PLUGIN_RUNTIME_MODULES,
+  ...builtinModules
+];
+const NODE_PREFIX = "node:";
+const STYLES_CSS_FILE_NAME = ObsidianPluginRepoPaths.StylesCss;
+const OBSIDIAN_PLUGIN_EXTERNALS_SET = new Set(OBSIDIAN_PLUGIN_EXTERNALS);
+async function cleanObsidianPluginDistFolder(distFolder) {
+  if (existsSync(distFolder)) {
+    await rm(distFolder, { recursive: true });
+  }
+  await mkdir(distFolder, { recursive: true });
+}
+async function completeObsidianPluginDistFolder(context) {
+  await mkdir(context.distFolder, { recursive: true });
+  if (!context.isProductionBuild && context.reload === "hot-reload-plugin") {
+    await writeFile(join(context.distFolder, ObsidianPluginRepoPaths.HotReload), "", "utf-8");
+  }
+  const manifestPath = resolvePathFromRoot({ path: ObsidianPluginRepoPaths.ManifestJson });
+  if (manifestPath && existsSync(manifestPath)) {
+    await cp(manifestPath, join(context.distFolder, ObsidianPluginRepoPaths.ManifestJson));
+  }
+}
+function getObsidianPluginBanner(bundlerName) {
+  return `/*
+THIS IS A GENERATED/BUNDLED FILE BY ${bundlerName.toUpperCase()}
+if you want to view the source, please visit the github repository of this plugin
+*/
+`;
+}
+function getObsidianPluginDistFolder(mode) {
+  return resolveFromRoot(mode === 1 /* Production */ ? ObsidianPluginRepoPaths.DistBuild : ObsidianPluginRepoPaths.DistDev);
+}
+function getObsidianPluginEntryPoint() {
+  return resolveFromRoot(join(ObsidianPluginRepoPaths.Src, ObsidianPluginRepoPaths.MainTs));
+}
+function isCssFileName(fileName) {
+  return basename(fileName).toLowerCase().endsWith(".css");
+}
+function isObsidianPluginExternal(moduleId) {
+  if (moduleId.startsWith(NODE_PREFIX) || OBSIDIAN_PLUGIN_EXTERNALS_SET.has(moduleId)) {
+    return true;
+  }
+  const SCOPED_PACKAGE_SEGMENT_COUNT = 2;
+  const packageName = moduleId.split("/").slice(0, moduleId.startsWith("@") ? SCOPED_PACKAGE_SEGMENT_COUNT : 1).join("/");
+  return packageName !== moduleId && OBSIDIAN_PLUGIN_EXTERNALS_SET.has(packageName);
+}
+function mergeCssAssets(cssAssets) {
+  const [firstCssAsset] = cssAssets;
+  if (firstCssAsset === void 0 || cssAssets.length === 1 && firstCssAsset.fileName === STYLES_CSS_FILE_NAME) {
+    return { fileNamesToRemove: [], stylesCss: void 0 };
+  }
+  return {
+    fileNamesToRemove: cssAssets.map((asset) => asset.fileName),
+    stylesCss: cssAssets.map((asset) => asset.source).join("\n")
+  };
+}
+function resolveFromRoot(path) {
+  return ensureNonNullable(resolvePathFromRoot({ path }), `Could not resolve '${path}' against the project root`);
+}
+async function resolveObsidianPluginBuildContext(params) {
+  const envPath = resolvePathFromRoot({ path: ".env" });
+  if (envPath && existsSync(envPath)) {
+    loadEnvFile(envPath);
+  }
+  const obsidianPluginBuilderEnv = process.env;
+  const isProductionBuild = params.mode === 1 /* Production */;
+  const distFolder = params.distFolder === void 0 ? getObsidianPluginDistFolder(params.mode) : resolveFromRoot(params.distFolder);
+  const packageJson = await readPackageJson();
+  return {
+    distFolder,
+    entryPoint: getObsidianPluginEntryPoint(),
+    isProductionBuild,
+    mainJsPath: join(distFolder, ObsidianPluginRepoPaths.MainJs),
+    obsidianConfigFolder: params.obsidianConfigFolder ?? obsidianPluginBuilderEnv.OBSIDIAN_CONFIG_FOLDER ?? "",
+    pluginName: packageJson.name ?? "(unknown)",
+    reload: params.reload ?? "hot-reload-plugin"
+  };
+}
+export {
+  BuildMode,
+  OBSIDIAN_PLUGIN_EXTERNALS,
+  OBSIDIAN_PLUGIN_RUNTIME_MODULES,
+  cleanObsidianPluginDistFolder,
+  completeObsidianPluginDistFolder,
+  getObsidianPluginBanner,
+  getObsidianPluginDistFolder,
+  getObsidianPluginEntryPoint,
+  isCssFileName,
+  isObsidianPluginExternal,
+  mergeCssAssets,
+  resolveFromRoot,
+  resolveObsidianPluginBuildContext
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9idW5kbGVycy9vYnNpZGlhbi1wbHVnaW4tYnVpbGQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBidW5kbGVyLWluZGVwZW5kZW50IGhhbGYgb2YgYnVpbGRpbmcgYW4gT2JzaWRpYW4gcGx1Z2luOiB3aGljaCBtb2R1bGVzIHN0YXkgZXh0ZXJuYWwsIHdoZXJlIHRoZVxuICogb3V0cHV0IGdvZXMsIHdoYXQgdGhlIG91dHB1dCBmb2xkZXIgaG9sZHMgYmVzaWRlcyB0aGUgYnVuZGxlLCBhbmQgaG93IGEgZGV2ZWxvcG1lbnQgYnVpbGQgcmVhY2hlcyB0aGVcbiAqIHZhdWx0LiBFdmVyeSBidW5kbGVyIGFkYXB0ZXIgaW4gdGhpcyBmb2xkZXIgKGVzYnVpbGQsIHJvbGx1cCwgdml0ZSwgd2VicGFjaywgcGFyY2VsKSBpcyBhIHRoaW4gbGF5ZXIgb3ZlclxuICogaXQsIHNvIGFsbCBvZiB0aGVtIHByb2R1Y2UgdGhlIHNhbWUgYG1haW4uanNgICsgYHN0eWxlcy5jc3NgICsgYG1hbmlmZXN0Lmpzb25gIGxheW91dC5cbiAqL1xuXG5pbXBvcnQgeyByZWFkUGFja2FnZUpzb24gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1kZXYtdG9vbGtpdC9ucG0nO1xuaW1wb3J0IHsgcmVzb2x2ZVBhdGhGcm9tUm9vdCB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWRldi10b29sa2l0L3Jvb3QnO1xuaW1wb3J0IHtcbiAgYmFzZW5hbWUsXG4gIGpvaW5cbn0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3BhdGgnO1xuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuaW1wb3J0IHsgZXhpc3RzU3luYyB9IGZyb20gJ25vZGU6ZnMnO1xuaW1wb3J0IHtcbiAgY3AsXG4gIG1rZGlyLFxuICBybSxcbiAgd3JpdGVGaWxlXG59IGZyb20gJ25vZGU6ZnMvcHJvbWlzZXMnO1xuaW1wb3J0IHsgYnVpbHRpbk1vZHVsZXMgfSBmcm9tICdub2RlOm1vZHVsZSc7XG5pbXBvcnQgcHJvY2VzcywgeyBsb2FkRW52RmlsZSB9IGZyb20gJ25vZGU6cHJvY2Vzcyc7XG5cbmltcG9ydCB7IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzIH0gZnJvbSAnLi4vb2JzaWRpYW4tcGx1Z2luLXJlcG8tcGF0aHMudHMnO1xuXG4vKipcbiAqIEVudW1lcmF0aW9uIHJlcHJlc2VudGluZyB0aGUgYnVpbGQgbW9kZXMuXG4gKi9cbmV4cG9ydCBlbnVtIEJ1aWxkTW9kZSB7XG4gIC8qKlxuICBEZXZlbG9wbWVudCBtb2RlIGZvciBidWlsZGluZyB0aGUgcGx1Z2luXG4gICAqL1xuICBEZXZlbG9wbWVudCxcbiAgLyoqXG4gIFByb2R1Y3Rpb24gbW9kZSBmb3IgYnVpbGRpbmcgdGhlIHBsdWdpblxuICAgKi9cbiAgUHJvZHVjdGlvblxufVxuXG4vKipcbiAqIFRoZSBtb2R1bGVzIE9ic2lkaWFuIHN1cHBsaWVzIGF0IHJ1bnRpbWUuIEEgcGx1Z2luIG11c3QgbmV2ZXIgYnVuZGxlIGl0cyBvd24gY29weSBvZiB0aGVtOiBhIHNlY29uZCBjb3B5XG4gKiBvZiB0aGUgQVBJIGJyZWFrcyBgaW5zdGFuY2VvZmAgYWdhaW5zdCB0aGUgcnVubmluZyBvbmUsIGFuZCBhIHNlY29uZCBDb2RlTWlycm9yIGJyZWFrcyBldmVyeSBleHRlbnNpb24uXG4gKlxuICogYGVzYnVpbGRgIGFuZCBgZXNsaW50YCBhcmUgaGVyZSBiZWNhdXNlIGEgcGx1Z2luIHRoYXQgaW1wb3J0cyBvbmUgb2YgdGhlIHRvb2xraXQncyBidWlsZC10aW1lIG1vZHVsZXNcbiAqIHdvdWxkIG90aGVyd2lzZSBkcmFnIGVpdGhlciBpbnRvIGBtYWluLmpzYC5cbiAqL1xuZXhwb3J0IGNvbnN0IE9CU0lESUFOX1BMVUdJTl9SVU5USU1FX01PRFVMRVM6IHJlYWRvbmx5IHN0cmluZ1tdID0gW1xuICAnb2JzaWRpYW4nLFxuICAnZWxlY3Ryb24nLFxuICAnQGNvZGVtaXJyb3IvYXV0b2NvbXBsZXRlJyxcbiAgJ0Bjb2RlbWlycm9yL2NvbGxhYicsXG4gICdAY29kZW1pcnJvci9jb21tYW5kcycsXG4gICdAY29kZW1pcnJvci9sYW5ndWFnZScsXG4gICdAY29kZW1pcnJvci9saW50JyxcbiAgJ0Bjb2RlbWlycm9yL3NlYXJjaCcsXG4gICdAY29kZW1pcnJvci9zdGF0ZScsXG4gICdAY29kZW1pcnJvci92aWV3JyxcbiAgJ0BsZXplci9jb21tb24nLFxuICAnQGxlemVyL2hpZ2hsaWdodCcsXG4gICdAbGV6ZXIvbHInLFxuICAnZXNidWlsZCcsXG4gICdlc2xpbnQnXG5dO1xuXG4vKipcbiAqIFRoZSBtb2R1bGUgaWRzIGFuIE9ic2lkaWFuIHBsdWdpbiBidW5kbGUgbGVhdmVzIHRvIGByZXF1aXJlKClgIGF0IHJ1bnRpbWU6IHRoZVxuICoge0BsaW5rIE9CU0lESUFOX1BMVUdJTl9SVU5USU1FX01PRFVMRVN9IGFuZCB0aGUgTm9kZSBidWlsdGlucy4gRXZlcnkgYG5vZGU6YC1wcmVmaXhlZCBpZCBpcyBleHRlcm5hbCB0b28sXG4gKiB3aGljaCBhIGJ1bmRsZXIgdGFrZXMgYXMgYSBwYXR0ZXJuIChlc2J1aWxkJ3MgYG5vZGU6KmApIG9yIHRocm91Z2gge0BsaW5rIGlzT2JzaWRpYW5QbHVnaW5FeHRlcm5hbH0uXG4gKi9cbmV4cG9ydCBjb25zdCBPQlNJRElBTl9QTFVHSU5fRVhURVJOQUxTOiByZWFkb25seSBzdHJpbmdbXSA9IFtcbiAgLi4uT0JTSURJQU5fUExVR0lOX1JVTlRJTUVfTU9EVUxFUyxcbiAgLi4uYnVpbHRpbk1vZHVsZXNcbl07XG5cbmNvbnN0IE5PREVfUFJFRklYID0gJ25vZGU6JztcbmNvbnN0IFNUWUxFU19DU1NfRklMRV9OQU1FOiBzdHJpbmcgPSBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5TdHlsZXNDc3M7XG5cbmNvbnN0IE9CU0lESUFOX1BMVUdJTl9FWFRFUk5BTFNfU0VUID0gbmV3IFNldChPQlNJRElBTl9QTFVHSU5fRVhURVJOQUxTKTtcblxuLyoqXG4gKiBBIENTUyBmaWxlIGEgYnVuZGxlciBlbWl0dGVkLCBhcyB7QGxpbmsgbWVyZ2VDc3NBc3NldHN9IHNlZXMgaXQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ3NzQXNzZXQge1xuICAvKipcbiAgICogVGhlIGZpbGUgbmFtZSByZWxhdGl2ZSB0byB0aGUgb3V0cHV0IGZvbGRlci5cbiAgICovXG4gIHJlYWRvbmx5IGZpbGVOYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBmaWxlJ3MgY29udGVudHMuXG4gICAqL1xuICByZWFkb25seSBzb3VyY2U6IHN0cmluZztcbn1cblxuLyoqXG4gKiBXaGF0IHtAbGluayBtZXJnZUNzc0Fzc2V0c30gZGVjaWRlZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNZXJnZUNzc0Fzc2V0c1Jlc3VsdCB7XG4gIC8qKlxuICAgKiBUaGUgZmlsZSBuYW1lcyB0byBkcm9wIGZyb20gdGhlIG91dHB1dCwgYmVjYXVzZSB0aGVpciBjb250ZW50cyBtb3ZlZCBpbnRvIGBzdHlsZXMuY3NzYC4gSW5jbHVkZXNcbiAgICogYHN0eWxlcy5jc3NgIGl0c2VsZiB3aGVuIHRoZSBidW5kbGVyIGFscmVhZHkgZW1pdHRlZCBvbmUsIHNvIGl0IGlzIGFsd2F5cyB3cml0dGVuIGFmcmVzaC5cbiAgICovXG4gIHJlYWRvbmx5IGZpbGVOYW1lc1RvUmVtb3ZlOiByZWFkb25seSBzdHJpbmdbXTtcblxuICAvKipcbiAgICogVGhlIGNvbnRlbnRzIG9mIGBzdHlsZXMuY3NzYCwgb3IgYHVuZGVmaW5lZGAgd2hlbiB0aGVyZSBpcyBub3RoaW5nIHRvIGRvOiB0aGUgYnVuZGxlIGhhcyBubyBDU1MgYXQgYWxsLFxuICAgKiBvciBpdHMgb25lIENTUyBmaWxlIGFscmVhZHkgaXMgYHN0eWxlcy5jc3NgLlxuICAgKi9cbiAgcmVhZG9ubHkgc3R5bGVzQ3NzOiBzdHJpbmcgfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogV2hlcmUgYSBwbHVnaW4gYnVpbGQgd3JpdGVzIGl0cyBvdXRwdXQgYW5kIHdoYXQgaXQgYnVpbGRzLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIE9ic2lkaWFuUGx1Z2luQnVpbGRDb250ZXh0IHtcbiAgLyoqXG4gICAqIFRoZSBhYnNvbHV0ZSBwYXRoIG9mIHRoZSBmb2xkZXIgdGhlIGJ1aWxkIHdyaXRlcyBgbWFpbi5qc2AsIGBzdHlsZXMuY3NzYCBhbmQgYG1hbmlmZXN0Lmpzb25gIGludG8uXG4gICAqL1xuICByZWFkb25seSBkaXN0Rm9sZGVyOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBhYnNvbHV0ZSBwYXRoIG9mIHRoZSBwbHVnaW4ncyBlbnRyeSBwb2ludCwgYHNyYy9tYWluLnRzYC5cbiAgICovXG4gIHJlYWRvbmx5IGVudHJ5UG9pbnQ6IHN0cmluZztcblxuICAvKipcbiAgICogV2hldGhlciB0aGlzIGlzIGEgcHJvZHVjdGlvbiBidWlsZC5cbiAgICovXG4gIHJlYWRvbmx5IGlzUHJvZHVjdGlvbkJ1aWxkOiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgYWJzb2x1dGUgcGF0aCBvZiB0aGUgZW1pdHRlZCBgbWFpbi5qc2AuXG4gICAqL1xuICByZWFkb25seSBtYWluSnNQYXRoOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBjb25maWd1cmF0aW9uIGZvbGRlciBhIGRldmVsb3BtZW50IGJ1aWxkIGlzIGRlcGxveWVkIGludG8sIG9yIGFuIGVtcHR5IHN0cmluZyB3aGVuIG5vbmVcbiAgICogaXMgY29uZmlndXJlZC5cbiAgICovXG4gIHJlYWRvbmx5IG9ic2lkaWFuQ29uZmlnRm9sZGVyOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4ncyBmb2xkZXIgbmFtZSBpbnNpZGUgYDx2YXVsdD4vLm9ic2lkaWFuL3BsdWdpbnNgLCB3aGljaCBpcyB0aGUgcGFja2FnZSBuYW1lLlxuICAgKi9cbiAgcmVhZG9ubHkgcGx1Z2luTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBIb3cgYSBkZXZlbG9wbWVudCBidWlsZCBpcyByZWxvYWRlZCBpbiBPYnNpZGlhbiBvbmNlIGl0IGlzIGRlcGxveWVkLlxuICAgKi9cbiAgcmVhZG9ubHkgcmVsb2FkOiBPYnNpZGlhblBsdWdpblJlbG9hZDtcbn1cblxuLyoqXG4gKiBXaGVyZSBhIGRldmVsb3BtZW50IGJ1aWxkIGlzIGRlcGxveWVkIGFuZCBob3cgT2JzaWRpYW4gcGlja3MgaXQgdXAuIEV2ZXJ5IGJ1bmRsZXIgYWRhcHRlciB0YWtlcyB0aGVzZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBPYnNpZGlhblBsdWdpbkRlcGxveW1lbnRPcHRpb25zIHtcbiAgLyoqXG4gICAqIEEgZm9sZGVyIGZvciBPYnNpZGlhbiBjb25maWd1cmF0aW9uLiBEZWZhdWx0cyB0byB0aGUgYE9CU0lESUFOX0NPTkZJR19GT0xERVJgIGVudmlyb25tZW50IHZhcmlhYmxlLFxuICAgKiByZWFkIGZyb20gdGhlIHByb2Nlc3Mgb3IgZnJvbSBhIGAuZW52YCBmaWxlIGluIHRoZSBwcm9qZWN0IHJvb3QuXG4gICAqL1xuICByZWFkb25seSBvYnNpZGlhbkNvbmZpZ0ZvbGRlcj86IHN0cmluZztcblxuICAvKipcbiAgICogSG93IGEgZGV2ZWxvcG1lbnQgYnVpbGQgaXMgcmVsb2FkZWQgaW4gT2JzaWRpYW4gb25jZSBpdCBpcyBjb3BpZWQgaW50byB0aGUgdmF1bHQuIERlZmF1bHRzIHRvXG4gICAqIGAnaG90LXJlbG9hZC1wbHVnaW4nYC5cbiAgICovXG4gIHJlYWRvbmx5IHJlbG9hZD86IE9ic2lkaWFuUGx1Z2luUmVsb2FkO1xufVxuXG4vKipcbiAqIEhvdyBhIGRldmVsb3BtZW50IGJ1aWxkIGlzIHJlbG9hZGVkIGluIE9ic2lkaWFuIG9uY2UgaXQgaXMgY29waWVkIGludG8gdGhlIHZhdWx0LlxuICpcbiAqIC0gYCdob3QtcmVsb2FkLXBsdWdpbidgOiB0aGUgYnVpbGQgd3JpdGVzIHRoZSBgLmhvdHJlbG9hZGAgbWFya2VyLCBhbmQgYG5wbSBydW4gZGV2YCBvcGVucyB0aGUgdmF1bHQgaW4gYW5cbiAqICAgT2JzaWRpYW4gaW5zdGFuY2UgaXQgb3ducywgd2l0aCB0aGUgSG90UmVsb2FkIHBsdWdpbiBpbnN0YWxsZWQgYW5kIGVuYWJsZWQgdGhlcmUuXG4gKiAtIGAnb2JzaWRpYW4tY2xpJ2A6IGV2ZXJ5IHJlYnVpbGQgcnVucyBgb2JzaWRpYW4gcGx1Z2luOnJlbG9hZGAgYWdhaW5zdCB0aGUgT2JzaWRpYW4geW91IGFscmVhZHkgaGF2ZSBvcGVuLFxuICogICB0aHJvdWdoIHRoZSBPYnNpZGlhbiBDTEkgKFNldHRpbmdzIOKGkiBHZW5lcmFsIOKGkiBDb21tYW5kIGxpbmUgaW50ZXJmYWNlKS4gTm8gSG90UmVsb2FkLCBubyBzZWNvbmQgaW5zdGFuY2UuXG4gKiAtIGBmYWxzZWA6IHRoZSBidWlsZCBpcyBjb3BpZWQgaW50byB0aGUgdmF1bHQgYW5kIG5vdGhpbmcgcmVsb2FkcyBpdC5cbiAqL1xuZXhwb3J0IHR5cGUgT2JzaWRpYW5QbHVnaW5SZWxvYWQgPSAnaG90LXJlbG9hZC1wbHVnaW4nIHwgJ29ic2lkaWFuLWNsaScgfCBmYWxzZTtcblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgcmVzb2x2ZU9ic2lkaWFuUGx1Z2luQnVpbGRDb250ZXh0fS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZXNvbHZlT2JzaWRpYW5QbHVnaW5CdWlsZENvbnRleHRQYXJhbXMgZXh0ZW5kcyBPYnNpZGlhblBsdWdpbkRlcGxveW1lbnRPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRoZSBvdXRwdXQgZm9sZGVyLiBEZWZhdWx0cyB0byBgZGlzdC9idWlsZGAgZm9yIGEgcHJvZHVjdGlvbiBidWlsZCBhbmQgYGRpc3QvZGV2YCBmb3IgYSBkZXZlbG9wbWVudFxuICAgKiBvbmUuXG4gICAqL1xuICByZWFkb25seSBkaXN0Rm9sZGVyPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgYnVpbGQgbW9kZS5cbiAgICovXG4gIHJlYWRvbmx5IG1vZGU6IEJ1aWxkTW9kZTtcbn1cblxuaW50ZXJmYWNlIE9ic2lkaWFuUGx1Z2luQnVpbGRlckVudiB7XG4gIE9CU0lESUFOX0NPTkZJR19GT0xERVI6IHN0cmluZztcbn1cblxuLyoqXG4gKiBSZW1vdmVzIHRoZSBvdXRwdXQgZm9sZGVyIG9mIGEgYnVpbGQgYW5kIGNyZWF0ZXMgaXQgZW1wdHkgYWdhaW4uXG4gKlxuICogQHBhcmFtIGRpc3RGb2xkZXIgLSBUaGUgb3V0cHV0IGZvbGRlci5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgb25jZSB0aGUgZm9sZGVyIGV4aXN0cyBhbmQgaXMgZW1wdHkuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBjbGVhbk9ic2lkaWFuUGx1Z2luRGlzdEZvbGRlcihkaXN0Rm9sZGVyOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgaWYgKGV4aXN0c1N5bmMoZGlzdEZvbGRlcikpIHtcbiAgICBhd2FpdCBybShkaXN0Rm9sZGVyLCB7IHJlY3Vyc2l2ZTogdHJ1ZSB9KTtcbiAgfVxuICBhd2FpdCBta2RpcihkaXN0Rm9sZGVyLCB7IHJlY3Vyc2l2ZTogdHJ1ZSB9KTtcbn1cblxuLyoqXG4gKiBQdXRzIHRoZSBmaWxlcyBhIHBsdWdpbiBmb2xkZXIgbmVlZHMgYmVzaWRlcyB0aGUgYnVuZGxlIGludG8gdGhlIG91dHB1dCBmb2xkZXI6IGBtYW5pZmVzdC5qc29uYCwgYW5kIGZvclxuICogYSBkZXZlbG9wbWVudCBidWlsZCByZWxvYWRlZCBieSB0aGUgSG90UmVsb2FkIHBsdWdpbiB0aGUgZW1wdHkgYC5ob3RyZWxvYWRgIG1hcmtlciBpdCB3YXRjaGVzIGZvci5cbiAqXG4gKiBAcGFyYW0gY29udGV4dCAtIFRoZSBidWlsZCBjb250ZXh0LlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyBvbmNlIHRoZSBmaWxlcyBhcmUgd3JpdHRlbi5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGNvbXBsZXRlT2JzaWRpYW5QbHVnaW5EaXN0Rm9sZGVyKGNvbnRleHQ6IE9ic2lkaWFuUGx1Z2luQnVpbGRDb250ZXh0KTogUHJvbWlzZTx2b2lkPiB7XG4gIGF3YWl0IG1rZGlyKGNvbnRleHQuZGlzdEZvbGRlciwgeyByZWN1cnNpdmU6IHRydWUgfSk7XG4gIGlmICghY29udGV4dC5pc1Byb2R1Y3Rpb25CdWlsZCAmJiBjb250ZXh0LnJlbG9hZCA9PT0gJ2hvdC1yZWxvYWQtcGx1Z2luJykge1xuICAgIGF3YWl0IHdyaXRlRmlsZShqb2luKGNvbnRleHQuZGlzdEZvbGRlciwgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuSG90UmVsb2FkKSwgJycsICd1dGYtOCcpO1xuICB9XG5cbiAgY29uc3QgbWFuaWZlc3RQYXRoID0gcmVzb2x2ZVBhdGhGcm9tUm9vdCh7IHBhdGg6IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hbmlmZXN0SnNvbiB9KTtcbiAgaWYgKG1hbmlmZXN0UGF0aCAmJiBleGlzdHNTeW5jKG1hbmlmZXN0UGF0aCkpIHtcbiAgICBhd2FpdCBjcChtYW5pZmVzdFBhdGgsIGpvaW4oY29udGV4dC5kaXN0Rm9sZGVyLCBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYW5pZmVzdEpzb24pKTtcbiAgfVxufVxuXG4vKipcbiAqIEJ1aWxkcyB0aGUgYmFubmVyIHBsYWNlZCBhdCB0aGUgdG9wIG9mIGBtYWluLmpzYC5cbiAqXG4gKiBAcGFyYW0gYnVuZGxlck5hbWUgLSBUaGUgYnVuZGxlcidzIG5hbWUsIGFzIHRoZSBiYW5uZXIgc3RhdGVzIGl0LlxuICogQHJldHVybnMgVGhlIGJhbm5lciwgYSBibG9jayBjb21tZW50IGZvbGxvd2VkIGJ5IGEgbmV3bGluZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldE9ic2lkaWFuUGx1Z2luQmFubmVyKGJ1bmRsZXJOYW1lOiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gYC8qXG5USElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSAke2J1bmRsZXJOYW1lLnRvVXBwZXJDYXNlKCl9XG5pZiB5b3Ugd2FudCB0byB2aWV3IHRoZSBzb3VyY2UsIHBsZWFzZSB2aXNpdCB0aGUgZ2l0aHViIHJlcG9zaXRvcnkgb2YgdGhpcyBwbHVnaW5cbiovXG5gO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBkZWZhdWx0IG91dHB1dCBmb2xkZXIgb2YgYSBidWlsZDogYGRpc3QvYnVpbGRgIGZvciBhIHByb2R1Y3Rpb24gYnVpbGQsIGBkaXN0L2RldmAgZm9yIGFcbiAqIGRldmVsb3BtZW50IG9uZS5cbiAqXG4gKiBAcGFyYW0gbW9kZSAtIFRoZSBidWlsZCBtb2RlLlxuICogQHJldHVybnMgVGhlIGFic29sdXRlIHBhdGggb2YgdGhlIG91dHB1dCBmb2xkZXIuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRPYnNpZGlhblBsdWdpbkRpc3RGb2xkZXIobW9kZTogQnVpbGRNb2RlKTogc3RyaW5nIHtcbiAgcmV0dXJuIHJlc29sdmVGcm9tUm9vdChtb2RlID09PSBCdWlsZE1vZGUuUHJvZHVjdGlvbiA/IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLkRpc3RCdWlsZCA6IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLkRpc3REZXYpO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBwbHVnaW4ncyBlbnRyeSBwb2ludCwgYHNyYy9tYWluLnRzYC5cbiAqXG4gKiBAcmV0dXJucyBUaGUgYWJzb2x1dGUgcGF0aCBvZiB0aGUgZW50cnkgcG9pbnQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRPYnNpZGlhblBsdWdpbkVudHJ5UG9pbnQoKTogc3RyaW5nIHtcbiAgcmV0dXJuIHJlc29sdmVGcm9tUm9vdChqb2luKE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLlNyYywgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFpblRzKSk7XG59XG5cbi8qKlxuICogVGVsbHMgd2hldGhlciBhIGZpbGUgbmFtZSBpcyBhIENTUyBmaWxlLlxuICpcbiAqIEBwYXJhbSBmaWxlTmFtZSAtIFRoZSBmaWxlIG5hbWUuXG4gKiBAcmV0dXJucyBgdHJ1ZWAgZm9yIGEgYC5jc3NgIGZpbGUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc0Nzc0ZpbGVOYW1lKGZpbGVOYW1lOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgcmV0dXJuIGJhc2VuYW1lKGZpbGVOYW1lKS50b0xvd2VyQ2FzZSgpLmVuZHNXaXRoKCcuY3NzJyk7XG59XG5cbi8qKlxuICogVGVsbHMgd2hldGhlciBhIG1vZHVsZSBpZCBpcyBvbmUgYW4gT2JzaWRpYW4gcGx1Z2luIGJ1bmRsZSBtdXN0IGxlYXZlIGV4dGVybmFsOiBvbmUgb2ZcbiAqIHtAbGluayBPQlNJRElBTl9QTFVHSU5fRVhURVJOQUxTfSwgYSBzdWJwYXRoIG9mIG9uZSAoYEBjb2RlbWlycm9yL3ZpZXcvZGlzdC9pbmRleC5qc2AsIGBmcy9wcm9taXNlc2ApLFxuICogb3IgYW55IGBub2RlOmAtcHJlZml4ZWQgaWQuXG4gKlxuICogQHBhcmFtIG1vZHVsZUlkIC0gVGhlIG1vZHVsZSBpZCBhcyB3cml0dGVuIGluIHRoZSBpbXBvcnRpbmcgZmlsZS5cbiAqIEByZXR1cm5zIGB0cnVlYCB3aGVuIHRoZSBidW5kbGUgbXVzdCBsZWF2ZSB0aGUgbW9kdWxlIHRvIGByZXF1aXJlKClgIGF0IHJ1bnRpbWUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc09ic2lkaWFuUGx1Z2luRXh0ZXJuYWwobW9kdWxlSWQ6IHN0cmluZyk6IGJvb2xlYW4ge1xuICBpZiAobW9kdWxlSWQuc3RhcnRzV2l0aChOT0RFX1BSRUZJWCkgfHwgT0JTSURJQU5fUExVR0lOX0VYVEVSTkFMU19TRVQuaGFzKG1vZHVsZUlkKSkge1xuICAgIHJldHVybiB0cnVlO1xuICB9XG5cbiAgY29uc3QgU0NPUEVEX1BBQ0tBR0VfU0VHTUVOVF9DT1VOVCA9IDI7XG4gIGNvbnN0IHBhY2thZ2VOYW1lID0gbW9kdWxlSWQuc3BsaXQoJy8nKS5zbGljZSgwLCBtb2R1bGVJZC5zdGFydHNXaXRoKCdAJykgPyBTQ09QRURfUEFDS0FHRV9TRUdNRU5UX0NPVU5UIDogMSkuam9pbignLycpO1xuICByZXR1cm4gcGFja2FnZU5hbWUgIT09IG1vZHVsZUlkICYmIE9CU0lESUFOX1BMVUdJTl9FWFRFUk5BTFNfU0VULmhhcyhwYWNrYWdlTmFtZSk7XG59XG5cbi8qKlxuICogRGVjaWRlcyBob3cgdGhlIENTUyBhIGJ1bmRsZXIgZW1pdHRlZCBiZWNvbWVzIHRoZSBvbmUgYHN0eWxlcy5jc3NgIE9ic2lkaWFuIGxvYWRzLlxuICpcbiAqIE9ic2lkaWFuIHJlYWRzIGEgcGx1Z2luJ3Mgc3R5bGVzaGVldCBmcm9tIGBzdHlsZXMuY3NzYCBhbmQgbm90aGluZyBlbHNlLCB3aGlsZSBhIGJ1bmRsZXIgbmFtZXMgdGhlIENTU1xuICogYWZ0ZXIgdGhlIGVudHJ5IChgbWFpbi5jc3NgKSwgYWZ0ZXIgdGhlIHBhY2thZ2UsIG9yIHdpdGggYSBjb250ZW50IGhhc2guIEEgbG9uZSBDU1MgZmlsZSBpcyByZW5hbWVkOyB3aGVuXG4gKiB0aGVyZSBhcmUgc2V2ZXJhbCwgdGhleSBhcmUgY29uY2F0ZW5hdGVkIGluIHRoZSBvcmRlciBnaXZlbi5cbiAqXG4gKiBAcGFyYW0gY3NzQXNzZXRzIC0gVGhlIENTUyBmaWxlcyB0aGUgYnVuZGxlciBlbWl0dGVkLCBpbiBvdXRwdXQgb3JkZXIuXG4gKiBAcmV0dXJucyBXaGF0IHRvIHdyaXRlIGFzIGBzdHlsZXMuY3NzYCBhbmQgd2hpY2ggZW1pdHRlZCBmaWxlcyB0byBkcm9wLlxuICovXG5leHBvcnQgZnVuY3Rpb24gbWVyZ2VDc3NBc3NldHMoY3NzQXNzZXRzOiByZWFkb25seSBDc3NBc3NldFtdKTogTWVyZ2VDc3NBc3NldHNSZXN1bHQge1xuICBjb25zdCBbZmlyc3RDc3NBc3NldF0gPSBjc3NBc3NldHM7XG4gIGlmIChmaXJzdENzc0Fzc2V0ID09PSB1bmRlZmluZWQgfHwgKGNzc0Fzc2V0cy5sZW5ndGggPT09IDEgJiYgZmlyc3RDc3NBc3NldC5maWxlTmFtZSA9PT0gU1RZTEVTX0NTU19GSUxFX05BTUUpKSB7XG4gICAgcmV0dXJuIHsgZmlsZU5hbWVzVG9SZW1vdmU6IFtdLCBzdHlsZXNDc3M6IHVuZGVmaW5lZCB9O1xuICB9XG5cbiAgcmV0dXJuIHtcbiAgICBmaWxlTmFtZXNUb1JlbW92ZTogY3NzQXNzZXRzLm1hcCgoYXNzZXQpID0+IGFzc2V0LmZpbGVOYW1lKSxcbiAgICBzdHlsZXNDc3M6IGNzc0Fzc2V0cy5tYXAoKGFzc2V0KSA9PiBhc3NldC5zb3VyY2UpLmpvaW4oJ1xcbicpXG4gIH07XG59XG5cbi8qKlxuICogUmVzb2x2ZXMgYSBwYXRoIGFnYWluc3QgdGhlIHByb2plY3Qgcm9vdC5cbiAqXG4gKiBAcGFyYW0gcGF0aCAtIFRoZSBwYXRoLCByZWxhdGl2ZSB0byB0aGUgcHJvamVjdCByb290IG9yIGFic29sdXRlLlxuICogQHJldHVybnMgVGhlIGFic29sdXRlIHBhdGguXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZXNvbHZlRnJvbVJvb3QocGF0aDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGVuc3VyZU5vbk51bGxhYmxlKHJlc29sdmVQYXRoRnJvbVJvb3QoeyBwYXRoIH0pLCBgQ291bGQgbm90IHJlc29sdmUgJyR7cGF0aH0nIGFnYWluc3QgdGhlIHByb2plY3Qgcm9vdGApO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIHdoZXJlIGEgcGx1Z2luIGJ1aWxkIHdyaXRlcyBpdHMgb3V0cHV0LCB3aGljaCBlbnRyeSBwb2ludCBpdCBidWlsZHMgYW5kIHdoaWNoIHZhdWx0IGFcbiAqIGRldmVsb3BtZW50IGJ1aWxkIGlzIGRlcGxveWVkIGludG8uXG4gKlxuICogTG9hZHMgdGhlIHByb2plY3QncyBgLmVudmAgZmlsZSBmaXJzdCwgc28gYE9CU0lESUFOX0NPTkZJR19GT0xERVJgIGNhbiBsaXZlIHRoZXJlLlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIFJlc29sdmVPYnNpZGlhblBsdWdpbkJ1aWxkQ29udGV4dFBhcmFtc30uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHRvIHRoZSB7QGxpbmsgT2JzaWRpYW5QbHVnaW5CdWlsZENvbnRleHR9LlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcmVzb2x2ZU9ic2lkaWFuUGx1Z2luQnVpbGRDb250ZXh0KHBhcmFtczogUmVzb2x2ZU9ic2lkaWFuUGx1Z2luQnVpbGRDb250ZXh0UGFyYW1zKTogUHJvbWlzZTxPYnNpZGlhblBsdWdpbkJ1aWxkQ29udGV4dD4ge1xuICBjb25zdCBlbnZQYXRoID0gcmVzb2x2ZVBhdGhGcm9tUm9vdCh7IHBhdGg6ICcuZW52JyB9KTtcbiAgaWYgKGVudlBhdGggJiYgZXhpc3RzU3luYyhlbnZQYXRoKSkge1xuICAgIGxvYWRFbnZGaWxlKGVudlBhdGgpO1xuICB9XG4gIGNvbnN0IG9ic2lkaWFuUGx1Z2luQnVpbGRlckVudiA9IHByb2Nlc3MuZW52IGFzIFBhcnRpYWw8T2JzaWRpYW5QbHVnaW5CdWlsZGVyRW52PjtcblxuICBjb25zdCBpc1Byb2R1Y3Rpb25CdWlsZCA9IHBhcmFtcy5tb2RlID09PSBCdWlsZE1vZGUuUHJvZHVjdGlvbjtcbiAgY29uc3QgZGlzdEZvbGRlciA9IHBhcmFtcy5kaXN0Rm9sZGVyID09PSB1bmRlZmluZWQgPyBnZXRPYnNpZGlhblBsdWdpbkRpc3RGb2xkZXIocGFyYW1zLm1vZGUpIDogcmVzb2x2ZUZyb21Sb290KHBhcmFtcy5kaXN0Rm9sZGVyKTtcbiAgY29uc3QgcGFja2FnZUpzb24gPSBhd2FpdCByZWFkUGFja2FnZUpzb24oKTtcblxuICByZXR1cm4ge1xuICAgIGRpc3RGb2xkZXIsXG4gICAgZW50cnlQb2ludDogZ2V0T2JzaWRpYW5QbHVnaW5FbnRyeVBvaW50KCksXG4gICAgaXNQcm9kdWN0aW9uQnVpbGQsXG4gICAgbWFpbkpzUGF0aDogam9pbihkaXN0Rm9sZGVyLCBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYWluSnMpLFxuICAgIG9ic2lkaWFuQ29uZmlnRm9sZGVyOiBwYXJhbXMub2JzaWRpYW5Db25maWdGb2xkZXIgPz8gb2JzaWRpYW5QbHVnaW5CdWlsZGVyRW52Lk9CU0lESUFOX0NPTkZJR19GT0xERVIgPz8gJycsXG4gICAgcGx1Z2luTmFtZTogcGFja2FnZUpzb24ubmFtZSA/PyAnKHVua25vd24pJyxcbiAgICByZWxvYWQ6IHBhcmFtcy5yZWxvYWQgPz8gJ2hvdC1yZWxvYWQtcGx1Z2luJ1xuICB9O1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQVNBLFNBQVMsdUJBQXVCO0FBQ2hDLFNBQVMsMkJBQTJCO0FBQ3BDO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyx5QkFBeUI7QUFDbEMsU0FBUyxrQkFBa0I7QUFDM0I7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMsc0JBQXNCO0FBQy9CLE9BQU8sV0FBVyxtQkFBbUI7QUFFckMsU0FBUywrQkFBK0I7QUFLakMsSUFBSyxZQUFMLGtCQUFLQSxlQUFMO0FBSUwsRUFBQUEsc0JBQUE7QUFJQSxFQUFBQSxzQkFBQTtBQVJVLFNBQUFBO0FBQUEsR0FBQTtBQWtCTCxNQUFNLGtDQUFxRDtBQUFBLEVBQ2hFO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFDRjtBQU9PLE1BQU0sNEJBQStDO0FBQUEsRUFDMUQsR0FBRztBQUFBLEVBQ0gsR0FBRztBQUNMO0FBRUEsTUFBTSxjQUFjO0FBQ3BCLE1BQU0sdUJBQStCLHdCQUF3QjtBQUU3RCxNQUFNLGdDQUFnQyxJQUFJLElBQUkseUJBQXlCO0FBaUl2RSxlQUFzQiw4QkFBOEIsWUFBbUM7QUFD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

package/dist/lib/esm/bundlers/obsidian-plugin-features.d.mts

@@ -0,0 +1,186 @@
+/// <reference path="../library-references.d.mts" />
+/**
+ * @file
+ *
+ * The build features every bundler adapter offers beside the plain plugin build: a UI framework, the stylesheet
+ * pipeline and WebAssembly. Every adapter takes the same {@link ObsidianPluginFeatureOptions}, so a project that
+ * switches bundler keeps its options and its installed packages.
+ *
+ * Each feature's packages are optional peer dependencies of the toolkit, imported from the PROJECT's own
+ * `node_modules` only when the feature is on, through {@link importOptionalPeer}.
+ *
+ * Erasable TypeScript only (no enums, no parameter properties): `obsidian-plugin-transforms.ts` imports this module,
+ * and a webpack loader or a parcel worker loads that one straight from source when the toolkit runs from source.
+ */
+/**
+ * Which shared transform a module goes through, as {@link getFeatureFileKind} tells it.
+ */
+export type FeatureFileKind = 'jsx' | 'stylesheet' | 'svelte' | 'wasm';
+/**
+ * Parameters for {@link getFrameworkDefines}.
+ */
+export interface GetFrameworkDefinesParams {
+    /**
+     * The UI framework, if any.
+     */
+    readonly framework: ObsidianPluginFramework | undefined;
+    /**
+     * Whether this is a production build.
+     */
+    readonly isProductionBuild: boolean;
+}
+/**
+ * Parameters for {@link importOptionalPeer}.
+ */
+export interface ImportOptionalPeerParams {
+    /**
+     * The option that needs the package, as the error message names it, e.g. `framework: 'solid'`.
+     */
+    readonly feature: string;
+    /**
+     * The package to install when it is missing.
+     */
+    readonly packageName: string;
+    /**
+     * The folder whose `node_modules` the package is resolved from. Defaults to the project root.
+     */
+    readonly projectFolder?: string;
+    /**
+     * The module to import. Defaults to {@link packageName}.
+     */
+    readonly specifier?: string;
+}
+/**
+ * The build features beside the plain plugin build. Every option is off unless set.
+ */
+export interface ObsidianPluginFeatureOptions {
+    /**
+     * The UI framework whose components the build compiles.
+     */
+    readonly framework?: ObsidianPluginFramework;
+    /**
+     * The stylesheet pipeline.
+     */
+    readonly styles?: ObsidianPluginStylesOptions;
+    /**
+     * Whether `import bytes from './module.wasm'` imports the module's bytes as a `Uint8Array`, inlined into `main.js`.
+     */
+    readonly wasm?: boolean;
+}
+/**
+ * A UI framework the bundler adapters compile.
+ *
+ * - `react` and `preact` compile JSX with the automatic runtime from `react` / `preact`.
+ * - `solid` compiles JSX with `babel-preset-solid`.
+ * - `svelte` compiles `.svelte` components and `.svelte.ts` / `.svelte.js` modules with the project's `svelte`.
+ * - `vue` compiles single-file components with `unplugin-vue` (on parcel, with `@parcel/transformer-vue`).
+ */
+export type ObsidianPluginFramework = 'preact' | 'react' | 'solid' | 'svelte' | 'vue';
+/**
+ * The stylesheet pipeline of {@link ObsidianPluginFeatureOptions}.
+ */
+export interface ObsidianPluginStylesOptions {
+    /**
+     * Whether a `*.module.css` file is a CSS module: its class names are scoped, and importing it gives the scoped
+     * names by their original ones.
+     */
+    readonly cssModules?: boolean;
+    /**
+     * Whether every stylesheet goes through the project's PostCSS configuration (`postcss.config.*`, `.postcssrc*`, or
+     * `postcss` in `package.json`).
+     */
+    readonly postcss?: boolean;
+    /**
+     * Whether every stylesheet goes through Tailwind CSS 4 (`@tailwindcss/postcss`), so `@import "tailwindcss";`
+     * expands to the utilities the sources use.
+     */
+    readonly tailwind?: boolean;
+}
+/**
+ * Parameters for {@link requireOptionalPeer}: the same as {@link ImportOptionalPeerParams}.
+ */
+export type RequireOptionalPeerParams = ImportOptionalPeerParams;
+/**
+ * Parameters for {@link resolveOptionalPeer}: the same as {@link ImportOptionalPeerParams}.
+ */
+export type ResolveOptionalPeerParams = ImportOptionalPeerParams;
+/**
+ * Tells which shared transform a module of a rollup-family build goes through, by its id.
+ *
+ * A virtual module (an id starting with `\0`) goes through none. A query is part of the match for a stylesheet, so a
+ * Vue component's `?vue&type=style&lang.css` block counts as one, and is cut off for the rest.
+ *
+ * @param id - The module id.
+ * @returns The kind of file, or `undefined` for a module no feature transforms.
+ */
+export declare function getFeatureFileKind(id: string): FeatureFileKind | undefined;
+/**
+ * Builds the compile-time constants a framework's runtime reads, which Obsidian's renderer does not define.
+ *
+ * `process.env.NODE_ENV` picks a runtime's production build (React, Preact's devtools, Vue, Solid), and without it a
+ * production plugin would bundle and run the development one. Vue also reads its three feature flags.
+ *
+ * @param params - The {@link GetFrameworkDefinesParams}.
+ * @returns The constants, by expression, each value a JavaScript literal. Empty when there is no framework.
+ */
+export declare function getFrameworkDefines(params: GetFrameworkDefinesParams): Record<string, string>;
+/**
+ * Tells which package supplies the automatic JSX runtime of a framework.
+ *
+ * @param framework - The UI framework, if any.
+ * @returns `react` or `preact`, or `undefined` for a framework that does not compile JSX with the automatic runtime.
+ */
+export declare function getJsxImportSource(framework: ObsidianPluginFramework | undefined): 'preact' | 'react' | undefined;
+/**
+ * Imports an optional peer dependency from the project's own `node_modules`.
+ *
+ * Resolved from the project rather than from the toolkit, so a package manager that does not hoist still finds what
+ * the project installed.
+ *
+ * @typeParam Module - The module's type.
+ * @param params - The {@link ImportOptionalPeerParams}.
+ * @returns A {@link Promise} that resolves to the module namespace.
+ * @throws If the project does not have the package, naming the option that needs it and the command that installs it.
+ */
+export declare function importOptionalPeer<Module>(params: ImportOptionalPeerParams): Promise<Module>;
+/**
+ * Tells whether a stylesheet is a CSS module by its file name.
+ *
+ * @param filePath - The stylesheet's path.
+ * @returns `true` for `*.module.css` (and `.module.pcss`, `.module.scss`, `.module.sass`).
+ */
+export declare function isCssModuleFile(filePath: string): boolean;
+/**
+ * Tells whether a stylesheet goes through PostCSS at all.
+ *
+ * @param styles - The stylesheet options, if any.
+ * @returns `true` when the project's PostCSS configuration or Tailwind applies.
+ */
+export declare function isPostcssNeeded(styles: ObsidianPluginStylesOptions | undefined): boolean;
+/**
+ * Replaces each compile-time constant in a module's code with its value, as a bundler's `define` does: only where
+ * the whole expression stands on its own, so `process.env.NODE_ENV` is replaced and `a.process.env.NODE_ENV` or
+ * `process.env.NODE_ENV_X` are not.
+ *
+ * @param code - The module's code.
+ * @param defines - The constants, by expression, each value a JavaScript literal.
+ * @returns The code with the constants replaced.
+ */
+export declare function replaceDefines(code: string, defines: Readonly<Record<string, string>>): string;
+/**
+ * Loads an optional peer dependency from the project's own `node_modules` synchronously, for a bundler whose plugins
+ * are applied synchronously (webpack). Loads an ES module too, through `require`.
+ *
+ * @param params - The {@link RequireOptionalPeerParams}.
+ * @returns The module, for the caller to type.
+ * @throws If the project does not have the package, naming the option that needs it and the command that installs it.
+ */
+export declare function requireOptionalPeer(params: RequireOptionalPeerParams): unknown;
+/**
+ * Resolves an optional peer dependency from the project's own `node_modules`.
+ *
+ * @param params - The {@link ResolveOptionalPeerParams}.
+ * @returns The absolute path of the module.
+ * @throws If the project does not have the package, naming the option that needs it and the command that installs it.
+ */
+export declare function resolveOptionalPeer(params: ResolveOptionalPeerParams): string;