@gusto/embedded-react-sdk 0.41.0 → 0.42.0

package/dist/contexts/GustoProvider/GustoProviderCustomUIAdapter.js

@@ -7,20 +7,18 @@ import { ApiProvider as C } from "../ApiProvider/ApiProvider.js";
 import { LoadingIndicatorProvider as I } from "../LoadingIndicatorProvider/LoadingIndicatorProvider.js";
 import { sanitizeError as L } from "../ObservabilityProvider/sanitization.js";
 import { SDKI18next as m } from "./SDKI18next.js";
-import "../../shared/constants.js";
-import "classnames";
 import { InternalError as x } from "../../components/Common/InternalError/InternalError.js";
 import { LocaleProvider as z } from "../LocaleProvider/LocaleProvider.js";
 import "../LocaleProvider/useLocale.js";
 import { ThemeProvider as D } from "../ThemeProvider/ThemeProvider.js";
 import { normalizeToSDKError as U } from "../../types/sdkError.js";
 import { ObservabilityProvider as T } from "../ObservabilityProvider/ObservabilityProvider.js";
-const X = (s) => {
+const V = (s) => {
   const {
     children: l,
     config: r,
     dictionary: i,
-    lng: t = "en",
+    lng: n = "en",
     locale: c = "en-US",
     currency: d = "USD",
     theme: p,
@@ -29,8 +27,8 @@ const X = (s) => {
     queryClient: b
   } = s;
   if (i)
-    for (const n in i) {
-      const e = n;
+    for (const t in i) {
+      const e = t;
       for (const a in i[e])
         m.addResourceBundle(
           e,
@@ -41,14 +39,14 @@ const X = (s) => {
         );
     }
   P(() => {
-    (async () => await m.changeLanguage(t))();
-  }, [t]);
+    (async () => await m.changeLanguage(n))();
+  }, [n]);
   const u = k(() => {
     if (r.observability?.onError)
-      return (n, e) => {
+      return (t, e) => {
         if (!r.observability?.onError) return;
         const h = {
-          ...U(n),
+          ...U(t),
           timestamp: Date.now(),
           componentStack: e.componentStack ?? void 0
         }, y = L(h, r.observability.sanitization);
@@ -64,9 +62,9 @@ const X = (s) => {
       queryClient: b,
       children: l
     }
-  ) }, t) }) }) }) }) }) });
+  ) }, n) }) }) }) }) }) });
 };
 export {
-  X as GustoProviderCustomUIAdapter
+  V as GustoProviderCustomUIAdapter
 };
 //# sourceMappingURL=GustoProviderCustomUIAdapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"GustoProviderCustomUIAdapter.js","sources":["../../../src/contexts/GustoProvider/GustoProviderCustomUIAdapter.tsx"],"sourcesContent":["import type React from 'react'\nimport type { ErrorInfo } from 'react'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { I18nextProvider } from 'react-i18next'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { useEffect, useMemo } from 'react'\nimport { ComponentsProvider } from '../ComponentAdapter/ComponentsProvider'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport { ApiProvider } from '../ApiProvider/ApiProvider'\nimport { LoadingIndicatorProvider } from '../LoadingIndicatorProvider/LoadingIndicatorProvider'\nimport type { LoadingIndicatorContextProps } from '../LoadingIndicatorProvider/useLoadingIndicator'\nimport { ObservabilityProvider } from '../ObservabilityProvider'\nimport { sanitizeError } from '../ObservabilityProvider/sanitization'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { ThemeProvider } from '@/contexts/ThemeProvider'\nimport type { GustoSDKTheme } from '@/contexts/ThemeProvider/theme'\nimport type { ResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\nexport interface APIConfig {\n  baseUrl: string\n  headers?: HeadersInit\n  hooks?: SDKHooks\n  observability?: ObservabilityHook\n}\n\nexport interface GustoProviderProps {\n  config: APIConfig\n  dictionary?: ResourceDictionary\n  lng?: string\n  locale?: string\n  currency?: string\n  theme?: GustoSDKTheme\n  queryClient?: QueryClient\n  components: ComponentsContextType\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\nexport interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {\n  children?: React.ReactNode\n}\n\n/**\n * A provider that accepts UI component adapters through the components prop\n */\nconst GustoProviderCustomUIAdapter: React.FC<GustoProviderCustomUIAdapterProps> = props => {\n  const {\n    children,\n    config,\n    dictionary,\n    lng = 'en',\n    locale = 'en-US',\n    currency = 'USD',\n    theme,\n    components,\n    LoaderComponent,\n    queryClient,\n  } = props\n\n  if (dictionary) {\n    for (const language in dictionary) {\n      const lang = language as SupportedLanguages\n      for (const ns in dictionary[lang]) {\n        SDKI18next.addResourceBundle(\n          lang,\n          ns,\n          (dictionary[lang] as Record<string, unknown>)[ns],\n          true,\n          true,\n        )\n      }\n    }\n  }\n\n  useEffect(() => {\n    void (async () => {\n      await SDKI18next.changeLanguage(lng)\n    })()\n  }, [lng])\n\n  const handleTopLevelError = useMemo(() => {\n    if (!config.observability?.onError) return undefined\n\n    return (error: unknown, errorInfo: ErrorInfo) => {\n      if (!config.observability?.onError) return\n\n      const sdkError = normalizeToSDKError(error)\n\n      const observabilityError = {\n        ...sdkError,\n        timestamp: Date.now(),\n        componentStack: errorInfo.componentStack ?? undefined,\n      }\n\n      const sanitizedError = sanitizeError(observabilityError, config.observability.sanitization)\n\n      config.observability.onError(sanitizedError)\n    }\n  }, [config.observability])\n  return (\n    <ComponentsProvider value={components}>\n      <LoadingIndicatorProvider value={LoaderComponent}>\n        <ObservabilityProvider observability={config.observability}>\n          <ErrorBoundary FallbackComponent={InternalError} onError={handleTopLevelError}>\n            <ThemeProvider theme={theme}>\n              <LocaleProvider locale={locale} currency={currency}>\n                <I18nextProvider i18n={SDKI18next} key={lng}>\n                  <ApiProvider\n                    url={config.baseUrl}\n                    headers={config.headers}\n                    hooks={config.hooks}\n                    queryClient={queryClient}\n                  >\n                    {children}\n                  </ApiProvider>\n                </I18nextProvider>\n              </LocaleProvider>\n            </ThemeProvider>\n          </ErrorBoundary>\n        </ObservabilityProvider>\n      </LoadingIndicatorProvider>\n    </ComponentsProvider>\n  )\n}\n\nexport { GustoProviderCustomUIAdapter }\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","components","LoaderComponent","queryClient","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider"],"mappings":";;;;;;;;;;;;;;;;;AAiDA,MAAMA,IAA4E,CAAAC,MAAS;AACzF,QAAM;AAAA,IACJ,UAAAC;AAAA,IACA,QAAAC;AAAA,IACA,YAAAC;AAAA,IACA,KAAAC,IAAM;AAAA,IACN,QAAAC,IAAS;AAAA,IACT,UAAAC,IAAW;AAAA,IACX,OAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,EAAA,IACEV;AAEJ,MAAIG;AACF,eAAWQ,KAAYR,GAAY;AACjC,YAAMS,IAAOD;AACb,iBAAWE,KAAMV,EAAWS,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCV,EAAWS,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeV,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMY,IAAsBC,EAAQ,MAAM;AACxC,QAAKf,EAAO,eAAe;AAE3B,aAAO,CAACgB,GAAgBC,MAAyB;AAC/C,YAAI,CAACjB,EAAO,eAAe,QAAS;AAIpC,cAAMkB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBlB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQoB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACpB,EAAO,aAAa,CAAC;AACzB,SACE,gBAAAsB,EAACC,GAAA,EAAmB,OAAOjB,GACzB,UAAA,gBAAAgB,EAACE,GAAA,EAAyB,OAAOjB,GAC/B,UAAA,gBAAAe,EAACG,GAAA,EAAsB,eAAezB,EAAO,eAC3C,UAAA,gBAAAsB,EAACI,GAAA,EAAc,mBAAmBC,GAAe,SAASb,GACxD,UAAA,gBAAAQ,EAACM,GAAA,EAAc,OAAAvB,GACb,UAAA,gBAAAiB,EAACO,GAAA,EAAe,QAAA1B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAkB,EAACQ,GAAA,EAAgB,MAAMlB,GACrB,UAAA,gBAAAU;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAK/B,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAQ;AAAA,MAEC,UAAAT;AAAA,IAAA;AAAA,EAAA,KAPmCG,CASxC,GACF,GACF,EAAA,CACF,EAAA,CACF,GACF,GACF;AAEJ;"}
