@mapletip/data 0.2.0 → 0.5.0

package/generated/monster-catalog-2-2.d.ts

@@ -0,0 +1,332 @@
+import type { CatalogFact } from './contract-2-catalog-fact.d.ts';
+/* Generated automatically from Rust-owned wire definitions. Do not edit. */
+
+export type CoverageKey = string;
+/**
+ * Historical overlay drop count, separate from native source coverage.
+ */
+export type MonsterHistoricalDropSummaryV2_2 =
+  | {
+      count: number;
+      sourceBuilds: NonEmptyVecString;
+      state: "known";
+    }
+  | {
+      state: "absent";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVecString = [string, ...string[]];
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_MonsterElementSummaryV2 = [MonsterElementSummaryV2, ...MonsterElementSummaryV2[]];
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_MonsterRelationshipFacetV2 = [MonsterRelationshipFacetV2, ...MonsterRelationshipFacetV2[]];
+export type SafeInt64 = number;
+/**
+ * Relationship kinds represented as compact positive-count catalog facets.
+ */
+export type MonsterRelationshipFacetKind =
+  | "bans"
+  | "banMaps"
+  | "damagedBy"
+  | "attacks"
+  | "revives"
+  | "lostItems"
+  | "skillAssignments"
+  | "speakConditions"
+  | "speakGroups"
+  | "speakLines"
+  | "localizedNames"
+  | "bookEntries"
+  | "bookMaps"
+  | "questCountGroupMemberships";
+export type MediaContentId = string;
+
+/**
+ * Standalone strict Monster catalog revision 2.2.
+ */
+export interface MonsterCatalogV2_2 {
+  browseCoverage: MonsterBrowseCoverageV2_2;
+  /**
+   * Contract version discriminator.
+   */
+  contractVersion: "2.2";
+  /**
+   * Contract format discriminator.
+   */
+  format: "mapletip.monster-catalog-2";
+  /**
+   * Number of parent Monster keys in `records`.
+   */
+  recordCount: number;
+  /**
+   * Records sorted by stable public key.
+   */
+  records: MonsterCatalogRecordV2_2[];
+  scope: BuildScope;
+}
+/**
+ * Coverage shared by this build's catalog rows.
+ */
+export interface MonsterBrowseCoverageV2_2 {
+  /**
+   * Whether this build carries a historical drop overlay.
+   */
+  historicalDrops: "supported" | "unsupported";
+  /**
+   * Scope of every location count in this catalog.
+   */
+  locationScope: "client-placements";
+  /**
+   * Coverage witness for rows whose location state is `absent`; omitted when none exist.
+   */
+  locationsAbsentCoverageKey?: CoverageKey | null;
+  /**
+   * Coverage witness for rows whose native drop state is `absent`; omitted when none exist.
+   */
+  nativeDropsAbsentCoverageKey?: CoverageKey | null;
+}
+/**
+ * Compact Monster row for browse catalog revision 2.2.
+ */
+export interface MonsterCatalogRecordV2_2 {
+  drops: MonsterDropSummaryV2_2;
+  /**
+   * Observed element summaries; empty collections are unknown without coverage.
+   */
+  elements:
+    | {
+        items: NonEmptyVec_MonsterElementSummaryV2;
+        state: "known";
+      }
+    | {
+        items: NonEmptyVec_MonsterElementSummaryV2;
+        state: "partial";
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+  /**
+   * Stable public key derived from family, domain, namespace, and source ID.
+   */
+  key: string;
+  /**
+   * Per-Monster client placement state and resolved counts.
+   */
+  locations:
+    | {
+        mapCount: number;
+        placementCount: number;
+        state: "known";
+      }
+    | {
+        state: "absent";
+      }
+    | {
+        mapCount: number;
+        placementCount: number;
+        state: "unresolved";
+      };
+  /**
+   * Localized display name, if observed.
+   */
+  name:
+    | {
+        state: "known";
+        value: string;
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+  /**
+   * Positively observed relationship counts; incomplete coverage stays partial.
+   */
+  relationships:
+    | {
+        items: NonEmptyVec_MonsterRelationshipFacetV2;
+        state: "known";
+      }
+    | {
+        items: NonEmptyVec_MonsterRelationshipFacetV2;
+        state: "partial";
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+  /**
+   * Same-build Media product's representative monster sprite identity.
+   */
+  sprite:
+    | {
+        state: "known";
+        value: MediaContentId;
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+  /**
+   * Contract-ordered compact stat facts.
+   *
+   * @minItems 12
+   * @maxItems 12
+   */
+  stats: [CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>];
+  /**
+   * Contract-ordered compact trait facts.
+   *
+   * @minItems 9
+   * @maxItems 9
+   */
+  traits: [CatalogFact<boolean>, CatalogFact<boolean>, CatalogFact<boolean>, CatalogFact<number>, CatalogFact<boolean>, CatalogFact<boolean>, CatalogFact<SafeInt64>, CatalogFact<SafeInt64>, CatalogFact<string>];
+}
+/**
+ * Native and historical drop facts derived from the evidence assertion stream.
+ */
+export interface MonsterDropSummaryV2_2 {
+  /**
+   * Historical overlay evidence is present only when the build supports an overlay.
+   */
+  historical?: MonsterHistoricalDropSummaryV2_2 | null;
+  /**
+   * Native evidence from this exact build. Known counts carry an explicit
+   * lower-bound marker because Monster Book coverage is partial.
+   */
+  native:
+    | {
+        count: number;
+        lowerBound: boolean;
+        state: "known";
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+}
+/**
+ * Compact canonical and source-code summary of one element/resistance pair.
+ */
+export interface MonsterElementSummaryV2 {
+  /**
+   * Verbatim source element code.
+   */
+  code: string;
+  /**
+   * Verbatim numeric effect tier.
+   */
+  effect: number;
+  /**
+   * Canonical element meaning when the build family supports it.
+   */
+  meaning:
+    | {
+        state: "known";
+        value: string;
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+  /**
+   * Canonical damage multiplier when the build family supports it.
+   */
+  multiplier:
+    | {
+        state: "known";
+        value: number;
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+  /**
+   * Canonical resistance meaning when the build family supports it.
+   */
+  resistance:
+    | {
+        state: "known";
+        value: string;
+      }
+    | {
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        state: "unsupported";
+      };
+}
+/**
+ * One positively observed relationship count. Zero-count tables do not
+ * appear here; the collection remains partial or unknown without a sealed
+ * source-table coverage witness.
+ */
+export interface MonsterRelationshipFacetV2 {
+  count: SafeInt64;
+  kind: MonsterRelationshipFacetKind;
+}
+/**
+ * Exact game family and build scope.
+ */
+export interface BuildScope {
+  /**
+   * Exact build identity (e.g., 'gms-v83', 'cw-cot2').
+   */
+  build_id: string;
+  /**
+   * Family identity (e.g., 'gms', 'classic-world').
+   */
+  family_id: string;
+  [k: string]: unknown | undefined;
+}