@dogsbay/format-mdx 0.2.0-beta.12 → 0.2.0-beta.121

package/dist/mintlify-nav.js

@@ -0,0 +1,418 @@
+/**
+ * Mintlify `docs.json` / legacy `mint.json` → NavItem[].
+ *
+ * Mintlify's navigation is polymorphic and recursive. A "navigation node" is an
+ * object that carries one (schema says one; we tolerate several) of these
+ * container arrays, each of which nests another navigation node:
+ *
+ *   languages · versions · tabs · dropdowns · anchors · groups · pages
+ *
+ * plus leaf `pages` entries that are bare path strings, `{ group, pages }`
+ * sub-groups, or `{ page/anchor/..., href }` external links. `versions` and
+ * `languages` wrap any other structure, so a fully-loaded site can be
+ * `versions → languages → tabs → groups → pages`.
+ *
+ * The legacy `mint.json` is flatter: `navigation` is an ARRAY of
+ * `{ group, pages }`, plus top-level `anchors: [{ name, url }]`. Both are
+ * handled here.
+ *
+ * Page labels are NOT in the config — a page is a bare slug, and its
+ * human-readable title lives in the MDX file's frontmatter. We resolve it the
+ * same way the Fumadocs nav builder does (frontmatter `title`, else a humanized
+ * last path segment).
+ */
+import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
+import { basename, dirname, join, sep } from "node:path";
+import YAML from "yaml";
+import { openApiPageKey, openApiRefSlug } from "./mintlify-openapi.js";
+/**
+ * True when `dir` looks like a Mintlify docs source: a `docs.json`/`mint.json`
+ * that actually reads as a Mintlify config, plus md/mdx pages. The config sniff
+ * (a `navigation` key or a `mintlify` `$schema`) keeps an unrelated `docs.json`
+ * — e.g. TypeDoc's output — from being claimed by the mdx importer.
+ */
+export function detectMintlifyDir(dir) {
+    if (!hasMdFiles(dir))
+        return false;
+    const config = readConfig(dir);
+    if (!config)
+        return false;
+    return (config.navigation != null ||
+        Array.isArray(config.anchors) ||
+        (typeof config.$schema === "string" && config.$schema.includes("mintlify")));
+}
+/**
+ * Build NavItem[] from a Mintlify config, or null when no config is present or
+ * it declares no navigation.
+ */
+export function buildMintlifyNav(source, opts = {}) {
+    const config = readConfig(source);
+    if (!config)
+        return null;
+    const ctx = { source, prefix: opts.hrefPrefix ?? "", depth: 0, budget: { spent: 0, warned: false } };
+    const items = [];
+    // `navigation` is an object (docs.json) or an array (legacy mint.json).
+    if (config.navigation != null) {
+        items.push(...navNodeToItems(config.navigation, ctx));
+    }
+    // Legacy top-level anchors sit alongside `navigation`, not inside it.
+    for (const a of objs(config.anchors))
+        items.push(anchorItem(a, ctx));
+    return items.length > 0 ? items : null;
+}
+/** Depth cap for the navigation walk — far above any real config (max seen: 6). */
+const MAX_NAV_DEPTH = 64;
+/**
+ * Total nav nodes one build may visit.
+ *
+ * Depth alone does not bound WORK: a cyclic `$ref` with two children per level
+ * is O(2^depth) — measured 4x per two levels, each node doing a readFileSync —
+ * so a depth cap of 64 still hangs the import forever. The bug this replaced
+ * (an unguarded RangeError) at least TERMINATED. Mintlify's own docs are ~1000
+ * items, so this is ~50x the largest real config.
+ */
+const MAX_NAV_NODES = 50_000;
+function readConfig(source) {
+    for (const name of ["docs.json", "mint.json"]) {
+        const p = join(source, name);
+        if (existsSync(p)) {
+            try {
+                return JSON.parse(readFileSync(p, "utf-8"));
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * A navigation node: an array (legacy nav / a bare pages list) or an object
+ * carrying container arrays. Containers are checked in outer-to-inner order and
+ * concatenated — the schema says one type per level, but concatenating is safe
+ * and tolerant of hand-written configs that mix them.
+ */
+function navNodeToItems(node, ctx) {
+    if (Array.isArray(node))
+        return node.flatMap((e) => entryToItems(e, ctx));
+    if (!node || typeof node !== "object")
+        return [];
+    // Container elements must be objects — a stray null/scalar in an array must
+    // be skipped, not throw (readConfig's contract is "bad config → null nav",
+    // and buildMintlifyNav is called uncaught). `pages` is exempt: entryToItems
+    // already tolerates strings and null.
+    if (++ctx.budget.spent > MAX_NAV_NODES) {
+        if (!ctx.budget.warned) {
+            console.warn(`warning: navigation exceeded ${MAX_NAV_NODES} nodes — the rest was skipped ` +
+                "(a branching $ref cycle looks like this)");
+            ctx.budget.warned = true;
+        }
+        return [];
+    }
+    if (ctx.depth >= MAX_NAV_DEPTH) {
+        console.warn(`warning: navigation nesting exceeded ${MAX_NAV_DEPTH} levels — the rest of ` +
+            "this branch was skipped (a $ref cycle looks like this)");
+        return [];
+    }
+    const inner = { ...ctx, depth: ctx.depth + 1 };
+    const items = [];
+    // `$ref` is resolved at every container level, not just languages: the same
+    // split-file pattern is used for versions and tabs in large configs.
+    for (const l of objs(node.languages))
+        items.push(variantItem(resolveRef(l, inner), "language", inner));
+    for (const v of objs(node.versions))
+        items.push(variantItem(resolveRef(v, inner), "version", inner));
+    for (const p of objs(node.products))
+        items.push(containerItem(resolveRef(p, inner), "product", inner));
+    for (const t of objs(node.tabs))
+        items.push(containerItem(resolveRef(t, inner), "tab", inner));
+    for (const a of objs(node.anchors))
+        items.push(containerItem(resolveRef(a, inner), "anchor", inner));
+    for (const d of objs(node.dropdowns))
+        items.push(containerItem(resolveRef(d, inner), "dropdown", inner));
+    for (const g of objs(node.groups))
+        items.push(...groupItems(resolveRef(g, inner), inner));
+    // `global` holds divisions shown on EVERY page (global anchors/tabs — a
+    // changelog or blog link that persists across sections). Documented in
+    // Mintlify's navigation reference; unhandled it silently dropped those
+    // links. Recursed like any other node, since it just wraps divisions.
+    if (node.global && typeof node.global === "object") {
+        items.push(...navNodeToItems(resolveRef(node.global, inner), inner));
+    }
+    // `menu` holds `{ item, href|groups }` entries — the dropdown under a tab.
+    // Missing it cost Mintlify's own docs their entire "Guides" section: 30 real
+    // pages imported from disk but appeared in no navigation, which is also why
+    // they looked like "pages outside the nav" when auditing coverage.
+    for (const m of objs(node.menu))
+        items.push(menuItem(resolveRef(m, inner), inner));
+    if (Array.isArray(node.pages))
+        items.push(...node.pages.flatMap((p) => entryToItems(p, inner)));
+    return items.filter(Boolean);
+}
+/** Array elements that are non-null objects (skips stray null/scalar entries). */
+function objs(v) {
+    return Array.isArray(v) ? v.filter((e) => e != null && typeof e === "object") : [];
+}
+/**
+ * Resolve a `{ "$ref": "./fr.json" }` node by loading that file.
+ *
+ * Mintlify splits large multi-language configs across files: the `en` entry is
+ * inlined in `docs.json` and the rest are `$ref`s to siblings. Not following
+ * them cost Mintlify's own docs their ENTIRE French, Spanish and Chinese
+ * navigation — three nav entries labelled `language` with no children, while
+ * the fr/es/zh pages imported fine and were simply unreachable.
+ *
+ * Resolved relative to the docs root, like every other Mintlify path. A ref
+ * that cannot be read returns the node untouched, so it degrades to today's
+ * behaviour rather than throwing.
+ *
+ * Two guards, both learned from `mintlify-openapi.ts` closing the same holes:
+ *
+ *  - CONFINEMENT. `docs.json` ships inside the untrusted repo being converted,
+ *    so "the operator chose it" covers which DIRECTORY to convert, not the
+ *    contents of a file in it. `{"$ref":"../../secret.json"}` put an
+ *    out-of-corpus file's contents into the exported navigation as labels and
+ *    hrefs.
+ *  - CYCLES. A self-referential ref recursed until the stack was exhausted,
+ *    producing a nav ~1800 levels deep whose depth varied by machine; it only
+ *    failed to crash because the RangeError happened to land inside the
+ *    try/catch below.
+ */
+function resolveRef(node, ctx) {
+    if (!node || typeof node !== "object" || typeof node.$ref !== "string")
+        return node;
+    const target = join(ctx.source, node.$ref.replace(/^\.\//, "").replace(/^\//, ""));
+    if (!withinSource(target, ctx.source)) {
+        console.warn(`warning: navigation $ref "${node.$ref}" points outside the docs directory — ignored`);
+        return node;
+    }
+    if (!existsSync(target))
+        return node;
+    try {
+        const loaded = JSON.parse(readFileSync(target, "utf-8"));
+        // A ref can point at an ARRAY (redirects.json is a bare list) — spreading
+        // that into an object would turn it into {0:…,1:…}.
+        if (Array.isArray(loaded))
+            return loaded;
+        // Keep any sibling keys the ref node carried (e.g. an explicit `language`).
+        const { $ref: _ref, ...rest } = node;
+        return { ...loaded, ...rest };
+    }
+    catch {
+        return node;
+    }
+}
+/** Is `target` inside the docs root once symlinks are resolved? */
+function withinSource(target, source) {
+    const real = (p) => {
+        try {
+            return realpathSync(p);
+        }
+        catch {
+            const parent = dirname(p);
+            return parent === p ? p : join(real(parent), basename(p));
+        }
+    };
+    const root = real(source);
+    const abs = real(target);
+    return abs === root || abs.startsWith(root + sep);
+}
+/** A single entry inside a `pages` array. */
+function entryToItems(entry, ctx) {
+    if (typeof entry === "string") {
+        // A `METHOD /path` string references an OpenAPI operation generated from the
+        // container's `openapi` spec (ollama's "Endpoints" group) — it is not a
+        // file. Point at the slug the page generator uses (openApiRefSlug) so the
+        // link resolves; treating it as a file slug produced a broken `/POST /x`.
+        const oaKey = openApiPageKey(entry);
+        if (oaKey) {
+            const path = oaKey.slice(oaKey.indexOf(" ") + 1);
+            const slug = openApiRefSlug(path);
+            const last = slug.split("/").pop() || slug;
+            return [{ label: humanize(last), href: `${ctx.prefix}/${slug}` }];
+        }
+        return [pageItem(entry, ctx)];
+    }
+    if (!entry || typeof entry !== "object")
+        return [];
+    // Sub-group: `{ group, pages }`.
+    if (typeof entry.group === "string")
+        return groupItems(entry, ctx);
+    // External or explicit page link: `{ page?, href }`.
+    if (typeof entry.href === "string") {
+        const label = str(entry.page ?? entry.group ?? entry.title) ?? entry.href;
+        return [{ label, href: resolveHref(entry.href, ctx) }];
+    }
+    // A nested navigation node (e.g. a page entry that itself carries groups).
+    const nested = navNodeToItems(entry, ctx);
+    return nested;
+}
+/** `{ group, pages, root?, tag? }` → a group NavItem (empty label = splice up). */
+function groupItems(g, ctx) {
+    const children = navNodeToItems(g, ctx);
+    const label = str(g.group);
+    // A group with an empty/absent name (legacy root group) has no header — its
+    // pages belong at the parent level.
+    if (!label)
+        return children;
+    const item = { label, children };
+    // `root` names a landing page for the group.
+    if (typeof g.root === "string")
+        item.href = pageHref(g.root, ctx);
+    return [item];
+}
+/** tab / dropdown / anchor: labelled by its own key; may be external or nest. */
+function containerItem(node, kind, ctx) {
+    const label = str(node[kind]) ?? str(node.name) ?? kind;
+    const children = navNodeToItems(node, ctx);
+    if (children.length > 0)
+        return { label, children };
+    // Leaf: an external href, or a bare path (legacy anchor `url`).
+    const target = str(node.href) ?? str(node.url);
+    return target ? { label, href: resolveHref(target, ctx) } : { label };
+}
+/** version / language: labelled by its key, tag appended; wraps nested nav. */
+function variantItem(node, kind, ctx) {
+    const base = str(node[kind]) ?? kind;
+    const tag = str(node.tag);
+    const label = tag ? `${base} (${tag})` : base;
+    const children = navNodeToItems(node, ctx);
+    const item = { label };
+    if (children.length > 0)
+        item.children = children;
+    else if (str(node.href))
+        item.href = resolveHref(node.href, ctx);
+    return item;
+}
+/**
+ * Mintlify `redirects` as a source → destination map, `$ref` resolved.
+ *
+ * A docs site accumulates these as pages move, and its OWN pages then link to
+ * the old paths — Mintlify serves the redirect, so the link works and nobody
+ * notices it is stale. On import the redirect does not exist, so those links
+ * 404: measured on Mintlify's own docs, 16 internal links point at a redirect
+ * source, including `/installation` on the front page (→ `/cli/install`).
+ *
+ * `redirects` is itself commonly a `$ref` to a sibling file (121 entries in
+ * `redirects.json` here), so it is resolved the same way as navigation.
+ */
+export function mintlifyRedirects(source) {
+    const config = readConfig(source);
+    if (!config)
+        return {};
+    const ctx = { source, prefix: "", depth: 0, budget: { spent: 0, warned: false } };
+    const raw = config.redirects;
+    const list = Array.isArray(raw)
+        ? raw
+        : (() => {
+            const resolved = resolveRef(raw, ctx);
+            return Array.isArray(resolved)
+                ? resolved
+                : Array.isArray(resolved?.redirects)
+                    ? resolved.redirects
+                    : [];
+        })();
+    const map = {};
+    for (const entry of list) {
+        const from = str(entry?.source);
+        const to = str(entry?.destination);
+        if (from && to)
+            map[from.replace(/\/$/, "")] = to;
+    }
+    return map;
+}
+/** A `menu` entry: `{ item, href? , groups?/pages? }`. */
+function menuItem(node, ctx) {
+    const label = str(node.item) ?? str(node.group) ?? "Menu";
+    const children = navNodeToItems(node, ctx);
+    const item = { label };
+    if (children.length > 0)
+        item.children = children;
+    else if (str(node.href))
+        item.href = resolveHref(node.href, ctx);
+    return item;
+}
+/** Legacy top-level anchor: `{ name, url, icon? }`. */
+function anchorItem(a, ctx) {
+    const label = str(a.name) ?? str(a.anchor) ?? "Anchor";
+    const target = str(a.url) ?? str(a.href);
+    return target ? { label, href: resolveHref(target, ctx) } : { label };
+}
+/** A bare page slug → NavItem, label resolved from frontmatter title. */
+function pageItem(slug, ctx) {
+    return { label: pageLabel(slug, ctx), href: pageHref(slug, ctx) };
+}
+// ── href / label helpers ────────────────────────────────
+function resolveHref(target, ctx) {
+    if (isExternal(target) || target.startsWith("#") || target.startsWith("mailto:"))
+        return target;
+    return pageHref(target, ctx);
+}
+function pageHref(slug, ctx) {
+    const clean = slug.replace(/^\//, "").replace(/\.mdx?$/, "");
+    // An `index` page is routed to its folder root by Astro (root `index.mdx` → `/`,
+    // `foo/index.mdx` → `/foo`), so the nav href must match — linking to `/index`
+    // 404s while the page lives at `/`. Mirrors the Fumadocs nav builder.
+    if (clean === "index")
+        return `${ctx.prefix}/`;
+    return `${ctx.prefix}/${clean.replace(/\/index$/, "")}`;
+}
+function isExternal(s) {
+    return /^https?:\/\//.test(s);
+}
+function pageLabel(slug, ctx) {
+    const clean = slug.replace(/^\//, "").replace(/\.mdx?$/, "");
+    const file = resolvePageFile(ctx.source, clean);
+    if (file) {
+        const title = frontmatterTitle(file);
+        if (title)
+            return title;
+    }
+    const last = clean.split("/").pop() || clean;
+    return humanize(last);
+}
+function resolvePageFile(source, slug) {
+    for (const ext of [".mdx", ".md"]) {
+        const p = join(source, slug + ext);
+        if (existsSync(p))
+            return p;
+        // A folder index: `slug/index.mdx`.
+        const idx = join(source, slug, "index" + ext);
+        if (existsSync(idx))
+            return idx;
+    }
+    return null;
+}
+function frontmatterTitle(file) {
+    try {
+        const src = readFileSync(file, "utf-8");
+        const m = /^---\n([\s\S]*?)\n---/.exec(src);
+        if (m) {
+            const fm = YAML.parse(m[1]);
+            if (fm && typeof fm.title === "string")
+                return fm.title;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return undefined;
+}
+function humanize(name) {
+    return name.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function str(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const t = v.trim();
+    return t.length > 0 ? t : undefined;
+}
+function hasMdFiles(dir) {
+    try {
+        return readdirSync(dir).some((e) => (e.endsWith(".md") || e.endsWith(".mdx")) && e !== "llms.txt");
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=mintlify-nav.js.map

package/dist/mintlify-nav.js.map

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

package/dist/mintlify-openapi.d.ts

@@ -0,0 +1,109 @@
+import type { TreeNode, ExportPage } from "@dogsbay/types";
+/**
+ * The OpenAPI spec reference declared in a Mintlify config, or null. Reads
+ * `docs.json` / `mint.json` `api.openapi` (string, or first of an array) and the
+ * legacy top-level `openapi`. Only an `http(s)://` value is a URL; everything
+ * else — including a ROOT-relative path like `/api-reference/openapi.json`,
+ * which Mintlify resolves against the docs root, not the filesystem root — is
+ * resolved against `source`.
+ */
+export declare function mintlifyOpenApiSpecRef(source: string): string | null;
+/**
+ * Where a spec reference came from — which decides how far we trust it.
+ *
+ * `config` is `docs.json` / `mint.json`: the operator pointed us at this site,
+ * so its config is a deliberate choice. `page` is a `.mdx` file's own
+ * frontmatter — that is CONTENT, authored by whoever wrote the repo we are
+ * converting, and converting an arbitrary public repo is the whole point of
+ * the migration story. Content does not get to name a network endpoint or a
+ * file outside the corpus.
+ */
+export type SpecRefOrigin = "config" | "page";
+/**
+ * Fetch the raw spec document, unparsed.
+ *
+ * An OpenAPI spec is a CANONICAL SOURCE ARTIFACT, not prose: round-tripping it
+ * through the TreeNode IR is lossy by construction ($ref/component schemas
+ * inline, security schemes and callbacks vanish). Exporters that can consume a
+ * spec directly should pass THIS through rather than rebuild it from endpoint
+ * nodes. Returns null when the spec cannot be read.
+ */
+export declare function readOpenApiSpecSource(specRef: string): Promise<{
+    text: string;
+    filename: string;
+} | null>;
+export interface EndpointMapResult {
+    /** `"<method> <path>"` (lowercase method) → the `endpoint` TreeNode(s). */
+    map: Map<string, TreeNode[]>;
+    /** The same keys → the page title format-openapi gives the operation. */
+    titles?: Map<string, string>;
+    /** Spec load/parse failure message, or null. Lets the caller distinguish a
+     *  failed fetch (blame the spec source) from a genuine no-match (blame the
+     *  page). Without this, every page reads "no matching operation" on a 404. */
+    loadError: string | null;
+}
+/**
+ * Parse a spec into an endpoint map. A fetch/parse error must degrade to blank
+ * pages (never crash the import), but is reported via `loadError` rather than
+ * silently swallowed.
+ */
+export declare function buildMintlifyEndpointMap(specRef: string): Promise<EndpointMapResult>;
+/**
+ * Normalise a page's `openapi` frontmatter value to a map key, or null when the
+ * page is not an OpenAPI page. Accepts `"post /partners/ban"` (method + path);
+ * a leading named-spec token (`"api POST /x"`) is tolerated by taking the last
+ * two whitespace-separated tokens.
+ */
+export declare function openApiPageKey(value: unknown): string | null;
+/**
+ * The spec a PAGE names in its own `openapi:` frontmatter, or null.
+ *
+ * Mintlify lets a page point at a specific spec inline:
+ *
+ *     openapi: "/openapi.json GET /project/update-status/{statusId}"
+ *
+ * `openApiPageKey` already tolerates that leading token (it takes the last two
+ * tokens); this reads the token itself, which nothing did. A site whose
+ * `docs.json` has no `api.openapi` key therefore resolved NO endpoints even
+ * though every page stated exactly which spec to use — measured on Mintlify's
+ * own documentation: 100 pages imported without their endpoint content and 20
+ * of them came out completely blank, next to an `openapi.json` sitting in the
+ * repo root.
+ *
+ * Resolved the same way as a config-declared ref: a leading `/` is the DOCS
+ * root, not the filesystem root.
+ */
+export declare function openApiPageSpecRef(source: string, value: unknown): string | null;
+/**
+ * The vault/site slug for a nav-referenced OpenAPI operation (a `pages` string
+ * of the form `"POST /api/generate"` under a tab/group that declares an
+ * `openapi` spec). The NAV and the GENERATED PAGE both call this, so their
+ * href and slug always agree. Path-based (`/api/generate` → `api/generate`) for
+ * clean URLs; same-path-different-method operations would collide — rare, and
+ * documented (ollama and typical REST doc sets use unique paths per page).
+ */
+export declare function openApiRefSlug(path: string): string;
+/**
+ * Every distinct OpenAPI spec a Mintlify config references — the top-level
+ * `api.openapi` AND any `openapi` declared on a nav container (tab/group).
+ *
+ * Both are real source artifacts. Capturing only the top-level one meant a site
+ * like ollama (whose spec is declared on an "API Reference" tab) fell back to
+ * lossy reconstruction despite having a perfectly good spec on disk.
+ */
+export declare function collectMintlifyOpenApiSpecRefs(source: string, 
+/** Spec refs named by individual pages' `openapi:` frontmatter. */
+pageSpecRefs?: readonly string[]): string[];
+/**
+ * Generate an ExportPage for every OpenAPI operation referenced ONLY by the nav
+ * (a `METHOD /path` `pages` string under a container that declares `openapi`) —
+ * these pages exist in no `.mdx` file (unlike the frontmatter case), so without
+ * this the nav links are dead and the API section is empty. ollama's docs.json
+ * is exactly this shape (an "Endpoints" group of 12 such strings under a tab
+ * with `openapi: /openapi.yaml`).
+ */
+export declare function collectMintlifyOpenApiNavPages(source: string): Promise<{
+    pages: ExportPage[];
+    loadError: string | null;
+}>;
+//# sourceMappingURL=mintlify-openapi.d.ts.map

package/dist/mintlify-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintlify-openapi.d.ts","sourceRoot":"","sources":["../src/mintlify-openapi.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAc3D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMpE;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AA0D9C;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAkBpD;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7B,yEAAyE;IACzE,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;kFAE8E;IAC9E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAmB5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAS5D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAchF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM;AACd,mEAAmE;AACnE,YAAY,GAAE,SAAS,MAAM,EAAO,GACnC,MAAM,EAAE,CAaV;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAkC5D"}