@mx-cartographer/experiences 9.5.3 → 9.6.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [9.5.4] - 10-09-2026
+
+- **ADDED** - `amount_input_modal_block`, the first modal action block: edits one whole-dollar setting in a dialog, picked by the CTA variant. `low_balance_threshold` (Low Account Balance "Edit Alert Settings") saves the threshold on the account's low-balance alert profile; `safety_net` (Savings Opportunity V2 "Set Reminder" / "Adjust Reminder") saves the safety net on the user insight profile. Saves run through `useCtaHandler`. Copy under `insights_feed.amount_input_modal`; mock beats, stories and `docs/action-blocks/amount-input-modal-block.md`.
+- **ADDED** - `ActionBlockEntry.presentation: 'modal'`: `ActionBlockLayer` renders such a block without the drawer, and only while it is open for its beat.
+- **ADDED** - Optional `CurrencyDialog` props `subtitle`, `errorText` and `isPrimaryDisabled`; `content` now accepts a node. Its helper text (validation or save error) is now announced with `role="alert"`. Existing callers are otherwise unchanged.
+- **CHANGED** - `hasDrawerBlock` moved to `insights-v2/mappings/hasDrawerBlock.ts` (still re-exported from `mappings/blocks`) so action blocks can import `ctaActions` without an import cycle.
+
 ## [9.5.3] - 10-09-2026
 
 - **CHANGED** - Repeating-transaction create flows show Sherlock-ineligible rows disabled instead of hiding them; `SelectTransaction` drives `TransactionList`'s new `isRowDisabled` prop instead of `filter` (MEW-4143)

package/dist/common/components/CurrencyDialog.d.ts

