@dogsbay/format-vitepress 0.2.0-beta.101

package/dist/nav.d.ts

@@ -0,0 +1,51 @@
+/**
+ * VitePress `themeConfig.sidebar` / `themeConfig.nav` → `NavItem[]`.
+ *
+ * Free of filesystem I/O: slug resolution is injected, so this module is unit
+ * testable and the loader stays the only thing that touches disk.
+ */
+import type { NavItem } from "@dogsbay/types";
+import type { RawNavItem, RawSidebar } from "./config.js";
+export interface NavContext {
+    /** URL prefix for every internal href (`/docs`). */
+    hrefPrefix: string;
+    /**
+     * Slugs that actually exist, so a sidebar link to `/guide/` can be resolved
+     * to `guide/index` vs `guide` correctly and a dangling link can be reported
+     * rather than emitted as a 404.
+     */
+    hasSlug?: (slug: string) => boolean;
+    onWarn?: (msg: string) => void;
+}
+/**
+ * A VitePress sidebar `link` is a SITE PATH, not a file path: `/guide/` is
+ * `guide/index.md`, `/config/include` is `config/include.md`. Both forms may
+ * carry `.md` or `.html`, and `base` is not included.
+ */
+export declare function linkToSlug(link: string): string;
+export declare function slugToHref(slug: string, ctx: NavContext): string;
+export declare function itemsToNav(items: RawNavItem[], ctx: NavContext): NavItem[];
+/**
+ * Build the sidebar.
+ *
+ * The object form (`{'/guide/': [...], '/config/': [...]}`) is VitePress's
+ * multi-section shape: each key is a path prefix and only its own section is
+ * visible while the reader is under it. A Dogsbay sidebar shows everything, so
+ * each key becomes a top-level GROUP. Its label comes from the matching top
+ * `nav` entry when there is one (that is the name the site itself gives the
+ * section — "Guide", "Config", "Examples"), else the prettified path segment.
+ *
+ * A single-key object is spliced flat: wrapping the whole site in one group
+ * called "Docs" is noise, not structure.
+ */
+export declare function buildNav(sidebar: RawSidebar | undefined, nav: RawNavItem[] | undefined, ctx: NavContext): NavItem[];
+/**
+ * Fallback nav: a tree derived from the page slugs themselves, used when the
+ * config yields no sidebar at all (an unreadable config, or a site that
+ * relies entirely on VitePress's own auto-sidebar).
+ */
+export declare function navFromSlugs(pages: {
+    slug: string;
+    title: string;
+}[], ctx: NavContext): NavItem[];
+//# sourceMappingURL=nav.d.ts.map

package/dist/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,CAIhE;AAgCD,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,EAAE,CAQ1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,GAAG,EAAE,UAAU,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,UAAU,GACd,OAAO,EAAE,CAsBX;AAyCD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EACxC,GAAG,EAAE,UAAU,GACd,OAAO,EAAE,CAsCX"}

package/dist/nav.js

