dommief 0.1.0 → 0.1.2

package/src/theme/types.ts

@@ -0,0 +1,25 @@
+export type ThemeSlotName = string;
+export type ThemeLayoutName = 'GlobalLayout' | 'DocLayout' | 'DemoLayout';
+
+/** Một thư mục theme đã quét (DM-501). Không phải `virtual:dommief/theme` của CONTRACTS §4.3 (hoãn: client không cần biết cấu trúc theme, chỉ cần alias đã resolve — xem resolver.ts). */
+export interface ThemeManifest {
+  /** Tên package theme (vd 'dommief-theme-default'), chỉ để debug/log. */
+  name: string;
+  /** Absolute path thư mục theme đã resolve (hoặc thư mục `src` nếu theme nằm trong monorepo nguồn). */
+  root: string;
+  /** specifier (PascalCase) → absolute path file nguồn. */
+  builtins: Record<string, string>;
+  /** specifier (PascalCase) → absolute path file nguồn. */
+  slots: Record<string, string>;
+  /** Chỉ 3 tên hợp lệ; thiếu 1 trong 3 là lỗi (theme không hoàn chỉnh). */
+  layouts: Record<ThemeLayoutName, string>;
+  /** localeId (vd 'en-US') → absolute path file json. */
+  locales: Record<string, string>;
+  /** Absolute path tới `plugin.ts`/`plugin.js`, nếu có. */
+  plugin: string | null;
+}
+
+export interface ThemeLoaderOptions {
+  cwd: string;
+  theme?: string;
+}

package/src/theme-modules.d.ts

@@ -0,0 +1,52 @@
+declare module 'dommief/theme/layouts/GlobalLayout' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/layouts/DocLayout' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/layouts/DemoLayout' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/NotFound' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/Navbar' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/Footer' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/Sidebar' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/Toc' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/Content' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/ColorSwitch' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/SearchBox' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/Api' {
+  const Component: any;
+  export default Component;
+}
+declare module 'dommief/theme/slots/Demo' {
+  const Component: any;
+  export default Component;
+}

package/src/utils/path.ts

@@ -0,0 +1,8 @@
+/**
+ * Chuẩn hoá đường dẫn về dạng POSIX (CONTRACTS §1): mọi `\` thành `/`.
+ * Giữ nguyên UNC path của Windows (`\\?\C:\...`) vì đổi sẽ làm path không dùng được.
+ */
+export function winPath(p: string): string {
+  if (/^\\\\\?\\/.test(p)) return p;
+  return p.replace(/\\/g, '/');
+}

package/src/vite/plugin.ts

