@hanzo/docs-core 16.2.6 → 16.4.2

package/dist/mdx-plugins/remark-image.js

@@ -1,7 +1,192 @@
-import {
-  remarkImage
-} from "../chunk-5PMI7QDD.js";
-import "../chunk-U67V476Y.js";
-export {
-  remarkImage
-};
+import { visit } from "unist-util-visit";
+import * as path$1 from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/mdx-plugins/remark-image.ts
+const VALID_BLUR_EXT = [
+	".jpeg",
+	".png",
+	".webp",
+	".avif",
+	".jpg"
+];
+const EXTERNAL_URL_REGEX = /^https?:\/\//;
+/**
+* Turn images into Next.js Image compatible usage.
+*/
+function remarkImage({ placeholder = "blur", external = true, useImport = true, onError = "error", publicDir = path$1.join(process.cwd(), "public") } = {}) {
+	return async (tree, file) => {
+		const importsToInject = [];
+		const promises = [];
+		async function onImage(src, node) {
+			const attributes = [{
+				type: "mdxJsxAttribute",
+				name: "alt",
+				value: node.alt ?? "image"
+			}];
+			if (node.title) attributes.push({
+				type: "mdxJsxAttribute",
+				name: "title",
+				value: node.title
+			});
+			if (src.type === "file" && useImport) {
+				const variableName = `__img${importsToInject.length}`;
+				const hasBlur = placeholder === "blur" && VALID_BLUR_EXT.some((ext) => src.file.endsWith(ext));
+				if (!file.dirname) throw new Error("When `useImport` is enabled, you must specify `dirname` in the VFile passed to compiler.");
+				importsToInject.push({
+					variableName,
+					importPath: getImportPath(src.file, file.dirname)
+				});
+				attributes.push({
+					type: "mdxJsxAttribute",
+					name: "src",
+					value: {
+						type: "mdxJsxAttributeValueExpression",
+						value: variableName,
+						data: { estree: {
+							body: [{
+								type: "ExpressionStatement",
+								expression: {
+									type: "Identifier",
+									name: variableName
+								}
+							}],
+							type: "Program",
+							sourceType: "script"
+						} }
+					}
+				});
+				const out = {
+					children: [],
+					type: "mdxJsxFlowElement",
+					name: "img",
+					attributes
+				};
+				if (hasBlur) out.attributes.push({
+					type: "mdxJsxAttribute",
+					name: "placeholder",
+					value: "blur"
+				});
+				return out;
+			}
+			const size = await getImageSize(src, external).catch((e) => {
+				throw new Error(`[Remark Image] Failed obtain image size for ${node.url} (public directory configured as ${publicDir})`, { cause: e });
+			});
+			if (!size) return;
+			attributes.push({
+				type: "mdxJsxAttribute",
+				name: "src",
+				value: src.type === "url" ? src.url.toString() : node.url
+			}, {
+				type: "mdxJsxAttribute",
+				name: "width",
+				value: size.width.toString()
+			}, {
+				type: "mdxJsxAttribute",
+				name: "height",
+				value: size.height.toString()
+			});
+			return {
+				type: "mdxJsxFlowElement",
+				name: "img",
+				attributes,
+				children: []
+			};
+		}
+		visit(tree, "image", (node) => {
+			const src = parseSrc(decodeURI(node.url), publicDir, file.dirname);
+			if (!src) return;
+			const task = onImage(src, node).catch((e) => {
+				if (onError === "ignore" || node.url.endsWith(".svg")) return;
+				if (onError === "hide") return {
+					type: "mdxJsxFlowElement",
+					name: null,
+					attributes: [],
+					children: []
+				};
+				if (onError === "error") throw e;
+				onError(e);
+			}).then((res) => {
+				if (res) Object.assign(node, res);
+			});
+			promises.push(task);
+		});
+		await Promise.all(promises);
+		if (importsToInject.length === 0) return;
+		const imports = importsToInject.map(({ variableName, importPath }) => ({
+			type: "mdxjsEsm",
+			data: { estree: { body: [{
+				type: "ImportDeclaration",
+				source: {
+					type: "Literal",
+					value: importPath
+				},
+				specifiers: [{
+					type: "ImportDefaultSpecifier",
+					local: {
+						type: "Identifier",
+						name: variableName
+					}
+				}]
+			}] } }
+		}));
+		tree.children.unshift(...imports);
+	};
+}
+function getImportPath(file, dir) {
+	const relative = path$1.relative(dir, file).replaceAll(path$1.sep, "/");
+	return relative.startsWith("../") ? relative : `./${relative}`;
+}
+/**
+* @param src - src href
+* @param publicDir - dir/url to resolve absolute paths
+* @param dir - dir to resolve relative paths
+*/
+function parseSrc(src, publicDir, dir) {
+	if (src.startsWith("file:///")) return {
+		type: "file",
+		file: fileURLToPath(src)
+	};
+	if (EXTERNAL_URL_REGEX.test(src)) return {
+		type: "url",
+		url: new URL(src)
+	};
+	if (src.startsWith("/")) {
+		if (EXTERNAL_URL_REGEX.test(publicDir)) {
+			const url = new URL(publicDir);
+			url.pathname = `/${[...url.pathname.split("/"), ...src.split("/")].filter((v) => v.length > 0).join("/")}`;
+			return {
+				type: "url",
+				url
+			};
+		}
+		return {
+			type: "file",
+			file: path$1.join(publicDir, src)
+		};
+	}
+	if (!dir) {
+		console.warn(`[Remark Image] found relative path ${src} but missing 'dirname' in VFile, this image will be skipped for now.`);
+		return;
+	}
+	return {
+		type: "file",
+		file: path$1.join(dir, src)
+	};
+}
+async function getImageSize(src, onExternal) {
+	if (src.type === "file") {
+		const { imageSizeFromFile } = await import("image-size/fromFile");
+		return imageSizeFromFile(src.file);
+	}
+	if (onExternal === false) return;
+	const { timeout } = typeof onExternal === "object" ? onExternal : {};
+	const res = await fetch(src.url, { signal: typeof timeout === "number" ? AbortSignal.timeout(timeout) : void 0 });
+	if (!res.ok) throw new Error(`[Remark Image] Failed to fetch ${src.url} (${res.status}): ${await res.text()}`);
+	const { imageSize } = await import("image-size");
+	return imageSize(new Uint8Array(await res.arrayBuffer()));
+}
+
+//#endregion
+export { remarkImage };
+//# sourceMappingURL=remark-image.js.map

