@terrafirmagreg-team/game 0.1.0 → 1.2.0

package/src/lib/dump/client/mods.ts

@@ -1,16 +0,0 @@
-import { langString } from '@terrafirmagreg-team/game/lib/dump/assets/lang/names';
-import { clientDumpLang, loadClientManifest } from '@terrafirmagreg-team/game/lib/dump/client/dump';
-import { createAsyncCache } from '@terrafirmagreg-team/ui/lib/utils/async-cache';
-
-export const loadClientModNames = createAsyncCache(
-  async (dataset: string, lang: string): Promise<Record<string, string>> => {
-    const manifest = await loadClientManifest(dataset);
-    const map = await clientDumpLang(dataset, lang);
-    const out: Record<string, string> = {};
-    for (const [ns, entry] of Object.entries(manifest?.namespaces ?? {})) {
-      const key = entry?.display?.name;
-      out[ns] = langString(map, key) ?? key ?? ns;
-    }
-    return out;
-  },
-);

package/src/lib/dump/client/registry.ts

@@ -1,125 +0,0 @@
-import { asIdTable, EDGE_TABLE_FIELD } from '@terrafirmagreg-team/game/lib/dump/contract/read';
-import { asEntry, displayOf } from '@terrafirmagreg-team/game/lib/dump/data/registry/parse';
-import { parseStackId } from '@terrafirmagreg-team/game/lib/dump/contract/ref';
-import type { DumpDisplay, DumpText } from '@terrafirmagreg-team/game/lib/dump/contract/text';
-import type {
-  DumpBlockEntry,
-  DumpEntityEntry,
-  DumpFluidEntry,
-  DumpItemEntry,
-  DumpRegistryEntry,
-  DumpRegistryKind,
-} from '@terrafirmagreg-team/game/lib/dump/data/registry/dto';
-import { clientNamespaceEntries } from '@terrafirmagreg-team/game/lib/dump/client/dump';
-import { createAsyncCache } from '@terrafirmagreg-team/ui/lib/utils/async-cache';
-
-type RegistryByKind = {
-  items: DumpItemEntry;
-  blocks: DumpBlockEntry;
-  fluids: DumpFluidEntry;
-  entities: DumpEntityEntry;
-};
-
-const KIND_FILE: Record<DumpRegistryKind, string> = {
-  items: 'items',
-  blocks: 'blocks',
-  fluids: 'fluids',
-  entities: 'entities',
-};
-
-const clientRegistry = createAsyncCache(
-  async (
-    dataset: string,
-    kind: DumpRegistryKind,
-  ): Promise<Map<string, DumpRegistryEntry>> => {
-    const out = new Map<string, DumpRegistryEntry>();
-    const file = KIND_FILE[kind];
-    const files = await clientNamespaceEntries(
-      dataset,
-      () => `registry/${file}.json`,
-      (ns) => ns.registry.includes(file),
-    );
-    for (const { entries } of files) {
-      const ids = asIdTable(entries);
-      for (const [id, raw] of Object.entries(entries)) {
-        if (id === EDGE_TABLE_FIELD) continue;
-        const entry = asEntry(raw, kind, id, ids);
-        if (!entry) continue;
-        if (!out.has(id)) out.set(id, entry);
-        if (entry.id !== id && !out.has(entry.id)) {
-          out.set(entry.id, entry);
-        }
-      }
-    }
-    return out;
-  },
-);
-
-export function loadClientRegistry<K extends DumpRegistryKind>(
-  dataset: string,
-  kind: K,
-): Promise<Map<string, RegistryByKind[K]>> {
-  return clientRegistry(dataset, kind) as Promise<Map<string, RegistryByKind[K]>>;
-}
-
-export function resolveClientStackDisplay(
-  compactId: string,
-  items: Map<string, DumpItemEntry>,
-  fluids: Map<string, DumpFluidEntry>,
-): DumpDisplay | undefined {
-  const parsed = parseStackId(compactId);
-  const item = items.get(parsed.id);
-  if (item) return displayOf(item, parsed.nbt);
-  const fluid = fluids.get(parsed.id);
-  if (fluid) return displayOf(fluid, parsed.nbt);
-  return undefined;
-}
-
-const SINGULAR_KIND: Record<string, DumpRegistryKind> = {
-  item: 'items',
-  block: 'blocks',
-  fluid: 'fluids',
-  entity: 'entities',
-};
-
-export function clientRegistryKindFor(kind: string): DumpRegistryKind {
-  return SINGULAR_KIND[kind] ?? (kind as DumpRegistryKind);
-}
-
-export async function loadClientRegistryOrder(
-  dataset: string,
-  kind: string,
-): Promise<string[]> {
-  const entries = await loadClientRegistry(dataset, clientRegistryKindFor(kind));
-  return [...entries.values()]
-    .flatMap((entry) => (entry.order != null ? [entry] : []))
-    .sort((a, b) => (a.order ?? 0) - (b.order ?? 0) || a.id.localeCompare(b.id))
-    .map((entry) => entry.id);
-}
-
-export async function loadClientRegistryTooltips(
-  dataset: string,
-  kind: string,
-): Promise<Record<string, DumpText[]> | undefined> {
-  const entries = await loadClientRegistry(dataset, clientRegistryKindFor(kind));
-  const out: Record<string, DumpText[]> = {};
-  for (const entry of entries.values()) {
-    const tooltip = entry.display?.tooltip;
-    if (tooltip?.length) out[entry.id] = tooltip;
-  }
-  return Object.keys(out).length ? out : undefined;
-}
-
-export async function loadClientRegistryTooltipsMod(
-  dataset: string,
-  kind: string,
-  mod: string,
-): Promise<Record<string, DumpText[]> | undefined> {
-  const entries = await loadClientRegistry(dataset, clientRegistryKindFor(kind));
-  const out: Record<string, DumpText[]> = {};
-  for (const entry of entries.values()) {
-    const lines = entry.display?.tooltipMods?.[mod];
-    if (lines?.length) out[entry.id] = lines;
-  }
-  return Object.keys(out).length ? out : undefined;
-}

