create-zudo-doc 1.3.0 → 2.0.0

package/templates/base/src/components/tree-nav-shared.tsx

@@ -1,71 +0,0 @@
-// Shared constants and primitives for sidebar-tree and site-tree-nav
-
-// Indentation — fluid clamp values
-export const INDENT = "clamp(0.8rem, 1.2vw, 1.625rem)";
-export const CONNECTOR_OFFSET = "clamp(0.2rem, 0.3vw, 0.5rem)";
-export const CONNECTOR_WIDTH = "clamp(0.4rem, 0.6vw, 1rem)";
-export const BASE_PAD = "clamp(0.4rem, 0.8vw, 1.3rem)";
-
-export function connectorLeft(depth: number): string {
-  return `calc(${depth} * ${INDENT} + ${CONNECTOR_OFFSET})`;
-}
-
-const CATEGORY_LINK_PATH =
-  "M5.746 5.74 0 11.49l20.987 20.96C34.126 45.572 41.963 53.45 41.948 53.523c-.012.062-9.456 9.544-20.986 21.07L0 95.55l5.714 5.715c3.142 3.143 5.748 5.715 5.79 5.715s2.63-2.563 5.75-5.696l17.939-18.001c21.867-21.94 29.443-29.599 29.443-29.768 0-.114-.665-.804-5.084-5.275C51.872 40.47 11.71.125 11.565.036 11.525.01 8.906 2.578 5.746 5.74m38.345-.066c-3.132 3.13-5.696 5.71-5.696 5.732-.001.022 2.16 2.185 4.8 4.807 2.641 2.623 8.382 8.338 12.758 12.702 15.38 15.337 23.763 23.641 24.314 24.086.19.153.346.336.346.405 0 .07-1.738 1.847-3.887 3.976a17515 17515 0 0 0-20.35 20.264 19555 19555 0 0 1-17.223 17.158c-.416.409-.757.77-.757.8 0 .083 11.415 11.485 11.457 11.445.235-.22 53.542-53.528 53.542-53.543C103.395 53.472 49.891.02 49.837 0c-.028-.01-2.613 2.543-5.746 5.674";
-
-export function CategoryLinkIcon({ className }: { className?: string }) {
-  return (
-    <svg
-      xmlns="http://www.w3.org/2000/svg"
-      fill="currentColor"
-      viewBox="0 0 103.395 107.049"
-      aria-hidden="true"
-      className={`shrink-0 ${className ?? ""}`}
-    >
-      <path d={CATEGORY_LINK_PATH} />
-    </svg>
-  );
-}
-
-export function ConnectorLines({
-  depth,
-  isLast,
-  widthScale = 1,
-  topPad = "0px",
-}: {
-  depth: number;
-  isLast: boolean;
-  widthScale?: number;
-  /**
-   * Padding-top of the inner content row that holds the link text. The horizontal
-   * connector and (when `isLast`) the vertical clip both anchor to the first-line
-   * midpoint computed as `topPad + 0.5lh`, so multi-line labels keep the connector
-   * aligned with the first line instead of the row's vertical center.
-   */
-  topPad?: string;
-}) {
-  if (depth === 0) return null;
-  const left = connectorLeft(depth);
-  const width = widthScale === 1 ? CONNECTOR_WIDTH : `calc(${CONNECTOR_WIDTH} * ${widthScale})`;
-  const firstLineMid = `calc(${topPad} + 0.5lh)`;
-  return (
-    <>
-      <div
-        className="absolute border-l border-dashed border-muted"
-        style={{
-          left,
-          top: 0,
-          bottom: isLast ? `calc(100% - ${firstLineMid})` : 0,
-        }}
-      />
-      <div
-        className="absolute border-t border-dashed border-muted"
-        style={{
-          left,
-          width,
-          top: firstLineMid,
-        }}
-      />
-    </>
-  );
-}

package/templates/base/src/utils/content-files.ts