+{"version":3,"file":"GustoProviderCustomUIAdapter.js","sources":["../../../src/contexts/GustoProvider/GustoProviderCustomUIAdapter.tsx"],"sourcesContent":["import type React from 'react'\nimport type { ErrorInfo } from 'react'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { I18nextProvider } from 'react-i18next'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { useEffect, useMemo } from 'react'\nimport { ComponentsProvider } from '../ComponentAdapter/ComponentsProvider'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport { ApiProvider } from '../ApiProvider/ApiProvider'\nimport { LoadingIndicatorProvider } from '../LoadingIndicatorProvider/LoadingIndicatorProvider'\nimport type { LoadingIndicatorContextProps } from '../LoadingIndicatorProvider/useLoadingIndicator'\nimport { ObservabilityProvider } from '../ObservabilityProvider'\nimport { sanitizeError } from '../ObservabilityProvider/sanitization'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { ThemeProvider } from '@/contexts/ThemeProvider'\nimport type { GustoSDKTheme } from '@/contexts/ThemeProvider/theme'\nimport type { ResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\nexport interface APIConfig {\n  baseUrl: string\n  headers?: HeadersInit\n  hooks?: SDKHooks\n  observability?: ObservabilityHook\n}\n\nexport interface GustoProviderProps {\n  config: APIConfig\n  dictionary?: ResourceDictionary\n  lng?: string\n  locale?: string\n  currency?: string\n  theme?: GustoSDKTheme\n  queryClient?: QueryClient\n  components: ComponentsContextType\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\nexport interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {\n  children?: React.ReactNode\n}\n\n/**\n * A provider that accepts UI component adapters through the components prop\n */\nconst GustoProviderCustomUIAdapter: React.FC<GustoProviderCustomUIAdapterProps> = props => {\n  const {\n    children,\n    config,\n    dictionary,\n    lng = 'en',\n    locale = 'en-US',\n    currency = 'USD',\n    theme,\n    components,\n    LoaderComponent,\n    queryClient,\n  } = props\n\n  if (dictionary) {\n    for (const language in dictionary) {\n      const lang = language as SupportedLanguages\n      for (const ns in dictionary[lang]) {\n        SDKI18next.addResourceBundle(\n          lang,\n          ns,\n          (dictionary[lang] as Record<string, unknown>)[ns],\n          true,\n          true,\n        )\n      }\n    }\n  }\n\n  useEffect(() => {\n    void (async () => {\n      await SDKI18next.changeLanguage(lng)\n    })()\n  }, [lng])\n\n  const handleTopLevelError = useMemo(() => {\n    if (!config.observability?.onError) return undefined\n\n    return (error: unknown, errorInfo: ErrorInfo) => {\n      if (!config.observability?.onError) return\n\n      const sdkError = normalizeToSDKError(error)\n\n      const observabilityError = {\n        ...sdkError,\n        timestamp: Date.now(),\n        componentStack: errorInfo.componentStack ?? undefined,\n      }\n\n      const sanitizedError = sanitizeError(observabilityError, config.observability.sanitization)\n\n      config.observability.onError(sanitizedError)\n    }\n  }, [config.observability])\n  return (\n    <ComponentsProvider value={components}>\n      <LoadingIndicatorProvider value={LoaderComponent}>\n        <ObservabilityProvider observability={config.observability}>\n          <ErrorBoundary FallbackComponent={InternalError} onError={handleTopLevelError}>\n            <ThemeProvider theme={theme}>\n              <LocaleProvider locale={locale} currency={currency}>\n                <I18nextProvider i18n={SDKI18next} key={lng}>\n                  <ApiProvider\n                    url={config.baseUrl}\n                    headers={config.headers}\n                    hooks={config.hooks}\n                    queryClient={queryClient}\n                  >\n                    {children}\n                  </ApiProvider>\n                </I18nextProvider>\n              </LocaleProvider>\n            </ThemeProvider>\n          </ErrorBoundary>\n        </ObservabilityProvider>\n      </LoadingIndicatorProvider>\n    </ComponentsProvider>\n  )\n}\n\nexport { GustoProviderCustomUIAdapter }\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","components","LoaderComponent","queryClient","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider"],"mappings":";;;;;;;;;;;;;;;AAiDA,MAAMA,IAA4E,CAAAC,MAAS;AACzF,QAAM;AAAA,IACJ,UAAAC;AAAA,IACA,QAAAC;AAAA,IACA,YAAAC;AAAA,IACA,KAAAC,IAAM;AAAA,IACN,QAAAC,IAAS;AAAA,IACT,UAAAC,IAAW;AAAA,IACX,OAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,EAAA,IACEV;AAEJ,MAAIG;AACF,eAAWQ,KAAYR,GAAY;AACjC,YAAMS,IAAOD;AACb,iBAAWE,KAAMV,EAAWS,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCV,EAAWS,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeV,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMY,IAAsBC,EAAQ,MAAM;AACxC,QAAKf,EAAO,eAAe;AAE3B,aAAO,CAACgB,GAAgBC,MAAyB;AAC/C,YAAI,CAACjB,EAAO,eAAe,QAAS;AAIpC,cAAMkB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBlB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQoB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACpB,EAAO,aAAa,CAAC;AACzB,SACE,gBAAAsB,EAACC,GAAA,EAAmB,OAAOjB,GACzB,UAAA,gBAAAgB,EAACE,GAAA,EAAyB,OAAOjB,GAC/B,UAAA,gBAAAe,EAACG,GAAA,EAAsB,eAAezB,EAAO,eAC3C,UAAA,gBAAAsB,EAACI,GAAA,EAAc,mBAAmBC,GAAe,SAASb,GACxD,UAAA,gBAAAQ,EAACM,GAAA,EAAc,OAAAvB,GACb,UAAA,gBAAAiB,EAACO,GAAA,EAAe,QAAA1B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAkB,EAACQ,GAAA,EAAgB,MAAMlB,GACrB,UAAA,gBAAAU;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAK/B,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAQ;AAAA,MAEC,UAAAT;AAAA,IAAA;AAAA,EAAA,KAPmCG,CASxC,GACF,GACF,EAAA,CACF,EAAA,CACF,GACF,GACF;AAEJ;"}

package/dist/helpers/breadcrumbHelpers.d.ts

@@ -1,4 +1,11 @@
 import { BreadcrumbNodes, BreadcrumbTrail } from '../components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes';
+import { FlowHeaderConfig } from '../components/Flow/useFlow';
+type BreadcrumbsHeader = Extract<FlowHeaderConfig, {
+    type: 'breadcrumbs';
+}>;
+type WithHeader = {
+    header?: FlowHeaderConfig | null;
+};
 /**
  * Builds a complete breadcrumb trail map from a hierarchical node structure.
  *
@@ -16,32 +23,38 @@ export declare const buildBreadcrumbs: (nodes: BreadcrumbNodes) => BreadcrumbTra
  */
 export declare const resolveBreadcrumbVariables: (variables: Record<string, string> | undefined, context: Record<string, unknown>) => Record<string, unknown>;
 /**
- * Removes a breadcrumb from all trails in the context.
- * Use this in state machine reducers to hide a step entirely (e.g. after payroll submission).
+ * 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.
+ */
+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).
  */
