@terrafirmagreg-team/guide 0.1.0 → 1.2.1

package/package.json

@@ -1,40 +1,41 @@
 {
   "name": "@terrafirmagreg-team/guide",
-  "version": "0.1.0",
+  "version": "1.2.1",
   "type": "module",
+  "description": "Guide/books section",
+  "license": "LGPL-3.0-only",
   "exports": {
     "./components/*": [
       "./src/components/*.tsx",
-      "./src/components/*.ts",
       "./src/components/*/index.tsx",
       "./src/components/*/index.ts"
     ],
     "./hooks/*": [
       "./src/hooks/*.ts",
-      "./src/hooks/*.tsx",
-      "./src/hooks/*/index.ts",
-      "./src/hooks/*/index.tsx"
+      "./src/hooks/*/index.ts"
     ],
     "./lib/*": [
       "./src/lib/*.ts",
-      "./src/lib/*.tsx",
-      "./src/lib/*/index.ts",
-      "./src/lib/*/index.tsx"
+      "./src/lib/*/index.ts"
     ],
     "./types/*": "./src/types/*.ts",
     "./types": "./src/types/index.ts",
     "./locales": "./src/locales.ts"
   },
   "dependencies": {
+    "@terrafirmagreg-team/data": "1.2.1",
+    "@terrafirmagreg-team/discussions": "1.2.1",
+    "@terrafirmagreg-team/dump": "1.2.1",
+    "@terrafirmagreg-team/game": "1.2.1",
+    "@terrafirmagreg-team/kit": "1.2.1",
+    "@terrafirmagreg-team/mdx": "1.2.1",
+    "@terrafirmagreg-team/preview": "1.2.1",
+    "@terrafirmagreg-team/search": "1.2.1",
+    "@terrafirmagreg-team/sites": "1.2.1",
+    "@terrafirmagreg-team/translate": "1.2.1",
+    "@terrafirmagreg-team/ui": "1.2.1",
     "fumadocs-core": "16.17.8",
-    "lucide-react": "^1.63.0",
-    "@terrafirmagreg-team/game": "0.1.0",
-    "@terrafirmagreg-team/quest": "0.1.0",
-    "@terrafirmagreg-team/recipe": "0.1.0",
-    "@terrafirmagreg-team/translate": "0.1.0",
-    "@terrafirmagreg-team/ui": "0.1.0",
-    "@terrafirmagreg-team/kit": "0.1.0",
-    "@terrafirmagreg-team/comments": "0.1.0"
+    "lucide-react": "^0.577.0"
   },
   "peerDependencies": {
     "next": ">=15",
@@ -54,8 +55,6 @@
     "access": "public"
   },
   "files": [
-    "src",
-    "styles",
-    "styles.css"
+    "src"
   ]
 }

package/src/components/book-switcher.tsx

@@ -1,15 +1,16 @@
 'use client';
 
 import { usePathname } from 'next/navigation';
+import { useMemo } from 'react';
 import { BookOpen } from 'lucide-react';
 import { useAsyncValue } from '@terrafirmagreg-team/ui/hooks/use-async-value';
 import { useTranslations } from '@terrafirmagreg-team/translate/hooks/use-translations';
 import { useResolvedLang } from '@terrafirmagreg-team/translate/hooks/use-resolved-lang';
-import { useLocationSearch } from '@terrafirmagreg-team/ui/hooks/page/use-location-search';
+import { useLocationSearchParams } from '@terrafirmagreg-team/ui/hooks/page/use-location-search';
 import { guideQueryFromParams } from '@terrafirmagreg-team/guide/lib/query';
 import { listGuideBooks } from '@terrafirmagreg-team/guide/lib/books';
 import { guideHref } from '@terrafirmagreg-team/guide/lib/links';
