@mx-cartographer/experiences 8.2.4 → 8.2.6

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [8.2.6] - 05-21-2026
+
+- **UPDATED** - Hide MarketingHub Offer call to action button when call_to_action content is blank
+## [8.2.5] - 05-14-2026
+
+- **FIXED** - Payment due date logic in account details to ensure consistent UTC-based date rendering
+
 ## [8.2.4] - 05-13-2026
 
 - **UPDATED** - Removed deprecated `variant` and `showBorder` props from Insights Micro Widget after `cardStyle` migration, reduce type duplication for micro insight `cards`

package/README.md

@@ -41,15 +41,19 @@ The library is built using a modern React stack, leveraging industry-standard to
 
 ### Prerequisites
 - **Node.js**: v18.0.0 or higher
-- **Yarn**: 4.11.0 [^YARN_VER]
+- **Yarn**: 4.14.1 [^YARN_VER]
 - **React**: 18.3.1 [^REACT_VER]
-- **MobX**: 6.13.6 [^MOBX_VER]
+- **MobX**: 6.15.0 [^MOBX_VER]
 
 ### Installation
 
 Install the library using yarn:
 
 ```bash
+# For v8.x (this branch)
+yarn add @mx-cartographer/experiences@v8-latest
+
+# For v9.x (master)
 yarn add @mx-cartographer/experiences
 ```
 
@@ -149,13 +153,24 @@ graph TD
     src --> core["core/ (Centralized TypeScript types and constants)"]
     src --> common["common/ (Shared components, hooks, stores, and API utilities)"]
     src --> accounts["accounts/ (Accounts summary, details, and connection management)"]
+    src --> analytics["analytics/ (User feedback collection and NPS/CSAT surveys)"]
     src --> budgets["budgets/ (Budget tracking, bubble charts, and categorization)"]
     src --> cashflow["cashflow/ (Cashflow forecasting and event management)"]
+    src --> categories["categories/ (Category management and classification)"]
     src --> dashboard["dashboard/ (Aggregate view of multiple experience widgets)"]
     src --> debts["debts/ (Debt tracking and payoff visualization)"]
+    src --> expenses["expenses/ (Expense tracking and management)"]
     src --> finstrong["finstrong/ (Financial health scoring and reporting)"]
     src --> goals["goals/ (Savings goal setting, tracking, and progress visualization)"]
+    src --> help["help/ (Contextual help, support requests, and user guidance)"]
+    src --> insights["insights/ (Data-driven financial insights and alerts)"]
+    src --> investments["investments/ (Investment portfolio tracking and holding details)"]
+    src --> merchants["merchants/ (Merchant data and transaction categorization)"]
+    src --> microinsights["microinsights/ (Smart, micro financial insights)"]
     src --> networth["networth/ (Asset and liability tracking with historical trends)"]
+    src --> notifications["notifications/ (Notification management and alerts)"]
+    src --> recurringtransactions["recurringtransactions/ (Recurring bill and subscription management)"]
+    src --> settings["settings/ (User profile, device, and preference management)"]
     src --> spending["spending/ (Categorized spending analysis)"]
     src --> transactions["transactions/ (Detailed transaction history and rules)"]
     src --> trends["trends/ (Longitudinal spending and income analysis)"]
@@ -176,7 +191,7 @@ yarn testui
 yarn citest
 ```
 
-Verification logic and test setups are maintained in [src/common/__tests__](src/common/__tests__) and [vitest.setup.insights.tsx](vitest.setup.insights.tsx).
+Verification logic and test setups are maintained in various `__tests__` directories throughout the codebase and [vitest.setup.insights.tsx](vitest.setup.insights.tsx).
 
 ## Contributing
 
@@ -193,18 +208,42 @@ Verification logic and test setups are maintained in [src/common/__tests__](src/
    yarn build
    ```
 
-<!-- Commented this out to prevent exposing internal operations in the npm registry -->
+## Release Workflow (v8.x)
+
+This branch (`Experiences_8.x`) publishes v8.x.x releases **manually**, while `master` publishes v9.x automatically via CI.
 
