@onlyworlds/sdk 1.0.1 → 1.3.0

package/dist/index.d.ts

@@ -1,3 +1,26 @@
+/**
+ * Modern branded types for type-safe element relationships
+ * Provides compile-time safety while maintaining zero runtime overhead
+ */
+declare const __brand: unique symbol;
+type Brand<B> = {
+    [__brand]: B;
+};
+/**
+ * Branded type for element IDs - ensures type safety for relationships
+ * @template T The element type this ID references
+ */
+type ElementId<T extends ElementType> = string & Brand<T>;
+/**
+ * Branded type for arrays of element IDs
+ * @template T The element type these IDs reference
+ */
+type ElementIds<T extends ElementType> = ElementId<T>[];
+/**
+ * Special type for IDs that can reference ANY element type
+ * Used in cases like Pin.element_type where the target can be any OnlyWorlds element
+ */
+type AnyElementId = ElementId<ElementType>;
 /**
  * Base fields shared by all OnlyWorlds elements
  */
@@ -57,22 +80,14 @@ interface Ability extends BaseElement {
     range?: string;
     challenges?: string;
     prevalence?: string;
-    /** Links to Construct */
-    tradition?: string;
-    /** Links to Phenomenon */
-    source?: string;
-    /** Links to Location */
-    locus?: string;
-    /** Links to Phenomenon */
-    effects?: string[];
-    /** Links to Trait */
-    talents?: string[];
-    /** Links to Construct */
-    requisites?: string[];
-    /** Links to Object */
-    instruments?: string[];
-    /** Links to Construct */
-    systems?: string[];
+    tradition?: ElementId<ElementType.Construct>;
+    source?: ElementId<ElementType.Phenomenon>;
+    locus?: ElementId<ElementType.Location>;
+    effects?: ElementIds<ElementType.Phenomenon>;
+    talents?: ElementIds<ElementType.Trait>;
+    requisites?: ElementIds<ElementType.Construct>;
+    instruments?: ElementIds<ElementType.Object>;
+    systems?: ElementIds<ElementType.Construct>;
 }
 /**
  * Object element type
@@ -81,26 +96,17 @@ interface Object$1 extends BaseElement {
     aesthetics?: string;
     weight?: string;
     amount?: string;
-    /** Links to Object */
-    parent_object?: string;
+    parent_object?: ElementId<ElementType.Object>;
     utility?: string;
     origins?: string;
-    /** Links to Location */
-    location?: string;
-    /** Links to Language */
-    language?: string;
-    /** Links to Construct */
-    materials?: string[];
-    /** Links to Construct */
-    technology?: string[];
-    /** Links to Phenomenon */
-    effects?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Construct */
-    consumes?: string[];
-    /** Links to Trait */
-    affinities?: string[];
+    location?: ElementId<ElementType.Location>;
+    language?: ElementId<ElementType.Language>;
+    materials?: ElementIds<ElementType.Construct>;
+    technology?: ElementIds<ElementType.Construct>;
+    effects?: ElementIds<ElementType.Phenomenon>;
+    abilities?: ElementIds<ElementType.Ability>;
+    consumes?: ElementIds<ElementType.Construct>;
+    affinities?: ElementIds<ElementType.Trait>;
 }
 /**
  * Character element type
@@ -113,11 +119,9 @@ interface Character extends BaseElement {
     background?: string;
     motivations?: string;
     birth_date?: string;
-    /** Links to Location */
-    birthplace?: string;
+    birthplace?: ElementId<ElementType.Location>;
     reputation?: string;
-    /** Links to Location */
-    location?: string;
+    location?: ElementId<ElementType.Location>;
     charisma?: string;
     coercion?: string;
     competence?: string;
