@npm-zenwork/tax-remittance-ui 0.5.2 → 0.5.3

package/dist/embedded/ThemeProvider.d.ts

@@ -30,6 +30,22 @@ interface ThemeProviderProps {
     theme?: TaxRemittanceTheme;
     children: ReactNode;
 }
+/**
+ * The element modals, drawers, dropdowns and toasts must portal into.
+ *
+ * Do not portal to `document.body` directly. Every rule this package ships is scoped
+ * under `.tax-remittance-embedded` so it cannot leak into the host application, which
+ * means anything mounted outside that subtree receives none of it — a modal portaled
+ * to `document.body` renders as an unstyled static block at the end of the page, with
+ * no positioning, backdrop or z-index, and is effectively invisible.
+ *
+ * This root is a body-level sibling carrying the widget class and the theme variables,
+ * so portalled content is styled correctly while still escaping the host's overflow
+ * and stacking contexts the way `document.body` did.
+ *
+ * Always returns an element, so callers can hand it straight to `createPortal`.
+ */
+export declare function usePortalRoot(): HTMLElement;
 /**
  * Injects the client's brand colors as CSS custom properties on the
  * `.tax-remittance-embedded` wrapper div.
@@ -42,6 +58,8 @@ interface ThemeProviderProps {
  * `index.css` maps Tailwind's `--color-brand-*` tokens to these vars
  * inside the `.tax-remittance-embedded` scope, so shared components
  * like `<Button>` and `<Input>` automatically respect client themes.
+ *
+ * It also owns the portal root — see `usePortalRoot`.
  */
 export declare function ThemeProvider({ theme, children }: ThemeProviderProps): import("react").JSX.Element;
 export {};