@gusto/embedded-react-sdk 0.46.3 → 0.47.1

package/dist/contexts/GustoProvider/SDKI18next.js.map

@@ -1 +1 @@
-{"version":3,"file":"SDKI18next.js","sources":["../../../src/contexts/GustoProvider/SDKI18next.ts"],"sourcesContent":["import type { i18n } from 'i18next'\nimport i18next from 'i18next'\nimport { initReactI18next } from 'react-i18next'\nimport { defaultNS } from '@/i18n'\nimport commonEn from '@/i18n/en/common.json'\n\n/**Creating new i18next instance to avoid global clashing */\nconst SDKI18next: i18n = i18next.createInstance({\n  debug: false,\n  fallbackLng: 'en',\n  resources: {\n    en: { common: commonEn },\n  },\n  defaultNS,\n})\n\n// eslint-disable-next-line\nSDKI18next.use(initReactI18next).init().catch(console.error)\n\nexport { SDKI18next }\n"],"names":["SDKI18next","i18next","commonEn","defaultNS","initReactI18next"],"mappings":";;;;AAOA,MAAMA,IAAmBC,EAAQ,eAAe;AAAA,EAC9C,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AAAA,IACT,IAAI,EAAE,QAAQC,EAAA;AAAA,EAAS;AAAA,EAEzB,WAAAC;AACF,CAAC;AAGDH,EAAW,IAAII,CAAgB,EAAE,OAAO,MAAM,QAAQ,KAAK;"}
+{"version":3,"file":"SDKI18next.js","sources":["../../../src/contexts/GustoProvider/SDKI18next.ts"],"sourcesContent":["import type { i18n } from 'i18next'\nimport i18next from 'i18next'\nimport { initReactI18next } from 'react-i18next'\nimport { defaultNS } from '@/i18n'\nimport commonEn from '@/i18n/en/common.json'\n\n/** @internal */\nconst SDKI18next: i18n = i18next.createInstance({\n  debug: false,\n  fallbackLng: 'en',\n  resources: {\n    en: { common: commonEn },\n  },\n  defaultNS,\n})\n\n// eslint-disable-next-line\nSDKI18next.use(initReactI18next).init().catch(console.error)\n\nexport { SDKI18next }\n"],"names":["SDKI18next","i18next","commonEn","defaultNS","initReactI18next"],"mappings":";;;;AAOA,MAAMA,IAAmBC,EAAQ,eAAe;AAAA,EAC9C,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AAAA,IACT,IAAI,EAAE,QAAQC,EAAA;AAAA,EAAS;AAAA,EAEzB,WAAAC;AACF,CAAC;AAGDH,EAAW,IAAII,CAAgB,EAAE,OAAO,MAAM,QAAQ,KAAK;"}

package/dist/contexts/GustoProvider/index.d.ts

@@ -1,6 +1,4 @@
 import "./types/i18next.d.ts"
 export { GustoProvider, GustoApiProvider } from './GustoProvider';
 export type { GustoApiProps } from './GustoProvider';
-export { SDKI18next } from './SDKI18next';
 export { GustoProviderCustomUIAdapter } from './GustoProviderCustomUIAdapter';
-export type { GustoProviderProps, GustoProviderCustomUIAdapterProps, APIConfig, } from './GustoProviderCustomUIAdapter';

package/dist/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.d.ts

@@ -1,7 +1,19 @@
 import { ReactNode } from 'react';
 import { LoadingIndicatorContextProps } from './useLoadingIndicator';
+/** @internal */
 export interface LoadingIndicatorProviderProps {
     children: ReactNode;
     value?: LoadingIndicatorContextProps['LoadingIndicator'];
 }
-export declare function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Provides the loading-indicator component to SDK base components via {@link LoadingIndicatorContext}.
+ *
+ * @remarks
+ * When `value` is omitted, the SDK's default `Loading` component is used. Composed by `GustoProvider`
+ * so a partner-supplied `LoaderComponent` flows through to every internal Suspense fallback.
+ *
+ * @param props - See {@link LoadingIndicatorProviderProps}.
+ * @returns A React subtree with the loading-indicator context applied.
+ * @internal
+ */
+export declare function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps): import("react").JSX.Element;

package/dist/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"LoadingIndicatorProvider.js","sources":["../../../src/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { LoadingIndicatorContext, type LoadingIndicatorContextProps } from './useLoadingIndicator'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\nexport interface LoadingIndicatorProviderProps {\n  children: ReactNode\n  value?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\nexport function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps) {\n  return (\n    <LoadingIndicatorContext.Provider value={{ LoadingIndicator: value ?? Loading }}>\n      {children}\n    </LoadingIndicatorContext.Provider>\n  )\n}\n"],"names":["LoadingIndicatorProvider","children","value","jsx","LoadingIndicatorContext","Loading"],"mappings":";;;AASO,SAASA,EAAyB,EAAE,UAAAC,GAAU,OAAAC,KAAwC;AAC3F,SACE,gBAAAC,EAACC,EAAwB,UAAxB,EAAiC,OAAO,EAAE,kBAAkBF,KAASG,KACnE,UAAAJ,GACH;AAEJ;"}
+{"version":3,"file":"LoadingIndicatorProvider.js","sources":["../../../src/contexts/LoadingIndicatorProvider/LoadingIndicatorProvider.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { LoadingIndicatorContext, type LoadingIndicatorContextProps } from './useLoadingIndicator'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\n/** @internal */\nexport interface LoadingIndicatorProviderProps {\n  children: ReactNode\n  value?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\n/**\n * Provides the loading-indicator component to SDK base components via {@link LoadingIndicatorContext}.\n *\n * @remarks\n * When `value` is omitted, the SDK's default `Loading` component is used. Composed by `GustoProvider`\n * so a partner-supplied `LoaderComponent` flows through to every internal Suspense fallback.\n *\n * @param props - See {@link LoadingIndicatorProviderProps}.\n * @returns A React subtree with the loading-indicator context applied.\n * @internal\n */\nexport function LoadingIndicatorProvider({ children, value }: LoadingIndicatorProviderProps) {\n  return (\n    <LoadingIndicatorContext.Provider value={{ LoadingIndicator: value ?? Loading }}>\n      {children}\n    </LoadingIndicatorContext.Provider>\n  )\n}\n"],"names":["LoadingIndicatorProvider","children","value","jsx","LoadingIndicatorContext","Loading"],"mappings":";;;AAqBO,SAASA,EAAyB,EAAE,UAAAC,GAAU,OAAAC,KAAwC;AAC3F,SACE,gBAAAC,EAACC,EAAwB,UAAxB,EAAiC,OAAO,EAAE,kBAAkBF,KAASG,KACnE,UAAAJ,GACH;AAEJ;"}

package/dist/contexts/LoadingIndicatorProvider/useLoadingIndicator.d.ts

@@ -1,16 +1,32 @@
 import { JSX } from 'react';
+/**
+ * Shape of the value stored in {@link LoadingIndicatorContext}.
+ *
+ * @internal
+ */
 export interface LoadingIndicatorContextProps {
     LoadingIndicator: ({ children }: {
         children?: React.ReactNode;
     }) => JSX.Element;
 }
+/**
+ * React context holding the loading-indicator component used by SDK base components.
+ *
+ * @internal
+ */
 export declare const LoadingIndicatorContext: import('react').Context<{
     LoadingIndicator: ({ children }: {
         children?: React.ReactNode;
-    }) => import("react/jsx-runtime").JSX.Element;
+    }) => JSX.Element;
 }>;
+/**
+ * Reads the loading-indicator component from {@link LoadingIndicatorContext}.
+ *
+ * @returns The current {@link LoadingIndicatorContextProps} value, falling back to the SDK default `Loading` component.
+ * @internal
+ */
 export declare const useLoadingIndicator: () => {
     LoadingIndicator: ({ children }: {
         children?: React.ReactNode;
-    }) => import("react/jsx-runtime").JSX.Element;
+    }) => JSX.Element;
 };

