notespress 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# blog-vitepress
+
+一个用于托管个人笔记站的 VitePress 外壳仓库，同时也包含一个可发布的 `notespress` CLI。
+
+Markdown 内容放在 `myBlog` 子模块中，当前仓库负责：
+
+- 站点配置
+- 自动生成导航
+- 代码示例包装页生成
+- GitHub Pages 部署
+
+## 快速开始
+
+```bash
+git clone <repo-url>
+cd blog-vitepress
+git submodule update --init --recursive
+pnpm install
+pnpm dev
+```
+
+## 作为 npm 包使用
+
+CLI 的目标用法是：在任意 Markdown 笔记目录下直接生成博客站点。
+
+本地安装：
+
+```bash
+npm install -D notespress
+npx notespress build
+```
+
+或者直接执行一次性命令：
+
+```bash
+pnpm dlx notespress build
+```
+
+常用命令：
+
+```bash
+notespress dev
+notespress build
+notespress preview
+```
+
+默认行为：
+
+- 当前目录作为内容目录
+- 构建产物输出到 `dist/`
+- 临时工作区输出到 `.blog-cli/`
+- `.js`、`.ts`、`.html` 会自动生成 `snippets/` 页面
+
+## 目录结构
+
+- `myBlog/`：Markdown 内容仓库，使用 git submodule 管理
+- `.vitepress/`：VitePress 配置
+- `docs/`：项目说明页
+- `scripts/`：构建前生成代码示例页面
+
+## 自动导航
+
+站点使用 `vitepress-auto-navigation` 根据 `myBlog` 目录自动生成 `nav` 和 `sidebar`。如果本地还没有拉取子模块，站点仍能启动，但不会显示笔记导航。
+
+除了 Markdown 页面，站点还会在构建前扫描 `myBlog` 里的 `.js`、`.ts` 和 `.html` 文件，并自动生成 `snippets/` 下的包装页，让这些代码文件也能通过导航访问。
+
+## 从 `myBlog` 直接生成网站
+
+根仓库现在提供了一个 `notespress`。如果你进入 `myBlog/`，可以直接运行：
+
+```bash
+pnpm build
+pnpm dev
+pnpm preview
+```
+
+这些脚本会调用上层仓库里的 `notespress`，临时创建一个独立的 VitePress 工作区，并把当前 `myBlog/` 目录生成为静态站点。
+
+- 输出目录默认是 `myBlog/dist`
+- 临时工作区在 `myBlog/.blog-cli`
+- 不会把 `.vitepress` 配置写回 `myBlog/`
+- `.js`、`.ts`、`.html` 文件会自动生成 `snippets/` 页面
+
+## 部署
+
+`.github/workflows/deploy.yml` 会在 `master` 分支收到 push 后自动：
+
+1. 拉取仓库和子模块
+2. 安装依赖
+3. 构建 VitePress 站点
+4. 发布到 GitHub Pages

package/assets/theme/custom.css