@@ -0,0 +1,182 @@
+const EXTERNAL_RE = /^[a-z][a-z0-9+.-]*:|^\/\//i;
+/**
+ * A VitePress sidebar `link` is a SITE PATH, not a file path: `/guide/` is
+ * `guide/index.md`, `/config/include` is `config/include.md`. Both forms may
+ * carry `.md` or `.html`, and `base` is not included.
+ */
+export function linkToSlug(link) {
+    let s = link.split("#")[0].split("?")[0];
+    s = s.replace(/^\/+/, "");
+    s = s.replace(/\.(md|html)$/i, "");
+    if (s.endsWith("/"))
+        s = `${s}index`;
+    if (s === "")
+        s = "index";
+    return s;
+}
+export function slugToHref(slug, ctx) {
+    const prefix = ctx.hrefPrefix.replace(/\/$/, "");
+    const clean = slug === "index" ? "" : slug.replace(/\/index$/, "");
+    return clean ? `${prefix}/${clean}` : prefix || "/";
+}
+function resolveHref(link, ctx) {
+    if (EXTERNAL_RE.test(link))
+        return link;
+    const anchor = link.includes("#") ? link.slice(link.indexOf("#")) : "";
+    const slug = linkToSlug(link);
+    if (ctx.hasSlug && !ctx.hasSlug(slug) && !ctx.hasSlug(`${slug}/index`)) {
+        ctx.onWarn?.(`sidebar link "${link}" has no matching page`);
+    }
+    return `${slugToHref(slug, ctx)}${anchor}`;
+}
+function itemToNav(item, ctx) {
+    const label = typeof item.text === "string" ? item.text : undefined;
+    const link = typeof item.link === "string" ? item.link : undefined;
+    const rawItems = Array.isArray(item.items) ? item.items : undefined;
+    const children = rawItems ? itemsToNav(rawItems, ctx) : undefined;
+    if (!label) {
+        // A nav dropdown may hold `{ component: … }` or a divider — nothing to
+        // render, but say so rather than dropping it invisibly.
+        ctx.onWarn?.(`sidebar item with no \`text\` skipped (keys: ${Object.keys(item).join(",")})`);
+        return null;
+    }
+    const nav = { label };
+    if (link)
+        nav.href = resolveHref(link, ctx);
+    if (children && children.length > 0)
+        nav.children = children;
+    if (!nav.href && !nav.children)
+        return null;
+    return nav;
+}
+export function itemsToNav(items, ctx) {
+    const out = [];
+    for (const item of items) {
+        if (!item || typeof item !== "object")
+            continue;
+        const nav = itemToNav(item, ctx);
+        if (nav)
+            out.push(nav);
+    }
+    return out;
+}
+/**
+ * Build the sidebar.
+ *
+ * The object form (`{'/guide/': [...], '/config/': [...]}`) is VitePress's
+ * multi-section shape: each key is a path prefix and only its own section is
+ * visible while the reader is under it. A Dogsbay sidebar shows everything, so
+ * each key becomes a top-level GROUP. Its label comes from the matching top
+ * `nav` entry when there is one (that is the name the site itself gives the
+ * section — "Guide", "Config", "Examples"), else the prettified path segment.
+ *
+ * A single-key object is spliced flat: wrapping the whole site in one group
+ * called "Docs" is noise, not structure.
+ */
+export function buildNav(sidebar, nav, ctx) {
+    if (!sidebar)
+        return [];
+    if (Array.isArray(sidebar))
+        return itemsToNav(sidebar, ctx);
+    const keys = Object.keys(sidebar);
+    if (keys.length === 0)
+        return [];
+    if (keys.length === 1)
+        return itemsToNav(sidebar[keys[0]], ctx);
+    const labels = navLabels(nav ?? []);
+    // Sections are built in the config's own key order. An earlier version
+    // sorted by key length to assign labels and then re-sorted by a Map keyed on
+    // LABEL — so two keys that prettify to the same name (`/v1/guide/` and
+    // `/v2/guide/` both give "Guide") collided in that Map and the sections came
+    // out in the wrong order. The index travels WITH the item instead.
+    const out = [];
+    keys.forEach((key, idx) => {
+        const children = itemsToNav(sidebar[key], ctx);
+        if (children.length === 0)
+            return;
+        out.push({ label: labels.get(normalizeKey(key)) ?? prettifyKey(key), children, idx });
+    });
+    out.sort((a, b) => a.idx - b.idx);
+    return out.map(({ label, children }) => ({ label, children }));
+}
+/** Top-level `nav` entries, indexed by the path they point at. */
+function navLabels(nav) {
+    const map = new Map();
+    const visit = (items) => {
+        for (const item of items) {
+            if (!item || typeof item !== "object")
+                continue;
+            const text = typeof item.text === "string" ? item.text : undefined;
+            const link = typeof item.link === "string" ? item.link : undefined;
+            const match = typeof item.activeMatch === "string" ? item.activeMatch : undefined;
+            if (text && (link || match) && !EXTERNAL_RE.test(link ?? "")) {
+                // `activeMatch` is the section's real extent when it is present;
+                // `link` points at the section landing page.
+                for (const p of [match, link]) {
+                    if (!p)
+                        continue;
+                    const k = normalizeKey(p);
+                    if (k && !map.has(k))
+                        map.set(k, text);
+                }
+            }
+            if (Array.isArray(item.items))
+                visit(item.items);
+        }
+    };
+    visit(nav);
+    return map;
+}
+function normalizeKey(key) {
+    return key.replace(/^\^/, "").replace(/\$$/, "").replace(/^\/+|\/+$/g, "");
+}
+function prettifyKey(key) {
+    const seg = normalizeKey(key).split("/").filter(Boolean).pop() ?? "";
+    if (!seg)
+        return "Docs";
+    return seg
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+/**
+ * Fallback nav: a tree derived from the page slugs themselves, used when the
+ * config yields no sidebar at all (an unreadable config, or a site that
+ * relies entirely on VitePress's own auto-sidebar).
+ */
+export function navFromSlugs(pages, ctx) {
+    const root = { label: "", items: [], groups: new Map() };
+    for (const page of [...pages].sort((a, b) => a.slug.localeCompare(b.slug))) {
+        if (page.slug === "index")
+            continue;
+        const parts = page.slug.split("/");
+        const file = parts.pop() ?? page.slug;
+        let group = root;
+        for (const part of parts) {
+            let next = group.groups.get(part);
+            if (!next) {
+                next = { label: prettifyKey(part), items: [], groups: new Map() };
+                group.groups.set(part, next);
+            }
+            group = next;
+        }
+        // A directory's `index` page becomes the group's own link, not a child.
+        if (file === "index" && group !== root) {
+            group.items.unshift({ label: page.title, href: slugToHref(page.slug, ctx) });
+            continue;
+        }
+        group.items.push({ label: page.title, href: slugToHref(page.slug, ctx) });
+    }
+    const collect = (g) => {
+        const out = [...g.items];
+        for (const child of g.groups.values()) {
+            const children = collect(child);
+            if (children.length > 0)
+                out.push({ label: child.label, children });
+        }
+        return out;
+    };
+    return collect(root);
+}
+//# sourceMappingURL=nav.js.map

package/dist/nav.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,14 @@
+import type { TreeNode } from "@dogsbay/types";
+import { type TranslateLedgerEntry, type TranslateOptions } from "./translate.js";
+export interface ParseVitepressResult {
+    tree: TreeNode[];
+    frontmatter: Record<string, unknown>;
+    /** Frontmatter + translated body. */
+    markdown: string;
+    /** Translated body only. */
+    body: string;
+    ledger: TranslateLedgerEntry[];
+    components: Record<string, number>;
+}
+export declare function parseVitepress(src: string, opts?: TranslateOptions): ParseVitepressResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAID,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,gBAAqB,GAC1B,oBAAoB,CAqBtB"}

package/dist/parse.js

@@ -0,0 +1,35 @@
+/**
+ * VitePress page → { tree, frontmatter, markdown, body, ledger }.
+ *
+ * Pipeline (mirrors format-gitbook / format-myst):
+ *   1. Split YAML frontmatter off the body so the body transform can't
+ *      disturb it.
+ *   2. Translate the VitePress body → Dogsbay-MD text.
+ *   3. Parse the translated Dogsbay-MD with the canonical `dogsbayMdToTree`.
+ *
+ * `markdown` (frontmatter + translated body) is what a migrate command writes
+ * to disk; `body` is the translated body alone.
+ */
+import { dogsbayMdToTree } from "@dogsbay/format-dogsbay-md";
+import { vitepressToDogsbayMd, } from "./translate.js";
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+export function parseVitepress(src, opts = {}) {
+    const normalized = src.replace(/\r\n?/g, "\n");
+    const fmMatch = normalized.match(FRONTMATTER_RE);
+    const fmBlock = fmMatch ? fmMatch[0] : "";
+    const rawBody = fmMatch ? normalized.slice(fmMatch[0].length) : normalized;
+    const { markdown: translatedBody, ledger, components } = vitepressToDogsbayMd(rawBody, opts);
+    const markdown = fmBlock
+        ? `${fmBlock.replace(/\n?$/, "\n")}\n${translatedBody}`
+        : translatedBody;
+    const { tree, frontmatter } = dogsbayMdToTree(markdown);
+    return {
+        tree,
+        frontmatter: frontmatter ?? {},
+        markdown,
+        body: translatedBody,
+        ledger,
+        components,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EACL,oBAAoB,GAGrB,MAAM,gBAAgB,CAAC;AAaxB,MAAM,cAAc,GAAG,mCAAmC,CAAC;AAE3D,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,OAAyB,EAAE;IAE3B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAE3E,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7F,MAAM,QAAQ,GAAG,OAAO;QACtB,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,cAAc,EAAE;QACvD,CAAC,CAAC,cAAc,CAAC;IAEnB,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAExD,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,WAAW,IAAI,EAAE;QAC9B,QAAQ;QACR,IAAI,EAAE,cAAc;QACpB,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/translate.d.ts

@@ -0,0 +1,80 @@
+/**
+ * VitePress Markdown → Dogsbay-MD text.
+ *
+ * VitePress markdown is CommonMark + `:::` containers + a handful of
+ * code-fence conventions + Vue. It is a near-superset of Dogsbay-MD, so this
+ * is a delimiter rewrite rather than a parser: once containers are renamed and
+ * fence metadata is normalized, `dogsbayMdToTree` defines correctness and we
+ * introduce zero new TreeNode types. Same pipeline as `format-gitbook` and
+ * `format-myst`.
+ *
+ * Everything this translator cannot map is recorded in a ledger. A migration
+ * that loses a construct silently is worse than one that says so.
+ */
+export interface TranslateLedgerEntry {
+    construct: string;
+    note: string;
+    line: number;
+}
+export interface SnippetRequest {
+    /** Path exactly as written in the source (`@/foo.ts`, `./bar.md`). */
+    path: string;
+    /** `#region` name, when the reference named one. */
+    region?: string;
+}
+export interface TranslateOptions {
+    /**
+     * Resolve a `<<<` snippet or `<!--@include:-->` target to its text.
+     * Injected so this module stays free of filesystem I/O (and unit-testable);
+     * the loader wires it to `srcDir` + the page's own directory.
+     */
+    readSnippet?: (req: SnippetRequest) => string | undefined;
+    /**
+     * Rewrite an image/asset reference to where the EXPORTER will put the file.
+     *
+     * A reference must match how its consumer resolves it: VitePress serves
+     * `public/` at the site root and co-located images relative to the page,
+     * neither of which survives into `_assets/`. Without this the reference
+     * survives the conversion and the FILE does not, which looks exactly like
+     * success. Injected because only the loader knows the page's directory.
+     */
+    assetHref?: (src: string) => string;
+    /** Directory an include/snippet spec resolves to, for rebasing nested ones. */
+    resolveDir?: (spec: string) => string | undefined;
+    /** Rebuild these options anchored at another directory. */
+    optionsForDir?: (dir: string) => TranslateOptions;
+}
+export interface TranslateResult {
+    markdown: string;
+    ledger: TranslateLedgerEntry[];
+    /** Component tag → occurrence count, for the import summary. */
+    components: Record<string, number>;
+}
+export declare function vitepressToDogsbayMd(source: string, opts?: TranslateOptions): TranslateResult;
+interface Ctx {
+    ledger: TranslateLedgerEntry[];
+    components: Record<string, number>;
+    opts: TranslateOptions;
+    /** Include-recursion depth, so a self-including fragment cannot loop. */
+    depth: number;
+}
+/**
+ * VitePress fence metadata → a single trailing `{…}` attrs block, which is
+ * what `dogsbayMdToTree` reads (markdown-it-attrs attaches it to the fence
+ * token; a bare `1,3-5` key becomes `props.highlights`).
+ *
+ *   ts [vitest.config.ts]   → ts {title="vitest.config.ts"}
+ *   js{1,3-5}               → js {1,3-5}
+ *   ts:line-numbers=2       → ts {lineNumbers="2"}
+ *   ts:no-line-numbers      → ts
+ *   js twoslash [a.js]      → js {title="a.js"}
+ *
+ * The attrs block MUST be last — markdown-it-attrs only reads a trailing one.
+ */
+export declare function translateFenceInfo(info: string, line: number, ctx?: Ctx): string;
+export declare function splitRegion(spec: string): {
+    path: string;
+    region?: string;
+};
+export {};
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,gBAAgB,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAqBD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,gBAAqB,GAC1B,eAAe,CAKjB;AAcD,UAAU,GAAG;IACX,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAkcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CA4DhF;AA8YD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAI3E"}