@@ -132,24 +136,15 @@ interface Character extends BaseElement {
     INT?: string;
     WIS?: string;
     CHA?: string;
-    /** Links to Species */
-    species?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Language */
-    languages?: string[];
-    /** Links to Object */
-    objects?: string[];
-    /** Links to Institution */
-    institutions?: string[];
-    /** Links to Family */
-    family?: string[];
-    /** Links to Character */
-    friends?: string[];
-    /** Links to Character */
-    rivals?: string[];
+    species?: ElementIds<ElementType.Species>;
+    traits?: ElementIds<ElementType.Trait>;
+    abilities?: ElementIds<ElementType.Ability>;
+    languages?: ElementIds<ElementType.Language>;
+    objects?: ElementIds<ElementType.Object>;
+    institutions?: ElementIds<ElementType.Institution>;
+    family?: ElementIds<ElementType.Family>;
+    friends?: ElementIds<ElementType.Character>;
+    rivals?: ElementIds<ElementType.Character>;
 }
 /**
  * Collective element type
@@ -158,25 +153,17 @@ interface Collective extends BaseElement {
     composition?: string;
     count?: string;
     formation_date?: string;
-    /** Links to Institution */
-    operator?: string;
+    operator?: ElementId<ElementType.Institution>;
     activity?: string;
     disposition?: string;
     state?: string;
-    /** Links to Construct */
-    equipment?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Construct */
-    symbolism?: string[];
-    /** Links to Species */
-    species?: string[];
-    /** Links to Character */
-    characters?: string[];
-    /** Links to Creature */
-    creatures?: string[];
-    /** Links to Phenomenon */
-    phenomena?: string[];
+    equipment?: ElementIds<ElementType.Construct>;
+    abilities?: ElementIds<ElementType.Ability>;
+    symbolism?: ElementIds<ElementType.Construct>;
+    species?: ElementIds<ElementType.Species>;
+    characters?: ElementIds<ElementType.Character>;
+    creatures?: ElementIds<ElementType.Creature>;
+    phenomena?: ElementIds<ElementType.Phenomenon>;
 }
 /**
  * Construct element type
@@ -188,46 +175,26 @@ interface Construct extends BaseElement {
     reach?: string;
     start_date?: string;
     end_date?: string;
-    /** Links to Character */
-    founder?: string;
-    /** Links to Institution */
-    custodian?: string;
-    /** Links to Character */
-    characters?: string[];
-    /** Links to Object */
-    objects?: string[];
-    /** Links to Location */
-    locations?: string[];
-    /** Links to Species */
-    species?: string[];
-    /** Links to Creature */
-    creatures?: string[];
-    /** Links to Institution */
-    institutions?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Collective */
-    collectives?: string[];
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Phenomenon */
-    phenomena?: string[];
-    /** Links to Language */
-    languages?: string[];
-    /** Links to Family */
-    families?: string[];
-    /** Links to Relation */
-    relations?: string[];
-    /** Links to Title */
-    titles?: string[];
-    /** Links to Construct */
-    constructs?: string[];
-    /** Links to Event */
-    events?: string[];
-    /** Links to Narrative */
-    narratives?: string[];
+    founder?: ElementId<ElementType.Character>;
+    custodian?: ElementId<ElementType.Institution>;
+    characters?: ElementIds<ElementType.Character>;
+    objects?: ElementIds<ElementType.Object>;
+    locations?: ElementIds<ElementType.Location>;
+    species?: ElementIds<ElementType.Species>;
+    creatures?: ElementIds<ElementType.Creature>;
+    institutions?: ElementIds<ElementType.Institution>;
+    traits?: ElementIds<ElementType.Trait>;
+    collectives?: ElementIds<ElementType.Collective>;
+    zones?: ElementIds<ElementType.Zone>;
+    abilities?: ElementIds<ElementType.Ability>;
+    phenomena?: ElementIds<ElementType.Phenomenon>;
+    languages?: ElementIds<ElementType.Language>;
+    families?: ElementIds<ElementType.Family>;
+    relations?: ElementIds<ElementType.Relation>;
+    titles?: ElementIds<ElementType.Title>;
+    constructs?: ElementIds<ElementType.Construct>;
+    events?: ElementIds<ElementType.Event>;
+    narratives?: ElementIds<ElementType.Narrative>;
 }
 /**
  * Creature element type
@@ -240,24 +207,17 @@ interface Creature extends BaseElement {
     demeanor?: string;
     status?: string;
     birth_date?: string;
-    /** Links to Location */
-    location?: string;
-    /** Links to Zone */
-    zone?: string;
+    location?: ElementId<ElementType.Location>;
+    zone?: ElementId<ElementType.Zone>;
     challenge_rating?: string;
     hit_points?: string;
     armor_class?: string;
     speed?: string;
