@terrafirmagreg-team/game 0.0.0-stage → 0.1.0

package/src/lib/entry/href.ts

@@ -0,0 +1,148 @@
+import { sectionUrl } from '@terrafirmagreg-team/kit/lib/location';
+import { encodeQuery, withLang } from '@terrafirmagreg-team/translate/lib/url';
+import { tagPseudoId } from '@terrafirmagreg-team/game/lib/dump/paths';
+import { refId, tagKindOf } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import type { TaggedReference } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import type { Lang } from '@terrafirmagreg-team/translate/types/locale';
+import type { EntryHrefOpts } from '@terrafirmagreg-team/game/types/entry';
+
+export type { EntryHrefOpts } from '@terrafirmagreg-team/game/types/entry';
+
+const query = encodeQuery;
+
+function recipeHref(
+  dataset: string,
+  lang: Lang | undefined,
+  opts?: {
+    type?: string;
+    item?: string;
+    fluid?: string;
+    id?: string;
+    tab?: string;
+    search?: string;
+    rpage?: number;
+  },
+): string {
+  const q = query([
+    ['type', opts?.type],
+    ['item', opts?.item],
+    ['fluid', opts?.item ? undefined : opts?.fluid],
+    ['id', opts?.id],
+    ['tab', opts?.tab],
+    ['search', opts?.search],
+    ['rpage', opts?.rpage && opts.rpage > 1 ? Math.floor(opts.rpage) : undefined],
+  ]);
+  const base = sectionUrl('recipe', dataset);
+  const href = q ? `${base}?${q}` : base;
+  return lang ? withLang(href, lang) : href;
+}
+
+function recipeStackHref(
+  dataset: string,
+  lang: Lang | undefined,
+  id: string,
+  opts?: Pick<EntryHrefOpts, 'tab' | 'search'> & {
+    kind?: 'item' | 'fluid' | 'tag';
+    tagKind?: string;
+  },
+): string {
+  const kept = { tab: opts?.tab, search: opts?.search };
+  if (opts?.kind === 'tag' || id.startsWith('#')) {
+    const bare = id.startsWith('#') ? id.slice(1) : id;
+    return recipeHref(dataset, lang, {
+      type: 'emi:tag',
+      id: tagPseudoId(bare, opts?.tagKind ?? 'item'),
+      ...kept,
+    });
+  }
+  return opts?.kind === 'fluid'
+    ? recipeHref(dataset, lang, { fluid: id, ...kept })
+    : recipeHref(dataset, lang, { item: id, ...kept });
+}
+
+function questHref(
+  dataset: string,
+  lang: Lang | undefined,
+  opts?: { category?: string; id?: string; item?: string },
+): string {
+  const q = query([
+    ['category', opts?.category],
+    ['id', opts?.id],
+    ['item', opts?.item],
+  ]);
+  const base = sectionUrl('quest', dataset);
+  const href = q ? `${base}?${q}` : base;
+  return lang ? withLang(href, lang) : href;
+}
+
+export function guideHref(
+  dataset: string,
+  lang: Lang | undefined,
+  bookId?: string,
+  entryId?: string,
+  hash?: string,
+  categoryId?: string,
+): string {
+  const q = query([
+    ['book', bookId],
+    ['entry', entryId],
+    ['cat', entryId ? undefined : categoryId],
+  ]);
+  const base = `${sectionUrl('guide', dataset)}${q ? `?${q}` : ''}`;
+  const href = hash ? `${base}#${hash}` : base;
+  return lang ? withLang(href, lang) : href;
+}
+
+export function entryHref(
+  dataset: string,
+  lang: Lang | undefined,
+  reference: TaggedReference,
+  opts?: EntryHrefOpts,
+): string {
+  const kept = { tab: opts?.tab, search: opts?.search };
+  switch (reference.kind) {
+    case 'item':
+    case 'block':
+    case 'entity':
+      return recipeStackHref(dataset, lang, refId(reference), { ...kept, kind: 'item' });
+    case 'fluid':
+      return recipeStackHref(dataset, lang, refId(reference), { ...kept, kind: 'fluid' });
+    case 'itemTag':
+    case 'blockTag':
+    case 'fluidTag':
+    case 'entityTag':
+      return recipeStackHref(dataset, lang, refId(reference), {
+        ...kept,
+        kind: 'tag',
+        tagKind: tagKindOf(reference.kind),
+      });
+    case 'texture':
+    case 'model':
+      return '#';
+    case 'recipe':
+      return recipeHref(dataset, lang, {
+        id: reference.id,
+        ...kept,
+        rpage: opts?.rpage,
+        type: opts?.type,
+      });
+    case 'quest':
+      return questHref(dataset, lang, {
+        category: opts?.filename,
+        id: reference.id,
+      });
+    case 'guide':
+    case 'chapter':
+      return guideHref(
+        dataset,
+        lang,
+        opts?.modId && opts?.bookPath ? `${opts.modId}:${opts.bookPath}` : undefined,
+        opts?.entry ?? reference.id,
+        opts?.hash,
+      );
+    default: {
+      const _exhaustive: never = reference.kind;
+      return _exhaustive;
+    }
+  }
+}

