fumadocs-epub 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -28,7 +28,7 @@ interface EpubConfig {
 interface EpubExportOptions<Config extends LoaderConfig = LoaderConfig> extends EpubConfig {
   /** Fumadocs source (from loader()) */
   source: LoaderOutput<Config>;
-  /** fucntion to get page Markdown content */
+  /** function to get page Markdown content */
   getMarkdown?: (page: Page<Config['source']['pageData']>) => string | undefined | Promise<string | undefined>;
 }
 //#endregion

package/dist/index.js

@@ -8,7 +8,6 @@ import rehypeStringify from "rehype-stringify";
 import { visit } from "unist-util-visit";
 import { remark } from "remark";
 import fs from "node:fs";
-
 //#region src/toc-builder.ts
 /**
 * Get pages in the order they appear in the page tree (navigation order).
@@ -25,7 +24,6 @@ function getPagesInTreeOrder(pageTree, getNodePage) {
 	}
 	return pages;
 }
-
 //#endregion
 //#region src/image-resolver.ts
 /**
@@ -44,7 +42,6 @@ function resolveImageSrc(src, pageDir, publicDir) {
 	const resolved = path.resolve(pageDir, src);
 	if (fs.existsSync(resolved)) return pathToFileURL(resolved).href;
 }
-
 //#endregion
 //#region src/markdown-to-html.ts
 const processor = remark().use(remarkGfm).use(remarkResolveImg).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeStringify, { allowDangerousHtml: true });
@@ -73,7 +70,6 @@ async function markdownToHtml(markdown, pageDir, publicDir) {
 	});
 	return String(result);
 }
-
 //#endregion
 //#region src/default-styles.ts
 /**
@@ -160,7 +156,6 @@ a {
   color: #0066cc;
 }
 `;
-
 //#endregion
 //#region src/index.ts
 /**
@@ -252,7 +247,7 @@ async function exportEpub(options) {
 	}
 	return buffer;
 }
-
 //#endregion
 export { defaultEpubStyles, exportEpub };
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/toc-builder.ts","../src/image-resolver.ts","../src/markdown-to-html.ts","../src/default-styles.ts","../src/index.ts"],"sourcesContent":["import type * as PageTree from 'fumadocs-core/page-tree';\nimport { flattenTree } from 'fumadocs-core/page-tree';\n\n/**\n * Get pages in the order they appear in the page tree (navigation order).\n * Uses flattenTree to traverse the tree depth-first, resolving each Item to a page.\n */\nexport function getPagesInTreeOrder<Page>(\n  pageTree: PageTree.Root,\n  getNodePage: (node: PageTree.Item) => Page | undefined,\n): Page[] {\n  const mainItems = flattenTree(pageTree.children);\n  const fallbackItems = pageTree.fallback ? flattenTree(pageTree.fallback.children) : [];\n  const items = [...mainItems, ...fallbackItems];\n  const pages: Page[] = [];\n\n  for (const item of items) {\n    const page = getNodePage(item);\n    if (page) {\n      pages.push(page);\n    }\n  }\n\n  return pages;\n}\n","import path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport fs from 'node:fs';\n\n/**\n * Resolve image src to file:// URL for epub-gen-memory to embed.\n * Handles relative paths (resolved from page dir), absolute paths, and remote URLs.\n */\nexport function resolveImageSrc(\n  src: string,\n  pageDir: string,\n  publicDir: string,\n): string | undefined {\n  // Already a file:// URL\n  if (src.startsWith('file://')) {\n    return src;\n  }\n\n  // Remote URL - epub-gen-memory can fetch these\n  if (src.startsWith('http://') || src.startsWith('https://')) {\n    return src;\n  }\n\n  // Data URL - pass through\n  if (src.startsWith('data:')) {\n    return src;\n  }\n\n  // Protocol-relative URL (//cdn.example.com/...) - normalize to https:\n  if (src.startsWith('//')) {\n    return `https:${src}`;\n  }\n\n  // Absolute path starting with / - could be from public dir\n  if (src.startsWith('/')) {\n    const resolved = path.join(publicDir, src.slice(1));\n    if (fs.existsSync(resolved)) return pathToFileURL(resolved).href;\n  }\n  // Relative path or others - resolve from page directory\n  const resolved = path.resolve(pageDir, src);\n  if (fs.existsSync(resolved)) return pathToFileURL(resolved).href;\n}\n","import type { Transformer } from 'unified';\nimport remarkGfm from 'remark-gfm';\nimport remarkRehype from 'remark-rehype';\nimport rehypeStringify from 'rehype-stringify';\nimport type { Root } from 'mdast';\nimport { visit } from 'unist-util-visit';\nimport { remark } from 'remark';\nimport { resolveImageSrc } from './image-resolver';\n\nconst processor = remark()\n  .use(remarkGfm)\n  .use(remarkResolveImg)\n  .use(remarkRehype, { allowDangerousHtml: true })\n  .use(rehypeStringify, { allowDangerousHtml: true });\n\ndeclare module 'vfile' {\n  export interface DataMap {\n    pageDir: string;\n    publicDir: string;\n  }\n}\n\nfunction remarkResolveImg(): Transformer<Root, Root> {\n  return (tree, file) => {\n    const { pageDir, publicDir } = file.data;\n    if (!pageDir || !publicDir) return;\n\n    visit(tree, 'image', (node, idx, parent) => {\n      const resolved = resolveImageSrc(node.url, pageDir, publicDir);\n      if (resolved) {\n        node.url = resolved;\n      } else if (idx !== undefined && parent) {\n        parent.children.splice(idx, 1);\n      }\n    });\n  };\n}\n\n/**\n * Convert markdown string to HTML suitable for EPUB chapters.\n * Uses unified pipeline: remark-parse -> remark-gfm -> remark-rehype -> rehype-stringify\n */\nexport async function markdownToHtml(\n  markdown: string,\n  pageDir: string,\n  publicDir: string,\n): Promise<string> {\n  const result = await processor.process({\n    value: markdown,\n    data: {\n      pageDir,\n      publicDir,\n    },\n  });\n  return String(result);\n}\n","/**\n * Minimal, readable CSS stylesheet suitable for e-readers.\n */\nexport const defaultEpubStyles = `\nbody {\n  font-family: Georgia, serif;\n  font-size: 1em;\n  line-height: 1.6;\n  margin: 1em;\n}\n\nh1, h2, h3, h4, h5, h6 {\n  font-family: Georgia, serif;\n  margin-top: 1.5em;\n  margin-bottom: 0.5em;\n  page-break-after: avoid;\n}\n\nh1 { font-size: 1.5em; }\nh2 { font-size: 1.3em; }\nh3 { font-size: 1.15em; }\n\npre, code {\n  font-family: \"Consolas\", \"Monaco\", \"Courier New\", monospace;\n  font-size: 0.9em;\n}\n\npre {\n  background: #f5f5f5;\n  padding: 1em;\n  overflow-x: auto;\n  page-break-inside: avoid;\n}\n\ncode {\n  background: #f5f5f5;\n  padding: 0.2em 0.4em;\n}\n\npre code {\n  background: none;\n  padding: 0;\n}\n\nimg {\n  max-width: 100%;\n  height: auto;\n}\n\nblockquote {\n  margin: 1em 0;\n  padding-left: 1em;\n  border-left: 4px solid #ccc;\n  color: #555;\n}\n\ntable {\n  border-collapse: collapse;\n  width: 100%;\n  page-break-inside: avoid;\n}\n\nth, td {\n  border: 1px solid #ddd;\n  padding: 0.5em;\n}\n\nth {\n  background: #f5f5f5;\n}\n\np {\n  margin: 0.75em 0;\n}\n\nul, ol {\n  margin: 0.75em 0;\n  padding-left: 1.5em;\n}\n\na {\n  color: #0066cc;\n}\n`;\n","import epub, { type Options } from 'epub-gen-memory';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { LoaderConfig, Page } from 'fumadocs-core/source';\nimport { getPagesInTreeOrder } from './toc-builder';\nimport { markdownToHtml } from './markdown-to-html';\nimport { defaultEpubStyles } from './default-styles';\nimport type { EpubExportOptions } from './types';\n\nexport { defaultEpubStyles } from './default-styles';\nexport type { EpubConfig, EpubExportOptions } from './types';\n\n/**\n * Get page directory for resolving relative image paths\n */\nfunction getPageDir(page: Page, cwd: string): string {\n  if (page.absolutePath) {\n    return path.dirname(page.absolutePath);\n  }\n  return path.resolve(cwd, path.dirname(page.path));\n}\n\n/**\n * Resolve cover image path - support file://, http(s)://, /public/..., or relative\n */\nfunction resolveCoverPath(\n  cover: string | undefined,\n  cwd: string,\n  publicDir?: string,\n): string | undefined {\n  if (!cover) return undefined;\n  if (cover.startsWith('file://') || cover.startsWith('http://') || cover.startsWith('https://'))\n    return cover;\n  if (cover.startsWith('/')) {\n    const base = publicDir ?? path.join(cwd, 'public');\n    return pathToFileUrl(path.join(base, cover.slice(1)));\n  }\n  return pathToFileUrl(path.resolve(cwd, cover));\n}\n\nfunction pathToFileUrl(filePath: string): string {\n  return pathToFileURL(filePath).href;\n}\n\n/**\n * Export Fumadocs documentation to EPUB format.\n *\n * @param options - Export configuration with source and epub config\n * @returns Promise resolving to the EPUB file as a Buffer\n *\n * @example\n * ```ts\n * import { exportEpub } from 'fumadocs-epub';\n * import { source } from '@/lib/source';\n *\n * const buffer = await exportEpub({\n *   source,\n *   title: 'My Documentation',\n *   author: 'My Team',\n *   cover: '/cover.png',\n * });\n * ```\n */\nexport async function exportEpub<C extends LoaderConfig>(\n  options: EpubExportOptions<C>,\n): Promise<Buffer> {\n  const cwd = process.cwd();\n  const {\n    source,\n    getMarkdown = async (page) => {\n      try {\n        return await (page.data as { getText: (type: string) => Promise<string> }).getText('raw');\n      } catch {\n        console.warn(\n          `Failed to get processed markdown for page \"${page.absolutePath ?? page.path}\", please specify the \"getMarkdown\" option.`,\n        );\n      }\n    },\n    title,\n    author = 'anonymous',\n    description,\n    language = 'en',\n    publisher = 'anonymous',\n    cover,\n    outputPath,\n    includePages,\n    excludePages,\n    css,\n    publicDir = path.resolve('public'),\n  } = options;\n\n  // Get pages in tree order (navigation order)\n  const pageTree = source.getPageTree();\n  const orderedPages = getPagesInTreeOrder(pageTree, (node) => source.getNodePage?.(node)).filter(\n    (p): p is Page => p != null,\n  );\n\n  // Fallback to getPages() if tree order yields no pages (e.g. i18n)\n  const pages = orderedPages.length > 0 ? orderedPages : source.getPages();\n\n  // Filter pages\n  const filteredPages = pages.filter((page) => {\n    if (includePages && !includePages(page)) return false;\n    if (excludePages && excludePages(page)) return false;\n    return true;\n  });\n\n  const chapters: { title: string; content: string }[] = [];\n\n  for (const page of filteredPages) {\n    const markdown = await getMarkdown(page);\n    if (!markdown) continue;\n\n    const pageDir = getPageDir(page, cwd);\n    const html = await markdownToHtml(markdown, pageDir, publicDir);\n    const pageTitle = page.data.title ?? page.slugs[page.slugs.length - 1] ?? 'Untitled';\n\n    chapters.push({\n      title: pageTitle,\n      content: html,\n    });\n  }\n\n  const epubOptions: Options = {\n    title,\n    author: Array.isArray(author) ? author : [author],\n    description,\n    lang: language,\n    publisher,\n    cover: resolveCoverPath(cover, cwd, publicDir) ?? cover,\n    css: css ?? defaultEpubStyles,\n    prependChapterTitles: true,\n    numberChaptersInTOC: true,\n    tocTitle: 'Table of Contents',\n  };\n\n  const content = chapters.map((ch) => ({\n    title: ch.title,\n    content: ch.content,\n  }));\n\n  const buffer = await epub(epubOptions, content);\n\n  if (outputPath) {\n    const fs = await import('node:fs/promises');\n    await fs.mkdir(path.dirname(outputPath), { recursive: true });\n    await fs.writeFile(outputPath, buffer);\n  }\n  return buffer;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/toc-builder.ts","../src/image-resolver.ts","../src/markdown-to-html.ts","../src/default-styles.ts","../src/index.ts"],"sourcesContent":["import type * as PageTree from 'fumadocs-core/page-tree';\nimport { flattenTree } from 'fumadocs-core/page-tree';\n\n/**\n * Get pages in the order they appear in the page tree (navigation order).\n * Uses flattenTree to traverse the tree depth-first, resolving each Item to a page.\n */\nexport function getPagesInTreeOrder<Page>(\n  pageTree: PageTree.Root,\n  getNodePage: (node: PageTree.Item) => Page | undefined,\n): Page[] {\n  const mainItems = flattenTree(pageTree.children);\n  const fallbackItems = pageTree.fallback ? flattenTree(pageTree.fallback.children) : [];\n  const items = [...mainItems, ...fallbackItems];\n  const pages: Page[] = [];\n\n  for (const item of items) {\n    const page = getNodePage(item);\n    if (page) {\n      pages.push(page);\n    }\n  }\n\n  return pages;\n}\n","import path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport fs from 'node:fs';\n\n/**\n * Resolve image src to file:// URL for epub-gen-memory to embed.\n * Handles relative paths (resolved from page dir), absolute paths, and remote URLs.\n */\nexport function resolveImageSrc(\n  src: string,\n  pageDir: string,\n  publicDir: string,\n): string | undefined {\n  // Already a file:// URL\n  if (src.startsWith('file://')) {\n    return src;\n  }\n\n  // Remote URL - epub-gen-memory can fetch these\n  if (src.startsWith('http://') || src.startsWith('https://')) {\n    return src;\n  }\n\n  // Data URL - pass through\n  if (src.startsWith('data:')) {\n    return src;\n  }\n\n  // Protocol-relative URL (//cdn.example.com/...) - normalize to https:\n  if (src.startsWith('//')) {\n    return `https:${src}`;\n  }\n\n  // Absolute path starting with / - could be from public dir\n  if (src.startsWith('/')) {\n    const resolved = path.join(publicDir, src.slice(1));\n    if (fs.existsSync(resolved)) return pathToFileURL(resolved).href;\n  }\n  // Relative path or others - resolve from page directory\n  const resolved = path.resolve(pageDir, src);\n  if (fs.existsSync(resolved)) return pathToFileURL(resolved).href;\n}\n","import type { Transformer } from 'unified';\nimport remarkGfm from 'remark-gfm';\nimport remarkRehype from 'remark-rehype';\nimport rehypeStringify from 'rehype-stringify';\nimport type { Root } from 'mdast';\nimport { visit } from 'unist-util-visit';\nimport { remark } from 'remark';\nimport { resolveImageSrc } from './image-resolver';\n\nconst processor = remark()\n  .use(remarkGfm)\n  .use(remarkResolveImg)\n  .use(remarkRehype, { allowDangerousHtml: true })\n  .use(rehypeStringify, { allowDangerousHtml: true });\n\ndeclare module 'vfile' {\n  export interface DataMap {\n    pageDir: string;\n    publicDir: string;\n  }\n}\n\nfunction remarkResolveImg(): Transformer<Root, Root> {\n  return (tree, file) => {\n    const { pageDir, publicDir } = file.data;\n    if (!pageDir || !publicDir) return;\n\n    visit(tree, 'image', (node, idx, parent) => {\n      const resolved = resolveImageSrc(node.url, pageDir, publicDir);\n      if (resolved) {\n        node.url = resolved;\n      } else if (idx !== undefined && parent) {\n        parent.children.splice(idx, 1);\n      }\n    });\n  };\n}\n\n/**\n * Convert markdown string to HTML suitable for EPUB chapters.\n * Uses unified pipeline: remark-parse -> remark-gfm -> remark-rehype -> rehype-stringify\n */\nexport async function markdownToHtml(\n  markdown: string,\n  pageDir: string,\n  publicDir: string,\n): Promise<string> {\n  const result = await processor.process({\n    value: markdown,\n    data: {\n      pageDir,\n      publicDir,\n    },\n  });\n  return String(result);\n}\n","/**\n * Minimal, readable CSS stylesheet suitable for e-readers.\n */\nexport const defaultEpubStyles = `\nbody {\n  font-family: Georgia, serif;\n  font-size: 1em;\n  line-height: 1.6;\n  margin: 1em;\n}\n\nh1, h2, h3, h4, h5, h6 {\n  font-family: Georgia, serif;\n  margin-top: 1.5em;\n  margin-bottom: 0.5em;\n  page-break-after: avoid;\n}\n\nh1 { font-size: 1.5em; }\nh2 { font-size: 1.3em; }\nh3 { font-size: 1.15em; }\n\npre, code {\n  font-family: \"Consolas\", \"Monaco\", \"Courier New\", monospace;\n  font-size: 0.9em;\n}\n\npre {\n  background: #f5f5f5;\n  padding: 1em;\n  overflow-x: auto;\n  page-break-inside: avoid;\n}\n\ncode {\n  background: #f5f5f5;\n  padding: 0.2em 0.4em;\n}\n\npre code {\n  background: none;\n  padding: 0;\n}\n\nimg {\n  max-width: 100%;\n  height: auto;\n}\n\nblockquote {\n  margin: 1em 0;\n  padding-left: 1em;\n  border-left: 4px solid #ccc;\n  color: #555;\n}\n\ntable {\n  border-collapse: collapse;\n  width: 100%;\n  page-break-inside: avoid;\n}\n\nth, td {\n  border: 1px solid #ddd;\n  padding: 0.5em;\n}\n\nth {\n  background: #f5f5f5;\n}\n\np {\n  margin: 0.75em 0;\n}\n\nul, ol {\n  margin: 0.75em 0;\n  padding-left: 1.5em;\n}\n\na {\n  color: #0066cc;\n}\n`;\n","import epub, { type Options } from 'epub-gen-memory';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { LoaderConfig, Page } from 'fumadocs-core/source';\nimport { getPagesInTreeOrder } from './toc-builder';\nimport { markdownToHtml } from './markdown-to-html';\nimport { defaultEpubStyles } from './default-styles';\nimport type { EpubExportOptions } from './types';\n\nexport { defaultEpubStyles } from './default-styles';\nexport type { EpubConfig, EpubExportOptions } from './types';\n\n/**\n * Get page directory for resolving relative image paths\n */\nfunction getPageDir(page: Page, cwd: string): string {\n  if (page.absolutePath) {\n    return path.dirname(page.absolutePath);\n  }\n  return path.resolve(cwd, path.dirname(page.path));\n}\n\n/**\n * Resolve cover image path - support file://, http(s)://, /public/..., or relative\n */\nfunction resolveCoverPath(\n  cover: string | undefined,\n  cwd: string,\n  publicDir?: string,\n): string | undefined {\n  if (!cover) return undefined;\n  if (cover.startsWith('file://') || cover.startsWith('http://') || cover.startsWith('https://'))\n    return cover;\n  if (cover.startsWith('/')) {\n    const base = publicDir ?? path.join(cwd, 'public');\n    return pathToFileUrl(path.join(base, cover.slice(1)));\n  }\n  return pathToFileUrl(path.resolve(cwd, cover));\n}\n\nfunction pathToFileUrl(filePath: string): string {\n  return pathToFileURL(filePath).href;\n}\n\n/**\n * Export Fumadocs documentation to EPUB format.\n *\n * @param options - Export configuration with source and epub config\n * @returns Promise resolving to the EPUB file as a Buffer\n *\n * @example\n * ```ts\n * import { exportEpub } from 'fumadocs-epub';\n * import { source } from '@/lib/source';\n *\n * const buffer = await exportEpub({\n *   source,\n *   title: 'My Documentation',\n *   author: 'My Team',\n *   cover: '/cover.png',\n * });\n * ```\n */\nexport async function exportEpub<C extends LoaderConfig>(\n  options: EpubExportOptions<C>,\n): Promise<Buffer> {\n  const cwd = process.cwd();\n  const {\n    source,\n    getMarkdown = async (page) => {\n      try {\n        return await (page.data as { getText: (type: string) => Promise<string> }).getText('raw');\n      } catch {\n        console.warn(\n          `Failed to get processed markdown for page \"${page.absolutePath ?? page.path}\", please specify the \"getMarkdown\" option.`,\n        );\n      }\n    },\n    title,\n    author = 'anonymous',\n    description,\n    language = 'en',\n    publisher = 'anonymous',\n    cover,\n    outputPath,\n    includePages,\n    excludePages,\n    css,\n    publicDir = path.resolve('public'),\n  } = options;\n\n  // Get pages in tree order (navigation order)\n  const pageTree = source.getPageTree();\n  const orderedPages = getPagesInTreeOrder(pageTree, (node) => source.getNodePage?.(node)).filter(\n    (p): p is Page => p != null,\n  );\n\n  // Fallback to getPages() if tree order yields no pages (e.g. i18n)\n  const pages = orderedPages.length > 0 ? orderedPages : source.getPages();\n\n  // Filter pages\n  const filteredPages = pages.filter((page) => {\n    if (includePages && !includePages(page)) return false;\n    if (excludePages && excludePages(page)) return false;\n    return true;\n  });\n\n  const chapters: { title: string; content: string }[] = [];\n\n  for (const page of filteredPages) {\n    const markdown = await getMarkdown(page);\n    if (!markdown) continue;\n\n    const pageDir = getPageDir(page, cwd);\n    const html = await markdownToHtml(markdown, pageDir, publicDir);\n    const pageTitle = page.data.title ?? page.slugs[page.slugs.length - 1] ?? 'Untitled';\n\n    chapters.push({\n      title: pageTitle,\n      content: html,\n    });\n  }\n\n  const epubOptions: Options = {\n    title,\n    author: Array.isArray(author) ? author : [author],\n    description,\n    lang: language,\n    publisher,\n    cover: resolveCoverPath(cover, cwd, publicDir) ?? cover,\n    css: css ?? defaultEpubStyles,\n    prependChapterTitles: true,\n    numberChaptersInTOC: true,\n    tocTitle: 'Table of Contents',\n  };\n\n  const content = chapters.map((ch) => ({\n    title: ch.title,\n    content: ch.content,\n  }));\n\n  const buffer = await epub(epubOptions, content);\n\n  if (outputPath) {\n    const fs = await import('node:fs/promises');\n    await fs.mkdir(path.dirname(outputPath), { recursive: true });\n    await fs.writeFile(outputPath, buffer);\n  }\n  return buffer;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-epub",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "EPUB export for Fumadocs documentation",
   "keywords": [
     "documentation",
@@ -13,7 +13,7 @@
   "author": "Fuma Nama",
   "repository": "github:fuma-nama/fumadocs",
   "files": [
-    "dist/*"
+    "dist"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -38,14 +38,13 @@
   },
   "devDependencies": {
     "@types/mdast": "^4.0.4",
-    "@types/node": "25.3.3",
+    "@types/node": "25.6.0",
     "rimraf": "^6.0.0",
-    "tsdown": "0.20.3",
-    "typescript": "^5.9.3",
+    "tsdown": "0.21.7",
+    "typescript": "^6.0.2",
     "vfile": "^6.0.3",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0",
-    "fumadocs-core": "16.6.10"
+    "fumadocs-core": "16.7.14",
+    "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "fumadocs-core": "^15.0.0 || ^16.0.0"
@@ -57,7 +56,7 @@
     "build": "tsdown",
     "clean": "rimraf dist",
     "dev": "tsdown --watch --clean false",
-    "lint": "eslint .",
+    "lint": "oxlint .",
     "types:check": "tsc --noEmit"
   }
 }