@riebeckite/honox 0.0.1 → 0.0.3

package/dist/index.js

@@ -154,424 +154,1034 @@ function pathToFileUrl(filePath) {
   return `file:///${filePath.replace(/\\/g, "/").replace(/^([A-Za-z]):/, "$1:")}`;
 }
 
-// src/ssg_plugin.ts
-import { defaultExtensionMap, toSSG } from "hono/ssg";
-import { relative } from "node:path";
-import { createServer } from "vite";
-var defaultEntry = "./src/index.tsx";
-function riebeckiteSsg(options = {}) {
-  const virtualId = "virtual:riebeckite-ssg-void-entry";
-  const resolvedVirtualId = `\0${virtualId}`;
-  const entry = options.entry ?? defaultEntry;
-  let resolvedConfig;
+// src/honox_islands.ts
+import fs3 from "node:fs/promises";
+import path3 from "node:path";
+import { parse } from "@babel/parser";
+var honoxIslandDependencyPluginName = "inject-importing-islands";
+var importingIslandsExport = "__importing_islands";
+function replaceHonoxIslandDependencyPlugin(plugins) {
+  return [
+    ...plugins.map(disableHonoxIslandDependencyPlugin),
+    scopedIslandDependencyPlugin()
+  ];
+}
+function disableHonoxIslandDependencyPlugin(plugin) {
+  if (plugin instanceof Promise) {
+    return plugin.then(disableHonoxIslandDependencyPlugin);
+  }
+  if (plugin.name !== honoxIslandDependencyPluginName) return plugin;
+  return { ...plugin, transform: void 0 };
+}
+function scopedIslandDependencyPlugin() {
+  let appDirectory = "";
+  let islandDirectory = "";
   return {
-    name: "riebeckite-ssg",
-    apply: "build",
-    enforce: "post",
-    config() {
-      return {
-        build: {
-          rollupOptions: {
-            input: [virtualId]
-          }
-        }
-      };
-    },
+    name: "riebeckite-inject-importing-islands",
     configResolved(config) {
-      resolvedConfig = config;
-    },
-    resolveId(id) {
-      return id === virtualId ? resolvedVirtualId : void 0;
+      appDirectory = path3.resolve(config.root, "app");
+      islandDirectory = path3.join(appDirectory, "islands");
     },
-    load(id) {
-      return id === resolvedVirtualId ? 'console.log("suppress empty chunk message")' : void 0;
-    },
-    async generateBundle(_outputOptions, bundle) {
-      const config = resolvedConfig;
-      if (!config) {
-        throw new Error("Riebeckite SSG could not resolve the Vite configuration.");
-      }
-      removeVirtualEntryChunk(bundle, resolvedVirtualId);
-      const server2 = await createServer({
-        root: config.root,
-        define: config.define,
-        resolve: {
-          ...config.resolve,
-          builtins: [...config.resolve.builtins, /^node:/]
-        },
-        plugins: [],
-        build: { ssr: true },
-        mode: config.mode
-      });
-      try {
-        const module = await server2.ssrLoadModule(entry);
-        const app = module.default;
-        if (!app) {
-          throw new Error(`Failed to find a default export from ${entry}.`);
-        }
-        const generatedHtml = [];
-        const result = await toSSG(
-          app,
-          {
-            writeFile: async (filePath, data) => {
-              const fileName = relative(config.build.outDir, filePath).replaceAll(
-                "\\",
-                "/"
-              );
-              if (fileName.endsWith(".html") && typeof data === "string") {
-                generatedHtml.push({ path: fileName, html: data });
-              }
-              this.emitFile({
-                type: "asset",
-                fileName,
-                source: data
-              });
-            },
-            async mkdir() {
-            }
-          },
-          {
-            dir: config.build.outDir,
-            plugins: options.plugins ?? [],
-            extensionMap: options.extensionMap ?? defaultExtensionMap
-          }
-        );
-        if (!result.success) throw result.error;
-        await emitGeneratedOutputs(
-          module,
-          (asset) => this.emitFile(asset)
-        );
-        inspectGeneratedHtmlPages(module, generatedHtml, {
-          warn: (message) => this.warn(message),
-          info: (message) => this.info(message)
-        });
-      } finally {
-        await server2.close();
+    async transform(sourceCode, id) {
+      const modulePath = toFilePath(id);
+      if (!isInDirectory(modulePath, appDirectory) || !isJavaScriptModule(modulePath)) {
+        return;
       }
+      if (!await importsIsland(modulePath, sourceCode, this)) return;
+      return {
+        code: `${sourceCode}
+export const ${importingIslandsExport} = true;
+`,
+        map: null
+      };
     }
   };
-}
-async function emitGeneratedOutputs(module, emit) {
-  const content = module.content;
-  if (!content) return;
-  const manifest = await content.getManifest();
-  for (const output of manifest.generatedOutputs ?? []) {
-    emit({
-      type: "asset",
-      fileName: output.path,
-      source: output.content
-    });
-  }
-}
-function inspectGeneratedHtmlPages(module, pages, log) {
-  const plugins = module.config?.plugins ?? [];
-  for (const plugin of plugins) {
-    const inspector = plugin.inspectGeneratedHtml;
-    if (typeof inspector !== "function") continue;
-    for (const page of pages) {
-      for (const diagnostic of inspector(page) ?? []) {
-        const label = `[${plugin.name ?? "plugin"}] ${page.path}: ${diagnostic.message}`;
-        if (diagnostic.severity === "info") log.info(label);
-        else log.warn(label);
+  async function importsIsland(modulePath, sourceCode, pluginContext) {
+    const visited = /* @__PURE__ */ new Set();
+    const visit = async (currentModulePath, currentSourceCode) => {
+      if (visited.has(currentModulePath)) return false;
+      visited.add(currentModulePath);
+      if (isInDirectory(currentModulePath, islandDirectory)) return true;
+      const importSources = getStaticImportSources(currentSourceCode);
+      for (const importSource of importSources) {
+        const resolved = await pluginContext.resolve(
+          importSource,
+          currentModulePath
+        );
+        if (!resolved) continue;
+        const dependencyPath = toFilePath(resolved.id);
+        if (!isInDirectory(dependencyPath, appDirectory) || !isJavaScriptModule(dependencyPath)) {
+          continue;
+        }
+        try {
+          const dependencySourceCode = await fs3.readFile(
+            dependencyPath,
+            "utf8"
+          );
+          if (await visit(dependencyPath, dependencySourceCode)) return true;
+        } catch {
+        }
       }
-    }
+      return false;
+    };
+    return visit(modulePath, sourceCode);
   }
 }
-function removeVirtualEntryChunk(bundle, virtualEntryId) {
-  for (const chunk of Object.values(bundle)) {
-    if (chunk.type === "chunk" && chunk.moduleIds?.includes(virtualEntryId)) {
-      delete bundle[chunk.fileName];
+function getStaticImportSources(sourceCode) {
+  const ast = parse(sourceCode, {
+    sourceType: "module",
+    plugins: ["typescript", "jsx"]
+  });
+  return ast.program.body.flatMap((statement) => {
+    if (statement.type === "ImportDeclaration" || statement.type === "ExportNamedDeclaration" || statement.type === "ExportAllDeclaration") {
+      return statement.source ? [statement.source.value] : [];
     }
-  }
+    return [];
+  });
 }
-
-// src/ssg.ts
-var defaultSsgEntry = "./app/server.ts";
-function riebeckiteSsgExtensionMap() {
-  return {
-    "application/atom+xml": "xml",
-    "application/json": "json",
-    "application/rss+xml": "xml",
-    "application/xml": "xml",
-    "text/html": "html",
-    "text/plain": "txt",
-    "text/xml": "xml"
-  };
+function toFilePath(id) {
+  return id.split("?", 1)[0] ?? id;
 }
-function createRiebeckiteSsg(options = {}) {
-  return riebeckiteSsg({
-    ...options,
-    entry: options.entry ?? defaultSsgEntry,
-    extensionMap: {
-      ...riebeckiteSsgExtensionMap(),
-      ...options.extensionMap
-    }
-  });
+function isInDirectory(filePath, directory) {
+  const relativePath = path3.relative(directory, filePath);
+  return relativePath !== "" && !relativePath.startsWith(`..${path3.sep}`) && !path3.isAbsolute(relativePath);
+}
+function isJavaScriptModule(filePath) {
+  return /\.[cm]?[jt]sx?$/.test(filePath);
 }
 
-// src/vite_plugin.ts
-import path5 from "node:path";
+// src/scaffold/index.ts
+import fs4 from "node:fs/promises";
+import path4 from "node:path";
 
-// src/asset_entries.ts
-import fs3 from "node:fs";
-import path3 from "node:path";
-import { uniqueStrings } from "@riebeckite/core";
-function writeRiebeckiteAssetEntries(config, paths2) {
-  writeGeneratedFile(paths2.pluginStyles, createPluginStylesEntry(config));
-  writeGeneratedFile(paths2.themeStyles, createThemeStylesEntry(config));
-}
-function createPluginStylesEntry(config) {
-  return createStylesheetEntry(
-    collectPluginStyleSpecifiers(config),
-    "Plugin default styles, in resolved plugin order. Generated by @riebeckite/honox; do not edit. Import this before the theme stylesheet so a theme can override plugin defaults."
-  );
-}
-function createThemeStylesEntry(config) {
-  return createStylesheetEntry(
-    config.theme.styles.map((style2) => style2.moduleSpecifier),
-    "Theme styles. Generated by @riebeckite/honox; do not edit. Import this after the plugin stylesheet so the theme wins the plugin/theme cascade."
-  );
+// src/scaffold/localized-content.ts
+var SCAFFOLD_LANGUAGES = [
+  "en",
+  "ja",
+  "zh-CN",
+  "es",
+  "de",
+  "fr",
+  "ko"
+];
+function defaultLanguageForLocale(locale) {
+  const normalized = locale.toLowerCase();
+  if (normalized.startsWith("ja")) return "ja";
+  if (normalized.startsWith("zh")) return "zh-CN";
+  if (normalized.startsWith("es")) return "es";
+  if (normalized.startsWith("de")) return "de";
+  if (normalized.startsWith("fr")) return "fr";
+  if (normalized.startsWith("ko")) return "ko";
+  return "en";
+}
+var HELPERS = {
+  en: "https://github.com/Rerurate514/riebeckite/blob/main/docs/en/README.md",
+  ja: "https://github.com/Rerurate514/riebeckite/blob/main/docs/ja/README.md"
+};
+var PLUGIN_INDEX_URL = "https://github.com/Rerurate514/riebeckite/tree/main/packages/plugins";
+var THEMES_INDEX_URL = "https://github.com/Rerurate514/riebeckite/tree/main/packages/themes";
+function pluginReadmeUrl(slug) {
+  return `https://github.com/Rerurate514/riebeckite/blob/main/packages/plugins/${slug}/README.md`;
+}
+function themeReadmeUrl(slug) {
+  return `https://github.com/Rerurate514/riebeckite/blob/main/packages/themes/${slug}/README.md`;
+}
+function localizedContentFiles(variables) {
+  const defaultLang = defaultLanguageForLocale(variables.locale);
+  const pages = [
+    { basePath: "index", build: (language) => indexContent(variables, language) },
+    { basePath: "framework/plugins", build: (language) => pluginsContent(language) },
+    { basePath: "framework/themes", build: (language) => themesContent(language) }
+  ];
+  const files = [];
+  for (const page of pages) {
+    for (const language of SCAFFOLD_LANGUAGES) {
+      const suffix = language === defaultLang ? "" : `.${language}`;
+      files.push({
+        path: `content/${page.basePath}${suffix}.md`,
+        content: page.build(language)
+      });
+    }
+  }
+  return files;
 }
-function collectPluginStyleSpecifiers(config) {
-  return config.plugins.flatMap(
-    (plugin) => (plugin.assets ?? []).filter((asset) => asset.kind === "style").map((asset) => asset.moduleSpecifier)
-  );
+function read(text, language) {
+  return text[language];
 }
-function createStylesheetEntry(moduleSpecifiers, banner) {
-  const imports = uniqueStrings(moduleSpecifiers).map((specifier) => `@import ${JSON.stringify(specifier)};`).join("\n");
-  if (!banner) return imports;
-  const header = `/* ${banner.replace(/\*\//g, "* /")} */`;
-  return imports ? `${header}
-${imports}
-` : `${header}
-`;
+function frontmatter() {
+  return ["---", "publish: true", "---", ""].join("\n");
 }
-function writeGeneratedFile(filePath, contents) {
-  fs3.mkdirSync(path3.dirname(filePath), { recursive: true });
-  fs3.writeFileSync(filePath, contents);
+function heading(level, text) {
+  return `${"#".repeat(level)} ${text}`;
 }
-
-// src/client_module.ts
-var clientModuleId = "virtual:riebeckite/client";
-var resolvedClientModuleId = `\0${clientModuleId}`;
-function riebeckiteClientModule(getConfig) {
-  return {
-    name: "riebeckite-client-module",
-    resolveId(id) {
-      if (id === clientModuleId) return resolvedClientModuleId;
-      return null;
-    },
-    load(id) {
-      if (id !== resolvedClientModuleId) return null;
-      return createClientModule(getConfig());
-    }
-  };
+function codeBlock(language, code) {
+  return ["```" + language, code, "```", ""].join("\n");
 }
-function createClientModule(config) {
-  const imports = [];
-  const initializers = [];
-  for (const [index, entry] of config.plugins.flatMap((plugin) => plugin.clientEntries ?? []).entries()) {
-    const localName = `pluginClientInitializer${index}`;
-    const importTarget = entry.exportName ? `{ ${entry.exportName} as ${localName} }` : localName;
-    imports.push(
-      `import ${importTarget} from ${JSON.stringify(entry.moduleSpecifier)};`
-    );
-    initializers.push(localName);
+var INDEX = {
+  lead: {
+    en: "Welcome to your Riebeckite site.",
+    ja: "あなたの Riebeckite サイトへようこそ。",
+    "zh-CN": "欢迎来到你的 Riebeckite 站点。",
+    es: "Bienvenido a tu sitio Riebeckite.",
+    de: "Willkommen auf deiner Riebeckite-Seite.",
+    fr: "Bienvenue sur votre site Riebeckite.",
+    ko: "Riebeckite 사이트에 오신 것을 환영합니다."
+  },
+  translatedNote: {
+    en: "Every page of this starter is available in seven languages. Switch with the selector below the page title.",
+    ja: "このスターターのすべてのページは 7 言語で利用できます。ページタイトル下のセレクターで切り替えられます。",
+    "zh-CN": "本模板的每个页面均提供七种语言版本，可用页面标题下方的选择器切换。",
+    es: "Cada página de este starter está disponible en siete idiomas. Cámbialos con el selector bajo el título.",
+    de: "Jede Seite dieses Starters ist in sieben Sprachen verfügbar. Wechsel mit dem Auswahlfeld unter dem Seitentitel.",
+    fr: "Chaque page de ce starter est disponible en sept langues. Changez avec le sélecteur sous le titre.",
+    ko: "이 스타터의 모든 페이지는 7개 언어로 제공됩니다. 페이지 제목 아래 선택기로 전환하세요."
+  },
+  whatHeading: {
+    en: "What is Riebeckite?",
+    ja: "Riebeckite とは",
+    "zh-CN": "什么是 Riebeckite？",
+    es: "¿Qué es Riebeckite?",
+    de: "Was ist Riebeckite?",
+    fr: "Qu'est-ce que Riebeckite ?",
+    ko: "Riebeckite란?"
+  },
+  whatBody: {
+    en: "Riebeckite is an extensible, content-first framework that builds fast static sites from plain Markdown — the same notes you keep in Obsidian. The ecosystem includes 50+ plugins and six themes, and this site demos both.",
+    ja: "Riebeckite は、プレーンな Markdown（Obsidian で管理しているのと同じノート）から高速な静的サイトを生成する、拡張性のあるコンテンツファーストのフレームワークです。エコシステムには 50 以上のプラグインと 6 つのテーマがあり、このサイトはその両方をデモしています。",
+    "zh-CN": "Riebeckite 是一个可扩展、内容优先的框架，可从纯 Markdown（即你在 Obsidian 中保存的笔记）构建快速的静态站点。生态包含 50+ 插件与六个主题，本站点同时演示两者。",
+    es: "Riebeckite es un framework extensible y orientado al contenido que construye sitios estáticos rápidos desde Markdown simple — las mismas notas que guardas en Obsidian. El ecosistema incluye más de 50 plugins y seis temas; este sitio demuestra ambos.",
+    de: "Riebeckite ist ein erweiterbares, inhaltsorientiertes Framework, das schnelle statische Seiten aus einfachem Markdown baut — denselben Notizen, die du in Obsidian führst. Das Ökosystem umfasst 50+ Plugins und sechs Themes; diese Seite demonstriert beides.",
+    fr: "Riebeckite est un framework extensible et centré sur le contenu qui construit des sites statiques rapides à partir de Markdown simple — les mêmes notes que vous gardez dans Obsidian. L'écosystème inclut plus de 50 plugins et six thèmes ; ce site en démontre les deux.",
+    ko: "Riebeckite는 일반 Markdown(Obsidian에서 관리하는 노트)에서 빠른 정적 사이트를 만드는 확장 가능한 콘텐츠 우선 프레임워크입니다. 생태계에는 50개 이상의 플러그인과 6개 테마가 있으며, 이 사이트가 그 두 가지를 보여줍니다."
+  },
+  exploreHeading: {
+    en: "Explore",
+    ja: "さらに深く",
+    "zh-CN": "继续探索",
+    es: "Explorar",
+    de: "Weiter erkunden",
+    fr: "Explorer",
+    ko: "더 살펴보기"
+  },
+  explorePlugins: {
+    en: "Plugins — representative packages grouped by capability",
+    ja: "プラグイン — 機能別の代表的なパッケージ",
+    "zh-CN": "插件 — 按能力分组的代表性包",
+    es: "Plugins — paquetes representativos por capacidad",
+    de: "Plugins — repräsentative Pakete nach Fähigkeit",
+    fr: "Plugins — paquets représentatifs par capacité",
+    ko: "플러그인 — 기능별 대표 패키지"
+  },
+  exploreThemes: {
+    en: "Themes — built-in design packages and how to switch",
+    ja: "テーマ — 同梱のデザインパッケージと切り替え方",
+    "zh-CN": "主题 — 内置设计包与切换方法",
+    es: "Temas — paquetes de diseño incluidos y cómo cambiar",
+    de: "Themes — mitgelieferte Design-Pakete und wie man wechselt",
+    fr: "Thèmes — paquets de design inclus et comment changer",
+    ko: "테마 — 내장 디자인 패키지와 전환 방법"
+  },
+  editHeading: {
+    en: "Edit this site",
+    ja: "サイトの編集",
+    "zh-CN": "编辑本站点",
+    es: "Editar este sitio",
+    de: "Diese Seite bearbeiten",
+    fr: "Éditer ce site",
+    ko: "사이트 편집"
+  },
+  editLead: {
+    en: "Content lives in `content/` as plain Markdown. Add a file, give it `publish: true` in the frontmatter, and it appears in the built site.",
+    ja: "コンテンツは `content/` にプレーンな Markdown として置きます。ファイルを追加してフロントマターに `publish: true` を書けば、ビルドされたサイトに反映されます。",
+    "zh-CN": "内容以纯 Markdown 存于 `content/`。新建文件并在 frontmatter 中写入 `publish: true`，它就会出现在构建后的站点中。",
+    es: "El contenido vive en `content/` como Markdown simple. Añade un archivo, pon `publish: true` en el frontmatter y aparecerá en el sitio compilado.",
+    de: "Inhalte liegen als einfaches Markdown in `content/`. Füge eine Datei hinzu, setze `publish: true` ins Frontmatter, und sie erscheint in der gebauten Seite.",
+    fr: "Le contenu vit dans `content/` en Markdown simple. Ajoutez un fichier, donnez-lui `publish: true` dans le frontmatter, et il apparaîtra dans le site construit.",
+    ko: "콘텐츠는 `content/`에 일반 Markdown으로 저장됩니다. 파일을 추가하고 프론트매터에 `publish: true`를 쓰면 빌드된 사이트에 나타납니다."
+  },
+  editL10n: {
+    en: "Localized pages use the `<base>.<lang>.md` convention next to the default file — for example `about.ja.md`. The l10n plugin serves them under `/lang/` paths and links them automatically.",
+    ja: "翻訳ページは既定ファイルの隣に `<base>.<lang>.md` の命名規則で置きます（例：`about.ja.md`）。l10n プラグインが `/lang/` パスの配下で配信し、自動的にリンクします。",
+    "zh-CN": "本地化页面采用默认文件旁的 `<base>.<lang>.md` 命名约定（例如 `about.ja.md`）。l10n 插件会在 `/lang/` 路径下提供服务并自动互链。",
+    es: "Las páginas localizadas usan la convención `<base>.<lang>.md` junto al archivo por defecto (p. ej. `about.ja.md`). El plugin l10n las sirve bajo rutas `/lang/` y las enlaza automáticamente.",
+    de: "Übersetzte Seiten folgen der Konvention `<base>.<lang>.md` neben der Standarddatei (z. B. `about.ja.md`). Das l10n-Plugin liefert sie unter `/lang/`-Pfaden und verlinkt sie automatisch.",
+    fr: "Les pages localisées suivent la convention `<base>.<lang>.md` à côté du fichier par défaut (ex. `about.ja.md`). Le plugin l10n les sert sous des chemins `/lang/` et les relie automatiquement.",
+    ko: "번역 페이지는 기본 파일 옆에 `<base>.<lang>.md` 규칙으로 둡니다(예: `about.ja.md`). l10n 플러그인이 `/lang/` 경로로 서빙하며 자동으로 링크합니다."
   }
-  return `${imports.join("\n")}
-
-export function initRiebeckiteClient() {
-${initializers.map((name) => `  ${name}();`).join("\n")}
-}
-`;
+};
+function indexContent(variables, language) {
+  const title = variables.title;
+  return [
+    frontmatter(),
+    heading(1, title),
+    read(INDEX.lead, language),
+    read(INDEX.translatedNote, language),
+    heading(2, read(INDEX.whatHeading, language)),
+    read(INDEX.whatBody, language),
+    heading(2, read(INDEX.exploreHeading, language)),
+    `- [${read(INDEX.explorePlugins, language)}](/framework/plugins)`,
+    `- [${read(INDEX.exploreThemes, language)}](/framework/themes)`,
+    heading(2, read(INDEX.editHeading, language)),
+    read(INDEX.editLead, language),
+    read(INDEX.editL10n, language),
+    ""
+  ].join("\n");
 }
-
-// src/vite_runner.ts
-import fs4 from "node:fs/promises";
-import path4 from "node:path";
-import { build, createServer as createServer2 } from "vite";
-var viteConfigFileNames = [
-  "vite.config.ts",
-  "vite.config.js",
-  "vite.config.mjs"
-];
-async function resolveHonoxApplicationRoot(configRoot) {
-  const roots = await findViteApplicationRoots(configRoot);
-  if (roots.length === 1) return roots[0];
-  if (roots.length === 0) {
-    throw new HonoxApplicationRootError(
-      `Could not find a Vite application under ${configRoot}.`
-    );
-  }
-  throw new HonoxApplicationRootError(
-    `Found multiple Vite applications under ${configRoot}: ${roots.join(", ")}.`
-  );
-}
-var HonoxApplicationRootError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "HonoxApplicationRootError";
+var THEMES_COPY = {
+  title: {
+    en: "Themes",
+    ja: "テーマ",
+    "zh-CN": "主题",
+    es: "Temas",
+    de: "Themen",
+    fr: "Thèmes",
+    ko: "테마"
+  },
+  intro: {
+    en: "A theme changes the whole look and feel of a site — colors, typography, and layout — without touching your content or routes. Riebeckite ships with six themes; switch by installing a package and changing one line.",
+    ja: "テーマを変えるだけで、色・文字組み・レイアウトといったサイト全体の見た目が変わります。コンテンツやルートには一切触れる必要はありません。Riebeckite には 6 つのテーマが用意されており、パッケージをインストールして 1 行書き換えるだけで切り替えられます。",
+    "zh-CN": "主题能整体改变站点的观感——配色、排版与布局——而无需改动你的内容或路由。Riebeckite 内置六个主题，安装一个包、改一行配置即可切换。",
+    es: "Un tema cambia toda la apariencia del sitio — colores, tipografía y diseño — sin tocar tu contenido ni tus rutas. Riebeckite incluye seis temas: instala un paquete y cambia una línea.",
+    de: "Ein Theme verändert das gesamte Erscheinungsbild einer Seite — Farben, Typografie, Layout — ohne dass du Inhalte oder Routen anfasst. Riebeckite bringt sechs Themes mit; der Wechsel ist eine Paketinstallation plus eine Zeile.",
+    fr: "Un thème change tout l'aspect d'un site — couleurs, typographie, mise en page — sans toucher au contenu ni aux routes. Riebeckite fournit six thèmes ; installez un paquet et changez une ligne.",
+    ko: "테마를 바꾸면 색상·타이포그래피·레이아웃 등 사이트 전체 분위기가 달라집니다. 콘텐츠나 라우트는 건드릴 필요가 없습니다. Riebeckite는 6개 테마를 제공하며 패키지 설치 후 한 줄만 바꾸면 전환됩니다."
+  },
+  switchHeading: {
+    en: "Switching themes",
+    ja: "テーマの切り替え",
+    "zh-CN": "切换主题",
+    es: "Cambiar de tema",
+    de: "Theme wechseln",
+    fr: "Changer de thème",
+    ko: "테마 전환"
+  },
+  switchCurrent: {
+    en: "This starter uses `@riebeckite/theme-default`. To try another theme:",
+    ja: "このスターターは `@riebeckite/theme-default` を使っています。別のテーマを試すには：",
+    "zh-CN": "本模板使用 `@riebeckite/theme-default`。想尝试其他主题：",
+    es: "Este starter usa `@riebeckite/theme-default`. Para probar otro tema:",
+    de: "Dieser Starter verwendet `@riebeckite/theme-default`. Um ein anderes Theme zu testen:",
+    fr: "Ce starter utilise `@riebeckite/theme-default`. Pour essayer un autre thème :",
+    ko: "이 스타터는 `@riebeckite/theme-default`를 사용합니다. 다른 테마를 시도하려면："
+  },
+  switchStep1: {
+    en: "Install the package:",
+    ja: "パッケージをインストール：",
+    "zh-CN": "安装该包：",
+    es: "Instala el paquete:",
+    de: "Installiere das Paket:",
+    fr: "Installez le paquet :",
+    ko: "패키지를 설치합니다："
+  },
+  switchStep2: {
+    en: "Point `theme` at the new factory in `riebeckite.config.ts`:",
+    ja: "`riebeckite.config.ts` の `theme` を新しいファクトリに変更：",
+    "zh-CN": "在 `riebeckite.config.ts` 中将 `theme` 指向新工厂函数：",
+    es: "Apunta `theme` al nuevo factory en `riebeckite.config.ts`:",
+    de: "Setze `theme` in `riebeckite.config.ts` auf den neuen Factory:",
+    fr: "Pointez `theme` vers le nouveau factory dans `riebeckite.config.ts` :",
+    ko: "`riebeckite.config.ts`의 `theme`를 새 팩토리로 변경합니다："
+  },
+  tableHeading: {
+    en: "The bundled themes",
+    ja: "同梱テーマ一覧",
+    "zh-CN": "内置主题一览",
+    es: "Los temas incluidos",
+    de: "Die mitgelieferten Themes",
+    fr: "Les thèmes inclus",
+    ko: "내장 테마 목록"
+  },
+  columnTheme: {
+    en: "Theme",
+    ja: "テーマ",
+    "zh-CN": "主题",
+    es: "Tema",
+    de: "Theme",
+    fr: "Thème",
+    ko: "테마"
+  },
+  columnDescription: {
+    en: "Description",
+    ja: "説明",
+    "zh-CN": "说明",
+    es: "Descripción",
+    de: "Beschreibung",
+    fr: "Description",
+    ko: "설명"
+  },
+  note: {
+    en: "Every theme supports light/dark color modes, typography, and article layouts; see each README for the full option list.",
+    ja: "すべてのテーマでライト/ダーク切り替え、文字組み、記事レイアウトをサポートしています。詳しいオプションは各 README を参照してください。",
+    "zh-CN": "所有主题都支持明暗配色、排版与文章布局，完整选项请见各 README。",
+    es: "Todos los temas admiten modos claro/oscuro, tipografía y diseño de artículo; consulta cada README para la lista completa de opciones.",
+    de: "Jedes Theme unterstützt Hell/Dunkel-Modi, Typografie und Artikel-Layouts; die vollständige Optionsliste steht im jeweiligen README.",
+    fr: "Chaque thème prend en charge les modes clair/sombre, la typographie et les mises en page d'article ; voir chaque README pour la liste complète des options.",
+    ko: "모든 테마가 라이트/다크 모드, 타이포그래피, 아티클 레이아웃을 지원합니다. 전체 옵션은 각 README를 참조하세요."
   }
 };
-async function resolveHonoxApplication(options) {
-  const configRoot = path4.resolve(options.configRoot);
-  const appRoot = options.appRoot ? path4.resolve(options.appRoot) : await resolveHonoxApplicationRoot(configRoot);
-  const workspaceRoot = options.workspaceRoot ?? await findWorkspaceRoot(configRoot);
-  const rawConfig = await loadRiebeckiteConfig({
-    configRoot,
-    configFile: options.configFile,
-    workspaceRoot
-  });
-  const config = resolveHonoxConfig(rawConfig, appRoot);
-  return {
-    config,
-    configRoot,
-    appRoot,
-    contentRoot: config.content.directory
-  };
-}
-async function findWorkspaceRoot(configRoot) {
-  try {
-    const workspaceConfig = path4.join(configRoot, "pnpm-workspace.yaml");
-    return (await fs4.stat(workspaceConfig)).isFile() ? configRoot : void 0;
-  } catch {
-    return void 0;
+var THEMES = [
+  {
+    slug: "default",
+    factory: "defaultTheme()",
+    desc: {
+      en: "The default theme: clean design tokens, light/dark/system color modes, and article layouts.",
+      ja: "デフォルトテーマ：クリーンなデザイントークン、ライト/ダーク/システムのカラーモード、記事レイアウト。",
+      "zh-CN": "默认主题：简洁的设计令牌、浅色/深色/系统配色与文章布局。",
+      es: "El tema por defecto: tokens limpios, modos claro/oscuro/sistema y distintos diseños de artículo.",
+      de: "Das Standard-Theme: klare Design-Tokens, Licht/Dunkel/System-Modi und Artikel-Layouts.",
+      fr: "Le thème par défaut : tokens épurés, modes clair/sombre/système et mises en page d'article.",
+      ko: "기본 테마: 깔끔한 디자인 토큰, 라이트/다크/시스템 컬러 모드, 아티클 레이아웃."
+    }
+  },
+  {
+    slug: "minimal",
+    factory: "minimalTheme()",
+    desc: {
+      en: "A quiet, typography-first theme.",
+      ja: "文字組みを重視した静かなテーマ。",
+      "zh-CN": "以排版为先的简洁主题。",
+      es: "Un tema sobrio, centrado en la tipografía.",
+      de: "Ein ruhiges, typografieorientiertes Theme.",
+      fr: "Un thème sobre, axé sur la typographie.",
+      ko: "타이포그래피 우선의 차분한 테마."
+    }
+  },
+  {
+    slug: "sakura",
+    factory: "sakuraTheme()",
+    desc: {
+      en: "A soft pink palette with warm accents.",
+      ja: "やわらかいピンクと温かみのあるアクセントのテーマ。",
+      "zh-CN": "柔和的粉色配色与温暖点缀。",
+      es: "Una paleta rosa suave con acentos cálidos.",
+      de: "Eine weiche rosa Palette mit warmen Akzenten.",
+      fr: "Une palette rose douce aux accents chaleureux.",
+      ko: "부드러운 핑크 팔레트와 따뜻한 액센트."
+    }
+  },
+  {
+    slug: "gruvbox",
+    factory: "gruvboxTheme()",
+    desc: {
+      en: "A warm, retro palette inspired by Gruvbox.",
+      ja: "Gruvbox 風の温かみのあるレトロパレット。",
+      "zh-CN": "受 Gruvbox 启发的温暖复古配色。",
+      es: "Una paleta retro cálida inspirada en Gruvbox.",
+      de: "Eine warme, von Gruvbox inspirierte Retro-Palette.",
+      fr: "Une palette rétro chaleureuse inspirée de Gruvbox.",
+      ko: "Gruvbox에서 영감을 받은 따뜻한 레트로 팔레트."
+    }
+  },
+  {
+    slug: "tokyonight",
+    factory: "tokyonightTheme()",
+    desc: {
+      en: "A modern night palette with an optional neon accent.",
+      ja: "ネオンオプション付きのモダンなナイトパレット。",
+      "zh-CN": "现代夜间配色，可选霓虹点缀。",
+      es: "Una paleta nocturna moderna con acento neón opcional.",
+      de: "Eine moderne Night-Palette mit optionalem Neon-Akzent.",
+      fr: "Une palette nocturne moderne avec accent néon optionnel.",
+      ko: "네온 액센트를 선택할 수 있는 모던한 나이트 팔레트."
+    }
+  },
+  {
+    slug: "rerurate",
+    factory: "rerurateTheme()",
+    desc: {
+      en: "The author's personal design language.",
+      ja: "作者自身のデザインをテーマにしたテーマ。",
+      "zh-CN": "作者个人的设计风格主题。",
+      es: "El lenguaje de diseño personal del autor.",
+      de: "Die persönliche Designsprache des Autors.",
+      fr: "Le langage de design personnel de l'auteur.",
+      ko: "저자의 개인 디자인 언어 테마."
+    }
   }
-}
-async function startHonoxDevServer(options) {
-  const server2 = await createServer2({ root: options.root });
-  await server2.listen();
-  server2.printUrls();
-  await waitForShutdown(server2);
-}
-async function buildHonoxApplication(options) {
-  await runTraced(
-    options.tracer,
-    "integration.honox.client_build",
-    () => build({ root: options.root, mode: "client" })
+];
+function themesContent(language) {
+  const copy = THEMES_COPY;
+  const lines = [frontmatter()];
+  lines.push(heading(1, read(copy.title, language)), "");
+  lines.push(read(copy.intro, language), "");
+  lines.push(heading(2, read(copy.switchHeading, language)), "");
+  lines.push(read(copy.switchCurrent, language), "");
+  lines.push(read(copy.switchStep1, language), "");
+  lines.push(codeBlock("sh", "pnpm add @riebeckite/theme-sakura"));
+  lines.push(read(copy.switchStep2, language), "");
+  lines.push(
+    codeBlock(
+      "ts",
+      [
+        'import { sakuraTheme } from "@riebeckite/theme-sakura";',
+        "",
+        "export default defineConfig({",
+        "  theme: sakuraTheme(),",
+        "});"
+      ].join("\n")
+    )
   );
-  await runTraced(
-    options.tracer,
-    "integration.honox.server_build",
-    () => build({ root: options.root })
+  lines.push(heading(2, read(copy.tableHeading, language)), "");
+  lines.push(
+    `| ${read(copy.columnTheme, language)} | ${read(copy.columnDescription, language)} |`
   );
-}
-async function runTraced(tracer, name, buildTask) {
-  return tracer ? await tracer.span(name, {}, buildTask) : await buildTask();
-}
-async function waitForShutdown(server2) {
-  await new Promise((resolve) => {
-    const close = () => {
-      void server2.close().finally(resolve);
-    };
-    process.once("SIGINT", close);
-    process.once("SIGTERM", close);
-  });
-}
-async function findViteApplicationRoots(root) {
-  const directories = [root];
-  const applicationRoots = [];
-  while (directories.length > 0) {
-    const directory = directories.pop();
-    if (!directory) continue;
-    if (await hasViteConfig(directory)) applicationRoots.push(directory);
-    const entries = await fs4.readdir(directory, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory() || entry.name === "node_modules" || entry.name === ".git" || entry.name === "tests") {
-        continue;
-      }
-      directories.push(path4.join(directory, entry.name));
-    }
+  lines.push("| --- | --- |");
+  for (const theme of THEMES) {
+    const packageName = `@riebeckite/theme-${theme.slug}`;
+    lines.push(
+      `| [\`${packageName}\`](${themeReadmeUrl(theme.slug)}) · \`${theme.factory}\` | ${read(theme.desc, language)} |`
+    );
   }
-  return applicationRoots;
-}
-async function hasViteConfig(directory) {
-  for (const fileName of viteConfigFileNames) {
-    try {
-      if ((await fs4.stat(path4.join(directory, fileName))).isFile()) return true;
-    } catch {
-    }
+  lines.push("");
+  lines.push(heading(2, read(copy.note, language)), "");
+  lines.push("");
+  lines.push(`[Riebeckite themes on GitHub](${THEMES_INDEX_URL})`, "");
+  lines.push("");
+  return lines.join("\n");
+}
+var PLUGINS_COPY = {
+  title: {
+    en: "Plugins",
+    ja: "プラグイン",
+    "zh-CN": "插件",
+    es: "Plugins",
+    de: "Plugins",
+    fr: "Plugins",
+    ko: "플러그인"
+  },
+  intro: {
+    en: "Riebeckite's power comes from its plugin ecosystem — over fifty packages that extend Markdown, rendering, search, SEO, and more. Below are representative examples grouped by capability; every entry links to its full README.",
+    ja: "Riebeckite の力はプラグインエコシステムにあります——50 以上のパッケージが Markdown・描画・検索・SEO などを拡張します。ここでは代表的なプラグインを機能別に紹介します。各項目のリンクから詳細な README を参照できます。",
+    "zh-CN": "Riebeckite 的强大来自其插件生态——五十多个扩展 Markdown、渲染、搜索、SEO 等的包。下面按能力分组展示代表性示例，每一项都链接到完整 README。",
+    es: "El poder de Riebeckite viene de su ecosistema de plugins — más de cincuenta paquetes que extienden Markdown, renderizado, búsqueda, SEO y más. Aquí tienes ejemplos representativos agrupados por capacidad; cada uno enlaza a su README completo.",
+    de: "Riebeckites Stärke kommt aus seinem Plugin-Ökosystem — über fünfzig Pakete, die Markdown, Rendering, Suche, SEO und mehr erweitern. Hier finden sich repräsentative Beispiele nach Fähigkeit gruppiert; jeder Eintrag verlinkt auf sein volles README.",
+    fr: "La puissance de Riebeckite vient de son écosystème de plugins — plus de cinquante paquets qui étendent Markdown, le rendu, la recherche, le SEO et plus encore. Voici des exemples représentatifs groupés par capacité ; chaque entrée renvoie vers son README complet.",
+    ko: "Riebeckite의 힘은 플러그인 생태계에 있습니다 — Markdown·렌더링·검색·SEO 등을 확장하는 50개 이상의 패키지. 아래는 기능별로 대표적인 예를 소개하며, 각 항목은 전체 README로 연결됩니다."
+  },
+  installHeading: {
+    en: "Adding a plugin",
+    ja: "プラグインの追加",
+    "zh-CN": "添加插件",
+    es: "Añadir un plugin",
+    de: "Ein Plugin hinzufügen",
+    fr: "Ajouter un plugin",
+    ko: "플러그인 추가"
+  },
+  installStep1: {
+    en: "Install the package:",
+    ja: "パッケージをインストール：",
+    "zh-CN": "安装该包：",
+    es: "Instala el paquete:",
+    de: "Installiere das Paket:",
+    fr: "Installez le paquet :",
+    ko: "패키지를 설치합니다："
+  },
+  installStep2: {
+    en: "Register it in the `plugins` array of `riebeckite.config.ts`:",
+    ja: "`riebeckite.config.ts` の `plugins` 配列に登録：",
+    "zh-CN": "在 `riebeckite.config.ts` 的 `plugins` 数组中注册：",
+    es: "Regístralo en el array `plugins` de `riebeckite.config.ts`:",
+    de: "Registriere es im `plugins`-Array der `riebeckite.config.ts`:",
+    fr: "Enregistrez-le dans le tableau `plugins` de `riebeckite.config.ts` :",
+    ko: "`riebeckite.config.ts`의 `plugins` 배열에 등록합니다："
+  },
+  fullList: {
+    en: "The complete plugin index lives in the repository:",
+    ja: "全プラグインの一覧はリポジトリにあります：",
+    "zh-CN": "完整的插件索引位于仓库中：",
+    es: "El índice completo de plugins vive en el repositorio:",
+    de: "Der vollständige Plugin-Index liegt im Repository:",
+    fr: "L'index complet des plugins se trouve dans le dépôt :",
+    ko: "전체 플러그인 목록은 저장소에 있습니다："
+  },
+  fullListLabel: {
+    en: "Riebeckite plugins on GitHub",
+    ja: "GitHub の Riebeckite プラグイン",
+    "zh-CN": "GitHub 上的 Riebeckite 插件",
+    es: "Plugins de Riebeckite en GitHub",
+    de: "Riebeckite-Plugins auf GitHub",
+    fr: "Plugins Riebeckite sur GitHub",
+    ko: "GitHub의 Riebeckite 플러그인"
+  },
+  columnPlugin: {
+    en: "Plugin",
+    ja: "プラグイン",
+    "zh-CN": "插件",
+    es: "Plugin",
+    de: "Plugin",
+    fr: "Plugin",
+    ko: "플러그인"
+  },
+  columnDescription: {
+    en: "What it does",
+    ja: "できること",
+    "zh-CN": "作用",
+    es: "Qué hace",
+    de: "Funktion",
+    fr: "Rôle",
+    ko: "기능"
   }
-  return false;
-}
-
-// src/vite_plugin.ts
-var defaultSsrExternals = [
-  "extend",
-  "debug",
-  "node:fs/promises",
-  "node:path",
-  "parse-numeric-range",
-  "slugify",
-  "vfile-matter"
-];
-function riebeckite(options = {}) {
-  let resolvedConfig;
-  const getConfig = () => {
-    if (!resolvedConfig) {
-      throw new Error("Riebeckite config has not been loaded yet.");
-    }
-    return resolvedConfig;
-  };
-  return [
-    {
-      name: "riebeckite-host-integration",
-      async config(userConfig) {
-        const root = userConfig.root ? path5.resolve(userConfig.root) : process.cwd();
-        const appRoot = options.appRoot ?? root;
-        const application = await resolveHonoxApplication({
-          configRoot: options.configRoot ?? appRoot,
-          configFile: options.configFile,
-          appRoot,
-          workspaceRoot: options.workspaceRoot
-        });
-        resolvedConfig = application.config;
-        writeRiebeckiteAssetEntries(resolvedConfig, {
-          pluginStyles: path5.join(appRoot, "app/.riebeckite/plugin-styles.css"),
-          themeStyles: path5.join(appRoot, "app/.riebeckite/theme-styles.css")
-        });
-        return {
-          define: {
-            "process.env.RIEBECKITE_APP_ROOT": JSON.stringify(appRoot)
-          },
-          resolve: {
-            alias: options.workspaceRoot ? createWorkspacePackageAliases(options.workspaceRoot) : []
-          }
-        };
+};
+var PLUGIN_CATEGORIES = [
+  {
+    title: {
+      en: "Markdown and notes",
+      ja: "マークダウンとノート",
+      "zh-CN": "Markdown 与笔记",
+      es: "Markdown y notas",
+      de: "Markdown und Notizen",
+      fr: "Markdown et notes",
+      ko: "마크다운과 노트"
+    },
+    summary: {
+      en: "Everyday note-taking tuned for Obsidian vaults.",
+      ja: "Obsidian ボールト向けの日常ノート機能。",
+      "zh-CN": "为 Obsidian 库打造的日常笔记功能。",
+      es: "Toma de notas diaria afinada para bóvedas Obsidian.",
+      de: "Alltägliche Notizfunktionen, optimiert für Obsidian-Vaults.",
+      fr: "Prise de notes quotidienne pensée pour les coffres Obsidian.",
+      ko: "Obsidian 볼트에 맞춘 일상 노트 기능."
+    },
+    plugins: [
+      {
+        slug: "obsidian-markdown",
+        desc: {
+          en: "Obsidian-flavored Markdown: wikilinks, embeds, callouts, and tags.",
+          ja: "Obsidian 風マークダウン：ウィキリンク・埋め込み・コールアウト・タグ。",
+          "zh-CN": "Obsidian 风格 Markdown：双链、嵌入、标注与标签。",
+          es: "Markdown estilo Obsidian: wikilinks, embeds, callouts y etiquetas.",
+          de: "Obsidian-Markdown: Wikilinks, Einbettungen, Callouts und Tags.",
+          fr: "Markdown façon Obsidian : wikilinks, embeds, callouts et tags.",
+          ko: "Obsidian 스타일 마크다운: 위키링크, 임베드, 콜아웃, 태그."
+        }
+      },
+      {
+        slug: "attachment",
+        desc: {
+          en: "Renders attached files and embeds assets via wikilinks.",
+          ja: "ウィキリンクによるファイル添付とアセットの埋め込み表示。",
+          "zh-CN": "通过双链渲染附件并嵌入资源。",
+          es: "Renderiza archivos adjuntos e incrusta assets con wikilinks.",
+          de: "Rendert Dateianhänge und bettet Assets per Wikilinks ein.",
+          fr: "Rend les fichiers joints et embarque les ressources via wikilinks.",
+          ko: "위키링크로 첨부 파일을 렌더링하고 자산을 임베드."
+        }
+      },
+      {
+        slug: "media",
+        desc: {
+          en: "Audio and video embeds from plain links.",
+          ja: "プレーンなリンクから音声・動画を埋め込み。",
+          "zh-CN": "从普通链接嵌入音频和视频。",
+          es: "Incrusta audio y vídeo desde enlaces simples.",
+          de: "Audio- und Video-Embeds aus einfachen Links.",
+          fr: "Embeds audio et vidéo depuis de simples liens.",
+          ko: "일반 링크에서 오디오·비디오 임베드."
+        }
       }
+    ]
+  },
+  {
+    title: {
+      en: "Diagrams and presentation",
+      ja: "図とプレゼンテーション",
+      "zh-CN": "图表与演示",
+      es: "Diagramas y presentación",
+      de: "Diagramme und Präsentation",
+      fr: "Diagrammes et présentation",
+      ko: "다이어그램과 프레젠테이션"
     },
-    riebeckiteClientModule(getConfig)
-  ];
-}
-function riebeckiteVite(options = {}) {
-  const { ssg, ssrExternals, ...integration } = options;
-  return [
-    ...riebeckite(integration),
-    riebeckiteSsrExternals([...defaultSsrExternals, ...ssrExternals ?? []]),
-    createRiebeckiteSsg(ssg)
-  ];
-}
-function riebeckiteSsrExternals(externals) {
-  return {
-    name: "riebeckite-ssr-externals",
-    config() {
-      return {
-        environments: {
-          ssr: {
-            resolve: {
-              external: [...externals]
-            }
-          }
+    summary: {
+      en: "Turn fenced code blocks into diagrams, charts, and slide decks.",
+      ja: "フェンスコードブロックを図やチャート、スライドに変換。",
+      "zh-CN": "将围栏代码块变成图表与幻灯片。",
+      es: "Convierte bloques de código en diagramas, gráficas y diapositivas.",
+      de: "Verwandle fenced Code-Blöcke in Diagramme, Charts und Folien.",
+      fr: "Transformez des blocs de code en diagrammes, graphiques et diapositives.",
+      ko: "fenced 코드 블록을 다이어그램·차트·슬라이드로 전환."
+    },
+    plugins: [
+      {
+        slug: "mermaid",
+        desc: {
+          en: "Mermaid diagrams from fenced code blocks.",
+          ja: "フェンスコードブロックから Mermaid 図を描画。",
+          "zh-CN": "从围栏代码块渲染 Mermaid 图表。",
+          es: "Diagramas Mermaid desde bloques de código delimitados.",
+          de: "Mermaid-Diagramme aus fenced Code-Blöcken.",
+          fr: "Diagrammes Mermaid depuis des blocs de code délimités.",
+          ko: "fenced 코드 블록에서 Mermaid 다이어그램 렌더링."
         }
-      };
+      },
+      {
+        slug: "graphviz",
+        desc: {
+          en: "DOT / Graphviz diagrams.",
+          ja: "DOT / Graphviz 図。",
+          "zh-CN": "DOT / Graphviz 图表。",
+          es: "Diagramas DOT / Graphviz.",
+          de: "DOT / Graphviz-Diagramme.",
+          fr: "Diagrammes DOT / Graphviz.",
+          ko: "DOT / Graphviz 다이어그램."
+        }
+      },
+      {
+        slug: "d2",
+        desc: {
+          en: "Diagrams in the D2 language.",
+          ja: "D2 言語によるダイアグラム。",
+          "zh-CN": "使用 D2 语言绘制图表。",
+          es: "Diagramas en lenguaje D2.",
+          de: "Diagramme in der Sprache D2.",
+          fr: "Diagrammes en langage D2.",
+          ko: "D2 언어 다이어그램."
+        }
+      },
+      {
+        slug: "excalidraw",
+        desc: {
+          en: "Renders Excalidraw sketch files.",
+          ja: "Excalidraw スケッチファイルを描画。",
+          "zh-CN": "渲染 Excalidraw 草图文件。",
+          es: "Renderiza bocetos de Excalidraw.",
+          de: "Rendert Excalidraw-Skizzen.",
+          fr: "Rend les croquis Excalidraw.",
+          ko: "Excalidraw 스케치 파일 렌더링."
+        }
+      }
+    ]
+  },
+  {
+    title: {
+      en: "Code and reading experience",
+      ja: "コードと読書体験",
+      "zh-CN": "代码与阅读体验",
+      es: "Código y experiencia de lectura",
+      de: "Code und Leseerlebnis",
+      fr: "Code et expérience de lecture",
+      ko: "코드와 읽기 경험"
+    },
+    summary: {
+      en: "Better code blocks and a comfortable reading experience.",
+      ja: "読みやすいコードブロックと快適な読書体験。",
+      "zh-CN": "更好的代码块与舒适的阅读体验。",
+      es: "Mejores bloques de código y una lectura cómoda.",
+      de: "Bessere Code-Blöcke und ein angenehmes Leseerlebnis.",
+      fr: "De meilleurs blocs de code et une lecture confortable.",
+      ko: "더 나은 코드 블록과 편안한 읽기 경험."
+    },
+    plugins: [
+      {
+        slug: "code-enhance",
+        desc: {
+          en: "Syntax highlighting, line numbers, and code toolbars.",
+          ja: "シンタックスハイライト・行番号・コードツールバー。",
+          "zh-CN": "语法高亮、行号与代码工具栏。",
+          es: "Resaltado de sintaxis, números de línea y barras de código.",
+          de: "Syntax-Highlighting, Zeilennummern und Code-Symbolleisten.",
+          fr: "Coloration syntaxique, numéros de ligne et barres de code.",
+          ko: "구문 강조, 줄 번호, 코드 도구 모음."
+        }
+      },
+      {
+        slug: "code-tabs",
+        desc: {
+          en: "Accessible tabbed code blocks.",
+          ja: "アクセシブルなタブ式コードブロック。",
+          "zh-CN": "无障碍的标签式代码块。",
+          es: "Bloques de código con pestañas accesibles.",
+          de: "Barrierefreie Code-Blöcke mit Tabs.",
+          fr: "Blocs de code à onglets accessibles.",
+          ko: "접근성 있는 탭식 코드 블록."
+        }
+      },
+      {
+        slug: "toc",
+        desc: {
+          en: "A scroll-aware table of contents.",
+          ja: "スクロール追従の目次。",
+          "zh-CN": "随滚动高亮的目录。",
+          es: "Una tabla de contenidos que sigue el scroll.",
+          de: "Ein scrollgesteuertes Inhaltsverzeichnis.",
+          fr: "Une table des matières qui suit le défilement.",
+          ko: "스크롤을 따라가는 목차."
+        }
+      },
+      {
+        slug: "backlinks",
+        desc: {
+          en: "Lists notes that link to the current one.",
+          ja: "現在のノートを参照するノートを一覧表示。",
+          "zh-CN": "列出链接到当前笔记的笔记。",
+          es: "Lista las notas que enlazan con la actual.",
+          de: "Listet Notizen, die auf die aktuelle verlinken.",
+          fr: "Liste les notes qui pointent vers la note courante.",
+          ko: "현재 노트를 링크한 노트 목록."
+        }
+      }
+    ]
+  },
+  {
+    title: {
+      en: "Search and navigation",
+      ja: "検索とナビゲーション",
+      "zh-CN": "搜索与导航",
+      es: "Búsqueda y navegación",
+      de: "Suche und Navigation",
+      fr: "Recherche et navigation",
+      ko: "검색과 탐색"
+    },
+    summary: {
+      en: "Find and move through your notes quickly.",
+      ja: "ノートをすばやく探して移動する。",
+      "zh-CN": "快速查找并在笔记之间穿梭。",
+      es: "Encuentra y recorre tus notas rápidamente.",
+      de: "Notizen schnell finden und durch sie navigieren.",
+      fr: "Retrouvez et parcourez vos notes rapidement.",
+      ko: "노트를 빠르게 찾고 이동하기."
+    },
+    plugins: [
+      {
+        slug: "search",
+        desc: {
+          en: "Client-side full-text search with a Ctrl+K modal.",
+          ja: "Ctrl+K モーダル付きのクライアント側全文検索。",
+          "zh-CN": "带 Ctrl+K 弹窗的客户端全文搜索。",
+          es: "Búsqueda de texto completo en el cliente con modal Ctrl+K.",
+          de: "Clientseitige Volltextsuche mit Ctrl+K-Modal.",
+          fr: "Recherche plein texte côté client avec modal Ctrl+K.",
+          ko: "Ctrl+K 모달이 있는 클라이언트 전체 텍스트 검색."
+        }
+      },
+      {
+        slug: "garden-explorer",
+        desc: {
+          en: "An interactive graph and search explorer.",
+          ja: "ノートのグラフと検索を探索するインタラクティブビュー。",
+          "zh-CN": "交互式图谱与搜索探索器。",
+          es: "Un explorador interactivo de grafo y búsqueda.",
+          de: "Ein interaktiver Graph- und Such-Explorer.",
+          fr: "Un explorateur interactif de graphe et de recherche.",
+          ko: "노트 그래프와 검색을 탐색하는 대화형 뷰."
+        }
+      },
+      {
+        slug: "local-graph",
+        desc: {
+          en: "A link graph around the current note.",
+          ja: "ノート周辺のリンクグラフ。",
+          "zh-CN": "当前笔记周边的链接图谱。",
+          es: "Un grafo de enlaces alrededor de la nota actual.",
+          de: "Ein Link-Graph rund um die aktuelle Notiz.",
+          fr: "Un graphe de liens autour de la note courante.",
+          ko: "현재 노트 주변의 링크 그래프."
+        }
+      },
+      {
+        slug: "permalink",
+        desc: {
+          en: "Stable, configurable permalinks.",
+          ja: "安定したカスタマイズ可能なパーマリンク。",
+          "zh-CN": "稳定、可配置的永久链接。",
+          es: "Permalinks estables y configurables.",
+          de: "Stabile, konfigurierbare Permalinks.",
+          fr: "Permaliens stables et configurables.",
+          ko: "안정적이고 설정 가능한 고유 주소."
+        }
+      }
+    ]
+  },
+  {
+    title: {
+      en: "Publishing and SEO",
+      ja: "公開と SEO",
+      "zh-CN": "发布与 SEO",
+      es: "Publicación y SEO",
+      de: "Veröffentlichung und SEO",
+      fr: "Publication et SEO",
+      ko: "배포와 SEO"
+    },
+    summary: {
+      en: "Ship a site that search engines and readers both understand.",
+      ja: "検索エンジンにも読者にも伝わるサイトを公開する。",
+      "zh-CN": "发布搜索引擎和读者都能理解的站点。",
+      es: "Publica un sitio que buscan buscadores y lectores por igual.",
+      de: "Veröffentliche eine Seite, die Suchmaschinen und Leser gleichermaßen verstehen.",
+      fr: "Publiez un site que moteurs de recherche et lecteurs comprennent.",
+      ko: "검색 엔진과 독자 모두가 이해하는 사이트를 배포."
+    },
+    plugins: [
+      {
+        slug: "seo",
+        desc: {
+          en: "SEO metadata, sitemaps, RSS/Atom/JSON feeds, and robots.txt.",
+          ja: "SEO メタデータ・サイトマップ・RSS/Atom/JSON フィード・robots.txt。",
+          "zh-CN": "SEO 元数据、站点地图、RSS/Atom/JSON 订阅与 robots.txt。",
+          es: "Metadatos SEO, sitemaps, feeds RSS/Atom/JSON y robots.txt.",
+          de: "SEO-Metadaten, Sitemaps, RSS/Atom/JSON-Feeds und robots.txt.",
+          fr: "Métadonnées SEO, sitemaps, flux RSS/Atom/JSON et robots.txt.",
+          ko: "SEO 메타데이터·사이트맵·RSS/Atom/JSON 피드·robots.txt."
+        }
+      },
+      {
+        slug: "l10n",
+        desc: {
+          en: "Localized URLs, a language switcher, and hreflang metadata — this site runs on it.",
+          ja: "ローカライズ済み URL・言語スイッチャー・hreflang メタデータ——このサイトもこれで動いています。",
+          "zh-CN": "本地化 URL、语言切换器与 hreflang 元数据——本站就运行在它之上。",
+          es: "URLs localizadas, selector de idioma y metadatos hreflang — este sitio se ejecuta sobre él.",
+          de: "Lokalisierte URLs, Sprachumschalter und hreflang-Metadaten — diese Seite läuft darauf.",
+          fr: "URLs localisées, sélecteur de langue et métadonnées hreflang — ce site repose dessus.",
+          ko: "로컬라이즈된 URL·언어 전환 UI·hreflang 메타데이터 — 이 사이트가 동작하는 기반입니다."
+        }
+      },
+      {
+        slug: "rich-embed",
+        desc: {
+          en: "Build-time rich media cards for external links.",
+          ja: "外部リンクのビルド時リッチメディアカード。",
+          "zh-CN": "外部链接的构建时富媒体卡片。",
+          es: "Tarjetas multimedia en build para enlaces externos.",
+          de: "Rich-Media-Karten für externe Links zur Build-Zeit.",
+          fr: "Cartes média construites à la compilation pour les liens externes.",
+          ko: "외부 링크의 빌드 시점 리치 미디어 카드."
+        }
+      },
+      {
+        slug: "deploy",
+        desc: {
+          en: "Static deployment output for hosting services.",
+          ja: "ホスティングサービス向けの静的デプロイ出力。",
+          "zh-CN": "面向托管服务的静态部署产物。",
+          es: "Salida de despliegue estático para servicios de hosting.",
+          de: "Statische Deployment-Ausgabe für Hosting-Dienste.",
+          fr: "Sortie de déploiement statique pour les services d'hébergement.",
+          ko: "호스팅 서비스용 정적 배포 산출물."
+        }
+      }
+    ]
+  },
+  {
+    title: {
+      en: "Content and developer experience",
+      ja: "コンテンツと開発体験",
+      "zh-CN": "内容与开发者体验",
+      es: "Contenido y experiencia de desarrollo",
+      de: "Content und Developer Experience",
+      fr: "Contenu et expérience développeur",
+      ko: "콘텐츠와 개발자 경험"
+    },
+    summary: {
+      en: "Query, organize, and keep your content healthy.",
+      ja: "コンテンツを検索・整理し、健全に保つ。",
+      "zh-CN": "查询、整理并保持内容健康。",
+      es: "Consulta, organiza y mantén sano tu contenido.",
+      de: "Content abfragen, organisieren und gesund halten.",
+      fr: "Requêter, organiser et garder votre contenu sain.",
+      ko: "콘텐츠를 조회·정리하고 건강하게 유지."
+    },
+    plugins: [
+      {
+        slug: "dataview",
+        desc: {
+          en: "Build-time queries over your notes.",
+          ja: "ノートに対するビルド時クエリ。",
+          "zh-CN": "对笔记的构建时查询。",
+          es: "Consultas en build sobre tus notas.",
+          de: "Build-Zeit-Abfragen über deine Notizen.",
+          fr: "Requêtes temps de build sur vos notes.",
+          ko: "노트에 대한 빌드 시점 조회."
+        }
+      },
+      {
+        slug: "kanban",
+        desc: {
+          en: "Obsidian-style Kanban boards from Markdown lists.",
+          ja: "Markdown リストから Obsidian スタイルのカンバンボードを作成。",
+          "zh-CN": "从 Markdown 列表创建 Obsidian 风格看板。",
+          es: "Tableros Kanban estilo Obsidian desde listas Markdown.",
+          de: "Obsidian-ähnliche Kanban-Boards aus Markdown-Listen.",
+          fr: "Tableaux Kanban façon Obsidian depuis des listes Markdown.",
+          ko: "Markdown 목록에서 Obsidian 스타일 칸반 보드 생성."
+        }
+      },
+      {
+        slug: "responsive-image",
+        desc: {
+          en: "Responsive images with lazy loading.",
+          ja: "レスポンシブ画像と遅延読み込み。",
+          "zh-CN": "响应式图片与懒加载。",
+          es: "Imágenes responsive con carga diferida.",
+          de: "Responsive Bilder mit Lazy Loading.",
+          fr: "Images responsives avec chargement différé.",
+          ko: "지연 로딩 지원 반응형 이미지."
+        }
+      },
+      {
+        slug: "quality",
+        desc: {
+          en: "Static quality and accessibility checks.",
+          ja: "静的品質・アクセシビリティ検査。",
+          "zh-CN": "静态质量与可访问性检查。",
+          es: "Inspección estática de calidad y accesibilidad.",
+          de: "Statische Qualitäts- und Barrierefreiheitsprüfung.",
+          fr: "Contrôle statique de qualité et d'accessibilité.",
+          ko: "정적 품질·접근성 검사."
+        }
+      }
+    ]
+  }
+];
+function pluginsContent(language) {
+  const copy = PLUGINS_COPY;
+  const categories = PLUGIN_CATEGORIES;
+  const lines = [frontmatter()];
+  lines.push(heading(1, read(copy.title, language)), "");
+  lines.push(read(copy.intro, language), "");
+  lines.push(heading(2, read(copy.installHeading, language)), "");
+  lines.push(read(copy.installStep1, language), "");
+  lines.push(codeBlock("sh", "pnpm add @riebeckite/plugin-mermaid"));
+  lines.push(read(copy.installStep2, language), "");
+  lines.push(
+    codeBlock(
+      "ts",
+      [
+        'import { defineConfig } from "@riebeckite/core";',
+        'import { l10n } from "@riebeckite/plugin-l10n";',
+        'import { mermaid } from "@riebeckite/plugin-mermaid";',
+        'import { obsidianMarkdown } from "@riebeckite/plugin-obsidian-markdown";',
+        "",
+        "export default defineConfig({",
+        "  // ...",
+        "  plugins: [obsidianMarkdown(), l10n({ ... }), mermaid()],",
+        "});"
+      ].join("\n")
+    )
+  );
+  lines.push(read(copy.fullList, language), "");
+  lines.push(`[${read(copy.fullListLabel, language)}](${PLUGIN_INDEX_URL})`, "");
+  for (const category of categories) {
+    lines.push(heading(2, read(category.title, language)), "");
+    lines.push(read(category.summary, language), "");
+    lines.push(`| ${read(copy.columnPlugin, language)} | ${read(copy.columnDescription, language)} |`);
+    lines.push("| --- | --- |");
+    for (const plugin of category.plugins) {
+      const packageName = `@riebeckite/plugin-${plugin.slug}`;
+      lines.push(
+        `| [\`${packageName}\`](${pluginReadmeUrl(plugin.slug)}) | ${read(plugin.desc, language)} |`
+      );
     }
-  };
+    lines.push("");
+  }
+  lines.push("");
+  lines.push(
+    `Riebeckite: [documentation](${HELPERS.en}) · [日本語ドキュメント](${HELPERS.ja})`,
+    ""
+  );
+  lines.push("");
+  return lines.join("\n");
 }
 
-// src/scaffold/index.ts
-import fs5 from "node:fs/promises";
-import path6 from "node:path";
-
 // src/scaffold/templates.ts
 function siteTemplateFiles(variables) {
   return [
@@ -581,7 +1191,7 @@ function siteTemplateFiles(variables) {
     { path: "tsconfig.json", content: tsconfig() },
     { path: ".gitignore", content: gitignore() },
     { path: "README.md", content: readme(variables) },
-    { path: "content/index.md", content: indexContent(variables) },
+    ...localizedContentFiles(variables),
     { path: "app/server.ts", content: server() },
     { path: "app/client.ts", content: client() },
     { path: "app/config.ts", content: appConfig() },
@@ -611,16 +1221,18 @@ function packageJson(variables) {
         inspect: "riebeckite inspect"
       },
       dependencies: {
-        "@riebeckite/core": "^0.0.1",
-        "@riebeckite/honox": "^0.0.1",
-        "@riebeckite/plugin-obsidian-markdown": "^0.0.1",
-        "@riebeckite/theme-default": "^0.0.1",
+        "@riebeckite/core": "^0.0.3",
+        "@riebeckite/honox": "^0.0.3",
+        "@riebeckite/plugin-color-mode": "^0.0.3",
+        "@riebeckite/plugin-l10n": "^0.0.3",
+        "@riebeckite/plugin-obsidian-markdown": "^0.0.3",
+        "@riebeckite/theme-default": "^0.0.3",
         hono: "^4.12.25",
         honox: "0.1.56"
       },
       devDependencies: {
         "@hono/vite-build": "^1.11.1",
-        "@riebeckite/cli": "^0.0.1",
+        "@riebeckite/cli": "^0.0.3",
         "@types/node": "^24.5.2",
         typescript: "^5.0.0",
         vite: "^8.0.9"
@@ -632,22 +1244,33 @@ function packageJson(variables) {
 `;
 }
 function riebeckiteConfig(variables) {
+  const { title, description, baseUrl, locale } = variables;
+  const languages = ["en", "ja", "zh-CN", "es", "de", "fr", "ko"];
   return `import { defineConfig } from "@riebeckite/core";
+import { colorModePlugin } from "@riebeckite/plugin-color-mode";
+import { l10n } from "@riebeckite/plugin-l10n";
 import { obsidianMarkdown } from "@riebeckite/plugin-obsidian-markdown";
 import { defaultTheme } from "@riebeckite/theme-default";
 
 export default defineConfig({
   site: {
-    title: ${JSON.stringify(variables.title)},
-    description: ${JSON.stringify(variables.description)},
-    baseUrl: ${JSON.stringify(variables.baseUrl)},
-    locale: ${JSON.stringify(variables.locale)},
+    title: ${JSON.stringify(title)},
+    description: ${JSON.stringify(description)},
+    baseUrl: ${JSON.stringify(baseUrl)},
+    locale: ${JSON.stringify(locale)},
   },
   content: {
     directory: "content",
   },
   theme: defaultTheme(),
-  plugins: [obsidianMarkdown()],
+plugins: [
+    obsidianMarkdown(),
+    colorModePlugin(),
+    l10n({
+      defaultLang: ${JSON.stringify(defaultLanguageForLocale(locale))},
+      languages: ${JSON.stringify(languages)},
+    }),
+  ],
 });
 `;
 }
@@ -729,12 +1352,83 @@ function gitignore() {
   return ["node_modules/", "dist/", ".riebeckite/", ""].join("\n");
 }
 function readme(variables) {
+  return defaultLanguageForLocale(variables.locale) === "ja" ? jaReadme(variables) : enReadme(variables);
+}
+var REPO = "https://github.com/Rerurate514/riebeckite";
+function enReadme(variables) {
   return [
     `# ${variables.title}`,
     "",
-    "A minimal Riebeckite site generated by `riebeckite init`.",
+    "A multilingual Riebeckite site generated by `riebeckite init` — seven",
+    "languages out of the box, plus a tour of the plugin and theme ecosystem.",
+    "",
+    "## What's inside",
+    "",
+    "- **Seven languages** (`en`, `ja`, `zh-CN`, `es`, `de`, `fr`, `ko`) via",
+    `  [\`@riebeckite/plugin-l10n\`](${REPO}/blob/main/packages/plugins/l10n/README.md).`,
+    "  Every page is translated; non-default languages are served under `/lang/`",
+    "  paths, and each page carries a language switcher.",
+    "- **Ecosystem tour pages**, written in all seven languages:",
+    "  - `/framework/plugins` — representative plugins grouped by capability.",
+    "  - `/framework/themes` — the bundled themes and how to switch.",
+    "- The **HonoX application shell** under `app/` — routes, components, and the",
+    "  renderer are yours to extend.",
+    "",
+    "Run `pnpm dev` and open the site to explore.",
+    "",
+    "## Commands",
+    "",
+    "```sh",
+    "pnpm install",
+    "pnpm exec riebeckite check",
+    "pnpm exec riebeckite dev",
+    "pnpm exec riebeckite build",
+    "```",
+    "",
+    "## Localization",
+    "",
+    "Content lives in `content/` as plain Markdown. Translations sit next to the",
+    "default file using the `<base>.<lang>.md` convention (`about.ja.md`,",
+    "`about.en.md`). The default language keeps the unsuffixed path; the rest are",
+    "served under `/lang/`.",
+    "",
+    "To add or remove a language, edit the `l10n(...)` plugin in",
+    "`riebeckite.config.ts` and add or remove the matching translation files.",
+    "",
+    "## Extending",
+    "",
+    `- **Plugins**: browse [packages/plugins](${REPO}/tree/main/packages/plugins)`,
+    "  in the Riebeckite repository — each package has its own README with options",
+    "  and examples.",
+    "- **Themes**: this starter uses `@riebeckite/theme-default`; swap it for",
+    "  another theme in `riebeckite.config.ts`.",
+    `- Docs: [English](${REPO}/blob/main/docs/en/README.md)`,
+    `  · [日本語](${REPO}/blob/main/docs/ja/README.md)`,
+    ""
+  ].join("\n");
+}
+function jaReadme(variables) {
+  return [
+    `# ${variables.title}`,
+    "",
+    "`riebeckite init` で生成した多言語対応の Riebeckite サイトです。7 言語に対応し、",
+    "プラグインとテーマのエコシステムを体感できる構成になっています。",
+    "",
+    "## 含まれているもの",
+    "",
+    "- **7 言語対応**（`en`, `ja`, `zh-CN`, `es`, `de`, `fr`, `ko`）—",
+    `  [\`@riebeckite/plugin-l10n\`](${REPO}/blob/main/packages/plugins/l10n/README_ja.md)`,
+    "  によるもの。すべてのページが翻訳され、既定言語以外は `/lang/` パスで配信され",
+    "  ます。各ページには言語スイッチャーが付いています。",
+    "- **エコシステム紹介ページ**（全 7 言語で作成）:",
+    "  - `/framework/plugins` — 代表的なプラグインを機能別に紹介。",
+    "  - `/framework/themes` — 同梱のテーマと切り替え方。",
+    "- **HonoX アプリケーションシェル** `app/` — ルート・コンポーネント・レンダラー",
+    "  は自由に拡張できます。",
+    "",
+    "`pnpm dev` を実行してサイトを開いてください。",
     "",
-    "## Commands",
+    "## コマンド",
     "",
     "```sh",
     "pnpm install",
@@ -743,24 +1437,24 @@ function readme(variables) {
     "pnpm exec riebeckite build",
     "```",
     "",
-    "Content lives in `content/`. The site owns `app/routes`, `app/components`,",
-    "`app/islands`, and `app/style.css`; see the Riebeckite HonoX integration",
-    "documentation for the site application contract.",
-    ""
-  ].join("\n");
-}
-function indexContent(variables) {
-  return [
-    "---",
-    "publish: true",
-    "---",
+    "## ローカライズ",
     "",
-    `# ${variables.title}`,
+    "コンテンツは `content/` にプレーンな Markdown として置きます。翻訳ページは既定",
+    "ファイルの隣に `<base>.<lang>.md` の規則で配置します（`about.ja.md`、",
+    "`about.en.md` など）。既定言語は接尾辞なしのパス、それ以外は `/lang/` のパスで",
+    "配信されます。",
     "",
-    "Welcome to your Riebeckite site.",
+    "言語の追加・削除は `riebeckite.config.ts` の `l10n(...)` プラグインを編集し、",
+    "対応する翻訳ファイルを追加・削除してください。",
     "",
-    "Edit `content/index.md` to change this page, and add more Markdown files",
-    "next to it. Files need `publish: true` frontmatter before they appear.",
+    "## 拡張",
+    "",
+    `- **プラグイン**: [packages/plugins](${REPO}/tree/main/packages/plugins) を`,
+    "  参照してください。各パッケージにはオプションと例付きの README があります。",
+    "- **テーマ**: このスターターは `@riebeckite/theme-default` を使用しています。",
+    "  `riebeckite.config.ts` で別のテーマに差し替えられます。",
+    `- ドキュメント: [English](${REPO}/blob/main/docs/en/README.md)`,
+    `  · [日本語](${REPO}/blob/main/docs/ja/README.md)`,
     ""
   ].join("\n");
 }
@@ -845,9 +1539,21 @@ export const ASSETS_ROOT = "public/";
 `;
 }
 function globalDeclarations() {
-  return `declare module "virtual:riebeckite/client" {
+  return `import type { PluginHeadTag } from "@riebeckite/core";
+
+declare module "virtual:riebeckite/client" {
   export function initRiebeckiteClient(): void;
 }
+
+declare module "hono" {
+  interface Env {
+    Variables: {
+      headTags?: readonly PluginHeadTag[];
+      htmlLanguage?: string;
+    };
+    Bindings: Record<string, never>;
+  }
+}
 `;
 }
 function style() {
@@ -861,6 +1567,8 @@ body {
 
 .site-header {
   display: flex;
+  align-items: center;
+  justify-content: space-between;
   gap: 1rem;
   padding: 1rem;
   border-bottom: 1px solid #d1d5db;
@@ -881,7 +1589,8 @@ body {
 `;
 }
 function siteHeader() {
-  return `import { config } from "../config";
+  return `import { ColorModeToggle } from "@riebeckite/plugin-color-mode";
+import { config } from "../config";
 
 export function SiteHeader() {
   return (
@@ -889,6 +1598,7 @@ export function SiteHeader() {
       <a href="/" class="site-header__home">
         {config.site.title}
       </a>
+      <ColorModeToggle />
     </header>
   );
 }
@@ -898,11 +1608,23 @@ function article() {
   return `import type { PostContent } from "@riebeckite/core";
 import { Article, ArticleContent, ArticleLayout } from "@riebeckite/honox/ui";
 
-export function SiteArticle({ post }: { post: PostContent }) {
+export function SiteArticle({
+  post,
+  afterMeta,
+}: {
+  post: PostContent;
+  afterMeta?: string;
+}) {
   return (
     <Article class="site-article">
       <ArticleLayout>
         <ArticleContent>
+          {afterMeta ? (
+            <div
+              class="site-article__after-meta"
+              dangerouslySetInnerHTML={{ __html: afterMeta }}
+            />
+          ) : null}
           <div dangerouslySetInnerHTML={{ __html: post.html ?? "" }} />
         </ArticleContent>
       </ArticleLayout>
@@ -912,8 +1634,10 @@ export function SiteArticle({ post }: { post: PostContent }) {
 `;
 }
 function renderer() {
-  return `import { jsxRenderer } from "hono/jsx-renderer";
+  return `import type { PluginHeadTag } from "@riebeckite/core";
+import { jsxRenderer } from "hono/jsx-renderer";
 import { Link, Script } from "honox/server";
+import { ColorModeScript } from "@riebeckite/plugin-color-mode";
 import { SiteHeader } from "../components/site-header";
 import { config } from "../config";
 
@@ -929,14 +1653,21 @@ function themeAttributes() {
   };
 }
 
-export default jsxRenderer(({ children }) => {
+export default jsxRenderer(({ children }, c) => {
+  const headTags: readonly PluginHeadTag[] = c.get("headTags") ?? [];
+
   return (
-    <html lang={config.site.locale} {...themeAttributes()}>
+    <html
+      lang={c.get("htmlLanguage") ?? config.site.locale}
+      {...themeAttributes()}
+    >
       <head>
         <meta charset="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
         <title>{config.site.title}</title>
+        <ColorModeScript />
         <Link href="/app/style.css" rel="stylesheet" />
+        {headTags.map(renderHeadTag)}
         <Script src="/app/client.ts" async />
       </head>
       <body class="riebeckite-page">
@@ -946,6 +1677,21 @@ export default jsxRenderer(({ children }) => {
     </html>
   );
 });
+
+function renderHeadTag(tag: PluginHeadTag, index: number) {
+  const key = \`\${tag.tag}-\${index}\`;
+  if (tag.tag === "meta") return <meta {...tag.attrs} key={key} />;
+  if (tag.tag === "link") return <link {...tag.attrs} key={key} />;
+  return (
+    <script
+      {...tag.attrs}
+      key={key}
+      dangerouslySetInnerHTML={
+        tag.children ? { __html: tag.children } : undefined
+      }
+    />
+  );
+}
 `;
 }
 function indexRoute() {
@@ -967,7 +1713,17 @@ export default createRoute(async (c) => {
     return c.notFound();
   }
 
-  return c.render(<SiteArticle post={post} />);
+  if (indexEntry) {
+    c.set("htmlLanguage", indexEntry.publicLocation.metadata?.["l10n.lang"]);
+    c.set("headTags", indexEntry.headTags ?? []);
+  }
+
+  return c.render(
+    <SiteArticle
+      post={post}
+      afterMeta={indexEntry?.bodySlots?.["article.after-meta"]}
+    />,
+  );
 });
 `;
 }
@@ -1001,76 +1757,505 @@ export default createRoute(
     if (route.kind === "redirect")
       return c.redirect(route.location, route.status);
 
-    const post = await content.getProcessedContent(route.entry.slug);
-    if (!isPublished(config, post.frontmatter)) {
-      return c.notFound();
+    const post = await content.getProcessedContent(route.entry.slug);
+    if (!isPublished(config, post.frontmatter)) {
+      return c.notFound();
+    }
+
+    c.set("htmlLanguage", route.entry.publicLocation.metadata?.["l10n.lang"]);
+    c.set("headTags", route.entry.headTags ?? []);
+
+    return c.render(
+      <SiteArticle
+        post={post}
+        afterMeta={route.entry.bodySlots?.["article.after-meta"]}
+      />,
+    );
+  },
+);
+`;
+}
+
+// src/scaffold/index.ts
+var ScaffoldSiteError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ScaffoldSiteError";
+  }
+};
+async function scaffoldRiebeckiteSite(options) {
+  const targetDirectory = path4.resolve(options.targetDirectory);
+  const files = siteTemplateFiles(templateVariables(options, targetDirectory));
+  await assertTargetWritable(
+    targetDirectory,
+    files,
+    options.overwrite ?? false
+  );
+  for (const file of files) {
+    const filePath = path4.join(targetDirectory, file.path);
+    await fs4.mkdir(path4.dirname(filePath), { recursive: true });
+    await fs4.writeFile(filePath, file.content, "utf8");
+  }
+  return { targetDirectory, files: files.map((file) => file.path) };
+}
+function templateVariables(options, targetDirectory) {
+  const name = normalizePackageName(
+    options.name ?? path4.basename(targetDirectory)
+  );
+  return {
+    name,
+    title: options.siteTitle ?? name,
+    description: options.description ?? "",
+    baseUrl: options.baseUrl ?? "",
+    locale: options.locale ?? "en"
+  };
+}
+async function assertTargetWritable(targetDirectory, files, overwrite) {
+  let entries;
+  try {
+    entries = await fs4.readdir(targetDirectory);
+  } catch (error) {
+    if (isNotFoundError(error)) return;
+    throw error;
+  }
+  const conflicts = entries.filter(
+    (entry) => files.some((file) => file.path.split("/")[0] === entry)
+  );
+  if (conflicts.length === 0) return;
+  if (overwrite) return;
+  throw new ScaffoldSiteError(
+    `The target directory is not empty: ${targetDirectory}
+Existing entries: ${conflicts.slice(0, 5).join(", ")}
+Pass --force to overwrite generated files.`
+  );
+}
+function normalizePackageName(value) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[-_.]+/, "").replace(/[-_.]+$/, "");
+  return normalized || "riebeckite-site";
+}
+function isNotFoundError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+
+// src/ssg_plugin.ts
+import { defaultExtensionMap, toSSG } from "hono/ssg";
+import { relative } from "node:path";
+import { createServer } from "vite";
+var defaultEntry = "./src/index.tsx";
+function riebeckiteSsg(options = {}) {
+  const virtualId = "virtual:riebeckite-ssg-void-entry";
+  const resolvedVirtualId = `\0${virtualId}`;
+  const entry = options.entry ?? defaultEntry;
+  let resolvedConfig;
+  return {
+    name: "riebeckite-ssg",
+    apply: "build",
+    enforce: "post",
+    config() {
+      return {
+        build: {
+          rollupOptions: {
+            input: [virtualId]
+          }
+        }
+      };
+    },
+    configResolved(config) {
+      resolvedConfig = config;
+    },
+    resolveId(id) {
+      return id === virtualId ? resolvedVirtualId : void 0;
+    },
+    load(id) {
+      return id === resolvedVirtualId ? 'console.log("suppress empty chunk message")' : void 0;
+    },
+    async generateBundle(_outputOptions, bundle) {
+      const config = resolvedConfig;
+      if (!config) {
+        throw new Error("Riebeckite SSG could not resolve the Vite configuration.");
+      }
+      removeVirtualEntryChunk(bundle, resolvedVirtualId);
+      const server2 = await createServer({
+        root: config.root,
+        define: config.define,
+        resolve: {
+          ...config.resolve,
+          builtins: [...config.resolve.builtins, /^node:/]
+        },
+        plugins: [],
+        build: { ssr: true },
+        mode: config.mode
+      });
+      try {
+        const module = await server2.ssrLoadModule(entry);
+        const app = module.default;
+        if (!app) {
+          throw new Error(`Failed to find a default export from ${entry}.`);
+        }
+        const generatedHtml = [];
+        const result = await toSSG(
+          app,
+          {
+            writeFile: async (filePath, data) => {
+              const fileName = relative(config.build.outDir, filePath).replaceAll(
+                "\\",
+                "/"
+              );
+              if (fileName.endsWith(".html") && typeof data === "string") {
+                generatedHtml.push({ path: fileName, html: data });
+              }
+              this.emitFile({
+                type: "asset",
+                fileName,
+                source: data
+              });
+            },
+            async mkdir() {
+            }
+          },
+          {
+            dir: config.build.outDir,
+            plugins: options.plugins ?? [],
+            extensionMap: options.extensionMap ?? defaultExtensionMap
+          }
+        );
+        if (!result.success) throw result.error;
+        await emitGeneratedOutputs(
+          module,
+          (asset) => this.emitFile(asset)
+        );
+        inspectGeneratedHtmlPages(module, generatedHtml, {
+          warn: (message) => this.warn(message),
+          info: (message) => this.info(message)
+        });
+      } finally {
+        await server2.close();
+      }
+    }
+  };
+}
+async function emitGeneratedOutputs(module, emit) {
+  const content = module.content;
+  if (!content) return;
+  const manifest = await content.getManifest();
+  for (const output of manifest.generatedOutputs ?? []) {
+    emit({
+      type: "asset",
+      fileName: output.path,
+      source: output.content
+    });
+  }
+}
+function inspectGeneratedHtmlPages(module, pages, log) {
+  const plugins = module.config?.plugins ?? [];
+  for (const plugin of plugins) {
+    const inspector = plugin.inspectGeneratedHtml;
+    if (typeof inspector !== "function") continue;
+    for (const page of pages) {
+      for (const diagnostic of inspector(page) ?? []) {
+        const label = `[${plugin.name ?? "plugin"}] ${page.path}: ${diagnostic.message}`;
+        if (diagnostic.severity === "info") log.info(label);
+        else log.warn(label);
+      }
+    }
+  }
+}
+function removeVirtualEntryChunk(bundle, virtualEntryId) {
+  for (const chunk of Object.values(bundle)) {
+    if (chunk.type === "chunk" && chunk.moduleIds?.includes(virtualEntryId)) {
+      delete bundle[chunk.fileName];
+    }
+  }
+}
+
+// src/ssg.ts
+var defaultSsgEntry = "./app/server.ts";
+function riebeckiteSsgExtensionMap() {
+  return {
+    "application/atom+xml": "xml",
+    "application/json": "json",
+    "application/rss+xml": "xml",
+    "application/xml": "xml",
+    "text/html": "html",
+    "text/plain": "txt",
+    "text/xml": "xml"
+  };
+}
+function createRiebeckiteSsg(options = {}) {
+  return riebeckiteSsg({
+    ...options,
+    entry: options.entry ?? defaultSsgEntry,
+    extensionMap: {
+      ...riebeckiteSsgExtensionMap(),
+      ...options.extensionMap
+    }
+  });
+}
+
+// src/vite_plugin.ts
+import path7 from "node:path";
+
+// src/asset_entries.ts
+import fs5 from "node:fs";
+import path5 from "node:path";
+import { uniqueStrings } from "@riebeckite/core";
+function writeRiebeckiteAssetEntries(config, paths2) {
+  writeGeneratedFile(paths2.pluginStyles, createPluginStylesEntry(config));
+  writeGeneratedFile(paths2.themeStyles, createThemeStylesEntry(config));
+}
+function createPluginStylesEntry(config) {
+  return createStylesheetEntry(
+    collectPluginStyleSpecifiers(config),
+    "Plugin default styles, in resolved plugin order. Generated by @riebeckite/honox; do not edit. Import this before the theme stylesheet so a theme can override plugin defaults."
+  );
+}
+function createThemeStylesEntry(config) {
+  return createStylesheetEntry(
+    config.theme.styles.map((style2) => style2.moduleSpecifier),
+    "Theme styles. Generated by @riebeckite/honox; do not edit. Import this after the plugin stylesheet so the theme wins the plugin/theme cascade."
+  );
+}
+function collectPluginStyleSpecifiers(config) {
+  return config.plugins.flatMap(
+    (plugin) => (plugin.assets ?? []).filter((asset) => asset.kind === "style").map((asset) => asset.moduleSpecifier)
+  );
+}
+function createStylesheetEntry(moduleSpecifiers, banner) {
+  const imports = uniqueStrings(moduleSpecifiers).map((specifier) => `@import ${JSON.stringify(specifier)};`).join("\n");
+  if (!banner) return imports;
+  const header = `/* ${banner.replace(/\*\//g, "* /")} */`;
+  return imports ? `${header}
+${imports}
+` : `${header}
+`;
+}
+function writeGeneratedFile(filePath, contents) {
+  fs5.mkdirSync(path5.dirname(filePath), { recursive: true });
+  fs5.writeFileSync(filePath, contents);
+}
+
+// src/client_module.ts
+import {
+  serializePublicClientConfig
+} from "@riebeckite/core";
+var clientModuleId = "virtual:riebeckite/client";
+var resolvedClientModuleId = `\0${clientModuleId}`;
+function riebeckiteClientModule(getConfig) {
+  return {
+    name: "riebeckite-client-module",
+    resolveId(id) {
+      if (id === clientModuleId) return resolvedClientModuleId;
+      return null;
+    },
+    load(id) {
+      if (id !== resolvedClientModuleId) return null;
+      return createClientModule(getConfig());
     }
+  };
+}
+function createClientModule(config) {
+  const imports = [];
+  const initializers = [];
+  for (const [index, entry] of config.plugins.flatMap((plugin) => plugin.clientEntries ?? []).entries()) {
+    const localName = `pluginClientInitializer${index}`;
+    const importTarget = entry.exportName ? `{ ${entry.exportName} as ${localName} }` : localName;
+    imports.push(
+      `import ${importTarget} from ${JSON.stringify(entry.moduleSpecifier)};`
+    );
+    const publicConfig = entry.publicConfig;
+    initializers.push(
+      publicConfig === void 0 ? `${localName}()` : `${localName}(${serializePublicClientConfig(publicConfig)})`
+    );
+  }
+  return `${imports.join("\n")}
 
-    return c.render(<SiteArticle post={post} />);
-  },
-);
+export function initRiebeckiteClient() {
+${initializers.map((initializer) => `  ${initializer};`).join("\n")}
+}
 `;
 }
 
-// src/scaffold/index.ts
-var ScaffoldSiteError = class extends Error {
+// src/vite_runner.ts
+import fs6 from "node:fs/promises";
+import path6 from "node:path";
+import { build, createServer as createServer2 } from "vite";
+var viteConfigFileNames = [
+  "vite.config.ts",
+  "vite.config.js",
+  "vite.config.mjs"
+];
+async function resolveHonoxApplicationRoot(configRoot) {
+  const roots = await findViteApplicationRoots(configRoot);
+  if (roots.length === 1) return roots[0];
+  if (roots.length === 0) {
+    throw new HonoxApplicationRootError(
+      `Could not find a Vite application under ${configRoot}.`
+    );
+  }
+  throw new HonoxApplicationRootError(
+    `Found multiple Vite applications under ${configRoot}: ${roots.join(", ")}.`
+  );
+}
+var HonoxApplicationRootError = class extends Error {
   constructor(message) {
     super(message);
-    this.name = "ScaffoldSiteError";
+    this.name = "HonoxApplicationRootError";
   }
 };
-async function scaffoldRiebeckiteSite(options) {
-  const targetDirectory = path6.resolve(options.targetDirectory);
-  const files = siteTemplateFiles(templateVariables(options, targetDirectory));
-  await assertTargetWritable(
-    targetDirectory,
-    files,
-    options.overwrite ?? false
-  );
-  for (const file of files) {
-    const filePath = path6.join(targetDirectory, file.path);
-    await fs5.mkdir(path6.dirname(filePath), { recursive: true });
-    await fs5.writeFile(filePath, file.content, "utf8");
-  }
-  return { targetDirectory, files: files.map((file) => file.path) };
-}
-function templateVariables(options, targetDirectory) {
-  const name = normalizePackageName(
-    options.name ?? path6.basename(targetDirectory)
-  );
+async function resolveHonoxApplication(options) {
+  const configRoot = path6.resolve(options.configRoot);
+  const appRoot = options.appRoot ? path6.resolve(options.appRoot) : await resolveHonoxApplicationRoot(configRoot);
+  const workspaceRoot = options.workspaceRoot ?? await findWorkspaceRoot(configRoot);
+  const rawConfig = await loadRiebeckiteConfig({
+    configRoot,
+    configFile: options.configFile,
+    workspaceRoot
+  });
+  const config = resolveHonoxConfig(rawConfig, appRoot);
   return {
-    name,
-    title: options.siteTitle ?? name,
-    description: options.description ?? "",
-    baseUrl: options.baseUrl ?? "",
-    locale: options.locale ?? "en"
+    config,
+    configRoot,
+    appRoot,
+    contentRoot: config.content.directory
   };
 }
-async function assertTargetWritable(targetDirectory, files, overwrite) {
-  let entries;
+async function findWorkspaceRoot(configRoot) {
   try {
-    entries = await fs5.readdir(targetDirectory);
-  } catch (error) {
-    if (isNotFoundError(error)) return;
-    throw error;
+    const workspaceConfig = path6.join(configRoot, "pnpm-workspace.yaml");
+    return (await fs6.stat(workspaceConfig)).isFile() ? configRoot : void 0;
+  } catch {
+    return void 0;
   }
-  const conflicts = entries.filter(
-    (entry) => files.some((file) => file.path.split("/")[0] === entry)
+}
+async function startHonoxDevServer(options) {
+  const server2 = await createServer2({ root: options.root });
+  await server2.listen();
+  server2.printUrls();
+  await waitForShutdown(server2);
+}
+async function buildHonoxApplication(options) {
+  await runTraced(
+    options.tracer,
+    "integration.honox.client_build",
+    () => build({ root: options.root, mode: "client" })
   );
-  if (conflicts.length === 0) return;
-  if (overwrite) return;
-  throw new ScaffoldSiteError(
-    `The target directory is not empty: ${targetDirectory}
-Existing entries: ${conflicts.slice(0, 5).join(", ")}
-Pass --force to overwrite generated files.`
+  await runTraced(
+    options.tracer,
+    "integration.honox.server_build",
+    () => build({ root: options.root })
   );
 }
-function normalizePackageName(value) {
-  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[-_.]+/, "").replace(/[-_.]+$/, "");
-  return normalized || "riebeckite-site";
+async function runTraced(tracer, name, buildTask) {
+  return tracer ? await tracer.span(name, {}, buildTask) : await buildTask();
 }
-function isNotFoundError(error) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+async function waitForShutdown(server2) {
+  await new Promise((resolve) => {
+    const close = () => {
+      void server2.close().finally(resolve);
+    };
+    process.once("SIGINT", close);
+    process.once("SIGTERM", close);
+  });
+}
+async function findViteApplicationRoots(root) {
+  const directories = [root];
+  const applicationRoots = [];
+  while (directories.length > 0) {
+    const directory = directories.pop();
+    if (!directory) continue;
+    if (await hasViteConfig(directory)) applicationRoots.push(directory);
+    const entries = await fs6.readdir(directory, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory() || entry.name === "node_modules" || entry.name === ".git" || entry.name === "tests") {
+        continue;
+      }
+      directories.push(path6.join(directory, entry.name));
+    }
+  }
+  return applicationRoots;
+}
+async function hasViteConfig(directory) {
+  for (const fileName of viteConfigFileNames) {
+    try {
+      if ((await fs6.stat(path6.join(directory, fileName))).isFile()) return true;
+    } catch {
+    }
+  }
+  return false;
+}
+
+// src/vite_plugin.ts
+var defaultSsrExternals = [
+  "extend",
+  "debug",
+  "node:fs/promises",
+  "node:path",
+  "parse-numeric-range",
+  "slugify",
+  "vfile-matter",
+  "yaml"
+];
+function riebeckite(options = {}) {
+  let resolvedConfig;
+  const getConfig = () => {
+    if (!resolvedConfig) {
+      throw new Error("Riebeckite config has not been loaded yet.");
+    }
+    return resolvedConfig;
+  };
+  return [
+    {
+      name: "riebeckite-host-integration",
+      async config(userConfig) {
+        const root = userConfig.root ? path7.resolve(userConfig.root) : process.cwd();
+        const appRoot = options.appRoot ?? root;
+        const application = await resolveHonoxApplication({
+          configRoot: options.configRoot ?? appRoot,
+          configFile: options.configFile,
+          appRoot,
+          workspaceRoot: options.workspaceRoot
+        });
+        resolvedConfig = application.config;
+        writeRiebeckiteAssetEntries(resolvedConfig, {
+          pluginStyles: path7.join(appRoot, "app/.riebeckite/plugin-styles.css"),
+          themeStyles: path7.join(appRoot, "app/.riebeckite/theme-styles.css")
+        });
+        return {
+          define: {
+            "process.env.RIEBECKITE_APP_ROOT": JSON.stringify(appRoot)
+          },
+          resolve: {
+            alias: options.workspaceRoot ? createWorkspacePackageAliases(options.workspaceRoot) : []
+          }
+        };
+      }
+    },
+    riebeckiteClientModule(getConfig)
+  ];
+}
+function riebeckiteVite(options = {}) {
+  const { ssg, ssrExternals, ...integration } = options;
+  return [
+    ...riebeckite(integration),
+    riebeckiteSsrExternals([...defaultSsrExternals, ...ssrExternals ?? []]),
+    createRiebeckiteSsg(ssg)
+  ];
+}
+function riebeckiteSsrExternals(externals) {
+  return {
+    name: "riebeckite-ssr-externals",
+    config() {
+      return {
+        environments: {
+          ssr: {
+            resolve: {
+              external: [...externals]
+            }
+          }
+        }
+      };
+    }
+  };
 }
 export {
   ScaffoldSiteError,
@@ -1079,6 +2264,7 @@ export {
   defaultSsgEntry,
   defaultSsrExternals,
   loadRiebeckiteConfig,
+  replaceHonoxIslandDependencyPlugin,
   resolveHonoxApplication,
   resolveHonoxApplicationRoot,
   resolveHonoxConfig,