@takazudo/zudo-doc 0.2.21 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "0.2.21",
+  "version": "1.0.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",
@@ -155,22 +155,370 @@
       "types": "./dist/icons/index.d.ts",
       "default": "./dist/icons/index.js"
     },
+    "./robots": {
+      "types": "./dist/robots.d.ts",
+      "default": "./dist/robots.js"
+    },
+    "./preset": {
+      "types": "./dist/preset.d.ts",
+      "default": "./dist/preset.js"
+    },
+    "./plugins/doc-history": {
+      "types": "./dist/plugins/doc-history.d.ts",
+      "default": "./dist/plugins/doc-history.js"
+    },
+    "./plugins/llms-txt": {
+      "types": "./dist/plugins/llms-txt.d.ts",
+      "default": "./dist/plugins/llms-txt.js"
+    },
+    "./plugins/search-index": {
+      "types": "./dist/plugins/search-index.d.ts",
+      "default": "./dist/plugins/search-index.js"
+    },
+    "./plugins/claude-resources": {
+      "types": "./dist/plugins/claude-resources.d.ts",
+      "default": "./dist/plugins/claude-resources.js"
+    },
+    "./plugins/routes": {
+      "types": "./dist/plugins/routes.d.ts",
+      "default": "./dist/plugins/routes.js"
+    },
+    "./content-admonition": {
+      "types": "./dist/content-admonition/index.d.ts",
+      "default": "./dist/content-admonition/index.js"
+    },
+    "./code-group": {
+      "types": "./dist/code-group/index.d.ts",
+      "default": "./dist/code-group/index.js"
+    },
+    "./math-block": {
+      "types": "./dist/math-block/index.d.ts",
+      "default": "./dist/math-block/index.js"
+    },
+    "./extract-headings": {
+      "types": "./dist/extract-headings/index.d.ts",
+      "default": "./dist/extract-headings/index.js"
+    },
+    "./settings": {
+      "types": "./dist/settings.d.ts",
+      "default": "./dist/settings.js"
+    },
+    "./mdx-components": {
+      "types": "./dist/mdx-components/index.d.ts",
+      "default": "./dist/mdx-components/index.js"
+    },
     "./safelist.css": "./dist/safelist.css",
     "./safelist": "./dist/safelist.css",
     "./content.css": "./dist/content.css",