@@ -1,110 +0,0 @@
-import { readFileSync, readdirSync } from "node:fs";
-import { join, relative } from "node:path";
-import matter from "gray-matter";
-import { settings } from "../config/settings";
-
-/** Strip markdown formatting to produce plain text */
-export function stripMarkdown(md: string): string {
-  return (
-    md
-      // Remove code blocks
-      .replace(/```[\s\S]*?```/g, "")
-      .replace(/`[^`]+`/g, "")
-      // Remove HTML tags
-      .replace(/<[^>]+>/g, "")
-      // Remove headings markers
-      .replace(/^#{1,6}\s+/gm, "")
-      // Remove emphasis/bold markers
-      .replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1")
-      .replace(/_{1,3}([^_]+)_{1,3}/g, "$1")
-      // Remove images (must run before link removal)
-      .replace(/!\[[^\]]*\]\([^)]+\)/g, "")
-      // Remove links but keep text
-      .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
-      // Remove blockquote markers
-      .replace(/^>\s+/gm, "")
-      // Remove horizontal rules
-      .replace(/^[-*_]{3,}\s*$/gm, "")
-      // Remove list markers
-      .replace(/^[\s]*[-*+]\s+/gm, "")
-      .replace(/^[\s]*\d+\.\s+/gm, "")
-      // Remove import statements
-      .replace(/^import\s+.*$/gm, "")
-      // Remove export statements
-      .replace(/^export\s+.*$/gm, "")
-      // Collapse whitespace
-      .replace(/\n{3,}/g, "\n\n")
-      .trim()
-  );
-}
-
-/** Walk a directory and collect all .md/.mdx files */
-export function collectMdFiles(
-  dir: string,
-): Array<{ filePath: string; slug: string }> {
-  const results: Array<{ filePath: string; slug: string }> = [];
-
-  function walk(currentDir: string, baseDir: string): void {
-    let entries;
-    try {
-      entries = readdirSync(currentDir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      const fullPath = join(currentDir, entry.name);
-      if (entry.isDirectory()) {
-        // Skip `_`-prefixed dirs to match the Content Collections convention
-        // (and zfb's routing): docs under them are not built as pages, so
-        // indexing them would yield search results whose links 404.
-        if (entry.name.startsWith("_")) continue;
-        walk(fullPath, baseDir);
-      } else if (/\.mdx?$/.test(entry.name) && !entry.name.startsWith("_")) {
-        const rel = relative(baseDir, fullPath)
-          .replace(/\.mdx?$/, "")
-          .replace(/\/index$/, "");
-        results.push({ filePath: fullPath, slug: rel });
-      }
-    }
-  }
-
-  walk(dir, dir);
-  return results;
-}
-
-/** Compute a URL from a slug and locale. When absolute is true and siteUrl is configured, returns a full URL. */
-export function slugToUrl(slug: string, locale: string | null, absolute = false): string {
-  const base = settings.base.replace(/\/$/, "");
-  const path = locale ? `${base}/${locale}/docs/${slug}` : `${base}/docs/${slug}`;
-  if (absolute && settings.siteUrl) {
-    return `${settings.siteUrl.replace(/\/$/, "")}${path}`;
-  }
-  return path;
-}
-
-/** Frontmatter fields used across the project */
-export interface DocFrontmatter {
-  title?: string;
-  description?: string;
-  sidebar_position?: number;
-  category?: string;
-  draft?: boolean;
-  unlisted?: boolean;
-  search_exclude?: boolean;
-  [key: string]: unknown;
-}
-
-/** Parse a markdown file and return frontmatter + content */
-export function parseMarkdownFile(filePath: string): { data: DocFrontmatter; content: string } | null {
-  try {
-    const raw = readFileSync(filePath, "utf-8");
-    return matter(raw);
-  } catch {
-    return null;
-  }
-}
-
-/** Check if a document should be excluded from indexing */
-export function isExcluded(data: DocFrontmatter): boolean {
-  return !!(data.search_exclude || data.draft || data.unlisted);
-}

package/templates/features/docTags/files/pages/lib/_tag-pages.tsx

@@ -1,47 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Thin stub — tag-pages moved to the package (epic #2344, S8).
-// Calls `createTagPages(deps)` from @takazudo/zudo-doc/tag-pages with host
-// singletons injected, then re-exports the resulting functions so all existing
-// call sites continue to work unchanged.
-
-import { createTagPages } from "@takazudo/zudo-doc/tag-pages";
-import type { TagInfo } from "@takazudo/zudo-doc/tag-pages";
-import { collectTags } from "@/utils/tags";
-import { defaultLocale, t } from "@/config/i18n";
-import { settings } from "@/config/settings";
-import { withBase, docsUrl } from "@/utils/base";
-import { isDefaultLocaleOnlyPath } from "@/utils/base";
-import { FooterWithDefaults } from "./_footer-with-defaults";
-import { HeaderWithDefaults } from "./_header-with-defaults";
-import { HeadWithDefaults } from "./_head-with-defaults";
-import { composeMetaTitle } from "./_compose-meta-title";
-import { DocHistoryArea } from "./_doc-history-area";
-import { BodyEndIslands } from "./_body-end-islands";
-import { stableDocs } from "./_nav-source-cache";
-
-export type { TagInfo };
-
-const { collectTagMapForLocale, TagDetailPageView, TagsIndexPageView } = createTagPages({
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  docsUrl,
-  composeMetaTitle,
-  collectTags: collectTags as (
-    entries: import("@takazudo/zudo-doc/tag-pages").TagPagesDocsEntry[],
-    slugFn: (id: string, data: { slug?: string }) => string,
-  ) => Map<string, TagInfo>,
-  stableDocs: stableDocs as (collectionName: string) => import("@takazudo/zudo-doc/tag-pages").TagPagesDocsEntry[],
-  isDefaultLocaleOnlyPath,
-  components: {
-    HeadWithDefaults,
-    HeaderWithDefaults,
-    FooterWithDefaults,
-    BodyEndIslands,
-    DocHistoryArea,
-  },
-});
-
-export { collectTagMapForLocale, TagDetailPageView, TagsIndexPageView };

package/templates/features/versioning/files/pages/lib/_versions-page.tsx

@@ -1,33 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Thin stub — versions-page moved to the package (epic #2344, S8).
-// Calls `createVersionsPageView(deps)` from
-// @takazudo/zudo-doc/versions-page with host singletons injected,
-// then re-exports the resulting component so all existing call sites continue
-// to work unchanged.
-
-import { createVersionsPageView } from "@takazudo/zudo-doc/versions-page";
-import { settings } from "@/config/settings";
-import { defaultLocale, t } from "@/config/i18n";
-import { withBase } from "@/utils/base";
-import { FooterWithDefaults } from "./_footer-with-defaults";
-import { HeaderWithDefaults } from "./_header-with-defaults";
-import { HeadWithDefaults } from "./_head-with-defaults";
-import { composeMetaTitle } from "./_compose-meta-title";
-import { BodyEndIslands } from "./_body-end-islands";
-
-export { type VersionsPageViewProps } from "@takazudo/zudo-doc/versions-page";
-
-export const VersionsPageView = createVersionsPageView({
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  composeMetaTitle,
-  components: {
-    HeadWithDefaults,
-    HeaderWithDefaults,
-    FooterWithDefaults,
-    BodyEndIslands,
-  },
-});