kerykeion 5.1.9__py3-none-any.whl → 5.1.12__py3-none-any.whl

kerykeion/charts/chart_drawer.py

@@ -211,6 +211,7 @@ class ChartDrawer:
     active_aspects: List[ActiveAspect]
     transparent_background: bool
     external_view: bool
+    show_house_position_comparison: bool
     custom_title: Union[str, None]
     _language_model: KerykeionLanguageModel
     _fallback_language_model: KerykeionLanguageModel
@@ -249,6 +250,7 @@ class ChartDrawer:
         celestial_points_settings: list[dict] = DEFAULT_CELESTIAL_POINTS_SETTINGS,
         aspects_settings: list[dict] = DEFAULT_CHART_ASPECTS_SETTINGS,
         custom_title: Union[str, None] = None,
+        show_house_position_comparison: bool = True,
         auto_size: bool = True,
         padding: int = 20,
     ):
@@ -275,6 +277,9 @@ class ChartDrawer:
                 Whether to use a transparent background instead of the theme color. Defaults to False.
             custom_title (str or None, optional):
                 Custom title for the chart. If None, the default title will be used based on chart type. Defaults to None.
+            show_house_position_comparison (bool, optional):
+                Whether to render the house position comparison grid (when supported by the chart type).
+                Defaults to True. Set to False to hide the table and reclaim horizontal space.
         """
         # --------------------
         # COMMON INITIALIZATION
@@ -287,6 +292,7 @@ class ChartDrawer:
         self.planets_settings = [dict(body) for body in celestial_points_settings]
         self.aspects_settings = [dict(aspect) for aspect in aspects_settings]
         self.custom_title = custom_title
+        self.show_house_position_comparison = show_house_position_comparison
         self.auto_size = auto_size
         self._padding = padding
         self._vertical_offsets: dict[str, int] = self._BASE_VERTICAL_OFFSETS.copy()
@@ -462,6 +468,8 @@ class ChartDrawer:
             self.second_circle_radius = 36
             self.third_circle_radius = 120
 
+        self._apply_house_comparison_width_override()
+
         # --------------------
         # FINAL COMMON SETUP FROM CHART DATA
         # --------------------
@@ -612,6 +620,9 @@ class ChartDrawer:
 
         delta_height = max(self.height - minimum_height, 0)
 
+        # Move title up for synastry charts
+        offsets["title"] = -10
+
         offsets["wheel"] += delta_height
         offsets["aspect_grid"] += delta_height
         offsets["aspect_list"] += delta_height
@@ -667,6 +678,19 @@ class ChartDrawer:
 
         return collected
 
+    def _apply_house_comparison_width_override(self) -> None:
+        """Shrink chart width when the optional house comparison grid is hidden."""
+        if self.show_house_position_comparison:
+            return
+
+        if self.chart_type == "Synastry":
+            self.width = self._DEFAULT_FULL_WIDTH
+        elif self.chart_type == "DualReturnChart":
+            self.width = self._DEFAULT_FULL_WIDTH_WITH_TABLE if self.double_chart_aspect_grid_type == "table" else self._DEFAULT_FULL_WIDTH
+        elif self.chart_type == "Transit":
+            # Transit charts already use the compact width unless the aspect grid table is requested.
+            self.width = self._DEFAULT_FULL_WIDTH_WITH_TABLE if self.double_chart_aspect_grid_type == "table" else self._DEFAULT_FULL_WIDTH
+
     def _dynamic_viewbox(self) -> str:
         """Return the viewBox string based on current width/height with vertical padding."""
         min_y = -self._VERTICAL_PADDING_TOP
@@ -776,7 +800,7 @@ class ChartDrawer:
                 # Secondary houses grid default x ~ 1015
                 secondary_houses_grid_right = 1015 + 120
                 extents.append(secondary_houses_grid_right)
-                if self.second_obj is not None:
+                if self.show_house_position_comparison and self.second_obj is not None:
                     point_column_label = self._translate("point", "Point")
                     first_subject_label = self._truncate_name(self.first_obj.name, 8, "…", True)  # type: ignore[union-attr]
                     second_subject_label = self._truncate_name(self.second_obj.name, 8, "…", True)  # type: ignore[union-attr]
@@ -809,33 +833,35 @@ class ChartDrawer:
 
             if self.chart_type == "Transit":
                 # House comparison grid at x ~ 1030
-                transit_columns = [
-                    self._translate("transit_point", "Transit Point"),
-                    self._translate("house_position", "Natal House"),
-                ]
-                transit_grid_width = self._estimate_house_comparison_grid_width(
-                    column_labels=transit_columns,
-                    include_radix_column=False,
-                    include_title=True,
-                    minimum_width=170.0,
-                )
-                house_comparison_grid_right = 980 + transit_grid_width
-                extents.append(house_comparison_grid_right)
+                if self.show_house_position_comparison:
+                    transit_columns = [
+                        self._translate("transit_point", "Transit Point"),
+                        self._translate("house_position", "Natal House"),
+                    ]
+                    transit_grid_width = self._estimate_house_comparison_grid_width(
+                        column_labels=transit_columns,
+                        include_radix_column=False,
+                        include_title=True,
+                        minimum_width=170.0,
+                    )
+                    house_comparison_grid_right = 980 + transit_grid_width
+                    extents.append(house_comparison_grid_right)
 
             if self.chart_type == "DualReturnChart":
                 # House comparison grid translated to x ~ 1100
-                dual_return_columns = [
-                    self._translate("return_point", "Return Point"),
-                    self._translate("Return", "DualReturnChart"),
-                    self._translate("Natal", "Natal"),
-                ]
-                dual_return_grid_width = self._estimate_house_comparison_grid_width(
-                    column_labels=dual_return_columns,
-                    include_radix_column=True,
-                    include_title=True,
-                )
-                house_comparison_grid_right = 1100 + dual_return_grid_width
-                extents.append(house_comparison_grid_right)
+                if self.show_house_position_comparison:
+                    dual_return_columns = [
+                        self._translate("return_point", "Return Point"),
+                        self._translate("Return", "DualReturnChart"),
+                        self._translate("Natal", "Natal"),
+                    ]
+                    dual_return_grid_width = self._estimate_house_comparison_grid_width(
+                        column_labels=dual_return_columns,
+                        include_radix_column=True,
+                        include_title=True,
+                    )
+                    house_comparison_grid_right = 1100 + dual_return_grid_width
+                    extents.append(house_comparison_grid_right)
 
         # Conservative safety padding
         return int(max(extents) + self._padding)
@@ -1165,17 +1191,24 @@ class ChartDrawer:
 
         return name[:max_length-1] + ellipsis_symbol
 
-    def _get_chart_title(self) -> str:
+    def _get_chart_title(self, custom_title_override: Union[str, None] = None) -> str:
         """
         Generate the chart title based on chart type and custom title settings.
 
         If a custom title is provided, it will be used. Otherwise, generates the
         appropriate default title based on the chart type and subjects.
 
