docs: globalize examples, front-load high-demand keywords, sync domains to 12+

Lead-with-global: the Western examples (natal chart, daily horoscope, synastry,
human design, forecast) use global cities while the Vedic section keeps Indian
coordinates. The README opening now front-loads the high-demand surface (natal
charts, daily horoscopes, synastry, Vedic kundli, tarot spreads, numerology,
human design bodygraphs, transit forecasts). Domain count reads 12+ and the
breadth lists include human design and forecast.

Author: ph33nx

AGENTS.md

@@ -1,6 +1,6 @@
 # RoxyApi .NET SDK - Agent Guide
 
-.NET SDK for RoxyAPI. Twelve domains (Western astrology, Vedic astrology, numerology, tarot, human design, forecast, biorhythm, I Ching, crystals, dreams, angel numbers, location) plus usage and languages. One API key, fully typed, generated from the OpenAPI spec.
+.NET SDK for RoxyAPI. 12+ domains (Western astrology, Vedic astrology, numerology, tarot, human design, forecast, biorhythm, I Ching, crystals, dreams, angel numbers, location) plus utility namespaces (usage, languages). One API key, fully typed, generated from the OpenAPI spec.
 
 > Before writing code with this SDK, read `docs/llms-full.txt` in this package for the complete method reference with one example per endpoint.
 
@@ -153,7 +153,7 @@ Responses are fully typed objects, not dictionaries. Discover fields with Intell
 - **Natal chart**: `Planets`, `Houses`, `Aspects`, `Ascendant`, `Midheaven`, `Summary`. Each planet has `Name`, `Sign`, `Degree`, `House`, `IsRetrograde`. The `Planets` list has more than ten entries (classical bodies plus nodes and key points).
 
 ```csharp
-var chart = await roxy.Astrology.NatalChart.PostAsync(new() { Date = new Date(1990, 1, 15), Time = "14:30:00", Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } });
+var chart = await roxy.Astrology.NatalChart.PostAsync(new() { Date = new Date(1990, 1, 15), Time = "14:30:00", Latitude = 40.7128, Longitude = -74.006, Timezone = new() { Double = -5 } });
 foreach (var p in chart!.Planets!)
     Console.WriteLine($"{p.Name}: {p.Sign} (house {p.House})");
 ```
@@ -204,7 +204,7 @@ Copy the format column exactly.
 | `Date` (and `BirthDate`, `StartDate`, ...) | The `Date` struct from `Microsoft.Kiota.Abstractions` | `new Date(1990, 1, 15)` | `"1990-01-15"`, `DateTime.Now`, `new DateTime(...)` |
 | `Time` | 24-hour string | `"14:30:00"`, `"09:00:00"` | `"2:30 PM"`, `"14:30"` (no seconds) |
 | `Timezone` | Union wrapper: decimal OR IANA | `new() { Double = 5.5 }`, `new() { Double = -5 }` OR `new() { String = "America/New_York" }` | `5.5`, `"5.5"`, `"+0530"` assigned directly |
-| `Latitude` / `Longitude` | `double` | `28.6139`, `-74.006` | `"28.6139"`, DMS strings |
+| `Latitude` / `Longitude` | `double` | `40.7128`, `-74.006` | `"40.7128"`, DMS strings |
 | `sign` (horoscope indexer) | Lowercase zodiac name | `["aries"]`, `["scorpio"]` | `["Aries"]`, `["1"]` |
 | `chakra` (crystals indexer) | Title-case name | `["Root"]`, `["Heart"]`, `["Third Eye"]` | `["heart"]`, `["third-eye"]` |
 | `FullName` (numerology) | Birth-certificate name | `"John William Smith"` | Nickname, partial name |

README.md

@@ -11,7 +11,7 @@ The .NET SDK for astrology, Vedic astrology, numerology, tarot, and more.
 
 One API key. Fully typed. Verified against NASA JPL Horizons.
 
