@mnaoumov/typescript-dev-toolkit 1.3.0 → 2.0.0

package/dist/lib/esm/docs-site/link-check.d.mts

@@ -0,0 +1,163 @@
+/// <reference path="../library-references.d.mts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * Validation of the links emitted by the built documentation HTML.
+ *
+ * Internal (same-site) links are validated offline: every `href`/`src` must resolve to a real
+ * file in the build output, and every `#fragment` must resolve to a real element id on the
+ * target page.
+ *
+ * External links can only be validated over the network, so those requests are heavily
+ * deduplicated — each unique external URL is fetched at most once regardless of how many of the
+ * thousands of generated pages reference it — and run through a bounded concurrency pool.
+ */
+/**
+ * The {@link BrokenLink.httpStatus} sentinel for a network-level failure (timeout, DNS,
+ * connection refused) where no HTTP response was received.
+ */
+export declare const NETWORK_FAILURE_STATUS = 0;
+/**
+ * A single link that does not resolve.
+ */
+export interface BrokenLink {
+    /**
+     * The HTTP status returned by an external link, when {@link BrokenLink.reason} is
+     * `external-error`. `0` denotes a network-level failure (timeout, DNS, connection refused).
+     */
+    httpStatus?: number;
+    /**
+     * The absolute URL of the page that contains the broken link.
+     */
+    pageUrl: string;
+    /**
+     * Why the link is considered broken.
+     */
+    reason: 'external-error' | 'missing-fragment' | 'missing-page';
+    /**
+     * The resolved absolute URL the link points at.
+     */
+    targetUrl: string;
+}
+/**
+ * A single built documentation page to validate.
+ */
+export interface DocumentationPage {
+    /**
+     * The page's rendered HTML.
+     */
+    html: string;
+    /**
+     * The page's path relative to the build-output root, e.g. `api/foo/index.html`.
+     */
+    relativePath: string;
+}
+/**
+ * Filesystem access the link checker needs, injected so the pure decision logic can be tested
+ * against an in-memory stub instead of a real build output.
+ */
+export interface LinkCheckFileSystem {
+    /**
+     * Reads the element ids present on an already-resolved page.
+     *
+     * @param pageKey - The key returned by {@link LinkCheckFileSystem.resolveExistingPage}.
+     * @returns The set of element ids on that page.
+     */
+    readIds: (pageKey: string) => Set<string>;
+    /**
+     * Resolves an output-relative path to an existing page.
+     *
+     * @param outputRelativePath - The decoded path relative to the build-output root.
+     * @returns A stable key (e.g. the resolved absolute file path) for the existing page, or
+     *   `null` when nothing exists at that path or the path escapes the build-output root.
+     */
+    resolveExistingPage: (outputRelativePath: string) => null | string;
+}
+/**
+ * Validates the deduplicated external URLs over the network through a bounded concurrency pool.
+ *
+ * @param targets - The unique external URL → referencing page map from {@link collectExternalTargets}.
+ * @param fetchUrlStatus - Injected probe returning the HTTP status for a URL (`0` for a network failure).
+ * @param concurrency - The maximum number of in-flight probes.
+ * @returns Every external URL that did not return HTTP `200`, in the map's iteration order.
+ */
+export declare function collectBrokenExternalLinks(targets: Map<string, string>, fetchUrlStatus: (url: string) => Promise<number>, concurrency: number): Promise<BrokenLink[]>;
+/**
+ * Finds every internal link across the built documentation pages that does not resolve.
+ *
+ * External and non-HTTP links are ignored. Each internal link must resolve to an existing page,
+ * and each `#fragment` must resolve to an existing element id on the target page.
+ *
+ * @param pages - The built documentation pages to validate.
+ * @param fileSystem - Injected access to the build output.
+ * @param siteBaseUrl - The absolute base URL the site is served from (with a trailing slash).
+ * @returns Every broken internal link, in page-then-document order.
+ */
+export declare function collectBrokenLinks(pages: DocumentationPage[], fileSystem: LinkCheckFileSystem, siteBaseUrl: string): BrokenLink[];
+/**
+ * Collects every unique external URL referenced across the built pages, deduplicated.
+ *
+ * Only HTTP(S) links that are not {@link isInternalDocUrl} are returned. Each unique URL maps to
+ * the first page that referenced it, so a later failure can be reported with a concrete example
+ * page even though the URL is fetched only once.
+ *
+ * @param pages - The built documentation pages to scan.
+ * @param siteBaseUrl - The absolute base URL the site is served from (with a trailing slash).
+ * @returns A map from each unique external URL to one referencing page URL.
+ */
+export declare function collectExternalTargets(pages: DocumentationPage[], siteBaseUrl: string): Map<string, string>;
+/**
+ * Extracts the values of every `id` attribute in a chunk of HTML.
+ *
+ * @param html - The HTML to scan.
+ * @returns The set of element ids.
+ */
+export declare function extractIds(html: string): Set<string>;
+/**
+ * Extracts the values of every `href`/`src` attribute in a chunk of HTML.
+ *
+ * @param html - The HTML to scan.
+ * @returns The raw link values, in document order (duplicates preserved).
+ */
+export declare function extractLinks(html: string): string[];
+/**
+ * Formats broken links into a human-readable multi-line report.
+ *
+ * @param brokenLinks - The broken links to describe.
+ * @returns One line per broken link.
+ */
+export declare function formatBrokenLinks(brokenLinks: BrokenLink[]): string;
+/**
+ * Computes the build-output-relative path for an internal documentation URL.
+ *
+ * @param targetUrl - The resolved absolute link URL (must be {@link isInternalDocUrl}).
+ * @param siteBaseUrl - The absolute base URL the site is served from (with a trailing slash).
+ * @returns The decoded path relative to the build-output root.
+ */
+export declare function getOutputRelativePath(targetUrl: URL, siteBaseUrl: string): string;
+/**
+ * Computes the absolute URL a built page is served at.
+ *
+ * @param relativePath - The page's path relative to the build-output root.
+ * @param siteBaseUrl - The absolute base URL the site is served from (with a trailing slash).
+ * @returns The page's absolute URL.
+ */
+export declare function getPageUrl(relativePath: string, siteBaseUrl: string): string;
+/**
+ * Determines whether a resolved link points at a page hosted by this documentation site.
+ *
+ * @param targetUrl - The resolved absolute link URL.
+ * @param siteBaseUrl - The absolute base URL the site is served from (with a trailing slash).
+ * @returns `true` when the link is same-origin and under the site base path.
+ */
+export declare function isInternalDocUrl(targetUrl: URL, siteBaseUrl: string): boolean;
+/**
+ * Resolves an output-relative path to an absolute path inside the build-output root, rejecting
+ * paths that escape it via `..` segments.
+ *
+ * @param outputRootPath - The absolute build-output root path.
+ * @param outputRelativePath - The decoded output-relative path.
+ * @returns The joined path when it stays within the root, otherwise `null`.
+ */
+export declare function resolveWithinRoot(outputRootPath: string, outputRelativePath: string): null | string;

