@vezham/docs-core 1.0.1

package/dist/utils-Bvy3V-fv.js

@@ -0,0 +1,59 @@
+import { createContentHighlighter } from "./search/index.js";
+import Search from "flexsearch";
+//#region src/search/flexsearch/utils.ts
+async function search(index, query, tag, limit = 60) {
+	const arr = await index.searchAsync(query, {
+		index: "content",
+		limit,
+		tag: tag ? { tags: tag } : void 0
+	});
+	const out = [];
+	if (arr.length === 0) return out;
+	const results = arr[0].result;
+	const highlighter = createContentHighlighter(query);
+	const grouped = /* @__PURE__ */ new Map();
+	for (const id of results) {
+		const doc = index.get(id);
+		if (!doc) continue;
+		let list = grouped.get(doc.page_id);
+		if (!list) {
+			list = [];
+			grouped.set(doc.page_id, list);
+		}
+		if (doc.type !== "page") list.push(doc);
+	}
+	for (const [page_id, items] of grouped) {
+		const page = index.get(page_id);
+		if (!page) continue;
+		out.push({
+			id: page_id,
+			type: "page",
+			content: highlighter.highlightMarkdown(page.content),
+			breadcrumbs: page.breadcrumbs,
+			url: page.url
+		});
+		for (const item of items) out.push({
+			id: item.id,
+			content: highlighter.highlightMarkdown(item.content),
+			breadcrumbs: item.breadcrumbs,
+			type: item.type,
+			url: item.url
+		});
+	}
+	return out;
+}
+function createDocument(options) {
+	return new Search.Document({
+		tokenize: "full",
+		...options,
+		document: {
+			id: "id",
+			index: ["content"],
+			tag: ["tags"],
+			store: true,
+			...options?.document
+		}
+	});
+}
+//#endregion
+export { search as n, createDocument as t };

package/dist/utils-Cgs-6U-z.js

@@ -0,0 +1,39 @@
+//#region src/highlight/utils.ts
+async function loadMissingTheme(highlighter, themes) {
+	const bundled = highlighter.getBundledThemes();
+	const loaded = highlighter.getLoadedThemes();
+	const missingThemes = themes.filter((theme) => {
+		if (typeof theme === "string") return theme in bundled && !loaded.includes(theme);
+		return theme.name === void 0 || !loaded.includes(theme.name);
+	});
+	if (missingThemes.length > 0) await highlighter.loadTheme(...missingThemes);
+}
+async function loadMissingLanguage(highlighter, langs) {
+	const bundled = highlighter.getBundledLanguages();
+	const loaded = highlighter.getLoadedLanguages();
+	const missingLangs = langs.filter((lang) => {
+		if (typeof lang === "string") return lang in bundled && !loaded.includes(lang);
+		return !loaded.includes(lang.name);
+	});
+	if (missingLangs.length > 0) await highlighter.loadLanguage(...missingLangs);
+}
+function getRequiredThemes(options) {
+	if ("theme" in options) return [options.theme];
+	else return Object.values(options.themes).filter((v) => v !== void 0);
+}
+function applyDefaultThemes(options, defaultValue = defaultThemes) {
+	if (!("theme" in options) && !("themes" in options)) return {
+		...defaultValue,
+		...options
+	};
+	else return options;
+}
+const defaultThemes = {
+	themes: {
+		light: "github-light",
+		dark: "github-dark"
+	},
+	defaultColor: false
+};
+//#endregion
+export { loadMissingTheme as a, loadMissingLanguage as i, defaultThemes as n, getRequiredThemes as r, applyDefaultThemes as t };

package/dist/utils-DEVq3cEC.js

