@limcpf/everything-is-a-markdown 0.5.1 → 0.5.3

package/README.ko.md

@@ -40,6 +40,31 @@ bun run blog [build|dev|clean] [options]
 - `--exclude <glob>`: 제외 패턴 추가 (반복 가능)
 - `--port <n>`: 개발 서버 포트 (기본 `3000`)
 
+## 설정 파일 (`blog.config.ts`)
+
+SEO/UI/정적 파일 설정은 config 파일에서 관리할 수 있습니다.
+
+```ts
+const config = {
+  vaultDir: "./vault",
+  outDir: "./dist",
+  staticPaths: ["assets", "public/favicon.ico"],
+  seo: {
+    siteUrl: "https://example.com",
+    defaultOgImage: "/assets/og.png",
+  },
+};
+
+export default config;
+```
+
+`staticPaths`:
+
+- 볼트 기준 상대 경로 배열
+- 폴더와 파일 모두 지정 가능
+- 지정한 경로의 파일들을 `dist`에 같은 상대 경로로 복사
+- 예: 볼트 `assets/og.png` -> `dist/assets/og.png`
+
 예시:
 
 ```bash

package/README.md

@@ -40,6 +40,31 @@ Common options:
 - `--exclude <glob>`: Add exclude pattern (repeatable)
 - `--port <n>`: Dev server port (default `3000`)
 
+## Config File (`blog.config.ts`)
+
+Use a config file for SEO/UI/static assets.
+
+```ts
+const config = {
+  vaultDir: "./vault",
+  outDir: "./dist",
+  staticPaths: ["assets", "public/favicon.ico"],
+  seo: {
+    siteUrl: "https://example.com",
+    defaultOgImage: "/assets/og.png",
+  },
+};
+
+export default config;
+```
+
+`staticPaths`:
+
+- Array of vault-relative paths
+- Supports both folders and files
+- Copies all matched files into the same relative location in `dist`
+- Example: `assets/og.png` in vault becomes `dist/assets/og.png`
+
 Examples:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limcpf/everything-is-a-markdown",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "license": "MIT",
   "private": false,
   "type": "module",

package/src/build.ts

@@ -1,3 +1,4 @@
+import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
 import matter from "gray-matter";
@@ -16,6 +17,7 @@ import {
   removeEmptyParents,
   removeFileIfExists,
   stripMdExt,
+  toPosixPath,
   toDocId,
   toRoute,
 } from "./utils";
@@ -655,7 +657,7 @@ function isNewByFrontmatterDate(date: string | undefined, newThreshold: number):
   return publishedAt != null && publishedAt >= newThreshold;
 }
 
-function getRecentSortEpochMs(doc: DocRecord): number {
+function getRecentSortEpochMs(doc: DocRecord): number | null {
   return parseDateToEpochMs(doc.updatedDate) ?? parseDateToEpochMs(doc.date);
 }
 
@@ -924,6 +926,92 @@ async function writeOutputIfChanged(
   await Bun.write(outputPath, content);
 }
 
+async function copyOutputFileIfChanged(
+  context: OutputWriteContext,
+  relOutputPath: string,
+  sourcePath: string,
+): Promise<void> {
+  const bytes = new Uint8Array(await Bun.file(sourcePath).arrayBuffer());
+  const outputHash = crypto.createHash("sha1").update(bytes).digest("hex");
+  context.nextHashes[relOutputPath] = outputHash;
+
+  const outputPath = path.join(context.outDir, relOutputPath);
+  const unchanged = context.previousHashes[relOutputPath] === outputHash;
+  if (unchanged && (await Bun.file(outputPath).exists())) {
+    return;
+  }
+
+  await ensureDir(path.dirname(outputPath));
+  await Bun.write(outputPath, bytes);
+}
+
+async function listFilesRecursively(baseDir: string): Promise<string[]> {
+  const entries = await fs.readdir(baseDir, { withFileTypes: true });
+  entries.sort((left, right) => left.name.localeCompare(right.name, "ko-KR"));
+
+  const files: string[] = [];
+  for (const entry of entries) {
+    const absolutePath = path.join(baseDir, entry.name);
+    if (entry.isDirectory()) {
+      const children = await listFilesRecursively(absolutePath);
+      for (const child of children) {
+        files.push(path.join(entry.name, child));
+      }
+      continue;
+    }
+
+    if (entry.isFile()) {
+      files.push(entry.name);
+    }
+  }
+
+  return files;
+}
+
+async function copyStaticPaths(context: OutputWriteContext, options: BuildOptions): Promise<void> {
+  for (const staticPath of options.staticPaths) {
+    const sourcePath = path.resolve(options.vaultDir, staticPath);
+
+    let sourceStat;
+    try {
+      sourceStat = await fs.stat(sourcePath);
+    } catch {
+      console.warn(`[static] path not found: ${staticPath}`);
+      continue;
+    }
+
+    if (sourceStat.isDirectory()) {
+      const files = await listFilesRecursively(sourcePath);
+      for (const file of files) {
+        const relFilePath = toPosixPath(file);
+        const relOutputPath = path.posix.join(staticPath, relFilePath);
+        const filePath = path.join(sourcePath, file);
+        await copyOutputFileIfChanged(context, relOutputPath, filePath);
+      }
+      continue;
+    }
+
+    if (sourceStat.isFile()) {
+      await copyOutputFileIfChanged(context, staticPath, sourcePath);
+      continue;
+    }
+
+    console.warn(`[static] unsupported path type, skipped: ${staticPath}`);
+  }
+}
+
+async function removeStaleOutputs(context: OutputWriteContext): Promise<void> {
+  for (const previousPath of Object.keys(context.previousHashes)) {
+    if (Object.hasOwn(context.nextHashes, previousPath)) {
+      continue;
+    }
+
+    const outputPath = path.join(context.outDir, previousPath);
+    await removeFileIfExists(outputPath);
+    await removeEmptyParents(path.dirname(outputPath), context.outDir);
+  }
+}
+
 function toRelativeAssetPath(fromOutputPath: string, assetOutputPath: string): string {
   const fromDir = path.posix.dirname(fromOutputPath);
   const relative = path.posix.relative(fromDir, assetOutputPath);
@@ -1242,6 +1330,7 @@ export async function buildSite(options: BuildOptions): Promise<BuildResult> {
     nextHashes: {},
   };
   const runtimeAssets = await writeRuntimeAssets(outputContext);
+  await copyStaticPaths(outputContext, options);
 
   const tree = buildTree(docs, options);
   const manifest = buildManifest(docs, tree, options);
@@ -1313,6 +1402,7 @@ export async function buildSite(options: BuildOptions): Promise<BuildResult> {
 
   await writeShellPages(outputContext, docs, manifest, options, runtimeAssets, contentByDocId);
   await writeSeoArtifacts(outputContext, docs, options);
+  await removeStaleOutputs(outputContext);
 
   await writeCache(cachePath, nextCache);
 

package/src/config.ts

@@ -132,6 +132,45 @@ function normalizePinnedMenu(raw: unknown, errorPrefix = "[config]"): PinnedMenu
   };
 }
 
+function normalizeStaticPaths(raw: unknown, errorPrefix = "[config]"): string[] {
+  if (raw == null) {
+    return [];
+  }
+  if (!Array.isArray(raw)) {
+    throw new Error(`${errorPrefix} "staticPaths" must be an array of strings`);
+  }
+
+  const normalized = new Set<string>();
+  for (const [index, value] of raw.entries()) {
+    if (typeof value !== "string") {
+      throw new Error(`${errorPrefix} "staticPaths[${index}]" must be a string`);
+    }
+
+    const cleaned = value
+      .trim()
+      .replace(/\\/g, "/")
+      .replace(/^\.\/+/, "")
+      .replace(/\/+$/, "");
+
+    if (
+      !cleaned ||
+      cleaned === "." ||
+      cleaned === ".." ||
+      cleaned.startsWith("../") ||
+      cleaned.startsWith("/") ||
+      path.isAbsolute(value.trim())
+    ) {
+      throw new Error(
+        `${errorPrefix} "staticPaths[${index}]" must be a non-empty vault-relative path (for example: "assets")`,
+      );
+    }
+
+    normalized.add(cleaned);
+  }
+
+  return Array.from(normalized);
+}
+
 export async function loadPinnedMenuConfig(
   configPath: string | undefined,
   cwd = process.cwd(),
@@ -166,9 +205,12 @@ export function resolveBuildOptions(
   pinnedMenu: PinnedMenuOption | null,
   cwd = process.cwd(),
 ): BuildOptions {
+  const vaultDir = path.resolve(cwd, cli.vaultDir ?? userConfig.vaultDir ?? DEFAULTS.vaultDir);
+  const outDir = path.resolve(cwd, cli.outDir ?? userConfig.outDir ?? DEFAULTS.outDir);
   const cfgExclude = userConfig.exclude ?? [];
   const cliExclude = cli.exclude ?? [];
   const mergedExclude = Array.from(new Set([...DEFAULTS.exclude, ...cfgExclude, ...cliExclude]));
+  const staticPaths = normalizeStaticPaths(userConfig.staticPaths, "[config]");
   const seo = normalizeSeoConfig(userConfig.seo);
   const siteTitleRaw = userConfig.seo?.siteName ?? userConfig.seo?.defaultTitle;
   const siteTitle =
@@ -179,9 +221,10 @@ export function resolveBuildOptions(
   const resolvedPinnedMenu = pinnedMenu ?? configPinnedMenu;
 
   return {
-    vaultDir: path.resolve(cwd, cli.vaultDir ?? userConfig.vaultDir ?? DEFAULTS.vaultDir),
-    outDir: path.resolve(cwd, cli.outDir ?? userConfig.outDir ?? DEFAULTS.outDir),
+    vaultDir,
+    outDir,
     exclude: mergedExclude,
+    staticPaths,
     newWithinDays: cli.newWithinDays ?? userConfig.ui?.newWithinDays ?? DEFAULTS.newWithinDays,
     recentLimit: cli.recentLimit ?? userConfig.ui?.recentLimit ?? DEFAULTS.recentLimit,
     siteTitle,

package/src/dev.ts

@@ -8,6 +8,10 @@ interface DevOptions {
   port: number;
 }
 
+function isStaticPathMatch(relPath: string, staticPath: string): boolean {
+  return relPath === staticPath || relPath.startsWith(`${staticPath}/`);
+}
+
 async function resolveOutputFile(outDir: string, pathname: string): Promise<string | null> {
   const decoded = decodeURIComponent(pathname);
   const clean = decoded.replace(/^\/+/, "");
@@ -89,7 +93,14 @@ export async function runDev(options: BuildOptions, devOptions: DevOptions): Pro
   };
 
   watcher.on("all", (_event, changedPath) => {
-    if (!/\.md$/i.test(changedPath)) {
+    const relPath = path.relative(options.vaultDir, changedPath).split(path.sep).join("/");
+    if (!relPath || relPath.startsWith("..")) {
+      return;
+    }
+
+    const isMarkdownChange = /\.md$/i.test(changedPath);
+    const isStaticChange = options.staticPaths.some((staticPath) => isStaticPathMatch(relPath, staticPath));
+    if (!isMarkdownChange && !isStaticChange) {
       return;
     }
     scheduleRebuild();

package/src/runtime/app.css

@@ -64,6 +64,8 @@
   --badge-new-fg: #ffffff;
   --mobile-toggle-bg: var(--latte-mauve);
   --mobile-toggle-fg: #ffffff;
+  --content-heading-accent-soft: rgba(136, 57, 239, 0.32);
+  --content-heading-subtle: var(--latte-subtext1);
   --desktop-sidebar-default: 420px;
   --desktop-sidebar-min: 320px;
   --desktop-viewer-min: 680px;
@@ -111,6 +113,8 @@
   --badge-new-fg: var(--mocha-crust);
   --mobile-toggle-bg: var(--mocha-mauve);
   --mobile-toggle-fg: var(--mocha-crust);
+  --content-heading-accent-soft: rgba(203, 166, 247, 0.34);
+  --content-heading-subtle: var(--mocha-subtext0);
 }
 
 * {
@@ -884,20 +888,55 @@ body.mobile-toggle-left .mobile-menu-toggle {
   color: var(--latte-subtext1);
 }
 
+.viewer-content > :first-child {
+  margin-top: 0;
+}
+
 .viewer-content h1,
 .viewer-content h2,
 .viewer-content h3,
 .viewer-content h4 {
   color: var(--latte-text);
-  font-weight: 600;
-  line-height: 1.35;
-  margin-top: 2rem;
-  margin-bottom: 1rem;
+  font-weight: 650;
+  line-height: 1.33;
+  letter-spacing: -0.015em;
+  text-wrap: balance;
+  margin-top: 2.2rem;
+  margin-bottom: 0.95rem;
+  scroll-margin-top: 20px;
+}
+
+.viewer-content h1 {
+  font-size: 2.08rem;
+  font-weight: 760;
+  letter-spacing: -0.02em;
+  margin-top: 2.8rem;
+  margin-bottom: 1.1rem;
+  padding-bottom: 0.4rem;
+  border-bottom: 1px solid var(--latte-surface0);
+}
+
+.viewer-content h2 {
+  font-size: 1.62rem;
+  margin-top: 2.6rem;
+  margin-bottom: 1.04rem;
+  padding: 0.1rem 0 0.18rem 0.55rem;
+  border-left: 3px solid var(--content-heading-accent-soft);
 }
 
-.viewer-content h1 { font-size: 2rem; }
-.viewer-content h2 { font-size: 1.5rem; }
-.viewer-content h3 { font-size: 1.25rem; }
+.viewer-content h3 {
+  font-size: 1.34rem;
+  color: var(--content-heading-subtle);
+  margin-top: 2.15rem;
+  margin-bottom: 0.92rem;
+}
+
+.viewer-content h4 {
+  font-size: 1.14rem;
+  color: var(--content-heading-subtle);
+  margin-top: 1.85rem;
+  margin-bottom: 0.8rem;
+}
 
 .viewer-content p {
   margin-bottom: 1.25rem;
@@ -1318,15 +1357,15 @@ body.mobile-toggle-left .mobile-menu-toggle {
   }
 
   .viewer-content h1 {
-    font-size: 1.72rem;
+    font-size: 1.82rem;
   }
 
   .viewer-content h2 {
-    font-size: 1.34rem;
+    font-size: 1.42rem;
   }
 
   .viewer-content h3 {
-    font-size: 1.16rem;
+    font-size: 1.22rem;
   }
 
   .viewer-content table {

package/src/types.ts

@@ -39,6 +39,7 @@ export interface UserConfig {
   vaultDir?: string;
   outDir?: string;
   exclude?: string[];
+  staticPaths?: string[];
   pinnedMenu?: {
     label?: string;
     sourceDir: string;
@@ -63,6 +64,7 @@ export interface BuildOptions {
   vaultDir: string;
   outDir: string;
   exclude: string[];
+  staticPaths: string[];
   newWithinDays: number;
   recentLimit: number;
   siteTitle?: string;