@paro.io/expert-shared-components 1.14.70 → 1.14.71

package/lib/tax-axis/components/processing/TaxAxisProcessing.js

@@ -31,21 +31,8 @@ const CRAWL_TICK_MS = 300; // interval between crawl ticks
 const CRAWL_STEP = 0.27; // % added each tick → 0.27 / 0.3s = 0.9%/s
 const FINISH_MS = 400; // ms to animate from 99% → 100% once ready
 const STAGE_ADVANCE_MS = 3200; // how often the displayed stage advances
-function buildStages(profile, mode) {
+function buildStages(profile) {
     var _a;
-    const entity = (profile === null || profile === void 0 ? void 0 : profile.entity) || "your business";
-    const stateCount = ((_a = profile === null || profile === void 0 ? void 0 : profile.states) === null || _a === void 0 ? void 0 : _a.length) || 1;
-    const bizName = (profile === null || profile === void 0 ? void 0 : profile.bizName) || "your business";
-    if (mode === 'prospect') {
-        return [
-            `Classifying ${entity} profile`,
-            "Injecting IRS 2026 + OBBBA parameters",
-            `Screening 25 strategies across ${stateCount} state${stateCount > 1 ? "s" : ""}`,
-            "Computing deterministic tax math",
-            "Generating strategy narratives",
-            `Assembling prospect report for ${bizName}`,
-        ];
-    }
     if (!profile) {
         return [
             "Parsing source documents",
@@ -55,6 +42,9 @@ function buildStages(profile, mode) {
             "Generating IRS citations",
         ];
     }
+    const entity = profile.entity || "your business";
+    const stateCount = ((_a = profile.states) === null || _a === void 0 ? void 0 : _a.length) || 1;
+    const bizName = profile.bizName || "your business";
     const base = [
         "Parsing source documents",
         "Injecting IRS 2026 parameters",
@@ -70,16 +60,10 @@ function buildStages(profile, mode) {
     base.push("Screening 30 eligible strategies", "Computing deterministic tax math", "Cross-validating source documents", "Generating IRS citations", `Assembling TaxAxis report for ${bizName}`);
     return base;
 }
-function TaxAxisProcessing({ onComplete, profile, reportReady = false, crawlStep, mode, userContext: _userContext = "expert", }) {
-    const stages = (0, react_1.useMemo)(() => buildStages(profile, mode), [profile, mode]);
+function TaxAxisProcessing({ onComplete, profile, reportReady = false, userContext: _userContext = "expert", }) {
+    const stages = (0, react_1.useMemo)(() => buildStages(profile), [profile]);
     const [progress, setProgress] = (0, react_1.useState)(0);
     const [stageIdx, setStageIdx] = (0, react_1.useState)(0);
-    const effectiveCrawlStep = crawlStep !== null && crawlStep !== void 0 ? crawlStep : CRAWL_STEP;
-    // Stable refs so effects don't restart when props change after mount
-    const crawlStepRef = (0, react_1.useRef)(effectiveCrawlStep);
-    const onCompleteRef = (0, react_1.useRef)(onComplete);
-    (0, react_1.useEffect)(() => { crawlStepRef.current = effectiveCrawlStep; }, [effectiveCrawlStep]);
-    (0, react_1.useEffect)(() => { onCompleteRef.current = onComplete; }, [onComplete]);
     const finishingRef = (0, react_1.useRef)(false);
     const completedRef = (0, react_1.useRef)(false);
     // Track current progress in a ref so the finish animation can read it synchronously
@@ -113,7 +97,7 @@ function TaxAxisProcessing({ onComplete, profile, reportReady = false, crawlStep
         progressRef.current = v;
         setProgress(v);
     };
-    // ── Crawl: 0 → 99% — runs once on mount, reads crawlStepRef so prop changes don't restart it ──
+    // ── Crawl: 0 → 80% — skipped entirely if reportReady already true on mount ──
     (0, react_1.useEffect)(() => {
         if (reportReady || finishingRef.current)
             return;
@@ -122,14 +106,14 @@ function TaxAxisProcessing({ onComplete, profile, reportReady = false, crawlStep
                 clearInterval(iv);
                 return;
             }
-            const next = Math.min(progressRef.current + crawlStepRef.current, CRAWL_CEILING);
+            const next = Math.min(progressRef.current + CRAWL_STEP, CRAWL_CEILING);
             setProgressSync(next);
             if (next >= CRAWL_CEILING)
                 clearInterval(iv);
         }, CRAWL_TICK_MS);
         return () => clearInterval(iv);
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
+        // reportReady intentionally in deps: if it arrives before mount effect runs, skip crawl
+    }, [reportReady]);
     // ── Stage labels: advance every STAGE_ADVANCE_MS ─────────────────
     (0, react_1.useEffect)(() => {
         const iv = setInterval(() => {
@@ -158,7 +142,7 @@ function TaxAxisProcessing({ onComplete, profile, reportReady = false, crawlStep
                 setProgressSync(100);
                 if (!completedRef.current) {
                     completedRef.current = true;
-                    setTimeout(() => onCompleteRef.current(), 150);
+                    setTimeout(onComplete, 150);
                 }
             }
         };

package/lib/tax-axis/components/prospectReport/ProspectNextSteps.js

@@ -25,9 +25,7 @@ function ProspectNextSteps({ sectionNum, bizName, onUpgrade, onPresent, onPrint,
                         bizName,
                         "'s documents to run the full TaxAxis analysis \u2014 computed savings with calculation traces, IRS citations, and a client-ready report."),
                     react_1.default.createElement("div", { style: { display: "flex", gap: 10, flexWrap: "wrap" } },
-                        react_1.default.createElement(GlowBtn, { onClick: () => { if (onUpgrade) {
-                                onUpgrade();
-                            } } }, "Upload Documents"),
+                        react_1.default.createElement(GlowBtn, { onClick: onUpgrade }, "Upload Documents"),
                         react_1.default.createElement(GlowBtn, { onClick: onPresent, style: { fontSize: 13 } }, "Present to Client"),
                         react_1.default.createElement(GlowBtn, { secondary: true, onClick: onPrint, style: { fontSize: 13 } }, "Download PDF")),
                     react_1.default.createElement("div", { style: { fontSize: 11, color: theme_1.T.text4, marginTop: 12, fontFamily: theme_1.T.body } }, "Typical turnaround: same day. No obligation until you review the results.")))),

package/lib/tax-axis/components/prospectReport/ProspectStrategyCard.d.ts

@@ -1,16 +1,10 @@
 import React from "react";
 import type { Strategy, ClientProfile, ComputedMap } from "../../lib/types";
-export interface LlmStrategyNarrative {
-    whyItMatters: string;
-    whatWeDo: string;
-}
 interface ProspectStrategyCardProps {
     strategy: Strategy;
     index: number;
     profile: ClientProfile;
     computed: ComputedMap;
-    /** LLM-generated narrative — when present, overrides all static/computed text */
-    llmNarrative?: LlmStrategyNarrative;
 }
-export declare function ProspectStrategyCard({ strategy: s, index: i, profile, computed, llmNarrative }: ProspectStrategyCardProps): React.JSX.Element;
+export declare function ProspectStrategyCard({ strategy: s, index: i, profile, computed }: ProspectStrategyCardProps): React.JSX.Element;
 export {};

package/lib/tax-axis/components/prospectReport/ProspectStrategyCard.js

@@ -8,19 +8,17 @@ const react_1 = __importDefault(require("react"));
 const strategyNarrative_1 = require("../../lib/data/strategyNarrative");
 const strategyProspect_1 = require("../../lib/data/strategyProspect");
 const theme_1 = require("./theme");
-function ProspectStrategyCard({ strategy: s, index: i, profile, computed, llmNarrative }) {
-    var _a, _b, _c, _d;
+function ProspectStrategyCard({ strategy: s, index: i, profile, computed }) {
+    var _a, _b;
     const p = strategyProspect_1.STRATEGY_PROSPECT[s.rank];
     const narr = strategyNarrative_1.STRATEGY_NARRATIVE[s.rank];
     const c = computed.get(s.rank);
-    const scaledLo = Math.round(((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) / 1000);
-    const scaledHi = Math.round(((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi) / 1000);
-    // When LLM narrative is provided, use it for whyItMatters and whatWeDo.
-    // HOW SAVINGS BREAK DOWN and WHY YOU NEED A SPECIALIST remain deterministic.
-    const whyText = (_c = llmNarrative === null || llmNarrative === void 0 ? void 0 : llmNarrative.whyItMatters) !== null && _c !== void 0 ? _c : (narr ? narr.whyMatters(profile) : strategyNarrative_1.NARRATIVE_FALLBACK.whyMatters(s));
+    const whyText = narr ? narr.whyMatters(profile) : strategyNarrative_1.NARRATIVE_FALLBACK.whyMatters(s);
     const breakdownText = narr ? narr.breakdown(profile, c) : strategyNarrative_1.NARRATIVE_FALLBACK.breakdown(s, c);
     const specialistText = (narr === null || narr === void 0 ? void 0 : narr.whySpecialist) || strategyNarrative_1.NARRATIVE_FALLBACK.whySpecialist(s);
-    const nextText = (_d = llmNarrative === null || llmNarrative === void 0 ? void 0 : llmNarrative.whatWeDo) !== null && _d !== void 0 ? _d : (narr ? narr.nextSteps : strategyNarrative_1.NARRATIVE_FALLBACK.nextSteps(s));
+    const nextText = narr ? narr.nextSteps : strategyNarrative_1.NARRATIVE_FALLBACK.nextSteps(s);
+    const scaledLo = Math.round(((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) / 1000);
+    const scaledHi = Math.round(((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi) / 1000);
     return (react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "24px 28px", boxShadow: theme_1.T.shadow } },
         react_1.default.createElement("div", { style: { display: "flex", alignItems: "flex-start", justifyContent: "space-between", marginBottom: 16 } },
             react_1.default.createElement("div", { style: { display: "flex", alignItems: "center", gap: 14 } },

package/lib/tax-axis/components/prospectReport/TaxAxisProspectReport.d.ts

@@ -1,41 +1,9 @@
 import React from "react";
 import type { ClientProfile, TaxAxisScreenProps } from "../../lib/types";
-import type { LlmStrategyNarrative } from "./ProspectStrategyCard";
-/** LLM output payload shape returned by generateProspectReport mutation */
-export interface LlmOutputPayload {
-    execSummary: string;
-    strategyNarratives: Record<string, LlmStrategyNarrative>;
-    additionalStrategiesBlurb: string;
-}
-/** Backend-computed math payload */
-export interface BackendComputePayload {
-    savingsLo: number;
-    savingsHi: number;
-    eligibleCount: number;
-    highPriorityCount: number;
-    quickWinCount: number;
-    gapBlock: {
-        currentTax: number;
-        optimizedTax: number;
-        realizedSavings: number;
-        realizedPctOfCurrent: number;
-        fedRatePct: number;
-        stateRatePct: number;
-    };
-    barData: Array<{
-        name: string;
-        mid: number;
-        pct: number;
-    }>;
-}
 export interface TaxAxisProspectReportProps extends TaxAxisScreenProps {
     profile: ClientProfile;
-    /** When provided (from generateProspectReport mutation), all math comes from backend */
-    backendComputePayload?: BackendComputePayload | null;
-    /** LLM-generated narrative text from the mutation */
-    outputPayload?: LlmOutputPayload | null;
     onUpgrade?: () => void;
     onPresent?: () => void;
     onReset?: () => void;
 }
-export declare function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload, onUpgrade, onPresent, onReset, }: TaxAxisProspectReportProps): React.JSX.Element;
+export declare function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }: TaxAxisProspectReportProps): React.JSX.Element;

package/lib/tax-axis/components/prospectReport/TaxAxisProspectReport.js

@@ -35,48 +35,47 @@ const SampleAnalysisPreview_1 = require("./SampleAnalysisPreview");
 const ProspectDocuments_1 = require("./ProspectDocuments");
 const ProspectNextSteps_1 = require("./ProspectNextSteps");
 const ProspectPrintView_1 = require("./ProspectPrintView");
-function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload, onUpgrade, onPresent, onReset, }) {
-    var _a, _b, _c, _d, _e, _f, _g;
+function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
     const bizName = profile.bizName || "Client";
     const [confirmReset, setConfirmReset] = (0, react_1.useState)(false);
     const [printMode, setPrintMode] = (0, react_1.useState)(false);
-    // ═══ ELIGIBLE STRATEGIES (client-side, for rendering strategy cards) ═══
+    // ═══ ELIGIBLE STRATEGIES ═══
     const eligible = (0, react_1.useMemo)(() => (0, compute_1.filterEligibleStrategies)(profile), [profile]);
     const high = eligible.filter(s => s.priority === "HIGH");
     const quick = eligible.filter(s => s.priority === "QUICK WIN");
+    // Top 3 by score for the sales narrative
     const top3 = (0, react_1.useMemo)(() => [...eligible].sort((a, b) => b.score - a.score).slice(0, 3), [eligible]);
     const remaining = eligible.length - top3.length;
     const remainingNames = eligible.filter(s => !top3.includes(s)).slice(0, 4).map(s => s.name);
-    // ═══ SAVINGS RANGE — backend-authoritative when available ═══
+    // ═══ SAVINGS RANGE (dynamic computation) ═══
     const computed = (0, react_1.useMemo)(() => (0, compute_1.computeAllStrategies)(profile), [profile]);
-    const displayLo = backendComputePayload
-        ? Math.round(backendComputePayload.savingsLo / 1000)
-        : Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.lo) !== null && _b !== void 0 ? _b : s.lo); }, 0) / 1000);
-    const displayHi = backendComputePayload
-        ? Math.round(backendComputePayload.savingsHi / 1000)
-        : Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.hi) !== null && _b !== void 0 ? _b : s.hi); }, 0) / 1000);
-    // ═══ GAP BLOCK — backend-authoritative when available ═══
-    const fedRatePct = (_a = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.fedRatePct) !== null && _a !== void 0 ? _a : (parseFloat((profile.federalRate || "24").replace("%", "")) || 24);
-    const stateRatePct = (_b = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.stateRatePct) !== null && _b !== void 0 ? _b : (parseFloat(profile.stateRate || "4.95") || 4.95);
-    const currentTax = (_c = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.currentTax) !== null && _c !== void 0 ? _c : Math.round(((0, compute_1.parseNum)(profile.netIncome) || Math.round((0, compute_1.parseNum)(profile.revenue) * 0.20))
-        * (fedRatePct + stateRatePct) / 100);
-    const realizedSavings = (_d = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.realizedSavings) !== null && _d !== void 0 ? _d : Math.min(Math.round((displayLo + displayHi) / 2 * 1000 * 0.325), Math.round(currentTax * 0.6));
-    const optimizedTax = (_e = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.optimizedTax) !== null && _e !== void 0 ? _e : (currentTax - realizedSavings);
-    const realizedPctOfCurrent = (_f = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.gapBlock.realizedPctOfCurrent) !== null && _f !== void 0 ? _f : (currentTax > 0 ? Math.round((realizedSavings / currentTax) * 100) : 0);
-    // ═══ BAR CHART DATA ═══
-    const barData = (_g = backendComputePayload === null || backendComputePayload === void 0 ? void 0 : backendComputePayload.barData) !== null && _g !== void 0 ? _g : (() => {
-        const totalMid = eligible.reduce((a, s) => { var _a, _b; const c = computed.get(s.rank); return a + (((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2; }, 0);
-        return top3.map(s => { var _a, _b; const c = computed.get(s.rank); const mid = Math.round((((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2); return { name: s.name, mid, pct: totalMid > 0 ? Math.round(mid / totalMid * 100) : 0 }; });
-    })();
+    const displayLo = Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.lo) !== null && _b !== void 0 ? _b : s.lo); }, 0) / 1000);
+    const displayHi = Math.round(eligible.reduce((a, s) => { var _a, _b; return a + ((_b = (_a = computed.get(s.rank)) === null || _a === void 0 ? void 0 : _a.hi) !== null && _b !== void 0 ? _b : s.hi); }, 0) / 1000);
+    // Savings bar chart data — top 3 strategies with midpoint + percentage
+    const totalMid = eligible.reduce((a, s) => { var _a, _b; const c = computed.get(s.rank); return a + (((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2; }, 0);
+    const barData = top3.map(s => { var _a, _b; const c = computed.get(s.rank); const mid = Math.round((((_a = c === null || c === void 0 ? void 0 : c.lo) !== null && _a !== void 0 ? _a : s.lo) + ((_b = c === null || c === void 0 ? void 0 : c.hi) !== null && _b !== void 0 ? _b : s.hi)) / 2); return { name: s.name, mid, pct: totalMid > 0 ? Math.round(mid / totalMid * 100) : 0 }; });
     const maxMid = Math.max(...barData.map(b => b.mid), 1);
+    // ═══ GAP BLOCK MATH — Current vs Optimized tax position ═══
+    const rev = (0, compute_1.parseNum)(profile.revenue);
+    const netIncome = (0, compute_1.parseNum)(profile.netIncome) || Math.round(rev * 0.20);
+    const fedRatePct = parseFloat((profile.federalRate || "24").replace("%", "")) || 24;
+    const stateRatePct = parseFloat(profile.stateRate || "4.95") || 4.95;
+    const combinedRate = (fedRatePct + stateRatePct) / 100;
+    const currentTax = Math.round(netIncome * combinedRate);
+    const theoreticalMidK = (displayLo + displayHi) / 2;
+    const realizedSavings = Math.min(Math.round(theoreticalMidK * 1000 * 0.325), Math.round(currentTax * 0.6));
+    const optimizedTax = currentTax - realizedSavings;
+    const realizedPctOfCurrent = currentTax > 0 ? Math.round((realizedSavings / currentTax) * 100) : 0;
+    // Section numbering — shifts when Additional Strategies section is present
+    const sectionNums = remaining > 0
+        ? { recommended: "02", additional: "03", sample: "04", documents: "05", nextSteps: "06" }
+        : { recommended: "02", additional: null, sample: "03", documents: "04", nextSteps: "05" };
     // ═══ DOCUMENT GROUPING ═══
     const allDocsNeeded = [...new Set(eligible.flatMap(s => { var _a; return ((_a = strategyProspect_1.STRATEGY_PROSPECT[s.rank]) === null || _a === void 0 ? void 0 : _a.docsNeeded) || []; }))];
     const requiredDocs = ["Profit & Loss Statement (current year)", "Balance Sheet (current year)"];
     const recommendedDocs = ["Federal Tax Return (most recent)", "W-2 / Officer Compensation records"];
     const conditionalDocs = allDocsNeeded.filter(d => !requiredDocs.includes(d) && !recommendedDocs.includes(d)).slice(0, 5);
-    const sectionNums = remaining > 0
-        ? { recommended: "02", additional: "03", sample: "04", documents: "05", nextSteps: "06" }
-        : { recommended: "02", additional: null, sample: "03", documents: "04", nextSteps: "05" };
+    // ═══ PRINT HANDLER ═══
     const handlePrint = () => {
         setPrintMode(true);
         requestAnimationFrame(() => {
@@ -87,16 +86,18 @@ function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload,
             });
         });
     };
+    // ═══ PRINT MODE — Light theme layout ═══
     if (printMode) {
         return (react_1.default.createElement(ProspectPrintView_1.ProspectPrintView, { profile: profile, bizName: bizName, displayLo: displayLo, displayHi: displayHi, currentTax: currentTax, optimizedTax: optimizedTax, realizedSavings: realizedSavings, realizedPctOfCurrent: realizedPctOfCurrent, fedRatePct: fedRatePct, stateRatePct: stateRatePct, eligible: eligible, high: high, quick: quick, top3: top3, computed: computed, fmtTax: compute_1.fmtTax, fmtSavings: compute_1.fmtSavings, requiredDocs: requiredDocs, recommendedDocs: recommendedDocs, conditionalDocs: conditionalDocs }));
     }
+    // ═══ INTERACTIVE MODE — Dark theme layout ═══
     return (react_1.default.createElement("div", null,
         react_1.default.createElement(ProspectCover_1.ProspectCover, { profile: profile, bizName: bizName, displayLo: displayLo, displayHi: displayHi }),
         react_1.default.createElement(TaxPositionGap_1.TaxPositionGap, { bizName: bizName, currentTax: currentTax, optimizedTax: optimizedTax, realizedSavings: realizedSavings, realizedPctOfCurrent: realizedPctOfCurrent, fedRatePct: fedRatePct, stateRatePct: stateRatePct, eligibleCount: eligible.length, fmtTax: compute_1.fmtTax, fmtSavings: compute_1.fmtSavings }),
         react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "24px 28px", marginBottom: 24, boxShadow: theme_1.T.shadow } },
             react_1.default.createElement("div", { style: { fontSize: 10, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.15em", color: theme_1.T.text4, marginBottom: 16, fontFamily: theme_1.T.mono } }, "AT A GLANCE"),
             react_1.default.createElement("div", { style: { display: "grid", gridTemplateColumns: "1fr 1fr 1fr 1fr", gap: 16 } }, [
-                { v: `$${displayLo}K–$${displayHi}K`, l: "Est. Savings" },
+                { v: `$${displayLo}K\u2013$${displayHi}K`, l: "Est. Savings" },
                 { v: String(eligible.length), l: "Strategies Found" },
                 { v: String(high.length), l: "High Impact" },
                 { v: String(quick.length), l: "Quick Wins" },
@@ -108,30 +109,29 @@ function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload,
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, color: theme_1.T.accent, fontFamily: theme_1.T.mono } }, "01"),
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.12em", color: theme_1.T.text4, fontFamily: theme_1.T.body } }, "EXECUTIVE SUMMARY")),
             react_1.default.createElement("div", { style: { height: 2, background: theme_1.T.accent, width: 48, marginBottom: 16 } }),
-            (outputPayload === null || outputPayload === void 0 ? void 0 : outputPayload.execSummary) ? (react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8, marginBottom: 12 } }, outputPayload.execSummary)) : (react_1.default.createElement(react_1.default.Fragment, null,
-                react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8, marginBottom: 12 } },
-                    "We evaluated ",
-                    bizName,
-                    "'s tax position against 25 federal strategies and identified ",
-                    react_1.default.createElement("strong", { style: { color: theme_1.T.white } },
-                        eligible.length,
-                        " applicable opportunities"),
-                    " with combined estimated savings of ",
-                    react_1.default.createElement("strong", { style: { color: theme_1.T.accentLt } },
-                        "$",
-                        displayLo,
-                        "K\u2013$",
-                        displayHi,
-                        "K annually"),
-                    ". ",
-                    high.length,
-                    " strategies could have significant impact."),
-                react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8 } },
-                    "The top ",
-                    top3.length,
-                    " strategies are detailed below.",
-                    quick.length > 0 ? ` ${quick.length} can be implemented this week with no structural changes.` : "",
-                    " These are profile-based estimates \u2014 uploading financial documents will refine savings calculations and unlock all 25 strategies.")))),
+            react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8, marginBottom: 12 } },
+                "We evaluated ",
+                bizName,
+                "'s tax position against 25 federal strategies and identified ",
+                react_1.default.createElement("strong", { style: { color: theme_1.T.white } },
+                    eligible.length,
+                    " applicable opportunities"),
+                " with combined estimated savings of ",
+                react_1.default.createElement("strong", { style: { color: theme_1.T.accentLt } },
+                    "$",
+                    displayLo,
+                    "K\u2013$",
+                    displayHi,
+                    "K annually"),
+                ". ",
+                high.length,
+                " strategies could have significant impact."),
+            react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8 } },
+                "The top ",
+                top3.length,
+                " strategies are detailed below.",
+                quick.length > 0 ? ` ${quick.length} can be implemented this week with no structural changes.` : "",
+                " These are profile-based estimates \u2014 uploading financial documents will refine savings calculations and unlock all 25 strategies.")),
         react_1.default.createElement("div", { style: { background: theme_1.T.surface, border: `1px solid ${theme_1.T.border}`, borderRadius: 14, padding: "20px 24px", marginBottom: 24, boxShadow: theme_1.T.shadow } },
             react_1.default.createElement("div", { style: { fontSize: 10, fontWeight: 700, color: theme_1.T.text4, textTransform: "uppercase", letterSpacing: "0.12em", marginBottom: 12, fontFamily: theme_1.T.mono } }, "SAVINGS DISTRIBUTION"),
             barData.map((b, i) => (react_1.default.createElement("div", { key: i, style: { display: "flex", alignItems: "center", gap: 10, marginBottom: i < barData.length - 1 ? 8 : 0 } },
@@ -151,10 +151,7 @@ function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload,
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, color: theme_1.T.accent, fontFamily: theme_1.T.mono } }, "02"),
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.12em", color: theme_1.T.text4, fontFamily: theme_1.T.body } }, "RECOMMENDED STRATEGIES")),
             react_1.default.createElement("div", { style: { height: 2, background: theme_1.T.accent, width: 48, marginBottom: 16 } }),
-            react_1.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 14 } }, top3.map((s, i) => {
-                var _a;
-                return (react_1.default.createElement(ProspectStrategyCard_1.ProspectStrategyCard, { key: s.rank, strategy: s, index: i, profile: profile, computed: computed, llmNarrative: (_a = outputPayload === null || outputPayload === void 0 ? void 0 : outputPayload.strategyNarratives) === null || _a === void 0 ? void 0 : _a[`S${s.rank}`] }));
-            }))),
+            react_1.default.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 14 } }, top3.map((s, i) => (react_1.default.createElement(ProspectStrategyCard_1.ProspectStrategyCard, { key: s.rank, strategy: s, index: i, profile: profile, computed: computed }))))),
         remaining > 0 && (react_1.default.createElement("div", { style: { marginBottom: 24 } },
             react_1.default.createElement("div", { style: { display: "flex", alignItems: "baseline", gap: 10, marginBottom: 6 } },
                 react_1.default.createElement("span", { style: { fontSize: 11, fontWeight: 700, color: theme_1.T.accent, fontFamily: theme_1.T.mono } }, "03"),
@@ -165,8 +162,10 @@ function TaxAxisProspectReport({ profile, backendComputePayload, outputPayload,
                     "+ ",
                     remaining,
                     " more strategies identified"),
-                react_1.default.createElement("div", { style: { fontSize: 13, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.7, marginBottom: 10 } }, (outputPayload === null || outputPayload === void 0 ? void 0 : outputPayload.additionalStrategiesBlurb)
-                    || `Including: ${remainingNames.join(", ")}${remaining > 4 ? " and more" : ""}`),
+                react_1.default.createElement("div", { style: { fontSize: 13, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.7, marginBottom: 10 } },
+                    "Including: ",
+                    remainingNames.join(", "),
+                    remaining > 4 ? " and more" : ""),
                 react_1.default.createElement("div", { style: { fontSize: 12, color: theme_1.T.text3, fontFamily: theme_1.T.body, lineHeight: 1.6, borderLeft: `3px solid ${theme_1.T.accent}`, paddingLeft: 12 } }, "Full analysis with documents unlocks specific savings estimates for every eligible strategy.")))),
         react_1.default.createElement(SampleAnalysisPreview_1.SampleAnalysisPreview, { sectionNum: sectionNums.sample, eligibleCount: eligible.length }),
         react_1.default.createElement(ProspectDocuments_1.ProspectDocuments, { sectionNum: sectionNums.documents, requiredDocs: requiredDocs, recommendedDocs: recommendedDocs, conditionalDocs: conditionalDocs }),

package/lib/tax-axis/lib/adapters/useEngineOutput.d.ts

@@ -1,65 +1,49 @@
 import type { Strategy, ComputedMap } from "../types";
-export interface EngineStrategyAnalysis {
-    strategy_id?: string;
-    strategy_name?: string;
-    lo?: number;
-    hi?: number;
-    estimatedSavings?: {
-        min?: number;
-        max?: number;
-    };
-    priority?: string;
-    score?: number;
-    weighted_score?: number;
-    quick_win?: boolean;
-    timeline_bucket?: string;
-    calculation_trace?: {
-        irs_cite?: string;
-        forms_required?: string[];
-        source_documents?: Array<{
-            field_label: string;
-            value_display: string;
-            source_hint: string;
-        }>;
-        position_strength?: string;
-        specialist_note?: string;
-    };
-    why_it_applies?: string;
-    next_step?: string;
-    risk_disclosure?: string;
-}
-export interface EngineCpaWorkflow {
-    engagement_recommendations?: string[];
+/** Raw engine output blob from the LLM run. */
+export type EngineOutput = Record<string, unknown> | null;
+/** Pre-computed formula engine results from outputPayload.meta.preComputed. */
+export interface PreComputedResults {
+    results: Record<string, PreComputedStrategyResult>;
+    completedCount?: number;
+    excludedCount?: number;
+    failedCount?: number;
+    totalSavingsLow?: number;
+    totalSavingsHigh?: number;
+    computedAt?: string;
 }
-export interface EngineOutput {
-    strategy_analysis?: EngineStrategyAnalysis[];
-    cpa_workflow?: EngineCpaWorkflow;
-    client_summary?: {
-        opening?: string;
-        closing?: string;
-        data_quality_note?: string;
-        interaction_warning?: string;
-        strategies?: Array<{
-            strategy_name?: string;
-            why_it_applies?: string;
-            next_step?: string;
-        }>;
-    };
-    nexus_flags?: Array<{
-        state: string;
-        nexus_type: string;
-        flag_text: string;
-    }>;
-    eligibility_screening?: {
-        excluded_strategies?: Array<{
-            strategy_id: string;
-            reason: string;
-            irs_cite: string;
-        }>;
-    };
+export interface PreComputedStrategyResult {
+    strategy_id: string;
+    status: "COMPLETE" | "EXCLUDED" | "FAILED";
+    result_gross: number | null;
+    confidence_interval?: {
+        low: number;
+        high: number;
+        basis?: string;
+    } | null;
+    trace?: Record<string, unknown>;
 }
+/** Adapter result passed to client-report / preparer-workpaper components. */
 export interface EngineOutputAdapterResult {
     strategies: Strategy[];
     computedMap: ComputedMap;
 }
-export declare function useEngineOutput(engineOutput: EngineOutput | null | undefined): EngineOutputAdapterResult | null;
+/** Single strategy analysis entry from the engine. */
+export interface EngineStrategyAnalysis {
+    strategy_id: string;
+    strategy_name: string;
+    priority_tier: string;
+    weighted_score: number;
+    quick_win: boolean;
+    engagement_recommendation: string;
+    risk_disclosure?: string | null;
+    calculation_trace?: Record<string, unknown>;
+    _reconciledPreComputed?: boolean;
+    [key: string]: unknown;
+}
+/** CPA workflow section from the engine. */
+export interface EngineCpaWorkflow {
+    workpaper_codes: string[] | null;
+    engagement_recommendations: string[];
+    [key: string]: unknown;
+}
+export declare function useEngineOutput(engineOutput: EngineOutput, preComputed?: PreComputedResults | null): EngineOutputAdapterResult | null;