@takazudo/zudo-doc 5.3.0 → 5.5.0

package/CHANGELOG.md

@@ -4,6 +4,36 @@ All notable changes to `@takazudo/zudo-doc` are documented in this file.
 
 The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.
 
+## [5.5.0] - 2026-08-14
+
+### Features
+
+- Bumped the `@takazudo/zfb` family (`zfb`, `zfb-runtime`, `zfb-md-wasm`, `zfb-adapter-cloudflare`) from 2.4.0 to 2.5.0 across the root, `@takazudo/zudo-doc`, and the `create-zudo-doc` scaffold pin. zfb 2.5.0 adds **autolink literals to the conservative GFM default**, so a bare URL written in markdown (`https://example.com`) now renders as a link with no configuration. The preset passes a partial `gfm` object, which inherits the new default — nothing to opt into. CJK-adjacent bare URLs still terminate at the right boundary, because `cjkFriendly` (on by default) wires the autolink boundary fixup. (a898b287)
+
+### Bug Fixes
+
+- Write the dev-server URL bare in the Introduction guide (EN+JA) instead of as `[url](url)`. Under 2.5.0's default-on autolink literals that form emits an `<a>` nested inside an `<a>`, which fails HTML validation. Reported upstream as [Takazudo/zudo-front-builder#2388](https://github.com/Takazudo/zudo-front-builder/issues/2388). (bbbf5d53)
+- CSS-shape smoke gate test: strip the leading whitespace BSD `wc -l` pads its count with, so the fake-curl fixture's `case` matches and the test passes on macOS as well as Linux CI. (55b094a0)
+
+### Other Changes
+
+- CJK Friendly reference (EN+JA) now notes that `gfm.autolinkLiteral` is on by default as of zfb 2.5.0, rather than presenting it as something to enable. (bbbf5d53)
+
+## [5.4.0] - 2026-08-13
+
+### Features
+
+- create-zudo-doc: new **Claude skills (writing)** scaffold feature (`--claude-skills-writing`, off by default) — ships the new `zudo-doc-writing` Claude Code skill into generated projects: a doc-writing + navigation-structure guide (plan-the-nav-tree-first workflow, 3-level hierarchy, file-structure-is-navigation, category index pages, `sidebar_position` discipline, frontmatter schema, no-h1 rule, relative `.mdx` links, admonition syntax) that keeps AI-assisted doc authoring from producing chaotic navigation. Independent of the existing "Claude skills (user-facing)" checkbox. (b37e28e5, #3383)
+
+### Bug Fixes
+
+- Corrected stale doc-authoring claims in the writing-rules skill and the Writing Docs guide: the default docs frontmatter schema is `.passthrough()` (custom keys are preserved, not rejected — and a typo'd framework field is silently ignored rather than erroring), and the admonition set includes the `caution` type (the `Caution` component, plus the JSX-only `Important` component). (9acbc838, 3f338647, #3384)
+
+### Other Changes
+
+- Restructured the Claude Skills guide (EN+JA) around the two independent opt-in skill features, and fixed the stale claim that shipped skills are verbatim monorepo copies. (4511619d)
+- Template drift check: allowlisted the template-only `zudo-doc-writing` skill (its correctness is guarded by the generator's vitest suite). (821f6602)
+
 ## [5.3.0] - 2026-08-11
 
 ### Features

package/dist/preset.js

@@ -16,10 +16,12 @@ function zudoDocPreset({
     markdown: {
       features: buildMarkdownFeatures(settings, directiveVocabulary),
       ...settings.cjkFriendly !== void 0 ? { cjkFriendly: settings.cjkFriendly } : {},
-      // zfb's gfm default is conservative (strikethrough + table only); the
-      // preset turns on the other two GFM constructs so task lists and
-      // footnotes render for real instead of as literal `[ ]` / `[^1]` text
-      // (#3197, #3208).
+      // zfb's gfm default is conservative — strikethrough, table, and (since
+      // zfb 2.5.0) autolinkLiteral on, task lists and footnotes off. A partial
+      // object only overrides the keys it names, so the two opted in here are
+      // the delta: task lists and footnotes render for real instead of as
+      // literal `[ ]` / `[^1]` text (#3197, #3208), and bare URLs autolink via
+      // the inherited default.
       gfm: { taskListItem: true, footnoteDefinition: true }
     },
     // zfb class mode keeps renderer output semantic and delegates color to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.3.0",
+  "version": "5.5.0",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -610,10 +610,10 @@
   ],
   "peerDependencies": {
     "@takazudo/zdtp": "^0.4.10",
-    "@takazudo/zfb": "^2.3.1",
-    "@takazudo/zfb-md-wasm": "^2.3.1",
-    "@takazudo/zfb-runtime": "^2.3.1",
-    "@takazudo/zudo-doc-history-server": "^5.2.1",
+    "@takazudo/zfb": "^2.5.0",
+    "@takazudo/zfb-md-wasm": "^2.5.0",
+    "@takazudo/zfb-runtime": "^2.5.0",
+    "@takazudo/zudo-doc-history-server": "^5.4.0",
     "diff": "^8.0.0",
     "katex": "^0.16.0",
     "preact": "^10.29.1",
@@ -647,9 +647,9 @@
     "tsx": "^4.21.0"
   },
   "devDependencies": {
-    "@takazudo/zfb": "2.3.1",
-    "@takazudo/zfb-md-wasm": "2.3.1",
-    "@takazudo/zfb-runtime": "2.3.1",
+    "@takazudo/zfb": "2.5.0",
+    "@takazudo/zfb-md-wasm": "2.5.0",
+    "@takazudo/zfb-runtime": "2.5.0",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
@@ -663,7 +663,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.3.0"
+    "@takazudo/zudo-doc-history-server": "5.5.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",