@@ -0,0 +1,171 @@
+.VPHome {
+  --home-accent: #0f766e;
+  --home-ink: #0f172a;
+  --home-surface: rgba(255, 255, 255, 0.84);
+  --home-border: rgba(15, 23, 42, 0.1);
+}
+
+.VPHome::before {
+  content: "";
+  position: fixed;
+  inset: 0;
+  background:
+    radial-gradient(circle at top left, rgba(15, 118, 110, 0.14), transparent 30%),
+    radial-gradient(circle at top right, rgba(249, 115, 22, 0.14), transparent 28%),
+    linear-gradient(180deg, rgba(248, 250, 252, 0.96), rgba(255, 255, 255, 0.98));
+  pointer-events: none;
+  z-index: -1;
+}
+
+.VPHome .VPHero {
+  padding-top: 48px;
+}
+
+.VPHome .VPHero .name,
+.VPHome .VPHero .text {
+  letter-spacing: -0.04em;
+}
+
+.VPHome .VPHero .name {
+  color: var(--home-accent);
+}
+
+.VPHome .VPHero .text {
+  color: var(--home-ink);
+  max-width: 10ch;
+  font-size: clamp(2.8rem, 5vw, 4.8rem);
+  line-height: 0.96;
+}
+
+.VPHome .VPHero .tagline {
+  max-width: 42rem;
+  color: rgba(15, 23, 42, 0.72);
+  font-size: 1.05rem;
+}
+
+.VPHome .VPButton.brand {
+  background: linear-gradient(135deg, #0f766e, #115e59);
+  border-color: transparent;
+}
+
+.VPHome .VPButton.alt {
+  border-color: var(--home-border);
+  background: var(--home-surface);
+}
+
+.VPHome .VPFeature {
+  border: 1px solid var(--home-border);
+  border-radius: 24px;
+  background: var(--home-surface);
+  box-shadow: 0 20px 50px rgba(15, 23, 42, 0.06);
+  backdrop-filter: blur(10px);
+}
+
+.VPHome .VPFeature .title {
+  color: var(--home-ink);
+}
+
+.VPHome .VPFeature .details {
+  color: rgba(15, 23, 42, 0.68);
+}
+
+.snippet-page .vp-doc {
+  --snippet-surface: rgba(15, 23, 42, 0.04);
+  --snippet-border: rgba(15, 23, 42, 0.12);
+  --snippet-accent: #0f766e;
+}
+
+.snippet-page .snippet-breadcrumb {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.45rem;
+  margin: 0 0 1rem;
+  color: rgba(15, 23, 42, 0.52);
+  font-size: 0.86rem;
+}
+
+.snippet-page .snippet-breadcrumb__link {
+  color: inherit;
+  font-weight: 600;
+  text-decoration: none;
+}
+
+.snippet-page .snippet-breadcrumb__link:hover {
+  color: var(--snippet-accent);
+}
+
+.snippet-page .snippet-breadcrumb__divider {
+  opacity: 0.45;
+}
+
+.snippet-page .vp-doc h1 {
+  margin-bottom: 0.75rem;
+}
+
+.snippet-page .snippet-hero {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.6rem;
+  margin: 0 0 1rem;
+}
+
+.snippet-page .snippet-hero__chip {
+  display: inline-flex;
+  align-items: center;
+  border: 1px solid var(--snippet-border);
+  border-radius: 999px;
+  background: linear-gradient(135deg, rgba(15, 118, 110, 0.14), rgba(15, 23, 42, 0.04));
+  color: var(--snippet-accent);
+  font-size: 0.78rem;
+  font-weight: 700;
+  letter-spacing: 0.06em;
+  padding: 0.35rem 0.7rem;
+  text-transform: uppercase;
+}
+
+.snippet-page .snippet-meta {
+  display: grid;
+  gap: 0.8rem;
+  margin: 0 0 1.35rem;
+}
+
+.snippet-page .snippet-meta__item {
+  border: 1px solid var(--snippet-border);
+  border-radius: 18px;
+  background: var(--snippet-surface);
+  padding: 0.9rem 1rem;
+}
+
+.snippet-page .snippet-meta__label {
+  display: block;
+  color: var(--snippet-accent);
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  margin-bottom: 0.4rem;
+  text-transform: uppercase;
+}
+
+.snippet-page .snippet-meta code {
+  background: transparent;
+  border: 0;
+  padding: 0;
+  word-break: break-all;
+}
+
+.snippet-page .snippet-meta a {
+  color: var(--snippet-accent);
+  font-weight: 600;
+  text-decoration: none;
+}
+
+.snippet-page .snippet-meta a:hover {
+  text-decoration: underline;
+}
+
+.snippet-page .vp-doc div[class*="language-"] {
+  border: 1px solid var(--snippet-border);
+  border-radius: 22px;
+  box-shadow: 0 24px 60px rgba(15, 23, 42, 0.08);
+}

package/bin/blog-cli.mjs

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+import { createServer, build, serve } from "vitepress"
+
+import { generateSnippetPages } from "../lib/snippets.mjs"
+import { prepareStandaloneWorkspace, resolveRepositoryRoot } from "../lib/standalone-site.mjs"
+
+function printHelp() {
+  process.stdout.write(`notespress
+
+Usage:
+  notespress build [content-dir] [--out-dir dir] [--base /path/]
+  notespress dev [content-dir] [--port 5173] [--host 0.0.0.0]
+  notespress preview [content-dir] [--port 4173]
+  notespress prepare-content [content-dir] [--output-dir dir] [--route-base /myBlog]
+
+Aliases:
+  build-site -> build
+`)
+}
+
+function parseArgs(argv) {
+  const [command = "help", ...rest] = argv
+  const options = {}
+  const positionals = []
+
+  for (let index = 0; index < rest.length; index += 1) {
+    const token = rest[index]
+
+    if (!token.startsWith("--")) {
+      positionals.push(token)
+      continue
+    }
+
+    const [rawKey, inlineValue] = token.slice(2).split("=", 2)
+
+    if (inlineValue != null) {
+      options[rawKey] = inlineValue
+      continue
+    }
+
+    const nextToken = rest[index + 1]
+
+    if (nextToken == null || nextToken.startsWith("--")) {
+      options[rawKey] = true
+      continue
+    }
+
+    options[rawKey] = nextToken
+    index += 1
+  }
+
+  return { command, options, positionals }
+}
+
+function resolveContentDir(positionals, options) {
+  return positionals[0] ?? options["content-dir"] ?? process.cwd()
+}
+
+function resolvePort(value, fallback) {
+  if (value == null) {
+    return fallback
+  }
+
+  const port = Number(value)
+
+  if (!Number.isInteger(port) || port <= 0) {
+    throw new Error(`Invalid port: ${value}`)
+  }
+
+  return port
+}
+
+async function runPrepareContent(positionals, options) {
+  const result = generateSnippetPages({
+    contentDir: resolveContentDir(positionals, options),
+    outputDir: options["output-dir"] ?? "snippets",
+    routeBase: options["route-base"] ?? "/myBlog",
+    snippetRouteBase: options["snippet-route-base"] ?? "/snippets",
+    sourceLinkPrefix: options["source-link-prefix"] ?? "myBlog",
+  })
+
+  process.stdout.write(`Generated ${result.count} snippet pages in ${result.outputDir}\n`)
+}
+
+async function runBuild(positionals, options) {
+  const workspace = prepareStandaloneWorkspace({
+    contentDir: resolveContentDir(positionals, options),
+    outDir: options["out-dir"],
+    base: options.base,
+    title: options.title,
+    description: options.description,
+  })
+
+  process.chdir(resolveRepositoryRoot())
+  await build(workspace.root)
+}
+
+async function runDev(positionals, options) {
+  const workspace = prepareStandaloneWorkspace({
+    contentDir: resolveContentDir(positionals, options),
+    outDir: options["out-dir"],
+    base: options.base,
+    title: options.title,
+    description: options.description,
+  })
+
+  process.chdir(resolveRepositoryRoot())
+  const server = await createServer(workspace.root, {
+    host: options.host,
+    port: resolvePort(options.port, 5173),
+  })
+
+  const closeServer = async () => {
+    await server.close()
+    process.exit(0)
+  }
+
+  process.on("SIGINT", closeServer)
+  process.on("SIGTERM", closeServer)
+
+  await server.listen()
+  server.printUrls()
+}
+
+async function runPreview(positionals, options) {
+  const workspace = prepareStandaloneWorkspace({
+    contentDir: resolveContentDir(positionals, options),
+    outDir: options["out-dir"],
+    base: options.base,
+    title: options.title,
+    description: options.description,
+  })
+
+  process.chdir(resolveRepositoryRoot())
+  await serve({
+    root: workspace.root,
+    port: resolvePort(options.port, 4173),
+    base: options.base,
+  })
+}
+
+async function main() {
+  const { command, options, positionals } = parseArgs(process.argv.slice(2))
+
+  switch (command) {
+    case "build":
+    case "build-site":
+      await runBuild(positionals, options)
+      return
+    case "dev":
+      await runDev(positionals, options)
+      return
+    case "preview":
+      await runPreview(positionals, options)
+      return
+    case "prepare-content":
+      await runPrepareContent(positionals, options)
+      return
+    case "help":
+    case "--help":
+    case "-h":
+      printHelp()
+      return
+    default:
+      process.stderr.write(`Unknown command: ${command}\n\n`)
+      printHelp()
+      process.exitCode = 1
+  }
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error.stack ?? error.message}\n`)
+  process.exit(1)
+})

package/lib/snippets.mjs

@@ -0,0 +1,218 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs"
+import { dirname, extname, join, relative } from "node:path"
+
+export const CODE_EXTENSIONS = new Set([".js", ".ts", ".html"])
+export const IGNORED_DIRS = new Set([
+  ".blog-cli",
+  ".git",
+  ".github",
+  ".vitepress",
+  "node_modules",
+  "dist",
+  "build",
+])
+
+const LANGUAGE_MAP = {
+  ".html": "html",
+  ".js": "js",
+  ".ts": "ts",
+}
+
+function toPosixPath(filePath) {
+  return filePath.replace(/\\/g, "/")
+}
+
+function escapeMarkdown(value) {
+  return value.replace(/\\/g, "\\\\").replace(/`/g, "\\`")
+}
+
+function escapeHtml(value) {
+  return value
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+}
+
+function normalizeRouteBase(routeBase = "") {
+  const normalized = routeBase.replace(/\\/g, "/").trim().replace(/\/+$/g, "")
+
+  if (normalized === "" || normalized === "/") {
+    return ""
+  }
+
+  return normalized.startsWith("/") ? normalized : `/${normalized}`
+}
+
+function createSectionRoute(routeBase, section) {
+  const normalizedBase = normalizeRouteBase(routeBase)
+  return `${normalizedBase}/${section}/`.replace(/\/+/g, "/")
+}
+
+function createSnippetRoute(snippetRouteBase, relativePath) {
+  const normalizedBase = normalizeRouteBase(snippetRouteBase) || "/snippets"
+  const routePath = relativePath.replace(/\.[^/.]+$/, "")
+  return `${normalizedBase}/${routePath}`.replace(/\/+/g, "/")
+}
+
+function createSnippetPage(relativePath, options) {
+  const {
+    contentDir,
+    outputDir,
+    routeBase,
+    snippetRouteBase,
+    sourceLinkPrefix,
+  } = options
+  const sourcePath = join(contentDir, relativePath)
+  const extension = extname(relativePath).toLowerCase()
+  const title = relativePath.split("/").at(-1)
+  const code = readFileSync(sourcePath, "utf8")
+  const language = LANGUAGE_MAP[extension] ?? "text"
+  const outputPath = join(outputDir, relativePath.replace(/\.[^/.]+$/, ".md"))
+  const outputDirname = dirname(outputPath)
+  const originalPath = toPosixPath(sourcePath)
+  const pathSegments = relativePath.split("/")
+  const lineCount = code === "" ? 0 : code.split(/\r?\n/).length
+  const section = pathSegments[0] ?? "snippet"
+  const sectionRoute = createSectionRoute(routeBase, section)
+  const snippetRoute = createSnippetRoute(snippetRouteBase, relativePath)
+  const includeSourcePath = [sourceLinkPrefix, relativePath]
+    .filter(Boolean)
+    .map(toPosixPath)
+    .join("/")
+  const breadcrumbItems = pathSegments.map((segment, index) => {
+    const href =
+      index === pathSegments.length - 1
+        ? snippetRoute
+        : createSnippetRoute(snippetRouteBase, pathSegments.slice(0, index + 1).join("/"))
+
+    return `<a class="snippet-breadcrumb__link" href="${escapeHtml(href)}">${escapeHtml(segment)}</a>`
+  })
+
+  mkdirSync(outputDirname, { recursive: true })
+  writeFileSync(
+    outputPath,
+    `---
+title: ${JSON.stringify(title)}
+outline: false
+pageClass: snippet-page
+---
+
+<div class="snippet-breadcrumb">
+  <a class="snippet-breadcrumb__link" href="${escapeHtml(sectionRoute)}">Back to ${escapeHtml(section)}</a>
+  <span class="snippet-breadcrumb__divider">/</span>
+  ${breadcrumbItems.join('\n  <span class="snippet-breadcrumb__divider">/</span>\n  ')}
+</div>
+
+<div class="snippet-hero">
+  <span class="snippet-hero__chip">${escapeHtml(language.toUpperCase())}</span>
+  <span class="snippet-hero__chip">${lineCount} lines</span>
+  <span class="snippet-hero__chip">${escapeHtml(section)}</span>
+</div>
+
+# ${escapeMarkdown(title)}
+
+<div class="snippet-meta">
+  <div class="snippet-meta__item">
+    <span class="snippet-meta__label">Source</span>
+    <code>${escapeHtml(originalPath)}</code>
+  </div>
+  <div class="snippet-meta__item">
+    <span class="snippet-meta__label">Route</span>
+    <code>${escapeHtml(snippetRoute)}</code>
+  </div>
+  <div class="snippet-meta__item">
+    <span class="snippet-meta__label">Section</span>
+    <a href="${escapeHtml(sectionRoute)}">${escapeHtml(sectionRoute)}</a>
+  </div>
+</div>
+
+<<< @/${includeSourcePath}
+`,
+  )
+}
+
+function walk(dir, options) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.name.startsWith(".") || IGNORED_DIRS.has(entry.name)) {
+      continue
+    }
+
+    const fullPath = join(dir, entry.name)
+
+    if (entry.isDirectory()) {
+      walk(fullPath, options)
+      continue
+    }
+
+    if (!entry.isFile()) {
+      continue
+    }
+
+    const extension = extname(entry.name).toLowerCase()
+
+    if (!CODE_EXTENSIONS.has(extension)) {
+      continue
+    }
+
+    createSnippetPage(toPosixPath(relative(options.contentDir, fullPath)), options)
+  }
+}
+
+export function generateSnippetPages(options = {}) {
+  const contentDir = options.contentDir ?? "myBlog"
+  const outputDir = options.outputDir ?? "snippets"
+  const routeBase = options.routeBase ?? "/myBlog"
+  const snippetRouteBase = options.snippetRouteBase ?? "/snippets"
+  const sourceLinkPrefix = options.sourceLinkPrefix ?? ""
+
+  if (existsSync(outputDir)) {
+    rmSync(outputDir, { recursive: true, force: true })
+  }
+
+  if (!existsSync(contentDir)) {
+    return { count: 0 }
+  }
+
+  const generationOptions = {
+    contentDir,
+    outputDir,
+    routeBase,
+    snippetRouteBase,
+    sourceLinkPrefix,
+  }
+
+  walk(contentDir, generationOptions)
+
+  let count = 0
+
+  if (existsSync(outputDir)) {
+    const stack = [outputDir]
+
+    while (stack.length > 0) {
+      const currentDir = stack.pop()
+
+      for (const entry of readdirSync(currentDir, { withFileTypes: true })) {
+        const fullPath = join(currentDir, entry.name)
+
+        if (entry.isDirectory()) {
+          stack.push(fullPath)
+          continue
+        }
+
+        if (entry.isFile() && extname(entry.name) === ".md") {
+          count += 1
+        }
+      }
+    }
+  }
+
+  return {
+    count,
+    contentDir,
+    outputDir,
+    routeBase,
+    snippetRouteBase,
+    sourceLinkPrefix,
+  }
+}

