nimbus-docs 0.0.2

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/client/mount.ts","../src/client/ids.ts","../src/client/disclosure.ts","../src/client/dom.ts","../src/client/tabs-controller.ts","../src/client/scroll-lock.ts","../src/client/code-copy.ts","../src/client/heading-anchors.ts"],"sourcesContent":["/**\n * mount.ts — Discover, mount, and unmount component instances.\n *\n * The single entry point used by every `*.client.ts` to wire its component.\n * Handles three concerns:\n *\n *   1. Initial discovery — finds elements matching `selector` and calls `init`\n *      on each, storing the returned teardown.\n *   2. View transitions — on `astro:before-swap`, runs every teardown so\n *      document/window listeners come down before the DOM is replaced.\n *   3. Re-mount — on `astro:page-load`, re-runs discovery against the new DOM.\n *\n * The init function receives the root element and returns a `destroy()`\n * function. The root element is the keying mechanism — calling mount again\n * against an already-tracked element is a no-op.\n *\n * Usage:\n *\n *   mount(\"[data-nb-collapsible]\", (root) => {\n *     const disclosure = makeDisclosure({ ... });\n *     return () => disclosure.destroy();\n *   });\n */\n\ntype Init = (root: HTMLElement) => () => void;\n\nexport function mount(selector: string, init: Init): void {\n  const instances = new Map<HTMLElement, () => void>();\n\n  function setup() {\n    document.querySelectorAll<HTMLElement>(selector).forEach((el) => {\n      if (instances.has(el)) return;\n      instances.set(el, init(el));\n    });\n  }\n\n  function teardown() {\n    instances.forEach((destroy) => destroy());\n    instances.clear();\n  }\n\n  // Module scripts are deferred, so DOM is parsed by the time this runs.\n  // Belt-and-braces check anyway.\n  if (document.readyState === \"loading\") {\n    document.addEventListener(\"DOMContentLoaded\", setup, { once: true });\n  } else {\n    setup();\n  }\n\n  document.addEventListener(\"astro:before-swap\", teardown);\n  document.addEventListener(\"astro:page-load\", setup);\n}\n","/**\n * Generate a unique ID with a prefix, scoped to the page.\n *\n * Used to build ARIA relationships (`aria-controls` / `aria-labelledby`)\n * between elements that don't have a stable author-provided id.\n */\n\nlet counter = 0;\n\nexport function generateId(prefix: string): string {\n  counter += 1;\n  return `${prefix}-${counter}`;\n}\n","/**\n * disclosure.ts — Open/close state with ARIA wiring.\n *\n * The shared module for any \"click trigger, reveals content\" pattern.\n * Owns:\n *   - open/closed state (in-memory + reflected as `data-nb-state` on both\n *     trigger and content)\n *   - ARIA: `aria-expanded` on trigger, `aria-controls` linking to content\n *   - Click handler on the trigger\n *\n * Animation is intentionally out of scope — CSS targets the `data-nb-state`\n * attribute and runs whatever transition the component wants. Returning\n * a teardown means the caller can clean up on unmount.\n *\n * Used by: Collapsible, and any future Accordion / Sidebar group /\n * dismissable Banner that wants the standard disclosure semantics.\n */\n\nimport { generateId } from \"./ids\";\n\nexport interface DisclosureOptions {\n  /** The element users click to toggle. Usually a `<button>`. */\n  trigger: HTMLElement;\n  /** The element that's shown/hidden. Gets `id` + `data-nb-state`. */\n  content: HTMLElement;\n  /** Initial open state. Default `false`. */\n  defaultOpen?: boolean;\n  /** Called whenever open changes. */\n  onOpenChange?: (open: boolean) => void;\n}\n\nexport interface DisclosureInstance {\n  open(): void;\n  close(): void;\n  toggle(): void;\n  isOpen(): boolean;\n  destroy(): void;\n}\n\nexport function makeDisclosure(opts: DisclosureOptions): DisclosureInstance {\n  const { trigger, content, defaultOpen = false, onOpenChange } = opts;\n\n  let open = defaultOpen;\n\n  // Ensure ARIA relationship exists.\n  if (!content.id) {\n    content.id = generateId(\"nb-disclosure\");\n  }\n  trigger.setAttribute(\"aria-controls\", content.id);\n\n  function syncState() {\n    const state = open ? \"open\" : \"closed\";\n    trigger.setAttribute(\"data-nb-state\", state);\n    content.setAttribute(\"data-nb-state\", state);\n    trigger.setAttribute(\"aria-expanded\", String(open));\n  }\n\n  function setOpen(value: boolean) {\n    if (open === value) return;\n    open = value;\n    syncState();\n    onOpenChange?.(value);\n  }\n\n  function handleClick(e: MouseEvent) {\n    e.preventDefault();\n    setOpen(!open);\n  }\n\n  syncState();\n  trigger.addEventListener(\"click\", handleClick);\n\n  return {\n    open() {\n      setOpen(true);\n    },\n    close() {\n      setOpen(false);\n    },\n    toggle() {\n      setOpen(!open);\n    },\n    isOpen() {\n      return open;\n    },\n    destroy() {\n      trigger.removeEventListener(\"click\", handleClick);\n    },\n  };\n}\n","/**\n * Shared DOM constants for client-side interaction primitives.\n */\n\n/** CSS selector for focusable elements within a container. */\nexport const FOCUSABLE =\n  'a[href], button:not([disabled]), input:not([disabled]):not([type=\"hidden\"]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([disabled]):not([tabindex=\"-1\"])';\n","/**\n * Shared tab activation primitive.\n *\n * Handles aria-selected, panel visibility, roving tabindex,\n * keyboard navigation, sliding indicator, and cross-instance sync.\n *\n * Used by: Tabs.astro, PackageManagers.astro\n */\n\nimport { FOCUSABLE } from \"./dom\";\n\nexport interface TabsConfig {\n  /** Root container holding tabs + panels */\n  container: Element;\n  /** CSS selector for tab trigger buttons */\n  tabSelector: string;\n  /** CSS selector for tab panels */\n  panelSelector: string;\n  /** Optional sliding indicator element */\n  indicator?: HTMLElement | null;\n  /** Enable roving tabindex + arrow key navigation (default: true) */\n  rovingTabindex?: boolean;\n  /** Cross-instance persistence config */\n  sync?: {\n    key: string;\n    storage?: \"local\" | \"session\";\n    /** Extract sync label from a tab element. Default: textContent.trim() */\n    getLabel?: (tab: HTMLElement) => string;\n  };\n  /** Called after a tab is activated */\n  onActivate?: (index: number) => void;\n}\n\nexport interface TabsInstance {\n  activate(index: number, options?: { emitSync?: boolean }): void;\n  readonly currentIndex: number;\n  destroy(): void;\n}\n\nexport function initTabs(config: TabsConfig): TabsInstance {\n  const { container, tabSelector, panelSelector, indicator = null, rovingTabindex = true, sync, onActivate } = config;\n\n  const tabs = Array.from(container.querySelectorAll<HTMLElement>(tabSelector));\n  const panels = Array.from(container.querySelectorAll<HTMLElement>(panelSelector));\n  const tablist = container.querySelector(\"[role=tablist]\") ?? container;\n\n  let currentIndex = -1;\n  let isInitialActivation = true;\n\n  function getStorage(kind: \"local\" | \"session\"): Storage | null {\n    try {\n      return kind === \"session\" ? sessionStorage : localStorage;\n    } catch {\n      return null;\n    }\n  }\n\n  function getLabel(tab: HTMLElement): string {\n    return sync?.getLabel?.(tab) ?? tab.textContent?.trim() ?? \"\";\n  }\n\n  function updateIndicator(index: number) {\n    if (!indicator || !tabs[index]) return;\n    indicator.style.left = `${tabs[index].offsetLeft}px`;\n    indicator.style.width = `${tabs[index].offsetWidth}px`;\n  }\n\n  function activate(index: number, options?: { emitSync?: boolean }) {\n    const emitSync = options?.emitSync ?? true;\n    if (index === currentIndex) return;\n\n    // Capture scroll position before DOM changes to prevent layout jump\n    const rect = container.getBoundingClientRect();\n    const scrollBefore = rect.top;\n\n    currentIndex = index;\n\n    tabs.forEach((tab, i) => {\n      const active = i === index;\n      tab.setAttribute(\"aria-selected\", String(active));\n      if (rovingTabindex) {\n        tab.setAttribute(\"tabindex\", active ? \"0\" : \"-1\");\n      }\n    });\n\n    panels.forEach((panel, i) => {\n      const visible = i === index;\n      panel.hidden = !visible;\n      // Panels with no focusable children need tabindex=\"0\" so keyboard\n      // users can Tab into the content (WAI-ARIA Tabs pattern).\n      if (visible) {\n        const hasFocusable = panel.querySelector(FOCUSABLE) !== null;\n        if (!hasFocusable) {\n          panel.setAttribute(\"tabindex\", \"0\");\n        } else {\n          panel.removeAttribute(\"tabindex\");\n        }\n      }\n    });\n\n    updateIndicator(index);\n    onActivate?.(index);\n\n    // Compensate scroll position after panel height change (skip on first paint)\n    if (emitSync && !isInitialActivation) {\n      const scrollAfter = container.getBoundingClientRect().top;\n      const delta = scrollAfter - scrollBefore;\n      if (Math.abs(delta) > 1) {\n        window.scrollTo({\n          top: window.scrollY + delta,\n          behavior: \"instant\",\n        });\n      }\n    }\n    isInitialActivation = false;\n\n    if (sync && emitSync) {\n      const label = getLabel(tabs[index]);\n      const store = getStorage(sync.storage === \"session\" ? \"session\" : \"local\");\n      store?.setItem(sync.key, label);\n      window.dispatchEvent(\n        new CustomEvent(\"ui-tab-sync\", {\n          detail: { key: sync.key, label, origin: container },\n        }),\n      );\n    }\n  }\n\n  // Resolve initial index from sync storage\n  let initialIndex = 0;\n  if (sync) {\n    const store = getStorage(sync.storage === \"session\" ? \"session\" : \"local\");\n    const saved = store?.getItem(sync.key);\n    if (saved) {\n      const idx = tabs.findIndex((t) => getLabel(t) === saved);\n      if (idx >= 0) initialIndex = idx;\n    }\n  }\n\n  // Click delegation on tablist\n  function handleClick(e: Event) {\n    const target = (e.target as HTMLElement).closest(tabSelector);\n    if (!target) return;\n    const idx = tabs.indexOf(target as HTMLElement);\n    if (idx >= 0) {\n      activate(idx);\n      if (rovingTabindex) (target as HTMLElement).focus();\n    }\n  }\n\n  // Keyboard navigation (roving tabindex)\n  function handleKeydown(e: KeyboardEvent) {\n    if (!rovingTabindex) return;\n    const ci = tabs.indexOf(e.target as HTMLElement);\n    if (ci < 0) return;\n\n    let next: number;\n    switch (e.key) {\n      case \"ArrowRight\":\n        next = ci + 1;\n        break;\n      case \"ArrowLeft\":\n        next = ci - 1;\n        break;\n      case \"Home\":\n        next = 0;\n        break;\n      case \"End\":\n        next = tabs.length - 1;\n        break;\n      default:\n        return;\n    }\n    // No-wrap: ignore if out of bounds\n    if (!tabs[next]) return;\n    e.preventDefault();\n    activate(next);\n    tabs[next].focus();\n  }\n\n  // Cross-instance sync via CustomEvent\n  function handleSync(e: Event) {\n    const detail = (e as CustomEvent).detail;\n    if (detail.key === sync?.key && detail.origin !== container) {\n      const idx = tabs.findIndex((t) => getLabel(t) === detail.label);\n      if (idx >= 0) activate(idx, { emitSync: false });\n    }\n  }\n\n  // Wire events\n  tablist.addEventListener(\"click\", handleClick);\n  tablist.addEventListener(\"keydown\", handleKeydown as EventListener);\n  if (sync) window.addEventListener(\"ui-tab-sync\", handleSync);\n\n  // Initial activation — skip indicator transition for first paint\n  if (indicator) indicator.style.transition = \"none\";\n  activate(initialIndex);\n  if (indicator) {\n    void indicator.offsetHeight; // force reflow\n    indicator.style.transition = \"\";\n  }\n\n  return {\n    activate,\n    get currentIndex() {\n      return currentIndex;\n    },\n    destroy() {\n      tablist.removeEventListener(\"click\", handleClick);\n      tablist.removeEventListener(\"keydown\", handleKeydown as EventListener);\n      if (sync) window.removeEventListener(\"ui-tab-sync\", handleSync);\n    },\n  };\n}\n","/**\n * scroll-lock.ts — Body scroll lock with scrollbar-width compensation.\n *\n * Prevents background scrolling when a modal/overlay is open.\n * Compensates for the scrollbar disappearing to avoid layout shift\n * (visible on Windows/Linux where scrollbars have width).\n *\n * Uses a data attribute + CSS for the overflow lock, and inline\n * paddingRight for the scrollbar compensation.\n *\n * Used by: Dialog (and any future overlay primitive).\n */\n\nconst ATTR = \"data-scroll-locked\";\n\nlet lockCount = 0;\nlet savedPaddingRight = \"\";\n\nexport function lockScroll(): void {\n  lockCount++;\n  if (lockCount > 1) return;\n\n  const scrollbarW = window.innerWidth - document.documentElement.clientWidth;\n  savedPaddingRight = document.body.style.paddingRight;\n\n  document.body.setAttribute(ATTR, \"\");\n  if (scrollbarW > 0) {\n    document.body.style.paddingRight = `${scrollbarW}px`;\n  }\n}\n\nexport function unlockScroll(): void {\n  if (lockCount === 0) return;\n  lockCount--;\n  if (lockCount > 0) return;\n\n  document.body.removeAttribute(ATTR);\n  document.body.style.paddingRight = savedPaddingRight;\n}\n","/**\n * code-copy.ts — Injects a Nimbus-styled copy button into every Shiki\n * code block rendered by Astro's built-in `<Code>` and fenced\n * code blocks in MDX.\n *\n * Astro emits `<pre class=\"astro-code shiki ...\">` for syntax-highlighted\n * blocks. We attach a copy button positioned in the top-right corner.\n *\n * Page-wide enhancement, not tied to a single component. Call `codeCopy()`\n * once (e.g. from BaseLayout). Uses `mount` for lifecycle so the buttons\n * are torn down on view transitions and re-added against the new DOM.\n *\n * The original code text comes from the `<code>` element's textContent —\n * Shiki's wrapper spans flatten down to the raw source.\n *\n * Code blocks rendered inside [data-cg-row] (CodeGroup) are skipped\n * because CodeGroup brings its own copy button per panel.\n */\n\nimport { mount } from \"./mount\";\n\nconst COPY_ICON = `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M216,32H88a8,8,0,0,0-8,8V80H40a8,8,0,0,0-8,8V216a8,8,0,0,0,8,8H168a8,8,0,0,0,8-8V176h40a8,8,0,0,0,8-8V40A8,8,0,0,0,216,32ZM160,208H48V96H160Zm48-48H176V88a8,8,0,0,0-8-8H96V48H208Z\"/></svg>`;\nconst CHECK_ICON = `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M173.66,98.34a8,8,0,0,1,0,11.32l-56,56a8,8,0,0,1-11.32,0l-24-24a8,8,0,0,1,11.32-11.32L112,148.69l50.34-50.35A8,8,0,0,1,173.66,98.34Z\"/></svg>`;\n\nfunction getCodeText(pre: HTMLElement): string {\n  const codeEl = pre.querySelector<HTMLElement>(\"code\");\n  return codeEl?.textContent ?? pre.textContent ?? \"\";\n}\n\nfunction initCodeCopy(pre: HTMLElement): () => void {\n  // Skip code blocks owned by CodeGroup — that component renders its own\n  // copy button per panel.\n  if (pre.closest(\"[data-cg-row]\")) return () => {};\n\n  const btn = document.createElement(\"button\");\n  btn.type = \"button\";\n  btn.className = \"nb-code-copy\";\n  btn.setAttribute(\"aria-label\", \"Copy code to clipboard\");\n  btn.innerHTML = COPY_ICON;\n\n  let resetTimer: number | undefined;\n\n  async function handleClick() {\n    const text = getCodeText(pre);\n    if (!text) return;\n\n    try {\n      await navigator.clipboard.writeText(text);\n    } catch {\n      return;\n    }\n\n    btn.innerHTML = CHECK_ICON;\n    btn.dataset.state = \"copied\";\n    btn.setAttribute(\"aria-label\", \"Copied!\");\n\n    if (resetTimer) window.clearTimeout(resetTimer);\n    resetTimer = window.setTimeout(() => {\n      btn.innerHTML = COPY_ICON;\n      delete btn.dataset.state;\n      btn.setAttribute(\"aria-label\", \"Copy code to clipboard\");\n    }, 1500);\n  }\n\n  btn.addEventListener(\"click\", handleClick);\n\n  // The button positions absolutely against the <pre>; make sure <pre> is\n  // a positioning context.\n  if (getComputedStyle(pre).position === \"static\") {\n    pre.style.position = \"relative\";\n  }\n  pre.appendChild(btn);\n\n  return () => {\n    if (resetTimer) window.clearTimeout(resetTimer);\n    btn.removeEventListener(\"click\", handleClick);\n    btn.remove();\n  };\n}\n\n/** Wire copy buttons onto all Shiki code blocks on the page. Call once. */\nexport function codeCopy(): void {\n  mount(\"pre.astro-code\", initCodeCopy);\n}\n","/** Add hoverable self-links to markdown headings with ids. */\n\nfunction applyHeadingAnchors() {\n  document.querySelectorAll<HTMLElement>(\".docs-content :is(h2, h3, h4)[id]\").forEach((heading) => {\n    if (heading.hasAttribute(\"data-heading-anchor-ready\")) return;\n    heading.setAttribute(\"data-heading-anchor-ready\", \"true\");\n\n    const link = document.createElement(\"a\");\n    link.href = `#${heading.id}`;\n    link.className = \"heading-anchor\";\n    link.setAttribute(\"aria-label\", `Link to ${heading.textContent?.trim() ?? \"section\"}`);\n    link.textContent = \"#\";\n    heading.appendChild(link);\n  });\n}\n\n/**\n * Add hoverable `#` self-links to all `h2`–`h4` headings in `.docs-content`.\n * Re-runs on `astro:page-load` for View Transitions. Call once (e.g. from\n * BaseLayout).\n */\nexport function headingAnchors(): void {\n  applyHeadingAnchors();\n  document.addEventListener(\"astro:page-load\", applyHeadingAnchors);\n}\n"],"mappings":";AA0BA,SAAgB,MAAM,UAAkB,MAAkB;CACxD,MAAM,4BAAY,IAAI,KAA8B;CAEpD,SAAS,QAAQ;AACf,WAAS,iBAA8B,SAAS,CAAC,SAAS,OAAO;AAC/D,OAAI,UAAU,IAAI,GAAG,CAAE;AACvB,aAAU,IAAI,IAAI,KAAK,GAAG,CAAC;IAC3B;;CAGJ,SAAS,WAAW;AAClB,YAAU,SAAS,YAAY,SAAS,CAAC;AACzC,YAAU,OAAO;;AAKnB,KAAI,SAAS,eAAe,UAC1B,UAAS,iBAAiB,oBAAoB,OAAO,EAAE,MAAM,MAAM,CAAC;KAEpE,QAAO;AAGT,UAAS,iBAAiB,qBAAqB,SAAS;AACxD,UAAS,iBAAiB,mBAAmB,MAAM;;;;;;;;;;;AC3CrD,IAAI,UAAU;AAEd,SAAgB,WAAW,QAAwB;AACjD,YAAW;AACX,QAAO,GAAG,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;AC4BtB,SAAgB,eAAe,MAA6C;CAC1E,MAAM,EAAE,SAAS,SAAS,cAAc,OAAO,iBAAiB;CAEhE,IAAI,OAAO;AAGX,KAAI,CAAC,QAAQ,GACX,SAAQ,KAAK,WAAW,gBAAgB;AAE1C,SAAQ,aAAa,iBAAiB,QAAQ,GAAG;CAEjD,SAAS,YAAY;EACnB,MAAM,QAAQ,OAAO,SAAS;AAC9B,UAAQ,aAAa,iBAAiB,MAAM;AAC5C,UAAQ,aAAa,iBAAiB,MAAM;AAC5C,UAAQ,aAAa,iBAAiB,OAAO,KAAK,CAAC;;CAGrD,SAAS,QAAQ,OAAgB;AAC/B,MAAI,SAAS,MAAO;AACpB,SAAO;AACP,aAAW;AACX,iBAAe,MAAM;;CAGvB,SAAS,YAAY,GAAe;AAClC,IAAE,gBAAgB;AAClB,UAAQ,CAAC,KAAK;;AAGhB,YAAW;AACX,SAAQ,iBAAiB,SAAS,YAAY;AAE9C,QAAO;EACL,OAAO;AACL,WAAQ,KAAK;;EAEf,QAAQ;AACN,WAAQ,MAAM;;EAEhB,SAAS;AACP,WAAQ,CAAC,KAAK;;EAEhB,SAAS;AACP,UAAO;;EAET,UAAU;AACR,WAAQ,oBAAoB,SAAS,YAAY;;EAEpD;;;;;;;;;ACnFH,MAAa,YACX;;;;;;;;;;;;ACiCF,SAAgB,SAAS,QAAkC;CACzD,MAAM,EAAE,WAAW,aAAa,eAAe,YAAY,MAAM,iBAAiB,MAAM,MAAM,eAAe;CAE7G,MAAM,OAAO,MAAM,KAAK,UAAU,iBAA8B,YAAY,CAAC;CAC7E,MAAM,SAAS,MAAM,KAAK,UAAU,iBAA8B,cAAc,CAAC;CACjF,MAAM,UAAU,UAAU,cAAc,iBAAiB,IAAI;CAE7D,IAAI,eAAe;CACnB,IAAI,sBAAsB;CAE1B,SAAS,WAAW,MAA2C;AAC7D,MAAI;AACF,UAAO,SAAS,YAAY,iBAAiB;UACvC;AACN,UAAO;;;CAIX,SAAS,SAAS,KAA0B;AAC1C,SAAO,MAAM,WAAW,IAAI,IAAI,IAAI,aAAa,MAAM,IAAI;;CAG7D,SAAS,gBAAgB,OAAe;AACtC,MAAI,CAAC,aAAa,CAAC,KAAK,OAAQ;AAChC,YAAU,MAAM,OAAO,GAAG,KAAK,OAAO,WAAW;AACjD,YAAU,MAAM,QAAQ,GAAG,KAAK,OAAO,YAAY;;CAGrD,SAAS,SAAS,OAAe,SAAkC;EACjE,MAAM,WAAW,SAAS,YAAY;AACtC,MAAI,UAAU,aAAc;EAI5B,MAAM,eADO,UAAU,uBAAuB,CACpB;AAE1B,iBAAe;AAEf,OAAK,SAAS,KAAK,MAAM;GACvB,MAAM,SAAS,MAAM;AACrB,OAAI,aAAa,iBAAiB,OAAO,OAAO,CAAC;AACjD,OAAI,eACF,KAAI,aAAa,YAAY,SAAS,MAAM,KAAK;IAEnD;AAEF,SAAO,SAAS,OAAO,MAAM;GAC3B,MAAM,UAAU,MAAM;AACtB,SAAM,SAAS,CAAC;AAGhB,OAAI,QAEF,KAAI,EADiB,MAAM,cAAc,UAAU,KAAK,MAEtD,OAAM,aAAa,YAAY,IAAI;OAEnC,OAAM,gBAAgB,WAAW;IAGrC;AAEF,kBAAgB,MAAM;AACtB,eAAa,MAAM;AAGnB,MAAI,YAAY,CAAC,qBAAqB;GAEpC,MAAM,QADc,UAAU,uBAAuB,CAAC,MAC1B;AAC5B,OAAI,KAAK,IAAI,MAAM,GAAG,EACpB,QAAO,SAAS;IACd,KAAK,OAAO,UAAU;IACtB,UAAU;IACX,CAAC;;AAGN,wBAAsB;AAEtB,MAAI,QAAQ,UAAU;GACpB,MAAM,QAAQ,SAAS,KAAK,OAAO;AAEnC,GADc,WAAW,KAAK,YAAY,YAAY,YAAY,QAAQ,EACnE,QAAQ,KAAK,KAAK,MAAM;AAC/B,UAAO,cACL,IAAI,YAAY,eAAe,EAC7B,QAAQ;IAAE,KAAK,KAAK;IAAK;IAAO,QAAQ;IAAW,EACpD,CAAC,CACH;;;CAKL,IAAI,eAAe;AACnB,KAAI,MAAM;EAER,MAAM,QADQ,WAAW,KAAK,YAAY,YAAY,YAAY,QAAQ,EACrD,QAAQ,KAAK,IAAI;AACtC,MAAI,OAAO;GACT,MAAM,MAAM,KAAK,WAAW,MAAM,SAAS,EAAE,KAAK,MAAM;AACxD,OAAI,OAAO,EAAG,gBAAe;;;CAKjC,SAAS,YAAY,GAAU;EAC7B,MAAM,SAAU,EAAE,OAAuB,QAAQ,YAAY;AAC7D,MAAI,CAAC,OAAQ;EACb,MAAM,MAAM,KAAK,QAAQ,OAAsB;AAC/C,MAAI,OAAO,GAAG;AACZ,YAAS,IAAI;AACb,OAAI,eAAgB,CAAC,OAAuB,OAAO;;;CAKvD,SAAS,cAAc,GAAkB;AACvC,MAAI,CAAC,eAAgB;EACrB,MAAM,KAAK,KAAK,QAAQ,EAAE,OAAsB;AAChD,MAAI,KAAK,EAAG;EAEZ,IAAI;AACJ,UAAQ,EAAE,KAAV;GACE,KAAK;AACH,WAAO,KAAK;AACZ;GACF,KAAK;AACH,WAAO,KAAK;AACZ;GACF,KAAK;AACH,WAAO;AACP;GACF,KAAK;AACH,WAAO,KAAK,SAAS;AACrB;GACF,QACE;;AAGJ,MAAI,CAAC,KAAK,MAAO;AACjB,IAAE,gBAAgB;AAClB,WAAS,KAAK;AACd,OAAK,MAAM,OAAO;;CAIpB,SAAS,WAAW,GAAU;EAC5B,MAAM,SAAU,EAAkB;AAClC,MAAI,OAAO,QAAQ,MAAM,OAAO,OAAO,WAAW,WAAW;GAC3D,MAAM,MAAM,KAAK,WAAW,MAAM,SAAS,EAAE,KAAK,OAAO,MAAM;AAC/D,OAAI,OAAO,EAAG,UAAS,KAAK,EAAE,UAAU,OAAO,CAAC;;;AAKpD,SAAQ,iBAAiB,SAAS,YAAY;AAC9C,SAAQ,iBAAiB,WAAW,cAA+B;AACnE,KAAI,KAAM,QAAO,iBAAiB,eAAe,WAAW;AAG5D,KAAI,UAAW,WAAU,MAAM,aAAa;AAC5C,UAAS,aAAa;AACtB,KAAI,WAAW;AACb,EAAK,UAAU;AACf,YAAU,MAAM,aAAa;;AAG/B,QAAO;EACL;EACA,IAAI,eAAe;AACjB,UAAO;;EAET,UAAU;AACR,WAAQ,oBAAoB,SAAS,YAAY;AACjD,WAAQ,oBAAoB,WAAW,cAA+B;AACtE,OAAI,KAAM,QAAO,oBAAoB,eAAe,WAAW;;EAElE;;;;;;;;;;;;;;;;;ACvMH,MAAM,OAAO;AAEb,IAAI,YAAY;AAChB,IAAI,oBAAoB;AAExB,SAAgB,aAAmB;AACjC;AACA,KAAI,YAAY,EAAG;CAEnB,MAAM,aAAa,OAAO,aAAa,SAAS,gBAAgB;AAChE,qBAAoB,SAAS,KAAK,MAAM;AAExC,UAAS,KAAK,aAAa,MAAM,GAAG;AACpC,KAAI,aAAa,EACf,UAAS,KAAK,MAAM,eAAe,GAAG,WAAW;;AAIrD,SAAgB,eAAqB;AACnC,KAAI,cAAc,EAAG;AACrB;AACA,KAAI,YAAY,EAAG;AAEnB,UAAS,KAAK,gBAAgB,KAAK;AACnC,UAAS,KAAK,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;AChBrC,MAAM,YAAY;AAClB,MAAM,aAAa;AAEnB,SAAS,YAAY,KAA0B;AAE7C,QADe,IAAI,cAA2B,OAAO,EACtC,eAAe,IAAI,eAAe;;AAGnD,SAAS,aAAa,KAA8B;AAGlD,KAAI,IAAI,QAAQ,gBAAgB,CAAE,cAAa;CAE/C,MAAM,MAAM,SAAS,cAAc,SAAS;AAC5C,KAAI,OAAO;AACX,KAAI,YAAY;AAChB,KAAI,aAAa,cAAc,yBAAyB;AACxD,KAAI,YAAY;CAEhB,IAAI;CAEJ,eAAe,cAAc;EAC3B,MAAM,OAAO,YAAY,IAAI;AAC7B,MAAI,CAAC,KAAM;AAEX,MAAI;AACF,SAAM,UAAU,UAAU,UAAU,KAAK;UACnC;AACN;;AAGF,MAAI,YAAY;AAChB,MAAI,QAAQ,QAAQ;AACpB,MAAI,aAAa,cAAc,UAAU;AAEzC,MAAI,WAAY,QAAO,aAAa,WAAW;AAC/C,eAAa,OAAO,iBAAiB;AACnC,OAAI,YAAY;AAChB,UAAO,IAAI,QAAQ;AACnB,OAAI,aAAa,cAAc,yBAAyB;KACvD,KAAK;;AAGV,KAAI,iBAAiB,SAAS,YAAY;AAI1C,KAAI,iBAAiB,IAAI,CAAC,aAAa,SACrC,KAAI,MAAM,WAAW;AAEvB,KAAI,YAAY,IAAI;AAEpB,cAAa;AACX,MAAI,WAAY,QAAO,aAAa,WAAW;AAC/C,MAAI,oBAAoB,SAAS,YAAY;AAC7C,MAAI,QAAQ;;;;AAKhB,SAAgB,WAAiB;AAC/B,OAAM,kBAAkB,aAAa;;;;;;AChFvC,SAAS,sBAAsB;AAC7B,UAAS,iBAA8B,oCAAoC,CAAC,SAAS,YAAY;AAC/F,MAAI,QAAQ,aAAa,4BAA4B,CAAE;AACvD,UAAQ,aAAa,6BAA6B,OAAO;EAEzD,MAAM,OAAO,SAAS,cAAc,IAAI;AACxC,OAAK,OAAO,IAAI,QAAQ;AACxB,OAAK,YAAY;AACjB,OAAK,aAAa,cAAc,WAAW,QAAQ,aAAa,MAAM,IAAI,YAAY;AACtF,OAAK,cAAc;AACnB,UAAQ,YAAY,KAAK;GACzB;;;;;;;AAQJ,SAAgB,iBAAuB;AACrC,sBAAqB;AACrB,UAAS,iBAAiB,mBAAmB,oBAAoB"}

package/dist/content.d.ts

@@ -0,0 +1,126 @@
+import { z } from "astro/zod";
+import * as astro_loaders0 from "astro/loaders";
+
+//#region src/content.d.ts
+interface DocsCollectionOptions {
+  /**
+   * Directory under `src/content/` to load docs from.
+   * Default: `"docs"`.
+   */
+  base?: string;
+  /**
+   * Glob pattern relative to `base`.
+   * Default: `"** /*.{md,mdx}"` (space added to avoid breaking this comment).
+   */
+  pattern?: string;
+  /**
+   * Extra fields merged into the default docs schema. Lets users add
+   * project-specific frontmatter (author, tags, etc.) without rebuilding
+   * the whole schema.
+   */
+  schemaFields?: Record<string, z.ZodTypeAny>;
+}
+interface PartialsCollectionOptions {
+  /**
+   * Directory under `src/content/` to load partials from.
+   * Default: `"partials"`.
+   */
+  base?: string;
+  /**
+   * Glob pattern relative to `base`.
+   * Default: `"** /*.{md,mdx}"`.
+   */
+  pattern?: string;
+}
+/**
+ * Returns an Astro content-collection config (`{ loader, schema }`) for the
+ * docs collection. Pass to `defineCollection()`.
+ */
+declare function docsCollection(options?: DocsCollectionOptions): {
+  loader: astro_loaders0.Loader;
+  schema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    template: z.ZodDefault<z.ZodEnum<{
+      doc: "doc";
+      splash: "splash";
+    }>>;
+    sidebar: z.ZodOptional<z.ZodObject<{
+      order: z.ZodOptional<z.ZodNumber>;
+      label: z.ZodOptional<z.ZodString>;
+      badge: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        text: z.ZodString;
+        variant: z.ZodDefault<z.ZodEnum<{
+          success: "success";
+          default: "default";
+          info: "info";
+          note: "note";
+          tip: "tip";
+          warning: "warning";
+          caution: "caution";
+          danger: "danger";
+        }>>;
+      }, z.core.$strip>]>>;
+      hidden: z.ZodOptional<z.ZodBoolean>;
+      hideChildren: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    hero: z.ZodOptional<z.ZodObject<{
+      title: z.ZodOptional<z.ZodString>;
+      tagline: z.ZodOptional<z.ZodString>;
+      actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        link: z.ZodString;
+        variant: z.ZodDefault<z.ZodEnum<{
+          primary: "primary";
+          secondary: "secondary";
+          outline: "outline";
+        }>>;
+        icon: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    head: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      tag: z.ZodEnum<{
+        link: "link";
+        meta: "meta";
+        script: "script";
+        style: "style";
+      }>;
+      attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+      content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    draft: z.ZodDefault<z.ZodBoolean>;
+    noindex: z.ZodDefault<z.ZodBoolean>;
+    llms: z.ZodDefault<z.ZodBoolean>;
+    aiDeprioritize: z.ZodDefault<z.ZodBoolean>;
+    pagefind: z.ZodDefault<z.ZodBoolean>;
+    tableOfContents: z.ZodOptional<z.ZodObject<{
+      minHeadingLevel: z.ZodDefault<z.ZodNumber>;
+      maxHeadingLevel: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    lastUpdated: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    socialImage: z.ZodOptional<z.ZodString>;
+    prev: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      link: z.ZodOptional<z.ZodString>;
+      label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodLiteral<false>]>>;
+    next: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      link: z.ZodOptional<z.ZodString>;
+      label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodLiteral<false>]>>;
+  }, z.core.$strip> | z.ZodObject<{
+    [x: string]: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+  }, z.core.$strip>;
+};
+/**
+ * Returns an Astro content-collection config (`{ loader, schema }`) for the
+ * partials collection. Pass to `defineCollection()`.
+ */
+declare function partialsCollection(options?: PartialsCollectionOptions): {
+  loader: astro_loaders0.Loader;
+  schema: z.ZodDefault<z.ZodObject<{
+    params: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+};
+//#endregion
+export { DocsCollectionOptions, PartialsCollectionOptions, docsCollection, partialsCollection };
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","names":[],"sources":["../src/content.ts"],"mappings":";;;;UAyBiB,qBAAA;EAsCD;;;;EAjCd,IAAA;;;;;EAKA,OAAA;;;;;;EAMA,YAAA,GAAe,MAAA,SAAe,CAAA,CAAE,UAAA;AAAA;AAAA,UAGjB,yBAAA;;;;;EAKf,IAAA;;;;;EAKA,OAAA;AAAA;;;;;iBASc,cAAA,CAAe,OAAA,GAAS,qBAAA;UAA0B,cAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAelD,kBAAA,CAAmB,OAAA,GAAS,yBAAA;UAA8B,cAAA,CAAA,MAAA"}

package/dist/content.js

@@ -0,0 +1,57 @@
+import { defineDocSchema, partialsSchema } from "./schemas.js";
+import { glob } from "astro/loaders";
+
+//#region src/content.ts
+/**
+* Content collection helpers for `nimbus-docs/content`.
+*
+* Users plug these into their `src/content.config.ts`:
+*
+*   import { defineCollection } from "astro:content";
+*   import { docsCollection, partialsCollection } from "nimbus-docs/content";
+*
+*   export const collections = {
+*     docs: defineCollection(docsCollection()),
+*     partials: defineCollection(partialsCollection()),
+*   };
+*
+* Extend the docs schema with extra frontmatter fields:
+*
+*   docs: defineCollection(docsCollection({
+*     schemaFields: { author: z.string(), tags: z.array(z.string()) },
+*   })),
+*/
+const DEFAULT_PATTERN = "**/*.{md,mdx}";
+/**
+* Returns an Astro content-collection config (`{ loader, schema }`) for the
+* docs collection. Pass to `defineCollection()`.
+*/
+function docsCollection(options = {}) {
+	const base = `./src/content/${options.base ?? "docs"}`;
+	const pattern = options.pattern ?? DEFAULT_PATTERN;
+	const schema = defineDocSchema({ fields: options.schemaFields });
+	return {
+		loader: glob({
+			base,
+			pattern
+		}),
+		schema
+	};
+}
+/**
+* Returns an Astro content-collection config (`{ loader, schema }`) for the
+* partials collection. Pass to `defineCollection()`.
+*/
+function partialsCollection(options = {}) {
+	return {
+		loader: glob({
+			base: `./src/content/${options.base ?? "partials"}`,
+			pattern: options.pattern ?? DEFAULT_PATTERN
+		}),
+		schema: partialsSchema
+	};
+}
+
+//#endregion
+export { docsCollection, partialsCollection };
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","names":[],"sources":["../src/content.ts"],"sourcesContent":["/**\n * Content collection helpers for `nimbus-docs/content`.\n *\n * Users plug these into their `src/content.config.ts`:\n *\n *   import { defineCollection } from \"astro:content\";\n *   import { docsCollection, partialsCollection } from \"nimbus-docs/content\";\n *\n *   export const collections = {\n *     docs: defineCollection(docsCollection()),\n *     partials: defineCollection(partialsCollection()),\n *   };\n *\n * Extend the docs schema with extra frontmatter fields:\n *\n *   docs: defineCollection(docsCollection({\n *     schemaFields: { author: z.string(), tags: z.array(z.string()) },\n *   })),\n */\n\nimport { glob } from \"astro/loaders\";\nimport type { z } from \"astro/zod\";\n\nimport { defineDocSchema, partialsSchema } from \"./schemas.js\";\n\nexport interface DocsCollectionOptions {\n  /**\n   * Directory under `src/content/` to load docs from.\n   * Default: `\"docs\"`.\n   */\n  base?: string;\n  /**\n   * Glob pattern relative to `base`.\n   * Default: `\"** /*.{md,mdx}\"` (space added to avoid breaking this comment).\n   */\n  pattern?: string;\n  /**\n   * Extra fields merged into the default docs schema. Lets users add\n   * project-specific frontmatter (author, tags, etc.) without rebuilding\n   * the whole schema.\n   */\n  schemaFields?: Record<string, z.ZodTypeAny>;\n}\n\nexport interface PartialsCollectionOptions {\n  /**\n   * Directory under `src/content/` to load partials from.\n   * Default: `\"partials\"`.\n   */\n  base?: string;\n  /**\n   * Glob pattern relative to `base`.\n   * Default: `\"** /*.{md,mdx}\"`.\n   */\n  pattern?: string;\n}\n\nconst DEFAULT_PATTERN = \"**/*.{md,mdx}\";\n\n/**\n * Returns an Astro content-collection config (`{ loader, schema }`) for the\n * docs collection. Pass to `defineCollection()`.\n */\nexport function docsCollection(options: DocsCollectionOptions = {}) {\n  const base = `./src/content/${options.base ?? \"docs\"}`;\n  const pattern = options.pattern ?? DEFAULT_PATTERN;\n  const schema = defineDocSchema({ fields: options.schemaFields });\n\n  return {\n    loader: glob({ base, pattern }),\n    schema,\n  };\n}\n\n/**\n * Returns an Astro content-collection config (`{ loader, schema }`) for the\n * partials collection. Pass to `defineCollection()`.\n */\nexport function partialsCollection(options: PartialsCollectionOptions = {}) {\n  const base = `./src/content/${options.base ?? \"partials\"}`;\n  const pattern = options.pattern ?? DEFAULT_PATTERN;\n\n  return {\n    loader: glob({ base, pattern }),\n    schema: partialsSchema,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyDA,MAAM,kBAAkB;;;;;AAMxB,SAAgB,eAAe,UAAiC,EAAE,EAAE;CAClE,MAAM,OAAO,iBAAiB,QAAQ,QAAQ;CAC9C,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,SAAS,gBAAgB,EAAE,QAAQ,QAAQ,cAAc,CAAC;AAEhE,QAAO;EACL,QAAQ,KAAK;GAAE;GAAM;GAAS,CAAC;EAC/B;EACD;;;;;;AAOH,SAAgB,mBAAmB,UAAqC,EAAE,EAAE;AAI1E,QAAO;EACL,QAAQ,KAAK;GAAE,MAJJ,iBAAiB,QAAQ,QAAQ;GAIvB,SAHP,QAAQ,WAAW;GAGH,CAAC;EAC/B,QAAQ;EACT"}

