@takazudo/zudo-doc 0.2.21 → 1.0.0

package/dist/routes/_docs-helpers.js

@@ -0,0 +1,173 @@
+import {
+  getCollection,
+  getContentSnapshot
+} from "@takazudo/zfb/content";
+import {
+  buildSidebarTree
+} from "../sidebar-tree/index.js";
+import { toRouteSlug } from "../slug/index.js";
+function snapshotAnchor(name) {
+  return getContentSnapshot()?.collections[name];
+}
+const bridgedByAnchor = /* @__PURE__ */ new WeakMap();
+function bridgeEntry(e, collectionName) {
+  return {
+    slug: e.slug,
+    id: toRouteSlug(e.slug),
+    collection: collectionName,
+    data: e.data,
+    body: e.body,
+    module_specifier: e.module_specifier,
+    Content: e.Content
+  };
+}
+function buildBridged(collectionName) {
+  const raw = getCollection(collectionName);
+  return raw.map((e) => bridgeEntry(e, collectionName)).filter((d) => !d.data.draft);
+}
+function stableDocs(collectionName) {
+  const anchor = snapshotAnchor(collectionName);
+  if (anchor === void 0) return buildBridged(collectionName);
+  const cached = bridgedByAnchor.get(anchor);
+  if (cached) return cached;
+  const built = buildBridged(collectionName);
+  bridgedByAnchor.set(anchor, built);
+  return built;
+}
+function isNavVisible(doc) {
+  return !doc.data.unlisted && !doc.data.standalone;
+}
+function toNavNode(node) {
+  return {
+    slug: node.id,
+    label: node.label,
+    description: node.description,
+    position: node.sidebar_position ?? 999,
+    href: node.href,
+    hasPage: node.hasPage,
+    children: node.children.map(toNavNode),
+    sortOrder: node.sortOrder ?? "asc"
+  };
+}
+function findRootIndexDoc(docs) {
+  let found;
+  for (const d of docs) {
+    const slug = d.data.slug ?? d.id.replace(/\/index$/, "");
+    if (slug === "") found = d;
+  }
+  return found;
+}
+function toRootNavNode(doc, locale, buildHref, categoryMeta) {
+  const meta = categoryMeta?.get("");
+  const noPage = doc.data.category_no_page ?? meta?.noPage;
+  const sortOrder = doc.data.category_sort_order ?? meta?.sortOrder ?? "asc";
+  return {
+    slug: "",
+    label: doc.data.sidebar_label ?? doc.data.title ?? meta?.label ?? "",
+    description: doc.data.description ?? meta?.description,
+    position: doc.data.sidebar_position ?? meta?.position ?? 999,
+    href: noPage ? void 0 : buildHref("", locale),
+    hasPage: noPage !== true,
+    children: [],
+    sortOrder
+  };
+}
+function buildNavTree(docs, locale, categoryMeta, buildHref, options) {
+  const href = options?.buildHref ?? buildHref;
+  const sidebarTree = buildSidebarTree(
+    docs.map((d) => ({ id: d.id, data: d.data })),
+    locale,
+    {
+      categoryMeta,
+      buildHref: (slug, loc) => href(slug, loc),
+      // Host call sites own visibility; disable the builder's default filter so
+      // breadcrumb (unfiltered) and nav (pre-filtered) paths are unchanged.
+      isNavVisible: () => true
+    }
+  );
+  const result = sidebarTree.map(toNavNode);
+  const rootDoc = findRootIndexDoc(docs);
+  if (rootDoc) {
+    result.push(toRootNavNode(rootDoc, locale, href, categoryMeta));
+    result.sort((a, b) => {
+      const posCompare = a.position - b.position;
+      if (posCompare !== 0) return posCompare;
+      return a.slug.localeCompare(b.slug);
+    });
+  }
+  return result;
+}
+function groupSatelliteNodes(tree, prefixes) {
+  const result = [...tree];
+  for (const prefix of prefixes) {
+    const primaryIdx = result.findIndex((n) => n.slug === prefix);
+    if (primaryIdx < 0) continue;
+    const primary = result[primaryIdx];
+    if (!primary) continue;
+    const satelliteIdxs = [];
+    for (let i = 0; i < result.length; i++) {
+      const node = result[i];
+      if (node && i !== primaryIdx && node.slug.startsWith(`${prefix}-`)) {
+        satelliteIdxs.push(i);
+      }
+    }
+    if (satelliteIdxs.length === 0) continue;
+    const extraChildren = [];
+    for (const idx of satelliteIdxs) {
+      const node = result[idx];
+      if (node) extraChildren.push(node);
+    }
+    result[primaryIdx] = { ...primary, children: [...primary.children, ...extraChildren] };
+    for (const idx of satelliteIdxs.reverse()) result.splice(idx, 1);
+  }
+  return result;
+}
+function findNode(nodes, slug) {
+  for (const node of nodes) {
+    if (node.slug === slug) return node;
+    const found = findNode(node.children, slug);
+    if (found) return found;
+  }
+  return void 0;
+}
+function firstRoutedHref(node) {
+  for (const child of node.children) {
+    if (child.hasPage && child.href) return child.href;
+    const nested = firstRoutedHref(child);
+    if (nested) return nested;
+  }
+  return void 0;
+}
+function collectAutoIndexNodes(nodes) {
+  const result = [];
+  for (const node of nodes) {
+    if (!node.hasPage && node.children.length > 0 && node.href) result.push(node);
+    result.push(...collectAutoIndexNodes(node.children));
+  }
+  return result;
+}
+function buildBreadcrumbs(tree, slug, homeHref, hrefFor) {
+  const parts = slug.split("/");
+  const crumbs = [{ label: "", href: homeHref }];
+  let nodes = tree;
+  for (let i = 0; i < parts.length; i++) {
+    const partialSlug = parts.slice(0, i + 1).join("/");
+    const node = nodes.find((n) => n.slug === partialSlug);
+    if (!node) break;
+    const isLast = i === parts.length - 1;
+    const href = isLast ? void 0 : hrefFor && node.href !== void 0 ? hrefFor(node.slug) : node.href;
+    crumbs.push({ label: node.label, href });
+    nodes = node.children;
+  }
+  return crumbs;
+}
+export {
+  buildBreadcrumbs,
+  buildNavTree,
+  collectAutoIndexNodes,
+  findNode,
+  firstRoutedHref,
+  groupSatelliteNodes,
+  isNavVisible,
+  stableDocs
+};

