pigeongov 0.2.0

package/dist/src/engine/multiyear/import.js

@@ -0,0 +1,193 @@
+// ---------------------------------------------------------------------------
+// Prior-Year Return Import
+// ---------------------------------------------------------------------------
+// Import data from a previous year's return bundle to pre-fill the
+// current year. The goal: minimize re-entry of stable information
+// (identity, address, dependents, bank accounts) while flagging
+// anything that likely needs updating.
+//
+// This is the "are these still correct?" module — because life changes
+// but your SSN doesn't.
+// ---------------------------------------------------------------------------
+/**
+ * Fields that are stable year-over-year and safe to import directly.
+ */
+const IMPORTABLE_IDENTITY_FIELDS = [
+    "firstName",
+    "lastName",
+    "ssn",
+    "dateOfBirth",
+];
+const IMPORTABLE_ADDRESS_FIELDS = [
+    "street1",
+    "street2",
+    "city",
+    "state",
+    "zipCode",
+];
+/**
+ * Fields that should NOT be imported because they're year-specific.
+ */
+const SKIP_FIELDS = new Set([
+    "federalWithheld",
+    "estimatedPayments",
+    "wages",
+    "taxableInterest",
+    "ordinaryDividends",
+    "scheduleCNet",
+    "otherIncome",
+    "refund",
+    "amountOwed",
+    "totalTax",
+    "totalPayments",
+    "calculation",
+    "validation",
+    "review",
+    "outputArtifacts",
+    "provenance",
+    "filledForm",
+]);
+function safeGet(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+function safeSet(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current) || typeof current[part] !== "object" || current[part] === null) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    const lastPart = parts[parts.length - 1];
+    current[lastPart] = value;
+}
+/**
+ * Import stable data from a previous year's return bundle.
+ *
+ * Imports:
+ * - Identity (name, SSN, DOB)
+ * - Address (with a note to verify — people move)
+ * - Dependents (with count verification prompt)
+ * - Filing status (as a suggestion, not a lock)
+ * - Recurring income source labels (not amounts)
+ * - Bank account info for direct deposit
+ *
+ * Skips:
+ * - All dollar amounts (income, withholding, payments, results)
+ * - Calculation results, validation, review summaries
+ * - Year-specific artifacts
+ */
+export function importFromPreviousYear(previousBundle) {
+    const prefilled = {};
+    const fieldsImported = [];
+    const fieldsSkipped = [];
+    const notes = [];
+    // --- Identity ---
+    const applicant = safeGet(previousBundle, "applicant");
+    if (applicant && typeof applicant === "object") {
+        const importedApplicant = {};
+        for (const field of IMPORTABLE_IDENTITY_FIELDS) {
+            const value = applicant[field];
+            if (value !== undefined && value !== null) {
+                importedApplicant[field] = value;
+                fieldsImported.push(`applicant.${field}`);
+            }
+        }
+        // Import address with verification note
+        const address = applicant["address"];
+        if (address && typeof address === "object") {
+            const importedAddress = {};
+            for (const field of IMPORTABLE_ADDRESS_FIELDS) {
+                const value = address[field];
+                if (value !== undefined && value !== null) {
+                    importedAddress[field] = value;
+                    fieldsImported.push(`applicant.address.${field}`);
+                }
+            }
+            importedApplicant["address"] = importedAddress;
+            notes.push("Address imported from last year. Has your address changed?");
+        }
+        prefilled["applicant"] = importedApplicant;
+    }
+    // --- Filing status ---
+    const filingStatus = safeGet(previousBundle, "filingStatus") ??
+        safeGet(previousBundle, "answers.filingStatus");
+    if (filingStatus !== undefined) {
+        prefilled["filingStatus"] = filingStatus;
+        fieldsImported.push("filingStatus");
+        notes.push(`Last year you filed as "${String(filingStatus)}". Has your filing status changed?`);
+    }
+    // --- Dependents ---
+    const dependents = safeGet(previousBundle, "dependents") ??
+        safeGet(previousBundle, "answers.dependents") ??
+        safeGet(previousBundle, "household");
+    if (Array.isArray(dependents)) {
+        prefilled["dependents"] = dependents;
+        fieldsImported.push("dependents");
+        notes.push(`Last year you had ${dependents.length} dependent(s). Still correct?`);
+    }
+    // --- Bank account info (for direct deposit) ---
+    const bankAccount = safeGet(previousBundle, "bankAccount") ??
+        safeGet(previousBundle, "answers.bankAccount");
+    if (bankAccount !== undefined && bankAccount !== null) {
+        prefilled["bankAccount"] = bankAccount;
+        fieldsImported.push("bankAccount");
+        notes.push("Bank account for direct deposit imported. Please verify.");
+    }
+    // --- Recurring income source labels (not amounts) ---
+    const answers = previousBundle["answers"];
+    if (answers && typeof answers === "object") {
+        const incomeSourceLabels = [];
+        // Check for W-2 employers
+        const w2s = answers["w2Documents"] ?? answers["w2s"];
+        if (Array.isArray(w2s)) {
+            for (const w2 of w2s) {
+                if (typeof w2 === "object" && w2 !== null) {
+                    const employer = w2["employerName"];
+                    if (typeof employer === "string") {
+                        incomeSourceLabels.push(`W-2: ${employer}`);
+                    }
+                }
+            }
+        }
+        // Check for 1099 sources
+        const docs1099 = answers["form1099s"] ?? answers["documents"];
+        if (Array.isArray(docs1099)) {
+            for (const doc of docs1099) {
+                if (typeof doc === "object" && doc !== null) {
+                    const payer = doc["payerName"];
+                    const docType = doc["type"];
+                    if (typeof payer === "string") {
+                        incomeSourceLabels.push(`${typeof docType === "string" ? docType.toUpperCase() : "1099"}: ${payer}`);
+                    }
+                }
+            }
+        }
+        if (incomeSourceLabels.length > 0) {
+            prefilled["priorIncomeSources"] = incomeSourceLabels;
+            fieldsImported.push("priorIncomeSources");
+            notes.push(`Found ${incomeSourceLabels.length} income source(s) from last year. ` +
+                "Do you still have these same sources?");
+        }
+    }
+    // --- Track skipped fields ---
+    for (const key of Object.keys(previousBundle)) {
+        if (SKIP_FIELDS.has(key) || key in prefilled) {
+            if (SKIP_FIELDS.has(key)) {
+                fieldsSkipped.push(key);
+            }
+        }
+    }
+    return { prefilled, fieldsImported, fieldsSkipped, notes };
+}
+//# sourceMappingURL=import.js.map

