@tesouro/embedded-components-react 0.11.234 → 0.11.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -258,6 +258,57 @@ applicant's ad blocker, and shows a message asking them to allow it.
258
258
  starts Alloy's SDK with the bank's configuration; finding one already on the
259
259
  page, it shows that blocked message instead of reinitializing yours.
260
260
 
261
+ ### Layout and overlays
262
+
263
+ The embedding contract binds new and migrated surfaces: use the container's
264
+ width and content-driven inline height unless the host supplies a height. To
265
+ constrain an inline widget, provide that height and its scroll container in
266
+ your layout. Shared modal dialogs and sheets use the viewport, trap focus and
267
+ lock page scroll while open. The shared primitives restore focus to their
268
+ opening control; a workflow that removes that control supplies its widget-root
269
+ fallback as part of its migration.
270
+
271
+ The following verified legacy gaps remain. This list is not an exhaustive
272
+ audit of every legacy widget against every embedding rule:
273
+
274
+ | Legacy flow | Current behavior | Migration owner |
275
+ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- |
276
+ | Invoicing create/edit form and invoice details (2 surfaces) | Remain non-modal, so their focus, background scrolling and assistive-technology behavior does not yet meet the modal contract. | [FOPS-1800](https://tesouro.atlassian.net/browse/FOPS-1800) |
277
+ | Bill Pay upload status tray (1 surface) | Fixed UI still renders inline and can be captured by a host transform or clipping container. | [FOPS-1798](https://tesouro.atlassian.net/browse/FOPS-1798) |
278
+ | Invoicing customer picker (1 scroll path) | Its scrollIntoView call can move host ancestors. | [FOPS-1800](https://tesouro.atlassian.net/browse/FOPS-1800) |
279
+ | Bill Pay invalid-field navigation (1 scroll path) | Its scrollIntoView call can move host ancestors. | [FOPS-1798](https://tesouro.atlassian.net/browse/FOPS-1798) |
280
+ | Approval-policy draft-card navigation (1 scroll path) | Its scrollIntoView call in shared/approval-policy/feature/src/lib/useApprovalPolicyRules.ts can move host ancestors. | [FOPS-1812](https://tesouro.atlassian.net/browse/FOPS-1812) |
281
+
282
+ Shared dialog, sheet, menu and tooltip primitives portal into an isolation root
283
+ attached to `document.body`, so a host container's `overflow` or transform does
284
+ not clip those overlays. `WidgetFrame` isolates inline stacking. The overlay
285
+ root defaults to z-index `2147483000`. If your page has its own overlays, set
286
+ `--tesouro-embedded-overlay-z-index` on `:root` to place the entire widget
287
+ overlay stack in your page's order:
288
+
289
+ ```css
290
+ :root {
291
+ --tesouro-embedded-overlay-z-index: 10000;
292
+ }
293
+ ```
294
+
295
+ Within that root, the order is popovers, dialogs/sheets, confirmations, then
296
+ toasts. A modal's own menus and selects remain above it. Toasts use a separate
297
+ body root one layer above the dialog roots, including dialogs in sibling
298
+ widgets. Do not override individual overlay z-index values.
299
+
300
+ Place multiple widgets under one `RootWidgetProvider` (or
301
+ `RefreshingRootWidgetProvider`) to share configuration. Each widget still owns
302
+ its own body-level overlay root at the same z-index, so the popover, dialog and
303
+ confirmation order above holds within one widget; between sibling widgets, the
304
+ most recently attached root paints on top. Open one overlay at a time across
305
+ widgets. Widgets coordinate their built-in toast renderers so there is only one active
306
+ toaster per page. Do not add a separate Sonner toaster for widget notifications.
307
+
308
+ Shadow DOM is not supported. Widgets and their styles belong in the document's
309
+ light DOM, and portals always target a body-level root. There is no public API
310
+ to supply a different portal container.
311
+
261
312
  ### Theming
262
313
 
263
314
  Widgets read their look from `--ttw-*` CSS variables. Set them on `:root`, or
package/dist/index.css CHANGED
@@ -365,6 +365,9 @@
365
365
  .ttw\:bottom-4 {
366
366
  bottom: calc(var(--ttw-spacing) * 4);
367
367
  }
368
+ .ttw\:bottom-6 {
369
+ bottom: calc(var(--ttw-spacing) * 6);
370
+ }
368
371
  .ttw\:left-0 {
369
372
  left: 0px;
370
373
  }
@@ -410,6 +413,18 @@
410
413
  .ttw\:z-\[1\] {
411
414
  z-index: 1;
412
415
  }
416
+ .ttw\:z-\[100\] {
417
+ z-index: 100;
418
+ }
419
+ .ttw\:z-\[101\] {
420
+ z-index: 101;
421
+ }
422
+ .ttw\:z-\[200\] {
423
+ z-index: 200;
424
+ }
425
+ .ttw\:z-\[201\] {
426
+ z-index: 201;
427
+ }
413
428
  .ttw\:z-\[1300\] {
414
429
  z-index: 1300;
415
430
  }
@@ -446,6 +461,9 @@
446
461
  .ttw\:mx-3\.5 {
447
462
  margin-inline: calc(var(--ttw-spacing) * 3.5);
448
463
  }
464
+ .ttw\:mx-8 {
465
+ margin-inline: calc(var(--ttw-spacing) * 8);
466
+ }
449
467
  .ttw\:mx-auto {
450
468
  margin-inline: auto;
451
469
  }
@@ -1,5 +1,5 @@
1
1
  // ../../libs/tesouro-embedded-components-react/shared/feature/dist/lib/analytics/build-info.js
2
- var e = "@tesouro/embedded-components-react", t = "0.11.234", n = "859cb707fb5dae48a8218aa22c9c6471d40046a1", r = Object.freeze({
2
+ var e = "@tesouro/embedded-components-react", t = "0.11.235", n = "c2a0ee45a88d2e75938fa65745eb85d44873bc7e", r = Object.freeze({
3
3
  library_name: e,
4
4
  library_version: t,
5
5
  library_sha: n
@@ -5,7 +5,7 @@ function i({ title: i, action: a, bodyClassName: o, className: s, children: c, .
5
5
  let u = i !== void 0 || a != null;
6
6
  return /* @__PURE__ */ r("div", {
7
7
  "data-slot": "widget-frame",
8
- className: t("ttw:@container/widget ttw:flex ttw:w-full ttw:flex-col ttw:overflow-hidden ttw:rounded-lg ttw:border ttw:border-border ttw:bg-card ttw:text-card-foreground", s),
8
+ className: t("ttw:@container/widget ttw:isolate ttw:flex ttw:w-full ttw:flex-col ttw:overflow-hidden ttw:rounded-lg ttw:border ttw:border-border ttw:bg-card ttw:text-card-foreground", s),
9
9
  ...l,
10
10
  children: [u ? /* @__PURE__ */ r("div", {
11
11
  className: "ttw:flex ttw:flex-wrap ttw:items-center ttw:justify-between ttw:gap-3 ttw:px-4 ttw:py-3",