chart2txt 0.6.0 → 0.7.0

package/dist/formatters/text/sections/planets.js

@@ -1,37 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generatePlanetsOutput = generatePlanetsOutput;
-const astrology_1 = require("../../../core/astrology");
-const dignities_1 = require("../../../core/dignities");
 const formatting_1 = require("../../../utils/formatting");
-const houseCalculations_1 = require("../../../utils/houseCalculations");
+const dignities_1 = require("../../../core/dignities");
 /**
  * Generates the [PLANETS] section of the chart output.
- * @param planets Array of planet points.
- * @param houseCusps Array of 12 house cusp degrees, or undefined if not available.
+ * @param placements Array of planet positions.
  * @param settings The chart settings.
  * @returns An array of strings for the output.
  */
-function generatePlanetsOutput(planets, houseCusps, settings) {
+function generatePlanetsOutput(placements) {
     const output = ['[PLANETS]'];
-    planets.forEach((planet) => {
-        const sign = (0, astrology_1.getDegreeSign)(planet.degree);
-        const degInSign = Math.floor((0, astrology_1.getDegreeInSign)(planet.degree));
-        const retrogradeIndicator = planet.speed !== undefined && planet.speed < 0 ? ' Retrograde' : '';
-        const dignities = (0, dignities_1.formatPlanetWithDignities)(planet, houseCusps);
-        let line = `${planet.name}: ${degInSign}° ${sign}${retrogradeIndicator}`;
-        if (dignities) {
-            line += ` ${dignities}`;
-        }
-        if (houseCusps && houseCusps.length === 12) {
-            const houseNumber = (0, houseCalculations_1.getHouseForPoint)(planet.degree, houseCusps);
-            if (houseNumber) {
-                line += `, ${(0, formatting_1.getOrdinal)(houseNumber)} house`;
-            }
+    placements.forEach((planet) => {
+        const dignities = (0, dignities_1.formatPlanetWithDignities)(planet);
+        const retrograde = planet.speed && planet.speed < 0 ? ' Retrograde' : '';
+        let line = `${planet.name}: ${Math.floor(planet.degree % 30)}° ${planet.sign}${retrograde} ${dignities}`;
+        if (planet.house) {
+            line += `, ${(0, formatting_1.getOrdinal)(planet.house)} house`;
         }
-        output.push(line);
+        output.push(line.replace(/\s+/g, ' ').trim());
     });
-    if (planets.length === 0) {
+    if (placements.length === 0) {
         output.push('No planets listed.');
     }
     return output;

package/dist/formatters/text/sections/signDistributions.d.ts

@@ -1,25 +1,9 @@
-import { Point } from '../../../types';
-/**
- * Generates the [ELEMENT DISTRIBUTION] section of the chart output.
- * @param planets Array of planet points.
- * @param chartName Optional chart name for the header.
- * @param ascendant Optional ascendant degree to include in analysis.
- * @returns An array of strings for the output.
- */
-export declare function generateElementDistributionOutput(planets: Point[], chartName?: string, ascendant?: number): string[];
-/**
- * Generates the [MODALITY DISTRIBUTION] section of the chart output.
- * @param planets Array of planet points.
- * @param chartName Optional chart name for the header.
- * @param ascendant Optional ascendant degree to include in analysis.
- * @returns An array of strings for the output.
- */
-export declare function generateModalityDistributionOutput(planets: Point[], chartName?: string, ascendant?: number): string[];
-/**
- * Generates the [POLARITY] section of the chart output.
- * @param planets Array of planet points.
- * @param chartName Optional chart name for the header.
- * @param ascendant Optional ascendant degree to include in analysis.
- * @returns An array of strings for the output.
- */
-export declare function generatePolarityOutput(planets: Point[], chartName?: string, ascendant?: number): string[];
+export declare function generateElementDistributionOutput(elements: {
+    [key: string]: string[];
+}): string[];
+export declare function generateModalityDistributionOutput(modalities: {
+    [key: string]: number;
+}): string[];
+export declare function generatePolarityOutput(polarities: {
+    [key: string]: number;
+}): string[];

package/dist/formatters/text/sections/signDistributions.js

@@ -4,64 +4,18 @@ exports.generateElementDistributionOutput = generateElementDistributionOutput;
 exports.generateModalityDistributionOutput = generateModalityDistributionOutput;
 exports.generatePolarityOutput = generatePolarityOutput;
 const signDistributions_1 = require("../../../core/signDistributions");
-/**
- * Generates the [ELEMENT DISTRIBUTION] section of the chart output.
- * @param planets Array of planet points.
- * @param chartName Optional chart name for the header.
- * @param ascendant Optional ascendant degree to include in analysis.
- * @returns An array of strings for the output.
- */
-function generateElementDistributionOutput(planets, chartName, ascendant) {
-    const header = chartName
-        ? `[ELEMENT DISTRIBUTION: ${chartName}]`
-        : '[ELEMENT DISTRIBUTION]';
-    const output = [header];
-    if (planets.length === 0) {
-        output.push('No planets available for element analysis.');
-        return output;
-    }
-    const distributions = (0, signDistributions_1.analyzeSignDistributions)(planets, ascendant);
-    const formattedElements = (0, signDistributions_1.formatElementDistribution)(distributions.elements);
-    output.push(...formattedElements);
+function generateElementDistributionOutput(elements) {
+    const output = ['[ELEMENT DISTRIBUTION]'];
+    output.push(...(0, signDistributions_1.formatElementDistribution)(elements));
     return output;
 }
-/**
- * Generates the [MODALITY DISTRIBUTION] section of the chart output.
- * @param planets Array of planet points.
- * @param chartName Optional chart name for the header.
- * @param ascendant Optional ascendant degree to include in analysis.
- * @returns An array of strings for the output.
- */
-function generateModalityDistributionOutput(planets, chartName, ascendant) {
-    const header = chartName
-        ? `[MODALITY DISTRIBUTION: ${chartName}]`
-        : '[MODALITY DISTRIBUTION]';
-    const output = [header];
-    if (planets.length === 0) {
-        output.push('No planets available for modality analysis.');
-        return output;
-    }
-    const distributions = (0, signDistributions_1.analyzeSignDistributions)(planets, ascendant);
-    const formattedModalities = (0, signDistributions_1.formatModalityDistribution)(distributions.modalities);
-    output.push(...formattedModalities);
+function generateModalityDistributionOutput(modalities) {
+    const output = ['[MODALITY DISTRIBUTION]'];
+    output.push(...(0, signDistributions_1.formatModalityDistribution)(modalities));
     return output;
 }
-/**
- * Generates the [POLARITY] section of the chart output.
- * @param planets Array of planet points.
- * @param chartName Optional chart name for the header.
- * @param ascendant Optional ascendant degree to include in analysis.
- * @returns An array of strings for the output.
- */
-function generatePolarityOutput(planets, chartName, ascendant) {
-    const header = chartName ? `[POLARITY: ${chartName}]` : '[POLARITY]';
-    const output = [header];
-    if (planets.length === 0) {
-        output.push('No planets available for polarity analysis.');
-        return output;
-    }
-    const distributions = (0, signDistributions_1.analyzeSignDistributions)(planets, ascendant);
-    const formattedPolarities = (0, signDistributions_1.formatPolarityDistribution)(distributions.polarities);
-    output.push(...formattedPolarities);
+function generatePolarityOutput(polarities) {
+    const output = ['[POLARITY]'];
+    output.push(...(0, signDistributions_1.formatPolarityDistribution)(polarities));
     return output;
 }

package/dist/formatters/text/textFormatter.d.ts

@@ -1,8 +1,7 @@
-import { ChartData, MultiChartData, PartialSettings } from '../../types';
+import { AstrologicalReport } from '../../types';
 /**
- * Orchestrates the generation of a complete astrological chart report in text format.
- * @param data The chart data, can be for a single chart or multiple charts (synastry, transits).
- * @param partialSettings Optional: Custom settings to override defaults.
+ * Formats a pre-computed and pre-grouped AstrologicalReport into a human-readable text string.
+ * @param report The AstrologicalReport object, with aspects already grouped.
  * @returns A string representing the full chart report.
  */
-export declare function formatChartToText(data: ChartData | MultiChartData, partialSettings?: PartialSettings): string;
+export declare function formatReportToText(report: AstrologicalReport): string;

package/dist/formatters/text/textFormatter.js

@@ -1,24 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatChartToText = formatChartToText;
-const types_1 = require("../../types");
-const ChartSettings_1 = require("../../config/ChartSettings");
-const validation_1 = require("../../utils/validation");
-const aspects_1 = require("../../core/aspects");
-const aspectPatterns_1 = require("../../core/aspectPatterns");
-/**
- * Helper function to get all points (planets + angles) from a chart for aspect calculation
- */
-function getAllPointsFromChart(chartData) {
-    const allPoints = [...chartData.planets];
-    if (chartData.ascendant !== undefined) {
-        allPoints.push({ name: 'Ascendant', degree: chartData.ascendant });
-    }
-    if (chartData.midheaven !== undefined) {
-        allPoints.push({ name: 'Midheaven', degree: chartData.midheaven });
-    }
-    return allPoints;
-}
+exports.formatReportToText = formatReportToText;
 const metadata_1 = require("./sections/metadata");
 const chartHeader_1 = require("./sections/chartHeader");
 const birthdata_1 = require("./sections/birthdata");
@@ -26,160 +8,118 @@ const angles_1 = require("./sections/angles");
 const houses_1 = require("./sections/houses");
 const planets_1 = require("./sections/planets");
 const dispositors_1 = require("./sections/dispositors");
-const aspects_2 = require("./sections/aspects");
-const aspectPatterns_2 = require("./sections/aspectPatterns");
+const aspects_1 = require("./sections/aspects");
+const aspectPatterns_1 = require("./sections/aspectPatterns");
 const houseOverlays_1 = require("./sections/houseOverlays");
 const signDistributions_1 = require("./sections/signDistributions");
-const processSingleChartOutput = (settings, chartData, chartTitlePrefix) => {
+const stelliums_1 = require("../../core/stelliums");
+const processSingleChartOutput = (analysis, settings, chartTitlePrefix) => {
     const outputLines = [];
-    outputLines.push(...(0, chartHeader_1.generateChartHeaderOutput)(chartData.name, chartTitlePrefix));
-    outputLines.push(...(0, birthdata_1.generateBirthdataOutput)(chartData.location, chartData.timestamp, settings));
-    outputLines.push(...(0, angles_1.generateAnglesOutput)(chartData.ascendant, chartData.midheaven));
-    outputLines.push(...(0, houses_1.generateHousesOutput)(chartData.houseCusps));
-    outputLines.push(...(0, planets_1.generatePlanetsOutput)(chartData.planets, chartData.houseCusps, settings));
-    outputLines.push(...(0, dispositors_1.generateDispositorsOutput)(chartData.planets));
-    outputLines.push(...(0, signDistributions_1.generateElementDistributionOutput)(chartData.planets, undefined, chartData.ascendant));
-    outputLines.push(...(0, signDistributions_1.generateModalityDistributionOutput)(chartData.planets, undefined, chartData.ascendant));
-    outputLines.push(...(0, signDistributions_1.generatePolarityOutput)(chartData.planets, undefined, chartData.ascendant));
-    const aspects = (0, aspects_1.calculateAspects)(settings.aspectDefinitions, getAllPointsFromChart(chartData), settings.skipOutOfSignAspects);
-    // For single chart, p1ChartName and p2ChartName are not needed for aspect string generation
-    outputLines.push(...(0, aspects_2.generateAspectsOutput)('[ASPECTS]', aspects, settings));
-    // Detect and display aspect patterns (if enabled)
+    const { chart, groupedAspects, patterns, stelliums, signDistributions, dispositors, placements, } = analysis;
+    outputLines.push(...(0, chartHeader_1.generateChartHeaderOutput)(chart.name, chartTitlePrefix));
+    outputLines.push(...(0, birthdata_1.generateBirthdataOutput)(chart.location, chart.timestamp, settings));
+    outputLines.push(...(0, angles_1.generateAnglesOutput)(chart.ascendant, chart.midheaven));
+    outputLines.push(...(0, houses_1.generateHousesOutput)(chart.houseCusps));
+    outputLines.push(...(0, planets_1.generatePlanetsOutput)(placements.planets));
+    outputLines.push(...(0, dispositors_1.generateDispositorsOutput)(dispositors));
+    if (settings.includeSignDistributions) {
+        outputLines.push(...(0, signDistributions_1.generateElementDistributionOutput)(signDistributions.elements));
+        outputLines.push(...(0, signDistributions_1.generateModalityDistributionOutput)(signDistributions.modalities));
+        outputLines.push(...(0, signDistributions_1.generatePolarityOutput)(signDistributions.polarities));
+    }
+    outputLines.push(...(0, aspects_1.generateAspectsOutput)('[ASPECTS]', groupedAspects));
     if (settings.includeAspectPatterns) {
-        const aspectPatterns = (0, aspectPatterns_1.detectAspectPatterns)(chartData.planets, chartData.houseCusps);
-        outputLines.push(...(0, aspectPatterns_2.generateAspectPatternsOutput)(aspectPatterns));
+        outputLines.push(...(0, aspectPatterns_1.generateAspectPatternsOutput)(patterns, undefined, false));
+        if (stelliums.length > 0) {
+            stelliums.forEach((stellium) => {
+                outputLines.push(...(0, stelliums_1.formatStellium)(stellium));
+            });
+        }
+        else {
+            outputLines.push('No Stelliums detected.');
+        }
     }
     outputLines.push('');
     return outputLines;
 };
-const processChartPairOutput = (settings, chart1, chart2) => {
+const processChartPairOutput = (analysis, settings) => {
     const outputLines = [];
+    const { chart1, chart2, groupedSynastryAspects, compositePatterns, houseOverlays, } = analysis;
     const header = chart1.chartType === 'event' && chart2.chartType === 'event'
         ? 'EVENT_RELATIONSHIP'
         : chart1.chartType === 'event' || chart2.chartType === 'event'
             ? 'NATAL_EVENT'
             : 'SYNASTRY';
     outputLines.push(...(0, chartHeader_1.generateChartHeaderOutput)(`${chart1.name}-${chart2.name}`, header));
-    const synastryAspects = (0, aspects_1.calculateMultichartAspects)(settings.aspectDefinitions, getAllPointsFromChart(chart1), getAllPointsFromChart(chart2), settings.skipOutOfSignAspects);
-    outputLines.push(...(0, aspects_2.generateAspectsOutput)('[PLANET-PLANET ASPECTS]', synastryAspects, settings, chart1.name, chart2.name));
+    outputLines.push(...(0, aspects_1.generateAspectsOutput)('[PLANET-PLANET ASPECTS]', groupedSynastryAspects, chart1.name, chart2.name));
+    if (settings.includeAspectPatterns && compositePatterns.length > 0) {
+        outputLines.push(...(0, aspectPatterns_1.generateAspectPatternsOutput)(compositePatterns, `${chart1.name}-${chart2.name} Composite`, true));
+    }
     outputLines.push('');
-    outputLines.push(...(0, houseOverlays_1.generateHouseOverlaysOutput)(chart1, chart2, settings));
+    outputLines.push(...(0, houseOverlays_1.generateHouseOverlaysOutput)(houseOverlays, chart1.name, chart2.name));
     outputLines.push('');
     return outputLines;
 };
-const processTransitChartInfoOutput = (settings, transitData) => {
+const processGlobalPatternsOutput = (analysis, isTransit = false) => {
     const outputLines = [];
-    outputLines.push(...(0, chartHeader_1.generateChartHeaderOutput)(transitData.name, 'TRANSIT'));
-    outputLines.push(...(0, birthdata_1.generateBirthdataOutput)(transitData.location, transitData.timestamp, settings, '[DATETIME]'));
-    // For transit chart's own planets, houses are usually not shown unless it's a full natal chart for that moment.
-    outputLines.push(...(0, planets_1.generatePlanetsOutput)(transitData.planets, transitData.houseCusps, settings));
-    outputLines.push('');
-    return outputLines;
-};
-const determineChartType = (data) => {
-    let baseChartString = 'natal';
-    let suffixString = '';
-    const natalCharts = data.filter(({ chartType }) => chartType !== 'transit' && chartType !== 'event');
-    const eventCharts = data.filter(({ chartType }) => chartType === 'event');
-    const transitCharts = data.filter(({ chartType }) => chartType === 'transit');
-    if (transitCharts.length > 1) {
-        throw new Error('Must provide at most one transit chart');
-    }
-    const hasTransit = transitCharts.length > 0;
-    // first determine suffix
-    if (natalCharts.length > 0) {
-        if (eventCharts.length === 0) {
-            if (hasTransit) {
-                suffixString = '_with_transit';
-            }
-        }
-        else if (eventCharts.length === 1) {
-            suffixString = hasTransit ? '_with_event_and_transit' : '_with_event';
-        }
-        else {
-            suffixString = hasTransit ? '_with_events_and_transit' : '_with_events';
+    const { charts, patterns } = analysis;
+    if (patterns.length > 0) {
+        const chartNames = charts.map((c) => c.name).join('-');
+        let title = `${chartNames} Global Composite`;
+        if (isTransit) {
+            title = `${chartNames} Global Transit Composite`;
         }
+        outputLines.push(...(0, aspectPatterns_1.generateAspectPatternsOutput)(patterns, title, true));
+        outputLines.push('');
     }
-    else {
-        // base event charts can have transits
-        if (hasTransit) {
-            suffixString = '_with_transit';
-        }
-    }
-    // then determine base string
-    if (natalCharts.length === 0) {
-        if (eventCharts.length === 0) {
-            throw new Error('Must provide at least one non-transit chart');
-        }
-        else if (eventCharts.length === 1) {
-            baseChartString = 'event';
-        }
-        else {
-            baseChartString = 'multi_event';
-        }
-    }
-    else if (natalCharts.length === 1) {
-        baseChartString = 'natal';
-    }
-    else if (natalCharts.length === 2) {
-        baseChartString = 'synastry';
-    }
-    else {
-        baseChartString = 'group_synastry';
-    }
-    return baseChartString + suffixString;
+    return outputLines;
 };
 /**
- * Orchestrates the generation of a complete astrological chart report in text format.
- * @param data The chart data, can be for a single chart or multiple charts (synastry, transits).
- * @param partialSettings Optional: Custom settings to override defaults.
+ * Formats a pre-computed and pre-grouped AstrologicalReport into a human-readable text string.
+ * @param report The AstrologicalReport object, with aspects already grouped.
  * @returns A string representing the full chart report.
  */
-function formatChartToText(data, partialSettings = {}) {
-    // Validate input data
-    const validationError = (0, validation_1.validateInputData)(data);
-    if (validationError) {
-        throw new Error(`Invalid chart data: ${validationError}`);
-    }
-    const settings = new ChartSettings_1.ChartSettings(partialSettings);
-    const houseSystemName = settings.houseSystemName;
+function formatReportToText(report) {
+    const { chartAnalyses, pairwiseAnalyses, globalAnalysis, transitAnalyses, globalTransitAnalysis, } = report;
+    const settings = report.settings;
     const outputLines = [];
-    if (!(0, types_1.isMultiChartData)(data)) {
-        // single chart or event, legacy usage
-        if (data.chartType === 'transit') {
-            throw new Error('Single chart data must not be transit.');
-        }
-        outputLines.push(...(0, metadata_1.generateMetadataOutput)(settings, data.chartType || 'natal', houseSystemName));
-        outputLines.push(''); // Blank line after metadata
-        outputLines.push(...processSingleChartOutput(settings, data));
-        return outputLines.join('\n').trimEnd();
+    const originalCharts = chartAnalyses.map((ca) => ca.chart);
+    const chartType = (0, metadata_1.determineChartType)(originalCharts);
+    outputLines.push(...(0, metadata_1.generateMetadataOutput)(settings, chartType, settings.houseSystemName));
+    outputLines.push('');
+    // 1. Process individual non-transit charts
+    const nonTransitAnalyses = chartAnalyses.filter((a) => a.chart.chartType !== 'transit');
+    for (const analysis of nonTransitAnalyses) {
+        outputLines.push(...processSingleChartOutput(analysis, settings));
     }
-    // multi-chart analysis proceeds from here on
-    // generate metadata
-    const chartType = determineChartType(data);
-    outputLines.push(...(0, metadata_1.generateMetadataOutput)(settings, chartType, houseSystemName));
-    outputLines.push(''); // Blank line after metadata
-    const nonTransitCharts = data.filter(({ chartType }) => chartType !== 'transit');
-    const transitChart = data.find(({ chartType }) => chartType === 'transit');
-    // first, process each chart individually
-    for (const chart of nonTransitCharts) {
-        outputLines.push(...processSingleChartOutput(settings, chart));
+    // 2. Process pairwise analyses
+    for (const analysis of pairwiseAnalyses) {
+        outputLines.push(...processChartPairOutput(analysis, settings));
     }
-    // then, process each pairwise chart
-    for (let i = 0; i < nonTransitCharts.length; i++) {
-        for (let j = i + 1; j < nonTransitCharts.length; j++) {
-            outputLines.push(...processChartPairOutput(settings, nonTransitCharts[i], nonTransitCharts[j]));
-        }
+    // 3. Process global patterns (non-transit)
+    if (globalAnalysis) {
+        outputLines.push(...processGlobalPatternsOutput(globalAnalysis, false));
     }
-    // finally, process transit against each non-transit chart
-    if (transitChart) {
-        outputLines.push(...processTransitChartInfoOutput(settings, transitChart));
-        for (const chart of nonTransitCharts) {
-            // Transit Aspects to Chart 1
-            const transitAspectsC1 = (0, aspects_1.calculateMultichartAspects)(settings.aspectDefinitions, getAllPointsFromChart(chart), getAllPointsFromChart(transitChart), settings.skipOutOfSignAspects);
-            outputLines.push(...(0, aspects_2.generateAspectsOutput)(`[TRANSIT ASPECTS: ${chart.name}]`, transitAspectsC1, settings, chart.name, transitChart.name, true));
+    // 4. Process transit analyses
+    if (transitAnalyses.length > 0) {
+        const transitChartAnalysis = chartAnalyses.find((a) => a.chart.chartType === 'transit');
+        if (transitChartAnalysis) {
+            outputLines.push(...(0, chartHeader_1.generateChartHeaderOutput)(transitChartAnalysis.chart.name, 'TRANSIT'));
+            outputLines.push(...(0, birthdata_1.generateBirthdataOutput)(transitChartAnalysis.chart.location, transitChartAnalysis.chart.timestamp, settings, '[DATETIME]'));
+            outputLines.push(...(0, planets_1.generatePlanetsOutput)(transitChartAnalysis.placements.planets));
             outputLines.push('');
         }
+        for (const analysis of transitAnalyses) {
+            outputLines.push(...(0, aspects_1.generateAspectsOutput)(`[TRANSIT ASPECTS: ${analysis.natalChart.name}]`, analysis.groupedAspects, analysis.natalChart.name, analysis.transitChart.name, true));
+            if (settings.includeAspectPatterns) {
+                outputLines.push(...(0, aspectPatterns_1.generateAspectPatternsOutput)(analysis.patterns, `Transit to ${analysis.natalChart.name}`, true));
+            }
+            outputLines.push('');
+        }
+    }
+    // 5. Process global transit patterns
+    if (globalTransitAnalysis) {
+        outputLines.push(...processGlobalPatternsOutput(globalTransitAnalysis, true));
     }
     return outputLines.join('\n').trimEnd();
 }

package/dist/index.d.ts

@@ -4,9 +4,12 @@
  *
  * This is the main entry point for the library.
  */
-export { formatChartToText as chart2txt } from './formatters/text/textFormatter';
+export { chart2txt } from './chart2txt';
+export { analyzeCharts } from './core/analysis';
+export { groupAspects } from './core/grouping';
+export { formatReportToText } from './formatters/text/textFormatter';
 export * from './types';
-export { DEFAULT_SETTINGS, DEFAULT_ASPECTS, DEFAULT_ASPECT_CATEGORIES, ZODIAC_SIGNS, } from './constants';
+export { DEFAULT_SETTINGS, DEFAULT_ASPECTS, ZODIAC_SIGNS } from './constants';
 export { ChartSettings } from './config/ChartSettings';
-import { formatChartToText } from './formatters/text/textFormatter';
-export default formatChartToText;
+import { chart2txt } from './chart2txt';
+export default chart2txt;

package/dist/index.js

@@ -20,21 +20,26 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChartSettings = exports.ZODIAC_SIGNS = exports.DEFAULT_ASPECT_CATEGORIES = exports.DEFAULT_ASPECTS = exports.DEFAULT_SETTINGS = exports.chart2txt = void 0;
-// Core formatter function
+exports.ChartSettings = exports.ZODIAC_SIGNS = exports.DEFAULT_ASPECTS = exports.DEFAULT_SETTINGS = exports.formatReportToText = exports.groupAspects = exports.analyzeCharts = exports.chart2txt = void 0;
+// Core functions
+var chart2txt_1 = require("./chart2txt");
+Object.defineProperty(exports, "chart2txt", { enumerable: true, get: function () { return chart2txt_1.chart2txt; } });
+var analysis_1 = require("./core/analysis");
+Object.defineProperty(exports, "analyzeCharts", { enumerable: true, get: function () { return analysis_1.analyzeCharts; } });
+var grouping_1 = require("./core/grouping");
+Object.defineProperty(exports, "groupAspects", { enumerable: true, get: function () { return grouping_1.groupAspects; } });
 var textFormatter_1 = require("./formatters/text/textFormatter");
-Object.defineProperty(exports, "chart2txt", { enumerable: true, get: function () { return textFormatter_1.formatChartToText; } });
+Object.defineProperty(exports, "formatReportToText", { enumerable: true, get: function () { return textFormatter_1.formatReportToText; } });
 // Export all types for library users
 __exportStar(require("./types"), exports);
 // Export constants that might be useful for users (e.g., for custom settings)
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "DEFAULT_SETTINGS", { enumerable: true, get: function () { return constants_1.DEFAULT_SETTINGS; } });
 Object.defineProperty(exports, "DEFAULT_ASPECTS", { enumerable: true, get: function () { return constants_1.DEFAULT_ASPECTS; } });
-Object.defineProperty(exports, "DEFAULT_ASPECT_CATEGORIES", { enumerable: true, get: function () { return constants_1.DEFAULT_ASPECT_CATEGORIES; } });
 Object.defineProperty(exports, "ZODIAC_SIGNS", { enumerable: true, get: function () { return constants_1.ZODIAC_SIGNS; } });
 // Export ChartSettings class for advanced configuration
 var ChartSettings_1 = require("./config/ChartSettings");
 Object.defineProperty(exports, "ChartSettings", { enumerable: true, get: function () { return ChartSettings_1.ChartSettings; } });
 // Default export for convenience (e.g. UMD builds or simple script tags)
-const textFormatter_2 = require("./formatters/text/textFormatter");
-exports.default = textFormatter_2.formatChartToText;
+const chart2txt_2 = require("./chart2txt");
+exports.default = chart2txt_2.chart2txt;

package/dist/types.d.ts

@@ -17,28 +17,46 @@ export interface ChartData {
 }
 export type MultiChartData = ChartData[];
 export declare function isMultiChartData(obj: ChartData | MultiChartData): obj is MultiChartData;
+export type UnionedPoint = [Point, string];
+export declare enum AspectClassification {
+    Major = "major",
+    Minor = "minor",
+    Esoteric = "esoteric"
+}
+export declare enum PlanetCategory {
+    Luminaries = "luminaries",
+    Personal = "personal",
+    Social = "social",
+    Outer = "outer",
+    Angles = "angles"
+}
 export interface Aspect {
     name: string;
     angle: number;
     orb: number;
+    classification?: AspectClassification;
+}
+export type AspectStrength = 'tight' | 'moderate' | 'wide';
+export interface AspectStrengthThresholds {
+    tight: number;
+    moderate: number;
 }
 export interface AspectData {
     planetA: string;
     planetB: string;
+    p1ChartName?: string;
+    p2ChartName?: string;
     aspectType: string;
     orb: number;
     application?: 'applying' | 'separating' | 'exact';
 }
-export interface AspectCategory {
-    name: string;
-    minOrb?: number;
-    maxOrb: number;
-}
 export interface PlanetPosition {
     name: string;
     degree: number;
     sign: string;
+    speed?: number;
     house?: number;
+    chartName?: string;
 }
 export interface TSquare {
     type: 'T-Square';
@@ -93,15 +111,82 @@ export interface Kite {
     averageOrb: number;
 }
 export type AspectPattern = TSquare | GrandTrine | Stellium | GrandCross | Yod | MysticRectangle | Kite;
-export interface Settings {
-    includeSignDegree: boolean;
-    includeAscendant: boolean;
-    houseSystemName: string;
-    includeHouseDegree: boolean;
-    aspectDefinitions: Aspect[];
-    aspectCategories: AspectCategory[];
-    skipOutOfSignAspects: boolean;
-    includeAspectPatterns: boolean;
-    dateFormat: string;
+export interface ChartAnalysis {
+    chart: ChartData;
+    placements: {
+        planets: PlanetPosition[];
+        [key: string]: any;
+    };
+    aspects: AspectData[];
+    groupedAspects?: Map<string, AspectData[]>;
+    patterns: AspectPattern[];
+    stelliums: Stellium[];
+    signDistributions: {
+        elements: {
+            [key: string]: string[];
+        };
+        modalities: {
+            [key: string]: number;
+        };
+        polarities: {
+            [key: string]: number;
+        };
+    };
+    dispositors: {
+        [key: string]: string;
+    };
+}
+export interface PairwiseAnalysis {
+    chart1: ChartData;
+    chart2: ChartData;
+    synastryAspects: AspectData[];
+    groupedSynastryAspects?: Map<string, AspectData[]>;
+    compositePatterns: AspectPattern[];
+    houseOverlays: {
+        chart1InChart2Houses: {
+            [key: string]: number;
+        };
+        chart2InChart1Houses: {
+            [key: string]: number;
+        };
+    };
+}
+export interface GlobalAnalysis {
+    charts: ChartData[];
+    patterns: AspectPattern[];
+}
+export interface TransitAnalysis {
+    natalChart: ChartData;
+    transitChart: ChartData;
+    aspects: AspectData[];
+    groupedAspects?: Map<string, AspectData[]>;
+    patterns: AspectPattern[];
+}
+export interface AstrologicalReport {
+    settings: Settings;
+    chartAnalyses: ChartAnalysis[];
+    pairwiseAnalyses: PairwiseAnalysis[];
+    globalAnalysis?: GlobalAnalysis;
+    transitAnalyses: TransitAnalysis[];
+    globalTransitAnalysis?: GlobalAnalysis;
+}
+export interface AnalysisSettings {
+    aspectDefinitions?: Aspect[] | 'traditional' | 'modern' | 'tight' | 'wide';
+    skipOutOfSignAspects?: boolean;
+    includeAspectPatterns?: boolean;
+    includeSignDistributions?: boolean;
+}
+export interface GroupingSettings {
+    aspectStrengthThresholds?: AspectStrengthThresholds;
+}
+export interface FormattingSettings {
+    dateFormat?: string;
+    houseSystemName?: string;
+}
+export interface Settings extends AnalysisSettings, GroupingSettings, FormattingSettings {
 }
 export type PartialSettings = Partial<Settings>;
+export type ChartDataWithInfo = {
+    data: ChartData;
+    index: number;
+};