create-zudo-doc 4.2.1 → 4.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/claude-md-gen.js
CHANGED
|
@@ -21,7 +21,7 @@ export function generateCLAUDEFile(choices) {
|
|
|
21
21
|
lines.push(`- **MDX** — content format, authored under \`src/content/\``);
|
|
22
22
|
lines.push(`- **Tailwind CSS v4** — via \`@tailwindcss/vite\``);
|
|
23
23
|
lines.push(`- **Preact** — for interactive islands only (with compat mode for React API)`);
|
|
24
|
-
lines.push(
|
|
24
|
+
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");
|
|
25
25
|
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`);
|
|
26
26
|
lines.push(``);
|
|
27
27
|
// Commands
|
|
@@ -31,6 +31,7 @@ export function generateCLAUDEFile(choices) {
|
|
|
31
31
|
if (choices.features.includes("docHistory")) {
|
|
32
32
|
lines.push(`- \`${pmRunCommand(pm, "dev")}\` — runs the zfb dev server (port 4321) and the doc-history API server (port 4322) concurrently via \`run-p\` (\`${pmRunCommand(pm, "dev:zfb")}\` / \`${pmRunCommand(pm, "dev:history")}\` individually)`);
|
|
33
33
|
lines.push(`- \`${pmRunCommand(pm, "dev:network")}\` — same, but zfb binds \`--host 0.0.0.0\` for LAN access (\`${pmRunCommand(pm, "dev:zfb:network")}\` individually); the doc-history server stays loopback-only and LAN clients reach it through zfb's \`/doc-history/*\` dev proxy`);
|
|
34
|
+
lines.push(`- **Trusted networks only:** this also serves your git doc-history — including UNPUBLISHED local commits — to anyone on the LAN via the \`/doc-history/*\` proxy`);
|
|
34
35
|
lines.push(`- \`run-p\` swallows trailing args, so other zfb flags don't forward through \`${pmRunCommand(pm, "dev")}\` — pass them directly instead: \`${pm} run dev:zfb -- <flags>\``);
|
|
35
36
|
}
|
|
36
37
|
else {
|
package/dist/scaffold.d.ts
CHANGED
|
@@ -18,5 +18,5 @@ export { getSecondaryLang };
|
|
|
18
18
|
*
|
|
19
19
|
* Bumped in lockstep by scripts/release-create-zudo-doc.sh.
|
|
20
20
|
*/
|
|
21
|
-
export declare const ZUDO_DOC_PIN = "^4.
|
|
21
|
+
export declare const ZUDO_DOC_PIN = "^4.3.0";
|
|
22
22
|
export declare function scaffold(choices: UserChoices): Promise<void>;
|
package/dist/scaffold.js
CHANGED
|
@@ -24,7 +24,7 @@ export { getSecondaryLang };
|
|
|
24
24
|
*
|
|
25
25
|
* Bumped in lockstep by scripts/release-create-zudo-doc.sh.
|
|
26
26
|
*/
|
|
27
|
-
export const ZUDO_DOC_PIN = "^4.
|
|
27
|
+
export const ZUDO_DOC_PIN = "^4.3.0";
|
|
28
28
|
/**
|
|
29
29
|
* Files in `templates/base/**` that must not be copied by the unconditional
|
|
30
30
|
* base mirror. Each entry is matched against the path relative to
|
|
@@ -590,9 +590,6 @@ function generatePackageJson(choices) {
|
|
|
590
590
|
// compiles. Same pin as host. Caught by W6B (#1735) consumer-build
|
|
591
591
|
// verification.
|
|
592
592
|
"preact-render-to-string": "^6.6.6",
|
|
593
|
-
// Retained until #2742 atomically moves HTML Preview to zfb-md-wasm.
|
|
594
|
-
shiki: "^4.0.2",
|
|
595
|
-
"@shikijs/transformers": "^4.0.0",
|
|
596
593
|
"gray-matter": "^4.0.0",
|
|
597
594
|
mermaid: "^11.12.3",
|
|
598
595
|
"remark-cjk-friendly": "^2.0.1",
|
|
@@ -660,7 +657,7 @@ function generatePackageJson(choices) {
|
|
|
660
657
|
// doc-history helpers, which in turn import
|
|
661
658
|
// @takazudo/zudo-doc-history-server/git-history. Without this dep the
|
|
662
659
|
// plugin host fails at init with ERR_MODULE_NOT_FOUND — W8A (#1739).
|
|
663
|
-
deps["@takazudo/zudo-doc-history-server"] = "^4.
|
|
660
|
+
deps["@takazudo/zudo-doc-history-server"] = "^4.3.0";
|
|
664
661
|
// tsx is no longer needed here: the relocated package plugin imports the
|
|
665
662
|
// runner directly (no `tsx -e` spawn) since the package ships compiled
|
|
666
663
|
// dist/ — package-first migration #2321 (#2337).
|
package/dist/zfb-config-gen.js
CHANGED
package/package.json
CHANGED
|
@@ -81,6 +81,8 @@ REPO_ROOT="$(git -C "$ROOT_DIR" worktree list | head -1 | awk '{print $1}')"
|
|
|
81
81
|
# worktree root, above) reconstructs the equivalent path there even when
|
|
82
82
|
# running from inside a different worktree.
|
|
83
83
|
PROJECT_PREFIX="$(git -C "$ROOT_DIR" rev-parse --show-prefix)"
|
|
84
|
+
MAIN_PROJECT_DIR="$REPO_ROOT/${PROJECT_PREFIX}"
|
|
85
|
+
MAIN_PROJECT_DIR="${MAIN_PROJECT_DIR%/}"
|
|
84
86
|
REPO_DOCS_DIR="$REPO_ROOT/${PROJECT_PREFIX}src/content/docs"
|
|
85
87
|
REPO_DOCS_JA_DIR="$REPO_ROOT/${PROJECT_PREFIX}src/content/docs-ja"
|
|
86
88
|
|
|
@@ -142,7 +144,7 @@ fi
|
|
|
142
144
|
# even when the project is nested inside a larger git repo (running `pnpm
|
|
143
145
|
# build` from the outer repo root would otherwise invoke the wrong
|
|
144
146
|
# package.json, #2918).
|
|
145
|
-
VERIFY_STEP="Run \`pnpm build\` from \`$
|
|
147
|
+
VERIFY_STEP="Run \`pnpm build\` from \`$MAIN_PROJECT_DIR\` to confirm the site builds correctly."
|
|
146
148
|
|
|
147
149
|
resolve_targets() {
|
|
148
150
|
case "$TARGET_MODE" in
|
|
@@ -204,7 +206,7 @@ argument-hint: "[-u|--update] [topic keyword, e.g., 'configuration', 'sidebar',
|
|
|
204
206
|
# $PROJECT_NAME Documentation Reference
|
|
205
207
|
|
|
206
208
|
Look up documentation from the $PROJECT_NAME project for $assistant_label.
|
|
207
|
-
Documentation base path: \`src/content/docs\` (relative to the project root: \`$
|
|
209
|
+
Documentation base path: \`src/content/docs\` (relative to the project root: \`$MAIN_PROJECT_DIR\`)
|
|
208
210
|
|
|
209
211
|
## Mode Detection
|
|
210
212
|
|
|
@@ -234,7 +236,7 @@ The user has new information and wants to add or update documentation in this re
|
|
|
234
236
|
the topic. Read them to understand what is already covered.
|
|
235
237
|
3. **Decide create vs update**: If an existing article covers the topic, update
|
|
236
238
|
it. Otherwise, create a new \`.mdx\` file in the appropriate subdirectory.
|
|
237
|
-
4. **Write the content**: Follow the doc-authoring rules in this project's CLAUDE.md (\`$
|
|
239
|
+
4. **Write the content**: Follow the doc-authoring rules in this project's CLAUDE.md (\`$MAIN_PROJECT_DIR/CLAUDE.md\`):
|
|
238
240
|
- Required frontmatter: \`title\` (string). Always set \`sidebar_position\`.
|
|
239
241
|
Optional: \`description\`, \`sidebar_label\`, \`tags\`, etc.
|
|
240
242
|
- Do NOT use \`# h1\` in content — the frontmatter \`title\` renders as h1.
|