package/src/lib/dump/client/tabs.ts

@@ -1,27 +0,0 @@
-import { asTab, asTabItems } from '@terrafirmagreg-team/game/lib/dump/data/tab/parse';
-import type { DumpCreativeTab, DumpCreativeTabs } from '@terrafirmagreg-team/game/lib/dump/data/tab/dto';
-import { clientNamespaceEntries } from '@terrafirmagreg-team/game/lib/dump/client/dump';
-import { createAsyncCache } from '@terrafirmagreg-team/ui/lib/utils/async-cache';
-
-export const loadClientTabs = createAsyncCache(
-  async (dataset: string): Promise<DumpCreativeTabs> => {
-    const tabs: DumpCreativeTab[] = [];
-    const members: Record<string, string[]> = {};
-    const files = await clientNamespaceEntries(
-      dataset,
-      () => 'registry/tabs.json',
-      (ns) => ns.registry.includes('tabs'),
-    );
-    for (const { entries } of files) {
-      for (const raw of Object.values(entries)) {
-        const tab = asTab(raw);
-        if (!tab) continue;
-        tabs.push(tab);
-        const items = asTabItems(raw);
-        if (items.length) members[tab.id] = items;
-      }
-    }
-    tabs.sort((a, b) => a.order - b.order || a.id.localeCompare(b.id));
-    return { tabs, members };
-  },
-);

package/src/lib/dump/client/tags.ts

