create-zudo-doc 0.2.0 → 0.2.1

package/templates/features/versioning/files/pages/v/[version]/docs/[[...slug]].tsx

@@ -19,30 +19,20 @@
 //
 // Version banner: if version.banner is set ("unmaintained" | "unreleased"),
 // the DocLayoutWithDefaults version-banner prop drives the banner display.
+//
+// Enumeration + per-entry derived data are built by the shared, memoized
+// buildDocRouteEntries (#2010); rendering by the shared renderDocPage. This
+// file owns only the route's nav source, its versioned URL closure, and the
+// param/prop shapes.
 
 import { settings } from "@/config/settings";
 import type { VersionConfig } from "@/config/settings";
-import { t } from "@/config/i18n";
-import { docsUrl, versionedDocsUrl, absoluteUrl } from "@/utils/base";
-import {
-  buildNavTree,
-  buildBreadcrumbs,
-  collectAutoIndexNodes,
-  type NavNode,
-} from "@/utils/docs";
-import { getNavSectionForSlug, getNavSubtree } from "@/utils/nav-scope";
-import { toRouteSlug, toSlugParams } from "@/utils/slug";
-// Locale-aware MDX components factory — see `pages/_mdx-components.ts`.
-import { createMdxComponents } from "../../../_mdx-components";
+import { versionedDocsUrl } from "@/utils/base";
 import type { JSX } from "preact";
 import { resolveNavSource } from "../../../lib/_nav-source-docs";
-import { extractHeadings } from "../../../lib/_extract-headings";
-import type { DocPageEntry, AutoIndexNode, DocPageEntryProps, DocPageAutoIndexProps } from "../../../lib/doc-page-props";
-import { DocMetainfoArea } from "../../../lib/_doc-metainfo-area";
-import { buildInlineVersionSwitcher } from "../../../lib/_inline-version-switcher";
-import { DocContentHeader } from "../../../lib/_doc-content-header";
-import { DocPageShell } from "../../../lib/_doc-page-shell";
-import { resolveDocPrevNext, flattenSubtree, rewriteNavHref, remapNavChildHrefs } from "../../../lib/_doc-route-paths";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "../../../lib/doc-page-props";
+import { buildDocRouteEntries } from "../../../lib/_doc-route-entries";
+import { renderDocPage } from "../../../lib/_doc-page-renderer";
 
 export const frontmatter = { title: "Docs" };
 
@@ -50,8 +40,6 @@ export const frontmatter = { title: "Docs" };
 // Types
 // ---------------------------------------------------------------------------
 
