@riebeckite/honox 0.0.11 → 0.0.13

package/dist/index.js

@@ -132,10 +132,7 @@ async function loadRiebeckiteConfig(options) {
       banner: {
         js: 'import { createRequire as __riebeckiteCreateRequire } from "node:module"; const require = __riebeckiteCreateRequire(import.meta.url);'
       },
-      plugins: [
-        externalizeBareModuleImports(),
-        ...options.workspaceRoot ? [workspacePackageResolver(options.workspaceRoot)] : []
-      ]
+      plugins: options.workspaceRoot ? [workspacePackageResolver(options.workspaceRoot)] : []
     });
     const module = await import(`${pathToFileUrl(outputFile)}?t=${Date.now()}`);
     return module.default;
@@ -153,17 +150,6 @@ function resolveHonoxConfig(config, appRoot) {
     }
   };
 }
-function externalizeBareModuleImports() {
-  return {
-    name: "externalize-bare-module-imports",
-    setup(buildApi) {
-      buildApi.onResolve({ filter: /^[^./]|^\.[^./]|^\.\.$/ }, (args) => {
-        if (path2.isAbsolute(args.path)) return null;
-        return { path: args.path, external: true };
-      });
-    }
-  };
-}
 function pathToFileUrl(filePath) {
   return `file:///${filePath.replace(/\\/g, "/").replace(/^([A-Za-z]):/, "$1:")}`;
 }
@@ -269,9 +255,148 @@ function isJavaScriptModule(filePath) {
 }
 
 // src/scaffold/index.ts
-import fs6 from "node:fs/promises";
+import fs7 from "node:fs/promises";
 import path7 from "node:path";
 