@@ -1,64 +0,0 @@
-import { asIdTable, EDGE_TABLE_FIELD } from '@terrafirmagreg-team/game/lib/dump/contract/read';
-import { asTag } from '@terrafirmagreg-team/game/lib/dump/data/tag/parse';
-import type { DumpTag } from '@terrafirmagreg-team/game/lib/dump/data/tag/dto';
-import { clientNamespaceEntries } from '@terrafirmagreg-team/game/lib/dump/client/dump';
-import { tagHashId, tagIdForms } from '@terrafirmagreg-team/game/lib/dump/paths';
-import { createAsyncCache } from '@terrafirmagreg-team/ui/lib/utils/async-cache';
-
-function indexKeys(tag: DumpTag, manifestKey: string): string[] {
-  return [...new Set([manifestKey, ...tagIdForms(tag.id)])];
-}
-
-const loadClientTags = createAsyncCache(async (dataset: string) => {
-  const map = new Map<string, DumpTag>();
-  const files = await clientNamespaceEntries(
-    dataset,
-    () => 'registry/tags.json',
-    (ns) => ns.registry.includes('tags'),
-  );
-  for (const { entries } of files) {
-    const ids = asIdTable(entries);
-    for (const [manifestKey, raw] of Object.entries(entries)) {
-      if (manifestKey === EDGE_TABLE_FIELD) continue;
-      const tag = asTag(raw, manifestKey, ids);
-      if (!tag) continue;
-      for (const alias of indexKeys(tag, manifestKey)) {
-        if (!map.has(alias)) map.set(alias, tag);
-      }
-    }
-  }
-  return map;
-});
-
-export async function resolveClientTag(
-  dataset: string,
-  id: string,
-): Promise<DumpTag | undefined> {
-  const tags = await loadClientTags(dataset);
-  for (const form of tagIdForms(id)) {
-    const hit = tags.get(form);
-    if (hit) return hit;
-  }
-  return undefined;
-}
-
-const MEMBER_REGISTRY: Record<string, string> = {
-  item: 'items',
-  block: 'blocks',
-  fluid: 'fluids',
-  entity: 'entities',
-};
-
-export async function loadClientTagMembers(
-  dataset: string,
-  kind: string,
-): Promise<Record<string, string[]> | undefined> {
-  const registry = MEMBER_REGISTRY[kind] ?? kind;
-  const out: Record<string, string[]> = {};
-  for (const tag of (await loadClientTags(dataset)).values()) {
-    if (tag.registry !== registry || !tag.members.length) continue;
-    out[tagHashId(tag.id)] ??= tag.members;
-  }
-  return Object.keys(out).length ? out : undefined;
-}
-

package/src/lib/dump/contract/kind.ts

@@ -1,61 +0,0 @@
-import {
-  asTaggedReference,
-  stackIdFromRef,
-  type ReferenceKind,
-  type TaggedReference,
-} from '@terrafirmagreg-team/game/lib/dump/contract/ref';
-import { asRecord, asString } from '@terrafirmagreg-team/game/lib/dump/contract/read';
-
-const LINK_KINDS = [
-  'item',
-  'block',
-  'fluid',
-  'entity',
-  'tag',
-  'texture',
-  'recipe',
-  'quest',
-  'guide',
-] as const;
-
-export type ResourceKind = (typeof LINK_KINDS)[number];
-
-export function asResourceKind(value: unknown): ResourceKind | undefined {
-  return typeof value === 'string' &&
-    (LINK_KINDS as readonly string[]).includes(value)
-    ? (value as ResourceKind)
-    : undefined;
-}
-
-export function referenceKindFromResource(
-  kind: ResourceKind | undefined,
-): ReferenceKind | undefined {
-  switch (kind) {
-    case 'tag':
-      return 'itemTag';
-    case 'item':
-    case 'block':
-    case 'fluid':
-    case 'entity':
-    case 'texture':
-    case 'recipe':
-    case 'quest':
-    case 'guide':
-      return kind;
-    default:
-      return undefined;
-  }
-}
-
-export function referenceFrom(value: unknown): TaggedReference | undefined {
-  const tagged = asTaggedReference(value);
-  if (tagged) return { kind: tagged.kind, id: stackIdFromRef(tagged) };
-  const row = asRecord(value);
-  const tagId = asString(row?.tag);
-  if (tagId && row?.id === undefined && row?.kind === undefined) {
-    return { kind: 'itemTag', id: `#${tagId}` };
-  }
-  const kind = referenceKindFromResource(asResourceKind(row?.kind));
-  const id = asString(row?.id);
-  return kind && id ? { kind, id } : undefined;
-}

