@paro.io/expert-shared-components 1.14.65 → 1.14.67

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

@@ -26,21 +26,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaxAxisProcessing = TaxAxisProcessing;
 const react_1 = __importStar(require("react"));
 const ProcessingStages_1 = require("./ProcessingStages");
+const CRAWL_CEILING = 99; // pause here until reportReady
+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) {
     var _a;
     if (!profile) {
         return [
             "Parsing source documents",
             "Injecting IRS 2026 parameters",
-            "Screening 25 eligible strategies",
+            "Screening eligible strategies",
             "Computing deterministic tax math",
             "Generating IRS citations",
         ];
     }
-    const entity = profile.entity || "your";
+    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";
-    // Verbatim from mock (App.jsx:1473-1477)
     const base = [
         "Parsing source documents",
         "Injecting IRS 2026 parameters",
@@ -53,53 +57,120 @@ function buildStages(profile) {
     if (entity === "S-Corporation") {
         base.push("Benchmarking officer salary against BLS data");
     }
-    base.push("Screening 25 eligible strategies", "Computing deterministic tax math", "Cross-validating source documents", "Generating IRS citations", `Assembling TaxAxis report for ${bizName}`);
+    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, userContext: _userContext = "expert", }) {
+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);
-    // Staged timer from mock (App.jsx:1481). setInterval advances one stage
-    // per tick; after the final stage, a 1000ms delay fires onComplete.
-    // Target: ~8s total. Dynamic path: 10 stages × 700ms = 7s + 1s nav = 8s.
-    // Fallback path (no profile): 5 stages × 1400ms = 7s + 1s nav = 8s.
-    const stageInterval = stages.length <= 5 ? 1400 : 700;
+    const [stageIdx, setStageIdx] = (0, react_1.useState)(0);
+    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
+    // without relying on the async functional-updater pattern.
+    const progressRef = (0, react_1.useRef)(0);
+    // ── Stall detection: show patience message after 35s of no progress change ──
+    const [showPatience, setShowPatience] = (0, react_1.useState)(false);
+    const lastProgressRef = (0, react_1.useRef)(0);
+    const stallTimerRef = (0, react_1.useRef)(null);
     (0, react_1.useEffect)(() => {
-        let i = 0;
-        let navTimer = null;
+        if (finishingRef.current) {
+            setShowPatience(false);
+            return;
+        }
+        if (progress !== lastProgressRef.current) {
+            lastProgressRef.current = progress;
+            setShowPatience(false);
+            if (stallTimerRef.current)
+                clearTimeout(stallTimerRef.current);
+            stallTimerRef.current = setTimeout(() => {
+                if (!finishingRef.current)
+                    setShowPatience(true);
+            }, 8000);
+        }
+        return () => {
+            if (stallTimerRef.current)
+                clearTimeout(stallTimerRef.current);
+        };
+    }, [progress]);
+    const setProgressSync = (v) => {
+        progressRef.current = v;
+        setProgress(v);
+    };
+    // ── Crawl: 0 → 80% — skipped entirely if reportReady already true on mount ──
+    (0, react_1.useEffect)(() => {
+        if (reportReady || finishingRef.current)
+            return;
         const iv = setInterval(() => {
-            i++;
-            setProgress(i);
-            if (i >= stages.length) {
+            if (finishingRef.current) {
                 clearInterval(iv);
-                navTimer = setTimeout(onComplete, 1000);
+                return;
+            }
+            const next = Math.min(progressRef.current + CRAWL_STEP, CRAWL_CEILING);
+            setProgressSync(next);
+            if (next >= CRAWL_CEILING)
+                clearInterval(iv);
+        }, CRAWL_TICK_MS);
+        return () => clearInterval(iv);
+        // 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(() => {
+            setStageIdx((i) => (i + 1 < stages.length ? i + 1 : i));
+        }, STAGE_ADVANCE_MS);
+        return () => clearInterval(iv);
+    }, [stages.length]);
+    // ── Finish: reportReady → fast fill to 100%, then onComplete ─────
+    (0, react_1.useEffect)(() => {
+        if (!reportReady || finishingRef.current || completedRef.current)
+            return;
+        finishingRef.current = true;
+        setStageIdx(stages.length - 1);
+        // Read current progress synchronously from ref — not from stale state closure
+        const startPct = progressRef.current;
+        const startTime = Date.now();
+        const frame = () => {
+            const elapsed = Date.now() - startTime;
+            const t = Math.min(elapsed / FINISH_MS, 1);
+            const eased = t < 1 ? t * (2 - t) : 1;
+            setProgressSync(startPct + (100 - startPct) * eased);
+            if (t < 1) {
+                requestAnimationFrame(frame);
+            }
+            else {
+                setProgressSync(100);
+                if (!completedRef.current) {
+                    completedRef.current = true;
+                    setTimeout(onComplete, 150);
+                }
             }
-        }, stageInterval);
-        return () => {
-            clearInterval(iv);
-            if (navTimer !== null)
-                clearTimeout(navTimer);
         };
-    }, [stages.length, stageInterval, onComplete]);
-    const pct = Math.round((progress / stages.length) * 100);
-    const title = (profile === null || profile === void 0 ? void 0 : profile.bizName)
-        ? `Analyzing ${profile.bizName}`
-        : "Running Analysis";
+        requestAnimationFrame(frame);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [reportReady, stages.length]);
+    const pct = Math.round(progress);
+    const title = (profile === null || profile === void 0 ? void 0 : profile.bizName) ? `Analyzing ${profile.bizName}` : "Running Analysis";
+    const isFinishing = finishingRef.current;
     return (react_1.default.createElement("div", { className: "pt-[60px] text-center" },
         react_1.default.createElement("div", { className: "relative w-[72px] h-[72px] mx-auto mb-7" },
             react_1.default.createElement("div", { className: "absolute inset-0 rounded-full animate-ping", style: {
                     background: "radial-gradient(circle, #248384, transparent 70%)",
                     opacity: 0.15,
+                    animationDuration: isFinishing ? "0.4s" : "1.4s",
                 } }),
             react_1.default.createElement("div", { className: "absolute inset-0 w-[72px] h-[72px] rounded-full bg-tax-axis-surface flex items-center justify-center", style: { border: "2px solid rgba(36,131,132,0.4)" } },
-                react_1.default.createElement("span", { className: "text-[28px] font-bold text-tax-axis-teal-light font-tax-axis-mono" }, pct))),
+                react_1.default.createElement("span", { className: "font-bold text-tax-axis-teal-light font-tax-axis-mono", style: { fontSize: pct === 100 ? 20 : 28 } }, pct === 100 ? "✓" : pct))),
         react_1.default.createElement("h2", { className: "text-[22px] font-bold text-white font-tax-axis-head mb-1" }, title),