package/dist/contexts/LoadingIndicatorProvider/useLoadingIndicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLoadingIndicator.js","sources":["../../../src/contexts/LoadingIndicatorProvider/useLoadingIndicator.tsx"],"sourcesContent":["import type { JSX } from 'react'\nimport { createContext, useContext } from 'react'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\nexport interface LoadingIndicatorContextProps {\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => JSX.Element\n}\nexport const LoadingIndicatorContext = createContext({\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => <Loading>{children}</Loading>,\n})\n\nexport const useLoadingIndicator = () => useContext(LoadingIndicatorContext)\n"],"names":["LoadingIndicatorContext","createContext","children","jsx","Loading","useLoadingIndicator","useContext"],"mappings":";;;AAOO,MAAMA,IAA0BC,EAAc;AAAA,EACnD,kBAAkB,CAAC,EAAE,UAAAC,QAA+C,gBAAAC,EAACC,KAAS,UAAAF,EAAA,CAAS;AACzF,CAAC,GAEYG,IAAsB,MAAMC,EAAWN,CAAuB;"}
+{"version":3,"file":"useLoadingIndicator.js","sources":["../../../src/contexts/LoadingIndicatorProvider/useLoadingIndicator.tsx"],"sourcesContent":["import type { JSX } from 'react'\nimport { createContext, useContext } from 'react'\nimport { Loading } from '@/components/Common/Loading/Loading'\n\n/**\n * Shape of the value stored in {@link LoadingIndicatorContext}.\n *\n * @internal\n */\nexport interface LoadingIndicatorContextProps {\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => JSX.Element\n}\n/**\n * React context holding the loading-indicator component used by SDK base components.\n *\n * @internal\n */\nexport const LoadingIndicatorContext = createContext({\n  LoadingIndicator: ({ children }: { children?: React.ReactNode }) => <Loading>{children}</Loading>,\n})\n\n/**\n * Reads the loading-indicator component from {@link LoadingIndicatorContext}.\n *\n * @returns The current {@link LoadingIndicatorContextProps} value, falling back to the SDK default `Loading` component.\n * @internal\n */\nexport const useLoadingIndicator = () => useContext(LoadingIndicatorContext)\n"],"names":["LoadingIndicatorContext","createContext","children","jsx","Loading","useLoadingIndicator","useContext"],"mappings":";;;AAiBO,MAAMA,IAA0BC,EAAc;AAAA,EACnD,kBAAkB,CAAC,EAAE,UAAAC,QAA+C,gBAAAC,EAACC,KAAS,UAAAF,EAAA,CAAS;AACzF,CAAC,GAQYG,IAAsB,MAAMC,EAAWN,CAAuB;"}

package/dist/contexts/LocaleProvider/LocaleProvider.d.ts

@@ -1,5 +1,21 @@
 import { LocaleProps } from './useLocale';
+/**
+ * Props for {@link LocaleProvider}: the {@link LocaleProps} settings plus any children to render within the locale scope.
+ *
+ * @internal
+ */
 export interface LocaleProviderProps extends LocaleProps {
     children?: React.ReactNode;
 }
-export declare function LocaleProvider({ locale, currency, children, }: LocaleProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Supplies locale and currency to descendant SDK components and sets the `lang` attribute on a wrapping `div`.
+ *
+ * @remarks
+ * Normally used internally by `GustoProvider`; render it directly only when composing the SDK
+ * outside of `GustoProvider`. Children access the active values through {@link useLocale}.
+ *
+ * @param props - The {@link LocaleProviderProps} controlling locale, currency, and children.
+ * @returns A `div` with `lang` set to the locale, wrapping `children` in the locale context.
+ * @internal
+ */
+export declare function LocaleProvider({ locale, currency, children, }: LocaleProviderProps): import("react").JSX.Element;

package/dist/contexts/LocaleProvider/LocaleProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocaleProvider.js","sources":["../../../src/contexts/LocaleProvider/LocaleProvider.tsx"],"sourcesContent":["import type { LocaleProps } from './useLocale'\nimport { LocaleContext } from './useLocale'\n\nexport interface LocaleProviderProps extends LocaleProps {\n  children?: React.ReactNode\n}\n\nexport function LocaleProvider({\n  locale = 'en-US',\n  currency = 'USD',\n  children,\n}: LocaleProviderProps) {\n  return (\n    <LocaleContext.Provider value={{ locale: locale, currency: currency }}>\n      <div lang={locale}>{children}</div>\n    </LocaleContext.Provider>\n  )\n}\n"],"names":["LocaleProvider","locale","currency","children","jsx","LocaleContext"],"mappings":";;AAOO,SAASA,EAAe;AAAA,EAC7B,QAAAC,IAAS;AAAA,EACT,UAAAC,IAAW;AAAA,EACX,UAAAC;AACF,GAAwB;AACtB,SACE,gBAAAC,EAACC,EAAc,UAAd,EAAuB,OAAO,EAAE,QAAAJ,GAAgB,UAAAC,EAAA,GAC/C,UAAA,gBAAAE,EAAC,OAAA,EAAI,MAAMH,GAAS,UAAAE,GAAS,GAC/B;AAEJ;"}
+{"version":3,"file":"LocaleProvider.js","sources":["../../../src/contexts/LocaleProvider/LocaleProvider.tsx"],"sourcesContent":["import type { LocaleProps } from './useLocale'\nimport { LocaleContext } from './useLocale'\n\n/**\n * Props for {@link LocaleProvider}: the {@link LocaleProps} settings plus any children to render within the locale scope.\n *\n * @internal\n */\nexport interface LocaleProviderProps extends LocaleProps {\n  children?: React.ReactNode\n}\n\n/**\n * Supplies locale and currency to descendant SDK components and sets the `lang` attribute on a wrapping `div`.\n *\n * @remarks\n * Normally used internally by `GustoProvider`; render it directly only when composing the SDK\n * outside of `GustoProvider`. Children access the active values through {@link useLocale}.\n *\n * @param props - The {@link LocaleProviderProps} controlling locale, currency, and children.\n * @returns A `div` with `lang` set to the locale, wrapping `children` in the locale context.\n * @internal\n */\nexport function LocaleProvider({\n  locale = 'en-US',\n  currency = 'USD',\n  children,\n}: LocaleProviderProps) {\n  return (\n    <LocaleContext.Provider value={{ locale: locale, currency: currency }}>\n      <div lang={locale}>{children}</div>\n    </LocaleContext.Provider>\n  )\n}\n"],"names":["LocaleProvider","locale","currency","children","jsx","LocaleContext"],"mappings":";;AAuBO,SAASA,EAAe;AAAA,EAC7B,QAAAC,IAAS;AAAA,EACT,UAAAC,IAAW;AAAA,EACX,UAAAC;AACF,GAAwB;AACtB,SACE,gBAAAC,EAACC,EAAc,UAAd,EAAuB,OAAO,EAAE,QAAAJ,GAAgB,UAAAC,EAAA,GAC/C,UAAA,gBAAAE,EAAC,OAAA,EAAI,MAAMH,GAAS,UAAAE,GAAS,GAC/B;AAEJ;"}

package/dist/contexts/LocaleProvider/index.d.ts

@@ -1,3 +1,3 @@
 import "./types/i18next.d.ts"
 export { LocaleProvider } from './LocaleProvider';
-export { useLocale, type LocaleProps } from './useLocale';
+export { useLocale } from './useLocale';

package/dist/contexts/LocaleProvider/useLocale.d.ts

@@ -1,10 +1,49 @@
+/**
+ * Locale and currency settings supplied to {@link LocaleProvider}.
+ *
+ * @remarks
+ * `locale` is a BCP 47 language tag (defaults to `en-US`) used for `Intl` formatting and the
+ * rendered wrapper's `lang` attribute. `currency` is an ISO 4217 currency code (defaults to
+ * `USD`) consumed by currency-aware inputs.
+ *
+ * @internal
+ */
 export interface LocaleProps {
     locale?: string;
     currency?: string;
 }
+/**
+ * React context backing {@link useLocale} and {@link useLocaleDateFormatter}.
+ *
+ * @internal
+ */
 export declare const LocaleContext: import('react').Context<LocaleProps | null>;
+/**
+ * Returns the active locale and currency from the surrounding {@link LocaleProvider}.
+ *
+ * @returns An object with `locale` (defaulting to `en-US`) and `currency` (defaulting to `USD`).
+ * @throws An `Error` when called outside a {@link LocaleProvider}.
+ * @internal
+ *
+ * @example
+ * ```tsx
+ * import { useLocale } from '@gusto/embedded-react-sdk'
+ *
+ * function Amount({ value }: { value: number }) {
+ *   const { locale, currency } = useLocale()
+ *   return <span>{new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value)}</span>
+ * }
+ * ```
+ */
 export declare const useLocale: () => {
     locale: string;
     currency: string;
 };
+/**
+ * Returns an `Intl.DateTimeFormat` configured with the active locale and a long-month, numeric-year, two-digit-day style.
+ *
+ * @returns An `Intl.DateTimeFormat` instance bound to the provider's locale (or `en-US` if unset).
+ * @throws An `Error` when called outside a {@link LocaleProvider}.
+ * @internal
+ */
 export declare const useLocaleDateFormatter: () => Intl.DateTimeFormat;

package/dist/contexts/LocaleProvider/useLocale.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.js","sources":["../../../src/contexts/LocaleProvider/useLocale.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\n\nexport interface LocaleProps {\n  locale?: string\n  currency?: string\n}\n\nexport const LocaleContext = createContext<LocaleProps | null>(null)\n\nexport const useLocale = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocal used outside provider')\n  }\n  return {\n    locale: values.locale ?? 'en-US',\n    currency: values.currency ?? 'USD',\n  }\n}\nexport const useLocaleDateFormatter = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocaleDateFormatter used outside provider')\n  }\n  return new Intl.DateTimeFormat(values.locale ?? 'en-US', {\n    year: 'numeric',\n    month: 'long',\n    day: '2-digit',\n  })\n}\n"],"names":["LocaleContext","createContext","useLocale","values","useContext","useLocaleDateFormatter"],"mappings":";AAOO,MAAMA,IAAgBC,EAAkC,IAAI,GAEtDC,IAAY,MAAM;AAC7B,QAAMC,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,gCAAgC;AAElD,SAAO;AAAA,IACL,QAAQA,EAAO,UAAU;AAAA,IACzB,UAAUA,EAAO,YAAY;AAAA,EAAA;AAEjC,GACaE,IAAyB,MAAM;AAC1C,QAAMF,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,8CAA8C;AAEhE,SAAO,IAAI,KAAK,eAAeA,EAAO,UAAU,SAAS;AAAA,IACvD,MAAM;AAAA,IACN,OAAO;AAAA,IACP,KAAK;AAAA,EAAA,CACN;AACH;"}
+{"version":3,"file":"useLocale.js","sources":["../../../src/contexts/LocaleProvider/useLocale.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\n\n/**\n * Locale and currency settings supplied to {@link LocaleProvider}.\n *\n * @remarks\n * `locale` is a BCP 47 language tag (defaults to `en-US`) used for `Intl` formatting and the\n * rendered wrapper's `lang` attribute. `currency` is an ISO 4217 currency code (defaults to\n * `USD`) consumed by currency-aware inputs.\n *\n * @internal\n */\nexport interface LocaleProps {\n  locale?: string\n  currency?: string\n}\n\n/**\n * React context backing {@link useLocale} and {@link useLocaleDateFormatter}.\n *\n * @internal\n */\nexport const LocaleContext = createContext<LocaleProps | null>(null)\n\n/**\n * Returns the active locale and currency from the surrounding {@link LocaleProvider}.\n *\n * @returns An object with `locale` (defaulting to `en-US`) and `currency` (defaulting to `USD`).\n * @throws An `Error` when called outside a {@link LocaleProvider}.\n * @internal\n *\n * @example\n * ```tsx\n * import { useLocale } from '@gusto/embedded-react-sdk'\n *\n * function Amount({ value }: { value: number }) {\n *   const { locale, currency } = useLocale()\n *   return <span>{new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value)}</span>\n * }\n * ```\n */\nexport const useLocale = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocal used outside provider')\n  }\n  return {\n    locale: values.locale ?? 'en-US',\n    currency: values.currency ?? 'USD',\n  }\n}\n/**\n * Returns an `Intl.DateTimeFormat` configured with the active locale and a long-month, numeric-year, two-digit-day style.\n *\n * @returns An `Intl.DateTimeFormat` instance bound to the provider's locale (or `en-US` if unset).\n * @throws An `Error` when called outside a {@link LocaleProvider}.\n * @internal\n */\nexport const useLocaleDateFormatter = () => {\n  const values = useContext(LocaleContext)\n  if (!values) {\n    throw new Error('useLocaleDateFormatter used outside provider')\n  }\n  return new Intl.DateTimeFormat(values.locale ?? 'en-US', {\n    year: 'numeric',\n    month: 'long',\n    day: '2-digit',\n  })\n}\n"],"names":["LocaleContext","createContext","useLocale","values","useContext","useLocaleDateFormatter"],"mappings":";AAsBO,MAAMA,IAAgBC,EAAkC,IAAI,GAmBtDC,IAAY,MAAM;AAC7B,QAAMC,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,gCAAgC;AAElD,SAAO;AAAA,IACL,QAAQA,EAAO,UAAU;AAAA,IACzB,UAAUA,EAAO,YAAY;AAAA,EAAA;AAEjC,GAQaE,IAAyB,MAAM;AAC1C,QAAMF,IAASC,EAAWJ,CAAa;AACvC,MAAI,CAACG;AACH,UAAM,IAAI,MAAM,8CAA8C;AAEhE,SAAO,IAAI,KAAK,eAAeA,EAAO,UAAU,SAAS;AAAA,IACvD,MAAM;AAAA,IACN,OAAO;AAAA,IACP,KAAK;AAAA,EAAA,CACN;AACH;"}