-// DocPageEntry, AutoIndexNode imported from pages/lib/doc-page-props.ts
-
 /** Route-specific extra fields — present on both branches of the union. */
 interface VersionedDocPageExtra {
   /** The version config for the active version. */
@@ -89,73 +77,31 @@ export function paths(): Array<{
   for (const version of settings.versions) {
     // Identity-stable nav source for this version (EN base, draft-filtered,
     // unlisted retained). Reused across the route's per-page paths()
-    // invocations so buildNavTree's identity fast-path applies — see
-    // pages/lib/_nav-source-docs.ts (#1902).
-    const { docs: allDocs, navDocs, categoryMeta } = resolveNavSource("en", version.slug);
-    // Versioned docs always use EN locale for nav tree
-    const tree = buildNavTree(navDocs, "en", categoryMeta);
+    // invocations so buildNavTree's identity fast-path and the
+    // buildDocRouteEntries memo apply — see pages/lib/_nav-source-docs.ts
+    // (#1902). Versioned docs always use EN locale for the nav tree.
+    const source = resolveNavSource("en", version.slug);
 
     // URL closure for THIS version — every versioned href (prev/next,
     // breadcrumb crumbs, auto-index cards) is produced by this single
     // function bound to the version slug. Because it is built per-version
-    // inside this loop, a latest-page pagination override (resolved against
-    // `tree` below) is rewritten through the VERSIONED closure for this route
-    // only — it can never bleed into the latest route, which has no such
-    // closure (#1916).
+    // inside this loop, a latest-page pagination override is rewritten
+    // through the VERSIONED closure for this route only — it can never bleed
+    // into the latest route, which has no such closure (#1916).
     const urlFor = (s: string): string => versionedDocsUrl(s, version.slug);
 
-    // Regular doc pages
-    for (const entry of allDocs) {
-      // A `category_no_page` index.mdx is metadata-only — kept in the nav tree
-      // for breadcrumbs but emits no route (zfb retains every .mdx as a
-      // collection entry, so the skip must be explicit).
-      if (entry.data.category_no_page === true) continue;
-      const slug = entry.data.slug ?? toRouteSlug(entry.slug);
-      const navSection = getNavSectionForSlug(slug);
-      const subtree = getNavSubtree(tree, navSection);
-
-      // Prev/next + pagination overrides against THIS version's own `tree`,
-      // then hrefs rewritten to the versioned URL form via urlFor.
-      const { prev: prevNode, next: nextNode } = resolveDocPrevNext(
-        tree,
-        flattenSubtree(subtree),
-        slug,
-        entry.data,
-      );
-
-      result.push({
-        params: { version: version.slug, slug: toSlugParams(slug) },
-        props: {
-          kind: "entry",
-          entry,
-          version,
-          // #1916 #1: breadcrumb crumbs remapped to the versioned URL space.
-          breadcrumbs: buildBreadcrumbs(tree, slug, "en", urlFor),
-          prev: rewriteNavHref(prevNode, urlFor),
-          next: rewriteNavHref(nextNode, urlFor),
-          headings: extractHeadings(entry.body ?? ""),
-        },
-      });
-    }
-
-    // Auto-generated index pages for categories without index.mdx
-    for (const node of collectAutoIndexNodes(tree)) {
+    for (const item of buildDocRouteEntries({
+      source,
+      locale: "en",
+      routeSig: `v-docs;${version.slug}`,
+      urlFor,
+    })) {
       result.push({
-        params: { version: version.slug, slug: toSlugParams(node.slug) },
-        props: {
-          kind: "autoIndex",
-          autoIndex: {
-            ...node,
-            // #1916 #2: child-card hrefs ALWAYS resolve to the versioned URL.
-            children: remapNavChildHrefs(node.children, urlFor) as NavNode[],
-          } as AutoIndexNode,
-          version,
-          // #1916 #1: breadcrumb crumbs remapped to the versioned URL space.
-          breadcrumbs: buildBreadcrumbs(tree, node.slug, "en", urlFor),
-          prev: null,
-          next: null,
-          headings: [],
-        },
+        params: { version: version.slug, slug: item.slugParams },
+        props:
+          item.props.kind === "entry"
+            ? { ...item.props, version }
+            : { ...item.props, version },
       });
     }
   }
@@ -170,96 +116,8 @@ export function paths(): Array<{
 type PageArgs = DocPageProps & { params: { version: string; slug: string[] } };
 
 export default function VersionedDocsPage(props: PageArgs): JSX.Element {
-  const { breadcrumbs, prev, next, headings, version } = props;
-  const locale = "en";
-
-  const slug = props.kind === "autoIndex"
-    ? props.autoIndex.slug
-    : (props.entry.data.slug ?? toRouteSlug(props.entry.slug));
-
-  const title = props.kind === "autoIndex" ? props.autoIndex.label : props.entry.data.title;
-  const description = props.kind === "autoIndex" ? props.autoIndex.description : props.entry.data.description;
-
-  // Locale-aware components bag — creates nav wrappers bound to the active
-  // locale so CategoryNav/CategoryTreeNav/SiteTreeNav query the right collection.
-  const components = createMdxComponents(locale);
-
-  // #1916 #2: child cards already carry versioned hrefs from paths(); just
-  // filter to renderable nodes here.
-  const autoIndexChildren = props.kind === "autoIndex"
-    ? props.autoIndex.children.filter((c: NavNode) => c.hasPage || c.children.length > 0)
-    : [];
-
-  // Version banner: drives the `<VersionBanner>` element inside
-  // DocLayoutWithDefaults when `version.banner` is "unmaintained" or
-  // "unreleased". The banner links out to the latest version of the
-  // current page (slug-preserving — strips the /v/{version}/ prefix).
-  const versionBannerType = version.banner ? version.banner : undefined;
-  const versionBannerLatestUrl = versionBannerType
-    ? docsUrl(slug, locale)
-    : undefined;
-  const versionBannerLabels = versionBannerType
-    ? {
-        message:
-          versionBannerType === "unmaintained"
-            ? t("version.banner.unmaintained", locale)
-            : t("version.banner.unreleased", locale),
-        latestLink: t("version.banner.latestLink", locale),
-      }
-    : undefined;
-
-  // Canonical URL — versioned pages use the versioned URL as canonical.
-  const currentPath = versionedDocsUrl(slug, version.slug, locale);
-  const canonical = absoluteUrl(currentPath);
-
-  // Persist key: locale + nav-section so the sidebar DOM node is reused
-  // across same-locale + same-section navigations only. No sanitizer needed —
-  // both lang (BCP-47 locale string) and navSection (filesystem-derived
-  // kebab-case slug) come from controlled, trusted sources.
-  const navSection = getNavSectionForSlug(slug);
-  const hideSidebar = props.kind === "entry" ? props.entry.data.hide_sidebar : undefined;
-  const sidebarPersistKey = hideSidebar
-    ? undefined
-    : `sidebar-${locale}-${navSection ?? "default"}`;
-
-  return (
-    <DocPageShell
-      kind={props.kind}
-      locale={locale}
-      slug={slug}
-      title={title}
-      description={description}
-      canonical={canonical}
-      breadcrumbs={breadcrumbs}
-      prev={prev}
-      next={next}
-      headings={headings}
-      navSection={navSection}
-      sidebarPersistKey={sidebarPersistKey}
-      hideSidebar={hideSidebar}
-      hideToc={props.kind === "entry" ? props.entry.data.hide_toc : undefined}
-      currentPath={currentPath}
-      currentVersion={version.slug}
-      versionSwitcher={buildInlineVersionSwitcher(slug, locale, version.slug)}
-      versionBanner={versionBannerType}
-      versionBannerLatestUrl={versionBannerLatestUrl}
-      versionBannerLabels={versionBannerLabels}
-      autoIndexLabel={props.kind === "autoIndex" ? props.autoIndex.label : undefined}
-      autoIndexChildren={autoIndexChildren}
-      metainfoSlot={
-        props.kind === "autoIndex" ? <DocMetainfoArea slug={slug} locale={locale} /> : null
-      }
-      contentHeaderSlot={
-        props.kind === "entry" ? (
-          <DocContentHeader entry={props.entry} slug={slug} locale={locale} />
-        ) : undefined
-      }
-      contentSlot={
-        props.kind === "entry" ? <props.entry.Content components={components} /> : undefined
-      }
-      // #1916 #5: doc-history hidden on versioned pages until versioned
-      // history is supported.
-      docHistorySlot={null}
-    />
-  );
+  return renderDocPage(props, {
+    locale: "en",
+    version: props.version,
+  });
 }

package/templates/base/src/components/content/heading-h3.tsx

@@ -1,20 +0,0 @@
-import type { CSSProperties } from 'react';
-
-type Props = React.ComponentPropsWithoutRef<'h3'>;
-
-export function HeadingH3({ id, children, className, ...rest }: Props) {
-  return (
-    <h3
-      id={id}
-      className={`text-body font-bold leading-snug pt-vsp-xs border-t-[2px] border-transparent${className ? ` ${className}` : ''}`}
-      style={
-        {
-          borderImage: 'linear-gradient(to right, var(--color-muted), transparent) 1',
-        } as CSSProperties
-      }
-      {...rest}
-    >
-      {children}
-    </h3>
-  );
-}

package/templates/base/src/components/theme-toggle.tsx

@@ -1,107 +0,0 @@
-"use client";
-
-// Use preact hook entrypoints directly — the "react" → "preact/compat" alias
-// lets us consume React-typed components in this Preact app (configured
-// project-wide). Same pattern as packages/zudo-doc/src/theme/theme-toggle.tsx.
-import { useState, useEffect } from "preact/hooks";
-
-const STORAGE_KEY = "zudo-doc-theme";
-
-function SunIcon() {
-  return (
-    <svg
-      aria-hidden="true"
-      xmlns="http://www.w3.org/2000/svg"
-      width="20"
-      height="20"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth="2"
-      strokeLinecap="round"
-      strokeLinejoin="round"
-    >
-      <circle cx="12" cy="12" r="5" />
-      <line x1="12" y1="1" x2="12" y2="3" />
-      <line x1="12" y1="21" x2="12" y2="23" />
-      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64" />
-      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78" />
-      <line x1="1" y1="12" x2="3" y2="12" />
-      <line x1="21" y1="12" x2="23" y2="12" />
-      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36" />
-      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22" />
-    </svg>
-  );
-}
-
-function MoonIcon() {
-  return (
-    <svg
-      aria-hidden="true"
-      xmlns="http://www.w3.org/2000/svg"
-      width="20"
-      height="20"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth="2"
-      strokeLinecap="round"
-      strokeLinejoin="round"
-    >
-      <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z" />
-    </svg>
-  );
-}
-
-interface ThemeToggleProps {
-  defaultMode?: "light" | "dark";
-}
-
-export default function ThemeToggle({ defaultMode = "dark" }: ThemeToggleProps) {
-  // Initial state must match server render to avoid hydration mismatch.
-  // Actual theme is synced from DOM in useEffect below.
-  const [mode, setMode] = useState<"light" | "dark">(defaultMode);
-
-  useEffect(() => {
-    const actual =
-      (document.documentElement.getAttribute("data-theme") as
-        | "light"
-        | "dark") || defaultMode;
-    if (actual !== mode) {
-      setMode(actual);
-    }
-  }, []); // eslint-disable-line react-hooks/exhaustive-deps
-
-  function toggle() {
-    const next = mode === "dark" ? "light" : "dark";
-    setMode(next);
-    document.documentElement.setAttribute("data-theme", next);
-    document.documentElement.style.colorScheme = next;
-    localStorage.setItem(STORAGE_KEY, next);
-    // Clear both v1 and v2 tweak state so the new scheme's palette takes effect.
-    localStorage.removeItem("zudo-doc-tweak-state");
-    localStorage.removeItem("zudo-doc-tweak-state-v2");
-    window.dispatchEvent(new CustomEvent("color-scheme-changed"));
-  }
-
-  const nextMode = mode === "dark" ? "light" : "dark";
-
-  return (
-    <button
-      onClick={toggle}
-      aria-label={`Switch to ${nextMode} mode`}
-      className="text-muted hover:text-fg transition-colors p-hsp-sm focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2"
-    >
-      {mode === "dark" ? <SunIcon /> : <MoonIcon />}
-    </button>
-  );
-}
-// Pin the island marker name to "ThemeToggle" regardless of esbuild's
-// identifier deduplication. Both this host component and the v2 package's
-// ThemeToggleInner share the plain name "ThemeToggle"; when both land in the
-// same SSR bundle esbuild renames one to "ThemeToggle2", making
-// captureComponentName() emit "ThemeToggle2" — a name that has no entry in
-// the island manifest. Setting displayName explicitly ensures Island() reads
-// the attribute-level name (displayName is preferred over .name) and emits
-// the correct data-zfb-island="ThemeToggle" marker. zudolab/zudo-doc#1446.
-ThemeToggle.displayName = "ThemeToggle";

package/templates/base/src/hooks/use-active-heading.ts

@@ -1,133 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from "preact/compat";
-import type { Heading } from "@/types/heading";
-
-const SCROLL_MARGIN_TOP = 80;
-const DEBOUNCE_MS = 200;
-
-function getActiveHeadingId(
-  headingIds: string[],
-  elementMap: Map<string, HTMLElement>,
-): string | null {
-  if (headingIds.length === 0) return null;
-
-  const viewportHeight = window.innerHeight;
-
-  let firstVisibleIndex = -1;
-  for (let i = 0; i < headingIds.length; i++) {
-    const el = elementMap.get(headingIds[i]);
-    if (!el) continue;
-    const { top } = el.getBoundingClientRect();
-    if (top >= SCROLL_MARGIN_TOP) {
-      firstVisibleIndex = i;
-      break;
-    }
-  }
-
-  if (firstVisibleIndex === -1) {
-    return headingIds[headingIds.length - 1];
-  }
-
-  if (firstVisibleIndex === 0) {
-    const el = elementMap.get(headingIds[0]);
-    if (el) {
-      const { top } = el.getBoundingClientRect();
-      if (top < viewportHeight / 2) {
-        return headingIds[0];
-      }
-    }
-    return null;
-  }
-
-  const el = elementMap.get(headingIds[firstVisibleIndex]);
-  if (el) {
-    const { top } = el.getBoundingClientRect();
-    if (top < viewportHeight / 2) {
-      return headingIds[firstVisibleIndex];
-    }
-  }
-
-  return headingIds[firstVisibleIndex - 1];
-}
-
-interface UseActiveHeadingResult {
-  activeId: string | null;
-  activate: (id: string) => void;
-}
-
-export function useActiveHeading(
-  headings: Heading[],
-): UseActiveHeadingResult {
-  const [activeId, setActiveId] = useState<string | null>(null);
-  const headingIdsRef = useRef<string[]>([]);
-  const elementMapRef = useRef<Map<string, HTMLElement>>(new Map());
-  const suppressedRef = useRef(false);
-
-  const activate = useCallback((id: string) => {
-    setActiveId(id);
-    suppressedRef.current = true;
-    // Safety timeout: unsuppress if no scroll event fires (target already in view)
-    setTimeout(() => {
-      suppressedRef.current = false;
-    }, 2000);
-  }, []);
-
-  useEffect(() => {
-    const ids = headings.map((h) => h.slug);
-    headingIdsRef.current = ids;
-
-    const map = new Map<string, HTMLElement>();
-    for (const id of ids) {
-      const el = document.getElementById(id);
-      if (el) map.set(id, el);
-    }
-    elementMapRef.current = map;
-
-    let timerId: ReturnType<typeof setTimeout> | null = null;
-
-    function update() {
-      timerId = null;
-      setActiveId(
-        getActiveHeadingId(headingIdsRef.current, elementMapRef.current),
-      );
-    }
-
-    let fallbackTimerId: ReturnType<typeof setTimeout> | null = null;
-
-    function onScroll() {
-      if (suppressedRef.current) {
-        // Fallback for browsers without scrollend (Safari < 18)
-        if (fallbackTimerId !== null) clearTimeout(fallbackTimerId);
-        fallbackTimerId = setTimeout(onScrollEnd, 1500);
-        return;
-      }
-      if (timerId !== null) clearTimeout(timerId);
-      timerId = setTimeout(update, DEBOUNCE_MS);
-    }
-
-    function onScrollEnd() {
-      suppressedRef.current = false;
-      if (fallbackTimerId !== null) {
-        clearTimeout(fallbackTimerId);
-        fallbackTimerId = null;
-      }
-      if (timerId !== null) clearTimeout(timerId);
-      update();
-    }
-
-    update();
-
-    window.addEventListener("scroll", onScroll, { passive: true });
-    window.addEventListener("resize", onScroll, { passive: true });
-    window.addEventListener("scrollend", onScrollEnd, { passive: true });
-
-    return () => {
-      window.removeEventListener("scroll", onScroll);
-      window.removeEventListener("resize", onScroll);
-      window.removeEventListener("scrollend", onScrollEnd);
-      if (timerId !== null) clearTimeout(timerId);
-      if (fallbackTimerId !== null) clearTimeout(fallbackTimerId);
-    };
-  }, [headings]);
-
-  return { activeId, activate };
-}

package/templates/base/src/plugins/docs-source-map.ts

@@ -1,103 +0,0 @@
-import { readdirSync } from "node:fs";
-import { resolve } from "node:path";
-
-export interface DocsSourceMapOptions {
-  /** Absolute root directory of the project */
-  rootDir: string;
-  /** Main docs directory relative to rootDir (e.g., "src/content/docs") */
-  docsDir: string;
-  /** Locale configurations: { ja: { dir: "src/content/docs-ja" } } */
-  locales: Record<string, { dir: string }>;
-  /** Version configurations */
-  versions: Array<{ slug: string; docsDir: string }> | false;
-  /** Base URL path (e.g., "/" or "/pj/my-docs/") */
-  base: string;
-  /** Whether to append trailing slash to URLs */
-  trailingSlash: boolean;
-}
-
-/**
- * Build a map of absolute file paths to URL paths.
- * Scans all configured docs directories for .md/.mdx files.
- */
-export function buildDocsSourceMap(
-  options: DocsSourceMapOptions,
-): Map<string, string> {
-  const map = new Map<string, string>();
-  const { rootDir, docsDir, locales, versions, base, trailingSlash } = options;
-
-  const normalizedBase = base.replace(/\/+$/, "");
-
-  function applyTS(url: string): string {
-    if (trailingSlash) {
-      if (url.endsWith("/")) return url;
-      return url + "/";
-    }
-    // Strip trailing slashes when trailingSlash is false (except root "/")
-    if (url !== "/" && url.endsWith("/")) {
-      return url.replace(/\/+$/, "");
-    }
-    return url;
-  }
-
-  function withBase(path: string): string {
-    const raw =
-      normalizedBase === ""
-        ? path
-        : `${normalizedBase}${path.startsWith("/") ? path : `/${path}`}`;
-    return applyTS(raw);
-  }
-
-  function scanDir(dir: string, urlPrefix: string): void {
-    const absDir = resolve(rootDir, dir);
-    let files: string[];
-    try {
-      files = readdirSync(absDir, { recursive: true })
-        .map((f) => String(f))
-        .filter((f) => /\.(md|mdx)$/.test(f));
-    } catch {
-      // Directory doesn't exist — skip silently
-      return;
-    }
-    for (const file of files) {
-      const absFile = resolve(absDir, file);
-      // Convert file path to slug: strip extension, strip /index suffix
-      const slug = file
-        .replace(/\.(md|mdx)$/, "")
-        .replace(/(^|\/)index$/, "$1") // Strip index (root or nested)
-        .replace(/(^|\\)index$/, "$1") // Windows
-        .replace(/\\/g, "/") // Windows path sep
-        .replace(/\/$/, ""); // Trailing slash from index strip
-      const url = withBase(`${urlPrefix}/${slug}`);
-      map.set(absFile, url);
-
-      // Also register with alternative extension for cross-referencing
-      // e.g., if file is foo.mdx, also register foo.md → same URL
-      // Only set if not already registered (avoid shadowing a real file)
-      const altExt = file.endsWith(".mdx")
-        ? file.replace(/\.mdx$/, ".md")
-        : file.replace(/\.md$/, ".mdx");
-      const altFile = resolve(absDir, altExt);
-      if (!map.has(altFile)) {
-        map.set(altFile, url);
-      }
-    }
-  }
-
-  // Main docs (default locale)
-  scanDir(docsDir, "/docs");
-
-  // Locale docs
-  for (const [code, config] of Object.entries(locales)) {
-    scanDir(config.dir, `/${code}/docs`);
-  }
-
-  // Versioned docs
-  if (versions) {
-    for (const version of versions) {
-      scanDir(version.docsDir, `/v/${version.slug}/docs`);
-    }
-  }
-
-  return map;
-}

package/templates/base/src/plugins/hast-utils.ts

@@ -1,10 +0,0 @@
-import type { Element, ElementContent, Text } from "hast";
-
-/** Recursively extract plain text from a HAST node tree. */
-export function extractText(node: Element | ElementContent | Text): string {
-  if (node.type === "text") return node.value;
-  if (node.type === "element") {
-    return node.children.map((c) => extractText(c)).join("");
-  }
-  return "";
-}

package/templates/base/src/plugins/rehype-code-title.ts

@@ -1,50 +0,0 @@
-import type { Root, Element } from "hast";
-import { visit, SKIP } from "unist-util-visit";
-
-/**
- * Rehype plugin that extracts title="..." from code block meta strings
- * and wraps the <pre> in a container with a title header.
- *
- * Usage in MDX:
- *   ```js title="config.js"
- *   const x = 1;
- *   ```
- */
-export function rehypeCodeTitle() {
-  return (tree: Root) => {
-    visit(tree, "element", (node: Element, index, parent) => {
-      if (node.tagName !== "pre" || !parent || index === undefined) return;
-
-      const codeEl = node.children.find(
-        (child): child is Element =>
-          child.type === "element" && child.tagName === "code",
-      );
-      if (!codeEl) return;
-
-      const meta =
-        String(codeEl.properties?.meta ?? "") ||
-        String((codeEl.data as Record<string, unknown> | undefined)?.meta ?? "");
-      const titleMatch = meta.match(/title="([^"]+)"/);
-      if (!titleMatch) return;
-
-      const title = titleMatch[1];
-
-      const titleEl: Element = {
-        type: "element",
-        tagName: "div",
-        properties: { className: ["code-block-title"] },
-        children: [{ type: "text", value: title }],
-      };
-
-      const wrapper: Element = {
-        type: "element",
-        tagName: "div",
-        properties: { className: ["code-block-container"] },
-        children: [titleEl, { ...node }],
-      };
-
-      (parent as Element).children[index] = wrapper;
-      return SKIP;
-    });
-  };
-}