package/src/lib/entry/icon-load.ts

@@ -0,0 +1,195 @@
+import type { AtlasBundle } from '@terrafirmagreg-team/game/lib/dump/assets/atlas/dto';
+import {
+  clientDumpJson,
+  clientRegistryDataFileRel,
+  clientTagFileRel,
+} from '@terrafirmagreg-team/game/lib/dump/client/dump';
+import { loadClientModAtlases } from '@terrafirmagreg-team/game/lib/dump/client/atlases';
+import { dumpRelPublicUrl, matchTagIndexKey } from '@terrafirmagreg-team/game/lib/dump/paths';
+import { lookupSpriteInBundle } from '@terrafirmagreg-team/game/lib/dump/assets/atlas/lookup';
+import { asIdTable, asRecord, asString } from '@terrafirmagreg-team/game/lib/dump/contract/read';
+import { asTaggedReference } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import { asEntry, matchVariant } from '@terrafirmagreg-team/game/lib/dump/data/registry/parse';
+import type { DumpEntityEntry } from '@terrafirmagreg-team/game/lib/dump/data/registry/dto';
+import { asTag, firstTagItem } from '@terrafirmagreg-team/game/lib/dump/data/tag/parse';
+import type { DumpNbt } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import type { DumpTag } from '@terrafirmagreg-team/game/lib/dump/data/tag/dto';
+import { createAsyncCache } from '@terrafirmagreg-team/ui/lib/utils/async-cache';
+
+export type { AtlasBundle } from '@terrafirmagreg-team/game/lib/dump/assets/atlas/dto';
+
+type TagMemberKind = 'item' | 'block' | 'fluid' | 'entity';
+
+const TAG_MEMBER_REGISTRY: Record<TagMemberKind, string> = {
+  item: 'items',
+  block: 'blocks',
+  fluid: 'fluids',
+  entity: 'entities',
+};
+
+export function fetchAtlases(
+  dataset: string,
+  modId: string,
+): Promise<AtlasBundle | null> {
+  return loadClientModAtlases(dataset, modId).then((bundle) =>
+    bundle.items || bundle.blocks ? bundle : null,
+  );
+}
+
+const fetchTagRecord = createAsyncCache(
+  async (dataset: string, tagId: string, memberKind: TagMemberKind) => {
+    const rel = await clientTagFileRel(dataset, tagId);
+    const entries = asRecord(await clientDumpJson(dataset, rel, 'high'));
+    if (!entries) return undefined;
+    const entryKey = matchTagIndexKey(
+      entries,
+      tagId,
+      TAG_MEMBER_REGISTRY[memberKind],
+    );
+    return entryKey !== undefined
+      ? asTag(entries[entryKey], entryKey, asIdTable(entries))
+      : undefined;
+  },
+);
+
+export function fetchTagItem(
+  dataset: string,
+  tagId: string,
+  memberKind: TagMemberKind,
+): Promise<string | null> {
+  return fetchTagRecord(dataset, tagId, memberKind).then(
+    (tag: DumpTag | undefined) => firstTagItem(tag) ?? null,
+  );
+}
+
+const TAG_ICON_MEMBER_LIMIT = 16;
+
+const TAG_ICON_SPRITE_KIND: Record<TagMemberKind, 'item' | 'fluid'> = {
+  item: 'item',
+  block: 'item',
+  fluid: 'fluid',
+  entity: 'item',
+};
+
+const fetchTagMembersList = createAsyncCache(
+  async (
+    dataset: string,
+    tagId: string,
+    memberKind: TagMemberKind,
+  ): Promise<string[]> => {
+    const tag = await fetchTagRecord(dataset, tagId, memberKind);
+    const members = (tag?.members ?? [])
+      .filter((member) => member && !member.startsWith('#'))
+      .slice(0, TAG_ICON_MEMBER_LIMIT);
+    if (!members.length) return [];
+    if (memberKind !== 'item' && memberKind !== 'block' && memberKind !== 'fluid') {
+      return members;
+    }
+    const spriteKind = TAG_ICON_SPRITE_KIND[memberKind];
+    const out: string[] = [];
+    for (const member of members) {
+      const itemId =
+        memberKind === 'block'
+          ? await fetchBlockItem(dataset, member)
+          : member;
+      const ns = itemId.split(':', 1)[0];
+      const bundle = ns ? await fetchAtlases(dataset, ns) : null;
+      if (lookupSpriteInBundle(bundle, { id: itemId, kind: spriteKind })) {
+        out.push(member);
+      }
+    }
+    return out.length ? out : [members[0]];
+  },
+);
+
+export function fetchTagMembers(
+  dataset: string,
+  tagId: string,
+  memberKind: TagMemberKind,
+): Promise<string[]> {
+  return fetchTagMembersList(dataset, tagId, memberKind);
+}
+
+const fetchBlockItem = createAsyncCache(
+  async (dataset: string, blockId: string): Promise<string> => {
+    const ns = blockId.split(':', 1)[0];
+    const rel = ns
+      ? await clientRegistryDataFileRel(dataset, ns, 'blocks')
+      : undefined;
+    const entries = rel
+      ? asRecord(await clientDumpJson(dataset, rel, 'high'))
+      : undefined;
+    const row = entries ? asRecord(entries[blockId]) : undefined;
+    const itemRef = row ? asTaggedReference(row.item) : undefined;
+    return asString(itemRef?.id) ?? blockId;
+  },
+);
+
+export function blockItemId(
+  dataset: string,
+  blockId: string,
+): Promise<string> {
+  return fetchBlockItem(dataset, blockId);
+}
+
+const fetchEntity = createAsyncCache(async (dataset: string, id: string) => {
+  const ns = id.split(':', 1)[0];
+  const rel = ns
+    ? await clientRegistryDataFileRel(dataset, ns, 'entities')
+    : undefined;
+  const entries = rel
+    ? asRecord(await clientDumpJson(dataset, rel, 'high'))
+    : undefined;
+  const raw = entries?.[id];
+  if (raw === undefined) return undefined;
+  const parsed = asEntry(raw, 'entities', id, asIdTable(entries ?? {}));
+  return parsed as DumpEntityEntry | undefined;
+});
+
+export async function fetchEntityTexture(
+  dataset: string,
+  id: string,
+  nbt?: DumpNbt,
+): Promise<string | null> {
+  const entity = await fetchEntity(dataset, id);
+  return entityTextureUrl(dataset, entity, id, nbt);
+}
+
+export function peekEntityTexture(
+  dataset: string,
+  id: string,
+  nbt?: DumpNbt,
+): string | null | undefined {
+  const entity = fetchEntity.peek(dataset, id);
+  return entity === undefined
+    ? undefined
+    : entityTextureUrl(dataset, entity, id, nbt);
+}
+
+export function peekTagMembers(
+  dataset: string,
+  tagId: string,
+  memberKind: TagMemberKind,
+): string[] | undefined {
+  return fetchTagMembersList.peek(dataset, tagId, memberKind);
+}
+
+export function peekBlockItem(
+  dataset: string,
+  blockId: string,
+): string | undefined {
+  return fetchBlockItem.peek(dataset, blockId);
+}
+
+function entityTextureUrl(
+  dataset: string,
+  entity: DumpEntityEntry | undefined,
+  id: string,
+  nbt?: DumpNbt,
+): string | null {
+  if (!entity) return null;
+  const texture = matchVariant(entity.variants, nbt)?.texture ?? entity.texture;
+  if (!texture) return null;
+  const ns = id.split(':', 1)[0];
+  return dumpRelPublicUrl(dataset, `assets/${ns}/${texture}`) ?? null;
+}