+        Args:
+            custom_title_override (str | None): Explicit override supplied at render time.
+
         Returns:
             str: The chart title to display (max ~40 characters).
         """
-        # If custom title is provided, use it
+        # If a kwarg override is provided, use it
+        if custom_title_override is not None:
+            return custom_title_override
+
+        # If custom title is provided at initialization, use it
         if self.custom_title is not None:
             return self.custom_title
 
@@ -1233,13 +1266,16 @@ class ChartDrawer:
         # Fallback for unknown chart types
         return self._truncate_name(self.first_obj.name)
 
-    def _create_template_dictionary(self) -> ChartTemplateModel:
+    def _create_template_dictionary(self, *, custom_title: Union[str, None] = None) -> ChartTemplateModel:
         """
         Assemble chart data and rendering instructions into a template dictionary.
 
         Gathers styling, dimensions, and SVG fragments for chart components based on
         chart type and subjects.
 
+        Args:
+            custom_title (str | None): Optional runtime override for the chart title.
+
         Returns:
             ChartTemplateModel: Populated structure of template variables.
         """
@@ -1330,7 +1366,7 @@ class ChartDrawer:
         first_subject_houses_list = get_houses_list(self.first_obj)
 
         # Chart title
-        template_dict["stringTitle"] = self._get_chart_title()
+        template_dict["stringTitle"] = self._get_chart_title(custom_title_override=custom_title)
 
         # ------------------------------- #
         #  CHART TYPE SPECIFIC SETTINGS   #
@@ -1869,23 +1905,26 @@ class ChartDrawer:
             )
 
             # House comparison grid
-            house_comparison_factory = HouseComparisonFactory(
-                first_subject=self.first_obj,  # type: ignore[arg-type]
-                second_subject=self.second_obj,  # type: ignore[arg-type]
-                active_points=self.active_points,
-            )
-            house_comparison = house_comparison_factory.get_house_comparison()
-
-            template_dict["makeHouseComparisonGrid"] = draw_single_house_comparison_grid(
-                house_comparison,
-                celestial_point_language=self._language_model.celestial_points,
-                active_points=self.active_points,
-                points_owner_subject_number=2, # The second subject is the Transit
-                house_position_comparison_label=self._translate("house_position_comparison", "House Position Comparison"),
-                return_point_label=self._translate("transit_point", "Transit Point"),
-                natal_house_label=self._translate("house_position", "Natal House"),
-                x_position=980,
-            )
+            if self.show_house_position_comparison:
+                house_comparison_factory = HouseComparisonFactory(
+                    first_subject=self.first_obj,  # type: ignore[arg-type]
+                    second_subject=self.second_obj,  # type: ignore[arg-type]
+                    active_points=self.active_points,
+                )
+                house_comparison = house_comparison_factory.get_house_comparison()
+
+                template_dict["makeHouseComparisonGrid"] = draw_single_house_comparison_grid(
+                    house_comparison,
+                    celestial_point_language=self._language_model.celestial_points,
+                    active_points=self.active_points,
+                    points_owner_subject_number=2, # The second subject is the Transit
+                    house_position_comparison_label=self._translate("house_position_comparison", "House Position Comparison"),
+                    return_point_label=self._translate("transit_point", "Transit Point"),
+                    natal_house_label=self._translate("house_position", "Natal House"),
+                    x_position=980,
+                )
+            else:
+                template_dict["makeHouseComparisonGrid"] = ""
 
         elif self.chart_type == "Synastry":
             # Set viewbox dynamically
@@ -2033,45 +2072,48 @@ class ChartDrawer:
                 text_color=self.chart_colors_settings["paper_0"],
                 celestial_point_language=self._language_model.celestial_points,
             )
-            house_comparison_factory = HouseComparisonFactory(
-                first_subject=self.first_obj,  # type: ignore[arg-type]
-                second_subject=self.second_obj,  # type: ignore[arg-type]
-                active_points=self.active_points,
-            )
-            house_comparison = house_comparison_factory.get_house_comparison()
-
-            first_subject_label = self._truncate_name(self.first_obj.name, 8, "…", True)  # type: ignore[union-attr]
-            second_subject_label = self._truncate_name(self.second_obj.name, 8, "…", True)  # type: ignore[union-attr]
-            point_column_label = self._translate("point", "Point")
-            comparison_label = self._translate("house_position_comparison", "House Position Comparison")
+            if self.show_house_position_comparison:
+                house_comparison_factory = HouseComparisonFactory(
+                    first_subject=self.first_obj,  # type: ignore[arg-type]
+                    second_subject=self.second_obj,  # type: ignore[arg-type]
+                    active_points=self.active_points,
+                )
+                house_comparison = house_comparison_factory.get_house_comparison()
+
+                first_subject_label = self._truncate_name(self.first_obj.name, 8, "…", True)  # type: ignore[union-attr]
+                second_subject_label = self._truncate_name(self.second_obj.name, 8, "…", True)  # type: ignore[union-attr]
+                point_column_label = self._translate("point", "Point")
+                comparison_label = self._translate("house_position_comparison", "House Position Comparison")
+
+                first_subject_grid = draw_house_comparison_grid(
+                    house_comparison,
+                    celestial_point_language=self._language_model.celestial_points,
+                    active_points=self.active_points,
+                    points_owner_subject_number=1,
+                    house_position_comparison_label=comparison_label,
+                    return_point_label=first_subject_label + " " + point_column_label,
+                    return_label=first_subject_label,
+                    radix_label=second_subject_label,
+                    x_position=1090,
+                    y_position=0,
+                )
 
-            first_subject_grid = draw_house_comparison_grid(
-                house_comparison,
-                celestial_point_language=self._language_model.celestial_points,
-                active_points=self.active_points,
-                points_owner_subject_number=1,
-                house_position_comparison_label=comparison_label,
-                return_point_label=first_subject_label + " " + point_column_label,
-                return_label=first_subject_label,
-                radix_label=second_subject_label,
-                x_position=1090,
-                y_position=0,
-            )
-
-            second_subject_grid = draw_house_comparison_grid(
-                house_comparison,
-                celestial_point_language=self._language_model.celestial_points,
-                active_points=self.active_points,
-                points_owner_subject_number=2,
-                house_position_comparison_label="",
-                return_point_label=second_subject_label + " " + point_column_label,
-                return_label=second_subject_label,
-                radix_label=first_subject_label,
-                x_position=1290,
-                y_position=0,
-            )
+                second_subject_grid = draw_house_comparison_grid(
+                    house_comparison,
+                    celestial_point_language=self._language_model.celestial_points,
+                    active_points=self.active_points,
+                    points_owner_subject_number=2,
+                    house_position_comparison_label="",
+                    return_point_label=second_subject_label + " " + point_column_label,
+                    return_label=second_subject_label,
+                    radix_label=first_subject_label,
+                    x_position=1290,
+                    y_position=0,
+                )
 
-            template_dict["makeHouseComparisonGrid"] = first_subject_grid + second_subject_grid
+                template_dict["makeHouseComparisonGrid"] = first_subject_grid + second_subject_grid
+            else:
+                template_dict["makeHouseComparisonGrid"] = ""
 
         elif self.chart_type == "DualReturnChart":
             # Set viewbox dynamically
@@ -2248,23 +2290,26 @@ class ChartDrawer:
                 celestial_point_language=self._language_model.celestial_points,
             )
 
-            house_comparison_factory = HouseComparisonFactory(
-                first_subject=self.first_obj,  # type: ignore[arg-type]
-                second_subject=self.second_obj,  # type: ignore[arg-type]
-                active_points=self.active_points,
-            )
-            house_comparison = house_comparison_factory.get_house_comparison()
-
-            template_dict["makeHouseComparisonGrid"] = draw_house_comparison_grid(
-                house_comparison,
-                celestial_point_language=self._language_model.celestial_points,
-                active_points=self.active_points,
-                points_owner_subject_number=2, # The second subject is the Solar Return
-                house_position_comparison_label=self._translate("house_position_comparison", "House Position Comparison"),
-                return_point_label=self._translate("return_point", "Return Point"),
-                return_label=self._translate("Return", "DualReturnChart"),
-                radix_label=self._translate("Natal", "Natal"),
-            )
+            if self.show_house_position_comparison:
+                house_comparison_factory = HouseComparisonFactory(
+                    first_subject=self.first_obj,  # type: ignore[arg-type]
+                    second_subject=self.second_obj,  # type: ignore[arg-type]
+                    active_points=self.active_points,
+                )
+                house_comparison = house_comparison_factory.get_house_comparison()
+
+                template_dict["makeHouseComparisonGrid"] = draw_house_comparison_grid(
+                    house_comparison,
+                    celestial_point_language=self._language_model.celestial_points,
+                    active_points=self.active_points,
+                    points_owner_subject_number=2, # The second subject is the Solar Return
+                    house_position_comparison_label=self._translate("house_position_comparison", "House Position Comparison"),
+                    return_point_label=self._translate("return_point", "Return Point"),
+                    return_label=self._translate("Return", "DualReturnChart"),
+                    radix_label=self._translate("Natal", "Natal"),
+                )
+            else:
+                template_dict["makeHouseComparisonGrid"] = ""
 
         elif self.chart_type == "SingleReturnChart":
             # Set viewbox dynamically
@@ -2401,7 +2446,7 @@ class ChartDrawer:
 
         return ChartTemplateModel(**template_dict)
 
-    def generate_svg_string(self, minify: bool = False, remove_css_variables=False) -> str:
+    def generate_svg_string(self, minify: bool = False, remove_css_variables=False, *, custom_title: Union[str, None] = None) -> str:
         """
         Render the full chart SVG as a string.
 