package/dist/src/engine/multiyear/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../../src/engine/multiyear/import.ts"],"names":[],"mappings":"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"}

package/dist/src/engine/optimizer/filing-status.d.ts

@@ -0,0 +1,29 @@
+import type { FilingStatus } from "../../types.js";
+export interface FilingStatusComparison {
+    statuses: FilingStatusResult[];
+    recommended: FilingStatus;
+    savings: number;
+    explanation: string;
+}
+export interface FilingStatusResult {
+    filingStatus: FilingStatus;
+    totalTax: number;
+    effectiveRate: number;
+    refund: number;
+    amountOwed: number;
+    creditLimitations: string[];
+}
+/**
+ * Compare MFJ vs MFS for married taxpayers.
+ * Shows the actual dollar difference and credits lost under MFS.
+ */
+export declare function compareFilingStatuses(baseInput: Record<string, unknown>, statusesToCompare?: FilingStatus[]): FilingStatusComparison;
+/**
+ * Quick check: should a married couple file jointly or separately?
+ * Returns a simple recommendation with reasoning.
+ */
+export declare function recommendFilingStatus(baseInput: Record<string, unknown>): {
+    recommendation: FilingStatus;
+    reason: string;
+    savings: number;
+};

package/dist/src/engine/optimizer/filing-status.js

