typedoc 0.27.7 → 0.28.0-beta.0

package/dist/lib/{utils → utils-common}/minimalSourceFile.js

@@ -4,10 +4,10 @@ import { binaryFindPartition } from "./array.js";
 // errors downstream.
 const lineStarts = new WeakMap();
 export class MinimalSourceFile {
-    fileName;
     text;
+    // This type is just string to ensure assignability from SourceFile
+    fileName;
     constructor(text, fileName) {
-        this.fileName = fileName;
         // This is unfortunate, but the yaml library we use relies on the source
         // text using LF line endings https://github.com/eemeli/yaml/issues/127.
         // If we don't do this, in a simple document which includes a single key
@@ -18,6 +18,7 @@ export class MinimalSourceFile {
         // we'll end up with a parsed title of "Windows line endings\r"
         this.text = text.replaceAll("\r\n", "\n");
         lineStarts.set(this, [0]);
+        this.fileName = fileName;
     }
     getLineAndCharacterOfPosition(pos) {
         if (pos < 0 || pos >= this.text.length) {

package/dist/lib/utils-common/minimalSourceFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimalSourceFile.js","sourceRoot":"","sources":["../../../src/lib/utils-common/minimalSourceFile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,8EAA8E;AAC9E,mFAAmF;AACnF,qBAAqB;AACrB,MAAM,UAAU,GAAG,IAAI,OAAO,EAA+B,CAAC;AAS9D,MAAM,OAAO,iBAAiB;IACjB,IAAI,CAAS;IACtB,mEAAmE;IAC1D,QAAQ,CAAS;IAE1B,YACI,IAAY,EACZ,QAAwB;QAExB,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,QAAQ;QACR,cAAc;QACd,sCAAsC;QACtC,cAAc;QACd,+DAA+D;QAC/D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,6BAA6B,CAAC,GAAW;QACrC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACrC,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAC/B,IAAI,EACJ,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAC5B,CAAC;YAEF,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7D,OAAO;YACH,SAAS,EAAE,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;YAC7B,IAAI;SACP,CAAC;IACN,CAAC;CACJ"}

package/dist/lib/utils-common/path.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Represents a normalized path with path separators being `/`
+ * On Windows, drives are represented like `C:/Users` for consistency
+ * with TypeScript.
+ *
+ * The empty string `""` is a valid normalized path.
+ */
+export type NormalizedPath = "" | "/" | string & {
+    readonly __normPath: unique symbol;
+};
+/**
+ * Represents either a {@link NormalizedPath} or a Node module name
+ * (e.g. `typedoc-plugin-mdn-links` or `@gerrit0/typedoc-plugin`)
+ */
+export type NormalizedPathOrModule = NormalizedPath | string & {
+    readonly __normPathOrModule: unique symbol;
+};
+/**
+ * Represents a glob path configured by a user.
+ */
+export type GlobString = string & {
+    readonly __globString: unique symbol;
+};
+export declare namespace NormalizedPathUtils {
+    function dirname(path: NormalizedPath): NormalizedPath;
+    function basename(path: NormalizedPath): NormalizedPath;
+    function relative(from: NormalizedPath, to: NormalizedPath): NormalizedPath;
+    function normalize(path: NormalizedPath): NormalizedPath;
+    function resolve(from: NormalizedPath, to: NormalizedPath): NormalizedPath;
+    function isAbsolute(from: NormalizedPath): boolean;
+    function splitFilename(name: string): {
+        name: string;
+        ext: string;
+    };
+}

package/dist/lib/utils-common/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/lib/utils-common/path.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,kBAAkB,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAE9G;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAE3E,yBAAiB,mBAAmB,CAAC;IACjC,SAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAe5D;IAED,SAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAiB7D;IAED,SAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,cAAc,CA2CjF;IAED,SAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAwB9D;IAED,SAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,cAAc,CAQhF;IAED,SAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAExD;IAED,SAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAMzE;CACJ"}

package/dist/lib/utils-common/path.js

@@ -0,0 +1,123 @@
+import { assert } from "./general.js";
+export var NormalizedPathUtils;
+(function (NormalizedPathUtils) {
+    function dirname(path) {
+        let end = path.length - 2;
+        for (; end > 0; --end) {
+            if (path[end] === "/")
+                break;
+        }
+        switch (end) {
+            case -2:
+            case -1:
+                return (path[0] === "/" ? "/" : ".");
+            case 0:
+                return path.substring(0, path.indexOf("/") + 1);
+            default:
+                return path.slice(0, end);
+        }
+    }
+    NormalizedPathUtils.dirname = dirname;
+    function basename(path) {
+        // We start at length - 2 as /var/typedoc/ should give `typedoc`
+        let end = path.length - 2;
+        for (; end >= 0; --end) {
+            if (path[end] === "/")
+                break;
+        }
+        switch (end) {
+            case -2:
+            case -1:
+                return path;
+            default:
+                if (path.endsWith("/")) {
+                    return path.slice(end + 1, -1);
+                }
+                return path.slice(end + 1);
+        }
+    }
+    NormalizedPathUtils.basename = basename;
+    function relative(from, to) {
+        if (from == to) {
+            return "";
+        }
+        assert(isAbsolute(from) && isAbsolute(to), "resolving relative paths without absolute inputs requires a filesystem");
+        if (!from.endsWith("/")) {
+            from += "/";
+        }
+        const end = to.length;
+        if (!to.endsWith("/")) {
+            to += "/";
+        }
+        const minLen = Math.min(from.length, to.length);
+        let lastCommonSlash = 0;
+        let i = 0;
+        for (; i < minLen; ++i) {
+            if (from[i] === to[i]) {
+                if (from[i] === "/") {
+                    lastCommonSlash = i;
+                }
+            }
+            else {
+                break;
+            }
+        }
+        if (lastCommonSlash === from.length - 1) {
+            return to.substring(from.length, end);
+        }
+        let prefix = "";
+        for (let i = lastCommonSlash + 1; i < from.length; ++i) {
+            if (from[i] === "/" || i + 1 === from.length) {
+                prefix += prefix ? "/.." : "..";
+            }
+        }
+        return prefix + to.substring(lastCommonSlash, end);
+    }
+    NormalizedPathUtils.relative = relative;
+    function normalize(path) {
+        const parts = path.split("/");
+        let canRemoveDotDot = false;
+        for (let i = 0; i < parts.length; /* inside loop */) {
+            if (parts[i] == "..") {
+                if (canRemoveDotDot) {
+                    if (i - 1 === 0 && /\w:/i.test(parts[0])) {
+                        parts.splice(i, 1);
+                    }
+                    else {
+                        parts.splice(i - 1, 2);
+                        i = i - 1;
+                    }
+                }
+                else {
+                    ++i;
+                }
+            }
+            else {
+                canRemoveDotDot = true;
+                ++i;
+            }
+        }
+        return parts.join("/");
+    }
+    NormalizedPathUtils.normalize = normalize;
+    function resolve(from, to) {
+        assert(isAbsolute(from), "resolving without an absolute path requires a filesystem");
+        if (isAbsolute(to)) {
+            return to;
+        }
+        return normalize(`${from}/${to}`);
+    }
+    NormalizedPathUtils.resolve = resolve;
+    function isAbsolute(from) {
+        return /^\/|^\w:\//.test(from);
+    }
+    NormalizedPathUtils.isAbsolute = isAbsolute;
+    function splitFilename(name) {
+        const lastDot = name.lastIndexOf(".");
+        if (lastDot < 1) {
+            return { name, ext: "" };
+        }
+        return { name: name.substring(0, lastDot), ext: name.substring(lastDot) };
+    }
+    NormalizedPathUtils.splitFilename = splitFilename;
+})(NormalizedPathUtils || (NormalizedPathUtils = {}));

package/dist/lib/utils-common/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/lib/utils-common/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAsBtC,MAAM,KAAW,mBAAmB,CAiInC;AAjID,WAAiB,mBAAmB;IAChC,SAAgB,OAAO,CAAC,IAAoB;QACxC,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,OAAO,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;gBAAE,MAAM;QACjC,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;YACV,KAAK,CAAC,CAAC,CAAC;YACR,KAAK,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAmB,CAAC;YAC3D,KAAK,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAmB,CAAC;YACtE;gBACI,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAmB,CAAC;QACpD,CAAC;IACL,CAAC;IAfe,2BAAO,UAetB,CAAA;IAED,SAAgB,QAAQ,CAAC,IAAoB;QACzC,gEAAgE;QAChE,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;gBAAE,MAAM;QACjC,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;YACV,KAAK,CAAC,CAAC,CAAC;YACR,KAAK,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC;YAChB;gBACI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAmB,CAAC;gBACrD,CAAC;gBACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAmB,CAAC;QACrD,CAAC;IACL,CAAC;IAjBe,4BAAQ,WAiBvB,CAAA;IAED,SAAgB,QAAQ,CAAC,IAAoB,EAAE,EAAkB;QAC7D,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,CACF,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,EAClC,wEAAwE,CAC3E,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,IAAI,GAAG,CAAC;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,EAAE,IAAI,GAAG,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAClB,eAAe,GAAG,CAAC,CAAC;gBACxB,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,MAAM;YACV,CAAC;QACL,CAAC;QAED,IAAI,eAAe,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAmB,CAAC;QAC5D,CAAC;QAED,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,eAAe,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3C,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACpC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,GAAG,CAAmB,CAAC;IACzE,CAAC;IA3Ce,4BAAQ,WA2CvB,CAAA;IAED,SAAgB,SAAS,CAAC,IAAoB;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAC,iBAAiB,EAChD,CAAC;YACC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBACnB,IAAI,eAAe,EAAE,CAAC;oBAClB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBACvC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvB,CAAC;yBAAM,CAAC;wBACJ,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;wBACvB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACJ,EAAE,CAAC,CAAC;gBACR,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,eAAe,GAAG,IAAI,CAAC;gBACvB,EAAE,CAAC,CAAC;YACR,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAmB,CAAC;IAC7C,CAAC;IAxBe,6BAAS,YAwBxB,CAAA;IAED,SAAgB,OAAO,CAAC,IAAoB,EAAE,EAAkB;QAC5D,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,0DAA0D,CAAC,CAAC;QAErF,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACd,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,IAAI,IAAI,EAAE,EAAoB,CAAC,CAAC;IACxD,CAAC;IARe,2BAAO,UAQtB,CAAA;IAED,SAAgB,UAAU,CAAC,IAAoB;QAC3C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAFe,8BAAU,aAEzB,CAAA;IAED,SAAgB,aAAa,CAAC,IAAY;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9E,CAAC;IANe,iCAAa,gBAM5B,CAAA;AACL,CAAC,EAjIgB,mBAAmB,KAAnB,mBAAmB,QAiInC"}

package/dist/lib/utils-common/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/lib/utils-common/set.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAQpE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAMvE"}

package/dist/lib/utils-common/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/lib/utils-common/set.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAI,CAAc,EAAE,CAAS;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAK,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,CAAc,EAAE,CAAc;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/lib/utils-common/string.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolves a string type into a union of characters, `"ab"` turns into `"a" | "b"`.
+ */
+export type Chars<T extends string> = T extends `${infer C}${infer R}` ? C | Chars<R> : never;
+/** Count the number of times `search` appears in `text` */
+export declare function countMatches(text: string, search: string): number;
+export declare function dedent(text: string): string;
+export declare function editDistance(s: string, t: string): number;
+export declare function getSimilarValues(values: Iterable<string>, compareTo: string): string[];
+export declare function escapeRegExp(s: string): string;
+export declare function escapeHtml(html: string): string;

package/dist/lib/utils-common/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/lib/utils-common/string.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GACjF,KAAK,CAAC;AAEV,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAcxD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,UAelC;AAID,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA4BzD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,YAc3E;AAGD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,UAErC;AASD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,UAEtC"}

package/dist/lib/utils-common/string.js

@@ -0,0 +1,84 @@
+import { DefaultMap } from "./map.js";
+/** Count the number of times `search` appears in `text` */
+export function countMatches(text, search) {
+    let count = 0;
+    let last = 0;
+    for (;;) {
+        const index = text.indexOf(search, last);
+        if (index === -1) {
+            break;
+        }
+        else {
+            last = index + 1;
+            ++count;
+        }
+    }
+    return count;
+}
+export function dedent(text) {
+    const lines = text.split(/\r?\n/);
+    while (lines.length && lines[0].search(/\S/) === -1) {
+        lines.shift();
+    }
+    while (lines.length && lines[lines.length - 1].search(/\S/) === -1) {
+        lines.pop();
+    }
+    const minIndent = lines.reduce((indent, line) => line.length ? Math.min(indent, line.search(/\S/)) : indent, Infinity);
+    return lines.map((line) => line.substring(minIndent)).join("\n");
+}
+// Based on https://en.wikipedia.org/wiki/Levenshtein_distance#Iterative_with_two_matrix_rows
+// Slightly modified for improved match results for options
+export function editDistance(s, t) {
+    if (s.length < t.length)
+        return editDistance(t, s);
+    let v0 = Array.from({ length: t.length + 1 }, (_, i) => i);
+    let v1 = Array.from({ length: t.length + 1 }, () => 0);
+    for (let i = 0; i < s.length; i++) {
+        v1[0] = i + 1;
+        for (let j = 0; j < s.length; j++) {
+            const deletionCost = v0[j + 1] + 1;
+            const insertionCost = v1[j] + 1;
+            let substitutionCost;
+            if (s[i] === t[j]) {
+                substitutionCost = v0[j];
+            }
+            else if (s[i]?.toUpperCase() === t[j]?.toUpperCase()) {
+                substitutionCost = v0[j] + 1;
+            }
+            else {
+                substitutionCost = v0[j] + 3;
+            }
+            v1[j + 1] = Math.min(deletionCost, insertionCost, substitutionCost);
+        }
+        [v0, v1] = [v1, v0];
+    }
+    return v0[t.length];
+}
+export function getSimilarValues(values, compareTo) {
+    const results = new DefaultMap(() => []);
+    let lowest = Infinity;
+    for (const name of values) {
+        const distance = editDistance(compareTo, name);
+        lowest = Math.min(lowest, distance);
+        results.get(distance).push(name);
+    }
+    // Experimenting a bit, it seems an edit distance of 3 is roughly the
+    // right metric for relevant "similar" results without showing obviously wrong suggestions
+    return results
+        .get(lowest)
+        .concat(results.get(lowest + 1), results.get(lowest + 2));
+}
+// From MDN
+export function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string
+}
+const htmlEscapes = {
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+};
+export function escapeHtml(html) {
+    return html.replace(/[&<>'"]/g, (c) => htmlEscapes[c]);
+}

package/dist/lib/utils-common/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../src/lib/utils-common/string.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils-common/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/lib/utils-common/validation.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils-common/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/lib/utils-common/validation.ts"],"names":[],"mappings":"AA4BA,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;AAErB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,EAAE,CAAC;AA8B7C,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,GAAQ;IAC7C,IAAI,IAAI,GAAQ,MAAM,CAAC;IACvB,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;QAChB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,GAAI,MAA2B,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAClB,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC;IACnC,CAAC;IAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAClB,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC;IACnC,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,OAAO,GAAG,KAAK,SAAS,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO,CACH,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;gBAClB,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAC/C,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,IACI,oBAAoB,IAAI,MAAM;QAC9B,CAAE,MAAc,CAAC,oBAAoB,CAAC,EACxC,CAAC;QACC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,CACH,CAAC,CAAC,GAAG;QACL,OAAO,GAAG,KAAK,QAAQ;QACvB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QACnB,MAAM,CAAC,OAAO,CAAS,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAChF,CAAC;AACN,CAAC;AAED,MAAM,UAAU,QAAQ,CAAmB,CAAI;IAC3C,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAU;IAClC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/lib/validation/documentation.d.ts

@@ -1,3 +1,3 @@
 import { type ProjectReflection, ReflectionKind } from "../models/index.js";
-import type { Logger } from "../utils/index.js";
-export declare function validateDocumentation(project: ProjectReflection, logger: Logger, requiredToBeDocumented: readonly ReflectionKind.KindString[]): void;
+import { type Logger } from "#utils";
+export declare function validateDocumentation(project: ProjectReflection, logger: Logger, requiredToBeDocumented: readonly ReflectionKind.KindString[], intentionallyNotDocumented: readonly string[], packagesRequiringDocumentation: readonly string[]): void;

package/dist/lib/validation/documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,iBAAiB,EAEtB,cAAc,EAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAQ,KAAK,MAAM,EAAc,MAAM,QAAQ,CAAC;AAEvD,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,sBAAsB,EAAE,SAAS,cAAc,CAAC,UAAU,EAAE,EAC5D,0BAA0B,EAAE,SAAS,MAAM,EAAE,EAC7C,8BAA8B,EAAE,SAAS,MAAM,EAAE,GAClD,IAAI,CA6HN"}

package/dist/lib/validation/documentation.js

@@ -1,7 +1,6 @@
 import { DeclarationReflection, ReflectionKind, ReflectionType, } from "../models/index.js";
-import { removeFlag } from "../utils/enum.js";
-import { nicePath } from "../utils/paths.js";
-export function validateDocumentation(project, logger, requiredToBeDocumented) {
+import { i18n, removeFlag } from "#utils";
+export function validateDocumentation(project, logger, requiredToBeDocumented, intentionallyNotDocumented, packagesRequiringDocumentation) {
     let kinds = requiredToBeDocumented.reduce((prev, cur) => prev | ReflectionKind[cur], 0);
     // Functions, Constructors, and Accessors never have comments directly on them.
     // If they are required to be documented, what's really required is that their
@@ -20,6 +19,7 @@ export function validateDocumentation(project, logger, requiredToBeDocumented) {
     }
     const toProcess = project.getReflectionsByKind(kinds);
     const seen = new Set();
+    const intentionalUsage = new Set();
     outer: while (toProcess.length) {
         const ref = toProcess.shift();
         if (seen.has(ref))
@@ -73,10 +73,19 @@ export function validateDocumentation(project, logger, requiredToBeDocumented) {
             (ref.kindOf(ReflectionKind.SomeSignature) &&
                 ref.parent?.hasComment());
         if (!hasComment && symbolId) {
-            if (symbolId.fileName.includes("node_modules")) {
+            if (!packagesRequiringDocumentation.includes(symbolId.packageName)) {
                 continue;
             }
-            logger.warn(logger.i18n.reflection_0_kind_1_defined_in_2_does_not_have_any_documentation(ref.getFriendlyFullName(), ReflectionKind[ref.kind], nicePath(symbolId.fileName)));
+            const intentionalIndex = intentionallyNotDocumented.indexOf(ref.getFriendlyFullName());
+            if (intentionalIndex !== -1) {
+                intentionalUsage.add(intentionalIndex);
+                continue;
+            }
+            logger.warn(i18n.reflection_0_kind_1_defined_in_2_does_not_have_any_documentation(ref.getFriendlyFullName(), ReflectionKind[ref.kind], `${symbolId.packageName}/${symbolId.packagePath}`));
         }
     }
+    const unusedIntentional = intentionallyNotDocumented.filter((_, i) => !intentionalUsage.has(i));
+    if (unusedIntentional.length) {
+        logger.warn(i18n.invalid_intentionally_not_documented_names_0(unusedIntentional.join("\n\t")));
+    }
 }

package/dist/lib/validation/documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.js","sourceRoot":"","sources":["../../../src/lib/validation/documentation.ts"],"names":[],"mappings":"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"}

package/dist/lib/validation/exports.d.ts

@@ -1,3 +1,3 @@
 import type { ProjectReflection } from "../models/index.js";
-import type { Logger } from "../utils/index.js";
+import { type Logger } from "#utils";
 export declare function validateExports(project: ProjectReflection, logger: Logger, intentionallyNotExported: readonly string[]): void;

package/dist/lib/validation/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/exports.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AA0D3C,wBAAgB,eAAe,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,EACd,wBAAwB,EAAE,SAAS,MAAM,EAAE,QAwC9C"}

package/dist/lib/validation/exports.js

@@ -1,6 +1,6 @@
 import { ok } from "assert";
-import { nicePath } from "../utils/paths.js";
 import { discoverAllReferenceTypes } from "../utils/reflections.js";
+import { i18n } from "#utils";
 function makeIntentionallyExportedHelper(project, intentional, logger) {
     const used = new Set();
     const processed = intentional.map((v) => {
@@ -31,7 +31,7 @@ function makeIntentionallyExportedHelper(project, intentional, logger) {
             }
             for (const [index, [file, name]] of processed.entries()) {
                 if (typeName === name &&
-                    type.symbolId.fileName.endsWith(file)) {
+                    `${type.symbolId.packageName}/${type.symbolId.packagePath}`.endsWith(file)) {
                     used.add(index);
                     return true;
                 }
@@ -55,11 +55,11 @@ export function validateExports(project, logger, intentionallyNotExported) {
             !warned.has(uniqueId) &&
             !project.symbolIdHasBeenRemoved(type.symbolId)) {
             warned.add(uniqueId);
-            logger.warn(logger.i18n.type_0_defined_in_1_is_referenced_by_2_but_not_included_in_docs(type.qualifiedName, nicePath(type.symbolId.fileName), owner.getFriendlyFullName()));
+            logger.warn(i18n.type_0_defined_in_1_is_referenced_by_2_but_not_included_in_docs(type.qualifiedName, `${type.symbolId.packageName}/${type.symbolId.packagePath}`, owner.getFriendlyFullName()));
         }
     }
     const unusedIntentional = intentional.getUnused();
     if (unusedIntentional.length) {
-        logger.warn(logger.i18n.invalid_intentionally_not_exported_symbols_0(unusedIntentional.join("\n\t")));
+        logger.warn(i18n.invalid_intentionally_not_exported_symbols_0(unusedIntentional.join("\n\t")));
     }
 }

package/dist/lib/validation/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/lib/validation/exports.ts"],"names":[],"mappings":"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"}

package/dist/lib/validation/links.d.ts

@@ -1,3 +1,3 @@
+import { type Logger } from "#utils";
 import { type ProjectReflection } from "../models/index.js";
-import type { Logger } from "../utils/index.js";
 export declare function validateLinks(project: ProjectReflection, logger: Logger): void;

package/dist/lib/validation/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAGH,KAAK,iBAAiB,EAIzB,MAAM,oBAAoB,CAAC;AA+B5B,wBAAgB,aAAa,CACzB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,GACf,IAAI,CAQN"}

package/dist/lib/validation/links.js

@@ -1,3 +1,4 @@
+import { i18n } from "#utils";
 import { ReflectionKind, ReflectionSymbolId, } from "../models/index.js";
 const linkTags = ["@link", "@linkcode", "@linkplain"];
 function getBrokenPartLinks(parts) {
@@ -35,10 +36,10 @@ function checkReflection(reflection, logger) {
             // If a link starts with it, and doesn't include a module source indicator "!"
             // then the user probably is trying to link to a package containing "@" with an absolute link.
             if (broken.startsWith("@") && !broken.includes("!")) {
-                logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_readme_for_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
+                logger.warn(i18n.failed_to_resolve_link_to_0_in_readme_for_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
             }
             else {
-                logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_readme_for_1(broken, reflection.getFriendlyFullName()));
+                logger.warn(i18n.failed_to_resolve_link_to_0_in_readme_for_1(broken, reflection.getFriendlyFullName()));
             }
         }
     }
@@ -48,10 +49,10 @@ function checkReflection(reflection, logger) {
             // If a link starts with it, and doesn't include a module source indicator "!"
             // then the user probably is trying to link to a package containing "@" with an absolute link.
             if (broken.startsWith("@") && !broken.includes("!")) {
-                logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_document_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
+                logger.warn(i18n.failed_to_resolve_link_to_0_in_document_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
             }
             else {
-                logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_document_1(broken, reflection.getFriendlyFullName()));
+                logger.warn(i18n.failed_to_resolve_link_to_0_in_document_1(broken, reflection.getFriendlyFullName()));
             }
         }
     }
@@ -60,10 +61,10 @@ function checkReflection(reflection, logger) {
         // If a link starts with it, and doesn't include a module source indicator "!"
         // then the user probably is trying to link to a package containing "@" with an absolute link.
         if (broken.startsWith("@") && !broken.includes("!")) {
-            logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_comment_for_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
+            logger.warn(i18n.failed_to_resolve_link_to_0_in_comment_for_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
         }
         else {
-            logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_comment_for_1(broken, reflection.getFriendlyFullName()));
+            logger.warn(i18n.failed_to_resolve_link_to_0_in_comment_for_1(broken, reflection.getFriendlyFullName()));
         }
     }
     if (reflection.isDeclaration() &&
@@ -72,10 +73,10 @@ function checkReflection(reflection, logger) {
         reflection.type.elementSummaries) {
         for (const broken of reflection.type.elementSummaries.flatMap(getBrokenPartLinks)) {
             if (broken.startsWith("@") && !broken.includes("!")) {
-                logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_comment_for_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
+                logger.warn(i18n.failed_to_resolve_link_to_0_in_comment_for_1_may_have_meant_2(broken, reflection.getFriendlyFullName(), broken.replace(/[.#~]/, "!")));
             }
             else {
-                logger.warn(logger.i18n.failed_to_resolve_link_to_0_in_comment_for_1(broken, reflection.getFriendlyFullName()));
+                logger.warn(i18n.failed_to_resolve_link_to_0_in_comment_for_1(broken, reflection.getFriendlyFullName()));
             }
         }
     }

package/dist/lib/validation/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/lib/validation/links.ts"],"names":[],"mappings":"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"}

package/dist/lib/validation/unusedMergeModuleWith.d.ts

@@ -1,3 +1,3 @@
+import { type Logger } from "#utils";
 import { type ProjectReflection } from "../models/index.js";
-import type { Logger } from "../utils/index.js";
 export declare function validateMergeModuleWith(project: ProjectReflection, logger: Logger): void;

package/dist/lib/validation/unusedMergeModuleWith.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unusedMergeModuleWith.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/unusedMergeModuleWith.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,oBAAoB,CAAC;AAE5E,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,GACf,IAAI,CAsBN"}

package/dist/lib/validation/unusedMergeModuleWith.js

@@ -1,11 +1,12 @@
+import { i18n } from "#utils";
 import { ReflectionKind } from "../models/index.js";
 export function validateMergeModuleWith(project, logger) {
     for (const refl of project.getReflectionsByKind(ReflectionKind.SomeModule)) {
         if (refl.comment?.getTag("@mergeModuleWith")) {
-            logger.warn(logger.i18n.reflection_0_has_unused_mergeModuleWith_tag(refl.getFriendlyFullName()));
+            logger.warn(i18n.reflection_0_has_unused_mergeModuleWith_tag(refl.getFriendlyFullName()));
         }
     }
     if (project.comment?.getTag("@mergeModuleWith")) {
-        logger.warn(logger.i18n.reflection_0_has_unused_mergeModuleWith_tag("<project>"));
+        logger.warn(i18n.reflection_0_has_unused_mergeModuleWith_tag("<project>"));
     }
 }

package/dist/lib/validation/unusedMergeModuleWith.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unusedMergeModuleWith.js","sourceRoot":"","sources":["../../../src/lib/validation/unusedMergeModuleWith.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAA0B,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,UAAU,uBAAuB,CACnC,OAA0B,EAC1B,MAAc;IAEd,KACI,MAAM,IAAI,IAAI,OAAO,CAAC,oBAAoB,CACtC,cAAc,CAAC,UAAU,CAC5B,EACH,CAAC;QACC,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CACP,IAAI,CAAC,2CAA2C,CAC5C,IAAI,CAAC,mBAAmB,EAAE,CAC7B,CACJ,CAAC;QACN,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CACP,IAAI,CAAC,2CAA2C,CAC5C,WAAW,CACd,CACJ,CAAC;IACN,CAAC;AACL,CAAC"}