@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.0.0

package/dist/lib/cjs/linters/over-exposure.d.cts

@@ -0,0 +1,357 @@
+/// <reference path="../index.d.cts" />
+/**
+ * @file
+ *
+ * Over-exposure analyzer.
+ *
+ * Finds declarations exposed more broadly than their references require, so the exposure can be
+ * tightened:
+ *
+ * - `export`ed symbols referenced only within their own file — the `export` can be dropped.
+ * - `public` class members referenced only inside their own class — they can be `private`.
+ * - `public` class members referenced only inside their own class and its subclasses — they can be
+ *   `protected`.
+ * - `protected` class members referenced only inside their own class — they can be `private`.
+ *
+ * The analysis is whole-program and type-aware: it uses the TypeScript language service's
+ * find-all-references to locate every use of each declaration, then classifies the tightest
+ * exposure that still covers all references. Because `findReferences` does not link a string-literal
+ * argument back to a member declaration when the parameter is a conditional/mapped key type (e.g.
+ * `bind(component, 'someSetting')` where the key is typed `ConditionalKeys<Settings, …>`), member
+ * analysis additionally treats a string literal whose text equals the member name as a reference —
+ * but only when its contextual type is a string-literal type (or union of them) all of whose members
+ * are keys of the declaring class, so incidental same-named strings (`console.log('name')`) are not
+ * miscounted. Members invoked by the framework via registration
+ * rather than by visible references (Obsidian lifecycle hooks, settings-tab `display`, etc.) are
+ * excluded via {@link LIFECYCLE_ALLOWLIST}, as are `override` and `static` members whose exposure is
+ * constrained by a base declaration. ECMAScript hard-private members (`#name`) are also excluded —
+ * they are already maximally private and cannot carry a visibility modifier. A declaration carrying
+ * a TSDoc (`/** … *\/`) documentation comment is likewise excluded — whether a top-level `export` or
+ * a class member, documenting it is a deliberate signal that it is part of the intended public API,
+ * regardless of where it currently happens to be referenced.
+ *
+ * A member referenced only from test files is reported with {@link OverExposureFinding.isForcedByTestOnly}
+ * set, surfacing members widened purely for testability — the canonical case for extracting logic
+ * into an independently testable component instead.
+ *
+ * Beyond reporting, passing `shouldFix` to {@link findOverExposure} / {@link analyzeOverExposure}
+ * rewrites the source in place: dropping the `export` keyword, or replacing/inserting a `private`
+ * or `protected` modifier. Each finding then carries {@link OverExposureFinding.wasFixed} /
+ * {@link OverExposureFinding.skipReason}. Changes that cannot be safely automated — those forced
+ * only by test references, decorated members, or an `export` shared with a still-exported sibling —
+ * are reported as skipped and left untouched.
+ *
+ * Additionally passing `shouldForce` (only meaningful together with `shouldFix`) tightens the
+ * declarations held wide purely by test references too — the production half of the canonical
+ * test-only migration: the member becomes `private` / the `export` is dropped, leaving only the
+ * test to switch to a cast-based access. Decorated members and exports shared with a still-exported
+ * sibling stay skipped even under `shouldForce`, because no edit can be applied safely.
+ */
+import type { CompilerOptions, LanguageService, LanguageServiceHost } from 'typescript' with { 'resolution-mode': 'import' };
+/**
+ * Parameters for {@link analyzeOverExposure}.
+ */
+export interface AnalyzeOverExposureParams {
+    /**
+    The language service to query for references and types.
+     */
+    readonly languageService: LanguageService;
+    /**
+     * Optional callback invoked once per analyzed source file, before that file is processed. The
+     * whole-program reference analysis is slow, so this lets callers report live progress instead of
+     * appearing to hang.
+     */
+    readonly onProgress?: (progress: OverExposureProgress) => void;
+    /**
+     * When `true`, each fixable finding is tightened in place via {@link writeFile} (which must then
+     * be provided), and the returned findings carry {@link OverExposureFinding.wasFixed} /
+     * {@link OverExposureFinding.skipReason}. When `false` or omitted, the analysis only reports.
+     *
+     * @default `false`
+     */
+    readonly shouldFix?: boolean | undefined;
+    /**
+     * When `true` (only meaningful together with {@link shouldFix}), declarations held wide purely by
+     * test references are tightened too, instead of being skipped with a `test-only`
+     * {@link OverExposureFinding.skipReason}. Decorated members and exports shared with a
+     * still-exported sibling stay skipped regardless, because no edit can be applied safely.
+     *
+     * @default `false`
+     */
+    readonly shouldForce?: boolean | undefined;
+    /**
+     * Absolute (canonical) path of the project's `src` folder. Only declarations in non-test files
+     * under this folder are analyzed; declarations elsewhere (test files, dependencies) are ignored
+     * but still counted as reference sites.
+     */
+    readonly srcFolder: string;
+    /**
+     * Writes the tightened contents of a changed file back to disk. Required when {@link shouldFix}
+     * is `true`; ignored otherwise.
+     *
+     * @param path - Absolute path of the file to write (original casing, as stored in the program).
+     * @param content - The full new file contents.
+     */
+    readonly writeFile?: (path: string, content: string) => void;
+}
+/**
+ * Parameters for {@link createLanguageServiceHost}.
+ */
+export interface CreateLanguageServiceHostParams {
+    /**
+    The compiler options.
+     */
+    readonly compilerOptions: CompilerOptions;
+    /**
+    The files to include in the program.
+     */
+    readonly fileNames: readonly string[];
+    /**
+    The file-system operations used to read sources.
+     */
+    readonly fileSystem: OverExposureFileSystem;
+}
+/**
+ * Parameters for {@link createProjectLanguageService}.
+ */
+export interface CreateProjectLanguageServiceParams {
+    /**
+    Absolute path to the project's `tsconfig.json`.
+     */
+    readonly tsConfigPath: string;
+}
+/**
+ * The exposure level a declaration currently has.
+ */
+export type CurrentExposure = 'export' | 'protected' | 'public';
+/**
+ * Parameters for {@link findOverExposure}.
+ */
+export interface FindOverExposureParams {
+    /**
+     * Optional callback invoked once per analyzed source file, for live progress reporting. Forwarded
+     * to {@link analyzeOverExposure}.
+     */
+    readonly onProgress?: (progress: OverExposureProgress) => void;
+    /**
+    Absolute path to the project root (the folder containing `tsconfig.json` and `src`).
+     */
+    readonly projectFolder: string;
+    /**
+     * When `true`, fixable findings are tightened in place on disk (the `export` keyword is dropped,
+     * or a `private` / `protected` modifier is inserted/replaced). When `false` or omitted, the
+     * project is only analyzed.
+     *
+     * @default `false`
+     */
+    readonly shouldFix?: boolean | undefined;
+    /**
+     * When `true` (only meaningful together with {@link shouldFix}), declarations held wide purely by
+     * test references are tightened too, instead of being skipped. Decorated members and exports
+     * shared with a still-exported sibling stay skipped regardless. Forwarded to
+     * {@link analyzeOverExposure}.
+     *
+     * @default `false`
+     */
+    readonly shouldForce?: boolean | undefined;
+}
+/**
+ * Options for {@link formatOverExposureFindings}.
+ */
+export interface FormatOverExposureFindingsOptions {
+    /**
+     * When set, file paths in the report are rendered relative to this folder (typically the current
+     * working directory) instead of as absolute paths. Paths outside the folder stay absolute.
+     */
+    readonly baseFolder?: string;
+}
+/**
+ * The subset of file-system operations the language-service host needs. Injecting this (rather than
+ * always using `typescript`'s `sys`) lets tests drive the analyzer against in-memory sources with no
+ * real file-system access.
+ */
+export interface OverExposureFileSystem {
+    /**
+     * Checks whether a directory exists.
+     *
+     * @param path - Directory path.
+     * @returns `true` when the directory exists.
+     */
+    directoryExists: (path: string) => boolean;
+    /**
+     * Checks whether a file exists.
+     *
+     * @param path - File path.
+     * @returns `true` when the file exists.
+     */
+    fileExists: (path: string) => boolean;
+    /**
+     * Resolves the directory that relative paths are resolved against.
+     *
+     * @returns The current working directory.
+     */
+    getCurrentDirectory: () => string;
+    /**
+     * Lists the immediate subdirectories of a directory.
+     *
+     * @param path - Directory path.
+     * @returns The immediate subdirectory names.
+     */
+    getDirectories: (path: string) => string[];
+    /**
+     * Lists the files under a directory, filtered by extension and include/exclude patterns.
+     *
+     * @param path - Root directory.
+     * @param extensions - Extensions to include.
+     * @param exclude - Patterns to exclude.
+     * @param include - Patterns to include.
+     * @param depth - Maximum recursion depth.
+     * @returns The matching file paths.
+     */
+    readDirectory: (path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number) => string[];
+    /**
+     * Reads a file as text.
+     *
+     * @param path - File path.
+     * @returns The file contents, or `undefined` when absent.
+     */
+    readFile: (path: string) => string | undefined;
+}
+/**
+ * A single over-exposed declaration.
+ */
+export interface OverExposureFinding {
+    /**
+    1-based column of the declaration's name.
+     */
+    readonly column: number;
+    /**
+    The current exposure level.
+     */
+    readonly currentExposure: CurrentExposure;
+    /**
+    Absolute path of the file declaring the symbol.
+     */
+    readonly filePath: string;
+    /**
+    `true` when the declaration has no references at all (besides itself).
+     */
+    readonly hasNoReferences: boolean;
+    /**
+     * `true` when the declaration would qualify for a tighter exposure if not for references coming
+     * exclusively from test files — i.e. it is exposed purely for testability.
+     */
+    readonly isForcedByTestOnly: boolean;
+    /**
+    `true` for a class member, `false` for a top-level export.
+     */
+    readonly isMember: boolean;
+    /**
+    1-based line of the declaration's name.
+     */
+    readonly line: number;
+    /**
+    The declared name.
+     */
+    readonly name: string;
+    /**
+     * In a fix run, why this finding was left untouched instead of tightened; `null` when it was
+     * fixed or when the analysis only reported (`shouldFix` off).
+     */
+    readonly skipReason: null | OverExposureSkipReason;
+    /**
+    The exposure the declaration could be tightened to.
+     */
+    readonly suggestedExposure: SuggestedExposure;
+    /**
+    `true` when a fix run tightened this declaration in place. Always `false` in a report run.
+     */
+    readonly wasFixed: boolean;
+}
+/**
+ * Progress reported while analyzing a project, one event per analyzed source file.
+ */
+export interface OverExposureProgress {
+    /**
+    Number of source files fully analyzed before the current one (0-based).
+     */
+    readonly analyzedFileCount: number;
+    /**
+    Absolute (canonical) path of the source file about to be analyzed.
+     */
+    readonly currentFilePath: string;
+    /**
+    Total number of source files that will be analyzed.
+     */
+    readonly totalFileCount: number;
+}
+/**
+ * Why a fix run left a finding untouched:
+ *
+ * - `decorated` — the member carries a decorator, so the modifier insertion point is ambiguous.
+ * - `shared-export` — the `export` keyword is shared with a still-exported sibling declarator.
+ * - `test-only` — the declaration is exposed purely for tests, so tightening would break the test.
+ */
+export type OverExposureSkipReason = 'decorated' | 'shared-export' | 'test-only';
+/**
+ * The (tighter) exposure level a declaration could be reduced to.
+ */
+export type SuggestedExposure = 'file-local' | 'private' | 'protected';
+/**
+ * Lifecycle and framework members invoked by Obsidian or a base class via registration rather than
+ * by references the language service can see. Tightening these would break the framework contract,
+ * so they are never reported.
+ */
+export declare const LIFECYCLE_ALLOWLIST: ReadonlySet<string>;
+/**
+ * Analyzes a project (already loaded into a language service) for over-exposed declarations, and —
+ * when {@link AnalyzeOverExposureParams.shouldFix} is set — tightens every fixable finding in place
+ * via {@link AnalyzeOverExposureParams.writeFile}. Findings that cannot be safely automated (exposed
+ * only for tests, decorated, or sharing an `export` keyword with a still-exported sibling) carry a
+ * {@link OverExposureFinding.skipReason} and are left untouched — unless
+ * {@link AnalyzeOverExposureParams.shouldForce} is set, which additionally tightens the test-only
+ * findings (decorated and shared-export ones still stay skipped).
+ *
+ * @param params - The {@link AnalyzeOverExposureParams}.
+ * @returns The over-exposed declarations, in discovery order.
+ */
+export declare function analyzeOverExposure(params: AnalyzeOverExposureParams): OverExposureFinding[];
+/**
+ * Builds a {@link LanguageServiceHost} backed by an explicit file list and file system.
+ *
+ * @param params - The {@link CreateLanguageServiceHostParams}.
+ * @returns The language-service host.
+ */
+export declare function createLanguageServiceHost(params: CreateLanguageServiceHostParams): LanguageServiceHost;
+/**
+ * Builds a language service over every file in a project's `tsconfig.json`.
+ *
+ * @param params - The {@link CreateProjectLanguageServiceParams}.
+ * @returns A language service ready for {@link analyzeOverExposure}.
+ */
+export declare function createProjectLanguageService(params: CreateProjectLanguageServiceParams): LanguageService;
+/**
+ * Finds over-exposed declarations in a project on disk. When
+ * {@link FindOverExposureParams.shouldFix} is set, each fixable finding is also tightened in place
+ * (rewriting the affected source files via `typescript`'s `sys.writeFile`).
+ *
+ * @param params - The {@link FindOverExposureParams}.
+ * @returns The over-exposed declarations.
+ */
+export declare function findOverExposure(params: FindOverExposureParams): OverExposureFinding[];
+/**
+ * Formats over-exposure findings as a human-readable report, using the grouped layout of ESLint's
+ * `stylish` formatter. Findings are grouped by file and sorted by line: each file is rendered as a
+ * `path` header line, followed by one indented `  line:column  change -- reason` row per finding (the
+ * `line:column` is right-padded so the rows align within a file). Terminals such as VS Code render
+ * each indented `line:column` as a clickable link — resolved against the file header above it — that
+ * jumps straight to the declaration. File groups are separated by a blank line. In a fix run (findings
+ * carrying {@link OverExposureFinding.wasFixed} / {@link OverExposureFinding.skipReason}) each change
+ * row is suffixed with `[fixed]` or `[skipped: …]`, and the trailing summary appends the fixed/skipped
+ * counts.
+ *
+ * @param findings - The findings to format.
+ * @param options - The {@link FormatOverExposureFindingsOptions}.
+ * @returns The report text. Empty-finding input yields a single "no findings" line.
+ */
+export declare function formatOverExposureFindings(findings: readonly OverExposureFinding[], options?: FormatOverExposureFindingsOptions): string;

