chart2txt 0.6.0 → 0.7.1

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

@@ -2,60 +2,53 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateHouseOverlaysOutput = generateHouseOverlaysOutput;
 const formatting_1 = require("../../../utils/formatting");
-const houseCalculations_1 = require("../../../utils/houseCalculations");
 /**
  * Generates the [HOUSE OVERLAYS] section for synastry.
- * @param chart1 The first chart data.
- * @param chart2 The second chart data.
- * @param settings The chart settings, containing the house system calculator.
+ * @param overlays The pre-calculated house overlay data.
+ * @param chart1Name The name of the first chart.
+ * @param chart2Name The name of the second chart.
  * @returns An array of strings for the output.
  */
-function generateHouseOverlaysOutput(chart1, chart2, settings) {
+function generateHouseOverlaysOutput(overlays, chart1Name, chart2Name) {
     const output = ['[HOUSE OVERLAYS]'];
-    const c1Name = chart1.name;
-    const c2Name = chart2.name;
-    // Chart 1's planets in Chart 2's houses
-    if (chart2.houseCusps && chart2.houseCusps.length === 12) {
-        output.push(`${c1Name}'s planets in ${c2Name}'s houses:`);
-        if (chart1.planets && chart1.planets.length > 0) {
-            chart1.planets.forEach((planet) => {
-                const houseNumber = (0, houseCalculations_1.getHouseForPoint)(planet.degree, chart2.houseCusps);
-                if (houseNumber) {
-                    output.push(`- ${planet.name}: ${(0, formatting_1.getOrdinal)(houseNumber)}`);
-                }
-                else {
-                    output.push(`- ${planet.name}: (Could not determine house in ${c2Name})`);
-                }
-            });
-        }
-        else {
-            output.push('(No planets listed for overlay)');
-        }
+    output.push(`${chart1Name}'s planets in ${chart2Name}'s houses:`);
+    if (Object.keys(overlays.chart1InChart2Houses).length > 0) {
+        output.push(formatHouseOverlayCompact(overlays.chart1InChart2Houses));
     }
     else {
-        output.push(`${c1Name}'s planets in ${c2Name}'s houses: (${c2Name} house cusps not available)`);
+        output.push(`(${chart2Name} house cusps not available)`);
     }
-    output.push(''); // Blank line between the two overlay sections
-    // Chart 2's planets in Chart 1's houses
-    if (chart1.houseCusps && chart1.houseCusps.length === 12) {
-        output.push(`${c2Name}'s planets in ${c1Name}'s houses:`);
-        if (chart2.planets && chart2.planets.length > 0) {
-            chart2.planets.forEach((planet) => {
-                const houseNumber = (0, houseCalculations_1.getHouseForPoint)(planet.degree, chart1.houseCusps);
-                if (houseNumber) {
-                    output.push(`- ${planet.name}: ${(0, formatting_1.getOrdinal)(houseNumber)}`);
-                }
-                else {
-                    output.push(`- ${planet.name}: (Could not determine house in ${c1Name})`);
-                }
-            });
-        }
-        else {
-            output.push('(No planets listed for overlay)');
-        }
+    output.push(`${chart2Name}'s planets in ${chart1Name}'s houses:`);
+    if (Object.keys(overlays.chart2InChart1Houses).length > 0) {
+        output.push(formatHouseOverlayCompact(overlays.chart2InChart1Houses));
     }
     else {
-        output.push(`${c2Name}'s planets in ${c1Name}'s houses: (${c1Name} house cusps not available)`);
+        output.push(`(${chart1Name} house cusps not available)`);
     }
     return output;
 }
+/**
+ * Formats house overlays in a compact format, grouping by house.
+ * @param overlays Object mapping planet names to house numbers.
+ * @returns A compact string representation.
+ */
+function formatHouseOverlayCompact(overlays) {
+    // Group planets by house
+    const houseGroups = {};
+    for (const planet in overlays) {
+        const house = overlays[planet];
+        if (!houseGroups[house]) {
+            houseGroups[house] = [];
+        }
+        houseGroups[house].push(planet);
+    }
+    // Sort houses numerically and format
+    const sortedHouses = Object.keys(houseGroups)
+        .map(Number)
+        .sort((a, b) => a - b);
+    const houseStrings = sortedHouses.map((house) => {
+        const planets = houseGroups[house].join(', ');
+        return `${(0, formatting_1.getOrdinal)(house)}: ${planets}`;
+    });
+    return houseStrings.join(' | ');
+}

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

@@ -1,4 +1,6 @@
 import { ChartSettings } from '../../../config/ChartSettings';
+import { MultiChartData } from '../../../types';
+export declare function determineChartType(data: MultiChartData): string;
 /**
  * Generates the [METADATA] section of the chart output.
  * @param settings The chart settings.

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

@@ -1,6 +1,60 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.determineChartType = determineChartType;
 exports.generateMetadataOutput = generateMetadataOutput;
+function 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';
+        }
+    }
+    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;
+}
 /**
  * Generates the [METADATA] section of the chart output.
  * @param settings The chart settings.

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

@@ -1,10 +1,8 @@
-import { Point } from '../../../types';
-import { ChartSettings } from '../../../config/ChartSettings';
+import { PlanetPosition } from '../../../types';
 /**
  * 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.
  */
-export declare function generatePlanetsOutput(planets: Point[], houseCusps: number[] | undefined, settings: ChartSettings): string[];
+export declare function generatePlanetsOutput(placements: PlanetPosition[]): string[];

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,122 @@ 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));
+    if (settings.includeDispositors) {
+        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('');
-    outputLines.push(...(0, houseOverlays_1.generateHouseOverlaysOutput)(chart1, chart2, settings));
+    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('');
+    if (settings.includeHouseOverlays) {
+        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';
-        }
-    }
-    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');
+    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`;
         }
-        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';
+        outputLines.push(...(0, aspectPatterns_1.generateAspectPatternsOutput)(patterns, title, true));
+        outputLines.push('');
     }
-    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();
 }