package/dist/lib/esm/docs-site/link-check.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 { getMandatoryNamedGroup } from "@mnaoumov/typescript-lib/reg-exp";
+import {
+  assertNever,
+  ensureNonNullable
+} from "@mnaoumov/typescript-lib/type-guards";
+import { normalize } from "node:path/posix";
+const LINK_ATTRIBUTE_REGEX = /\b(?:href|src)=(?<quote>['"])(?<value>.*?)\k<quote>/giu;
+const ID_ATTRIBUTE_REGEX = /\bid=(?<quote>['"])(?<value>.*?)\k<quote>/giu;
+const HTTP_OK_STATUS = 200;
+const NETWORK_FAILURE_STATUS = 0;
+async function collectBrokenExternalLinks(targets, fetchUrlStatus, concurrency) {
+  const entries = [...targets];
+  const results = Array.from({ length: entries.length }, () => null);
+  let nextIndex = 0;
+  async function runWorker() {
+    for (let index = nextIndex++; index < entries.length; index = nextIndex++) {
+      const [externalUrl, pageUrl] = ensureNonNullable(entries[index]);
+      const httpStatus = await fetchUrlStatus(externalUrl);
+      if (httpStatus !== HTTP_OK_STATUS) {
+        results[index] = { httpStatus, pageUrl, reason: "external-error", targetUrl: externalUrl };
+      }
+    }
+  }
+  const workerCount = Math.max(1, Math.min(concurrency, entries.length));
+  await Promise.all(Array.from({ length: workerCount }, () => runWorker()));
+  return results.filter((brokenLink) => brokenLink !== null);
+}
+function collectBrokenLinks(pages, fileSystem, siteBaseUrl) {
+  const brokenLinks = [];
+  for (const page of pages) {
+    const pageUrl = getPageUrl(page.relativePath, siteBaseUrl);
+    for (const rawLink of extractLinks(page.html)) {
+      const targetUrl = new URL(rawLink, pageUrl);
+      if (!isInternalDocUrl(targetUrl, siteBaseUrl)) {
+        continue;
+      }
+      const pageKey = fileSystem.resolveExistingPage(getOutputRelativePath(targetUrl, siteBaseUrl));
+      if (pageKey === null) {
+        brokenLinks.push({ pageUrl, reason: "missing-page", targetUrl: targetUrl.href });
+        continue;
+      }
+      const fragment = targetUrl.hash.slice(1);
+      if (fragment.length > 0 && !fileSystem.readIds(pageKey).has(fragment)) {
+        brokenLinks.push({ pageUrl, reason: "missing-fragment", targetUrl: targetUrl.href });
+      }
+    }
+  }
+  return brokenLinks;
+}
+function collectExternalTargets(pages, siteBaseUrl) {
+  const targets = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const pageUrl = getPageUrl(page.relativePath, siteBaseUrl);
+    for (const rawLink of extractLinks(page.html)) {
+      const targetUrl = new URL(rawLink, pageUrl);
+      if (targetUrl.protocol !== "http:" && targetUrl.protocol !== "https:" || isInternalDocUrl(targetUrl, siteBaseUrl)) {
+        continue;
+      }
+      const externalUrl = `${targetUrl.origin}${targetUrl.pathname}${targetUrl.search}`;
+      if (!targets.has(externalUrl)) {
+        targets.set(externalUrl, pageUrl);
+      }
+    }
+  }
+  return targets;
+}
+function extractIds(html) {
+  return new Set([...html.matchAll(ID_ATTRIBUTE_REGEX)].map((match) => getMandatoryNamedGroup(match, "value")));
+}
+function extractLinks(html) {
+  return [...html.matchAll(LINK_ATTRIBUTE_REGEX)].map((match) => getMandatoryNamedGroup(match, "value"));
+}
+function formatBrokenLinks(brokenLinks) {
+  return brokenLinks.map((brokenLink) => {
+    switch (brokenLink.reason) {
+      case "external-error": {
+        return `${brokenLink.pageUrl} links to external URL ${brokenLink.targetUrl} that returned ${describeHttpStatus(brokenLink.httpStatus)}.`;
+      }
+      case "missing-fragment": {
+        return `${brokenLink.pageUrl} links to missing fragment ${brokenLink.targetUrl}.`;
+      }
+      case "missing-page": {
+        return `${brokenLink.pageUrl} links to missing page ${brokenLink.targetUrl}.`;
+      }
+      default: {
+        return assertNever(brokenLink.reason);
+      }
+    }
+  }).join("\n");
+}
+function getOutputRelativePath(targetUrl, siteBaseUrl) {
+  const base = new URL(siteBaseUrl);
+  return decodeURIComponent(targetUrl.pathname.slice(base.pathname.length));
+}
+function getPageUrl(relativePath, siteBaseUrl) {
+  const normalized = relativePath.replaceAll("\\", "/");
+  const urlPath = normalized === "index.html" ? "" : normalized.replace(/index\.html$/u, "");
+  return new URL(urlPath, siteBaseUrl).href;
+}
+function isInternalDocUrl(targetUrl, siteBaseUrl) {
+  const base = new URL(siteBaseUrl);
+  return targetUrl.origin === base.origin && targetUrl.pathname.startsWith(base.pathname);
+}
+function resolveWithinRoot(outputRootPath, outputRelativePath) {
+  const root = normalize(outputRootPath.replaceAll("\\", "/")).replace(/\/$/u, "");
+  let joined = normalize(`${root}/${outputRelativePath.replaceAll("\\", "/")}`);
+  if (joined.length > 1) {
+    joined = joined.replace(/\/$/u, "");
+  }
+  return joined !== root && !joined.startsWith(`${root}/`) ? null : joined;
+}
+function describeHttpStatus(httpStatus) {
+  return httpStatus === void 0 || httpStatus === NETWORK_FAILURE_STATUS ? "a network failure" : `HTTP ${String(httpStatus)}`;
+}
+export {
+  NETWORK_FAILURE_STATUS,
+  collectBrokenExternalLinks,
+  collectBrokenLinks,
+  collectExternalTargets,
+  extractIds,
+  extractLinks,
+  formatBrokenLinks,
+  getOutputRelativePath,
+  getPageUrl,
+  isInternalDocUrl,
+  resolveWithinRoot
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9kb2NzLXNpdGUvbGluay1jaGVjay50cyJdLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBmaWxlXG4gKlxuICogVmFsaWRhdGlvbiBvZiB0aGUgbGlua3MgZW1pdHRlZCBieSB0aGUgYnVpbHQgZG9jdW1lbnRhdGlvbiBIVE1MLlxuICpcbiAqIEludGVybmFsIChzYW1lLXNpdGUpIGxpbmtzIGFyZSB2YWxpZGF0ZWQgb2ZmbGluZTogZXZlcnkgYGhyZWZgL2BzcmNgIG11c3QgcmVzb2x2ZSB0byBhIHJlYWxcbiAqIGZpbGUgaW4gdGhlIGJ1aWxkIG91dHB1dCwgYW5kIGV2ZXJ5IGAjZnJhZ21lbnRgIG11c3QgcmVzb2x2ZSB0byBhIHJlYWwgZWxlbWVudCBpZCBvbiB0aGVcbiAqIHRhcmdldCBwYWdlLlxuICpcbiAqIEV4dGVybmFsIGxpbmtzIGNhbiBvbmx5IGJlIHZhbGlkYXRlZCBvdmVyIHRoZSBuZXR3b3JrLCBzbyB0aG9zZSByZXF1ZXN0cyBhcmUgaGVhdmlseVxuICogZGVkdXBsaWNhdGVkIOKAlCBlYWNoIHVuaXF1ZSBleHRlcm5hbCBVUkwgaXMgZmV0Y2hlZCBhdCBtb3N0IG9uY2UgcmVnYXJkbGVzcyBvZiBob3cgbWFueSBvZiB0aGVcbiAqIHRob3VzYW5kcyBvZiBnZW5lcmF0ZWQgcGFnZXMgcmVmZXJlbmNlIGl0IOKAlCBhbmQgcnVuIHRocm91Z2ggYSBib3VuZGVkIGNvbmN1cnJlbmN5IHBvb2wuXG4gKi9cblxuaW1wb3J0IHsgZ2V0TWFuZGF0b3J5TmFtZWRHcm91cCB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9yZWctZXhwJztcbmltcG9ydCB7XG4gIGFzc2VydE5ldmVyLFxuICBlbnN1cmVOb25OdWxsYWJsZVxufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuaW1wb3J0IHsgbm9ybWFsaXplIH0gZnJvbSAnbm9kZTpwYXRoL3Bvc2l4JztcblxuY29uc3QgTElOS19BVFRSSUJVVEVfUkVHRVggPSAvXFxiKD86aHJlZnxzcmMpPSg/PHF1b3RlPlsnXCJdKSg/PHZhbHVlPi4qPylcXGs8cXVvdGU+L2dpdTtcbmNvbnN0IElEX0FUVFJJQlVURV9SRUdFWCA9IC9cXGJpZD0oPzxxdW90ZT5bJ1wiXSkoPzx2YWx1ZT4uKj8pXFxrPHF1b3RlPi9naXU7XG5jb25zdCBIVFRQX09LX1NUQVRVUyA9IDIwMDtcblxuLyoqXG4gKiBUaGUge0BsaW5rIEJyb2tlbkxpbmsuaHR0cFN0YXR1c30gc2VudGluZWwgZm9yIGEgbmV0d29yay1sZXZlbCBmYWlsdXJlICh0aW1lb3V0LCBETlMsXG4gKiBjb25uZWN0aW9uIHJlZnVzZWQpIHdoZXJlIG5vIEhUVFAgcmVzcG9uc2Ugd2FzIHJlY2VpdmVkLlxuICovXG5leHBvcnQgY29uc3QgTkVUV09SS19GQUlMVVJFX1NUQVRVUyA9IDA7XG5cbi8qKlxuICogQSBzaW5nbGUgbGluayB0aGF0IGRvZXMgbm90IHJlc29sdmUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQnJva2VuTGluayB7XG4gIC8qKlxuICAgKiBUaGUgSFRUUCBzdGF0dXMgcmV0dXJuZWQgYnkgYW4gZXh0ZXJuYWwgbGluaywgd2hlbiB7QGxpbmsgQnJva2VuTGluay5yZWFzb259IGlzXG4gICAqIGBleHRlcm5hbC1lcnJvcmAuIGAwYCBkZW5vdGVzIGEgbmV0d29yay1sZXZlbCBmYWlsdXJlICh0aW1lb3V0LCBETlMsIGNvbm5lY3Rpb24gcmVmdXNlZCkuXG4gICAqL1xuICBodHRwU3RhdHVzPzogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgYWJzb2x1dGUgVVJMIG9mIHRoZSBwYWdlIHRoYXQgY29udGFpbnMgdGhlIGJyb2tlbiBsaW5rLlxuICAgKi9cbiAgcGFnZVVybDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBXaHkgdGhlIGxpbmsgaXMgY29uc2lkZXJlZCBicm9rZW4uXG4gICAqL1xuICByZWFzb246ICdleHRlcm5hbC1lcnJvcicgfCAnbWlzc2luZy1mcmFnbWVudCcgfCAnbWlzc2luZy1wYWdlJztcblxuICAvKipcbiAgICogVGhlIHJlc29sdmVkIGFic29sdXRlIFVSTCB0aGUgbGluayBwb2ludHMgYXQuXG4gICAqL1xuICB0YXJnZXRVcmw6IHN0cmluZztcbn1cblxuLyoqXG4gKiBBIHNpbmdsZSBidWlsdCBkb2N1bWVudGF0aW9uIHBhZ2UgdG8gdmFsaWRhdGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRG9jdW1lbnRhdGlvblBhZ2Uge1xuICAvKipcbiAgICogVGhlIHBhZ2UncyByZW5kZXJlZCBIVE1MLlxuICAgKi9cbiAgaHRtbDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgcGFnZSdzIHBhdGggcmVsYXRpdmUgdG8gdGhlIGJ1aWxkLW91dHB1dCByb290LCBlLmcuIGBhcGkvZm9vL2luZGV4Lmh0bWxgLlxuICAgKi9cbiAgcmVsYXRpdmVQYXRoOiBzdHJpbmc7XG59XG5cbi8qKlxuICogRmlsZXN5c3RlbSBhY2Nlc3MgdGhlIGxpbmsgY2hlY2tlciBuZWVkcywgaW5qZWN0ZWQgc28gdGhlIHB1cmUgZGVjaXNpb24gbG9naWMgY2FuIGJlIHRlc3RlZFxuICogYWdhaW5zdCBhbiBpbi1tZW1vcnkgc3R1YiBpbnN0ZWFkIG9mIGEgcmVhbCBidWlsZCBvdXRwdXQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTGlua0NoZWNrRmlsZVN5c3RlbSB7XG4gIC8qKlxuICAgKiBSZWFkcyB0aGUgZWxlbWVudCBpZHMgcHJlc2VudCBvbiBhbiBhbHJlYWR5LXJlc29sdmVkIHBhZ2UuXG4gICAqXG4gICAqIEBwYXJhbSBwYWdlS2V5IC0gVGhlIGtleSByZXR1cm5lZCBieSB7QGxpbmsgTGlua0NoZWNrRmlsZVN5c3RlbS5yZXNvbHZlRXhpc3RpbmdQYWdlfS5cbiAgICogQHJldHVybnMgVGhlIHNldCBvZiBlbGVtZW50IGlkcyBvbiB0aGF0IHBhZ2UuXG4gICAqL1xuICByZWFkSWRzOiAocGFnZUtleTogc3RyaW5nKSA9PiBTZXQ8c3RyaW5nPjtcblxuICAvKipcbiAgICogUmVzb2x2ZXMgYW4gb3V0cHV0LXJlbGF0aXZlIHBhdGggdG8gYW4gZXhpc3RpbmcgcGFnZS5cbiAgICpcbiAgICogQHBhcmFtIG91dHB1dFJlbGF0aXZlUGF0aCAtIFRoZSBkZWNvZGVkIHBhdGggcmVsYXRpdmUgdG8gdGhlIGJ1aWxkLW91dHB1dCByb290LlxuICAgKiBAcmV0dXJucyBBIHN0YWJsZSBrZXkgKGUuZy4gdGhlIHJlc29sdmVkIGFic29sdXRlIGZpbGUgcGF0aCkgZm9yIHRoZSBleGlzdGluZyBwYWdlLCBvclxuICAgKiAgIGBudWxsYCB3aGVuIG5vdGhpbmcgZXhpc3RzIGF0IHRoYXQgcGF0aCBvciB0aGUgcGF0aCBlc2NhcGVzIHRoZSBidWlsZC1vdXRwdXQgcm9vdC5cbiAgICovXG4gIHJlc29sdmVFeGlzdGluZ1BhZ2U6IChvdXRwdXRSZWxhdGl2ZVBhdGg6IHN0cmluZykgPT4gbnVsbCB8IHN0cmluZztcbn1cblxuLyoqXG4gKiBWYWxpZGF0ZXMgdGhlIGRlZHVwbGljYXRlZCBleHRlcm5hbCBVUkxzIG92ZXIgdGhlIG5ldHdvcmsgdGhyb3VnaCBhIGJvdW5kZWQgY29uY3VycmVuY3kgcG9vbC5cbiAqXG4gKiBAcGFyYW0gdGFyZ2V0cyAtIFRoZSB1bmlxdWUgZXh0ZXJuYWwgVVJMIOKGkiByZWZlcmVuY2luZyBwYWdlIG1hcCBmcm9tIHtAbGluayBjb2xsZWN0RXh0ZXJuYWxUYXJnZXRzfS5cbiAqIEBwYXJhbSBmZXRjaFVybFN0YXR1cyAtIEluamVjdGVkIHByb2JlIHJldHVybmluZyB0aGUgSFRUUCBzdGF0dXMgZm9yIGEgVVJMIChgMGAgZm9yIGEgbmV0d29yayBmYWlsdXJlKS5cbiAqIEBwYXJhbSBjb25jdXJyZW5jeSAtIFRoZSBtYXhpbXVtIG51bWJlciBvZiBpbi1mbGlnaHQgcHJvYmVzLlxuICogQHJldHVybnMgRXZlcnkgZXh0ZXJuYWwgVVJMIHRoYXQgZGlkIG5vdCByZXR1cm4gSFRUUCBgMjAwYCwgaW4gdGhlIG1hcCdzIGl0ZXJhdGlvbiBvcmRlci5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGNvbGxlY3RCcm9rZW5FeHRlcm5hbExpbmtzKFxuICB0YXJnZXRzOiBNYXA8c3RyaW5nLCBzdHJpbmc+LFxuICBmZXRjaFVybFN0YXR1czogKHVybDogc3RyaW5nKSA9PiBQcm9taXNlPG51bWJlcj4sXG4gIGNvbmN1cnJlbmN5OiBudW1iZXJcbik6IFByb21pc2U8QnJva2VuTGlua1tdPiB7XG4gIGNvbnN0IGVudHJpZXMgPSBbLi4udGFyZ2V0c107XG4gIGNvbnN0IHJlc3VsdHM6IChCcm9rZW5MaW5rIHwgbnVsbClbXSA9IEFycmF5LmZyb20oeyBsZW5ndGg6IGVudHJpZXMubGVuZ3RoIH0sICgpID0+IG51bGwpO1xuICBsZXQgbmV4dEluZGV4ID0gMDtcblxuICBhc3luYyBmdW5jdGlvbiBydW5Xb3JrZXIoKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgZm9yIChsZXQgaW5kZXggPSBuZXh0SW5kZXgrKzsgaW5kZXggPCBlbnRyaWVzLmxlbmd0aDsgaW5kZXggPSBuZXh0SW5kZXgrKykge1xuICAgICAgY29uc3QgW2V4dGVybmFsVXJsLCBwYWdlVXJsXSA9IGVuc3VyZU5vbk51bGxhYmxlKGVudHJpZXNbaW5kZXhdKTtcbiAgICAgIGNvbnN0IGh0dHBTdGF0dXMgPSBhd2FpdCBmZXRjaFVybFN0YXR1cyhleHRlcm5hbFVybCk7XG4gICAgICBpZiAoaHR0cFN0YXR1cyAhPT0gSFRUUF9PS19TVEFUVVMpIHtcbiAgICAgICAgcmVzdWx0c1tpbmRleF0gPSB7IGh0dHBTdGF0dXMsIHBhZ2VVcmwsIHJlYXNvbjogJ2V4dGVybmFsLWVycm9yJywgdGFyZ2V0VXJsOiBleHRlcm5hbFVybCB9O1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIGNvbnN0IHdvcmtlckNvdW50ID0gTWF0aC5tYXgoMSwgTWF0aC5taW4oY29uY3VycmVuY3ksIGVudHJpZXMubGVuZ3RoKSk7XG4gIGF3YWl0IFByb21pc2UuYWxsKEFycmF5LmZyb20oeyBsZW5ndGg6IHdvcmtlckNvdW50IH0sICgpID0+IHJ1bldvcmtlcigpKSk7XG5cbiAgLy8gSW5kZXhlZCBhc3NpZ25tZW50IGFib3ZlIGtlZXBzIGZhaWx1cmVzIGluIHRoZSBtYXAncyBpdGVyYXRpb24gb3JkZXI7IGRyb3AgdGhlIHN1Y2Nlc3NmdWwgZ2Fwcy5cbiAgcmV0dXJuIHJlc3VsdHMuZmlsdGVyKChicm9rZW5MaW5rKTogYnJva2VuTGluayBpcyBCcm9rZW5MaW5rID0+IGJyb2tlbkxpbmsgIT09IG51bGwpO1xufVxuXG4vKipcbiAqIEZpbmRzIGV2ZXJ5IGludGVybmFsIGxpbmsgYWNyb3NzIHRoZSBidWlsdCBkb2N1bWVudGF0aW9uIHBhZ2VzIHRoYXQgZG9lcyBub3QgcmVzb2x2ZS5cbiAqXG4gKiBFeHRlcm5hbCBhbmQgbm9uLUhUVFAgbGlua3MgYXJlIGlnbm9yZWQuIEVhY2ggaW50ZXJuYWwgbGluayBtdXN0IHJlc29sdmUgdG8gYW4gZXhpc3RpbmcgcGFnZSxcbiAqIGFuZCBlYWNoIGAjZnJhZ21lbnRgIG11c3QgcmVzb2x2ZSB0byBhbiBleGlzdGluZyBlbGVtZW50IGlkIG9uIHRoZSB0YXJnZXQgcGFnZS5cbiAqXG4gKiBAcGFyYW0gcGFnZXMgLSBUaGUgYnVpbHQgZG9jdW1lbnRhdGlvbiBwYWdlcyB0byB2YWxpZGF0ZS5cbiAqIEBwYXJhbSBmaWxlU3lzdGVtIC0gSW5qZWN0ZWQgYWNjZXNzIHRvIHRoZSBidWlsZCBvdXRwdXQuXG4gKiBAcGFyYW0gc2l0ZUJhc2VVcmwgLSBUaGUgYWJzb2x1dGUgYmFzZSBVUkwgdGhlIHNpdGUgaXMgc2VydmVkIGZyb20gKHdpdGggYSB0cmFpbGluZyBzbGFzaCkuXG4gKiBAcmV0dXJucyBFdmVyeSBicm9rZW4gaW50ZXJuYWwgbGluaywgaW4gcGFnZS10aGVuLWRvY3VtZW50IG9yZGVyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY29sbGVjdEJyb2tlbkxpbmtzKHBhZ2VzOiBEb2N1bWVudGF0aW9uUGFnZVtdLCBmaWxlU3lzdGVtOiBMaW5rQ2hlY2tGaWxlU3lzdGVtLCBzaXRlQmFzZVVybDogc3RyaW5nKTogQnJva2VuTGlua1tdIHtcbiAgY29uc3QgYnJva2VuTGlua3M6IEJyb2tlbkxpbmtbXSA9IFtdO1xuXG4gIGZvciAoY29uc3QgcGFnZSBvZiBwYWdlcykge1xuICAgIGNvbnN0IHBhZ2VVcmwgPSBnZXRQYWdlVXJsKHBhZ2UucmVsYXRpdmVQYXRoLCBzaXRlQmFzZVVybCk7XG4gICAgZm9yIChjb25zdCByYXdMaW5rIG9mIGV4dHJhY3RMaW5rcyhwYWdlLmh0bWwpKSB7XG4gICAgICBjb25zdCB0YXJnZXRVcmwgPSBuZXcgVVJMKHJhd0xpbmssIHBhZ2VVcmwpO1xuICAgICAgaWYgKCFpc0ludGVybmFsRG9jVXJsKHRhcmdldFVybCwgc2l0ZUJhc2VVcmwpKSB7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICBjb25zdCBwYWdlS2V5ID0gZmlsZVN5c3RlbS5yZXNvbHZlRXhpc3RpbmdQYWdlKGdldE91dHB1dFJlbGF0aXZlUGF0aCh0YXJnZXRVcmwsIHNpdGVCYXNlVXJsKSk7XG4gICAgICBpZiAocGFnZUtleSA9PT0gbnVsbCkge1xuICAgICAgICBicm9rZW5MaW5rcy5wdXNoKHsgcGFnZVVybCwgcmVhc29uOiAnbWlzc2luZy1wYWdlJywgdGFyZ2V0VXJsOiB0YXJnZXRVcmwuaHJlZiB9KTtcbiAgICAgICAgY29udGludWU7XG4gICAgICB9XG5cbiAgICAgIGNvbnN0IGZyYWdtZW50ID0gdGFyZ2V0VXJsLmhhc2guc2xpY2UoMSk7XG4gICAgICBpZiAoZnJhZ21lbnQubGVuZ3RoID4gMCAmJiAhZmlsZVN5c3RlbS5yZWFkSWRzKHBhZ2VLZXkpLmhhcyhmcmFnbWVudCkpIHtcbiAgICAgICAgYnJva2VuTGlua3MucHVzaCh7IHBhZ2VVcmwsIHJlYXNvbjogJ21pc3NpbmctZnJhZ21lbnQnLCB0YXJnZXRVcmw6IHRhcmdldFVybC5ocmVmIH0pO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiBicm9rZW5MaW5rcztcbn1cblxuLyoqXG4gKiBDb2xsZWN0cyBldmVyeSB1bmlxdWUgZXh0ZXJuYWwgVVJMIHJlZmVyZW5jZWQgYWNyb3NzIHRoZSBidWlsdCBwYWdlcywgZGVkdXBsaWNhdGVkLlxuICpcbiAqIE9ubHkgSFRUUChTKSBsaW5rcyB0aGF0IGFyZSBub3Qge0BsaW5rIGlzSW50ZXJuYWxEb2NVcmx9IGFyZSByZXR1cm5lZC4gRWFjaCB1bmlxdWUgVVJMIG1hcHMgdG9cbiAqIHRoZSBmaXJzdCBwYWdlIHRoYXQgcmVmZXJlbmNlZCBpdCwgc28gYSBsYXRlciBmYWlsdXJlIGNhbiBiZSByZXBvcnRlZCB3aXRoIGEgY29uY3JldGUgZXhhbXBsZVxuICogcGFnZSBldmVuIHRob3VnaCB0aGUgVVJMIGlzIGZldGNoZWQgb25seSBvbmNlLlxuICpcbiAqIEBwYXJhbSBwYWdlcyAtIFRoZSBidWlsdCBkb2N1bWVudGF0aW9uIHBhZ2VzIHRvIHNjYW4uXG4gKiBAcGFyYW0gc2l0ZUJhc2VVcmwgLSBUaGUgYWJzb2x1dGUgYmFzZSBVUkwgdGhlIHNpdGUgaXMgc2VydmVkIGZyb20gKHdpdGggYSB0cmFpbGluZyBzbGFzaCkuXG4gKiBAcmV0dXJucyBBIG1hcCBmcm9tIGVhY2ggdW5pcXVlIGV4dGVybmFsIFVSTCB0byBvbmUgcmVmZXJlbmNpbmcgcGFnZSBVUkwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjb2xsZWN0RXh0ZXJuYWxUYXJnZXRzKHBhZ2VzOiBEb2N1bWVudGF0aW9uUGFnZVtdLCBzaXRlQmFzZVVybDogc3RyaW5nKTogTWFwPHN0cmluZywgc3RyaW5nPiB7XG4gIGNvbnN0IHRhcmdldHMgPSBuZXcgTWFwPHN0cmluZywgc3RyaW5nPigpO1xuXG4gIGZvciAoY29uc3QgcGFnZSBvZiBwYWdlcykge1xuICAgIGNvbnN0IHBhZ2VVcmwgPSBnZXRQYWdlVXJsKHBhZ2UucmVsYXRpdmVQYXRoLCBzaXRlQmFzZVVybCk7XG4gICAgZm9yIChjb25zdCByYXdMaW5rIG9mIGV4dHJhY3RMaW5rcyhwYWdlLmh0bWwpKSB7XG4gICAgICBjb25zdCB0YXJnZXRVcmwgPSBuZXcgVVJMKHJhd0xpbmssIHBhZ2VVcmwpO1xuICAgICAgaWYgKCh0YXJnZXRVcmwucHJvdG9jb2wgIT09ICdodHRwOicgJiYgdGFyZ2V0VXJsLnByb3RvY29sICE9PSAnaHR0cHM6JykgfHwgaXNJbnRlcm5hbERvY1VybCh0YXJnZXRVcmwsIHNpdGVCYXNlVXJsKSkge1xuICAgICAgICBjb250aW51ZTtcbiAgICAgIH1cblxuICAgICAgY29uc3QgZXh0ZXJuYWxVcmwgPSBgJHt0YXJnZXRVcmwub3JpZ2lufSR7dGFyZ2V0VXJsLnBhdGhuYW1lfSR7dGFyZ2V0VXJsLnNlYXJjaH1gO1xuICAgICAgaWYgKCF0YXJnZXRzLmhhcyhleHRlcm5hbFVybCkpIHtcbiAgICAgICAgdGFyZ2V0cy5zZXQoZXh0ZXJuYWxVcmwsIHBhZ2VVcmwpO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiB0YXJnZXRzO1xufVxuXG4vKipcbiAqIEV4dHJhY3RzIHRoZSB2YWx1ZXMgb2YgZXZlcnkgYGlkYCBhdHRyaWJ1dGUgaW4gYSBjaHVuayBvZiBIVE1MLlxuICpcbiAqIEBwYXJhbSBodG1sIC0gVGhlIEhUTUwgdG8gc2Nhbi5cbiAqIEByZXR1cm5zIFRoZSBzZXQgb2YgZWxlbWVudCBpZHMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBleHRyYWN0SWRzKGh0bWw6IHN0cmluZyk6IFNldDxzdHJpbmc+IHtcbiAgcmV0dXJuIG5ldyBTZXQoWy4uLmh0bWwubWF0Y2hBbGwoSURfQVRUUklCVVRFX1JFR0VYKV0ubWFwKChtYXRjaCkgPT4gZ2V0TWFuZGF0b3J5TmFtZWRHcm91cChtYXRjaCwgJ3ZhbHVlJykpKTtcbn1cblxuLyoqXG4gKiBFeHRyYWN0cyB0aGUgdmFsdWVzIG9mIGV2ZXJ5IGBocmVmYC9gc3JjYCBhdHRyaWJ1dGUgaW4gYSBjaHVuayBvZiBIVE1MLlxuICpcbiAqIEBwYXJhbSBodG1sIC0gVGhlIEhUTUwgdG8gc2Nhbi5cbiAqIEByZXR1cm5zIFRoZSByYXcgbGluayB2YWx1ZXMsIGluIGRvY3VtZW50IG9yZGVyIChkdXBsaWNhdGVzIHByZXNlcnZlZCkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBleHRyYWN0TGlua3MoaHRtbDogc3RyaW5nKTogc3RyaW5nW10ge1xuICByZXR1cm4gWy4uLmh0bWwubWF0Y2hBbGwoTElOS19BVFRSSUJVVEVfUkVHRVgpXS5tYXAoKG1hdGNoKSA9PiBnZXRNYW5kYXRvcnlOYW1lZEdyb3VwKG1hdGNoLCAndmFsdWUnKSk7XG59XG5cbi8qKlxuICogRm9ybWF0cyBicm9rZW4gbGlua3MgaW50byBhIGh1bWFuLXJlYWRhYmxlIG11bHRpLWxpbmUgcmVwb3J0LlxuICpcbiAqIEBwYXJhbSBicm9rZW5MaW5rcyAtIFRoZSBicm9rZW4gbGlua3MgdG8gZGVzY3JpYmUuXG4gKiBAcmV0dXJucyBPbmUgbGluZSBwZXIgYnJva2VuIGxpbmsuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBmb3JtYXRCcm9rZW5MaW5rcyhicm9rZW5MaW5rczogQnJva2VuTGlua1tdKTogc3RyaW5nIHtcbiAgcmV0dXJuIGJyb2tlbkxpbmtzXG4gICAgLm1hcCgoYnJva2VuTGluaykgPT4ge1xuICAgICAgc3dpdGNoIChicm9rZW5MaW5rLnJlYXNvbikge1xuICAgICAgICBjYXNlICdleHRlcm5hbC1lcnJvcic6IHtcbiAgICAgICAgICByZXR1cm4gYCR7YnJva2VuTGluay5wYWdlVXJsfSBsaW5rcyB0byBleHRlcm5hbCBVUkwgJHticm9rZW5MaW5rLnRhcmdldFVybH0gdGhhdCByZXR1cm5lZCAke2Rlc2NyaWJlSHR0cFN0YXR1cyhicm9rZW5MaW5rLmh0dHBTdGF0dXMpfS5gO1xuICAgICAgICB9XG4gICAgICAgIGNhc2UgJ21pc3NpbmctZnJhZ21lbnQnOiB7XG4gICAgICAgICAgcmV0dXJuIGAke2Jyb2tlbkxpbmsucGFnZVVybH0gbGlua3MgdG8gbWlzc2luZyBmcmFnbWVudCAke2Jyb2tlbkxpbmsudGFyZ2V0VXJsfS5gO1xuICAgICAgICB9XG4gICAgICAgIGNhc2UgJ21pc3NpbmctcGFnZSc6IHtcbiAgICAgICAgICByZXR1cm4gYCR7YnJva2VuTGluay5wYWdlVXJsfSBsaW5rcyB0byBtaXNzaW5nIHBhZ2UgJHticm9rZW5MaW5rLnRhcmdldFVybH0uYDtcbiAgICAgICAgfVxuICAgICAgICBkZWZhdWx0OiB7XG4gICAgICAgICAgcmV0dXJuIGFzc2VydE5ldmVyKGJyb2tlbkxpbmsucmVhc29uKTtcbiAgICAgICAgfVxuICAgICAgfVxuICAgIH0pXG4gICAgLmpvaW4oJ1xcbicpO1xufVxuXG4vKipcbiAqIENvbXB1dGVzIHRoZSBidWlsZC1vdXRwdXQtcmVsYXRpdmUgcGF0aCBmb3IgYW4gaW50ZXJuYWwgZG9jdW1lbnRhdGlvbiBVUkwuXG4gKlxuICogQHBhcmFtIHRhcmdldFVybCAtIFRoZSByZXNvbHZlZCBhYnNvbHV0ZSBsaW5rIFVSTCAobXVzdCBiZSB7QGxpbmsgaXNJbnRlcm5hbERvY1VybH0pLlxuICogQHBhcmFtIHNpdGVCYXNlVXJsIC0gVGhlIGFic29sdXRlIGJhc2UgVVJMIHRoZSBzaXRlIGlzIHNlcnZlZCBmcm9tICh3aXRoIGEgdHJhaWxpbmcgc2xhc2gpLlxuICogQHJldHVybnMgVGhlIGRlY29kZWQgcGF0aCByZWxhdGl2ZSB0byB0aGUgYnVpbGQtb3V0cHV0IHJvb3QuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRPdXRwdXRSZWxhdGl2ZVBhdGgodGFyZ2V0VXJsOiBVUkwsIHNpdGVCYXNlVXJsOiBzdHJpbmcpOiBzdHJpbmcge1xuICBjb25zdCBiYXNlID0gbmV3IFVSTChzaXRlQmFzZVVybCk7XG4gIHJldHVybiBkZWNvZGVVUklDb21wb25lbnQodGFyZ2V0VXJsLnBhdGhuYW1lLnNsaWNlKGJhc2UucGF0aG5hbWUubGVuZ3RoKSk7XG59XG5cbi8qKlxuICogQ29tcHV0ZXMgdGhlIGFic29sdXRlIFVSTCBhIGJ1aWx0IHBhZ2UgaXMgc2VydmVkIGF0LlxuICpcbiAqIEBwYXJhbSByZWxhdGl2ZVBhdGggLSBUaGUgcGFnZSdzIHBhdGggcmVsYXRpdmUgdG8gdGhlIGJ1aWxkLW91dHB1dCByb290LlxuICogQHBhcmFtIHNpdGVCYXNlVXJsIC0gVGhlIGFic29sdXRlIGJhc2UgVVJMIHRoZSBzaXRlIGlzIHNlcnZlZCBmcm9tICh3aXRoIGEgdHJhaWxpbmcgc2xhc2gpLlxuICogQHJldHVybnMgVGhlIHBhZ2UncyBhYnNvbHV0ZSBVUkwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRQYWdlVXJsKHJlbGF0aXZlUGF0aDogc3RyaW5nLCBzaXRlQmFzZVVybDogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3Qgbm9ybWFsaXplZCA9IHJlbGF0aXZlUGF0aC5yZXBsYWNlQWxsKCdcXFxcJywgJy8nKTtcbiAgY29uc3QgdXJsUGF0aCA9IG5vcm1hbGl6ZWQgPT09ICdpbmRleC5odG1sJyA/ICcnIDogbm9ybWFsaXplZC5yZXBsYWNlKC9pbmRleFxcLmh0bWwkL3UsICcnKTtcbiAgcmV0dXJuIG5ldyBVUkwodXJsUGF0aCwgc2l0ZUJhc2VVcmwpLmhyZWY7XG59XG5cbi8qKlxuICogRGV0ZXJtaW5lcyB3aGV0aGVyIGEgcmVzb2x2ZWQgbGluayBwb2ludHMgYXQgYSBwYWdlIGhvc3RlZCBieSB0aGlzIGRvY3VtZW50YXRpb24gc2l0ZS5cbiAqXG4gKiBAcGFyYW0gdGFyZ2V0VXJsIC0gVGhlIHJlc29sdmVkIGFic29sdXRlIGxpbmsgVVJMLlxuICogQHBhcmFtIHNpdGVCYXNlVXJsIC0gVGhlIGFic29sdXRlIGJhc2UgVVJMIHRoZSBzaXRlIGlzIHNlcnZlZCBmcm9tICh3aXRoIGEgdHJhaWxpbmcgc2xhc2gpLlxuICogQHJldHVybnMgYHRydWVgIHdoZW4gdGhlIGxpbmsgaXMgc2FtZS1vcmlnaW4gYW5kIHVuZGVyIHRoZSBzaXRlIGJhc2UgcGF0aC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzSW50ZXJuYWxEb2NVcmwodGFyZ2V0VXJsOiBVUkwsIHNpdGVCYXNlVXJsOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgY29uc3QgYmFzZSA9IG5ldyBVUkwoc2l0ZUJhc2VVcmwpO1xuICByZXR1cm4gdGFyZ2V0VXJsLm9yaWdpbiA9PT0gYmFzZS5vcmlnaW4gJiYgdGFyZ2V0VXJsLnBhdGhuYW1lLnN0YXJ0c1dpdGgoYmFzZS5wYXRobmFtZSk7XG59XG5cbi8qKlxuICogUmVzb2x2ZXMgYW4gb3V0cHV0LXJlbGF0aXZlIHBhdGggdG8gYW4gYWJzb2x1dGUgcGF0aCBpbnNpZGUgdGhlIGJ1aWxkLW91dHB1dCByb290LCByZWplY3RpbmdcbiAqIHBhdGhzIHRoYXQgZXNjYXBlIGl0IHZpYSBgLi5gIHNlZ21lbnRzLlxuICpcbiAqIEBwYXJhbSBvdXRwdXRSb290UGF0aCAtIFRoZSBhYnNvbHV0ZSBidWlsZC1vdXRwdXQgcm9vdCBwYXRoLlxuICogQHBhcmFtIG91dHB1dFJlbGF0aXZlUGF0aCAtIFRoZSBkZWNvZGVkIG91dHB1dC1yZWxhdGl2ZSBwYXRoLlxuICogQHJldHVybnMgVGhlIGpvaW5lZCBwYXRoIHdoZW4gaXQgc3RheXMgd2l0aGluIHRoZSByb290LCBvdGhlcndpc2UgYG51bGxgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVzb2x2ZVdpdGhpblJvb3Qob3V0cHV0Um9vdFBhdGg6IHN0cmluZywgb3V0cHV0UmVsYXRpdmVQYXRoOiBzdHJpbmcpOiBudWxsIHwgc3RyaW5nIHtcbiAgY29uc3Qgcm9vdCA9IG5vcm1hbGl6ZShvdXRwdXRSb290UGF0aC5yZXBsYWNlQWxsKCdcXFxcJywgJy8nKSkucmVwbGFjZSgvXFwvJC91LCAnJyk7XG4gIGxldCBqb2luZWQgPSBub3JtYWxpemUoYCR7cm9vdH0vJHtvdXRwdXRSZWxhdGl2ZVBhdGgucmVwbGFjZUFsbCgnXFxcXCcsICcvJyl9YCk7XG4gIGlmIChqb2luZWQubGVuZ3RoID4gMSkge1xuICAgIGpvaW5lZCA9IGpvaW5lZC5yZXBsYWNlKC9cXC8kL3UsICcnKTtcbiAgfVxuXG4gIHJldHVybiBqb2luZWQgIT09IHJvb3QgJiYgIWpvaW5lZC5zdGFydHNXaXRoKGAke3Jvb3R9L2ApID8gbnVsbCA6IGpvaW5lZDtcbn1cblxuZnVuY3Rpb24gZGVzY3JpYmVIdHRwU3RhdHVzKGh0dHBTdGF0dXM6IG51bWJlciB8IHVuZGVmaW5lZCk6IHN0cmluZyB7XG4gIHJldHVybiBodHRwU3RhdHVzID09PSB1bmRlZmluZWQgfHwgaHR0cFN0YXR1cyA9PT0gTkVUV09SS19GQUlMVVJFX1NUQVRVUyA/ICdhIG5ldHdvcmsgZmFpbHVyZScgOiBgSFRUUCAke1N0cmluZyhodHRwU3RhdHVzKX1gO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQWNBLFNBQVMsOEJBQThCO0FBQ3ZDO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyxpQkFBaUI7QUFFMUIsTUFBTSx1QkFBdUI7QUFDN0IsTUFBTSxxQkFBcUI7QUFDM0IsTUFBTSxpQkFBaUI7QUFNaEIsTUFBTSx5QkFBeUI7QUEwRXRDLGVBQXNCLDJCQUNwQixTQUNBLGdCQUNBLGFBQ3VCO0FBQ3ZCLFFBQU0sVUFBVSxDQUFDLEdBQUcsT0FBTztBQUMzQixRQUFNLFVBQWlDLE1BQU0sS0FBSyxFQUFFLFFBQVEsUUFBUSxPQUFPLEdBQUcsTUFBTSxJQUFJO0FBQ3hGLE1BQUksWUFBWTtBQUVoQixpQkFBZSxZQUEyQjtBQUN4QyxhQUFTLFFBQVEsYUFBYSxRQUFRLFFBQVEsUUFBUSxRQUFRLGFBQWE7QUFDekUsWUFBTSxDQUFDLGFBQWEsT0FBTyxJQUFJLGtCQUFrQixRQUFRLEtBQUssQ0FBQztBQUMvRCxZQUFNLGFBQWEsTUFBTSxlQUFlLFdBQVc7QUFDbkQsVUFBSSxlQUFlLGdCQUFnQjtBQUNqQyxnQkFBUSxLQUFLLElBQUksRUFBRSxZQUFZLFNBQVMsUUFBUSxrQkFBa0IsV0FBVyxZQUFZO0FBQUEsTUFDM0Y7QUFBQSxJQUNGO0FBQUEsRUFDRjtBQUVBLFFBQU0sY0FBYyxLQUFLLElBQUksR0FBRyxLQUFLLElBQUksYUFBYSxRQUFRLE1BQU0sQ0FBQztBQUNy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

package/dist/lib/esm/docs-site/og-image-page.d.mts

@@ -0,0 +1,15 @@
+/// <reference path="../library-references.d.mts" />
+/**
+ * @file
+ *
+ * Resolves generated Open Graph image paths from documentation page metadata.
+ */
+/**
+ * Resolves the public Open Graph image slug for a documentation page.
+ *
+ * @param frontmatter - The page's parsed frontmatter.
+ * @param filePath - The page's source-file path.
+ * @param contentDocsDirectory - The documentation content root.
+ * @returns The case-preserved explicit slug, or a slug derived from the file path.
+ */
+export declare function getOgImagePageSlug(frontmatter: Record<string, unknown>, filePath: string, contentDocsDirectory: string): string;

package/dist/lib/esm/docs-site/og-image-page.mjs

@@ -0,0 +1,21 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+import { relative } from "node:path/posix";
+function getOgImagePageSlug(frontmatter, filePath, contentDocsDirectory) {
+  const slug = frontmatter["slug"];
+  if (typeof slug === "string") {
+    return slug;
+  }
+  let filePathSlug = relative(contentDocsDirectory, filePath);
+  filePathSlug = filePathSlug.replaceAll("\\", "/");
+  filePathSlug = filePathSlug.replace(/\.\w+$/, "");
+  filePathSlug = filePathSlug.replace(/(?:^|\/)index$/, "");
+  return filePathSlug || "index";
+}
+export {
+  getOgImagePageSlug
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2RvY3Mtc2l0ZS9vZy1pbWFnZS1wYWdlLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogUmVzb2x2ZXMgZ2VuZXJhdGVkIE9wZW4gR3JhcGggaW1hZ2UgcGF0aHMgZnJvbSBkb2N1bWVudGF0aW9uIHBhZ2UgbWV0YWRhdGEuXG4gKi9cblxuaW1wb3J0IHsgcmVsYXRpdmUgfSBmcm9tICdub2RlOnBhdGgvcG9zaXgnO1xuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBwdWJsaWMgT3BlbiBHcmFwaCBpbWFnZSBzbHVnIGZvciBhIGRvY3VtZW50YXRpb24gcGFnZS5cbiAqXG4gKiBAcGFyYW0gZnJvbnRtYXR0ZXIgLSBUaGUgcGFnZSdzIHBhcnNlZCBmcm9udG1hdHRlci5cbiAqIEBwYXJhbSBmaWxlUGF0aCAtIFRoZSBwYWdlJ3Mgc291cmNlLWZpbGUgcGF0aC5cbiAqIEBwYXJhbSBjb250ZW50RG9jc0RpcmVjdG9yeSAtIFRoZSBkb2N1bWVudGF0aW9uIGNvbnRlbnQgcm9vdC5cbiAqIEByZXR1cm5zIFRoZSBjYXNlLXByZXNlcnZlZCBleHBsaWNpdCBzbHVnLCBvciBhIHNsdWcgZGVyaXZlZCBmcm9tIHRoZSBmaWxlIHBhdGguXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRPZ0ltYWdlUGFnZVNsdWcoZnJvbnRtYXR0ZXI6IFJlY29yZDxzdHJpbmcsIHVua25vd24+LCBmaWxlUGF0aDogc3RyaW5nLCBjb250ZW50RG9jc0RpcmVjdG9yeTogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3Qgc2x1ZyA9IGZyb250bWF0dGVyWydzbHVnJ107XG4gIGlmICh0eXBlb2Ygc2x1ZyA9PT0gJ3N0cmluZycpIHtcbiAgICByZXR1cm4gc2x1ZztcbiAgfVxuXG4gIGxldCBmaWxlUGF0aFNsdWcgPSByZWxhdGl2ZShjb250ZW50RG9jc0RpcmVjdG9yeSwgZmlsZVBhdGgpO1xuICBmaWxlUGF0aFNsdWcgPSBmaWxlUGF0aFNsdWcucmVwbGFjZUFsbCgnXFxcXCcsICcvJyk7XG4gIGZpbGVQYXRoU2x1ZyA9IGZpbGVQYXRoU2x1Zy5yZXBsYWNlKC9cXC5cXHcrJC8sICcnKTtcbiAgZmlsZVBhdGhTbHVnID0gZmlsZVBhdGhTbHVnLnJlcGxhY2UoLyg/Ol58XFwvKWluZGV4JC8sICcnKTtcbiAgcmV0dXJuIGZpbGVQYXRoU2x1ZyB8fCAnaW5kZXgnO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7QUFNQSxTQUFTLGdCQUFnQjtBQVVsQixTQUFTLG1CQUFtQixhQUFzQyxVQUFrQixzQkFBc0M7QUFDL0gsUUFBTSxPQUFPLFlBQVksTUFBTTtBQUMvQixNQUFJLE9BQU8sU0FBUyxVQUFVO0FBQzVCLFdBQU87QUFBQSxFQUNUO0FBRUEsTUFBSSxlQUFlLFNBQVMsc0JBQXNCLFFBQVE7QUFDMUQsaUJBQWUsYUFBYSxXQUFXLE1BQU0sR0FBRztBQUNoRCxpQkFBZSxhQUFhLFFBQVEsVUFBVSxFQUFFO0FBQ2hELGlCQUFlLGFBQWEsUUFBUSxrQkFBa0IsRUFBRTtBQUN4RCxTQUFPLGdCQUFnQjtBQUN6QjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/docs-site/og-image.d.mts

@@ -0,0 +1,70 @@
+/// <reference path="../library-references.d.mts" />
+/// <reference types="node" />
+/**
+ * @file
+ *
+ * Renders a page's Open Graph card: satori lays it out as SVG, resvg rasterizes it to PNG.
+ */
+import type { Font } from 'satori';
+/**
+ * What one Open Graph card shows: a title, and optionally a description, a code signature and a badge.
+ */
+export interface OgCardContent {
+    readonly badge?: string | undefined;
+    readonly description?: string | undefined;
+    readonly signature?: string | undefined;
+    readonly title: string;
+}
+/**
+ * The per-site part of every card: the fonts, the logo and the brand text in the footer.
+ */
+export interface RenderOgImageOptions {
+    /**
+     * The text the footer carries, normally the package's name.
+     */
+    readonly brandText: string;
+    /**
+     * The fonts satori renders the text with.
+     */
+    readonly fonts: Font[];
+    /**
+     * The site logo as a PNG data URI, or `null` to render the card without one.
+     */
+    readonly logoDataUri: null | string;
+}
+/**
+ * Hashes a card's content, so an unchanged card is not rendered again.
+ *
+ * @param params - The card's content.
+ * @returns A 16-character hex digest.
+ */
+export declare function computeOgHash(params: OgCardContent): string;
+/**
+ * Loads the fonts satori needs to render text.
+ *
+ * This package ships `inter-latin-400-normal.ttf` / `inter-latin-700-normal.ttf` under
+ * `assets/docs-site/fonts`; this falls back to any other `.ttf`/`.otf` in `fontsDirectory` and
+ * returns `null` when the directory holds none, so the caller can skip OG generation instead of
+ * crashing the build.
+ *
+ * @param fontsDirectory - The folder holding the fonts.
+ * @returns The fonts, or `null` when the folder holds none.
+ */
+export declare function loadFonts(fontsDirectory: string): Promise<Font[] | null>;
+/**
+ * Rasterize an SVG favicon to a PNG data URI via resvg for embedding in the satori layout (satori's
+ * `<img>` needs a raster/data-URI source). Returns `null` when the file is missing so the caller can
+ * render the card without a logo. Call this ONCE and reuse the result across all cards.
+ *
+ * @param faviconPath - The SVG favicon's path.
+ * @returns The PNG data URI, or `null` when the favicon is missing.
+ */
+export declare function loadLogoDataUri(faviconPath: string): Promise<null | string>;
+/**
+ * Renders a page's card to a PNG.
+ *
+ * @param params - The card's content.
+ * @param options - The fonts, logo and brand text every card shares.
+ * @returns The PNG.
+ */
+export declare function renderOgImage(params: OgCardContent, options: RenderOgImageOptions): Promise<Buffer>;