-import { parseSectionLocation } from '@terrafirmagreg-team/kit/lib/location';
+import { parseSectionLocation } from '@terrafirmagreg-team/sites/location';
 import { Switcher } from '@terrafirmagreg-team/ui/components/blocks/nav/switcher';
 
 function oneLineLanding(text: string | undefined) {
@@ -20,10 +21,14 @@ function oneLineLanding(text: string | undefined) {
 
 export function GuideBookSwitcher() {
   const t = useTranslations();
-  const { dataset } = parseSectionLocation(usePathname());
+  const { dataset: datasetId } = parseSectionLocation(usePathname());
   const lang = useResolvedLang();
-  const { bookId } = guideQueryFromParams(
-    new URLSearchParams(useLocationSearch()),
+  const params = useLocationSearchParams();
+  const { bookId } = guideQueryFromParams(params);
+  const version = params.get('version') ?? undefined;
+  const dataset = useMemo(
+    () => (datasetId ? { id: datasetId, version } : undefined),
+    [datasetId, version],
   );
   const books = useAsyncValue(
     dataset ? () => listGuideBooks(dataset, lang) : undefined,
@@ -40,7 +45,8 @@ export function GuideBookSwitcher() {
         url: guideHref(dataset, lang, book.bookId),
       }))}
       selected={bookId}
-      placeholder={t('ui.select_book')}
+      placeholder={t('Select book', { note: 'ui.select_book' })}
     />
   );
 }
+

package/src/components/mdx/guide-entry.tsx

@@ -0,0 +1,48 @@
+'use client';
+
+import { usePathname } from 'next/navigation';
+import { useContext } from 'react';
+import { parseSectionLocation } from '@terrafirmagreg-team/sites/location';
+import { Entry } from '@terrafirmagreg-team/game/components/entry/entry';
+import { useEntryContext } from '@terrafirmagreg-team/game/hooks/use-entry-context';
+import { ResolvedLangContext } from '@terrafirmagreg-team/translate/hooks/use-resolved-lang';
+import { useAsyncValue } from '@terrafirmagreg-team/ui/hooks/use-async-value';
+import { findClientGuideEntry } from '@terrafirmagreg-team/guide/lib/client/guides';
+import type { GuideDirectiveProps } from '@terrafirmagreg-team/game/types/entry';
+
+export function GuideEntry({
+  id,
+  dataset: datasetProp,
+  name,
+  modId,
+  bookPath,
+  entry: entryOpt,
+  ...rest
+}: GuideDirectiveProps) {
+  const ctx = useEntryContext();
+  const pathname = usePathname();
+  const locId = parseSectionLocation(pathname).dataset;
+  const dataset =
+    datasetProp ?? ctx?.dataset ?? (locId ? { id: locId } : undefined);
+  const lang = useContext(ResolvedLangContext)?.lang;
+  const hit = useAsyncValue(
+    dataset && lang && id
+      ? () => findClientGuideEntry(dataset, lang, id)
+      : false,
+    [dataset, lang, id],
+  );
+  return (
+    <Entry
+      kind="guide"
+      id={hit?.entry.id ?? id}
+      dataset={dataset}
+      name={name ?? hit?.entry.name}
+      icon={hit?.entry.icon}
+      modId={modId ?? hit?.modId}
+      bookPath={bookPath ?? hit?.bookPath}
+      entry={entryOpt ?? hit?.entry.id}
+      {...rest}
+    />
+  );
+}
+

package/src/components/mdx/multiblock.tsx