@@ -0,0 +1,182 @@
+import type { Plugin } from 'vite';
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadConfig, type ResolvedConfig } from '../config.js';
+import { createPluginHost, type PluginHookHost } from '../plugins.js';
+import { transformMarkdown } from '../markdown/index.js';
+import { resolveClientFile, resolveThemeApiFile } from '../paths.js';
+import { dommiefRoutesPlugin } from './routesPlugin.js';
+import { dommiefSitePlugin } from './sitePlugin.js';
+import { dommiefSearchIndexPlugin } from './searchIndexPlugin.js';
+import { createState } from './state.js';
+import { winPath } from '../utils/path.js';
+import { escapeXml } from '../sitemap.js';
+import { buildAliasChain } from '../theme/resolver.js';
+import { computePipelineHash, computeRoutesHash, type TransformCache } from '../cache.js';
+// Import từ prefers-color.js (KHÔNG phải theme-api.js): file này chạy trong tiến trình
+// Node của CLI (build-time), không qua bundle SSR của Vite. Import trực tiếp theme-api.tsx
+// (có JSX + hook 'react') từng nạp 'react' vào tiến trình CLI qua đường khác với bản mà
+// server.mjs dùng để renderToPipeableStream → 2 dispatcher react khác nhau →
+// `TypeError: dispatcher.getOwner is not a function` (đã bắt trực tiếp, không phải suy đoán).
+import { PREFERS_COLOR_ATTR, PREFERS_COLOR_BOOT_SCRIPT, resolveConfiguredColor, type PrefersColorValue } from '../prefers-color.js';
+
+const demoRegistry = new Map<string, string>();
+// Thư mục file .md chứa demo inline: import tương đối trong demo resolve theo đây.
+const demoDirs = new Map<string, string>();
+
+export interface DommiefPluginOptions {
+  root: string;
+  /** Đã resolve sẵn (CLI): dùng lại, không đọc config lần nữa. */
+  config?: ResolvedConfig;
+  /** Plugin host dùng chung với CLI (để `onBuildEnd` chạy trên đúng host đã đăng ký hook). */
+  host?: PluginHookHost;
+  /** Chỉ `dommief build` truyền vào (DM-406); dev chạy trong bộ nhớ Vite nên không cache. */
+  cache?: TransformCache;
+  /** DM-801: thu `PageMeta.texts` ngay trong lượt transform đã có (cả cache hit lẫn miss —
+   * payload cache luôn chứa `meta.texts`), KHÔNG transform lại file .md ở bước search index
+   * riêng — nếu không phải tự dựng lại `routesHash`/`pipelineHash` khớp hệt để trúng cache
+   * (sai một chi tiết = miss toàn bộ, im lặng) và thổi gấp đôi số cache stats hiển thị cho
+   * người dùng. Chỉ `dommief build` truyền vào. */
+  collectTexts?: (file: string, texts: import('../markdown/index.js').TextFragment[]) => void;
+}
+
+// Plugin tổng hợp: transform md + ?meta + entry ảo, và uỷ thác virtual:dommief/routes
+// + virtual:dommief/site cho hai plugin riêng để invalidate độc lập (DM-206/209).
+export function dommiefPlugin(opts: DommiefPluginOptions) {
+  let loaded: { config: ResolvedConfig; host: PluginHookHost } | undefined =
+    opts.config ? { config: opts.config, host: opts.host ?? createPluginHost(opts.config.plugins ?? []) } : undefined;
+  const state = createState(opts.root, () => {
+    if (!loaded) throw new Error('dommief: config chưa được nạp');
+    return loaded;
+  });
+
+  const markdownPlugin: Plugin = {
+    name: 'dommief:markdown',
+    enforce: 'pre',
+    async config() {
+      if (!loaded) {
+        const config = await loadConfig(opts.root);
+        loaded = { config, host: createPluginHost(config.plugins ?? []) };
+      }
+      const aliases = buildAliasChain(opts.root, loaded.config);
+      // `package.json` export `./theme-api` trỏ `dist/theme-api.js`; theme (vd theme-default) import
+      // `dommief/theme-api` phải trúng file NGUỒN mà entry-client/entry-server import (resolveClientFile
+      // luôn chọn source), nếu không sẽ ra 2 module khác nhau → `SiteContext` khác nhau →
+      // `useSiteData()`/`useNavData()` trong theme luôn rỗng (xem paths.ts).
+      aliases['dommief/theme-api'] = resolveThemeApiFile();
+      return {
+        base: loaded.config.base,
+        resolve: { dedupe: ['react', 'react-dom', 'react-router'], alias: aliases },
+        ssr: { noExternal: ['dommief'] },
+      };
+    },
+    resolveId(id, importer) {
+      if (id === 'dommief/client') return resolveClientFile('index.tsx');
+      const bare = id.replace(/^\//, '');
+      if (bare === 'virtual:dommief/entry') return '\0virtual:dommief/entry';
+      if (bare.startsWith('virtual:dommief-demo/')) return '\0' + bare;
+      if (importer?.startsWith('\0virtual:dommief-demo/') && id.startsWith('.')) {
+        const dir = demoDirs.get(importer.slice('\0virtual:dommief-demo/'.length));
+        if (dir) return this.resolve(path.resolve(dir, id), path.join(dir, '_demo.tsx'), { skipSelf: true });
+      }
+      if (bare === 'virtual:dommief/routes' || bare === 'virtual:dommief/site') return null;
+      if (id.endsWith('.md') || id.endsWith('.md?meta')) {
+        const base = importer ? path.dirname(importer.replace(/\?meta$/, '')) : process.cwd();
+        const q = id.endsWith('?meta') ? '?meta' : '';
+        const clean = id.replace(/\?meta$/, '');
+        // Id = absolute POSIX path (+ `?meta`), KHÔNG `\0`: nhờ vậy `ModuleNode.file` là file md
+        // thật và Vite tự invalidate module trang khi file đổi (DM-209 ca (d)).
+        return winPath(path.isAbsolute(clean) ? clean : path.resolve(base, clean)) + q;
+      }
+      return null;
+    },
+    async load(id) {
+      if (id.startsWith('\0virtual:dommief-demo/')) {
+        const demoId = id.slice('\0virtual:dommief-demo/'.length);
+        const source = demoRegistry.get(demoId) ?? 'export default function Demo(){ return null; }';
+        return { code: source, map: null, moduleType: 'jsx' };
+      }
+      if (id === '\0virtual:dommief/entry') {
+        return { code: `import ${JSON.stringify(resolveClientFile('entry-client.tsx'))};`, map: null, moduleType: 'js' };
+      }
+      if (id.endsWith('.md') || id.endsWith('.md?meta')) {
+        const isMeta = id.endsWith('?meta');
+        const file = isMeta ? id.slice(0, -'?meta'.length) : id;
+        const code = await fs.promises.readFile(file, 'utf8');
+        const transformOpts = { hooks: state.host(), byFile: state.getTable().byFile, base: state.config().base, code: state.config().markdown };
+        let out: string; let meta: Awaited<ReturnType<typeof transformMarkdown>>['meta']; let warnings: string[]; let apiSrcFiles: string[] = [];
+        if (opts.cache) {
+          const host = state.host();
+          const input = {
+            md: code, file, base: transformOpts.base,
+            routesHash: computeRoutesHash(transformOpts.byFile),
+            pipelineHash: computePipelineHash({ code: transformOpts.code, plugins: [...host.collectRemarkPlugins(), ...host.collectRehypePlugins()] }),
+          };
+          // `<API src>` đọc file nguồn khác .md: nội dung phụ thuộc file đó, không nằm trong key => không cache trang này.
+          const cacheable = !/<API[\s/>]/.test(code);
+          const hit = await opts.cache.getOrCompute(file, input, async () => {
+            const r = await transformMarkdown(code, file, transformOpts);
+            return { code: r.code, meta: r.meta, warnings: r.warnings, demos: r.demos };
+          }, cacheable);
+          let hitDemos: { id: string; source: string; src?: string }[] = [];
+          ({ code: out, meta, warnings } = hit);
+          hitDemos = hit.demos ?? [];
+          for (const d of hitDemos) { demoRegistry.set(d.id, d.source); demoDirs.set(d.id, path.dirname(file)); if (d.src) this.addWatchFile(path.resolve(path.dirname(file), d.src)); }
+        } else {
+          const r = await transformMarkdown(code, file, transformOpts);
+          ({ code: out, meta, warnings, apiSrcFiles } = r);
+          const nonCacheDemos = (r as any).demos ?? [];
+          for (const d of nonCacheDemos as any) { demoRegistry.set(d.id, d.source); demoDirs.set(d.id, path.dirname(file)); if (d.src) this.addWatchFile(path.resolve(path.dirname(file), d.src)); }
+        }
+        for (const w of warnings) this.warn(w);
+        for (const apiFile of apiSrcFiles) this.addWatchFile(apiFile); // <API src> đọc file khác .md (#17)
+        if (!isMeta) opts.collectTexts?.(file, meta.texts); // DM-801: thu 1 lần/file, không tính với nhánh `?meta`
+        if (isMeta) {
+          // ?meta: import công khai cho code người dùng (vd `import m from './x.md?meta'`).
+          // KHÔNG còn ai trong core dùng đường này để dựng site module — xem `extractPageSummary` (#12).
+          // Trả frontmatter + toc (nhỏ) — không texts (nặng, chỉ để tìm kiếm).
+          return { code: `export default ${JSON.stringify({ frontmatter: meta.frontmatter, toc: meta.toc })};`, map: null, moduleType: 'js' };
+        }
+        return { code: out, map: null, moduleType: 'jsx' };
+      }
+      return null;
+    },
+    // order 'pre': script chèn ở đây phải đi qua bước bundle HTML của Vite, nếu không build không có JS.
+    transformIndexHtml: { order: 'pre', handler(html) {
+      const title = state.config().title;
+      let out = html;
+      if (!/<title>/.test(out)) out = out.replace('<head>', `<head><title>${escapeXml(title)}</title>`);
+      const tags = state.host().collectHtmlHeadTags();
+      if (tags.length) out = out.replace('</head>', tags.join('\n') + '</head>');
+      // THEME-API §9.2 + Amendment #1: inline script < 1KB, KHÔNG `async`/`defer`, chạy trước
+      // paint để không nháy sáng rồi sang tối. Nếu `themeConfig.prefersColor.default` khác
+      // 'auto', SSR ghi thẳng `data-prefers-color` vào `<html>` để trang đúng màu ngay cả khi
+      // tắt JS (gate Phase 4) — inline script chỉ GHI ĐÈ khi localStorage có lựa chọn khác.
+      const themeConfig = state.config().themeConfig as { prefersColor?: { default?: PrefersColorValue } } | undefined;
+      const configuredColor = resolveConfiguredColor(themeConfig?.prefersColor?.default);
+      if (configuredColor && !/data-prefers-color=/.test(out)) {
+        out = out.replace(/<html(\s|>)/, `<html ${PREFERS_COLOR_ATTR}="${configuredColor}"$1`);
+      }
+      if (!out.includes(PREFERS_COLOR_BOOT_SCRIPT)) {
+        out = out.replace('</head>', `<script>${PREFERS_COLOR_BOOT_SCRIPT}</script></head>`);
+      }
+      if (!out.includes('virtual:dommief/entry')) {
+        out = out.replace('</body>', `<script type="module" src="/virtual:dommief/entry"></script></body>`);
+      }
+      return out;
+    } },
+    configureServer(server) {
+      // DM-502: thêm/xoá file trong `.dommief/theme/**` phải đăng ký lại alias KHÔNG restart server.
+      // Alias cũ đã bị các module khác import tĩnh ⇒ không cách nào HMR theo chuẩn, phải full-reload.
+      const localThemeDir = winPath(path.resolve(opts.root, '.dommief', 'theme')) + '/';
+      const update = () => {
+        const aliases = buildAliasChain(opts.root, loaded!.config);
+        server.config.resolve.alias = { ...(server.config.resolve.alias as any), ...aliases };
+        server.ws.send({ type: 'full-reload' });
+      };
+      server.watcher.on('add', (f) => { if (winPath(f).startsWith(localThemeDir)) update(); });
+      server.watcher.on('unlink', (f) => { if (winPath(f).startsWith(localThemeDir)) update(); });
+    },
+  };
+  return [markdownPlugin, dommiefRoutesPlugin(state), dommiefSitePlugin(state), dommiefSearchIndexPlugin(state)] as Plugin[];
+}

package/src/vite/routesPlugin.ts

@@ -0,0 +1,39 @@
+import type { Plugin, ViteDevServer } from 'vite';
+import { createRoutesModule } from '../routesModule.js';
+import type { DommiefState } from './state.js';
+
+// Đặc tả: backlog DM-206. Plugin riêng `dommief:routes` để DM-303 invalidate độc lập.
+// Invalidate chỉ khi topology đổi (md thêm/xoá/đổi tên). Sửa nội dung md (kể cả frontmatter) KHÔNG invalidate.
+
+export function dommiefRoutesPlugin(state: DommiefState): Plugin {
+  const virtualId = 'virtual:dommief/routes';
+  const resolvedId = '\0' + virtualId;
+  let server: ViteDevServer | null = null;
+
+  const invalidate = () => {
+    state.resetTable();
+    const mod = server?.moduleGraph.getModuleById(resolvedId);
+    if (mod) server!.moduleGraph.invalidateModule(mod);
+  };
+
+  return {
+    name: 'dommief:routes',
+    enforce: 'pre',
+    configureServer(s) { server = s; },
+    resolveId(id) {
+      if (id === virtualId) return resolvedId;
+      return null;
+    },
+    load(id) {
+      if (id !== resolvedId) return null;
+      return { code: createRoutesModule(state.getTable().routes), map: null };
+    },
+    watchChange(id, { event }) {
+      if (!id.endsWith('.md')) return;
+      if (event === 'create' || event === 'delete') {
+        invalidate();
+        server?.ws.send({ type: 'full-reload' });
+      }
+    },
+  };
+}

package/src/vite/searchIndexPlugin.ts

@@ -0,0 +1,66 @@
+import type { Plugin } from 'vite';
+import fs from 'node:fs';
+import type { DommiefState } from './state.js';
+
+// DM-801: `virtual:dommief/search-index` trả CHỈ MANIFEST (URL theo locale), KHÔNG trả dữ liệu
+// index inline — tránh gửi hàng MB index vào bundle client (tiêu chí #2).
+// - Dev: middleware phục vụ `*/search-index/<locale>.json` bằng buildSearchIndex on-the-fly (không cache).
+// - Build: search emitter trong build.ts ghi file thật vào dist/search-index/; dev không cần ghi file.
+
+const VIRTUAL_ID = 'virtual:dommief/search-index';
+const RESOLVED_ID = '\0' + VIRTUAL_ID;
+const PREFIX = '/search-index/';
+
+export function dommiefSearchIndexPlugin(state: DommiefState): Plugin {
+  return {
+    name: 'dommief:search-index',
+    enforce: 'pre',
+    resolveId(id) {
+      if (id === VIRTUAL_ID) return RESOLVED_ID;
+      return null;
+    },
+    load(id) {
+      if (id !== RESOLVED_ID) return null;
+      const config = state.config();
+      if (!config.search.enabled) return { code: 'export const manifest = { locales: {} }; export default manifest;\n', map: null };
+      const locales = Object.fromEntries((config.locales ?? []).map((l) => [l.id, `${config.base}search-index/${l.id}.json`]));
+      return { code: `export const manifest = ${JSON.stringify({ locales })}; export default manifest;\n`, map: null };
+    },
+    configureServer(s) {
+      s.middlewares.use(async (req, res, next) => {
+        const url = req.url?.split('?')[0] ?? '';
+        if (!url.endsWith('.json')) return next();
+        const base = (state.config().base || '/').replace(/\/$/, '') || '';
+        const localPath = base && url.startsWith(base + PREFIX) ? url.slice((base + PREFIX).length) : (url.startsWith(PREFIX) ? url.slice(PREFIX.length) : null);
+        if (localPath === null) return next();
+        const localeId = localPath.replace(/\.json$/, '');
+        if (!state.config().locales?.some((l) => l.id === localeId)) return next();
+        if (!state.config().search.enabled) { res.statusCode = 404; return res.end(); }
+        try {
+          const { buildSearchIndex } = await import('../search.js');
+          const { transformMarkdown } = await import('../markdown/index.js');
+          const t = state.getTable();
+          const routes = t.routes.filter((r) => (r.locale ?? state.config().locales[0]?.id) === localeId);
+          // Dev không dùng cache; đọc trực tiếp file .md để có texts (extractPageSummary trong sitePlugin
+          // chỉ lấy frontmatter+toc để dựng site module nhẹ, KHÔNG có texts — texts chỉ nằm trong
+          // transformMarkdown/PageMeta).
+          const resIdx = await buildSearchIndex({
+            routes,
+            loadPageMeta: async (r) => {
+              let raw: string;
+              try { raw = fs.readFileSync(r.file, 'utf8'); } catch { raw = ''; }
+              const tr = await transformMarkdown(raw, r.file, { hooks: state.host(), byFile: t.byFile, base: state.config().base, code: state.config().markdown });
+              return tr.meta;
+            },
+            config: { locales: state.config().locales },
+          });
+          res.setHeader('Content-Type', 'application/json');
+          res.end(JSON.stringify(resIdx.locales[localeId] ?? {}));
+        } catch (e: unknown) {
+          res.statusCode = 500;
+          res.end(JSON.stringify({ error: e instanceof Error ? e.message : 'search index build failed' }));
+        }
+      });
+    },
+  };
+}

package/src/vite/sitePlugin.ts

@@ -0,0 +1,97 @@
+import type { Plugin, ViteDevServer } from 'vite';
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { createSiteModule, type SiteModuleMeta } from '../siteModule.js';
+import { extractPageSummary } from '../markdown/remark-meta.js';
+import type { DommiefState } from './state.js';
+
+// Đặc tả: backlog DM-209. Plugin riêng `dommief:site` giữ `virtual:dommief/site` nhẹ.
+// Invalidate chỉ khi frontmatter của md đổi, md thêm/xoá/đổi tên, hoặc config đổi.
+// Sửa thân bài KHÔNG invalidate.
+
+function frontmatterHash(file: string): string {
+  let raw: string;
+  try { raw = readFileSync(file, 'utf8'); } catch { return ''; }
+  const m = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  const block = m?.[1] ?? '';
+  // heading cũng vào hash: `toc` nằm trong site module nên đổi tiêu đề phải invalidate nó.
+  const headings = raw.match(/^#{1,6}\s.*$/gm)?.join('\n') ?? '';
+  return createHash('sha256').update(block + '\n--\n' + headings).digest('hex').slice(0, 16);
+}
+
+export function dommiefSitePlugin(state: DommiefState): Plugin {
+  const virtualId = 'virtual:dommief/site';
+  const resolvedId = '\0' + virtualId;
+
+  let frontmatterHashes = new Map<string, string>();
+  let cache: string | null = null;
+  let server: ViteDevServer | null = null;
+
+  const invalidate = () => {
+    cache = null;
+    state.resetTable();
+    const mod = server?.moduleGraph.getModuleById(resolvedId);
+    if (mod) server!.moduleGraph.invalidateModule(mod);
+  };
+
+  return {
+    name: 'dommief:site',
+    enforce: 'pre',
+    configureServer(s) { server = s; },
+    resolveId(id) {
+      if (id === virtualId) return resolvedId;
+      return null;
+    },
+    load(this: any, id) {
+      if (id !== resolvedId) return null;
+      if (cache) return { code: cache, map: null };
+      const config = state.config();
+      const t = state.getTable();
+      // Một lần đọc file cho cả frontmatter lẫn toc (#12): không còn import `.md?meta` riêng
+      // cho từng route, nên cả nav/sidebar lẫn `site.meta` đều ra từ cùng một parser.
+      const summaries = new Map(t.routes.map((r) => {
+        let raw: string;
+        try { raw = readFileSync(r.file, 'utf8'); } catch { raw = ''; }
+        return [r.id, extractPageSummary(raw, r.file, (m) => this.warn(m))] as const;
+      }));
+      const frontmatter = Object.fromEntries([...summaries].map(([id, s]) => [id, s.frontmatter]));
+      const meta: SiteModuleMeta = Object.fromEntries([...summaries].map(([id, s]) => [id, s]));
+      const code = createSiteModule({
+        routes: t.routes,
+        config: {
+          base: config.base,
+          title: config.title,
+          description: config.description,
+          locales: config.locales,
+          themeConfig: config.themeConfig,
+          frontmatter,
+          search: { enabled: config.search.enabled },
+        },
+        meta,
+      });
+      // ghi nhớ hash frontmatter hiện tại cho từng file
+      frontmatterHashes = new Map(t.routes.map((r) => [r.file, frontmatterHash(r.file)]));
+      cache = code;
+      return { code, map: null };
+    },
+    handleHotUpdate(ctx) {
+      const id = ctx.file;
+      if (!id.endsWith('.md')) return;
+      const oldHash = frontmatterHashes.get(id);
+      const newHash = frontmatterHash(id);
+      // Chưa có hash cũ (site module chưa từng load) ⇒ cache cũng chưa có, không cần invalidate.
+      if (oldHash !== undefined && oldHash !== newHash) {
+        frontmatterHashes.set(id, newHash);
+        invalidate();
+      }
+      // trả undefined → Vite dùng hành vi mặc định (module trang vẫn HMR)
+    },
+    watchChange(id, { event }) {
+      if (!id.endsWith('.md')) return;
+      if (event === 'create' || event === 'delete') {
+        invalidate();
+        server?.ws.send({ type: 'full-reload' });
+      }
+    },
+  };
+}

package/src/vite/state.ts

@@ -0,0 +1,27 @@
+import { buildRouteTable } from '../routes.js';
+import type { ResolvedConfig } from '../config.js';
+import type { PluginHookHost } from '../plugins.js';
+import type { RouteTable } from '../types.js';
+
+/**
+ * Trạng thái dùng chung của ba plugin Vite (markdown/routes/site): MỘT config, MỘT plugin host,
+ * MỘT route table. Trước đây mỗi plugin tự quét và tự gọi `modifyRoutes`, nên hai bảng có thể lệch nhau.
+ */
+export interface DommiefState {
+  cwd: string;
+  config(): ResolvedConfig;
+  host(): PluginHookHost;
+  getTable(): RouteTable;
+  resetTable(): void;
+}
+
+export function createState(cwd: string, get: () => { config: ResolvedConfig; host: PluginHookHost }): DommiefState {
+  let table: RouteTable | null = null;
+  return {
+    cwd,
+    config: () => get().config,
+    host: () => get().host,
+    getTable: () => (table ??= buildRouteTable({ cwd, config: get().config, hooks: get().host })),
+    resetTable: () => { table = null; },
+  };
+}