@@ -2411,11 +2456,12 @@ class ChartDrawer:
         Args:
             minify (bool): Remove whitespace and quotes for compactness.
             remove_css_variables (bool): Embed CSS variable definitions.
+            custom_title (str or None): Optional override for the SVG title.
 
         Returns:
             str: SVG markup as a string.
         """
-        td = self._create_template_dictionary()
+        td = self._create_template_dictionary(custom_title=custom_title)
 
         DATA_DIR = Path(__file__).parent
         xml_svg = DATA_DIR / "templates" / "chart.xml"
@@ -2428,8 +2474,6 @@ class ChartDrawer:
 
         logger.debug("Template dictionary includes %s fields", len(td.model_dump()))
 
-        self._create_template_dictionary()
-
         if remove_css_variables:
             template = inline_css_variables_in_svg(template)
 
@@ -2441,7 +2485,7 @@ class ChartDrawer:
 
         return template
 
-    def save_svg(self, output_path: Union[str, Path, None] = None, filename: Union[str, None] = None, minify: bool = False, remove_css_variables=False):
+    def save_svg(self, output_path: Union[str, Path, None] = None, filename: Union[str, None] = None, minify: bool = False, remove_css_variables=False, *, custom_title: Union[str, None] = None):
         """
         Generate and save the full chart SVG to disk.
 