@@ -0,0 +1,86 @@
+'use client';
+
+import { useContext, useMemo } from 'react';
+import { usePathname } from 'next/navigation';
+import {
+  type DatasetRef,
+  parseSectionLocation,
+} from '@terrafirmagreg-team/sites/location';
+import { useAsyncValue } from '@terrafirmagreg-team/ui/hooks/use-async-value';
+import { useDumpLocation } from '@terrafirmagreg-team/game/hooks/use-dump-location';
+import { ResolvedLangContext } from '@terrafirmagreg-team/translate/hooks/use-resolved-lang';
+import { createDumpAssetResolver } from '@terrafirmagreg-team/dump/lib/dump/assets/urls';
+import { asMultiblock } from '@terrafirmagreg-team/guide/lib/meta';
+import { glbFor } from '@terrafirmagreg-team/guide/lib/multiblock/url';
+import { loadMultiblockNameIndex } from '@terrafirmagreg-team/guide/lib/client/guides';
+import { multiblockKey } from '@terrafirmagreg-team/guide/lib/multiblock';
+import { MultiblockVisual } from '@terrafirmagreg-team/guide/components/views/kind/media';
+import type { GuideMultiblock } from '@terrafirmagreg-team/guide/types';
+
+export type MdxMultiblockProps = {
+  id?: string;
+  name?: string;
+  spec?: string;
+  label?: string;
+  dataset?: DatasetRef;
+  title?: string;
+};
+
+export function MdxMultiblock({
+  id,
+  name,
+  spec,
+  label,
+  dataset: datasetProp,
+  title,
+}: MdxMultiblockProps) {
+  const pathname = usePathname();
+  const locId = parseSectionLocation(pathname).dataset;
+  const dataset = useMemo<DatasetRef>(
+    () => datasetProp ?? { id: locId ?? '' },
+    [datasetProp, locId],
+  );
+  const lang = useContext(ResolvedLangContext)?.lang;
+  const dumpLoc = useDumpLocation(dataset);
+  const resolveResource = useMemo(
+    () => createDumpAssetResolver(dataset),
+    [dataset],
+  );
+  const namedSpec = useAsyncValue(
+    dataset && lang && name
+      ? async () =>
+          (await loadMultiblockNameIndex(dataset, lang))[
+            name.trim().toLowerCase()
+          ]
+      : false,
+    [dataset, lang, name],
+  );
+  const value = useMemo<string | GuideMultiblock | undefined>(() => {
+    if (spec) {
+      try {
+        return JSON.parse(spec) as GuideMultiblock;
+      } catch {
+        return undefined;
+      }
+    }
+    if (name) return namedSpec;
+    return id;
+  }, [id, name, spec, namedSpec]);
+  const key = multiblockKey(asMultiblock(value));
+  const src = useAsyncValue(
+    dataset && key
+      ? () => glbFor(dataset, '', asMultiblock(value), lang)
+      : false,
+    [dataset, key, lang, dumpLoc],
+  );
+  const glbs = src && key ? { [key]: src } : undefined;
+  return (
+    <MultiblockVisual
+      value={value}
+      title={title ?? label ?? id ?? name}
+      glbs={glbs}
+      resolveResource={resolveResource}
+    />
+  );
+}
+

package/src/{lib/tree/children.ts → components/tree/children.tsx}

@@ -2,13 +2,17 @@ import { createElement } from 'react';
 import type * as PageTree from 'fumadocs-core/page-tree';
 import { Entry } from '@terrafirmagreg-team/game/components/entry/entry';
 import { encodeQueryValue } from '@terrafirmagreg-team/translate/lib/url';
-import { sectionUrl } from '@terrafirmagreg-team/kit/lib/location';
+import {
+  type DatasetRef,
+  sectionUrl,
+  versionSuffix,
+} from '@terrafirmagreg-team/sites/location';
 import { bookOptionId, guideCategoryHref } from '@terrafirmagreg-team/guide/lib/paths';
 import type { GuideIndex } from '@terrafirmagreg-team/guide/types';
-import type { TaggedReference } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import type { TaggedReference } from '@terrafirmagreg-team/dump/lib/dump/contract/ref';
 
 function nodeIcon(
-  dataset: string,
+  dataset: DatasetRef,
   icon: TaggedReference | undefined,
   name: string,
 ): React.ReactNode {
@@ -34,7 +38,7 @@ function nodeIcon(
 }
 
 export function guideTreeChildren(
-  dataset: string,
+  dataset: DatasetRef,
   index: GuideIndex,
 ): PageTree.Node[] {
   const bookId =
@@ -56,15 +60,16 @@ export function guideTreeChildren(
         index.bookPath ?? '',
         category,
       ),
-      $id: `${dataset}/${index.modId}/${index.bookPath}/${category.id}#index`,
+      $id: `${dataset.id}/${dataset.version ?? ''}/${index.modId}/${index.bookPath}/${category.id}#index`,
     },
-    $id: `${dataset}/${index.modId}/${index.bookPath}/${category.id}`,
+    $id: `${dataset.id}/${dataset.version ?? ''}/${index.modId}/${index.bookPath}/${category.id}`,
     children: category.entries.map((entry): PageTree.Item => ({
       type: 'page',
       name: entry.name,
-      url: `${sectionUrl('guide', dataset)}?book=${encodeQueryValue(bookId ?? '')}&entry=${encodeQueryValue(entry.id)}`,
+      url: `${sectionUrl('guide', dataset.id)}?book=${encodeQueryValue(bookId ?? '')}&entry=${encodeQueryValue(entry.id)}${versionSuffix(dataset)}`,
       icon: nodeIcon(dataset, entry.icon, entry.name),
-      $id: `${dataset}/${index.modId}/${index.bookPath}/${category.id}/${entry.id}`,
+      $id: `${dataset.id}/${dataset.version ?? ''}/${index.modId}/${index.bookPath}/${category.id}/${entry.id}`,
     })),
   }));
 }
