@dogsbay/docs-layout 0.2.0-beta.92 → 0.2.0-beta.94

package/src/DocsNavClient.astro

@@ -17,7 +17,10 @@
  *   - HTML per page: ~200 bytes (this placeholder + a tiny script
  *     tag) vs ~600 KB+ for the SSR tree at scale.
  *   - No-JS users see only the skeleton + the `<noscript>` fallback
- *     link. A `sitemap.xml` link covers no-JS navigation.
+ *     link. A `sitemap-index.xml` link covers no-JS navigation —
+ *     note `emitSitemapFiles` only runs when `site.url` is a valid
+ *     http(s) URL, so a site without one has no sitemap for this
+ *     fallback to reach.
  *   - First paint waits for the JS bundle + the JSON fetch. On a 4G
  *     connection that's typically <200 ms; the skeleton fills the
  *     space until then.
@@ -34,21 +37,32 @@ interface Props {
    * so multi-axis sites work the same as SSR.
    */
   basePath?: string;
+  /** Current source's product/namespace, if multi-product site. */
+  namespace?: string;
   /** Current source's version axis value, if multi-version site. */
   version?: string;
   /** Current source's locale axis value, if multi-locale site. */
   locale?: string;
 }
 
-const { currentPath, basePath = "", version, locale } = Astro.props;
+const { currentPath, basePath = "", namespace, version, locale } = Astro.props;
 const navUrl = `${basePath}/_dogsbay/nav.json`;
 ---
 
+{/*
+  `role="navigation"` is REQUIRED here, not decoration: `aria-label` and
+  `aria-busy` are prohibited on a generic div (axe: aria-prohibited-attr,
+  serious) because a role-less element has no accessible name to label.
+  Giving the nav container its real role makes both attributes legal and
+  makes the landmark discoverable — it was previously neither.
+*/}
 <div
   id="docs-nav-root"
+  role="navigation"
   data-nav-url={navUrl}
   data-current-path={currentPath}
   data-base-path={basePath}
+  data-namespace={namespace ?? ""}
   data-version={version ?? ""}
   data-locale={locale ?? ""}
   aria-busy="true"
@@ -73,7 +87,11 @@ const navUrl = `${basePath}/_dogsbay/nav.json`;
   <noscript>
     <p class="px-2 py-1.5 text-sm text-sidebar-foreground/70">
       JavaScript is required to render the sidebar. Use the
-      <a href={`${basePath}/sitemap.xml`} class="underline">sitemap</a>
+      {/* sitemap-index.xml, not sitemap.xml — Dogsbay emits the
+          sitemap-index / sitemap-0 pair directly (see emitSitemapFiles);
+          `sitemap.xml` has never existed, so this no-JS fallback link
+          404'd on every site. */}
+      <a href={`${basePath}/sitemap-index.xml`} class="underline">sitemap</a>
       to browse all pages.
     </p>
   </noscript>

package/src/SearchDialog.astro

