chart2txt 0.3.1 → 0.4.0

package/dist/chart2txt.min.js

@@ -1 +1 @@
-!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define([],n):"object"==typeof exports?exports.chart2txt=n():e.chart2txt=n()}(this,(()=>(()=>{"use strict";var e={921:(e,n)=>{Object.defineProperty(n,"__esModule",{value:!0}),n.DEFAULT_SETTINGS=n.DEFAULT_ASPECTS=n.ZODIAC_SIGNS=void 0,n.ZODIAC_SIGNS=["Aries","Taurus","Gemini","Cancer","Leo","Virgo","Libra","Scorpio","Sagittarius","Capricorn","Aquarius","Pisces"],n.DEFAULT_ASPECTS=[{name:"conjunction",angle:0,orb:5},{name:"opposition",angle:180,orb:5},{name:"trine",angle:120,orb:5},{name:"square",angle:90,orb:5},{name:"sextile",angle:60,orb:3}],n.DEFAULT_SETTINGS={includeSignDegree:!0,omitSigns:!1,houseSystem:"equal",includeHouseDegree:!1,omitHouses:!1,includeAscendant:!0,omitPoints:!1,aspectDefinitions:n.DEFAULT_ASPECTS,omitAspects:!1}}},n={};function t(o){var s=n[o];if(void 0!==s)return s.exports;var i=n[o]={exports:{}};return e[o](i,i.exports,t),i.exports}var o={};return(()=>{var e=o;const n=t(921);function s(e,t,o=[],s=n.DEFAULT_SETTINGS.includeSignDegree){const i=[...t?[{name:"Ascendant",degree:t}]:[],...e,...o].map((e=>{const t=function(e){const t=Math.floor(e/30)%12;return n.ZODIAC_SIGNS[t]}(e.degree);if(s){const n=Math.floor(e.degree%30);return`${e.name} is at ${n}° ${t}`}return`${e.name} is in ${t}`})).join(". ");return i?`${i}.`:""}function i(e,t,o,s=[],i=n.DEFAULT_SETTINGS.includeHouseDegree){const r=[...o,...s].map((n=>{const o=function(e,n,t){switch(e){case"equal":{const e=(n-t+360)%360;return{house:Math.floor(e/30)+1,degree:e%30}}case"whole_sign":{const e=(n-Math.floor(t/30)%12*30+360)%360;return{house:Math.floor(e/30)+1,degree:e%30}}}}(e,n.degree,t);return i?`${n.name} is at ${o.degree}° in house ${o.house}`:`${n.name} is in house ${o.house}`})).join(". ");return r?`${r}.`:""}function r(e,t={}){const o=Object.assign({},n.DEFAULT_SETTINGS,t);let r="Astrology Chart";const a=(c=e.location,u=e.timestamp,[c?`location: ${c}`:"",u?`at: ${u.toLocaleString()}`:""].filter((e=>""!==e)).join(", "));var c,u;if(a&&(r+=` (${a})`),r+=":\n\n",o.omitSigns||(r+=s(e.planets,o.includeAscendant&&e.ascendant?e.ascendant:void 0,o.omitPoints?[]:e.points,o.includeSignDegree)),o.omitHouses||void 0===e.ascendant||(r+="\n\n"+i(o.houseSystem,e.ascendant,e.planets,o.omitPoints?[]:e.points,o.includeHouseDegree)),!o.omitAspects){const n=function(e,n){const t=[];for(let o=0;o<n.length;o++)for(let s=o+1;s<n.length;s++){const i=n[o],r=n[s];let a=Math.abs(i.degree-r.degree);a>180&&(a=360-a);for(const n of e){const e=Math.abs(a-n.angle);if(e<=n.orb){t.push({planetA:i.name,planetB:r.name,aspectType:n.name,orb:e});break}}}return t}(o.aspectDefinitions,e.planets);n.length>0&&(r+="\n\n"+function(e){const n=e.map((e=>`${e.planetA} is in ${e.aspectType} with ${e.planetB} (orb: ${e.orb.toFixed(1)}°)`)).join(". ");return n?`${n}.`:""}(n))}return r}e.default=r})(),o=o.default})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.chart2txt=t():e.chart2txt=t()}(this,(()=>(()=>{"use strict";var e={75:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.calculateAspects=function(e,t){const n=[];if(!t||t.length<2)return n;for(let r=0;r<t.length;r++)for(let a=r+1;a<t.length;a++){const s=t[r],o=t[a];let u=Math.abs(s.degree-o.degree);u>180&&(u=360-u);let i=null;for(const t of e){const e=Math.abs(u-t.angle);e<=t.orb&&(!i||e<i.orb)&&(i={planetA:s.name,planetB:o.name,aspectType:t.name,orb:e})}i&&n.push(i)}return n},t.calculateMultichartAspects=function(e,t,n){const r=[];if(!t||!n||0===t.length||0===n.length)return r;for(const a of t)for(const t of n){let n=Math.abs(a.degree-t.degree);n>180&&(n=360-n);let s=null;for(const r of e){const e=Math.abs(n-r.angle);e<=r.orb&&(!s||e<s.orb)&&(s={planetA:a.name,planetB:t.name,aspectType:r.name,orb:e})}s&&r.push(s)}return r}},156:function(e,t,n){var r=this&&this.__createBinding||(Object.create?function(e,t,n,r){void 0===r&&(r=n);var a=Object.getOwnPropertyDescriptor(t,n);a&&!("get"in a?!t.__esModule:a.writable||a.configurable)||(a={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,r,a)}:function(e,t,n,r){void 0===r&&(r=n),e[r]=t[n]}),a=this&&this.__exportStar||function(e,t){for(var n in e)"default"===n||Object.prototype.hasOwnProperty.call(t,n)||r(t,e,n)};Object.defineProperty(t,"__esModule",{value:!0}),t.ChartSettings=t.ZODIAC_SIGNS=t.DEFAULT_ASPECT_CATEGORIES=t.DEFAULT_ASPECTS=t.DEFAULT_SETTINGS=t.chart2txt=void 0;var s=n(723);Object.defineProperty(t,"chart2txt",{enumerable:!0,get:function(){return s.formatChartToText}}),a(n(613),t);var o=n(921);Object.defineProperty(t,"DEFAULT_SETTINGS",{enumerable:!0,get:function(){return o.DEFAULT_SETTINGS}}),Object.defineProperty(t,"DEFAULT_ASPECTS",{enumerable:!0,get:function(){return o.DEFAULT_ASPECTS}}),Object.defineProperty(t,"DEFAULT_ASPECT_CATEGORIES",{enumerable:!0,get:function(){return o.DEFAULT_ASPECT_CATEGORIES}}),Object.defineProperty(t,"ZODIAC_SIGNS",{enumerable:!0,get:function(){return o.ZODIAC_SIGNS}});var u=n(230);Object.defineProperty(t,"ChartSettings",{enumerable:!0,get:function(){return u.ChartSettings}});const i=n(723);t.default=i.formatChartToText},172:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.generateChartHeaderOutput=function(e,t="CHART"){return[`[${t}: ${e||"Unknown"}]`]}},230:(e,t,n)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.ChartSettings=void 0;const r=n(921);t.ChartSettings=class{constructor(e={}){const t={...r.DEFAULT_SETTINGS,...e};this.includeSignDegree=t.includeSignDegree,this.includeAscendant=t.includeAscendant,this.includeHouseDegree=t.includeHouseDegree,this.aspectDefinitions=t.aspectDefinitions||r.DEFAULT_ASPECTS,this.aspectCategories=t.aspectCategories||r.DEFAULT_ASPECT_CATEGORIES,this.dateFormat=t.dateFormat}}},234:(e,t,n)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.generatePlanetsOutput=function(e,t,n){const a=["[PLANETS]"];e.forEach((e=>{const n=(0,r.getDegreeSign)(e.degree),s=Math.floor((0,r.getDegreeInSign)(e.degree)),o=void 0!==e.speed&&e.speed<0?" Rx":"";let u=`${e.name}: ${s}° ${n}${o}`;if(t&&12===t.length){const n=function(e,t){if(!t||12!==t.length)return 0;for(let n=0;n<12;n++){const r=t[n],a=t[(n+1)%12];if(r<a){if(e>=r&&e<a)return n+1}else if(e>=r||e<a)return n+1}return 0}(e.degree,t);n>0&&(u+=`, House ${n}`)}a.push(u)})),0===e.length&&a.push("No planets listed.");return a};const r=n(904)},388:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.generateMetadataOutput=function(e,t,n){const r=["[METADATA]",`chart_type: ${t}`];n&&r.push(`house_system: ${n}`);return r.push(`date_format: ${e.dateFormat}`),r}},613:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isMultiChartData=function(e){return void 0!==e.chart1}},723:(e,t,n)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.formatChartToText=function(e,t={}){const n=new r.ChartSettings(t),h=[];let g,d="natal";if("chart1"in e){const t=e;g=t.chart1.houseSystemName,t.chart2&&t.transit?d="synastry_with_transit":t.chart2?d="synastry":t.transit&&(d="natal_with_transit")}else g=e.houseSystemName;h.push(...(0,s.generateMetadataOutput)(n,d,g)),h.push("");const f=(e,t)=>{h.push(...(0,o.generateChartHeaderOutput)(e.name,t)),h.push(...(0,u.generateBirthdataOutput)(e.location,e.timestamp,n)),h.push(...(0,i.generateAnglesOutput)(e.ascendant,e.midheaven)),h.push(...(0,c.generatePlanetsOutput)(e.planets,e.houseCusps,n));const r=(0,a.calculateAspects)(n.aspectDefinitions,e.planets);h.push(...(0,p.generateAspectsOutput)("[ASPECTS]",r,n)),h.push("")};if("chart1"in e){const t=e,r=t.chart1,s=r.name||"Chart 1";if(f(r),t.chart2){const e=t.chart2,u=e.name||"Chart 2";f(e),h.push(...(0,o.generateChartHeaderOutput)(`${s}-${u}`,"SYNASTRY"));const i=(0,a.calculateMultichartAspects)(n.aspectDefinitions,r.planets,e.planets);h.push(...(0,p.generateAspectsOutput)("[PLANET-PLANET ASPECTS]",i,n,s,u)),h.push(""),h.push(...(0,l.generateHouseOverlaysOutput)(r,e,n)),h.push("")}if(t.transit){const e=t.transit,i=e.name||"Current";S=e,h.push(...(0,o.generateChartHeaderOutput)(S.name||"Current","TRANSIT")),h.push(...(0,u.generateBirthdataOutput)(S.location,S.timestamp,n,"[DATETIME]")),h.push(...(0,c.generatePlanetsOutput)(S.planets,S.houseCusps,n)),h.push("");const l=(0,a.calculateMultichartAspects)(n.aspectDefinitions,r.planets,e.planets);if(h.push(...(0,p.generateAspectsOutput)(`[TRANSIT ASPECTS: ${s}]`,l,n,s,i,!0)),h.push(""),t.chart2){const r=t.chart2.name||"Chart 2",s=(0,a.calculateMultichartAspects)(n.aspectDefinitions,t.chart2.planets,e.planets);h.push(...(0,p.generateAspectsOutput)(`[TRANSIT ASPECTS: ${r}]`,s,n,r,i,!0)),h.push("")}}}else f(e);var S;return h.join("\n").trimEnd()};const r=n(230),a=n(75),s=n(388),o=n(172),u=n(888),i=n(945),c=n(234),p=n(784),l=n(756)},756:(e,t)=>{function n(e,t){if(!t||12!==t.length)return 0;for(let n=0;n<12;n++){const r=t[n],a=t[(n+1)%12];if(r<a){if(e>=r&&e<a)return n+1}else if(e>=r||e<a)return n+1}return 0}Object.defineProperty(t,"__esModule",{value:!0}),t.generateHouseOverlaysOutput=function(e,t,r){const a=["[HOUSE OVERLAYS]"],s=e.name||"Chart 1",o=t.name||"Chart 2";t.houseCusps&&12===t.houseCusps.length?(a.push(`${s}'s planets in ${o}'s houses:`),e.planets&&e.planets.length>0?e.planets.forEach((e=>{const r=n(e.degree,t.houseCusps);r>0?a.push(`${e.name}: House ${r}`):a.push(`${e.name}: (Could not determine house in ${o})`)})):a.push("(No planets listed for overlay)")):a.push(`${s}'s planets in ${o}'s houses: (${o} house cusps not available)`);a.push(""),e.houseCusps&&12===e.houseCusps.length?(a.push(`${o}'s planets in ${s}'s houses:`),t.planets&&t.planets.length>0?t.planets.forEach((t=>{const r=n(t.degree,e.houseCusps);r>0?a.push(`${t.name}: House ${r}`):a.push(`${t.name}: (Could not determine house in ${s})`)})):a.push("(No planets listed for overlay)")):a.push(`${o}'s planets in ${s}'s houses: (${s} house cusps not available)`);return a}},784:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.generateAspectsOutput=function(e,t,n,r,a,s=!1){const o=[e];let u=!1;n.aspectCategories.forEach((e=>{const n=t.filter((t=>{const n=t.orb,r=void 0===e.minOrb||n>e.minOrb,a=n<=e.maxOrb;return r&&a}));if(n.length>0){u=!0;let t=`orb < ${e.maxOrb.toFixed(1)}°`;void 0!==e.minOrb&&(t=e.minOrb<e.maxOrb?`orb ${e.minOrb.toFixed(1)}-${e.maxOrb.toFixed(1)}°`:`orb > ${e.minOrb.toFixed(1)}° & < ${e.maxOrb.toFixed(1)}°`),o.push(`[${e.name.toUpperCase()}: ${t}]`),n.sort(((e,t)=>e.orb-t.orb)),n.forEach((e=>{const t=r?`${r}'s ${e.planetA}`:e.planetA;let n=e.planetB;s?n=`transiting ${e.planetB}`:a&&(n=`${a}'s ${e.planetB}`),o.push(`${t} ${e.aspectType} ${n}: ${e.orb.toFixed(1)}°`)}))}})),!u&&t.length>0?o.push("No aspects within defined categories."):0===t.length&&o.push("None");return o}},888:(e,t,n)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.generateBirthdataOutput=function(e,t,n,a="[BIRTHDATA]"){if(!t)return[`${a} Not available`];const s=(0,r.formatDateCustom)(t,n.dateFormat),o=(0,r.formatTime)(t);return[`${a} ${e||"Unknown Location"}, ${s}, ${o}`]};const r=n(889)},889:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.formatDateCustom=function(e,t){const n=e.getMonth()+1,r=e.getDate(),a=e.getFullYear();switch(t.toUpperCase()){case"MM/DD/YYYY":return`${n.toString().padStart(2,"0")}/${r.toString().padStart(2,"0")}/${a}`;case"DD/MM/YYYY":return`${r.toString().padStart(2,"0")}/${n.toString().padStart(2,"0")}/${a}`;case"YYYY-MM-DD":return`${a}-${n.toString().padStart(2,"0")}-${r.toString().padStart(2,"0")}`;default:return console.warn(`Unrecognized date format: ${t}. Falling back to toLocaleDateString().`),e.toLocaleDateString()}},t.formatTime=function(e){return e.toLocaleTimeString("en-US",{hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:!0})}},904:(e,t,n)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.getDegreeSign=function(e){const t=Math.floor(e/30)%12;if(t<0||t>=r.ZODIAC_SIGNS.length)return console.error(`Invalid sign index computed: ${t} for degree ${e}`),"Unknown Sign";return r.ZODIAC_SIGNS[t]},t.getDegreeInSign=function(e){return e%30};const r=n(921)},921:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.DEFAULT_SETTINGS=t.DEFAULT_ASPECT_CATEGORIES=t.DEFAULT_ASPECTS=t.ZODIAC_SIGNS=void 0,t.ZODIAC_SIGNS=["Aries","Taurus","Gemini","Cancer","Leo","Virgo","Libra","Scorpio","Sagittarius","Capricorn","Aquarius","Pisces"],t.DEFAULT_ASPECTS=[{name:"conjunction",angle:0,orb:5},{name:"opposition",angle:180,orb:5},{name:"trine",angle:120,orb:5},{name:"square",angle:90,orb:5},{name:"sextile",angle:60,orb:3}],t.DEFAULT_ASPECT_CATEGORIES=[{name:"MAJOR",maxOrb:2},{name:"MODERATE",minOrb:2,maxOrb:4}],t.DEFAULT_SETTINGS={includeSignDegree:!0,includeHouseDegree:!1,includeAscendant:!0,aspectDefinitions:t.DEFAULT_ASPECTS,aspectCategories:t.DEFAULT_ASPECT_CATEGORIES,dateFormat:"MM/DD/YYYY"}},945:(e,t,n)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.generateAnglesOutput=function(e,t){const n=["[ANGLES]"];void 0!==e?n.push(`ASC: ${Math.floor((0,r.getDegreeInSign)(e))}° ${(0,r.getDegreeSign)(e)}`):n.push("ASC: Not available");void 0!==t?n.push(`MC: ${Math.floor((0,r.getDegreeInSign)(t))}° ${(0,r.getDegreeSign)(t)}`):n.push("MC: Not available");return n};const r=n(904)}},t={};var n=function n(r){var a=t[r];if(void 0!==a)return a.exports;var s=t[r]={exports:{}};return e[r].call(s.exports,s,s.exports,n),s.exports}(156);return n=n.default})()));

