kerykeion 5.0.0b2__py3-none-any.whl → 5.0.0b5__py3-none-any.whl

kerykeion/charts/themes/black-and-white.css

@@ -0,0 +1,148 @@
+:root {
+    /* -------- */
+    /* General */
+    /* ------- */
+    --kerykeion-color-black: #000000;
+    --kerykeion-color-white: #ffffff;
+
+    --kerykeion-color-neutral-content: #111111;
+    --kerykeion-color-base-content: #111111;
+    --kerykeion-color-primary: #222222;
+    --kerykeion-color-secondary: #444444;
+    --kerykeion-color-accent: #666666;
+    --kerykeion-color-neutral: #1a1a1a;
+    --kerykeion-color-base-100: #ffffff;
+    --kerykeion-color-info: #222222;
+    --kerykeion-color-info-content: #ffffff;
+    --kerykeion-color-success: #333333;
+    --kerykeion-color-warning: #555555;
+    --kerykeion-color-error: #777777;
+
+    /* Zodiac */
+    --kerykeion-color-base-200: #f0f0f0;
+    --kerykeion-color-base-300: #d9d9d9;
+
+    /* ----------- */
+    /* Chart Color */
+    /* ----------- */
+
+    /* Main colors */
+    --kerykeion-chart-color-paper-0: var(--kerykeion-color-neutral-content);
+    --kerykeion-chart-color-paper-1: var(--kerykeion-color-base-100);
+
+    /* Zodiac Sign Sectors */
+    --kerykeion-chart-color-zodiac-bg-0: var(--kerykeion-color-base-200);
+    --kerykeion-chart-color-zodiac-bg-1: var(--kerykeion-color-base-300);
+    --kerykeion-chart-color-zodiac-bg-2: var(--kerykeion-color-base-200);
+    --kerykeion-chart-color-zodiac-bg-3: var(--kerykeion-color-base-300);
+    --kerykeion-chart-color-zodiac-bg-4: var(--kerykeion-color-base-200);
+    --kerykeion-chart-color-zodiac-bg-5: var(--kerykeion-color-base-300);
+    --kerykeion-chart-color-zodiac-bg-6: var(--kerykeion-color-base-200);
+    --kerykeion-chart-color-zodiac-bg-7: var(--kerykeion-color-base-300);
+    --kerykeion-chart-color-zodiac-bg-8: var(--kerykeion-color-base-200);
+    --kerykeion-chart-color-zodiac-bg-9: var(--kerykeion-color-base-300);
+    --kerykeion-chart-color-zodiac-bg-10: var(--kerykeion-color-base-200);
+    --kerykeion-chart-color-zodiac-bg-11: var(--kerykeion-color-base-300);
+
+    /* Zodiac Sign Rings */
+    --kerykeion-chart-color-zodiac-radix-ring-0: var(--kerykeion-color-black);
+    --kerykeion-chart-color-zodiac-radix-ring-1: var(--kerykeion-color-black);
+    --kerykeion-chart-color-zodiac-radix-ring-2: var(--kerykeion-color-black);
+    --kerykeion-chart-color-zodiac-transit-ring-0: var(--kerykeion-color-black);
+    --kerykeion-chart-color-zodiac-transit-ring-1: var(--kerykeion-color-black);
+    --kerykeion-chart-color-zodiac-transit-ring-2: var(--kerykeion-color-black);
+    --kerykeion-chart-color-zodiac-transit-ring-3: var(--kerykeion-color-black);
+    --kerykeion-chart-color-houses-radix-line: var(--kerykeion-color-base-content);
+    --kerykeion-chart-color-houses-transit-line: var(--kerykeion-color-base-content);
+
+    /* Aspects */
+    --kerykeion-chart-color-conjunction: #222222;
+    --kerykeion-chart-color-semi-sextile: #333333;
+    --kerykeion-chart-color-semi-square: #444444;
+    --kerykeion-chart-color-sextile: #333333;
+    --kerykeion-chart-color-quintile: #555555;
+    --kerykeion-chart-color-square: #000000;
+    --kerykeion-chart-color-trine: #222222;
+    --kerykeion-chart-color-sesquiquadrate: #444444;
+    --kerykeion-chart-color-biquintile: #555555;
+    --kerykeion-chart-color-quincunx: #444444;
+    --kerykeion-chart-color-opposition: #000000;
+
+    /* Planets */
+    --kerykeion-chart-color-sun: #000000;
+    --kerykeion-chart-color-moon: #000000;
+    --kerykeion-chart-color-mercury: #000000;
+    --kerykeion-chart-color-venus: #000000;
+    --kerykeion-chart-color-mars: #000000;
+    --kerykeion-chart-color-jupiter: #000000;
+    --kerykeion-chart-color-saturn: #000000;
+    --kerykeion-chart-color-uranus: #000000;
+    --kerykeion-chart-color-neptune: #000000;
+    --kerykeion-chart-color-pluto: #000000;
+    --kerykeion-chart-color-true-node: #000000;
+    --kerykeion-chart-color-mean-node: #000000;
+    --kerykeion-chart-color-chiron: #000000;
+    --kerykeion-chart-color-first-house: #000000;
+    --kerykeion-chart-color-tenth-house: #000000;
+    --kerykeion-chart-color-seventh-house: #000000;
+    --kerykeion-chart-color-fourth-house: #000000;
+    --kerykeion-chart-color-mean-lilith: #000000;
+    --kerykeion-chart-color-true-lilith: #000000;
+    --kerykeion-chart-color-ceres: #000000;
+    --kerykeion-chart-color-pallas: #000000;
+    --kerykeion-chart-color-juno: #000000;
+    --kerykeion-chart-color-vesta: #000000;
+    --kerykeion-chart-color-pars-fortunae: #000000;
+    --kerykeion-chart-color-vertex: #000000;
+    --kerykeion-chart-color-east-point: #000000;
+    --kerykeion-chart-color-eris: #000000;
+    --kerykeion-chart-color-earth: #000000;
+    --kerykeion-chart-color-pholus: #000000;
+    --kerykeion-chart-color-sedna: #000000;
+    --kerykeion-chart-color-haumea: #000000;
+    --kerykeion-chart-color-makemake: #000000;
+    --kerykeion-chart-color-ixion: #000000;
+    --kerykeion-chart-color-orcus: #000000;
+    --kerykeion-chart-color-quaoar: #000000;
+    --kerykeion-chart-color-regulus: #000000;
+    --kerykeion-chart-color-spica: #000000;
+    --kerykeion-chart-color-anti-vertex: #000000;
+
+    /* Arab Parts */
+    --kerykeion-chart-color-pars-spiritus: #000000;
+    --kerykeion-chart-color-pars-amoris: #000000;
+    --kerykeion-chart-color-pars-fortunae: #000000;
+    --kerykeion-chart-color-pars-fidei: #000000;
+
+    /* Zodiac Signs */
+    --kerykeion-chart-color-zodiac-icon-0: #000000;
+    --kerykeion-chart-color-zodiac-icon-1: #000000;
+    --kerykeion-chart-color-zodiac-icon-2: #000000;
+    --kerykeion-chart-color-zodiac-icon-3: #000000;
+    --kerykeion-chart-color-zodiac-icon-4: #000000;
+    --kerykeion-chart-color-zodiac-icon-5: #000000;
+    --kerykeion-chart-color-zodiac-icon-6: #000000;
+    --kerykeion-chart-color-zodiac-icon-7: #000000;
+    --kerykeion-chart-color-zodiac-icon-8: #000000;
+    --kerykeion-chart-color-zodiac-icon-9: #000000;
+    --kerykeion-chart-color-zodiac-icon-10: #000000;
+    --kerykeion-chart-color-zodiac-icon-11: #000000;
+
+    /* Elements Percentage */
+    --kerykeion-chart-color-air-percentage: #111111;
+    --kerykeion-chart-color-earth-percentage: #333333;
+    --kerykeion-chart-color-fire-percentage: #555555;
+    --kerykeion-chart-color-water-percentage: #777777;
+
+    /* Modalities Percentage */
+    --kerykeion-chart-color-cardinal-percentage: #222222;
+    --kerykeion-chart-color-fixed-percentage: #444444;
+    --kerykeion-chart-color-mutable-percentage: #666666;
+
+    /* Aspects */
+    --kerykeion-chart-color-lunar-phase-0: var(--kerykeion-color-black);
+    --kerykeion-chart-color-lunar-phase-1: var(--kerykeion-color-white);
+
+    /* Houses Numbers */
+    --kerykeion-chart-color-house-number: #000000;
+}