+// src/scaffold/deployment.ts
+var GITHUB_REPOSITORY_PATTERN = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+function assertGitHubRepository(value, option) {
+  if (!GITHUB_REPOSITORY_PATTERN.test(value)) {
+    throw new Error(
+      `${option} must be a GitHub repository in owner/repository form.`
+    );
+  }
+}
+function deploymentTemplateFiles(options) {
+  const contentRepository = options.contentRepository;
+  if (contentRepository !== void 0) {
+    assertGitHubRepository(contentRepository, "contentRepository");
+  }
+  if (options.siteRepository !== void 0) {
+    assertGitHubRepository(options.siteRepository, "siteRepository");
+  }
+  if (contentRepository !== void 0 && options.siteRepository === void 0) {
+    throw new Error(
+      "siteRepository is required when contentRepository is provided."
+    );
+  }
+  return [
+    { path: "wrangler.jsonc", content: wranglerConfig() },
+    {
+      path: ".github/workflows/deploy.yml",
+      content: deployWorkflow(contentRepository)
+    },
+    ...contentRepository !== void 0 && options.siteRepository !== void 0 ? [
+      {
+        path: "github/notify-site.yml",
+        content: notifySiteWorkflow(options.siteRepository)
+      }
+    ] : []
+  ];
+}
+function wranglerConfig() {
+  return `${JSON.stringify(
+    {
+      name: "riebeckite-site",
+      compatibility_date: "2026-03-10",
+      compatibility_flags: ["nodejs_compat"],
+      assets: { directory: "./dist" }
+    },
+    null,
+    2
+  )}
+`;
+}
+function deployWorkflow(contentRepository) {
+  const contentCheckout = contentRepository === void 0 ? "" : `
+      - name: Check out the external content repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${contentRepository}
+          token: \${{ secrets.RIEBECKITE_CONTENT_READ_TOKEN || github.token }}
+          path: content
+`;
+  return `name: Deploy to Cloudflare Workers
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+  repository_dispatch:
+    types: [content-updated]
+
+concurrency:
+  group: riebeckite-deploy
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Check out the site repository
+        uses: actions/checkout@v4
+${contentCheckout}
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Validate configuration and plugins
+        run: npm exec riebeckite check
+
+      - name: Build the site
+        run: npm exec riebeckite build
+
+      - name: Deploy the built assets
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: deploy
+`;
+}
+function notifySiteWorkflow(siteRepository) {
+  const [owner, repo] = siteRepository.split("/");
+  return `name: Notify Riebeckite site
+
+on:
+  push:
+    branches: [main]
+
+permissions: {}
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate dispatch configuration
+        env:
+          SITE_DISPATCH_TOKEN: \${{ secrets.SITE_DISPATCH_TOKEN }}
+        run: |
+          if [ -z "$SITE_DISPATCH_TOKEN" ]; then
+            echo "::error::SITE_DISPATCH_TOKEN is not configured. Add a token that can dispatch to ${siteRepository}."
+            exit 1
+          fi
+
+      - name: Notify the site repository
+        uses: actions/github-script@v7
+        with:
+          github-token: \${{ secrets.SITE_DISPATCH_TOKEN }}
+          script: |
+            await github.rest.repos.createDispatchEvent({
+              owner: ${JSON.stringify(owner)},
+              repo: ${JSON.stringify(repo)},
+              event_type: "content-updated",
+            });
+`;
+}
+
 // src/scaffold/presets.ts
 var SCAFFOLD_LANGUAGES = [
   "en",
@@ -293,13 +418,10 @@ function defaultLanguageForLocale(locale) {
   return "en";
 }
 var SCAFFOLD_PRESET_NAMES = [
-  "empty",
-  "minimal",
   "starter",
-  "rich",
-  "full",
-  "max",
-  "ultra"
+  "minimal",
+  "showcase",
+  "empty"
 ];
 function isScaffoldPresetName(value) {
   return SCAFFOLD_PRESET_NAMES.includes(value);
@@ -684,38 +806,9 @@ var minimal = {
 };
 var starter = {
   name: "starter",
-  description: "The default starter: Obsidian Markdown, color mode, seven languages, and a site header.",
+  description: "Recommended for most sites: a practical Markdown garden with search, discovery, and reading essentials.",
   languages: [...SCAFFOLD_LANGUAGES],
   theme: defaultTheme,
-  plugins: [obsidianMarkdown, colorMode, l10n],
-  contentPages: ["index"],
-  appFiles: [...BASE_APP_FILES, "index", "slug", "header", "article"],
-  readme: "standard"
-};
-var rich = {
-  name: "rich",
-  description: "A showcasing starter: publishing and reading plugins plus guided ecosystem tour pages in seven languages.",
-  languages: [...SCAFFOLD_LANGUAGES],
-  theme: showCaseTheme,
-  plugins: [
-    obsidianMarkdown,
-    colorMode,
-    l10n,
-    seo,
-    toc,
-    properties,
-    alias,
-    codeEnhance
-  ],
-  contentPages: ["index", "framework/plugins", "framework/themes"],
-  appFiles: [...BASE_APP_FILES, "index", "slug", "header", "article"],
-  readme: "rich"
-};
-var full = {
-  name: "full",
-  description: "A ready blog: discovery, media, and reading plugins plus a build guide.",
-  languages: [...SCAFFOLD_LANGUAGES],
-  theme: showCaseTheme,
   plugins: [
     obsidianMarkdown,
     colorMode,
@@ -728,102 +821,19 @@ var full = {
     search,
     backlinks,
     relatedPosts,
-    share,
-    changelog,
-    webmention,
     recentPosts,
-    attachment,
-    pdf,
-    media,
     responsiveImage,
     lightbox,
-    highlight,
-    codeTabs,
-    codeAnnotations,
-    shortcodes,
     series,
-    taxonomy,
-    autoCardLink,
-    richEmbed,
-    gallery
+    taxonomy
   ],
-  contentPages: ["index", "framework/plugins", "framework/themes", "guide"],
+  contentPages: ["index", "guide", "examples"],
   appFiles: [...BASE_APP_FILES, "index", "slug", "header", "article"],
-  readme: "rich"
-};
-var max = {
-  name: "max",
-  description: "Diagram and knowledge plugins on top of full, with showcase example pages.",
-  languages: [...SCAFFOLD_LANGUAGES],
-  theme: showCaseTheme,
-  plugins: [
-    obsidianMarkdown,
-    colorMode,
-    l10n,
-    seo,
-    toc,
-    properties,
-    alias,
-    codeEnhance,
-    search,
-    backlinks,
-    relatedPosts,
-    share,
-    changelog,
-    webmention,
-    recentPosts,
-    attachment,
-    pdf,
-    media,
-    responsiveImage,
-    lightbox,
-    highlight,
-    codeTabs,
-    codeAnnotations,
-    shortcodes,
-    series,
-    taxonomy,
-    autoCardLink,
-    richEmbed,
-    gallery,
-    mermaid,
-    graphviz,
-    d2,
-    plantuml,
-    chartjs,
-    vegaLite,
-    wavedrom,
-    markmap,
-    map,
-    marp,
-    qrCode,
-    discordEmbed,
-    excalidraw,
-    excaliBrain,
-    canvas,
-    bases,
-    dataview,
-    flashcards,
-    kanban,
-    query,
-    localGraph,
-    hoverPreview,
-    gardenExplorer,
-    ux
-  ],
-  contentPages: [
-    "index",
-    "framework/plugins",
-    "framework/themes",
-    "guide",
-    "examples"
-  ],
-  appFiles: [...BASE_APP_FILES, "index", "slug", "header", "article"],
-  readme: "rich"
+  readme: "standard"
 };
-var ultra = {
-  name: "ultra",
-  description: "The full plugin catalog and theme reference pages — everything the ecosystem offers.",
+var showcase = {
+  name: "showcase",
+  description: "Explore the complete Riebeckite ecosystem with rendered examples, reference pages, and local fixtures.",
   languages: [...SCAFFOLD_LANGUAGES],
   theme: showCaseTheme,
   plugins: [
@@ -899,7 +909,7 @@ var ultra = {
   appFiles: [...BASE_APP_FILES, "index", "slug", "header", "article"],
   readme: "rich"
 };
-var scaffoldPresets = { empty, minimal, starter, rich, full, max, ultra };
+var scaffoldPresets = { starter, minimal, showcase, empty };
 var SCAFFOLD_DEFAULT_PRESET = "starter";
 function resolveScaffoldPreset(value) {
   if (value === void 0) return scaffoldPresets[SCAFFOLD_DEFAULT_PRESET];
@@ -913,6 +923,9 @@ function resolveScaffoldPreset(value) {
   return preset;
 }
 
+// src/scaffold/templates.ts
+import fs6 from "node:fs";
+
 // src/vite_plugin.ts
 import path6 from "node:path";
 
@@ -996,12 +1009,28 @@ function createClientModule(config) {
       `import ${importTarget} from ${JSON.stringify(entry.moduleSpecifier)};`
     );
     const publicConfig = entry.publicConfig;
+    const initializer = publicConfig === void 0 ? `${localName}()` : `${localName}(${serializePublicClientConfig(publicConfig)})`;
     initializers.push(
-      publicConfig === void 0 ? `${localName}()` : `${localName}(${serializePublicClientConfig(publicConfig)})`
+      `runPluginClientInitializer(${JSON.stringify(entry.moduleSpecifier)}, () => ${initializer})`
     );
   }
   return `${imports.join("\n")}
 
+function runPluginClientInitializer(name, initialize) {
+  try {
+    const result = initialize();
+    if (result && typeof result.then === "function") {
+      result.catch((error) => reportPluginClientError(name, error));
+    }
+  } catch (error) {
+    reportPluginClientError(name, error);
+  }
+}
+
+function reportPluginClientError(name, error) {
+  console.error("[riebeckite] Plugin client initializer failed: " + name, error);
+}
+
 export function initRiebeckiteClient() {
 ${initializers.map((initializer) => `  ${initializer};`).join("\n")}
 }
@@ -1479,10 +1508,19 @@ function style(preset) {
       "}",
       "",
       ".site-header__home {",
+      "  display: inline-flex;",
+      "  align-items: center;",
+      "  gap: 0.5rem;",
       "  color: #111827;",
       "  font-weight: 700;",
       "  text-decoration: none;",
       "}",
+      "",
+      ".site-header__logo {",
+      "  width: 1.75rem;",
+      "  height: 1.75rem;",
+      "  object-fit: contain;",
+      "}",
       ""
     );
   }
@@ -1517,6 +1555,13 @@ export function SiteHeader() {
   return (
     <header class="site-header">
       <a href="/" class="site-header__home">
+        <img
+          src="/riebeckite-logo.png"
+          alt=""
+          class="site-header__logo"
+          width="28"
+          height="28"
+        />
         {config.site.title}
       </a>
       <ColorModeToggle />
@@ -1579,6 +1624,10 @@ function themeAttributes() {
   };
 }
 
+// Riebeckite plugin client entries need the HonoX client bundle even without
+// an island component.
+export const __importing_islands = true;
+
 export default jsxRenderer(({ children }, c) => {
   const headTags: readonly PluginHeadTag[] = c.get("headTags") ?? [];
 
@@ -1591,6 +1640,7 @@ export default jsxRenderer(({ children }, c) => {
         <meta charset="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
         <title>{config.site.title}</title>
+        <link rel="icon" href="/favicon.ico" />
 ${hasColorMode ? `        <ColorModeScript />
 ` : ""}        <Link href="/app/style.css" rel="stylesheet" />
         {headTags.map(renderHeadTag)}
@@ -1625,12 +1675,17 @@ function bareRenderer() {
 import { Link, Script } from "honox/server";
 import { config } from "../config";
 
+// Riebeckite plugin client entries need the HonoX client bundle even without
+// an island component.
+export const __importing_islands = true;
+
 export default jsxRenderer(({ children }, c) => (
   <html lang={c.get("htmlLanguage") ?? config.site.locale}>
     <head>
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width, initial-scale=1.0" />
       <title>{config.site.title}</title>
+      <link rel="icon" href="/favicon.ico" />
       <Link href="/app/style.css" rel="stylesheet" />
       <Script src="/app/client.ts" async />
     </head>
@@ -1691,7 +1746,8 @@ function slugRoute() {
   return `import { isPublished } from "@riebeckite/core";
 import {
   contentRouteSsgParams,
-  resolveContentRoute,
+  pluginPageSsgParams,
+  resolveRiebeckiteRoute,
 } from "@riebeckite/honox/server";
 import { createRoute } from "honox/factory";
 import { SiteArticle } from "../components/article";
@@ -1701,21 +1757,27 @@ import { content } from "../content";
 export default createRoute(
   contentRouteSsgParams("/:slug{.+}", async () => {
     const manifest = await content.getManifest();
-    return manifest.entries
+    const contentPaths = manifest.entries
       .filter((entry) => isPublished(config, entry.frontmatter))
       .filter((entry) => entry.permalink !== "/")
       .map((entry) => ({ slug: entry.permalink.replace(/^\\/+/, "") }));
+    return [...contentPaths, ...(await pluginPageSsgParams(content))];
   }),
   async (c) => {
     const requestedSlug = c.req.param("slug");
     if (!requestedSlug) return c.notFound();
     if (/\\.[a-zA-Z0-9]+$/.test(requestedSlug)) return c.notFound();
 
-    const manifest = await content.getManifest();
-    const route = resolveContentRoute(manifest, c.req.path);
+    const route = await resolveRiebeckiteRoute(content, c.req.path);
     if (!route) return c.notFound();
     if (route.kind === "redirect")
       return c.redirect(route.location, route.status);
+    if (route.kind === "page") {
+      c.set("headTags", route.page.headTags ?? []);
+      return c.render(
+        <div dangerouslySetInnerHTML={{ __html: route.page.body }} />,
+      );
+    }
 
     const post = await content.getProcessedContent(route.entry.slug);
     if (!isPublished(config, post.frontmatter)) {
@@ -2004,7 +2066,7 @@ var PLUGIN_MARKDOWN_GUIDES = {
       "---",
       "",
       "```daily-snippet",
-      "Fixed the ultra preset examples.",
+      "Updated the showcase examples.",
       "```"
     ].join("\n")
   },
@@ -2083,7 +2145,10 @@ function localizedContentFiles(variables, preset) {
   };
   for (const page of preset.contentPages) {
     if (page === "index") {
-      pushLocalized("index", (language) => indexContent(variables, language));
+      pushLocalized(
+        "index",
+        (language) => indexContent(variables, preset, language)
+      );
     } else if (page === "framework/plugins") {
       pushLocalized(
         "framework/plugins",
@@ -2110,6 +2175,12 @@ function localizedContentFiles(variables, preset) {
       pushEnglishOnly("reference/themes", () => referenceThemesContent(preset));
     }
   }
+  if (preset.name === "starter" || preset.name === "showcase") {
+    files.push(...knowledgeFixtureFiles(preset));
+  }
+  if (preset.name === "showcase") {
+    files.push(...showcaseAssetFiles());
+  }
   return files;
 }
 function read(text, language) {
@@ -2127,6 +2198,72 @@ ${code}
 \`\`\`
 `;
 }
+function knowledgeFixtureFiles(preset) {
+  const prefix = preset.name === "showcase" ? "demo" : "notes";
+  return [
+    {
+      path: `content/${prefix}/planning.md`,
+      content: [
+        "---",
+        "title: Planning a Markdown site",
+        "description: A related note used by the generated discovery examples.",
+        "date: 2026-09-30",
+        "tags: [riebeckite, project]",
+        "status: active",
+        "aliases: [/start-here/]",
+        "series: publish-a-site",
+        "series_title: Publish a site",
+        "series_order: 1",
+        "publish: true",
+        "---",
+        "",
+        "# Planning a Markdown site",
+        "",
+        "Start with [[writing]] to see backlinks, related posts, tags, and the series navigation working together."
+      ].join("\n")
+    },
+    {
+      path: `content/${prefix}/writing.md`,
+      content: [
+        "---",
+        "title: Writing the first note",
+        "description: A second connected note for search and related-content examples.",
+        "date: 2026-10-01",
+        "tags: [riebeckite, project]",
+        "status: active",
+        "series: publish-a-site",
+        "series_title: Publish a site",
+        "series_order: 2",
+        "publish: true",
+        "---",
+        "",
+        "# Writing the first note",
+        "",
+        "This note links back to [[planning]]. Search for **Markdown site** or browse the generated tags."
+      ].join("\n")
+    }
+  ];
+}
+function showcaseAssetFiles() {
+  return [
+    {
+      path: "content/images/demo.svg",
+      content: '<svg xmlns="http://www.w3.org/2000/svg" width="640" height="360" viewBox="0 0 640 360"><rect width="640" height="360" fill="#315b8c"/><text x="320" y="180" fill="white" font-size="32" text-anchor="middle">Riebeckite showcase</text></svg>\n'
+    },
+    {
+      path: "content/attachments/project-brief.pdf",
+      content: "%PDF-1.1\n1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj\n2 0 obj<</Type/Pages/Count 0/Kids[]>>endobj\ntrailer<</Root 1 0 R>>\n%%EOF\n"
+    },
+    {
+      path: "content/drawings/Architecture.excalidraw",
+      content: '{"type":"excalidraw","version":2,"elements":[],"appState":{"viewBackgroundColor":"#ffffff"},"files":{}}\n'
+    },
+    {
+      path: "content/drawings/site.canvas",
+      content: '{"nodes":[{"id":"note","type":"text","text":"Note","x":0,"y":0,"width":200,"height":60}],"edges":[]}\n'
+    }
+  ];
+}
 var INDEX = {
   lead: {
     en: "Welcome to your Riebeckite site.",
@@ -2219,7 +2356,7 @@ var INDEX = {
     ko: "번역 페이지는 기본 파일 옆에 `<base>.<lang>.md` 규칙으로 둡니다(예: `about.ja.md`). l10n 플러그인이 `/lang/` 경로로 서빙하며 자동으로 링크합니다."
   }
 };
-function indexContent(variables, language) {
+function indexContent(variables, preset, language) {
   const title = variables.title;
   return [
     frontmatter(),
@@ -2228,9 +2365,17 @@ function indexContent(variables, 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)`,
+    ...preset.name === "showcase" ? [
+      heading(2, read(INDEX.exploreHeading, language)),
+      `- [${read(INDEX.explorePlugins, language)}](/framework/plugins)`,
+      `- [${read(INDEX.exploreThemes, language)}](/framework/themes)`,
+      "- [Working examples](/examples/)",
+      "- [Plugin reference](/reference/plugins/)"
+    ] : preset.name === "starter" ? [
+      heading(2, read(INDEX.exploreHeading, language)),
+      "- [Getting started](/guide/)",
+      "- [Example notes](/examples/)"
+    ] : [],
     heading(2, read(INDEX.editHeading, language)),
     read(INDEX.editLead, language),
     read(INDEX.editL10n, language),
@@ -3098,10 +3243,16 @@ var EXAMPLES_COPY = {
     ja: "サンプル集"
   },
   intro: {
-    en: "A working demo of every diagram, chart, and code feature this preset ships. Fenced code blocks are turned into rendered output at build time by the diagram plugins; code blocks gain toolbars from the code plugins. Each section below is also copy-pasteable into any Markdown document.",
-    ja: "このプリセットが含む、すべての図表・チャート・コード機能の実例です。フェンス付きコードブロックはビルド時に図表プラグインが描画し、コードブロックにはコードプラグインがツールバーを追加します。以下の各セクションは、任意の Markdown 文書にそのままコピーして使えます。"
+    en: "Rendered examples for the diagram, chart, and code features in this preset. Fenced code blocks are turned into output at build time by the relevant plugins, while code blocks gain toolbars from the code plugins. Each section below is copy-pasteable into a Markdown document.",
+    ja: "このプリセットに含まれる図表・チャート・コード機能の描画例です。フェンス付きコードブロックは対応するプラグインによりビルド時に出力へ変換され、コードブロックにはツールバーが付きます。以下の各セクションは、Markdown 文書にそのままコピーして使えます。"
   }
 };
+var SHOWCASE_GUIDE_DEMOS = [
+  "@riebeckite/plugin-plantuml",
+  "@riebeckite/plugin-excalidraw",
+  "@riebeckite/plugin-canvas",
+  "@riebeckite/plugin-flashcards"
+];
 function examplesContent(preset, language) {
   const lines = [
     frontmatter(),
@@ -3118,6 +3269,19 @@ function examplesContent(preset, language) {
     lines.push(readSummary(demo.intro, language), "");
     lines.push(demo.markdown, "");
   }
+  if (preset.name === "showcase") {
+    for (const packageName of SHOWCASE_GUIDE_DEMOS) {
+      if (!hasPlugin(preset, packageName)) continue;
+      const guide = PLUGIN_MARKDOWN_GUIDES[packageName];
+      if (!guide) continue;
+      lines.push(
+        heading(2, packageName.replace("@riebeckite/plugin-", "")),
+        ""
+      );
+      lines.push(guide.summary, "");
+      lines.push(guide.markdown, "");
+    }
+  }
   return lines.join("\n");
 }
 function referencePluginsContent(preset, variables) {
@@ -3209,7 +3373,7 @@ function referenceThemesContent(preset) {
 }
 
 // src/scaffold/version.ts
-var RIEBECKITE_VERSION = "^0.0.11";
+var RIEBECKITE_VERSION = "^0.0.13";
 
 // src/scaffold/templates.ts
 function siteTemplateFiles(preset, variables) {
@@ -3223,10 +3387,26 @@ function siteTemplateFiles(preset, variables) {
     { path: "tsconfig.json", content: tsconfig() },
     { path: ".gitignore", content: gitignore() },
     { path: "README.md", content: readme(preset, variables) },
+    { path: "public/favicon.ico", content: readPackageAsset("favicon.ico") },
+    {
+      path: "public/riebeckite-logo.png",
+      content: readPackageAsset("riebeckite-logo.png")
+    },
     ...localizedContentFiles(variables, preset),
     ...appFiles(preset)
   ];
 }
+function readPackageAsset(fileName) {
+  const candidates = [
+    new URL(`../../assets/${fileName}`, import.meta.url),
+    new URL(`../../../assets/${fileName}`, import.meta.url),
+    new URL(`../assets/${fileName}`, import.meta.url)
+  ];
+  for (const candidate of candidates) {
+    if (fs6.existsSync(candidate)) return fs6.readFileSync(candidate);
+  }
+  throw new Error(`Missing Riebeckite scaffold asset: ${fileName}`);
+}
 var APP_FILE_LABELS = [
   "server",
   "client",
@@ -3359,11 +3539,8 @@ function riebeckiteConfig(preset, variables) {
 var OPTION_DEPTH = {
   empty: 0,
   minimal: 0,
-  starter: 0,
-  rich: 1,
-  full: 2,
-  max: 2,
-  ultra: 3
+  starter: 2,
+  showcase: 3
 };
 function optionContext(preset, variables) {
   return {
@@ -3480,24 +3657,12 @@ var README_INTRO = {
     ja: "最小限で実用的な Riebeckite サイトです。Obsidian マークダウン・minimal テーマ・1 ページ構成。"
   },
   starter: {
-    en: "The default Riebeckite starter: Obsidian Markdown, a color-mode toggle, and seven languages.",
-    ja: "Riebeckite の既定スターターです。Obsidian マークダウン・カラーモード切替・7 言語対応。"
-  },
-  rich: {
-    en: "A showcasing starter: publishing and reading plugins plus guided ecosystem tour pages in seven languages.",
-    ja: "紹介を目的としたスターターです。公開・読書体験のプラグインと、7 言語のエコシステム紹介ページ付き。"
-  },
-  full: {
-    en: "A ready-to-use blog preset: discovery, media, and reading plugins plus a getting-started guide.",
-    ja: "そのまま使えるブログ向けプリセットです。検索・メディア・読書体験のプラグインと入門ガイド付き。"
+    en: "Recommended for most sites: a practical Markdown garden with search, discovery, and reading essentials.",
+    ja: "大半のサイトにおすすめの構成です。検索・発見・閲覧に必要な機能を備えた実用的な Markdown サイトを作れます。"
   },
-  max: {
-    en: "Diagram, chart, and knowledge plugins on top of full, with showcase example pages.",
-    ja: "full に図解・チャート・ナレッジ系プラグインを加えた構成で、お試し用サンプルページ付き。"
-  },
-  ultra: {
-    en: "The complete plugin catalog with plugin and theme reference pages.",
-    ja: "全プラグインを有効化した最上位構成。プラグイン/テーマのリファレンスページ付き。"
+  showcase: {
+    en: "Explore the complete Riebeckite ecosystem with rendered examples, reference pages, and local fixtures.",
+    ja: "描画例・リファレンスページ・ローカルのフィクスチャで、Riebeckite のエコシステム全体を確認できる構成です。"
   }
 };
 var README_WORDS = {
@@ -4100,10 +4265,11 @@ var ScaffoldSiteError = class extends Error {
 async function scaffoldRiebeckiteSite(options) {
   const targetDirectory = path7.resolve(options.targetDirectory);
   const preset = resolveScaffoldPreset(options.preset);
-  const files = siteTemplateFiles(
-    preset,
-    templateVariables(options, targetDirectory)
-  );
+  validateDeploymentOptions(options);
+  const files = [
+    ...siteTemplateFiles(preset, templateVariables(options, targetDirectory)),
+    ...options.githubActions ? deploymentTemplateFiles(deploymentOptions(options)) : []
+  ];
   await assertTargetWritable(
     targetDirectory,
     files,
@@ -4111,11 +4277,41 @@ async function scaffoldRiebeckiteSite(options) {
   );
   for (const file of files) {
     const filePath = path7.join(targetDirectory, file.path);
-    await fs6.mkdir(path7.dirname(filePath), { recursive: true });
-    await fs6.writeFile(filePath, file.content, "utf8");
+    await fs7.mkdir(path7.dirname(filePath), { recursive: true });
+    await fs7.writeFile(filePath, file.content);
   }
   return { targetDirectory, files: files.map((file) => file.path) };
 }
+function deploymentOptions(options) {
+  return {
+    contentRepository: options.contentRepository,
+    siteRepository: options.siteRepository
+  };
+}
+function validateDeploymentOptions(options) {
+  try {
+    if (options.contentRepository !== void 0) {
+      assertGitHubRepository(options.contentRepository, "contentRepository");
+    }
+    if (options.siteRepository !== void 0) {
+      assertGitHubRepository(options.siteRepository, "siteRepository");
+    }
+  } catch (error) {
+    throw new ScaffoldSiteError(
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  if (options.contentRepository !== void 0 && !options.githubActions) {
+    throw new ScaffoldSiteError(
+      "--content-repository requires --github-actions."
+    );
+  }
+  if (options.contentRepository !== void 0 && options.siteRepository === void 0) {
+    throw new ScaffoldSiteError(
+      "--site-repository is required when --content-repository is used with --github-actions."
+    );
+  }
+}
 function templateVariables(options, targetDirectory) {
   const name = normalizePackageName(
     options.name ?? path7.basename(targetDirectory)
@@ -4131,7 +4327,7 @@ function templateVariables(options, targetDirectory) {
 async function assertTargetWritable(targetDirectory, files, overwrite) {
   let entries;
   try {
-    entries = await fs6.readdir(targetDirectory);
+    entries = await fs7.readdir(targetDirectory);
   } catch (error) {
     if (isNotFoundError2(error)) return;
     throw error;
@@ -4175,9 +4371,11 @@ export {
   createRiebeckiteSsg,
   defaultSsgEntry,
   defaultSsrExternals,
+  empty,
   formatScaffoldNextSteps,
   isScaffoldPresetName,
   loadRiebeckiteConfig,
+  minimal,
   replaceHonoxIslandDependencyPlugin,
   resolveHonoxApplication,
   resolveHonoxApplicationRoot,
@@ -4189,5 +4387,7 @@ export {
   riebeckiteVite,
   scaffoldPresets,
   scaffoldRiebeckiteSite,
-  startHonoxDevServer
+  showcase,
+  startHonoxDevServer,
+  starter
 };