@paro.io/expert-shared-components 1.14.57 → 1.14.60

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 }) {
+function ProspectStrategyCard({ strategy: s, index: i, profile, computed, backendNarrative }) {
     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 = 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 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 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,9 +1,35 @@
 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, onUpgrade, onPresent, onReset, }: TaxAxisProspectReportProps): React.JSX.Element;
+export declare function TaxAxisProspectReport({ profile, backendResults, onUpgrade, onPresent, onReset, }: TaxAxisProspectReportProps): React.JSX.Element;

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

@@ -35,10 +35,24 @@ const SampleAnalysisPreview_1 = require("./SampleAnalysisPreview");
 const ProspectDocuments_1 = require("./ProspectDocuments");
 const ProspectNextSteps_1 = require("./ProspectNextSteps");
 const ProspectPrintView_1 = require("./ProspectPrintView");
-function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
+function TaxAxisProspectReport({ profile, backendResults, 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");
@@ -109,29 +123,30 @@ function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
                 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 } }),
-            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.")),
+            (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: { 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,7 +166,10 @@ function TaxAxisProspectReport({ profile, onUpgrade, onPresent, onReset, }) {
                 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) => (react_1.default.createElement(ProspectStrategyCard_1.ProspectStrategyCard, { key: s.rank, strategy: s, index: i, profile: profile, computed: computed }))))),
+            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 }));
+            }))),
         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,14 +5,10 @@ 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 } from "./components/documents/DocumentReviewModal";
-export type { DocumentReviewModalProps } from "./components/documents/DocumentReviewModal";
 export { TaxAxisProcessing } from "./components/processing/TaxAxisProcessing";
 export type { TaxAxisProcessingProps } from "./components/processing/TaxAxisProcessing";
 export { TaxAxisDashboard } from "./components/dashboard/TaxAxisDashboard";

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.DocumentReviewModal = exports.TaxAxisDocuments = exports.TaxAxisIntake = exports.useEngineOutput = 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.TaxAxisDocuments = exports.TaxAxisIntake = 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,16 +30,11 @@ __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; } });
 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; } });
 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,151 +1,26 @@
 import type { Strategy, ComputedMap } from "../types";
-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;
+/** 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;
 }
+/** Single strategy analysis entry from the engine. */
 export interface EngineStrategyAnalysis {
     strategy_id: string;
     strategy_name: string;
-    priority_tier: "HIGH" | "MEDIUM" | "LOW" | "NOT_RECOMMENDED";
+    priority_tier: string;
     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;
-    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;
+    calculation_trace?: Record<string, unknown>;
+    [key: string]: unknown;
 }