-    "./page-loading.css": "./dist/page-loading.css"
+    "./page-loading.css": "./dist/page-loading.css",
+    "./features.css": "./dist/features.css",
+    "./tags-audit": {
+      "types": "./dist/tags-audit.d.ts",
+      "default": "./dist/tags-audit.js"
+    },
+    "./color-scheme-utils": {
+      "types": "./dist/color-scheme-utils.d.ts",
+      "default": "./dist/color-scheme-utils.js"
+    },
+    "./design-token-panel-bootstrap": {
+      "types": "./dist/design-token-panel-bootstrap.d.ts",
+      "default": "./dist/design-token-panel-bootstrap.js"
+    },
+    "./render-markdown": {
+      "types": "./dist/render-markdown/index.d.ts",
+      "default": "./dist/render-markdown/index.js"
+    },
+    "./slug": {
+      "types": "./dist/slug/index.d.ts",
+      "default": "./dist/slug/index.js"
+    },
+    "./smart-break": {
+      "types": "./dist/smart-break/index.d.ts",
+      "default": "./dist/smart-break/index.js"
+    },
+    "./use-modal-dialog": {
+      "types": "./dist/use-modal-dialog/index.d.ts",
+      "default": "./dist/use-modal-dialog/index.js"
+    },
+    "./island-types": {
+      "types": "./dist/island-types/index.d.ts",
+      "default": "./dist/island-types/index.js"
+    },
+    "./url-helpers": {
+      "types": "./dist/url-helpers/index.d.ts",
+      "default": "./dist/url-helpers/index.js"
+    },
+    "./factory-context": {
+      "types": "./dist/factory-context/index.d.ts",
+      "default": "./dist/factory-context/index.js"
+    },
+    "./compose-meta-title": {
+      "types": "./dist/compose-meta-title/index.d.ts",
+      "default": "./dist/compose-meta-title/index.js"
+    },
+    "./frontmatter-preview-data": {
+      "types": "./dist/frontmatter-preview-data/index.d.ts",
+      "default": "./dist/frontmatter-preview-data/index.js"
+    },
+    "./tree-nav-shared": {
+      "types": "./dist/tree-nav-shared/index.d.ts",
+      "default": "./dist/tree-nav-shared/index.js"
+    },
+    "./sidebar-tree-island": {
+      "types": "./dist/sidebar-tree-island/index.d.ts",
+      "default": "./dist/sidebar-tree-island/index.js"
+    },
+    "./sidebar-toggle-island": {
+      "types": "./dist/sidebar-toggle-island/index.d.ts",
+      "default": "./dist/sidebar-toggle-island/index.js"
+    },
+    "./desktop-sidebar-toggle-island": {
+      "types": "./dist/desktop-sidebar-toggle-island/index.d.ts",
+      "default": "./dist/desktop-sidebar-toggle-island/index.js"
+    },
+    "./site-tree-nav-island": {
+      "types": "./dist/site-tree-nav-island/index.d.ts",
+      "default": "./dist/site-tree-nav-island/index.js"
+    },
+    "./image-enlarge": {
+      "types": "./dist/image-enlarge/index.d.ts",
+      "default": "./dist/image-enlarge/index.js"
+    },
+    "./mermaid-enlarge": {
+      "types": "./dist/mermaid-enlarge/index.d.ts",
+      "default": "./dist/mermaid-enlarge/index.js"
+    },
+    "./ai-chat-modal": {
+      "types": "./dist/ai-chat-modal/index.d.ts",
+      "default": "./dist/ai-chat-modal/index.js"
+    },
+    "./doc-history": {
+      "types": "./dist/doc-history/index.d.ts",
+      "default": "./dist/doc-history/index.js"
+    },
+    "./nav-scope": {
+      "types": "./dist/nav-scope/index.d.ts",
+      "default": "./dist/nav-scope/index.js"
+    },
+    "./nav-data-prep": {
+      "types": "./dist/nav-data-prep/index.d.ts",
+      "default": "./dist/nav-data-prep/index.js"
+    },
+    "./sidebar-utils": {
+      "types": "./dist/sidebar-utils/index.d.ts",
+      "default": "./dist/sidebar-utils/index.js"
+    },
+    "./search-widget-script": {
+      "types": "./dist/search-widget-script/index.d.ts",
+      "default": "./dist/search-widget-script/index.js"
+    },
+    "./search-widget": {
+      "types": "./dist/search-widget/index.d.ts",
+      "default": "./dist/search-widget/index.js"
+    },
+    "./head-with-defaults": {
+      "types": "./dist/head-with-defaults/index.d.ts",
+      "default": "./dist/head-with-defaults/index.js"
+    },
+    "./sidebar-prepaint": {
+      "types": "./dist/sidebar-prepaint/index.d.ts",
+      "default": "./dist/sidebar-prepaint/index.js"
+    },
+    "./sidebar-with-defaults": {
+      "types": "./dist/sidebar-with-defaults/index.d.ts",
+      "default": "./dist/sidebar-with-defaults/index.js"
+    },
+    "./footer-with-defaults": {
+      "types": "./dist/footer-with-defaults/index.d.ts",
+      "default": "./dist/footer-with-defaults/index.js"
+    },
+    "./header-with-defaults": {
+      "types": "./dist/header-with-defaults/index.d.ts",
+      "default": "./dist/header-with-defaults/index.js"
+    },
+    "./doc-page-shell": {
+      "types": "./dist/doc-page-shell/index.d.ts",
+      "default": "./dist/doc-page-shell/index.js"
+    },
+    "./doc-page-props": {
+      "types": "./dist/doc-page-props/index.d.ts",
+      "default": "./dist/doc-page-props/index.js"
+    },
+    "./locale-merge": {
+      "types": "./dist/locale-merge/index.d.ts",
+      "default": "./dist/locale-merge/index.js"
+    },
+    "./doc-route-paths": {
+      "types": "./dist/doc-route-paths/index.d.ts",
+      "default": "./dist/doc-route-paths/index.js"
+    },
+    "./nav-source-cache": {
+      "types": "./dist/nav-source-cache/index.d.ts",
+      "default": "./dist/nav-source-cache/index.js"
+    },
+    "./nav-source-docs": {
+      "types": "./dist/nav-source-docs/index.d.ts",
+      "default": "./dist/nav-source-docs/index.js"
+    },
+    "./doc-route-entries": {
+      "types": "./dist/doc-route-entries/index.d.ts",
+      "default": "./dist/doc-route-entries/index.js"
+    },
+    "./route-enumerators": {
+      "types": "./dist/route-enumerators/index.d.ts",
+      "default": "./dist/route-enumerators/index.js"
+    },
+    "./github-helpers": {
+      "types": "./dist/github-helpers/index.d.ts",
+      "default": "./dist/github-helpers/index.js"
+    },
+    "./tag-helpers": {
+      "types": "./dist/tag-helpers/index.d.ts",
+      "default": "./dist/tag-helpers/index.js"
+    },
+    "./doc-metainfo-area": {
+      "types": "./dist/doc-metainfo-area/index.d.ts",
+      "default": "./dist/doc-metainfo-area/index.js"
+    },
+    "./doc-tags-area": {
+      "types": "./dist/doc-tags-area/index.d.ts",
+      "default": "./dist/doc-tags-area/index.js"
+    },
+    "./doc-pager": {
+      "types": "./dist/doc-pager/index.d.ts",
+      "default": "./dist/doc-pager/index.js"
+    },
+    "./doc-body-end": {
+      "types": "./dist/doc-body-end/index.d.ts",
+      "default": "./dist/doc-body-end/index.js"
+    },
+    "./doc-history-area": {
+      "types": "./dist/doc-history-area/index.d.ts",
+      "default": "./dist/doc-history-area/index.js"
+    },
+    "./doc-content-header": {
+      "types": "./dist/doc-content-header/index.d.ts",
+      "default": "./dist/doc-content-header/index.js"
+    },
+    "./doc-page-renderer": {
+      "types": "./dist/doc-page-renderer/index.d.ts",
+      "default": "./dist/doc-page-renderer/index.js"
+    },
+    "./inline-version-switcher": {
+      "types": "./dist/inline-version-switcher/index.d.ts",
+      "default": "./dist/inline-version-switcher/index.js"
+    },
+    "./versions-page": {
+      "types": "./dist/versions-page/index.d.ts",
+      "default": "./dist/versions-page/index.js"
+    },
+    "./tag-pages": {
+      "types": "./dist/tag-pages/index.d.ts",
+      "default": "./dist/tag-pages/index.js"
+    },
+    "./category-nav": {
+      "types": "./dist/category-nav/index.d.ts",
+      "default": "./dist/category-nav/index.js"
+    },
+    "./category-tree-nav": {
+      "types": "./dist/category-tree-nav/index.d.ts",
+      "default": "./dist/category-tree-nav/index.js"
+    },
+    "./site-tree-nav": {
+      "types": "./dist/site-tree-nav/index.d.ts",
+      "default": "./dist/site-tree-nav/index.js"
+    },
+    "./routes/index": {
+      "types": "./dist/routes/index.d.ts",
+      "default": "./dist/routes/index.js"
+    },
+    "./routes/404": {
+      "types": "./dist/routes/404.d.ts",
+      "default": "./dist/routes/404.js"
+    },
+    "./routes/sitemap.xml": {
+      "types": "./dist/routes/sitemap.xml.d.ts",
+      "default": "./dist/routes/sitemap.xml.js"
+    },
+    "./routes/robots.txt": {
+      "types": "./dist/routes/robots.txt.d.ts",
+      "default": "./dist/routes/robots.txt.js"
+    },
+    "./routes/docs-slug": {
+      "types": "./dist/routes/docs-slug.d.ts",
+      "default": "./dist/routes/docs-slug.js"
+    },
+    "./routes/docs-versions": {
+      "types": "./dist/routes/docs-versions.d.ts",
+      "default": "./dist/routes/docs-versions.js"
+    },
+    "./routes/docs-tags-index": {
+      "types": "./dist/routes/docs-tags-index.d.ts",
+      "default": "./dist/routes/docs-tags-index.js"
+    },
+    "./routes/docs-tags-tag": {
+      "types": "./dist/routes/docs-tags-tag.d.ts",
+      "default": "./dist/routes/docs-tags-tag.js"
+    },
+    "./routes/api-ai-chat": {
+      "types": "./dist/routes/api-ai-chat.d.ts",
+      "default": "./dist/routes/api-ai-chat.js"
+    },
+    "./routes/locale-index": {
+      "types": "./dist/routes/locale-index.d.ts",
+      "default": "./dist/routes/locale-index.js"
+    },
+    "./routes/locale-docs-slug": {
+      "types": "./dist/routes/locale-docs-slug.d.ts",
+      "default": "./dist/routes/locale-docs-slug.js"
+    },
+    "./routes/locale-docs-versions": {
+      "types": "./dist/routes/locale-docs-versions.d.ts",
+      "default": "./dist/routes/locale-docs-versions.js"
+    },
+    "./routes/locale-docs-tags-index": {
+      "types": "./dist/routes/locale-docs-tags-index.d.ts",
+      "default": "./dist/routes/locale-docs-tags-index.js"
+    },
+    "./routes/locale-docs-tags-tag": {
+      "types": "./dist/routes/locale-docs-tags-tag.d.ts",
+      "default": "./dist/routes/locale-docs-tags-tag.js"
+    },
+    "./routes/v-docs-slug": {
+      "types": "./dist/routes/v-docs-slug.d.ts",
+      "default": "./dist/routes/v-docs-slug.js"
+    },
+    "./routes/v-locale-docs-slug": {
+      "types": "./dist/routes/v-locale-docs-slug.d.ts",
+      "default": "./dist/routes/v-locale-docs-slug.js"
+    },
+    "./eject": {
+      "types": "./dist/eject/index.d.ts",
+      "default": "./dist/eject/index.js"
+    }
+  },
+  "bin": {
+    "gen-z-index": "./bin/gen-z-index.mjs",
+    "tags-audit": "./bin/tags-audit.mjs",
+    "zudo-doc": "./bin/zudo-doc.mjs"
   },
   "files": [
     "dist",
+    "bin",
+    "eject",
+    "routes-src",
     "README.md"
   ],
   "peerDependencies": {
     "preact": "^10.29.1",
-    "@takazudo/zfb": "^0.1.0-next.59",
-    "@takazudo/zfb-runtime": "^0.1.0-next.59",
-    "@takazudo/zudo-doc-history-server": "^0.2.15",
-    "@takazudo/zdtp": "^0.2.3",
-    "shiki": "^4.0.2"
+    "@takazudo/zfb": "^0.1.0-next.65",
+    "@takazudo/zfb-runtime": "^0.1.0-next.65",
+    "@takazudo/zudo-doc-history-server": "^0.2.21",
+    "@takazudo/zdtp": "^0.3.3",
+    "shiki": "^4.0.2",
+    "zod": "^4.3.6",
+    "katex": "^0.16.0",
+    "diff": "^8.0.0"
   },
   "peerDependenciesMeta": {
     "@takazudo/zudo-doc-history-server": {
@@ -181,12 +529,23 @@
     },
     "shiki": {
       "optional": true
+    },
+    "katex": {
+      "optional": true
+    },
+    "diff": {
+      "optional": true
     }
   },
   "dependencies": {
-    "gray-matter": "^4.0.3"
+    "fs-extra": "^11.3.0",
+    "gray-matter": "^4.0.3",
+    "minimist": "^1.2.8",
+    "picocolors": "^1.1.1"
   },
   "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
     "cross-env": "^7.0.3",
     "preact": "^10.29.1",