package/dist/config/ChartSettings.d.ts

@@ -0,0 +1,10 @@
+import { Settings, PartialSettings, AspectCategory, Aspect } from '../types';
+export declare class ChartSettings implements Settings {
+    includeSignDegree: boolean;
+    includeAscendant: boolean;
+    includeHouseDegree: boolean;
+    aspectDefinitions: Aspect[];
+    aspectCategories: AspectCategory[];
+    dateFormat: string;
+    constructor(customSettings?: PartialSettings);
+}

package/dist/config/ChartSettings.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChartSettings = void 0;
+const constants_1 = require("../constants");
+class ChartSettings {
+    constructor(customSettings = {}) {
+        const mergedSettings = { ...constants_1.DEFAULT_SETTINGS, ...customSettings };
+        this.includeSignDegree = mergedSettings.includeSignDegree;
+        this.includeAscendant = mergedSettings.includeAscendant;
+        this.includeHouseDegree = mergedSettings.includeHouseDegree;
+        this.aspectDefinitions =
+            mergedSettings.aspectDefinitions || constants_1.DEFAULT_ASPECTS; // Ensure array is not undefined
+        this.aspectCategories =
+            mergedSettings.aspectCategories || constants_1.DEFAULT_ASPECT_CATEGORIES; // Ensure array is not undefined
+        this.dateFormat = mergedSettings.dateFormat;
+    }
+}
+exports.ChartSettings = ChartSettings;

