@mx-cartographer/experiences 9.4.14 → 9.4.16

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## [9.4.16] - 09-03-2026
+
+- **ADDED** - insights-v2 overflow (“…”) menu on the insight card header: new presentational `OverflowMenu` (icon trigger + action list with full aria/keyboard support) and `InsightOptionsMenu`, which owns the item set — helpful / not helpful / hide — from `insights_feed.overflow_menu` copy. The host supplies the action handler via `beatActions.onMenuAction`, delivered through the new `BeatActionsProvider`/`useBeatActions` context; the menu renders only on the full (non-mini) layout when a handler is wired (WEC-1767)
+- **ADDED** - `OverflowMenuCopy` (`insights_feed.overflow_menu`) localization type and copy keys (`aria_label`, `helpful`, `not_helpful`, `hide`) (WEC-1767)
+
+## [9.4.15] - 09-03-2026
+
+- **ADDED** - Transaction History action block (single-bar): `transaction_history_block` registered in `mappings/blocks.ts`, rendering a `BarChartV2` over the beat's monthly `data_series` above a reused transactions `TransactionList` drilldown. Variant behavior (chart top, bar colors, drawer header, and the per-variant `filterStrategy`) is driven by `drillDownConfig`, covering the Transaction, CategorySpend, MonthlySpend, AccountBalance, and UpcomingBill variants (WEC-1701)
+- **ADDED** - Upcoming-bill drilldown synthesizes its chart bars from the beat's recurring-bill transactions plus a projected bill read off `instance_slot_data` (`buildUpcomingBillSeries`), de-duped by date and sorted oldest→newest with a `TRN-projected-bill` sentinel bar (WEC-1701)
+- **CHANGED** - Migrated insights-v2 instance-slot block names and bar-chart variant names to snake_case to match the backend contract: `BlockType` values, the `mappings/blocks.ts` map keys, `BAR_CHART_VARIANTS`, `BarchartBlock` layout keys, and the corresponding mock payloads (e.g. `bar_chart_block`, `category_color`, `monthly_spend_comparison`, `savings_account_balances_summary`, `budget_block`, `category_transactions_block`) (WEC-1701)
+- **CHANGED** - `buildChartData` accepts an optional date format (defaults to month-short; upcoming-bill passes month-day) and now carries each bar's `date` so chart tabs, filter indexing, and the drawer header stay aligned (WEC-1701)
+- **CHANGED** - `Legends` type made consistent: `additional_value`, `additional_value_type`, and `value_type` are now optional, and `instance_slot_data.legends` is typed as `Legends[]` (WEC-1701)
+- **CHANGED** - `drillDownConfig` type-hardened: `DataSeriesItem` replaces `any[]` for the data series shape; removed the unused `filterKind` field; `filterStrategy` is now a required discriminated union returning a typed `TransactionFilter` or `{ skip: true }` (WEC-1701)
+- **CHANGED** - `ActionDrawerState.context` stays `unknown` at the store level; drilldown components narrow to their expected payload shape via the new `useActionContext<DrilldownPayload>()` hook (WEC-1701)
+- **CHANGED** - `TransactionHistoryBlock` snapshots the shared transaction filter on mount and restores it on unmount via a `useLayoutEffect` cleanup function, keeping beat-specific filter state scoped to the block lifecycle instead of leaking into `InsightsV2Store` as a global concern (WEC-1701)
+- **FIXED** - Transaction History block renders the shared `EmptyBarChart` empty state instead of crashing when a single-bar or upcoming-bill beat produces no chart data (WEC-1701)
+- **FIXED** - Upcoming-bill drilldown rendered an empty chart because the recurring-bill scoping guids were read from the top-level `Beat`; they (plus `primary_transaction_guid` and `account_guids`) are now sourced from `instance_slot_data`, where the payload actually carries them, so the synthesized bars render again (WEC-1701)
+- **FIXED** - `TransactionHistoryBlock` `useLayoutEffect` deps now use stable joined-string keys (`beatTransactionGuidsKey`, `recurringBillGuidsKey`) instead of unmemoized computed arrays, preventing infinite render/fetch loops (WEC-1701)
+- **ADDED** - Unit tests for the Transaction History action block: `drillDownConfig` + filter strategies, `utils` (flattened series, upcoming-bill synthesis, drawer titles, default selection), the `useTransactionHistory` hook, `TransactionDrillDown`, the block render, `buildChartData` date-format behavior, and the block registry mapping (WEC-1701)
+
 ## [9.4.14] - 09-03-2026
 
 - **ADDED** - insights-v2 `TransactionDetailsBlock` action block: shared drawer content any transaction beat opens via `primary_cta.block = 'TransactionDetailsBlock'`. Resolves its subject transaction from `instance_slot_data.transaction_guid`, then `beat.primary_transaction_guid`, then `transaction_guids[0]`, preferring the `transactionStore` object over the payload snapshot so inline edits write through; maps backend action-name strings to the `TopActions`/`BottomActions` enums (unknown names dropped, `undefined` means defaults, `[]` means none); `useTransactionDetailsPrepare` loads transaction data at drawer-open time. Registered in `mappings/blocks.ts`, with a Storybook story (WEC-1499)

package/dist/core/types/Insights.d.ts