package/dist/lib/cjs/nano-staged-config.cjs

@@ -0,0 +1,148 @@
+/*
+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();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var nano_staged_config_exports = {};
+__export(nano_staged_config_exports, {
+  getNanoStagedConfig: () => getNanoStagedConfig,
+  obsidianDevUtilsConfig: () => obsidianDevUtilsConfig
+});
+module.exports = __toCommonJS(nano_staged_config_exports);
+var import_node_process = __toESM(__extractDefault(require('node:process')), 1);
+var import_env_toggle = require('./env-toggle.cjs');
+var import_package_manager = require('./package-manager.cjs');
+const PACKAGE_MANAGER_RUN_COMMAND = (0, import_package_manager.getPackageManagerRunCommand)().join(" ");
+const SPELLCHECK_COMMAND = `${PACKAGE_MANAGER_RUN_COMMAND} spellcheck --`;
+const WRITER_TASKS = {
+  "*.{ts,tsx,mts}": [
+    `${PACKAGE_MANAGER_RUN_COMMAND} lint:fix --`,
+    `${PACKAGE_MANAGER_RUN_COMMAND} format --`
+  ],
+  "*.md": [
+    `${PACKAGE_MANAGER_RUN_COMMAND} lint:md:fix --`
+  ]
+};
+const obsidianDevUtilsConfig = partitionSpellcheck(WRITER_TASKS);
+const NANO_STAGED_ENV_VARIABLE = "NANO_STAGED";
+function getNanoStagedConfig(options) {
+  (0, import_env_toggle.loadEnvFileIfExists)();
+  if ((0, import_env_toggle.isEnvVariableOff)(NANO_STAGED_ENV_VARIABLE)) {
+    import_node_process.default.stdout.write(`nano-staged: skipped (${NANO_STAGED_ENV_VARIABLE} is off).
+`);
+    import_node_process.default.exit(0);
+  }
+  const additionalWriterTasks = options?.additionalWriterTasks ?? {};
+  if (Object.keys(additionalWriterTasks).length === 0) {
+    return obsidianDevUtilsConfig;
+  }
+  const duplicatePattern = Object.keys(additionalWriterTasks).find((pattern) => Object.hasOwn(WRITER_TASKS, pattern));
+  if (duplicatePattern !== void 0) {
+    throw new Error(`nano-staged writer pattern '${duplicatePattern}' is already a shared writer pattern.`);
+  }
+  return partitionSpellcheck({ ...WRITER_TASKS, ...additionalWriterTasks });
+}
+function partitionSpellcheck(writerTasks) {
+  const patterns = Object.keys(writerTasks);
+  const patternWithSlash = patterns.find((pattern) => pattern.includes("/"));
+  if (patternWithSlash !== void 0) {
+    throw new Error(`nano-staged writer pattern '${patternWithSlash}' contains '/', which the spellcheck partition cannot express.`);
+  }
+  const complementPattern = `!(${patterns.map((pattern) => `${pattern}!(?)`).join("|")})*`;
+  const config = {
+    [complementPattern]: [SPELLCHECK_COMMAND]
+  };
+  for (const [pattern, commands] of Object.entries(writerTasks)) {
+    config[pattern] = [...commands, SPELLCHECK_COMMAND];
+  }
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getNanoStagedConfig,
+  obsidianDevUtilsConfig
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25hbm8tc3RhZ2VkLWNvbmZpZy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFNoYXJlZCBuYW5vLXN0YWdlZCBjb25maWd1cmF0aW9uIGZvciBwcmUtY29tbWl0IGhvb2tzLlxuICovXG5cbmltcG9ydCBwcm9jZXNzIGZyb20gJ25vZGU6cHJvY2Vzcyc7XG5cbmltcG9ydCB7XG4gIGlzRW52VmFyaWFibGVPZmYsXG4gIGxvYWRFbnZGaWxlSWZFeGlzdHNcbn0gZnJvbSAnLi9lbnYtdG9nZ2xlLnRzJztcbmltcG9ydCB7IGdldFBhY2thZ2VNYW5hZ2VyUnVuQ29tbWFuZCB9IGZyb20gJy4vcGFja2FnZS1tYW5hZ2VyLnRzJztcblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgZ2V0TmFub1N0YWdlZENvbmZpZ30uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgR2V0TmFub1N0YWdlZENvbmZpZ09wdGlvbnMge1xuICAvKipcbiAgICogUmVwby1zcGVjaWZpYyBmaWxlLXJld3JpdGluZyB0YXNrcywga2V5ZWQgYnkgdGhlIG5hbm8tc3RhZ2VkIHBhdHRlcm4gdGhhdCBjbGFpbXMgdGhlaXIgZmlsZXMuXG4gICAqXG4gICAqIEVhY2ggZ2V0cyBzcGVsbGNoZWNrIGFwcGVuZGVkIGFuZCBpdHMgZmlsZXMgcmVtb3ZlZCBmcm9tIHRoZSBzcGVsbGNoZWNrLW9ubHkga2V5LCBleGFjdGx5IGxpa2UgdGhlIHNoYXJlZFxuICAgKiB3cml0ZXJzLiBBIHBhdHRlcm4gbXVzdCBub3QgY29udGFpbiBgL2AsIGFuZCBtdXN0IG5vdCByZXBlYXQgYSBzaGFyZWQgd3JpdGVyIHBhdHRlcm4uXG4gICAqL1xuICByZWFkb25seSBhZGRpdGlvbmFsV3JpdGVyVGFza3M/OiBSZWFkb25seTxSZWNvcmQ8c3RyaW5nLCByZWFkb25seSBzdHJpbmdbXT4+O1xufVxuXG4vKipcbiAqIFRoZSBgPG1hbmFnZXI+IHJ1bmAgcHJlZml4IGV2ZXJ5IHRhc2sgYmVsb3cgaXMgYnVpbHQgb24sIHJlc29sdmVkIG9uY2UgZm9yIHRoZSBwcm9jZXNzLlxuICpcbiAqIERldGVjdGlvbiBwcm9iZXMgZm9yIGEgbG9ja2ZpbGUgYmVzaWRlIGBwYWNrYWdlLmpzb25gLCBzbyBpdCBpcyBhIGhhbmRmdWwgb2YgYGV4aXN0c1N5bmNgIGNhbGxzIGFuZFxuICogbm90aGluZyBtb3JlIFx1MjAxNCBubyBgLmVudmAgcmVhZCBhbmQgbm8gYHByb2Nlc3MuZXhpdGAsIHdoaWNoIGlzIHdoYXQgbGV0cyBpdCBzaXQgYXQgbW9kdWxlIHNjb3BlLlxuICovXG5jb25zdCBQQUNLQUdFX01BTkFHRVJfUlVOX0NPTU1BTkQgPSBnZXRQYWNrYWdlTWFuYWdlclJ1bkNvbW1hbmQoKS5qb2luKCcgJyk7XG5cbmNvbnN0IFNQRUxMQ0hFQ0tfQ09NTUFORCA9IGAke1BBQ0tBR0VfTUFOQUdFUl9SVU5fQ09NTUFORH0gc3BlbGxjaGVjayAtLWA7XG5cbi8qKlxuICogVGhlIHRhc2tzIHRoYXQgUkVXUklURSBhIHN0YWdlZCBmaWxlLCBrZXllZCBieSB0aGUgbmFuby1zdGFnZWQgcGF0dGVybiB0aGF0IGNsYWltcyBpdC5cbiAqXG4gKiBgbGludDpmaXhgIGFuZCBgZm9ybWF0YCBib3RoIHJld3JpdGUgdGhlIGZpbGUsIHNvIHRoZXkgaGF2ZSB0byBzaGFyZSBvbmUga2V5OiBuYW5vLXN0YWdlZCBydW5zIGl0c1xuICogcGVyLXBhdHRlcm4gZ3JvdXBzIHVuZGVyIGBQcm9taXNlLmFsbGAgKGBydW4oKWAgaW4gYG5hbm8tc3RhZ2VkL2xpYi9jbWQtcnVubmVyLmpzYCksIGFuZCBzZXF1ZW5jZXMgb25seVxuICogdGhlIGNvbW1hbmRzIElOU0lERSBhIHNpbmdsZSBrZXkncyBhcnJheSAoYHJ1blRhc2soKWAsIGEgYGZvciAuLi4gb2YgYXdhaXRgKS4gU3BsaXQgYWNyb3NzIHR3byBrZXlzIHRoZXlcbiAqIHJhY2UsIHdoaWNoZXZlciBmaW5pc2hlcyBsYXN0IHdpbnMsIGFuZCB0aGUgY29tbWl0IHN0YWdlcyBieXRlcyB0aGF0IG5laXRoZXIgdG9vbCB3b3VsZCBoYXZlIHByb2R1Y2VkIG9uXG4gKiBpdHMgb3duLlxuICpcbiAqIFNvIGRvIE5PVCBleHByZXNzIGEgZGlyZWN0b3J5IGV4Y2x1c2lvbiBieSBnaXZpbmcgb25lIG9mIHRoZXNlIHR3byBpdHMgb3duIG5lZ2F0ZWQga2V5IC0tIHRoYXQgc2lsZW50bHlcbiAqIHRha2VzIHRoZSBvcmRlcmluZyBhd2F5LiBBbiBleGNsdXNpb24gYmVsb25ncyBpbiB0aGUgZXhjbHVkZWQgdG9vbCdzIG93biBjb25maWcsIHdoZXJlIEVTTGludCdzXG4gKiBgZ2xvYmFsSWdub3Jlc2AgYWxyZWFkeSBwdXRzIGl0OiBhIHBhdGggRVNMaW50IGlnbm9yZXMgaXMgcmVwb3J0ZWQgYXMgYSB3YXJuaW5nIGFuZCBleGl0cyAwIHdoZW4gaXQgaXNcbiAqIHBhc3NlZCBleHBsaWNpdGx5LCBzbyBpdCBjb3N0cyBhIGNvbnNvbGUgbGluZSByYXRoZXIgdGhhbiBhIGZhaWxlZCBjb21taXQgYW5kIG5lZWRzIG5vIGtleSBoZXJlLlxuICovXG5jb25zdCBXUklURVJfVEFTS1M6IFJlYWRvbmx5PFJlY29yZDxzdHJpbmcsIHJlYWRvbmx5IHN0cmluZ1tdPj4gPSB7XG4gICcqLnt0cyx0c3gsbXRzfSc6IFtcbiAgICBgJHtQQUNLQUdFX01BTkFHRVJfUlVOX0NPTU1BTkR9IGxpbnQ6Zml4IC0tYCxcbiAgICBgJHtQQUNLQUdFX01BTkFHRVJfUlVOX0NPTU1BTkR9IGZvcm1hdCAtLWBcbiAgXSxcbiAgJyoubWQnOiBbXG4gICAgYCR7UEFDS0FHRV9NQU5BR0VSX1JVTl9DT01NQU5EfSBsaW50Om1kOmZpeCAtLWBcbiAgXVxufTtcblxuLyoqXG4gKiBOYW5vLXN0YWdlZCBjb25maWd1cmF0aW9uIHRoYXQgcnVucyBmaWxlLWJhc2VkIGxpbnQsIGZvcm1hdCwgYW5kIHNwZWxsY2hlY2sgb24gc3RhZ2VkIGZpbGVzLlxuICpcbiAqIE9ubHkgaW5jbHVkZXMgdG9vbHMgdGhhdCBjYW4gb3BlcmF0ZSBvbiBpbmRpdmlkdWFsIGZpbGVzLiBXaG9sZS1wcm9qZWN0IGNoZWNrc1xuICogKFR5cGVTY3JpcHQgY29tcGlsYXRpb24sIHVuaXQgdGVzdHMpIGFyZSBsZWZ0IHRvIENJLlxuICpcbiAqIENvbW1hbmRzIHJ1biB0aHJvdWdoIHRoZSBwYWNrYWdlIG1hbmFnZXIgdGhhdCBvd25zIHRoZSB0cmVlIFx1MjAxNCBgbnBtIHJ1biAuLi4gLS1gLCBgYnVuIHJ1biAuLi4gLS1gLCBhbmRcbiAqIHNvIG9uIFx1MjAxNCBzbyBuYW5vLXN0YWdlZCBmaWxlIHBhdGhzIGFyZSBmb3J3YXJkZWQgYXMgQ0xJIGFyZ3VtZW50cy5cbiAqXG4gKiBTcGVsbGNoZWNrIGlzIHBhcnRpdGlvbmVkIGFjcm9zcyB0aGUga2V5cyByYXRoZXIgdGhhbiBnaXZlbiBhIGNhdGNoLWFsbCBgJyonYCBrZXkgKHNlZVxuICogYHBhcnRpdGlvblNwZWxsY2hlY2tgKS4gQSByZXBvIGFkZGluZyBhIGZpbGUtcmV3cml0aW5nIHRhc2sgb2YgaXRzIG93biBwYXNzZXMgaXQgdG9cbiAqIHtAbGluayBnZXROYW5vU3RhZ2VkQ29uZmlnfSBhcyBgYWRkaXRpb25hbFdyaXRlclRhc2tzYCByYXRoZXIgdGhhbiBzcHJlYWRpbmcgdGhpcyBvYmplY3QgYW5kIGFkZGluZyBhIGtleSxcbiAqIHdoaWNoIHdvdWxkIHJlaW50cm9kdWNlIHRoZSBvdmVybGFwIGZvciB0aGF0IGtleSdzIGZpbGVzLlxuICovXG5leHBvcnQgY29uc3Qgb2JzaWRpYW5EZXZVdGlsc0NvbmZpZzogUmVjb3JkPHN0cmluZywgc3RyaW5nW10+ID0gcGFydGl0aW9uU3BlbGxjaGVjayhXUklURVJfVEFTS1MpO1xuXG5jb25zdCBOQU5PX1NUQUdFRF9FTlZfVkFSSUFCTEUgPSAnTkFOT19TVEFHRUQnO1xuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBuYW5vLXN0YWdlZCBjb25maWd1cmF0aW9uIHRvIHVzZSwgaG9ub3JpbmcgYSBwZXItZGV2ZWxvcGVyIG9wdC1vdXQuXG4gKlxuICogTG9hZHMgYSBnaXRpZ25vcmVkIGAuZW52YCBpZiBwcmVzZW50LCB0aGVuIFx1MjAxNCB3aGVuIGBOQU5PX1NUQUdFRGAgaXMgc2V0IHRvIGFuIG9mZiB2YWx1ZSAoYDBgLCBgZmFsc2VgLFxuICogYG9mZmAsIG9yIGBub2ApIFx1MjAxNCBwcmludHMgYSBub3RpY2UgYW5kIGV4aXRzIHRoZSBwcm9jZXNzIHN1Y2Nlc3NmdWxseSBzbyB0aGUgcHJlLWNvbW1pdCBjaGVja3MgYXJlXG4gKiBza2lwcGVkLiBUaGlzIG1pcnJvcnMgaHVza3kncyBvd24gYEhVU0tZPTBgIHN3aXRjaCwgYnV0IHNjb3BlZCB0byB0aGUgbmFuby1zdGFnZWQgc3RlcCAoc28gdGhlXG4gKiBjb21taXQtbXNnIGhvb2sgc3RpbGwgcnVucykuIE90aGVyd2lzZSBpdCByZXR1cm5zIHtAbGluayBvYnNpZGlhbkRldlV0aWxzQ29uZmlnfSwgb3IgXHUyMDE0IHdoZW5cbiAqIGBhZGRpdGlvbmFsV3JpdGVyVGFza3NgIGFyZSBnaXZlbiBcdTIwMTQgdGhlIHNhbWUgY29uZmlndXJhdGlvbiByZS1wYXJ0aXRpb25lZCB3aXRoIHRob3NlIHdyaXRlcnMgYWRkZWQuXG4gKlxuICogYE5BTk9fU1RBR0VEYCBpcyBub3QgYW4gbnBtIHNjcmlwdCwgc28gaXQgY2FycmllcyBpdHMgb3duIHN3aXRjaCByYXRoZXIgdGhhbiB0aGUgc2NyaXB0LW5hbWUtZGVyaXZlZCBvbmVcbiAqIGV2ZXJ5IG5wbSBzY3JpcHQgZ2V0cyBcdTIwMTQgYnV0IGJvdGggc2hhcmUgdGhlIHNhbWUgbm90aW9uIG9mIGFuIG9mZiB2YWx1ZSwgdmlhIHtAbGluayBpc0VudlZhcmlhYmxlT2ZmfS5cbiAqXG4gKiBUaGlzIGlzIGEgZnVuY3Rpb24gcmF0aGVyIHRoYW4gbW9kdWxlLWxldmVsIGNvZGUgc28gaW1wb3J0aW5nIHRoZSBwYWNrYWdlIGJhcnJlbCBuZXZlciB0cmlnZ2VycyB0aGVcbiAqIGAuZW52YCByZWFkIG9yIHRoZSBwcm9jZXNzIGV4aXQ7IGNhbGwgaXQgZnJvbSB0aGUgdGhpbiBgc2NyaXB0cy9uYW5vLXN0YWdlZC1jb25maWcudHNgIGVudHJ5LiBSZXNvbHZpbmcgdGhlXG4gKiBwYWNrYWdlIG1hbmFnZXIgaXMgdGhlIG9uZSB0aGluZyB0aGF0IGRvZXMgcnVuIGF0IG1vZHVsZSBzY29wZSwgYW5kIGl0IGRvZXMgbmVpdGhlciBvZiB0aG9zZSB0d29cbiAqIHRoaW5ncyBcdTIwMTQgaXQgb25seSBwcm9iZXMgZm9yIGEgbG9ja2ZpbGUuXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgb3B0aW9uYWwgb3B0aW9ucy5cbiAqIEByZXR1cm5zIFRoZSBuYW5vLXN0YWdlZCB0YXNrIGNvbmZpZ3VyYXRpb24uIERvZXMgbm90IHJldHVybiB3aGVuIHRoZSBvcHQtb3V0IGlzIGFjdGl2ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldE5hbm9TdGFnZWRDb25maWcob3B0aW9ucz86IEdldE5hbm9TdGFnZWRDb25maWdPcHRpb25zKTogUmVjb3JkPHN0cmluZywgc3RyaW5nW10+IHtcbiAgbG9hZEVudkZpbGVJZkV4aXN0cygpO1xuXG4gIGlmIChpc0VudlZhcmlhYmxlT2ZmKE5BTk9fU1RBR0VEX0VOVl9WQVJJQUJMRSkpIHtcbiAgICBwcm9jZXNzLnN0ZG91dC53cml0ZShgbmFuby1zdGFnZWQ6IHNraXBwZWQgKCR7TkFOT19TVEFHRURfRU5WX1ZBUklBQkxFfSBpcyBvZmYpLlxcbmApO1xuICAgIHByb2Nlc3MuZXhpdCgwKTtcbiAgfVxuXG4gIGNvbnN0IGFkZGl0aW9uYWxXcml0ZXJUYXNrcyA9IG9wdGlvbnM/LmFkZGl0aW9uYWxXcml0ZXJUYXNrcyA/PyB7fTtcbiAgaWYgKE9iamVjdC5rZXlzKGFkZGl0aW9uYWxXcml0ZXJUYXNrcykubGVuZ3RoID09PSAwKSB7XG4gICAgcmV0dXJuIG9ic2lkaWFuRGV2VXRpbHNDb25maWc7XG4gIH1cblxuICBjb25zdCBkdXBsaWNhdGVQYXR0ZXJuID0gT2JqZWN0LmtleXMoYWRkaXRpb25hbFdyaXRlclRhc2tzKS5maW5kKChwYXR0ZXJuKSA9PiBPYmplY3QuaGFzT3duKFdSSVRFUl9UQVNLUywgcGF0dGVybikpO1xuICBpZiAoZHVwbGljYXRlUGF0dGVybiAhPT0gdW5kZWZpbmVkKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBuYW5vLXN0YWdlZCB3cml0ZXIgcGF0dGVybiAnJHtkdXBsaWNhdGVQYXR0ZXJufScgaXMgYWxyZWFkeSBhIHNoYXJlZCB3cml0ZXIgcGF0dGVybi5gKTtcbiAgfVxuXG4gIHJldHVybiBwYXJ0aXRpb25TcGVsbGNoZWNrKHsgLi4uV1JJVEVSX1RBU0tTLCAuLi5hZGRpdGlvbmFsV3JpdGVyVGFza3MgfSk7XG59XG5cbi8qKlxuICogQnVpbGRzIGEgbmFuby1zdGFnZWQgY29uZmlndXJhdGlvbiBpbiB3aGljaCBzcGVsbGNoZWNrIG5ldmVyIHJlYWRzIGEgZmlsZSB3aGlsZSBhbm90aGVyIHRhc2sgcmV3cml0ZXMgaXQuXG4gKlxuICogVGhlIHNhbWUgYFByb21pc2UuYWxsYCB0aGF0IGZvcmNlcyB0d28gd3JpdGVycyBpbnRvIG9uZSBrZXkgbWFrZXMgYSBjYXRjaC1hbGwgYCcqJ2Agc3BlbGxjaGVjayBrZXkgcnVuXG4gKiBDT05DVVJSRU5UTFkgd2l0aCBldmVyeSB3cml0ZXIga2V5LCBzbyBjc3BlbGwgd291bGQgcmVhZCBhIGZpbGUgdGhhdCBFU0xpbnQgb3IgZHByaW50IGlzIHJld3JpdGluZyBpblxuICogcGxhY2UgLS0gYSBzcHVyaW91cyBmaW5kaW5nIG9uIGEgaGFsZi13cml0dGVuIGZpbGUsIG9yIGEgcGFzcyBvdmVyIGNvbnRlbnQgdGhhdCBpcyBub3Qgd2hhdCBnZXRzXG4gKiBjb21taXR0ZWQuIFNvIHRoZSBzdGFnZWQgZmlsZXMgYXJlIFBBUlRJVElPTkVEIGluc3RlYWQ6XG4gKlxuICogLSBldmVyeSB3cml0ZXIga2V5IGdldHMgc3BlbGxjaGVjayBhcHBlbmRlZCBhcyBpdHMgTEFTVCBjb21tYW5kLCBzbyBpdCByZWFkcyB0aGF0IGtleSdzIGZpbGVzIGFmdGVyIHRoZXlcbiAqICAgaGF2ZSBiZWVuIHJld3JpdHRlbjtcbiAqIC0gb25lIGNvbXBsZW1lbnQga2V5IHNwZWxsY2hlY2tzIGV4YWN0bHkgdGhlIGZpbGVzIG5vIHdyaXRlciBrZXkgY2xhaW1zLlxuICpcbiAqIFRoZSBjb21wbGVtZW50IGlzIHdyaXR0ZW4gaW4gbmFuby1zdGFnZWQncyBvd24gZ2xvYiBkaWFsZWN0LCB3aGljaCBjb21waWxlcyBgISguLi4pYCB0byBhIGxvb2thaGVhZCB0aGF0XG4gKiBpcyBOT1QgYW5jaG9yZWQgYXQgdGhlIGVuZCBvZiB0aGUgcGF0aDogYCEoKi5tZCkqYCB3b3VsZCBleGNsdWRlIGBub3Rlcy5tZC5iYWtgIHRvby4gQSBuZXN0ZWQgYCEoPylgXG4gKiBjb21waWxlcyB0byBgKD8hLilgLCB3aGljaCBJUyBhbiBlbmQgYW5jaG9yLCBzbyBlYWNoIGFsdGVybmF0aXZlIGlzIHN1ZmZpeGVkIHdpdGggaXQuIEEgd3JpdGVyIHBhdHRlcm5cbiAqIGNvbnRhaW5pbmcgYC9gIHdvdWxkIHN3aXRjaCBuYW5vLXN0YWdlZCBpbnRvIGdsb2JzdGFyIG1vZGUsIHdoZXJlIGAqYCBzdG9wcyBjcm9zc2luZyBkaXJlY3RvcmllcyBhbmQgdGhlXG4gKiBjb25zdHJ1Y3Rpb24gbm8gbG9uZ2VyIGhvbGRzIC0tIGhlbmNlIHRoZSB0aHJvdy4gVGhlIHVuaXQgdGVzdCBwaW5zIHRoZSBwYXJ0aXRpb24gYWdhaW5zdCB0aGUgaW5zdGFsbGVkXG4gKiBuYW5vLXN0YWdlZCBjb21waWxlciwgc28gYSByZWxlYXNlIHRoYXQgY2hhbmdlcyBpdHMgZGlhbGVjdCBmYWlscyB0aGVyZSByYXRoZXIgdGhhbiBpbiBhIGNvbW1pdC5cbiAqXG4gKiBAcGFyYW0gd3JpdGVyVGFza3MgLSBUaGUgZmlsZS1yZXdyaXRpbmcgdGFza3MsIGtleWVkIGJ5IHRoZSBwYXR0ZXJuIHRoYXQgY2xhaW1zIHRoZWlyIGZpbGVzLlxuICogQHJldHVybnMgVGhlIGNvbmZpZ3VyYXRpb24sIHdpdGggdGhlIHNwZWxsY2hlY2sgc3RlcCBwYXJ0aXRpb25lZCBhY3Jvc3MgdGhlIGtleXMuXG4gKi9cbmZ1bmN0aW9uIHBhcnRpdGlvblNwZWxsY2hlY2sod3JpdGVyVGFza3M6IFJlYWRvbmx5PFJlY29yZDxzdHJpbmcsIHJlYWRvbmx5IHN0cmluZ1tdPj4pOiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmdbXT4ge1xuICBjb25zdCBwYXR0ZXJucyA9IE9iamVjdC5rZXlzKHdyaXRlclRhc2tzKTtcbiAgY29uc3QgcGF0dGVybldpdGhTbGFzaCA9IHBhdHRlcm5zLmZpbmQoKHBhdHRlcm4pID0+IHBhdHRlcm4uaW5jbHVkZXMoJy8nKSk7XG4gIGlmIChwYXR0ZXJuV2l0aFNsYXNoICE9PSB1bmRlZmluZWQpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoYG5hbm8tc3RhZ2VkIHdyaXRlciBwYXR0ZXJuICcke3BhdHRlcm5XaXRoU2xhc2h9JyBjb250YWlucyAnLycsIHdoaWNoIHRoZSBzcGVsbGNoZWNrIHBhcnRpdGlvbiBjYW5ub3QgZXhwcmVzcy5gKTtcbiAgfVxuXG4gIGNvbnN0IGNvbXBsZW1lbnRQYXR0ZXJuID0gYCEoJHtwYXR0ZXJucy5tYXAoKHBhdHRlcm4pID0+IGAke3BhdHRlcm59ISg/KWApLmpvaW4oJ3wnKX0pKmA7XG4gIGNvbnN0IGNvbmZpZzogUmVjb3JkPHN0cmluZywgc3RyaW5nW10+ID0ge1xuICAgIFtjb21wbGVtZW50UGF0dGVybl06IFtTUEVMTENIRUNLX0NPTU1BTkRdXG4gIH07XG5cbiAgZm9yIChjb25zdCBbcGF0dGVybiwgY29tbWFuZHNdIG9mIE9iamVjdC5lbnRyaWVzKHdyaXRlclRhc2tzKSkge1xuICAgIGNvbmZpZ1twYXR0ZXJuXSA9IFsuLi5jb21tYW5kcywgU1BFTExDSEVDS19DT01NQU5EXTtcbiAgfVxuXG4gIHJldHVybiBjb25maWc7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBTUEsMEJBQW9CO0FBRXBCLHdCQUdPO0FBQ1AsNkJBQTRDO0FBcUI1QyxNQUFNLGtDQUE4QixvREFBNEIsRUFBRSxLQUFLLEdBQUc7QUFFMUUsTUFBTSxxQkFBcUIsR0FBRywyQkFBMkI7QUFnQnpELE1BQU0sZUFBNEQ7QUFBQSxFQUNoRSxrQkFBa0I7QUFBQSxJQUNoQixHQUFHLDJCQUEyQjtBQUFBLElBQzlCLEdBQUcsMkJBQTJCO0FBQUEsRUFDaEM7QUFBQSxFQUNBLFFBQVE7QUFBQSxJQUNOLEdBQUcsMkJBQTJCO0FBQUEsRUFDaEM7QUFDRjtBQWdCTyxNQUFNLHlCQUFtRCxvQkFBb0IsWUFBWTtBQUVoRyxNQUFNLDJCQUEyQjtBQXNCMUIsU0FBUyxvQkFBb0IsU0FBZ0U7QUFDbEcsNkNBQW9CO0FBRXBCLFVBQUksb0NBQWlCLHdCQUF3QixHQUFHO0FBQzlDLHdCQUFBQSxRQUFRLE9BQU8sTUFBTSx5QkFBeUIsd0JBQXdCO0FBQUEsQ0FBYTtBQUNuRix3QkFBQUEsUUFBUSxLQUFLLENBQUM7QUFBQSxFQUNoQjtBQUVBLFFBQU0sd0JBQXdCLFNBQVMseUJBQXlCLENBQUM7QUFDakUsTUFBSSxPQUFPLEtBQUsscUJBQXFCLEVBQUUsV0FBVyxHQUFHO0FBQ25ELFdBQU87QUFBQSxFQUNUO0FBRUEsUUFBTSxtQkFBbUIsT0FBTyxLQUFLLHFCQUFxQixFQUFFLEtBQUssQ0FBQyxZQUFZLE9BQU8sT0FBTyxjQUFjLE9BQU8sQ0FBQztBQUNsSCxNQUFJLHFCQUFxQixRQUFXO0FBQ2xDLFVBQU0sSUFBSSxNQUFNLCtCQUErQixnQkFBZ0IsdUNBQXVDO0FBQUEsRUFDeEc7QUFFQSxTQUFPLG9CQUFvQixFQUFFLEdBQUcsY0FBYyxHQUFHLHNCQUFzQixDQUFDO0FBQzFFO0FBd0JBLFNBQVMsb0JBQW9CLGFBQW9GO0FBQy9HLFFBQU0sV0FBVyxPQUFPLEtBQUssV0FBVztBQUN4QyxRQUFNLG1CQUFtQixTQUFTLEtBQUssQ0FBQyxZQUFZLFFBQVEsU0FBUyxHQUFHLENBQUM7QUFDekUsTUFBSSxxQkFBcUIsUUFBVztBQUNsQyxVQUFNLElBQUksTUFBTSwrQkFBK0IsZ0JBQWdCLGdFQUFnRTtBQUFBLEVBQ2pJO0FBRUEsUUFBTSxvQkFBb0IsS0FBSyxTQUFTLElBQUksQ0FBQyxZQUFZLEdBQUcsT0FBTyxNQUFNLEVBQUUsS0FBSyxHQUFHLENBQUM7QUFDcEYsUUFBTSxTQUFtQztBQUFBLElBQ3ZDLENBQUMsaUJBQWlCLEdBQUcsQ0FBQyxrQkFBa0I7QUFBQSxFQUMxQztBQUVBLGFBQVcsQ0FBQyxTQUFTLFFBQVEsS0FBSyxPQUFPLFFBQVEsV0FBVyxHQUFHO0FBQzdELFdBQU8sT0FBTyxJQUFJLENBQUMsR0FBRyxVQUFVLGtCQUFrQjtBQUFBLEVBQ3BEO0FBRUEsU0FBTztBQUNUOyIsCiAgIm5hbWVzIjogWyJwcm9jZXNzIl0KfQo=

package/dist/lib/cjs/nano-staged-config.d.cts

@@ -0,0 +1,54 @@
+/// <reference path="./index.d.cts" />
+/**
+ * @file
+ *
+ * Shared nano-staged configuration for pre-commit hooks.
+ */
+/**
+ * Options for {@link getNanoStagedConfig}.
+ */
+export interface GetNanoStagedConfigOptions {
+    /**
+     * Repo-specific file-rewriting tasks, keyed by the nano-staged pattern that claims their files.
+     *
+     * Each gets spellcheck appended and its files removed from the spellcheck-only key, exactly like the shared
+     * writers. A pattern must not contain `/`, and must not repeat a shared writer pattern.
+     */
+    readonly additionalWriterTasks?: Readonly<Record<string, readonly string[]>>;
+}
+/**
+ * Nano-staged configuration that runs file-based lint, format, and spellcheck on staged files.
+ *
+ * Only includes tools that can operate on individual files. Whole-project checks
+ * (TypeScript compilation, unit tests) are left to CI.
+ *
+ * Commands run through the package manager that owns the tree — `npm run ... --`, `bun run ... --`, and
+ * so on — so nano-staged file paths are forwarded as CLI arguments.
+ *
+ * Spellcheck is partitioned across the keys rather than given a catch-all `'*'` key (see
+ * `partitionSpellcheck`). A repo adding a file-rewriting task of its own passes it to
+ * {@link getNanoStagedConfig} as `additionalWriterTasks` rather than spreading this object and adding a key,
+ * which would reintroduce the overlap for that key's files.
+ */
+export declare const obsidianDevUtilsConfig: Record<string, string[]>;
+/**
+ * Resolves the nano-staged configuration to use, honoring a per-developer opt-out.
+ *
+ * Loads a gitignored `.env` if present, then — when `NANO_STAGED` is set to an off value (`0`, `false`,
+ * `off`, or `no`) — prints a notice and exits the process successfully so the pre-commit checks are
+ * skipped. This mirrors husky's own `HUSKY=0` switch, but scoped to the nano-staged step (so the
+ * commit-msg hook still runs). Otherwise it returns {@link obsidianDevUtilsConfig}, or — when
+ * `additionalWriterTasks` are given — the same configuration re-partitioned with those writers added.
+ *
+ * `NANO_STAGED` is not an npm script, so it carries its own switch rather than the script-name-derived one
+ * every npm script gets — but both share the same notion of an off value, via {@link isEnvVariableOff}.
+ *
+ * This is a function rather than module-level code so importing the package barrel never triggers the
+ * `.env` read or the process exit; call it from the thin `scripts/nano-staged-config.ts` entry. Resolving the
+ * package manager is the one thing that does run at module scope, and it does neither of those two
+ * things — it only probes for a lockfile.
+ *
+ * @param options - The optional options.
+ * @returns The nano-staged task configuration. Does not return when the opt-out is active.
+ */
+export declare function getNanoStagedConfig(options?: GetNanoStagedConfigOptions): Record<string, string[]>;

