@limcpf/everything-is-a-markdown 0.5.0 → 0.5.2

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.0",
+  "version": "0.5.2",
   "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);
 }
 
@@ -804,6 +806,7 @@ function buildManifest(docs: DocRecord[], tree: TreeNode[], options: BuildOption
 
   return {
     generatedAt: new Date().toISOString(),
+    siteTitle: resolveSiteTitle(options),
     defaultBranch: DEFAULT_BRANCH,
     branches,
     ui: {
@@ -816,6 +819,24 @@ function buildManifest(docs: DocRecord[], tree: TreeNode[], options: BuildOption
   };
 }
 
+function resolveSiteTitle(options: BuildOptions): string {
+  const value = options.siteTitle ?? options.seo?.siteName ?? options.seo?.defaultTitle ?? DEFAULT_SITE_TITLE;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : DEFAULT_SITE_TITLE;
+}
+
+function composeDocumentTitle(pageTitle: string, siteTitle: string): string {
+  const left = pageTitle.trim();
+  const right = siteTitle.trim();
+  if (!left) {
+    return right || DEFAULT_SITE_TITLE;
+  }
+  if (!right || left === right) {
+    return left;
+  }
+  return `${left} - ${right}`;
+}
+
 function pickSeoImageDefaults(
   seo: BuildOptions["seo"],
 ): { social: string | null; og: string | null; twitter: string | null } {
@@ -905,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);
@@ -948,11 +1055,13 @@ async function writeRuntimeAssets(context: OutputWriteContext): Promise<RuntimeA
 }
 
 function buildShellMeta(route: string, doc: DocRecord | null, options: BuildOptions): AppShellMeta {
-  const defaultTitle = options.seo?.defaultTitle ?? DEFAULT_SITE_TITLE;
+  const defaultTitle = options.seo?.defaultTitle ?? options.siteTitle ?? DEFAULT_SITE_TITLE;
+  const siteTitle = resolveSiteTitle(options);
   const defaultDescription = options.seo?.defaultDescription ?? DEFAULT_SITE_DESCRIPTION;
   const description = typeof doc?.description === "string" && doc.description.trim().length > 0 ? doc.description.trim() : undefined;
   const canonicalUrl = options.seo ? buildCanonicalUrl(route, options.seo) : undefined;
-  const title = doc?.title ?? defaultTitle;
+  const baseTitle = doc?.title ?? defaultTitle;
+  const title = composeDocumentTitle(baseTitle, siteTitle);
   const imageDefaults = pickSeoImageDefaults(options.seo);
   const ogImage = imageDefaults.og ?? imageDefaults.social ?? undefined;
   const twitterImage = imageDefaults.twitter ?? imageDefaults.social ?? undefined;
@@ -1221,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);
@@ -1292,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,19 +205,29 @@ 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 =
+    typeof siteTitleRaw === "string" && siteTitleRaw.trim().length > 0
+      ? siteTitleRaw.trim()
+      : undefined;
   const configPinnedMenu = normalizePinnedMenu(userConfig.pinnedMenu, "[config]");
   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,
     pinnedMenu: resolvedPinnedMenu,
     wikilinks: userConfig.markdown?.wikilinks ?? DEFAULTS.wikilinks,
     imagePolicy: userConfig.markdown?.images ?? DEFAULTS.imagePolicy,

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.js

@@ -11,6 +11,7 @@ const DESKTOP_VIEWER_MIN = 680;
 const DESKTOP_SPLITTER_WIDTH = 10;
 const DESKTOP_SPLITTER_STEP = 24;
 const DEFAULT_BRANCH = "dev";
+const DEFAULT_SITE_TITLE = "File-System Blog";
 const BRANCH_KEY = "fsblog.branch";
 const FOCUSABLE_SELECTOR =
   'a[href], button:not([disabled]), input:not([disabled]), textarea:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex="-1"])';
@@ -130,6 +131,23 @@ function resolveRouteFromLocation(routeMap) {
   return direct;
 }
 
+function resolveSiteTitle(manifest) {
+  const value = typeof manifest?.siteTitle === "string" ? manifest.siteTitle.trim() : "";
+  return value || DEFAULT_SITE_TITLE;
+}
+
+function composeDocumentTitle(pageTitle, siteTitle) {
+  const left = String(pageTitle ?? "").trim();
+  const right = String(siteTitle ?? "").trim();
+  if (!left) {
+    return right || DEFAULT_SITE_TITLE;
+  }
+  if (!right || left === right) {
+    return left;
+  }
+  return `${left} - ${right}`;
+}
+
 function formatMetaDateTime(value) {
   const parsed = new Date(value);
   if (!Number.isFinite(parsed.getTime())) {
@@ -1127,6 +1145,7 @@ async function start() {
     }
     manifest = await manifestRes.json();
   }
+  const siteTitle = resolveSiteTitle(manifest);
   const defaultBranch = normalizeBranch(manifest.defaultBranch) || DEFAULT_BRANCH;
   const availableBranchSet = new Set([defaultBranch]);
   for (const doc of manifest.docs) {
@@ -1296,7 +1315,7 @@ async function start() {
 
       if (shouldUseInitialView) {
         hasHydratedInitialView = true;
-        document.title = `${initialViewData.title} - File-System Blog`;
+        document.title = composeDocumentTitle(initialViewData.title, siteTitle);
         if (viewerEl instanceof HTMLElement) {
           viewerEl.scrollTo(0, 0);
         }
@@ -1320,7 +1339,7 @@ async function start() {
 
       navEl.innerHTML = renderNav(view.docs, view.docIndexById, id);
 
-      document.title = `${doc.title} - File-System Blog`;
+      document.title = composeDocumentTitle(doc.title, siteTitle);
       if (viewerEl instanceof HTMLElement) {
         viewerEl.scrollTo(0, 0);
       }

package/src/template.ts

@@ -183,6 +183,9 @@ export function renderAppShellHtml(
   const initialManifestScript = renderInitialManifestScript(manifest);
   const symbolFontStylesheet =
     "https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&display=swap";
+  const appTitle = typeof manifest?.siteTitle === "string" && manifest.siteTitle.trim().length > 0
+    ? manifest.siteTitle.trim()
+    : DEFAULT_TITLE;
   const initialTitle = initialView ? escapeHtmlAttribute(initialView.title) : "문서를 선택하세요";
   const initialBreadcrumb = initialView ? initialView.breadcrumbHtml : "";
   const initialMeta = initialView ? initialView.metaHtml : "";
@@ -213,7 +216,7 @@ ${headMeta}
         <div class="sidebar-header">
           <h1 class="sidebar-title">
             <span class="material-symbols-outlined icon-terminal">terminal</span>
-            ~/dev-blog
+            ${escapeHtmlAttribute(appTitle)}
           </h1>
           <button id="sidebar-close" class="sidebar-close" type="button" aria-label="탐색기 닫기">
             <span class="material-symbols-outlined">close</span>

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,8 +64,10 @@ export interface BuildOptions {
   vaultDir: string;
   outDir: string;
   exclude: string[];
+  staticPaths: string[];
   newWithinDays: number;
   recentLimit: number;
+  siteTitle?: string;
   pinnedMenu: PinnedMenuOption | null;
   wikilinks: boolean;
   imagePolicy: ImagePolicy;
@@ -123,6 +126,7 @@ export type TreeNode = FolderNode | FileNode;
 
 export interface Manifest {
   generatedAt: string;
+  siteTitle: string;
   defaultBranch: string;
   branches: string[];
   ui: {