+

package/src/{lib/tree/index.ts → components/tree/index.tsx}

@@ -2,14 +2,20 @@ import 'server-only';
 import { createElement } from 'react';
 import type * as PageTree from 'fumadocs-core/page-tree';
 import { Entry } from '@terrafirmagreg-team/game/components/entry/entry';
-import { loadMergedLangMap } from '@terrafirmagreg-team/game/lib/dump/assets/lang/load';
-import { asRecord, asString } from '@terrafirmagreg-team/game/lib/dump/contract/read';
-import { loadDatasetDump } from '@terrafirmagreg-team/game/lib/dump/mods/load';
-import { clientDumpJson } from '@terrafirmagreg-team/game/lib/dump/client/dump';
+import { loadMergedLangMap } from '@terrafirmagreg-team/dump/lib/dump/assets/lang/load';
+import { asRecord, asString } from '@terrafirmagreg-team/dump/lib/dump/contract/read';
+import { loadDatasetDump } from '@terrafirmagreg-team/dump/lib/dump/mods/load';
+import { DUMP_POINTER_TTL } from '@terrafirmagreg-team/dump/lib/dump/json-reader';
+import { createAsyncCache } from '@terrafirmagreg-team/data/lib/async-cache';
+import { clientDumpJson } from '@terrafirmagreg-team/dump/lib/dump/client/dump';
 import { keyTreeNode } from '@terrafirmagreg-team/translate/server';
 import { loadLocaleRegistry } from '@terrafirmagreg-team/translate/server';
 import { encodeQueryValue } from '@terrafirmagreg-team/translate/lib/url';
-import { sectionUrl } from '@terrafirmagreg-team/kit/lib/location';
+import {
+  type DatasetRef,
+  sectionUrl,
+  versionSuffix,
+} from '@terrafirmagreg-team/sites/location';
 import { bookOptionId } from '@terrafirmagreg-team/guide/lib/paths';
 import { bookSlug, toBook } from '@terrafirmagreg-team/guide/lib/book';
 import { sectionDatasets } from '@terrafirmagreg-team/kit/lib/datasets';