package/src/lib/dump/contract/read.ts

@@ -1,77 +0,0 @@
-
-
-export function asRecord(value: unknown): Record<string, unknown> | undefined {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;
-  return value as Record<string, unknown>;
-}
-
-export function asString(value: unknown): string | undefined {
-  return typeof value === 'string' && value ? value : undefined;
-}
-
-export function asNumber(value: unknown): number | undefined {
-  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-}
-
-export function asBool(value: unknown): boolean | undefined {
-  if (typeof value === 'boolean') return value;
-  if (value === 1) return true;
-  if (value === 0) return false;
-  return undefined;
-}
-
-export function asStringList(value: unknown): string[] {
-  if (!Array.isArray(value)) return [];
-  return value.filter((item): item is string => typeof item === 'string' && Boolean(item));
-}
-
-export const EDGE_TABLE_FIELD = '$ids';
-
-export function asIdTable(file: unknown): string[] | undefined {
-  const ids = asStringList(asRecord(file)?.[EDGE_TABLE_FIELD]);
-  return ids.length ? ids : undefined;
-}
-
-export function asEdgeList(value: unknown, ids?: string[]): string[] {
-  if (!Array.isArray(value)) return [];
-  const out: string[] = [];
-  for (const item of value) {
-    if (typeof item === 'string') {
-      if (item) out.push(item);
-      continue;
-    }
-    if (typeof item === 'number' && Number.isInteger(item)) {
-      const ref = ids?.[item];
-      if (ref) out.push(ref);
-    }
-  }
-  return out;
-}
-
-export function resolveEdgeRows(
-  map: Record<string, unknown>,
-): Record<string, Record<string, unknown>> {
-  const ids = asIdTable(map);
-  const out: Record<string, Record<string, unknown>> = {};
-  for (const [key, value] of Object.entries(map)) {
-    if (key === EDGE_TABLE_FIELD) continue;
-    const row = asRecord(value);
-    if (!row) continue;
-    if (ids) {
-      if (Array.isArray(row.usedBy)) row.usedBy = asEdgeList(row.usedBy, ids);
-      if (Array.isArray(row.producedBy)) row.producedBy = asEdgeList(row.producedBy, ids);
-    }
-    out[key] = row;
-  }
-  return out;
-}
-
-export function asStringMap(value: unknown): Record<string, string> | undefined {
-  const row = asRecord(value);
-  if (!row) return undefined;
-  const out: Record<string, string> = {};
-  for (const [key, item] of Object.entries(row)) {
-    if (typeof item === 'string') out[key] = item;
-  }
-  return out;
-}

package/src/lib/dump/contract/ref.ts