@@ -0,0 +1,151 @@
+//#region src/page-tree/utils.ts
+/**
+* Flatten tree to an array of page nodes
+*/
+function flattenTree(nodes) {
+	const out = [];
+	for (const node of nodes) if (node.type === "folder") {
+		if (node.index) out.push(node.index);
+		out.push(...flattenTree(node.children));
+	} else if (node.type === "page") out.push(node);
+	return out;
+}
+/**
+* Get neighbours of a page, useful for implementing "previous & next" buttons
+*/
+function findNeighbour(tree, url, options) {
+	const { separateRoot = true } = options ?? {};
+	const roots = separateRoot ? getPageTreeRoots(tree) : [tree];
+	if (tree.fallback) roots.push(tree.fallback);
+	for (const root of roots) {
+		const list = flattenTree(root.children);
+		const idx = list.findIndex((item) => item.url === url);
+		if (idx === -1) continue;
+		return {
+			previous: list[idx - 1],
+			next: list[idx + 1]
+		};
+	}
+	return {};
+}
+function getPageTreeRoots(pageTree) {
+	const result = pageTree.children.flatMap((child) => {
+		if (child.type !== "folder") return [];
+		const roots = getPageTreeRoots(child);
+		if (child.root) roots.push(child);
+		return roots;
+	});
+	if (!pageTree.type || pageTree.type === "root") result.push(pageTree);
+	return result;
+}
+/**
+* Get other **page** nodes that lives under the same parent.
+*
+* note: folders & its index nodes are not considered, use `findSiblings()` for more control.
+*/
+function getPageTreePeers(treeOrTrees, url) {
+	return findSiblings(treeOrTrees, url).filter((item) => item.type === "page");
+}
+/**
+* Get other tree nodes that lives under the same parent.
+*/
+function findSiblings(treeOrTrees, url) {
+	if ("children" in treeOrTrees) {
+		const parent = findParent(treeOrTrees, url);
+		if (!parent) return [];
+		return parent.children.filter((item) => item.type !== "page" || item.url !== url);
+	}
+	for (const lang in treeOrTrees) {
+		const result = findSiblings(treeOrTrees[lang], url);
+		if (result.length > 0) return result;
+	}
+	return [];
+}
+function findParent(from, url) {
+	let result;
+	visit(from, (node, parent) => {
+		if (node.type === "page" && node.url === url) {
+			result = parent;
+			return "break";
+		}
+	});
+	return result;
+}
+/**
+* Search the path of a node in the tree matched by the matcher.
+*
+* @returns The path to the target node (from starting root), or null if the page doesn't exist
+*/
+function findPath(nodes, matcher, options = {}) {
+	const { includeSeparator = true } = options;
+	function run(nodes) {
+		let separator;
+		for (const node of nodes) {
+			if (matcher(node)) {
+				const items = [];
+				if (separator) items.push(separator);
+				items.push(node);
+				return items;
+			}
+			if (node.type === "separator" && includeSeparator) {
+				separator = node;
+				continue;
+			}
+			if (node.type === "folder") {
+				const items = node.index && matcher(node.index) ? [node.index] : run(node.children);
+				if (items) {
+					items.unshift(node);
+					if (separator) items.unshift(separator);
+					return items;
+				}
+			}
+		}
+	}
+	return run(nodes) ?? null;
+}
+/**
+* Find the structural projection of `page` (under the root folder `from`) in `to`:
+* the page at the same file path relative to the root folder.
+*/
+function findProjection(from, to, page) {
+	const prefix = from.$ref && `${from.$ref.folder}/`;
+	if (!prefix || !to.$ref || !page.$ref?.startsWith(prefix)) return;
+	const target = `${to.$ref.folder}/${page.$ref.slice(prefix.length)}`;
+	let result;
+	visit(to, (node) => {
+		if (node.type === "page" && node.$ref === target) {
+			result = node;
+			return "break";
+		}
+	});
+	return result;
+}
+const VisitBreak = Symbol("VisitBreak");
+/**
+* Perform a depth-first search on page tree visiting every node.
+*
+* @param root - the root of page tree to visit.
+* @param visitor - function to receive nodes, return `skip` to skip the children of current node, `break` to stop the search entirely.
+*/
+function visit(root, visitor) {
+	function onNode(node, parent) {
+		const result = visitor(node, parent);
+		switch (result) {
+			case "skip": return node;
+			case "break": throw VisitBreak;
+			default: if (result) node = result;
+		}
+		if ("index" in node && node.index) node.index = onNode(node.index, node);
+		if ("fallback" in node && node.fallback) node.fallback = onNode(node.fallback, node);
+		if ("children" in node) for (let i = 0; i < node.children.length; i++) node.children[i] = onNode(node.children[i], node);
+		return node;
+	}
+	try {
+		return onNode(root);
+	} catch (e) {
+		if (e === VisitBreak) return root;
+		throw e;
+	}
+}
+//#endregion
+export { findSiblings as a, getPageTreeRoots as c, findProjection as i, visit as l, findParent as n, flattenTree as o, findPath as r, getPageTreePeers as s, findNeighbour as t };

