@mapletip/data 0.1.0

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

@@ -0,0 +1,378 @@
+/* Generated automatically from Rust-owned wire definitions. Do not edit. */
+
+export type MonsterDropAssertionV2 =
+  | {
+      assertionKind: "native";
+      evidenceKey: string;
+      monsterKey: string;
+      occurrence: MonsterDropEntryV2;
+      sourceBuild: string;
+      sourceInput: ProductInputPin;
+      [k: string]: unknown | undefined;
+    }
+  | {
+      assertionKind: "historical-overlay";
+      attribution: DropEvidenceAttribution;
+      category?: string | null;
+      evidenceKey: string;
+      itemClass?: string | null;
+      itemKey?: string | null;
+      itemName?: string | null;
+      itemSourceId: string;
+      monsterKey: string;
+      sourceBuild: string;
+      [k: string]: unknown | undefined;
+    };
+/**
+ * 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";
+/**
+ * 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";
+/**
+ * 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;
+export type NullableString = string | null;
+/**
+ * Shared fact state. SQL NULL is represented by `Unknown` with reason
+ * `source-null`; only `Absent` carries a complete-coverage witness.
+ */
+export type FactState2 =
+  | (
+      | {
+          source?: SourceRef | null;
+          state: "known";
+          value: RawValue;
+        }
+      | {
+          reason: StateReason;
+          source?: SourceRef | null;
+          state: "unknown";
+        }
+      | {
+          coverageKey: CoverageKey;
+          state: "absent";
+        }
+      | {
+          capability: Capability;
+          source?: SourceRef | null;
+          state: "unsupported";
+        }
+    )
+  | undefined;
+export type LogicalSourceAddress = string;
+/**
+ * A scalar source observation that preserves the source value kind.
+ */
+export type RawScalar =
+  | {
+      kind: "integer";
+      value: SafeInt64;
+    }
+  | {
+      kind: "real";
+      value: number;
+    }
+  | {
+      kind: "text";
+      value: string;
+    }
+  | {
+      kind: "boolean";
+      value: boolean;
+    }
+  | {
+      kind: "bytes";
+      value: number[];
+    }
+  | {
+      kind: "source-null";
+    };
+export type StateReason = string;
+export type CoverageKey = string;
+export type Capability = string;
+/**
+ * Shared fact state. SQL NULL is represented by `Unknown` with reason
+ * `source-null`; only `Absent` carries a complete-coverage witness.
+ */
+export type FactState3 =
+  | (
+      | {
+          source?: SourceRef | null;
+          state: "known";
+          value: EntityRef;
+        }
+      | {
+          reason: StateReason;
+          source?: SourceRef | null;
+          state: "unknown";
+        }
+      | {
+          coverageKey: CoverageKey;
+          state: "absent";
+        }
+      | {
+          capability: Capability;
+          source?: SourceRef | null;
+          state: "unsupported";
+        }
+    )
+  | undefined;
+/**
+ * Shared entity-reference states. The generic parameter brands resolved keys
+ * for the target domain without changing their JSON representation.
+ */
+export type EntityRef =
+  | {
+      key: EntityKey;
+      state: "resolved";
+    }
+  | {
+      sourceId: RawSourceId;
+      state: "unresolved";
+    }
+  | {
+      candidateKeys: EntityKey[];
+      state: "ambiguous";
+    }
+  | {
+      reason: StateReason;
+      state: "unavailable";
+    };
+export type EntityKey = string;
+export type RawSourceId = string;
+
+export interface MonsterEvidencePackV2 {
+  contractVersion: "2.0";
+  format: "mapletip.monster-evidence-pack-2";
+  historicalOverlayPin?: ProductHistoricalOverlay | null;
+  recordKind: string;
+  records: {
+    [k: string]: MonsterEvidencePageV2 | undefined;
+  };
+  scope: BuildScope;
+}
+export interface ProductHistoricalOverlay {
+  artifactSha256: string;
+  crosswalkManifestSha256: string;
+  enabled: boolean;
+  format: string;
+  reviewReference: string;
+  sourceInput: ProductInputPin;
+  targetInput: ProductInputPin;
+  transform: string;
+  [k: string]: unknown | undefined;
+}
+export interface ProductInputPin {
+  buildId: string;
+  familyId: string;
+  fileSha256: string;
+  snapshotRoot: string;
+  snapshotScheme: string;
+  [k: string]: unknown | undefined;
+}
+export interface MonsterEvidencePageV2 {
+  collection: string;
+  dropAssertions?: MonsterDropAssertionV2[];
+  monsterKey?: string | null;
+  quests?: MonsterQuestEntryV2[];
+  sourceEvidence?: MonsterCoreOccurrenceV2[];
+}
+/**
+ * Monster 2.0 evidence occurrence with an artifact-independent target reference.
+ */
+export interface MonsterDropEntryV2 {
+  category?: string | null;
+  conditions?: string | null;
+  evidenceAttribution?: HistoricalEvidenceAttribution | null;
+  evidenceId: string;
+  evidenceSource: string;
+  itemClass?: string | null;
+  itemName?: string | null;
+  itemRef: MonsterEntityRefV2;
+  ordinal: number;
+  quantityMax?: SafeInt64 | null;
+  quantityMin?: SafeInt64 | null;
+  rate?: number | null;
+  rateDenominator?: SafeInt64 | null;
+  sourcePath: string;
+}
+/**
+ * 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;
+}
+/**
+ * Monster 2.0 target reference. Product availability belongs to the release envelope and is
+ * deliberately omitted from this immutable product record.
+ */
+export interface MonsterEntityRefV2 {
+  associationState: AssociationState;
+  candidateCount?: number | null;
+  candidateCoverage: Coverage;
+  catalogueMembership: CatalogueMembership;
+  evidenceKey?: string | null;
+  key?: string | null;
+  kind: string;
+  namespace?: string | null;
+  sourceIdentity: SourceIdentity;
+  state: RefState;
+  typedVersion: TypedVersionState;
+}
+/**
+ * Monster 2.0 quest occurrence with an artifact-independent target reference.
+ */
+export interface MonsterQuestEntryV2 {
+  countGroupId?: string | null;
+  killCount?: SafeInt64 | null;
+  memberOrdinal?: number | null;
+  occurrenceKey: string;
+  phase: NullableString;
+  questName?: string | null;
+  questRef: MonsterEntityRefV2;
+  questSourceId: string;
+  requirementKind: string;
+  requirementOrdinal: number;
+  sourcePath: string;
+  stateKey: SafeInt64;
+}
+/**
+ * One source occurrence retained by a selected Monster-core collection.
+ */
+export interface MonsterCoreOccurrenceV2 {
+  /**
+   * Selected source and normalized fields, keyed by inventory field name.
+   */
+  fields: {
+    [k: string]: FactState2 | undefined;
+  };
+  /**
+   * Stable key derived from build, source identity, collection and occurrence address.
+   */
+  occurrenceKey: string;
+  /**
+   * Stable public key of the occurrence's Monster, `MobSkill`, or group owner.
+   */
+  ownerKey?: string | null;
+  /**
+   * Canonical target references; raw source IDs remain in `fields`.
+   */
+  references: {
+    [k: string]: FactState3 | undefined;
+  };
+  /**
+   * Exact logical source path when it was retained by normalization.
+   */
+  sourcePath:
+    | {
+        source?: SourceRef | null;
+        state: "known";
+        value: LogicalSourceAddress;
+      }
+    | {
+        reason: StateReason;
+        source?: SourceRef | null;
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        capability: Capability;
+        source?: SourceRef | null;
+        state: "unsupported";
+      };
+}
+/**
+ * Source attribution for a fact or raw observation.
+ */
+export interface SourceRef {
+  /**
+   * Optional logical address within the source; never a local file path.
+   */
+  logicalAddress?: LogicalSourceAddress | null;
+  /**
+   * Source family or source kind, preserved as supplied by the producer.
+   */
+  sourceKind: string;
+}
+/**
+ * A raw value and its optional source attribution.
+ */
+export interface RawValue {
+  scalar: RawScalar;
+  source?: SourceRef | null;
+}
+/**
+ * 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;
+}