package/dist/lib/cjs/npm-publish.cjs

@@ -0,0 +1,93 @@
+/*
+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();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"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 npm_publish_exports = {};
+__export(npm_publish_exports, {
+  publish: () => publish
+});
+module.exports = __toCommonJS(npm_publish_exports);
+var import_root = require('./root.cjs');
+async function publish(isBeta) {
+  const tag = isBeta ? "beta" : "latest";
+  await (0, import_root.execFromRoot)(["npm", "publish", "--tag", tag]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  publish
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25wbS1wdWJsaXNoLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIE5QTSBwdWJsaXNoLlxuICovXG5cbmltcG9ydCB7IGV4ZWNGcm9tUm9vdCB9IGZyb20gJy4vcm9vdC50cyc7XG5cbi8qKlxuICogUHVibGlzaCB0byBOUE0uXG4gKlxuICogQXV0aGVudGljYXRpb24gaXMgaW50ZW50aW9uYWxseSBub3QgaGFuZGxlZCBoZXJlLiBUaGUgcHVibGlzaCBpcyBleHBlY3RlZCB0byBydW4gZnJvbSBhIENJIGpvYlxuICogY29uZmlndXJlZCBhcyBhIHtAbGluayBodHRwczovL2RvY3MubnBtanMuY29tL3RydXN0ZWQtcHVibGlzaGVycyB8IHRydXN0ZWQgcHVibGlzaGVyfSBvbiBucG1qcy5jb20sXG4gKiB3aGVyZSB0aGUgbnBtIENMSSBleGNoYW5nZXMgdGhlIGpvYidzIHNob3J0LWxpdmVkIE9JREMgdG9rZW4gZm9yIGEgcHVibGlzaCBncmFudCBvbiBpdHMgb3duLiBObyBOUE1cbiAqIHRva2VuIGlzIHJlYWQsIHdyaXR0ZW4sIG9yIHN0b3JlZCwgYW5kIHRoZSBwdWJsaXNoZWQgcGFja2FnZSBnZXRzIHByb3ZlbmFuY2UgZm9yIGZyZWUuXG4gKlxuICogUmVxdWlyZXMgbnBtIGAxMS41LjFgIG9yIGxhdGVyLlxuICpcbiAqIEBwYXJhbSBpc0JldGEgLSBXaGV0aGVyIHRvIHB1Ymxpc2ggdG8gdGhlIGJldGEgTlBNIHJlZ2lzdHJ5LlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcHVibGlzaChpc0JldGE/OiBib29sZWFuKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHRhZyA9IGlzQmV0YSA/ICdiZXRhJyA6ICdsYXRlc3QnO1xuICBhd2FpdCBleGVjRnJvbVJvb3QoWyducG0nLCAncHVibGlzaCcsICctLXRhZycsIHRhZ10pO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQU1BLGtCQUE2QjtBQWM3QixlQUFzQixRQUFRLFFBQWlDO0FBQzdELFFBQU0sTUFBTSxTQUFTLFNBQVM7QUFDOUIsWUFBTSwwQkFBYSxDQUFDLE9BQU8sV0FBVyxTQUFTLEdBQUcsQ0FBQztBQUNyRDsiLAogICJuYW1lcyI6IFtdCn0K