package/src/lib/entry/icon.ts

@@ -0,0 +1,10 @@
+import { tagKindOf } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import type { ReferenceKind } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+
+export function stackKindOf(
+  kind: ReferenceKind | undefined,
+): 'item' | 'block' | 'fluid' | undefined {
+  if (kind === 'item' || kind === 'block' || kind === 'fluid') return kind;
+  const member = tagKindOf(kind);
+  return member === 'entity' ? undefined : member;
+}

package/src/lib/entry/tooltip.ts

@@ -0,0 +1,60 @@
+import { displayOf } from '@terrafirmagreg-team/game/lib/dump/data/registry/parse';
+import { parseStackId } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import { clientDumpLang } from '@terrafirmagreg-team/game/lib/dump/client/dump';
+import {
+  clientRegistryKindFor,
+  loadClientRegistry,
+} from '@terrafirmagreg-team/game/lib/dump/client/registry';
+import type { DumpDisplay } from '@terrafirmagreg-team/game/lib/dump/contract/text';
+import { dumpTextLines } from '@terrafirmagreg-team/game/lib/dump/assets/lang/names';
+import { createAsyncCache } from '@terrafirmagreg-team/ui/lib/utils/async-cache';
+
+export const loadStackDisplay = createAsyncCache(
+  async (
+    dataset: string,
+    compactId: string,
+    kind?: 'item' | 'fluid' | 'entity',
+  ): Promise<DumpDisplay | undefined> => {
+    const parsed = parseStackId(compactId);
+    const ofKind = async (registry: 'items' | 'fluids') => {
+      const entry = (await loadClientRegistry(dataset, registry)).get(
+        parsed.id,
+      );
+      return entry ? displayOf(entry, parsed.nbt) : undefined;
+    };
+    if (kind) {
+      const entry = (
+        await loadClientRegistry(dataset, clientRegistryKindFor(kind))
+      ).get(parsed.id);
+      return entry ? displayOf(entry, parsed.nbt) : undefined;
+    }
+    return (await ofKind('items')) ?? (await ofKind('fluids'));
+  },
+);
+
+type StackTooltip = {
+  lines: string[];
+  mods: Record<string, string[]>;
+};
+
+export async function stackTooltip(
+  dataset: string,
+  id: string,
+  lang: string | undefined,
+  langMap: Record<string, string> | undefined,
+  kind: 'item' | 'fluid' | 'entity' | undefined,
+): Promise<StackTooltip> {
+  const display = await loadStackDisplay(dataset, id, kind);
+  const map =
+    langMap ?? (lang ? await clientDumpLang(dataset, lang) : undefined);
+  if (!display || !map) return { lines: [], mods: {} };
+  const mods: Record<string, string[]> = {};
+  for (const [mod, raw] of Object.entries(display.tooltipMods ?? {})) {
+    const resolved = dumpTextLines(map, raw);
+    if (resolved.length) mods[mod] = resolved;
+  }
+  return {
+    lines: display.tooltip?.length ? dumpTextLines(map, display.tooltip) : [],
+    mods,
+  };
+}