-The fastest way to add natal charts, kundli matching, daily horoscopes, tarot readings, and spiritual insights to ASP.NET Core, Blazor, MAUI, Unity, and AI agents. Twelve domains behind a single [Roxy](https://roxyapi.com) subscription, interpretations in eight languages, generated from the OpenAPI spec so new endpoints appear the day they ship.
+The fastest way to add natal charts, daily horoscopes, synastry, Vedic kundli, tarot spreads, numerology, human design bodygraphs, and transit forecasts to ASP.NET Core, Blazor, MAUI, Unity, and AI agents. 12+ domains behind a single [Roxy](https://roxyapi.com) subscription, interpretations in eight languages, generated from the OpenAPI spec so new endpoints appear the day they ship.
 
 ## Install
 
@@ -147,7 +147,7 @@ var horoscope = await roxy.Astrology.Horoscope["aries"].Daily.GetAsync();
 var synastry = await roxy.Astrology.Synastry.PostAsync(new()
 {
     Person1 = new() { Date = new Date(1990, 1, 15), Time = "14:30:00", Latitude = 40.7128, Longitude = -74.006, Timezone = new() { Double = -5 } },
-    Person2 = new() { Date = new Date(1992, 7, 22), Time = "09:00:00", Latitude = 51.5074, Longitude = -0.1278, Timezone = new() { Double = 0 } },
+    Person2 = new() { Date = new Date(1992, 7, 22), Time = "09:00:00", Latitude = 51.5074, Longitude = -0.1278, Timezone = new() { Double = 1 } },
 });
 
 // Moon phase. Viral for wellness, cycle-tracking, and meditation apps.
@@ -248,7 +248,7 @@ The breakout 2026 self-discovery category. One call returns the full bodygraph f
 var bodygraph = await roxy.HumanDesign.Bodygraph.PostAsync(new()
 {
     Date = new Date(1990, 7, 4), Time = "10:12:00",
-    Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 },
+    Latitude = 40.7128, Longitude = -74.006, Timezone = new() { Double = -4 },
 });
 // bodygraph.Type, bodygraph.Strategy, bodygraph.Profile, bodygraph.Definition
 // bodygraph.Centers, bodygraph.Channels, bodygraph.Gates, bodygraph.IncarnationCross
@@ -261,7 +261,7 @@ The first cross-domain, stateless forecast in the catalog. One call merges Weste
 ```csharp
 var timeline = await roxy.Forecast.Timeline.PostAsync(new()
 {
-    BirthData = new() { Date = new Date(1990, 7, 4), Time = "10:12:00", Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } },
+    BirthData = new() { Date = new Date(1990, 7, 4), Time = "10:12:00", Latitude = 40.7128, Longitude = -74.006, Timezone = new() { Double = -4 } },
     StartDate = new Date(2026, 6, 1),
     EndDate = new Date(2026, 6, 30),
 });
@@ -441,7 +441,7 @@ Console.WriteLine($"{city.City}, {city.Country} at {city.Latitude}, {city.Longit
 var chart = await roxy.Astrology.NatalChart.PostAsync(new()
 {
     Date = new Date(1990, 1, 15), Time = "14:30:00",
-    Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 },
+    Latitude = 40.7128, Longitude = -74.006, Timezone = new() { Double = -5 },
 });
 
 foreach (var planet in chart!.Planets!)

docs/llms-full.txt

@@ -16,7 +16,7 @@ How the calls below map to the API:
 - **Request bodies use a target-typed `new()`.** The body type is inferred from the method, so you never name it. Property names are the PascalCase of the JSON fields (`birth_date` becomes `BirthDate`).
 - **Query parameters use a configuration lambda.** `await roxy.Crystals.Search.GetAsync(c => c.QueryParameters.Q = "amethyst");`
 - **Dates use `new Date(year, month, day)`; times are 24-hour strings (`"14:30:00"`).**
-- **`Timezone` is a union:** `new() { Double = 5.5 }` (decimal offset) or `new() { String = "Asia/Kolkata" }` (IANA name, resolved to the DST-correct offset).
+- **`Timezone` is a union:** `new() { Double = -5 }` (decimal offset) or `new() { String = "America/New_York" }` (IANA name, resolved to the DST-correct offset).
 - **Every call is async and throws `RoxyError` on a 4xx or 5xx.** Capture the result directly: `var chart = await roxy.Astrology.NatalChart.PostAsync(new() { ... });`
 
 **Multi-language responses.** Interpretations are available in eight languages: en, tr, de, es, fr, hi, pt, ru. Add `c => c.QueryParameters.Lang = "es"` to any supported endpoint. Supported: astrology, vedicAstrology, numerology, tarot, biorhythm, iching, crystals, angelNumbers. English-only: dreams, location, usage, languages. Untranslated fields fall back to English.