package/dist/routes/api-ai-chat.d.ts

@@ -0,0 +1,5 @@
+export declare const frontmatter: {
+    title: string;
+};
+export declare const prerender = false;
+export default function AiChatHandler(): Response;

package/dist/routes/api-ai-chat.js

@@ -0,0 +1,24 @@
+import { settings } from "./_context.js";
+const frontmatter = { title: "AI Chat API" };
+const prerender = false;
+const DISABLED_MESSAGE = "This feature is disabled on this demo. Need per project setup to enable this.";
+function jsonResponse(body, status) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+function AiChatHandler() {
+  if (settings.aiChatDemoMode === false && settings.aiAssistant) {
+    return jsonResponse(
+      { error: "ai-chat handler not provided by the package route (see A1 #2361)" },
+      501
+    );
+  }
+  return jsonResponse({ response: DISABLED_MESSAGE }, 200);
+}
+export {
+  AiChatHandler as default,
+  frontmatter,
+  prerender
+};

package/dist/routes/docs-slug.d.ts

@@ -0,0 +1,21 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "../doc-page-props/index.js";
+export declare const frontmatter: {
+    title: string;
+};
+type DocPageProps = DocPageEntryProps | DocPageAutoIndexProps;
+export declare function paths(): Array<{
+    params: {
+        slug: string[];
+    };
+    props: DocPageProps;
+}>;
+type PageArgs = DocPageProps & {
+    params: {
+        slug: string[];
+    };
+};
+export default function DocsPage(props: PageArgs): JSX.Element;
+export {};

package/dist/routes/docs-slug.js

@@ -0,0 +1,26 @@
+import { settings, defaultLocale, resolveNavSource, buildDocRouteEntries } from "./_context.js";
+import { renderDocPage } from "./_chrome.js";
+const frontmatter = { title: "Docs" };
+function paths() {
+  const locale = defaultLocale;
+  const source = resolveNavSource(locale, void 0);
+  return buildDocRouteEntries({
+    source,
+    locale,
+    routeSig: `docs;${locale}`
+  }).map((item) => ({
+    params: { slug: item.slugParams },
+    props: item.props
+  }));
+}
+function DocsPage(props) {
+  return renderDocPage(props, {
+    locale: defaultLocale,
+    docHistoryContentDir: settings.docsDir
+  });
+}
+export {
+  DocsPage as default,
+  frontmatter,
+  paths
+};

package/dist/routes/docs-tags-index.d.ts