-        react_1.default.createElement("p", { className: "text-[13px] text-tax-axis-text-3 font-tax-axis-body mb-7" }, "Deterministic \u00B7 Temperature 0 \u00B7 IRS-cited"),
+        react_1.default.createElement("p", { className: "text-[13px] text-tax-axis-text-3 font-tax-axis-body mb-7" }, isFinishing ? "Report ready — loading your results…" : "Deterministic · Temperature 0 · IRS-cited"),
         react_1.default.createElement("div", { className: "max-w-[360px] mx-auto mb-6 h-0.5 bg-tax-axis-surface-2 rounded-sm overflow-hidden" },
-            react_1.default.createElement("div", { className: "h-full rounded-sm transition-[width] duration-[400ms]", style: {
-                    width: `${pct}%`,
+            react_1.default.createElement("div", { className: "h-full rounded-sm", style: {
+                    width: `${progress}%`,
                     background: "linear-gradient(90deg, #248384, #A1E5E6)",
                     boxShadow: "0 0 8px #248384",
+                    transition: isFinishing ? "none" : "width 0.18s linear",
                 } })),
-        react_1.default.createElement(ProcessingStages_1.ProcessingStages, { stages: stages, progress: progress })));
+        react_1.default.createElement(ProcessingStages_1.ProcessingStages, { stages: stages, progress: stageIdx + 1 }),
+        pct >= CRAWL_CEILING && !isFinishing && (react_1.default.createElement("p", { className: "text-[11px] text-tax-axis-text-4 font-tax-axis-mono mt-4 animate-pulse" }, "Finalizing analysis\u2026")),
+        showPatience && !isFinishing && (react_1.default.createElement("p", { className: "text-[13px] text-tax-axis-text-3 font-tax-axis-body mt-4 text-center" }, "Still running \u2014 document analysis typically takes 2\u20133 minutes. Do not navigate away."))));
 }

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