@@ -195,11 +554,12 @@
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
-    "@takazudo/zfb": "0.1.0-next.59",
-    "@takazudo/zfb-runtime": "0.1.0-next.59"
+    "zod": "^4.3.6",
+    "@takazudo/zfb": "0.1.0-next.65",
+    "@takazudo/zfb-runtime": "0.1.0-next.65"
   },
   "scripts": {
-    "build": "cross-env NODE_OPTIONS=--max-old-space-size=4096 tsup",
+    "build": "tsup && tsc -p tsconfig.build.json",
     "dev": "tsup --watch",
     "test": "vitest run --config vitest.config.ts",
     "typecheck": "tsc --noEmit"

package/routes-src/404.tsx

@@ -0,0 +1,49 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /404 — package-owned equivalent of pages/404.tsx
+// (A1 #2361). Static route; emitted as dist/404.html.
+
+import type { JSX } from "preact";
+import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
+import { settings, defaultLocale, withBase } from "./_context.js";
+import {
+  HeadWithDefaults,
+  HeaderWithDefaults,
+  FooterWithDefaults,
+  BodyEndIslandsStub,
+  composeMetaTitle,
+} from "./_chrome.js";
+
+export const frontmatter = { title: "404" };
+
+export default function NotFoundPage(): JSX.Element {
+  const locale = defaultLocale;
+  const title = "Page Not Found";
+
+  return (
+    <DocLayoutWithDefaults
+      title={composeMetaTitle(title)}
+      head={<HeadWithDefaults title={title} />}
+      lang={locale}
+      noindex={true}
+      hideSidebar={true}
+      hideToc={true}
+      sidebarOverride={<></>}
+      headerOverride={<HeaderWithDefaults lang={locale} />}
+      footerOverride={<FooterWithDefaults lang={locale} />}
+      bodyEndComponents={<BodyEndIslandsStub basePath={settings.base ?? "/"} />}
+      enableClientRouter={settings.dynamicPageTransition}
+    >
+      <div class="min-h-[60vh] flex flex-col items-center justify-center px-hsp-2xl py-vsp-xl">
+        <h1 class="text-display font-bold mb-vsp-md">404</h1>
+        <p class="text-title text-muted mb-vsp-xl">Page not found.</p>
+        <a
+          href={withBase("/")}
+          class="bg-accent px-hsp-lg py-vsp-xs font-medium text-bg hover:bg-accent-hover"
+        >
+          Back to Home
+        </a>
+      </div>
+    </DocLayoutWithDefaults>
+  );
+}