package/dist/constants.d.ts

@@ -1,4 +1,5 @@
-import { Aspect, Settings } from './types';
+import { Aspect, Settings, AspectCategory } from './types';
 export declare const ZODIAC_SIGNS: string[];
 export declare const DEFAULT_ASPECTS: Aspect[];
+export declare const DEFAULT_ASPECT_CATEGORIES: AspectCategory[];
 export declare const DEFAULT_SETTINGS: Settings;

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SETTINGS = exports.DEFAULT_ASPECTS = exports.ZODIAC_SIGNS = void 0;
+exports.DEFAULT_SETTINGS = exports.DEFAULT_ASPECT_CATEGORIES = exports.DEFAULT_ASPECTS = exports.ZODIAC_SIGNS = void 0;
 exports.ZODIAC_SIGNS = [
     'Aries',
     'Taurus',
@@ -16,24 +16,25 @@ exports.ZODIAC_SIGNS = [
     'Pisces',
 ];
 exports.DEFAULT_ASPECTS = [
-    { name: 'conjunction', angle: 0, orb: 5 },
+    { name: 'conjunction', angle: 0, orb: 5 }, // Max orb for this aspect to be considered
     { name: 'opposition', angle: 180, orb: 5 },
     { name: 'trine', angle: 120, orb: 5 },
     { name: 'square', angle: 90, orb: 5 },
     { name: 'sextile', angle: 60, orb: 3 },
 ];
+exports.DEFAULT_ASPECT_CATEGORIES = [
+    { name: 'MAJOR', maxOrb: 2 }, // Orb < 2°
+    { name: 'MODERATE', minOrb: 2, maxOrb: 4 }, // Orb 2-4°
+];
 exports.DEFAULT_SETTINGS = {
     // sign settings
-    includeSignDegree: true,
-    omitSigns: false,
+    includeSignDegree: true, // For planets list: "Sun: 8° Cancer" vs "Sun: Cancer"
     // house settings
-    houseSystem: 'equal',
-    includeHouseDegree: false,
-    omitHouses: false,
+    includeHouseDegree: false, // New format shows "House X", not degree in house for planets list
     // point settings
-    includeAscendant: true,
-    omitPoints: false,
+    includeAscendant: true, // Legacy, ASC/MC now have dedicated [ANGLES] section
     // orb + aspect settings
     aspectDefinitions: exports.DEFAULT_ASPECTS,
-    omitAspects: false,
+    aspectCategories: exports.DEFAULT_ASPECT_CATEGORIES,
+    dateFormat: 'MM/DD/YYYY', // As per example output
 };

package/dist/core/aspects.d.ts

@@ -0,0 +1,17 @@
+import { Point, Aspect, AspectData } from '../types';
+/**
+ * Identifies aspects between planets in a single chart.
+ * @param aspectDefinitions Array of aspect types to check for.
+ * @param planets Array of planet points.
+ * @returns Array of found aspects.
+ */
+export declare function calculateAspects(aspectDefinitions: Aspect[], planets: Point[]): AspectData[];
+/**
+ * Identifies aspects between planets across two charts.
+ * PlanetA is always from chart1Planets, PlanetB always from chart2Planets.
+ * @param aspectDefinitions Array of aspect types to check for.
+ * @param chart1Planets Array of planet points for the first chart.
+ * @param chart2Planets Array of planet points for the second chart.
+ * @returns Array of found aspects.
+ */
+export declare function calculateMultichartAspects(aspectDefinitions: Aspect[], chart1Planets: Point[], chart2Planets: Point[]): AspectData[];

package/dist/core/aspects.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateAspects = calculateAspects;
+exports.calculateMultichartAspects = calculateMultichartAspects;
+/**
+ * Identifies aspects between planets in a single chart.
+ * @param aspectDefinitions Array of aspect types to check for.
+ * @param planets Array of planet points.
+ * @returns Array of found aspects.
+ */
+function calculateAspects(aspectDefinitions, planets) {
+    const aspects = [];
+    if (!planets || planets.length < 2)
+        return aspects;
+    for (let i = 0; i < planets.length; i++) {
+        for (let j = i + 1; j < planets.length; j++) {
+            const planetA = planets[i];
+            const planetB = planets[j];
+            let diff = Math.abs(planetA.degree - planetB.degree);
+            if (diff > 180)
+                diff = 360 - diff;
+            // Find the tightest valid aspect
+            let tightestAspect = null;
+            for (const aspectType of aspectDefinitions) {
+                const orb = Math.abs(diff - aspectType.angle);
+                if (orb <= aspectType.orb) {
+                    if (!tightestAspect || orb < tightestAspect.orb) {
+                        tightestAspect = {
+                            planetA: planetA.name,
+                            planetB: planetB.name,
+                            aspectType: aspectType.name,
+                            orb,
+                        };
+                    }
+                }
+            }
+            if (tightestAspect) {
+                aspects.push(tightestAspect);
+            }
+        }
+    }
+    return aspects;
+}
+/**
+ * Identifies aspects between planets across two charts.
+ * PlanetA is always from chart1Planets, PlanetB always from chart2Planets.
+ * @param aspectDefinitions Array of aspect types to check for.
+ * @param chart1Planets Array of planet points for the first chart.
+ * @param chart2Planets Array of planet points for the second chart.
+ * @returns Array of found aspects.
+ */
+function calculateMultichartAspects(aspectDefinitions, chart1Planets, chart2Planets) {
+    const aspects = [];
+    if (!chart1Planets ||
+        !chart2Planets ||
+        chart1Planets.length === 0 ||
+        chart2Planets.length === 0) {
+        return aspects;
+    }
+    for (const p1 of chart1Planets) {
+        for (const p2 of chart2Planets) {
+            let diff = Math.abs(p1.degree - p2.degree);
+            if (diff > 180)
+                diff = 360 - diff;
+            // Find the tightest valid aspect
+            let tightestAspect = null;
+            for (const aspectType of aspectDefinitions) {
+                const orb = Math.abs(diff - aspectType.angle);
+                if (orb <= aspectType.orb) {
+                    if (!tightestAspect || orb < tightestAspect.orb) {
+                        tightestAspect = {
+                            planetA: p1.name, // From chart1
+                            planetB: p2.name, // From chart2
+                            aspectType: aspectType.name,
+                            orb,
+                        };
+                    }
+                }
+            }
+            if (tightestAspect) {
+                aspects.push(tightestAspect);
+            }
+        }
+    }
+    return aspects;
+}

package/dist/core/astrology.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Determines the zodiac sign for a given degree.
+ * @param degree The absolute degree (0-359.99...).
+ * @returns The zodiac sign name.
+ */
+export declare function getDegreeSign(degree: number): string;
+/**
+ * Calculates the degree within its 30-degree sign (0-29.99...).
+ * @param degree The absolute degree (0-359.99...).
+ * @returns The degree within the sign.
+ */
+export declare function getDegreeInSign(degree: number): number;

package/dist/core/astrology.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDegreeSign = getDegreeSign;
+exports.getDegreeInSign = getDegreeInSign;
+const constants_1 = require("../constants");
+/**
+ * Determines the zodiac sign for a given degree.
+ * @param degree The absolute degree (0-359.99...).
+ * @returns The zodiac sign name.
+ */
+function getDegreeSign(degree) {
+    const signIndex = Math.floor(degree / 30) % 12;
+    if (signIndex < 0 || signIndex >= constants_1.ZODIAC_SIGNS.length) {
+        // This should ideally not happen with degree % 12 logic if degree is positive
+        console.error(`Invalid sign index computed: ${signIndex} for degree ${degree}`);
+        return 'Unknown Sign';
+    }
+    return constants_1.ZODIAC_SIGNS[signIndex];
+}
+/**
+ * Calculates the degree within its 30-degree sign (0-29.99...).
+ * @param degree The absolute degree (0-359.99...).
+ * @returns The degree within the sign.
+ */
+function getDegreeInSign(degree) {
+    return degree % 30;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Generates the [ANGLES] section of the chart output.
+ * @param ascDegree The degree of the Ascendant.
+ * @param mcDegree The degree of the Midheaven.
+ * @returns An array of strings for the output.
+ */
+export declare function generateAnglesOutput(ascDegree?: number, mcDegree?: number): string[];

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAnglesOutput = generateAnglesOutput;
+const astrology_1 = require("../../../core/astrology");
+/**
+ * Generates the [ANGLES] section of the chart output.
+ * @param ascDegree The degree of the Ascendant.
+ * @param mcDegree The degree of the Midheaven.
+ * @returns An array of strings for the output.
+ */
+function generateAnglesOutput(ascDegree, mcDegree) {
+    const output = ['[ANGLES]'];
+    if (ascDegree !== undefined) {
+        output.push(`ASC: ${Math.floor((0, astrology_1.getDegreeInSign)(ascDegree))}° ${(0, astrology_1.getDegreeSign)(ascDegree)}`);
+    }
+    else {
+        output.push('ASC: Not available');
+    }
+    if (mcDegree !== undefined) {
+        output.push(`MC: ${Math.floor((0, astrology_1.getDegreeInSign)(mcDegree))}° ${(0, astrology_1.getDegreeSign)(mcDegree)}`);
+    }
+    else {
+        output.push('MC: Not available');
+    }
+    return output;
+}

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

@@ -0,0 +1,14 @@
+import { AspectData } from '../../../types';
+import { ChartSettings } from '../../../config/ChartSettings';
+/**
+ * Generates aspect sections (e.g., [ASPECTS], [PLANET-PLANET ASPECTS], [TRANSIT ASPECTS: Name]).
+ * @param title The main title for this aspect block (e.g., "[ASPECTS]").
+ * @param aspects Array of calculated aspect data.
+ * @param settings The chart settings, containing aspect categories.
+ * @param p1ChartName Optional: Name of the first chart/entity for synastry/transit aspects.
+ * @param p2ChartName Optional: Name of the second chart/entity for synastry aspects.
+ * @param p2IsTransit Optional: Boolean indicating if p2 represents transiting points.
+ * @returns An array of strings for the output.
+ */
+export declare function generateAspectsOutput(title: string, aspects: AspectData[], settings: ChartSettings, p1ChartName?: string, p2ChartName?: string, // For synastry, this is the second person's name. For transits, it could be "Current" or the transit chart name.
+p2IsTransit?: boolean): string[];

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAspectsOutput = generateAspectsOutput;
+/**
+ * Generates aspect sections (e.g., [ASPECTS], [PLANET-PLANET ASPECTS], [TRANSIT ASPECTS: Name]).
+ * @param title The main title for this aspect block (e.g., "[ASPECTS]").
+ * @param aspects Array of calculated aspect data.
+ * @param settings The chart settings, containing aspect categories.
+ * @param p1ChartName Optional: Name of the first chart/entity for synastry/transit aspects.
+ * @param p2ChartName Optional: Name of the second chart/entity for synastry aspects.
+ * @param p2IsTransit Optional: Boolean indicating if p2 represents transiting points.
+ * @returns An array of strings for the output.
+ */
+function generateAspectsOutput(title, aspects, settings, p1ChartName, p2ChartName, // For synastry, this is the second person's name. For transits, it could be "Current" or the transit chart name.
+p2IsTransit = false) {
+    const output = [title];
+    let aspectsFoundInAnyCategory = false;
+    settings.aspectCategories.forEach((category) => {
+        const categoryAspects = aspects.filter((asp) => {
+            const orb = asp.orb;
+            const minOrbCheck = category.minOrb === undefined ? true : orb > category.minOrb;
+            const maxOrbCheck = orb <= category.maxOrb;
+            return minOrbCheck && maxOrbCheck;
+        });
+        if (categoryAspects.length > 0) {
+            aspectsFoundInAnyCategory = true;
+            let orbRangeStr = `orb < ${category.maxOrb.toFixed(1)}°`;
+            if (category.minOrb !== undefined) {
+                // Ensure minOrb is less than maxOrb for sensible range string
+                orbRangeStr =
+                    category.minOrb < category.maxOrb
+                        ? `orb ${category.minOrb.toFixed(1)}-${category.maxOrb.toFixed(1)}°`
+                        : `orb > ${category.minOrb.toFixed(1)}° & < ${category.maxOrb.toFixed(1)}°`; // Fallback for unusual category def
+            }
+            output.push(`[${category.name.toUpperCase()}: ${orbRangeStr}]`);
+            categoryAspects.sort((a, b) => a.orb - b.orb); // Sort by orb tightness
+            categoryAspects.forEach((asp) => {
+                const p1NameStr = p1ChartName
+                    ? `${p1ChartName}'s ${asp.planetA}`
+                    : asp.planetA;
+                let p2NameStr = asp.planetB;
+                if (p2IsTransit) {
+                    // For "Transit Aspects: Alice", p1 is Alice, p2 is the transiting planet.
+                    // Example: "Alice's Mercury opposition transiting Neptune: 0.3°" - here p2ChartName is not used for the planet itself.
+                    p2NameStr = `transiting ${asp.planetB}`;
+                }
+                else if (p2ChartName) {
+                    // For "Synastry: Alice-Bob", "Planet-Planet Aspects"
+                    // Example: "Alice's Mercury opposition Bob's Neptune: 0.3°"
+                    p2NameStr = `${p2ChartName}'s ${asp.planetB}`;
+                }
+                // If neither p2IsTransit nor p2ChartName, it's a natal chart aspect, e.g. "Venus opposition Pluto: 1.2°"
+                output.push(`${p1NameStr} ${asp.aspectType} ${p2NameStr}: ${asp.orb.toFixed(1)}°`);
+            });
+        }
+    });
+    if (!aspectsFoundInAnyCategory && aspects.length > 0) {
+        output.push('No aspects within defined categories.');
+    }
+    else if (aspects.length === 0) {
+        output.push('None');
+    }
+    return output;
+}

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

@@ -0,0 +1,10 @@
+import { ChartSettings } from '../../../config/ChartSettings';
+/**
+ * Generates the [BIRTHDATA] or [DATETIME] section.
+ * @param location The location string.
+ * @param timestamp The Date object for the event.
+ * @param settings The chart settings, used for date formatting.
+ * @param sectionTitle The title for the section (e.g., "[BIRTHDATA]", "[DATETIME]").
+ * @returns An array of strings for the output.
+ */
+export declare function generateBirthdataOutput(location: string | undefined, timestamp: Date | undefined, settings: ChartSettings, sectionTitle?: string): string[];

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBirthdataOutput = generateBirthdataOutput;
+const datetime_1 = require("../../../utils/datetime");
+/**
+ * Generates the [BIRTHDATA] or [DATETIME] section.
+ * @param location The location string.
+ * @param timestamp The Date object for the event.
+ * @param settings The chart settings, used for date formatting.
+ * @param sectionTitle The title for the section (e.g., "[BIRTHDATA]", "[DATETIME]").
+ * @returns An array of strings for the output.
+ */
+function generateBirthdataOutput(location, timestamp, settings, sectionTitle = '[BIRTHDATA]') {
+    if (!timestamp)
+        return [`${sectionTitle} Not available`];
+    const dateStr = (0, datetime_1.formatDateCustom)(timestamp, settings.dateFormat);
+    const timeStr = (0, datetime_1.formatTime)(timestamp);
+    return [
+        `${sectionTitle} ${location || 'Unknown Location'}, ${dateStr}, ${timeStr}`,
+    ];
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Generates the chart header line (e.g., "[CHART: Alice]", "[SYNASTRY: Alice-Bob]").
+ * @param chartName The name of the chart or chart combination.
+ * @param prefix The prefix for the header (e.g., "CHART", "SYNASTRY", "TRANSIT").
+ * @returns An array containing a single string for the header line.
+ */
+export declare function generateChartHeaderOutput(chartName: string | undefined, prefix?: string): string[];

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateChartHeaderOutput = generateChartHeaderOutput;
+/**
+ * Generates the chart header line (e.g., "[CHART: Alice]", "[SYNASTRY: Alice-Bob]").
+ * @param chartName The name of the chart or chart combination.
+ * @param prefix The prefix for the header (e.g., "CHART", "SYNASTRY", "TRANSIT").
+ * @returns An array containing a single string for the header line.
+ */
+function generateChartHeaderOutput(chartName, prefix = 'CHART') {
+    return [`[${prefix}: ${chartName || 'Unknown'}]`];
+}

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

@@ -0,0 +1,10 @@
+import { ChartData } from '../../../types';
+import { ChartSettings } from '../../../config/ChartSettings';
+/**
+ * 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.
+ * @returns An array of strings for the output.
+ */
+export declare function generateHouseOverlaysOutput(chart1: ChartData, chart2: ChartData, settings: ChartSettings): string[];

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

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateHouseOverlaysOutput = generateHouseOverlaysOutput;
+// Helper function to determine which house a point falls into
+function getHouseForPoint(pointDegree, houseCusps) {
+    if (!houseCusps || houseCusps.length !== 12) {
+        // console.error("Invalid or missing houseCusps array for getHouseForPoint.");
+        return 0; // Indicate failure or inability to calculate
+    }
+    for (let i = 0; i < 12; i++) {
+        const cuspStart = houseCusps[i]; // Cusp of current house (e.g., for House 1, i=0, cuspStart = Cusp 1)
+        const cuspEnd = houseCusps[(i + 1) % 12]; // Cusp of next house (e.g., for House 1, cuspEnd = Cusp 2)
+        // Check if the point degree falls between cuspStart and cuspEnd
+        if (cuspStart < cuspEnd) {
+            // Normal case: e.g., Cusp1=10, Cusp2=40. Point is between 10 and 40.
+            if (pointDegree >= cuspStart && pointDegree < cuspEnd) {
+                return i + 1; // House number is i+1 (cusps are 0-indexed, houses 1-indexed)
+            }
+        }
+        else {
+            // Wrap-around case: e.g., Cusp12=330, Cusp1=20. Point is >=330 OR <20.
+            if (pointDegree >= cuspStart || pointDegree < cuspEnd) {
+                return i + 1; // House number is i+1
+            }
+        }
+    }
+    // console.warn(`Point ${pointDegree} did not fall into any house with cusps: ${houseCusps.join(', ')}.`);
+    return 0; // Should ideally not be reached if cusps correctly cover 360 degrees
+}
+/**
+ * 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.
+ * @returns An array of strings for the output.
+ */
+function generateHouseOverlaysOutput(chart1, chart2, settings) {
+    const output = ['[HOUSE OVERLAYS]'];
+    const c1Name = chart1.name || 'Chart 1';
+    const c2Name = chart2.name || 'Chart 2';
+    // 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 = getHouseForPoint(planet.degree, chart2.houseCusps);
+                if (houseNumber > 0) {
+                    output.push(`${planet.name}: House ${houseNumber}`);
+                }
+                else {
+                    output.push(`${planet.name}: (Could not determine house in ${c2Name})`);
+                }
+            });
+        }
+        else {
+            output.push('(No planets listed for overlay)');
+        }
+    }
+    else {
+        output.push(`${c1Name}'s planets in ${c2Name}'s houses: (${c2Name} 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 = getHouseForPoint(planet.degree, chart1.houseCusps);
+                if (houseNumber > 0) {
+                    output.push(`${planet.name}: House ${houseNumber}`);
+                }
+                else {
+                    output.push(`${planet.name}: (Could not determine house in ${c1Name})`);
+                }
+            });
+        }
+        else {
+            output.push('(No planets listed for overlay)');
+        }
+    }
+    else {
+        output.push(`${c2Name}'s planets in ${c1Name}'s houses: (${c1Name} house cusps not available)`);
+    }
+    return output;
+}

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

@@ -0,0 +1,9 @@
+import { ChartSettings } from '../../../config/ChartSettings';
+/**
+ * Generates the [METADATA] section of the chart output.
+ * @param settings The chart settings.
+ * @param chartType A string describing the type of chart (e.g., "natal", "synastry").
+ * @param houseSystemName Optional: The name of the house system used.
+ * @returns An array of strings, each representing a line in the output.
+ */
+export declare function generateMetadataOutput(settings: ChartSettings, chartType: string, houseSystemName?: string): string[];

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMetadataOutput = generateMetadataOutput;
+/**
+ * Generates the [METADATA] section of the chart output.
+ * @param settings The chart settings.
+ * @param chartType A string describing the type of chart (e.g., "natal", "synastry").
+ * @param houseSystemName Optional: The name of the house system used.
+ * @returns An array of strings, each representing a line in the output.
+ */
+function generateMetadataOutput(settings, chartType, houseSystemName) {
+    const output = ['[METADATA]', `chart_type: ${chartType}`];
+    if (houseSystemName) {
+        output.push(`house_system: ${houseSystemName}`);
+    }
+    output.push(`date_format: ${settings.dateFormat}`);
+    return output;
+}

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

@@ -0,0 +1,10 @@
+import { Point } from '../../../types';
+import { ChartSettings } from '../../../config/ChartSettings';
+/**
+ * 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 settings The chart settings.
+ * @returns An array of strings for the output.
+ */
+export declare function generatePlanetsOutput(planets: Point[], houseCusps: number[] | undefined, settings: ChartSettings): string[];

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

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePlanetsOutput = generatePlanetsOutput;
+const astrology_1 = require("../../../core/astrology");
+// Helper function to determine which house a point falls into
+// (Copied from houseOverlays.ts - consider moving to a shared util if used in more places)
+function getHouseForPoint(pointDegree, houseCusps) {
+    if (!houseCusps || houseCusps.length !== 12) {
+        return 0; // Indicate failure or inability to calculate
+    }
+    for (let i = 0; i < 12; i++) {
+        const cuspStart = houseCusps[i];
+        const cuspEnd = houseCusps[(i + 1) % 12];
+        if (cuspStart < cuspEnd) {
+            if (pointDegree >= cuspStart && pointDegree < cuspEnd) {
+                return i + 1;
+            }
+        }
+        else {
+            if (pointDegree >= cuspStart || pointDegree < cuspEnd) {
+                return i + 1;
+            }
+        }
+    }
+    return 0; // Should not be reached if cusps cover 360 degrees
+}
+/**
+ * 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 settings The chart settings.
+ * @returns An array of strings for the output.
+ */
+function generatePlanetsOutput(planets, houseCusps, settings) {
+    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 ? ' Rx' : '';
+        let line = `${planet.name}: ${degInSign}° ${sign}${retrogradeIndicator}`;
+        if (houseCusps && houseCusps.length === 12) {
+            const houseNumber = getHouseForPoint(planet.degree, houseCusps);
+            if (houseNumber > 0) {
+                line += `, House ${houseNumber}`;
+            }
+        }
+        output.push(line);
+    });
+    if (planets.length === 0) {
+        output.push('No planets listed.');
+    }
+    return output;
+}

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

@@ -0,0 +1,8 @@
+import { ChartData, MultiChartData, PartialSettings } 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.
+ * @returns A string representing the full chart report.
+ */
+export declare function formatChartToText(data: ChartData | MultiChartData, partialSettings?: PartialSettings): string;

package/dist/formatters/text/textFormatter.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatChartToText = formatChartToText;
+const ChartSettings_1 = require("../../config/ChartSettings");
+const aspects_1 = require("../../core/aspects");
+const metadata_1 = require("./sections/metadata");
+const chartHeader_1 = require("./sections/chartHeader");
+const birthdata_1 = require("./sections/birthdata");
+const angles_1 = require("./sections/angles");
+const planets_1 = require("./sections/planets");
+const aspects_2 = require("./sections/aspects");
+const houseOverlays_1 = require("./sections/houseOverlays");
+/**
+ * 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.
+ * @returns A string representing the full chart report.
+ */
+function formatChartToText(data, partialSettings = {}) {
+    const settings = new ChartSettings_1.ChartSettings(partialSettings);
+    const outputLines = [];
+    let baseChartType = 'natal';
+    let primaryHouseSystemName;
+    if ('chart1' in data) {
+        // Check if it's MultiChartData
+        const multiData = data;
+        primaryHouseSystemName = multiData.chart1.houseSystemName; // Use chart1's house system name for overall metadata
+        if (multiData.chart2 && multiData.transit)
+            baseChartType = 'synastry_with_transit';
+        else if (multiData.chart2)
+            baseChartType = 'synastry';
+        else if (multiData.transit)
+            baseChartType = 'natal_with_transit';
+    }
+    else {
+        // Single ChartData object
+        primaryHouseSystemName = data.houseSystemName;
+    }
+    outputLines.push(...(0, metadata_1.generateMetadataOutput)(settings, baseChartType, primaryHouseSystemName));
+    outputLines.push(''); // Blank line after metadata
+    const processSingleChartOutput = (chartData, chartTitlePrefix) => {
+        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, planets_1.generatePlanetsOutput)(chartData.planets, chartData.houseCusps, settings));
+        const aspects = (0, aspects_1.calculateAspects)(settings.aspectDefinitions, chartData.planets);
+        // For single chart, p1ChartName and p2ChartName are not needed for aspect string generation
+        outputLines.push(...(0, aspects_2.generateAspectsOutput)('[ASPECTS]', aspects, settings));
+        outputLines.push('');
+    };
+    const processTransitChartInfoOutput = (transitData) => {
+        outputLines.push(...(0, chartHeader_1.generateChartHeaderOutput)(transitData.name || 'Current', '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('');
+    };
+    if ('chart1' in data) {
+        // MultiChartData
+        const multiData = data;
+        const chart1 = multiData.chart1;
+        const chart1Name = chart1.name || 'Chart 1';
+        processSingleChartOutput(chart1);
+        if (multiData.chart2) {
+            const chart2 = multiData.chart2;
+            const chart2Name = chart2.name || 'Chart 2';
+            processSingleChartOutput(chart2);
+            // Synastry Section
+            outputLines.push(...(0, chartHeader_1.generateChartHeaderOutput)(`${chart1Name}-${chart2Name}`, 'SYNASTRY'));
+            const synastryAspects = (0, aspects_1.calculateMultichartAspects)(settings.aspectDefinitions, chart1.planets, chart2.planets);
+            outputLines.push(...(0, aspects_2.generateAspectsOutput)('[PLANET-PLANET ASPECTS]', synastryAspects, settings, chart1Name, chart2Name));
+            outputLines.push('');
+            outputLines.push(...(0, houseOverlays_1.generateHouseOverlaysOutput)(chart1, chart2, settings));
+            outputLines.push('');
+        }
+        if (multiData.transit) {
+            const transit = multiData.transit;
+            const transitName = transit.name || 'Current'; // Used for p2ChartName in transit aspects
+            processTransitChartInfoOutput(transit);
+            // Transit Aspects to Chart 1
+            const transitAspectsC1 = (0, aspects_1.calculateMultichartAspects)(settings.aspectDefinitions, chart1.planets, transit.planets);
+            outputLines.push(...(0, aspects_2.generateAspectsOutput)(`[TRANSIT ASPECTS: ${chart1Name}]`, transitAspectsC1, settings, chart1Name, transitName, true));
+            outputLines.push('');
+            if (multiData.chart2) {
+                const chart2Name = multiData.chart2.name || 'Chart 2';
+                // Transit Aspects to Chart 2
+                const transitAspectsC2 = (0, aspects_1.calculateMultichartAspects)(settings.aspectDefinitions, multiData.chart2.planets, transit.planets);
+                outputLines.push(...(0, aspects_2.generateAspectsOutput)(`[TRANSIT ASPECTS: ${chart2Name}]`, transitAspectsC2, settings, chart2Name, transitName, true));
+                outputLines.push('');
+            }
+        }
+    }
+    else {
+        // Single ChartData object
+        processSingleChartOutput(data);
+    }
+    return outputLines.join('\n').trimEnd();
+}

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 /**
  * chart2txt
- * A library to convert astrological chart data to human-readable text
+ * A library to convert astrological chart data to human-readable text.
+ *
+ * This is the main entry point for the library.
  */
-import type { Point, ChartData, Settings } from './types';
-/**
- * Main function to convert chart data to text
- */
-export declare function chart2txt(data: ChartData, settings?: Partial<Settings>): string;
-export { ChartData, Point, Settings };
-export default chart2txt;
+export { formatChartToText as chart2txt } from './formatters/text/textFormatter';
+export * from './types';
+export { DEFAULT_SETTINGS, DEFAULT_ASPECTS, DEFAULT_ASPECT_CATEGORIES, ZODIAC_SIGNS, } from './constants';
+export { ChartSettings } from './config/ChartSettings';
+import { formatChartToText } from './formatters/text/textFormatter';
+export default formatChartToText;

package/dist/index.js

@@ -1,163 +1,40 @@
 "use strict";
 /**
  * chart2txt
- * A library to convert astrological chart data to human-readable text
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.chart2txt = chart2txt;
-const constants_1 = require("./constants");
-/**
- * Determines the zodiac sign for a given degree
- */
-function getDegreeSign(degree) {
-    const signIndex = Math.floor(degree / 30) % 12;
-    return constants_1.ZODIAC_SIGNS[signIndex];
-}
-/**
- * Calculates the house for a given degree, based on the ascendant
- */
-function getHousePosition(houseSystem, pointDegree, ascendant) {
-    switch (houseSystem) {
-        case 'equal': {
-            // House 1 starts at the ascendant
-            const housePosition = (pointDegree - ascendant + 360) % 360;
-            const house = Math.floor(housePosition / 30) + 1;
-            const degree = housePosition % 30;
-            return { house, degree };
-        }
-        case 'whole_sign': {
-            // House 1 starts at beginning of ascendant sign
-            const house1SignCusp = (Math.floor(ascendant / 30) % 12) * 30;
-            // Computation proceeds same as equal, using sign cusp
-            const housePosition = (pointDegree - house1SignCusp + 360) % 360;
-            const house = Math.floor(housePosition / 30) + 1;
-            const degree = housePosition % 30;
-            return { house, degree };
-        }
-    }
-}
-/**
- * Identifies aspects between planets
- */
-function calculateAspects(aspectDefinitions, planets) {
-    const aspects = [];
-    // Compare each planet with every other planet
-    for (let i = 0; i < planets.length; i++) {
-        for (let j = i + 1; j < planets.length; j++) {
-            const planetA = planets[i];
-            const planetB = planets[j];
-            // Calculate the angular difference
-            let diff = Math.abs(planetA.degree - planetB.degree);
-            if (diff > 180)
-                diff = 360 - diff;
-            // Check against each aspect type
-            for (const aspectType of aspectDefinitions) {
-                const orb = Math.abs(diff - aspectType.angle);
-                if (orb <= aspectType.orb) {
-                    aspects.push({
-                        planetA: planetA.name,
-                        planetB: planetB.name,
-                        aspectType: aspectType.name,
-                        orb,
-                    });
-                    break; // Only record the strongest aspect between two planets
-                }
-            }
-        }
-    }
-    return aspects;
-}
-/**
- * Formats planet sign positions as text
- */
-function formatPlanetSigns(planets, ascendant, points = [], includeDegree = constants_1.DEFAULT_SETTINGS.includeSignDegree) {
-    const ascPoint = ascendant
-        ? [{ name: 'Ascendant', degree: ascendant }]
-        : [];
-    const output = [...ascPoint, ...planets, ...points]
-        .map((planet) => {
-        const sign = getDegreeSign(planet.degree);
-        if (includeDegree) {
-            const degree = Math.floor(planet.degree % 30);
-            return `${planet.name} is at ${degree}° ${sign}`;
-        }
-        else {
-            return `${planet.name} is in ${sign}`;
-        }
-    })
-        .join('. ');
-    return output ? `${output}.` : '';
-}
-/**
- * Formats planet house positions as text
- */
-function formatPlanetHouses(houseSystem, ascendant, planets, points = [], includeDegree = constants_1.DEFAULT_SETTINGS.includeHouseDegree) {
-    // TODO: house systems
-    const output = [...planets, ...points]
-        .map((planet) => {
-        const houseData = getHousePosition(houseSystem, planet.degree, ascendant);
-        if (includeDegree) {
-            return `${planet.name} is at ${houseData.degree}° in house ${houseData.house}`;
-        }
-        else {
-            return `${planet.name} is in house ${houseData.house}`;
-        }
-    })
-        .join('. ');
-    return output ? `${output}.` : '';
-}
-/**
- * Formats aspects between planets as text
- */
-function formatAspects(aspects) {
-    const output = aspects
-        .map((aspect) => {
-        return `${aspect.planetA} is in ${aspect.aspectType} with ${aspect.planetB} (orb: ${aspect.orb.toFixed(1)}°)`;
-    })
-        .join('. ');
-    return output ? `${output}.` : '';
-}
-/**
- * Formats provided location and time, if present, as text
- */
-function formatLocationAndDate(location, timestamp) {
-    const locationString = location ? `location: ${location}` : '';
-    const timestampString = timestamp ? `at: ${timestamp.toLocaleString()}` : '';
-    return [locationString, timestampString].filter((s) => s !== '').join(', ');
-}
-/**
- * Main function to convert chart data to text
- */
-function chart2txt(data, settings = {}) {
-    // override default settings with any provided settings data
-    const fullSettings = Object.assign({}, constants_1.DEFAULT_SETTINGS, settings);
-    // format header
-    let result = 'Astrology Chart';
-    const locationAndDate = formatLocationAndDate(data.location, data.timestamp);
-    if (locationAndDate) {
-        result += ` (${locationAndDate})`;
-    }
-    result += ':\n\n';
-    // format planets
-    if (!fullSettings.omitSigns) {
-        result += formatPlanetSigns(data.planets, fullSettings.includeAscendant && data.ascendant
-            ? data.ascendant
-            : undefined, fullSettings.omitPoints ? [] : data.points, fullSettings.includeSignDegree);
+ * A library to convert astrological chart data to human-readable text.
+ *
+ * This is the main entry point for the library.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
     }
-    // format houses
-    if (!fullSettings.omitHouses && data.ascendant !== undefined) {
-        result +=
-            '\n\n' +
-                formatPlanetHouses(fullSettings.houseSystem, data.ascendant, data.planets, fullSettings.omitPoints ? [] : data.points, fullSettings.includeHouseDegree);
-    }
-    // format aspects
-    if (!fullSettings.omitAspects) {
-        const aspects = calculateAspects(fullSettings.aspectDefinitions, data.planets);
-        if (aspects.length > 0) {
-            result += '\n\n' + formatAspects(aspects);
-        }
-    }
-    return result;
-}
-// Default export for browser usage
-exports.default = chart2txt;
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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
+var textFormatter_1 = require("./formatters/text/textFormatter");
+Object.defineProperty(exports, "chart2txt", { enumerable: true, get: function () { return textFormatter_1.formatChartToText; } });
+// 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;

package/dist/types.d.ts

@@ -1,14 +1,25 @@
 export interface Point {
     name: string;
     degree: number;
+    speed?: number;
 }
 export interface ChartData {
+    name?: string;
     planets: Point[];
     ascendant?: number;
+    midheaven?: number;
     points?: Point[];
+    houseCusps?: number[];
+    houseSystemName?: string;
     timestamp?: Date;
     location?: string;
 }
+export interface MultiChartData {
+    chart1: ChartData;
+    chart2?: ChartData;
+    transit?: ChartData;
+}
+export declare function isMultiChartData(obj: ChartData | MultiChartData): obj is MultiChartData;
 export interface Aspect {
     name: string;
     angle: number;
@@ -20,15 +31,17 @@ export interface AspectData {
     aspectType: string;
     orb: number;
 }
-export type HouseSystem = 'whole_sign' | 'equal';
+export interface AspectCategory {
+    name: string;
+    minOrb?: number;
+    maxOrb: number;
+}
 export interface Settings {
     includeSignDegree: boolean;
-    omitSigns: boolean;
     includeAscendant: boolean;
-    omitPoints: boolean;
     includeHouseDegree: boolean;
-    houseSystem: HouseSystem;
-    omitHouses: boolean;
     aspectDefinitions: Aspect[];
-    omitAspects: boolean;
+    aspectCategories: AspectCategory[];
+    dateFormat: string;
 }
+export type PartialSettings = Partial<Settings>;

package/dist/types.js

@@ -1,2 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMultiChartData = isMultiChartData;
+function isMultiChartData(obj) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return obj.chart1 !== undefined;
+}

package/dist/utils/datetime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Formats a Date object into a string based on the specified format.
+ * @param date The Date object to format.
+ * @param format The target format string (e.g., "MM/DD/YYYY").
+ * @returns The formatted date string.
+ */
+export declare function formatDateCustom(date: Date, format: string): string;
+/**
+ * Formats the time part of a Date object.
+ * @param date The Date object.
+ * @returns The formatted time string (e.g., "09:28:00 AM").
+ */
+export declare function formatTime(date: Date): string;

package/dist/utils/datetime.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDateCustom = formatDateCustom;
+exports.formatTime = formatTime;
+/**
+ * Formats a Date object into a string based on the specified format.
+ * @param date The Date object to format.
+ * @param format The target format string (e.g., "MM/DD/YYYY").
+ * @returns The formatted date string.
+ */
+function formatDateCustom(date, format) {
+    const m = date.getMonth() + 1;
+    const d = date.getDate();
+    const y = date.getFullYear();
+    switch (format.toUpperCase()) {
+        case 'MM/DD/YYYY':
+            return `${m.toString().padStart(2, '0')}/${d
+                .toString()
+                .padStart(2, '0')}/${y}`;
+        case 'DD/MM/YYYY':
+            return `${d.toString().padStart(2, '0')}/${m
+                .toString()
+                .padStart(2, '0')}/${y}`;
+        case 'YYYY-MM-DD':
+            return `${y}-${m.toString().padStart(2, '0')}-${d
+                .toString()
+                .padStart(2, '0')}`;
+        default:
+            // Fallback to a common locale string if format is unrecognized
+            console.warn(`Unrecognized date format: ${format}. Falling back to toLocaleDateString().`);
+            return date.toLocaleDateString();
+    }
+}
+/**
+ * Formats the time part of a Date object.
+ * @param date The Date object.
+ * @returns The formatted time string (e.g., "09:28:00 AM").
+ */
+function formatTime(date) {
+    return date.toLocaleTimeString('en-US', {
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: true,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chart2txt",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Convert astrological chart data to human-readable text",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",