@terrafirmagreg-team/kit 1.2.9 → 1.2.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terrafirmagreg-team/kit",
-  "version": "1.2.9",
+  "version": "1.2.11",
   "type": "module",
   "description": "Fumadocs content engine",
   "license": "LGPL-3.0-only",
@@ -24,11 +24,11 @@
   "dependencies": {
     "@base-ui/react": "^1.9.0",
     "@icons-pack/react-simple-icons": "13.15.1",
-    "@terrafirmagreg-team/data": "^1.2.2",
-    "@terrafirmagreg-team/mdx": "^1.2.3",
-    "@terrafirmagreg-team/sites": "^1.2.1",
-    "@terrafirmagreg-team/translate": "^1.2.5",
-    "@terrafirmagreg-team/ui": "^1.2.6",
+    "@terrafirmagreg-team/data": "^1.2.3",
+    "@terrafirmagreg-team/mdx": "^1.2.5",
+    "@terrafirmagreg-team/sites": "^1.2.2",
+    "@terrafirmagreg-team/translate": "^1.2.7",
+    "@terrafirmagreg-team/ui": "^1.2.8",
     "fumadocs-core": "16.17.10",
     "lucide-react": "^1.63.0",
     "server-only": "^0.0.1",

package/src/components/blocks/nav-title.tsx

@@ -13,10 +13,12 @@ import {
 } from '@terrafirmagreg-team/sites/location';
 import { setVersionPreference } from '@terrafirmagreg-team/kit/hooks/use-version-pref';
 import { useVersionedDataset } from '@terrafirmagreg-team/kit/hooks/use-versioned-dataset';
+import { useSectionNames } from '@terrafirmagreg-team/kit/hooks/use-section-names';
 import { VersionMenu } from '@terrafirmagreg-team/kit/components/version-menu';
 
 export function NavTitle({ className, ...props }: ComponentProps<'a'>) {
   const { section, dataset } = parseSectionLocation(usePathname());
+  const sectionNames = useSectionNames();
   const datasetId = dataset;
 
   const gameData = isDumpSection(section) && datasetId;
@@ -52,6 +54,8 @@ export function NavTitle({ className, ...props }: ComponentProps<'a'>) {
             versions={versions}
             onSelect={(next) => setVersionPreference(datasetId, next)}
           />
+        ) : section ? (
+          sectionNames[section]?.title
         ) : undefined
       }
       className={className}

package/src/components/dump-status/stale-badge.tsx

@@ -0,0 +1,18 @@
+'use client';
+
+import { useTranslations } from '@terrafirmagreg-team/translate/hooks/use-translations';
+import { cn } from '@terrafirmagreg-team/ui/lib/utils/cn';
+
+export function StaleBadge({ className }: { className?: string }) {
+  const t = useTranslations();
+  return (
+    <span
+      className={cn(
+        'pointer-events-none absolute end-3 top-3 z-20 rounded-full border border-amber-500/40 bg-amber-500/10 px-2 py-0.5 text-[11px] font-medium text-amber-700 dark:text-amber-300',
+        className,
+      )}
+    >
+      {t('cached', { note: 'kit.stale_badge' })}
+    </span>
+  );
+}

package/src/components/layouts/layout.tsx

@@ -21,6 +21,7 @@ import {
 } from '@terrafirmagreg-team/ui/components/blocks/nav/site-menu';
 import { buttonVariants } from '@terrafirmagreg-team/ui/components/ui/button';
 import { cn } from '@terrafirmagreg-team/ui/lib/utils/cn';
+import { skeletonTree } from '@terrafirmagreg-team/ui/lib/tree';
 import { Globe } from 'lucide-react';
 import {
   SiCurseforge,
@@ -37,6 +38,7 @@ import { LangLocalesScope } from '@terrafirmagreg-team/translate/provider';
 import { localeItems } from '@terrafirmagreg-team/translate/create';
 import { siteLinks } from '@terrafirmagreg-team/sites';
 import { useCurrentDataset } from '@terrafirmagreg-team/kit/hooks/use-current-dataset';
+import { useFailedDatasets } from '@terrafirmagreg-team/kit/hooks/use-dump-status';
 import { useDatasetAccent } from '@terrafirmagreg-team/kit/hooks/use-dataset-accent';
 import { useNavOptions } from '@terrafirmagreg-team/kit/hooks/use-nav-options';
 import { pinTreeDataset } from '@terrafirmagreg-team/kit/lib/pin-tree';
@@ -57,6 +59,7 @@ export type LayoutProps = {
   useTree?: (tree: PageTree.Root) => PageTree.Root;
   sidebar?: Pick<LeftSidebarSlotProps, 'feature'>;
   navTitle?: ComponentType<ComponentProps<'a'>>;
+  defaultOpenLevel?: number;
   children?: ReactNode;
 };
 
@@ -78,15 +81,19 @@ export function Layout({
   useTree = identityTree,
   sidebar,
   navTitle,
+  defaultOpenLevel,
   children,
 }: LayoutProps) {
   const t = useTranslations();
   const { defaultLanguage } = useLocaleRegistry();
   const lang: Lang = useResolvedLang();
-  const current = useCurrentDataset(catalog[section]);
+  const sectionDatasets = catalog[section] ?? [];
+  const current = useCurrentDataset(sectionDatasets);
   const baseId = current ? current.id : undefined;
   const pinned = current ? current.version : undefined;
-  const meta = catalog[section].find((item) => item.id === baseId);
+  const meta = sectionDatasets.find((item) => item.id === baseId);
+  const failedDatasets = useFailedDatasets();
+  const datasetFailed = baseId !== undefined && failedDatasets.includes(baseId);
   useDatasetAccent(meta?.accent);
   const nav = useNavOptions({ section, catalog });
   const pathname = usePathname();
@@ -104,12 +111,14 @@ export function Layout({
     $id: `${section}:empty`,
   };
   const tree = useTree(serverTree);
+  const effectiveTree =
+    datasetFailed && !tree.children.length ? skeletonTree() : tree;
   const pinnedTree = useMemo(
     () =>
       pinned && baseId
-        ? pinTreeDataset(tree, section, baseId, pinned)
-        : tree,
-    [tree, section, baseId, pinned],
+        ? pinTreeDataset(effectiveTree, section, baseId, pinned)
+        : effectiveTree,
+    [effectiveTree, section, baseId, pinned],
   );
   const locales = meta?.languages ? localeItems(meta.languages) : undefined;
   const links = baseId
@@ -139,6 +148,7 @@ export function Layout({
     <UiLayout
       tree={pinnedTree}
       navTitle={navTitle}
+      defaultOpenLevel={defaultOpenLevel}
       sidebar={
         <LeftSidebar
           navKeys={NAV_KEYS}

package/src/components/page-features.tsx

@@ -0,0 +1,30 @@
+import type {
+  SectionFeatures,
+  SectionPageContext,
+} from '../types/features.ts';
+import type { ReactNode } from 'react';
+
+export function pageFeatureNodes(
+  ctx: SectionPageContext,
+  features: SectionFeatures,
+  body: ReactNode,
+): {
+  actionsRight: ReactNode;
+  body: ReactNode;
+  footer: ReactNode;
+  comments: ReactNode;
+} {
+  const wrapped = features.wrapBody ? (
+    features.wrapBody(body, ctx)
+  ) : (
+    <div data-md-root className="contents">
+      {body}
+    </div>
+  );
+  return {
+    actionsRight: features.actionsRight?.(ctx),
+    body: wrapped,
+    footer: features.footer?.(ctx),
+    comments: features.comments?.(ctx),
+  };
+}

package/src/components/views/not-found.tsx

@@ -1,9 +1,15 @@
 'use client';
-import { FileQuestion } from 'lucide-react';
-import { sectionUrl } from '@terrafirmagreg-team/sites/location';
+import { useEffect, useRef } from 'react';
+import { usePathname, useRouter } from 'next/navigation';
+import { isSectionKey, sectionUrl } from '@terrafirmagreg-team/sites/location';
 import { useTranslations } from '@terrafirmagreg-team/translate/hooks/use-translations';
 import { LangLink } from '@terrafirmagreg-team/ui/components/blocks/lang/link';
 import { EmptyState } from '@terrafirmagreg-team/ui/components/blocks/page/empty-state';
+import { buttonVariants } from '@terrafirmagreg-team/ui/components/ui/button';
+import { cn } from '@terrafirmagreg-team/ui/lib/utils/cn';
+import { requestDumpRetry } from '@terrafirmagreg-team/data/lib/dump-status';
+import { useDumpStatus } from '@terrafirmagreg-team/kit/hooks/use-dump-status';
+import { useSectionCatalog } from '@terrafirmagreg-team/kit/hooks/use-catalog';
 import type { SectionDataset, SectionKey } from '@terrafirmagreg-team/kit/types';
 
 export function SectionNotFound({
@@ -14,24 +20,119 @@ export function SectionNotFound({
   datasets: readonly SectionDataset[];
 }) {
   const t = useTranslations();
+  const router = useRouter();
+  const { statuses } = useDumpStatus();
+  const hadFailure = useRef(false);
+  const anyFailed = Object.values(statuses).some(
+    (state) => state.status === 'failed',
+  );
+  useEffect(() => {
+    if (anyFailed) {
+      hadFailure.current = true;
+      return;
+    }
+    if (hadFailure.current && Object.keys(statuses).length) {
+      hadFailure.current = false;
+      router.refresh();
+    }
+  }, [anyFailed, statuses, router]);
+
   if (!datasets.length)
     return (
-      <EmptyState variant="missing">
-        {t('Section data is temporarily unavailable. Try again later.', {
-          note: 'kit.section_unavailable',
-        })}
-      </EmptyState>
+      <div className="mx-2 flex min-w-0 flex-1 flex-col items-center justify-center gap-3 bg-background [grid-area:main] md:my-2 md:overflow-clip md:rounded-2xl md:border md:shadow-sm">
+        <EmptyState variant="missing">
+          {t('Section data is temporarily unavailable. Try again later.', {
+            note: 'kit.section_unavailable',
+          })}
+        </EmptyState>
+        <button
+          type="button"
+          onClick={requestDumpRetry}
+          className={cn(buttonVariants({ variant: 'outline', size: 'xs' }))}
+        >
+          {t('Retry now', { note: 'kit.retry_now' })}
+        </button>
+      </div>
     );
   return (
-    <main className="flex min-h-dvh flex-col items-center justify-center gap-3 p-8 text-muted-foreground">
-      <FileQuestion className="size-10" />
-      <p>{t('Page not found', { note: 'ui.not_found' })}</p>
+    <div className="mx-2 flex min-w-0 flex-1 flex-col items-center justify-center gap-6 bg-background [grid-area:main] md:my-2 md:overflow-clip md:rounded-2xl md:border md:shadow-sm">
+      <div className="flex flex-col items-center gap-2 text-center">
+        <span
+          aria-hidden
+          className="select-none text-6xl leading-none font-semibold tracking-tighter text-muted-foreground/25"
+        >
+          404
+        </span>
+        <p className="font-medium text-foreground">
+          {t('Page not found', { note: 'ui.not_found' })}
+        </p>
+        <p className="max-w-sm text-sm text-balance text-muted-foreground">
+          {t("The page you're looking for doesn't exist or was moved.", {
+            note: 'ui.not_found_description',
+          })}
+        </p>
+      </div>
       <LangLink
         href={sectionUrl(section, datasets[0].id)}
-        className="text-sm underline underline-offset-4 transition-colors hover:text-foreground"
+        className={cn(
+          buttonVariants({ variant: 'outline', size: 'sm' }),
+          'no-underline',
+        )}
       >
         {t('Back', { note: 'ui.back' })}
       </LangLink>
+    </div>
+  );
+}
+
+export function RootNotFound() {
+  const pathname = usePathname();
+  const catalog = useSectionCatalog();
+  const t = useTranslations();
+  const parts = pathname.split('/').filter(Boolean);
+  const section = isSectionKey(parts[0]) ? parts[0] : undefined;
+  const datasets = section ? catalog[section] : undefined;
+  const known = datasets?.some((dataset) => dataset.id === parts[1]);
+  const href =
+    section && datasets?.length
+      ? `/${section}/${known ? parts[1] : datasets[0].id}`
+      : '/';
+
+  return (
+    <main className="flex min-h-dvh flex-col items-center justify-center gap-8 p-8">
+      <div className="flex flex-col items-center gap-3 text-center">
+        <span
+          aria-hidden
+          className="select-none bg-gradient-to-b from-muted-foreground/40 to-muted-foreground/10 bg-clip-text text-[8rem] leading-none font-semibold tracking-tighter text-transparent"
+        >
+          404
+        </span>
+        <h1 className="text-xl font-semibold text-foreground">
+          {t('Page not found', { note: 'ui.not_found' })}
+        </h1>
+        <p className="max-w-sm text-sm text-balance text-muted-foreground">
+          {t("The page you're looking for doesn't exist or was moved.", {
+            note: 'ui.not_found_description',
+          })}
+        </p>
+      </div>
+      <div className="flex items-center gap-2">
+        <LangLink
+          href={href}
+          className={cn(buttonVariants({ size: 'sm' }), 'no-underline')}
+        >
+          {t('Back', { note: 'ui.back' })}
+        </LangLink>
+        <LangLink
+          href="/"
+          className={cn(
+            buttonVariants({ variant: 'ghost', size: 'sm' }),
+            'no-underline',
+          )}
+        >
+          {t('Go home', { note: 'ui.go_home' })}
+        </LangLink>
+      </div>
     </main>
   );
 }

package/src/components/views/routes.tsx

@@ -193,8 +193,8 @@ export function createSectionRoutes<
       render(
         await source.getSource(),
         slug,
-        await trees?.(),
-        await datasetCatalog(),
+        await trees?.().catch(() => undefined),
+        await datasetCatalog().catch((): DatasetCatalog => ({}) as DatasetCatalog),
         page,
         lang,
       ),
@@ -203,8 +203,10 @@ export function createSectionRoutes<
   async function SectionLayout({ children }: { children?: ReactNode }) {
     const { slots } = baseOptions();
     const [resolvedTrees, catalog] = await Promise.all([
-      trees ? trees() : Promise.resolve<SectionTrees>({}),
-      datasetCatalog(),
+      trees
+        ? trees().catch((): SectionTrees => ({}))
+        : Promise.resolve<SectionTrees>({}),
+      datasetCatalog().catch((): DatasetCatalog => ({}) as DatasetCatalog),
     ]);
     return (
       <LayoutView
@@ -237,8 +239,8 @@ export function createSectionRoutes<
     }
 
     const [resolvedTrees, catalog] = await Promise.all([
-      trees?.(),
-      datasetCatalog(),
+      trees?.().catch(() => undefined),
+      datasetCatalog().catch((): DatasetCatalog => ({}) as DatasetCatalog),
     ]);
     const content = langContent(
       slug,

package/src/components/views/unavailable.tsx

@@ -0,0 +1,38 @@
+'use client';
+
+import type { ReactNode } from 'react';
+import { CloudOff } from 'lucide-react';
+import { useTranslations } from '@terrafirmagreg-team/translate/hooks/use-translations';
+import { requestDumpRetry } from '@terrafirmagreg-team/data/lib/dump-status';
+import { buttonVariants } from '@terrafirmagreg-team/ui/components/ui/button';
+import { cn } from '@terrafirmagreg-team/ui/lib/utils/cn';
+
+export function DumpUnavailable({ children }: { children?: ReactNode }) {
+  const t = useTranslations();
+  return (
+    <div className="pointer-events-auto flex max-w-xs flex-col items-center gap-2.5 rounded-lg border border-border bg-popover px-5 py-4 text-center shadow-lg">
+      <CloudOff className="size-5 text-muted-foreground" />
+      <p className="text-sm text-muted-foreground">
+        {children ??
+          t('Section data is temporarily unavailable. Try again later.', {
+            note: 'kit.section_unavailable',
+          })}
+      </p>
+      <button
+        type="button"
+        onClick={requestDumpRetry}
+        className={cn(buttonVariants({ variant: 'outline', size: 'xs' }))}
+      >
+        {t('Retry now', { note: 'kit.retry_now' })}
+      </button>
+    </div>
+  );
+}
+
+export function DumpUnavailableOverlay({ children }: { children?: ReactNode }) {
+  return (
+    <div className="pointer-events-none absolute inset-0 z-20 flex items-center justify-center p-6">
+      {children ?? <DumpUnavailable />}
+    </div>
+  );
+}

package/src/hooks/use-dump-status.ts

@@ -0,0 +1,32 @@
+'use client';
+
+import { useSyncExternalStore } from 'react';
+import {
+  dumpStatusSnapshot,
+  subscribeDumpStatus,
+  type DumpStatusSnapshot,
+} from '@terrafirmagreg-team/data/lib/dump-status';
+
+const SERVER_SNAPSHOT: DumpStatusSnapshot = {
+  statuses: {},
+  retryNonce: 0,
+  dismissed: false,
+};
+
+export function useDumpStatus(): DumpStatusSnapshot {
+  return useSyncExternalStore(
+    subscribeDumpStatus,
+    dumpStatusSnapshot,
+    () => SERVER_SNAPSHOT,
+  );
+}
+
+export function useDumpRetryNonce(): number {
+  return useDumpStatus().retryNonce;
+}
+
+export function useFailedDatasets(): string[] {
+  return Object.entries(useDumpStatus().statuses)
+    .filter(([, state]) => state.status === 'failed')
+    .map(([id]) => id);
+}

package/src/hooks/use-nav-options.ts

@@ -17,6 +17,8 @@ import type {
   SwitcherProps,
 } from '@terrafirmagreg-team/ui/types/nav';
 
+const EMPTY_DATASETS: never[] = [];
+
 function datasetIcon(dataset: { icon?: IconName }): ReactNode {
   if (!dataset.icon) return undefined;
   return createElement(DynamicIcon, {
@@ -31,7 +33,8 @@ export function useNavOptions({ section, catalog }: LeftSidebarScope): {
 } {
   const t = useTranslations();
   const sectionNames = useSectionNames();
-  const current = useCurrentDataset(catalog[section]);
+  const sectionDatasets = catalog[section] ?? EMPTY_DATASETS;
+  const current = useCurrentDataset(sectionDatasets);
   const baseId = current ? current.id : undefined;
   const pinned = current ? current.version : undefined;
   const preferred = useVersionPreference(baseId);
@@ -41,7 +44,7 @@ export function useNavOptions({ section, catalog }: LeftSidebarScope): {
     () =>
       sectionTabs.map(({ key, icon: Icon }) => {
         const meta = baseId
-          ? catalog[key].find(({ id }) => id === baseId)
+          ? catalog[key]?.find(({ id }) => id === baseId)
           : undefined;
         const pinned =
           isDumpSection(key) && baseId
@@ -61,14 +64,14 @@ export function useNavOptions({ section, catalog }: LeftSidebarScope): {
 
   const datasetOptions: SwitcherOption[] = useMemo(
     () =>
-      catalog[section].map((datasetItem) => ({
+      sectionDatasets.map((datasetItem) => ({
         value: datasetItem.id,
         title: datasetItem.title ?? datasetItem.id,
         description: datasetItem.description,
         icon: datasetIcon(datasetItem),
         url: sectionUrl(section, datasetItem.id),
       })),
-    [section, catalog],
+    [section, sectionDatasets],
   );
 
   return {

package/src/lib/config.ts

@@ -43,6 +43,7 @@ export type SectionConfigInput = {
         url: string;
         icon?: string;
       }[];
+      sections?: readonly SectionKey[];
       guide?: { bookOrder?: readonly string[] };
     }
   >;

package/src/lib/datasets.ts

@@ -4,6 +4,7 @@ import { sectionConfig } from './config';
 import { sections } from './sources';
 import { datasetId } from './tree';
 import { createAsyncCache } from '@terrafirmagreg-team/data/lib/async-cache';
+import { dumpStatusSnapshot } from '@terrafirmagreg-team/data/lib/dump-status';
 import { loadLocaleRegistry, sortLangCodes } from '@terrafirmagreg-team/translate/server';
 import type { DatasetRef } from '@terrafirmagreg-team/sites/location';
 import { sectionTabs } from '@terrafirmagreg-team/sites/sections';
@@ -79,6 +80,30 @@ async function datasetMeta(
   return meta ? metaFields(meta) : {};
 }
 
+async function sectionDatasetMeta(
+  section: SectionKey,
+  id: string,
+): Promise<Omit<SectionDataset, 'id' | 'languages'>> {
+  const meta = await datasetMeta(section, id);
+  return Object.values(meta).some((value) => value !== undefined)
+    ? meta
+    : datasetMeta('docs', id);
+}
+
+const lastGoodDatasets = new Map<SectionKey, Map<string, SectionDataset>>();
+
+function rememberDataset(section: SectionKey, row: SectionDataset) {
+  let good = lastGoodDatasets.get(section);
+  if (!good) lastGoodDatasets.set(section, (good = new Map()));
+  good.set(row.id, row);
+}
+
+function datasetMembership(section: SectionKey, id: string): boolean {
+  const declared = sectionConfig().datasetConfig[id]?.sections;
+  if (declared) return declared.includes(section);
+  return lastGoodDatasets.get(section)?.has(id) === true;
+}
+
 function metaFields(
   meta: Record<string, unknown>,
 ): Omit<SectionDataset, 'id' | 'languages'> {
@@ -144,56 +169,69 @@ async function dumpDatasets(
 ): Promise<SectionDataset[]> {
   const dump = sectionConfig().dump;
   if (!dump) return [];
-  const refs = await dump.discoverDatasets();
+  const refs = await dump.discoverDatasets().catch(() => [] as DatasetRef[]);
   const versions = new Map<string, string[]>();
-  for (const ref of refs) {
-    const { id, version } = ref;
-    if (version) {
-      const list = versions.get(id) ?? [];
-      list.push(version);
-      versions.set(id, list);
+  const ids: string[] = [];
+  if (refs.length) {
+    for (const ref of refs) {
+      const { id, version } = ref;
+      if (version) {
+        const list = versions.get(id) ?? [];
+        list.push(version);
+        versions.set(id, list);
+      } else {
+        ids.push(id);
+      }
+    }
+  } else {
+    for (const id of Object.keys(sectionConfig().datasetConfig)) {
+      if (datasetMembership(section, id)) ids.push(id);
     }
   }
-  const ids = refs.filter((ref) => !ref.version);
-  const usable = await Promise.all(
-    ids.map(async (ref) => {
-      const { id } = ref;
-      const index = await dump.loadDataset(ref);
-      if (!index || !hasContent(index)) return null;
-      return {
-        id,
-        languages: datasetLanguages(index.manifest.languages ?? []),
-      };
-    }),
-  );
   return (
     await Promise.all(
-      usable
-        .filter((row): row is { id: string; languages: Lang[] } => row !== null)
-        .map(async ({ id, languages }) => ({
+      ids.map(async (id): Promise<SectionDataset | null> => {
+        const index = await dump.loadDataset({ id }).catch(() => null);
+        if (!index) {
+          if (dumpStatusSnapshot().statuses[id]?.status !== 'failed')
+            return null;
+          const good = lastGoodDatasets.get(section)?.get(id);
+          if (good) return good;
+          if (!datasetMembership(section, id)) return null;
+          return {
+            id,
+            languages: datasetLanguages([]),
+            ...(await sectionDatasetMeta(section, id)),
+            ...datasetAppearance(id),
+          };
+        }
+        if (!hasContent(index)) return null;
+        const row: SectionDataset = {
           id,
-          languages,
+          languages: datasetLanguages(index.manifest.languages ?? []),
           ...(versions.get(id)?.length
             ? { versions: versions.get(id)!.sort(compareVersions).reverse() }
             : {}),
-          ...(await datasetMeta(section, id).then((meta) =>
-            Object.values(meta).some((value) => value !== undefined)
-              ? meta
-              : datasetMeta('docs', id),
-          )),
+          ...(await sectionDatasetMeta(section, id)),
           ...datasetAppearance(id),
-        })),
-      )
-  ).sort(datasetOrder);
+        };
+        rememberDataset(section, row);
+        return row;
+      }),
+    )
+  )
+    .filter((row): row is SectionDataset => row !== null)
+    .sort(datasetOrder);
 }
 
 export function sectionDatasets(
   section: SectionKey,
 ): Promise<SectionDataset[]> {
   const hasContent = sectionConfig().dump?.hasContent[section];
-  return hasContent
+  const promise = hasContent
     ? dumpSectionDatasets(section, hasContent)
     : contentSectionDatasetsCached(section);
+  return promise.catch(() => []);
 }
 
 export async function defaultDataset(
@@ -228,7 +266,8 @@ const datasetCatalogCached = createAsyncCache(
   async (): Promise<DatasetCatalog> =>
     Promise.all(
       sectionTabs.map(
-        async ({ key }) => [key, await sectionDatasets(key)] as const,
+        async ({ key }) =>
+          [key, await sectionDatasets(key).catch(() => [])] as const,
       ),
     ).then((rows) => Object.fromEntries(rows) as DatasetCatalog),
   () => 'catalog',

package/src/lib/toc-title.ts

@@ -8,6 +8,27 @@ import {
   type ReactNode,
 } from 'react';
 
+function isPresentation(element: ReactElement): boolean {
+  const props = element.props as Record<string, unknown>;
+  if (props['data-md'] !== undefined) return true;
+  const type = element.type as { mdPresentation?: boolean } | string;
+  return typeof type !== 'string' && type.mdPresentation === true;
+}
+
+function textOf(node: ReactNode): string {
+  return Children.toArray(node)
+    .map((child) => {
+      if (typeof child === 'string' || typeof child === 'number')
+        return String(child);
+      if (isValidElement(child)) {
+        const element = child as ReactElement<{ children?: ReactNode }>;
+        return textOf(element.props.children);
+      }
+      return '';
+    })
+    .join('');
+}
+
 function unwrap(node: ReactNode): ReactNode {
   return Children.map(node, (child) => {
     if (!isValidElement(child)) return child;
@@ -15,6 +36,7 @@ function unwrap(node: ReactNode): ReactNode {
       href?: unknown;
       children?: ReactNode;
     }>;
+    if (isPresentation(element)) return textOf(element.props.children);
     if (element.props.href !== undefined) {
       return unwrap(element.props.children);
     }

package/src/lib/urls.ts

@@ -15,3 +15,12 @@ export function getDatasetImageUrl(section: string, dataset: string) {
   };
 }
 
+export function createGitFileUrl(git: {
+  user: string;
+  repo: string;
+  branch: string;
+}) {
+  return (filePath: string) =>
+    `https://github.com/${git.user}/${git.repo}/blob/${git.branch}/${filePath}`;
+}
+

package/src/types/features.ts

@@ -8,6 +8,7 @@ export interface SectionPageContext {
   datasetId?: string;
   copied?: TranslationState;
   history?: boolean;
+  exports?: Record<string, unknown>;
 }
 
 export interface SectionFeatures {