package/dist/contexts/ObservabilityProvider/ObservabilityContext.d.ts

@@ -1,5 +1,16 @@
 import { ObservabilityHook } from '../../types/observability';
+/**
+ * Value provided by the SDK's observability context, exposing the configured observability hook to descendants.
+ *
+ * @internal
+ */
 export interface ObservabilityContextValue {
+    /** The partner-supplied observability hook, or `undefined` if none was configured. */
     observability: ObservabilityHook | undefined;
 }
+/**
+ * React context that carries the partner-supplied observability hook through the SDK provider tree.
+ *
+ * @internal
+ */
 export declare const ObservabilityContext: import('react').Context<ObservabilityContextValue | undefined>;

package/dist/contexts/ObservabilityProvider/ObservabilityContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservabilityContext.js","sources":["../../../src/contexts/ObservabilityProvider/ObservabilityContext.ts"],"sourcesContent":["import { createContext } from 'react'\nimport type { ObservabilityHook } from '@/types/observability'\n\nexport interface ObservabilityContextValue {\n  observability: ObservabilityHook | undefined\n}\n\nexport const ObservabilityContext = createContext<ObservabilityContextValue | undefined>(undefined)\n"],"names":["ObservabilityContext","createContext"],"mappings":";AAOO,MAAMA,IAAuBC,EAAqD,MAAS;"}
+{"version":3,"file":"ObservabilityContext.js","sources":["../../../src/contexts/ObservabilityProvider/ObservabilityContext.ts"],"sourcesContent":["import { createContext } from 'react'\nimport type { ObservabilityHook } from '@/types/observability'\n\n/**\n * Value provided by the SDK's observability context, exposing the configured observability hook to descendants.\n *\n * @internal\n */\nexport interface ObservabilityContextValue {\n  /** The partner-supplied observability hook, or `undefined` if none was configured. */\n  observability: ObservabilityHook | undefined\n}\n\n/**\n * React context that carries the partner-supplied observability hook through the SDK provider tree.\n *\n * @internal\n */\nexport const ObservabilityContext = createContext<ObservabilityContextValue | undefined>(undefined)\n"],"names":["ObservabilityContext","createContext"],"mappings":";AAkBO,MAAMA,IAAuBC,EAAqD,MAAS;"}

package/dist/contexts/ObservabilityProvider/ObservabilityProvider.d.ts

@@ -1,7 +1,24 @@
 import { ReactNode } from 'react';
 import { ObservabilityHook } from '../../types/observability';
+/**
+ * Props for {@link ObservabilityProvider}.
+ *
+ * @internal
+ */
 export interface ObservabilityProviderProps {
     children: ReactNode;
     observability?: ObservabilityHook;
 }