package/dist/index.d.ts

@@ -0,0 +1,255 @@
+import { BadgeVariant, Breadcrumb, NimbusConfig, PrevNext, PrevNextLink, PrevNextOverrides, SearchProvider, SearchResult, SidebarBadge, SidebarConfig, SidebarConfigItem, SidebarExternalLinkItem, SidebarGroupItem, SidebarItem, SidebarLinkItem, SidebarSection, TOCItem } from "./types.js";
+import mdx from "@astrojs/mdx";
+import * as astro_content0 from "astro:content";
+import { CollectionEntry } from "astro:content";
+import { AstroGlobal, AstroIntegration, GetStaticPaths } from "astro";
+import { ShikiTransformer } from "shiki";
+
+//#region src/_internal/content.d.ts
+/**
+ * Return visible entries from one or more collections. Drafts are
+ * filtered out in production builds (matching the existing
+ * single-collection behaviour).
+ *
+ * Defaults to `["docs"]` — the framework's primary collection.
+ * Cross-collection callers (llms.txt aggregators, custom indexes,
+ * etc.) pass an explicit list.
+ *
+ * Returns a flat `CollectionEntry<string>[]` so cross-collection
+ * traversal doesn't need to know the user's collection names at type
+ * time. Callers that need per-collection type safety should call
+ * `getCollection("api")` directly.
+ */
+declare function getVisibleEntries(collections?: string[]): Promise<CollectionEntry<string>[]>;
+//#endregion
+//#region src/_internal/sidebar.d.ts
+/** Hash the sidebar structure into a short string for sessionStorage invalidation. */
+declare function sidebarHash(items: SidebarItem[]): string;
+//#endregion
+//#region src/_internal/transform.d.ts
+/**
+ * MDX → markdown transform for AI-readable static routes.
+ *
+ * This intentionally starts small and dependency-free: it operates on the
+ * raw MDX body that Astro's content layer exposes and maps the starter's
+ * default components to plain markdown equivalents. The route that calls this
+ * lives in user code, so replacing or bypassing this transformer is a one-line
+ * edit.
+ */
+interface MarkdownComponentRenderContext {
+  name: string;
+  attrs: Record<string, string | boolean>;
+  children: string;
+}
+type MarkdownComponentRenderer = (context: MarkdownComponentRenderContext) => string;
+interface RenderEntryAsMarkdownOptions {
+  /**
+   * Override how specific MDX components are rendered. Keys are component
+   * names (e.g. `Aside`, `Tabs`, `PackageManagers`).
+   */
+  componentMap?: Record<string, MarkdownComponentRenderer>;
+  /** Strip YAML frontmatter if the raw body includes it. Default: true. */
+  stripFrontmatter?: boolean;
+}
+interface MarkdownEntry {
+  body?: string;
+}
+/**
+ * Render an Astro content entry's raw MDX body as plain markdown.
+ *
+ * This handles the starter's default MDX components. Users can pass a
+ * `componentMap` to override individual component renderers or replace this
+ * function entirely from their user-owned `.md` route.
+ */
+declare function renderEntryAsMarkdown(entry: MarkdownEntry, options?: RenderEntryAsMarkdownOptions): string;
+//#endregion
+//#region src/integration.d.ts
+interface NimbusIntegrationOptions {
+  /** MDX options forwarded to `@astrojs/mdx`. */
+  mdx?: Parameters<typeof mdx>[0];
+  /** Skip sitemap integration. Default: enabled when `site.url` is set. */
+  sitemap?: boolean;
+  /**
+   * Build-time MDX PascalCase tag validation.
+   *
+   *   - `true` (default): parse `src/components.ts` for the globals
+   *     registry and fail the build on unknown PascalCase tags found
+   *     in `src/content/**\/*.mdx`.
+   *   - `false`: skip validation entirely.
+   *   - `{ componentsPath }`: override the registry file location.
+   *     Relative paths resolve to the project root.
+   *   - `{ contentDirs }`: override the scanned directories. Relative
+   *     paths resolve to the project root. Default: `["src/content"]`.
+   *   - `{ skip }`: filter out files (e.g. vendored or generated MDX).
+   *
+   * Runs as a pre-build content pass rather than as a remark plugin so
+   * it works regardless of which markdown processor is wired into
+   * `markdown.processor`. Sätteri (the default) replaces unified's
+   * pipeline, which silently disables remark plugins attached via
+   * `mdx({ remarkPlugins })`.
+   */
+  validateMdx?: boolean | {
+    componentsPath?: string;
+    contentDirs?: string[];
+    skip?: (filePath: string) => boolean;
+  };
+}
+declare function nimbus(rawConfig: NimbusConfig, options?: NimbusIntegrationOptions): AstroIntegration;
+//#endregion
+//#region src/_internal/code-transformers.d.ts
+/**
+ * The canonical Shiki transformer chain for Nimbus. Returns a fresh
+ * array each call so callers don't accidentally mutate a shared list.
+ *
+ * Used by:
+ *   - `integration.ts` → `shikiConfig.transformers` (fenced MDX blocks)
+ *   - `Code.astro` in the starter → `transformers` prop on Astro's
+ *     built-in `<Code>` component (and by extension, anything that
+ *     composes `<Code>` such as `<CodeGroup>`)
+ */
+declare function defaultCodeTransformers(): ShikiTransformer[];
+//#endregion
+//#region src/index.d.ts
+/**
+ * Define a typed Nimbus config. Returns the config unchanged but inferred.
+ */
+declare function defineConfig<T extends NimbusConfig>(config: T): T;
+/**
+ * Build the sidebar tree for the given current path, scoped to the
+ * top-level section containing that page.
+ *
+ * Reads `sidebar` from the user's nimbus.config. If `sidebar.items` is set,
+ * resolves config-driven sidebar. Otherwise auto-generates from filesystem
+ * (i.e. the `docs` collection's entry IDs).
+ *
+ * The returned tree is always scoped: only the current section's children
+ * are returned. To enumerate every top-level section (for header tabs or
+ * a section switcher), use `getSidebarSections`.
+ *
+ * @param currentSlug - The current page's URL path (e.g. "/getting-started").
+ *                     Used to set `isCurrent` on matching links and to pick
+ *                     which top-level section to surface.
+ */
+declare function getSidebar(currentSlug: string): Promise<SidebarItem[]>;
+/**
+ * Derive one section per top-level group in the sidebar — used by
+ * `Header.astro` to render the section tab strip (and by any other
+ * cross-section navigation).
+ *
+ * Reads the un-scoped tree so every section is visible, then collapses
+ * each top-level group to `{ label, href, isActive }`.
+ */
+declare function getSidebarSections(currentSlug: string): Promise<SidebarSection[]>;
+/**
+ * Resolve prev/next links for the current page.
+ *
+ * Walks the flattened sidebar; returns the surrounding entries. Honors
+ * `prev`/`next` frontmatter overrides if provided.
+ */
+declare function getPrevNext(currentSlug: string, options?: {
+  overrides?: PrevNextOverrides;
+  sidebarTree?: SidebarItem[];
+}): Promise<PrevNext>;
+/**
+ * Build breadcrumb trail from "/" to the current page.
+ *
+ * Phase 5: simple URL-segment derivation. Later phases may enrich with
+ * sidebar-aware labels.
+ */
+declare function getBreadcrumbs(currentSlug: string, options?: {
+  homeLabel?: string;
+}): Promise<Breadcrumb[]>;
+/**
+ * Build an edit URL for a content entry using `config.editPattern`.
+ *
+ * `{path}` is replaced with the entry's source path when Astro provides it,
+ * falling back to the default docs collection path convention.
+ */
+declare function getEditUrl(entry: {
+  id: string;
+  filePath?: string;
+}): Promise<string | undefined>;
+/**
+ * Resolve a content entry's `lastUpdated` date from `git log`.
+ *
+ * Reads the author date (`%aI`) of the most recent commit that touched
+ * the entry's source file. Author date is stable across rebases — the
+ * value reflects when the content was actually changed, not when the
+ * commit happened to land in this branch.
+ *
+ * Returns `undefined` when git can't answer (no `.git`, shallow clone,
+ * file untracked, command not on PATH, etc.) so the caller can chain a
+ * fallback:
+ *
+ *   const lastUpdated = entry.data.lastUpdated ?? await getLastUpdated(entry);
+ *
+ * Frontmatter always wins. Per-process cached so repeated calls for
+ * the same entry don't re-spawn `git`.
+ *
+ * Production note: most CI/CD systems do shallow clones by default
+ * (Vercel, Cloudflare Pages, GitHub Actions checkout@v4) — set
+ * `fetch-depth: 0` to make full history available, otherwise git
+ * returns nothing and the helper falls back to frontmatter or nothing.
+ */
+declare function getLastUpdated(entry: {
+  id: string;
+  filePath?: string;
+}): Promise<Date | undefined>;
+/**
+ * Filter heading list to the configured min/max heading levels.
+ *
+ * @param headings - Raw `headings` from Astro's `render(entry)` return value.
+ * @param options - Override min/max heading levels. Defaults: min=2, max=3.
+ */
+declare function getTOC(headings: {
+  depth: number;
+  text: string;
+  slug: string;
+}[], options?: {
+  minHeadingLevel?: number;
+  maxHeadingLevel?: number;
+}): TOCItem[];
+/**
+ * `getStaticPaths` implementation for a docs catch-all route.
+ *
+ * Returns one path per visible entry in the `docs` collection. Drafts are
+ * filtered in production. Each path passes `{ entry }` as props so the
+ * page component can access it via `getDocsPageProps(Astro)`.
+ *
+ * Usage:
+ *
+ *   // src/pages/[...slug].astro
+ *   export const prerender = true;
+ *   export const getStaticPaths = getDocsStaticPaths;
+ *
+ * The entry's `id` is used verbatim as the slug. So `docs/index.mdx` →
+ * `/index`, `docs/guides/setup.mdx` → `/guides/setup`. If you want a docs
+ * entry at the root URL, name it appropriately and decide whether to use
+ * a static `pages/index.astro` or let the catch-all handle root.
+ */
+declare const getDocsStaticPaths: GetStaticPaths;
+/**
+ * Read the current entry from `Astro.props`, render it, and return the
+ * pieces a docs page needs: the typed entry, the renderable `<Content />`
+ * component, and the headings list (for TOC generation).
+ *
+ * Pass the page's `Astro` global. Throws if `Astro.props.entry` is missing,
+ * which indicates the page didn't wire `getDocsStaticPaths` (or a custom
+ * equivalent) correctly.
+ *
+ * Usage:
+ *
+ *   const { entry, Content, headings } = await getDocsPageProps(Astro);
+ */
+declare function getDocsPageProps(astro: AstroGlobal): Promise<{
+  entry: astro_content0.CollectionEntry<"docs">;
+  Content: unknown;
+  headings: {
+    depth: number;
+    text: string;
+    slug: string;
+  }[];
+}>;
+//#endregion
+export { type BadgeVariant, type Breadcrumb, type NimbusConfig, type NimbusIntegrationOptions, type PrevNext, type PrevNextLink, type PrevNextOverrides, type SearchProvider, type SearchResult, type SidebarBadge, type SidebarConfig, type SidebarConfigItem, type SidebarExternalLinkItem, type SidebarGroupItem, type SidebarItem, type SidebarLinkItem, type SidebarSection, type TOCItem, nimbus as default, defaultCodeTransformers, defineConfig, getBreadcrumbs, getDocsPageProps, getDocsStaticPaths, getEditUrl, getLastUpdated, getPrevNext, getSidebar, getSidebarSections, getTOC, getVisibleEntries, renderEntryAsMarkdown, sidebarHash };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/_internal/content.ts","../src/_internal/sidebar.ts","../src/_internal/transform.ts","../src/integration.ts","../src/_internal/code-transformers.ts","../src/index.ts"],"mappings":";;;;;;;;;;;;;ACqoBA;;;;;;;;AC3nBA;iBFwBsB,iBAAA,CACpB,WAAA,cACC,OAAA,CAAQ,eAAA;;;;iBCimBK,WAAA,CAAY,KAAA,EAAO,WAAA;;;;;;;;;;;ADnmBnC;UExBiB,8BAAA;EACf,IAAA;EACA,KAAA,EAAO,MAAA;EACP,QAAA;AAAA;AAAA,KAGU,yBAAA,IACV,OAAA,EAAS,8BAAA;AAAA,UAGM,4BAAA;EFgBS;;;;EEXxB,YAAA,GAAe,MAAA,SAAe,yBAAA;ED4mBL;EC1mBzB,gBAAA;AAAA;AAAA,UAGQ,aAAA;EACR,IAAA;AAAA;;AArBF;;;;;;iBAiNgB,qBAAA,CACd,KAAA,EAAO,aAAA,EACP,OAAA,GAAS,4BAAA;;;UC7KM,wBAAA;EDpCR;ECsCP,GAAA,GAAM,UAAA,QAAkB,GAAA;EDrChB;ECuCR,OAAA;EDpCU;;;;;AAIZ;;;;;;;;;;AAQC;;;;EC4CC,WAAA;IAGM,cAAA;IACA,WAAA;IACA,IAAA,IAAQ,QAAA;EAAA;AAAA;AAAA,iBAIA,MAAA,CACd,SAAA,EAAW,YAAA,EACX,OAAA,GAAS,wBAAA,GACR,gBAAA;;;AFijBH;;;;;;;;AC3nBA;;AD2nBA,iBGjlBgB,uBAAA,CAAA,GAA2B,gBAAA;;;;;AHilB3C;iBI9jBgB,YAAA,WAAuB,YAAA,CAAA,CAAc,MAAA,EAAQ,CAAA,GAAI,CAAA;;;;;;;;;AH3ChE;;;;;AA+LD;;;iBGjGsB,UAAA,CAAW,WAAA,WAAsB,OAAA,CAAQ,WAAA;;;;;;;;;iBAazC,kBAAA,CAAmB,WAAA,WAAsB,OAAA,CAAQ,cAAA;AFvFvE;;;;;;AAAA,iBEyHsB,WAAA,CACpB,WAAA,UACA,OAAA;EACE,SAAA,GAAY,iBAAA;EACZ,WAAA,GAAc,WAAA;AAAA,IAEf,OAAA,CAAQ,QAAA;;;;;;AF9FX;iBEyGsB,cAAA,CACpB,WAAA,UACA,OAAA;EAAY,SAAA;AAAA,IACX,OAAA,CAAQ,UAAA;;;;;;;iBAUW,UAAA,CAAW,KAAA;EAC/B,EAAA;EACA,QAAA;AAAA,IACE,OAAA;;;;;ADtJJ;;;;;;;;ACmBA;;;;;;;;;;iBAiKsB,cAAA,CAAe,KAAA;EACnC,EAAA;EACA,QAAA;AAAA,IACE,OAAA,CAAQ,IAAA;;AAjHZ;;;;;iBA4HgB,MAAA,CACd,QAAA;EAAY,KAAA;EAAe,IAAA;EAAc,IAAA;AAAA,KACzC,OAAA;EAAY,eAAA;EAA0B,eAAA;AAAA,IACrC,OAAA;;;;;AAhFH;;;;;;;;;;;;;;cA4Ga,kBAAA,EAAoB,cAAA;;;;;AA3FjC;;;;;;;;;iBAmHsB,gBAAA,CAAiB,KAAA,EAAO,WAAA,GAAc,OAAA;EAC1D,KAAA,EADuD,cAAA,CACxB,eAAA;EAC/B,OAAA;EACA,QAAA;IAAY,KAAA;IAAe,IAAA;IAAc,IAAA;EAAA;AAAA"}