package/dist/mdx-plugins/remark-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-image.js","names":["path","importsToInject: { variableName: string; importPath: string }[]","promises: Promise<void>[]","attributes: MdxJsxAttribute[]","out: MdxJsxFlowElement"],"sources":["../../src/mdx-plugins/remark-image.ts"],"sourcesContent":["import * as path from 'node:path';\nimport type { Image, Root } from 'mdast';\nimport type { Transformer } from 'unified';\nimport { visit } from 'unist-util-visit';\nimport type { MdxjsEsm } from 'mdast-util-mdxjs-esm';\nimport type { ISizeCalculationResult } from 'image-size/types/interface';\nimport type { MdxJsxAttribute, MdxJsxFlowElement } from 'mdast-util-mdx-jsx';\nimport { fileURLToPath } from 'node:url';\n\nconst VALID_BLUR_EXT = ['.jpeg', '.png', '.webp', '.avif', '.jpg'];\nconst EXTERNAL_URL_REGEX = /^https?:\\/\\//;\n\ntype ExternalImageOptions =\n  | {\n      /**\n       * timeout for fetching remote images (in milliseconds)\n       */\n      timeout?: number;\n    }\n  | boolean;\n\nexport interface RemarkImageOptions {\n  /**\n   * Directory or base URL to resolve absolute image paths\n   */\n  publicDir?: string;\n\n  /**\n   * Preferred placeholder type, only available with `useImport` + local images.\n   *\n   * @defaultValue 'blur'\n   */\n  placeholder?: 'blur' | 'none';\n\n  /**\n   * Define how to handle errors when fetching image size.\n   *\n   * - `error` (default): throw an error.\n   * - `ignore`: do absolutely nothing (Next.js Image component may complain).\n   * - `hide`: remove that image element.\n   *\n   * @defaultValue 'error'\n   */\n  onError?: 'error' | 'hide' | 'ignore' | ((error: Error) => void);\n\n  /**\n   * Import images in the file, and let bundlers handle it.\n   *\n   * ```tsx\n   * import MyImage from \"./public/img.png\";\n   *\n   * <img src={MyImage} />\n   * ```\n   *\n   * When disabled, `placeholder` will be ignored.\n   *\n   * @defaultValue true\n   */\n  useImport?: boolean;\n\n  /**\n   * Fetch image size of external URLs\n   *\n   * @defaultValue true\n   */\n  external?: ExternalImageOptions;\n}\n\ntype Source =\n  | {\n      type: 'url';\n      url: URL;\n    }\n  | {\n      type: 'file';\n      file: string;\n    };\n\n/**\n * Turn images into Next.js Image compatible usage.\n */\nexport function remarkImage({\n  placeholder = 'blur',\n  external = true,\n  useImport = true,\n  onError = 'error',\n  publicDir = path.join(process.cwd(), 'public'),\n}: RemarkImageOptions = {}): Transformer<Root, Root> {\n  return async (tree, file) => {\n    const importsToInject: { variableName: string; importPath: string }[] = [];\n    const promises: Promise<void>[] = [];\n\n    async function onImage(src: Source, node: Image): Promise<MdxJsxFlowElement | undefined> {\n      const attributes: MdxJsxAttribute[] = [\n        {\n          type: 'mdxJsxAttribute',\n          name: 'alt',\n          value: node.alt ?? 'image',\n        },\n      ];\n\n      if (node.title) {\n        attributes.push({\n          type: 'mdxJsxAttribute',\n          name: 'title',\n          value: node.title,\n        });\n      }\n\n      if (src.type === 'file' && useImport) {\n        // Unique variable name for the given static image URL\n        const variableName = `__img${importsToInject.length}`;\n        const hasBlur =\n          placeholder === 'blur' && VALID_BLUR_EXT.some((ext) => src.file.endsWith(ext));\n\n        if (!file.dirname) {\n          throw new Error(\n            'When `useImport` is enabled, you must specify `dirname` in the VFile passed to compiler.',\n          );\n        }\n\n        importsToInject.push({\n          variableName,\n          importPath: getImportPath(src.file, file.dirname),\n        });\n\n        attributes.push({\n          type: 'mdxJsxAttribute',\n          name: 'src',\n          value: {\n            type: 'mdxJsxAttributeValueExpression',\n            value: variableName,\n            data: {\n              estree: {\n                body: [\n                  {\n                    type: 'ExpressionStatement',\n                    expression: { type: 'Identifier', name: variableName },\n                  },\n                ],\n                type: 'Program',\n                sourceType: 'script',\n              },\n            },\n          },\n        });\n\n        const out: MdxJsxFlowElement = {\n          children: [],\n          type: 'mdxJsxFlowElement',\n          name: 'img',\n          attributes,\n        };\n\n        if (hasBlur) {\n          out.attributes.push({\n            type: 'mdxJsxAttribute',\n            name: 'placeholder',\n            value: 'blur',\n          });\n        }\n\n        return out;\n      }\n\n      const size = await getImageSize(src, external).catch((e) => {\n        throw new Error(\n          `[Remark Image] Failed obtain image size for ${node.url} (public directory configured as ${publicDir})`,\n          {\n            cause: e,\n          },\n        );\n      });\n\n      if (!size) return;\n\n      attributes.push(\n        {\n          type: 'mdxJsxAttribute',\n          name: 'src',\n          // `src` doesn't support file paths, we can use `node.url` for files and let the underlying framework handle it\n          value: src.type === 'url' ? src.url.toString() : node.url,\n        },\n        {\n          type: 'mdxJsxAttribute',\n          name: 'width',\n          value: size.width.toString(),\n        },\n        {\n          type: 'mdxJsxAttribute',\n          name: 'height',\n          value: size.height.toString(),\n        },\n      );\n\n      return {\n        type: 'mdxJsxFlowElement',\n        name: 'img',\n        attributes,\n        children: [],\n      };\n    }\n\n    visit(tree, 'image', (node) => {\n      const src = parseSrc(decodeURI(node.url), publicDir, file.dirname);\n      if (!src) return;\n\n      const task = onImage(src, node)\n        .catch((e) => {\n          // ignore SVG as it is not always needed\n          if (onError === 'ignore' || node.url.endsWith('.svg')) {\n            return;\n          }\n\n          if (onError === 'hide') {\n            return {\n              type: 'mdxJsxFlowElement',\n              name: null,\n              attributes: [],\n              children: [],\n            } satisfies MdxJsxFlowElement;\n          }\n\n          if (onError === 'error') throw e;\n          onError(e);\n        })\n        .then((res) => {\n          if (res) Object.assign(node, res);\n        });\n\n      promises.push(task);\n    });\n\n    await Promise.all(promises);\n    if (importsToInject.length === 0) return;\n\n    const imports = importsToInject.map(\n      ({ variableName, importPath }) =>\n        ({\n          type: 'mdxjsEsm',\n          data: {\n            estree: {\n              body: [\n                {\n                  type: 'ImportDeclaration',\n                  source: { type: 'Literal', value: importPath },\n                  specifiers: [\n                    {\n                      type: 'ImportDefaultSpecifier',\n                      local: { type: 'Identifier', name: variableName },\n                    },\n                  ],\n                },\n              ],\n            },\n          },\n        }) as MdxjsEsm,\n    );\n\n    tree.children.unshift(...imports);\n  };\n}\n\nfunction getImportPath(file: string, dir: string): string {\n  const relative = path.relative(dir, file).replaceAll(path.sep, '/');\n\n  return relative.startsWith('../') ? relative : `./${relative}`;\n}\n\n/**\n * @param src - src href\n * @param publicDir - dir/url to resolve absolute paths\n * @param dir - dir to resolve relative paths\n */\nfunction parseSrc(src: string, publicDir: string, dir?: string): Source | undefined {\n  if (src.startsWith('file:///')) return { type: 'file', file: fileURLToPath(src) };\n\n  if (EXTERNAL_URL_REGEX.test(src)) {\n    return {\n      type: 'url',\n      url: new URL(src),\n    };\n  }\n\n  if (src.startsWith('/')) {\n    if (EXTERNAL_URL_REGEX.test(publicDir)) {\n      const url = new URL(publicDir);\n      const segs = [...url.pathname.split('/'), ...src.split('/')].filter((v) => v.length > 0);\n\n      url.pathname = `/${segs.join('/')}`;\n      return { type: 'url', url };\n    }\n\n    return {\n      type: 'file',\n      file: path.join(publicDir, src),\n    };\n  }\n\n  if (!dir) {\n    console.warn(\n      `[Remark Image] found relative path ${src} but missing 'dirname' in VFile, this image will be skipped for now.`,\n    );\n    return;\n  }\n\n  return {\n    type: 'file',\n    file: path.join(dir, src),\n  };\n}\n\nasync function getImageSize(\n  src: Source,\n  onExternal: ExternalImageOptions,\n): Promise<ISizeCalculationResult | undefined> {\n  if (src.type === 'file') {\n    const { imageSizeFromFile } = await import('image-size/fromFile');\n    return imageSizeFromFile(src.file);\n  }\n  if (onExternal === false) return;\n\n  const { timeout } = typeof onExternal === 'object' ? onExternal : {};\n  const res = await fetch(src.url, {\n    signal: typeof timeout === 'number' ? AbortSignal.timeout(timeout) : undefined,\n  });\n  if (!res.ok) {\n    throw new Error(\n      `[Remark Image] Failed to fetch ${src.url} (${res.status}): ${await res.text()}`,\n    );\n  }\n\n  const { imageSize } = await import('image-size');\n  return imageSize(new Uint8Array(await res.arrayBuffer()));\n}\n"],"mappings":"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"}