-export declare const ObservabilityProvider: ({ children, observability }: ObservabilityProviderProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Makes a partner-supplied observability hook available to SDK components for error and metric reporting.
+ *
+ * @remarks
+ * Typically mounted by `GustoProvider` when the `observability` config option is set. Errors and metrics
+ * emitted by SDK components are routed through {@link useObservability}, which applies PII sanitization
+ * before invoking the partner's `onError` and `onMetric` callbacks.
+ *
+ * @param props - {@link ObservabilityProviderProps} containing the children and optional observability hook.
+ * @returns The provider element wrapping `children` with the observability context.
+ * @internal
+ */
+export declare const ObservabilityProvider: ({ children, observability }: ObservabilityProviderProps) => import("react").JSX.Element;

package/dist/contexts/ObservabilityProvider/ObservabilityProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservabilityProvider.js","sources":["../../../src/contexts/ObservabilityProvider/ObservabilityProvider.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { useMemo } from 'react'\nimport { ObservabilityContext } from './ObservabilityContext'\nimport type { ObservabilityHook } from '@/types/observability'\n\nexport interface ObservabilityProviderProps {\n  children: ReactNode\n  observability?: ObservabilityHook\n}\n\nexport const ObservabilityProvider = ({ children, observability }: ObservabilityProviderProps) => {\n  const value = useMemo(() => ({ observability }), [observability])\n\n  return <ObservabilityContext.Provider value={value}>{children}</ObservabilityContext.Provider>\n}\n"],"names":["ObservabilityProvider","children","observability","value","useMemo","jsx","ObservabilityContext"],"mappings":";;;AAUO,MAAMA,IAAwB,CAAC,EAAE,UAAAC,GAAU,eAAAC,QAAgD;AAChG,QAAMC,IAAQC,EAAQ,OAAO,EAAE,eAAAF,MAAkB,CAACA,CAAa,CAAC;AAEhE,SAAO,gBAAAG,EAACC,EAAqB,UAArB,EAA8B,OAAAH,GAAe,UAAAF,EAAA,CAAS;AAChE;"}
+{"version":3,"file":"ObservabilityProvider.js","sources":["../../../src/contexts/ObservabilityProvider/ObservabilityProvider.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { useMemo } from 'react'\nimport { ObservabilityContext } from './ObservabilityContext'\nimport type { ObservabilityHook } from '@/types/observability'\n\n/**\n * Props for {@link ObservabilityProvider}.\n *\n * @internal\n */\nexport interface ObservabilityProviderProps {\n  children: ReactNode\n  observability?: ObservabilityHook\n}\n\n/**\n * Makes a partner-supplied observability hook available to SDK components for error and metric reporting.\n *\n * @remarks\n * Typically mounted by `GustoProvider` when the `observability` config option is set. Errors and metrics\n * emitted by SDK components are routed through {@link useObservability}, which applies PII sanitization\n * before invoking the partner's `onError` and `onMetric` callbacks.\n *\n * @param props - {@link ObservabilityProviderProps} containing the children and optional observability hook.\n * @returns The provider element wrapping `children` with the observability context.\n * @internal\n */\nexport const ObservabilityProvider = ({ children, observability }: ObservabilityProviderProps) => {\n  const value = useMemo(() => ({ observability }), [observability])\n\n  return <ObservabilityContext.Provider value={value}>{children}</ObservabilityContext.Provider>\n}\n"],"names":["ObservabilityProvider","children","observability","value","useMemo","jsx","ObservabilityContext"],"mappings":";;;AA2BO,MAAMA,IAAwB,CAAC,EAAE,UAAAC,GAAU,eAAAC,QAAgD;AAChG,QAAMC,IAAQC,EAAQ,OAAO,EAAE,eAAAF,MAAkB,CAACA,CAAa,CAAC;AAEhE,SAAO,gBAAAG,EAACC,EAAqB,UAArB,EAA8B,OAAAH,GAAe,UAAAF,EAAA,CAAS;AAChE;"}

package/dist/contexts/ObservabilityProvider/index.d.ts

@@ -1,5 +1,5 @@
 import "./types/i18next.d.ts"
 export { ObservabilityProvider } from './ObservabilityProvider';
 export { useObservability } from './useObservability';
-export { normalizeToSDKError } from '../../types/sdkError';
 export type { ObservabilityProviderProps } from './ObservabilityProvider';
+export type { ObservabilityContextValue } from './ObservabilityContext';

package/dist/contexts/ObservabilityProvider/sanitization.d.ts

@@ -1,5 +1,54 @@
 import { ObservabilityError, ObservabilityMetric, SanitizationConfig } from '../../types/observability';
+/**
+ * Replaces PII patterns (SSN, email, phone, credit card, long tokens) in a string with redacted placeholders.
+ *
+ * @param value - The string to scan and redact.
+ * @returns The input with each matched pattern replaced by a `[TYPE-REDACTED]` placeholder.
+ * @internal
+ */
 export declare function sanitizeString(value: string): string;
+/**
+ * Recursively walks a value, redacting sensitive object keys and PII patterns in nested strings.
+ *
+ * @remarks
+ * Keys whose names match (case-insensitively contain) any built-in sensitive field name or any
+ * entry in `additionalSensitiveFields` have their values replaced with `[REDACTED]`. String
+ * values are passed through {@link sanitizeString} so PII patterns inside them are also redacted.
+ * Numbers, booleans, `null`, and `undefined` pass through unchanged.
+ *
+ * @param obj - The value to sanitize. May be any JSON-shaped structure.
+ * @param additionalSensitiveFields - Extra field names to treat as sensitive (case-insensitive substring match).
+ * @returns A new value of the same shape with sensitive fields and PII patterns redacted.
+ * @internal
+ */
 export declare function sanitizeObject(obj: unknown, additionalSensitiveFields?: string[]): unknown;
+/**
+ * Returns a copy of an observability error with PII redacted from messages and field-error metadata.
+ *
+ * @remarks
+ * If `config.customErrorSanitizer` is provided, it is invoked and its result returned directly.
+ * When sanitization is disabled, the error passes through unchanged except that `raw` is stripped
+ * unless `includeRawError` is true. When enabled, `message` and each `fieldErrors[].message` run
+ * through {@link sanitizeString}, and each `fieldErrors[].metadata` runs through {@link sanitizeObject}
+ * with `additionalSensitiveFields` applied.
+ *
+ * @param error - The error reported by SDK error boundaries or form submissions.
+ * @param config - Optional sanitization configuration; defaults to enabled with `raw` stripped.
+ * @returns The sanitized error suitable for forwarding to a partner observability hook.
+ * @internal
+ */
 export declare function sanitizeError(error: ObservabilityError, config?: SanitizationConfig): ObservabilityError;
+/**
+ * Returns a copy of an observability metric with sensitive values redacted from its tags.
+ *
+ * @remarks
+ * If `config.customMetricSanitizer` is provided, it is invoked and its result returned directly.
+ * When sanitization is disabled, the metric passes through unchanged. Otherwise the `tags` record
+ * is run through {@link sanitizeObject} with `additionalSensitiveFields` applied.
+ *
+ * @param metric - The metric reported by SDK component instrumentation.
+ * @param config - Optional sanitization configuration; defaults to enabled.
+ * @returns The sanitized metric suitable for forwarding to a partner observability hook.
+ * @internal
+ */
 export declare function sanitizeMetric(metric: ObservabilityMetric, config?: SanitizationConfig): ObservabilityMetric;

package/dist/contexts/ObservabilityProvider/sanitization.js.map

@@ -1 +1 @@
-{"version":3,"file":"sanitization.js","sources":["../../../src/contexts/ObservabilityProvider/sanitization.ts"],"sourcesContent":["import type {\n  ObservabilityError,\n  ObservabilityMetric,\n  SanitizationConfig,\n} from '@/types/observability'\n\nconst PII_PATTERNS = [\n  { pattern: /\\b\\d{3}-\\d{2}-\\d{4}\\b/g, replacement: '[SSN-REDACTED]' },\n  { pattern: /\\b\\d{9}\\b/g, replacement: '[SSN-REDACTED]' },\n  {\n    pattern: /\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b/g,\n    replacement: '[EMAIL-REDACTED]',\n  },\n  { pattern: /\\b\\d{3}[-.\\s]?\\d{3}[-.\\s]?\\d{4}\\b/g, replacement: '[PHONE-REDACTED]' },\n  { pattern: /\\(\\d{3}\\)\\s*\\d{3}[-.\\s]?\\d{4}/g, replacement: '[PHONE-REDACTED]' },\n  { pattern: /\\b\\d{4}[-\\s]?\\d{4}[-\\s]?\\d{4}[-\\s]?\\d{4}\\b/g, replacement: '[CC-REDACTED]' },\n  { pattern: /\\b[A-Za-z0-9_-]{32,}\\b/g, replacement: '[TOKEN-REDACTED]' },\n]\n\nconst SENSITIVE_FIELD_NAMES = [\n  'password',\n  'token',\n  'apiKey',\n  'api_key',\n  'secret',\n  'ssn',\n  'social_security_number',\n  'creditCard',\n  'credit_card',\n  'cvv',\n  'pin',\n  'bankAccount',\n  'bank_account',\n  'routingNumber',\n  'routing_number',\n  'accountNumber',\n  'account_number',\n]\n\nexport function sanitizeString(value: string): string {\n  let sanitized = value\n\n  for (const { pattern, replacement } of PII_PATTERNS) {\n    sanitized = sanitized.replace(pattern, replacement)\n  }\n\n  return sanitized\n}\n\nexport function sanitizeObject(obj: unknown, additionalSensitiveFields: string[] = []): unknown {\n  if (obj === null || obj === undefined) {\n    return obj\n  }\n\n  if (typeof obj === 'string') {\n    return sanitizeString(obj)\n  }\n\n  if (typeof obj === 'number' || typeof obj === 'boolean') {\n    return obj\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(item => sanitizeObject(item, additionalSensitiveFields))\n  }\n\n  if (typeof obj === 'object') {\n    const sanitized: Record<string, unknown> = {}\n\n    const allSensitiveFields = [...SENSITIVE_FIELD_NAMES, ...additionalSensitiveFields]\n\n    for (const [key, value] of Object.entries(obj)) {\n      if (allSensitiveFields.some(field => key.toLowerCase().includes(field.toLowerCase()))) {\n        sanitized[key] = '[REDACTED]'\n        continue\n      }\n\n      sanitized[key] = sanitizeObject(value, additionalSensitiveFields)\n    }\n\n    return sanitized\n  }\n\n  return obj\n}\n\nexport function sanitizeError(\n  error: ObservabilityError,\n  config: SanitizationConfig = {},\n): ObservabilityError {\n  const {\n    enabled = true,\n    includeRawError = false,\n    customErrorSanitizer,\n    additionalSensitiveFields = [],\n  } = config\n\n  if (customErrorSanitizer) {\n    return customErrorSanitizer(error)\n  }\n\n  if (!enabled) {\n    return includeRawError ? error : { ...error, raw: undefined }\n  }\n\n  const sanitizedFieldErrors = error.fieldErrors.map(fe => ({\n    ...fe,\n    message: sanitizeString(fe.message),\n    metadata: fe.metadata\n      ? (sanitizeObject(fe.metadata, additionalSensitiveFields) as Record<string, unknown>)\n      : undefined,\n  }))\n\n  return {\n    ...error,\n    message: sanitizeString(error.message),\n    fieldErrors: sanitizedFieldErrors,\n    raw: includeRawError ? error.raw : undefined,\n  }\n}\n\nexport function sanitizeMetric(\n  metric: ObservabilityMetric,\n  config: SanitizationConfig = {},\n): ObservabilityMetric {\n  const { enabled = true, customMetricSanitizer, additionalSensitiveFields = [] } = config\n\n  if (customMetricSanitizer) {\n    return customMetricSanitizer(metric)\n  }\n\n  if (!enabled) {\n    return metric\n  }\n\n  return {\n    ...metric,\n    tags: metric.tags\n      ? (sanitizeObject(metric.tags, additionalSensitiveFields) as Record<string, string>)\n      : undefined,\n  }\n}\n"],"names":["PII_PATTERNS","SENSITIVE_FIELD_NAMES","sanitizeString","value","sanitized","pattern","replacement","sanitizeObject","obj","additionalSensitiveFields","item","allSensitiveFields","key","field","sanitizeError","error","config","enabled","includeRawError","customErrorSanitizer","sanitizedFieldErrors","fe","sanitizeMetric","metric","customMetricSanitizer"],"mappings":"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"}
+{"version":3,"file":"sanitization.js","sources":["../../../src/contexts/ObservabilityProvider/sanitization.ts"],"sourcesContent":["import type {\n  ObservabilityError,\n  ObservabilityMetric,\n  SanitizationConfig,\n} from '@/types/observability'\n\nconst PII_PATTERNS = [\n  { pattern: /\\b\\d{3}-\\d{2}-\\d{4}\\b/g, replacement: '[SSN-REDACTED]' },\n  { pattern: /\\b\\d{9}\\b/g, replacement: '[SSN-REDACTED]' },\n  {\n    pattern: /\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b/g,\n    replacement: '[EMAIL-REDACTED]',\n  },\n  { pattern: /\\b\\d{3}[-.\\s]?\\d{3}[-.\\s]?\\d{4}\\b/g, replacement: '[PHONE-REDACTED]' },\n  { pattern: /\\(\\d{3}\\)\\s*\\d{3}[-.\\s]?\\d{4}/g, replacement: '[PHONE-REDACTED]' },\n  { pattern: /\\b\\d{4}[-\\s]?\\d{4}[-\\s]?\\d{4}[-\\s]?\\d{4}\\b/g, replacement: '[CC-REDACTED]' },\n  { pattern: /\\b[A-Za-z0-9_-]{32,}\\b/g, replacement: '[TOKEN-REDACTED]' },\n]\n\nconst SENSITIVE_FIELD_NAMES = [\n  'password',\n  'token',\n  'apiKey',\n  'api_key',\n  'secret',\n  'ssn',\n  'social_security_number',\n  'creditCard',\n  'credit_card',\n  'cvv',\n  'pin',\n  'bankAccount',\n  'bank_account',\n  'routingNumber',\n  'routing_number',\n  'accountNumber',\n  'account_number',\n]\n\n/**\n * Replaces PII patterns (SSN, email, phone, credit card, long tokens) in a string with redacted placeholders.\n *\n * @param value - The string to scan and redact.\n * @returns The input with each matched pattern replaced by a `[TYPE-REDACTED]` placeholder.\n * @internal\n */\nexport function sanitizeString(value: string): string {\n  let sanitized = value\n\n  for (const { pattern, replacement } of PII_PATTERNS) {\n    sanitized = sanitized.replace(pattern, replacement)\n  }\n\n  return sanitized\n}\n\n/**\n * Recursively walks a value, redacting sensitive object keys and PII patterns in nested strings.\n *\n * @remarks\n * Keys whose names match (case-insensitively contain) any built-in sensitive field name or any\n * entry in `additionalSensitiveFields` have their values replaced with `[REDACTED]`. String\n * values are passed through {@link sanitizeString} so PII patterns inside them are also redacted.\n * Numbers, booleans, `null`, and `undefined` pass through unchanged.\n *\n * @param obj - The value to sanitize. May be any JSON-shaped structure.\n * @param additionalSensitiveFields - Extra field names to treat as sensitive (case-insensitive substring match).\n * @returns A new value of the same shape with sensitive fields and PII patterns redacted.\n * @internal\n */\nexport function sanitizeObject(obj: unknown, additionalSensitiveFields: string[] = []): unknown {\n  if (obj === null || obj === undefined) {\n    return obj\n  }\n\n  if (typeof obj === 'string') {\n    return sanitizeString(obj)\n  }\n\n  if (typeof obj === 'number' || typeof obj === 'boolean') {\n    return obj\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(item => sanitizeObject(item, additionalSensitiveFields))\n  }\n\n  if (typeof obj === 'object') {\n    const sanitized: Record<string, unknown> = {}\n\n    const allSensitiveFields = [...SENSITIVE_FIELD_NAMES, ...additionalSensitiveFields]\n\n    for (const [key, value] of Object.entries(obj)) {\n      if (allSensitiveFields.some(field => key.toLowerCase().includes(field.toLowerCase()))) {\n        sanitized[key] = '[REDACTED]'\n        continue\n      }\n\n      sanitized[key] = sanitizeObject(value, additionalSensitiveFields)\n    }\n\n    return sanitized\n  }\n\n  return obj\n}\n\n/**\n * Returns a copy of an observability error with PII redacted from messages and field-error metadata.\n *\n * @remarks\n * If `config.customErrorSanitizer` is provided, it is invoked and its result returned directly.\n * When sanitization is disabled, the error passes through unchanged except that `raw` is stripped\n * unless `includeRawError` is true. When enabled, `message` and each `fieldErrors[].message` run\n * through {@link sanitizeString}, and each `fieldErrors[].metadata` runs through {@link sanitizeObject}\n * with `additionalSensitiveFields` applied.\n *\n * @param error - The error reported by SDK error boundaries or form submissions.\n * @param config - Optional sanitization configuration; defaults to enabled with `raw` stripped.\n * @returns The sanitized error suitable for forwarding to a partner observability hook.\n * @internal\n */\nexport function sanitizeError(\n  error: ObservabilityError,\n  config: SanitizationConfig = {},\n): ObservabilityError {\n  const {\n    enabled = true,\n    includeRawError = false,\n    customErrorSanitizer,\n    additionalSensitiveFields = [],\n  } = config\n\n  if (customErrorSanitizer) {\n    return customErrorSanitizer(error)\n  }\n\n  if (!enabled) {\n    return includeRawError ? error : { ...error, raw: undefined }\n  }\n\n  const sanitizedFieldErrors = error.fieldErrors.map(fe => ({\n    ...fe,\n    message: sanitizeString(fe.message),\n    metadata: fe.metadata\n      ? (sanitizeObject(fe.metadata, additionalSensitiveFields) as Record<string, unknown>)\n      : undefined,\n  }))\n\n  return {\n    ...error,\n    message: sanitizeString(error.message),\n    fieldErrors: sanitizedFieldErrors,\n    raw: includeRawError ? error.raw : undefined,\n  }\n}\n\n/**\n * Returns a copy of an observability metric with sensitive values redacted from its tags.\n *\n * @remarks\n * If `config.customMetricSanitizer` is provided, it is invoked and its result returned directly.\n * When sanitization is disabled, the metric passes through unchanged. Otherwise the `tags` record\n * is run through {@link sanitizeObject} with `additionalSensitiveFields` applied.\n *\n * @param metric - The metric reported by SDK component instrumentation.\n * @param config - Optional sanitization configuration; defaults to enabled.\n * @returns The sanitized metric suitable for forwarding to a partner observability hook.\n * @internal\n */\nexport function sanitizeMetric(\n  metric: ObservabilityMetric,\n  config: SanitizationConfig = {},\n): ObservabilityMetric {\n  const { enabled = true, customMetricSanitizer, additionalSensitiveFields = [] } = config\n\n  if (customMetricSanitizer) {\n    return customMetricSanitizer(metric)\n  }\n\n  if (!enabled) {\n    return metric\n  }\n\n  return {\n    ...metric,\n    tags: metric.tags\n      ? (sanitizeObject(metric.tags, additionalSensitiveFields) as Record<string, string>)\n      : undefined,\n  }\n}\n"],"names":["PII_PATTERNS","SENSITIVE_FIELD_NAMES","sanitizeString","value","sanitized","pattern","replacement","sanitizeObject","obj","additionalSensitiveFields","item","allSensitiveFields","key","field","sanitizeError","error","config","enabled","includeRawError","customErrorSanitizer","sanitizedFieldErrors","fe","sanitizeMetric","metric","customMetricSanitizer"],"mappings":"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"}

package/dist/contexts/ObservabilityProvider/useObservability.d.ts

@@ -1,2 +1,16 @@
 import { ObservabilityContextValue } from './ObservabilityContext';
+/**
+ * Returns the partner-supplied observability hook with PII sanitization applied to its callbacks.
+ *
+ * @remarks
+ * SDK components call this hook to report errors and metrics. Each `onError` and `onMetric`
+ * payload is run through the configured sanitization (PII pattern redaction plus sensitive-field
+ * removal) before being passed to the partner's hook, so partner-side telemetry never receives
+ * raw form values or other sensitive data unless explicitly opted in via `sanitization` config.
+ * When no {@link ObservabilityProvider} is present, `observability` is `undefined` and reports
+ * are dropped.
+ *
+ * @returns A context value whose `observability` is either the sanitized hook or `undefined`.
+ * @internal
+ */
 export declare const useObservability: () => ObservabilityContextValue;

package/dist/contexts/ObservabilityProvider/useObservability.js.map

@@ -1 +1 @@
-{"version":3,"file":"useObservability.js","sources":["../../../src/contexts/ObservabilityProvider/useObservability.ts"],"sourcesContent":["import { useContext } from 'react'\nimport { ObservabilityContext } from './ObservabilityContext'\nimport type { ObservabilityContextValue } from './ObservabilityContext'\nimport { useSanitizedObservability } from './useSanitizedObservability'\n\nexport const useObservability = (): ObservabilityContextValue => {\n  const context = useContext(ObservabilityContext)\n  const sanitizedObservability = useSanitizedObservability(context?.observability)\n\n  if (context === undefined) {\n    return { observability: undefined }\n  }\n\n  return { observability: sanitizedObservability }\n}\n"],"names":["useObservability","context","useContext","ObservabilityContext","sanitizedObservability","useSanitizedObservability"],"mappings":";;;AAKO,MAAMA,IAAmB,MAAiC;AAC/D,QAAMC,IAAUC,EAAWC,CAAoB,GACzCC,IAAyBC,EAA0BJ,GAAS,aAAa;AAE/E,SAAIA,MAAY,SACP,EAAE,eAAe,OAAA,IAGnB,EAAE,eAAeG,EAAA;AAC1B;"}
+{"version":3,"file":"useObservability.js","sources":["../../../src/contexts/ObservabilityProvider/useObservability.ts"],"sourcesContent":["import { useContext } from 'react'\nimport { ObservabilityContext } from './ObservabilityContext'\nimport type { ObservabilityContextValue } from './ObservabilityContext'\nimport { useSanitizedObservability } from './useSanitizedObservability'\n\n/**\n * Returns the partner-supplied observability hook with PII sanitization applied to its callbacks.\n *\n * @remarks\n * SDK components call this hook to report errors and metrics. Each `onError` and `onMetric`\n * payload is run through the configured sanitization (PII pattern redaction plus sensitive-field\n * removal) before being passed to the partner's hook, so partner-side telemetry never receives\n * raw form values or other sensitive data unless explicitly opted in via `sanitization` config.\n * When no {@link ObservabilityProvider} is present, `observability` is `undefined` and reports\n * are dropped.\n *\n * @returns A context value whose `observability` is either the sanitized hook or `undefined`.\n * @internal\n */\nexport const useObservability = (): ObservabilityContextValue => {\n  const context = useContext(ObservabilityContext)\n  const sanitizedObservability = useSanitizedObservability(context?.observability)\n\n  if (context === undefined) {\n    return { observability: undefined }\n  }\n\n  return { observability: sanitizedObservability }\n}\n"],"names":["useObservability","context","useContext","ObservabilityContext","sanitizedObservability","useSanitizedObservability"],"mappings":";;;AAmBO,MAAMA,IAAmB,MAAiC;AAC/D,QAAMC,IAAUC,EAAWC,CAAoB,GACzCC,IAAyBC,EAA0BJ,GAAS,aAAa;AAE/E,SAAIA,MAAY,SACP,EAAE,eAAe,OAAA,IAGnB,EAAE,eAAeG,EAAA;AAC1B;"}

package/dist/contexts/ObservabilityProvider/useSanitizedObservability.d.ts

@@ -1,4 +1,18 @@
 import { ObservabilityError, ObservabilityMetric, ObservabilityHook } from '../../types/observability';
+/**
+ * Wraps an observability hook so its `onError` and `onMetric` callbacks receive sanitized payloads.
+ *
+ * @remarks
+ * Returns `undefined` when no observability hook is configured. Otherwise returns an object with
+ * memoized `onError` / `onMetric` callbacks that route through {@link sanitizeError} and
+ * {@link sanitizeMetric} using the hook's `sanitization` config. Each wrapped callback is only
+ * present when the underlying hook defines its counterpart, so partners can opt into error
+ * tracking, metric tracking, or both independently.
+ *
+ * @param observability - The partner-supplied observability hook, if any.
+ * @returns A wrapped hook with sanitizing callbacks, or `undefined` when no hook is supplied.
+ * @internal
+ */
 export declare function useSanitizedObservability(observability?: ObservabilityHook): {
     onError: ((error: ObservabilityError) => void) | undefined;
     onMetric: ((metric: ObservabilityMetric) => void) | undefined;

package/dist/contexts/ObservabilityProvider/useSanitizedObservability.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSanitizedObservability.js","sources":["../../../src/contexts/ObservabilityProvider/useSanitizedObservability.ts"],"sourcesContent":["import { useCallback } from 'react'\nimport { sanitizeError, sanitizeMetric } from './sanitization'\nimport type {\n  ObservabilityError,\n  ObservabilityMetric,\n  ObservabilityHook,\n} from '@/types/observability'\n\nexport function useSanitizedObservability(observability?: ObservabilityHook) {\n  const sanitizationConfig = observability?.sanitization\n\n  const onError = useCallback(\n    (error: ObservabilityError) => {\n      if (!observability?.onError) return\n\n      const sanitized = sanitizeError(error, sanitizationConfig)\n      observability.onError(sanitized)\n    },\n    [observability, sanitizationConfig],\n  )\n\n  const onMetric = useCallback(\n    (metric: ObservabilityMetric) => {\n      if (!observability?.onMetric) return\n\n      const sanitized = sanitizeMetric(metric, sanitizationConfig)\n      observability.onMetric(sanitized)\n    },\n    [observability, sanitizationConfig],\n  )\n\n  if (!observability) {\n    return undefined\n  }\n\n  return {\n    onError: observability.onError ? onError : undefined,\n    onMetric: observability.onMetric ? onMetric : undefined,\n  }\n}\n"],"names":["useSanitizedObservability","observability","sanitizationConfig","onError","useCallback","error","sanitized","sanitizeError","onMetric","metric","sanitizeMetric"],"mappings":";;AAQO,SAASA,EAA0BC,GAAmC;AAC3E,QAAMC,IAAqBD,GAAe,cAEpCE,IAAUC;AAAA,IACd,CAACC,MAA8B;AAC7B,UAAI,CAACJ,GAAe,QAAS;AAE7B,YAAMK,IAAYC,EAAcF,GAAOH,CAAkB;AACzD,MAAAD,EAAc,QAAQK,CAAS;AAAA,IACjC;AAAA,IACA,CAACL,GAAeC,CAAkB;AAAA,EAAA,GAG9BM,IAAWJ;AAAA,IACf,CAACK,MAAgC;AAC/B,UAAI,CAACR,GAAe,SAAU;AAE9B,YAAMK,IAAYI,EAAeD,GAAQP,CAAkB;AAC3D,MAAAD,EAAc,SAASK,CAAS;AAAA,IAClC;AAAA,IACA,CAACL,GAAeC,CAAkB;AAAA,EAAA;AAGpC,MAAKD;AAIL,WAAO;AAAA,MACL,SAASA,EAAc,UAAUE,IAAU;AAAA,MAC3C,UAAUF,EAAc,WAAWO,IAAW;AAAA,IAAA;AAElD;"}
+{"version":3,"file":"useSanitizedObservability.js","sources":["../../../src/contexts/ObservabilityProvider/useSanitizedObservability.ts"],"sourcesContent":["import { useCallback } from 'react'\nimport { sanitizeError, sanitizeMetric } from './sanitization'\nimport type {\n  ObservabilityError,\n  ObservabilityMetric,\n  ObservabilityHook,\n} from '@/types/observability'\n\n/**\n * Wraps an observability hook so its `onError` and `onMetric` callbacks receive sanitized payloads.\n *\n * @remarks\n * Returns `undefined` when no observability hook is configured. Otherwise returns an object with\n * memoized `onError` / `onMetric` callbacks that route through {@link sanitizeError} and\n * {@link sanitizeMetric} using the hook's `sanitization` config. Each wrapped callback is only\n * present when the underlying hook defines its counterpart, so partners can opt into error\n * tracking, metric tracking, or both independently.\n *\n * @param observability - The partner-supplied observability hook, if any.\n * @returns A wrapped hook with sanitizing callbacks, or `undefined` when no hook is supplied.\n * @internal\n */\nexport function useSanitizedObservability(observability?: ObservabilityHook) {\n  const sanitizationConfig = observability?.sanitization\n\n  const onError = useCallback(\n    (error: ObservabilityError) => {\n      if (!observability?.onError) return\n\n      const sanitized = sanitizeError(error, sanitizationConfig)\n      observability.onError(sanitized)\n    },\n    [observability, sanitizationConfig],\n  )\n\n  const onMetric = useCallback(\n    (metric: ObservabilityMetric) => {\n      if (!observability?.onMetric) return\n\n      const sanitized = sanitizeMetric(metric, sanitizationConfig)\n      observability.onMetric(sanitized)\n    },\n    [observability, sanitizationConfig],\n  )\n\n  if (!observability) {\n    return undefined\n  }\n\n  return {\n    onError: observability.onError ? onError : undefined,\n    onMetric: observability.onMetric ? onMetric : undefined,\n  }\n}\n"],"names":["useSanitizedObservability","observability","sanitizationConfig","onError","useCallback","error","sanitized","sanitizeError","onMetric","metric","sanitizeMetric"],"mappings":";;AAsBO,SAASA,EAA0BC,GAAmC;AAC3E,QAAMC,IAAqBD,GAAe,cAEpCE,IAAUC;AAAA,IACd,CAACC,MAA8B;AAC7B,UAAI,CAACJ,GAAe,QAAS;AAE7B,YAAMK,IAAYC,EAAcF,GAAOH,CAAkB;AACzD,MAAAD,EAAc,QAAQK,CAAS;AAAA,IACjC;AAAA,IACA,CAACL,GAAeC,CAAkB;AAAA,EAAA,GAG9BM,IAAWJ;AAAA,IACf,CAACK,MAAgC;AAC/B,UAAI,CAACR,GAAe,SAAU;AAE9B,YAAMK,IAAYI,EAAeD,GAAQP,CAAkB;AAC3D,MAAAD,EAAc,SAASK,CAAS;AAAA,IAClC;AAAA,IACA,CAACL,GAAeC,CAAkB;AAAA,EAAA;AAGpC,MAAKD;AAIL,WAAO;AAAA,MACL,SAASA,EAAc,UAAUE,IAAU;AAAA,MAC3C,UAAUF,EAAc,WAAWO,IAAW;AAAA,IAAA;AAElD;"}

package/dist/contexts/ThemeProvider/ThemeProvider.d.ts

@@ -1,7 +1,9 @@
 import { default as React } from 'react';
 import { GustoSDKTheme } from './theme';
+/** @internal */
 export interface ThemeProviderProps {
-    theme?: GustoSDKTheme;
+    /** Partial set of theme tokens that override the SDK defaults. */
+    theme?: Partial<GustoSDKTheme>;
     /**
      * Element to use as the portal container for all SDK overlays (Select, ComboBox,
      * DatePicker, Menu, etc.). Defaults to the SDK's root article element.
@@ -10,6 +12,8 @@ export interface ThemeProviderProps {
      * when your app's scroll or clipping context interferes with overlay positioning.
      */
     portalContainer?: HTMLElement;
+    /** Subtree rendered inside the SDK's themed root element. */
     children?: React.ReactNode;
 }
+/** @internal */
 export declare const ThemeProvider: React.FC<ThemeProviderProps>;

package/dist/contexts/ThemeProvider/ThemeProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.js","sources":["../../../src/contexts/ThemeProvider/ThemeProvider.tsx"],"sourcesContent":["import type React from 'react'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\nimport { ThemeContext } from './useTheme'\nimport { mergePartnerTheme, type GustoSDKTheme } from './theme'\nimport '@/styles/sdk.scss'\n\nexport interface ThemeProviderProps {\n  theme?: GustoSDKTheme\n  /**\n   * Element to use as the portal container for all SDK overlays (Select, ComboBox,\n   * DatePicker, Menu, etc.). Defaults to the SDK's root article element.\n   *\n   * Pass `document.body` (or another stable element outside the SDK's container)\n   * when your app's scroll or clipping context interferes with overlay positioning.\n   */\n  portalContainer?: HTMLElement\n  children?: React.ReactNode\n}\n\nexport const ThemeProvider: React.FC<ThemeProviderProps> = ({\n  theme: partnerThemeOverrides = {},\n  portalContainer,\n  children,\n}) => {\n  const GThemeVariables = useRef<HTMLStyleElement | null>(null)\n  const portalContainerRef = useRef<HTMLElement | null>(null)\n\n  const articleRef = useCallback(\n    (el: HTMLElement | null) => {\n      portalContainerRef.current = portalContainer ?? el\n    },\n    [portalContainer],\n  )\n\n  const mergedTheme = useMemo(\n    () => mergePartnerTheme(partnerThemeOverrides),\n    [partnerThemeOverrides],\n  )\n\n  const cssContent = useMemo(\n    () => `.GSDK{\\n${parseThemeToCSS(mergedTheme).join('\\n')}\\n}`,\n    [mergedTheme],\n  )\n\n  useEffect(() => {\n    if (!GThemeVariables.current) {\n      GThemeVariables.current = document.createElement('style')\n      GThemeVariables.current.setAttribute('data-testid', 'GSDK')\n      document.head.appendChild(GThemeVariables.current)\n    }\n\n    GThemeVariables.current.textContent = cssContent\n  }, [cssContent])\n\n  return (\n    <ThemeContext.Provider value={{ container: portalContainerRef }}>\n      <article className=\"GSDK\" data-testid=\"GSDK\" ref={articleRef}>\n        {children}\n      </article>\n    </ThemeContext.Provider>\n  )\n}\n\n/**\n * Recursive flattening of the theme object into css variable format\n */\nconst parseThemeToCSS = (theme: GustoSDKTheme, prefix?: string): string[] => {\n  const cssProps: string[] = []\n  for (const [key, value] of Object.entries(theme)) {\n    if (typeof value === 'object') {\n      cssProps.push(...parseThemeToCSS(value, prefix ? prefix + '-' + key : key))\n    } else {\n      cssProps.push(`--g-${prefix ? prefix + '-' + key : key}: ${value};`)\n    }\n  }\n  return cssProps\n}\n"],"names":["ThemeProvider","partnerThemeOverrides","portalContainer","children","GThemeVariables","useRef","portalContainerRef","articleRef","useCallback","el","mergedTheme","useMemo","mergePartnerTheme","cssContent","parseThemeToCSS","useEffect","ThemeContext","jsx","theme","prefix","cssProps","key","value"],"mappings":";;;;;AAmBO,MAAMA,IAA8C,CAAC;AAAA,EAC1D,OAAOC,IAAwB,CAAA;AAAA,EAC/B,iBAAAC;AAAA,EACA,UAAAC;AACF,MAAM;AACJ,QAAMC,IAAkBC,EAAgC,IAAI,GACtDC,IAAqBD,EAA2B,IAAI,GAEpDE,IAAaC;AAAA,IACjB,CAACC,MAA2B;AAC1B,MAAAH,EAAmB,UAAUJ,KAAmBO;AAAA,IAClD;AAAA,IACA,CAACP,CAAe;AAAA,EAAA,GAGZQ,IAAcC;AAAA,IAClB,MAAMC,EAAkBX,CAAqB;AAAA,IAC7C,CAACA,CAAqB;AAAA,EAAA,GAGlBY,IAAaF;AAAA,IACjB,MAAM;AAAA,EAAWG,EAAgBJ,CAAW,EAAE,KAAK;AAAA,CAAI,CAAC;AAAA;AAAA,IACxD,CAACA,CAAW;AAAA,EAAA;AAGd,SAAAK,EAAU,MAAM;AACd,IAAKX,EAAgB,YACnBA,EAAgB,UAAU,SAAS,cAAc,OAAO,GACxDA,EAAgB,QAAQ,aAAa,eAAe,MAAM,GAC1D,SAAS,KAAK,YAAYA,EAAgB,OAAO,IAGnDA,EAAgB,QAAQ,cAAcS;AAAA,EACxC,GAAG,CAACA,CAAU,CAAC,qBAGZG,EAAa,UAAb,EAAsB,OAAO,EAAE,WAAWV,EAAA,GACzC,UAAA,gBAAAW,EAAC,WAAA,EAAQ,WAAU,QAAO,eAAY,QAAO,KAAKV,GAC/C,UAAAJ,GACH,GACF;AAEJ,GAKMW,IAAkB,CAACI,GAAsBC,MAA8B;AAC3E,QAAMC,IAAqB,CAAA;AAC3B,aAAW,CAACC,GAAKC,CAAK,KAAK,OAAO,QAAQJ,CAAK;AAC7C,IAAI,OAAOI,KAAU,WACnBF,EAAS,KAAK,GAAGN,EAAgBQ,GAAOH,IAASA,IAAS,MAAME,IAAMA,CAAG,CAAC,IAE1ED,EAAS,KAAK,OAAOD,IAASA,IAAS,MAAME,IAAMA,CAAG,KAAKC,CAAK,GAAG;AAGvE,SAAOF;AACT;"}
+{"version":3,"file":"ThemeProvider.js","sources":["../../../src/contexts/ThemeProvider/ThemeProvider.tsx"],"sourcesContent":["import type React from 'react'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\nimport { ThemeContext } from './useTheme'\nimport { mergePartnerTheme, type GustoSDKTheme } from './theme'\nimport '@/styles/sdk.scss'\n\n/** @internal */\nexport interface ThemeProviderProps {\n  /** Partial set of theme tokens that override the SDK defaults. */\n  theme?: Partial<GustoSDKTheme>\n  /**\n   * Element to use as the portal container for all SDK overlays (Select, ComboBox,\n   * DatePicker, Menu, etc.). Defaults to the SDK's root article element.\n   *\n   * Pass `document.body` (or another stable element outside the SDK's container)\n   * when your app's scroll or clipping context interferes with overlay positioning.\n   */\n  portalContainer?: HTMLElement\n  /** Subtree rendered inside the SDK's themed root element. */\n  children?: React.ReactNode\n}\n\n/** @internal */\nexport const ThemeProvider: React.FC<ThemeProviderProps> = ({\n  theme: partnerThemeOverrides = {},\n  portalContainer,\n  children,\n}) => {\n  const GThemeVariables = useRef<HTMLStyleElement | null>(null)\n  const portalContainerRef = useRef<HTMLElement | null>(null)\n\n  const articleRef = useCallback(\n    (el: HTMLElement | null) => {\n      portalContainerRef.current = portalContainer ?? el\n    },\n    [portalContainer],\n  )\n\n  const mergedTheme = useMemo(\n    () => mergePartnerTheme(partnerThemeOverrides),\n    [partnerThemeOverrides],\n  )\n\n  const cssContent = useMemo(\n    () => `.GSDK{\\n${parseThemeToCSS(mergedTheme).join('\\n')}\\n}`,\n    [mergedTheme],\n  )\n\n  useEffect(() => {\n    if (!GThemeVariables.current) {\n      GThemeVariables.current = document.createElement('style')\n      GThemeVariables.current.setAttribute('data-testid', 'GSDK')\n      document.head.appendChild(GThemeVariables.current)\n    }\n\n    GThemeVariables.current.textContent = cssContent\n  }, [cssContent])\n\n  return (\n    <ThemeContext.Provider value={{ container: portalContainerRef }}>\n      <article className=\"GSDK\" data-testid=\"GSDK\" ref={articleRef}>\n        {children}\n      </article>\n    </ThemeContext.Provider>\n  )\n}\n\n/**\n * Recursive flattening of the theme object into css variable format\n */\nconst parseThemeToCSS = (theme: Partial<GustoSDKTheme>, prefix?: string): string[] => {\n  const cssProps: string[] = []\n  for (const [key, value] of Object.entries(theme)) {\n    if (typeof value === 'object') {\n      cssProps.push(...parseThemeToCSS(value, prefix ? prefix + '-' + key : key))\n    } else {\n      cssProps.push(`--g-${prefix ? prefix + '-' + key : key}: ${value};`)\n    }\n  }\n  return cssProps\n}\n"],"names":["ThemeProvider","partnerThemeOverrides","portalContainer","children","GThemeVariables","useRef","portalContainerRef","articleRef","useCallback","el","mergedTheme","useMemo","mergePartnerTheme","cssContent","parseThemeToCSS","useEffect","ThemeContext","jsx","theme","prefix","cssProps","key","value"],"mappings":";;;;;AAuBO,MAAMA,IAA8C,CAAC;AAAA,EAC1D,OAAOC,IAAwB,CAAA;AAAA,EAC/B,iBAAAC;AAAA,EACA,UAAAC;AACF,MAAM;AACJ,QAAMC,IAAkBC,EAAgC,IAAI,GACtDC,IAAqBD,EAA2B,IAAI,GAEpDE,IAAaC;AAAA,IACjB,CAACC,MAA2B;AAC1B,MAAAH,EAAmB,UAAUJ,KAAmBO;AAAA,IAClD;AAAA,IACA,CAACP,CAAe;AAAA,EAAA,GAGZQ,IAAcC;AAAA,IAClB,MAAMC,EAAkBX,CAAqB;AAAA,IAC7C,CAACA,CAAqB;AAAA,EAAA,GAGlBY,IAAaF;AAAA,IACjB,MAAM;AAAA,EAAWG,EAAgBJ,CAAW,EAAE,KAAK;AAAA,CAAI,CAAC;AAAA;AAAA,IACxD,CAACA,CAAW;AAAA,EAAA;AAGd,SAAAK,EAAU,MAAM;AACd,IAAKX,EAAgB,YACnBA,EAAgB,UAAU,SAAS,cAAc,OAAO,GACxDA,EAAgB,QAAQ,aAAa,eAAe,MAAM,GAC1D,SAAS,KAAK,YAAYA,EAAgB,OAAO,IAGnDA,EAAgB,QAAQ,cAAcS;AAAA,EACxC,GAAG,CAACA,CAAU,CAAC,qBAGZG,EAAa,UAAb,EAAsB,OAAO,EAAE,WAAWV,EAAA,GACzC,UAAA,gBAAAW,EAAC,WAAA,EAAQ,WAAU,QAAO,eAAY,QAAO,KAAKV,GAC/C,UAAAJ,GACH,GACF;AAEJ,GAKMW,IAAkB,CAACI,GAA+BC,MAA8B;AACpF,QAAMC,IAAqB,CAAA;AAC3B,aAAW,CAACC,GAAKC,CAAK,KAAK,OAAO,QAAQJ,CAAK;AAC7C,IAAI,OAAOI,KAAU,WACnBF,EAAS,KAAK,GAAGN,EAAgBQ,GAAOH,IAASA,IAAS,MAAME,IAAMA,CAAG,CAAC,IAE1ED,EAAS,KAAK,OAAOD,IAASA,IAAS,MAAME,IAAMA,CAAG,KAAKC,CAAK,GAAG;AAGvE,SAAOF;AACT;"}

package/dist/contexts/ThemeProvider/customRender.d.ts

@@ -1,4 +1,5 @@
 import { RenderOptions } from '@testing-library/react';
 import { ReactElement } from 'react';
+/** @internal */
 declare const customRender: (ui: ReactElement, options?: Omit<RenderOptions, "wrapper">) => import('@testing-library/react').RenderResult<typeof import("@testing-library/dom/types/queries"), HTMLElement, HTMLElement>;
 export { customRender as render };

package/dist/contexts/ThemeProvider/index.d.ts

@@ -1,4 +1,3 @@
 import "./types/i18next.d.ts"
 export { ThemeProvider, type ThemeProviderProps } from './ThemeProvider';
 export { useTheme } from './useTheme';
-export { render } from './customRender';

package/dist/contexts/ThemeProvider/test-utils.d.ts

@@ -1,4 +1,4 @@
 import { default as React } from 'react';
 export declare const AllTheProviders: ({ children }: {
     children: React.ReactNode;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;

package/dist/contexts/ThemeProvider/theme.d.ts

@@ -1,102 +1,8 @@
+import { GustoSDKTheme, GustoSDKThemeColors } from './types';
+export type { GustoSDKTheme, GustoSDKThemeColors };
+/** @internal */
 export declare const transitionDuration = 200;
-declare const defaultThemeColors: {
-    colorBody: string;
-    colorBodyAccent: string;
-    colorBodyContent: string;
-    colorBodySubContent: string;
-    colorPrimary: string;
-    colorPrimaryAccent: string;
-    colorPrimaryContent: string;
-    colorSecondary: string;
-    colorSecondaryAccent: string;
-    colorSecondaryContent: string;
-    colorInfo: string;
-    colorInfoAccent: string;
-    colorInfoContent: string;
-    colorWarning: string;
-    colorWarningAccent: string;
-    colorWarningContent: string;
-    colorError: string;
-    colorErrorAccent: string;
-    colorErrorContent: string;
-    colorSuccess: string;
-    colorSuccessAccent: string;
-    colorSuccessContent: string;
-    colorBorderPrimary: string;
-    colorBorderSecondary: string;
-    colorButtonIcon: string;
-};
-export type GustoSDKThemeColors = Partial<typeof defaultThemeColors>;
-export declare const createTheme: (colors?: GustoSDKThemeColors) => {
-    inputBackgroundColor: string | undefined;
-    inputBorderColor: string;
-    inputContentColor: string | undefined;
-    inputBorderWidth: string;
-    inputPlaceholderColor: string | undefined;
-    inputAdornmentColor: string | undefined;
-    inputDisabledBackgroundColor: string | undefined;
-    inputLabelColor: string | undefined;
-    inputLabelFontSize: string;
-    inputLabelFontWeight: string;
-    inputDescriptionColor: string | undefined;
-    inputErrorColor: string | undefined;
-    inputRadius: string;
-    buttonRadius: string;
-    cardRadius: string;
-    badgeRadius: string;
-    bannerRadius: string;
-    boxRadius: string;
-    fontSizeRoot: string;
-    fontFamily: string;
-    fontLineHeightLarge: string;
-    fontLineHeightRegular: string;
-    fontLineHeightSmall: string;
-    fontLineHeightExtraSmall: string;
-    fontSizeExtraSmall: string;
-    fontSizeSmall: string;
-    fontSizeRegular: string;
-    fontSizeLarge: string;
-    fontSizeHeading1: string;
-    fontSizeHeading2: string;
-    fontSizeHeading3: string;
-    fontSizeHeading4: string;
-    fontSizeHeading5: string;
-    fontSizeHeading6: string;
-    fontWeightRegular: string;
-    fontWeightMedium: string;
-    fontWeightSemibold: string;
-    fontWeightBold: string;
-    transitionDuration: string;
-    shadowResting: string;
-    shadowTopmost: string;
-    focusRingColor: string | undefined;
-    focusRingWidth: string;
-    colorBody: string;
-    colorBodyAccent: string;
-    colorBodyContent: string;
-    colorBodySubContent: string;
-    colorPrimary: string;
-    colorPrimaryAccent: string;
-    colorPrimaryContent: string;
-    colorSecondary: string;
-    colorSecondaryAccent: string;
-    colorSecondaryContent: string;
-    colorInfo: string;
-    colorInfoAccent: string;
-    colorInfoContent: string;
-    colorWarning: string;
-    colorWarningAccent: string;
-    colorWarningContent: string;
-    colorError: string;
-    colorErrorAccent: string;
-    colorErrorContent: string;
-    colorSuccess: string;
-    colorSuccessAccent: string;
-    colorSuccessContent: string;
-    colorBorderPrimary: string;
-    colorBorderSecondary: string;
-    colorButtonIcon: string;
-};
-export type GustoSDKTheme = Partial<ReturnType<typeof createTheme>>;
-export declare const mergePartnerTheme: (partnerTheme: GustoSDKTheme) => GustoSDKTheme;
-export {};
+/** @internal */
+export declare const createTheme: (colors?: Partial<GustoSDKThemeColors>) => GustoSDKTheme;
+/** @internal */
+export declare const mergePartnerTheme: (partnerTheme: Partial<GustoSDKTheme>) => GustoSDKTheme;