+/** 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 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;
+export declare function useEngineOutput(_engineOutput: EngineOutput): EngineOutputAdapterResult | null;

package/lib/tax-axis/lib/adapters/useEngineOutput.js

@@ -1,161 +1,12 @@
 "use strict";
-// ═══════════════════════════════════════════════════════════════════
-// useEngineOutput — adapts live EngineOutput from paro-graphql-api
-// into the Strategy[] + ComputedMap shapes the FE components consume.
-//
-// Strategy: use the static STRATEGIES catalog as a structural template
-// (rank, cat, entities, authority, etc.) and override savings/priority/score
-// from the live engine data. Falls back to static data when a strategy_id
-// has no match in the catalog (future-proofing for new strategies).
-// ═══════════════════════════════════════════════════════════════════
+// useEngineOutput — minimal stub to unblock builds.
+// TODO: centralise narrative-field mapping (why_it_applies, source_documents, specialistNote) here.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useEngineOutput = useEngineOutput;
 const react_1 = require("react");
-const data_1 = require("../data");
-// ── Strategy ID → rank mapping (S1..S26 → rank 1..25 catalog) ───────
-// Maps engine strategy_ids like "S2", "S5" etc. to catalog ranks.
-// Built once from the static STRATEGIES array by matching code/name heuristics.
-const ENGINE_ID_TO_RANK = {
-    S1: 1, // Business Entity Structure (S-Corp election)
-    S2: 2, // Section 179
-    S3: 3, // Bonus Depreciation §168(k)
-    S4: 4, // QBI §199A
-    S5: 5, // R&D Credit §41
-    S6: 6, // WOTC §51
-    S7: 7, // Retirement Plan
-    S8: 8, // Cost Segregation
-    S9: 9, // HSA
-    S10: 10, // Business Meals
-    S11: 11, // Professional Services / Legal
-    S12: 12, // Home Office
-    S13: 13, // Health Care Credit §45R
-    S14: 14, // Charitable / DAF
-    S15: 15, // SALT PTE
-    S16: 16, // §163(j) Interest
-    S17: 17, // Income Deferral
-    S18: 18, // Opportunity Zone §1400Z
-    S19: 19, // §179D Energy
-    S20: 20, // Accounting Method
-    S21: 21, // OBBBA Overtime
-    S22: 22, // OBBBA Tips / Overtime
-    S23: 23, // §174A R&E catch-up
-    S24: 24, // Childcare §45F
-    S25: 25, // OBBBA Trump Accounts
-};
-const CATALOG_BY_RANK = new Map(data_1.STRATEGIES.map((s) => [s.rank, s]));
-// ── Priority tier mapping ─────────────────────────────────────────────
-function mapPriority(tier, quickWin) {
-    if (quickWin)
-        return "QUICK WIN";
-    if (tier === "HIGH")
-        return "HIGH";
-    if (tier === "MEDIUM")
-        return "MEDIUM";
-    if (tier === "LOW")
-        return "LOW";
-    return "NOT RECOMMENDED";
-}
-// ── Timeline bucket from implementation_roadmap ───────────────────────
-function resolveTimelineBucket(strategyId, roadmap) {
-    if (roadmap.quick_wins.some((r) => r.strategy_id === strategyId))
-        return "now";
-    if (roadmap.immediate.some((r) => r.strategy_id === strategyId))
-        return "now";
-    if (roadmap.thirty_day.some((r) => r.strategy_id === strategyId))
-        return "30d";
-    if (roadmap.ninety_day.some((r) => r.strategy_id === strategyId))
-        return "90d";
-    if (roadmap.annual.some((r) => r.strategy_id === strategyId))
-        return "filing";
-    return "filing";
-}
-// ── CalculationTrace → StrategyTraceStep[] ───────────────────────────
-function traceFromEngine(trace) {
-    var _a, _b;
-    const steps = [];
-    // Emit formula as step 1
-    if (trace.formula) {
-        steps.push({
-            n: 1,
-            step: "Formula",
-            formula: trace.formula,
-            result: trace.result_gross != null ? `$${trace.result_gross.toLocaleString()}` : "See CI",
-            src: trace.irs_cite || "",
-        });
-    }
-    // Emit confidence interval as step 2 when present
-    if (((_a = trace.confidence_interval) === null || _a === void 0 ? void 0 : _a.low) != null && ((_b = trace.confidence_interval) === null || _b === void 0 ? void 0 : _b.high) != null) {
-        steps.push({
-            n: 2,
-            step: "Confidence range",
-            formula: `Low × ${trace.confidence_interval.basis}`,
-            result: `$${trace.confidence_interval.low.toLocaleString()} – $${trace.confidence_interval.high.toLocaleString()}`,
-            src: trace.irs_cite || "",
-        });
-    }
-    return steps;
-}
-function adaptEngineOutput(engineOutput) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
-    const strategies = [];
-    const computedMap = new Map();
-    for (const analysis of engineOutput.strategy_analysis) {
-        if (analysis.priority_tier === "NOT_RECOMMENDED")
-            continue;
-        const rank = ENGINE_ID_TO_RANK[analysis.strategy_id];
-        const template = rank != null ? CATALOG_BY_RANK.get(rank) : undefined;
-        const trace = analysis.calculation_trace;
-        const ci = trace === null || trace === void 0 ? void 0 : trace.confidence_interval;
-        const lo = (_b = (_a = ci === null || ci === void 0 ? void 0 : ci.low) !== null && _a !== void 0 ? _a : template === null || template === void 0 ? void 0 : template.lo) !== null && _b !== void 0 ? _b : 0;
-        const hi = (_d = (_c = ci === null || ci === void 0 ? void 0 : ci.high) !== null && _c !== void 0 ? _c : template === null || template === void 0 ? void 0 : template.hi) !== null && _d !== void 0 ? _d : 0;
-        const timelineBucket = resolveTimelineBucket(analysis.strategy_id, engineOutput.implementation_roadmap);
-        const clientSummaryEntry = engineOutput.client_summary.strategies.find((cs) => cs.strategy_name === analysis.strategy_name);
-        const strategy = {
-            rank: rank !== null && rank !== void 0 ? rank : 99,
-            code: (_e = template === null || template === void 0 ? void 0 : template.code) !== null && _e !== void 0 ? _e : analysis.strategy_id,
-            name: analysis.strategy_name,
-            cat: (_f = template === null || template === void 0 ? void 0 : template.cat) !== null && _f !== void 0 ? _f : "deductions",
-            priority: mapPriority(analysis.priority_tier, analysis.quick_win),
-            score: Math.round(analysis.weighted_score),
-            entities: (_g = template === null || template === void 0 ? void 0 : template.entities) !== null && _g !== void 0 ? _g : ["S-Corporation", "C-Corporation", "Partnership/LLC", "Sole Proprietorship"],
-            lo,
-            hi,
-            timeline: (_h = template === null || template === void 0 ? void 0 : template.timeline) !== null && _h !== void 0 ? _h : timelineBucket,
-            timelineBucket,
-            authority: (_j = trace === null || trace === void 0 ? void 0 : trace.irs_cite) !== null && _j !== void 0 ? _j : template === null || template === void 0 ? void 0 : template.authority,
-            forms: (_l = (_k = trace === null || trace === void 0 ? void 0 : trace.forms_required) === null || _k === void 0 ? void 0 : _k.join(", ")) !== null && _l !== void 0 ? _l : template === null || template === void 0 ? void 0 : template.forms,
-            warning: (_o = (_m = analysis.risk_disclosure) !== null && _m !== void 0 ? _m : template === null || template === void 0 ? void 0 : template.warning) !== null && _o !== void 0 ? _o : null,
-            abstract: analysis.engagement_recommendation,
-            trace: traceFromEngine(trace),
-            needsPTE: template === null || template === void 0 ? void 0 : template.needsPTE,
-            onlyIndustry: template === null || template === void 0 ? void 0 : template.onlyIndustry,
-            excludeIndustry: template === null || template === void 0 ? void 0 : template.excludeIndustry,
-            preferIndustry: template === null || template === void 0 ? void 0 : template.preferIndustry,
-            minEmployees: template === null || template === void 0 ? void 0 : template.minEmployees,
-            needsOwnerComp: template === null || template === void 0 ? void 0 : template.needsOwnerComp,
-            clientBrief: (_p = clientSummaryEntry === null || clientSummaryEntry === void 0 ? void 0 : clientSummaryEntry.why_it_applies) !== null && _p !== void 0 ? _p : template === null || template === void 0 ? void 0 : template.clientBrief,
-            action: (_q = clientSummaryEntry === null || clientSummaryEntry === void 0 ? void 0 : clientSummaryEntry.next_step) !== null && _q !== void 0 ? _q : template === null || template === void 0 ? void 0 : template.action,
-            sourceDocuments: (_r = trace === null || trace === void 0 ? void 0 : trace.source_documents) !== null && _r !== void 0 ? _r : [],
-            quickWin: analysis.quick_win,
-            positionStrength: (_s = trace === null || trace === void 0 ? void 0 : trace.position_strength) !== null && _s !== void 0 ? _s : undefined,
-            specialistNote: (_t = trace === null || trace === void 0 ? void 0 : trace.specialist_note) !== null && _t !== void 0 ? _t : undefined,
-        };
-        strategies.push(strategy);
-        computedMap.set(strategy.rank, {
-            lo,
-            hi,
-            trace: strategy.trace,
-        });
-    }
-    // Sort by weighted_score descending (same ordering the FE uses)
-    strategies.sort((a, b) => b.score - a.score);
-    return { strategies, computedMap, engineOutput };
-}
-// ── React hook ────────────────────────────────────────────────────────
-function useEngineOutput(engineOutput) {
-    return (0, react_1.useMemo)(() => {
-        if (!engineOutput)
-            return null;
-        return adaptEngineOutput(engineOutput);
-    }, [engineOutput]);
+// ---------------------------------------------------------------------------
+// Hook — pass-through stub (returns null, no mapping yet)
+// ---------------------------------------------------------------------------
+function useEngineOutput(_engineOutput) {
+    return (0, react_1.useMemo)(() => null, [_engineOutput]);
 }

package/lib/tax-axis/lib/data/documents.d.ts

@@ -1,4 +1,3 @@
-import { DocSpec } from "../types";
-export type TaxAxisEntityTypeKey = "S_CORP" | "C_CORP" | "PARTNERSHIP" | "LLC" | "SOLE_PROP";
+import type { ClientProfile, DocSpec } from "../types";
 export declare const DOC_SPECS_BASE: DocSpec[];
-export declare function getDocSpecs(entityType?: TaxAxisEntityTypeKey | string | null): DocSpec[];
+export declare function getDocSpecs(profile?: ClientProfile): DocSpec[];