@@ -1,262 +0,0 @@
-
-
-import { formatNbt, parseSnbt } from '@terrafirmagreg-team/game/lib/snbt';
-import { asRecord, asString } from '@terrafirmagreg-team/game/lib/dump/contract/read';
-
-const REFERENCE_KINDS = [
-  'item',
-  'block',
-  'fluid',
-  'entity',
-  'itemTag',
-  'blockTag',
-  'fluidTag',
-  'entityTag',
-  'texture',
-  'model',
-  'recipe',
-  'guide',
-  'quest',
-  'chapter',
-] as const;
-
-export type ReferenceKind = (typeof REFERENCE_KINDS)[number];
-
-const TAG_KINDS = ['itemTag', 'blockTag', 'fluidTag', 'entityTag'] as const;
-
-const ICON_KINDS: readonly ReferenceKind[] = [
-  'item',
-  'block',
-  'fluid',
-  'entity',
-  ...TAG_KINDS,
-  'texture',
-];
-
-export type DumpNbt =
-  | string
-  | number
-  | boolean
-  | null
-  | DumpNbt[]
-  | { [key: string]: DumpNbt };
-
-export type TaggedReference = {
-  kind: ReferenceKind;
-  id: string;
-  tag?: DumpNbt;
-};
-
-export type ParsedStackId = {
-  id: string;
-  nbt?: DumpNbt;
-};
-
-function asReferenceKind(value: unknown): ReferenceKind | undefined {
-  if (typeof value !== 'string') return undefined;
-  return (REFERENCE_KINDS as readonly string[]).includes(value)
-    ? (value as ReferenceKind)
-    : undefined;
-}
-
-export function asNbt(value: unknown): DumpNbt | undefined {
-  if (value === null) return null;
-  if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-    return value;
-  }
-  if (Array.isArray(value)) return value as DumpNbt[];
-  const row = asRecord(value);
-  if (!row || Object.keys(row).length === 0) return undefined;
-  return row as { [key: string]: DumpNbt };
-}
-
-export function nbtAt(
-  tag: DumpNbt | undefined,
-  ...path: (string | number)[]
-): DumpNbt | undefined {
-  let cur: DumpNbt | undefined = tag;
-  for (const key of path) {
-    if (cur === undefined || cur === null) return undefined;
-    if (typeof key === 'number') {
-      if (!Array.isArray(cur)) return undefined;
-      cur = cur[key];
-      continue;
-    }
-    if (typeof cur !== 'object' || Array.isArray(cur)) return undefined;
-    cur = cur[key];
-  }
-  return cur;
-}
-
-export function parseStackId(compact: string): ParsedStackId {
-  const brace = compact.indexOf('{');
-  if (brace <= 0) return { id: compact };
-  const id = compact.slice(0, brace);
-  if (!id) return { id: compact };
-  try {
-    const nbt = asNbt(parseSnbt(compact.slice(brace)));
-    return nbt !== undefined ? { id, nbt } : { id };
-  } catch {
-    return { id };
-  }
-}
-
-export function stackIdBase(compact: string): string {
-  const brace = compact.indexOf('{');
-  return brace > 0 ? compact.slice(0, brace) : compact;
-}
-
-export function canonicalStackId(compact: string): string {
-  const brace = compact.indexOf('{');
-  if (brace <= 0) return compact;
-  const parsed = parseStackId(compact);
-  const nbt = formatNbt(parsed.nbt);
-  return nbt !== undefined && nbt.startsWith('{')
-    ? `${parsed.id}${nbt}`
-    : compact;
-}
-
-export function asTaggedReference(value: unknown): TaggedReference | undefined {
-  const row = asRecord(value);
-  if (!row) return undefined;
-  const kind = asReferenceKind(row.kind);
-  const id = asString(row.id);
-  if (!kind || !id) return undefined;
-  const tag = asNbt(row.tag);
-  return { kind, id, ...(tag !== undefined ? { tag } : {}) };
-}
-
-export function isTagKind(
-  kind: ReferenceKind | undefined,
-): kind is (typeof TAG_KINDS)[number] {
-  return kind !== undefined && (TAG_KINDS as readonly string[]).includes(kind);
-}
-
-export function tagKindOf(
-  kind: ReferenceKind | undefined,
-): 'item' | 'block' | 'fluid' | 'entity' | undefined {
-  switch (kind) {
-    case 'itemTag':
-      return 'item';
-    case 'blockTag':
-      return 'block';
-    case 'fluidTag':
-      return 'fluid';
-    case 'entityTag':
-      return 'entity';
-    default:
-      return undefined;
-  }
-}
-
-export function isIconKind(kind: ReferenceKind | undefined): boolean {
-  return kind !== undefined && ICON_KINDS.includes(kind);
-}
-
-export function classifyRefId(
-  id: string,
-  kind?: ReferenceKind,
-): TaggedReference | undefined {
-  const trimmed = id.trim();
-  if (!trimmed) return undefined;
-  const parsed = parseStackId(
-    trimmed.startsWith('#') ? trimmed.slice(1) : trimmed,
-  );
-  const resolved = trimmed.startsWith('#')
-    ? (isTagKind(kind) ? kind : 'itemTag')
-    : (kind ?? 'item');
-  return {
-    kind: resolved,
-    id: parsed.id,
-    ...(parsed.nbt !== undefined ? { tag: parsed.nbt } : {}),
-  };
-}
-
-export function refId(ref: TaggedReference): string {
-  return stackIdFromRef(ref);
-}
-
-export function compactRefId(value: unknown): string | undefined {
-  if (typeof value === 'string' && value) return value;
-  const tagged = asTaggedReference(value);
-  return tagged ? stackIdFromRef(tagged) : undefined;
-}
-
-function nbtEquals(left: DumpNbt | undefined, right: DumpNbt | undefined): boolean {
-  if (left === right) return true;
-  if (left === undefined || right === undefined) return false;
-  if (left === null || right === null) return left === right;
-  if (typeof left !== typeof right) return false;
-  if (typeof left !== 'object') return left === right;
-  if (Array.isArray(left)) {
-    return (
-      Array.isArray(right) &&
-      left.length === right.length &&
-      left.every((value, index) => nbtEquals(value, right[index]))
-    );
-  }
-  if (Array.isArray(right)) return false;
-  const leftRow = left as { [key: string]: DumpNbt };
-  const rightRow = right as { [key: string]: DumpNbt };
-  const leftKeys = Object.keys(leftRow).sort();
-  const rightKeys = Object.keys(rightRow).sort();
-  if (leftKeys.length !== rightKeys.length) return false;
-  return leftKeys.every(
-    (key, index) => key === rightKeys[index] && nbtEquals(leftRow[key], rightRow[key]),
-  );
-}
-
-function nbtMatches(pattern: DumpNbt | undefined, actual: DumpNbt | undefined): boolean {
-  if (pattern === undefined) return actual === undefined;
-  if (actual === undefined || actual === null) return pattern === actual;
-  if (pattern === null) return actual === null;
-  if (typeof pattern !== 'object') return pattern === actual;
-  if (Array.isArray(pattern)) {
-    if (!Array.isArray(actual) || pattern.length !== actual.length) return false;
-    return pattern.every((item, index) => nbtMatches(item, actual[index]));
-  }
-  if (typeof actual !== 'object' || Array.isArray(actual) || actual === null) return false;
-  const actualRow = actual as { [key: string]: DumpNbt };
-  return Object.entries(pattern).every(([key, value]) => nbtMatches(value, actualRow[key]));
-}
-
-function nbtKeyCount(tag: DumpNbt | undefined): number {
-  return tag !== null && typeof tag === 'object' && !Array.isArray(tag)
-    ? Object.keys(tag ?? {}).length
-    : 0;
-}
-
-function nbtSharedKeys(left: DumpNbt | undefined, right: DumpNbt | undefined): number {
-  if (!left || !right) return 0;
-  if (typeof left !== 'object' || Array.isArray(left)) return 0;
-  if (typeof right !== 'object' || Array.isArray(right)) return 0;
-  const rightRow = right as { [key: string]: DumpNbt };
-  let shared = 0;
-  for (const [key, value] of Object.entries(left)) {
-    if (key in rightRow && nbtEquals(value, rightRow[key])) shared++;
-  }
-  return shared;
-}
-
-export function nbtSpecificity(candidate: DumpNbt, query: DumpNbt): number {
-  if (nbtEquals(candidate, query)) return 500;
-  if (nbtMatches(candidate, query)) return 400 + nbtKeyCount(candidate);
-  if (nbtMatches(query, candidate)) return 300 - nbtKeyCount(candidate);
-  const shared = nbtSharedKeys(candidate, query);
-  return shared > 0 ? 200 + shared : -1;
-}
-
-export function stackIdFromRef(ref: TaggedReference): string {
-  switch (ref.kind) {
-    case 'itemTag':
-    case 'blockTag':
-    case 'fluidTag':
-    case 'entityTag':
-      return `#${ref.id.replace(/^#+/, '')}`;
-    default: {
-      const tag = formatNbt(ref.tag);
-      return tag !== undefined && tag.startsWith('{') ? `${ref.id}${tag}` : ref.id;
-    }
-  }
-}
-