@@ -0,0 +1,7 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+export declare const frontmatter: {
+    title: string;
+};
+export default function DocsTagsIndexPage(): JSX.Element;

package/dist/routes/docs-tags-index.js

@@ -0,0 +1,11 @@
+import { jsx } from "preact/jsx-runtime";
+import { defaultLocale } from "./_context.js";
+import { TagsIndexPageView } from "./_chrome.js";
+const frontmatter = { title: "All Tags" };
+function DocsTagsIndexPage() {
+  return /* @__PURE__ */ jsx(TagsIndexPageView, { locale: defaultLocale });
+}
+export {
+  DocsTagsIndexPage as default,
+  frontmatter
+};

package/dist/routes/docs-tags-tag.d.ts

@@ -0,0 +1,23 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+import type { TagInfo } from "../tag-pages/index.js";
+export declare const frontmatter: {
+    title: string;
+};
+export declare function paths(): Array<{
+    params: {
+        tag: string;
+    };
+    props: {
+        tagInfo: TagInfo;
+    };
+}>;
+interface PageProps {
+    params: {
+        tag: string;
+    };
+    tagInfo: TagInfo;
+}
+export default function DocTagPage({ params, tagInfo }: PageProps): JSX.Element;
+export {};

package/dist/routes/docs-tags-tag.js

@@ -0,0 +1,19 @@
+import { jsx } from "preact/jsx-runtime";
+import { defaultLocale } from "./_context.js";
+import { collectTagMapForLocale, TagDetailPageView } from "./_chrome.js";
+const frontmatter = { title: "Tag" };
+function paths() {
+  const tagMap = collectTagMapForLocale(defaultLocale);
+  return [...tagMap.entries()].map(([tag, tagInfo]) => ({
+    params: { tag },
+    props: { tagInfo }
+  }));
+}
+function DocTagPage({ params, tagInfo }) {
+  return /* @__PURE__ */ jsx(TagDetailPageView, { locale: defaultLocale, tag: params.tag, tagInfo });
+}
+export {
+  DocTagPage as default,
+  frontmatter,
+  paths
+};

package/dist/routes/docs-versions.d.ts

@@ -0,0 +1,7 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+export declare const frontmatter: {
+    title: string;
+};
+export default function VersionsPage(): JSX.Element;

package/dist/routes/docs-versions.js

@@ -0,0 +1,11 @@
+import { jsx } from "preact/jsx-runtime";
+import { defaultLocale } from "./_context.js";
+import { VersionsPageView } from "./_chrome.js";
+const frontmatter = { title: "Versions" };
+function VersionsPage() {
+  return /* @__PURE__ */ jsx(VersionsPageView, { locale: defaultLocale });
+}
+export {
+  VersionsPage as default,
+  frontmatter
+};

package/dist/routes/index.d.ts

@@ -0,0 +1,7 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+export declare const frontmatter: {
+    title: string;
+};
+export default function IndexPage(): JSX.Element;

package/dist/routes/index.js

