@@ -112,12 +112,12 @@ public function calculateCompatibility(
112112 * Birth date in YYYY-MM-DD format. Date is critical for house cusp calculations as it
113113 * determines planetary positions used in some house systems.
114114 * @param float $latitude
115- * Birth location latitude in decimal degrees. Location determines the local horizon and
116- * meridian, which are fundamental to house division. Higher latitudes cause more distortion in
117- * time-based systems like Placidus.
115+ * Birth location latitude in decimal degrees (-90 to 90) . Location determines the local
116+ * horizon and meridian, which are fundamental to house division. Higher latitudes cause more
117+ * distortion in time-based systems like Placidus.
118118 * @param float $longitude
119- * Birth location longitude in decimal degrees. Affects local time and horizon calculations for
120- * house cusps.
119+ * Birth location longitude in decimal degrees (-180 to 180) . Affects local time and horizon
120+ * calculations for house cusps.
121121 * @param string $time
122122 * Birth time in 24-hour HH:MM:SS format. Time is ESSENTIAL for accurate house cusps - even
123123 * minutes matter. The Ascendant (1st house cusp) changes roughly every 4 minutes. Without
@@ -373,7 +373,7 @@ public function generateCompositeChart(
373373 /**
374374 * Lunar Return Chart - Monthly emotional forecast with Moon cycle chart
375375 *
376- * Generate a lunar return chart for any month — cast for the exact moment the transiting Moon
376+ * Generate a lunar return chart for any month, cast for the exact moment the transiting Moon
377377 * returns to its natal ecliptic longitude. The Moon completes one sidereal orbit every ~27.3
378378 * days, making this the primary technique for monthly astrological forecasting. Returns full
379379 * tropical zodiac chart with planetary positions, house cusps, aspects, Ascendant, and
@@ -390,11 +390,11 @@ public function generateCompositeChart(
390390 * Original birth time in 24-hour HH:MM:SS format. Determines exact natal Moon position for
391391 * monthly return timing.
392392 * @param float $latitude
393- * Latitude of the lunar return location in decimal degrees. Affects the Ascendant and house
394- * cusps of the return chart.
393+ * Latitude of the lunar return location in decimal degrees (-90 to 90) . Affects the Ascendant
394+ * and house cusps of the return chart.
395395 * @param float $longitude
396- * Longitude of the lunar return location in decimal degrees. Determines local sidereal time
397- * for house calculations.
396+ * Longitude of the lunar return location in decimal degrees (-180 to 180) . Determines local
397+ * sidereal time for house calculations.
398398 * @param string $returnDate
399399 * Approximate date near the desired lunar return (YYYY-MM-DD). The Moon returns to its natal
400400 * position every ~27.3 days, so provide a date within a few days of the expected return.
@@ -492,18 +492,18 @@ public function generateNatalChart(
492492 *
493493 * @param string $approximateDate
494494 * Approximate date near the expected planetary return (YYYY-MM-DD). Provide a date within the
495- * expected return window — the algorithm searches from this starting point.
495+ * expected return window. The algorithm searches from this starting point.
496496 * @param string $birthDate
497497 * Original birth date in YYYY-MM-DD format. Used to determine the natal longitude of the
498498 * selected planet.
499499 * @param string $birthTime
500500 * Original birth time in 24-hour HH:MM:SS format. Determines exact natal planet position for
501501 * return timing.
502502 * @param float $latitude
503- * Latitude of the return location in decimal degrees. Affects house cusps and Ascendant of the
504- * return chart.
503+ * Latitude of the return location in decimal degrees (-90 to 90) . Affects house cusps and
504+ * Ascendant of the return chart.
505505 * @param float $longitude
506- * Longitude of the return location in decimal degrees.
506+ * Longitude of the return location in decimal degrees (-180 to 180) .
507507 * @param string $planet
508508 * Planet for the return calculation. Supports Mercury (~88 days), Venus (~225 days), Mars
509509 * (~687 days), Jupiter (~12 years), and Saturn (~29 years). Saturn return is a major life
@@ -539,7 +539,7 @@ public function generatePlanetaryReturn(
539539 /**
540540 * Solar Return Chart - Annual birthday forecast with relocated chart
541541 *
542- * Generate a solar return chart for any year — the foundational technique for annual
542+ * Generate a solar return chart for any year, the foundational technique for annual
543543 * astrological forecasting. The chart is cast for the exact moment the transiting Sun returns
544544 * to its natal ecliptic longitude (your astrological birthday). Returns full tropical zodiac
545545 * chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven.
@@ -556,11 +556,11 @@ public function generatePlanetaryReturn(
556556 * Original birth time in 24-hour HH:MM:SS format. Determines exact natal Sun position for
557557 * annual return timing.
558558 * @param float $latitude
559- * Latitude of the solar return location in decimal degrees. Use current residence or travel
560- * location at time of birthday — solar return charts are location-sensitive.
559+ * Latitude of the solar return location in decimal degrees (-90 to 90) . Use current residence
560+ * or travel location at time of birthday. Solar return charts are location-sensitive.
561561 * @param float $longitude
562- * Longitude of the solar return location in decimal degrees. Affects house cusps and Ascendant
563- * of the return chart.
562+ * Longitude of the solar return location in decimal degrees (-180 to 180) . Affects house cusps
563+ * and Ascendant of the return chart.
564564 * @param int $returnYear
565565 * Year for which to cast the solar return chart. The chart is erected for the exact moment the
566566 * transiting Sun conjuncts the natal Sun longitude in this year.
@@ -778,7 +778,7 @@ public function getPlanetaryPositions(
778778 * (e.g., "sun", "moon") or case-insensitive name (e.g., "Sun", "MOON"). Returns complete
779779 * astrology meaning including: symbol, tagline, category (personal/social/generational),
780780 * temperature, orbital period, retrograde status, dignities
781- * (rulership/detriment/exultation /fall), positive and negative keywords, and short/long
781+ * (rulership/detriment/exaltation /fall), positive and negative keywords, and short/long
782782 * descriptions. Perfect for birth chart readings, planet meaning lookups, astrology education,
783783 * natal chart interpretation, transit meanings, planetary symbolism reference, and
784784 * keyword-based interpretations.
@@ -904,7 +904,7 @@ public function getZodiacSign(
904904 * astrology reference apps, planet meaning widgets, birth chart interpretation tools,
905905 * astrology learning platforms, planetary keywords reference, and zodiac planet guides. Use
906906 * GET /planet-meanings/{id} for complete profiles with detailed interpretations, keywords,
907- * temperature, and dignities (rulership/detriment/exultation /fall).
907+ * temperature, and dignities (rulership/detriment/exaltation /fall).
908908 *
909909 * GET /astrology/planet-meanings
910910 *
0 commit comments