@gusto/embedded-react-sdk 0.46.3 → 0.47.1

package/dist/contexts/ThemeProvider/theme.js

@@ -1,4 +1,4 @@
-import { toRem as n, getRootFontSize as l } from "../../helpers/rem.js";
+import { toRem as n, getRootFontSize as a } from "../../helpers/rem.js";
 const o = {
   neutral: {
     25: "#FFFFFF",
@@ -31,7 +31,7 @@ const o = {
     500: "#DCDCDC",
     800: "#1C1C1C"
   }
-}, u = 200, i = {
+}, u = 200, e = {
   colorBody: o.neutral[25],
   colorBodyAccent: o.neutral[100],
   colorBodyContent: o.neutral[1e3],
@@ -57,73 +57,67 @@ const o = {
   colorBorderPrimary: o.neutral[300],
   colorBorderSecondary: o.neutral[200],
   colorButtonIcon: o.neutral[400]
-}, d = (r = {}) => ({
-  // Colors
-  ...i,
-  ...r,
-  // Input Colors
-  inputBackgroundColor: r.colorBody,
-  inputBorderColor: o.neutral[300],
-  inputContentColor: r.colorBodyContent,
-  inputBorderWidth: "1px",
-  inputPlaceholderColor: r.colorBodySubContent,
-  inputAdornmentColor: r.colorBodySubContent,
-  inputDisabledBackgroundColor: r.colorBodyAccent,
-  // Field Colors
-  inputLabelColor: r.colorBodyContent,
-  inputLabelFontSize: n(16),
-  inputLabelFontWeight: "500",
-  inputDescriptionColor: r.colorBodySubContent,
-  inputErrorColor: r.colorErrorAccent,
-  // Radius
-  inputRadius: n(8),
-  buttonRadius: n(8),
-  cardRadius: n(8),
-  badgeRadius: n(6),
-  bannerRadius: n(8),
-  boxRadius: n(8),
-  // Font
-  fontSizeRoot: l(),
-  fontFamily: 'system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
-  fontLineHeightLarge: n(28),
-  fontLineHeightRegular: n(24),
-  fontLineHeightSmall: n(20),
-  fontLineHeightExtraSmall: n(18),
-  fontSizeExtraSmall: n(12),
-  fontSizeSmall: n(14),
-  fontSizeRegular: n(16),
-  fontSizeLarge: n(18),
-  fontSizeHeading1: n(32),
-  fontSizeHeading2: n(24),
-  fontSizeHeading3: n(20),
-  fontSizeHeading4: n(18),
-  fontSizeHeading5: n(16),
-  fontSizeHeading6: n(14),
-  fontWeightRegular: "400",
-  fontWeightMedium: "500",
-  fontWeightSemibold: "600",
-  fontWeightBold: "700",
-  // Transitions
-  transitionDuration: `${u}ms`,
-  // Shadows
-  shadowResting: "0px 1px 2px 0px rgba(10, 13, 18, 0.05)",
-  shadowTopmost: "0px 4px 6px 0px rgba(28, 28, 28, 0.05), 0px 10px 15px 0px rgba(28, 28, 28, 0.10)",
-  // Focus
-  focusRingColor: r.colorPrimary,
-  focusRingWidth: "2px"
-}), C = (r) => {
-  const a = Object.entries(i).reduce(
-    (t, [e, c]) => (t[e] = r[e] || c, t),
-    {}
+}, s = (t = {}) => {
+  const r = { ...e, ...t };
+  return {
+    ...r,
+    inputBackgroundColor: r.colorBody,
+    inputBorderColor: o.neutral[300],
+    inputContentColor: r.colorBodyContent,
+    inputBorderWidth: "1px",
+    inputPlaceholderColor: r.colorBodySubContent,
+    inputAdornmentColor: r.colorBodySubContent,
+    inputDisabledBackgroundColor: r.colorBodyAccent,
+    inputLabelColor: r.colorBodyContent,
+    inputLabelFontSize: n(16),
+    inputLabelFontWeight: "500",
+    inputDescriptionColor: r.colorBodySubContent,
+    inputErrorColor: r.colorErrorAccent,
+    inputRadius: n(8),
+    buttonRadius: n(8),
+    cardRadius: n(8),
+    badgeRadius: n(6),
+    bannerRadius: n(8),
+    boxRadius: n(8),
+    fontSizeRoot: a(),
+    fontFamily: 'system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+    fontLineHeightLarge: n(28),
+    fontLineHeightRegular: n(24),
+    fontLineHeightSmall: n(20),
+    fontLineHeightExtraSmall: n(18),
+    fontSizeExtraSmall: n(12),
+    fontSizeSmall: n(14),
+    fontSizeRegular: n(16),
+    fontSizeLarge: n(18),
+    fontSizeHeading1: n(32),
+    fontSizeHeading2: n(24),
+    fontSizeHeading3: n(20),
+    fontSizeHeading4: n(18),
+    fontSizeHeading5: n(16),
+    fontSizeHeading6: n(14),
+    fontWeightRegular: "400",
+    fontWeightMedium: "500",
+    fontWeightSemibold: "600",
+    fontWeightBold: "700",
+    transitionDuration: `${u}ms`,
+    shadowResting: "0px 1px 2px 0px rgba(10, 13, 18, 0.05)",
+    shadowTopmost: "0px 4px 6px 0px rgba(28, 28, 28, 0.05), 0px 10px 15px 0px rgba(28, 28, 28, 0.10)",
+    focusRingColor: r.colorPrimary,
+    focusRingWidth: "2px"
+  };
+}, g = (t) => {
+  const r = Object.entries(e).reduce(
+    (i, [c, l]) => (i[c] = t[c] || l, i),
+    { ...e }
   );
   return {
-    ...d(a),
-    ...r
+    ...s(r),
+    ...t
   };
 };
 export {
-  d as createTheme,
-  C as mergePartnerTheme,
+  s as createTheme,
+  g as mergePartnerTheme,
   u as transitionDuration
 };
 //# sourceMappingURL=theme.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sources":["../../../src/contexts/ThemeProvider/theme.ts"],"sourcesContent":["import { getRootFontSize, toRem } from '@/helpers/rem'\n\n// Colors are for internal use in our theme currently\n// We don't export them for partner use or overrides\nconst baseColors = {\n  neutral: {\n    25: '#FFFFFF',\n    50: '#FAFAFA',\n    100: '#F5F5F5',\n    200: '#E9EAEB',\n    300: '#D5D7DA',\n    400: '#A4A7AE',\n    500: '#717680',\n    600: '#535862',\n    700: '#414651',\n    800: '#252B37',\n    900: '#181D27',\n    1000: '#0A0D12',\n  },\n  error: {\n    100: '#FEF3F2',\n    500: '#C5271C',\n    800: '#D92D20',\n  },\n  warning: {\n    100: '#FFFAF2',\n    500: '#E9B550',\n    700: '#B88023',\n    800: '#B88023',\n  },\n  success: {\n    100: '#F3FAFB',\n    400: '#2BABAD',\n    500: '#0A8080',\n    800: '#005961',\n  },\n  info: {\n    100: '#F4F4F3',\n    500: '#DCDCDC',\n    800: '#1C1C1C',\n  },\n}\n\nexport const transitionDuration = 200\n\nconst defaultThemeColors = {\n  colorBody: baseColors.neutral[25],\n  colorBodyAccent: baseColors.neutral[100],\n  colorBodyContent: baseColors.neutral[1000],\n  colorBodySubContent: baseColors.neutral[700],\n  colorPrimary: baseColors.neutral[1000],\n  colorPrimaryAccent: baseColors.neutral[900],\n  colorPrimaryContent: baseColors.neutral[100],\n  colorSecondary: baseColors.neutral[25],\n  colorSecondaryAccent: baseColors.neutral[100],\n  colorSecondaryContent: baseColors.neutral[600],\n  colorInfo: baseColors.info[100],\n  colorInfoAccent: baseColors.info[500],\n  colorInfoContent: baseColors.info[800],\n  colorWarning: baseColors.warning[100],\n  colorWarningAccent: baseColors.warning[500],\n  colorWarningContent: baseColors.warning[800],\n  colorError: baseColors.error[100],\n  colorErrorAccent: baseColors.error[500],\n  colorErrorContent: baseColors.error[800],\n  colorSuccess: baseColors.success[100],\n  colorSuccessAccent: baseColors.success[500],\n  colorSuccessContent: baseColors.success[800],\n  colorBorderPrimary: baseColors.neutral[300],\n  colorBorderSecondary: baseColors.neutral[200],\n  colorButtonIcon: baseColors.neutral[400],\n}\n\nexport type GustoSDKThemeColors = Partial<typeof defaultThemeColors>\n\nexport const createTheme = (colors: GustoSDKThemeColors = {}) => {\n  return {\n    // Colors\n    ...defaultThemeColors,\n    ...colors,\n    // Input Colors\n    inputBackgroundColor: colors.colorBody,\n    inputBorderColor: baseColors.neutral[300],\n    inputContentColor: colors.colorBodyContent,\n    inputBorderWidth: '1px',\n    inputPlaceholderColor: colors.colorBodySubContent,\n    inputAdornmentColor: colors.colorBodySubContent,\n    inputDisabledBackgroundColor: colors.colorBodyAccent,\n    // Field Colors\n    inputLabelColor: colors.colorBodyContent,\n    inputLabelFontSize: toRem(16),\n    inputLabelFontWeight: '500',\n    inputDescriptionColor: colors.colorBodySubContent,\n    inputErrorColor: colors.colorErrorAccent,\n    // Radius\n    inputRadius: toRem(8),\n    buttonRadius: toRem(8),\n    cardRadius: toRem(8),\n    badgeRadius: toRem(6),\n    bannerRadius: toRem(8),\n    boxRadius: toRem(8),\n    // Font\n    fontSizeRoot: getRootFontSize(),\n    fontFamily: 'system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif',\n    fontLineHeightLarge: toRem(28),\n    fontLineHeightRegular: toRem(24),\n    fontLineHeightSmall: toRem(20),\n    fontLineHeightExtraSmall: toRem(18),\n    fontSizeExtraSmall: toRem(12),\n    fontSizeSmall: toRem(14),\n    fontSizeRegular: toRem(16),\n    fontSizeLarge: toRem(18),\n    fontSizeHeading1: toRem(32),\n    fontSizeHeading2: toRem(24),\n    fontSizeHeading3: toRem(20),\n    fontSizeHeading4: toRem(18),\n    fontSizeHeading5: toRem(16),\n    fontSizeHeading6: toRem(14),\n    fontWeightRegular: '400',\n    fontWeightMedium: '500',\n    fontWeightSemibold: '600',\n    fontWeightBold: '700',\n    // Transitions\n    transitionDuration: `${transitionDuration}ms`,\n    // Shadows\n    shadowResting: '0px 1px 2px 0px rgba(10, 13, 18, 0.05)',\n    shadowTopmost:\n      '0px 4px 6px 0px rgba(28, 28, 28, 0.05), 0px 10px 15px 0px rgba(28, 28, 28, 0.10)',\n    // Focus\n    focusRingColor: colors.colorPrimary,\n    focusRingWidth: '2px',\n  }\n}\n\nexport type GustoSDKTheme = Partial<ReturnType<typeof createTheme>>\n\nexport const mergePartnerTheme = (partnerTheme: GustoSDKTheme): GustoSDKTheme => {\n  const colors = Object.entries(defaultThemeColors).reduce(\n    (acc: GustoSDKThemeColors, [key, value]) => {\n      acc[key as keyof typeof defaultThemeColors] =\n        partnerTheme[key as keyof typeof defaultThemeColors] || value\n      return acc\n    },\n    {},\n  )\n\n  const theme = createTheme(colors)\n\n  return {\n    ...theme,\n    ...partnerTheme,\n  }\n}\n"],"names":["baseColors","transitionDuration","defaultThemeColors","createTheme","colors","toRem","getRootFontSize","mergePartnerTheme","partnerTheme","acc","key","value"],"mappings":"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"}
+{"version":3,"file":"theme.js","sources":["../../../src/contexts/ThemeProvider/theme.ts"],"sourcesContent":["import type { GustoSDKTheme, GustoSDKThemeColors } from './types'\nimport { getRootFontSize, toRem } from '@/helpers/rem'\n\nexport type { GustoSDKTheme, GustoSDKThemeColors }\n\n// Colors are for internal use in our theme currently\n// We don't export them for partner use or overrides\nconst baseColors = {\n  neutral: {\n    25: '#FFFFFF',\n    50: '#FAFAFA',\n    100: '#F5F5F5',\n    200: '#E9EAEB',\n    300: '#D5D7DA',\n    400: '#A4A7AE',\n    500: '#717680',\n    600: '#535862',\n    700: '#414651',\n    800: '#252B37',\n    900: '#181D27',\n    1000: '#0A0D12',\n  },\n  error: {\n    100: '#FEF3F2',\n    500: '#C5271C',\n    800: '#D92D20',\n  },\n  warning: {\n    100: '#FFFAF2',\n    500: '#E9B550',\n    700: '#B88023',\n    800: '#B88023',\n  },\n  success: {\n    100: '#F3FAFB',\n    400: '#2BABAD',\n    500: '#0A8080',\n    800: '#005961',\n  },\n  info: {\n    100: '#F4F4F3',\n    500: '#DCDCDC',\n    800: '#1C1C1C',\n  },\n}\n\n/** @internal */\nexport const transitionDuration = 200\n\nconst defaultThemeColors: GustoSDKThemeColors = {\n  colorBody: baseColors.neutral[25],\n  colorBodyAccent: baseColors.neutral[100],\n  colorBodyContent: baseColors.neutral[1000],\n  colorBodySubContent: baseColors.neutral[700],\n  colorPrimary: baseColors.neutral[1000],\n  colorPrimaryAccent: baseColors.neutral[900],\n  colorPrimaryContent: baseColors.neutral[100],\n  colorSecondary: baseColors.neutral[25],\n  colorSecondaryAccent: baseColors.neutral[100],\n  colorSecondaryContent: baseColors.neutral[600],\n  colorInfo: baseColors.info[100],\n  colorInfoAccent: baseColors.info[500],\n  colorInfoContent: baseColors.info[800],\n  colorWarning: baseColors.warning[100],\n  colorWarningAccent: baseColors.warning[500],\n  colorWarningContent: baseColors.warning[800],\n  colorError: baseColors.error[100],\n  colorErrorAccent: baseColors.error[500],\n  colorErrorContent: baseColors.error[800],\n  colorSuccess: baseColors.success[100],\n  colorSuccessAccent: baseColors.success[500],\n  colorSuccessContent: baseColors.success[800],\n  colorBorderPrimary: baseColors.neutral[300],\n  colorBorderSecondary: baseColors.neutral[200],\n  colorButtonIcon: baseColors.neutral[400],\n}\n\n/** @internal */\nexport const createTheme = (colors: Partial<GustoSDKThemeColors> = {}): GustoSDKTheme => {\n  const mergedColors = { ...defaultThemeColors, ...colors }\n\n  return {\n    ...mergedColors,\n    inputBackgroundColor: mergedColors.colorBody,\n    inputBorderColor: baseColors.neutral[300],\n    inputContentColor: mergedColors.colorBodyContent,\n    inputBorderWidth: '1px',\n    inputPlaceholderColor: mergedColors.colorBodySubContent,\n    inputAdornmentColor: mergedColors.colorBodySubContent,\n    inputDisabledBackgroundColor: mergedColors.colorBodyAccent,\n    inputLabelColor: mergedColors.colorBodyContent,\n    inputLabelFontSize: toRem(16),\n    inputLabelFontWeight: '500',\n    inputDescriptionColor: mergedColors.colorBodySubContent,\n    inputErrorColor: mergedColors.colorErrorAccent,\n    inputRadius: toRem(8),\n    buttonRadius: toRem(8),\n    cardRadius: toRem(8),\n    badgeRadius: toRem(6),\n    bannerRadius: toRem(8),\n    boxRadius: toRem(8),\n    fontSizeRoot: getRootFontSize(),\n    fontFamily: 'system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif',\n    fontLineHeightLarge: toRem(28),\n    fontLineHeightRegular: toRem(24),\n    fontLineHeightSmall: toRem(20),\n    fontLineHeightExtraSmall: toRem(18),\n    fontSizeExtraSmall: toRem(12),\n    fontSizeSmall: toRem(14),\n    fontSizeRegular: toRem(16),\n    fontSizeLarge: toRem(18),\n    fontSizeHeading1: toRem(32),\n    fontSizeHeading2: toRem(24),\n    fontSizeHeading3: toRem(20),\n    fontSizeHeading4: toRem(18),\n    fontSizeHeading5: toRem(16),\n    fontSizeHeading6: toRem(14),\n    fontWeightRegular: '400',\n    fontWeightMedium: '500',\n    fontWeightSemibold: '600',\n    fontWeightBold: '700',\n    transitionDuration: `${transitionDuration}ms`,\n    shadowResting: '0px 1px 2px 0px rgba(10, 13, 18, 0.05)',\n    shadowTopmost:\n      '0px 4px 6px 0px rgba(28, 28, 28, 0.05), 0px 10px 15px 0px rgba(28, 28, 28, 0.10)',\n    focusRingColor: mergedColors.colorPrimary,\n    focusRingWidth: '2px',\n  }\n}\n\n/** @internal */\nexport const mergePartnerTheme = (partnerTheme: Partial<GustoSDKTheme>): GustoSDKTheme => {\n  const colors = Object.entries(defaultThemeColors).reduce(\n    (acc, [key, value]) => {\n      acc[key as keyof GustoSDKThemeColors] =\n        partnerTheme[key as keyof GustoSDKThemeColors] || value\n      return acc\n    },\n    { ...defaultThemeColors },\n  )\n\n  return {\n    ...createTheme(colors),\n    ...partnerTheme,\n  }\n}\n"],"names":["baseColors","transitionDuration","defaultThemeColors","createTheme","colors","mergedColors","toRem","getRootFontSize","mergePartnerTheme","partnerTheme","acc","key","value"],"mappings":"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"}

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

@@ -0,0 +1,181 @@
+/**
+ * Color tokens that can be overridden to customize the SDK's visual theme.
+ * Pass a `Partial<GustoSDKThemeColors>` when constructing a `Partial<GustoSDKTheme>`
+ * to supply to `ThemeProvider`.
+ *
+ * @public
+ */
+export interface GustoSDKThemeColors {
+    /** Background color of the main content area. */
+    colorBody: string;
+    /** Subtle accent background, used for hover states and alternating rows. */
+    colorBodyAccent: string;
+    /** Primary text color rendered on body backgrounds. */
+    colorBodyContent: string;
+    /** Secondary/muted text color for supporting copy and labels. */
+    colorBodySubContent: string;
+    /** Brand primary color, used for primary buttons and active states. */
+    colorPrimary: string;
+    /** Hover/pressed tint for primary elements. */
+    colorPrimaryAccent: string;
+    /** Text or icon color rendered on primary backgrounds. */
+    colorPrimaryContent: string;
+    /** Brand secondary color, used for secondary buttons and surfaces. */
+    colorSecondary: string;
+    /** Hover/pressed tint for secondary elements. */
+    colorSecondaryAccent: string;
+    /** Text or icon color rendered on secondary backgrounds. */
+    colorSecondaryContent: string;
+    /** Background for informational banners and callouts. */
+    colorInfo: string;
+    /** Border or icon accent inside informational surfaces. */
+    colorInfoAccent: string;
+    /** Text color rendered on informational surfaces. */
+    colorInfoContent: string;
+    /** Background for warning banners and callouts. */
+    colorWarning: string;
+    /** Border or icon accent inside warning surfaces. */
+    colorWarningAccent: string;
+    /** Text color rendered on warning surfaces. */
+    colorWarningContent: string;
+    /** Background for error banners and inline validation states. */
+    colorError: string;
+    /** Border, icon accent, and field error indicator inside error surfaces. */
+    colorErrorAccent: string;
+    /** Text color rendered on error surfaces. */
+    colorErrorContent: string;
+    /** Background for success banners and confirmation states. */
+    colorSuccess: string;
+    /** Border or icon accent inside success surfaces. */
+    colorSuccessAccent: string;
+    /** Text color rendered on success surfaces. */
+    colorSuccessContent: string;
+    /** Color of primary borders (inputs, cards, dividers). */
+    colorBorderPrimary: string;
+    /** Color of secondary/subtle borders. */
+    colorBorderSecondary: string;
+    /** Color of icon-only buttons. */
+    colorButtonIcon: string;
+}
+/**
+ * Complete set of design tokens that control the SDK's visual theme. Pass a
+ * `Partial<GustoSDKTheme>` to `ThemeProvider` to override specific tokens; any
+ * token not supplied falls back to the SDK default.
+ *
+ * @public
+ */
+export interface GustoSDKTheme extends GustoSDKThemeColors {
+    /**
+     * Background color of text inputs and selects.
+     * @defaultValue `colorBody`
+     */
+    inputBackgroundColor: string;
+    /** Border color of text inputs and selects. */
+    inputBorderColor: string;
+    /**
+     * Text color inside text inputs and selects.
+     * @defaultValue `colorBodyContent`
+     */
+    inputContentColor: string;
+    /** Border width of text inputs and selects. */
+    inputBorderWidth: string;
+    /**
+     * Placeholder text color inside inputs.
+     * @defaultValue `colorBodySubContent`
+     */
+    inputPlaceholderColor: string;
+    /**
+     * Color of leading/trailing adornment icons in inputs.
+     * @defaultValue `colorBodySubContent`
+     */
+    inputAdornmentColor: string;
+    /**
+     * Background color of disabled inputs.
+     * @defaultValue `colorBodyAccent`
+     */
+    inputDisabledBackgroundColor: string;
+    /**
+     * Color of form field labels.
+     * @defaultValue `colorBodyContent`
+     */
+    inputLabelColor: string;
+    /** Font size of form field labels. */
+    inputLabelFontSize: string;
+    /** Font weight of form field labels. */
+    inputLabelFontWeight: string;
+    /**
+     * Color of form field description/hint text.
+     * @defaultValue `colorBodySubContent`
+     */
+    inputDescriptionColor: string;
+    /**
+     * Color of inline field error messages.
+     * @defaultValue `colorErrorAccent`
+     */
+    inputErrorColor: string;
+    /** Border radius of text inputs and selects. */
+    inputRadius: string;
+    /** Border radius of buttons. */
+    buttonRadius: string;
+    /** Border radius of card surfaces. */
+    cardRadius: string;
+    /** Border radius of badges. */
+    badgeRadius: string;
+    /** Border radius of banners. */
+    bannerRadius: string;
+    /** Border radius of box/panel surfaces. */
+    boxRadius: string;
+    /** Root document font size as a numeric string (no `px` suffix). Used as the rem base. */
+    fontSizeRoot: string;
+    /** Font family stack applied to all SDK text. */
+    fontFamily: string;
+    /** Line height for large text. */
+    fontLineHeightLarge: string;
+    /** Line height for regular/body text. */
+    fontLineHeightRegular: string;
+    /** Line height for small text. */
+    fontLineHeightSmall: string;
+    /** Line height for extra-small text. */
+    fontLineHeightExtraSmall: string;
+    /** Font size for extra-small text. */
+    fontSizeExtraSmall: string;
+    /** Font size for small text. */
+    fontSizeSmall: string;
+    /** Font size for regular/body text. */
+    fontSizeRegular: string;
+    /** Font size for large text. */
+    fontSizeLarge: string;
+    /** Font size for H1 headings. */
+    fontSizeHeading1: string;
+    /** Font size for H2 headings. */
+    fontSizeHeading2: string;
+    /** Font size for H3 headings. */
+    fontSizeHeading3: string;
+    /** Font size for H4 headings. */
+    fontSizeHeading4: string;
+    /** Font size for H5 headings. */
+    fontSizeHeading5: string;
+    /** Font size for H6 headings. */
+    fontSizeHeading6: string;
+    /** Font weight for regular text. */
+    fontWeightRegular: string;
+    /** Font weight for medium-emphasis text. */
+    fontWeightMedium: string;
+    /** Font weight for semibold text. */
+    fontWeightSemibold: string;
+    /** Font weight for bold text. */
+    fontWeightBold: string;
+    /** Duration of UI transitions, e.g. `"200ms"`. */
+    transitionDuration: string;
+    /** Box shadow for resting/default elevation. */
+    shadowResting: string;
+    /** Box shadow for elevated/topmost surfaces such as dropdowns and modals. */
+    shadowTopmost: string;
+    /**
+     * Color of the keyboard focus ring.
+     * @defaultValue `colorPrimary`
+     */
+    focusRingColor: string;
+    /** Width of the keyboard focus ring. */
+    focusRingWidth: string;
+}

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

@@ -1,5 +1,9 @@
+/** @internal */
 export interface ThemeContextProps {
+    /** Ref to the element used as the portal container for SDK overlays. */
     container: React.RefObject<HTMLElement | null>;
 }
+/** @internal */
 export declare const ThemeContext: import('react').Context<ThemeContextProps>;
+/** @internal */
 export declare const useTheme: () => ThemeContextProps;

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

@@ -1 +1 @@
-{"version":3,"file":"useTheme.js","sources":["../../../src/contexts/ThemeProvider/useTheme.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\n\nexport interface ThemeContextProps {\n  container: React.RefObject<HTMLElement | null>\n}\nexport const ThemeContext = createContext({} as ThemeContextProps)\n\nexport const useTheme = () => useContext(ThemeContext)\n"],"names":["ThemeContext","createContext","useTheme","useContext"],"mappings":";AAKO,MAAMA,IAAeC,EAAc,CAAA,CAAuB,GAEpDC,IAAW,MAAMC,EAAWH,CAAY;"}
+{"version":3,"file":"useTheme.js","sources":["../../../src/contexts/ThemeProvider/useTheme.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\n\n/** @internal */\nexport interface ThemeContextProps {\n  /** Ref to the element used as the portal container for SDK overlays. */\n  container: React.RefObject<HTMLElement | null>\n}\n/** @internal */\nexport const ThemeContext = createContext({} as ThemeContextProps)\n\n/** @internal */\nexport const useTheme = () => useContext(ThemeContext)\n"],"names":["ThemeContext","createContext","useTheme","useContext"],"mappings":";AAQO,MAAMA,IAAeC,EAAc,CAAA,CAAuB,GAGpDC,IAAW,MAAMC,EAAWH,CAAY;"}

package/dist/contexts/index.d.ts

@@ -8,4 +8,5 @@ export type { ApiProviderProps } from './ApiProvider/ApiProvider';
 export type { ComponentsContextType } from './ComponentAdapter/useComponentContext';
 export * from './ComponentAdapter/componentAdapterTypes';
 export { ObservabilityProvider, useObservability } from './ObservabilityProvider';
-export type { ObservabilityProviderProps } from './ObservabilityProvider';
+export type { ObservabilityProviderProps, ObservabilityContextValue } from './ObservabilityProvider';
+export type { GustoSDKTheme, GustoSDKThemeColors } from './ThemeProvider/theme';

package/dist/helpers/LRUCache.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Least-recently-used cache keyed by string with thunk values producing translation tables.
+ *
+ * @remarks Backs the i18n translation cache so loaded language bundles can be evicted in
+ * insertion-recency order once the configured capacity is reached. Reading or writing a key
+ * promotes it to the most-recently-used position.
+ *
+ * @internal
+ */
 export declare class LRUCache {
     capacity: number;
     map: Map<string, () => Record<string, string>>;

package/dist/helpers/LRUCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"LRUCache.js","sources":["../../src/helpers/LRUCache.ts"],"sourcesContent":["export class LRUCache {\n  capacity: number\n  map: Map<string, () => Record<string, string>>\n\n  constructor(capacity: number) {\n    this.capacity = capacity\n    this.map = new Map()\n  }\n\n  get(key: string): (() => Record<string, string>) | null {\n    const value = this.map.get(key)\n    if (value === undefined) return null\n\n    // Small hack to re-order keys: we remove the requested key and place it at the end\n    this.map.delete(key)\n    this.map.set(key, value)\n\n    return value\n  }\n\n  put(key: string, value: () => Record<string, string>): void {\n    // remove last element to avoid overflow, only if it does not have\n    // the inserted key is a new key\n    if (this.map.size >= this.capacity && !this.map.has(key)) {\n      const firstKey = this.map.keys().next().value as string\n      this.map.delete(firstKey)\n    }\n\n    // Small hack to re-order keys: we remove the requested key and place it at the end\n    this.map.delete(key)\n    this.map.set(key, value)\n  }\n}\n"],"names":["LRUCache","capacity","key","value","firstKey"],"mappings":"AAAO,MAAMA,EAAS;AAAA,EACpB;AAAA,EACA;AAAA,EAEA,YAAYC,GAAkB;AAC5B,SAAK,WAAWA,GAChB,KAAK,0BAAU,IAAA;AAAA,EACjB;AAAA,EAEA,IAAIC,GAAoD;AACtD,UAAMC,IAAQ,KAAK,IAAI,IAAID,CAAG;AAC9B,WAAIC,MAAU,SAAkB,QAGhC,KAAK,IAAI,OAAOD,CAAG,GACnB,KAAK,IAAI,IAAIA,GAAKC,CAAK,GAEhBA;AAAA,EACT;AAAA,EAEA,IAAID,GAAaC,GAA2C;AAG1D,QAAI,KAAK,IAAI,QAAQ,KAAK,YAAY,CAAC,KAAK,IAAI,IAAID,CAAG,GAAG;AACxD,YAAME,IAAW,KAAK,IAAI,KAAA,EAAO,OAAO;AACxC,WAAK,IAAI,OAAOA,CAAQ;AAAA,IAC1B;AAGA,SAAK,IAAI,OAAOF,CAAG,GACnB,KAAK,IAAI,IAAIA,GAAKC,CAAK;AAAA,EACzB;AACF;"}
+{"version":3,"file":"LRUCache.js","sources":["../../src/helpers/LRUCache.ts"],"sourcesContent":["/**\n * Least-recently-used cache keyed by string with thunk values producing translation tables.\n *\n * @remarks Backs the i18n translation cache so loaded language bundles can be evicted in\n * insertion-recency order once the configured capacity is reached. Reading or writing a key\n * promotes it to the most-recently-used position.\n *\n * @internal\n */\nexport class LRUCache {\n  capacity: number\n  map: Map<string, () => Record<string, string>>\n\n  constructor(capacity: number) {\n    this.capacity = capacity\n    this.map = new Map()\n  }\n\n  get(key: string): (() => Record<string, string>) | null {\n    const value = this.map.get(key)\n    if (value === undefined) return null\n\n    // Small hack to re-order keys: we remove the requested key and place it at the end\n    this.map.delete(key)\n    this.map.set(key, value)\n\n    return value\n  }\n\n  put(key: string, value: () => Record<string, string>): void {\n    // remove last element to avoid overflow, only if it does not have\n    // the inserted key is a new key\n    if (this.map.size >= this.capacity && !this.map.has(key)) {\n      const firstKey = this.map.keys().next().value as string\n      this.map.delete(firstKey)\n    }\n\n    // Small hack to re-order keys: we remove the requested key and place it at the end\n    this.map.delete(key)\n    this.map.set(key, value)\n  }\n}\n"],"names":["LRUCache","capacity","key","value","firstKey"],"mappings":"AASO,MAAMA,EAAS;AAAA,EACpB;AAAA,EACA;AAAA,EAEA,YAAYC,GAAkB;AAC5B,SAAK,WAAWA,GAChB,KAAK,0BAAU,IAAA;AAAA,EACjB;AAAA,EAEA,IAAIC,GAAoD;AACtD,UAAMC,IAAQ,KAAK,IAAI,IAAID,CAAG;AAC9B,WAAIC,MAAU,SAAkB,QAGhC,KAAK,IAAI,OAAOD,CAAG,GACnB,KAAK,IAAI,IAAIA,GAAKC,CAAK,GAEhBA;AAAA,EACT;AAAA,EAEA,IAAID,GAAaC,GAA2C;AAG1D,QAAI,KAAK,IAAI,QAAQ,KAAK,YAAY,CAAC,KAAK,IAAI,IAAID,CAAG,GAAG;AACxD,YAAME,IAAW,KAAK,IAAI,KAAA,EAAO,OAAO;AACxC,WAAK,IAAI,OAAOA,CAAQ;AAAA,IAC1B;AAGA,SAAK,IAAI,OAAOF,CAAG,GACnB,KAAK,IAAI,IAAIA,GAAKC,CAAK;AAAA,EACzB;AACF;"}

package/dist/helpers/apiErrorToList.d.ts

@@ -1,7 +1,23 @@
-import { EntityErrorObject } from '@gusto/embedded-api/models/components/entityerrorobject';
-/**Traverses errorList and finds items with message properties */
+import { EntityErrorObject } from '@gusto/embedded-api-v-2025-11-15/models/components/entityerrorobject';
+/**
+ * Renders each error in the list that carries a `message` as a `<span>` keyed by `errorKey`.
+ *
+ * @param errorList - Flat list of entity errors returned by the API.
+ * @returns React nodes for messaged entries; entries without a message yield `null`.
+ * @internal
+ */
 export declare const renderErrorList: (errorList: Array<EntityErrorObject>) => React.ReactNode[];
-/**Recuresively parses error list and constructs an array of objects containing attribute value error messages associated with form fields. Nested errors construct '.' separated keys
- * metadata.state is a special case for state taxes validation errors
+/**
+ * Recursively flattens a nested API error tree into a list keyed for form-field display.
+ *
+ * @remarks Builds dot-separated `errorKey` paths from nested errors and converts each segment
+ * from snake_case to camelCase so the resulting keys match react-hook-form field names.
+ * `metadata.key` is used as the path segment for nested errors when present; `metadata.state`
+ * is a special case for state-tax validation errors, falling back to the node's own `errorKey`.
+ *
+ * @param error - The root entity error to flatten.
+ * @param parentKey - Accumulated dot-path prefix used during recursion. Omit at the top level.
+ * @returns A flat list of `{ errorKey, message, category }` entries ready to bind to form fields.
+ * @internal
  */
 export declare const getFieldErrors: (error: EntityErrorObject, parentKey?: string) => Array<EntityErrorObject>;

package/dist/helpers/apiErrorToList.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiErrorToList.js","sources":["../../src/helpers/apiErrorToList.tsx"],"sourcesContent":["import type { EntityErrorObject } from '@gusto/embedded-api/models/components/entityerrorobject'\nimport { snakeCaseToCamelCase } from './formattedStrings'\n\n/**Traverses errorList and finds items with message properties */\nexport const renderErrorList = (errorList: Array<EntityErrorObject>): React.ReactNode[] => {\n  return errorList.map(errorFromList => {\n    if (errorFromList.message) {\n      return <span key={errorFromList.errorKey}>{errorFromList.message}</span>\n    }\n    return null\n  })\n}\n/**Recuresively parses error list and constructs an array of objects containing attribute value error messages associated with form fields. Nested errors construct '.' separated keys\n * metadata.state is a special case for state taxes validation errors\n */\nexport const getFieldErrors = (\n  error: EntityErrorObject,\n  parentKey?: string,\n): Array<EntityErrorObject> => {\n  const keyPrefix = parentKey ? parentKey + '.' : ''\n  if (error.category === 'invalid_attribute_value' || error.category === 'invalid_operation') {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message ?? '',\n        category: error.category,\n      },\n    ]\n  }\n  if (error.category === 'nested_errors' && error.errors !== undefined) {\n    //TODO: clean this up once Metadata type is fixed in openapi spec\n    let keySuffix = ''\n    //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    if (error.metadata?.key && typeof error.metadata.key === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.key as string\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    } else if (error.metadata?.state && typeof error.metadata.state === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.state as string\n    } else if (error.errorKey) {\n      keySuffix = error.errorKey\n    }\n    return error.errors.flatMap(err => getFieldErrors(err, keyPrefix + keySuffix))\n  }\n  if (error.message) {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message,\n        category: error.category,\n      },\n    ]\n  }\n  return []\n}\n"],"names":["renderErrorList","errorList","errorFromList","jsx","getFieldErrors","error","parentKey","keyPrefix","snakeCaseToCamelCase","keySuffix","err"],"mappings":";;AAIO,MAAMA,IAAkB,CAACC,MACvBA,EAAU,IAAI,CAAAC,MACfA,EAAc,UACT,gBAAAC,EAAC,QAAA,EAAmC,UAAAD,EAAc,QAAA,GAAvCA,EAAc,QAAiC,IAE5D,IACR,GAKUE,IAAiB,CAC5BC,GACAC,MAC6B;AAC7B,QAAMC,IAAYD,IAAYA,IAAY,MAAM;AAChD,MAAID,EAAM,aAAa,6BAA6BA,EAAM,aAAa;AACrE,WAAO;AAAA,MACL;AAAA,QACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,QACzD,SAASA,EAAM,WAAW;AAAA,QAC1B,UAAUA,EAAM;AAAA,MAAA;AAAA,IAClB;AAGJ,MAAIA,EAAM,aAAa,mBAAmBA,EAAM,WAAW,QAAW;AAEpE,QAAII,IAAY;AAEhB,WAAIJ,EAAM,UAAU,OAAO,OAAOA,EAAM,SAAS,OAAQ,WAEvDI,IAAYJ,EAAM,SAAS,MAElBA,EAAM,UAAU,SAAS,OAAOA,EAAM,SAAS,SAAU,WAElEI,IAAYJ,EAAM,SAAS,QAClBA,EAAM,aACfI,IAAYJ,EAAM,WAEbA,EAAM,OAAO,QAAQ,CAAAK,MAAON,EAAeM,GAAKH,IAAYE,CAAS,CAAC;AAAA,EAC/E;AACA,SAAIJ,EAAM,UACD;AAAA,IACL;AAAA,MACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,MACzD,SAASA,EAAM;AAAA,MACf,UAAUA,EAAM;AAAA,IAAA;AAAA,EAClB,IAGG,CAAA;AACT;"}
+{"version":3,"file":"apiErrorToList.js","sources":["../../src/helpers/apiErrorToList.tsx"],"sourcesContent":["import type { EntityErrorObject } from '@gusto/embedded-api-v-2025-11-15/models/components/entityerrorobject'\nimport { snakeCaseToCamelCase } from './formattedStrings'\n\n/**\n * Renders each error in the list that carries a `message` as a `<span>` keyed by `errorKey`.\n *\n * @param errorList - Flat list of entity errors returned by the API.\n * @returns React nodes for messaged entries; entries without a message yield `null`.\n * @internal\n */\nexport const renderErrorList = (errorList: Array<EntityErrorObject>): React.ReactNode[] => {\n  return errorList.map(errorFromList => {\n    if (errorFromList.message) {\n      return <span key={errorFromList.errorKey}>{errorFromList.message}</span>\n    }\n    return null\n  })\n}\n/**\n * Recursively flattens a nested API error tree into a list keyed for form-field display.\n *\n * @remarks Builds dot-separated `errorKey` paths from nested errors and converts each segment\n * from snake_case to camelCase so the resulting keys match react-hook-form field names.\n * `metadata.key` is used as the path segment for nested errors when present; `metadata.state`\n * is a special case for state-tax validation errors, falling back to the node's own `errorKey`.\n *\n * @param error - The root entity error to flatten.\n * @param parentKey - Accumulated dot-path prefix used during recursion. Omit at the top level.\n * @returns A flat list of `{ errorKey, message, category }` entries ready to bind to form fields.\n * @internal\n */\nexport const getFieldErrors = (\n  error: EntityErrorObject,\n  parentKey?: string,\n): Array<EntityErrorObject> => {\n  const keyPrefix = parentKey ? parentKey + '.' : ''\n  if (error.category === 'invalid_attribute_value' || error.category === 'invalid_operation') {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message ?? '',\n        category: error.category,\n      },\n    ]\n  }\n  if (error.category === 'nested_errors' && error.errors !== undefined) {\n    //TODO: clean this up once Metadata type is fixed in openapi spec\n    let keySuffix = ''\n    //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    if (error.metadata?.key && typeof error.metadata.key === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.key as string\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    } else if (error.metadata?.state && typeof error.metadata.state === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.state as string\n    } else if (error.errorKey) {\n      keySuffix = error.errorKey\n    }\n    return error.errors.flatMap(err => getFieldErrors(err, keyPrefix + keySuffix))\n  }\n  if (error.message) {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message,\n        category: error.category,\n      },\n    ]\n  }\n  return []\n}\n"],"names":["renderErrorList","errorList","errorFromList","jsx","getFieldErrors","error","parentKey","keyPrefix","snakeCaseToCamelCase","keySuffix","err"],"mappings":";;AAUO,MAAMA,IAAkB,CAACC,MACvBA,EAAU,IAAI,CAAAC,MACfA,EAAc,UACT,gBAAAC,EAAC,QAAA,EAAmC,UAAAD,EAAc,QAAA,GAAvCA,EAAc,QAAiC,IAE5D,IACR,GAeUE,IAAiB,CAC5BC,GACAC,MAC6B;AAC7B,QAAMC,IAAYD,IAAYA,IAAY,MAAM;AAChD,MAAID,EAAM,aAAa,6BAA6BA,EAAM,aAAa;AACrE,WAAO;AAAA,MACL;AAAA,QACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,QACzD,SAASA,EAAM,WAAW;AAAA,QAC1B,UAAUA,EAAM;AAAA,MAAA;AAAA,IAClB;AAGJ,MAAIA,EAAM,aAAa,mBAAmBA,EAAM,WAAW,QAAW;AAEpE,QAAII,IAAY;AAEhB,WAAIJ,EAAM,UAAU,OAAO,OAAOA,EAAM,SAAS,OAAQ,WAEvDI,IAAYJ,EAAM,SAAS,MAElBA,EAAM,UAAU,SAAS,OAAOA,EAAM,SAAS,SAAU,WAElEI,IAAYJ,EAAM,SAAS,QAClBA,EAAM,aACfI,IAAYJ,EAAM,WAEbA,EAAM,OAAO,QAAQ,CAAAK,MAAON,EAAeM,GAAKH,IAAYE,CAAS,CAAC;AAAA,EAC/E;AACA,SAAIJ,EAAM,UACD;AAAA,IACL;AAAA,MACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,MACzD,SAASA,EAAM;AAAA,MACf,UAAUA,EAAM;AAAA,IAAA;AAAA,EAClB,IAGG,CAAA;AACT;"}

package/dist/helpers/applyMissingDefaults.d.ts

@@ -1,5 +1,14 @@
 /**
- * Applies default values only to properties that are undefined in the source object.
- * This is more efficient than object spread as it only sets values that are actually missing.
+ * Returns a copy of `rawProps` with `defaults` filled in only where the source value is `undefined`.
+ *
+ * @remarks Cheaper than `{ ...defaults, ...rawProps }` because it copies the source once and only
+ * writes the keys that are actually missing. Properties explicitly set to `null` or `false` are
+ * preserved as-is.
+ *
+ * @typeParam T - Shape of the props object.
+ * @param rawProps - Caller-supplied props; values set here always win.
+ * @param defaults - Fallback values applied only when the corresponding `rawProps` value is `undefined`.
+ * @returns A new object combining `rawProps` with defaults filled in for missing keys.
+ * @internal
  */
 export declare function applyMissingDefaults<T>(rawProps: T, defaults: Partial<T>): T;

package/dist/helpers/applyMissingDefaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"applyMissingDefaults.js","sources":["../../src/helpers/applyMissingDefaults.ts"],"sourcesContent":["/**\n * Applies default values only to properties that are undefined in the source object.\n * This is more efficient than object spread as it only sets values that are actually missing.\n */\nexport function applyMissingDefaults<T>(rawProps: T, defaults: Partial<T>): T {\n  const result = { ...rawProps }\n\n  for (const key in defaults) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    if ((rawProps as any)[key] === undefined && defaults[key] !== undefined) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(result as any)[key] = defaults[key]\n    }\n  }\n\n  return result\n}\n"],"names":["applyMissingDefaults","rawProps","defaults","result","key"],"mappings":"AAIO,SAASA,EAAwBC,GAAaC,GAAyB;AAC5E,QAAMC,IAAS,EAAE,GAAGF,EAAA;AAEpB,aAAWG,KAAOF;AAEhB,IAAKD,EAAiBG,CAAG,MAAM,UAAaF,EAASE,CAAG,MAAM,WAE1DD,EAAeC,CAAG,IAAIF,EAASE,CAAG;AAIxC,SAAOD;AACT;"}
+{"version":3,"file":"applyMissingDefaults.js","sources":["../../src/helpers/applyMissingDefaults.ts"],"sourcesContent":["/**\n * Returns a copy of `rawProps` with `defaults` filled in only where the source value is `undefined`.\n *\n * @remarks Cheaper than `{ ...defaults, ...rawProps }` because it copies the source once and only\n * writes the keys that are actually missing. Properties explicitly set to `null` or `false` are\n * preserved as-is.\n *\n * @typeParam T - Shape of the props object.\n * @param rawProps - Caller-supplied props; values set here always win.\n * @param defaults - Fallback values applied only when the corresponding `rawProps` value is `undefined`.\n * @returns A new object combining `rawProps` with defaults filled in for missing keys.\n * @internal\n */\nexport function applyMissingDefaults<T>(rawProps: T, defaults: Partial<T>): T {\n  const result = { ...rawProps }\n\n  for (const key in defaults) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    if ((rawProps as any)[key] === undefined && defaults[key] !== undefined) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(result as any)[key] = defaults[key]\n    }\n  }\n\n  return result\n}\n"],"names":["applyMissingDefaults","rawProps","defaults","result","key"],"mappings":"AAaO,SAASA,EAAwBC,GAAaC,GAAyB;AAC5E,QAAMC,IAAS,EAAE,GAAGF,EAAA;AAEpB,aAAWG,KAAOF;AAEhB,IAAKD,EAAiBG,CAAG,MAAM,UAAaF,EAASE,CAAG,MAAM,WAE1DD,EAAeC,CAAG,IAAIF,EAASE,CAAG;AAIxC,SAAOD;AACT;"}

package/dist/helpers/breadcrumbHelpers.d.ts

@@ -9,50 +9,91 @@ type WithHeader = {
 /**
  * Builds a complete breadcrumb trail map from a hierarchical node structure.
  *
- * Takes a tree structure of breadcrumb nodes and generates a map where each state
- * has its complete breadcrumb trail from root to that state. This is useful for
- * initializing breadcrumb navigation in state machines or multi-step flows.
+ * @remarks Walks each node's `parent` pointer to assemble a root-to-state trail, producing
+ * one entry per state. Use it to seed breadcrumb navigation when initializing a state
+ * machine or multi-step flow.
+ *
+ * @param nodes - Map of state names to breadcrumb nodes, each carrying an `item` and an
+ * optional `parent` state key.
+ * @returns A map from state name to its ordered breadcrumb trail.
+ * @internal
  */
 export declare const buildBreadcrumbs: (nodes: BreadcrumbNodes) => BreadcrumbTrail;
 /**
  * Resolves template variables in breadcrumb labels using values from a context object.
  *
- * Supports Handlebars-style template syntax (`{{variableName}}`) for dynamic breadcrumb labels.
- * Variables enclosed in double braces are replaced with their corresponding values from the context.
- * Non-template strings are returned as-is.
+ * @remarks Supports Handlebars-style `{{variableName}}` syntax. Values enclosed in double
+ * braces are replaced with the corresponding key on `context`; missing keys resolve to an
+ * empty string. Strings without a template token are returned unchanged.
+ *
+ * @param variables - Map of variable names to either a literal or a `{{key}}` template.
+ * Pass `undefined` to skip resolution.
+ * @param context - Source values referenced by template tokens.
+ * @returns A map of variable names to resolved values, or an empty object when `variables`
+ * is `undefined`.
+ * @internal
  */
 export declare const resolveBreadcrumbVariables: (variables: Record<string, string> | undefined, context: Record<string, unknown>) => Record<string, unknown>;
 /**
- * Merges `patch` fields into the existing breadcrumbs header on a context,
- * preserving the existing trails and CTA. If the context has no breadcrumbs
- * header, a fresh one is created. Useful when a transition needs to flip
- * breadcrumbs visibility (`currentBreadcrumbId`) without rebuilding any
- * trails.
+ * Merges `patch` fields into the existing breadcrumbs header on a context.
+ *
+ * @remarks Preserves existing trails and CTA; if the context has no breadcrumbs header
+ * a fresh one is created. Use this when a transition needs to flip breadcrumb visibility
+ * (for example `currentBreadcrumbId`) without rebuilding any trails.
+ *
+ * @typeParam T - Context shape carrying an optional `header` of the discriminated union.
+ * @param context - The context whose breadcrumbs header should be patched.
+ * @param patch - Partial breadcrumbs-header fields to merge in. The `type` discriminator
+ * cannot be overridden.
+ * @returns A new context with the patched breadcrumbs header.
+ * @internal
  */
 export declare const patchBreadcrumbsHeader: <T extends WithHeader>(context: T, patch: Partial<Omit<BreadcrumbsHeader, "type">>) => T & {
     header: BreadcrumbsHeader;
 };
 /**
- * Removes a breadcrumb from all trails in the context's breadcrumbs header.
- * Use this in state machine reducers to hide a step entirely (e.g. after
- * payroll submission).
+ * Removes a breadcrumb from every trail in the context's breadcrumbs header.
+ *
+ * @remarks Use in state machine reducers to hide a step entirely, for example after
+ * payroll submission when the step should no longer appear in any trail.
+ *
+ * @typeParam T - Context shape carrying an optional `header` of the discriminated union.
+ * @param breadcrumbId - Id of the breadcrumb to strip from every trail.
+ * @param context - The context whose breadcrumbs header should be updated.
+ * @returns A new context with the breadcrumb removed from all trails.
+ * @internal
  */
 export declare const hideBreadcrumb: <T extends WithHeader>(breadcrumbId: string, context: T) => T;
 /**
- * Marks a breadcrumb as non-navigable across all trails in the context's
- * breadcrumbs header. Use this in state machine reducers to disable backward
- * navigation to a specific step.
+ * Marks a breadcrumb as non-navigable across every trail in the context's breadcrumbs header.
+ *
+ * @remarks Use in state machine reducers to disable backward navigation to a specific step
+ * while still showing it in the trail.
+ *
+ * @typeParam T - Context shape carrying an optional `header` of the discriminated union.
+ * @param breadcrumbId - Id of the breadcrumb to mark `isNavigable: false`.
+ * @param context - The context whose breadcrumbs header should be updated.
+ * @returns A new context with the breadcrumb locked in every trail.
+ * @internal
  */
 export declare const lockBreadcrumb: <T extends WithHeader>(breadcrumbId: string, context: T) => T;
 /**
- * Updates the breadcrumb trail for a specific state with resolved variables
- * and switches the active breadcrumb to that state.
- *
- * This function is typically used in state machine transitions to update
- * breadcrumb navigation when moving between states. It preserves all existing
- * breadcrumb trails for other states and only updates the trail for the
- * specified state by resolving any template variables for that state's
- * breadcrumb. The resulting context's header is always of type `'breadcrumbs'`.
+ * Updates the breadcrumb trail for a specific state with resolved variables and switches
+ * the active breadcrumb to that state.
+ *
+ * @remarks Typically called from state machine transitions to update breadcrumb navigation
+ * when moving between states. Existing trails for other states are preserved; only the trail
+ * for `stateName` is rewritten with `variables` resolved against the context. The resulting
+ * context's header is always of type `'breadcrumbs'`.
+ *
+ * @typeParam T - Context shape carrying an optional `header` of the discriminated union.
+ * @param stateName - The state whose breadcrumb trail should be updated and made active.
+ * @param context - The context whose breadcrumbs header should be updated.
+ * @param variables - Optional template variables to resolve against the context for each
+ * breadcrumb in the target state's trail.
+ * @returns A new context with the trail for `stateName` updated and `currentBreadcrumbId`
+ * set to `stateName`.
+ * @internal
  */
 export declare const updateBreadcrumbs: <T extends WithHeader>(stateName: string, context: T, variables?: Record<string, string>) => T & {
     header: BreadcrumbsHeader;