@mapletip/data 0.1.0

package/generated/item-detail-2.d.ts

@@ -0,0 +1,540 @@
+/* Generated automatically from Rust-owned wire definitions. Do not edit. */
+
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState =
+  | {
+      items: NonEmptyVec_ItemRawOccurrence;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: ItemRawOccurrence[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_ItemRawOccurrence = [ItemRawOccurrence, ...ItemRawOccurrence[]];
+export type LogicalSourceAddress = string;
+export type SafeInt64 = number;
+/**
+ * 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: SafeInt64;
+    }
+  | {
+      reason: StateReason;
+      source?: SourceRef | null;
+      state: "unknown";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      capability: Capability;
+      source?: SourceRef | null;
+      state: "unsupported";
+    };
+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 FactState =
+  | {
+      source?: SourceRef | null;
+      state: "known";
+      value: string;
+    }
+  | {
+      reason: StateReason;
+      source?: SourceRef | null;
+      state: "unknown";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      capability: Capability;
+      source?: SourceRef | null;
+      state: "unsupported";
+    };
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState7 =
+  | {
+      items: NonEmptyVecString;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: string[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVecString = [string, ...string[]];
+export type EntityKey = string;
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState2 =
+  | {
+      items: NonEmptyVec_ItemMobSkillEffectOccurrence;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: ItemMobSkillEffectOccurrence[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_ItemMobSkillEffectOccurrence = [
+  ItemMobSkillEffectOccurrence,
+  ...ItemMobSkillEffectOccurrence[]
+];
+/**
+ * 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 RawSourceId = string;
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState3 =
+  | {
+      items: NonEmptyVec_ItemMonsterCardOccurrence;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: ItemMonsterCardOccurrence[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_ItemMonsterCardOccurrence = [ItemMonsterCardOccurrence, ...ItemMonsterCardOccurrence[]];
+/**
+ * Shared entity-reference states. The generic parameter brands resolved keys
+ * for the target domain without changing their JSON representation.
+ */
+export type EntityRef2 =
+  | {
+      key: EntityKey;
+      state: "resolved";
+    }
+  | {
+      sourceId: RawSourceId;
+      state: "unresolved";
+    }
+  | {
+      candidateKeys: EntityKey[];
+      state: "ambiguous";
+    }
+  | {
+      reason: StateReason;
+      state: "unavailable";
+    };
+/**
+ * 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;
+/**
+ * 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";
+    };
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState4 =
+  | {
+      items: NonEmptyVec_ItemRequirementOccurrence;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: ItemRequirementOccurrence[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_ItemRequirementOccurrence = [ItemRequirementOccurrence, ...ItemRequirementOccurrence[]];
+/**
+ * Shared entity-reference states. The generic parameter brands resolved keys
+ * for the target domain without changing their JSON representation.
+ */
+export type EntityRef3 =
+  | {
+      key: EntityKey;
+      state: "resolved";
+    }
+  | {
+      sourceId: RawSourceId;
+      state: "unresolved";
+    }
+  | {
+      candidateKeys: EntityKey[];
+      state: "ambiguous";
+    }
+  | {
+      reason: StateReason;
+      state: "unavailable";
+    };
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState5 =
+  | {
+      items: NonEmptyVec_ItemSkillGrantOccurrence;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: ItemSkillGrantOccurrence[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_ItemSkillGrantOccurrence = [ItemSkillGrantOccurrence, ...ItemSkillGrantOccurrence[]];
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState6 =
+  | {
+      items: NonEmptyVec_ItemSummonEntryOccurrence;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: ItemSummonEntryOccurrence[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_ItemSummonEntryOccurrence = [ItemSummonEntryOccurrence, ...ItemSummonEntryOccurrence[]];
+
+export interface ItemDetailRecord {
+  book_pageOccurrences: CollectionState;
+  description: FactState;
+  descriptionLocale: FactState;
+  evidencePageKeys: CollectionState7;
+  itemClass: FactState;
+  key: EntityKey;
+  mob_skill_effectOccurrences: CollectionState2;
+  monster_cardOccurrences: CollectionState3;
+  name: FactState;
+  nameLocale: FactState;
+  /**
+   * Normalized scalar facts from `item_nonequip`, retained as typed raw
+   * values so the public boundary never invents a domain interpretation.
+   */
+  nonequipFacts?: {
+    [k: string]: FactState2 | undefined;
+  };
+  /**
+   * Normalized scalar facts from `item_pet`, when this item is a pet.
+   */
+  petFacts?: {
+    [k: string]: FactState2 | undefined;
+  };
+  /**
+   * Raw-evidence/display-only matrix rows are available through lazy evidence pages.
+   */
+  relationshipPageKeys: {
+    [k: string]: CollectionState7;
+  };
+  requirement_entryOccurrences: CollectionState4;
+  reward_entryOccurrences: CollectionState;
+  skill_grantOccurrences: CollectionState5;
+  slotLimit: FactState2 | undefined;
+  sourceIdentity: SourceIdentity;
+  spec_effectOccurrences: CollectionState;
+  summon_entryOccurrences: CollectionState6;
+  upgrade_effectOccurrences: CollectionState;
+}
+/**
+ * Item detail occurrence whose uninterpreted values are loaded from evidence pages.
+ */
+export interface ItemRawOccurrence {
+  evidencePageKey: string;
+  occurrenceKey: string;
+  sourceAddress: EvidenceSourceAddress;
+  sourceOrdinal: FactState3;
+}
+/**
+ * Exact, logical `MFv1` source address retained on detail and evidence occurrences.
+ */
+export interface EvidenceSourceAddress {
+  imgPath: LogicalSourceAddress;
+  namespace: string;
+  ordinal?: SafeInt64 | null;
+  propertyPath: string;
+  recordKey?: string | null;
+  sourceId: string;
+}
+/**
+ * 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;
+}
+/**
+ * Item-to-skill occurrence with its source-mapped target ID and resolution state.
+ */
+export interface ItemMobSkillEffectOccurrence {
+  evidencePageKey: string;
+  mob_skill_resolves: EntityRef;
+  mob_skill_source_id: FactState3;
+  occurrenceKey: string;
+  sourceAddress: EvidenceSourceAddress;
+  sourceOrdinal: FactState3;
+}
+/**
+ * Item-to-MonsterBook occurrence; Monster remains the target owner.
+ */
+export interface ItemMonsterCardOccurrence {
+  evidencePageKey: string;
+  monster_resolves: EntityRef2;
+  monster_source_id: FactState3;
+  occurrenceKey: string;
+  sourceAddress: EvidenceSourceAddress;
+  sourceOrdinal: FactState3;
+}
+/**
+ * A raw value and its optional source attribution.
+ */
+export interface RawValue {
+  scalar: RawScalar;
+  source?: SourceRef | null;
+}
+/**
+ * Item requirement occurrence targeting another exact Item key.
+ */
+export interface ItemRequirementOccurrence {
+  evidencePageKey: string;
+  occurrenceKey: string;
+  required_resolves: EntityRef3;
+  required_source_id: FactState3;
+  sourceAddress: EvidenceSourceAddress;
+  sourceOrdinal: FactState3;
+}
+/**
+ * Item skill-grant occurrence with a lazy Skill-owned target.
+ */
+export interface ItemSkillGrantOccurrence {
+  evidencePageKey: string;
+  occurrenceKey: string;
+  skill_resolves: EntityRef;
+  skill_source_id: FactState3;
+  sourceAddress: EvidenceSourceAddress;
+  sourceOrdinal: FactState3;
+}
+/**
+ * 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;
+}
+/**
+ * Item summon occurrence with a lazy Monster-owned target.
+ */
+export interface ItemSummonEntryOccurrence {
+  evidencePageKey: string;
+  monster_resolves: EntityRef2;
+  monster_source_id: FactState3;
+  occurrenceKey: string;
+  sourceAddress: EvidenceSourceAddress;
+  sourceOrdinal: FactState3;
+}