@@ -0,0 +1,117 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Island } from "@takazudo/zfb";
+import { DocLayoutWithDefaults } from "../doclayout/index.js";
+import { SiteTreeNav } from "../site-tree-nav-island/index.js";
+import {
+  settings,
+  defaultLocale,
+  t,
+  withBase,
+  resolveNavSource,
+  buildNavTree,
+  groupSatelliteNodes,
+  getCategoryOrder,
+  collectTags,
+  docsUrl,
+  toRouteSlug
+} from "./_context.js";
+import {
+  HeadWithDefaults,
+  HeaderWithDefaults,
+  FooterWithDefaults,
+  BodyEndIslandsStub,
+  composeMetaTitle
+} from "./_chrome.js";
+const frontmatter = { title: "Home" };
+function IndexPage() {
+  const locale = defaultLocale;
+  const { navDocs, categoryMeta } = resolveNavSource(locale, void 0);
+  const tree = buildNavTree(
+    navDocs,
+    locale,
+    categoryMeta,
+    (slug, loc) => docsUrl(slug, loc)
+  );
+  const categoryOrder = getCategoryOrder();
+  const groupedTree = groupSatelliteNodes(tree, categoryOrder);
+  const tagCount = collectTags(
+    navDocs.filter((d) => !d.data.category_no_page),
+    (id, data) => data.slug ?? toRouteSlug(id)
+  ).size;
+  const ctaNav = settings.headerNav[0] ?? null;
+  const overview = ctaNav ? withBase(ctaNav.path) : null;
+  const logoUrl = withBase("/img/logo.svg");
+  return /* @__PURE__ */ jsxs(
+    DocLayoutWithDefaults,
+    {
+      title: composeMetaTitle(settings.siteName),
+      head: /* @__PURE__ */ jsx(HeadWithDefaults, { title: settings.siteName }),
+      lang: locale,
+      noindex: settings.noindex,
+      hideSidebar: true,
+      hideToc: true,
+      sidebarOverride: /* @__PURE__ */ jsx(Fragment, {}),
+      headerOverride: /* @__PURE__ */ jsx(HeaderWithDefaults, { lang: locale, currentPath: withBase("/") }),
+      footerOverride: /* @__PURE__ */ jsx(FooterWithDefaults, { lang: locale }),
+      bodyEndComponents: /* @__PURE__ */ jsx(BodyEndIslandsStub, { basePath: settings.base ?? "/" }),
+      enableClientRouter: settings.dynamicPageTransition,
+      children: [
+        /* @__PURE__ */ jsx("div", { class: "flex justify-center mb-vsp-xl", children: /* @__PURE__ */ jsxs("div", { class: "flex flex-col items-center text-center gap-hsp-md lg:flex-row lg:text-left lg:gap-hsp-xl", children: [
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              class: "w-[320px] max-w-full aspect-[1200/630] bg-fg shrink-0",
+              style: {
+                WebkitMask: `url(${logoUrl}) center/contain no-repeat`,
+                mask: `url(${logoUrl}) center/contain no-repeat`
+              },
+              "aria-hidden": "true"
+            }
+          ),
+          /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs", children: settings.siteName }),
+            /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: settings.siteDescription }),
+            /* @__PURE__ */ jsxs("div", { class: "flex items-center justify-center lg:justify-start gap-hsp-md text-small", children: [
+              overview && /* @__PURE__ */ jsxs(Fragment, { children: [
+                /* @__PURE__ */ jsx("a", { href: overview, class: "text-fg underline hover:text-accent", children: t("nav.overview", locale) }),
+                /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" })
+              ] }),
+              settings.githubUrl && /* @__PURE__ */ jsxs(Fragment, { children: [
+                /* @__PURE__ */ jsx(
+                  "a",
+                  {
+                    href: settings.githubUrl,
+                    class: "inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent",
+                    target: "_blank",
+                    rel: "noopener noreferrer",
+                    children: "GitHub"
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" })
+              ] })
+            ] })
+          ] })
+        ] }) }),
+        Island({
+          when: "idle",
+          children: /* @__PURE__ */ jsx(
+            SiteTreeNav,
+            {
+              tree: groupedTree,
+              categoryOrder,
+              categoryIgnore: ["inbox", "develop"]
+            }
+          )
+        }),
+        settings.docTags && tagCount > 0 && /* @__PURE__ */ jsxs("section", { class: "mt-vsp-xl", children: [
+          /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-md", children: t("doc.allTags", locale) }),
+          /* @__PURE__ */ jsx("a", { href: withBase("/docs/tags"), class: "text-accent underline hover:text-accent-hover", children: t("doc.allTags", locale) })
+        ] })
+      ]
+    }
+  );
+}
+export {
+  IndexPage as default,
+  frontmatter
+};

package/dist/routes/locale-docs-slug.d.ts

@@ -0,0 +1,27 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "../doc-page-props/index.js";
+export declare const frontmatter: {
+    title: string;
+};
+interface LocaleDocPageExtra {
+    contentDir: string;
+    isFallback: boolean;
+}
+type DocPageProps = (DocPageEntryProps & LocaleDocPageExtra) | (DocPageAutoIndexProps & LocaleDocPageExtra);
+export declare function paths(): Array<{
+    params: {
+        locale: string;
+        slug: string[];
+    };
+    props: DocPageProps;
+}>;
+type PageArgs = DocPageProps & {
+    params: {
+        locale: string;
+        slug: string[];
+    };
+};
+export default function LocaleDocsPage(props: PageArgs): JSX.Element;
+export {};

package/dist/routes/locale-docs-slug.js