package/dist/mdx-plugins/remark-mdx-files.d.ts

@@ -1,40 +1,2 @@
-import { Root } from 'mdast';
-import { Transformer } from 'unified';
-import { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';
-
-interface FileNode {
-    depth: number;
-    type: 'file';
-    name: string;
-}
-interface FolderNode {
-    depth: number;
-    type: 'folder';
-    name: string;
-    children: Node[];
-}
-type Node = FileNode | FolderNode;
-interface RemarkMdxFilesOptions {
-    /**
-     * @defaultValue files
-     */
-    lang?: string;
-    toMdx?: (node: Node) => MdxJsxFlowElement;
-}
-/**
- * Convert codeblocks with `files` as lang, like:
- *
- * ```files
- * project
- * ├── src
- * │   ├── index.js
- * │   └── utils
- * │       └── helper.js
- * ├── package.json
- * ```
- *
- * into MDX `<Files />` component
- */
-declare function remarkMdxFiles(options?: RemarkMdxFilesOptions): Transformer<Root, Root>;
-
-export { type RemarkMdxFilesOptions, remarkMdxFiles };
+import { n as remarkMdxFiles, t as RemarkMdxFilesOptions } from "../remark-mdx-files-DOYafA4x.js";
+export { RemarkMdxFilesOptions, remarkMdxFiles };

package/dist/mdx-plugins/remark-mdx-files.js

@@ -1,7 +1,96 @@
-import {
-  remarkMdxFiles
-} from "../chunk-ADBHPKXG.js";
-import "../chunk-U67V476Y.js";
-export {
-  remarkMdxFiles
-};
+import { visit } from "unist-util-visit";
+
+//#region src/mdx-plugins/remark-mdx-files.ts
+function parseFileTree(code) {
+	const lines = code.split(/\r?\n/);
+	const stack = /* @__PURE__ */ new Map();
+	for (const line of lines) {
+		let depth = 0;
+		let name = line;
+		let match;
+		while (match = /(?:├──|│|└──)\s*/.exec(name)) {
+			name = name.slice(match[0].length);
+			depth++;
+		}
+		if (!name) continue;
+		const node = name.endsWith("/") ? {
+			type: "folder",
+			name,
+			children: [],
+			depth
+		} : {
+			type: "file",
+			name,
+			depth
+		};
+		let parent;
+		for (let i = depth - 1; i >= 0 && !parent; i--) parent = stack.get(i);
+		stack.set(depth, node);
+		if (!parent) continue;
+		if (parent.type === "file") Object.assign(parent, {
+			type: "folder",
+			children: []
+		});
+		parent.children.push(node);
+	}
+	return stack.get(0);
+}
+function defaultToMDX(node, depth = 0) {
+	if (depth === 0) return {
+		type: "mdxJsxFlowElement",
+		name: "Files",
+		attributes: [],
+		children: [defaultToMDX(node, depth + 1)]
+	};
+	const attributes = [{
+		type: "mdxJsxAttribute",
+		name: "name",
+		value: node.name
+	}];
+	if (node.type === "file") return {
+		type: "mdxJsxFlowElement",
+		attributes,
+		children: [],
+		name: "File"
+	};
+	attributes.push({
+		type: "mdxJsxAttribute",
+		name: "defaultOpen",
+		value: null
+	});
+	return {
+		type: "mdxJsxFlowElement",
+		attributes,
+		name: "Folder",
+		children: node.children.map((item) => defaultToMDX(item, depth + 1))
+	};
+}
+/**
+* Convert codeblocks with `files` as lang, like:
+*
+* ```files
+* project
+* ├── src
+* │   ├── index.js
+* │   └── utils
+* │       └── helper.js
+* ├── package.json
+* ```
+*
+* into MDX `<Files />` component
+*/
+function remarkMdxFiles(options = {}) {
+	const { lang = "files", toMdx = defaultToMDX } = options;
+	return (tree) => {
+		visit(tree, "code", (node) => {
+			if (node.lang !== lang || !node.value) return;
+			const fileTree = parseFileTree(node.value);
+			if (!fileTree) return;
+			Object.assign(node, toMdx(fileTree));
+		});
+	};
+}
+
+//#endregion
+export { remarkMdxFiles };
+//# sourceMappingURL=remark-mdx-files.js.map

package/dist/mdx-plugins/remark-mdx-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-mdx-files.js","names":["match: RegExpMatchArray | null","node: Node","parent: Node | undefined","attributes: MdxJsxAttribute[]"],"sources":["../../src/mdx-plugins/remark-mdx-files.ts"],"sourcesContent":["import type { Root } from 'mdast';\nimport { visit } from 'unist-util-visit';\nimport type { Transformer } from 'unified';\nimport type { MdxJsxAttribute, MdxJsxFlowElement } from 'mdast-util-mdx-jsx';\n\ninterface FileNode {\n  depth: number;\n  type: 'file';\n  name: string;\n}\n\ninterface FolderNode {\n  depth: number;\n  type: 'folder';\n  name: string;\n  children: Node[];\n}\n\ntype Node = FileNode | FolderNode;\n\nexport interface RemarkMdxFilesOptions {\n  /**\n   * @defaultValue files\n   */\n  lang?: string;\n  toMdx?: (node: Node) => MdxJsxFlowElement;\n}\n\nfunction parseFileTree(code: string) {\n  const lines = code.split(/\\r?\\n/);\n  const stack = new Map<number, Node>();\n\n  for (const line of lines) {\n    let depth = 0;\n    let name = line;\n    let match: RegExpMatchArray | null;\n\n    while ((match = /(?:├──|│|└──)\\s*/.exec(name))) {\n      name = name.slice(match[0].length);\n      depth++;\n    }\n\n    if (!name) continue;\n    const node: Node = name.endsWith('/')\n      ? { type: 'folder', name, children: [], depth }\n      : { type: 'file', name, depth };\n\n    let parent: Node | undefined;\n    for (let i = depth - 1; i >= 0 && !parent; i--) {\n      parent = stack.get(i);\n    }\n\n    stack.set(depth, node);\n    if (!parent) continue;\n    if (parent.type === 'file') {\n      Object.assign(parent, {\n        type: 'folder',\n        children: [],\n      });\n    }\n\n    (parent as FolderNode).children.push(node);\n  }\n\n  return stack.get(0);\n}\n\nfunction defaultToMDX(node: Node, depth = 0): MdxJsxFlowElement {\n  if (depth === 0) {\n    return {\n      type: 'mdxJsxFlowElement',\n      name: 'Files',\n      attributes: [],\n      children: [defaultToMDX(node, depth + 1)],\n    };\n  }\n\n  const attributes: MdxJsxAttribute[] = [\n    { type: 'mdxJsxAttribute', name: 'name', value: node.name },\n  ];\n\n  if (node.type === 'file') {\n    return {\n      type: 'mdxJsxFlowElement',\n      attributes,\n      children: [],\n      name: 'File',\n    };\n  }\n\n  attributes.push({\n    type: 'mdxJsxAttribute',\n    name: 'defaultOpen',\n    value: null,\n  });\n\n  return {\n    type: 'mdxJsxFlowElement',\n    attributes,\n    name: 'Folder',\n    children: node.children.map((item) => defaultToMDX(item, depth + 1)),\n  };\n}\n\n/**\n * Convert codeblocks with `files` as lang, like:\n *\n * ```files\n * project\n * ├── src\n * │   ├── index.js\n * │   └── utils\n * │       └── helper.js\n * ├── package.json\n * ```\n *\n * into MDX `<Files />` component\n */\nexport function remarkMdxFiles(options: RemarkMdxFilesOptions = {}): Transformer<Root, Root> {\n  const { lang = 'files', toMdx = defaultToMDX } = options;\n\n  return (tree) => {\n    visit(tree, 'code', (node) => {\n      if (node.lang !== lang || !node.value) return;\n\n      const fileTree = parseFileTree(node.value);\n      if (!fileTree) return;\n\n      Object.assign(node, toMdx(fileTree));\n    });\n  };\n}\n"],"mappings":";;;AA4BA,SAAS,cAAc,MAAc;CACnC,MAAM,QAAQ,KAAK,MAAM,QAAQ;CACjC,MAAM,wBAAQ,IAAI,KAAmB;AAErC,MAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,QAAQ;EACZ,IAAI,OAAO;EACX,IAAIA;AAEJ,SAAQ,QAAQ,mBAAmB,KAAK,KAAK,EAAG;AAC9C,UAAO,KAAK,MAAM,MAAM,GAAG,OAAO;AAClC;;AAGF,MAAI,CAAC,KAAM;EACX,MAAMC,OAAa,KAAK,SAAS,IAAI,GACjC;GAAE,MAAM;GAAU;GAAM,UAAU,EAAE;GAAE;GAAO,GAC7C;GAAE,MAAM;GAAQ;GAAM;GAAO;EAEjC,IAAIC;AACJ,OAAK,IAAI,IAAI,QAAQ,GAAG,KAAK,KAAK,CAAC,QAAQ,IACzC,UAAS,MAAM,IAAI,EAAE;AAGvB,QAAM,IAAI,OAAO,KAAK;AACtB,MAAI,CAAC,OAAQ;AACb,MAAI,OAAO,SAAS,OAClB,QAAO,OAAO,QAAQ;GACpB,MAAM;GACN,UAAU,EAAE;GACb,CAAC;AAGJ,EAAC,OAAsB,SAAS,KAAK,KAAK;;AAG5C,QAAO,MAAM,IAAI,EAAE;;AAGrB,SAAS,aAAa,MAAY,QAAQ,GAAsB;AAC9D,KAAI,UAAU,EACZ,QAAO;EACL,MAAM;EACN,MAAM;EACN,YAAY,EAAE;EACd,UAAU,CAAC,aAAa,MAAM,QAAQ,EAAE,CAAC;EAC1C;CAGH,MAAMC,aAAgC,CACpC;EAAE,MAAM;EAAmB,MAAM;EAAQ,OAAO,KAAK;EAAM,CAC5D;AAED,KAAI,KAAK,SAAS,OAChB,QAAO;EACL,MAAM;EACN;EACA,UAAU,EAAE;EACZ,MAAM;EACP;AAGH,YAAW,KAAK;EACd,MAAM;EACN,MAAM;EACN,OAAO;EACR,CAAC;AAEF,QAAO;EACL,MAAM;EACN;EACA,MAAM;EACN,UAAU,KAAK,SAAS,KAAK,SAAS,aAAa,MAAM,QAAQ,EAAE,CAAC;EACrE;;;;;;;;;;;;;;;;AAiBH,SAAgB,eAAe,UAAiC,EAAE,EAA2B;CAC3F,MAAM,EAAE,OAAO,SAAS,QAAQ,iBAAiB;AAEjD,SAAQ,SAAS;AACf,QAAM,MAAM,SAAS,SAAS;AAC5B,OAAI,KAAK,SAAS,QAAQ,CAAC,KAAK,MAAO;GAEvC,MAAM,WAAW,cAAc,KAAK,MAAM;AAC1C,OAAI,CAAC,SAAU;AAEf,UAAO,OAAO,MAAM,MAAM,SAAS,CAAC;IACpC"}

package/dist/mdx-plugins/remark-mdx-mermaid.d.ts

@@ -1,15 +1,2 @@
-import { Transformer } from 'unified';
-import { Root } from 'mdast';
-
-interface RemarkMdxMermaidOptions {
-    /**
-     * @defaultValue mermaid
-     */
-    lang?: string;
-}
-/**
- * Convert `mermaid` codeblocks into `<Mermaid />` MDX component
- */
-declare function remarkMdxMermaid(options?: RemarkMdxMermaidOptions): Transformer<Root, Root>;
-
-export { type RemarkMdxMermaidOptions, remarkMdxMermaid };
+import { n as remarkMdxMermaid, t as RemarkMdxMermaidOptions } from "../remark-mdx-mermaid-BdSUUiCG.js";
+export { RemarkMdxMermaidOptions, remarkMdxMermaid };

package/dist/mdx-plugins/remark-mdx-mermaid.js

@@ -1,7 +1,31 @@
-import {
-  remarkMdxMermaid
-} from "../chunk-FUUVPEA5.js";
-import "../chunk-U67V476Y.js";
-export {
-  remarkMdxMermaid
-};
+import { visit } from "unist-util-visit";
+
+//#region src/mdx-plugins/remark-mdx-mermaid.ts
+function toMDX(code) {
+	return {
+		type: "mdxJsxFlowElement",
+		name: "Mermaid",
+		attributes: [{
+			type: "mdxJsxAttribute",
+			name: "chart",
+			value: code.trim()
+		}],
+		children: []
+	};
+}
+/**
+* Convert `mermaid` codeblocks into `<Mermaid />` MDX component
+*/
+function remarkMdxMermaid(options = {}) {
+	const { lang = "mermaid" } = options;
+	return (tree) => {
+		visit(tree, "code", (node) => {
+			if (node.lang !== lang || !node.value) return;
+			Object.assign(node, toMDX(node.value));
+		});
+	};
+}
+
+//#endregion
+export { remarkMdxMermaid };
+//# sourceMappingURL=remark-mdx-mermaid.js.map

package/dist/mdx-plugins/remark-mdx-mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-mdx-mermaid.js","names":[],"sources":["../../src/mdx-plugins/remark-mdx-mermaid.ts"],"sourcesContent":["import { visit } from 'unist-util-visit';\nimport type { Transformer } from 'unified';\nimport type { Root } from 'mdast';\nimport type { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';\n\nfunction toMDX(code: string): MdxJsxFlowElement {\n  return {\n    type: 'mdxJsxFlowElement',\n    name: 'Mermaid',\n    attributes: [\n      {\n        type: 'mdxJsxAttribute',\n        name: 'chart',\n        value: code.trim(),\n      },\n    ],\n    children: [],\n  };\n}\n\nexport interface RemarkMdxMermaidOptions {\n  /**\n   * @defaultValue mermaid\n   */\n  lang?: string;\n}\n\n/**\n * Convert `mermaid` codeblocks into `<Mermaid />` MDX component\n */\nexport function remarkMdxMermaid(options: RemarkMdxMermaidOptions = {}): Transformer<Root, Root> {\n  const { lang = 'mermaid' } = options;\n\n  return (tree) => {\n    visit(tree, 'code', (node) => {\n      if (node.lang !== lang || !node.value) return;\n\n      Object.assign(node, toMDX(node.value));\n    });\n  };\n}\n"],"mappings":";;;AAKA,SAAS,MAAM,MAAiC;AAC9C,QAAO;EACL,MAAM;EACN,MAAM;EACN,YAAY,CACV;GACE,MAAM;GACN,MAAM;GACN,OAAO,KAAK,MAAM;GACnB,CACF;EACD,UAAU,EAAE;EACb;;;;;AAaH,SAAgB,iBAAiB,UAAmC,EAAE,EAA2B;CAC/F,MAAM,EAAE,OAAO,cAAc;AAE7B,SAAQ,SAAS;AACf,QAAM,MAAM,SAAS,SAAS;AAC5B,OAAI,KAAK,SAAS,QAAQ,CAAC,KAAK,MAAO;AAEvC,UAAO,OAAO,MAAM,MAAM,KAAK,MAAM,CAAC;IACtC"}

package/dist/mdx-plugins/remark-npm.d.ts

@@ -1,31 +1,2 @@
-import { Root } from 'mdast';
-import { Transformer } from 'unified';
-
-interface PackageManager {
-    name: string;
-    /**
-     * Default to `name`
-     */
-    value?: string;
-    /**
-     * Convert from npm to another package manager
-     */
-    command: (command: string) => string | undefined;
-}
-interface RemarkNpmOptions {
-    /**
-     * Persist Tab value (Fumadocs UI only)
-     *
-     * @defaultValue false
-     */
-    persist?: {
-        id: string;
-    } | false;
-    packageManagers?: PackageManager[];
-}
-/**
- * It generates multiple tabs of codeblocks for different package managers from a npm command codeblock.
- */
-declare function remarkNpm({ persist, packageManagers, }?: RemarkNpmOptions): Transformer<Root, Root>;
-
-export { type RemarkNpmOptions, remarkNpm };
+import { n as remarkNpm, t as RemarkNpmOptions } from "../remark-npm-BIvIEKT2.js";
+export { RemarkNpmOptions, remarkNpm };

package/dist/mdx-plugins/remark-npm.js

@@ -1,8 +1,68 @@
-import {
-  remarkNpm
-} from "../chunk-GLRQBLGN.js";
-import "../chunk-TWIDBWFG.js";
-import "../chunk-U67V476Y.js";
-export {
-  remarkNpm
-};
+import { generateCodeBlockTabs } from "./codeblock-utils.js";
+import { visit } from "unist-util-visit";
+import convert from "npm-to-yarn";
+
+//#region src/mdx-plugins/remark-npm.ts
+const aliases = ["npm", "package-install"];
+/**
+* It generates multiple tabs of codeblocks for different package managers from a npm command codeblock.
+*/
+function remarkNpm({ persist = false, packageManagers = [
+	{
+		command: (cmd) => convert(cmd, "npm"),
+		name: "npm"
+	},
+	{
+		command: (cmd) => convert(cmd, "pnpm"),
+		name: "pnpm"
+	},
+	{
+		command: (cmd) => convert(cmd, "yarn"),
+		name: "yarn"
+	},
+	{
+		command: (cmd) => convert(cmd, "bun"),
+		name: "bun"
+	}
+] } = {}) {
+	return (tree) => {
+		visit(tree, "code", (node) => {
+			if (!node.lang || !aliases.includes(node.lang)) return;
+			let code = node.value;
+			if (node.lang === "package-install" && !code.startsWith("npm") && !code.startsWith("npx")) code = `npm install ${code}`;
+			const options = {
+				persist,
+				tabs: [],
+				triggers: []
+			};
+			for (const manager of packageManagers) {
+				const value = manager.value ?? manager.name;
+				const command = manager.command(code);
+				if (!command || command.length === 0) continue;
+				options.defaultValue ??= value;
+				options.triggers.push({
+					value,
+					children: [{
+						type: "text",
+						value: manager.name
+					}]
+				});
+				options.tabs.push({
+					value,
+					children: [{
+						type: "code",
+						lang: "bash",
+						meta: node.meta,
+						value: command
+					}]
+				});
+			}
+			Object.assign(node, generateCodeBlockTabs(options));
+			return "skip";
+		});
+	};
+}
+
+//#endregion
+export { remarkNpm };
+//# sourceMappingURL=remark-npm.js.map

package/dist/mdx-plugins/remark-npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-npm.js","names":["options: CodeBlockTabsOptions"],"sources":["../../src/mdx-plugins/remark-npm.ts"],"sourcesContent":["import type { Root } from 'mdast';\nimport type { Transformer } from 'unified';\nimport { visit } from 'unist-util-visit';\nimport convert from 'npm-to-yarn';\nimport { type CodeBlockTabsOptions, generateCodeBlockTabs } from '@/mdx-plugins/codeblock-utils';\n\ninterface PackageManager {\n  name: string;\n\n  /**\n   * Default to `name`\n   */\n  value?: string;\n\n  /**\n   * Convert from npm to another package manager\n   */\n  command: (command: string) => string | undefined;\n}\n\nexport interface RemarkNpmOptions {\n  /**\n   * Persist Tab value (Fumadocs UI only)\n   *\n   * @defaultValue false\n   */\n  persist?:\n    | {\n        id: string;\n      }\n    | false;\n\n  packageManagers?: PackageManager[];\n}\n\nconst aliases = ['npm', 'package-install'];\n\n/**\n * It generates multiple tabs of codeblocks for different package managers from a npm command codeblock.\n */\nexport function remarkNpm({\n  persist = false,\n  packageManagers = [\n    { command: (cmd) => convert(cmd, 'npm'), name: 'npm' },\n    { command: (cmd) => convert(cmd, 'pnpm'), name: 'pnpm' },\n    { command: (cmd) => convert(cmd, 'yarn'), name: 'yarn' },\n    { command: (cmd) => convert(cmd, 'bun'), name: 'bun' },\n  ],\n}: RemarkNpmOptions = {}): Transformer<Root, Root> {\n  return (tree) => {\n    visit(tree, 'code', (node) => {\n      if (!node.lang || !aliases.includes(node.lang)) return;\n      let code = node.value;\n\n      if (node.lang === 'package-install' && !code.startsWith('npm') && !code.startsWith('npx')) {\n        code = `npm install ${code}`;\n      }\n      const options: CodeBlockTabsOptions = {\n        persist,\n        tabs: [],\n        triggers: [],\n      };\n\n      for (const manager of packageManagers) {\n        const value = manager.value ?? manager.name;\n        const command = manager.command(code);\n        if (!command || command.length === 0) continue;\n\n        options.defaultValue ??= value;\n        options.triggers.push({\n          value,\n          children: [{ type: 'text', value: manager.name }],\n        });\n        options.tabs.push({\n          value,\n          children: [\n            {\n              type: 'code',\n              lang: 'bash',\n              meta: node.meta,\n              value: command,\n            },\n          ],\n        });\n      }\n\n      Object.assign(node, generateCodeBlockTabs(options));\n      return 'skip';\n    });\n  };\n}\n"],"mappings":";;;;;AAmCA,MAAM,UAAU,CAAC,OAAO,kBAAkB;;;;AAK1C,SAAgB,UAAU,EACxB,UAAU,OACV,kBAAkB;CAChB;EAAE,UAAU,QAAQ,QAAQ,KAAK,MAAM;EAAE,MAAM;EAAO;CACtD;EAAE,UAAU,QAAQ,QAAQ,KAAK,OAAO;EAAE,MAAM;EAAQ;CACxD;EAAE,UAAU,QAAQ,QAAQ,KAAK,OAAO;EAAE,MAAM;EAAQ;CACxD;EAAE,UAAU,QAAQ,QAAQ,KAAK,MAAM;EAAE,MAAM;EAAO;CACvD,KACmB,EAAE,EAA2B;AACjD,SAAQ,SAAS;AACf,QAAM,MAAM,SAAS,SAAS;AAC5B,OAAI,CAAC,KAAK,QAAQ,CAAC,QAAQ,SAAS,KAAK,KAAK,CAAE;GAChD,IAAI,OAAO,KAAK;AAEhB,OAAI,KAAK,SAAS,qBAAqB,CAAC,KAAK,WAAW,MAAM,IAAI,CAAC,KAAK,WAAW,MAAM,CACvF,QAAO,eAAe;GAExB,MAAMA,UAAgC;IACpC;IACA,MAAM,EAAE;IACR,UAAU,EAAE;IACb;AAED,QAAK,MAAM,WAAW,iBAAiB;IACrC,MAAM,QAAQ,QAAQ,SAAS,QAAQ;IACvC,MAAM,UAAU,QAAQ,QAAQ,KAAK;AACrC,QAAI,CAAC,WAAW,QAAQ,WAAW,EAAG;AAEtC,YAAQ,iBAAiB;AACzB,YAAQ,SAAS,KAAK;KACpB;KACA,UAAU,CAAC;MAAE,MAAM;MAAQ,OAAO,QAAQ;MAAM,CAAC;KAClD,CAAC;AACF,YAAQ,KAAK,KAAK;KAChB;KACA,UAAU,CACR;MACE,MAAM;MACN,MAAM;MACN,MAAM,KAAK;MACX,OAAO;MACR,CACF;KACF,CAAC;;AAGJ,UAAO,OAAO,MAAM,sBAAsB,QAAQ,CAAC;AACnD,UAAO;IACP"}

package/dist/mdx-plugins/remark-steps.d.ts

@@ -1,23 +1,2 @@
-import { Transformer } from 'unified';
-import { Root } from 'mdast';
-
-interface RemarkStepsOptions {
-    /**
-     * Class name for steps container
-     *
-     * @defaultValue fd-steps
-     */
-    steps?: string;
-    /**
-     * Class name for step container
-     *
-     * @defaultValue fd-step
-     */
-    step?: string;
-}
-/**
- * Convert headings in the format of `1. Hello World` into steps.
- */
-declare function remarkSteps({ steps, step, }?: RemarkStepsOptions): Transformer<Root, Root>;
-
-export { type RemarkStepsOptions, remarkSteps };
+import { n as remarkSteps, t as RemarkStepsOptions } from "../remark-steps-CHJN-rtm.js";
+export { RemarkStepsOptions, remarkSteps };