kerykeion/kr_types/__init__.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+"""
+Backward compatibility module for Kerykeion v4.x imports.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types import ...
+    NEW: from kerykeion.schemas import ...
+"""
+import warnings
+
+# Issue deprecation warning when this module is imported
+warnings.warn(
+    "The 'kerykeion.kr_types' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas for backward compatibility
+from kerykeion.schemas import *  # noqa: F401, F403
+from kerykeion.schemas.kerykeion_exception import *  # noqa: F401, F403
+from kerykeion.schemas.kr_literals import *  # noqa: F401, F403
+from kerykeion.schemas.kr_models import *  # noqa: F401, F403
+from kerykeion.schemas.settings_models import *  # noqa: F401, F403
+from kerykeion.schemas.chart_template_model import *  # noqa: F401, F403
+
+__all__ = [
+    # Re-export from schemas
+    "KerykeionException",
+    # kr_literals
+    "ZodiacType",
+    "Sign",
+    "SignNumbers",
+    "AspectMovementType",
+    "Houses",
+    "HouseNumbers",
+    "AstrologicalPoint",
+    "Element",
+    "Quality",
+    "ChartType",
+    "PointType",
+    "LunarPhaseEmoji",
+    "LunarPhaseName",
+    "SiderealMode",
+    "HousesSystemIdentifier",
+    "PerspectiveType",
+    "SignsEmoji",
+    "KerykeionChartTheme",
+    "KerykeionChartLanguage",
+    "RelationshipScoreDescription",
+    "CompositeChartType",
+    "AspectName",
+    # kr_models
+    "AstrologicalSubjectModel",
+    "CompositeSubjectModel",
+    "KerykeionPointModel",
+    "AspectModel",
+    "ActiveAspect",
+    "SingleChartAspectsModel",
+    "DualChartAspectsModel",
+    "ElementDistributionModel",
+    "QualityDistributionModel",
+    "SingleChartDataModel",
+    "DualChartDataModel",
+    # settings_models
+    "KerykeionSettingsModel",
+    # chart_template_model
+    "ChartTemplateModel",
+]

kerykeion/kr_types/chart_template_model.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Backward compatibility module for chart_template_model.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.chart_template_model import ...
+    NEW: from kerykeion.schemas.chart_template_model import ...
+"""
+import warnings
+
+warnings.warn(
+    "The 'kerykeion.kr_types.chart_template_model' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.chart_template_model' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas.chart_template_model for backward compatibility
+from kerykeion.schemas.chart_template_model import *  # noqa: F401, F403

kerykeion/kr_types/kerykeion_exception.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Backward compatibility module for kerykeion_exception.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.kerykeion_exception import ...
+    NEW: from kerykeion.schemas.kerykeion_exception import ...
+"""
+import warnings
+
+warnings.warn(
+    "The 'kerykeion.kr_types.kerykeion_exception' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.kerykeion_exception' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas.kerykeion_exception for backward compatibility
+from kerykeion.schemas.kerykeion_exception import *  # noqa: F401, F403

kerykeion/kr_types/kr_literals.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Backward compatibility module for kr_literals.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.kr_literals import ...
+    NEW: from kerykeion.schemas.kr_literals import ...
+"""
+import warnings
+
+warnings.warn(
+    "The 'kerykeion.kr_types.kr_literals' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.kr_literals' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas.kr_literals for backward compatibility
+from kerykeion.schemas.kr_literals import *  # noqa: F401, F403

kerykeion/kr_types/kr_models.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Backward compatibility module for kr_models.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.kr_models import ...
+    NEW: from kerykeion.schemas.kr_models import ...
+"""
+import warnings
+
+warnings.warn(
+    "The 'kerykeion.kr_types.kr_models' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.kr_models' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas.kr_models for backward compatibility
+from kerykeion.schemas.kr_models import *  # noqa: F401, F403

kerykeion/kr_types/settings_models.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Backward compatibility module for settings_models.
+
+DEPRECATED: This module will be removed in Kerykeion v6.0.
+Please update your imports:
+    OLD: from kerykeion.kr_types.settings_models import ...
+    NEW: from kerykeion.schemas.settings_models import ...
+"""
+import warnings
+
+warnings.warn(
+    "The 'kerykeion.kr_types.settings_models' module is deprecated and will be removed in v6.0. "
+    "Please update your imports to use 'kerykeion.schemas.settings_models' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from schemas.settings_models for backward compatibility
+from kerykeion.schemas.settings_models import *  # noqa: F401, F403

kerykeion/relationship_score_factory.py

@@ -41,9 +41,11 @@ Copyright: (C) 2025 Kerykeion Project
 License: AGPL-3.0
 """
 
+import logging
+from typing import Optional
+
 from kerykeion import AstrologicalSubjectFactory
 from kerykeion.aspects import AspectsFactory
-import logging
 from kerykeion.schemas.kr_models import AstrologicalSubjectModel, RelationshipScoreAspectModel, RelationshipScoreModel
 from kerykeion.schemas.kr_literals import RelationshipScoreDescription
 
@@ -77,6 +79,8 @@ class RelationshipScoreFactory:
         first_subject (AstrologicalSubjectModel): First astrological subject
         second_subject (AstrologicalSubjectModel): Second astrological subject
         use_only_major_aspects (bool, optional): Filter to major aspects only. Defaults to True.
+        axis_orb_limit (float | None, optional): Optional orb threshold for chart axes
+            filtering during aspect calculation.
 
     Reference:
         http://www.cirodiscepolo.it/Articoli/Discepoloele.htm
@@ -98,6 +102,8 @@ class RelationshipScoreFactory:
         first_subject: AstrologicalSubjectModel,
         second_subject: AstrologicalSubjectModel,
         use_only_major_aspects: bool = True,
+        *,
+        axis_orb_limit: Optional[float] = None,
     ):
         self.use_only_major_aspects = use_only_major_aspects
         self.first_subject: AstrologicalSubjectModel = first_subject
@@ -107,7 +113,11 @@ class RelationshipScoreFactory:
         self.relationship_score_description: RelationshipScoreDescription = "Minimal"
         self.is_destiny_sign = False
         self.relationship_score_aspects: list[RelationshipScoreAspectModel] = []
-        self._synastry_aspects = AspectsFactory.dual_chart_aspects(self.first_subject, self.second_subject).all_aspects
+        self._synastry_aspects = AspectsFactory.dual_chart_aspects(
+            self.first_subject,
+            self.second_subject,
+            axis_orb_limit=axis_orb_limit,
+        ).all_aspects
 
     def _evaluate_destiny_sign(self):
         """

kerykeion/schemas/__init__.py

@@ -27,6 +27,9 @@ from .kr_literals import (
     RelationshipScoreDescription,
     CompositeChartType,
     AspectName,
+    # Deprecated aliases
+    Planet,
+    AxialCusps,
 )
 from .kr_models import (
     SubscriptableBaseModel,
@@ -80,6 +83,10 @@ __all__ = [
     "CompositeChartType",
     "AspectName",
 
+    # Deprecated aliases (for v4.x compatibility, will be removed in v6.0)
+    "Planet",
+    "AxialCusps",
+
     # Main Model Classes (from kr_models)
     "SubscriptableBaseModel",
     "LunarPhaseModel",

kerykeion/schemas/kr_literals.py

@@ -136,7 +136,7 @@ Usually the standard is "Apparent Geocentric"
 SignsEmoji = Literal["♈️", "♉️", "♊️", "♋️", "♌️", "♍️", "♎️", "♏️", "♐️", "♑️", "♒️", "♓️"]
 """Literal type for Zodiac Signs Emoji"""
 
-KerykeionChartTheme = Literal["light", "dark", "dark-high-contrast", "classic", "strawberry"]
+KerykeionChartTheme = Literal["light", "dark", "dark-high-contrast", "classic", "strawberry", "black-and-white"]
 """Literal type for Kerykeion Chart Themes"""
 
 
@@ -168,3 +168,14 @@ AspectName = Literal[
 
 ReturnType = Literal["Lunar", "Solar"]
 """Literal type for Return Types"""
+
+
+# ---------------------------------------------------------------------------
+# Deprecated aliases for backward compatibility with Kerykeion v4.x
+# ---------------------------------------------------------------------------
+# These will be removed in v6.0 - migrate to AstrologicalPoint
+Planet = AstrologicalPoint
+"""DEPRECATED: Use AstrologicalPoint instead. This alias will be removed in v6.0."""
+
+AxialCusps = AstrologicalPoint
+"""DEPRECATED: Use AstrologicalPoint instead. This alias will be removed in v6.0."""

kerykeion/settings/__init__.py

@@ -1,6 +1,20 @@
-from .kerykeion_settings import KerykeionSettingsModel, get_settings
+from kerykeion.schemas import KerykeionSettingsModel
+from .chart_defaults import (
+    DEFAULT_CHART_COLORS,
+    DEFAULT_CELESTIAL_POINTS_SETTINGS,
+    DEFAULT_CHART_ASPECTS_SETTINGS,
+)
+from .kerykeion_settings import LANGUAGE_SETTINGS, SettingsSource, load_settings_mapping
+from .translations import get_translations, load_language_settings
 
 __all__ = [
     "KerykeionSettingsModel",
-    "get_settings",
+    "DEFAULT_CHART_COLORS",
+    "DEFAULT_CELESTIAL_POINTS_SETTINGS",
+    "DEFAULT_CHART_ASPECTS_SETTINGS",
+    "LANGUAGE_SETTINGS",
+    "load_settings_mapping",
+    "load_language_settings",
+    "get_translations",
+    "SettingsSource",
 ]