-    /** Links to Species */
-    species?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Language */
-    languages?: string[];
-    /** Links to Ability */
-    actions?: string[];
+    species?: ElementIds<ElementType.Species>;
+    traits?: ElementIds<ElementType.Trait>;
+    abilities?: ElementIds<ElementType.Ability>;
+    languages?: ElementIds<ElementType.Language>;
+    actions?: ElementIds<ElementType.Ability>;
 }
 /**
  * Event element type
@@ -268,40 +228,23 @@ interface Event extends BaseElement {
     consequences?: string;
     start_date?: string;
     end_date?: string;
-    /** Links to Event */
-    triggers?: string[];
-    /** Links to Character */
-    characters?: string[];
-    /** Links to Object */
-    objects?: string[];
-    /** Links to Location */
-    locations?: string[];
-    /** Links to Species */
-    species?: string[];
-    /** Links to Creature */
-    creatures?: string[];
-    /** Links to Institution */
-    institutions?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Collective */
-    collectives?: string[];
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Phenomenon */
-    phenomena?: string[];
-    /** Links to Language */
-    languages?: string[];
-    /** Links to Family */
-    families?: string[];
-    /** Links to Relation */
-    relations?: string[];
-    /** Links to Title */
-    titles?: string[];
-    /** Links to Construct */
-    constructs?: string[];
+    triggers?: ElementIds<ElementType.Event>;
+    characters?: ElementIds<ElementType.Character>;
+    objects?: ElementIds<ElementType.Object>;
+    locations?: ElementIds<ElementType.Location>;
+    species?: ElementIds<ElementType.Species>;
+    creatures?: ElementIds<ElementType.Creature>;
+    institutions?: ElementIds<ElementType.Institution>;
+    traits?: ElementIds<ElementType.Trait>;
+    collectives?: ElementIds<ElementType.Collective>;
+    zones?: ElementIds<ElementType.Zone>;
+    abilities?: ElementIds<ElementType.Ability>;
+    phenomena?: ElementIds<ElementType.Phenomenon>;
+    languages?: ElementIds<ElementType.Language>;
+    families?: ElementIds<ElementType.Family>;
+    relations?: ElementIds<ElementType.Relation>;
+    titles?: ElementIds<ElementType.Title>;
+    constructs?: ElementIds<ElementType.Construct>;
 }
 /**
  * Family element type
@@ -310,24 +253,15 @@ interface Family extends BaseElement {
     spirit?: string;
     history?: string;
     reputation?: string;
-    /** Links to Construct */
-    traditions?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Language */
-    languages?: string[];
-    /** Links to Character */
-    ancestors?: string[];
-    /** Links to Location */
-    estates?: string[];
-    /** Links to Institution */
-    governs?: string[];
-    /** Links to Object */
-    heirlooms?: string[];
-    /** Links to Creature */
-    creatures?: string[];
+    traditions?: ElementIds<ElementType.Construct>;
+    traits?: ElementIds<ElementType.Trait>;
+    abilities?: ElementIds<ElementType.Ability>;
+    languages?: ElementIds<ElementType.Language>;
+    ancestors?: ElementIds<ElementType.Character>;
+    estates?: ElementIds<ElementType.Location>;
+    governs?: ElementIds<ElementType.Institution>;
+    heirlooms?: ElementIds<ElementType.Object>;
+    creatures?: ElementIds<ElementType.Creature>;
 }
 /**
  * Institution element type
@@ -335,21 +269,14 @@ interface Family extends BaseElement {
 interface Institution extends BaseElement {
     doctrine?: string;
     founding_date?: string;
-    /** Links to Institution */
-    parent_institution?: string;
+    parent_institution?: ElementId<ElementType.Institution>;
     status?: string;
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Object */
-    objects?: string[];
-    /** Links to Creature */
-    creatures?: string[];
-    /** Links to Institution */
-    allies?: string[];
-    /** Links to Institution */
-    adversaries?: string[];
-    /** Links to Construct */
-    constructs?: string[];
+    zones?: ElementIds<ElementType.Zone>;
+    objects?: ElementIds<ElementType.Object>;
+    creatures?: ElementIds<ElementType.Creature>;
+    allies?: ElementIds<ElementType.Institution>;
+    adversaries?: ElementIds<ElementType.Institution>;
+    constructs?: ElementIds<ElementType.Construct>;
 }
 /**
  * Language element type
@@ -359,13 +286,10 @@ interface Language extends BaseElement {
     grammar?: string;
     lexicon?: string;
     writing?: string;
-    /** Links to Construct */
-    classification?: string;
+    classification?: ElementId<ElementType.Construct>;
     status?: string;
