@onlyworlds/sdk 1.4.1 → 2.0.0

package/dist/index.d.mts

@@ -72,92 +72,96 @@ interface WorldInput {
 }
 /**
  * Ability element type
+ * Fields organized by sections: Mechanics, World
  */
 interface Ability extends BaseElement {
     activation?: string;
-    duration?: string;
-    potency?: string;
-    range?: string;
+    duration?: number;
+    potency?: number;
+    range?: number;
+    effects?: ElementIds<ElementType.Phenomenon>;
     challenges?: string;
+    talents?: ElementIds<ElementType.Trait>;
+    requisites?: ElementIds<ElementType.Construct>;
     prevalence?: 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
+ * Fields organized by sections: Form, Function, World
  */
 interface Object$1 extends BaseElement {
     aesthetics?: string;
-    weight?: string;
-    amount?: string;
+    weight?: number;
+    amount?: number;
     parent_object?: ElementId<ElementType.Object>;
-    utility?: string;
-    origins?: string;
-    location?: ElementId<ElementType.Location>;
-    language?: ElementId<ElementType.Language>;
     materials?: ElementIds<ElementType.Construct>;
     technology?: ElementIds<ElementType.Construct>;
+    utility?: string;
     effects?: ElementIds<ElementType.Phenomenon>;
     abilities?: ElementIds<ElementType.Ability>;
     consumes?: ElementIds<ElementType.Construct>;
+    origins?: string;
+    location?: ElementId<ElementType.Location>;
+    language?: ElementId<ElementType.Language>;
     affinities?: ElementIds<ElementType.Trait>;
 }
 /**
  * Character element type
+ * Fields organized by sections: Constitution, Origins, World, Personality, Social, TTRPG
  */
 interface Character extends BaseElement {
     physicality?: string;
     mentality?: string;
-    height?: string;
-    weight?: string;
+    height?: number;
+    weight?: number;
+    species?: ElementIds<ElementType.Species>;
+    traits?: ElementIds<ElementType.Trait>;
+    abilities?: ElementIds<ElementType.Ability>;
     background?: string;
     motivations?: string;
-    birth_date?: string;
+    birth_date?: number;
     birthplace?: ElementId<ElementType.Location>;
+    languages?: ElementIds<ElementType.Language>;
     reputation?: string;
     location?: ElementId<ElementType.Location>;
-    charisma?: string;
-    coercion?: string;
-    competence?: string;
-    compassion?: string;
-    creativity?: string;
-    courage?: string;
-    level?: string;
-    hit_points?: string;
-    STR?: string;
-    DEX?: string;
-    CON?: string;
-    INT?: string;
-    WIS?: string;
-    CHA?: 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>;
+    charisma?: number;
+    coercion?: number;
+    competence?: number;
+    compassion?: number;
+    creativity?: number;
+    courage?: number;
     family?: ElementIds<ElementType.Family>;
     friends?: ElementIds<ElementType.Character>;
     rivals?: ElementIds<ElementType.Character>;
+    level?: number;
+    hit_points?: number;
+    STR?: number;
+    DEX?: number;
+    CON?: number;
+    INT?: number;
+    WIS?: number;
+    CHA?: number;
 }
 /**
  * Collective element type
+ * Fields organized by sections: Formation, Dynamics, World
  */
 interface Collective extends BaseElement {
     composition?: string;
-    count?: string;
-    formation_date?: string;
+    count?: number;
+    formation_date?: number;
     operator?: ElementId<ElementType.Institution>;
+    equipment?: ElementIds<ElementType.Construct>;
     activity?: string;
     disposition?: string;
     state?: string;
-    equipment?: ElementIds<ElementType.Construct>;
     abilities?: ElementIds<ElementType.Ability>;
     symbolism?: ElementIds<ElementType.Construct>;
     species?: ElementIds<ElementType.Species>;
@@ -167,14 +171,15 @@ interface Collective extends BaseElement {
 }
 /**
  * Construct element type
+ * Fields organized by sections: Nature, Involves
  */
 interface Construct extends BaseElement {
     rationale?: string;
     history?: string;
     status?: string;
     reach?: string;
-    start_date?: string;
-    end_date?: string;
+    start_date?: number;
+    end_date?: number;
     founder?: ElementId<ElementType.Character>;
     custodian?: ElementId<ElementType.Institution>;
     characters?: ElementIds<ElementType.Character>;
@@ -198,36 +203,38 @@ interface Construct extends BaseElement {
 }
 /**
  * Creature element type
+ * Fields organized by sections: Biology, Behaviour, World, TTRPG
  */
 interface Creature extends BaseElement {
     appearance?: string;
-    weight?: string;
-    height?: string;
+    weight?: number;
+    height?: number;
+    species?: ElementIds<ElementType.Species>;
     habits?: string;
     demeanor?: string;
-    status?: string;
-    birth_date?: string;
-    location?: ElementId<ElementType.Location>;
-    zone?: ElementId<ElementType.Zone>;
-    challenge_rating?: string;
-    hit_points?: string;
-    armor_class?: string;
-    speed?: string;
-    species?: ElementIds<ElementType.Species>;
     traits?: ElementIds<ElementType.Trait>;
     abilities?: ElementIds<ElementType.Ability>;
     languages?: ElementIds<ElementType.Language>;
+    status?: string;
+    birth_date?: number;
+    location?: ElementId<ElementType.Location>;
+    zone?: ElementId<ElementType.Zone>;
+    challenge_rating?: number;
+    hit_points?: number;
+    armor_class?: number;
+    speed?: number;
     actions?: ElementIds<ElementType.Ability>;
 }
 /**
  * Event element type
+ * Fields organized by sections: Nature, Involves
  */
 interface Event extends BaseElement {
     history?: string;
     challenges?: string;
     consequences?: string;
-    start_date?: string;
-    end_date?: string;
+    start_date?: number;
+    end_date?: number;
     triggers?: ElementIds<ElementType.Event>;
     characters?: ElementIds<ElementType.Character>;
     objects?: ElementIds<ElementType.Object>;
@@ -248,16 +255,17 @@ interface Event extends BaseElement {
 }
 /**
  * Family element type
+ * Fields organized by sections: Identity, World
  */
 interface Family extends BaseElement {
     spirit?: string;
     history?: string;
-    reputation?: string;
     traditions?: ElementIds<ElementType.Construct>;
     traits?: ElementIds<ElementType.Trait>;
     abilities?: ElementIds<ElementType.Ability>;
     languages?: ElementIds<ElementType.Language>;
     ancestors?: ElementIds<ElementType.Character>;
+    reputation?: string;
     estates?: ElementIds<ElementType.Location>;
     governs?: ElementIds<ElementType.Institution>;
     heirlooms?: ElementIds<ElementType.Object>;
@@ -265,21 +273,23 @@ interface Family extends BaseElement {
 }
 /**
  * Institution element type
+ * Fields organized by sections: Foundation, Claims, World
  */
 interface Institution extends BaseElement {
     doctrine?: string;
-    founding_date?: string;
+    founding_date?: number;
     parent_institution?: ElementId<ElementType.Institution>;
-    status?: string;
     zones?: ElementIds<ElementType.Zone>;
     objects?: ElementIds<ElementType.Object>;
     creatures?: ElementIds<ElementType.Creature>;
+    status?: string;
     allies?: ElementIds<ElementType.Institution>;
     adversaries?: ElementIds<ElementType.Institution>;
     constructs?: ElementIds<ElementType.Construct>;
 }
 /**
  * Language element type
+ * Fields organized by sections: Structure, World
  */
 interface Language extends BaseElement {
     phonology?: string;
@@ -293,14 +303,15 @@ interface Language extends BaseElement {
 }
 /**
  * Law element type
+ * Fields organized by sections: Code, World
  */
 interface Law extends BaseElement {
     declaration?: string;
     purpose?: string;
-    date?: string;
+    date?: number;
     parent_law?: ElementId<ElementType.Law>;
-    author?: ElementId<ElementType.Institution>;
     penalties?: ElementIds<ElementType.Construct>;
+    author?: ElementId<ElementType.Institution>;
     locations?: ElementIds<ElementType.Location>;
     zones?: ElementIds<ElementType.Zone>;
     prohibitions?: ElementIds<ElementType.Construct>;
@@ -309,25 +320,22 @@ interface Law extends BaseElement {
 }
 /**
  * Location element type
+ * Fields organized by sections: Setting, Politics, World, Production, Commerce, Construction, Defense
  */
 interface Location extends BaseElement {
     form?: string;
     function?: string;
-    founding_date?: string;
+    founding_date?: number;
     parent_location?: ElementId<ElementType.Location>;
+    populations?: ElementIds<ElementType.Collective>;
     political_climate?: string;
     primary_power?: ElementId<ElementType.Institution>;
     governing_title?: ElementId<ElementType.Title>;
+    secondary_powers?: ElementIds<ElementType.Institution>;
     zone?: ElementId<ElementType.Zone>;
     rival?: ElementId<ElementType.Location>;
     partner?: ElementId<ElementType.Location>;
     customs?: string;
-    infrastructure?: string;
-    architecture?: string;
-    defensibility?: string;
-    elevation?: string;
-    populations?: ElementIds<ElementType.Collective>;
-    secondary_powers?: ElementIds<ElementType.Institution>;
     founders?: ElementIds<ElementType.Character>;
     cults?: ElementIds<ElementType.Construct>;
     delicacies?: ElementIds<ElementType.Species>;
@@ -335,38 +343,45 @@ interface Location extends BaseElement {
     extraction_goods?: ElementIds<ElementType.Construct>;
     industry_methods?: ElementIds<ElementType.Construct>;
     industry_goods?: ElementIds<ElementType.Construct>;
+    infrastructure?: string;
     extraction_markets?: ElementIds<ElementType.Location>;
     industry_markets?: ElementIds<ElementType.Location>;
     currencies?: ElementIds<ElementType.Construct>;
+    architecture?: string;
     buildings?: ElementIds<ElementType.Object>;
     building_methods?: ElementIds<ElementType.Construct>;
+    defensibility?: string;
+    elevation?: number;
     fighters?: ElementIds<ElementType.Construct>;
     defensive_objects?: ElementIds<ElementType.Object>;
 }
 /**
  * Phenomenon element type
+ * Fields organized by sections: Mechanics, World
  */
 interface Phenomenon extends BaseElement {
     expression?: string;
     effects?: string;
-    duration?: string;
-    mythology?: string;
-    system?: ElementId<ElementType.Phenomenon>;
+    duration?: number;
     catalysts?: ElementIds<ElementType.Object>;
     empowerments?: ElementIds<ElementType.Ability>;
+    mythology?: string;
+    system?: ElementId<ElementType.Phenomenon>;
     triggers?: ElementIds<ElementType.Construct>;
     wielders?: ElementIds<ElementType.Character>;
     environments?: ElementIds<ElementType.Location>;
 }
 /**
  * Relation element type
+ * Fields organized by sections: Nature, Involves
  */
 interface Relation extends BaseElement {
     background?: string;
-    start_date?: string;
-    end_date?: string;
-    intensity?: string;
+    start_date?: number;
+    end_date?: number;
+    intensity?: number;
     actor?: ElementId<ElementType.Character>;
+    events?: ElementIds<ElementType.Event>;
     characters?: ElementIds<ElementType.Character>;
     objects?: ElementIds<ElementType.Object>;
     locations?: ElementIds<ElementType.Location>;
@@ -382,60 +397,62 @@ interface Relation extends BaseElement {
     families?: ElementIds<ElementType.Family>;
     titles?: ElementIds<ElementType.Title>;
     constructs?: ElementIds<ElementType.Construct>;
-    events?: ElementIds<ElementType.Event>;
     narratives?: ElementIds<ElementType.Narrative>;
 }
 /**
  * Species element type
+ * Fields organized by sections: Biology, Psychology, World
  */
 interface Species extends BaseElement {
     appearance?: string;
-    life_span?: string;
-    weight?: string;
+    life_span?: number;
+    weight?: number;
+    nourishment?: ElementIds<ElementType.Species>;
+    reproduction?: ElementIds<ElementType.Construct>;
+    adaptations?: ElementIds<ElementType.Ability>;
     instincts?: string;
     sociality?: string;
     temperament?: string;
     communication?: string;
-    aggression?: string;
+    aggression?: number;
+    traits?: ElementIds<ElementType.Trait>;
     role?: 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
+ * Fields organized by sections: Scope, World
  */
 interface Zone extends BaseElement {
     role?: string;
-    start_date?: string;
-    end_date?: string;
-    context?: string;
+    start_date?: number;
+    end_date?: number;
     phenomena?: ElementIds<ElementType.Phenomenon>;
     linked_zones?: ElementIds<ElementType.Zone>;
+    context?: string;
     populations?: ElementIds<ElementType.Collective>;
     titles?: ElementIds<ElementType.Title>;
     principles?: ElementIds<ElementType.Construct>;
 }
 /**
  * Title element type
+ * Fields organized by sections: Mandate, World
  */
 interface Title extends BaseElement {
     authority?: string;
     eligibility?: string;
-    grant_date?: string;
-    revoke_date?: string;
+    grant_date?: number;
+    revoke_date?: number;
     issuer?: ElementId<ElementType.Institution>;
     body?: ElementId<ElementType.Institution>;
     superior_title?: ElementId<ElementType.Title>;
-    status?: string;
-    history?: string;
     holders?: ElementIds<ElementType.Character>;
     symbols?: ElementIds<ElementType.Object>;
+    status?: string;
+    history?: string;
     characters?: ElementIds<ElementType.Character>;
     institutions?: ElementIds<ElementType.Institution>;
     families?: ElementIds<ElementType.Family>;
@@ -452,6 +469,7 @@ interface Title extends BaseElement {
 }
 /**
  * Trait element type
+ * Fields organized by sections: Qualitative, Quantitative, World
  */
 interface Trait extends BaseElement {
     social_effects?: string;
@@ -459,25 +477,26 @@ interface Trait extends BaseElement {
     functional_effects?: string;
     personality_effects?: string;
     behaviour_effects?: string;
-    charisma?: string;
-    coercion?: string;
-    competence?: string;
-    compassion?: string;
-    creativity?: string;
-    courage?: string;
+    charisma?: number;
+    coercion?: number;
+    competence?: number;
+    compassion?: number;
+    creativity?: number;
+    courage?: number;
     significance?: string;
     anti_trait?: ElementId<ElementType.Trait>;
     empowered_abilities?: ElementIds<ElementType.Ability>;
 }
 /**
  * Narrative element type
+ * Fields organized by sections: Context, Involves
  */
 interface Narrative extends BaseElement {
     story?: string;
     consequences?: string;
-    start_date?: string;
-    end_date?: string;
-    order?: string;
+    start_date?: number;
+    end_date?: number;
+    order?: number;
     parent_narrative?: ElementId<ElementType.Narrative>;
     protagonist?: ElementId<ElementType.Character>;
     antagonist?: ElementId<ElementType.Character>;
@@ -504,18 +523,20 @@ interface Narrative extends BaseElement {
 }
 /**
  * Map element type
+ * Fields organized by sections: Details
  */
 interface Map extends BaseElement {
     background_color?: string;
-    hierarchy?: string;
-    width?: string;
-    height?: string;
-    depth?: string;
+    hierarchy?: number;
+    width?: number;
+    height?: number;
+    depth?: number;
     parent_map?: ElementId<ElementType.Map>;
     location?: ElementId<ElementType.Location>;
 }
 /**
  * Marker element type
+ * Fields organized by sections: Details
  */
 interface Marker extends BaseElement {
     map?: ElementId<ElementType.Map>;
@@ -526,6 +547,7 @@ interface Marker extends BaseElement {
 }
 /**
  * Pin element type
+ * Fields organized by sections: Details
  */
 interface Pin extends BaseElement {
     map?: ElementId<ElementType.Map>;
@@ -835,6 +857,26 @@ declare const ELEMENT_LABELS: Record<ElementType, string>;
  * @returns The plural label string
  */
 declare function getElementLabel(elementType: ElementType): string;
+/**
+ * Section metadata for OnlyWorlds elements
+ * Source: sectioned_schema.json
+ */
+interface SectionInfo {
+    name: string;
+    order: number;
+    fields: string[];
+}
+/**
+ * Element section definitions - provides organized field groupings for each element type
+ * Enables UI components to display fields in logical sections with proper ordering
+ */
+declare const ELEMENT_SECTIONS: Record<ElementType, SectionInfo[]>;
+/**
+ * Get sections for an element type
+ * @param elementType The element type
+ * @returns Array of section information for the element type
+ */
+declare function getElementSections(elementType: ElementType): SectionInfo[];
 /**
  * Current OnlyWorlds version
  * Synced with https://github.com/OnlyWorlds/OnlyWorlds/blob/main/VERSION
@@ -864,8 +906,6 @@ declare function getElementIcon(elementType: ElementType): string;
  * @returns Unicode symbol string
  */
 declare function getElementUnicodeIcon(elementType: ElementType): string;
-declare const ELEMENT_MATERIAL_ICONS: Record<ElementType, string>;
-declare const getElementMaterialIcon: typeof getElementIcon;
 /**
  * Field type definitions for OnlyWorlds elements
  */
@@ -888,17 +928,29 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly duration: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly potency: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly range: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        readonly effects: {
+            readonly type: "multi_link";
+            readonly target: "phenomenon";
         };
         readonly challenges: {
             readonly type: "text";
         };
+        readonly talents: {
+            readonly type: "multi_link";
+            readonly target: "trait";
+        };
+        readonly requisites: {
+            readonly type: "multi_link";
+            readonly target: "construct";
+        };
         readonly prevalence: {
             readonly type: "text";
         };
@@ -914,18 +966,6 @@ declare const FIELD_SCHEMA: {
             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";
@@ -943,10 +983,22 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly height: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly weight: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        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 background: {
             readonly type: "text";
@@ -955,96 +1007,84 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly birth_date: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        readonly birthplace: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
         };
         readonly reputation: {
             readonly type: "text";
         };
+        readonly location: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly objects: {
+            readonly type: "multi_link";
+            readonly target: "object";
+        };
+        readonly institutions: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
         readonly charisma: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly coercion: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly competence: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly compassion: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly creativity: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly courage: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        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 level: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly hit_points: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly STR: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly DEX: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly CON: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly INT: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly WIS: {
-            readonly type: "text";
+            readonly type: "number";
         };
         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 type: "number";
         };
     };
     readonly collective: {
@@ -1052,10 +1092,18 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly count: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly formation_date: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        readonly operator: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
+        readonly equipment: {
+            readonly type: "multi_link";
+            readonly target: "construct";
         };
         readonly activity: {
             readonly type: "text";
@@ -1066,14 +1114,6 @@ declare const FIELD_SCHEMA: {
         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";
@@ -1113,10 +1153,10 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly start_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly end_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly founder: {
             readonly type: "single_link";
@@ -1204,10 +1244,14 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly weight: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly height: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        readonly species: {
+            readonly type: "multi_link";
+            readonly target: "species";
         };
         readonly habits: {
             readonly type: "text";
@@ -1215,23 +1259,23 @@ declare const FIELD_SCHEMA: {
         readonly demeanor: {
             readonly type: "text";
         };
-        readonly status: {
-            readonly type: "text";
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
         };
-        readonly birth_date: {
-            readonly type: "text";
+        readonly abilities: {
+            readonly type: "multi_link";
+            readonly target: "ability";
         };
-        readonly challenge_rating: {
-            readonly type: "text";
+        readonly languages: {
+            readonly type: "multi_link";
+            readonly target: "language";
         };
-        readonly hit_points: {
+        readonly status: {
             readonly type: "text";
         };
-        readonly armor_class: {
-            readonly type: "text";
-        };
-        readonly speed: {
-            readonly type: "text";
+        readonly birth_date: {
+            readonly type: "number";
         };
         readonly location: {
             readonly type: "single_link";
@@ -1241,21 +1285,17 @@ declare const FIELD_SCHEMA: {
             readonly type: "single_link";
             readonly target: "zone";
         };
-        readonly species: {
-            readonly type: "multi_link";
-            readonly target: "species";
+        readonly challenge_rating: {
+            readonly type: "number";
         };
-        readonly traits: {
-            readonly type: "multi_link";
-            readonly target: "trait";
+        readonly hit_points: {
+            readonly type: "number";
         };
-        readonly abilities: {
-            readonly type: "multi_link";
-            readonly target: "ability";
+        readonly armor_class: {
+            readonly type: "number";
         };
-        readonly languages: {
-            readonly type: "multi_link";
-            readonly target: "language";
+        readonly speed: {
+            readonly type: "number";
         };
         readonly actions: {
             readonly type: "multi_link";
@@ -1273,14 +1313,14 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly start_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly end_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly triggers: {
             readonly type: "multi_link";
-            readonly target: "event";
+            readonly target: "construct";
         };
         readonly characters: {
             readonly type: "multi_link";
@@ -1354,9 +1394,6 @@ declare const FIELD_SCHEMA: {
         readonly history: {
             readonly type: "text";
         };
-        readonly reputation: {
-            readonly type: "text";
-        };
         readonly traditions: {
             readonly type: "multi_link";
             readonly target: "construct";
@@ -1377,6 +1414,9 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "character";
         };
+        readonly reputation: {
+            readonly type: "text";
+        };
         readonly estates: {
             readonly type: "multi_link";
             readonly target: "location";
@@ -1399,10 +1439,7 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly founding_date: {
-            readonly type: "text";
-        };
-        readonly status: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly parent_institution: {
             readonly type: "single_link";
@@ -1420,6 +1457,9 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "creature";
         };
+        readonly status: {
+            readonly type: "text";
+        };
         readonly allies: {
             readonly type: "multi_link";
             readonly target: "institution";
@@ -1446,13 +1486,13 @@ declare const FIELD_SCHEMA: {
         readonly writing: {
             readonly type: "text";
         };
-        readonly status: {
-            readonly type: "text";
-        };
         readonly classification: {
             readonly type: "single_link";
             readonly target: "construct";
         };
+        readonly status: {
+            readonly type: "text";
+        };
         readonly spread: {
             readonly type: "multi_link";
             readonly target: "location";
@@ -1470,20 +1510,20 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         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 author: {
+            readonly type: "single_link";
+            readonly target: "institution";
+        };
         readonly locations: {
             readonly type: "multi_link";
             readonly target: "location";
@@ -1513,30 +1553,19 @@ declare const FIELD_SCHEMA: {
             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 type: "number";
         };
         readonly parent_location: {
             readonly type: "single_link";
             readonly target: "location";
         };
+        readonly populations: {
+            readonly type: "multi_link";
+            readonly target: "collective";
+        };
+        readonly political_climate: {
+            readonly type: "text";
+        };
         readonly primary_power: {
             readonly type: "single_link";
             readonly target: "institution";
@@ -1545,6 +1574,10 @@ declare const FIELD_SCHEMA: {
             readonly type: "single_link";
             readonly target: "title";
         };
+        readonly secondary_powers: {
+            readonly type: "multi_link";
+            readonly target: "institution";
+        };
         readonly zone: {
             readonly type: "single_link";
             readonly target: "zone";
@@ -1557,13 +1590,8 @@ declare const FIELD_SCHEMA: {
             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 customs: {
+            readonly type: "text";
         };
         readonly founders: {
             readonly type: "multi_link";
@@ -1593,6 +1621,9 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "construct";
         };
+        readonly infrastructure: {
+            readonly type: "text";
+        };
         readonly extraction_markets: {
             readonly type: "multi_link";
             readonly target: "location";
@@ -1605,6 +1636,9 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "construct";
         };
+        readonly architecture: {
+            readonly type: "text";
+        };
         readonly buildings: {
             readonly type: "multi_link";
             readonly target: "object";
@@ -1613,6 +1647,12 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "construct";
         };
+        readonly defensibility: {
+            readonly type: "text";
+        };
+        readonly elevation: {
+            readonly type: "number";
+        };
         readonly fighters: {
             readonly type: "multi_link";
             readonly target: "construct";
@@ -1627,16 +1667,16 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly hierarchy: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly width: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly height: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly depth: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly parent_map: {
             readonly type: "single_link";
@@ -1648,6 +1688,14 @@ declare const FIELD_SCHEMA: {
         };
     };
     readonly marker: {
+        readonly map: {
+            readonly type: "single_link";
+            readonly target: "map";
+        };
+        readonly zone: {
+            readonly type: "single_link";
+            readonly target: "zone";
+        };
         readonly x: {
             readonly type: "integer";
         };
@@ -1657,14 +1705,6 @@ declare const FIELD_SCHEMA: {
         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: {
@@ -1674,13 +1714,13 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly start_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly end_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly order: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly parent_narrative: {
             readonly type: "single_link";
@@ -1780,29 +1820,15 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly weight: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly amount: {
-            readonly type: "text";
-        };
-        readonly utility: {
-            readonly type: "text";
-        };
-        readonly origins: {
-            readonly type: "text";
+            readonly type: "number";
         };
         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";
@@ -1811,6 +1837,9 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "construct";
         };
+        readonly utility: {
+            readonly type: "text";
+        };
         readonly effects: {
             readonly type: "multi_link";
             readonly target: "phenomenon";
@@ -1823,6 +1852,17 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "construct";
         };
+        readonly origins: {
+            readonly type: "text";
+        };
+        readonly location: {
+            readonly type: "single_link";
+            readonly target: "location";
+        };
+        readonly language: {
+            readonly type: "single_link";
+            readonly target: "language";
+        };
         readonly affinities: {
             readonly type: "multi_link";
             readonly target: "trait";
@@ -1836,14 +1876,7 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly duration: {
-            readonly type: "text";
-        };
-        readonly mythology: {
-            readonly type: "text";
-        };
-        readonly system: {
-            readonly type: "single_link";
-            readonly target: "phenomenon";
+            readonly type: "number";
         };
         readonly catalysts: {
             readonly type: "multi_link";
@@ -1853,6 +1886,13 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "ability";
         };
+        readonly mythology: {
+            readonly type: "text";
+        };
+        readonly system: {
+            readonly type: "single_link";
+            readonly target: "phenomenon";
+        };
         readonly triggers: {
             readonly type: "multi_link";
             readonly target: "construct";
@@ -1867,9 +1907,17 @@ declare const FIELD_SCHEMA: {
         };
     };
     readonly pin: {
+        readonly map: {
+            readonly type: "single_link";
+            readonly target: "map";
+        };
         readonly element_type: {
             readonly type: "text";
         };
+        readonly element_id: {
+            readonly type: "single_link";
+            readonly target: "any";
+        };
         readonly x: {
             readonly type: "integer";
         };
@@ -1879,32 +1927,28 @@ declare const FIELD_SCHEMA: {
         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 type: "number";
         };
         readonly end_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly intensity: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly actor: {
             readonly type: "single_link";
             readonly target: "character";
         };
+        readonly events: {
+            readonly type: "multi_link";
+            readonly target: "event";
+        };
         readonly characters: {
             readonly type: "multi_link";
             readonly target: "character";
@@ -1957,6 +2001,10 @@ declare const FIELD_SCHEMA: {
             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";
@@ -1965,10 +2013,6 @@ declare const FIELD_SCHEMA: {
             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";
@@ -1979,10 +2023,22 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly life_span: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly weight: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        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 instincts: {
             readonly type: "text";
@@ -1997,7 +2053,11 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly aggression: {
-            readonly type: "text";
+            readonly type: "number";
+        };
+        readonly traits: {
+            readonly type: "multi_link";
+            readonly target: "trait";
         };
         readonly role: {
             readonly type: "text";
@@ -2006,22 +2066,6 @@ declare const FIELD_SCHEMA: {
             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";
@@ -2043,16 +2087,10 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly grant_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly revoke_date: {
-            readonly type: "text";
-        };
-        readonly status: {
-            readonly type: "text";
-        };
-        readonly history: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly issuer: {
             readonly type: "single_link";
@@ -2074,6 +2112,12 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "object";
         };
+        readonly status: {
+            readonly type: "text";
+        };
+        readonly history: {
+            readonly type: "text";
+        };
         readonly characters: {
             readonly type: "multi_link";
             readonly target: "character";
@@ -2144,22 +2188,22 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly charisma: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly coercion: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly competence: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly compassion: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly creativity: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly courage: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly significance: {
             readonly type: "text";
@@ -2178,13 +2222,10 @@ declare const FIELD_SCHEMA: {
             readonly type: "text";
         };
         readonly start_date: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly end_date: {
-            readonly type: "text";
-        };
-        readonly context: {
-            readonly type: "text";
+            readonly type: "number";
         };
         readonly phenomena: {
             readonly type: "multi_link";
@@ -2194,6 +2235,9 @@ declare const FIELD_SCHEMA: {
             readonly type: "multi_link";
             readonly target: "zone";
         };
+        readonly context: {
+            readonly type: "text";
+        };
         readonly populations: {
             readonly type: "multi_link";
             readonly target: "collective";
@@ -2208,20 +2252,6 @@ declare const FIELD_SCHEMA: {
         };
     };
 };
-/**
- * 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
@@ -2320,4 +2350,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, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_MATERIAL_ICONS, ELEMENT_UNICODE_ICONS, 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, ONLYWORLDS_VERSION, 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, getElementIcon, getElementLabel, getElementMaterialIcon, getElementUnicodeIcon };
+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_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_UNICODE_ICONS, type ElementId, type ElementIds, ElementType, type Event, type EventInput, FIELD_SCHEMA, type Family, type FamilyInput, type FieldInfo, 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, ONLYWORLDS_VERSION, type Object$1 as Object, type ObjectInput, OnlyWorldsClient, type OnlyWorldsConfig, type Phenomenon, type PhenomenonInput, type Pin, type PinInput, type Relation, type RelationInput, type SectionInfo, type Species, type SpeciesInput, type Title, type TitleInput, type Trait, type TraitInput, type World, type WorldInput, type Zone, type ZoneInput, createAnyElementId, createElementId, createElementIds, getElementIcon, getElementLabel, getElementSections, getElementUnicodeIcon };