@geenius/docs 0.1.0 → 0.4.0

package/packages/shared/dist/index.js

@@ -0,0 +1,788 @@
+import { GeeniusError, ErrorCode } from '@geenius/tools/errors';
+import matter from 'gray-matter';
+
+// src/config.ts
+var DocsError = class _DocsError extends GeeniusError {
+  constructor(options) {
+    super(options);
+    this.name = "DocsError";
+    Object.setPrototypeOf(this, _DocsError.prototype);
+  }
+};
+var DocsConfigurationError = class _DocsConfigurationError extends DocsError {
+  constructor(options) {
+    super({
+      ...options,
+      code: options.code ?? ErrorCode.INVALID_CONFIG
+    });
+    this.name = "DocsConfigurationError";
+    Object.setPrototypeOf(this, _DocsConfigurationError.prototype);
+  }
+};
+var DocsProviderError = class _DocsProviderError extends DocsError {
+  constructor(options) {
+    super({
+      ...options,
+      code: options.code ?? ErrorCode.INTERNAL_ERROR
+    });
+    this.name = "DocsProviderError";
+    Object.setPrototypeOf(this, _DocsProviderError.prototype);
+  }
+};
+
+// src/config.ts
+var _config = null;
+function configureDocs(config) {
+  _config = config;
+}
+function getDocsConfig() {
+  if (!_config) {
+    throw new DocsConfigurationError({
+      code: ErrorCode.MISSING_CONFIG,
+      message: "Docs not configured. Call configureDocs() first.",
+      context: { function: "getDocsConfig" }
+    });
+  }
+  return _config;
+}
+function isDocsConfigured() {
+  return _config !== null;
+}
+function resetDocsConfig() {
+  _config = null;
+}
+function defineDocsConfig(overrides) {
+  return {
+    baseUrl: "/docs",
+    defaultAccess: "public",
+    versionsEnabled: false,
+    cmdKEnabled: true,
+    showReadingTime: true,
+    showLastEdited: true,
+    printModeEnabled: true,
+    ...overrides
+  };
+}
+function mergeDocsConfig(base, overrides) {
+  return {
+    ...base,
+    ...overrides
+  };
+}
+
+// src/utilities.ts
+function toTocLevel(level) {
+  if (level === 2 || level === 3 || level === 4) {
+    return level;
+  }
+  return 4;
+}
+function extractToc(mdxContent) {
+  const headingRegex = /^(#{2,4})\s+(.+)$/gm;
+  const items = [];
+  let match = headingRegex.exec(mdxContent);
+  while (match !== null) {
+    const text = match[2].trim();
+    items.push({
+      id: slugify(text),
+      text,
+      level: toTocLevel(match[1].length),
+      children: []
+    });
+    match = headingRegex.exec(mdxContent);
+  }
+  const nested = [];
+  let currentH2 = null;
+  let currentH3 = null;
+  for (const item of items) {
+    if (item.level === 2) {
+      currentH2 = item;
+      currentH3 = null;
+      nested.push(item);
+      continue;
+    }
+    if (item.level === 3) {
+      currentH3 = item;
+      if (currentH2) {
+        currentH2.children.push(item);
+      } else {
+        nested.push(item);
+      }
+      continue;
+    }
+    if (currentH3) {
+      currentH3.children.push(item);
+    } else if (currentH2) {
+      currentH2.children.push(item);
+    } else {
+      nested.push(item);
+    }
+  }
+  return nested;
+}
+function calcWordCount(content) {
+  const stripped = content.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "").replace(/!\[.*?\]\(.*?\)/g, "").replace(/\[([^\]]+)\]\(.*?\)/g, "$1").replace(/[#*_~>|-]/g, "").trim();
+  const words = stripped.split(/\s+/).filter(Boolean);
+  return {
+    wordCount: words.length,
+    readingTime: Math.max(1, Math.ceil(words.length / 225))
+  };
+}
+function buildBreadcrumbs(sections, sectionId, slug) {
+  const crumbs = [{ title: "Docs", href: "/docs" }];
+  const sectionMap = new Map(sections.map((section) => [section.id, section]));
+  const trail = [];
+  let current = sectionMap.get(sectionId);
+  while (current) {
+    trail.unshift(current);
+    current = current.parentId ? sectionMap.get(current.parentId) : void 0;
+  }
+  for (const section of trail) {
+    crumbs.push({ title: section.title, href: `/docs/${section.slug}` });
+  }
+  if (slug) {
+    const parentSlug = trail[trail.length - 1]?.slug ?? "";
+    crumbs.push({ title: slug, href: `/docs/${parentSlug}/${slug}` });
+  }
+  return crumbs;
+}
+function buildDocsIndex(pages, sections) {
+  const sectionMap = new Map(sections.map((section) => [section.id, section]));
+  return pages.filter((page) => page.status === "published").map((page) => {
+    const section = sectionMap.get(page.sectionId);
+    return {
+      pageId: page.id,
+      pageTitle: page.title,
+      sectionTitle: section?.title ?? "",
+      sectionSlug: section?.slug ?? "",
+      slug: page.slug,
+      highlight: page.excerpt ?? page.content.slice(0, 160),
+      score: 0,
+      tags: page.tags
+    };
+  });
+}
+function searchDocs(query, index) {
+  if (!query.trim()) {
+    return [];
+  }
+  const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+  return index.map((entry) => {
+    let score = 0;
+    const titleLower = entry.pageTitle.toLowerCase();
+    const highlightLower = entry.highlight.toLowerCase();
+    const sectionLower = entry.sectionTitle.toLowerCase();
+    const tagsLower = entry.tags.map((tag) => tag.toLowerCase());
+    for (const term of terms) {
+      if (titleLower.includes(term)) {
+        score += 10;
+      }
+      if (tagsLower.some((tag) => tag.includes(term))) {
+        score += 5;
+      }
+      if (sectionLower.includes(term)) {
+        score += 3;
+      }
+      if (highlightLower.includes(term)) {
+        score += 2;
+      }
+    }
+    return { ...entry, score };
+  }).filter((entry) => entry.score > 0).sort((left, right) => right.score - left.score).slice(0, 20);
+}
+function slugify(title) {
+  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+}
+function highlightMatch(text, query, maxLen = 160) {
+  if (!query.trim()) {
+    return text.slice(0, maxLen);
+  }
+  const lowerText = text.toLowerCase();
+  const lowerQuery = query.toLowerCase();
+  const index = lowerText.indexOf(lowerQuery);
+  if (index === -1) {
+    return text.slice(0, maxLen);
+  }
+  const start = Math.max(0, index - 40);
+  const end = Math.min(text.length, index + query.length + (maxLen - 80));
+  let snippet = text.slice(start, end);
+  if (start > 0) {
+    snippet = `\u2026${snippet}`;
+  }
+  if (end < text.length) {
+    snippet = `${snippet}\u2026`;
+  }
+  return snippet;
+}
+var defaultDocsConfig = {
+  siteName: "Docs",
+  cmdKEnabled: true,
+  showReadingTime: true,
+  showLastEdited: true,
+  versionsEnabled: false,
+  defaultAccess: "public",
+  printModeEnabled: true
+};
+
+// src/providers/astro.ts
+function sectionTitle(sectionId) {
+  return sectionId.split(/[-_/]/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || "General";
+}
+function asString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function asNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string") {
+    const parsed = Number.parseInt(value, 10);
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return 0;
+}
+function asAccess(value) {
+  if (value === "team" || value === "admin") {
+    return value;
+  }
+  return "public";
+}
+function asStatus(value) {
+  if (value === "draft" || value === "archived") {
+    return value;
+  }
+  return "published";
+}
+function asTags(value) {
+  if (Array.isArray(value)) {
+    return value.filter((entry) => typeof entry === "string");
+  }
+  if (typeof value === "string") {
+    return value.split(",").map((entry) => entry.trim()).filter(Boolean);
+  }
+  return [];
+}
+function createSidebar(pages) {
+  const sections = /* @__PURE__ */ new Map();
+  for (const page of pages.filter((entry) => entry.status === "published")) {
+    const title = sectionTitle(page.sectionId);
+    const existing = sections.get(page.sectionId) ?? {
+      id: page.sectionId,
+      title,
+      slug: slugify(title),
+      pages: []
+    };
+    existing.pages.push({ slug: page.slug, title: page.title });
+    sections.set(page.sectionId, existing);
+  }
+  return [...sections.values()];
+}
+var AstroDocsProvider = class {
+  pages = [];
+  /**
+   * Loads docs from an Astro-style `import.meta.glob()` result.
+   *
+   * @param globResult - Lazy or eager Astro content loaders keyed by path.
+   * @returns Nothing. The provider page set is replaced in memory.
+   */
+  async loadFromGlob(globResult) {
+    const parsed = await Promise.all(
+      Object.entries(globResult).map(async ([path, loader]) => {
+        const raw = typeof loader === "function" ? await loader() : loader;
+        return this.parseDoc(path, raw);
+      })
+    );
+    this.pages = this.linkPages(parsed);
+  }
+  /**
+   * Loads docs from already-read file contents.
+   *
+   * @param files - File path and content pairs to normalise.
+   * @returns Nothing. The provider page set is replaced in memory.
+   */
+  async loadFromFiles(files) {
+    this.pages = this.linkPages(
+      files.map((file) => this.parseDoc(file.path, file.content))
+    );
+  }
+  parseDoc(path, raw) {
+    const parsed = matter(raw);
+    const pathParts = path.replace(/.*content\/docs\//, "").replace(/\.(mdx?|md)$/, "").split("/").filter(Boolean);
+    const slug = pathParts.join("/");
+    const sectionId = pathParts[0] ?? "general";
+    const titleFromPath = pathParts[pathParts.length - 1] ?? slug;
+    const { wordCount, readingTime } = calcWordCount(parsed.content);
+    const authorName = asString(parsed.data.author) ?? "Geenius";
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const status = parsed.data.draft === true ? "draft" : asStatus(parsed.data.status);
+    return {
+      id: asString(parsed.data.id) ?? slug,
+      title: asString(parsed.data.title) ?? sectionTitle(titleFromPath),
+      slug,
+      content: parsed.content,
+      excerpt: asString(parsed.data.description),
+      sectionId,
+      order: asNumber(parsed.data.order),
+      author: {
+        name: authorName,
+        avatar: asString(parsed.data.avatar)
+      },
+      lastEditedBy: asString(parsed.data.lastEditedBy) ? {
+        name: asString(parsed.data.lastEditedBy) ?? authorName,
+        editedAt: asString(parsed.data.lastEditedAt) ?? now
+      } : void 0,
+      version: asString(parsed.data.version),
+      access: asAccess(parsed.data.access),
+      tags: asTags(parsed.data.tags),
+      status,
+      createdAt: asString(parsed.data.createdAt) ?? now,
+      updatedAt: asString(parsed.data.updatedAt) ?? now,
+      wordCount,
+      readingTime,
+      viewCount: asNumber(parsed.data.viewCount)
+    };
+  }
+  linkPages(pages) {
+    const sorted = [...pages].sort((left, right) => left.order - right.order);
+    return sorted.map((page, index) => {
+      const prev = sorted[index - 1];
+      const next = sorted[index + 1];
+      const prevLink = prev ? { slug: prev.slug, title: prev.title } : null;
+      const nextLink = next ? { slug: next.slug, title: next.title } : null;
+      return {
+        ...page,
+        prev: prevLink,
+        next: nextLink,
+        toc: extractToc(page.content)
+      };
+    });
+  }
+  /**
+   * Loads the sidebar structure derived from the parsed Astro pages.
+   *
+   * @returns Sidebar navigation entries derived from the published pages.
+   */
+  async getSidebar() {
+    return createSidebar(this.pages);
+  }
+  /**
+   * Resolves a linked docs page by slug.
+   *
+   * @param slug - Target page slug.
+   * @returns The linked page or `null` when no page matches the slug.
+   */
+  async getPage(slug) {
+    return this.pages.find((page) => page.slug === slug) ?? null;
+  }
+  /**
+   * Returns all published pages managed by the provider.
+   *
+   * @returns Published pages in their linked navigation order.
+   */
+  async getAllPages() {
+    return this.pages.filter((page) => page.status === "published");
+  }
+  /**
+   * Searches the parsed Astro page set.
+   *
+   * @param query - User-entered search query.
+   * @returns Ranked search results derived from the published pages.
+   */
+  async search(query) {
+    const normalizedQuery = query.trim().toLowerCase();
+    if (!normalizedQuery) {
+      return [];
+    }
+    return this.pages.filter((page) => page.status === "published").map((page) => {
+      let score = 0;
+      if (page.title.toLowerCase().includes(normalizedQuery)) {
+        score += 10;
+      }
+      if (page.tags.some((tag) => tag.toLowerCase().includes(normalizedQuery))) {
+        score += 4;
+      }
+      if (page.content.toLowerCase().includes(normalizedQuery)) {
+        score += 2;
+      }
+      if (score === 0) {
+        return null;
+      }
+      return {
+        pageId: page.id,
+        pageTitle: page.title,
+        sectionTitle: sectionTitle(page.sectionId),
+        slug: page.slug,
+        highlight: highlightMatch(page.excerpt ?? page.content, query),
+        score
+      };
+    }).filter((result) => result !== null).sort((left, right) => right.score - left.score);
+  }
+  /**
+   * Resolves previous and next pages for a slug.
+   *
+   * @param slug - Target page slug.
+   * @returns Linked previous and next page records when available.
+   */
+  async getNavigation(slug) {
+    const page = this.pages.find((entry) => entry.slug === slug);
+    if (!page) {
+      return { prev: null, next: null };
+    }
+    return {
+      prev: page.prev ? this.pages.find((entry) => entry.slug === page.prev?.slug) ?? null : null,
+      next: page.next ? this.pages.find((entry) => entry.slug === page.next?.slug) ?? null : null
+    };
+  }
+};
+
+// src/providers/fumadocs.ts
+function sectionTitle2(sectionId) {
+  return sectionId.split(/[-_/]/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || "General";
+}
+function asString2(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function asAccess2(value) {
+  if (value === "team" || value === "admin") {
+    return value;
+  }
+  return "public";
+}
+function asStatus2(value) {
+  if (value === "draft" || value === "archived") {
+    return value;
+  }
+  return "published";
+}
+function asTags2(value) {
+  if (Array.isArray(value)) {
+    return value.filter((entry) => typeof entry === "string");
+  }
+  if (typeof value === "string") {
+    return value.split(",").map((entry) => entry.trim()).filter(Boolean);
+  }
+  return [];
+}
+function createSidebar2(pages) {
+  const sections = /* @__PURE__ */ new Map();
+  for (const page of pages.filter((entry) => entry.status === "published")) {
+    const title = sectionTitle2(page.sectionId);
+    const existing = sections.get(page.sectionId) ?? {
+      id: page.sectionId,
+      title,
+      slug: slugify(title),
+      pages: []
+    };
+    existing.pages.push({ slug: page.slug, title: page.title });
+    sections.set(page.sectionId, existing);
+  }
+  return [...sections.values()];
+}
+var FumadocsDocsProvider = class {
+  pages = [];
+  tree = [];
+  /**
+   * Loads pages and an optional page tree from Fumadocs.
+   *
+   * @param pages - Source pages supplied by Fumadocs.
+   * @param tree - Optional source page tree for nested sidebar rendering.
+   * @returns Nothing. The provider page set is replaced in memory.
+   */
+  loadFromSource(pages, tree = []) {
+    this.tree = tree;
+    this.pages = this.linkPages(pages.map((page) => this.normalizePage(page)));
+  }
+  normalizePage(page) {
+    const slugParts = page.slugs ?? page.slug?.split("/") ?? [];
+    const slug = slugParts.join("/");
+    const sectionId = slugParts[0] ?? "general";
+    const title = page.data.title ?? slugParts[slugParts.length - 1] ?? slug;
+    const content = page.data.body ?? "";
+    const { wordCount, readingTime } = calcWordCount(content);
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    return {
+      id: slug,
+      title,
+      slug,
+      content,
+      excerpt: page.data.description,
+      sectionId,
+      order: page.data.order ?? 0,
+      author: {
+        name: page.data.author ?? "Geenius",
+        avatar: asString2(page.data.avatar)
+      },
+      lastEditedBy: asString2(page.data.lastModified ?? page.data.lastUpdated) ? {
+        name: page.data.author ?? "Geenius",
+        editedAt: asString2(page.data.lastModified ?? page.data.lastUpdated) ?? now
+      } : void 0,
+      version: asString2(page.data.version),
+      access: asAccess2(page.data.access),
+      tags: asTags2(page.data.tags),
+      status: page.data.draft === true ? "draft" : asStatus2(page.data.status),
+      createdAt: now,
+      updatedAt: asString2(page.data.lastModified ?? page.data.lastUpdated) ?? now,
+      wordCount,
+      readingTime,
+      viewCount: 0,
+      toc: page.data.toc ?? extractToc(content)
+    };
+  }
+  linkPages(pages) {
+    const sorted = [...pages].sort((left, right) => left.order - right.order);
+    return sorted.map((page, index) => {
+      const prev = sorted[index - 1];
+      const next = sorted[index + 1];
+      const prevLink = prev ? { slug: prev.slug, title: prev.title } : null;
+      const nextLink = next ? { slug: next.slug, title: next.title } : null;
+      return {
+        ...page,
+        prev: prevLink,
+        next: nextLink
+      };
+    });
+  }
+  treeToSidebar(nodes) {
+    return nodes.filter((node) => node.type === "folder").map((folder) => {
+      const title = folder.name ?? "Section";
+      const children = folder.children ?? [];
+      const pages = children.filter((child) => child.type === "page").map((child) => ({
+        slug: child.slug ?? "",
+        title: child.name ?? child.slug ?? "Untitled"
+      }));
+      const nestedChildren = this.treeToSidebar(
+        children.filter((child) => child.type === "folder")
+      );
+      return {
+        id: folder.slug ?? slugify(title),
+        title,
+        slug: folder.slug ?? slugify(title),
+        icon: folder.icon,
+        pages,
+        children: nestedChildren.length > 0 ? nestedChildren : void 0
+      };
+    });
+  }
+  /**
+   * Loads the sidebar structure derived from the Fumadocs tree or grouped pages.
+   *
+   * @returns Sidebar navigation entries derived from the published pages.
+   */
+  async getSidebar() {
+    if (this.tree.length > 0) {
+      return this.treeToSidebar(this.tree);
+    }
+    return createSidebar2(this.pages);
+  }
+  /**
+   * Resolves a linked docs page by slug.
+   *
+   * @param slug - Target page slug.
+   * @returns The linked page or `null` when no page matches the slug.
+   */
+  async getPage(slug) {
+    return this.pages.find((page) => page.slug === slug) ?? null;
+  }
+  /**
+   * Returns all published pages managed by the provider.
+   *
+   * @returns Published pages in their linked navigation order.
+   */
+  async getAllPages() {
+    return this.pages.filter((page) => page.status === "published");
+  }
+  /**
+   * Searches the provider-backed page set.
+   *
+   * @param query - User-entered search query.
+   * @returns Ranked search results derived from the published pages.
+   */
+  async search(query) {
+    const normalizedQuery = query.trim().toLowerCase();
+    if (!normalizedQuery) {
+      return [];
+    }
+    return this.pages.filter((page) => page.status === "published").map((page) => {
+      let score = 0;
+      if (page.title.toLowerCase().includes(normalizedQuery)) {
+        score += 10;
+      }
+      if (page.tags.some((tag) => tag.toLowerCase().includes(normalizedQuery))) {
+        score += 4;
+      }
+      if (page.content.toLowerCase().includes(normalizedQuery)) {
+        score += 2;
+      }
+      if (page.excerpt?.toLowerCase().includes(normalizedQuery)) {
+        score += 1;
+      }
+      if (score === 0) {
+        return null;
+      }
+      return {
+        pageId: page.id,
+        pageTitle: page.title,
+        sectionTitle: sectionTitle2(page.sectionId),
+        slug: page.slug,
+        highlight: highlightMatch(page.excerpt ?? page.content, query),
+        score
+      };
+    }).filter((result) => result !== null).sort((left, right) => right.score - left.score);
+  }
+  /**
+   * Resolves previous and next pages for a slug.
+   *
+   * @param slug - Target page slug.
+   * @returns Linked previous and next page records when available.
+   */
+  async getNavigation(slug) {
+    const page = this.pages.find((entry) => entry.slug === slug);
+    if (!page) {
+      return { prev: null, next: null };
+    }
+    return {
+      prev: page.prev ? this.pages.find((entry) => entry.slug === page.prev?.slug) ?? null : null,
+      next: page.next ? this.pages.find((entry) => entry.slug === page.next?.slug) ?? null : null
+    };
+  }
+};
+
+// src/providers/internal.ts
+function sectionTitle3(sectionId) {
+  return sectionId.split(/[-_/]/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || "General";
+}
+function createSidebar3(pages) {
+  const sections = /* @__PURE__ */ new Map();
+  for (const page of pages.filter((entry) => entry.status === "published")) {
+    const title = sectionTitle3(page.sectionId);
+    const entry = sections.get(page.sectionId) ?? {
+      id: page.sectionId,
+      title,
+      slug: slugify(title),
+      pages: []
+    };
+    entry.pages.push({ slug: page.slug, title: page.title });
+    sections.set(page.sectionId, entry);
+  }
+  return [...sections.values()].map((entry) => ({
+    ...entry,
+    pages: [...entry.pages].sort(
+      (left, right) => left.title.localeCompare(right.title)
+    )
+  }));
+}
+var InternalDocsProvider = class {
+  pages = [];
+  /**
+   * @param pages - Optional initial page records to seed the provider with.
+   */
+  constructor(pages = []) {
+    this.pages = this.linkPages(pages);
+  }
+  /**
+   * Replaces the provider's page set.
+   *
+   * @param pages - Fresh page records to seed into the provider.
+   * @returns Nothing. The provider page set is replaced in memory.
+   */
+  setPages(pages) {
+    this.pages = this.linkPages(pages);
+  }
+  linkPages(pages) {
+    const sorted = [...pages].sort((left, right) => left.order - right.order);
+    return sorted.map((page, index) => {
+      const prev = sorted[index - 1];
+      const next = sorted[index + 1];
+      const prevLink = prev ? { slug: prev.slug, title: prev.title } : null;
+      const nextLink = next ? { slug: next.slug, title: next.title } : null;
+      return {
+        ...page,
+        prev: prevLink,
+        next: nextLink,
+        toc: extractToc(page.content)
+      };
+    });
+  }
+  /**
+   * Loads the sidebar structure derived from the current page set.
+   *
+   * @returns Sidebar navigation entries derived from the published pages.
+   */
+  async getSidebar() {
+    return createSidebar3(this.pages);
+  }
+  /**
+   * Resolves a linked docs page by slug.
+   *
+   * @param slug - Target page slug.
+   * @returns The linked page or `null` when no page matches the slug.
+   */
+  async getPage(slug) {
+    return this.pages.find((page) => page.slug === slug) ?? null;
+  }
+  /**
+   * Returns all published pages managed by the provider.
+   *
+   * @returns Published pages in their linked navigation order.
+   */
+  async getAllPages() {
+    return this.pages.filter((page) => page.status === "published");
+  }
+  /**
+   * Searches the provider-backed page set.
+   *
+   * @param query - User-entered search query.
+   * @returns Ranked search results derived from the published pages.
+   */
+  async search(query) {
+    const normalizedQuery = query.trim().toLowerCase();
+    if (!normalizedQuery) {
+      return [];
+    }
+    return this.pages.filter((page) => page.status === "published").map((page) => {
+      let score = 0;
+      if (page.title.toLowerCase().includes(normalizedQuery)) {
+        score += 10;
+      }
+      if (page.tags.some((tag) => tag.toLowerCase().includes(normalizedQuery))) {
+        score += 4;
+      }
+      if (page.content.toLowerCase().includes(normalizedQuery)) {
+        score += 2;
+      }
+      if (score === 0) {
+        return null;
+      }
+      return {
+        pageId: page.id,
+        pageTitle: page.title,
+        sectionTitle: sectionTitle3(page.sectionId),
+        slug: page.slug,
+        highlight: highlightMatch(page.excerpt ?? page.content, query),
+        score
+      };
+    }).filter((result) => result !== null).sort((left, right) => right.score - left.score);
+  }
+  /**
+   * Resolves previous and next pages for a slug.
+   *
+   * @param slug - Target page slug.
+   * @returns Linked previous and next page records when available.
+   */
+  async getNavigation(slug) {
+    const page = this.pages.find((entry) => entry.slug === slug);
+    if (!page) {
+      return { prev: null, next: null };
+    }
+    return {
+      prev: page.prev ? this.pages.find((entry) => entry.slug === page.prev?.slug) ?? null : null,
+      next: page.next ? this.pages.find((entry) => entry.slug === page.next?.slug) ?? null : null
+    };
+  }
+};
+
+export { AstroDocsProvider, DocsConfigurationError, DocsError, DocsProviderError, FumadocsDocsProvider, InternalDocsProvider, buildBreadcrumbs, buildDocsIndex, calcWordCount, configureDocs, defaultDocsConfig, defineDocsConfig, extractToc, getDocsConfig, highlightMatch, isDocsConfigured, mergeDocsConfig, resetDocsConfig, searchDocs, slugify };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map