create-zudo-doc 4.5.0 → 5.0.0

package/dist/claude-md-gen.js

@@ -19,7 +19,7 @@ export function generateCLAUDEFile(choices) {
     lines.push(``);
     lines.push(`- **zfb** — documentation build framework`);
     lines.push(`- **MDX** — content format, authored under \`src/content/\``);
-    lines.push(`- **Tailwind CSS v4** — via \`@tailwindcss/vite\``);
+    lines.push(`- **Tailwind CSS v4** — compiled by zfb's embedded Tailwind engine (no \`@tailwindcss/vite\` plugin, no \`tailwindcss\` dependency); \`src/styles/global.css\` imports \`tailwindcss/preflight\` + \`tailwindcss/utilities\` and zfb's internal resolver serves both`);
     lines.push(`- **Preact** — for interactive islands only (with compat mode for React API)`);
     lines.push("- **zfb semantic highlighting** — native build-time fenced-code rendering plus lazy `@takazudo/zfb-md-wasm` for HtmlPreview; both emit `hi-*` classes resolved through `--zd-syntax-*` design tokens");
     lines.push(`- **@takazudo/zudo-doc** — the package that owns everything: layout, chrome, islands, default \`@theme\` design tokens, and (via \`packageOwnedRoutes\`, on by default) the doc routes themselves`);

package/dist/constants.js

@@ -247,6 +247,13 @@ export const FEATURES = [
         default: false,
         cliFlag: "sidebar-toggle",
     },
+    {
+        value: "tocToggle",
+        label: "TOC toggle",
+        hint: "Show/hide the desktop table of contents",
+        default: false,
+        cliFlag: "toc-toggle",
+    },
     {
         value: "versioning",
         label: "Versioning",

package/dist/features/index.js

@@ -10,6 +10,7 @@ import { searchFeature } from "./search.js";
 import { footerFeature } from "./footer.js";
 import { sidebarResizerFeature } from "./sidebar-resizer.js";
 import { sidebarToggleFeature } from "./sidebar-toggle.js";
+import { tocToggleFeature } from "./toc-toggle.js";
 import { docHistoryFeature } from "./doc-history.js";
 import { llmsTxtFeature } from "./llms-txt.js";
 import { claudeResourcesFeature } from "./claude-resources.js";
@@ -39,6 +40,7 @@ export const featureModules = {
     themePackSwitcher: themePackSwitcherFeature,
     sidebarResizer: sidebarResizerFeature,
     sidebarToggle: sidebarToggleFeature,
+    tocToggle: tocToggleFeature,
     versioning: versioningFeature,
     docHistory: docHistoryFeature,
     bodyFootUtil: bodyFootUtilFeature,

package/dist/features/toc-toggle.d.ts

@@ -0,0 +1,11 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * TOC-toggle feature.
+ *
+ * Purely a `zudoDoc({ tocToggle: true })` field (see `zfb-config-gen.ts`).
+ * `DesktopTocToggle` is fully package-owned
+ * (`@takazudo/zudo-doc/desktop-toc-toggle-island`, wired into the doc-page
+ * shell directly) and its CSS ships unconditionally from
+ * `@takazudo/zudo-doc/features.css` — nothing to inject or copy.
+ */
+export declare const tocToggleFeature: FeatureModule;

package/dist/features/toc-toggle.js

@@ -0,0 +1,13 @@
+/**
+ * TOC-toggle feature.
+ *
+ * Purely a `zudoDoc({ tocToggle: true })` field (see `zfb-config-gen.ts`).
+ * `DesktopTocToggle` is fully package-owned
+ * (`@takazudo/zudo-doc/desktop-toc-toggle-island`, wired into the doc-page
+ * shell directly) and its CSS ships unconditionally from
+ * `@takazudo/zudo-doc/features.css` — nothing to inject or copy.
+ */
+export const tocToggleFeature = () => ({
+    name: "tocToggle",
+    injections: [],
+});

package/dist/scaffold.d.ts

@@ -32,5 +32,5 @@ export declare function deriveDocSkillName(projectName: string): string;
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export declare const ZUDO_DOC_PIN = "^4.5.0";
+export declare const ZUDO_DOC_PIN = "^5.0.0";
 export declare function scaffold(choices: UserChoices): Promise<void>;

package/dist/scaffold.js

@@ -43,7 +43,7 @@ export function deriveDocSkillName(projectName) {
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^4.5.0";
+export const ZUDO_DOC_PIN = "^5.0.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -573,9 +573,15 @@ function generatePackageJson(choices) {
         // 1.1.0: container-directive fixes (multi-block bodies, unclosed-opener
         // diagnostics) plus highlighting for fences nested in MDX JSX bodies and
         // directives. Content-rendering fixes, additive.
-        "@takazudo/zfb": "1.1.0",
-        "@takazudo/zfb-runtime": "1.1.0",
-        "@takazudo/zfb-md-wasm": "1.1.0",
+        // 2.0.0: BREAKING — the `githubAutolinks` markdown feature was removed
+        // (`GithubAutolinksConfig` is gone from `zfb/config`, and a config still
+        // setting it hard-errors at load). A fresh scaffold never emitted it, so
+        // there is no generator-side migration. Additive alongside it:
+        // `strictContentBridge`, a build-only gate that fails `zfb build` when a
+        // collection entry falls back to `<pre data-zfb-content-fallback>`.
+        "@takazudo/zfb": "2.1.0",
+        "@takazudo/zfb-runtime": "2.1.0",
+        "@takazudo/zfb-md-wasm": "2.1.0",
         // @takazudo/zudo-doc — published from this monorepo via
         // .github/workflows/publish-zudo-doc.yml. The pin here is bumped in
         // lockstep by scripts/release-create-zudo-doc.sh whenever zudo-doc's
@@ -610,10 +616,6 @@ function generatePackageJson(choices) {
         // compiles. Same pin as host. Caught by W6B (#1735) consumer-build
         // verification.
         "preact-render-to-string": "^6.6.6",
-        "gray-matter": "^4.0.0",
-        mermaid: "^11.12.3",
-        "remark-cjk-friendly": "^2.0.1",
-        "remark-directive": "^3.0.0",
         // katex — server-side LaTeX renderer used by the always-on
         // pages/lib/_math-block.tsx (called from pages/_mdx-components.ts
         // for `$…$` and `$$…$$` math nodes). Caught by W6B (#1735)
@@ -663,11 +665,17 @@ function generatePackageJson(choices) {
         // packages/zudo-doc/src/__tests__/optional-peer-reachability.test.ts.)
     };
     const devDeps = {
-        "@tailwindcss/vite": "^4.2.0",
-        tailwindcss: "^4.2.0",
         typescript: "^5.9.0",
         "@types/node": "^22.0.0",
-        "@types/react": "^19.2.0", // needed for preact/compat type resolution
+        // @types/react is intentionally ABSENT (#3181/#3183). tsconfig.base.json
+        // now sets `jsx: "react-jsx"` + `jsxImportSource: "preact"`, so TypeScript
+        // resolves `JSX.IntrinsicElements` from preact/jsx-runtime's own types —
+        // not from a global @types/react namespace. Ejected components (e.g.
+        // `src/components/zudo-doc/theme-toggle/`) typecheck cleanly under
+        // `zfb check` without it; verified by the create-zudo-doc `test:slow`
+        // post-eject build. Do not re-add this dep to work around a typecheck
+        // failure — that would mean the react-jsx flip regressed, which is worth
+        // reporting against #3181, not papering over here.
         // html-validate dropped — check:html is no longer a default script
         // (see the scripts block below; `.htmlvalidate.json` no longer ships).
     };
@@ -695,7 +703,7 @@ function generatePackageJson(choices) {
         // `/exclude` at module scope from the always-bundled chrome graph; #3110
         // moved compileExclude into @takazudo/zudo-doc, so docHistory-OFF projects
         // no longer need the package at all.
-        deps["@takazudo/zudo-doc-history-server"] = "^4.5.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^5.0.0";
         // tsx is no longer needed here: the relocated package plugin imports the
         // runner directly (no `tsx -e` spawn) since the package ships compiled
         // dist/ — package-first migration #2321 (#2337).

package/dist/zfb-config-gen.js

@@ -56,6 +56,7 @@ export const DEFAULT_MIRROR = {
     designTokenPanel: false,
     sidebarResizer: false,
     sidebarToggle: false,
+    tocToggle: false,
     imageEnlarge: false,
     findInPage: false,
     dynamicPageTransition: false,
@@ -219,6 +220,7 @@ function buildDesiredConfig(choices) {
     desired.designTokenPanel = choices.features.includes("designTokenPanel");
     desired.sidebarResizer = choices.features.includes("sidebarResizer");
     desired.sidebarToggle = choices.features.includes("sidebarToggle");
+    desired.tocToggle = choices.features.includes("tocToggle");
     desired.imageEnlarge = choices.features.includes("imageEnlarge");
     // findInPage rides the existing tauri feature (#2690) — the Cmd/Ctrl+F find
     // bar only makes sense inside the Tauri desktop shell, so it has no CLI
@@ -358,6 +360,7 @@ const FIELD_ORDER = [
     "designTokenPanel",
     "sidebarResizer",
     "sidebarToggle",
+    "tocToggle",
     "imageEnlarge",
     "findInPage",
     "dynamicPageTransition",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zudo-doc",
-  "version": "4.5.0",
+  "version": "5.0.0",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",
@@ -61,7 +61,6 @@
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^22.0.0",
-    "gray-matter": "^4.0.3",
     "typescript": "^5.9.0",
     "vitest": "^4.1.0"
   }

package/templates/base/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
+  <rect width="32" height="32" rx="6" fill="#7c3aed"/>
+  <text x="16" y="23" font-family="system-ui,sans-serif" font-size="20" font-weight="700" fill="white" text-anchor="middle">Z</text>
+</svg>