@mapletip/data 0.1.0

package/generated/monster-evidence-pack.d.ts

@@ -0,0 +1,269 @@
+/* Generated automatically from Rust-owned wire definitions. Do not edit. */
+
+/**
+ * Confidence in a historical assertion as evidence about a target build.
+ */
+export type HistoricalDropConfidence = "maybe";
+/**
+ * Kind of evidence attribution attached to a Monster drop pair.
+ */
+export type DropEvidenceKind = "native" | "supplemental-historical";
+/**
+ * Resolved or unresolved entity reference to the dropped item.
+ */
+export type EntityRef = {
+  [k: string]: unknown | undefined;
+} & {
+  associationState: AssociationState;
+  candidateCount?: number | null;
+  candidateCoverage: Coverage;
+  catalogueMembership: CatalogueMembership;
+  evidenceKey?: string | null;
+  key?: string | null;
+  kind: string;
+  namespace?: string | null;
+  productCapability: ProductCapability;
+  sourceIdentity: SourceIdentity;
+  state: RefState;
+  typedVersion: TypedVersionState;
+  [k: string]: unknown | undefined;
+};
+/**
+ * Canonical association state supplied by the B1 normalizer.
+ */
+export type AssociationState = "resolved" | "unresolved" | "ambiguous" | "unknown" | "unsupported";
+/**
+ * Universal completeness and coverage indicator (contracts.md § Shared semantic shapes).
+ */
+export type Coverage = "complete" | "partial" | "unknown" | "unsupported";
+/**
+ * Independent catalogue membership state.
+ */
+export type CatalogueMembership = "present" | "verified-absent" | "unknown";
+/**
+ * Independent public product capability state.
+ */
+export type ProductCapability = "implemented" | "not-implemented" | "source-unsupported";
+/**
+ * Projection state for a public reference.
+ */
+export type RefState = "resolved" | "unresolved" | "ambiguous" | "unknown" | "absent" | "unsupported";
+/**
+ * Independent typed-version availability state.
+ */
+export type TypedVersionState = "available" | "unavailable" | "unknown";
+export type SafeInt64 = number;
+/**
+ * Resolved or unresolved reference to the quest entity.
+ */
+export type EntityRef1 = {
+  [k: string]: unknown | undefined;
+} & {
+  associationState: AssociationState;
+  candidateCount?: number | null;
+  candidateCoverage: Coverage;
+  catalogueMembership: CatalogueMembership;
+  evidenceKey?: string | null;
+  key?: string | null;
+  kind: string;
+  namespace?: string | null;
+  productCapability: ProductCapability;
+  sourceIdentity: SourceIdentity;
+  state: RefState;
+  typedVersion: TypedVersionState;
+  [k: string]: unknown | undefined;
+};
+
+/**
+ * Bounded content-addressed pack for lazy drop/Quest evidence pages.
+ */
+export interface MonsterEvidencePack {
+  contractVersion: string;
+  format: "mapletip.monster-evidence-pack";
+  recordKind: string;
+  records: {
+    [k: string]: MonsterEvidencePage | undefined;
+  };
+  scope: BuildScope;
+  [k: string]: unknown | undefined;
+}
+/**
+ * One lazily loaded evidence page. Exactly one collection is populated for a
+ * page; the other remains empty so one physical pack can serve both logical
+ * evidence relations without inventing a second resolver or wire format.
+ */
+export interface MonsterEvidencePage {
+  drops: MonsterDropEntry[];
+  quests: MonsterQuestEntry[];
+  [k: string]: unknown | undefined;
+}
+/**
+ * Reciprocal item drop association for a monster.
+ */
+export interface MonsterDropEntry {
+  /**
+   * Equipment slot or item category label.
+   */
+  category?: string | null;
+  /**
+   * Drop gating conditions (e.g. quest ID or party condition).
+   */
+  conditions?: string | null;
+  /**
+   * Optional typed attribution for supplemental historical assertions.
+   * Native evidence fields above remain the source observation as admitted.
+   */
+  evidenceAttribution?: HistoricalEvidenceAttribution | null;
+  /**
+   * Stable source-derived occurrence key; never a SQLite surrogate ID.
+   */
+  evidenceId: string;
+  /**
+   * Evidence source identifier (e.g. 'wz-monsterbook', 'cw-historical-reviewed').
+   */
+  evidenceSource: string;
+  /**
+   * Item classification namespace (e.g. 'Equip', 'Consume', 'Etc').
+   */
+  itemClass?: string | null;
+  /**
+   * Preserved item display name if known.
+   */
+  itemName?: string | null;
+  itemRef: EntityRef;
+  /**
+   * Literal ordinal within the source evidence list.
+   */
+  ordinal: number;
+  /**
+   * Maximum quantity dropped.
+   */
+  quantityMax?: SafeInt64 | null;
+  /**
+   * Minimum quantity dropped.
+   */
+  quantityMin?: SafeInt64 | null;
+  /**
+   * Exact nullable `monster_drop_evidence.rate` value if stated by source;
+   * the normalizer does not establish a probability scale here.
+   */
+  rate?: number | null;
+  /**
+   * Exact nullable `monster_drop_evidence.rate_denominator` value.
+   */
+  rateDenominator?: SafeInt64 | null;
+  /**
+   * Exact source path for this evidence occurrence.
+   */
+  sourcePath: string;
+  [k: string]: unknown | undefined;
+}
+/**
+ * Group of source assertions supporting one exact public Monster/item pair.
+ */
+export interface HistoricalEvidenceAttribution {
+  assertions: DropEvidenceAttribution[];
+  [k: string]: unknown | undefined;
+}
+/**
+ * One source `MonsterBook` assertion retained on a deduplicated CW pair.
+ */
+export interface DropEvidenceAttribution {
+  attribution: string;
+  confidence: HistoricalDropConfidence;
+  crosswalkInputSha256: string;
+  evidenceKey: string;
+  evidenceKind: DropEvidenceKind;
+  propertyPath: string;
+  reviewReference: string;
+  sourceBuild: string;
+  sourceIdentity: SourceIdentity;
+  sourceInputSha256: string;
+  sourceRecordKey: string;
+  transform: string;
+  [k: string]: unknown | undefined;
+}
+/**
+ * Upstream source identity coordinates.
+ */
+export interface SourceIdentity {
+  /**
+   * Explicit source discriminator when one ID has multiple records (empty or omitted when unused).
+   */
+  discriminator?: string | null;
+  /**
+   * Exact upstream source identifier (e.g., '0100100').
+   */
+  id: string;
+  /**
+   * Source namespace (e.g., 'wz.mob', 'wz.item', 'wz.map'). None when missing or ambiguous.
+   */
+  namespace?: string | null;
+  [k: string]: unknown | undefined;
+}
+/**
+ * Quest requirement association for a monster (kill objective).
+ */
+export interface MonsterQuestEntry {
+  /**
+   * Quest count group ID if this kill objective belongs to a shared defeat pool.
+   */
+  countGroupId?: string | null;
+  /**
+   * Required kill quota to complete the objective.
+   */
+  killCount?: SafeInt64 | null;
+  /**
+   * Literal count-group member ordinal when this requirement fans out.
+   */
+  memberOrdinal?: number | null;
+  /**
+   * Stable source-derived requirement/member occurrence key.
+   */
+  occurrenceKey: string;
+  /**
+   * Canonical Quest phase. `null` preserves the normalizer's unknown phase
+   * for a state whose interpreted `phase` column is NULL.
+   */
+  phase: string | null;
+  /**
+   * Localized quest name.
+   */
+  questName?: string | null;
+  questRef: EntityRef1;
+  /**
+   * Upstream quest source ID.
+   */
+  questSourceId: string;
+  /**
+   * Normalizer-owned requirement kind (for example `mob-kill`).
+   */
+  requirementKind: string;
+  /**
+   * Literal requirement ordinal within the Quest state/kind section.
+   */
+  requirementOrdinal: number;
+  /**
+   * Exact source path for the requirement occurrence.
+   */
+  sourcePath: string;
+  /**
+   * Exact Quest state discriminator from the normalized requirement.
+   */
+  stateKey: number;
+  [k: string]: unknown | undefined;
+}
+/**
+ * Build scope specifying the game family and concrete build identity.
+ */
+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;
+}