@@ -0,0 +1,66 @@
+import { calculateFederalTax } from "../tax-calculator.js";
+const FILING_STATUS_DISPLAY = {
+    single: "Single",
+    married_filing_jointly: "Married Filing Jointly",
+    married_filing_separately: "Married Filing Separately",
+    head_of_household: "Head of Household",
+    qualifying_surviving_spouse: "Qualifying Surviving Spouse",
+};
+/**
+ * Compare MFJ vs MFS for married taxpayers.
+ * Shows the actual dollar difference and credits lost under MFS.
+ */
+export function compareFilingStatuses(baseInput, statusesToCompare) {
+    const statuses = statusesToCompare ?? [
+        "married_filing_jointly",
+        "married_filing_separately",
+    ];
+    const results = [];
+    for (const status of statuses) {
+        const modifiedInput = { ...baseInput, filingStatus: status };
+        const result = calculateFederalTax(modifiedInput);
+        const creditLimitations = [];
+        if (status === "married_filing_separately") {
+            creditLimitations.push("EITC not available when filing separately");
+            creditLimitations.push("Education credits may be reduced or eliminated");
+            creditLimitations.push("Child and Dependent Care Credit may be limited");
+            creditLimitations.push("Student loan interest deduction not available");
+            creditLimitations.push("Standard deduction is half of MFJ amount");
+        }
+        results.push({
+            filingStatus: status,
+            totalTax: result.totalTax,
+            effectiveRate: result.effectiveRate,
+            refund: result.refund,
+            amountOwed: result.amountOwed,
+            creditLimitations,
+        });
+    }
+    // Find the best (lowest tax) option
+    const sorted = [...results].sort((a, b) => a.totalTax - b.totalTax);
+    const best = sorted[0];
+    const worst = sorted[sorted.length - 1];
+    const savings = Number((worst.totalTax - best.totalTax).toFixed(2));
+    const explanation = savings > 0
+        ? `${FILING_STATUS_DISPLAY[best.filingStatus]} saves $${savings.toLocaleString()} compared to ${FILING_STATUS_DISPLAY[worst.filingStatus]}.`
+        : `Both filing statuses result in the same tax liability.`;
+    return {
+        statuses: results,
+        recommended: best.filingStatus,
+        savings,
+        explanation,
+    };
+}
+/**
+ * Quick check: should a married couple file jointly or separately?
+ * Returns a simple recommendation with reasoning.
+ */
+export function recommendFilingStatus(baseInput) {
+    const comparison = compareFilingStatuses(baseInput);
+    return {
+        recommendation: comparison.recommended,
+        reason: comparison.explanation,
+        savings: comparison.savings,
+    };
+}
+//# sourceMappingURL=filing-status.js.map

package/dist/src/engine/optimizer/filing-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filing-status.js","sourceRoot":"","sources":["../../../../src/engine/optimizer/filing-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAoB3D,MAAM,qBAAqB,GAAiC;IAC1D,MAAM,EAAE,QAAQ;IAChB,sBAAsB,EAAE,wBAAwB;IAChD,yBAAyB,EAAE,2BAA2B;IACtD,iBAAiB,EAAE,mBAAmB;IACtC,2BAA2B,EAAE,6BAA6B;CAC3D,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAkC,EAClC,iBAAkC;IAElC,MAAM,QAAQ,GAAG,iBAAiB,IAAI;QACpC,wBAAwB;QACxB,2BAA2B;KAC5B,CAAC;IAEF,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,aAAa,GAAG,EAAE,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,mBAAmB,CAAC,aAAqE,CAAC,CAAC;QAE1G,MAAM,iBAAiB,GAAa,EAAE,CAAC;QACvC,IAAI,MAAM,KAAK,2BAA2B,EAAE,CAAC;YAC3C,iBAAiB,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YACpE,iBAAiB,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YACzE,iBAAiB,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YACzE,iBAAiB,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YACxE,iBAAiB,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,YAAY,EAAE,MAAM;YACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,iBAAiB;SAClB,CAAC,CAAC;IACL,CAAC;IAED,oCAAoC;IACpC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpE,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC;QAC7B,CAAC,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,OAAO,CAAC,cAAc,EAAE,gBAAgB,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG;QAC5I,CAAC,CAAC,wDAAwD,CAAC;IAE7D,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,IAAI,CAAC,YAAY;QAC9B,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAkC;IAElC,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO;QACL,cAAc,EAAE,UAAU,CAAC,WAAW;QACtC,MAAM,EAAE,UAAU,CAAC,WAAW;QAC9B,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC"}

