@takazudo/zudo-doc 1.3.0 → 2.0.0

package/dist/routes/_chrome.js

@@ -1,393 +1,21 @@
-import { Fragment, jsx } from "preact/jsx-runtime";
-import {
-  settings,
-  defaultLocale,
-  locales,
-  t,
-  withBase,
-  stripBase,
-  docsUrl,
-  versionedDocsUrl,
-  absoluteUrl,
-  navHref,
-  buildLocaleLinks,
-  getNavSectionForSlug,
-  getCategoryOrder,
-  toRouteSlug,
-  resolveNavSource,
-  loadNavSourceDocs,
-  buildNavTree,
-  groupSatelliteNodes,
-  collectAutoIndexNodes,
-  findNode,
-  firstRoutedHref,
-  collectTags,
-  stableDocs,
-  colorSchemes
-} from "./_context.js";
-import { createComposeMetaTitle } from "../compose-meta-title/index.js";
-import {
-  generateCssCustomProperties,
-  generateLightDarkCssProperties
-} from "../color-scheme-utils.js";
-import { createHeadWithDefaults } from "../head-with-defaults/index.js";
-import { createHeaderWithDefaults } from "../header-with-defaults/index.js";
-import { createFooterWithDefaults } from "../footer-with-defaults/index.js";
-import { createSidebarWithDefaults } from "../sidebar-with-defaults/index.js";
-import { createSidebarPrepaint } from "../sidebar-prepaint/index.js";
-import { createDocBodyEnd } from "../doc-body-end/index.js";
-import { createBodyEndIslands } from "../doc-body-end-islands/index.js";
-import { createDocPager } from "../doc-pager/index.js";
-import { createDocPageShell } from "../doc-page-shell/index.js";
-import { createDocContentHeader } from "../doc-content-header/index.js";
-import { createDocMetainfoArea } from "../doc-metainfo-area/index.js";
-import { createDocTagsArea } from "../doc-tags-area/index.js";
-import { createDocHistoryArea } from "../doc-history-area/index.js";
-import { createInlineVersionSwitcher } from "../inline-version-switcher/index.js";
-import { createRenderDocPage } from "../doc-page-renderer/index.js";
-import { createVersionsPageView } from "../versions-page/index.js";
-import { createTagPages } from "../tag-pages/index.js";
-import { createMdxComponents } from "../mdx-components/index.js";
-import { createCategoryNavWrapper } from "../category-nav/index.js";
-import { createCategoryTreeNavWrapper } from "../category-tree-nav/index.js";
-import { createSiteTreeNavWrapper } from "../site-tree-nav/index.js";
-import { getTocTitle } from "../toc/index.js";
-import { SearchWidget } from "../search-widget/index.js";
-import { buildGitHubRepoUrl, buildGitHubSourceUrl } from "../github-helpers/index.js";
-import { toHistorySlug } from "../slug/index.js";
-import {
-  buildRootMenuItems as buildRootMenuItemsBase,
-  buildLocaleLinksForNav as buildLocaleLinksForNavBase,
-  remapVersionedHrefs,
-  getThemeDefaultMode as getThemeDefaultModeBase
-} from "../nav-data-prep/index.js";
-import { buildSidebarForSection } from "../sidebar-utils/index.js";
-import { Details } from "../details/index.js";
-import {
-  HtmlPreviewWrapper
-} from "../html-preview-wrapper/index.js";
-const GREY_RAMP = [
-  "#000000",
-  "#1a1a1a",
-  "#333333",
-  "#4d4d4d",
-  "#666666",
-  "#808080",
-  "#999999",
-  "#b3b3b3",
-  "#cccccc",
-  "#d9d9d9",
-  "#e6e6e6",
-  "#f2f2f2",
-  "#ff5555",
-  "#50fa7b",
-  "#f1fa8c",
-  "#8be9fd"
-];
-const DEFAULT_SCHEME = {
-  background: "#000000",
-  foreground: "#ffffff",
-  cursor: "#ffffff",
-  selectionBg: "#444444",
-  selectionFg: "#ffffff",
-  palette: GREY_RAMP
-};
-const docHistoryMeta = {};
-const sidebarsConfig = {};
-const BodyEndIslands = createBodyEndIslands({ settings });
-function DocHistoryStub(_props) {
-  return /* @__PURE__ */ jsx(Fragment, {});
-}
-function SearchWidgetBound(props) {
-  return SearchWidget({ ...props, base: withBase("/") });
-}
-const composeMetaTitle = createComposeMetaTitle(settings.siteName);
-function resolveHostScheme(key) {
-  if (!colorSchemes) return DEFAULT_SCHEME;
-  return colorSchemes[key] ?? DEFAULT_SCHEME;
-}
-const HeadWithDefaults = createHeadWithDefaults({
-  settings,
-  composeMetaTitle,
-  withBase,
-  absoluteUrl,
-  // Called only in single-scheme mode (colorMode false): resolve via settings.colorScheme.
-  generateCssCustomProperties: () => generateCssCustomProperties(resolveHostScheme(settings.colorScheme)),
-  // Called only in light/dark mode (colorMode truthy): resolve the pair.
-  generateLightDarkCssProperties: () => {
-    const cm = settings.colorMode;
-    if (cm) {
-      return generateLightDarkCssProperties(
-        resolveHostScheme(cm.lightScheme),
-        resolveHostScheme(cm.darkScheme)
-      );
-    }
-    return generateLightDarkCssProperties(DEFAULT_SCHEME, DEFAULT_SCHEME);
-  }
-});
-function buildRootMenuItems(lang, currentVersion) {
-  return buildRootMenuItemsBase(
-    lang,
-    currentVersion,
-    settings.headerNav,
-    (key, l) => t(key, l),
-    (path, l, v) => navHref(path, l, v)
-  );
-}
-function buildLocaleLinksForNav(currentPath, lang, localeCount) {
-  return buildLocaleLinksForNavBase(
-    currentPath,
-    lang,
-    localeCount,
-    (path, l) => buildLocaleLinks(path, l)
-  );
-}
-function buildSidebarNodes(lang, navSection, currentVersion, emptyWhenUnsectioned = true) {
-  if (navSection === void 0 && emptyWhenUnsectioned) return [];
-  const { navDocs, categoryMeta } = loadNavSourceDocs(lang, currentVersion);
-  const explicitPrefixes = getCategoryOrder().filter((cm) => cm !== "!");
-  const rawNodes = buildSidebarForSection(
-    navDocs,
-    lang,
-    navSection,
-    categoryMeta,
-    sidebarsConfig,
-    (d, l, meta) => buildNavTree(
-      d,
-      l,
-      meta,
-      (slug, loc) => docsUrl(slug, loc)
-    ),
-    explicitPrefixes
-  );
-  return currentVersion ? remapVersionedHrefs(
-    rawNodes,
-    currentVersion,
-    lang,
-    (slug, v, l) => versionedDocsUrl(slug, v, l)
-  ) : rawNodes;
-}
-function getThemeDefaultMode() {
-  return getThemeDefaultModeBase(settings.colorMode);
-}
-const HeaderWithDefaults = createHeaderWithDefaults({
-  settings,
-  defaultLocale,
-  locales,
-  t,
-  withBase,
-  stripBase,
-  docsUrl,
-  navHref,
-  versionedDocsUrl,
-  buildLocaleLinksForNav,
-  buildRootMenuItems,
-  buildSidebarNodes,
-  getThemeDefaultMode,
-  buildGitHubRepoUrl: () => buildGitHubRepoUrl(settings.githubUrl),
-  SearchWidget: SearchWidgetBound
-});
-const FooterWithDefaults = createFooterWithDefaults({
-  settings,
-  defaultLocale,
-  tagVocabulary: [],
-  isExternal: (href) => /^https?:\/\//.test(href),
-  resolveHref: (href) => /^https?:\/\//.test(href) ? href : withBase(href),
-  withBase,
-  // The footer taglist is host-bound (project tag aggregation); package default
-  // renders no tag columns.
-  loadTagsForLocale: () => []
-});
-const SidebarWithDefaults = createSidebarWithDefaults({
-  defaultLocale,
-  localeCount: locales.length,
-  buildRootMenuItems,
-  buildLocaleLinksForNav,
-  buildSidebarNodes,
-  getThemeDefaultMode,
-  t
-});
-const SidebarPrepaint = createSidebarPrepaint({ sidebarToggle: settings.sidebarToggle });
-const DocBodyEnd = createDocBodyEnd({ settings, BodyEndIslands });
-const DocPager = createDocPager({ t });
-const DocMetainfoArea = createDocMetainfoArea({
-  settings,
-  defaultLocale,
-  docHistoryMeta,
-  t,
-  toHistorySlug
-});
-const DocTagsArea = createDocTagsArea({
-  settings,
-  defaultLocale,
-  tagVocabularyEntries: [],
-  tagHref: (tag, locale) => {
-    const encoded = encodeURIComponent(tag);
-    return withBase(
-      locale === defaultLocale ? `/docs/tags/${encoded}` : `/${locale}/docs/tags/${encoded}`
-    );
-  },
-  t
-});
-const DocContentHeader = createDocContentHeader({
-  t,
-  buildFrontmatterPreviewEntries: () => [],
-  frontmatterRenderers: {},
-  DocMetainfoArea,
-  DocTagsArea
-});
-const DocHistoryArea = createDocHistoryArea({
-  settings,
-  defaultLocale,
-  docHistoryMeta,
-  t,
-  toHistorySlug,
-  buildGitHubSourceUrl: (contentDir, entryId) => buildGitHubSourceUrl(settings.githubUrl, contentDir, entryId),
-  DocHistory: DocHistoryStub
-});
-const buildInlineVersionSwitcher = createInlineVersionSwitcher({
-  settings,
-  defaultLocale,
-  t,
-  docsUrl,
-  versionedDocsUrl,
-  withBase
-});
-const CategoryNavWrapper = createCategoryNavWrapper({
-  defaultLocale,
-  resolveNavSource,
-  buildNavTree: ((docs, locale, categoryMeta) => buildNavTree(
-    docs,
-    locale,
-    categoryMeta,
-    (slug, loc) => docsUrl(slug, loc)
-  )),
-  findNode,
-  firstRoutedHref
-});
-const CategoryTreeNavWrapper = createCategoryTreeNavWrapper({
-  defaultLocale,
-  resolveNavSource,
-  buildNavTree: ((docs, locale, categoryMeta) => buildNavTree(
-    docs,
-    locale,
-    categoryMeta,
-    (slug, loc) => docsUrl(slug, loc)
-  )),
-  groupSatelliteNodes,
-  findNode
-});
-const SiteTreeNavWrapper = createSiteTreeNavWrapper({
-  defaultLocale,
-  resolveNavSource,
-  buildNavTree: ((docs, locale, categoryMeta) => buildNavTree(
-    docs,
-    locale,
-    categoryMeta,
-    (slug, loc) => docsUrl(slug, loc)
-  )),
-  groupSatelliteNodes,
-  getCategoryOrder
-});
-function HtmlPreviewBound(props) {
-  return HtmlPreviewWrapper({
-    globalConfig: settings.htmlPreview ?? null,
-    ...props
-  });
-}
-function IslandPassthrough(props) {
-  return props.children ?? null;
-}
-function createMdxComponentsBound(lang = defaultLocale) {
-  return createMdxComponents({
-    settings,
-    locale: lang,
-    navData: {
-      CategoryNav: CategoryNavWrapper,
-      CategoryTreeNav: CategoryTreeNavWrapper,
-      SiteTreeNav: SiteTreeNavWrapper
-    },
-    // Package-owned content components wired here so an INJECTED docs route
-    // (packageOwnedRoutes, no host `pages/` stub) renders MDX using these tags
-    // without the "MDX requires '<X>' to be passed via the 'components' prop"
-    // error (sub-issue #2390 / supersedes #2377).
-    //   - Details      → fully functional (pure <details>, no client JS).
-    //   - HtmlPreview  → SSR-renders; see HtmlPreviewBound for the hydration
-    //                    caveat tied to the node_modules islands-scanner gap.
-    //   - Island       → SSR pass-through; see IslandPassthrough.
-    // PresetGenerator stays a package stub (render nothing): it is the
-    // showcase's project-bound interactive island and downstream projects stub
-    // it. The showcase keeps its host-owned docs catch-all routes (allowlisted)
-    // so its real PresetGenerator still renders.
-    extras: {
-      Details,
-      HtmlPreview: HtmlPreviewBound,
-      Island: IslandPassthrough,
-      PresetGenerator: (_props) => null
-    }
-  });
-}
-const DocPageShell = createDocPageShell({
-  settings,
+import { routeCtx } from "./_context.js";
+import { createChrome } from "../chrome/index.js";
+const chrome = createChrome(routeCtx);
+const {
   composeMetaTitle,
-  getTocTitle,
   HeadWithDefaults,
-  SidebarWithDefaults,
   HeaderWithDefaults,
   FooterWithDefaults,
-  SidebarPrepaint,
-  DocBodyEnd,
-  DocPager
-});
-const renderDocPage = createRenderDocPage({
-  docsUrl,
-  versionedDocsUrl,
-  absoluteUrl,
-  getNavSectionForSlug,
-  toRouteSlug,
-  createMdxComponents: createMdxComponentsBound,
-  t,
-  buildInlineVersionSwitcher,
-  DocPageShell,
-  DocContentHeader,
-  DocMetainfoArea,
-  DocHistoryArea
-});
-const VersionsPageView = createVersionsPageView({
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  composeMetaTitle,
-  components: {
-    HeadWithDefaults,
-    HeaderWithDefaults,
-    FooterWithDefaults,
-    BodyEndIslands
-  }
-});
-const tagPages = createTagPages({
-  settings,
-  defaultLocale,
-  t,
-  withBase,
-  docsUrl,
-  composeMetaTitle,
-  collectTags,
-  stableDocs,
-  isDefaultLocaleOnlyPath: void 0,
-  components: {
-    HeadWithDefaults,
-    HeaderWithDefaults,
-    FooterWithDefaults,
-    BodyEndIslands,
-    DocHistoryArea
-  }
-});
-const { collectTagMapForLocale, TagDetailPageView, TagsIndexPageView } = tagPages;
-import {
-  buildDocRouteEntries
-} from "./_context.js";
+  SidebarWithDefaults,
+  renderDocPage,
+  VersionsPageView,
+  collectTagMapForLocale,
+  TagDetailPageView,
+  TagsIndexPageView,
+  SiteTreeNavWrapper,
+  BodyEndIslands
+} = chrome;
+import { buildDocRouteEntries } from "./_context.js";
 export {
   BodyEndIslands,
   FooterWithDefaults,
@@ -401,6 +29,5 @@ export {
   buildDocRouteEntries,
   collectTagMapForLocale,
   composeMetaTitle,
-  createMdxComponentsBound,
   renderDocPage
 };

package/dist/routes/_context.d.ts

@@ -1,50 +1,19 @@
 import type { Settings } from "../settings.js";
 import type { ColorScheme } from "../color-scheme-utils.js";
-import type { FactoryI18n } from "../factory-context/index.js";
-import { type UrlHelpers } from "../url-helpers/index.js";
-import { toRouteSlug, toSlugParams } from "../slug/index.js";
-import { type TagVocabularyEntry } from "../tag-helpers/index.js";
-import type { DocNavNode } from "../doc-page-props/index.js";
-import type { HeadingItem } from "../extract-headings/index.js";
-import { stableDocs, isNavVisible, buildNavTree, collectAutoIndexNodes, groupSatelliteNodes, findNode, firstRoutedHref } from "./_docs-helpers.js";
-export interface RouteContextPayload {
-    settings: Settings;
-    translations: Record<string, Record<string, string>>;
-    tagVocabulary: readonly TagVocabularyEntry[];
-    colorSchemes: Record<string, ColorScheme> | null;
-}
-/** The serializable route-context (from the virtual module). */
+import { type RouteContextPayload } from "../route-context/index.js";
+export type { RouteContextPayload, TagInfo } from "../route-context/index.js";
+/** The serializable route-context payload (from the virtual module). */
 export declare const ctx: RouteContextPayload;
+declare const routeCtx: import("../factory-context/index.js").RouteContext<Settings>;
+export { routeCtx };
 export declare const settings: Settings;
 /** Host color-scheme palette map. `null` when not supplied — `_chrome.tsx`
  *  falls back to `DEFAULT_SCHEME` in that case. */
 export declare const colorSchemes: Record<string, ColorScheme> | null;
-export declare const defaultLocale: string;
-export declare const locales: readonly string[];
-export declare function getLocaleConfig(locale: string): {
+export declare const i18n: import("../factory-context/index.js").FactoryI18n, defaultLocale: string, locales: readonly string[], getLocaleConfig: (locale: string) => {
     label: string;
     dir: string;
-} | undefined;
-export declare function getLocaleLabel(locale: string): string;
-export declare function t(key: string, locale?: string): string;
-export declare const i18n: FactoryI18n;
-export declare const urlHelpers: UrlHelpers;
-export declare const withBase: (path: string) => string, stripBase: (path: string) => string, docsUrl: (slug: string, lang?: string) => string, versionedDocsUrl: (slug: string, versionSlug: string, lang?: string) => string, navHref: (path: string, lang: string | undefined, currentVersion: string | undefined) => string, isDefaultLocaleOnlyPath: (path: string) => boolean, absoluteUrl: (pageUrl: string) => string | undefined, isExternal: (href: string) => boolean, resolveHref: (href: string) => string, buildLocaleLinks: (currentPath: string, currentLang: string) => import("../url-helpers/index.js").LocaleLink[];
-export declare function getCategoryOrder(): string[];
-export declare function getNavSectionForSlug(slug: string): string | undefined;
-export declare function getNavSubtree(tree: DocNavNode[], categoryMatch?: string): DocNavNode[];
-export declare function extractHeadings(body: string): HeadingItem[];
-export interface TagInfo {
-    tag: string;
-    count: number;
-    docs: {
-        slug: string;
-        title: string;
-        description?: string;
-    }[];
-}
-export declare function resolveTagBound(raw: string): import("../tag-helpers/index.js").ResolvedTag;
-export declare function collectTags(entries: ReadonlyArray<{
+} | undefined, getLocaleLabel: (locale: string) => string, t: (key: string, locale?: string) => string, urlHelpers: import("../url-helpers/index.js").UrlHelpers, withBase: (path: string) => string, stripBase: (path: string) => string, docsUrl: (slug: string, lang?: string) => string, versionedDocsUrl: (slug: string, versionSlug: string, lang?: string) => string, navHref: (path: string, lang: string | undefined, currentVersion: string | undefined) => string, isDefaultLocaleOnlyPath: (path: string) => boolean, absoluteUrl: (pageUrl: string) => string | undefined, isExternal: (href: string) => boolean, resolveHref: (href: string) => string, buildLocaleLinks: (currentPath: string, currentLang: string) => import("../url-helpers/index.js").LocaleLink[], getCategoryOrder: () => string[], getNavSectionForSlug: (slug: string) => string | undefined, getNavSubtree: (tree: import("./_docs-helpers.js").DocNavNode[], categoryMatch?: string) => import("./_docs-helpers.js").DocNavNode[], extractHeadings: (body: string) => import("../extract-headings/index.js").HeadingItem[], resolveTagBound: (raw: string) => import("../tag-helpers/index.js").ResolvedTag, collectTags: (entries: ReadonlyArray<{
     id: string;
     data: {
         slug?: string;
@@ -54,8 +23,6 @@ export declare function collectTags(entries: ReadonlyArray<{
     };
 }>, slugFn: (id: string, data: {
     slug?: string;
-}) => string): Map<string, TagInfo>;
-export declare const resolveNavSource: (lang: string, currentVersion: string | undefined, options?: import("../nav-source-docs/index.js").NavSourceOptions) => import("../nav-source-docs/index.js").NavSourceDocs, resolveVersionedLocaleSource: (versionSlug: string, versionDocsDir: string | undefined, lang: string, localeDir: string | undefined, options?: import("../nav-source-docs/index.js").NavSourceOptions) => import("../nav-source-docs/index.js").NavSourceDocs, loadNavSourceDocs: (lang: string, currentVersion: string | undefined) => import("../nav-source-docs/index.js").NavSourceDocs;
-export declare const buildDocRouteEntries: (args: import("../doc-route-entries/index.js").BuildDocRouteEntriesArgs) => import("../doc-route-entries/index.js").DocRouteEntry[];
-export declare const enumerateDocsRoutes: (locale: string) => string[], enumerateTagsRoutes: (locale: string) => string[], enumerateVersionedRoutes: (version: import("../route-enumerators/index.js").VersionConfigForEnum, locale: string) => string[], enumerateAllRoutes: () => Map<string, string>;
-export { buildNavTree, groupSatelliteNodes, findNode, firstRoutedHref, collectAutoIndexNodes, isNavVisible, stableDocs, toRouteSlug, toSlugParams, };
+}) => string) => Map<string, import("./_context.js").TagInfo>, resolveNavSource: (lang: string, currentVersion: string | undefined, options?: import("../nav-source-docs/index.js").NavSourceOptions) => import("../nav-source-docs/index.js").NavSourceDocs, resolveVersionedLocaleSource: (versionSlug: string, versionDocsDir: string | undefined, lang: string, localeDir: string | undefined, options?: import("../nav-source-docs/index.js").NavSourceOptions) => import("../nav-source-docs/index.js").NavSourceDocs, loadNavSourceDocs: (lang: string, currentVersion: string | undefined) => import("../nav-source-docs/index.js").NavSourceDocs, buildDocRouteEntries: (args: import("../doc-route-entries/index.js").BuildDocRouteEntriesArgs) => import("../doc-route-entries/index.js").DocRouteEntry[], enumerateDocsRoutes: (locale: string) => string[], enumerateTagsRoutes: (locale: string) => string[], enumerateVersionedRoutes: (version: import("../route-enumerators/index.js").VersionConfigForEnum, locale: string) => string[], enumerateAllRoutes: () => Map<string, string>, buildNavTree: (docs: import("./_docs-helpers.js").DocPageEntry[], locale: string, categoryMeta: Map<string, import("./_docs-helpers.js").CategoryMeta> | undefined, buildHref: import("../factory-context/index.js").RouteHrefBuilder, options?: {
+    buildHref?: import("../factory-context/index.js").RouteHrefBuilder;
+}) => import("./_docs-helpers.js").DocNavNode[], groupSatelliteNodes: (tree: import("./_docs-helpers.js").DocNavNode[], prefixes: string[]) => import("./_docs-helpers.js").DocNavNode[], findNode: (nodes: import("./_docs-helpers.js").DocNavNode[], slug: string) => import("./_docs-helpers.js").DocNavNode | undefined, firstRoutedHref: (node: import("./_docs-helpers.js").DocNavNode) => string | undefined, collectAutoIndexNodes: (nodes: import("./_docs-helpers.js").DocNavNode[]) => import("./_docs-helpers.js").DocNavNode[], isNavVisible: (doc: import("./_docs-helpers.js").DocPageEntry) => boolean, stableDocs: (collectionName: string) => import("./_docs-helpers.js").DocPageEntry[], toRouteSlug: (id: string) => string, toSlugParams: (routeSlug: string) => string[];