@@ -2455,12 +2499,13 @@ class ChartDrawer:
                 If None, uses the default pattern: "{subject.name} - {chart_type} Chart".
             minify (bool): Pass-through to generate_svg_string for compact output.
             remove_css_variables (bool): Pass-through to generate_svg_string to embed CSS variables.
+            custom_title (str or None): Optional override for the SVG title.
 
         Returns:
             None
         """
 
-        self.template = self.generate_svg_string(minify, remove_css_variables)
+        self.template = self.generate_svg_string(minify, remove_css_variables, custom_title=custom_title)
 
         # Convert output_path to Path object, default to home directory
         output_directory = Path(output_path) if output_path is not None else Path.home()

kerykeion/charts/templates/chart.xml

@@ -20,52 +20,52 @@
     Main Chart -->
     <g kr:node="Main_Chart">
         <g kr:node="Top_Left_Text" transform="translate(0,$title_translate_y)">
-            <text x="20" y="22" style="fill: $paper_color_0; font-size: 24px">$stringTitle</text>
-            <text x="20" y="58" style="fill: $paper_color_0; font-size: 10px">$top_left_0</text>
-            <text x="20" y="70" style="fill: $paper_color_0; font-size: 10px">$top_left_1</text>
-            <text x="20" y="82" style="fill: $paper_color_0; font-size: 10px">$top_left_2</text>
-            <text x="20" y="94" style="fill: $paper_color_0; font-size: 10px">$top_left_3</text>
-            <text x="20" y="106" style="fill: $paper_color_0; font-size: 10px">$top_left_4</text>
-            <text x="20" y="118" style="fill: $paper_color_0; font-size: 10px">$top_left_5</text>
+            <text kr:node="Chart_Title" x="20" y="22" style="fill: $paper_color_0; font-size: 24px">$stringTitle</text>
+            <text kr:node="Top_Left_Text_0" x="20" y="58" style="fill: $paper_color_0; font-size: 10px">$top_left_0</text>
+            <text kr:node="Top_Left_Text_1" x="20" y="70" style="fill: $paper_color_0; font-size: 10px">$top_left_1</text>
+            <text kr:node="Top_Left_Text_2" x="20" y="82" style="fill: $paper_color_0; font-size: 10px">$top_left_2</text>
+            <text kr:node="Top_Left_Text_3" x="20" y="94" style="fill: $paper_color_0; font-size: 10px">$top_left_3</text>
+            <text kr:node="Top_Left_Text_4" x="20" y="106" style="fill: $paper_color_0; font-size: 10px">$top_left_4</text>
+            <text kr:node="Top_Left_Text_5" x="20" y="118" style="fill: $paper_color_0; font-size: 10px">$top_left_5</text>
         </g>
 
         <!-- Elements -->
         <g kr:node="Elements_Percentages" transform="translate(0,$elements_translate_y)">
-            <text x="20" y="138" style="fill: $paper_color_0; font-size: 10px;">$elements_string</text>
-            <text x="20" y="152"
+            <text kr:node="Elements_Text" x="20" y="138" style="fill: $paper_color_0; font-size: 10px;">$elements_string</text>
+            <text kr:node="Fire_Text" x="20" y="152"
                 style="fill: var(--kerykeion-chart-color-fire-percentage); font-size: 10px;">
                 $fire_string</text>
-            <text x="20" y="164"
+            <text kr:node="Earth_Text" x="20" y="164"
                 style="fill: var(--kerykeion-chart-color-earth-percentage); font-size: 10px;">
                 $earth_string</text>
-            <text x="20" y="176"
+            <text kr:node="Air_Text" x="20" y="176"
                 style="fill: var(--kerykeion-chart-color-air-percentage); font-size: 10px;">
                 $air_string</text>
-            <text x="20" y="188"
+            <text kr:node="Water_Text" x="20" y="188"
                 style="fill: var(--kerykeion-chart-color-water-percentage); font-size: 10px;">
                 $water_string</text>
         </g>
 
         <!-- Qualities -->
         <g kr:node="Qualities_Percentages" transform="translate(0,$qualities_translate_y)">
-            <text x="20" y="208" style="fill: $paper_color_0; font-size: 10px;">$qualities_string</text>
-            <text x="20" y="222"
+            <text kr:node="Qualities_Text" x="20" y="208" style="fill: $paper_color_0; font-size: 10px;">$qualities_string</text>
+            <text kr:node="Cardinal_Text" x="20" y="222"
                 style="fill: var(--kerykeion-chart-color-cardinal-percentage); font-size: 10px;">
                 $cardinal_string</text>
-            <text x="20" y="234"
+            <text kr:node="Fixed_Text" x="20" y="234"
                 style="fill: var(--kerykeion-chart-color-fixed-percentage); font-size: 10px;">
                 $fixed_string</text>
-            <text x="20" y="246"
+            <text kr:node="Mutable_Text" x="20" y="246"
                 style="fill: var(--kerykeion-chart-color-mutable-percentage); font-size: 10px;">
                 $mutable_string</text>
         </g>
 
         <g kr:node="Bottom_Left_Text" transform="translate(0,$bottom_left_translate_y)">
-            <text x="20" y="452" style="fill: $paper_color_0; font-size: 10px">$bottom_left_0</text>
-            <text x="20" y="466" style="fill: $paper_color_0; font-size: 10px">$bottom_left_1</text>
-            <text x="20" y="480" style="fill: $paper_color_0; font-size: 10px">$bottom_left_2</text>
-            <text x="20" y="494" style="fill: $paper_color_0; font-size: 10px">$bottom_left_3</text>
-            <text x="20" y="508" style="fill: $paper_color_0; font-size: 10px">$bottom_left_4</text>
+            <text kr:node="Bottom_Left_Text_0" x="20" y="452" style="fill: $paper_color_0; font-size: 10px">$bottom_left_0</text>
+            <text kr:node="Bottom_Left_Text_1" x="20" y="466" style="fill: $paper_color_0; font-size: 10px">$bottom_left_1</text>
+            <text kr:node="Bottom_Left_Text_2" x="20" y="480" style="fill: $paper_color_0; font-size: 10px">$bottom_left_2</text>
+            <text kr:node="Bottom_Left_Text_3" x="20" y="494" style="fill: $paper_color_0; font-size: 10px">$bottom_left_3</text>
+            <text kr:node="Bottom_Left_Text_4" x="20" y="508" style="fill: $paper_color_0; font-size: 10px">$bottom_left_4</text>
         </g>
 
         <!-- Lunar Phase -->
@@ -738,4 +738,4 @@
             />
         </symbol>
     </defs>
-</svg>
+</svg>

kerykeion/report.py

@@ -34,7 +34,6 @@ ASPECT_SYMBOLS = {
 MOVEMENT_SYMBOLS = {
     "Applying": "→",
     "Separating": "←",
-    "Exact": "✓",
 }
 
 

kerykeion/schemas/kr_literals.py

@@ -17,8 +17,14 @@ SignNumbers = Literal[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]
 """Literal type for Zodiac Sign Numbers, the signs are numbered in order starting from Aries (0) to Pis (11)"""
 
 
-AspectMovementType = Literal["Applying", "Separating", "Exact"]
-"""Literal type for Aspect Movement: Applying (planets moving toward exact aspect), Separating (planets moving away), or Exact (within tight orb)"""
+AspectMovementType = Literal["Applying", "Separating", "Fixed"]
+"""Literal type for Aspect Movement.
+
+Values:
+    - "Applying": planets are moving toward the exact aspect (orb decreasing).
+    - "Separating": planets are moving away from the exact aspect (orb increasing).
+    - "Fixed": both points are effectively fixed so the orb does not change over time.
+"""
 
 
 Houses = Literal["First_House", "Second_House", "Third_House", "Fourth_House", "Fifth_House", "Sixth_House", "Seventh_House", "Eighth_House", "Ninth_House", "Tenth_House", "Eleventh_House", "Twelfth_House"]

kerykeion/schemas/kr_models.py

@@ -299,8 +299,8 @@ class AspectModel(SubscriptableBaseModel):
     p1: int
     p2: int
     aspect_movement: AspectMovementType = Field(
-        description="Indicates whether the aspect is applying (planets moving toward exact aspect), "
-                    "separating (planets moving away from exact aspect), or exact (within tight orb)."
+        description="Indicates whether the aspect is applying (orb decreasing), "
+                    "separating (orb increasing), or fixed (no relative motion)."
     )