package/dist/utils-Yx0IL9eW.js

@@ -0,0 +1,48 @@
+import { valueToEstree } from "estree-util-value-to-estree";
+//#region src/mdx-plugins/utils.ts
+function flattenNode(node) {
+	if ("children" in node) return node.children.map(flattenNode).join("");
+	if ("value" in node && typeof node.value === "string") return node.value;
+	return "";
+}
+function flattenNodeHast(node) {
+	if ("children" in node) return node.children.map(flattenNodeHast).join("");
+	return "value" in node && typeof node.value === "string" ? node.value : "";
+}
+function toMdxExport(name, value) {
+	return toMdxExportRaw(name, valueToEstree(value));
+}
+function toMdxExportRaw(name, expression) {
+	return {
+		type: "mdxjsEsm",
+		value: "",
+		data: { estree: {
+			type: "Program",
+			sourceType: "module",
+			body: [{
+				type: "ExportNamedDeclaration",
+				attributes: [],
+				specifiers: [],
+				declaration: {
+					type: "VariableDeclaration",
+					kind: "let",
+					declarations: [{
+						type: "VariableDeclarator",
+						id: {
+							type: "Identifier",
+							name
+						},
+						init: expression
+					}]
+				}
+			}]
+		} }
+	};
+}
+function handleTag(value, tag) {
+	const idx = value.indexOf(tag);
+	if (idx !== -1) return value.slice(0, idx).trimEnd() + value.slice(idx + tag.length);
+	return false;
+}
+//#endregion
+export { toMdxExportRaw as a, toMdxExport as i, flattenNodeHast as n, handleTag as r, flattenNode as t };

package/package.json