-    /** Links to Location */
-    spread?: string[];
-    /** Links to Language */
-    dialects?: string[];
+    spread?: ElementIds<ElementType.Location>;
+    dialects?: ElementIds<ElementType.Language>;
 }
 /**
  * Law element type
@@ -374,22 +298,14 @@ interface Law extends BaseElement {
     declaration?: string;
     purpose?: string;
     date?: string;
-    /** Links to Law */
-    parent_law?: string;
-    /** Links to Institution */
-    author?: string;
-    /** Links to Construct */
-    penalties?: string[];
-    /** Links to Location */
-    locations?: string[];
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Construct */
-    prohibitions?: string[];
-    /** Links to Title */
-    adjudicators?: string[];
-    /** Links to Title */
-    enforcers?: string[];
+    parent_law?: ElementId<ElementType.Law>;
+    author?: ElementId<ElementType.Institution>;
+    penalties?: ElementIds<ElementType.Construct>;
+    locations?: ElementIds<ElementType.Location>;
+    zones?: ElementIds<ElementType.Zone>;
+    prohibitions?: ElementIds<ElementType.Construct>;
+    adjudicators?: ElementIds<ElementType.Title>;
+    enforcers?: ElementIds<ElementType.Title>;
 }
 /**
  * Location element type
@@ -398,56 +314,34 @@ interface Location extends BaseElement {
     form?: string;
     function?: string;
     founding_date?: string;
-    /** Links to Location */
-    parent_location?: string;
+    parent_location?: ElementId<ElementType.Location>;
     political_climate?: string;
-    /** Links to Institution */
-    primary_power?: string;
-    /** Links to Title */
-    governing_title?: string;
-    /** Links to Zone */
-    zone?: string;
-    /** Links to Location */
-    rival?: string;
-    /** Links to Location */
-    partner?: string;
+    primary_power?: ElementId<ElementType.Institution>;
+    governing_title?: ElementId<ElementType.Title>;
+    zone?: ElementId<ElementType.Zone>;
+    rival?: ElementId<ElementType.Location>;
+    partner?: ElementId<ElementType.Location>;
     customs?: string;
     infrastructure?: string;
     architecture?: string;
     defensibility?: string;
     elevation?: string;