@@ -1,10 +1,16 @@
+import { ReactNode } from 'react';
 import { ButtonProps } from '@mui/material/Button';
 interface CurrencyDialogProps {
     closeAriaLabel: string;
-    content?: string;
+    /** Body copy; a node so callers can emphasise part of it (e.g. a bold account name). */
+    content?: ReactNode;
+    /** Validation or save error, shown under the input and marking it invalid. */
+    errorText?: string;
     inputLabel?: string;
     inputValue?: string;
     isOpen: boolean;
+    /** Disables the primary button on top of the built-in input check (e.g. while saving). */
+    isPrimaryDisabled?: boolean;
     handleInputChange?: (value: string) => void;
     handleModalClose: () => void;
     handlePrimaryAction: () => void;
@@ -13,7 +19,9 @@ interface CurrencyDialogProps {
     primaryText: string;
     secondaryColor?: ButtonProps['color'];
     secondaryText?: string;
+    /** A line under the title, e.g. the account a setting applies to. */
+    subtitle?: ReactNode;
     title: string;
 }
-declare const CurrencyDialog: ({ closeAriaLabel, content, inputLabel, inputValue, isOpen, handleInputChange, handleModalClose, handlePrimaryAction, handleSecondaryAction, primaryColor, primaryText, secondaryColor, secondaryText, title, }: CurrencyDialogProps) => import("react/jsx-runtime").JSX.Element;
+declare const CurrencyDialog: ({ closeAriaLabel, content, errorText, inputLabel, inputValue, isOpen, isPrimaryDisabled, handleInputChange, handleModalClose, handlePrimaryAction, handleSecondaryAction, primaryColor, primaryText, secondaryColor, secondaryText, subtitle, title, }: CurrencyDialogProps) => import("react/jsx-runtime").JSX.Element;
 export default CurrencyDialog;

package/dist/common/components/CurrencyDialog.es.js

@@ -1,34 +1,34 @@
-import { useScreenSize as v } from "../hooks/useScreenSize.es.js";
-import p from "@mui/material/Stack";
-import { H3 as I, P as y } from "@mxenabled/mxui";
-import c from "@mui/material/Button";
-import { Icon as S } from "@mxenabled/mx-icons";
-import { jsx as o, jsxs as e } from "react/jsx-runtime";
-import j from "@mui/material/Dialog";
-import k from "@mui/material/DialogContent";
-import M from "@mui/material/IconButton";
-import $ from "@mui/material/DialogActions";
-import F from "@mui/material/InputAdornment";
-import w from "@mui/material/TextField";
-var O = ({ closeAriaLabel: d, content: f, inputLabel: t, inputValue: i, isOpen: h, handleInputChange: u, handleModalClose: n, handlePrimaryAction: a, handleSecondaryAction: g, primaryColor: x = "primary", primaryText: m, secondaryColor: b = "primary", secondaryText: l, title: s }) => {
-  const C = i !== "" && i !== "0" && !isNaN(parseFloat(i ?? "0")), { isSmallMobile: D } = v();
-  return /* @__PURE__ */ o(j, {
-    "aria-label": s,
+import { useScreenSize as k } from "../hooks/useScreenSize.es.js";
+import n from "@mui/material/Stack";
+import { H3 as S, P as j } from "@mxenabled/mxui";
+import f from "@mui/material/Button";
+import { Icon as M } from "@mxenabled/mx-icons";
+import { jsx as o, jsxs as t } from "react/jsx-runtime";
+import $ from "@mui/material/Dialog";
+import B from "@mui/material/DialogContent";
+import F from "@mui/material/IconButton";
+import H from "@mui/material/DialogActions";
+import w from "@mui/material/InputAdornment";
+import A from "@mui/material/TextField";
+var U = ({ closeAriaLabel: h, content: g, errorText: a, inputLabel: r, inputValue: i, isOpen: u, isPrimaryDisabled: x = !1, handleInputChange: b, handleModalClose: m, handlePrimaryAction: s, handleSecondaryAction: C, primaryColor: D = "primary", primaryText: p, secondaryColor: v = "primary", secondaryText: l, subtitle: y, title: c }) => {
+  const d = x || (r ? !(i !== "" && i !== "0" && !isNaN(parseFloat(i ?? "0"))) : !1), { isSmallMobile: I } = k();
+  return /* @__PURE__ */ o($, {
+    "aria-label": c,
     "aria-labelledby": "modal-title",
     maxWidth: "xs",
-    onClose: n,
-    open: h,
+    onClose: m,
+    open: u,
     role: "dialog",
     sx: {
       "& .MuiDialogContent-root": { p: 0 },
-      ...D && { "& .MuiDialog-paper": { minWidth: "100%" } }
+      ...I && { "& .MuiDialog-paper": { minWidth: "100%" } }
     },
-    children: /* @__PURE__ */ o(k, { children: /* @__PURE__ */ e("form", {
-      onSubmit: (r) => {
-        r.preventDefault(), a();
+    children: /* @__PURE__ */ o(B, { children: /* @__PURE__ */ t("form", {
+      onSubmit: (e) => {
+        e.preventDefault(), d || s();
       },
       children: [
-        /* @__PURE__ */ e(p, {
+        /* @__PURE__ */ t(n, {
           sx: {
             alignItems: "center",
             flexDirection: "row",
@@ -39,46 +39,52 @@ var O = ({ closeAriaLabel: d, content: f, inputLabel: t, inputValue: i, isOpen:
             pr: 16,
             pt: 24
           },
-          children: [/* @__PURE__ */ o(I, {
-            id: "modal-title",
-            children: s
-          }), /* @__PURE__ */ o(M, {
-            "aria-label": d,
-            onClick: n,
+          children: [/* @__PURE__ */ t(n, {
+            sx: { gap: 4 },
+            children: [/* @__PURE__ */ o(S, {
+              id: "modal-title",
+              children: c
+            }), y]
+          }), /* @__PURE__ */ o(F, {
+            "aria-label": h,
+            onClick: m,
             sx: {
               minHeight: 24,
               position: "absolute",
               right: 8,
               top: 18
             },
-            children: /* @__PURE__ */ o(S, {
+            children: /* @__PURE__ */ o(M, {
               name: "close",
               sx: { color: "action.active" }
             })
           })]
         }),
-        /* @__PURE__ */ e(p, {
+        /* @__PURE__ */ t(n, {
           sx: {
             gap: 24,
             px: 24
           },
-          children: [/* @__PURE__ */ o(y, {
+          children: [/* @__PURE__ */ o(j, {
             variant: "subtitle1",
-            children: f
-          }), t && /* @__PURE__ */ o(w, {
+            children: g
+          }), r && /* @__PURE__ */ o(A, {
             autoFocus: !0,
+            error: !!a,
+            helperText: a,
             inputMode: "decimal",
-            label: t,
-            onChange: ({ target: { value: r } }) => {
-              /^\d*\.?\d*$/.test(r) && u?.(r);
+            label: r,
+            onChange: ({ target: { value: e } }) => {
+              /^\d*\.?\d*$/.test(e) && b?.(e);
             },
             slotProps: {
-              input: { startAdornment: /* @__PURE__ */ o(F, {
+              input: { startAdornment: /* @__PURE__ */ o(w, {
                 position: "start",
                 children: "$"
               }) },
+              formHelperText: { role: "alert" },
               htmlInput: {
-                "aria-label": t,
+                "aria-label": r,
                 noValidate: !0,
                 pattern: "[0-9]*\\.?[0-9]*"
               }
@@ -87,25 +93,25 @@ var O = ({ closeAriaLabel: d, content: f, inputLabel: t, inputValue: i, isOpen:
             value: i
           })]
         }),
-        /* @__PURE__ */ e($, {
+        /* @__PURE__ */ t(H, {
           sx: {
             justifyContent: "flex-end",
             gap: 16,
             p: 24,
             ">:not(style)~:not(style)": { ml: 0 }
           },
-          children: [l && /* @__PURE__ */ o(c, {
+          children: [l && /* @__PURE__ */ o(f, {
             "aria-label": l,
-            color: b,
-            onClick: g,
+            color: v,
+            onClick: C,
             children: l
-          }), /* @__PURE__ */ o(c, {
-            "aria-label": m,
-            color: x,
-            disabled: t ? !C : !1,
-            onClick: a,
+          }), /* @__PURE__ */ o(f, {
+            "aria-label": p,
+            color: D,
+            disabled: d,
+            onClick: s,
             variant: "contained",
-            children: m
+            children: p
           })]
         })
       ]
@@ -113,7 +119,7 @@ var O = ({ closeAriaLabel: d, content: f, inputLabel: t, inputValue: i, isOpen:
   });
 };
 export {
-  O as default
+  U as default
 };
 
 //# sourceMappingURL=CurrencyDialog.es.js.map

package/dist/common/components/CurrencyDialog.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"CurrencyDialog.es.js","names":[],"sources":["../../../src/common/components/CurrencyDialog.tsx"],"sourcesContent":["import { Icon } from '@mxenabled/mx-icons'\nimport { H3, P } from '@mxenabled/mxui'\n\nimport Button, { type ButtonProps } from '@mui/material/Button'\nimport Dialog from '@mui/material/Dialog'\nimport DialogActions from '@mui/material/DialogActions'\nimport DialogContent from '@mui/material/DialogContent'\nimport IconButton from '@mui/material/IconButton'\nimport InputAdornment from '@mui/material/InputAdornment'\nimport Stack from '@mui/material/Stack'\nimport TextField from '@mui/material/TextField'\n\nimport { useScreenSize } from '../hooks'\n\ninterface CurrencyDialogProps {\n  closeAriaLabel: string\n  content?: string\n  inputLabel?: string\n  inputValue?: string\n  isOpen: boolean\n  handleInputChange?: (value: string) => void\n  handleModalClose: () => void\n  handlePrimaryAction: () => void\n  handleSecondaryAction?: () => void\n  primaryColor?: ButtonProps['color']\n  primaryText: string\n  secondaryColor?: ButtonProps['color']\n  secondaryText?: string\n  title: string\n}\n\n// Created for V2 of BudgetDetailsDrawer.\n// The previous design will be replaced once the new design is finalized.\n// Also needs to be updated to use the mxui library\n// with the updated Dialog components.\n\nconst CurrencyDialog = ({\n  closeAriaLabel,\n  content,\n  inputLabel,\n  inputValue,\n  isOpen,\n  handleInputChange,\n  handleModalClose,\n  handlePrimaryAction,\n  handleSecondaryAction,\n  primaryColor = 'primary',\n  primaryText,\n  secondaryColor = 'primary',\n  secondaryText,\n  title,\n}: CurrencyDialogProps) => {\n  const numericValue = parseFloat(inputValue ?? '0')\n  const isValid = inputValue !== '' && inputValue !== '0' && !isNaN(numericValue)\n\n  const { isSmallMobile } = useScreenSize()\n\n  return (\n    <Dialog\n      aria-label={title}\n      aria-labelledby=\"modal-title\"\n      maxWidth=\"xs\"\n      onClose={handleModalClose}\n      open={isOpen}\n      role=\"dialog\"\n      sx={{\n        '& .MuiDialogContent-root': { p: 0 },\n        ...(isSmallMobile && { '& .MuiDialog-paper': { minWidth: '100%' } }),\n      }}\n    >\n      <DialogContent>\n        <form\n          onSubmit={(e) => {\n            e.preventDefault()\n            handlePrimaryAction()\n          }}\n        >\n          <Stack\n            sx={{\n              alignItems: 'center',\n              flexDirection: 'row',\n              justifyContent: 'space-between',\n              pb: 12,\n              pl: 24,\n              position: 'relative',\n              pr: 16,\n              pt: 24,\n            }}\n          >\n            <H3 id=\"modal-title\">{title}</H3>\n            <IconButton\n              aria-label={closeAriaLabel}\n              onClick={handleModalClose}\n              sx={{ minHeight: 24, position: 'absolute', right: 8, top: 18 }}\n            >\n              <Icon name=\"close\" sx={{ color: 'action.active' }} />\n            </IconButton>\n          </Stack>\n          <Stack sx={{ gap: 24, px: 24 }}>\n            <P variant=\"subtitle1\">{content}</P>\n            {inputLabel && (\n              <TextField\n                autoFocus={true}\n                inputMode=\"decimal\"\n                label={inputLabel}\n                onChange={({ target: { value } }) => {\n                  if (!/^\\d*\\.?\\d*$/.test(value)) return\n\n                  handleInputChange?.(value)\n                }}\n                slotProps={{\n                  input: {\n                    startAdornment: <InputAdornment position=\"start\">$</InputAdornment>,\n                  },\n                  htmlInput: {\n                    'aria-label': inputLabel,\n                    noValidate: true,\n                    pattern: '[0-9]*\\\\.?[0-9]*',\n                  },\n                }}\n                type=\"text\"\n                value={inputValue}\n              />\n            )}\n          </Stack>\n          <DialogActions\n            sx={{\n              justifyContent: 'flex-end',\n              gap: 16,\n              p: 24,\n              '>:not(style)~:not(style)': { ml: 0 },\n            }}\n          >\n            {secondaryText && (\n              <Button\n                aria-label={secondaryText}\n                color={secondaryColor}\n                onClick={handleSecondaryAction}\n              >\n                {secondaryText}\n              </Button>\n            )}\n            <Button\n              aria-label={primaryText}\n              color={primaryColor}\n              disabled={inputLabel ? !isValid : false}\n              onClick={handlePrimaryAction}\n              variant=\"contained\"\n            >\n              {primaryText}\n            </Button>\n          </DialogActions>\n        </form>\n      </DialogContent>\n    </Dialog>\n  )\n}\n\nexport default CurrencyDialog\n"],"mappings":"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"}
+{"version":3,"file":"CurrencyDialog.es.js","names":[],"sources":["../../../src/common/components/CurrencyDialog.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\n\nimport { Icon } from '@mxenabled/mx-icons'\nimport { H3, P } from '@mxenabled/mxui'\n\nimport Button, { type ButtonProps } from '@mui/material/Button'\nimport Dialog from '@mui/material/Dialog'\nimport DialogActions from '@mui/material/DialogActions'\nimport DialogContent from '@mui/material/DialogContent'\nimport IconButton from '@mui/material/IconButton'\nimport InputAdornment from '@mui/material/InputAdornment'\nimport Stack from '@mui/material/Stack'\nimport TextField from '@mui/material/TextField'\n\nimport { useScreenSize } from '../hooks'\n\ninterface CurrencyDialogProps {\n  closeAriaLabel: string\n  /** Body copy; a node so callers can emphasise part of it (e.g. a bold account name). */\n  content?: ReactNode\n  /** Validation or save error, shown under the input and marking it invalid. */\n  errorText?: string\n  inputLabel?: string\n  inputValue?: string\n  isOpen: boolean\n  /** Disables the primary button on top of the built-in input check (e.g. while saving). */\n  isPrimaryDisabled?: boolean\n  handleInputChange?: (value: string) => void\n  handleModalClose: () => void\n  handlePrimaryAction: () => void\n  handleSecondaryAction?: () => void\n  primaryColor?: ButtonProps['color']\n  primaryText: string\n  secondaryColor?: ButtonProps['color']\n  secondaryText?: string\n  /** A line under the title, e.g. the account a setting applies to. */\n  subtitle?: ReactNode\n  title: string\n}\n\n// Created for V2 of BudgetDetailsDrawer.\n// The previous design will be replaced once the new design is finalized.\n// Also needs to be updated to use the mxui library\n// with the updated Dialog components.\n\nconst CurrencyDialog = ({\n  closeAriaLabel,\n  content,\n  errorText,\n  inputLabel,\n  inputValue,\n  isOpen,\n  isPrimaryDisabled = false,\n  handleInputChange,\n  handleModalClose,\n  handlePrimaryAction,\n  handleSecondaryAction,\n  primaryColor = 'primary',\n  primaryText,\n  secondaryColor = 'primary',\n  secondaryText,\n  subtitle,\n  title,\n}: CurrencyDialogProps) => {\n  const numericValue = parseFloat(inputValue ?? '0')\n  const isValid = inputValue !== '' && inputValue !== '0' && !isNaN(numericValue)\n  // One rule for the button and for Enter: the form's submit must not bypass a disabled button.\n  const isPrimaryBlocked = isPrimaryDisabled || (inputLabel ? !isValid : false)\n\n  const { isSmallMobile } = useScreenSize()\n\n  return (\n    <Dialog\n      aria-label={title}\n      aria-labelledby=\"modal-title\"\n      maxWidth=\"xs\"\n      onClose={handleModalClose}\n      open={isOpen}\n      role=\"dialog\"\n      sx={{\n        '& .MuiDialogContent-root': { p: 0 },\n        ...(isSmallMobile && { '& .MuiDialog-paper': { minWidth: '100%' } }),\n      }}\n    >\n      <DialogContent>\n        <form\n          onSubmit={(e) => {\n            e.preventDefault()\n            if (!isPrimaryBlocked) handlePrimaryAction()\n          }}\n        >\n          <Stack\n            sx={{\n              alignItems: 'center',\n              flexDirection: 'row',\n              justifyContent: 'space-between',\n              pb: 12,\n              pl: 24,\n              position: 'relative',\n              pr: 16,\n              pt: 24,\n            }}\n          >\n            <Stack sx={{ gap: 4 }}>\n              <H3 id=\"modal-title\">{title}</H3>\n              {subtitle}\n            </Stack>\n            <IconButton\n              aria-label={closeAriaLabel}\n              onClick={handleModalClose}\n              sx={{ minHeight: 24, position: 'absolute', right: 8, top: 18 }}\n            >\n              <Icon name=\"close\" sx={{ color: 'action.active' }} />\n            </IconButton>\n          </Stack>\n          <Stack sx={{ gap: 24, px: 24 }}>\n            <P variant=\"subtitle1\">{content}</P>\n            {inputLabel && (\n              <TextField\n                autoFocus={true}\n                error={!!errorText}\n                helperText={errorText}\n                inputMode=\"decimal\"\n                label={inputLabel}\n                onChange={({ target: { value } }) => {\n                  if (!/^\\d*\\.?\\d*$/.test(value)) return\n\n                  handleInputChange?.(value)\n                }}\n                slotProps={{\n                  input: {\n                    startAdornment: <InputAdornment position=\"start\">$</InputAdornment>,\n                  },\n                  // Announce errors: focus is usually on the primary button when one appears.\n                  formHelperText: { role: 'alert' },\n                  htmlInput: {\n                    'aria-label': inputLabel,\n                    noValidate: true,\n                    pattern: '[0-9]*\\\\.?[0-9]*',\n                  },\n                }}\n                type=\"text\"\n                value={inputValue}\n              />\n            )}\n          </Stack>\n          <DialogActions\n            sx={{\n              justifyContent: 'flex-end',\n              gap: 16,\n              p: 24,\n              '>:not(style)~:not(style)': { ml: 0 },\n            }}\n          >\n            {secondaryText && (\n              <Button\n                aria-label={secondaryText}\n                color={secondaryColor}\n                onClick={handleSecondaryAction}\n              >\n                {secondaryText}\n              </Button>\n            )}\n            <Button\n              aria-label={primaryText}\n              color={primaryColor}\n              disabled={isPrimaryBlocked}\n              onClick={handlePrimaryAction}\n              variant=\"contained\"\n            >\n              {primaryText}\n            </Button>\n          </DialogActions>\n        </form>\n      </DialogContent>\n    </Dialog>\n  )\n}\n\nexport default CurrencyDialog\n"],"mappings":"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"}

package/dist/core/index.es.js

@@ -1,138 +1,140 @@
 import { LOCALES as r, VALID_LOCALES as t, buildDynamicCopy as i, getLocale as m } from "./utils/Localization.es.js";
 import { Fetch as p } from "./utils/Fetch.es.js";
-import { AccountIcon as a, AccountIconVariants as f, AccountSubType as c, AccountType as s, AccountTypeName as S, ConnectionStatus as A, ConnectionStatusEnums as u, ErrorStatuses as y, MfaStatuses as T, NonConnectedStatuses as l, ProcessingStatuses as g, PropertyType as d, PropertyTypeName as C, StatusName as N } from "./types/Account.es.js";
+import { AccountIcon as f, AccountIconVariants as a, AccountSubType as c, AccountType as s, AccountTypeName as S, ConnectionStatus as A, ConnectionStatusEnums as u, ErrorStatuses as y, MfaStatuses as T, NonConnectedStatuses as l, ProcessingStatuses as g, PropertyType as d, PropertyTypeName as C, StatusName as N } from "./types/Account.es.js";
 import { UserVerification as b } from "./types/Beat.es.js";
 import { ExpenseStatus as B, ScheduledPaymentTypes as L } from "./types/Expense.es.js";
 import { GoalType as E, MetaType as I, TrackType as P } from "./types/Goal.es.js";
-import { AccountNotificationTypes as F, BudgetNotificationTypes as H, InsightNotificationTypes as M, NotificationTypes as U } from "./types/Notification.es.js";
-import { TransactionStatus as x, TransactionType as O } from "./types/Transaction.es.js";
-import { ScreenSize as k } from "./types/ScreenSize.es.js";
-import { Frequency as w, RecurrenceStatus as z, RecurrenceType as _, RepeatingType as j } from "./types/RepeatingTransaction.es.js";
-import { AccountApi as J } from "./api/AccountApi.es.js";
-import { AnalyticsApi as Q } from "./api/AnalyticsApi.es.js";
-import { AppDataApi as Y } from "./api/AppDataApi.es.js";
-import { BannerApi as $ } from "./api/BannerApi.es.js";
-import { BeatApi as ro } from "./api/BeatApi.es.js";
-import { BudgetsApi as io } from "./api/BudgetsApi.es.js";
-import { CategoryApi as eo } from "./api/CategoryApi.es.js";
-import { FinstrongApi as no } from "./api/FinstrongApi.es.js";
-import { GlobalCopyApi as fo } from "./api/GlobalCopyApi.es.js";
-import { GoalApi as so } from "./api/GoalApi.es.js";
-import { HelpApi as Ao } from "./api/HelpApi.es.js";
-import { HoldingApi as yo } from "./api/HoldingApi.es.js";
-import { MerchantApi as lo } from "./api/MerchantApi.es.js";
-import { NotificationApi as Co } from "./api/NotificationApi.es.js";
-import { RepeatingTransactionsApi as ho } from "./api/RepeatingTransactionsApi.es.js";
-import { ScheduledPaymentsApi as Go } from "./api/ScheduledPaymentsApi.es.js";
-import { SettingsApi as Lo } from "./api/SettingsApi.es.js";
-import { TransactionApi as Eo } from "./api/TransactionApi.es.js";
-import { UserApi as Po } from "./api/UserApi.es.js";
-import { WidgetApi as Fo } from "./api/WidgetApi.es.js";
-import { AccountStore as Mo } from "./stores/AccountStore.es.js";
-import { AppDataStore as Vo } from "./stores/AppDataStore.es.js";
-import { AnalyticsStore as Oo } from "./stores/AnalyticsStore.es.js";
-import { BeatStore as ko } from "./stores/BeatStore.es.js";
-import { BudgetsStore as wo } from "./stores/BudgetsStore.es.js";
-import { CashflowStore as _o } from "./stores/CashflowStore.es.js";
-import { CategoryStore as vo } from "./stores/CategoryStore.es.js";
-import { ConnectStore as Ko } from "./stores/ConnectStore.es.js";
-import { DebtsStore as Xo } from "./stores/DebtsStore.es.js";
-import { FinstrongStore as Zo } from "./stores/FinstrongStore.es.js";
-import { GlobalStore as or } from "./stores/GlobalStore.es.js";
-import { GlobalUiStore as tr } from "./stores/GlobalUiStore.es.js";
-import { GlobalCopyStore as mr } from "./stores/GlobalCopyStore.es.js";
-import { GoalStore as pr } from "./stores/GoalStore.es.js";
-import { HelpStore as ar } from "./stores/HelpStore.es.js";
-import { HoldingStore as cr } from "./stores/HoldingStore.es.js";
-import { InsightsV2Store as Sr } from "./stores/InsightsV2Store.es.js";
-import { MerchantStore as ur } from "./stores/MerchantStore.es.js";
-import { NetWorthStore as Tr } from "./stores/NetWorthStore.es.js";
-import { NotificationStore as gr } from "./stores/NotificationStore.es.js";
-import { RecurringTransactionsStore as Cr } from "./stores/RecurringTransactionsStore.es.js";
-import { SettingsStore as hr } from "./stores/SettingsStore.es.js";
-import { TransactionStore as Gr } from "./stores/TransactionStore.es.js";
-import { TrendsStore as Lr } from "./stores/TrendsStore.es.js";
-import { UserStore as Er } from "./stores/UserStore.es.js";
+import { slot as F } from "./types/Insights.es.js";
+import { AccountNotificationTypes as M, BudgetNotificationTypes as U, InsightNotificationTypes as V, NotificationTypes as x } from "./types/Notification.es.js";
+import { TransactionStatus as W, TransactionType as k } from "./types/Transaction.es.js";
+import { ScreenSize as w } from "./types/ScreenSize.es.js";
+import { Frequency as _, RecurrenceStatus as j, RecurrenceType as v, RepeatingType as J } from "./types/RepeatingTransaction.es.js";
+import { AccountApi as Q } from "./api/AccountApi.es.js";
+import { AnalyticsApi as Y } from "./api/AnalyticsApi.es.js";
+import { AppDataApi as $ } from "./api/AppDataApi.es.js";
+import { BannerApi as ro } from "./api/BannerApi.es.js";
+import { BeatApi as io } from "./api/BeatApi.es.js";
+import { BudgetsApi as eo } from "./api/BudgetsApi.es.js";
+import { CategoryApi as no } from "./api/CategoryApi.es.js";
+import { FinstrongApi as ao } from "./api/FinstrongApi.es.js";
+import { GlobalCopyApi as so } from "./api/GlobalCopyApi.es.js";
+import { GoalApi as Ao } from "./api/GoalApi.es.js";
+import { HelpApi as yo } from "./api/HelpApi.es.js";
+import { HoldingApi as lo } from "./api/HoldingApi.es.js";
+import { MerchantApi as Co } from "./api/MerchantApi.es.js";
+import { NotificationApi as ho } from "./api/NotificationApi.es.js";
+import { RepeatingTransactionsApi as Go } from "./api/RepeatingTransactionsApi.es.js";
+import { ScheduledPaymentsApi as Lo } from "./api/ScheduledPaymentsApi.es.js";
+import { SettingsApi as Eo } from "./api/SettingsApi.es.js";
+import { TransactionApi as Po } from "./api/TransactionApi.es.js";
+import { UserApi as Fo } from "./api/UserApi.es.js";
+import { WidgetApi as Mo } from "./api/WidgetApi.es.js";
+import { AccountStore as Vo } from "./stores/AccountStore.es.js";
+import { AppDataStore as Oo } from "./stores/AppDataStore.es.js";
+import { AnalyticsStore as ko } from "./stores/AnalyticsStore.es.js";
+import { BeatStore as wo } from "./stores/BeatStore.es.js";
+import { BudgetsStore as _o } from "./stores/BudgetsStore.es.js";
+import { CashflowStore as vo } from "./stores/CashflowStore.es.js";
+import { CategoryStore as Ko } from "./stores/CategoryStore.es.js";
+import { ConnectStore as Xo } from "./stores/ConnectStore.es.js";
+import { DebtsStore as Zo } from "./stores/DebtsStore.es.js";
+import { FinstrongStore as or } from "./stores/FinstrongStore.es.js";
+import { GlobalStore as tr } from "./stores/GlobalStore.es.js";
+import { GlobalUiStore as mr } from "./stores/GlobalUiStore.es.js";
+import { GlobalCopyStore as pr } from "./stores/GlobalCopyStore.es.js";
+import { GoalStore as fr } from "./stores/GoalStore.es.js";
+import { HelpStore as cr } from "./stores/HelpStore.es.js";
+import { HoldingStore as Sr } from "./stores/HoldingStore.es.js";
+import { InsightsV2Store as ur } from "./stores/InsightsV2Store.es.js";
+import { MerchantStore as Tr } from "./stores/MerchantStore.es.js";
+import { NetWorthStore as gr } from "./stores/NetWorthStore.es.js";
+import { NotificationStore as Cr } from "./stores/NotificationStore.es.js";
+import { RecurringTransactionsStore as hr } from "./stores/RecurringTransactionsStore.es.js";
+import { SettingsStore as Gr } from "./stores/SettingsStore.es.js";
+import { TransactionStore as Lr } from "./stores/TransactionStore.es.js";
+import { TrendsStore as Er } from "./stores/TrendsStore.es.js";
+import { UserStore as Pr } from "./stores/UserStore.es.js";
 export {
-  J as AccountApi,
-  a as AccountIcon,
-  f as AccountIconVariants,
-  F as AccountNotificationTypes,
-  Mo as AccountStore,
+  Q as AccountApi,
+  f as AccountIcon,
+  a as AccountIconVariants,
+  M as AccountNotificationTypes,
+  Vo as AccountStore,
   c as AccountSubType,
   s as AccountType,
   S as AccountTypeName,
-  Q as AnalyticsApi,
-  Oo as AnalyticsStore,
-  Y as AppDataApi,
-  Vo as AppDataStore,
-  $ as BannerApi,
-  ro as BeatApi,
-  ko as BeatStore,
-  H as BudgetNotificationTypes,
-  io as BudgetsApi,
-  wo as BudgetsStore,
-  _o as CashflowStore,
-  eo as CategoryApi,
-  vo as CategoryStore,
-  Ko as ConnectStore,
+  Y as AnalyticsApi,
+  ko as AnalyticsStore,
+  $ as AppDataApi,
+  Oo as AppDataStore,
+  ro as BannerApi,
+  io as BeatApi,
+  wo as BeatStore,
+  U as BudgetNotificationTypes,
+  eo as BudgetsApi,
+  _o as BudgetsStore,
+  vo as CashflowStore,
+  no as CategoryApi,
+  Ko as CategoryStore,
+  Xo as ConnectStore,
   A as ConnectionStatus,
   u as ConnectionStatusEnums,
-  Xo as DebtsStore,
+  Zo as DebtsStore,
   y as ErrorStatuses,
   B as ExpenseStatus,
   p as Fetch,
-  no as FinstrongApi,
-  Zo as FinstrongStore,
-  w as Frequency,
-  fo as GlobalCopyApi,
-  mr as GlobalCopyStore,
-  or as GlobalStore,
-  tr as GlobalUiStore,
-  so as GoalApi,
-  pr as GoalStore,
+  ao as FinstrongApi,
+  or as FinstrongStore,
+  _ as Frequency,
+  so as GlobalCopyApi,
+  pr as GlobalCopyStore,
+  tr as GlobalStore,
+  mr as GlobalUiStore,
+  Ao as GoalApi,
+  fr as GoalStore,
   E as GoalType,
-  Ao as HelpApi,
-  ar as HelpStore,
-  yo as HoldingApi,
-  cr as HoldingStore,
-  M as InsightNotificationTypes,
-  Sr as InsightsV2Store,
+  yo as HelpApi,
+  cr as HelpStore,
+  lo as HoldingApi,
+  Sr as HoldingStore,
+  V as InsightNotificationTypes,
+  ur as InsightsV2Store,
   r as LOCALES,
-  lo as MerchantApi,
-  ur as MerchantStore,
+  Co as MerchantApi,
+  Tr as MerchantStore,
   I as MetaType,
   T as MfaStatuses,
-  Tr as NetWorthStore,
+  gr as NetWorthStore,
   l as NonConnectedStatuses,
-  Co as NotificationApi,
-  gr as NotificationStore,
-  U as NotificationTypes,
+  ho as NotificationApi,
+  Cr as NotificationStore,
+  x as NotificationTypes,
   g as ProcessingStatuses,
   d as PropertyType,
   C as PropertyTypeName,
-  z as RecurrenceStatus,
-  _ as RecurrenceType,
-  Cr as RecurringTransactionsStore,
-  ho as RepeatingTransactionsApi,
-  j as RepeatingType,
+  j as RecurrenceStatus,
+  v as RecurrenceType,
+  hr as RecurringTransactionsStore,
+  Go as RepeatingTransactionsApi,
+  J as RepeatingType,
   L as ScheduledPaymentTypes,
-  Go as ScheduledPaymentsApi,
-  k as ScreenSize,
-  Lo as SettingsApi,
-  hr as SettingsStore,
+  Lo as ScheduledPaymentsApi,
+  w as ScreenSize,
+  Eo as SettingsApi,
+  Gr as SettingsStore,
   N as StatusName,
   P as TrackType,
-  Eo as TransactionApi,
-  x as TransactionStatus,
-  Gr as TransactionStore,
-  O as TransactionType,
-  Lr as TrendsStore,
-  Po as UserApi,
-  Er as UserStore,
+  Po as TransactionApi,
+  W as TransactionStatus,
+  Lr as TransactionStore,
+  k as TransactionType,
+  Er as TrendsStore,
+  Fo as UserApi,
+  Pr as UserStore,
   b as UserVerification,
   t as VALID_LOCALES,
-  Fo as WidgetApi,
+  Mo as WidgetApi,
   i as buildDynamicCopy,
-  m as getLocale
+  m as getLocale,
+  F as slot
 };

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

@@ -39,7 +39,7 @@ export interface InsightsPayload {
     widget_type: WidgetType;
     instance_slot: InstanceSlot;
     /**
-     * V1 only. The v2 contract carries everything a block needs on `instance_slot.data_series` rows,
+     * V1 only. The v2 contract carries everything a block needs on `instance_slot.data`,
      * and omits this key entirely (see the LargeTransactionV2 payload). Blocks that still require it
      * get it as a required field through `BlockProps`, which re-declares it.
      */
@@ -237,22 +237,39 @@ export interface InstanceSlotRow {
     primary_text?: string;
     secondary_text?: string;
 }
+/**
+ * V2: the slots a block's variant filled, keyed by slot name; ditto owns the names and omits any
+ * slot it has no value for (`lib/ditto/blocks/<block>.yml`). Read with `slot()`, which names the
+ * kind the caller expects.
+ */
+export interface InstanceSlotData {
+    [slot: string]: unknown;
+}
+/**
+ * Reads one slot off a block's `data`; undefined when ditto did not fill it.
+ *
+ * The caller names the kind, because the slot's kind lives in the block's ditto schema and not
+ * here — a block fills slots with whatever its card needs, so no fixed list of kinds would hold
+ * (`account_switch_block` alone carries a boolean and `budget_block` a nested object).
+ */
+export declare const slot: <T = unknown>(data: InstanceSlotData | undefined, name: string) => T | undefined;
+/**
+ * V2: which block renders this beat's content, and what it renders.
+ *
+ * `block` is optional: a beat whose template has no ditto config arrives as an empty `{}` and the
+ * card renders its copy and CTAs alone, so a reader cannot assume a block is named. One interface
+ * with `block` optional rather than a union with `Record<string, never>`, which TypeScript absorbs
+ * — that union left `block` reading as required and typed a promise it did not keep.
+ *
+ * `variant` is optional for the same reason — the empty `{}` carries neither. Every ditto beat
+ * file that names a block also names a variant, so a *filled* slot always has one; ditto drops a
+ * nil variant rather than sending null, which is why the type is `string | null | undefined`.
+ */
 export interface InstanceSlot {
-    block: BlockType;
-    variant: string | null;
-    /**
-     * V2: the slot's pre-localized header, sent by tupac's `instance_slot_with_text` /
-     * `instance_slot_with_header` envelopes (e.g. `"July 26"`, the transaction date).
-     *
-     * This is *not* a row field: under `with_header` a row's `secondary_text` is the category, so
-     * the header has to come from here. Absent on the `logos_only` envelopes (micro/notification).
-     */
-    header_text?: string;
-    /**
-     * V2 (LargeTransactionV2 onward): rows carried inline on the slot. V1 blocks read their data
-     * from `InsightsPayload.instance_slot_data` instead and leave this absent.
-     */
-    data_series?: InstanceSlotRow[];
+    block?: BlockType;
+    variant?: string | null;
+    /** The slots this block's variant declares in ditto. */
+    data?: InstanceSlotData;
     /** Primary line on the hero card, e.g. "Epic Bank Checking, *1234". */
     account_name?: string;
     /** Secondary line beneath the name, e.g. "Checking Account" / "Credit Card". */

package/dist/core/types/Insights.es.js

@@ -0,0 +1,6 @@
+var t = (o, r) => o?.[r];
+export {
+  t as slot
+};
+
+//# sourceMappingURL=Insights.es.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Insights.es.js","names":[],"sources":["../../../src/core/types/Insights.ts"],"sourcesContent":["// ============ Core InsightsV2 Types ============\n\nimport { InsightsInstanceSlotData } from './InsightsInstanceSlotData'\n\nexport interface ThemedSVGImageProps {\n  divProps?: React.HTMLAttributes<HTMLDivElement>\n  image: React.ComponentType<React.SVGProps<SVGSVGElement>>\n  isMini?: boolean\n}\n\n/**\n * Emitted by a block when the user drills into a specific datum (e.g. clicks a\n * chart bar). Named fields rather than positional args so blocks with differing\n * shapes can extend this without the call sites transposing values.\n */\nexport interface DrilldownPayload {\n  chartBarIndex: number\n  tabIndex?: number\n  transaction_guid?: string\n  block?: string\n}\n\n/**\n * Which envelope a beat was fetched with. `embedded` (the transaction-row pill + details-drawer\n * card) and `notification` are V2 additions; a surface asks for one with `widget_type=` on the fetch.\n */\nexport type WidgetType = 'full' | 'mini' | 'micro' | 'embedded' | 'notification'\n\n/**\n * V2: the transaction-row tag, its own small section of the `embedded` envelope (the same grammar\n * as `description` / `footer`, with room for a tone or an icon later). Omitted for an insight that\n * tags no transaction row. It deliberately is *not* `short_title`, which stays a per-variant\n * attribute with a second consumer (the bank-holiday sub-header).\n */\nexport interface Pill {\n  text: string\n}\n\n/**\n * V2: facts a drilldown shows that the card does not (e.g. the account number for the Transaction\n * Details drawer). A flat hash shared by every CTA of the card, omitted when the insight has none.\n * Never carries copy or user actions (memo, tags, hide, flag come from the transaction store).\n */\nexport type DrilldownData = Record<string, string | number | boolean | null>\n\nexport interface InsightsPayload {\n  widget_type: WidgetType\n  instance_slot: InstanceSlot\n  /**\n   * V1 only. The v2 contract carries everything a block needs on `instance_slot.data`,\n   * and omits this key entirely (see the LargeTransactionV2 payload). Blocks that still require it\n   * get it as a required field through `BlockProps`, which re-declares it.\n   */\n  instance_slot_data?: InsightsInstanceSlotData\n  description: Description\n  primary_cta?: PrimaryCTA\n  secondary_cta?: SecondaryCTA\n  title?: string\n  sub_title?: Subtitle\n  /**\n   * V2 rename of `sub_title`: a flat string, with the logo promoted to the payload-level `logo`\n   * field below. `sub_title` wins when both are present.\n   */\n  subtitle?: string\n  /** V2: header logo paired with the flat `subtitle`: an entity guid or a status icon (`LogoRef`). */\n  logo?: LogoRef\n  /** V2: which design branch the backend picked (e.g. `no_merchant`). */\n  variant?: string\n  /** V2, `embedded` envelope only: the transaction-row pill. */\n  pill?: Pill\n  /** V2: drilldown-only facts, e.g. `{ account_number: 'XXXXXXXX043' }`. */\n  drilldown_data?: DrilldownData\n  footer?: Footer\n  // TODO: Add in_description_cta to insights_payload from backend\n  guid: string\n  user_guid: string\n  client_guid?: string\n  /** Template name, e.g. `LargeTransactionV2`. */\n  template?: string\n  revision?: number\n  /** Unix seconds. */\n  created_at?: number\n  /** Unix seconds. */\n  updated_at?: number\n  /** Unix seconds. */\n  active_at?: number\n  displayed_at?: number | null\n  dismissed_at: number | null\n  cta_clicked_at?: number | null\n  has_been_displayed?: boolean\n  is_dismissed: boolean\n  is_deleted?: boolean\n  is_hidden_by_system?: boolean\n  is_obsolete?: boolean\n  is_refreshable?: boolean\n  is_sampled?: boolean\n  is_zero_state?: boolean\n  status?: string | null\n  /**\n   * V2 (LargeTransactionV2 onward): the entities the beat is about, carried on the payload so\n   * action blocks do not have to reach back out to the beat envelope.\n   */\n  primary_account_guid?: string | null\n  primary_transaction_guid?: string | null\n  primary_category_guid?: string | null\n  primary_merchant_guid?: string | null\n  /**\n   * V2: the repeating transaction a subscription beat is about (Upcoming Subscription, Subscription\n   * Price Increase). Read by `recurring_transaction_block`, see\n   * `actionBlocks/RecurringTransactionBlock/subscriptionBeats.ts`.\n   */\n  primary_repeating_transaction_guid?: string | null\n}\n\nexport interface Legends {\n  label: string\n  value: number\n  additional_value?: number\n  additional_value_type?: string\n  value_type?: string\n}\n\nexport interface Logo {\n  category_guid?: string\n  category_name?: string\n  institution_guid?: string\n  institution_name?: string\n  logo_color?: string\n  logo_name?: string\n  merchant_guid?: string\n  merchant_name?: string\n}\n\nexport interface Subtitle {\n  logo?: Logo\n  text: string\n}\n\n/**\n * A V2 logo, shared by the header (`InsightsPayload.logo`) and every instance-slot row. It takes\n * one of two shapes:\n *\n * - **Entity**: `guid`, whose prefix (`INS-` / `MCH-` / `CAT-`) picks the logo component, plus an\n *   optional `fallback_guid` for when that component's asset cannot load. Today that is the\n *   category behind an `MCH-` guid, which `MerchantLogo` shows as a tile when the merchant image\n *   is missing.\n * - **Status icon**: `icon` (an mx-icons name, e.g. `warning`) and `color` (a theme palette path,\n *   e.g. `error.main`), for subheaders that show a state rather than an entity (V1's\n *   `logo_name` / `logo_color`).\n *\n * `alt` is the accessible name for either shape. A logo sends one shape; if it sends both, `icon`\n * wins, as `logo_name` does in V1's `SubHeader`.\n */\nexport interface LogoRef {\n  alt?: string\n  color?: string\n  fallback_guid?: string\n  guid?: string\n  icon?: string\n}\n\nexport interface CategoryLogo {\n  category_guid: string\n  category_name: string\n}\n\nexport interface MerchantLogo {\n  merchant_guid: string\n  merchant_name: string\n}\n\nexport interface InstitutionLogo {\n  institution_guid: string\n  institution_name: string\n}\n\nexport interface Description {\n  text: string\n  html_text: string\n}\n\n/**\n * Post message a CTA press sends to the host, resolved by the backend for the beat's current\n * state. Absent/null = the backend has not described one: the frontend uses the template's\n * interim `ctaPostMessages` entry if there is one, else sends no message. `payload` carries only\n * beat-specific extras; the frontend always adds `beat_guid`, `beat_template`, `user_guid` and\n * `action_string`.\n */\nexport interface CtaPostMessageMetadata {\n  /** Post message event; defaults to `beat/cta`. */\n  event?: string | null\n  /** Operation the host should perform, e.g. `op_1`, `op_2`, `op_3`. Defaults to `op_1`. */\n  action?: string | null\n  /** Beat-specific fields merged into the message metadata (account ids, amounts, ...). */\n  payload?: Record<string, unknown> | null\n}\n\nexport interface PrimaryCTA {\n  label: string\n  block: string\n  variant?: string | null\n  /**\n   * What pressing the CTA does beyond opening its block, named by the backend (ditto\n   * `primary_cta_action`, passed through by tupac). Looked up in `insights-v2/ctaActions`;\n   * null / absent / unknown means the CTA only opens its block or posts its message.\n   */\n  action_key?: string | null\n  metadata?: CtaPostMessageMetadata | null\n}\n\nexport interface SecondaryCTA {\n  label: string\n  block: string\n  variant?: string | null\n  /** See `PrimaryCTA.action_key` (ditto `secondary_cta_action`). */\n  action_key?: string | null\n  metadata?: CtaPostMessageMetadata | null\n}\n\nexport interface Footer {\n  /** V1: a pre-formatted date string. */\n  date?: string\n  /**\n   * The account label, on both V1 and V2. The backend resolves the plurality: one account sends\n   * its name (e.g. `Epic Bank`), several send a localized count (e.g. `2 Accounts`), none sends\n   * nothing. There is deliberately no separate `accounts` key — see tupac's `footer_account_label`.\n   */\n  account?: string\n  /**\n   * V2 (LargeTransactionV2 onward): unix seconds, formatted by `Footer` for display.\n   * Replaces `date`; `date` wins when a beat somehow sends both.\n   */\n  timestamp?: number\n}\n\n// ============ Instance Slot Types ============\n// Values are the snake_case block names the backend sends on a beat's instance slot; the PascalCase\n// keys stay as friendly references (e.g. BlockType.BarChartBlock === 'bar_chart_block').\nexport const BlockType = {\n  AccountBlock: 'account_block',\n  AccountSwitchBlock: 'account_switch_block',\n  BarChartBlock: 'bar_chart_block',\n  BudgetBlock: 'budget_block',\n  ImageBlock: 'image_block',\n  TransactionBlock: 'transaction_block',\n  DonutChartBlock: 'donut_chart_block',\n  DoubleBarChartBlock: 'double_bar_chart_block',\n  DoubleProgressBarBlock: 'double_progress_bar_block',\n  SaveExtraBlock: 'save_extra_block',\n  StepChartBlock: 'step_chart_block',\n  SVGImageBlock: 'svg_image_block',\n  WithdrawalBlock: 'withdrawal_block',\n} as const\n\nexport type BlockType = (typeof BlockType)[keyof typeof BlockType]\n\n/**\n * A pre-localized row on a V2 instance slot. The backend resolves the copy and formatting; the\n * logo is a `LogoRef` (an entity guid or a status icon, see `logoFromRef`).\n */\nexport interface InstanceSlotRow {\n  amount?: number\n  logo?: LogoRef\n  primary_text?: string\n  secondary_text?: string\n}\n\n/**\n * V2: the slots a block's variant filled, keyed by slot name; ditto owns the names and omits any\n * slot it has no value for (`lib/ditto/blocks/<block>.yml`). Read with `slot()`, which names the\n * kind the caller expects.\n */\nexport interface InstanceSlotData {\n  [slot: string]: unknown\n}\n\n/**\n * Reads one slot off a block's `data`; undefined when ditto did not fill it.\n *\n * The caller names the kind, because the slot's kind lives in the block's ditto schema and not\n * here — a block fills slots with whatever its card needs, so no fixed list of kinds would hold\n * (`account_switch_block` alone carries a boolean and `budget_block` a nested object).\n */\nexport const slot = <T = unknown>(\n  data: InstanceSlotData | undefined,\n  name: string,\n): T | undefined => data?.[name] as T | undefined\n\n/**\n * V2: which block renders this beat's content, and what it renders.\n *\n * `block` is optional: a beat whose template has no ditto config arrives as an empty `{}` and the\n * card renders its copy and CTAs alone, so a reader cannot assume a block is named. One interface\n * with `block` optional rather than a union with `Record<string, never>`, which TypeScript absorbs\n * — that union left `block` reading as required and typed a promise it did not keep.\n *\n * `variant` is optional for the same reason — the empty `{}` carries neither. Every ditto beat\n * file that names a block also names a variant, so a *filled* slot always has one; ditto drops a\n * nil variant rather than sending null, which is why the type is `string | null | undefined`.\n */\nexport interface InstanceSlot {\n  block?: BlockType\n  variant?: string | null\n  /** The slots this block's variant declares in ditto. */\n  data?: InstanceSlotData\n  // Direct Deposit block (Set Up Direct Deposit, Switch Direct Deposit, Missing\n  // Interest Rate): account facts carried flat on the slot, beside `data`.\n  /** Primary line on the hero card, e.g. \"Epic Bank Checking, *1234\". */\n  account_name?: string\n  /** Secondary line beneath the name, e.g. \"Checking Account\" / \"Credit Card\". */\n  account_type?: string\n  /** Status pill label, e.g. \"Direct Deposit Not Set Up\" / \"Interest Rate: 19.99% APR\". */\n  status_text?: string\n  institution_guid?: string\n  institution_name?: string\n}\n"],"mappings":"AA2RA,IAAa,IAAA,CACX,GACA,MACkB,IAAO,CAAA"}

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

@@ -13,7 +13,8 @@ export type { Expense } from './Expense';
 export { ExpenseStatus, ScheduledPaymentTypes } from './Expense';
 export type { DynamicCopyElement, GlobalCopy } from './GlobalCopy';
 export { GoalType, MetaType, TrackType } from './Goal';
-export type { ThemedSVGImageProps, DrilldownData, DrilldownPayload, InsightsPayload, InstanceSlot, Pill, WidgetType, InstanceSlotRow, BlockType, Description, PrimaryCTA, CtaPostMessageMetadata, SecondaryCTA, Subtitle, Footer, Logo, LogoRef, CategoryLogo, MerchantLogo, InstitutionLogo, Legends, } from './Insights';
+export type { ThemedSVGImageProps, DrilldownData, DrilldownPayload, InsightsPayload, InstanceSlot, InstanceSlotData, Pill, WidgetType, InstanceSlotRow, BlockType, Description, PrimaryCTA, CtaPostMessageMetadata, SecondaryCTA, Subtitle, Footer, Logo, LogoRef, CategoryLogo, MerchantLogo, InstitutionLogo, Legends, } from './Insights';
+export { slot } from './Insights';
 export type { Goal, MonthlyCashFlowProfile, RetirementGoalAccount } from './Goal';
 export type { Debt } from './Debt';
 export type { GlobalCaptureException, GlobalErrorHandler, GlobalEventHandler } from './Handlers';