@@ -17,7 +23,7 @@ import type { GuideBookJson, GuideBookRef } from '@terrafirmagreg-team/guide/lib
 import type { SectionTrees } from '@terrafirmagreg-team/kit/types';
 
 function bookIcon(
-  dataset: string,
+  dataset: DatasetRef,
   raw: GuideBookJson | undefined,
 ): React.ReactNode {
   const cover = asRecord(raw?.cover);
@@ -43,7 +49,7 @@ function bookIcon(
 }
 
 function bookLeaf(
-  dataset: string,
+  dataset: DatasetRef,
   ref: GuideBookRef,
   slug: string,
   raw: GuideBookJson | undefined,
@@ -54,14 +60,14 @@ function bookLeaf(
   return keyTreeNode({
     type: 'page',
     name: book.name,
-    url: `${sectionUrl('guide', dataset)}?book=${encodeQueryValue(bookId)}`,
+    url: `${sectionUrl('guide', dataset.id)}?book=${encodeQueryValue(bookId)}${versionSuffix(dataset)}`,
     icon: bookIcon(dataset, raw),
-    $id: `${dataset}/book/${bookId}`,
+    $id: `${dataset.id}/${dataset.version ?? ''}/book/${bookId}`,
   }) as PageTree.Item;
 }
 
 async function datasetBookLeaves(
-  dataset: string,
+  dataset: DatasetRef,
   langMap: Record<string, string>,
 ): Promise<PageTree.Node[]> {
   const dump = await loadDatasetDump(dataset);
@@ -92,11 +98,14 @@ async function datasetBookLeaves(
   return leaves;
 }
 
-let cached: Promise<SectionTrees> | undefined;
+const guideTreesCache = createAsyncCache(
+  async (): Promise<SectionTrees> => buildGuideTrees(),
+  () => 'guide-trees',
+  DUMP_POINTER_TTL,
+);
 
 export function guideTrees(): Promise<SectionTrees> {
-  cached ??= buildGuideTrees();
-  return cached;
+  return guideTreesCache();
 }
 
 async function buildGuideTrees(): Promise<SectionTrees> {
@@ -105,13 +114,14 @@ async function buildGuideTrees(): Promise<SectionTrees> {
   const trees: SectionTrees = {};
   for (const { id, title: datasetTitle, languages } of datasets) {
     for (const lang of languages ?? [defaultLanguage]) {
-      const map = await loadMergedLangMap(id, lang);
+      const map = await loadMergedLangMap({ id }, lang);
       (trees[lang] ??= {})[id] = {
         name: datasetTitle ?? id,
-        children: await datasetBookLeaves(id, map),
+        children: await datasetBookLeaves({ id }, map),
         $id: `guide/${id}/${lang}`,
       } satisfies PageTree.Root;
     }
   }
   return trees;
 }
+

package/src/components/views/browser.tsx

@@ -1,8 +1,9 @@
 'use client';
-
 import { useEffect, useMemo } from 'react';
-import { useRouter, useSearchParams } from 'next/navigation';
+import { useRouter } from 'next/navigation';
+import { useLocationSearchParams } from '@terrafirmagreg-team/ui/hooks/page/use-location-search';
 import { useAsyncValue } from '@terrafirmagreg-team/ui/hooks/use-async-value';
+import { useVersionedDataset } from '@terrafirmagreg-team/kit/hooks/use-versioned-dataset';
 import { useLangMap } from '@terrafirmagreg-team/game/hooks/use-lang-map';
 import { useTranslations } from '@terrafirmagreg-team/translate/hooks/use-translations';
 import { Skeleton } from '@terrafirmagreg-team/ui/components/ui/skeleton';
@@ -23,30 +24,21 @@ import { guideConfig } from '@terrafirmagreg-team/guide/lib/config';
 import type { Lang } from '@terrafirmagreg-team/translate/types/locale';
 import type { GuideMessages } from '@terrafirmagreg-team/guide/types';
 
-const MESSAGE_KEYS: readonly string[] = [
-  'guide.related',
-  'guide.objective',
-  'guide.link',
-  'guide.quest',
-  'guide.recipe_empty',
-  'guide.entity_unavailable',
-  'guide.entry_missing',
-  'guide.entry_count',
-  'guide.page_count',
-];
-
 export function GuideBrowser({
-  dataset,
+  dataset: id,
   datasetTitle,
   lang,
+  versions,
 }: {
   dataset: string;
   datasetTitle: string;
   lang: Lang;
+  versions?: readonly string[];
 }) {
   const t = useTranslations();
   const router = useRouter();
-  const params = useSearchParams();
+  const params = useLocationSearchParams();
+  const dataset = useVersionedDataset(id, { versions }) ?? { id };
   const { bookId, entryId, categoryId } = useMemo(
     () => guideQueryFromParams(params),
     [params],
@@ -57,7 +49,23 @@ export function GuideBrowser({
   );
   const langMap = useLangMap(dataset, lang);
   const messages = useMemo<GuideMessages>(
-    () => Object.fromEntries(MESSAGE_KEYS.map((key) => [key, t(key)])),
+    () => ({
+      'guide.related': t('Related', { note: 'guide.related' }),
+      'guide.objective': t('Objective', { note: 'guide.objective' }),
+      'guide.link': t('Open', { note: 'guide.link' }),
+      'guide.quest': t('Quest', { note: 'guide.quest' }),
+      'guide.recipe_empty': t('No recipes', { note: 'guide.recipe_empty' }),
+      'guide.entity_unavailable': t('Entity preview unavailable', {
+        note: 'guide.entity_unavailable',
+      }),
+      'guide.entry_missing': t('Entry not found', {
+        note: 'guide.entry_missing',
+      }),
+      'guide.entry_count': t('{count} entries', {
+        note: 'guide.entry_count',
+      }),
+      'guide.page_count': t('{count} pages', { note: 'guide.page_count' }),
+    }),
     [t],
   );
 
@@ -122,3 +130,4 @@ export function GuideBrowser({
   }
   return <GuidePageView payload={payload} langMap={langMap} />;
 }
+

package/src/components/views/entry/pages.tsx

@@ -1,3 +1,4 @@
+import type { DatasetRef } from '@terrafirmagreg-team/sites/location';
 import type { ReactNode } from 'react';
 import { PageText } from '@terrafirmagreg-team/guide/components/views/page/text';
 import {
@@ -19,7 +20,7 @@ import {
 import { TablePage } from '@terrafirmagreg-team/guide/components/views/kind/table';
 import { UnknownPage } from '@terrafirmagreg-team/guide/components/views/kind/unknown';
 import type { PageRendererProps } from '@terrafirmagreg-team/guide/types';
-import type { AtlasBundle } from '@terrafirmagreg-team/game/lib/dump/assets/atlas/dto';
+import type { AtlasBundle } from '@terrafirmagreg-team/dump/lib/dump/assets/atlas/dto';
 import type { Lang } from '@terrafirmagreg-team/translate/types/locale';
 import { guideMessage } from '@terrafirmagreg-team/guide/lib/messages';
 import type { PagePreviewData } from '@terrafirmagreg-team/ui/types/preview';
@@ -79,7 +80,7 @@ export function EntryPages({
   previews,
   messages,
 }: {
-  dataset: string;
+  dataset: DatasetRef;
   lang: Lang;
   bookPath: string;
   pages: GuidePage[];
@@ -184,3 +185,4 @@ export function EntryPages({
     </div>
   );
 }
+

package/src/components/views/entry/view.tsx

@@ -1,3 +1,4 @@
+import type { DatasetRef } from '@terrafirmagreg-team/sites/location';
 import { EntryPages } from '@terrafirmagreg-team/guide/components/views/entry/pages';
 import type { PagePreviewData } from '@terrafirmagreg-team/ui/types/preview';
 import type { Lang } from '@terrafirmagreg-team/translate/types/locale';
@@ -24,7 +25,7 @@ export function EntryView({
   previews,
   messages,
 }: {
-  dataset: string;
+  dataset: DatasetRef;
   lang: Lang;
   bookPath: string;
   entry: GuideEntry;
@@ -58,3 +59,4 @@ export function EntryView({
     />
   );
 }
+

package/src/components/views/kind/links.tsx

@@ -1,6 +1,6 @@
 import { LinkPreview } from '@terrafirmagreg-team/ui/components/blocks/link/link-preview';
 import { Entry } from '@terrafirmagreg-team/game/components/entry/entry';
-import { questHref } from '@terrafirmagreg-team/quest/lib/links';
+import { guideEmbeds } from '@terrafirmagreg-team/guide/lib/embeds';
 import { guideMessage } from '@terrafirmagreg-team/guide/lib/messages';
 import {
   entryLabel,
@@ -92,7 +92,7 @@ export function QuestPage({
   const id = page.trigger || page.quest || page.link;
   const hit = id ? questLinks?.[parseGuideReference(id).id] : undefined;
   const href = hit
-    ? questHref(dataset, lang, { category: hit.filename, id: hit.questId })
+    ? guideEmbeds().quest?.href(dataset, lang, { category: hit.filename, id: hit.questId })
     : undefined;
   const name = id ? spriteName(dataset, langMap, atlases, id) : '—';
   const label = id && name !== id ? name : <code>{name}</code>;
@@ -109,3 +109,4 @@ export function QuestPage({
     </p>
   );
 }
+

package/src/components/views/kind/media.tsx

@@ -5,11 +5,11 @@ import { asMultiblock } from '@terrafirmagreg-team/guide/lib/meta';
 import {
   createDumpAssetResolver,
   texturePublicUrl,
-} from '@terrafirmagreg-team/game/lib/dump/assets/urls';
-import { dumpRelPublicUrl } from '@terrafirmagreg-team/game/lib/dump/paths';
-import { parseStackId } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
-import { langString } from '@terrafirmagreg-team/game/lib/dump/assets/lang/names';
-import { matchVariant } from '@terrafirmagreg-team/game/lib/dump/data/registry/parse';
+} from '@terrafirmagreg-team/dump/lib/dump/assets/urls';
+import { dumpRelPublicUrl } from '@terrafirmagreg-team/dump/lib/dump/paths';
+import { parseStackId } from '@terrafirmagreg-team/dump/lib/dump/contract/ref';
+import { langString } from '@terrafirmagreg-team/dump/lib/dump/assets/lang/names';
+import { matchVariant } from '@terrafirmagreg-team/dump/lib/dump/data/registry/parse';
 import { GlbViewer } from '@terrafirmagreg-team/ui/components/blocks/media/glb/viewer';
 import { multiblockKey } from '@terrafirmagreg-team/guide/lib/multiblock';
 import { guideFormatOpts } from '@terrafirmagreg-team/guide/lib/format';
@@ -165,3 +165,4 @@ export function MultiMultiblockPage({
     <MissingVisual title={page.name} />
   );
 }
+

package/src/components/views/kind/recipe.tsx

@@ -1,11 +1,7 @@
 'use client';
-
-import { useState } from 'react';
-import Link from 'next/link';
 import { Card } from '@terrafirmagreg-team/ui/components/ui/card';
 import { EmptyState } from '@terrafirmagreg-team/ui/components/blocks/page/empty-state';
-import { PagedCard } from '@terrafirmagreg-team/recipe/components/cards/paged-card';
-import { FitCard } from '@terrafirmagreg-team/recipe/components/cards/fit-card';
+import { guideEmbeds } from '@terrafirmagreg-team/guide/lib/embeds';
 import { Entry } from '@terrafirmagreg-team/game/components/entry/entry';
 import { EntryList } from '@terrafirmagreg-team/game/components/entry/list';
 import { guideMessage } from '@terrafirmagreg-team/guide/lib/messages';
@@ -13,51 +9,8 @@ import { collectItemIds } from '@terrafirmagreg-team/guide/lib/data/parse';
 import { pageTitle } from '@terrafirmagreg-team/guide/lib/toc';
 import { spriteName } from '@terrafirmagreg-team/guide/lib/names';
 import { recipeIds, recipeNameScope } from '@terrafirmagreg-team/guide/lib/recipe';
-import { recipeHref } from '@terrafirmagreg-team/recipe/lib/links';
-import { recipeCardImageUrl } from '@terrafirmagreg-team/recipe/lib/links';
-import { recipeImageUrl } from '@terrafirmagreg-team/game/lib/dump/assets/urls';
-import { recipeTitle } from '@terrafirmagreg-team/recipe/lib/data/parse';
-import type { Recipe } from '@terrafirmagreg-team/recipe/lib/data/dto';
-import type { PageRendererProps } from '@terrafirmagreg-team/guide/types';
 
-function GuideRecipeCard({
-  id,
-  recipe,
-  dataset,
-  lang,
-  langMap,
-}: {
-  id: string;
-  recipe: Recipe;
-  dataset: string;
-  lang: string;
-  langMap: Record<string, string>;
-}) {
-  const [failed, setFailed] = useState(false);
-  if (failed) return null;
-  const src =
-    recipeImageUrl(dataset, recipe) ?? recipeCardImageUrl(dataset, id);
-  if (!src) return null;
-  const title = recipeTitle(recipe, langMap);
-  return (
-    <Link
-      href={recipeHref(dataset, lang, { id })}
-      className="not-prose block w-fit max-w-full"
-    >
-      <FitCard w={recipe.w ?? 0}>
-        <PagedCard
-          recipe={recipe}
-          dataset={dataset}
-          lang={lang}
-          langMap={langMap}
-          title={title}
-          src={src}
-          onFail={() => setFailed(true)}
-        />
-      </FitCard>
-    </Link>
-  );
-}
+import type { PageRendererProps } from '@terrafirmagreg-team/guide/types';
 
 export function RecipePage({
   dataset,
@@ -76,13 +29,14 @@ export function RecipePage({
       </EmptyState>
     );
   }
+  const RecipeCard = guideEmbeds().recipe?.Card;
   return (
     <div className="space-y-4">
       {ids.map((id) => {
         const recipe = extras?.recipes?.[id];
-        if (recipe) {
+        if (recipe && RecipeCard) {
           return (
-            <GuideRecipeCard
+            <RecipeCard
               key={id}
               id={id}
               recipe={recipe}
@@ -132,3 +86,4 @@ export function SpotlightPage({
     />
   );
 }
+