package/lib/standalone-config.mjs

@@ -0,0 +1,90 @@
+import { existsSync, readdirSync } from "node:fs"
+import { basename, extname, join } from "node:path"
+import { defineConfig } from "vitepress"
+import genNav from "vitepress-auto-navigation"
+
+const CODE_EXTENSIONS = [".js", ".ts", ".html"]
+
+function hasMarkdownContent(dir) {
+  if (!existsSync(dir)) {
+    return false
+  }
+
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.name.startsWith(".")) {
+      continue
+    }
+
+    if (entry.isFile() && entry.name.endsWith(".md")) {
+      return true
+    }
+
+    if (entry.isDirectory() && hasMarkdownContent(join(dir, entry.name))) {
+      return true
+    }
+  }
+
+  return false
+}
+
+function createSnippetSidebar(autoNavigation) {
+  return Object.fromEntries(
+    Object.entries(autoNavigation.sidebar).map(([path, items]) => [`/snippets${path}`, items]),
+  )
+}
+
+export function createStandaloneSiteConfig(options = {}) {
+  const contentDir = options.contentDir ?? process.cwd()
+  const siteTitle = options.title ?? basename(contentDir)
+  const description =
+    options.description ?? `Static site generated from ${basename(contentDir)} with notespress.`
+  const siteBase = options.base ?? "/"
+  const hasContent = hasMarkdownContent(contentDir)
+  const autoNavigation = hasContent
+    ? genNav({
+        sourceDir: contentDir,
+        routeBase: "",
+        extensions: [".md", ...CODE_EXTENSIONS],
+        resolveText: (file) => {
+          const extension = extname(file.relativePath).toLowerCase()
+
+          if (!CODE_EXTENSIONS.includes(extension)) {
+            return file.name
+          }
+
+          return basename(file.relativePath)
+        },
+        resolveLink: (file) => {
+          const extension = extname(file.relativePath).toLowerCase()
+
+          if (!CODE_EXTENSIONS.includes(extension)) {
+            return file.routePath
+          }
+
+          return `/snippets/${file.relativePath.replace(/\.[^/.]+$/, "")}`
+        },
+      })
+    : { nav: [], sidebar: {} }
+  const snippetSidebar = createSnippetSidebar(autoNavigation)
+
+  return defineConfig({
+    base: siteBase,
+    cleanUrls: true,
+    title: siteTitle,
+    description,
+    lastUpdated: true,
+    outDir: options.outDir,
+    cacheDir: options.cacheDir,
+    themeConfig: {
+      nav: autoNavigation.nav,
+      sidebar: {
+        ...(hasContent ? autoNavigation.sidebar : {}),
+        ...(hasContent ? snippetSidebar : {}),
+      },
+      search: {
+        provider: "local",
+      },
+      socialLinks: [{ icon: "github", link: "https://github.com/Notryag" }],
+    },
+  })
+}

