@takazudo/zudo-doc 0.2.21 → 1.0.0

package/routes-src/v-locale-docs-slug.tsx

@@ -0,0 +1,85 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Package route entrypoint: /v/[version]/[locale]/docs/[[...slug]] —
+// package-owned equivalent of pages/v/[version]/[locale]/docs/[[...slug]].tsx
+// (A1 #2361).
+//
+// Versioned non-default-locale docs route. The dynamic `[version]`/`[locale]`
+// patterns are injected ONCE; `paths()` cross-products versions × non-default
+// locales with a locale-first merge over the version's EN base.
+
+import type { JSX } from "preact";
+import type { VersionConfig } from "@takazudo/zudo-doc/settings";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "@takazudo/zudo-doc/doc-page-props";
+import { settings, resolveVersionedLocaleSource, versionedDocsUrl, buildDocRouteEntries } from "./_context.js";
+import { renderDocPage } from "./_chrome.js";
+
+export const frontmatter = { title: "Docs" };
+
+interface VersionedLocaleDocPageExtra {
+  version: VersionConfig;
+  contentDir: string;
+  isFallback: boolean;
+}
+
+type DocPageProps =
+  | (DocPageEntryProps & VersionedLocaleDocPageExtra)
+  | (DocPageAutoIndexProps & VersionedLocaleDocPageExtra);
+
+export function paths(): Array<{
+  params: { version: string; locale: string; slug: string[] };
+  props: DocPageProps;
+}> {
+  if (!settings.versions) return [];
+
+  const result: Array<{
+    params: { version: string; locale: string; slug: string[] };
+    props: DocPageProps;
+  }> = [];
+
+  for (const version of settings.versions) {
+    for (const locale of Object.keys(settings.locales)) {
+      const localeDir = version.locales?.[locale]?.dir;
+      const source = resolveVersionedLocaleSource(
+        version.slug,
+        version.docsDir,
+        locale,
+        localeDir,
+        { applyDefaultLocaleOnlyFilter: true, keepUnlisted: true },
+      );
+      const urlFor = (s: string): string => versionedDocsUrl(s, version.slug, locale);
+
+      for (const item of buildDocRouteEntries({
+        source,
+        locale,
+        routeSig: `v-locale-docs;${version.slug};${locale}`,
+        urlFor,
+      })) {
+        const extra: VersionedLocaleDocPageExtra = {
+          version,
+          contentDir: item.isFallback ? version.docsDir : (localeDir ?? version.docsDir),
+          isFallback: item.isFallback,
+        };
+        result.push({
+          params: { version: version.slug, locale, slug: item.slugParams },
+          props: { ...(item.props as DocPageProps), ...extra },
+        });
+      }
+    }
+  }
+
+  return result;
+}
+
+type PageArgs = DocPageProps & {
+  params: { version: string; locale: string; slug: string[] };
+};
+
+export default function VersionedLocaleDocsPage(props: PageArgs): JSX.Element {
+  return renderDocPage(props, {
+    locale: props.params.locale,
+    version: props.version,
+    isFallback: props.isFallback,
+    docHistoryContentDir: props.contentDir,
+  });
+}

package/dist/toc/smart-break.d.ts

@@ -1,27 +0,0 @@
-import { VNode } from 'preact';
-
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-
-/**
- * Local copy of the SmartBreak helper used by TOC entries. Kept inside
- * the toc primitive folder so the package is self-contained and does
- * not reach back into the host application's `src/utils/smart-break`.
- *
- * The host's full smart-break util exposes additional helpers
- * (`smartBreakToHtml`, `escapeAndInjectWbr`) that the TOC does not
- * need; this file ports only `isPathLike`, `smartBreak`, and the
- * `SmartBreak` Preact wrapper. Keep the heuristic byte-identical to
- * the host implementation so wbr placement matches everywhere.
- */
-declare function isPathLike(text: string): boolean;
-declare function smartBreak(text: string): VNode | string;
-/**
- * Preact function component wrapper — pure, server-renderable.
- * Stringifies children and defers to smartBreak.
- */
-declare function SmartBreak({ children }: {
-    children?: unknown;
-}): VNode;
-
-export { SmartBreak, isPathLike, smartBreak };