@@ -0,0 +1,251 @@
+{
+  "name": "@vezham/docs-core",
+  "version": "1.0.1",
+  "description": "The React.js library for building a documentation website",
+  "keywords": [
+    "Docs",
+    "Fumadocs"
+  ],
+  "homepage": "https://vezham.com",
+  "bugs": {
+    "url": "https://github.com/vezham/fumadocs/issues"
+  },
+  "license": "MIT",
+  "author": "Fuma Nama",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vezham/fumadocs",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./breadcrumb": "./dist/breadcrumb.js",
+    "./content/github": "./dist/content/github.js",
+    "./content/md": "./dist/content/md.js",
+    "./content/md/frontmatter": "./dist/content/md/frontmatter.js",
+    "./content/mdx/preset-bundler": "./dist/content/mdx/preset-bundler.js",
+    "./content/mdx/preset-runtime": "./dist/content/mdx/preset-runtime.js",
+    "./content/toc": "./dist/content/toc.js",
+    "./dynamic-link": "./dist/dynamic-link.js",
+    "./framework": "./dist/framework/index.js",
+    "./framework/astro": "./dist/framework/astro.js",
+    "./framework/next": "./dist/framework/next.js",
+    "./framework/react-router": "./dist/framework/react-router.js",
+    "./framework/tanstack": "./dist/framework/tanstack.js",
+    "./framework/waku": "./dist/framework/waku.js",
+    "./highlight": "./dist/highlight/index.js",
+    "./highlight/client": "./dist/highlight/client.js",
+    "./highlight/shiki": "./dist/highlight/shiki/index.js",
+    "./highlight/shiki/full": "./dist/highlight/shiki/full.js",
+    "./highlight/shiki/react": "./dist/highlight/shiki/react.js",
+    "./i18n": "./dist/i18n/index.js",
+    "./i18n/middleware": "./dist/i18n/middleware.js",
+    "./link": "./dist/link.js",
+    "./mdx-plugins": "./dist/mdx-plugins/index.js",
+    "./mdx-plugins/codeblock-utils": "./dist/mdx-plugins/codeblock-utils.js",
+    "./mdx-plugins/rehype-code": "./dist/mdx-plugins/rehype-code.js",
+    "./mdx-plugins/rehype-code.core": "./dist/mdx-plugins/rehype-code.core.js",
+    "./mdx-plugins/rehype-toc": "./dist/mdx-plugins/rehype-toc.js",
+    "./mdx-plugins/remark-admonition": "./dist/mdx-plugins/remark-admonition.js",
+    "./mdx-plugins/remark-block-id": "./dist/mdx-plugins/remark-block-id.js",
+    "./mdx-plugins/remark-code-tab": "./dist/mdx-plugins/remark-code-tab.js",
+    "./mdx-plugins/remark-directive-admonition": "./dist/mdx-plugins/remark-directive-admonition.js",
+    "./mdx-plugins/remark-feedback-block": "./dist/mdx-plugins/remark-feedback-block.js",
+    "./mdx-plugins/remark-gfm": "./dist/mdx-plugins/remark-gfm.js",
+    "./mdx-plugins/remark-heading": "./dist/mdx-plugins/remark-heading.js",
+    "./mdx-plugins/remark-image": "./dist/mdx-plugins/remark-image.js",
+    "./mdx-plugins/remark-llms": "./dist/mdx-plugins/remark-llms.js",
+    "./mdx-plugins/remark-llms.runtime": "./dist/mdx-plugins/remark-llms.runtime.js",
+    "./mdx-plugins/remark-mdx-files": "./dist/mdx-plugins/remark-mdx-files.js",
+    "./mdx-plugins/remark-mdx-mermaid": "./dist/mdx-plugins/remark-mdx-mermaid.js",
+    "./mdx-plugins/remark-npm": "./dist/mdx-plugins/remark-npm.js",
+    "./mdx-plugins/remark-steps": "./dist/mdx-plugins/remark-steps.js",
+    "./mdx-plugins/remark-structure": "./dist/mdx-plugins/remark-structure.js",
+    "./mdx-plugins/stringifier": "./dist/mdx-plugins/stringifier.js",
+    "./mdx-plugins/transformer-icon": "./dist/mdx-plugins/transformer-icon.js",
+    "./negotiation": "./dist/negotiation/index.js",
+    "./page-tree": "./dist/page-tree/index.js",
+    "./search": "./dist/search/index.js",
+    "./search/algolia": "./dist/search/algolia.js",
+    "./search/client": "./dist/search/client.js",
+    "./search/client/algolia": "./dist/search/client/algolia.js",
+    "./search/client/fetch": "./dist/search/client/fetch.js",
+    "./search/client/flexsearch-static": "./dist/search/client/flexsearch-static.js",
+    "./search/client/mixedbread": "./dist/search/client/mixedbread.js",
+    "./search/client/orama-cloud": "./dist/search/client/orama-cloud.js",
+    "./search/client/orama-cloud-legacy": "./dist/search/client/orama-cloud-legacy.js",
+    "./search/client/orama-static": "./dist/search/client/orama-static.js",
+    "./search/flexsearch": "./dist/search/flexsearch.js",
+    "./search/mixedbread": "./dist/search/mixedbread.js",
+    "./search/orama-cloud": "./dist/search/orama-cloud.js",
+    "./search/orama-cloud-legacy": "./dist/search/orama-cloud-legacy.js",
+    "./search/server": "./dist/search/server.js",
+    "./server": {
+      "browser": "./dist/server.browser.js",
+      "import": "./dist/server.js"
+    },
+    "./server.browser": "./dist/server.browser.js",
+    "./source": "./dist/source/index.js",
+    "./source/client": "./dist/source/client/index.js",
+    "./source/dynamic": "./dist/source/dynamic.js",
+    "./source/llms": "./dist/source/llms.js",
+    "./source/plugins/lucide-icons": "./dist/source/plugins/lucide-icons.js",
+    "./source/plugins/slugs": "./dist/source/plugins/slugs.js",
+    "./source/plugins/status-badges": "./dist/source/plugins/status-badges.js",
+    "./source/schema": "./dist/source/schema.js",
+    "./toc": "./dist/toc.js",
+    "./utils/use-media-query": "./dist/utils/use-media-query.js",
+    "./utils/use-on-change": "./dist/utils/use-on-change.js",
+    "./package.json": "./package.json",
+    "./source/*": {
+      "types": "./dist/source/plugins/*.d.ts",
+      "import": "./dist/source/plugins/*.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "estree-util-value-to-estree": "^3.5.0",
+    "github-slugger": "^2.0.0",
+    "hast-util-to-estree": "^3.1.3",
+    "hast-util-to-jsx-runtime": "^2.3.6",
+    "mdast-util-mdx": "^3.0.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "npm-to-yarn": "3.2.0",
+    "remark": "^15.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-rehype": "^11.1.2",
+    "scroll-into-view-if-needed": "^3.1.0",
+    "shiki": "^4.4.3",
+    "tinyglobby": "^0.2.17",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0",
+    "vfile": "^6.0.3",
+    "yaml": "^2.9.0",
+    "zbsearch": "^4.0.0",
+    "@fumari/image-size": "^0.1.0"
+  },
+  "devDependencies": {
+    "@formatjs/intl-localematcher": "^0.8.13",
+    "@mdx-js/mdx": "^3.1.1",
+    "@mixedbread/sdk": "0.77.0",
+    "@orama/core": "^1.2.19",
+    "@oramacloud/client": "^2.1.4",
+    "@shikijs/transformers": "^4.4.3",
+    "@tanstack/react-router": "1.170.32",
+    "@types/estree-jsx": "^1.0.5",
+    "@types/hast": "^3.0.5",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "26.3.0",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "algoliasearch": "5.57.0",
+    "flexsearch": "^0.8.212",
+    "lucide-react": "^1.34.0",
+    "next": "16.3.3",
+    "path-to-regexp": "^8.4.2",
+    "react-router": "^8.3.0",
+    "remark-directive": "^4.0.0",
+    "remark-mdx": "^3.1.1",
+    "remove-markdown": "^0.6.4",
+    "tsdown": "0.22.14",
+    "typescript": "^6.0.3",
+    "waku": "1.0.0-rc.0",
+    "zod": "4.4.3",
+    "tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "@mdx-js/mdx": "*",
+    "@mixedbread/sdk": "0.x.x",
+    "@orama/core": "1.x.x",
+    "@oramacloud/client": "2.x.x",
+    "@tanstack/react-router": "1.x.x",
+    "@types/estree-jsx": "*",
+    "@types/hast": "*",
+    "@types/mdast": "*",
+    "@types/react": "*",
+    "algoliasearch": "5.x.x",
+    "flexsearch": "*",
+    "lucide-react": "*",
+    "next": "16.x.x",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router": "7.x.x || 8.x.x",
+    "waku": "*",
+    "zod": "4.x.x"
+  },
+  "peerDependenciesMeta": {
+    "flexsearch": {
+      "optional": true
+    },
+    "@mdx-js/mdx": {
+      "optional": true
+    },
+    "@types/estree-jsx": {
+      "optional": true
+    },
+    "@types/hast": {
+      "optional": true
+    },
+    "@types/mdast": {
+      "optional": true
+    },
+    "@mixedbread/sdk": {
+      "optional": true
+    },
+    "@types/react": {
+      "optional": true
+    },
+    "@orama/core": {
+      "optional": true
+    },
+    "@oramacloud/client": {
+      "optional": true
+    },
+    "algoliasearch": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "react-router": {
+      "optional": true
+    },
+    "waku": {
+      "optional": true
+    },
+    "@tanstack/react-router": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "inlinedDependencies": {
+    "@formatjs/fast-memoize": "3.1.7",
+    "@formatjs/intl-localematcher": "0.8.13",
+    "@shikijs/transformers": "4.4.3",
+    "path-to-regexp": "8.4.2",
+    "remove-markdown": "0.6.4"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rimraf dist",
+    "dev": "tsdown --watch --clean false",
+    "lint": "oxlint .",
+    "types:check": "tsc --noEmit"
+  }
+}