@@ -57,6 +57,14 @@ interface Props {
    * back to slugs when undefined.
    */
   taxonomyDisplay?: Record<string, TaxonomyDisplay>;
+  /**
+   * Current page's product (namespace) and version. On a multi-product /
+   * versioned site, search opens PRE-SCOPED to these — a Calico 3.32 page
+   * searches Calico 3.32 by default. The scope is seeded as normal facet
+   * selections, so the reader can untick them to search wider.
+   */
+  scopeProduct?: string;
+  scopeVersion?: string;
 }
 
 const {
@@ -64,6 +72,8 @@ const {
   navUrl,
   placeholder = "Search docs...",
   taxonomyDisplay,
+  scopeProduct,
+  scopeVersion,
 } = Astro.props;
 ---
 
@@ -72,6 +82,8 @@ const {
   data-pagefind-url={pagefindUrl}
   data-nav-url={navUrl}
   data-taxonomy-display={taxonomyDisplay ? JSON.stringify(taxonomyDisplay) : ""}
+  data-scope-product={scopeProduct ?? ""}
+  data-scope-version={scopeVersion ?? ""}
   class="fixed left-1/2 top-[10vh] z-50 w-[calc(100vw-2rem)] max-w-4xl -translate-x-1/2 rounded-xl border border-border bg-popover p-0 text-popover-foreground shadow-2xl backdrop:bg-black/40 backdrop:backdrop-blur-sm"
 >
   <form method="dialog" class="flex flex-col">
@@ -215,6 +227,9 @@ const {
   };
 
   const dialog = document.querySelector<HTMLDialogElement>("[data-search-dialog]");
+  // Current page's product/version — search opens pre-scoped to these.
+  const scopeProduct = dialog?.dataset.scopeProduct || "";
+  const scopeVersion = dialog?.dataset.scopeVersion || "";
   const trigger = document.querySelector<HTMLButtonElement>("[data-search-trigger]");
   const input = dialog?.querySelector<HTMLInputElement>("[data-search-input]");
   const resultsBox = dialog?.querySelector<HTMLDivElement>("[data-search-results]");
@@ -652,9 +667,22 @@ const {
       const fromUrl = parseFiltersFromUrl(new URLSearchParams(window.location.search));
       input!.value = fromUrl.query;
       filters = fromUrl.filters;
+      const hadUrlState = fromUrl.query.length > 0 || countActiveFilters(filters) > 0;
+      // Auto-scope: a FRESH open (no filters/query carried in the URL) on a
+      // multi-product/versioned site starts scoped to the CURRENT product +
+      // version. Seeded as ordinary facet selections, so the reader can
+      // untick "Product: calico" / "Version: 3.32" to search wider. A URL
+      // that already carries state wins (shared/roundtripped searches).
+      if (!hadUrlState) {
+        if (scopeProduct) filters.product = [scopeProduct];
+        if (scopeVersion) filters.version = [scopeVersion];
+      }
       renderFacets();
 
-      const hasInitial = input!.value.length > 0 || countActiveFilters(filters) > 0;
+      // Run immediately only when there's a query or the state came from the
+      // URL. A fresh open shows the empty prompt with the scope pre-ticked —
+      // results appear (scoped) as soon as the reader types.
+      const hasInitial = hadUrlState;
       if (hasInitial) {
         runSearch(input!.value);
       } else {

package/src/VersionSwitcher.astro

@@ -37,6 +37,9 @@ const currentLabel = currentRow?.entry.label ?? currentRow?.entry.id ?? "Version
       {currentRow?.entry.eol && (
         <span class="ml-1 rounded bg-muted px-1 text-[10px] uppercase text-muted-foreground">EOL</span>
       )}
+      {currentRow?.entry.prerelease && (
+        <span class="ml-1 rounded bg-muted px-1 text-[10px] uppercase text-muted-foreground">Pre</span>
+      )}
       <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="ml-1 transition-transform"><polyline points="6 9 12 15 18 9"/></svg>
     </summary>
     <ul class="absolute right-0 z-50 mt-1 min-w-[10rem] rounded-md border border-border bg-popover p-1 text-sm shadow-md">
@@ -59,6 +62,9 @@ const currentLabel = currentRow?.entry.label ?? currentRow?.entry.id ?? "Version
               {row.entry.eol && (
                 <span class="rounded bg-muted px-1 text-[10px] uppercase text-muted-foreground">EOL</span>
               )}
+              {row.entry.prerelease && (
+                <span class="rounded bg-muted px-1 text-[10px] uppercase text-muted-foreground">Pre</span>
+              )}
               {row.entry.default && !row.isCurrent && (
                 <span class="text-[10px] text-muted-foreground">default</span>
               )}

package/src/docs-nav-client.ts

@@ -23,11 +23,63 @@
  */
 import { filterNavByAxis } from "./nav-filter.js";
 
+interface NavMark {
+  kind: "added" | "changed" | "removed" | "moved";
+  label?: string;
+  subtree?: boolean;
+}
+
 interface NavItem {
   label: string;
   href?: string;
   icon?: string;
   children?: NavItem[];
+  mark?: NavMark;
+}
+
+/**
+ * A state marker beside a nav label (release comparisons mark changed /
+ * new / removed pages; the same slot serves "new since your last
+ * visit", deprecation flags, version badges).
+ *
+ * Accessibility contract — mirrors SidebarNavMark.astro, which renders
+ * the server-side tree:
+ *  - **Never colour alone** (WCAG 1.4.1): a distinct GLYPH carries the
+ *    meaning, so it survives greyscale and colour-blindness; colour only
+ *    reinforces.
+ *  - **Survives forced-colors** (High Contrast strips backgrounds): the
+ *    glyph is real text, so it always renders.
+ *  - **Announced**: a visually-hidden word rides along, so the row reads
+ *    "MySQL, changed". It is a sibling span, NOT an aria-label on the
+ *    link — an aria-label would REPLACE the page name in the
+ *    accessibility tree, losing the label it exists to announce.
+ */
+const MARK_GLYPH: Record<NavMark["kind"], string> = {
+  added: "+",
+  changed: "•",
+  removed: "−",
+  moved: "→",
+};
+
+function buildMark(mark: NavMark): HTMLElement {
+  const text = mark.label ?? (mark.subtree ? `contains ${mark.kind}` : mark.kind);
+  const wrap = document.createElement("span");
+  wrap.className = "db-nav-mark";
+  wrap.dataset.navMark = mark.kind;
+  if (mark.subtree) wrap.dataset.navMarkSubtree = "";
+  wrap.title = text;
+
+  const glyph = document.createElement("span");
+  glyph.setAttribute("aria-hidden", "true");
+  glyph.textContent = MARK_GLYPH[mark.kind];
+  wrap.appendChild(glyph);
+
+  const sr = document.createElement("span");
+  sr.className = "sr-only";
+  sr.textContent = text;
+  wrap.appendChild(sr);
+
+  return wrap;
 }
 
 /**
@@ -64,7 +116,7 @@ function hasActiveDescendant(item: NavItem, current: string): boolean {
  * sync. Padding is computed from `level` the same way (`8 + level*12`
  * pixels) so indentation lines up across the same render.
  */
-function renderItem(item: NavItem, current: string, level: number): HTMLLIElement {
+export function renderItem(item: NavItem, current: string, level: number): HTMLLIElement {
   const li = document.createElement("li");
   li.dataset.sidebar = "nav-tree-item";
 
@@ -73,7 +125,87 @@ function renderItem(item: NavItem, current: string, level: number): HTMLLIElemen
   const padLeft = `${8 + level * 12}px`;
   const heightClass = level === 0 ? "h-8" : "h-7";
 
-  if (hasChildren) {
+  if (hasChildren && item.href) {
+    // A branch that is ALSO a page (section landing page) uses the APG
+    // "disclosure navigation" pattern: a real link (navigates) and a
+    // SEPARATE toggle <button> (expands/collapses), as siblings. Nesting
+    // a focusable <a> inside the interactive <summary> — as this did
+    // before — is an axe `nested-interactive` violation ("interactive
+    // controls must not be nested"). Native <details> can't hold a
+    // visible-when-collapsed header link without that nesting, so a
+    // page-branch drops <details> for link + button + sibling submenu.
+    const open = active || hasActiveDescendant(item, current);
+    const submenuId = `nav-sub-${item.href.replace(/[^a-z0-9]+/gi, "-")}-${level}`;
+
+    const row = document.createElement("div");
+    row.className = [
+      "flex w-full min-w-0 items-center gap-2 rounded-md text-sm text-sidebar-foreground hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",
+      heightClass,
+      active ? "bg-sidebar-accent font-medium text-sidebar-accent-foreground" : "",
+    ]
+      .filter(Boolean)
+      .join(" ");
+    row.style.paddingLeft = padLeft;
+
+    const toggle = document.createElement("button");
+    toggle.type = "button";
+    toggle.dataset.navToggle = "";
+    toggle.setAttribute("aria-controls", submenuId);
+    toggle.setAttribute("aria-expanded", String(open));
+    toggle.setAttribute("aria-label", `Toggle ${item.label} section`);
+    toggle.className =
+      "shrink-0 rounded outline-none ring-sidebar-ring focus-visible:ring-2";
+    toggle.innerHTML =
+      '<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="size-4 shrink-0 transition-transform duration-200" data-chevron aria-hidden="true"><polyline points="9 18 15 12 9 6"/></svg>';
+    row.appendChild(toggle);
+
+    if (item.icon) {
+      const iconSpan = document.createElement("span");
+      iconSpan.className = "shrink-0 [&>svg]:size-4";
+      iconSpan.innerHTML = item.icon;
+      row.appendChild(iconSpan);
+    }
+
+    const link = document.createElement("a");
+    link.className =
+      "min-w-0 flex-1 truncate text-inherit no-underline outline-none ring-sidebar-ring focus-visible:ring-2";
+    link.href = item.href;
+    link.textContent = item.label;
+    link.dataset.navHref = item.href; // rehighlight keys off this
+    if (active) link.dataset.active = "true";
+    row.appendChild(link);
+
+    if (item.mark) {
+      // A SUBTREE mark describes DESCENDANTS — never strike through this
+      // row for it (a surviving group whose child was deleted would read
+      // as a deleted section).
+      if (!item.mark.subtree) link.dataset.navMarkRow = item.mark.kind;
+      row.appendChild(buildMark(item.mark));
+    }
+
+    const submenu = document.createElement("ul");
+    submenu.id = submenuId;
+    submenu.dataset.navSubmenu = "";
+    submenu.className = "flex min-w-0 flex-col";
+    submenu.dataset.sidebar = "nav-tree";
+    submenu.dataset.level = String(level + 1);
+    for (const child of item.children!) {
+      submenu.appendChild(renderItem(child, current, level + 1));
+    }
+    if (!open) submenu.hidden = true;
+
+    toggle.addEventListener("click", () => {
+      const isOpen = toggle.getAttribute("aria-expanded") === "true";
+      toggle.setAttribute("aria-expanded", String(!isOpen));
+      submenu.hidden = isOpen;
+    });
+
+    li.appendChild(row);
+    li.appendChild(submenu);
+  } else if (hasChildren) {
+    // Pure grouping label (no href): native <details>/<summary> is fully
+    // accessible here — the summary is the only interactive control, and
+    // its label is a plain <span>. Zero-JS expand/collapse.
     const details = document.createElement("details");
     if (active || hasActiveDescendant(item, current)) details.open = true;
 
@@ -81,16 +213,11 @@ function renderItem(item: NavItem, current: string, level: number): HTMLLIElemen
     summary.className = [
       "flex w-full min-w-0 cursor-pointer items-center gap-2 rounded-md text-sm text-sidebar-foreground outline-none [list-style:none] ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 [&::-webkit-details-marker]:hidden",
       heightClass,
-      active ? "bg-sidebar-accent font-medium text-sidebar-accent-foreground" : "",
     ]
       .filter(Boolean)
       .join(" ");
     summary.style.paddingLeft = padLeft;
-    if (item.href) summary.dataset.navHref = item.href;
-    if (active) summary.dataset.active = "true";
 
-    // Chevron SVG — matches SidebarNavTree's rotation-on-open via CSS
-    // (`details[open] > summary [data-chevron] { transform: rotate(90deg); }`).
     summary.innerHTML =
       '<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="size-4 shrink-0 transition-transform duration-200" data-chevron aria-hidden="true"><polyline points="9 18 15 12 9 6"/></svg>';
 
@@ -102,13 +229,17 @@ function renderItem(item: NavItem, current: string, level: number): HTMLLIElemen
     }
 
     const label = document.createElement("span");
-    label.className = "truncate";
+    label.className = "min-w-0 flex-1 truncate";
     label.textContent = item.label;
     summary.appendChild(label);
 
+    // A collapsed group HIDES its children, so a change inside must
+    // signal outward — the same visibility rule the diff renderer
+    // applies to tabs.
+    if (item.mark) summary.appendChild(buildMark(item.mark));
+
     details.appendChild(summary);
 
-    // Recurse — nested `<ul>` mirrors SidebarNavTree's `<Astro.self>`.
     const childUl = document.createElement("ul");
     childUl.className = "flex min-w-0 flex-col";
     childUl.dataset.sidebar = "nav-tree";
@@ -146,17 +277,24 @@ function renderItem(item: NavItem, current: string, level: number): HTMLLIElemen
     }
 
     const label = document.createElement("span");
-    label.className = "truncate";
+    label.className = "min-w-0 flex-1 truncate";
     label.textContent = item.label;
     a.appendChild(label);
 
+    if (item.mark) {
+      // strikethrough only for a page that IS removed, never for an
+      // aggregate about its children
+      if (!item.mark.subtree) a.dataset.navMarkRow = item.mark.kind;
+      a.appendChild(buildMark(item.mark));
+    }
+
     li.appendChild(a);
   }
 
   return li;
 }
 
-function renderTree(items: NavItem[], current: string, root: HTMLElement): void {
+export function renderTree(items: NavItem[], current: string, root: HTMLElement): void {
   const ul = document.createElement("ul");
   ul.className =
     "flex min-w-0 flex-col w-full group-data-[collapsible=icon]:hidden";
@@ -199,7 +337,9 @@ function rehighlight(root: HTMLElement, current: string): void {
       el.classList.remove(...ACTIVE_CLASSES);
     }
   }
-  // Expand ancestors of the new active item.
+  // Expand ancestors of the new active item — both native <details>
+  // groups and the button-driven [data-nav-submenu] disclosures used by
+  // section-landing (href) branches.
   const active = root.querySelector<HTMLElement>('[data-active="true"]');
   if (active) {
     let parent: HTMLElement | null = active.parentElement;
@@ -207,6 +347,13 @@ function rehighlight(root: HTMLElement, current: string): void {
       if (parent.tagName === "DETAILS") {
         (parent as HTMLDetailsElement).open = true;
       }
+      if (parent.matches("[data-nav-submenu]")) {
+        parent.hidden = false;
+        const toggle = root.querySelector<HTMLElement>(
+          `[data-nav-toggle][aria-controls="${parent.id}"]`,
+        );
+        toggle?.setAttribute("aria-expanded", "true");
+      }
       parent = parent.parentElement;
     }
   }
@@ -229,13 +376,20 @@ export async function hydrateDocsNav(): Promise<void> {
   }
   const current = normalize(root.dataset.currentPath || location.pathname);
   const basePath = root.dataset.basePath || "";
+  const namespace = root.dataset.namespace || undefined;
   const version = root.dataset.version || undefined;
   const locale = root.dataset.locale || undefined;
 
   try {
     const nav = await fetchNav(navUrl);
     const filtered = filterNavByAxis(nav, {
-      basePath: basePath || "/docs",
+      // Pass basePath through as-is — an empty basePath (root-served
+      // site) must stay "", matching the SSR path's `?? "/docs"`
+      // (which keeps ""). Coercing "" → "/docs" makes the filter look
+      // for `/docs/…` bucket hrefs that don't exist and blanks the
+      // whole sidebar on a root-served multi-source site.
+      basePath,
+      namespace: namespace || undefined,
       version: version || undefined,
       locale: locale || undefined,
     });

package/src/link-icons.ts

@@ -0,0 +1,54 @@
+/**
+ * Internal/external link-icon affordance — the tiny bit of logic behind
+ * the `data-link-icons` + `--db-link-icon-*` attributes DocsLayout stamps
+ * on `<body>`. Classification itself is pure CSS (by href shape); this
+ * only turns the configured glyphs into the attribute + custom-property
+ * values. See plans/link-resolution-and-icons.md.
+ */
+
+export interface LinkIcons {
+  /** Glyph after external links (absolute / protocol-relative href). */
+  external?: string;
+  /** Glyph after internal links (root / relative href). */
+  internal?: string;
+}
+
+export interface LinkIconAttrs {
+  /**
+   * Space-separated active kinds for `data-link-icons` (`"external"`,
+   * `"internal"`, or both) — undefined when the feature is off, so the
+   * attribute is omitted entirely.
+   */
+  tokens?: string;
+  /**
+   * Inline `style` value setting the `--db-link-icon-*` custom
+   * properties to the (single-quoted, CSS-string-safe) glyphs —
+   * undefined when nothing is active.
+   */
+  style?: string;
+}
+
+/** CSS-string-escape a glyph so it's a valid single-quoted `content:` value. */
+function cssString(glyph: string): string {
+  return glyph.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+
+/**
+ * Build the `<body>` attributes for the link-icon feature. A side is
+ * active only when its glyph is a non-empty string; an absent config (or
+ * all-empty) yields `{}` so DocsLayout emits no attributes.
+ */
+export function linkIconAttrs(icons: LinkIcons | undefined): LinkIconAttrs {
+  const external = icons?.external?.trim() ? icons.external : "";
+  const internal = icons?.internal?.trim() ? icons.internal : "";
+  const tokens = [external ? "external" : "", internal ? "internal" : ""]
+    .filter(Boolean)
+    .join(" ");
+  const style = [
+    external ? `--db-link-icon-external: '${cssString(external)}'` : "",
+    internal ? `--db-link-icon-internal: '${cssString(internal)}'` : "",
+  ]
+    .filter(Boolean)
+    .join("; ");
+  return { tokens: tokens || undefined, style: style || undefined };
+}

package/src/markdown-negotiation.ts

@@ -7,6 +7,11 @@
  * Returns the path to rewrite to (the `.md` mirror endpoint) when the
  * request should be served as markdown; returns `null` when the normal
  * HTML response should pass through.
+ *
+ * `basePath` is the prefix the site is SERVED at (Dogsbay's combined
+ * urlBase + basePath). It is needed only to recognise the site index,
+ * whose mirror is `<base>/index.md` rather than `<base>.md` — see
+ * `shouldRewriteToMarkdown`.
  */
 
 const Q_PARAM_RE = /^\s*q\s*=\s*([0-9.]+)\s*$/i;
@@ -28,6 +33,7 @@ const Q_PARAM_RE = /^\s*q\s*=\s*([0-9.]+)\s*$/i;
 export function shouldRewriteToMarkdown(
   accept: string | null | undefined,
   pathname: string,
+  basePath = "",
 ): string | null {
   if (!accept) return null;
   if (!acceptsMarkdown(accept)) return null;
@@ -35,8 +41,38 @@ export function shouldRewriteToMarkdown(
   if (hasNonHtmlExtension(pathname)) return null;
 
   const trimmed = pathname.replace(/\/$/, "");
-  const target = trimmed === "" ? "/.md" : `${trimmed}.md`;
-  return target;
+  const base = basePath.replace(/\/+$/, "");
+
+  // A request outside the served prefix is not ours to rewrite. Without
+  // this guard, `("/", "/docs")` fell through to `"" + ".md"` — a
+  // RELATIVE target, resolved against whatever the request path was.
+  if (base && trimmed !== base && !trimmed.startsWith(`${base}/`)) return null;
+
+  // The site index is emitted as `index.md.ts`, so its mirror is
+  // `<base>/index.md`. Every other page emitted by the shipped importers
+  // has its mirror at `<path>.md`: Dogsbay builds in Astro's directory
+  // format, so a leaf at `/getting-started/` maps to
+  // `/getting-started.md`, and a directory index like `guides/index.md`
+  // is NORMALIZED to slug `guides` (see import-mkdocs.ts's
+  // `.replace(/\/index$/, "")`), emitting `guides.astro` + `guides.md.ts`
+  // — so `/guides.md` exists too.
+  //
+  // Appending `.md` to the site index produced `/.md` (root-served) or
+  // `/blog.md` (mounted); neither exists, and `/blog.md` additionally
+  // falls OUTSIDE the `/blog/*` Workers route. Leaf and index URLs both
+  // carry a trailing slash, so only the base comparison distinguishes
+  // them.
+  //
+  // CAVEAT: a caller driving `exportAstroProject` directly with an
+  // unnormalized `<dir>/index` slug gets `src/pages/<dir>/index.astro`
+  // (served `/<dir>/`) whose only mirror is `/<dir>/index.md`, and this
+  // returns `/<dir>.md` — a 404. No shipped importer does that. If one
+  // ever should, generalize the sibling `.md.ts` emitter in
+  // `format-astro/src/project.ts` rather than guessing here from a URL
+  // that cannot distinguish the two shapes.
+  if (trimmed === base) return `${base}/index.md`;
+
+  return `${trimmed}.md`;
 }
 
 function acceptsMarkdown(accept: string): boolean {