-<!-- ## Publishing alpha versions
-1. Bump the version in package.json using the format `major.minor.patch-alpha.<yourinitials><n>` See [the version history](https://www.npmjs.com/package/@mx-cartographer/experiences?activeTab=versions) for examples.
-1. Run `npm publish --tag alpha`.
+To avoid overwriting the `latest` npm dist-tag (which should always point to v9.x on `master`), **always publish with the `v8-latest` tag**:
 
+1. Branch off `Experiences_8.x` for your feature work:
+   ```bash
+   git checkout Experiences_8.x
+   git checkout -b my-feature-branch
+   ```
+1. Make your changes, including bumping the version in `package.json` and updating `CHANGELOG.md`.
+1. Push your feature branch and open an MR targeting `Experiences_8.x` on GitLab.
+1. After code review and merge, pull down the updated branch:
+   ```bash
+   git checkout Experiences_8.x
+   git pull origin Experiences_8.x
+   ```
+1. Tag the release and push the tag:
+   ```bash
+   git tag v8.2.6
+   git push origin --tags
+   ```
+1. Publish with the dist-tag:
+   ```bash
+   npm publish --tag v8-latest
+   ```
+
+Consumers on v8 can install with:
+```bash
+yarn add @mx-cartographer/experiences@v8-latest
+# or pin a specific version
+yarn add @mx-cartographer/experiences@8.2.6
+```
 
-## Merging and Publishing
-1. Update CHANGELOG.md and include the version to publish using the standard `major.minor.patch`. If there are breaking changes, we bump the major, new feature we bump minor and bug fixes or minor changes, we bump patch.
-1. Request a MR review by commenting `shipit --review`
-1. Once the MR is approved, comment `shipit --publish-version=major|minor|patch`.
-2. Shipit will bump the version in package.json, merge and publish the package to npm. -->
+> **Do not** run `npm publish` without `--tag v8-latest` from this branch — it would move the `latest` tag away from v9.x.
 
 ## Support
 
@@ -217,12 +256,12 @@ For technical assistance or internal inquiries:
 
 [^1]: [src/common/components/WidgetContainer.tsx:55](src/common/components/WidgetContainer.tsx#L55)
 [^2]: [src/common/context/WidgetContainerProvider.tsx:10](src/common/context/WidgetContainerProvider.tsx#L10)
-[^3]: [src/common/context/GlobalStoreProvider.tsx:10](src/common/context/GlobalStoreProvider.tsx#L10)
+[^3]: [src/common/context/GlobalDataProvider.tsx:16](src/common/context/GlobalDataProvider.tsx#L16)
 [^4]: [src/common/hooks/useScreenSize.tsx:4](src/common/hooks/useScreenSize.tsx#L4)
-[^5]: [package.json:267](package.json#L267)
-[^6]: [package.json:160](package.json#L160)
-[^MUI_VER]: [package.json:188](package.json#L188)
-[^MXUI_VER]: [package.json:196](package.json#L196)
-[^MOBX_VER]: [package.json:202](package.json#L202)
-[^REACT_VER]: [package.json:206](package.json#L206)
-[^YARN_VER]: [package.json:284](package.json#L284)
+[^5]: [package.json:274](package.json#L274)
+[^6]: [package.json:233](package.json#L233)
+[^MUI_VER]: [package.json:195](package.json#L195)
+[^MXUI_VER]: [package.json:203](package.json#L203)
+[^MOBX_VER]: [package.json:209](package.json#L209)
+[^REACT_VER]: [package.json:213](package.json#L213)
+[^YARN_VER]: [package.json:291](package.json#L291)

package/dist/{AccountDetailsHeader-CfdnKyJK.mjs → AccountDetailsHeader-DIysk_4w.mjs}

@@ -5,7 +5,7 @@ import { H3 as x, InstitutionLogo as D, Text as d, H2 as N } from "@mxenabled/mx
 import { f as P } from "./NumberFormatting--XMeeBfr.mjs";
 import p from "react";
 import { G, d as f, l as O, f as R, a as v, u as w } from "./hooks-BaO_gOI6.mjs";
-import { g as L } from "./AccountFields-CAy0x_4i.mjs";
+import { g as L } from "./AccountFields-mwJ8NXsX.mjs";
 import { A as i } from "./Account-BaJmiJAG.mjs";
 import H from "@mui/material/Card";
 import M from "@mui/material/CardContent";

package/dist/{AccountFields-CAy0x_4i.mjs → AccountFields-mwJ8NXsX.mjs}

@@ -1,12 +1,12 @@
 import { jsx as p } from "react/jsx-runtime";
-import { Text as v, Icon as b } from "@mxenabled/mxui";
-import { A as d, a as h, P as F, b as T } from "./Account-BaJmiJAG.mjs";
-import { i as A, u as D, a as g, b as O, c as C } from "./AccountUtils-T5_Odvos.mjs";
+import { Text as h, Icon as b } from "@mxenabled/mxui";
+import { A as d, a as F, P as T, b as A } from "./Account-BaJmiJAG.mjs";
+import { i as D, u as g, a as O, b as C, c as N } from "./AccountUtils-T5_Odvos.mjs";
 import { F as m } from "./Accounts-CseLC3lL.mjs";
-import { f as N } from "./DateUtil-Bhq59ZVg.mjs";
+import { f } from "./DateUtil-Bhq59ZVg.mjs";
 import { f as s, i as o, a as S, b as I } from "./NumberFormatting--XMeeBfr.mjs";
 import { b as i } from "./Localization-DnoVyBNK.mjs";
-import { f, D as c } from "./DateFormats-HudZ3Bjs.mjs";
+import { f as c, D as y } from "./DateFormats-HudZ3Bjs.mjs";
 const Y = (l, e) => {
   const n = [
     {
@@ -19,7 +19,7 @@ const Y = (l, e) => {
       valueFormatter: (a) => a
     }
   ];
-  if (A(l)) {
+  if (D(l)) {
     n.unshift({
       label: e.account_balance,
       name: "balance",
@@ -30,7 +30,7 @@ const Y = (l, e) => {
     const a = Object.keys(d).filter((t) => Number(t)).map((t) => ({
       label: e.account_types[t],
       value: Number(t),
-      icon: /* @__PURE__ */ p(b, { name: h[t] })
+      icon: /* @__PURE__ */ p(b, { name: F[t] })
     }));
     n.push({
       label: e.account_type,
@@ -42,10 +42,10 @@ const Y = (l, e) => {
     });
   }
   if (l.account_type === d.PROPERTY) {
-    const a = Object.keys(F).filter((t) => Number(t)).map((t) => ({
+    const a = Object.keys(T).filter((t) => Number(t)).map((t) => ({
       label: e.property_types[t],
       value: Number(t),
-      icon: /* @__PURE__ */ p(b, { name: T[t] })
+      icon: /* @__PURE__ */ p(b, { name: A[t] })
     }));
     n.push({
       label: e.property_type,
@@ -56,7 +56,7 @@ const Y = (l, e) => {
       valueFormatter: (t) => a.find((r) => r.value === t)?.label
     });
   }
-  if (D(l)) {
+  if (g(l)) {
     let a = e.interest_rate, t = "interest_rate";
     l.is_manual || (typeof l.apr == "number" && (a = e.apr, t = "apr"), typeof l.apy == "number" && (a = e.apy, t = "apy")), n.push({
       event: "account_details_click_interest_rate",
@@ -68,7 +68,7 @@ const Y = (l, e) => {
       valueFormatter: (r) => o(r) ? S(r / 100) : r
     });
   }
-  return g(l) && (n.push({
+  return O(l) && (n.push({
     label: e.minimum_payment,
     name: "minimum_payment",
     placeholder: i(e.enter_value, e.minimum_payment),
@@ -79,8 +79,8 @@ const Y = (l, e) => {
     name: "payment_due_at",
     type: m.Date,
     valueFormatter: (a) => {
-      const t = typeof a == "number" ? new Date(a * 1e3) : a;
-      return f(t, c.MED_MONTH_SHORT_DAY_FULL_YEAR);
+      const t = typeof a == "number" ? f(a) : a;
+      return c(t, y.MED_MONTH_SHORT_DAY_FULL_YEAR);
     }
   }) : n.push({
     label: e.day_payment_due,
@@ -91,13 +91,13 @@ const Y = (l, e) => {
       e.day_of_every_month,
       I(a <= 31 ? a : new Date(a).getDate())
     )
-  })), O(l) && n.push({
+  })), C(l) && n.push({
     label: e.credit_limit,
     name: "credit_limit",
     placeholder: i(e.enter_value, e.credit_limit),
     type: m.Currency,
     valueFormatter: (a) => s(a, "0,0.00")
-  }), C(l) && n.push({
+  }), N(l) && n.push({
     label: e.original_balance,
     minAmount: 1,
     name: "original_balance",
@@ -115,11 +115,11 @@ const Y = (l, e) => {
     }
     default:
       if (a = e.current_balance, t = l.balance, l.minimum_payment && l.payment_due_at) {
-        const y = N(l.payment_due_at);
-        r = /* @__PURE__ */ p(v, { component: "strong", variant: "caption", children: i(
+        const v = f(l.payment_due_at);
+        r = /* @__PURE__ */ p(h, { component: "strong", variant: "caption", children: i(
           e.payment_due_on,
           s(l.minimum_payment, "0,0.00"),
-          f(y, c.FULL_MONTH_DAY)
+          c(v, y.FULL_MONTH_DAY)
         ) });
       } else l.credit_limit && (r = e.available_credit, _ = s(l.credit_limit - (l?.balance ?? 0), "0,0.00"));
   }

package/dist/{AccountListItem-BYyeeCf6.mjs → AccountListItem-CU-oWLRi.mjs}

@@ -11,7 +11,7 @@ import { InstitutionLogo as B, Text as r } from "@mxenabled/mxui";
 import { Error as j } from "@mxenabled/mx-icons";
 import { I as T } from "./IconBacking-DgT8DCeh.mjs";
 import { f as $ } from "./NumberFormatting--XMeeBfr.mjs";
-import { g as k } from "./AccountFields-CAy0x_4i.mjs";
+import { g as k } from "./AccountFields-mwJ8NXsX.mjs";
 import { u as w } from "./useAccountDisplayName-CFa_MrS6.mjs";
 import { a as E, u as M } from "./hooks-BaO_gOI6.mjs";
 import { C as d } from "./Account-BaJmiJAG.mjs";

package/dist/accounts/index.es.js

@@ -11,15 +11,15 @@ import B from "@mui/material/ListSubheader";
 import P from "@mui/system/Stack";
 import { f as s1 } from "../NumberFormatting--XMeeBfr.mjs";
 import { useTheme as y1, alpha as w1 } from "@mui/material/styles";
-import { u as R, A as x1 } from "../AccountDetailsHeader-CfdnKyJK.mjs";
+import { u as R, A as x1 } from "../AccountDetailsHeader-DIysk_4w.mjs";
 import { L as R1 } from "../LineChart-CejWS_rh.mjs";
 import { g as S1, a as T1, b as E1 } from "../SpendingData-PKlh8caU.mjs";
 import { l as D1, u as A, d as D, g as k, h as p1, a as _1, b as G } from "../hooks-BaO_gOI6.mjs";
 import { A as I, g as f, N as L1 } from "../Account-BaJmiJAG.mjs";
 import { I as f1, P as g1, S as H1 } from "../Account-BxHMlV9R.mjs";
-import { a as k1, b as I1 } from "../AccountFields-CAy0x_4i.mjs";
-import { g as c2 } from "../AccountFields-CAy0x_4i.mjs";
-import { A as U } from "../AccountListItem-BYyeeCf6.mjs";
+import { a as k1, b as I1 } from "../AccountFields-mwJ8NXsX.mjs";
+import { g as c2 } from "../AccountFields-mwJ8NXsX.mjs";
+import { A as U } from "../AccountListItem-CU-oWLRi.mjs";
 import l1 from "@mui/material/Tab";
 import Z1 from "@mui/material/Tabs";
 import N1 from "@mui/material/Switch";

package/dist/cashflow/index.es.js

@@ -23,7 +23,7 @@ import ye from "@mui/material/Tab";
 import { getUnixTime as le } from "date-fns/getUnixTime";
 import Q from "@mui/material/List";
 import ee from "@mui/material/ListItem";
-import { A as tt } from "../AccountListItem-BYyeeCf6.mjs";
+import { A as tt } from "../AccountListItem-CU-oWLRi.mjs";
 import { f as U, D as Y } from "../DateFormats-HudZ3Bjs.mjs";
 import nt from "@mui/material/ListSubheader";
 import { f as J } from "../NumberFormatting--XMeeBfr.mjs";

package/dist/debts/index.es.js

@@ -12,7 +12,7 @@ import { G as Ge, q as ee, u as w, k as V, g as k, d as te, a as He, b as ze } f
 import { u as ae } from "../useScreenSize-CeFhWTt_.mjs";
 import { b as T } from "../Localization-DnoVyBNK.mjs";
 import { D as ie } from "../Drawer-XPaLYjiO.mjs";
-import { A as je, u as Ve } from "../AccountDetailsHeader-CfdnKyJK.mjs";
+import { A as je, u as Ve } from "../AccountDetailsHeader-DIysk_4w.mjs";
 import Ye from "@mui/material/Card";
 import Ke from "@mui/material/CardContent";
 import Ue from "@mui/material/CardHeader";

package/dist/finstrong/index.es.js

@@ -43,7 +43,7 @@ import { E as Be } from "../EmptyState-DHAkGsjk.mjs";
 import $n from "@mui/material/Chip";
 import { D as ie } from "../Drawer-XPaLYjiO.mjs";
 import { g as kt } from "../AccountDisplayName-CO7z3v99.mjs";
-import { g as Mt } from "../AccountFields-CAy0x_4i.mjs";
+import { g as Mt } from "../AccountFields-mwJ8NXsX.mjs";
 import Nn from "@mui/material/ListSubheader";
 import { S as dt } from "../Select-BZRUpOib.mjs";
 import { A as je } from "../Account-BaJmiJAG.mjs";

package/dist/insights/index.es.js

@@ -3363,7 +3363,7 @@ const A4 = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAACvCAYAAACM9QdJAA
     altLoadingText: r,
     beat: i,
     button: /* @__PURE__ */ s(C, { spacing: 10, children: [
-      /* @__PURE__ */ t(
+      i.call_to_action && /* @__PURE__ */ t(
         H,
         {
           beat: i,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-cartographer/experiences",
-  "version": "8.2.4",
+  "version": "8.2.6",
   "description": "Library containing experience widgets",
   "author": "MX",
   "license": "MIT",
@@ -288,5 +288,5 @@
     "CHANGELOG.md",
     "README.md"
   ],
-  "packageManager": "yarn@4.14.1"
+  "packageManager": "yarn@4.15.0"
 }