@onlyworlds/sdk 1.2.0 → 1.3.1

package/dist/index.d.mts

@@ -520,9 +520,9 @@ interface Map extends BaseElement {
 interface Marker extends BaseElement {
     map?: ElementId<ElementType.Map>;
     zone?: ElementId<ElementType.Zone>;
-    x?: string;
-    y?: string;
-    z?: string;
+    x?: number;
+    y?: number;
+    z?: number;
 }
 /**
  * Pin element type
@@ -531,9 +531,9 @@ interface Pin extends BaseElement {
     map?: ElementId<ElementType.Map>;
     element_type?: ElementType;
     element_id?: AnyElementId;
-    x?: string;
-    y?: string;
-    z?: string;
+    x?: number;
+    y?: number;
+    z?: number;
 }
 /**
  * Input types for API requests (using _id and _ids suffixes)
@@ -825,272 +825,1370 @@ declare enum ElementType {
     Zone = "zone"
 }
 /**
- * Runtime metadata for field relationships - enables tooling and dynamic processing
- * Maps element types to their field relationships for runtime introspection
+ * UI labels for element types - provides proper plural forms
+ * Useful for displaying element type names in user interfaces
  */
-declare const FIELD_MAPPINGS: {
+declare const ELEMENT_LABELS: Record<ElementType, string>;
+/**
+ * Get the plural label for an element type
+ * @param elementType The element type
+ * @returns The plural label string
+ */
+declare function getElementLabel(elementType: ElementType): string;
+/**
+ * Field type definitions for OnlyWorlds elements
+ */
+type FieldType = 'text' | 'integer' | 'integer_max' | 'single_link' | 'multi_link';
+/**
+ * Field metadata structure
+ */
+interface FieldInfo {
+    type: FieldType;
+    target?: string;
+    max?: number;
+}
+/**
+ * Comprehensive field schema - provides complete metadata for all fields
+ * Maps element types to their field definitions including types and cardinality
+ */
+declare const FIELD_SCHEMA: {
     readonly ability: {
-        readonly tradition: "construct";
-        readonly source: "phenomenon";
-        readonly locus: "location";
-        readonly effects: "phenomenon";
-        readonly talents: "trait";
-        readonly requisites: "construct";
-        readonly instruments: "object";
-        readonly systems: "construct";
+        readonly activation: {
+            readonly type: "text";
+        };
+        readonly duration: {
+            readonly type: "text";
+        };
+        readonly potency: {
+            readonly type: "text";
+        };
+        readonly range: {
+            readonly type: "text";
+        };
+        readonly challenges: {
+            readonly type: "text";
+        };
+        readonly prevalence: {
+            readonly type: "text";
+        };
+        readonly tradition: {
+            readonly type: "single_link";
+            readonly target: "construct";
+        };
+        readonly source: {
+            readonly type: "single_link";
+            readonly target: "phenomenon";
+        };
+        readonly locus: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly effects: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly talents: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly requisites: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly instruments: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly systems: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
     };
     readonly character: {
-        readonly birthplace: "location";
-        readonly location: "location";
-        readonly species: "species";
-        readonly traits: "trait";
-        readonly abilities: "ability";
-        readonly languages: "language";
-        readonly objects: "object";
-        readonly institutions: "institution";
-        readonly family: "family";
-        readonly friends: "character";
-        readonly rivals: "character";
+        readonly physicality: {
+            readonly type: "text";
+        };
+        readonly mentality: {
+            readonly type: "text";
+        };
+        readonly height: {
+            readonly type: "text";
+        };
+        readonly weight: {
+            readonly type: "text";
+        };
+        readonly background: {
+            readonly type: "text";
+        };
+        readonly motivations: {
+            readonly type: "text";
+        };
+        readonly birth_date: {
+            readonly type: "text";
+        };
+        readonly reputation: {
+            readonly type: "text";
+        };
+        readonly charisma: {
+            readonly type: "text";
+        };
+        readonly coercion: {
+            readonly type: "text";
+        };
+        readonly competence: {
+            readonly type: "text";
+        };
+        readonly compassion: {
+            readonly type: "text";
+        };
+        readonly creativity: {
+            readonly type: "text";
+        };
+        readonly courage: {
+            readonly type: "text";
+        };
+        readonly level: {
+            readonly type: "text";
+        };
+        readonly hit_points: {
+            readonly type: "text";
+        };
+        readonly STR: {
+            readonly type: "text";
+        };
+        readonly DEX: {
+            readonly type: "text";
+        };
+        readonly CON: {
+            readonly type: "text";
+        };
+        readonly INT: {
+            readonly type: "text";
+        };
+        readonly WIS: {
+            readonly type: "text";
+        };
+        readonly CHA: {
+            readonly type: "text";
+        };
+        readonly birthplace: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly location: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly institutions: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly family: {
+            readonly type: "multi_link";
+            readonly target: "family";
+        };
+        readonly friends: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly rivals: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
     };
     readonly collective: {
-        readonly operator: "institution";
-        readonly equipment: "construct";
-        readonly abilities: "ability";
-        readonly symbolism: "construct";
-        readonly species: "species";
-        readonly characters: "character";
-        readonly creatures: "creature";
-        readonly phenomena: "phenomenon";
+        readonly composition: {
+            readonly type: "text";
+        };
+        readonly count: {
+            readonly type: "text";
+        };
+        readonly formation_date: {
+            readonly type: "text";
+        };
+        readonly activity: {
+            readonly type: "text";
+        };
+        readonly disposition: {
+            readonly type: "text";
+        };
+        readonly state: {
+            readonly type: "text";
+        };
+        readonly operator: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly equipment: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly symbolism: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly characters: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
+        readonly phenomena: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
     };
     readonly construct: {
-        readonly founder: "character";
-        readonly custodian: "institution";
-        readonly characters: "character";
-        readonly objects: "object";
-        readonly locations: "location";
-        readonly species: "species";
-        readonly creatures: "creature";
-        readonly institutions: "institution";
-        readonly traits: "trait";
-        readonly collectives: "collective";
-        readonly zones: "zone";
-        readonly abilities: "ability";
-        readonly phenomena: "phenomenon";
-        readonly languages: "language";
-        readonly families: "family";
-        readonly relations: "relation";
-        readonly titles: "title";
-        readonly constructs: "construct";
-        readonly events: "event";
-        readonly narratives: "narrative";
+        readonly rationale: {
+            readonly type: "text";
+        };
+        readonly history: {
+            readonly type: "text";
+        };
+        readonly status: {
+            readonly type: "text";
+        };
+        readonly reach: {
+            readonly type: "text";
+        };
+        readonly start_date: {
+            readonly type: "text";
+        };
+        readonly end_date: {
+            readonly type: "text";
+        };
+        readonly founder: {
+            readonly type: "single_link";
+            readonly target: "character";
+        };
+        readonly custodian: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly characters: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly locations: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
+        readonly institutions: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly collectives: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly phenomena: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
+        readonly families: {
+            readonly type: "multi_link";
+            readonly target: "family";
+        };
+        readonly relations: {
+            readonly type: "multi_link";
+            readonly target: "relation";
+        };
+        readonly titles: {
+            readonly type: "multi_link";
+            readonly target: "title";
+        };
+        readonly constructs: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly events: {
+            readonly type: "multi_link";
+            readonly target: "event";
+        };
+        readonly narratives: {
+            readonly type: "multi_link";
+            readonly target: "narrative";
+        };
     };
     readonly creature: {
-        readonly location: "location";
-        readonly zone: "zone";
-        readonly species: "species";
-        readonly traits: "trait";
-        readonly abilities: "ability";
-        readonly languages: "language";
-        readonly actions: "ability";
+        readonly appearance: {
+            readonly type: "text";
+        };
+        readonly weight: {
+            readonly type: "text";
+        };
+        readonly height: {
+            readonly type: "text";
+        };
+        readonly habits: {
+            readonly type: "text";
+        };
+        readonly demeanor: {
+            readonly type: "text";
+        };
+        readonly status: {
+            readonly type: "text";
+        };
+        readonly birth_date: {
+            readonly type: "text";
+        };
+        readonly challenge_rating: {
+            readonly type: "text";
+        };
+        readonly hit_points: {
+            readonly type: "text";
+        };
+        readonly armor_class: {
+            readonly type: "text";
+        };
+        readonly speed: {
+            readonly type: "text";
+        };
+        readonly location: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly zone: {
+            readonly type: "single_link";
+            readonly target: "zone";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
+        readonly actions: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
     };
     readonly event: {
-        readonly triggers: "event";
-        readonly characters: "character";
-        readonly objects: "object";
-        readonly locations: "location";
-        readonly species: "species";
-        readonly creatures: "creature";
-        readonly institutions: "institution";
-        readonly traits: "trait";
-        readonly collectives: "collective";
-        readonly zones: "zone";
-        readonly abilities: "ability";
-        readonly phenomena: "phenomenon";
-        readonly languages: "language";
-        readonly families: "family";
-        readonly relations: "relation";
-        readonly titles: "title";
-        readonly constructs: "construct";
+        readonly history: {
+            readonly type: "text";
+        };
+        readonly challenges: {
+            readonly type: "text";
+        };
+        readonly consequences: {
+            readonly type: "text";
+        };
+        readonly start_date: {
+            readonly type: "text";
+        };
+        readonly end_date: {
+            readonly type: "text";
+        };
+        readonly triggers: {
+            readonly type: "multi_link";
+            readonly target: "event";
+        };
+        readonly characters: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly locations: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
+        readonly institutions: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly collectives: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly phenomena: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
+        readonly families: {
+            readonly type: "multi_link";
+            readonly target: "family";
+        };
+        readonly relations: {
+            readonly type: "multi_link";
+            readonly target: "relation";
+        };
+        readonly titles: {
+            readonly type: "multi_link";
+            readonly target: "title";
+        };
+        readonly constructs: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
     };
     readonly family: {
-        readonly traditions: "construct";
-        readonly traits: "trait";
-        readonly abilities: "ability";
-        readonly languages: "language";
-        readonly ancestors: "character";
-        readonly estates: "location";
-        readonly governs: "institution";
-        readonly heirlooms: "object";
-        readonly creatures: "creature";
+        readonly spirit: {
+            readonly type: "text";
+        };
+        readonly history: {
+            readonly type: "text";
+        };
+        readonly reputation: {
+            readonly type: "text";
+        };
+        readonly traditions: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
+        readonly ancestors: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly estates: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly governs: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly heirlooms: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
     };
     readonly institution: {
-        readonly parent_institution: "institution";
-        readonly zones: "zone";
-        readonly objects: "object";
-        readonly creatures: "creature";
-        readonly allies: "institution";
-        readonly adversaries: "institution";
-        readonly constructs: "construct";
+        readonly doctrine: {
+            readonly type: "text";
+        };
+        readonly founding_date: {
+            readonly type: "text";
+        };
+        readonly status: {
+            readonly type: "text";
+        };
+        readonly parent_institution: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
+        readonly allies: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly adversaries: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly constructs: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
     };
     readonly language: {
-        readonly classification: "construct";
-        readonly spread: "location";
-        readonly dialects: "language";
+        readonly phonology: {
+            readonly type: "text";
+        };
+        readonly grammar: {
+            readonly type: "text";
+        };
+        readonly lexicon: {
+            readonly type: "text";
+        };
+        readonly writing: {
+            readonly type: "text";
+        };
+        readonly status: {
+            readonly type: "text";
+        };
+        readonly classification: {
+            readonly type: "single_link";
+            readonly target: "construct";
+        };
+        readonly spread: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly dialects: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
     };
     readonly law: {
-        readonly parent_law: "law";
-        readonly author: "institution";
-        readonly penalties: "construct";
-        readonly locations: "location";
-        readonly zones: "zone";
-        readonly prohibitions: "construct";
-        readonly adjudicators: "title";
-        readonly enforcers: "title";
+        readonly declaration: {
+            readonly type: "text";
+        };
+        readonly purpose: {
+            readonly type: "text";
+        };
+        readonly date: {
+            readonly type: "text";
+        };
+        readonly parent_law: {
+            readonly type: "single_link";
+            readonly target: "law";
+        };
+        readonly author: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly penalties: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly locations: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly prohibitions: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly adjudicators: {
+            readonly type: "multi_link";
+            readonly target: "title";
+        };
+        readonly enforcers: {
+            readonly type: "multi_link";
+            readonly target: "title";
+        };
     };
     readonly location: {
-        readonly parent_location: "location";
-        readonly primary_power: "institution";
-        readonly governing_title: "title";
-        readonly zone: "zone";
-        readonly rival: "location";
-        readonly partner: "location";
-        readonly populations: "collective";
-        readonly secondary_powers: "institution";
-        readonly founders: "character";
-        readonly cults: "construct";
-        readonly delicacies: "species";
-        readonly extraction_methods: "construct";
-        readonly extraction_goods: "construct";
-        readonly industry_methods: "construct";
-        readonly industry_goods: "construct";
-        readonly extraction_markets: "location";
-        readonly industry_markets: "location";
-        readonly currencies: "construct";
-        readonly buildings: "object";
-        readonly building_methods: "construct";
-        readonly fighters: "construct";
-        readonly defensive_objects: "object";
+        readonly form: {
+            readonly type: "text";
+        };
+        readonly function: {
+            readonly type: "text";
+        };
+        readonly founding_date: {
+            readonly type: "text";
+        };
+        readonly political_climate: {
+            readonly type: "text";
+        };
+        readonly customs: {
+            readonly type: "text";
+        };
+        readonly infrastructure: {
+            readonly type: "text";
+        };
+        readonly architecture: {
+            readonly type: "text";
+        };
+        readonly defensibility: {
+            readonly type: "text";
+        };
+        readonly elevation: {
+            readonly type: "text";
+        };
+        readonly parent_location: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly primary_power: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly governing_title: {
+            readonly type: "single_link";
+            readonly target: "title";
+        };
+        readonly zone: {
+            readonly type: "single_link";
+            readonly target: "zone";
+        };
+        readonly rival: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly partner: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly populations: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly secondary_powers: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly founders: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly cults: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly delicacies: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly extraction_methods: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly extraction_goods: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly industry_methods: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly industry_goods: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly extraction_markets: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly industry_markets: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly currencies: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly buildings: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly building_methods: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly fighters: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly defensive_objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
     };
     readonly map: {
-        readonly parent_map: "map";
-        readonly location: "location";
+        readonly background_color: {
+            readonly type: "text";
+        };
+        readonly hierarchy: {
+            readonly type: "text";
+        };
+        readonly width: {
+            readonly type: "text";
+        };
+        readonly height: {
+            readonly type: "text";
+        };
+        readonly depth: {
+            readonly type: "text";
+        };
+        readonly parent_map: {
+            readonly type: "single_link";
+            readonly target: "map";
+        };
+        readonly location: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
     };
     readonly marker: {
-        readonly map: "map";
-        readonly zone: "zone";
+        readonly x: {
+            readonly type: "integer";
+        };
+        readonly y: {
+            readonly type: "integer";
+        };
+        readonly z: {
+            readonly type: "integer";
+        };
+        readonly map: {
+            readonly type: "single_link";
+            readonly target: "map";
+        };
+        readonly zone: {
+            readonly type: "single_link";
+            readonly target: "zone";
+        };
     };
     readonly narrative: {
-        readonly parent_narrative: "narrative";
-        readonly protagonist: "character";
-        readonly antagonist: "character";
-        readonly narrator: "character";
-        readonly conservator: "institution";
-        readonly events: "event";
-        readonly characters: "character";
-        readonly objects: "object";
-        readonly locations: "location";
-        readonly species: "species";
-        readonly creatures: "creature";
-        readonly institutions: "institution";
-        readonly traits: "trait";
-        readonly collectives: "collective";
-        readonly zones: "zone";
-        readonly abilities: "ability";
-        readonly phenomena: "phenomenon";
-        readonly languages: "language";
-        readonly families: "family";
-        readonly relations: "relation";
-        readonly titles: "title";
-        readonly constructs: "construct";
-        readonly laws: "law";
+        readonly story: {
+            readonly type: "text";
+        };
+        readonly consequences: {
+            readonly type: "text";
+        };
+        readonly start_date: {
+            readonly type: "text";
+        };
+        readonly end_date: {
+            readonly type: "text";
+        };
+        readonly order: {
+            readonly type: "text";
+        };
+        readonly parent_narrative: {
+            readonly type: "single_link";
+            readonly target: "narrative";
+        };
+        readonly protagonist: {
+            readonly type: "single_link";
+            readonly target: "character";
+        };
+        readonly antagonist: {
+            readonly type: "single_link";
+            readonly target: "character";
+        };
+        readonly narrator: {
+            readonly type: "single_link";
+            readonly target: "character";
+        };
+        readonly conservator: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly events: {
+            readonly type: "multi_link";
+            readonly target: "event";
+        };
+        readonly characters: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly locations: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
+        readonly institutions: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly collectives: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly phenomena: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
+        readonly families: {
+            readonly type: "multi_link";
+            readonly target: "family";
+        };
+        readonly relations: {
+            readonly type: "multi_link";
+            readonly target: "relation";
+        };
+        readonly titles: {
+            readonly type: "multi_link";
+            readonly target: "title";
+        };
+        readonly constructs: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly laws: {
+            readonly type: "multi_link";
+            readonly target: "law";
+        };
     };
     readonly object: {
-        readonly parent_object: "object";
-        readonly location: "location";
-        readonly language: "language";
-        readonly materials: "construct";
-        readonly technology: "construct";
-        readonly effects: "phenomenon";
-        readonly abilities: "ability";
-        readonly consumes: "construct";
-        readonly affinities: "trait";
+        readonly aesthetics: {
+            readonly type: "text";
+        };
+        readonly weight: {
+            readonly type: "text";
+        };
+        readonly amount: {
+            readonly type: "text";
+        };
+        readonly utility: {
+            readonly type: "text";
+        };
+        readonly origins: {
+            readonly type: "text";
+        };
+        readonly parent_object: {
+            readonly type: "single_link";
+            readonly target: "object";
+        };
+        readonly location: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly language: {
+            readonly type: "single_link";
+            readonly target: "language";
+        };
+        readonly materials: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly technology: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly effects: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly consumes: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly affinities: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
     };
     readonly phenomenon: {
-        readonly system: "phenomenon";
-        readonly catalysts: "object";
-        readonly empowerments: "ability";
-        readonly triggers: "construct";
-        readonly wielders: "character";
-        readonly environments: "location";
+        readonly expression: {
+            readonly type: "text";
+        };
+        readonly effects: {
+            readonly type: "text";
+        };
+        readonly duration: {
+            readonly type: "text";
+        };
+        readonly mythology: {
+            readonly type: "text";
+        };
+        readonly system: {
+            readonly type: "single_link";
+            readonly target: "phenomenon";
+        };
+        readonly catalysts: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly empowerments: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly triggers: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly wielders: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly environments: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
     };
     readonly pin: {
-        readonly map: "map";
-        readonly element_id: "any_element";
+        readonly element_type: {
+            readonly type: "text";
+        };
+        readonly x: {
+            readonly type: "integer";
+        };
+        readonly y: {
+            readonly type: "integer";
+        };
+        readonly z: {
+            readonly type: "integer";
+        };
+        readonly map: {
+            readonly type: "single_link";
+            readonly target: "map";
+        };
+        readonly element_id: {
+            readonly type: "single_link";
+            readonly target: "any";
+        };
     };
     readonly relation: {
-        readonly actor: "character";
-        readonly characters: "character";
-        readonly objects: "object";
-        readonly locations: "location";
-        readonly species: "species";
-        readonly creatures: "creature";
-        readonly institutions: "institution";
-        readonly traits: "trait";
-        readonly collectives: "collective";
-        readonly zones: "zone";
-        readonly abilities: "ability";
-        readonly phenomena: "phenomenon";
-        readonly languages: "language";
-        readonly families: "family";
-        readonly titles: "title";
-        readonly constructs: "construct";
-        readonly events: "event";
-        readonly narratives: "narrative";
+        readonly background: {
+            readonly type: "text";
+        };
+        readonly start_date: {
+            readonly type: "text";
+        };
+        readonly end_date: {
+            readonly type: "text";
+        };
+        readonly intensity: {
+            readonly type: "text";
+        };
+        readonly actor: {
+            readonly type: "single_link";
+            readonly target: "character";
+        };
+        readonly characters: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly locations: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
+        readonly institutions: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly collectives: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly phenomena: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
+        readonly families: {
+            readonly type: "multi_link";
+            readonly target: "family";
+        };
+        readonly titles: {
+            readonly type: "multi_link";
+            readonly target: "title";
+        };
+        readonly constructs: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly events: {
+            readonly type: "multi_link";
+            readonly target: "event";
+        };
+        readonly narratives: {
+            readonly type: "multi_link";
+            readonly target: "narrative";
+        };
     };
     readonly species: {
-        readonly parent_species: "species";
-        readonly nourishment: "species";
-        readonly reproduction: "construct";
-        readonly adaptations: "ability";
-        readonly traits: "trait";
-        readonly locations: "location";
-        readonly zones: "zone";
-        readonly affinities: "phenomenon";
+        readonly appearance: {
+            readonly type: "text";
+        };
+        readonly life_span: {
+            readonly type: "text";
+        };
+        readonly weight: {
+            readonly type: "text";
+        };
+        readonly instincts: {
+            readonly type: "text";
+        };
+        readonly sociality: {
+            readonly type: "text";
+        };
+        readonly temperament: {
+            readonly type: "text";
+        };
+        readonly communication: {
+            readonly type: "text";
+        };
+        readonly aggression: {
+            readonly type: "text";
+        };
+        readonly role: {
+            readonly type: "text";
+        };
+        readonly parent_species: {
+            readonly type: "single_link";
+            readonly target: "species";
+        };
+        readonly nourishment: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly reproduction: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly adaptations: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly locations: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly affinities: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
     };
     readonly title: {
-        readonly issuer: "institution";
-        readonly body: "institution";
-        readonly superior_title: "title";
-        readonly holders: "character";
-        readonly symbols: "object";
-        readonly characters: "character";
-        readonly institutions: "institution";
-        readonly families: "family";
-        readonly zones: "zone";
-        readonly locations: "location";
-        readonly objects: "object";
-        readonly constructs: "construct";
-        readonly laws: "law";
-        readonly collectives: "collective";
-        readonly creatures: "creature";
-        readonly phenomena: "phenomenon";
-        readonly species: "species";
-        readonly languages: "language";
+        readonly authority: {
+            readonly type: "text";
+        };
+        readonly eligibility: {
+            readonly type: "text";
+        };
+        readonly grant_date: {
+            readonly type: "text";
+        };
+        readonly revoke_date: {
+            readonly type: "text";
+        };
+        readonly status: {
+            readonly type: "text";
+        };
+        readonly history: {
+            readonly type: "text";
+        };
+        readonly issuer: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly body: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly superior_title: {
+            readonly type: "single_link";
+            readonly target: "title";
+        };
+        readonly holders: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly symbols: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly characters: {
+            readonly type: "multi_link";
+            readonly target: "character";
+        };
+        readonly institutions: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
+        readonly families: {
+            readonly type: "multi_link";
+            readonly target: "family";
+        };
+        readonly zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly locations: {
+            readonly type: "multi_link";
+            readonly target: "location";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly constructs: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+        readonly laws: {
+            readonly type: "multi_link";
+            readonly target: "law";
+        };
+        readonly collectives: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly creatures: {
+            readonly type: "multi_link";
+            readonly target: "creature";
+        };
+        readonly phenomena: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
+        };
     };
     readonly trait: {
-        readonly anti_trait: "trait";
-        readonly empowered_abilities: "ability";
+        readonly social_effects: {
+            readonly type: "text";
+        };
+        readonly physical_effects: {
+            readonly type: "text";
+        };
+        readonly functional_effects: {
+            readonly type: "text";
+        };
+        readonly personality_effects: {
+            readonly type: "text";
+        };
+        readonly behaviour_effects: {
+            readonly type: "text";
+        };
+        readonly charisma: {
+            readonly type: "text";
+        };
+        readonly coercion: {
+            readonly type: "text";
+        };
+        readonly competence: {
+            readonly type: "text";
+        };
+        readonly compassion: {
+            readonly type: "text";
+        };
+        readonly creativity: {
+            readonly type: "text";
+        };
+        readonly courage: {
+            readonly type: "text";
+        };
+        readonly significance: {
+            readonly type: "text";
+        };
+        readonly anti_trait: {
+            readonly type: "single_link";
+            readonly target: "trait";
+        };
+        readonly empowered_abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
+        };
     };
     readonly zone: {
-        readonly phenomena: "phenomenon";
-        readonly linked_zones: "zone";
-        readonly populations: "collective";
-        readonly titles: "title";
-        readonly principles: "construct";
+        readonly role: {
+            readonly type: "text";
+        };
+        readonly start_date: {
+            readonly type: "text";
+        };
+        readonly end_date: {
+            readonly type: "text";
+        };
+        readonly context: {
+            readonly type: "text";
+        };
+        readonly phenomena: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
+        };
+        readonly linked_zones: {
+            readonly type: "multi_link";
+            readonly target: "zone";
+        };
+        readonly populations: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly titles: {
+            readonly type: "multi_link";
+            readonly target: "title";
+        };
+        readonly principles: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
+    };
+};
+/**
+ * Legacy FIELD_MAPPINGS export for backward compatibility
+ * @deprecated Use FIELD_SCHEMA instead for comprehensive field metadata
+ */
+declare const FIELD_MAPPINGS: {
+    [k: string]: {
+        [k: string]: any;
     };
 };
 /**
  * Type for the field mappings - enables type-safe access to relationship metadata
+ * @deprecated Use FIELD_SCHEMA instead
  */
 type FieldMappingsType = typeof FIELD_MAPPINGS;
 /**
@@ -1191,4 +2289,4 @@ declare class OnlyWorldsClient {
     static prepareInput<T extends Record<string, any>>(data: T): any;
 }
 
-export { type Ability, type AbilityInput, type AnyElementId, type ApiResponse, type BaseElement, type Character, type CharacterInput, type Collective, type CollectiveInput, type Construct, type ConstructInput, type Creature, type CreatureInput, type ElementId, type ElementIds, ElementType, type Event, type EventInput, FIELD_MAPPINGS, type Family, type FamilyInput, type FieldMappingsType, type Institution, type InstitutionInput, type Language, type LanguageInput, type Law, type LawInput, type ListOptions, type Location, type LocationInput, type Map, type MapInput, type Marker, type MarkerInput, type Narrative, type NarrativeInput, type Object$1 as Object, type ObjectInput, OnlyWorldsClient, type OnlyWorldsConfig, type Phenomenon, type PhenomenonInput, type Pin, type PinInput, type Relation, type RelationInput, type Species, type SpeciesInput, type Title, type TitleInput, type Trait, type TraitInput, type World, type WorldInput, type Zone, type ZoneInput, createAnyElementId, createElementId, createElementIds };
+export { type Ability, type AbilityInput, type AnyElementId, type ApiResponse, type BaseElement, type Character, type CharacterInput, type Collective, type CollectiveInput, type Construct, type ConstructInput, type Creature, type CreatureInput, ELEMENT_LABELS, type ElementId, type ElementIds, ElementType, type Event, type EventInput, FIELD_MAPPINGS, FIELD_SCHEMA, type Family, type FamilyInput, type FieldInfo, type FieldMappingsType, type FieldType, type Institution, type InstitutionInput, type Language, type LanguageInput, type Law, type LawInput, type ListOptions, type Location, type LocationInput, type Map, type MapInput, type Marker, type MarkerInput, type Narrative, type NarrativeInput, type Object$1 as Object, type ObjectInput, OnlyWorldsClient, type OnlyWorldsConfig, type Phenomenon, type PhenomenonInput, type Pin, type PinInput, type Relation, type RelationInput, type Species, type SpeciesInput, type Title, type TitleInput, type Trait, type TraitInput, type World, type WorldInput, type Zone, type ZoneInput, createAnyElementId, createElementId, createElementIds, getElementLabel };