-    /** Links to Collective */
-    populations?: string[];
-    /** Links to Institution */
-    secondary_powers?: string[];
-    /** Links to Character */
-    founders?: string[];
-    /** Links to Construct */
-    cults?: string[];
-    /** Links to Species */
-    delicacies?: string[];
-    /** Links to Construct */
-    extraction_methods?: string[];
-    /** Links to Construct */
-    extraction_goods?: string[];
-    /** Links to Construct */
-    industry_methods?: string[];
-    /** Links to Construct */
-    industry_goods?: string[];
-    /** Links to Location */
-    extraction_markets?: string[];
-    /** Links to Location */
-    industry_markets?: string[];
-    /** Links to Construct */
-    currencies?: string[];
-    /** Links to Object */
-    buildings?: string[];
-    /** Links to Construct */
-    building_methods?: string[];
-    /** Links to Construct */
-    fighters?: string[];
-    /** Links to Object */
-    defensive_objects?: string[];
+    populations?: ElementIds<ElementType.Collective>;
+    secondary_powers?: ElementIds<ElementType.Institution>;
+    founders?: ElementIds<ElementType.Character>;
+    cults?: ElementIds<ElementType.Construct>;
+    delicacies?: ElementIds<ElementType.Species>;
+    extraction_methods?: ElementIds<ElementType.Construct>;
+    extraction_goods?: ElementIds<ElementType.Construct>;
+    industry_methods?: ElementIds<ElementType.Construct>;
+    industry_goods?: ElementIds<ElementType.Construct>;
+    extraction_markets?: ElementIds<ElementType.Location>;
+    industry_markets?: ElementIds<ElementType.Location>;
+    currencies?: ElementIds<ElementType.Construct>;
+    buildings?: ElementIds<ElementType.Object>;
+    building_methods?: ElementIds<ElementType.Construct>;
+    fighters?: ElementIds<ElementType.Construct>;
+    defensive_objects?: ElementIds<ElementType.Object>;
 }
 /**
  * Phenomenon element type
@@ -457,18 +351,12 @@ interface Phenomenon extends BaseElement {
     effects?: string;
     duration?: string;
     mythology?: string;
-    /** Links to Phenomenon */
-    system?: string;
-    /** Links to Object */
-    catalysts?: string[];
-    /** Links to Ability */
-    empowerments?: string[];
-    /** Links to Construct */
-    triggers?: string[];
-    /** Links to Character */
-    wielders?: string[];
-    /** Links to Location */
-    environments?: string[];
+    system?: ElementId<ElementType.Phenomenon>;
+    catalysts?: ElementIds<ElementType.Object>;
+    empowerments?: ElementIds<ElementType.Ability>;
+    triggers?: ElementIds<ElementType.Construct>;
+    wielders?: ElementIds<ElementType.Character>;
+    environments?: ElementIds<ElementType.Location>;
 }
 /**
  * Relation element type
@@ -478,42 +366,24 @@ interface Relation extends BaseElement {
     start_date?: string;
     end_date?: string;
     intensity?: string;
-    /** Links to Character */
-    actor?: string;
-    /** Links to Character */
-    characters?: string[];
-    /** Links to Object */
-    objects?: string[];
-    /** Links to Location */
-    locations?: string[];
-    /** Links to Species */
-    species?: string[];
-    /** Links to Creature */
-    creatures?: string[];
-    /** Links to Institution */
-    institutions?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Collective */
-    collectives?: string[];
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Phenomenon */
-    phenomena?: string[];
-    /** Links to Language */
-    languages?: string[];
-    /** Links to Family */
-    families?: string[];
-    /** Links to Title */
-    titles?: string[];
-    /** Links to Construct */
-    constructs?: string[];
-    /** Links to Event */
-    events?: string[];
-    /** Links to Narrative */
-    narratives?: string[];
+    actor?: ElementId<ElementType.Character>;
+    characters?: ElementIds<ElementType.Character>;
+    objects?: ElementIds<ElementType.Object>;
+    locations?: ElementIds<ElementType.Location>;
+    species?: ElementIds<ElementType.Species>;
+    creatures?: ElementIds<ElementType.Creature>;
+    institutions?: ElementIds<ElementType.Institution>;
+    traits?: ElementIds<ElementType.Trait>;
+    collectives?: ElementIds<ElementType.Collective>;
+    zones?: ElementIds<ElementType.Zone>;
+    abilities?: ElementIds<ElementType.Ability>;
+    phenomena?: ElementIds<ElementType.Phenomenon>;
+    languages?: ElementIds<ElementType.Language>;
+    families?: ElementIds<ElementType.Family>;
+    titles?: ElementIds<ElementType.Title>;
+    constructs?: ElementIds<ElementType.Construct>;
+    events?: ElementIds<ElementType.Event>;
+    narratives?: ElementIds<ElementType.Narrative>;
 }
 /**
  * Species element type
@@ -528,22 +398,14 @@ interface Species extends BaseElement {
     communication?: string;
     aggression?: string;
     role?: string;
-    /** Links to Species */
-    parent_species?: string;
-    /** Links to Species */
-    nourishment?: string[];
-    /** Links to Construct */
-    reproduction?: string[];
-    /** Links to Ability */
-    adaptations?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Location */
-    locations?: string[];
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Phenomenon */
-    affinities?: string[];
+    parent_species?: ElementId<ElementType.Species>;
+    nourishment?: ElementIds<ElementType.Species>;
+    reproduction?: ElementIds<ElementType.Construct>;
+    adaptations?: ElementIds<ElementType.Ability>;
+    traits?: ElementIds<ElementType.Trait>;
+    locations?: ElementIds<ElementType.Location>;
+    zones?: ElementIds<ElementType.Zone>;
+    affinities?: ElementIds<ElementType.Phenomenon>;
 }
 /**
  * Zone element type
@@ -553,16 +415,11 @@ interface Zone extends BaseElement {
     start_date?: string;
     end_date?: string;
     context?: string;
-    /** Links to Phenomenon */
-    phenomena?: string[];
-    /** Links to Zone */
-    linked_zones?: string[];
-    /** Links to Collective */
-    populations?: string[];
-    /** Links to Title */
-    titles?: string[];
-    /** Links to Construct */
-    principles?: string[];
+    phenomena?: ElementIds<ElementType.Phenomenon>;
+    linked_zones?: ElementIds<ElementType.Zone>;
+    populations?: ElementIds<ElementType.Collective>;
+    titles?: ElementIds<ElementType.Title>;
+    principles?: ElementIds<ElementType.Construct>;
 }
 /**
  * Title element type
@@ -572,44 +429,26 @@ interface Title extends BaseElement {
     eligibility?: string;
     grant_date?: string;
     revoke_date?: string;
-    /** Links to Institution */
-    issuer?: string;
-    /** Links to Institution */
-    body?: string;
-    /** Links to Title */
-    superior_title?: string;
+    issuer?: ElementId<ElementType.Institution>;
+    body?: ElementId<ElementType.Institution>;
+    superior_title?: ElementId<ElementType.Title>;
     status?: string;
     history?: string;
