@tesouro/embedded-components-react 0.2.284 → 0.2.288

package/dist/experimental/WidgetSuite.d.ts

@@ -739,6 +739,110 @@ declare const WIDGET_SUITE_SECTION_TITLE_LABELS_EN: WidgetSuiteSectionTitleLabel
 declare const WIDGET_SUITE_CONTENT_LABELS_EN: WidgetSuiteContentLabels;
 declare const WIDGET_SUITE_DISCLOSURE_LABELS_EN: WidgetSuiteDisclosureLabels;
 
+interface CardsWidgetPaginationInput {
+    paginationToken?: string;
+    pageSize?: number;
+}
+
+/**
+ * The sections this widget renders itself. These ids are the public vocabulary
+ * a host uses to deep-link into a section, so they are part of the package's
+ * API surface — renaming one is a breaking change.
+ */
+declare const SettingsSection: {
+    readonly Profile: "profile";
+    readonly Team: "team";
+    readonly Invoice: "invoice";
+    readonly Expense: "expense";
+    readonly BillPay: "bill-pay";
+    readonly Accounting: "accounting";
+    readonly Tags: "tags";
+    readonly Help: "help";
+};
+type SettingsSection = (typeof SettingsSection)[keyof typeof SettingsSection];
+/**
+ * A selectable section id: one of the built-ins, or the id of a host-supplied
+ * {@link SettingsWidgetAdditionalSection}. The `string & {}` arm keeps the
+ * built-in literals visible to editor autocomplete while still accepting a
+ * host's own id.
+ */
+type SettingsWidgetSectionId = SettingsSection | (string & {});
+
+interface WidgetSuiteAccountsSelection {
+    /** The account whose details are open. `null` is the list. */
+    accountId?: string | null;
+}
+interface WidgetSuiteCardsSelection {
+    /** The card whose details panel is open. `null` closes it. */
+    cardId?: string | null;
+    /**
+     * The list's cursor and page size. Forwarded to the widget's own `pagination`
+     * and `defaultPagination`, so the suite holds no cursor of its own: leaving
+     * the section and coming back restarts the walk unless a host drives it.
+     */
+    pagination?: CardsWidgetPaginationInput;
+}
+interface WidgetSuiteSettingsSelection {
+    /**
+     * The settings section on screen. Controlled only: the suite never supplies a
+     * value of its own, because `SettingsWidget` substitutes another section when
+     * this one is not available to the user and reports nothing when it does
+     * (EMBD-4980 adds the `defaultSelectedSection` that would make an initial
+     * value safe).
+     */
+    section?: SettingsWidgetSectionId;
+}
+/**
+ * Where the suite is pointed, grouped by section.
+ *
+ * One object rather than a prop per key: it is the value a host mirrors into its
+ * URL, and it groups the same way `contentLabels` does. Every key resolves
+ * independently, so `selection={{ section: 'accounts' }}` drives the menu and
+ * leaves the account to `defaultSelection`.
+ *
+ * Credit and debit cards get separate groups because the Cards section mounts
+ * two `CardsWidget` instances against two endpoints, so one card id cannot
+ * address both. There is no `invoicing` group: that section renders the Monite
+ * `<Receivables />`, whose tab is internal state (EMBD-2171 replaces it,
+ * EMBD-4979 makes the native tab controllable).
+ */
+interface WidgetSuiteSelection {
+    section?: WidgetSuiteSectionId;
+    accounts?: WidgetSuiteAccountsSelection;
+    creditCards?: WidgetSuiteCardsSelection;
+    debitCards?: WidgetSuiteCardsSelection;
+    settings?: WidgetSuiteSettingsSelection;
+}
+/**
+ * Where the suite can *open*, which is not everything it can be driven to:
+ * `SettingsWidget` takes no initial section, so naming one here would be a
+ * silent no-op (EMBD-4980 adds the prop that makes it work).
+ *
+ * Derived rather than hand-written, so each key stays in exactly one of the two
+ * types as the widgets behind them gain the props they are missing.
+ */
+type WidgetSuiteDefaultSelection = Omit<WidgetSuiteSelection, 'settings'>;
+interface WidgetSuiteCardsSelectionSnapshot {
+    cardId: string | null;
+    pagination: CardsWidgetPaginationInput | undefined;
+}
+/**
+ * The selection as the suite reports it: every key carries a value, so a host
+ * reading one needs no optional chaining. Assignable to
+ * {@link WidgetSuiteSelection}, so a host can hand a snapshot straight back.
+ */
+interface WidgetSuiteSelectionSnapshot {
+    section: WidgetSuiteSectionId | undefined;
+    accounts: {
+        accountId: string | null;
+    };
+    creditCards: WidgetSuiteCardsSelectionSnapshot;
+    debitCards: WidgetSuiteCardsSelectionSnapshot;
+    settings: {
+        section: SettingsWidgetSectionId | undefined;
+    };
+}
+
 interface WidgetSuiteProps extends WidgetProviderProps {
     /**
      * Which sections the suite offers, in menu order.
@@ -753,6 +857,34 @@ interface WidgetSuiteProps extends WidgetProviderProps {
      * this is the host's ceiling rather than a promise of what renders.
      */
     sections: readonly WidgetSuiteSectionId[];
+    /**
+     * Where the suite is pointed, for a host that owns navigation — a URL, a
+     * router, its own state. Every key resolves on its own, so driving one leaves
+     * the rest to the suite.
+     *
+     * A key here puts the widget behind it in controlled mode for the lifetime of
+     * the mount, so supply it with `onSelectionChange` or the surface will not
+     * move when the user clicks.
+     */
+    selection?: WidgetSuiteSelection;
+    /**
+     * Where the suite opens, for a host that wants a deep link but not ownership.
+     * Read once per mount, and ignored per key when `selection` names that key.
+     *
+     * Carries every key `selection` does bar `settings` — see
+     * {@link WidgetSuiteDefaultSelection}.
+     */
+    defaultSelection?: WidgetSuiteDefaultSelection;
+    /**
+     * The whole selection after a person moved the suite: a menu click, a row, a
+     * card, a settings tab, a page of a card list. Every key carries a value, and
+     * the object can be handed straight back as `selection`.
+     *
+     * Never fired for the entitlement fallback, and never fired on mount, so a
+     * host mirroring this into its URL cannot overwrite the deep link it was just
+     * handed. A move that touches two keys reports once.
+     */
+    onSelectionChange?: (selection: WidgetSuiteSelectionSnapshot) => void;
     /** Overrides for the shell's own copy — the nav landmark name, empty state. */
     labels?: PartialDeep<WidgetSuiteShellLabels>;
     /** Overrides for the section names in the menu. */
@@ -779,8 +911,8 @@ interface WidgetSuiteProps extends WidgetProviderProps {
      * heading reads as a fragment of someone else's. Set `false` when the host
      * already renders a heading of its own above the suite.
      *
-     * Sections whose widget heads itself (Accounts, Settings) never get one, at
-     * any setting — see `rendersOwnTitle` in `sections.tsx`.
+     * Sections whose widget heads itself (Accounts, Cards, Settings) never get
+     * one, at any setting — see `rendersOwnTitle` in `sections.tsx`.
      */
     showSectionTitle?: boolean;
 }
@@ -801,15 +933,17 @@ interface WidgetSuiteProps extends WidgetProviderProps {
  * init fails before answering the disclosure flags, the acceptance surface
  * alone when the session owes the bank's disclosures, or the nav over its
  * sections. States rather than an overlay over a mounted shell — see
- * `WidgetSuiteInner` for why each boundary sits where it does.
+ * `WidgetSuiteSurface` for why each boundary sits where it does.
  *
- * The active section is held here rather than taken as a prop, matching
- * `BillPayWidgetNative` and `SettingsWidget`. A host-controlled
- * `selectedSectionId` / `onSectionChange` pair is the natural next step for
- * deep-linking, and is deliberately not invented on an experimental export
- * before a host asks for it.
+ * Navigation is one `selection` object a host can drive key by key, published to
+ * the sections through `WidgetSuiteProvider`. Only the open panel is mounted, so
+ * a key the suite holds survives leaving a section and coming back and a key it
+ * does not hold is lost: today Accounts remembers its open account and Cards its
+ * open card, while Bill Pay forgets its tab, Settings its section and each card
+ * list its cursor. That split is the widgets' current shape rather than a
+ * decision — see `WidgetSuiteSelection` for the ticket behind each gap.
  */
 declare function WidgetSuite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: WidgetSuiteProps): React.JSX.Element;
 
 export { WIDGET_SUITE_CONTENT_LABELS_EN, WIDGET_SUITE_DEFAULT_SECTIONS, WIDGET_SUITE_DISCLOSURE_LABELS_EN, WIDGET_SUITE_SECTION_LABELS_EN, WIDGET_SUITE_SECTION_TITLE_LABELS_EN, WIDGET_SUITE_SHELL_LABELS_EN, WidgetSuite, WidgetSuiteSectionId };
-export type { PartialDeep, WidgetSuiteContentLabels, WidgetSuiteDisclosureLabels, WidgetSuiteProps, WidgetSuiteSectionLabels, WidgetSuiteSectionTitleLabels, WidgetSuiteShellLabels };
+export type { PartialDeep, WidgetSuiteAccountsSelection, WidgetSuiteCardsSelection, WidgetSuiteCardsSelectionSnapshot, WidgetSuiteContentLabels, WidgetSuiteDefaultSelection, WidgetSuiteDisclosureLabels, WidgetSuiteProps, WidgetSuiteSectionLabels, WidgetSuiteSectionTitleLabels, WidgetSuiteSelection, WidgetSuiteSelectionSnapshot, WidgetSuiteSettingsSelection, WidgetSuiteShellLabels };

package/dist/experimental/WidgetSuite.js

@@ -1,6 +1,6 @@
 import { WIDGET_SUITE_CONTENT_LABELS_EN as e, WIDGET_SUITE_DISCLOSURE_LABELS_EN as t, WIDGET_SUITE_SECTION_LABELS_EN as n, WIDGET_SUITE_SECTION_TITLE_LABELS_EN as r } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index4.js";
-import { WIDGET_SUITE_DEFAULT_SECTIONS as i, WidgetSuiteSectionId as a } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index5.js";
+import { WIDGET_SUITE_DEFAULT_SECTIONS as i, WidgetSuiteSectionId as a } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index7.js";
 import { WIDGET_SUITE_SHELL_LABELS_EN as o } from "../libs/tesouro-embedded-components-react/widget-suite/ui/dist/index2.js";
-import { WidgetSuite as s } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index6.js";
+import { WidgetSuite as s } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index8.js";
 import "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index.js";
 export { e as WIDGET_SUITE_CONTENT_LABELS_EN, i as WIDGET_SUITE_DEFAULT_SECTIONS, t as WIDGET_SUITE_DISCLOSURE_LABELS_EN, n as WIDGET_SUITE_SECTION_LABELS_EN, r as WIDGET_SUITE_SECTION_TITLE_LABELS_EN, o as WIDGET_SUITE_SHELL_LABELS_EN, s as WidgetSuite, a as WidgetSuiteSectionId };

package/dist/experimental/index.d.ts

@@ -739,6 +739,110 @@ declare const WIDGET_SUITE_SECTION_TITLE_LABELS_EN: WidgetSuiteSectionTitleLabel
 declare const WIDGET_SUITE_CONTENT_LABELS_EN: WidgetSuiteContentLabels;
 declare const WIDGET_SUITE_DISCLOSURE_LABELS_EN: WidgetSuiteDisclosureLabels;
 
+interface CardsWidgetPaginationInput {
+    paginationToken?: string;
+    pageSize?: number;
+}
+
+/**
+ * The sections this widget renders itself. These ids are the public vocabulary
+ * a host uses to deep-link into a section, so they are part of the package's
+ * API surface — renaming one is a breaking change.
+ */
+declare const SettingsSection: {
+    readonly Profile: "profile";
+    readonly Team: "team";
+    readonly Invoice: "invoice";
+    readonly Expense: "expense";
+    readonly BillPay: "bill-pay";
+    readonly Accounting: "accounting";
+    readonly Tags: "tags";
+    readonly Help: "help";
+};
+type SettingsSection = (typeof SettingsSection)[keyof typeof SettingsSection];
+/**
+ * A selectable section id: one of the built-ins, or the id of a host-supplied
+ * {@link SettingsWidgetAdditionalSection}. The `string & {}` arm keeps the
+ * built-in literals visible to editor autocomplete while still accepting a
+ * host's own id.
+ */
+type SettingsWidgetSectionId = SettingsSection | (string & {});
+
+interface WidgetSuiteAccountsSelection {
+    /** The account whose details are open. `null` is the list. */
+    accountId?: string | null;
+}
+interface WidgetSuiteCardsSelection {
+    /** The card whose details panel is open. `null` closes it. */
+    cardId?: string | null;
+    /**
+     * The list's cursor and page size. Forwarded to the widget's own `pagination`
+     * and `defaultPagination`, so the suite holds no cursor of its own: leaving
+     * the section and coming back restarts the walk unless a host drives it.
+     */
+    pagination?: CardsWidgetPaginationInput;
+}
+interface WidgetSuiteSettingsSelection {
+    /**
+     * The settings section on screen. Controlled only: the suite never supplies a
+     * value of its own, because `SettingsWidget` substitutes another section when
+     * this one is not available to the user and reports nothing when it does
+     * (EMBD-4980 adds the `defaultSelectedSection` that would make an initial
+     * value safe).
+     */
+    section?: SettingsWidgetSectionId;
+}
+/**
+ * Where the suite is pointed, grouped by section.
+ *
+ * One object rather than a prop per key: it is the value a host mirrors into its
+ * URL, and it groups the same way `contentLabels` does. Every key resolves
+ * independently, so `selection={{ section: 'accounts' }}` drives the menu and
+ * leaves the account to `defaultSelection`.
+ *
+ * Credit and debit cards get separate groups because the Cards section mounts
+ * two `CardsWidget` instances against two endpoints, so one card id cannot
+ * address both. There is no `invoicing` group: that section renders the Monite
+ * `<Receivables />`, whose tab is internal state (EMBD-2171 replaces it,
+ * EMBD-4979 makes the native tab controllable).
+ */
+interface WidgetSuiteSelection {
+    section?: WidgetSuiteSectionId;
+    accounts?: WidgetSuiteAccountsSelection;
+    creditCards?: WidgetSuiteCardsSelection;
+    debitCards?: WidgetSuiteCardsSelection;
+    settings?: WidgetSuiteSettingsSelection;
+}
+/**
+ * Where the suite can *open*, which is not everything it can be driven to:
+ * `SettingsWidget` takes no initial section, so naming one here would be a
+ * silent no-op (EMBD-4980 adds the prop that makes it work).
+ *
+ * Derived rather than hand-written, so each key stays in exactly one of the two
+ * types as the widgets behind them gain the props they are missing.
+ */
+type WidgetSuiteDefaultSelection = Omit<WidgetSuiteSelection, 'settings'>;
+interface WidgetSuiteCardsSelectionSnapshot {
+    cardId: string | null;
+    pagination: CardsWidgetPaginationInput | undefined;
+}
+/**
+ * The selection as the suite reports it: every key carries a value, so a host
+ * reading one needs no optional chaining. Assignable to
+ * {@link WidgetSuiteSelection}, so a host can hand a snapshot straight back.
+ */
+interface WidgetSuiteSelectionSnapshot {
+    section: WidgetSuiteSectionId | undefined;
+    accounts: {
+        accountId: string | null;
+    };
+    creditCards: WidgetSuiteCardsSelectionSnapshot;
+    debitCards: WidgetSuiteCardsSelectionSnapshot;
+    settings: {
+        section: SettingsWidgetSectionId | undefined;
+    };
+}
+
 interface WidgetSuiteProps extends WidgetProviderProps {
     /**
      * Which sections the suite offers, in menu order.
@@ -753,6 +857,34 @@ interface WidgetSuiteProps extends WidgetProviderProps {
      * this is the host's ceiling rather than a promise of what renders.
      */
     sections: readonly WidgetSuiteSectionId[];
+    /**
+     * Where the suite is pointed, for a host that owns navigation — a URL, a
+     * router, its own state. Every key resolves on its own, so driving one leaves
+     * the rest to the suite.
+     *
+     * A key here puts the widget behind it in controlled mode for the lifetime of
+     * the mount, so supply it with `onSelectionChange` or the surface will not
+     * move when the user clicks.
+     */
+    selection?: WidgetSuiteSelection;
+    /**
+     * Where the suite opens, for a host that wants a deep link but not ownership.
+     * Read once per mount, and ignored per key when `selection` names that key.
+     *
+     * Carries every key `selection` does bar `settings` — see
+     * {@link WidgetSuiteDefaultSelection}.
+     */
+    defaultSelection?: WidgetSuiteDefaultSelection;
+    /**
+     * The whole selection after a person moved the suite: a menu click, a row, a
+     * card, a settings tab, a page of a card list. Every key carries a value, and
+     * the object can be handed straight back as `selection`.
+     *
+     * Never fired for the entitlement fallback, and never fired on mount, so a
+     * host mirroring this into its URL cannot overwrite the deep link it was just
+     * handed. A move that touches two keys reports once.
+     */
+    onSelectionChange?: (selection: WidgetSuiteSelectionSnapshot) => void;
     /** Overrides for the shell's own copy — the nav landmark name, empty state. */
     labels?: PartialDeep<WidgetSuiteShellLabels>;
     /** Overrides for the section names in the menu. */
@@ -779,8 +911,8 @@ interface WidgetSuiteProps extends WidgetProviderProps {
      * heading reads as a fragment of someone else's. Set `false` when the host
      * already renders a heading of its own above the suite.
      *
-     * Sections whose widget heads itself (Accounts, Settings) never get one, at
-     * any setting — see `rendersOwnTitle` in `sections.tsx`.
+     * Sections whose widget heads itself (Accounts, Cards, Settings) never get
+     * one, at any setting — see `rendersOwnTitle` in `sections.tsx`.
      */
     showSectionTitle?: boolean;
 }
@@ -801,15 +933,17 @@ interface WidgetSuiteProps extends WidgetProviderProps {
  * init fails before answering the disclosure flags, the acceptance surface
  * alone when the session owes the bank's disclosures, or the nav over its
  * sections. States rather than an overlay over a mounted shell — see
- * `WidgetSuiteInner` for why each boundary sits where it does.
+ * `WidgetSuiteSurface` for why each boundary sits where it does.
  *
- * The active section is held here rather than taken as a prop, matching
- * `BillPayWidgetNative` and `SettingsWidget`. A host-controlled
- * `selectedSectionId` / `onSectionChange` pair is the natural next step for
- * deep-linking, and is deliberately not invented on an experimental export
- * before a host asks for it.
+ * Navigation is one `selection` object a host can drive key by key, published to
+ * the sections through `WidgetSuiteProvider`. Only the open panel is mounted, so
+ * a key the suite holds survives leaving a section and coming back and a key it
+ * does not hold is lost: today Accounts remembers its open account and Cards its
+ * open card, while Bill Pay forgets its tab, Settings its section and each card
+ * list its cursor. That split is the widgets' current shape rather than a
+ * decision — see `WidgetSuiteSelection` for the ticket behind each gap.
  */
 declare function WidgetSuite({ baseUrl, widgetToken, organizationId, configClient, gatewayRouting, linkComponent, implementation, uiFramework, errorFallback, onError, analytics, disclosuresAcceptance, ...innerProps }: WidgetSuiteProps): React.JSX.Element;
 
 export { WIDGET_SUITE_CONTENT_LABELS_EN, WIDGET_SUITE_DEFAULT_SECTIONS, WIDGET_SUITE_DISCLOSURE_LABELS_EN, WIDGET_SUITE_SECTION_LABELS_EN, WIDGET_SUITE_SECTION_TITLE_LABELS_EN, WIDGET_SUITE_SHELL_LABELS_EN, WidgetSuite, WidgetSuiteSectionId };
-export type { PartialDeep, WidgetSuiteContentLabels, WidgetSuiteDisclosureLabels, WidgetSuiteProps, WidgetSuiteSectionLabels, WidgetSuiteSectionTitleLabels, WidgetSuiteShellLabels };
+export type { PartialDeep, WidgetSuiteAccountsSelection, WidgetSuiteCardsSelection, WidgetSuiteCardsSelectionSnapshot, WidgetSuiteContentLabels, WidgetSuiteDefaultSelection, WidgetSuiteDisclosureLabels, WidgetSuiteProps, WidgetSuiteSectionLabels, WidgetSuiteSectionTitleLabels, WidgetSuiteSelection, WidgetSuiteSelectionSnapshot, WidgetSuiteSettingsSelection, WidgetSuiteShellLabels };

package/dist/experimental/index.js

@@ -1,6 +1,6 @@
 import { WIDGET_SUITE_CONTENT_LABELS_EN as e, WIDGET_SUITE_DISCLOSURE_LABELS_EN as t, WIDGET_SUITE_SECTION_LABELS_EN as n, WIDGET_SUITE_SECTION_TITLE_LABELS_EN as r } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index4.js";
-import { WIDGET_SUITE_DEFAULT_SECTIONS as i, WidgetSuiteSectionId as a } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index5.js";
+import { WIDGET_SUITE_DEFAULT_SECTIONS as i, WidgetSuiteSectionId as a } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index7.js";
 import { WIDGET_SUITE_SHELL_LABELS_EN as o } from "../libs/tesouro-embedded-components-react/widget-suite/ui/dist/index2.js";
-import { WidgetSuite as s } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index6.js";
+import { WidgetSuite as s } from "../libs/tesouro-embedded-components-react/widget-suite/feature/dist/index8.js";
 import "./WidgetSuite.js";
 export { e as WIDGET_SUITE_CONTENT_LABELS_EN, i as WIDGET_SUITE_DEFAULT_SECTIONS, t as WIDGET_SUITE_DISCLOSURE_LABELS_EN, n as WIDGET_SUITE_SECTION_LABELS_EN, r as WIDGET_SUITE_SECTION_TITLE_LABELS_EN, o as WIDGET_SUITE_SHELL_LABELS_EN, s as WidgetSuite, a as WidgetSuiteSectionId };

package/dist/index.css

@@ -4489,8 +4489,8 @@
     outline-style: var(--tw-outline-style);
     outline-width: 2px;
   }
-  .ttw\:focus-visible\:outline-offset-2:focus-visible {
-    outline-offset: 2px;
+  .ttw\:focus-visible\:-outline-offset-2:focus-visible {
+    outline-offset: calc(2px * -1);
   }
   .ttw\:focus-visible\:outline-ring:focus-visible {
     outline-color: var(--ttw-ring);