@@ -16,8 +16,6 @@ function ProspectPrintView({ profile, bizName, displayLo, displayHi, currentTax,
           body * { visibility: hidden !important; }
           .prospect-print-root, .prospect-print-root * { visibility: visible !important; }
           .prospect-print-root { position: absolute !important; left: 0 !important; top: 0 !important; width: 100% !important; }
-          body, p, span, div, td, th, li { color: #212529 !important; }
-          h1, h2, h3, h4, h5, h6, strong, b { color: #060821 !important; }
           .no-print { display: none !important; }
         }
       `),

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

@@ -1,17 +1,10 @@
 import React from "react";
 import type { Strategy, ClientProfile, ComputedMap } from "../../lib/types";
-interface BackendNarrative {
-    whyThisMatters: string;
-    howSavingsBreakDown: string;
-    whyYouNeedSpecialist: string;
-    whatWeDoNext: string;
-}
 interface ProspectStrategyCardProps {
     strategy: Strategy;
     index: number;
     profile: ClientProfile;
     computed: ComputedMap;
-    backendNarrative?: BackendNarrative | null;
 }
-export declare function ProspectStrategyCard({ strategy: s, index: i, profile, computed, backendNarrative }: 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,15 +8,15 @@ 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, backendNarrative }) {
+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 whyText = (backendNarrative === null || backendNarrative === void 0 ? void 0 : backendNarrative.whyThisMatters) || (narr ? narr.whyMatters(profile) : strategyNarrative_1.NARRATIVE_FALLBACK.whyMatters(s));
-    const breakdownText = (backendNarrative === null || backendNarrative === void 0 ? void 0 : backendNarrative.howSavingsBreakDown) || (narr ? narr.breakdown(profile, c) : strategyNarrative_1.NARRATIVE_FALLBACK.breakdown(s, c));
-    const specialistText = (backendNarrative === null || backendNarrative === void 0 ? void 0 : backendNarrative.whyYouNeedSpecialist) || (narr === null || narr === void 0 ? void 0 : narr.whySpecialist) || strategyNarrative_1.NARRATIVE_FALLBACK.whySpecialist(s);
-    const nextText = (backendNarrative === null || backendNarrative === void 0 ? void 0 : backendNarrative.whatWeDoNext) || (narr ? narr.nextSteps : strategyNarrative_1.NARRATIVE_FALLBACK.nextSteps(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 = 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 } },

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

@@ -1,35 +1,9 @@
 import React from "react";
 import type { ClientProfile, TaxAxisScreenProps } from "../../lib/types";
-export interface BackendProspectResults {
-    sessionId: string;
-    strategies: Array<{
-        strategyId: string;
-        strategyName: string;
-        priorityTier: string;
-        savingsLo: number;
-        savingsHi: number;
-        score: number;
-        quickWin: boolean;
-        timeline: string;
-        ircCite: string;
-        narrative: {
-            whyThisMatters: string;
-            howSavingsBreakDown: string;
-            whyYouNeedSpecialist: string;
-            whatWeDoNext: string;
-        };
-    }>;
-    executiveSummary: string;
-    totalSavingsLo: number;
-    totalSavingsHi: number;
-    eligibleCount: number;
-    generatedAt: string;
-}
 export interface TaxAxisProspectReportProps extends TaxAxisScreenProps {
     profile: ClientProfile;
-    backendResults?: BackendProspectResults | null;
     onUpgrade?: () => void;
     onPresent?: () => void;
     onReset?: () => void;
 }
-export declare function TaxAxisProspectReport({ profile, backendResults, 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,24 +35,10 @@ const SampleAnalysisPreview_1 = require("./SampleAnalysisPreview");
 const ProspectDocuments_1 = require("./ProspectDocuments");
 const ProspectNextSteps_1 = require("./ProspectNextSteps");
 const ProspectPrintView_1 = require("./ProspectPrintView");
-function TaxAxisProspectReport({ profile, backendResults, onUpgrade, onPresent, onReset, }) {
+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);
-    // ═══ BACKEND NARRATIVE LOOKUP ═══
-    // Build a map from strategy rank (number) to backend narrative when available.
-    // strategyId format: "S1", "S2", etc.
-    const narrativeLookup = (0, react_1.useMemo)(() => {
-        if (!(backendResults === null || backendResults === void 0 ? void 0 : backendResults.strategies))
-            return null;
-        const map = new Map();
-        for (const s of backendResults.strategies) {
-            const rank = parseInt(s.strategyId.replace("S", ""), 10);
-            if (!isNaN(rank))
-                map.set(rank, s.narrative);
-        }
-        return map;
-    }, [backendResults]);
     // ═══ ELIGIBLE STRATEGIES ═══
     const eligible = (0, react_1.useMemo)(() => (0, compute_1.filterEligibleStrategies)(profile), [profile]);
     const high = eligible.filter(s => s.priority === "HIGH");
@@ -123,30 +109,29 @@ function TaxAxisProspectReport({ profile, backendResults, onUpgrade, onPresent,
                 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 } }),
-            (backendResults === null || backendResults === void 0 ? void 0 : backendResults.executiveSummary) ? (react_1.default.createElement("div", { style: { fontSize: 14, color: theme_1.T.text2, fontFamily: theme_1.T.body, lineHeight: 1.8 } }, backendResults.executiveSummary)) : (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 } },
@@ -166,10 +151,7 @@ function TaxAxisProspectReport({ profile, backendResults, onUpgrade, onPresent,
                 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, backendNarrative: (_a = narrativeLookup === null || narrativeLookup === void 0 ? void 0 : narrativeLookup.get(s.rank)) !== null && _a !== void 0 ? _a : null }));
-            }))),
+            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"),

package/lib/tax-axis/index.d.ts

@@ -5,11 +5,13 @@ export { SectionHeader } from "./components/shared/SectionHeader";
 export * from "./lib/types";
 export * from "./lib/data";
 export * from "./lib/compute";
+export { useEngineOutput } from "./lib/adapters/useEngineOutput";
+export type { EngineOutput, EngineOutputAdapterResult, EngineStrategyAnalysis, EngineCpaWorkflow } from "./lib/adapters/useEngineOutput";
 export { TaxAxisIntake } from "./components/intake/TaxAxisIntake";
 export type { TaxAxisIntakeProps } from "./components/intake/TaxAxisIntake";
 export { TaxAxisDocuments } from "./components/documents/TaxAxisDocuments";
 export type { TaxAxisDocumentsProps } from "./components/documents/TaxAxisDocuments";
-export { DocumentReviewModal, EXTRACTED_FIELDS_QUERY, SAVE_FIELD_EDIT_MUTATION } from "./components/documents/DocumentReviewModal";
+export { DocumentReviewModal } from "./components/documents/DocumentReviewModal";
 export type { DocumentReviewModalProps } from "./components/documents/DocumentReviewModal";
 export { TaxAxisProcessing } from "./components/processing/TaxAxisProcessing";
 export type { TaxAxisProcessingProps } from "./components/processing/TaxAxisProcessing";

package/lib/tax-axis/index.js

@@ -14,7 +14,7 @@ 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.TaxAxisPresentationMode = exports.TaxAxisProspectReport = exports.TaxAxisExtractionReview = exports.TaxAxisPreparerWorkpaper = exports.TaxAxisClientReport = exports.TaxAxisDashboard = exports.TaxAxisProcessing = exports.SAVE_FIELD_EDIT_MUTATION = exports.EXTRACTED_FIELDS_QUERY = exports.DocumentReviewModal = exports.TaxAxisDocuments = exports.TaxAxisIntake = exports.SectionHeader = exports.TaxAxisButton = exports.TaxAxisBadge = exports.TaxAxisCard = void 0;
+exports.TaxAxisPresentationMode = exports.TaxAxisProspectReport = exports.TaxAxisExtractionReview = exports.TaxAxisPreparerWorkpaper = exports.TaxAxisClientReport = exports.TaxAxisDashboard = exports.TaxAxisProcessing = exports.DocumentReviewModal = exports.TaxAxisDocuments = exports.TaxAxisIntake = exports.useEngineOutput = exports.SectionHeader = exports.TaxAxisButton = exports.TaxAxisBadge = exports.TaxAxisCard = void 0;
 // Shared primitives
 var TaxAxisCard_1 = require("./components/shared/TaxAxisCard");
 Object.defineProperty(exports, "TaxAxisCard", { enumerable: true, get: function () { return TaxAxisCard_1.TaxAxisCard; } });
@@ -30,6 +30,9 @@ __exportStar(require("./lib/types"), exports);
 __exportStar(require("./lib/data"), exports);
 // Compute
 __exportStar(require("./lib/compute"), exports);
+// Adapters
+var useEngineOutput_1 = require("./lib/adapters/useEngineOutput");
+Object.defineProperty(exports, "useEngineOutput", { enumerable: true, get: function () { return useEngineOutput_1.useEngineOutput; } });
 // Screens
 var TaxAxisIntake_1 = require("./components/intake/TaxAxisIntake");
 Object.defineProperty(exports, "TaxAxisIntake", { enumerable: true, get: function () { return TaxAxisIntake_1.TaxAxisIntake; } });
@@ -37,8 +40,6 @@ var TaxAxisDocuments_1 = require("./components/documents/TaxAxisDocuments");
 Object.defineProperty(exports, "TaxAxisDocuments", { enumerable: true, get: function () { return TaxAxisDocuments_1.TaxAxisDocuments; } });
 var DocumentReviewModal_1 = require("./components/documents/DocumentReviewModal");
 Object.defineProperty(exports, "DocumentReviewModal", { enumerable: true, get: function () { return DocumentReviewModal_1.DocumentReviewModal; } });
-Object.defineProperty(exports, "EXTRACTED_FIELDS_QUERY", { enumerable: true, get: function () { return DocumentReviewModal_1.EXTRACTED_FIELDS_QUERY; } });
-Object.defineProperty(exports, "SAVE_FIELD_EDIT_MUTATION", { enumerable: true, get: function () { return DocumentReviewModal_1.SAVE_FIELD_EDIT_MUTATION; } });
 var TaxAxisProcessing_1 = require("./components/processing/TaxAxisProcessing");
 Object.defineProperty(exports, "TaxAxisProcessing", { enumerable: true, get: function () { return TaxAxisProcessing_1.TaxAxisProcessing; } });
 var TaxAxisDashboard_1 = require("./components/dashboard/TaxAxisDashboard");

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

@@ -1,26 +1,151 @@
 import type { Strategy, ComputedMap } from "../types";
-/** Raw engine output blob from the LLM run. */
-export type EngineOutput = Record<string, unknown> | null;
-/** Adapter result passed to client-report / preparer-workpaper components. */
-export interface EngineOutputAdapterResult {
-    strategies: Strategy[];
-    computedMap: ComputedMap;
+export interface SourceDocumentRef {
+    field_label: string;
+    value_display: string;
+    source_hint: string;
+}
+export interface EngineCalculationTrace {
+    strategy_id: string;
+    branch_executed: string | null;
+    formula: string;
+    inputs: Record<string, unknown>;
+    result_gross: number | null;
+    confidence_interval: {
+        low: number;
+        high: number;
+        basis: string;
+    } | null;
+    position_strength: string;
+    irs_cite: string;
+    data_quality_flag: string | null;
+    forms_required: string[];
+    deadline_flag: string | null;
+    amt_flag: boolean;
+    source_documents?: SourceDocumentRef[];
+    specialist_note?: string | null;
 }
-/** Single strategy analysis entry from the engine. */
 export interface EngineStrategyAnalysis {
     strategy_id: string;
     strategy_name: string;
-    priority_tier: string;
+    priority_tier: "HIGH" | "MEDIUM" | "LOW" | "NOT_RECOMMENDED";
     weighted_score: number;
+    scores: {
+        financial_impact: number;
+        applicability: number;
+        complexity: number;
+        risk: number;
+        cash_flow: number;
+    };
     quick_win: boolean;
+    calculation_trace: EngineCalculationTrace;
     engagement_recommendation: string;
-    calculation_trace?: Record<string, unknown>;
-    [key: string]: unknown;
+    risk_disclosure: string | null;
+}
+export interface EngineClientSummaryStrategy {
+    slot: number;
+    strategy_name: string;
+    savings_range: string;
+    why_it_applies: string;
+    next_step: string;
+    quick_win_badge: boolean;
+    deadline_flag?: string | null;
 }
-/** CPA workflow section from the engine. */
 export interface EngineCpaWorkflow {
     workpaper_codes: string[] | null;
+    section_6694_notices: Array<{
+        strategy_id: string;
+        position_strength: string;
+        notice: string;
+    }>;
+    prior_year_flags: string[];
+    conflict_of_interest_checklist: Array<{
+        strategy_id: string;
+        conflict_prompt: string;
+        confirmed_no_conflict: boolean;
+    }>;
     engagement_recommendations: string[];
-    [key: string]: unknown;
 }
-export declare function useEngineOutput(_engineOutput: EngineOutput): EngineOutputAdapterResult | null;
+export interface EngineOutput {
+    engagement_id: string;
+    generated_at: string;
+    algorithm_version: string;
+    business_profile: {
+        entity_type: string;
+        industry: string;
+        industry_vertical: string;
+        states: string[];
+        data_years: number;
+        confidence_tier: string;
+        effective_tax_rate: number | null;
+        data_quality_flags: string[];
+    };
+    eligibility_screening: {
+        excluded_strategies: Array<{
+            strategy_id: string;
+            status: "EXCLUDED";
+            reason: string;
+            irs_cite: string;
+        }>;
+    };
+    strategy_analysis: EngineStrategyAnalysis[];
+    strategy_interaction_warnings: Array<{
+        strategy_pair: [string, string];
+        warning_text: string;
+    }>;
+    implementation_roadmap: {
+        quick_wins: Array<{
+            strategy_id: string;
+            action: string;
+            deadline?: string | null;
+        }>;
+        immediate: Array<{
+            strategy_id: string;
+            action: string;
+            deadline?: string | null;
+        }>;
+        thirty_day: Array<{
+            strategy_id: string;
+            action: string;
+            deadline?: string | null;
+        }>;
+        ninety_day: Array<{
+            strategy_id: string;
+            action: string;
+            deadline?: string | null;
+        }>;
+        annual: Array<{
+            strategy_id: string;
+            action: string;
+            deadline?: string | null;
+        }>;
+    };
+    cpa_workflow: EngineCpaWorkflow;
+    client_summary: {
+        opening: string;
+        strategies: EngineClientSummaryStrategy[];
+        data_quality_note: string | null;
+        interaction_warning: string | null;
+        closing: string;
+    };
+    risk_disclosures: string[];
+    client_risk_disclosures: {
+        accuracy_penalty_warning: string | null;
+        applies_to_strategies: string[];
+    };
+    amt_flags: Array<{
+        trigger: string;
+        strategy_id: string;
+        flag_text: string;
+    }>;
+    nexus_flags: Array<{
+        state: string;
+        nexus_type: string;
+        flag_text: string;
+    }>;
+}
+export interface EngineOutputAdapterResult {
+    strategies: Strategy[];
+    computedMap: ComputedMap;
+    engineOutput: EngineOutput;
+}
+export declare function useEngineOutput(engineOutput: EngineOutput | null | undefined): EngineOutputAdapterResult | null;