@mapletip/data 0.1.0

package/generated/monster-detail.d.ts

@@ -0,0 +1,799 @@
+/* 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;
+};
+
+/**
+ * Monster detail for the declared partial diagnostic scope.
+ */
+export interface MonsterDetailRecord {
+  /**
+   * Wire contract version ('major.minor').
+   */
+  contractVersion: string;
+  /**
+   * Lazy pages used when the inline evidence collection would exceed the
+   * selected pack target. The inline vector is empty in that mode.
+   */
+  dropPages?: PagedCollection | null;
+  /**
+   * Dropped items and evidence links.
+   */
+  drops: MonsterDropEntry[];
+  /**
+   * Elemental affinity descriptors ('F:weak', 'I:immune', etc.).
+   */
+  elements: string[];
+  /**
+   * Format identifier ('mapletip.monster-detail').
+   */
+  format: "mapletip.monster-detail";
+  /**
+   * Deterministic public entity key ('monster-<64 lowercase hex>').
+   */
+  key: string;
+  locations: PagedCollection1;
+  /**
+   * Monster localized display name.
+   */
+  name:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: string;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Lazy pages used when the inline Quest collection would exceed the
+   * selected pack target. The inline vector is empty in that mode.
+   */
+  questPages?: PagedCollection | null;
+  /**
+   * Associated quest kill objectives.
+   */
+  quests: MonsterQuestEntry[];
+  scope: BuildScope;
+  sourceIdentity: SourceIdentity1;
+  stats: MonsterStats;
+  [k: string]: unknown | undefined;
+}
+/**
+ * Paged collection descriptor whose physical packs are bounded by the
+ * selected `PackSizePolicy`.
+ */
+export interface PagedCollection {
+  /**
+   * Universal completeness and coverage indicator (contracts.md § Shared semantic shapes).
+   */
+  coverage: "complete" | "partial" | "unknown" | "unsupported";
+  /**
+   * Distinct target count if different from observed count.
+   */
+  mapCount?: number | null;
+  /**
+   * Total observed count across all occurrences.
+   */
+  observedCount: number;
+  /**
+   * Sorted array of page descriptors.
+   */
+  pages: PageDescriptor[];
+  [k: string]: unknown | undefined;
+}
+/**
+ * Page descriptor for paged relationship or evidence records.
+ */
+export interface PageDescriptor {
+  /**
+   * Number of items in this page.
+   */
+  count: number;
+  /**
+   * Bounded record key for direct fetch.
+   */
+  recordKey: string;
+  /**
+   * Record kind ('relationships' or 'evidence').
+   */
+  recordKind: string;
+  [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;
+}
+/**
+ * Paged collection descriptor whose physical packs are bounded by the
+ * selected `PackSizePolicy`.
+ */
+export interface PagedCollection1 {
+  /**
+   * Universal completeness and coverage indicator (contracts.md § Shared semantic shapes).
+   */
+  coverage: "complete" | "partial" | "unknown" | "unsupported";
+  /**
+   * Distinct target count if different from observed count.
+   */
+  mapCount?: number | null;
+  /**
+   * Total observed count across all occurrences.
+   */
+  observedCount: number;
+  /**
+   * Sorted array of page descriptors.
+   */
+  pages: PageDescriptor[];
+  [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.
+ */
+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;
+}
+/**
+ * Upstream source identity coordinates.
+ */
+export interface SourceIdentity1 {
+  /**
+   * 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;
+}
+/**
+ * Combat and gameplay statistics.
+ */
+export interface MonsterStats {
+  /**
+   * Accuracy rating.
+   */
+  acc:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Whether monster is classified as a boss.
+   */
+  boss:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: boolean;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Evasion rating.
+   */
+  eva:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.exp` source value.
+   */
+  exp:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.max_hp` source value.
+   */
+  hp:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.level` source value.
+   */
+  level:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.ma_damage` source value.
+   */
+  maDamage:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.md_damage` source value.
+   */
+  mdDamage:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.max_mp` source value.
+   */
+  mp:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.pa_damage` source value; gameplay meaning is
+   * owned by the normalizer, not inferred here.
+   */
+  paDamage:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.pd_damage` source value.
+   */
+  pdDamage:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.pushed` source value.
+   */
+  pushed:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Exact `monster_version.speed` source value.
+   */
+  speed:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: number;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  /**
+   * Canonical 0/1 undead flag; unsupported raw codes remain unknown.
+   */
+  undead:
+    | {
+        state: "known";
+        /**
+         * Observed value.
+         */
+        value: boolean;
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Reason for absence if known.
+         */
+        reason?: string | null;
+        state: "unknown";
+        [k: string]: unknown | undefined;
+      }
+    | {
+        /**
+         * Name of the unsupported capability.
+         */
+        capability: string;
+        state: "unsupported";
+        [k: string]: unknown | undefined;
+      };
+  [k: string]: unknown | undefined;
+}