package/dist/src/engine/orchestrator.d.ts

@@ -0,0 +1,14 @@
+import type { FormPlugin, OrchestratorResult, TaxOrchestratorInput } from "./types.js";
+export declare class TaxOrchestrator {
+    private plugins;
+    /** Register a form plugin. Overwrites any existing plugin with the same formId. */
+    register(plugin: FormPlugin): void;
+    /** Unregister a plugin by formId. Returns true if it existed. */
+    unregister(formId: string): boolean;
+    /** List all registered plugin IDs. */
+    registeredPlugins(): string[];
+    /** Execute the full orchestration pipeline for the given input. */
+    execute(input: TaxOrchestratorInput): OrchestratorResult;
+    private topologicalSort;
+}
+export declare const defaultOrchestrator: TaxOrchestrator;

package/dist/src/engine/orchestrator.js

@@ -0,0 +1,135 @@
+// ---------------------------------------------------------------------------
+// Tax Orchestrator
+//
+// Manages a registry of FormPlugin instances, determines which are triggered
+// for a given input, resolves their dependency order via topological sort,
+// and executes them in sequence — collecting results, validation checks, and
+// merged form-line mappings along the way.
+// ---------------------------------------------------------------------------
+export class TaxOrchestrator {
+    plugins = new Map();
+    /** Register a form plugin. Overwrites any existing plugin with the same formId. */
+    register(plugin) {
+        this.plugins.set(plugin.formId, plugin);
+    }
+    /** Unregister a plugin by formId. Returns true if it existed. */
+    unregister(formId) {
+        return this.plugins.delete(formId);
+    }
+    /** List all registered plugin IDs. */
+    registeredPlugins() {
+        return [...this.plugins.keys()];
+    }
+    /** Execute the full orchestration pipeline for the given input. */
+    execute(input) {
+        // 1. The core-1040 plugin must be registered — it is the root of every return.
+        const corePlugin = this.plugins.get("core-1040");
+        if (!corePlugin) {
+            throw new Error("TaxOrchestrator: 'core-1040' plugin is not registered. " +
+                "Register it before calling execute().");
+        }
+        // 2. Determine which plugins are triggered.
+        const triggeredIds = [];
+        for (const [id, plugin] of this.plugins) {
+            if (plugin.triggerCondition(input)) {
+                triggeredIds.push(id);
+            }
+        }
+        // 3. Topologically sort triggered plugins by their dependencies.
+        const sortedIds = this.topologicalSort(triggeredIds);
+        // 4. Execute each plugin in dependency order.
+        const intermediateResults = new Map();
+        const allValidationChecks = [];
+        const formLinesMerged = {};
+        let coreResult = undefined;
+        for (const id of sortedIds) {
+            const plugin = this.plugins.get(id);
+            const result = plugin.calculate(input, intermediateResults);
+            intermediateResults.set(id, result);
+            if (id === "core-1040") {
+                coreResult = result;
+            }
+            // Collect validation checks.
+            const checks = plugin.validate(result, input);
+            allValidationChecks.push(...checks);
+            // Merge form lines.
+            const lines = plugin.mapToFormLines(result);
+            for (const [key, value] of Object.entries(lines)) {
+                formLinesMerged[key] = value;
+            }
+        }
+        return {
+            coreResult,
+            formResults: intermediateResults,
+            allValidationChecks,
+            triggeredForms: sortedIds,
+            formLinesMerged,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Topological sort via Kahn's algorithm.
+    //
+    // Only considers plugins that are in the `pluginIds` set. If a dependency
+    // is listed but not triggered (and not in the set), it is ignored — this
+    // lets optional upstream plugins stay out of the graph when not needed.
+    // -------------------------------------------------------------------------
+    topologicalSort(pluginIds) {
+        const idSet = new Set(pluginIds);
+        // Build adjacency list and in-degree map for the triggered subset.
+        const inDegree = new Map();
+        const dependents = new Map(); // dependency -> [plugins that depend on it]
+        for (const id of idSet) {
+            if (!inDegree.has(id)) {
+                inDegree.set(id, 0);
+            }
+            if (!dependents.has(id)) {
+                dependents.set(id, []);
+            }
+            const plugin = this.plugins.get(id);
+            if (!plugin) {
+                throw new Error(`TaxOrchestrator: plugin '${id}' is triggered but not registered.`);
+            }
+            for (const dep of plugin.dependencies) {
+                if (!idSet.has(dep)) {
+                    // Dependency not triggered — skip it (the plugin will receive
+                    // no intermediate result for that dep, which is fine if it's optional).
+                    continue;
+                }
+                inDegree.set(id, (inDegree.get(id) ?? 0) + 1);
+                if (!dependents.has(dep)) {
+                    dependents.set(dep, []);
+                }
+                dependents.get(dep).push(id);
+            }
+        }
+        // Seed queue with zero-in-degree nodes.
+        const queue = [];
+        for (const [id, degree] of inDegree) {
+            if (degree === 0) {
+                queue.push(id);
+            }
+        }
+        const sorted = [];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            sorted.push(current);
+            for (const dependent of dependents.get(current) ?? []) {
+                const newDegree = (inDegree.get(dependent) ?? 1) - 1;
+                inDegree.set(dependent, newDegree);
+                if (newDegree === 0) {
+                    queue.push(dependent);
+                }
+            }
+        }
+        if (sorted.length !== idSet.size) {
+            const remaining = [...idSet].filter((id) => !sorted.includes(id));
+            throw new Error(`TaxOrchestrator: dependency cycle detected among plugins: ${remaining.join(", ")}`);
+        }
+        return sorted;
+    }
+}
+// ---------------------------------------------------------------------------
+// Default singleton orchestrator — plugins register themselves on import.
+// ---------------------------------------------------------------------------
+export const defaultOrchestrator = new TaxOrchestrator();
+//# sourceMappingURL=orchestrator.js.map

package/dist/src/engine/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/engine/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/src/engine/scenarios/whatif.d.ts

@@ -0,0 +1,34 @@
+import type { TaxCalculationResult } from "../tax-calculator.js";
+export interface WhatIfScenario {
+    label: string;
+    modifications: Record<string, unknown>;
+}
+export interface WhatIfComparison {
+    baseCase: ScenarioResult;
+    scenarios: ScenarioResult[];
+    bestScenario: string;
+    maxSavings: number;
+}
+export interface ScenarioResult {
+    label: string;
+    federalTax: number;
+    effectiveRate: number;
+    refund: number;
+    amountOwed: number;
+    deltaFromBase: number;
+    deltaLabel: string;
+}
+/**
+ * Compare multiple tax scenarios against a base case.
+ * Each scenario modifies one or more fields of the base input.
+ */
+export declare function compareScenarios(baseInput: Record<string, unknown>, scenarios: WhatIfScenario[]): WhatIfComparison;
+/**
+ * Quick scenario: "What if I contribute $X more to retirement?"
+ */
+export declare function whatIfRetirementContribution(baseInput: Record<string, unknown>, additionalContribution: number): WhatIfComparison;
+/**
+ * Quick scenario: "What if I earn $X more?"
+ */
+export declare function whatIfAdditionalIncome(baseInput: Record<string, unknown>, additionalIncome: number): WhatIfComparison;
+export type { TaxCalculationResult };

package/dist/src/engine/scenarios/whatif.js

@@ -0,0 +1,70 @@
+import { calculateFederalTax } from "../tax-calculator.js";
+/**
+ * Compare multiple tax scenarios against a base case.
+ * Each scenario modifies one or more fields of the base input.
+ */
+export function compareScenarios(baseInput, scenarios) {
+    const baseResult = calculateFederalTax(baseInput);
+    const baseSummary = summarizeResult("Base case", baseResult, 0);
+    const scenarioResults = [];
+    for (const scenario of scenarios) {
+        const modifiedInput = { ...baseInput, ...scenario.modifications };
+        // Deep merge adjustments if present
+        if (scenario.modifications.adjustments && baseInput.adjustments) {
+            modifiedInput.adjustments = {
+                ...baseInput.adjustments,
+                ...scenario.modifications.adjustments,
+            };
+        }
+        const result = calculateFederalTax(modifiedInput);
+        const delta = result.totalTax - baseResult.totalTax;
+        scenarioResults.push(summarizeResult(scenario.label, result, delta));
+    }
+    const bestScenario = scenarioResults.reduce((best, current) => current.deltaFromBase < best.deltaFromBase ? current : best, scenarioResults[0]);
+    return {
+        baseCase: baseSummary,
+        scenarios: scenarioResults,
+        bestScenario: bestScenario.label,
+        maxSavings: Math.abs(Math.min(0, bestScenario.deltaFromBase)),
+    };
+}
+function summarizeResult(label, result, delta) {
+    return {
+        label,
+        federalTax: result.totalTax,
+        effectiveRate: result.effectiveRate,
+        refund: result.refund,
+        amountOwed: result.amountOwed,
+        deltaFromBase: Number(delta.toFixed(2)),
+        deltaLabel: delta === 0 ? "no change" : delta > 0 ? `+$${delta.toFixed(2)} more tax` : `-$${Math.abs(delta).toFixed(2)} less tax`,
+    };
+}
+/**
+ * Quick scenario: "What if I contribute $X more to retirement?"
+ */
+export function whatIfRetirementContribution(baseInput, additionalContribution) {
+    return compareScenarios(baseInput, [
+        {
+            label: `Additional $${additionalContribution.toLocaleString()} retirement contribution`,
+            modifications: {
+                adjustments: {
+                    iraDeduction: (baseInput.adjustments?.iraDeduction ?? 0) + additionalContribution,
+                },
+            },
+        },
+    ]);
+}
+/**
+ * Quick scenario: "What if I earn $X more?"
+ */
+export function whatIfAdditionalIncome(baseInput, additionalIncome) {
+    return compareScenarios(baseInput, [
+        {
+            label: `Additional $${additionalIncome.toLocaleString()} income`,
+            modifications: {
+                wages: (baseInput.wages ?? 0) + additionalIncome,
+            },
+        },
+    ]);
+}
+//# sourceMappingURL=whatif.js.map

package/dist/src/engine/scenarios/whatif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatif.js","sourceRoot":"","sources":["../../../../src/engine/scenarios/whatif.ts"],"names":[],"mappings":"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"}

package/dist/src/engine/state/ca/calculator.d.ts

@@ -0,0 +1,3 @@
+import type { StateTaxPlugin, StateTaxConstants } from "../types.js";
+export declare const CA_CONSTANTS: StateTaxConstants;
+export declare const californiaTaxPlugin: StateTaxPlugin;