package/lib/standalone-site.mjs

@@ -0,0 +1,98 @@
+import { createHash } from "node:crypto"
+import { mkdirSync, readFileSync, readdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs"
+import { basename, dirname, join, resolve } from "node:path"
+import { fileURLToPath, pathToFileURL } from "node:url"
+
+import { generateSnippetPages, IGNORED_DIRS } from "./snippets.mjs"
+
+const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..")
+
+function workspaceIdFor(contentDir) {
+  const hash = createHash("sha1").update(contentDir).digest("hex").slice(0, 8)
+  return `${basename(contentDir)}-${hash}`
+}
+
+function ensureDir(dir) {
+  mkdirSync(dir, { recursive: true })
+}
+
+function writeStandaloneConfig(workspaceRoot, options) {
+  const configDir = join(workspaceRoot, ".vitepress")
+  const themeDir = join(configDir, "theme")
+  const configModuleUrl = pathToFileURL(join(REPO_ROOT, "lib", "standalone-config.mjs")).href
+  const customCss = readFileSync(join(REPO_ROOT, "assets", "theme", "custom.css"), "utf8")
+
+  ensureDir(themeDir)
+  writeFileSync(
+    join(configDir, "config.mjs"),
+    `import { createStandaloneSiteConfig } from ${JSON.stringify(configModuleUrl)}
+
+export default createStandaloneSiteConfig(${JSON.stringify(options, null, 2)})
+`,
+  )
+  writeFileSync(
+    join(themeDir, "index.js"),
+    `import DefaultTheme from "vitepress/theme"
+import "./custom.css"
+
+export default DefaultTheme
+`,
+  )
+  writeFileSync(join(themeDir, "custom.css"), customCss)
+}
+
+function mirrorContentEntries(contentDir, workspaceRoot) {
+  for (const entry of readdirSync(contentDir, { withFileTypes: true })) {
+    if (entry.name.startsWith(".") || IGNORED_DIRS.has(entry.name)) {
+      continue
+    }
+
+    const targetPath = join(contentDir, entry.name)
+    const linkPath = join(workspaceRoot, entry.name)
+    const linkType = entry.isDirectory() ? "dir" : "file"
+
+    symlinkSync(targetPath, linkPath, linkType)
+  }
+}
+
+export function resolveRepositoryRoot() {
+  return REPO_ROOT
+}
+
+export function prepareStandaloneWorkspace(options = {}) {
+  const contentDir = resolve(options.contentDir ?? process.cwd())
+  const stateRoot = resolve(options.stateDir ?? join(contentDir, ".blog-cli"))
+  const workspaceRoot =
+    options.workspaceDir ??
+    join(stateRoot, "workspaces", workspaceIdFor(contentDir))
+  const outDir = resolve(options.outDir ?? join(contentDir, "dist"))
+  const cacheDir = resolve(options.cacheDir ?? join(stateRoot, "cache", workspaceIdFor(contentDir)))
+
+  rmSync(workspaceRoot, { recursive: true, force: true })
+  ensureDir(workspaceRoot)
+  ensureDir(dirname(cacheDir))
+
+  mirrorContentEntries(contentDir, workspaceRoot)
+  generateSnippetPages({
+    contentDir,
+    outputDir: join(workspaceRoot, "snippets"),
+    routeBase: "",
+    snippetRouteBase: "/snippets",
+    sourceLinkPrefix: "",
+  })
+  writeStandaloneConfig(workspaceRoot, {
+    contentDir,
+    title: options.title,
+    description: options.description,
+    base: options.base,
+    outDir,
+    cacheDir,
+  })
+
+  return {
+    root: workspaceRoot,
+    outDir,
+    cacheDir,
+    contentDir,
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "notespress",
+  "version": "0.1.0",
+  "description": "Generate a VitePress blog site directly from a Markdown notes directory.",
+  "license": "MIT",
+  "packageManager": "pnpm@10.30.3",
+  "type": "module",
+  "files": [
+    "assets",
+    "bin",
+    "lib",
+    "README.md"
+  ],
+  "keywords": [
+    "blog",
+    "cli",
+    "markdown",
+    "notes",
+    "vitepress"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "notespress": "./bin/blog-cli.mjs"
+  },
+  "scripts": {
+    "prepare:content": "node scripts/generate-snippets.mjs",
+    "dev": "pnpm prepare:content && vitepress dev",
+    "build": "pnpm prepare:content && vitepress build",
+    "preview": "vitepress preview",
+    "notespress:dev": "node ./bin/blog-cli.mjs dev myBlog",
+    "notespress:build": "node ./bin/blog-cli.mjs build myBlog",
+    "notespress:preview": "node ./bin/blog-cli.mjs preview myBlog",
+    "docs:build": "pnpm build",
+    "docs:preview": "pnpm preview"
+  },
+  "dependencies": {
+    "vitepress": "^1.6.4",
+    "vue": "^3.5.13",
+    "vitepress-auto-navigation": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "typescript": "^5.9.3"
+  }
+}