@@ -26,9 +26,9 @@ export interface InsightsPayload {
 export interface Legends {
     label: string;
     value: number;
-    additional_value: number;
-    additional_value_type: string;
-    value_type: string;
+    additional_value?: number;
+    additional_value_type?: string;
+    value_type?: string;
 }
 export interface Logo {
     category_guid?: string;
@@ -75,18 +75,18 @@ export interface Footer {
     account: string;
 }
 export declare const BlockType: {
-    readonly AccountBlock: "AccountBlock";
-    readonly BarChartBlock: "BarChartBlock";
-    readonly BudgetBlock: "BudgetBlock";
-    readonly CategoryTransactionsBlock: "CategoryTransactionsBlock";
-    readonly ImageBlock: "ImageBlock";
-    readonly DonutChartBlock: "DonutChartBlock";
-    readonly DoubleBarChartBlock: "DoubleBarChartBlock";
-    readonly DoubleProgressBarBlock: "DoubleProgressBarBlock";
-    readonly StepChartBlock: "StepChartBlock";
-    readonly SVGImageBlock: "SVGImageBlock";
+    readonly AccountBlock: "account_block";
+    readonly BarChartBlock: "bar_chart_block";
+    readonly BudgetBlock: "budget_block";
+    readonly CategoryTransactionsBlock: "category_transactions_block";
+    readonly ImageBlock: "image_block";
+    readonly DonutChartBlock: "donut_chart_block";
+    readonly DoubleBarChartBlock: "double_bar_chart_block";
+    readonly DoubleProgressBarBlock: "double_progress_bar_block";
+    readonly StepChartBlock: "step_chart_block";
+    readonly SVGImageBlock: "svg_image_block";
 };
-export type BlockType = keyof typeof BlockType;
+export type BlockType = (typeof BlockType)[keyof typeof BlockType];
 export interface InstanceSlot {
     block: BlockType;
     variant: string | null;

package/dist/core/types/InsightsInstanceSlotData.d.ts

@@ -4,9 +4,13 @@ export interface InsightsInstanceSlotData extends Partial<BarChartBlockData>, Pa
 }
 interface CommonProps {
     amount?: number;
-    legends?: (Legends | LegendProps)[];
+    date?: string;
+    legends?: Legends[];
     category_guid?: string;
     data_series?: DataSeries | DataSet[];
+    transaction_guids?: string[];
+    account_guids?: string[];
+    primary_transaction_guid?: string;
 }
 export interface BarChartBlockData {
     average_amount?: number;

package/dist/core/types/InsightsInstanceSlotData.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"InsightsInstanceSlotData.es.js","names":[],"sources":["../../../src/core/types/InsightsInstanceSlotData.ts"],"sourcesContent":["import type { DataSeries, Legends } from '../../core'\nimport type { Transaction } from './Transaction'\n\nexport interface InsightsInstanceSlotData\n  extends\n    Partial<BarChartBlockData>,\n    Partial<BudgetBlockData>,\n    Partial<DonutChartBlockData>,\n    Partial<DoubleProgressBarBlockData>,\n    Partial<ImageBlockData>,\n    Partial<AccountBlockData>,\n    Partial<SaveExtraBlockData>,\n    Partial<StepChartBlockData>,\n    Partial<SVGImageBlockData>,\n    Partial<CategoryTransactionsBlockData>,\n    Partial<AccountSwitchBlockData>,\n    Partial<TransactionDetailsBlockData>,\n    Partial<CommonProps> {}\n\n//when any of the type is used more than one times, we can use the common props\ninterface CommonProps {\n  amount?: number\n  legends?: (Legends | LegendProps)[]\n  category_guid?: string\n  data_series?: DataSeries | DataSet[]\n}\n\n//BarChart Block\nexport interface BarChartBlockData {\n  average_amount?: number\n  ariaLabel?: string\n}\n\n//DonutChart Block\ninterface Main {\n  value: string\n  value_type: string\n  label: string\n}\nexport interface DonutChartBlockData {\n  main: Main\n}\n\n//DoubleBarChart Block\n// TODO : This has to be revisited again to update the below types based on API response once we have the final shape of the data_series for double bar chart from BE\nexport interface LegendProps extends Legends {\n  amount: number\n  formattedAmount: string\n  label: string\n  color?: string\n}\n\nexport interface DataSet extends DataSeries {\n  ariaLabelComparison: string\n  ariaLabelMain: string\n  comparison: number\n  formattedComparison: string\n  formattedMain: string\n  label: string\n  main: number\n}\n\n//DoubleProgressBar Block\n\ninterface DoubleProgressBarProps {\n  label: string\n  value: number\n}\nexport interface DoubleProgressBarBlockData {\n  doubleProgressBar: {\n    previous: DoubleProgressBarProps\n    latest: DoubleProgressBarProps\n  }\n}\n\n//Image Block\nexport interface ImageBlockData {\n  image: string\n}\n\n//Account Block\nexport interface AccountBlockData {\n  sub_text: string\n  institution_guid?: string\n  institution_name?: string\n  icon_name?: string\n  /** Header bar text (standard card), or the colored category strip label (deposit cards). */\n  header_text?: string\n  // Deposit variants (Unified Deposit, Unified Deposit Emergency Fund, Savings Account Deposit)\n  /** Merchant guid — renders a real merchant logo in the deposit card when present. */\n  merchant_guid?: string\n  /** Merchant display name — logo alt text and the payer line under the amount. */\n  merchant_name?: string\n  /** Secondary label beside the amount, e.g. `On {date}, you saved` or `Balance as of MM/DD/YY`. */\n  label?: string\n}\n\nexport interface SaveExtraBlockData {\n  /** Styled segments `[lead-in, amount digits, trailing copy]`, e.g. `['Save an extra', '100', 'to help your funds grow']`. */\n  primary_text?: string[]\n  /** Styled segments `[projected balance, caption]`, e.g. `['$8,313.87', 'After payday & projected expenses']`. */\n  secondary_text?: string[]\n  /** MakeTransfer drilldown: available balance (both variants). */\n  available_balance?: number\n  /** SAVE_ENOUGH_TO_LIVE_ON: average monthly spend. */\n  avg_monthly_spend?: number\n  /** SAVE_ENOUGH_TO_LIVE_ON: how long the balance lasts, overlaid on the timeline SVG (e.g. \"2 months, 11 days\"). */\n  time_period?: string\n  /** SAVE_AN_EXTRA_100: upcoming expenses (the \"Expenses\" figure). */\n  upcoming_expenses?: number\n  /** SAVE_AN_EXTRA_100: total remaining after expenses. */\n  total_remaining?: number\n  /** SAVE_ENOUGH_TO_LIVE_ON: date for the \"Your available balances as of {date}\" line. */\n  date?: string\n}\n\n//AccountSwitch Block\nexport interface AccountSwitchBlockData {\n  discovered_institution_guid: string\n  discovered_institution_name: string\n  held_institution_guid: string\n  held_institution_name: string\n  is_connected: boolean\n}\n\n// StepChart Block\nexport interface StepChartBlockData {\n  completed_steps: number\n  label_1: string\n  label_2?: string\n}\n\n//Budgets Blocks\nexport enum BudgetTierType {\n  LOW_BUDGET_TIER = 'LOW',\n  MEDIUM_BUDGET_TIER = 'MEDIUM',\n  OFF_TRACK_BUDGET_TIER = 'OFF_TRACK',\n}\n\nexport type BudgetTierValue = `${BudgetTierType}`\n\nexport interface BudgetLocalizedPayload {\n  primary_text?: string\n  amount_left_label?: string\n  spent_label?: string\n  budgeted_label?: string\n}\n\nexport interface BudgetBlockData {\n  budget_percent: number\n  budget_tier: BudgetTierValue\n  category_guid?: string\n  merchant_guid?: string\n  spent_amount: number\n  budgeted_amount: number\n  localized_payload: BudgetLocalizedPayload\n}\n\nexport interface SVGImageBlockData {\n  isCIBC?: boolean\n}\n\nexport type InsightTransaction = Pick<Transaction, 'amount'> &\n  Partial<Pick<Transaction, 'category_guid' | 'date' | 'description' | 'merchant_guid'>> & {\n    merchant_name?: string\n  }\n\nexport interface CategoryTransactionsBlockData {\n  primary_transaction?: InsightTransaction\n}\n\n// TransactionDetails Action Block\nexport interface TransactionDetailsBlockData {\n  /**\n   * Explicit subject of the details drawer. Optional: the block falls back to\n   * `beat.primary_transaction_guid`, then `beat.transaction_guids[0]`.\n   */\n  transaction_guid?: string\n  /** `TopActions` member names, e.g. `['Category', 'Date', 'Memo']`. Omit for the defaults. */\n  top_actions?: string[]\n  /** `BottomActions` member names, e.g. `['MerchantBudget', 'HideTransaction']`. Omit for defaults. */\n  bottom_actions?: string[]\n}\n"],"mappings":"AAqIA,IAAY,IAAL,0BAAA,GAAA;AACL,SAAA,EAAA,kBAAA,OACA,EAAA,qBAAA,UACA,EAAA,wBAAA;AACF,GAAA,CAAA,CAAA"}
+{"version":3,"file":"InsightsInstanceSlotData.es.js","names":[],"sources":["../../../src/core/types/InsightsInstanceSlotData.ts"],"sourcesContent":["import type { DataSeries, Legends } from '../../core'\nimport type { Transaction } from './Transaction'\n\nexport interface InsightsInstanceSlotData\n  extends\n    Partial<BarChartBlockData>,\n    Partial<BudgetBlockData>,\n    Partial<DonutChartBlockData>,\n    Partial<DoubleProgressBarBlockData>,\n    Partial<ImageBlockData>,\n    Partial<AccountBlockData>,\n    Partial<SaveExtraBlockData>,\n    Partial<StepChartBlockData>,\n    Partial<SVGImageBlockData>,\n    Partial<CategoryTransactionsBlockData>,\n    Partial<AccountSwitchBlockData>,\n    Partial<TransactionDetailsBlockData>,\n    Partial<CommonProps> {}\n\n//when any of the type is used more than one times, we can use the common props\ninterface CommonProps {\n  amount?: number\n  date?: string\n  legends?: Legends[]\n  category_guid?: string\n  data_series?: DataSeries | DataSet[]\n  transaction_guids?: string[]\n  account_guids?: string[]\n  primary_transaction_guid?: string\n}\n\n//BarChart Block\nexport interface BarChartBlockData {\n  average_amount?: number\n  ariaLabel?: string\n}\n\n//DonutChart Block\ninterface Main {\n  value: string\n  value_type: string\n  label: string\n}\nexport interface DonutChartBlockData {\n  main: Main\n}\n\n//DoubleBarChart Block\n// TODO : This has to be revisited again to update the below types based on API response once we have the final shape of the data_series for double bar chart from BE\nexport interface LegendProps extends Legends {\n  amount: number\n  formattedAmount: string\n  label: string\n  color?: string\n}\n\nexport interface DataSet extends DataSeries {\n  ariaLabelComparison: string\n  ariaLabelMain: string\n  comparison: number\n  formattedComparison: string\n  formattedMain: string\n  label: string\n  main: number\n}\n\n//DoubleProgressBar Block\n\ninterface DoubleProgressBarProps {\n  label: string\n  value: number\n}\nexport interface DoubleProgressBarBlockData {\n  doubleProgressBar: {\n    previous: DoubleProgressBarProps\n    latest: DoubleProgressBarProps\n  }\n}\n\n//Image Block\nexport interface ImageBlockData {\n  image: string\n}\n\n//Account Block\nexport interface AccountBlockData {\n  sub_text: string\n  institution_guid?: string\n  institution_name?: string\n  icon_name?: string\n  /** Header bar text (standard card), or the colored category strip label (deposit cards). */\n  header_text?: string\n  // Deposit variants (Unified Deposit, Unified Deposit Emergency Fund, Savings Account Deposit)\n  /** Merchant guid — renders a real merchant logo in the deposit card when present. */\n  merchant_guid?: string\n  /** Merchant display name — logo alt text and the payer line under the amount. */\n  merchant_name?: string\n  /** Secondary label beside the amount, e.g. `On {date}, you saved` or `Balance as of MM/DD/YY`. */\n  label?: string\n}\n\nexport interface SaveExtraBlockData {\n  /** Styled segments `[lead-in, amount digits, trailing copy]`, e.g. `['Save an extra', '100', 'to help your funds grow']`. */\n  primary_text?: string[]\n  /** Styled segments `[projected balance, caption]`, e.g. `['$8,313.87', 'After payday & projected expenses']`. */\n  secondary_text?: string[]\n  /** MakeTransfer drilldown: available balance (both variants). */\n  available_balance?: number\n  /** SAVE_ENOUGH_TO_LIVE_ON: average monthly spend. */\n  avg_monthly_spend?: number\n  /** SAVE_ENOUGH_TO_LIVE_ON: how long the balance lasts, overlaid on the timeline SVG (e.g. \"2 months, 11 days\"). */\n  time_period?: string\n  /** SAVE_AN_EXTRA_100: upcoming expenses (the \"Expenses\" figure). */\n  upcoming_expenses?: number\n  /** SAVE_AN_EXTRA_100: total remaining after expenses. */\n  total_remaining?: number\n  /** SAVE_ENOUGH_TO_LIVE_ON: date for the \"Your available balances as of {date}\" line. */\n  date?: string\n}\n\n//AccountSwitch Block\nexport interface AccountSwitchBlockData {\n  discovered_institution_guid: string\n  discovered_institution_name: string\n  held_institution_guid: string\n  held_institution_name: string\n  is_connected: boolean\n}\n\n// StepChart Block\nexport interface StepChartBlockData {\n  completed_steps: number\n  label_1: string\n  label_2?: string\n}\n\n//Budgets Blocks\nexport enum BudgetTierType {\n  LOW_BUDGET_TIER = 'LOW',\n  MEDIUM_BUDGET_TIER = 'MEDIUM',\n  OFF_TRACK_BUDGET_TIER = 'OFF_TRACK',\n}\n\nexport type BudgetTierValue = `${BudgetTierType}`\n\nexport interface BudgetLocalizedPayload {\n  primary_text?: string\n  amount_left_label?: string\n  spent_label?: string\n  budgeted_label?: string\n}\n\nexport interface BudgetBlockData {\n  budget_percent: number\n  budget_tier: BudgetTierValue\n  category_guid?: string\n  merchant_guid?: string\n  spent_amount: number\n  budgeted_amount: number\n  localized_payload: BudgetLocalizedPayload\n}\n\nexport interface SVGImageBlockData {\n  isCIBC?: boolean\n}\n\nexport type InsightTransaction = Pick<Transaction, 'amount'> &\n  Partial<Pick<Transaction, 'category_guid' | 'date' | 'description' | 'merchant_guid'>> & {\n    merchant_name?: string\n  }\n\nexport interface CategoryTransactionsBlockData {\n  primary_transaction?: InsightTransaction\n}\n\n// TransactionDetails Action Block\nexport interface TransactionDetailsBlockData {\n  /**\n   * Explicit subject of the details drawer. Optional: the block falls back to\n   * `beat.primary_transaction_guid`, then `beat.transaction_guids[0]`.\n   */\n  transaction_guid?: string\n  /** `TopActions` member names, e.g. `['Category', 'Date', 'Memo']`. Omit for the defaults. */\n  top_actions?: string[]\n  /** `BottomActions` member names, e.g. `['MerchantBudget', 'HideTransaction']`. Omit for defaults. */\n  bottom_actions?: string[]\n}\n"],"mappings":"AAyIA,IAAY,IAAL,0BAAA,GAAA;AACL,SAAA,EAAA,kBAAA,OACA,EAAA,qBAAA,UACA,EAAA,wBAAA;AACF,GAAA,CAAA,CAAA"}

package/dist/core/types/localization/InsightsFeedCopy.d.ts

@@ -48,9 +48,30 @@ export interface MakeTransferCopy {
     increment_aria_label: string;
     decrement_aria_label: string;
 }
+export interface OverflowMenuCopy {
+    /** Accessible label for the "…" trigger button. */
+    aria_label: string;
+    helpful: string;
+    not_helpful: string;
+    hide: string;
+}
+export interface TransactionHistoryBlock {
+    category_spend_drawer_title: string;
+    monthly_spend_comparison_drawer_title: string;
+    savings_account_balances_summary_drawer_title: string;
+    upcoming_bill_drawer_title: string;
+    monthly_spend_to_income_drawer_title: string;
+    monthly_debt_to_income_drawer_title: string;
+    monthly_savings_to_income_drawer_title: string;
+    cost_living_to_income_drawer_title: string;
+    non_essential_category_summary_drawer_title: string;
+    monthly_deposit_summary_drawer_title: string;
+}
 export interface InsightsFeedCopy {
     general: GeneralInsightsFeedCopy;
     settings_menu: SettingsMenuCopy;
     make_transfer: MakeTransferCopy;
+    overflow_menu: OverflowMenuCopy;
+    transaction_history_block: TransactionHistoryBlock;
 }
 export {};

package/dist/core/types/localization/index.d.ts

@@ -13,7 +13,7 @@ export type { DebtsCopy } from './DebtsCopy';
 export type { FinstrongCopy } from './FinstrongCopy';
 export type { GoalsCopy } from './GoalsCopy';
 export type { HelpCopy, HelpByCategoryList } from './HelpCopy';
-export type { InsightsFeedCopy, MakeTransferCopy } from './InsightsFeedCopy';
+export type { InsightsFeedCopy, MakeTransferCopy, OverflowMenuCopy } from './InsightsFeedCopy';
 export type { InvestmentsCopy } from './InvestmentsCopy';
 export type { MicroInsightsCopy } from './MicroInsightsCopy';
 export type { NetWorthCopy } from './NetWorthCopy';

package/dist/insights-v2/CommonUtils.d.ts

@@ -1 +1,3 @@
+import { Transaction } from '../core';
 export declare const formatValueByType: (value: number, type: string, format: string) => string;
+export declare const selectTransactionsByGuids: (detailedTransactions: Transaction[], guids: string[] | undefined) => Transaction[];

package/dist/insights-v2/CommonUtils.es.js

@@ -1,7 +1,12 @@
-import { formatCurrency as e } from "../core/utils/NumberFormatting.es.js";
-var f = (r, t, n) => t === "amount" ? e(r, n) : t === "percent" ? `${r}%` : String(r);
+import { formatCurrency as i } from "../core/utils/NumberFormatting.es.js";
+var u = (r, t, e) => t === "amount" ? i(r, e) : t === "percent" ? `${r}%` : String(r), a = (r, t) => {
+  if (!t?.length) return [];
+  const e = new Set(t);
+  return r.filter((n) => e.has(n.guid));
+};
 export {
-  f as formatValueByType
+  u as formatValueByType,
+  a as selectTransactionsByGuids
 };
 
 //# sourceMappingURL=CommonUtils.es.js.map

package/dist/insights-v2/CommonUtils.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommonUtils.es.js","names":[],"sources":["../../src/insights-v2/CommonUtils.ts"],"sourcesContent":["import { formatCurrency } from '../core/utils/NumberFormatting'\n\nexport const formatValueByType = (value: number, type: string, format: string): string => {\n  if (type === 'amount') return formatCurrency(value, format)\n  if (type === 'percent') return `${value}%`\n  return String(value)\n}\n"],"mappings":";AAEA,IAAa,IAAA,CAAqB,GAAe,GAAc,MACzD,MAAS,WAAiB,EAAe,GAAO,CAAM,IACtD,MAAS,YAAkB,GAAG,CAAA,MAC3B,OAAO,CAAK"}
+{"version":3,"file":"CommonUtils.es.js","names":[],"sources":["../../src/insights-v2/CommonUtils.ts"],"sourcesContent":["import type { Transaction } from '../core'\nimport { formatCurrency } from '../core/utils/NumberFormatting'\n\nexport const formatValueByType = (value: number, type: string, format: string): string => {\n  if (type === 'amount') return formatCurrency(value, format)\n  if (type === 'percent') return `${value}%`\n  return String(value)\n}\n\nexport const selectTransactionsByGuids = (\n  detailedTransactions: Transaction[],\n  guids: string[] | undefined,\n): Transaction[] => {\n  if (!guids?.length) return []\n  const guidSet = new Set(guids)\n  return detailedTransactions.filter((transaction) => guidSet.has(transaction.guid))\n}\n"],"mappings":";AAGA,IAAa,IAAA,CAAqB,GAAe,GAAc,MACzD,MAAS,WAAiB,EAAe,GAAO,CAAM,IACtD,MAAS,YAAkB,GAAG,CAAA,MAC3B,OAAO,CAAK,GAGR,IAAA,CACX,GACA,MACkB;AAClB,MAAI,CAAC,GAAO,OAAQ,QAAO,CAAC;AAC5B,QAAM,IAAU,IAAI,IAAI,CAAK;AAC7B,SAAO,EAAqB,OAAA,CAAQ,MAAgB,EAAQ,IAAI,EAAY,IAAI,CAAC;AACnF"}

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionDrillDown.d.ts

@@ -0,0 +1,22 @@
+import { default as React } from 'react';
+import { Transaction } from '../../../core';
+interface TabItem {
+    label: string;
+    ariaLabel?: string;
+}
+interface TransactionDrillDownProps {
+    ariaLabel?: string;
+    heading?: string;
+    subHeadingText?: string;
+    icon?: React.ReactNode;
+    tabs?: TabItem[];
+    selectedIndex: number;
+    top: React.ReactNode;
+    onSelectionChange?: (selectedIndex: number) => void;
+    transactionFilter?: (selectedIndex: number) => (transaction: Transaction) => boolean;
+    baseTransactions?: Transaction[];
+}
+export declare const TransactionDrillDown: (({ ariaLabel, heading, subHeadingText, icon, tabs, selectedIndex, top, onSelectionChange, transactionFilter, baseTransactions, }: TransactionDrillDownProps) => import("react/jsx-runtime").JSX.Element) & {
+    displayName: string;
+};
+export default TransactionDrillDown;

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionDrillDown.es.js

@@ -0,0 +1,108 @@
+import { useGlobalCopyStore as W, useGlobalUiStore as $, useTransactionStore as j } from "../../../common/context/hooks.es.js";
+import { exportTransactionsToCSV as k } from "../../../core/utils/TransactionUtils.es.js";
+import G from "../../../common/components/Loader.es.js";
+import P from "../../../transactions/components/shared/TransactionList.es.js";
+import "react";
+import { observer as A } from "mobx-react-lite";
+import c from "@mui/material/Stack";
+import { H3 as E, Text as d } from "@mxenabled/mxui";
+import N from "@mui/material/Button";
+import { Icon as R } from "@mxenabled/mx-icons";
+import { jsx as r, jsxs as o } from "react/jsx-runtime";
+import p from "@mui/material/Box";
+import U from "@mui/material/Tab";
+import V from "@mui/material/Tabs";
+var u = "transaction-drill-down-panel", v = (m) => `transaction-details-tab-${m}`, ar = A(function({ ariaLabel: T, heading: i, subHeadingText: n, icon: y, tabs: b, selectedIndex: e, top: C, onSelectionChange: g, transactionFilter: f, baseTransactions: _ }) {
+  const { transactions: l } = W(), { isCopyLoaded: w } = $(), { sortedTransactionsWithSplits: D, tags: S, detailedTransactions: L } = j();
+  if (!w) return /* @__PURE__ */ r(G, {});
+  const s = !!b?.length, B = T ?? l.transactions_title, I = (t, a) => {
+    g?.(a);
+  }, h = f ? (_ ?? L).filter(f(e)) : void 0, x = h ?? D;
+  return /* @__PURE__ */ o(p, {
+    sx: {
+      bgcolor: "background.paper",
+      width: "100%"
+    },
+    children: [s && /* @__PURE__ */ r(V, {
+      "aria-label": B,
+      onChange: I,
+      value: e,
+      variant: "fullWidth",
+      children: b.map((t, a) => /* @__PURE__ */ r(U, {
+        "aria-controls": u,
+        "aria-label": t.ariaLabel,
+        id: v(a),
+        label: t.label,
+        sx: {
+          minWidth: "auto",
+          px: 0
+        }
+      }, `${t.label}-${a}`))
+    }), /* @__PURE__ */ o(p, {
+      "aria-labelledby": s ? v(e) : void 0,
+      id: u,
+      role: s ? "tabpanel" : void 0,
+      children: [
+        (i || n) && /* @__PURE__ */ o(c, {
+          sx: {
+            gap: 4,
+            pt: 16,
+            px: 24
+          },
+          children: [i && /* @__PURE__ */ r(E, { children: i }), n && /* @__PURE__ */ o(c, {
+            sx: {
+              alignItems: "center",
+              flexDirection: "row",
+              gap: 8
+            },
+            children: [y, /* @__PURE__ */ r(d, {
+              textTransform: "uppercase",
+              variant: "body2",
+              children: n
+            })]
+          })]
+        }),
+        /* @__PURE__ */ r(p, {
+          sx: { pt: 16 },
+          children: C
+        }),
+        /* @__PURE__ */ o(c, {
+          sx: {
+            alignItems: "center",
+            borderBottomColor: "divider",
+            borderBottomStyle: "solid",
+            borderBottomWidth: 1,
+            flexDirection: "row",
+            justifyContent: "space-between",
+            pb: 4,
+            pt: 16,
+            px: 24
+          },
+          children: [/* @__PURE__ */ r(d, {
+            bold: !0,
+            variant: "body1",
+            children: l.transactions_title
+          }), x.length > 0 && /* @__PURE__ */ r(N, {
+            onClick: () => {
+              k(x, S);
+            },
+            startIcon: /* @__PURE__ */ r(R, { name: "ios_share" }),
+            sx: { height: 28 },
+            children: /* @__PURE__ */ r(d, {
+              bold: !0,
+              variant: "body2",
+              children: l.export_csv_btn
+            })
+          })]
+        }),
+        /* @__PURE__ */ r(P, { transaction: h })
+      ]
+    })]
+  });
+});
+export {
+  ar as TransactionDrillDown,
+  ar as default
+};
+
+//# sourceMappingURL=TransactionDrillDown.es.js.map

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionDrillDown.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionDrillDown.es.js","names":[],"sources":["../../../../src/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionDrillDown.tsx"],"sourcesContent":["import React from 'react'\n\nimport Box from '@mui/material/Box'\nimport Button from '@mui/material/Button'\nimport Stack from '@mui/material/Stack'\nimport Tab from '@mui/material/Tab'\nimport Tabs from '@mui/material/Tabs'\nimport { observer } from 'mobx-react-lite'\n\nimport { Icon } from '@mxenabled/mx-icons'\nimport { H3, Text } from '@mxenabled/mxui'\n\nimport { Loader, useGlobalCopyStore, useGlobalUiStore, useTransactionStore } from '../../../common'\nimport type { Transaction } from '../../../core'\nimport { exportTransactionsToCSV } from '../../../core/utils/TransactionUtils'\nimport { TransactionList } from '../../../transactions'\n\ninterface TabItem {\n  label: string\n  ariaLabel?: string\n}\n\nconst PANEL_ID = 'transaction-drill-down-panel'\nconst tabId = (index: number) => `transaction-details-tab-${index}`\n\ninterface TransactionDrillDownProps {\n  ariaLabel?: string\n  heading?: string\n  subHeadingText?: string\n  icon?: React.ReactNode\n  tabs?: TabItem[]\n  selectedIndex: number\n  top: React.ReactNode\n  onSelectionChange?: (selectedIndex: number) => void\n  transactionFilter?: (selectedIndex: number) => (transaction: Transaction) => boolean\n  baseTransactions?: Transaction[]\n}\n\nexport const TransactionDrillDown = observer(function TransactionDrillDown({\n  ariaLabel,\n  heading,\n  subHeadingText,\n  icon,\n  tabs,\n  selectedIndex,\n  top,\n  onSelectionChange,\n  transactionFilter,\n  baseTransactions,\n}: TransactionDrillDownProps) {\n  const { transactions: transactionsCopy } = useGlobalCopyStore()\n  const { isCopyLoaded } = useGlobalUiStore()\n  const { sortedTransactionsWithSplits, tags, detailedTransactions } = useTransactionStore()\n\n  if (!isCopyLoaded) return <Loader />\n\n  const hasTabs = !!tabs?.length\n  const tablistLabel = ariaLabel ?? transactionsCopy.transactions_title\n\n  const handlePrimaryChange = (_event: React.SyntheticEvent, newValue: number) => {\n    onSelectionChange?.(newValue)\n  }\n\n  const filteredTransactions = transactionFilter\n    ? (baseTransactions ?? detailedTransactions).filter(transactionFilter(selectedIndex))\n    : undefined\n\n  const exportTransactions = filteredTransactions ?? sortedTransactionsWithSplits\n\n  return (\n    <Box sx={{ bgcolor: 'background.paper', width: '100%' }}>\n      {hasTabs && (\n        <Tabs\n          aria-label={tablistLabel}\n          onChange={handlePrimaryChange}\n          value={selectedIndex}\n          variant=\"fullWidth\"\n        >\n          {tabs!.map((tab, index) => (\n            <Tab\n              aria-controls={PANEL_ID}\n              aria-label={tab.ariaLabel}\n              id={tabId(index)}\n              key={`${tab.label}-${index}`}\n              label={tab.label}\n              sx={{ minWidth: 'auto', px: 0 }}\n            />\n          ))}\n        </Tabs>\n      )}\n\n      <Box\n        aria-labelledby={hasTabs ? tabId(selectedIndex) : undefined}\n        id={PANEL_ID}\n        role={hasTabs ? 'tabpanel' : undefined}\n      >\n        {(heading || subHeadingText) && (\n          <Stack sx={{ gap: 4, pt: 16, px: 24 }}>\n            {heading && <H3>{heading}</H3>}\n            {subHeadingText && (\n              <Stack sx={{ alignItems: 'center', flexDirection: 'row', gap: 8 }}>\n                {icon}\n                <Text textTransform=\"uppercase\" variant=\"body2\">\n                  {subHeadingText}\n                </Text>\n              </Stack>\n            )}\n          </Stack>\n        )}\n\n        <Box sx={{ pt: 16 }}>{top}</Box>\n\n        <Stack\n          sx={{\n            alignItems: 'center',\n            borderBottomColor: 'divider',\n            borderBottomStyle: 'solid',\n            borderBottomWidth: 1,\n            flexDirection: 'row',\n            justifyContent: 'space-between',\n            pb: 4,\n            pt: 16,\n            px: 24,\n          }}\n        >\n          <Text bold={true} variant=\"body1\">\n            {transactionsCopy.transactions_title}\n          </Text>\n          {exportTransactions.length > 0 && (\n            <Button\n              onClick={() => {\n                exportTransactionsToCSV(exportTransactions, tags)\n              }}\n              startIcon={<Icon name=\"ios_share\" />}\n              sx={{ height: 28 }}\n            >\n              <Text bold={true} variant=\"body2\">\n                {transactionsCopy.export_csv_btn}\n              </Text>\n            </Button>\n          )}\n        </Stack>\n\n        <TransactionList transaction={filteredTransactions} />\n      </Box>\n    </Box>\n  )\n})\n\nexport default TransactionDrillDown\n"],"mappings":"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"}

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock.d.ts

@@ -0,0 +1,8 @@
+import { Beat } from '../../../core';
+interface TransactionHistoryProp {
+    beat: Beat;
+}
+export declare const TransactionHistoryBlock: (({ beat }: TransactionHistoryProp) => import("react/jsx-runtime").JSX.Element) & {
+    displayName: string;
+};
+export {};

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock.es.js

@@ -0,0 +1,89 @@
+import { useInsightsV2Store as E } from "../../../common/context/hooks.es.js";
+import { formatCurrency as M } from "../../../core/utils/NumberFormatting.es.js";
+import { BarChartV2 as N } from "../../components/chartblocks/BarchartV2.es.js";
+import { EmptyBarChart as P } from "../../components/chartblocks/EmptyBarChart.es.js";
+import { TransactionDrillDown as R } from "./TransactionDrillDown.es.js";
+import { useTransactionHistory as q } from "./useTransactionHistory.es.js";
+import { getDefaultSelection as z, getDrillDownConfig as J, getFlattenedDataSeries as O, toStoreFilter as Q } from "./utils.es.js";
+import { useLayoutEffect as U, useState as W } from "react";
+import { observer as X } from "mobx-react-lite";
+import { jsx as m } from "react/jsx-runtime";
+import { useTheme as Y } from "@mui/material/styles";
+var ct = X(({ beat: e }) => {
+  const g = Y(), { instanceSlotData: a, beatTransactions: n, primaryTransaction: T, spendCategoryGuids: u, allAccountGuids: p, categoryName: C, displayedDateRange: l, transactionStore: v } = q(e), { actionDrawer: h } = E(), { insights_payload: y } = e, D = h.trigger === "secondaryCta" ? y?.secondary_cta?.variant : y?.primary_cta?.variant, { top: c, filterMode: i, header: S, colors: x, filterStrategy: L } = J(D ?? ""), { dataSeries: s, chartData: o, comparisonBars: B } = O({
+    data: a?.data_series,
+    ariaLabel: a?.ariaLabel ?? "",
+    top: c,
+    beatTransactions: n,
+    payload: a
+  }), { chartBarIndex: I, subTabIndex: _ } = z({
+    chartTabCount: o.length,
+    comparisonTabCount: B.length,
+    actionDrawer: h,
+    beatGuid: e.guid
+  }), [r, b] = W(I), f = (t) => L({
+    beat: e,
+    beatTransactions: n,
+    dataSeries: s,
+    selectedIndex: t,
+    subIndex: _,
+    isLastTab: t === s.length - 1,
+    instanceSlotData: a,
+    spendCategoryGuids: u,
+    displayedDateRange: l
+  }), G = n.map((t) => t.guid).join(","), A = u.join(","), F = p.join(",");
+  U(() => {
+    i !== "store" || !s.length || v.setFilter(Q(f(r), {
+      allAccountGuids: p,
+      displayedDateRange: l
+    }));
+  }, [
+    e.guid,
+    r,
+    i,
+    s.length,
+    a,
+    l,
+    A,
+    F,
+    G
+  ]);
+  const d = S?.({
+    htmlTitle: e.html_title,
+    primaryTransaction: T,
+    categoryName: C,
+    selectedDate: o[r]?.date ?? void 0
+  }), j = x(g, a?.category_guid), [H, w] = (a?.legends ?? []).map((t) => t.label), K = i === "local" ? (t) => f(t).custom ?? (() => !0) : void 0, V = i === "local" ? n : void 0, k = c === "singleBar" || c === "upcomingBill" ? o.length ? /* @__PURE__ */ m(N, {
+    amounts: {
+      average: a?.average_amount,
+      formattedAverage: M(a?.average_amount ?? 0, "0,0.00")
+    },
+    color: j[0] ?? g.palette.primary.main,
+    data: o,
+    legendPosition: "top",
+    monthlyAmountLabel: H,
+    onBarClick: b,
+    selectedTabIndex: r,
+    trendAmountLabel: w
+  }) : /* @__PURE__ */ m(P, {}) : null;
+  return /* @__PURE__ */ m(R, {
+    ariaLabel: a?.ariaLabel,
+    baseTransactions: V,
+    heading: d?.heading,
+    icon: d?.icon,
+    onSelectionChange: b,
+    selectedIndex: r,
+    subHeadingText: d?.subHeadingText,
+    tabs: o.map((t) => ({
+      ariaLabel: t.ariaLabel,
+      label: t.label
+    })),
+    top: k,
+    transactionFilter: K
+  });
+});
+export {
+  ct as TransactionHistoryBlock
+};
+
+//# sourceMappingURL=TransactionHistoryBlock.es.js.map

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionHistoryBlock.es.js","names":[],"sources":["../../../../src/insights-v2/actionBlocks/TransactionHistoryBlock/TransactionHistoryBlock.tsx"],"sourcesContent":["import { useLayoutEffect, useState } from 'react'\n\nimport { useTheme } from '@mui/material/styles'\nimport { observer } from 'mobx-react-lite'\n\nimport type { Beat, DataSeries, Transaction } from '../../../core'\nimport { formatCurrency } from '../../../core/utils/NumberFormatting'\nimport { BarChartV2 } from '../../components/chartblocks/BarchartV2'\nimport { EmptyBarChart } from '../../components/chartblocks/EmptyBarChart'\n\nimport { TransactionDrillDown } from './TransactionDrillDown'\nimport { useTransactionHistory } from './useTransactionHistory'\nimport {\n  getDefaultSelection,\n  getDrillDownConfig,\n  getFlattenedDataSeries,\n  toStoreFilter,\n} from './utils'\nimport { useInsightsV2Store } from '../../../common'\n\ninterface TransactionHistoryProp {\n  beat: Beat\n}\n\nexport const TransactionHistoryBlock = observer(({ beat }: TransactionHistoryProp) => {\n  const theme = useTheme()\n  const {\n    instanceSlotData,\n    beatTransactions,\n    primaryTransaction,\n    spendCategoryGuids,\n    allAccountGuids,\n    categoryName,\n    displayedDateRange,\n    transactionStore,\n  } = useTransactionHistory(beat)\n\n  const { actionDrawer } = useInsightsV2Store()\n\n  const { insights_payload } = beat\n\n  const dynamicCtaVariant =\n    actionDrawer.trigger === 'secondaryCta'\n      ? insights_payload?.secondary_cta?.variant\n      : insights_payload?.primary_cta?.variant\n\n  const { top, filterMode, header, colors, filterStrategy } = getDrillDownConfig(\n    dynamicCtaVariant ?? '',\n  )\n\n  const { dataSeries, chartData, comparisonBars } = getFlattenedDataSeries({\n    data: instanceSlotData?.data_series as DataSeries,\n    ariaLabel: instanceSlotData?.ariaLabel ?? '',\n    top,\n    beatTransactions,\n    payload: instanceSlotData,\n  })\n\n  const { chartBarIndex, subTabIndex } = getDefaultSelection({\n    chartTabCount: chartData.length,\n    comparisonTabCount: comparisonBars.length,\n    actionDrawer,\n    beatGuid: beat.guid,\n  })\n\n  const [selectedIndex, setSelectedIndex] = useState(chartBarIndex)\n\n  const resolveFilter = (index: number) =>\n    filterStrategy({\n      beat,\n      beatTransactions,\n      dataSeries,\n      selectedIndex: index,\n      subIndex: subTabIndex,\n      isLastTab: index === dataSeries.length - 1,\n      instanceSlotData,\n      spendCategoryGuids,\n      displayedDateRange,\n    })\n\n  // Apply the current selection's filter. Store variants route through the store filter; local\n  // (upcomingBill) variants filter beatTransactions directly and only backfill the cache when the\n  // Stable primitive keys for the collections below: beatTransactions/spendCategoryGuids/\n  // allAccountGuids are recomputed (new array identity) every render, so depending on them directly\n  // re-fires the effect each render (REVIEW.md MEW-3732). Key on content instead.\n  const beatTransactionGuidsKey = beatTransactions.map((transaction) => transaction.guid).join(',')\n  const spendCategoryGuidsKey = spendCategoryGuids.join(',')\n  const allAccountGuidsKey = allAccountGuids.join(',')\n\n  // store variants route the selection through the shared store filter; local (upcomingBill) variants\n  // filter beatTransactions directly, so there's nothing to push to the store for them.\n  useLayoutEffect(() => {\n    if (filterMode !== 'store' || !dataSeries.length) return\n    transactionStore.setFilter(\n      toStoreFilter(resolveFilter(selectedIndex), { allAccountGuids, displayedDateRange }),\n    )\n  }, [\n    beat.guid,\n    selectedIndex,\n    filterMode,\n    dataSeries.length,\n    instanceSlotData,\n    displayedDateRange,\n    spendCategoryGuidsKey,\n    allAccountGuidsKey,\n    beatTransactionGuidsKey,\n  ])\n\n  const headerContent = header?.({\n    htmlTitle: beat.html_title,\n    primaryTransaction,\n    categoryName,\n    selectedDate: chartData[selectedIndex]?.date ?? undefined,\n  })\n\n  const barColors = colors(theme, instanceSlotData?.category_guid)\n  const [monthlyAmountLabel, trendAmountLabel] = (instanceSlotData?.legends ?? []).map(\n    (legend) => legend.label,\n  )\n\n  const transactionFilter =\n    filterMode === 'local'\n      ? (index: number) => resolveFilter(index).custom ?? (() => true)\n      : undefined\n\n  const baseTransactions: Transaction[] | undefined =\n    filterMode === 'local' ? beatTransactions : undefined\n\n  const isBarTop = top === 'singleBar' || top === 'upcomingBill'\n  const chartTop = !isBarTop ? null : chartData.length ? (\n    <BarChartV2\n      amounts={{\n        average: instanceSlotData?.average_amount,\n        formattedAverage: formatCurrency(instanceSlotData?.average_amount ?? 0, '0,0.00'),\n      }}\n      color={barColors[0] ?? theme.palette.primary.main}\n      data={chartData}\n      legendPosition=\"top\"\n      monthlyAmountLabel={monthlyAmountLabel}\n      onBarClick={setSelectedIndex}\n      selectedTabIndex={selectedIndex}\n      trendAmountLabel={trendAmountLabel}\n    />\n  ) : (\n    <EmptyBarChart />\n  )\n\n  return (\n    <TransactionDrillDown\n      ariaLabel={instanceSlotData?.ariaLabel}\n      baseTransactions={baseTransactions}\n      heading={headerContent?.heading}\n      icon={headerContent?.icon}\n      onSelectionChange={setSelectedIndex}\n      selectedIndex={selectedIndex}\n      subHeadingText={headerContent?.subHeadingText}\n      tabs={chartData.map((bar) => ({\n        ariaLabel: bar.ariaLabel,\n        label: bar.label,\n      }))}\n      top={chartTop}\n      transactionFilter={transactionFilter}\n    />\n  )\n})\n"],"mappings":";;;;;;;;;;;AAwBA,IAAa,KAA0B,EAAA,CAAU,EAAE,MAAA,EAAA,MAAmC;AACpF,QAAM,IAAQ,EAAS,GACjB,EACJ,kBAAA,GACA,kBAAA,GACA,oBAAA,GACA,oBAAA,GACA,iBAAA,GACA,cAAA,GACA,oBAAA,GACA,kBAAA,EAAA,IACE,EAAsB,CAAI,GAExB,EAAE,cAAA,EAAA,IAAiB,EAAmB,GAEtC,EAAE,kBAAA,EAAA,IAAqB,GAEvB,IACJ,EAAa,YAAY,iBACrB,GAAkB,eAAe,UACjC,GAAkB,aAAa,SAE/B,EAAE,KAAA,GAAK,YAAA,GAAY,QAAA,GAAQ,QAAA,GAAQ,gBAAA,EAAA,IAAmB,EAC1D,KAAqB,EACvB,GAEM,EAAE,YAAA,GAAY,WAAA,GAAW,gBAAA,EAAA,IAAmB,EAAuB;AAAA,IACvE,MAAM,GAAkB;AAAA,IACxB,WAAW,GAAkB,aAAa;AAAA,IAC1C,KAAA;AAAA,IACA,kBAAA;AAAA,IACA,SAAS;AAAA,EACX,CAAC,GAEK,EAAE,eAAA,GAAe,aAAA,EAAA,IAAgB,EAAoB;AAAA,IACzD,eAAe,EAAU;AAAA,IACzB,oBAAoB,EAAe;AAAA,IACnC,cAAA;AAAA,IACA,UAAU,EAAK;AAAA,EACjB,CAAC,GAEK,CAAC,GAAe,CAAA,IAAoB,EAAS,CAAa,GAE1D,IAAA,CAAiB,MACrB,EAAe;AAAA,IACb,MAAA;AAAA,IACA,kBAAA;AAAA,IACA,YAAA;AAAA,IACA,eAAe;AAAA,IACf,UAAU;AAAA,IACV,WAAW,MAAU,EAAW,SAAS;AAAA,IACzC,kBAAA;AAAA,IACA,oBAAA;AAAA,IACA,oBAAA;AAAA,EACF,CAAC,GAOG,IAA0B,EAAiB,IAAA,CAAK,MAAgB,EAAY,IAAI,EAAE,KAAK,GAAG,GAC1F,IAAwB,EAAmB,KAAK,GAAG,GACnD,IAAqB,EAAgB,KAAK,GAAG;AAInD,EAAA,EAAA,MAAsB;AACpB,IAAI,MAAe,WAAW,CAAC,EAAW,UAC1C,EAAiB,UACf,EAAc,EAAc,CAAa,GAAG;AAAA,MAAE,iBAAA;AAAA,MAAiB,oBAAA;AAAA,IAAmB,CAAC,CACrF;AAAA,EACF,GAAG;AAAA,IACD,EAAK;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,IAAgB,IAAS;AAAA,IAC7B,WAAW,EAAK;AAAA,IAChB,oBAAA;AAAA,IACA,cAAA;AAAA,IACA,cAAc,EAAU,CAAA,GAAgB,QAAQ;AAAA,EAClD,CAAC,GAEK,IAAY,EAAO,GAAO,GAAkB,aAAa,GACzD,CAAC,GAAoB,CAAA,KAAqB,GAAkB,WAAW,CAAC,GAAG,IAAA,CAC9E,MAAW,EAAO,KACrB,GAEM,IACJ,MAAe,UAAA,CACV,MAAkB,EAAc,CAAK,EAAE,WAAA,MAAiB,MACzD,QAEA,IACJ,MAAe,UAAU,IAAmB,QAGxC,IADW,MAAQ,eAAe,MAAQ,iBACZ,EAAU,SAC5C,gBAAA,EAAC,GAAD;AAAA,IACE,SAAS;AAAA,MACP,SAAS,GAAkB;AAAA,MAC3B,kBAAkB,EAAe,GAAkB,kBAAkB,GAAG,QAAQ;AAAA,IAClF;AAAA,IACA,OAAO,EAAU,CAAA,KAAM,EAAM,QAAQ,QAAQ;AAAA,IAC7C,MAAM;AAAA,IACN,gBAAe;AAAA,IACK,oBAAA;AAAA,IACpB,YAAY;AAAA,IACZ,kBAAkB;AAAA,IACA,kBAAA;AAAA,EACnB,CAAA,IAED,gBAAA,EAAC,GAAD,CAAgB,CAAA,IAfW;AAkB7B,SACE,gBAAA,EAAC,GAAD;AAAA,IACE,WAAW,GAAkB;AAAA,IACX,kBAAA;AAAA,IAClB,SAAS,GAAe;AAAA,IACxB,MAAM,GAAe;AAAA,IACrB,mBAAmB;AAAA,IACJ,eAAA;AAAA,IACf,gBAAgB,GAAe;AAAA,IAC/B,MAAM,EAAU,IAAA,CAAK,OAAS;AAAA,MAC5B,WAAW,EAAI;AAAA,MACf,OAAO,EAAI;AAAA,IACb,EAAE;AAAA,IACF,KAAK;AAAA,IACc,mBAAA;AAAA,EACpB,CAAA;AAEL,CAAC"}

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/layout.d.ts

@@ -0,0 +1,68 @@
+import { ReactNode } from 'react';
+import { Theme } from '@mui/material/styles';
+import { Beat, Transaction } from '../../../core';
+import { TransactionFilter } from '../../../core/stores/TransactionStore';
+import { InsightsInstanceSlotData } from '../../../core/types/InsightsInstanceSlotData';
+import { ChartDataSeriesItem } from '../../blocks';
+export interface DrillDownHeader {
+    heading?: string;
+    subHeadingText?: string;
+    icon?: ReactNode;
+}
+export interface DrillDownHeaderContext {
+    htmlTitle?: string;
+    primaryTransaction?: Transaction;
+    categoryName: string;
+    selectedDate?: string | Date;
+}
+export declare const DRILLDOWN_VARIANTS: {
+    readonly TRANSACTION: "bill_amount_not_standard";
+    readonly CATEGORY_SPEND: "category_spend";
+    readonly MONTHLY_SPEND: "monthly_spend_comparison";
+    readonly ACCOUNT_BALANCE: "savings_account_balances_summary";
+    readonly UPCOMING_BILL: "upcoming_bill";
+    readonly SPEND_TO_INCOME: "monthly_spend_to_income";
+    readonly SAVINGS_TO_INCOME: "monthly_savings_to_income";
+    readonly DEBT_TO_INCOME: "monthly_debt_to_income";
+    readonly COST_OF_LIVING: "cost_living_to_income";
+    readonly NON_ESSENTIAL_CATEGORY: "non_essential_category_summary";
+    readonly DEPOSIT_SUMMARY: "monthly_deposit_summary";
+};
+export type DrillDownVariant = (typeof DRILLDOWN_VARIANTS)[keyof typeof DRILLDOWN_VARIANTS];
+/**
+ * One row of the flattened data_series a filterStrategy indexes into: a single-bar monthly total or a
+ * synthesized upcoming-bill bar. Fields are optional because the backend keys each row dynamically
+ * from data_series.names and not every variant carries a guid/category. Double-bar comparison rows
+ * will extend this in the next MR.
+ */
+export type ColorKind = (theme: Theme, categoryGuid?: string) => string[];
+export type HeaderKind = (ctx: DrillDownHeaderContext) => DrillDownHeader;
+/**
+ * Everything a filterStrategy needs to turn the currently-selected bar/sub-tab into a
+ * TransactionFilter. Data-only so strategies stay pure and testable.
+ */
+export interface FilterContext {
+    beat: Beat;
+    beatTransactions: Transaction[];
+    dataSeries: ChartDataSeriesItem[];
+    selectedIndex: number;
+    subIndex: number;
+    isLastTab: boolean;
+    instanceSlotData: InsightsInstanceSlotData;
+    spendCategoryGuids: string[];
+    displayedDateRange: {
+        start: Date;
+        end: Date;
+    };
+}
+export type FilterStrategy = (ctx: FilterContext) => TransactionFilter;
+export interface DrillDownVariantConfig {
+    top: 'singleBar' | 'upcomingBill' | 'doubleBar' | 'tabsOnly';
+    filterStrategy: FilterStrategy;
+    colors: ColorKind;
+    header?: HeaderKind;
+    scope: 'store' | 'beat';
+    filterMode: 'store' | 'local';
+}
+export declare const layout: Partial<Record<DrillDownVariant, DrillDownVariantConfig>>;
+export declare const FALLBACK: DrillDownVariantConfig;

package/dist/insights-v2/actionBlocks/TransactionHistoryBlock/layout.es.js

@@ -0,0 +1,118 @@
+import { DATE_FORMATS_INTL as p, formatDate as u } from "../../../core/constants/DateFormats.es.js";
+import { getCategoryColor as y } from "../../../core/utils/CategoryUtil.es.js";
+import { MerchantLogo as N } from "@mxenabled/mxui";
+import { Icon as T } from "@mxenabled/mx-icons";
+import { jsx as g } from "react/jsx-runtime";
+import { endOfMonth as S, startOfMonth as O } from "date-fns";
+var i = {
+  TRANSACTION: "bill_amount_not_standard",
+  CATEGORY_SPEND: "category_spend",
+  MONTHLY_SPEND: "monthly_spend_comparison",
+  ACCOUNT_BALANCE: "savings_account_balances_summary",
+  UPCOMING_BILL: "upcoming_bill",
+  SPEND_TO_INCOME: "monthly_spend_to_income",
+  SAVINGS_TO_INCOME: "monthly_savings_to_income",
+  DEBT_TO_INCOME: "monthly_debt_to_income",
+  COST_OF_LIVING: "cost_living_to_income",
+  NON_ESSENTIAL_CATEGORY: "non_essential_category_summary",
+  DEPOSIT_SUMMARY: "monthly_deposit_summary"
+}, c = (e, t) => t && y(t, e) || e.palette.primary.main, _ = (e) => ({
+  start: O(new Date(e ?? NaN)),
+  end: S(new Date(e ?? NaN))
+}), d = (e) => e?.length ? { accounts: e } : {}, l = ({ beatTransactions: e, dataSeries: t, selectedIndex: n }) => {
+  const o = t[n], r = o?.guid, a = e.find((s) => s.guid === r)?.has_been_split;
+  return {
+    custom: (s) => s.guid === r,
+    dateRange: _(o?.date),
+    showSplits: !a
+  };
+}, I = ({ dataSeries: e, selectedIndex: t, instanceSlotData: n }) => {
+  const o = e[t], r = n.category_guid ?? o?.guid;
+  return {
+    custom: (a) => a.category_guid === r || a.top_level_category_guid === r,
+    dateRange: _(o?.date)
+  };
+}, f = ({ dataSeries: e, selectedIndex: t, spendCategoryGuids: n, instanceSlotData: o }) => {
+  const r = e[t];
+  return {
+    custom: (a) => !!a.top_level_category_guid && n.includes(a.top_level_category_guid),
+    dateRange: _(r?.date),
+    ...d(o.account_guids)
+  };
+}, A = ({ beat: e, dataSeries: t, selectedIndex: n, isLastTab: o, instanceSlotData: r }) => {
+  const a = t[n], { start: s, end: m } = _(a?.date);
+  return {
+    dateRange: {
+      start: s,
+      end: o && e.created_at ? new Date(e.created_at) : m
+    },
+    ...d(r.account_guids)
+  };
+}, L = {
+  [i.TRANSACTION]: {
+    top: "singleBar",
+    scope: "store",
+    filterMode: "store",
+    filterStrategy: l,
+    colors: (e, t) => [c(e, t)],
+    header: (e) => ({
+      heading: e.htmlTitle,
+      subHeadingText: e.primaryTransaction?.description || void 0,
+      icon: /* @__PURE__ */ g(N, {
+        alt: e.primaryTransaction?.description,
+        categoryGuid: e.primaryTransaction?.category_guid || "",
+        merchantGuid: e.primaryTransaction?.merchant_guid || "",
+        size: 16
+      })
+    })
+  },
+  [i.CATEGORY_SPEND]: {
+    top: "singleBar",
+    filterStrategy: I,
+    scope: "store",
+    filterMode: "store",
+    colors: (e, t) => [c(e, t)],
+    header: (e) => ({
+      heading: e.categoryName,
+      subHeadingText: e.selectedDate && u(e.selectedDate, p.MONTH_LONG) || "",
+      icon: /* @__PURE__ */ g(T, {
+        name: "calendar_month",
+        size: 16
+      })
+    })
+  },
+  [i.MONTHLY_SPEND]: {
+    top: "singleBar",
+    filterStrategy: f,
+    scope: "store",
+    filterMode: "store",
+    colors: (e) => [e.palette.chart.chart2 ?? e.palette.primary.main]
+  },
+  [i.ACCOUNT_BALANCE]: {
+    top: "singleBar",
+    filterStrategy: A,
+    scope: "store",
+    filterMode: "store",
+    colors: (e) => [e.palette.success.main]
+  },
+  [i.UPCOMING_BILL]: {
+    top: "upcomingBill",
+    filterStrategy: l,
+    scope: "beat",
+    filterMode: "local",
+    colors: (e, t) => [c(e, t)]
+  }
+}, R = {
+  top: "singleBar",
+  filterStrategy: l,
+  scope: "store",
+  filterMode: "store",
+  colors: (e, t) => [c(e, t)]
+};
+export {
+  i as DRILLDOWN_VARIANTS,
+  R as FALLBACK,
+  L as layout
+};
+
+//# sourceMappingURL=layout.es.js.map