@@ -0,0 +1,40 @@
+import { settings, getLocaleConfig, resolveNavSource, buildDocRouteEntries } from "./_context.js";
+import { renderDocPage } from "./_chrome.js";
+const frontmatter = { title: "Docs" };
+function paths() {
+  const result = [];
+  for (const locale of Object.keys(settings.locales)) {
+    const contentDir = getLocaleConfig(locale)?.dir ?? settings.docsDir;
+    const source = resolveNavSource(locale, void 0, {
+      applyDefaultLocaleOnlyFilter: true,
+      keepUnlisted: true
+    });
+    for (const item of buildDocRouteEntries({
+      source,
+      locale,
+      routeSig: `locale-docs;${locale}`
+    })) {
+      const extra = {
+        contentDir: item.isFallback ? settings.docsDir : contentDir,
+        isFallback: item.isFallback
+      };
+      result.push({
+        params: { locale, slug: item.slugParams },
+        props: { ...item.props, ...extra }
+      });
+    }
+  }
+  return result;
+}
+function LocaleDocsPage(props) {
+  return renderDocPage(props, {
+    locale: props.params.locale,
+    isFallback: props.isFallback,
+    docHistoryContentDir: props.contentDir
+  });
+}
+export {
+  LocaleDocsPage as default,
+  frontmatter,
+  paths
+};

package/dist/routes/locale-docs-tags-index.d.ts

@@ -0,0 +1,18 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+export declare const frontmatter: {
+    title: string;
+};
+export declare function paths(): Array<{
+    params: {
+        locale: string;
+    };
+}>;
+interface PageProps {
+    params: {
+        locale: string;
+    };
+}
+export default function LocaleTagsIndexPage({ params }: PageProps): JSX.Element;
+export {};

package/dist/routes/locale-docs-tags-index.js

@@ -0,0 +1,15 @@
+import { jsx } from "preact/jsx-runtime";
+import { settings } from "./_context.js";
+import { TagsIndexPageView } from "./_chrome.js";
+const frontmatter = { title: "All Tags" };
+function paths() {
+  return Object.keys(settings.locales).map((locale) => ({ params: { locale } }));
+}
+function LocaleTagsIndexPage({ params }) {
+  return /* @__PURE__ */ jsx(TagsIndexPageView, { locale: params.locale });
+}
+export {
+  LocaleTagsIndexPage as default,
+  frontmatter,
+  paths
+};

package/dist/routes/locale-docs-tags-tag.d.ts

@@ -0,0 +1,25 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+import type { TagInfo } from "../tag-pages/index.js";
+export declare const frontmatter: {
+    title: string;
+};
+export declare function paths(): Array<{
+    params: {
+        locale: string;
+        tag: string;
+    };
+    props: {
+        tagInfo: TagInfo;
+    };
+}>;
+interface PageProps {
+    params: {
+        locale: string;
+        tag: string;
+    };
+    tagInfo: TagInfo;
+}
+export default function LocaleDocTagPage({ params, tagInfo }: PageProps): JSX.Element;
+export {};

package/dist/routes/locale-docs-tags-tag.js

@@ -0,0 +1,22 @@
+import { jsx } from "preact/jsx-runtime";
+import { settings } from "./_context.js";
+import { collectTagMapForLocale, TagDetailPageView } from "./_chrome.js";
+const frontmatter = { title: "Tag" };
+function paths() {
+  const result = [];
+  for (const locale of Object.keys(settings.locales)) {
+    const tagMap = collectTagMapForLocale(locale);
+    for (const [tag, tagInfo] of tagMap.entries()) {
+      result.push({ params: { locale, tag }, props: { tagInfo } });
+    }
+  }
+  return result;
+}
+function LocaleDocTagPage({ params, tagInfo }) {
+  return /* @__PURE__ */ jsx(TagDetailPageView, { locale: params.locale, tag: params.tag, tagInfo });
+}
+export {
+  LocaleDocTagPage as default,
+  frontmatter,
+  paths
+};

package/dist/routes/locale-docs-versions.d.ts

@@ -0,0 +1,18 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+export declare const frontmatter: {
+    title: string;
+};
+export declare function paths(): Array<{
+    params: {
+        locale: string;
+    };
+}>;
+interface PageProps {
+    params: {
+        locale: string;
+    };
+}
+export default function LocaleVersionsPage({ params }: PageProps): JSX.Element;
+export {};

package/dist/routes/locale-docs-versions.js

@@ -0,0 +1,15 @@
+import { jsx } from "preact/jsx-runtime";
+import { settings } from "./_context.js";
+import { VersionsPageView } from "./_chrome.js";
+const frontmatter = { title: "Versions" };
+function paths() {
+  return Object.keys(settings.locales).map((locale) => ({ params: { locale } }));
+}
+function LocaleVersionsPage({ params }) {
+  return /* @__PURE__ */ jsx(VersionsPageView, { locale: params.locale });
+}
+export {
+  LocaleVersionsPage as default,
+  frontmatter,
+  paths
+};