-    /** Links to Character */
-    holders?: string[];
-    /** Links to Object */
-    symbols?: string[];
-    /** Links to Character */
-    characters?: string[];
-    /** Links to Institution */
-    institutions?: string[];
-    /** Links to Family */
-    families?: string[];
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Location */
-    locations?: string[];
-    /** Links to Object */
-    objects?: string[];
-    /** Links to Construct */
-    constructs?: string[];
-    /** Links to Law */
-    laws?: string[];
-    /** Links to Collective */
-    collectives?: string[];
-    /** Links to Creature */
-    creatures?: string[];
-    /** Links to Phenomenon */
-    phenomena?: string[];
-    /** Links to Species */
-    species?: string[];
-    /** Links to Language */
-    languages?: string[];
+    holders?: ElementIds<ElementType.Character>;
+    symbols?: ElementIds<ElementType.Object>;
+    characters?: ElementIds<ElementType.Character>;
+    institutions?: ElementIds<ElementType.Institution>;
+    families?: ElementIds<ElementType.Family>;
+    zones?: ElementIds<ElementType.Zone>;
+    locations?: ElementIds<ElementType.Location>;
+    objects?: ElementIds<ElementType.Object>;
+    constructs?: ElementIds<ElementType.Construct>;
+    laws?: ElementIds<ElementType.Law>;
+    collectives?: ElementIds<ElementType.Collective>;
+    creatures?: ElementIds<ElementType.Creature>;
+    phenomena?: ElementIds<ElementType.Phenomenon>;
+    species?: ElementIds<ElementType.Species>;
+    languages?: ElementIds<ElementType.Language>;
 }
 /**
  * Trait element type
@@ -627,10 +466,8 @@ interface Trait extends BaseElement {
     creativity?: string;
     courage?: string;
     significance?: string;
-    /** Links to Trait */
-    anti_trait?: string;
-    /** Links to Ability */
-    empowered_abilities?: string[];
+    anti_trait?: ElementId<ElementType.Trait>;
+    empowered_abilities?: ElementIds<ElementType.Ability>;
 }
 /**
  * Narrative element type
@@ -641,52 +478,29 @@ interface Narrative extends BaseElement {
     start_date?: string;
     end_date?: string;
     order?: string;
-    /** Links to Narrative */
-    parent_narrative?: string;
-    /** Links to Character */
-    protagonist?: string;
-    /** Links to Character */
-    antagonist?: string;
-    /** Links to Character */
-    narrator?: string;
-    /** Links to Institution */
-    conservator?: string;
-    /** Links to Event */
-    events?: string[];
-    /** Links to Character */
-    characters?: string[];
-    /** Links to Object */
-    objects?: string[];
-    /** Links to Location */
-    locations?: string[];
-    /** Links to Species */
-    species?: string[];
-    /** Links to Creature */
-    creatures?: string[];
-    /** Links to Institution */
-    institutions?: string[];
-    /** Links to Trait */
-    traits?: string[];
-    /** Links to Collective */
-    collectives?: string[];
-    /** Links to Zone */
-    zones?: string[];
-    /** Links to Ability */
-    abilities?: string[];
-    /** Links to Phenomenon */
-    phenomena?: string[];
-    /** Links to Language */
-    languages?: string[];
-    /** Links to Family */
-    families?: string[];
-    /** Links to Relation */
-    relations?: string[];
-    /** Links to Title */
-    titles?: string[];
-    /** Links to Construct */
-    constructs?: string[];
-    /** Links to Law */
-    laws?: string[];
+    parent_narrative?: ElementId<ElementType.Narrative>;
+    protagonist?: ElementId<ElementType.Character>;
+    antagonist?: ElementId<ElementType.Character>;
+    narrator?: ElementId<ElementType.Character>;
+    conservator?: ElementId<ElementType.Institution>;
+    events?: ElementIds<ElementType.Event>;
+    characters?: ElementIds<ElementType.Character>;
+    objects?: ElementIds<ElementType.Object>;
+    locations?: ElementIds<ElementType.Location>;
+    species?: ElementIds<ElementType.Species>;
+    creatures?: ElementIds<ElementType.Creature>;
+    institutions?: ElementIds<ElementType.Institution>;
+    traits?: ElementIds<ElementType.Trait>;
+    collectives?: ElementIds<ElementType.Collective>;
+    zones?: ElementIds<ElementType.Zone>;
+    abilities?: ElementIds<ElementType.Ability>;
+    phenomena?: ElementIds<ElementType.Phenomenon>;
+    languages?: ElementIds<ElementType.Language>;
+    families?: ElementIds<ElementType.Family>;
+    relations?: ElementIds<ElementType.Relation>;
+    titles?: ElementIds<ElementType.Title>;
+    constructs?: ElementIds<ElementType.Construct>;
+    laws?: ElementIds<ElementType.Law>;
 }
 /**
  * Map element type
@@ -697,34 +511,29 @@ interface Map extends BaseElement {
     width?: string;
     height?: string;
     depth?: string;
-    /** Links to Map */
-    parent_map?: string;
-    /** Links to Location */
-    location?: string;
+    parent_map?: ElementId<ElementType.Map>;
+    location?: ElementId<ElementType.Location>;
 }
 /**
  * Marker element type
  */
 interface Marker extends BaseElement {
-    /** Links to Map */
-    map?: string;
-    /** Links to Zone */
-    zone?: string;
-    x?: string;
-    y?: string;
-    z?: string;
+    map?: ElementId<ElementType.Map>;
+    zone?: ElementId<ElementType.Zone>;
+    x?: number;
+    y?: number;
+    z?: number;
 }
 /**
  * Pin element type
  */
 interface Pin extends BaseElement {
-    /** Links to Map */
-    map?: string;
-    /** Links to ContentType */
-    element_type?: string;
-    x?: string;
-    y?: string;
-    z?: string;
+    map?: ElementId<ElementType.Map>;
+    element_type?: ElementType;
+    element_id?: AnyElementId;
+    x?: number;
+    y?: number;
+    z?: number;
 }
 /**
  * Input types for API requests (using _id and _ids suffixes)
@@ -984,9 +793,9 @@ interface MarkerInput extends Omit<Marker, 'map' | 'zone'> {
     map_id?: string;
     zone_id?: string;
 }
-interface PinInput extends Omit<Pin, 'map' | 'element_type'> {
+interface PinInput extends Omit<Pin, 'map' | 'element_id'> {
     map_id?: string;
-    element_type_id?: string;
+    element_id?: string;
 }
 /**
  * All available element types in OnlyWorlds
@@ -1015,6 +824,1380 @@ declare enum ElementType {
     Trait = "trait",
     Zone = "zone"
 }
+/**
+ * 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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;
+/**
+ * Creates a typed element ID from a string
+ * @param id The string ID to brand
+ * @returns Branded ElementId
+ */
+declare function createElementId<T extends ElementType>(id: string): ElementId<T>;
+/**
+ * Creates typed element IDs array from string array
+ * @param ids The string IDs to brand
+ * @returns Branded ElementIds array
+ */
+declare function createElementIds<T extends ElementType>(ids: string[]): ElementIds<T>;
+/**
+ * Creates an AnyElementId that can reference any element type
+ * @param id The string ID to brand
+ * @returns AnyElementId
+ */
+declare function createAnyElementId(id: string): AnyElementId;
 
 interface OnlyWorldsConfig {
     apiKey: string;
@@ -1095,4 +2278,4 @@ declare class OnlyWorldsClient {
     static prepareInput<T extends Record<string, any>>(data: T): any;
 }
 
-export { type Ability, type AbilityInput, type ApiResponse, type BaseElement, type Character, type CharacterInput, type Collective, type CollectiveInput, type Construct, type ConstructInput, type Creature, type CreatureInput, ElementType, type Event, type EventInput, type Family, type FamilyInput, 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 };
+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, 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 };