-export declare const hideBreadcrumb: <T extends {
-    breadcrumbs?: BreadcrumbTrail;
-}>(breadcrumbId: string, context: T) => T;
+export declare const hideBreadcrumb: <T extends WithHeader>(breadcrumbId: string, context: T) => T;
 /**
- * Marks a breadcrumb as non-navigable across all trails in the context.
- * Use this in state machine reducers to disable backward navigation to a specific step.
+ * 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.
  */
-export declare const lockBreadcrumb: <T extends {
-    breadcrumbs?: BreadcrumbTrail;
-}>(breadcrumbId: string, context: T) => T;
+export declare const lockBreadcrumb: <T extends WithHeader>(breadcrumbId: string, context: T) => T;
 /**
- * Updates the breadcrumb trail for a specific state with resolved variables.
+ * 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.
-
+ * 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'`.
  */
-export declare const updateBreadcrumbs: <T extends {
-    breadcrumbs?: BreadcrumbTrail;
-    currentBreadcrumb?: string;
-}>(stateName: string, context: T, variables?: Record<string, string>) => Omit<T, "breadcrumbs" | "currentBreadcrumb"> & {
-    breadcrumbs: BreadcrumbTrail;
-    currentBreadcrumbId: string;
+export declare const updateBreadcrumbs: <T extends WithHeader>(stateName: string, context: T, variables?: Record<string, string>) => T & {
+    header: BreadcrumbsHeader;
 };
+export {};

package/dist/helpers/breadcrumbHelpers.js

@@ -1,55 +1,65 @@
-const o = (r) => {
+const u = (r) => r?.type === "breadcrumbs" ? r : { type: "breadcrumbs" }, o = (r) => {
   const e = {};
-  for (const [c, s] of Object.entries(r)) {
-    const n = [];
-    let t = s;
-    for (; t; ) {
-      n.unshift(t.item);
-      const a = t.parent;
-      t = a ? r[a] ?? null : null;
+  for (const [t, a] of Object.entries(r)) {
+    const c = [];
+    let s = a;
+    for (; s; ) {
+      c.unshift(s.item);
+      const n = s.parent;
+      s = n ? r[n] ?? null : null;
     }
-    e[c] = n;
+    e[t] = c;
   }
   return e;
-}, u = (r, e) => {
+}, b = (r, e) => {
   if (!r)
     return {};
-  const c = {};
-  for (const [s, n] of Object.entries(r)) {
-    const t = n.match(/{{(.*?)}}/);
-    if (t?.[1]) {
-      const a = t[1].trim();
-      c[s] = e[a] ?? "";
+  const t = {};
+  for (const [a, c] of Object.entries(r)) {
+    const s = c.match(/{{(.*?)}}/);
+    if (s?.[1]) {
+      const n = s[1].trim();
+      t[a] = e[n] ?? "";
     } else
-      c[s] = n;
+      t[a] = c;
   }
-  return c;
-}, b = (r, e) => {
-  const c = e.breadcrumbs ?? {}, s = Object.fromEntries(
-    Object.entries(c).map(([n, t]) => [
-      n,
-      t.filter((a) => a.id !== r)
+  return t;
+}, m = (r, e) => {
+  const t = u(r.header);
+  return { ...r, header: { ...t, ...e } };
+}, i = (r, e) => {
+  const t = u(e.header), a = t.breadcrumbs ?? {}, c = Object.fromEntries(
+    Object.entries(a).map(([s, n]) => [
+      s,
+      n.filter((d) => d.id !== r)
     ])
   );
-  return { ...e, breadcrumbs: s };
-}, l = (r, e, c) => {
-  const s = e.breadcrumbs ?? {}, t = (s[r] ?? []).map((a) => ({
-    ...a,
-    variables: u(c, e)
+  return {
+    ...e,
+    header: { ...t, breadcrumbs: c }
+  };
+}, l = (r, e, t) => {
+  const a = u(e.header), c = a.breadcrumbs ?? {}, n = (c[r] ?? []).map((d) => ({
+    ...d,
+    variables: b(t, e)
   }));
   return {
     ...e,
-    breadcrumbs: {
-      ...s,
-      [r]: t
-    },
-    currentBreadcrumbId: r
+    header: {
+      ...a,
+      breadcrumbs: {
+        ...c,
+        [r]: n
+      },
+      currentBreadcrumbId: r
+    }
   };
 };
 export {
   o as buildBreadcrumbs,
-  b as hideBreadcrumb,
-  u as resolveBreadcrumbVariables,
+  i as hideBreadcrumb,
+  m as patchBreadcrumbsHeader,
+  b as resolveBreadcrumbVariables,
   l as updateBreadcrumbs
 };
 //# sourceMappingURL=breadcrumbHelpers.js.map

package/dist/helpers/breadcrumbHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumbHelpers.js","sources":["../../src/helpers/breadcrumbHelpers.ts"],"sourcesContent":["import type {\n  BreadcrumbNode,\n  BreadcrumbNodes,\n  BreadcrumbTrail,\n  FlowBreadcrumb,\n} from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\n\n/**\n * Builds a complete breadcrumb trail map from a hierarchical node structure.\n *\n * Takes a tree structure of breadcrumb nodes and generates a map where each state\n * has its complete breadcrumb trail from root to that state. This is useful for\n * initializing breadcrumb navigation in state machines or multi-step flows.\n */\nexport const buildBreadcrumbs = (nodes: BreadcrumbNodes): BreadcrumbTrail => {\n  const map: Record<string, FlowBreadcrumb[]> = {}\n\n  for (const [state, node] of Object.entries(nodes)) {\n    const trail: FlowBreadcrumb[] = []\n    let current: BreadcrumbNode | null = node\n\n    while (current) {\n      trail.unshift(current.item)\n      const parentKey: string | null = current.parent\n      current = parentKey ? (nodes[parentKey] ?? null) : null\n    }\n\n    map[state] = trail\n  }\n\n  return map\n}\n\n/**\n * Resolves template variables in breadcrumb labels using values from a context object.\n *\n * Supports Handlebars-style template syntax ({{variableName}}) for dynamic breadcrumb labels.\n * Variables enclosed in double braces are replaced with their corresponding values from the context.\n * Non-template strings are returned as-is.\n */\nexport const resolveBreadcrumbVariables = (\n  variables: Record<string, string> | undefined,\n  context: Record<string, unknown>,\n): Record<string, unknown> => {\n  if (!variables) {\n    return {}\n  }\n\n  const resolved: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(variables)) {\n    const match = value.match(/{{(.*?)}}/)\n    if (match?.[1]) {\n      const ctxKey = match[1].trim()\n      resolved[key] = context[ctxKey] ?? ''\n    } else {\n      resolved[key] = value\n    }\n  }\n  return resolved\n}\n\n/**\n * Removes a breadcrumb from all trails in the context.\n * Use this in state machine reducers to hide a step entirely (e.g. after payroll submission).\n */\nexport const hideBreadcrumb = <T extends { breadcrumbs?: BreadcrumbTrail }>(\n  breadcrumbId: string,\n  context: T,\n): T => {\n  const allBreadcrumbs = context.breadcrumbs ?? {}\n  const updatedBreadcrumbs = Object.fromEntries(\n    Object.entries(allBreadcrumbs).map(([stateKey, trail]) => [\n      stateKey,\n      trail.filter(b => b.id !== breadcrumbId),\n    ]),\n  )\n  return { ...context, breadcrumbs: updatedBreadcrumbs }\n}\n\n/**\n * Marks a breadcrumb as non-navigable across all trails in the context.\n * Use this in state machine reducers to disable backward navigation to a specific step.\n */\nexport const lockBreadcrumb = <T extends { breadcrumbs?: BreadcrumbTrail }>(\n  breadcrumbId: string,\n  context: T,\n): T => {\n  const allBreadcrumbs = context.breadcrumbs ?? {}\n  const updatedBreadcrumbs = Object.fromEntries(\n    Object.entries(allBreadcrumbs).map(([stateKey, trail]) => [\n      stateKey,\n      trail.map(b => (b.id === breadcrumbId ? { ...b, isNavigable: false } : b)),\n    ]),\n  )\n  return { ...context, breadcrumbs: updatedBreadcrumbs }\n}\n\n/**\n * Updates the breadcrumb trail for a specific state with resolved variables.\n *\n * This function is typically used in state machine transitions to update breadcrumb\n * navigation when moving between states. It preserves all existing breadcrumb trails\n * for other states and only updates the trail for the specified state by resolving\n * any template variables for that state's breadcrumb.\n\n */\nexport const updateBreadcrumbs = <\n  T extends { breadcrumbs?: BreadcrumbTrail; currentBreadcrumb?: string },\n>(\n  stateName: string,\n  context: T,\n  variables?: Record<string, string>,\n): Omit<T, 'breadcrumbs' | 'currentBreadcrumb'> & {\n  breadcrumbs: BreadcrumbTrail\n  currentBreadcrumbId: string\n} => {\n  const allBreadcrumbs = context.breadcrumbs ?? {}\n  const trail = allBreadcrumbs[stateName] ?? []\n  const resolvedTrail = trail.map(breadcrumb => {\n    return {\n      ...breadcrumb,\n      variables: resolveBreadcrumbVariables(variables, context as Record<string, unknown>),\n    }\n  })\n  return {\n    ...context,\n    breadcrumbs: {\n      ...allBreadcrumbs,\n      [stateName]: resolvedTrail,\n    },\n    currentBreadcrumbId: stateName,\n  }\n}\n"],"names":["buildBreadcrumbs","nodes","map","state","node","trail","current","parentKey","resolveBreadcrumbVariables","variables","context","resolved","key","value","match","ctxKey","hideBreadcrumb","breadcrumbId","allBreadcrumbs","updatedBreadcrumbs","stateKey","b","updateBreadcrumbs","stateName","resolvedTrail","breadcrumb"],"mappings":"AAcO,MAAMA,IAAmB,CAACC,MAA4C;AAC3E,QAAMC,IAAwC,CAAA;AAE9C,aAAW,CAACC,GAAOC,CAAI,KAAK,OAAO,QAAQH,CAAK,GAAG;AACjD,UAAMI,IAA0B,CAAA;AAChC,QAAIC,IAAiCF;AAErC,WAAOE,KAAS;AACd,MAAAD,EAAM,QAAQC,EAAQ,IAAI;AAC1B,YAAMC,IAA2BD,EAAQ;AACzC,MAAAA,IAAUC,IAAaN,EAAMM,CAAS,KAAK,OAAQ;AAAA,IACrD;AAEA,IAAAL,EAAIC,CAAK,IAAIE;AAAA,EACf;AAEA,SAAOH;AACT,GASaM,IAA6B,CACxCC,GACAC,MAC4B;AAC5B,MAAI,CAACD;AACH,WAAO,CAAA;AAGT,QAAME,IAAoC,CAAA;AAC1C,aAAW,CAACC,GAAKC,CAAK,KAAK,OAAO,QAAQJ,CAAS,GAAG;AACpD,UAAMK,IAAQD,EAAM,MAAM,WAAW;AACrC,QAAIC,IAAQ,CAAC,GAAG;AACd,YAAMC,IAASD,EAAM,CAAC,EAAE,KAAA;AACxB,MAAAH,EAASC,CAAG,IAAIF,EAAQK,CAAM,KAAK;AAAA,IACrC;AACE,MAAAJ,EAASC,CAAG,IAAIC;AAAA,EAEpB;AACA,SAAOF;AACT,GAMaK,IAAiB,CAC5BC,GACAP,MACM;AACN,QAAMQ,IAAiBR,EAAQ,eAAe,CAAA,GACxCS,IAAqB,OAAO;AAAA,IAChC,OAAO,QAAQD,CAAc,EAAE,IAAI,CAAC,CAACE,GAAUf,CAAK,MAAM;AAAA,MACxDe;AAAA,MACAf,EAAM,OAAO,CAAAgB,MAAKA,EAAE,OAAOJ,CAAY;AAAA,IAAA,CACxC;AAAA,EAAA;AAEH,SAAO,EAAE,GAAGP,GAAS,aAAaS,EAAA;AACpC,GA6BaG,IAAoB,CAG/BC,GACAb,GACAD,MAIG;AACH,QAAMS,IAAiBR,EAAQ,eAAe,CAAA,GAExCc,KADQN,EAAeK,CAAS,KAAK,CAAA,GACf,IAAI,CAAAE,OACvB;AAAA,IACL,GAAGA;AAAA,IACH,WAAWjB,EAA2BC,GAAWC,CAAkC;AAAA,EAAA,EAEtF;AACD,SAAO;AAAA,IACL,GAAGA;AAAA,IACH,aAAa;AAAA,MACX,GAAGQ;AAAA,MACH,CAACK,CAAS,GAAGC;AAAA,IAAA;AAAA,IAEf,qBAAqBD;AAAA,EAAA;AAEzB;"}
+{"version":3,"file":"breadcrumbHelpers.js","sources":["../../src/helpers/breadcrumbHelpers.ts"],"sourcesContent":["import type {\n  BreadcrumbNode,\n  BreadcrumbNodes,\n  BreadcrumbTrail,\n  FlowBreadcrumb,\n} from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport type { FlowHeaderConfig } from '@/components/Flow/useFlow'\n\ntype BreadcrumbsHeader = Extract<FlowHeaderConfig, { type: 'breadcrumbs' }>\n\ntype WithHeader = { header?: FlowHeaderConfig | null }\n\n/**\n * Returns the existing breadcrumbs header from a context, defaulting to a\n * blank breadcrumbs config when the header is missing or of a different\n * variant. Helpers below use this so callers don't need to manually narrow\n * the discriminated `header` union before mutating breadcrumb data.\n */\nconst getBreadcrumbsHeader = (header: FlowHeaderConfig | null | undefined): BreadcrumbsHeader => {\n  if (header?.type === 'breadcrumbs') return header\n  return { type: 'breadcrumbs' }\n}\n\n/**\n * Builds a complete breadcrumb trail map from a hierarchical node structure.\n *\n * Takes a tree structure of breadcrumb nodes and generates a map where each state\n * has its complete breadcrumb trail from root to that state. This is useful for\n * initializing breadcrumb navigation in state machines or multi-step flows.\n */\nexport const buildBreadcrumbs = (nodes: BreadcrumbNodes): BreadcrumbTrail => {\n  const map: Record<string, FlowBreadcrumb[]> = {}\n\n  for (const [state, node] of Object.entries(nodes)) {\n    const trail: FlowBreadcrumb[] = []\n    let current: BreadcrumbNode | null = node\n\n    while (current) {\n      trail.unshift(current.item)\n      const parentKey: string | null = current.parent\n      current = parentKey ? (nodes[parentKey] ?? null) : null\n    }\n\n    map[state] = trail\n  }\n\n  return map\n}\n\n/**\n * Resolves template variables in breadcrumb labels using values from a context object.\n *\n * Supports Handlebars-style template syntax ({{variableName}}) for dynamic breadcrumb labels.\n * Variables enclosed in double braces are replaced with their corresponding values from the context.\n * Non-template strings are returned as-is.\n */\nexport const resolveBreadcrumbVariables = (\n  variables: Record<string, string> | undefined,\n  context: Record<string, unknown>,\n): Record<string, unknown> => {\n  if (!variables) {\n    return {}\n  }\n\n  const resolved: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(variables)) {\n    const match = value.match(/{{(.*?)}}/)\n    if (match?.[1]) {\n      const ctxKey = match[1].trim()\n      resolved[key] = context[ctxKey] ?? ''\n    } else {\n      resolved[key] = value\n    }\n  }\n  return resolved\n}\n\n/**\n * Merges `patch` fields into the existing breadcrumbs header on a context,\n * preserving the existing trails and CTA. If the context has no breadcrumbs\n * header, a fresh one is created. Useful when a transition needs to flip\n * breadcrumbs visibility (`currentBreadcrumbId`) without rebuilding any\n * trails.\n */\nexport const patchBreadcrumbsHeader = <T extends WithHeader>(\n  context: T,\n  patch: Partial<Omit<BreadcrumbsHeader, 'type'>>,\n): T & { header: BreadcrumbsHeader } => {\n  const existing = getBreadcrumbsHeader(context.header)\n  return { ...context, header: { ...existing, ...patch } }\n}\n\n/**\n * Removes a breadcrumb from all trails in the context's breadcrumbs header.\n * Use this in state machine reducers to hide a step entirely (e.g. after\n * payroll submission).\n */\nexport const hideBreadcrumb = <T extends WithHeader>(breadcrumbId: string, context: T): T => {\n  const breadcrumbsHeader = getBreadcrumbsHeader(context.header)\n  const allBreadcrumbs = breadcrumbsHeader.breadcrumbs ?? {}\n  const updatedBreadcrumbs = Object.fromEntries(\n    Object.entries(allBreadcrumbs).map(([stateKey, trail]) => [\n      stateKey,\n      trail.filter(b => b.id !== breadcrumbId),\n    ]),\n  )\n  return {\n    ...context,\n    header: { ...breadcrumbsHeader, breadcrumbs: updatedBreadcrumbs },\n  }\n}\n\n/**\n * Marks a breadcrumb as non-navigable across all trails in the context's\n * breadcrumbs header. Use this in state machine reducers to disable backward\n * navigation to a specific step.\n */\nexport const lockBreadcrumb = <T extends WithHeader>(breadcrumbId: string, context: T): T => {\n  const breadcrumbsHeader = getBreadcrumbsHeader(context.header)\n  const allBreadcrumbs = breadcrumbsHeader.breadcrumbs ?? {}\n  const updatedBreadcrumbs = Object.fromEntries(\n    Object.entries(allBreadcrumbs).map(([stateKey, trail]) => [\n      stateKey,\n      trail.map(b => (b.id === breadcrumbId ? { ...b, isNavigable: false } : b)),\n    ]),\n  )\n  return {\n    ...context,\n    header: { ...breadcrumbsHeader, breadcrumbs: updatedBreadcrumbs },\n  }\n}\n\n/**\n * Updates the breadcrumb trail for a specific state with resolved variables\n * and switches the active breadcrumb to that state.\n *\n * This function is typically used in state machine transitions to update\n * breadcrumb navigation when moving between states. It preserves all existing\n * breadcrumb trails for other states and only updates the trail for the\n * specified state by resolving any template variables for that state's\n * breadcrumb. The resulting context's header is always of type `'breadcrumbs'`.\n */\nexport const updateBreadcrumbs = <T extends WithHeader>(\n  stateName: string,\n  context: T,\n  variables?: Record<string, string>,\n): T & { header: BreadcrumbsHeader } => {\n  const breadcrumbsHeader = getBreadcrumbsHeader(context.header)\n  const allBreadcrumbs = breadcrumbsHeader.breadcrumbs ?? {}\n  const trail = allBreadcrumbs[stateName] ?? []\n  const resolvedTrail = trail.map(breadcrumb => ({\n    ...breadcrumb,\n    variables: resolveBreadcrumbVariables(variables, context as Record<string, unknown>),\n  }))\n  return {\n    ...context,\n    header: {\n      ...breadcrumbsHeader,\n      breadcrumbs: {\n        ...allBreadcrumbs,\n        [stateName]: resolvedTrail,\n      },\n      currentBreadcrumbId: stateName,\n    },\n  }\n}\n"],"names":["getBreadcrumbsHeader","header","buildBreadcrumbs","nodes","map","state","node","trail","current","parentKey","resolveBreadcrumbVariables","variables","context","resolved","key","value","match","ctxKey","patchBreadcrumbsHeader","patch","existing","hideBreadcrumb","breadcrumbId","breadcrumbsHeader","allBreadcrumbs","updatedBreadcrumbs","stateKey","b","updateBreadcrumbs","stateName","resolvedTrail","breadcrumb"],"mappings":"AAkBA,MAAMA,IAAuB,CAACC,MACxBA,GAAQ,SAAS,gBAAsBA,IACpC,EAAE,MAAM,cAAA,GAUJC,IAAmB,CAACC,MAA4C;AAC3E,QAAMC,IAAwC,CAAA;AAE9C,aAAW,CAACC,GAAOC,CAAI,KAAK,OAAO,QAAQH,CAAK,GAAG;AACjD,UAAMI,IAA0B,CAAA;AAChC,QAAIC,IAAiCF;AAErC,WAAOE,KAAS;AACd,MAAAD,EAAM,QAAQC,EAAQ,IAAI;AAC1B,YAAMC,IAA2BD,EAAQ;AACzC,MAAAA,IAAUC,IAAaN,EAAMM,CAAS,KAAK,OAAQ;AAAA,IACrD;AAEA,IAAAL,EAAIC,CAAK,IAAIE;AAAA,EACf;AAEA,SAAOH;AACT,GASaM,IAA6B,CACxCC,GACAC,MAC4B;AAC5B,MAAI,CAACD;AACH,WAAO,CAAA;AAGT,QAAME,IAAoC,CAAA;AAC1C,aAAW,CAACC,GAAKC,CAAK,KAAK,OAAO,QAAQJ,CAAS,GAAG;AACpD,UAAMK,IAAQD,EAAM,MAAM,WAAW;AACrC,QAAIC,IAAQ,CAAC,GAAG;AACd,YAAMC,IAASD,EAAM,CAAC,EAAE,KAAA;AACxB,MAAAH,EAASC,CAAG,IAAIF,EAAQK,CAAM,KAAK;AAAA,IACrC;AACE,MAAAJ,EAASC,CAAG,IAAIC;AAAA,EAEpB;AACA,SAAOF;AACT,GASaK,IAAyB,CACpCN,GACAO,MACsC;AACtC,QAAMC,IAAWpB,EAAqBY,EAAQ,MAAM;AACpD,SAAO,EAAE,GAAGA,GAAS,QAAQ,EAAE,GAAGQ,GAAU,GAAGD,IAAM;AACvD,GAOaE,IAAiB,CAAuBC,GAAsBV,MAAkB;AAC3F,QAAMW,IAAoBvB,EAAqBY,EAAQ,MAAM,GACvDY,IAAiBD,EAAkB,eAAe,CAAA,GAClDE,IAAqB,OAAO;AAAA,IAChC,OAAO,QAAQD,CAAc,EAAE,IAAI,CAAC,CAACE,GAAUnB,CAAK,MAAM;AAAA,MACxDmB;AAAA,MACAnB,EAAM,OAAO,CAAAoB,MAAKA,EAAE,OAAOL,CAAY;AAAA,IAAA,CACxC;AAAA,EAAA;AAEH,SAAO;AAAA,IACL,GAAGV;AAAA,IACH,QAAQ,EAAE,GAAGW,GAAmB,aAAaE,EAAA;AAAA,EAAmB;AAEpE,GAgCaG,IAAoB,CAC/BC,GACAjB,GACAD,MACsC;AACtC,QAAMY,IAAoBvB,EAAqBY,EAAQ,MAAM,GACvDY,IAAiBD,EAAkB,eAAe,CAAA,GAElDO,KADQN,EAAeK,CAAS,KAAK,CAAA,GACf,IAAI,CAAAE,OAAe;AAAA,IAC7C,GAAGA;AAAA,IACH,WAAWrB,EAA2BC,GAAWC,CAAkC;AAAA,EAAA,EACnF;AACF,SAAO;AAAA,IACL,GAAGA;AAAA,IACH,QAAQ;AAAA,MACN,GAAGW;AAAA,MACH,aAAa;AAAA,QACX,GAAGC;AAAA,QACH,CAACK,CAAS,GAAGC;AAAA,MAAA;AAAA,MAEf,qBAAqBD;AAAA,IAAA;AAAA,EACvB;AAEJ;"}

package/dist/helpers/dateFormatting.d.ts

@@ -23,6 +23,18 @@ export declare const formatPayPeriodRange: (startDateInput?: string | Date | nul
     useShortMonth?: boolean;
 }) => string;
 export declare const formatDateToStringDate: (date: Date) => string | null;
+/**
+ * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local
+ * time, so the calendar date is preserved regardless of the runtime timezone.
+ *
+ * Unlike `formatDateToStringDate` (which reads UTC), this function reads the
+ * local year/month/day — safe for dates parsed from locale-format strings
+ * (e.g. "4/16/1998") or ISO strings, both of which `normalizeToDate` lands at
+ * local midnight.
+ *
+ * Returns `''` for null, undefined, empty, or unparseable input.
+ */
+export declare const normalizeToISOString: (value?: string | null) => string;
 /**
  * Normalizes Date to local midnight, handling timezone issues from any adapter.
  */

package/dist/helpers/dateFormatting.js

@@ -2,136 +2,143 @@ const s = (t) => {
   if (!t) return null;
   if (typeof t == "string") {
     if (/^\d{4}-\d{2}-\d{2}$/.test(t)) {
-      const e = t.split("-");
-      if (e.length !== 3) return null;
-      const r = e.map(Number), o = r[0], i = r[1], a = r[2];
+      const n = t.split("-");
+      if (n.length !== 3) return null;
+      const r = n.map(Number), o = r[0], i = r[1], a = r[2];
       return o === void 0 || i === void 0 || a === void 0 || isNaN(o) || isNaN(i) || isNaN(a) || i < 1 || i > 12 || a < 1 || a > 31 ? null : new Date(o, i - 1, a);
     }
-    const n = new Date(t);
-    return isNaN(n.getTime()) ? null : n;
+    const e = new Date(t);
+    return isNaN(e.getTime()) ? null : e;
   }
   return t instanceof Date ? isNaN(t.getTime()) ? null : t : null;
-}, m = (t) => (n, e) => {
-  const r = s(n);
-  return r ? r.toLocaleDateString(e, t) : "";
-}, h = m({
+}, u = (t) => (e, n) => {
+  const r = s(e);
+  return r ? r.toLocaleDateString(n, t) : "";
+}, g = u({
   weekday: "short",
   month: "short",
   day: "numeric"
-}), g = m({
+}), h = u({
   weekday: "short",
   month: "short",
   day: "numeric",
   year: "numeric"
-}), y = m({
+}), y = u({
   month: "short",
   day: "numeric"
-}), S = m({
+}), S = u({
   month: "short",
   day: "numeric",
   year: "numeric"
-}), N = m({
+}), N = u({
   month: "long",
   day: "numeric"
-}), T = m({
+}), T = u({
   month: "long",
   day: "numeric",
   year: "numeric"
-}), w = (t, n) => {
-  const e = s(t);
-  if (!e) return { time: "", date: "" };
-  const r = e.toLocaleTimeString(n, {
+}), w = (t, e) => {
+  const n = s(t);
+  if (!n) return { time: "", date: "" };
+  const r = n.toLocaleTimeString(e, {
     hour: "numeric",
     minute: "2-digit",
     hour12: !0,
     timeZoneName: "short"
-  }), o = e.toLocaleDateString(n, {
+  }), o = n.toLocaleDateString(e, {
     weekday: "short",
     month: "short",
     day: "numeric"
   });
   return { time: r, date: o };
-}, L = (t, n, e) => {
-  const r = s(t), o = s(n);
+}, L = (t, e, n) => {
+  const r = s(t), o = s(e);
   if (!r || !o)
     return { startDate: "", endDate: "" };
-  const i = r.toLocaleDateString(e, {
+  const i = r.toLocaleDateString(n, {
     month: "long",
     day: "numeric"
-  }), a = o.toLocaleDateString(e, {
+  }), a = o.toLocaleDateString(n, {
     month: "short",
     day: "numeric",
     year: "numeric"
   });
   return { startDate: i, endDate: a };
-}, M = (t, n, e, r) => {
-  const o = s(t), i = s(n);
+}, M = (t, e, n, r) => {
+  const o = s(t), i = s(e);
   if (!o || !i) return "";
-  const a = r?.useShortMonth ? "short" : "long", c = o.toLocaleDateString(e, {
+  const a = r?.useShortMonth ? "short" : "long", c = o.toLocaleDateString(n, {
     month: a,
     day: "numeric"
-  }), l = i.toLocaleDateString(e, {
+  }), l = i.toLocaleDateString(n, {
     month: a,
     day: "numeric",
     year: "numeric"
   });
   return `${c}–${l}`;
-}, W = (t) => isNaN(t.getTime()) ? null : t.toISOString().split("T")[0] || null, P = (t) => {
+}, p = (t) => isNaN(t.getTime()) ? null : t.toISOString().split("T")[0] || null, W = (t) => {
+  if (!t) return "";
+  const e = s(t);
+  if (!e) return "";
+  const n = e.getFullYear(), r = String(e.getMonth() + 1).padStart(2, "0"), o = String(e.getDate()).padStart(2, "0");
+  return `${n}-${r}-${o}`;
+}, $ = (t) => {
   if (!t || isNaN(t.getTime()))
     return null;
-  const n = t.toISOString(), [e] = n.split("T");
-  if (!e) return null;
-  const r = e.split("-");
+  const e = t.toISOString(), [n] = e.split("T");
+  if (!n) return null;
+  const r = n.split("-");
   if (r.length !== 3) return null;
   const o = r.map(Number), i = o[0], a = o[1], c = o[2];
   return isNaN(i) || isNaN(a) || isNaN(c) || a < 1 || a > 12 || c < 1 || c > 31 ? null : new Date(i, a - 1, c);
-}, u = 1e3 * 60 * 60, d = u * 24, k = (t) => {
-  const n = s(t);
-  if (!n) return null;
-  const e = /* @__PURE__ */ new Date();
-  return (n.getTime() - e.getTime()) / u;
-}, p = (t) => {
-  const n = s(t);
-  if (!n) return null;
-  const e = /* @__PURE__ */ new Date();
-  return (n.getTime() - e.getTime()) / d;
+}, m = 1e3 * 60 * 60, d = m * 24, F = (t) => {
+  const e = s(t);
+  if (!e) return null;
+  const n = /* @__PURE__ */ new Date();
+  return (e.getTime() - n.getTime()) / m;
+}, P = (t) => {
+  const e = s(t);
+  if (!e) return null;
+  const n = /* @__PURE__ */ new Date();
+  return (e.getTime() - n.getTime()) / d;
 }, D = (t) => {
-  const n = t.getDay();
-  return n === 0 || n === 6;
-}, f = (t, n) => {
-  const e = new Date(t);
-  return e.setDate(e.getDate() + n), e;
-}, F = (t, n) => {
-  let e = new Date(t);
-  e.setHours(0, 0, 0, 0);
+  const e = t.getDay();
+  return e === 0 || e === 6;
+}, f = (t, e) => {
+  const n = new Date(t);
+  return n.setDate(n.getDate() + e), n;
+}, k = (t, e) => {
+  let n = new Date(t);
+  n.setHours(0, 0, 0, 0);
   let r = 0;
-  for (; r < n; )
-    e = f(e, 1), D(e) || r++;
-  return e;
+  for (; r < e; )
+    n = f(n, 1), D(n) || r++;
+  return n;
 };
-function $(t, n) {
-  if (!(t == null || n == null))
-    return `${String(t).padStart(2, "0")}-${String(n).padStart(2, "0")}`;
+function Y(t, e) {
+  if (!(t == null || e == null))
+    return `${String(t).padStart(2, "0")}-${String(e).padStart(2, "0")}`;
 }
 export {
-  u as MS_PER_HOUR,
-  F as addBusinessDays,
+  m as MS_PER_HOUR,
+  k as addBusinessDays,
   f as addDays,
   N as formatDateLong,
   T as formatDateLongWithYear,
   y as formatDateShort,
-  h as formatDateShortWithWeekday,
-  g as formatDateShortWithWeekdayAndYear,
+  g as formatDateShortWithWeekday,
+  h as formatDateShortWithWeekdayAndYear,
   S as formatDateShortWithYear,
-  W as formatDateToStringDate,
+  p as formatDateToStringDate,
   w as formatDateWithTime,
-  $ as formatMonthDay,
+  Y as formatMonthDay,
   L as formatPayPeriod,
   M as formatPayPeriodRange,
-  p as getDaysUntil,
-  k as getHoursUntil,
+  P as getDaysUntil,
+  F as getHoursUntil,
   D as isWeekend,
-  P as normalizeDateToLocal,
-  s as normalizeToDate
+  $ as normalizeDateToLocal,
+  s as normalizeToDate,
+  W as normalizeToISOString
 };
 //# sourceMappingURL=dateFormatting.js.map

package/dist/helpers/dateFormatting.js.map

@@ -1 +1 @@
-{"version":3,"file":"dateFormatting.js","sources":["../../src/helpers/dateFormatting.ts"],"sourcesContent":["/**\n * Normalizes any date input (string, Date, or undefined) to a Date object.\n * Handles YYYY-MM-DD strings by parsing them in local timezone to avoid timezone issues.\n * Also handles ISO timestamp strings for compatibility.\n * Returns null for invalid inputs.\n */\nexport const normalizeToDate = (dateInput?: string | Date | null): Date | null => {\n  if (!dateInput) return null\n\n  if (typeof dateInput === 'string') {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(dateInput)) {\n      const parts = dateInput.split('-')\n      if (parts.length !== 3) return null\n\n      const numbers = parts.map(Number)\n      const year = numbers[0]\n      const month = numbers[1]\n      const day = numbers[2]\n      if (year === undefined || month === undefined || day === undefined) {\n        return null\n      }\n\n      if (\n        isNaN(year) ||\n        isNaN(month) ||\n        isNaN(day) ||\n        month < 1 ||\n        month > 12 ||\n        day < 1 ||\n        day > 31\n      ) {\n        return null\n      }\n\n      return new Date(year, month - 1, day)\n    }\n\n    const parsedDate = new Date(dateInput)\n    return isNaN(parsedDate.getTime()) ? null : parsedDate\n  }\n\n  if (dateInput instanceof Date) {\n    return isNaN(dateInput.getTime()) ? null : dateInput\n  }\n\n  return null\n}\n\n/**\n * Creates a date formatter function that handles both string and Date inputs.\n */\nconst createDateFormatter =\n  (options: Intl.DateTimeFormatOptions) =>\n  (dateInput?: string | Date | null, locale?: string): string => {\n    const date = normalizeToDate(dateInput)\n    if (!date) return ''\n    return date.toLocaleDateString(locale, options)\n  }\n\nexport const formatDateShortWithWeekday = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n})\n\nexport const formatDateShortWithWeekdayAndYear = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateShort = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n})\n\nexport const formatDateShortWithYear = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateLong = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n})\n\nexport const formatDateLongWithYear = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateWithTime = (\n  dateInput?: string | Date | null,\n  locale?: string,\n): { time: string; date: string } => {\n  const date = normalizeToDate(dateInput)\n  if (!date) return { time: '', date: '' }\n\n  const time = date.toLocaleTimeString(locale, {\n    hour: 'numeric',\n    minute: '2-digit',\n    hour12: true,\n    timeZoneName: 'short',\n  })\n\n  const dateString = date.toLocaleDateString(locale, {\n    weekday: 'short',\n    month: 'short',\n    day: 'numeric',\n  })\n\n  return { time, date: dateString }\n}\n\nexport const formatPayPeriod = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n): { startDate: string; endDate: string } => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) {\n    return { startDate: '', endDate: '' }\n  }\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: 'long',\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return { startDate: startFormatted, endDate: endFormatted }\n}\n\nexport const formatPayPeriodRange = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n  options?: { useShortMonth?: boolean },\n): string => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) return ''\n\n  const monthFormat = options?.useShortMonth ? 'short' : 'long'\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return `${startFormatted}–${endFormatted}`\n}\n\nexport const formatDateToStringDate = (date: Date): string | null => {\n  if (isNaN(date.getTime())) {\n    return null\n  }\n  return date.toISOString().split('T')[0] || null\n}\n\n/**\n * Normalizes Date to local midnight, handling timezone issues from any adapter.\n */\nexport const normalizeDateToLocal = (date: Date | null): Date | null => {\n  if (!date || isNaN(date.getTime())) {\n    return null\n  }\n\n  const isoString = date.toISOString()\n  const [datePart] = isoString.split('T')\n  if (!datePart) return null\n\n  const parts = datePart.split('-')\n  if (parts.length !== 3) return null\n  const numbers = parts.map(Number)\n  const year = numbers[0]!\n  const month = numbers[1]!\n  const day = numbers[2]!\n  if (isNaN(year) || isNaN(month) || isNaN(day) || month < 1 || month > 12 || day < 1 || day > 31) {\n    return null\n  }\n\n  return new Date(year, month - 1, day)\n}\n\nexport const MS_PER_HOUR = 1000 * 60 * 60\nconst MS_PER_DAY = MS_PER_HOUR * 24\n\nexport const getHoursUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_HOUR\n}\n\nexport const getDaysUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_DAY\n}\n\nexport const isWeekend = (date: Date): boolean => {\n  const day = date.getDay()\n  return day === 0 || day === 6\n}\n\nexport const addDays = (date: Date, days: number): Date => {\n  const result = new Date(date)\n  result.setDate(result.getDate() + days)\n  return result\n}\n\nexport const addBusinessDays = (startDate: Date, businessDays: number): Date => {\n  let currentDate = new Date(startDate)\n  currentDate.setHours(0, 0, 0, 0)\n  let daysAdded = 0\n\n  while (daysAdded < businessDays) {\n    currentDate = addDays(currentDate, 1)\n    if (!isWeekend(currentDate)) {\n      daysAdded++\n    }\n  }\n\n  return currentDate\n}\n\n/** Formats numeric month and day as a zero-padded `MM-DD` string. */\nexport function formatMonthDay(month?: number, day?: number): string | undefined {\n  if (month == null || day == null) return undefined\n  return `${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`\n}\n"],"names":["normalizeToDate","dateInput","parts","numbers","year","month","day","parsedDate","createDateFormatter","options","locale","date","formatDateShortWithWeekday","formatDateShortWithWeekdayAndYear","formatDateShort","formatDateShortWithYear","formatDateLong","formatDateLongWithYear","formatDateWithTime","time","dateString","formatPayPeriod","startDateInput","endDateInput","startDate","endDate","startFormatted","endFormatted","formatPayPeriodRange","monthFormat","formatDateToStringDate","normalizeDateToLocal","isoString","datePart","MS_PER_HOUR","MS_PER_DAY","getHoursUntil","deadline","deadlineDate","now","getDaysUntil","isWeekend","addDays","days","result","addBusinessDays","businessDays","currentDate","daysAdded","formatMonthDay"],"mappings":"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"}
+{"version":3,"file":"dateFormatting.js","sources":["../../src/helpers/dateFormatting.ts"],"sourcesContent":["/**\n * Normalizes any date input (string, Date, or undefined) to a Date object.\n * Handles YYYY-MM-DD strings by parsing them in local timezone to avoid timezone issues.\n * Also handles ISO timestamp strings for compatibility.\n * Returns null for invalid inputs.\n */\nexport const normalizeToDate = (dateInput?: string | Date | null): Date | null => {\n  if (!dateInput) return null\n\n  if (typeof dateInput === 'string') {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(dateInput)) {\n      const parts = dateInput.split('-')\n      if (parts.length !== 3) return null\n\n      const numbers = parts.map(Number)\n      const year = numbers[0]\n      const month = numbers[1]\n      const day = numbers[2]\n      if (year === undefined || month === undefined || day === undefined) {\n        return null\n      }\n\n      if (\n        isNaN(year) ||\n        isNaN(month) ||\n        isNaN(day) ||\n        month < 1 ||\n        month > 12 ||\n        day < 1 ||\n        day > 31\n      ) {\n        return null\n      }\n\n      return new Date(year, month - 1, day)\n    }\n\n    const parsedDate = new Date(dateInput)\n    return isNaN(parsedDate.getTime()) ? null : parsedDate\n  }\n\n  if (dateInput instanceof Date) {\n    return isNaN(dateInput.getTime()) ? null : dateInput\n  }\n\n  return null\n}\n\n/**\n * Creates a date formatter function that handles both string and Date inputs.\n */\nconst createDateFormatter =\n  (options: Intl.DateTimeFormatOptions) =>\n  (dateInput?: string | Date | null, locale?: string): string => {\n    const date = normalizeToDate(dateInput)\n    if (!date) return ''\n    return date.toLocaleDateString(locale, options)\n  }\n\nexport const formatDateShortWithWeekday = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n})\n\nexport const formatDateShortWithWeekdayAndYear = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateShort = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n})\n\nexport const formatDateShortWithYear = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateLong = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n})\n\nexport const formatDateLongWithYear = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n  year: 'numeric',\n})\n\nexport const formatDateWithTime = (\n  dateInput?: string | Date | null,\n  locale?: string,\n): { time: string; date: string } => {\n  const date = normalizeToDate(dateInput)\n  if (!date) return { time: '', date: '' }\n\n  const time = date.toLocaleTimeString(locale, {\n    hour: 'numeric',\n    minute: '2-digit',\n    hour12: true,\n    timeZoneName: 'short',\n  })\n\n  const dateString = date.toLocaleDateString(locale, {\n    weekday: 'short',\n    month: 'short',\n    day: 'numeric',\n  })\n\n  return { time, date: dateString }\n}\n\nexport const formatPayPeriod = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n): { startDate: string; endDate: string } => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) {\n    return { startDate: '', endDate: '' }\n  }\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: 'long',\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return { startDate: startFormatted, endDate: endFormatted }\n}\n\nexport const formatPayPeriodRange = (\n  startDateInput?: string | Date | null,\n  endDateInput?: string | Date | null,\n  locale?: string,\n  options?: { useShortMonth?: boolean },\n): string => {\n  const startDate = normalizeToDate(startDateInput)\n  const endDate = normalizeToDate(endDateInput)\n\n  if (!startDate || !endDate) return ''\n\n  const monthFormat = options?.useShortMonth ? 'short' : 'long'\n\n  const startFormatted = startDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n  })\n\n  const endFormatted = endDate.toLocaleDateString(locale, {\n    month: monthFormat,\n    day: 'numeric',\n    year: 'numeric',\n  })\n\n  return `${startFormatted}–${endFormatted}`\n}\n\nexport const formatDateToStringDate = (date: Date): string | null => {\n  if (isNaN(date.getTime())) {\n    return null\n  }\n  return date.toISOString().split('T')[0] || null\n}\n\n/**\n * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local\n * time, so the calendar date is preserved regardless of the runtime timezone.\n *\n * Unlike `formatDateToStringDate` (which reads UTC), this function reads the\n * local year/month/day — safe for dates parsed from locale-format strings\n * (e.g. \"4/16/1998\") or ISO strings, both of which `normalizeToDate` lands at\n * local midnight.\n *\n * Returns `''` for null, undefined, empty, or unparseable input.\n */\nexport const normalizeToISOString = (value?: string | null): string => {\n  if (!value) return ''\n  const date = normalizeToDate(value)\n  if (!date) return ''\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Normalizes Date to local midnight, handling timezone issues from any adapter.\n */\nexport const normalizeDateToLocal = (date: Date | null): Date | null => {\n  if (!date || isNaN(date.getTime())) {\n    return null\n  }\n\n  const isoString = date.toISOString()\n  const [datePart] = isoString.split('T')\n  if (!datePart) return null\n\n  const parts = datePart.split('-')\n  if (parts.length !== 3) return null\n  const numbers = parts.map(Number)\n  const year = numbers[0]!\n  const month = numbers[1]!\n  const day = numbers[2]!\n  if (isNaN(year) || isNaN(month) || isNaN(day) || month < 1 || month > 12 || day < 1 || day > 31) {\n    return null\n  }\n\n  return new Date(year, month - 1, day)\n}\n\nexport const MS_PER_HOUR = 1000 * 60 * 60\nconst MS_PER_DAY = MS_PER_HOUR * 24\n\nexport const getHoursUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_HOUR\n}\n\nexport const getDaysUntil = (deadline?: Date | string | null): number | null => {\n  const deadlineDate = normalizeToDate(deadline)\n  if (!deadlineDate) return null\n\n  const now = new Date()\n  const timeDiffMs = deadlineDate.getTime() - now.getTime()\n  return timeDiffMs / MS_PER_DAY\n}\n\nexport const isWeekend = (date: Date): boolean => {\n  const day = date.getDay()\n  return day === 0 || day === 6\n}\n\nexport const addDays = (date: Date, days: number): Date => {\n  const result = new Date(date)\n  result.setDate(result.getDate() + days)\n  return result\n}\n\nexport const addBusinessDays = (startDate: Date, businessDays: number): Date => {\n  let currentDate = new Date(startDate)\n  currentDate.setHours(0, 0, 0, 0)\n  let daysAdded = 0\n\n  while (daysAdded < businessDays) {\n    currentDate = addDays(currentDate, 1)\n    if (!isWeekend(currentDate)) {\n      daysAdded++\n    }\n  }\n\n  return currentDate\n}\n\n/** Formats numeric month and day as a zero-padded `MM-DD` string. */\nexport function formatMonthDay(month?: number, day?: number): string | undefined {\n  if (month == null || day == null) return undefined\n  return `${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`\n}\n"],"names":["normalizeToDate","dateInput","parts","numbers","year","month","day","parsedDate","createDateFormatter","options","locale","date","formatDateShortWithWeekday","formatDateShortWithWeekdayAndYear","formatDateShort","formatDateShortWithYear","formatDateLong","formatDateLongWithYear","formatDateWithTime","time","dateString","formatPayPeriod","startDateInput","endDateInput","startDate","endDate","startFormatted","endFormatted","formatPayPeriodRange","monthFormat","formatDateToStringDate","normalizeToISOString","value","normalizeDateToLocal","isoString","datePart","MS_PER_HOUR","MS_PER_DAY","getHoursUntil","deadline","deadlineDate","now","getDaysUntil","isWeekend","addDays","days","result","addBusinessDays","businessDays","currentDate","daysAdded","formatMonthDay"],"mappings":"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"}

package/dist/helpers/formattedStrings.d.ts

@@ -6,6 +6,8 @@ export declare const firstLastName: ({ first_name, last_name, }: {
     last_name?: string | null;
 }) => string;
 export declare const getStreet: (address: EmployeeAddress | Location) => string;
+/** Joins street lines with a comma for display (avoids getStreet’s leading-space/comma quirks). */
+export declare const formatStreetForDisplay: (address: EmployeeAddress | Location) => string;
 export declare const getCityStateZip: (address: EmployeeAddress | Location) => string;
 export declare const addressInline: (address: EmployeeAddress | Location) => string;
 export declare const currentDateString: () => string;