package/src/lib/preview.ts

@@ -0,0 +1,18 @@
+import {
+  stackIdFromRef,
+  type TaggedReference,
+} from '@terrafirmagreg-team/game/lib/dump/contract/ref';
+import type { PreviewIcon } from '@terrafirmagreg-team/ui/types/preview';
+
+export function entryPreviewIcon(
+  ref: TaggedReference | undefined,
+  dataset: string,
+): PreviewIcon | undefined {
+  if (!ref) return undefined;
+  return {
+    type: 'entry',
+    kind: ref.kind,
+    id: stackIdFromRef(ref),
+    dataset,
+  };
+}

package/src/lib/search.ts

@@ -0,0 +1,31 @@
+import { staticClient } from 'fumadocs-core/search/client/orama-static';
+import { parseDatasetRef } from '@terrafirmagreg-team/kit/lib/location';
+import type { SearchClientSourceCtx } from '@terrafirmagreg-team/kit/lib/search/sources';
+import { loadClientVersions } from './dump/client/dump';
+import { dumpStorageUrl } from './dump/paths';
+
+export function dumpSearchClientSource({ refs, locale, tag }: SearchClientSourceCtx) {
+  return {
+    deps: [refs.join(','), locale, String(tag)],
+    async search(query: string) {
+      const clients = await Promise.all(
+        refs.map(async (ref) => {
+          const { id, version } = parseDatasetRef(ref);
+          const ver = version ?? (await loadClientVersions(id))?.latest;
+          if (!ver) return null;
+          return staticClient({
+            locale,
+            tag,
+            from: dumpStorageUrl(`${id}/${ver}/search.json`),
+          });
+        }),
+      );
+      const lists = await Promise.all(
+        clients.flatMap((client) =>
+          client ? [Promise.resolve(client.search(query)).catch(() => [])] : [],
+        ),
+      );
+      return lists.flat();
+    },
+  };
+}