@gusto/embedded-react-sdk 0.46.3 → 0.47.1

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'\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;"}
+{"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 * @remarks Walks each node's `parent` pointer to assemble a root-to-state trail, producing\n * one entry per state. Use it to seed breadcrumb navigation when initializing a state\n * machine or multi-step flow.\n *\n * @param nodes - Map of state names to breadcrumb nodes, each carrying an `item` and an\n * optional `parent` state key.\n * @returns A map from state name to its ordered breadcrumb trail.\n * @internal\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 * @remarks Supports Handlebars-style `{{variableName}}` syntax. Values enclosed in double\n * braces are replaced with the corresponding key on `context`; missing keys resolve to an\n * empty string. Strings without a template token are returned unchanged.\n *\n * @param variables - Map of variable names to either a literal or a `{{key}}` template.\n * Pass `undefined` to skip resolution.\n * @param context - Source values referenced by template tokens.\n * @returns A map of variable names to resolved values, or an empty object when `variables`\n * is `undefined`.\n * @internal\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 *\n * @remarks Preserves existing trails and CTA; if the context has no breadcrumbs header\n * a fresh one is created. Use this when a transition needs to flip breadcrumb visibility\n * (for example `currentBreadcrumbId`) without rebuilding any trails.\n *\n * @typeParam T - Context shape carrying an optional `header` of the discriminated union.\n * @param context - The context whose breadcrumbs header should be patched.\n * @param patch - Partial breadcrumbs-header fields to merge in. The `type` discriminator\n * cannot be overridden.\n * @returns A new context with the patched breadcrumbs header.\n * @internal\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 every trail in the context's breadcrumbs header.\n *\n * @remarks Use in state machine reducers to hide a step entirely, for example after\n * payroll submission when the step should no longer appear in any trail.\n *\n * @typeParam T - Context shape carrying an optional `header` of the discriminated union.\n * @param breadcrumbId - Id of the breadcrumb to strip from every trail.\n * @param context - The context whose breadcrumbs header should be updated.\n * @returns A new context with the breadcrumb removed from all trails.\n * @internal\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 every trail in the context's breadcrumbs header.\n *\n * @remarks Use in state machine reducers to disable backward navigation to a specific step\n * while still showing it in the trail.\n *\n * @typeParam T - Context shape carrying an optional `header` of the discriminated union.\n * @param breadcrumbId - Id of the breadcrumb to mark `isNavigable: false`.\n * @param context - The context whose breadcrumbs header should be updated.\n * @returns A new context with the breadcrumb locked in every trail.\n * @internal\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 and switches\n * the active breadcrumb to that state.\n *\n * @remarks Typically called from state machine transitions to update breadcrumb navigation\n * when moving between states. Existing trails for other states are preserved; only the trail\n * for `stateName` is rewritten with `variables` resolved against the context. The resulting\n * context's header is always of type `'breadcrumbs'`.\n *\n * @typeParam T - Context shape carrying an optional `header` of the discriminated union.\n * @param stateName - The state whose breadcrumb trail should be updated and made active.\n * @param context - The context whose breadcrumbs header should be updated.\n * @param variables - Optional template variables to resolve against the context for each\n * breadcrumb in the target state's trail.\n * @returns A new context with the trail for `stateName` updated and `currentBreadcrumbId`\n * set to `stateName`.\n * @internal\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,GAeJC,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,GAgBaM,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,GAgBaK,IAAyB,CACpCN,GACAO,MACsC;AACtC,QAAMC,IAAWpB,EAAqBY,EAAQ,MAAM;AACpD,SAAO,EAAE,GAAGA,GAAS,QAAQ,EAAE,GAAGQ,GAAU,GAAGD,IAAM;AACvD,GAcaE,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,GA+CaG,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/currencyHelpers.d.ts

@@ -1,2 +1,16 @@
+/**
+ * Converts a dollar amount to whole cents, rounding to the nearest cent.
+ *
+ * @param dollars - Amount in dollars, or `null` to pass through.
+ * @returns The amount in cents, or `null` if the input was `null`.
+ * @internal
+ */
 export declare const dollarsToCents: (dollars: number | null) => number | null;
+/**
+ * Converts a cents amount to dollars without rounding.
+ *
+ * @param cents - Amount in cents, or `null` to pass through.
+ * @returns The amount in dollars as a floating-point number, or `null` if the input was `null`.
+ * @internal
+ */
 export declare const centsToDollars: (cents: number | null) => number | null;

package/dist/helpers/currencyHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"currencyHelpers.js","sources":["../../src/helpers/currencyHelpers.ts"],"sourcesContent":["export const dollarsToCents = (dollars: number | null): number | null => {\n  if (dollars === null) return null\n  return Math.round(dollars * 100)\n}\n\nexport const centsToDollars = (cents: number | null): number | null => {\n  if (cents === null) return null\n  return cents / 100\n}\n"],"names":["dollarsToCents","dollars","centsToDollars","cents"],"mappings":"AAAO,MAAMA,IAAiB,CAACC,MACzBA,MAAY,OAAa,OACtB,KAAK,MAAMA,IAAU,GAAG,GAGpBC,IAAiB,CAACC,MACzBA,MAAU,OAAa,OACpBA,IAAQ;"}
+{"version":3,"file":"currencyHelpers.js","sources":["../../src/helpers/currencyHelpers.ts"],"sourcesContent":["/**\n * Converts a dollar amount to whole cents, rounding to the nearest cent.\n *\n * @param dollars - Amount in dollars, or `null` to pass through.\n * @returns The amount in cents, or `null` if the input was `null`.\n * @internal\n */\nexport const dollarsToCents = (dollars: number | null): number | null => {\n  if (dollars === null) return null\n  return Math.round(dollars * 100)\n}\n\n/**\n * Converts a cents amount to dollars without rounding.\n *\n * @param cents - Amount in cents, or `null` to pass through.\n * @returns The amount in dollars as a floating-point number, or `null` if the input was `null`.\n * @internal\n */\nexport const centsToDollars = (cents: number | null): number | null => {\n  if (cents === null) return null\n  return cents / 100\n}\n"],"names":["dollarsToCents","dollars","centsToDollars","cents"],"mappings":"AAOO,MAAMA,IAAiB,CAACC,MACzBA,MAAY,OAAa,OACtB,KAAK,MAAMA,IAAU,GAAG,GAUpBC,IAAiB,CAACC,MACzBA,MAAU,OAAa,OACpBA,IAAQ;"}

package/dist/helpers/dateFormatting.d.ts

@@ -1,51 +1,186 @@
 /**
  * Normalizes any date input (string, Date, or undefined) to a Date object.
- * Handles YYYY-MM-DD strings by parsing them in local timezone to avoid timezone issues.
- * Also handles ISO timestamp strings for compatibility.
- * Returns null for invalid inputs.
+ *
+ * @remarks Handles `YYYY-MM-DD` strings by parsing them in local time to avoid
+ * timezone drift. Also accepts ISO timestamp strings and existing `Date`
+ * instances. Returns `null` for nullish, empty, or unparseable input.
+ *
+ * @param dateInput - The date value to normalize.
+ * @returns A `Date` instance, or `null` if the input is missing or invalid.
+ * @internal
  */
 export declare const normalizeToDate: (dateInput?: string | Date | null) => Date | null;
+/**
+ * Formats a date as a short weekday plus short month and day (e.g. `Mon, Jan 5`).
+ *
+ * @internal
+ */
 export declare const formatDateShortWithWeekday: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a short weekday, short month, day, and year (e.g. `Mon, Jan 5, 2025`).
+ *
+ * @internal
+ */
 export declare const formatDateShortWithWeekdayAndYear: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a short month and day (e.g. `Jan 5`).
+ *
+ * @internal
+ */
 export declare const formatDateShort: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a short month, day, and year (e.g. `Jan 5, 2025`).
+ *
+ * @internal
+ */
 export declare const formatDateShortWithYear: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a long month and day (e.g. `January 5`).
+ *
+ * @internal
+ */
 export declare const formatDateLong: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Formats a date as a long month, day, and year (e.g. `January 5, 2025`).
+ *
+ * @internal
+ */
 export declare const formatDateLongWithYear: (dateInput?: string | Date | null, locale?: string) => string;
+/**
+ * Splits a date into separate locale-formatted time and date strings.
+ *
+ * @param dateInput - The date value to format.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.
+ * @returns An object with `time` (e.g. `3:45 PM EST`) and `date` (e.g. `Mon, Jan 5`).
+ * Both fields are empty strings when the input cannot be parsed.
+ * @internal
+ */
 export declare const formatDateWithTime: (dateInput?: string | Date | null, locale?: string) => {
     time: string;
     date: string;
 };
+/**
+ * Formats a pay period start and end date for display as separate fields.
+ *
+ * @remarks Start date renders with the long month and day; end date renders
+ * with the short month, day, and year.
+ *
+ * @param startDateInput - Pay period start date.
+ * @param endDateInput - Pay period end date.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.
+ * @returns Formatted `startDate` and `endDate` strings. Both fields are empty
+ * strings when either input cannot be parsed.
+ * @internal
+ */
 export declare const formatPayPeriod: (startDateInput?: string | Date | null, endDateInput?: string | Date | null, locale?: string) => {
     startDate: string;
     endDate: string;
 };
+/**
+ * Formats a pay period as a single en-dash–separated range string.
+ *
+ * @param startDateInput - Pay period start date.
+ * @param endDateInput - Pay period end date.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.
+ * @param options - When `useShortMonth` is true, both ends use short month names.
+ * Otherwise the start uses the long month name and the end uses short.
+ * @returns The formatted range (e.g. `January 1–Jan 15, 2025`), or an empty
+ * string when either input cannot be parsed.
+ * @internal
+ */
 export declare const formatPayPeriodRange: (startDateInput?: string | Date | null, endDateInput?: string | Date | null, locale?: string, options?: {
     useShortMonth?: boolean;
 }) => string;
+/**
+ * Formats a `Date` as a `YYYY-MM-DD` string using the local year, month, and day.
+ *
+ * @param date - The date to format.
+ * @returns A zero-padded `YYYY-MM-DD` string, or `null` when the input is an invalid date.
+ * @internal
+ */
 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.
+ * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local time.
  *
- * 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.
+ * @remarks Reads the local year, month, and day so the calendar date is
+ * preserved regardless of the runtime timezone. Safe for dates parsed from
+ * locale-format strings (e.g. `4/16/1998`) or ISO strings, both of which land
+ * at local midnight when normalized.
  *
- * Returns `''` for null, undefined, empty, or unparseable input.
+ * @param value - The date string to convert.
+ * @returns A `YYYY-MM-DD` string, or `''` for nullish, empty, or unparseable input.
+ * @internal
  */
 export declare const normalizeToISOString: (value?: string | null) => string;
 /**
- * Normalizes Date to local midnight, handling timezone issues from any adapter.
+ * Normalizes a `Date` to local midnight, stripping any time-of-day component.
+ *
+ * @param date - The date to normalize, or `null`.
+ * @returns A new `Date` at local midnight, or `null` when the input is missing or invalid.
+ * @internal
  */
 export declare const normalizeDateToLocal: (date: Date | null) => Date | null;
+/**
+ * Number of milliseconds in one hour.
+ *
+ * @internal
+ */
 export declare const MS_PER_HOUR: number;
+/**
+ * Returns the number of hours from now until a deadline.
+ *
+ * @param deadline - Target date in the future (or past, for negative results).
+ * @returns Hours until `deadline` (fractional, negative if `deadline` is in
+ * the past), or `null` when the input cannot be parsed.
+ * @internal
+ */
 export declare const getHoursUntil: (deadline?: Date | string | null) => number | null;
+/**
+ * Returns the number of days from now until a deadline.
+ *
+ * @param deadline - Target date in the future (or past, for negative results).
+ * @returns Days until `deadline` (fractional, negative if `deadline` is in
+ * the past), or `null` when the input cannot be parsed.
+ * @internal
+ */
 export declare const getDaysUntil: (deadline?: Date | string | null) => number | null;
-export declare const isWeekend: (date: Date) => boolean;
+/**
+ * Returns a new `Date` offset from the input by a given number of days.
+ *
+ * @param date - The base date. Not mutated.
+ * @param days - Number of days to add (negative values subtract).
+ * @returns A new `Date` shifted by `days`.
+ * @internal
+ */
 export declare const addDays: (date: Date, days: number) => Date;
+/**
+ * Returns a new `Date` offset by a given number of business days (Monday–Friday).
+ *
+ * @remarks Skips Saturdays and Sundays when counting. The result is normalized
+ * to local midnight. Does not account for holidays.
+ *
+ * @param startDate - The base date. Not mutated.
+ * @param businessDays - Number of business days to add.
+ * @returns A new `Date` shifted forward by `businessDays` weekdays.
+ * @internal
+ */
 export declare const addBusinessDays: (startDate: Date, businessDays: number) => Date;
-/** Formats numeric month and day as a zero-padded `MM-DD` string. */
+/**
+ * Formats numeric month and day as a zero-padded `MM-DD` string.
+ *
+ * @param month - Month number, 1–12.
+ * @param day - Day-of-month number, 1–31.
+ * @returns A `MM-DD` string, or `undefined` when either argument is missing.
+ * @internal
+ */
 export declare function formatMonthDay(month?: number, day?: number): string | undefined;
-/** Returns the number of days in a given month (1-indexed). Uses a non-leap year so February always returns 28. */
+/**
+ * Returns the number of days in a given month (1-indexed).
+ *
+ * @remarks Uses a non-leap year, so February always returns 28.
+ *
+ * @param month - Month number, 1–12.
+ * @returns The number of days in that month.
+ * @internal
+ */
 export declare function getDaysInMonth(month: number): number;

package/dist/helpers/dateFormatting.js

@@ -136,7 +136,6 @@ export {
   R as getDaysInMonth,
   k as getDaysUntil,
   Y as getHoursUntil,
-  g as isWeekend,
   W as normalizeDateToLocal,
   s as normalizeToDate,
   F as normalizeToISOString

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  const year = String(date.getFullYear()).padStart(4, '0')\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 * 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  return new Date(date.getFullYear(), date.getMonth(), date.getDate())\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\n/** Returns the number of days in a given month (1-indexed). Uses a non-leap year so February always returns 28. */\nexport function getDaysInMonth(month: number): number {\n  return new Date(2023, month, 0).getDate()\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","MS_PER_HOUR","MS_PER_DAY","getHoursUntil","deadline","deadlineDate","now","getDaysUntil","isWeekend","addDays","days","result","addBusinessDays","businessDays","currentDate","daysAdded","formatMonthDay","getDaysInMonth"],"mappings":"AAMO,MAAMA,IAAkB,CAACC,MAAkD;AAChF,MAAI,CAACA,EAAW,QAAO;AAEvB,MAAI,OAAOA,KAAc,UAAU;AACjC,QAAI,sBAAsB,KAAKA,CAAS,GAAG;AACzC,YAAMC,IAAQD,EAAU,MAAM,GAAG;AACjC,UAAIC,EAAM,WAAW,EAAG,QAAO;AAE/B,YAAMC,IAAUD,EAAM,IAAI,MAAM,GAC1BE,IAAOD,EAAQ,CAAC,GAChBE,IAAQF,EAAQ,CAAC,GACjBG,IAAMH,EAAQ,CAAC;AAKrB,aAJIC,MAAS,UAAaC,MAAU,UAAaC,MAAQ,UAKvD,MAAMF,CAAI,KACV,MAAMC,CAAK,KACX,MAAMC,CAAG,KACTD,IAAQ,KACRA,IAAQ,MACRC,IAAM,KACNA,IAAM,KAEC,OAGF,IAAI,KAAKF,GAAMC,IAAQ,GAAGC,CAAG;AAAA,IACtC;AAEA,UAAMC,IAAa,IAAI,KAAKN,CAAS;AACrC,WAAO,MAAMM,EAAW,QAAA,CAAS,IAAI,OAAOA;AAAA,EAC9C;AAEA,SAAIN,aAAqB,OAChB,MAAMA,EAAU,QAAA,CAAS,IAAI,OAAOA,IAGtC;AACT,GAKMO,IACJ,CAACC,MACD,CAACR,GAAkCS,MAA4B;AAC7D,QAAMC,IAAOX,EAAgBC,CAAS;AACtC,SAAKU,IACEA,EAAK,mBAAmBD,GAAQD,CAAO,IAD5B;AAEpB,GAEWG,IAA6BJ,EAAoB;AAAA,EAC5D,SAAS;AAAA,EACT,OAAO;AAAA,EACP,KAAK;AACP,CAAC,GAEYK,IAAoCL,EAAoB;AAAA,EACnE,SAAS;AAAA,EACT,OAAO;AAAA,EACP,KAAK;AAAA,EACL,MAAM;AACR,CAAC,GAEYM,IAAkBN,EAAoB;AAAA,EACjD,OAAO;AAAA,EACP,KAAK;AACP,CAAC,GAEYO,IAA0BP,EAAoB;AAAA,EACzD,OAAO;AAAA,EACP,KAAK;AAAA,EACL,MAAM;AACR,CAAC,GAEYQ,IAAiBR,EAAoB;AAAA,EAChD,OAAO;AAAA,EACP,KAAK;AACP,CAAC,GAEYS,IAAyBT,EAAoB;AAAA,EACxD,OAAO;AAAA,EACP,KAAK;AAAA,EACL,MAAM;AACR,CAAC,GAEYU,IAAqB,CAChCjB,GACAS,MACmC;AACnC,QAAMC,IAAOX,EAAgBC,CAAS;AACtC,MAAI,CAACU,EAAM,QAAO,EAAE,MAAM,IAAI,MAAM,GAAA;AAEpC,QAAMQ,IAAOR,EAAK,mBAAmBD,GAAQ;AAAA,IAC3C,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,cAAc;AAAA,EAAA,CACf,GAEKU,IAAaT,EAAK,mBAAmBD,GAAQ;AAAA,IACjD,SAAS;AAAA,IACT,OAAO;AAAA,IACP,KAAK;AAAA,EAAA,CACN;AAED,SAAO,EAAE,MAAAS,GAAM,MAAMC,EAAA;AACvB,GAEaC,IAAkB,CAC7BC,GACAC,GACAb,MAC2C;AAC3C,QAAMc,IAAYxB,EAAgBsB,CAAc,GAC1CG,IAAUzB,EAAgBuB,CAAY;AAE5C,MAAI,CAACC,KAAa,CAACC;AACjB,WAAO,EAAE,WAAW,IAAI,SAAS,GAAA;AAGnC,QAAMC,IAAiBF,EAAU,mBAAmBd,GAAQ;AAAA,IAC1D,OAAO;AAAA,IACP,KAAK;AAAA,EAAA,CACN,GAEKiB,IAAeF,EAAQ,mBAAmBf,GAAQ;AAAA,IACtD,OAAO;AAAA,IACP,KAAK;AAAA,IACL,MAAM;AAAA,EAAA,CACP;AAED,SAAO,EAAE,WAAWgB,GAAgB,SAASC,EAAA;AAC/C,GAEaC,IAAuB,CAClCN,GACAC,GACAb,GACAD,MACW;AACX,QAAMe,IAAYxB,EAAgBsB,CAAc,GAC1CG,IAAUzB,EAAgBuB,CAAY;AAE5C,MAAI,CAACC,KAAa,CAACC,EAAS,QAAO;AAEnC,QAAMI,IAAcpB,GAAS,gBAAgB,UAAU,QAEjDiB,IAAiBF,EAAU,mBAAmBd,GAAQ;AAAA,IAC1D,OAAOmB;AAAA,IACP,KAAK;AAAA,EAAA,CACN,GAEKF,IAAeF,EAAQ,mBAAmBf,GAAQ;AAAA,IACtD,OAAOmB;AAAA,IACP,KAAK;AAAA,IACL,MAAM;AAAA,EAAA,CACP;AAED,SAAO,GAAGH,CAAc,IAAIC,CAAY;AAC1C,GAEaG,IAAyB,CAACnB,MAA8B;AACnE,MAAI,MAAMA,EAAK,QAAA,CAAS;AACtB,WAAO;AAET,QAAMP,IAAO,OAAOO,EAAK,YAAA,CAAa,EAAE,SAAS,GAAG,GAAG,GACjDN,IAAQ,OAAOM,EAAK,SAAA,IAAa,CAAC,EAAE,SAAS,GAAG,GAAG,GACnDL,IAAM,OAAOK,EAAK,QAAA,CAAS,EAAE,SAAS,GAAG,GAAG;AAClD,SAAO,GAAGP,CAAI,IAAIC,CAAK,IAAIC,CAAG;AAChC,GAaayB,IAAuB,CAACC,MAAkC;AACrE,MAAI,CAACA,EAAO,QAAO;AACnB,QAAMrB,IAAOX,EAAgBgC,CAAK;AAClC,MAAI,CAACrB,EAAM,QAAO;AAClB,QAAMP,IAAOO,EAAK,YAAA,GACZN,IAAQ,OAAOM,EAAK,SAAA,IAAa,CAAC,EAAE,SAAS,GAAG,GAAG,GACnDL,IAAM,OAAOK,EAAK,QAAA,CAAS,EAAE,SAAS,GAAG,GAAG;AAClD,SAAO,GAAGP,CAAI,IAAIC,CAAK,IAAIC,CAAG;AAChC,GAKa2B,IAAuB,CAACtB,MAC/B,CAACA,KAAQ,MAAMA,EAAK,QAAA,CAAS,IACxB,OAEF,IAAI,KAAKA,EAAK,YAAA,GAAeA,EAAK,SAAA,GAAYA,EAAK,SAAS,GAGxDuB,IAAc,MAAO,KAAK,IACjCC,IAAaD,IAAc,IAEpBE,IAAgB,CAACC,MAAmD;AAC/E,QAAMC,IAAetC,EAAgBqC,CAAQ;AAC7C,MAAI,CAACC,EAAc,QAAO;AAE1B,QAAMC,wBAAU,KAAA;AAEhB,UADmBD,EAAa,QAAA,IAAYC,EAAI,QAAA,KAC5BL;AACtB,GAEaM,IAAe,CAACH,MAAmD;AAC9E,QAAMC,IAAetC,EAAgBqC,CAAQ;AAC7C,MAAI,CAACC,EAAc,QAAO;AAE1B,QAAMC,wBAAU,KAAA;AAEhB,UADmBD,EAAa,QAAA,IAAYC,EAAI,QAAA,KAC5BJ;AACtB,GAEaM,IAAY,CAAC9B,MAAwB;AAChD,QAAML,IAAMK,EAAK,OAAA;AACjB,SAAOL,MAAQ,KAAKA,MAAQ;AAC9B,GAEaoC,IAAU,CAAC/B,GAAYgC,MAAuB;AACzD,QAAMC,IAAS,IAAI,KAAKjC,CAAI;AAC5B,SAAAiC,EAAO,QAAQA,EAAO,QAAA,IAAYD,CAAI,GAC/BC;AACT,GAEaC,IAAkB,CAACrB,GAAiBsB,MAA+B;AAC9E,MAAIC,IAAc,IAAI,KAAKvB,CAAS;AACpC,EAAAuB,EAAY,SAAS,GAAG,GAAG,GAAG,CAAC;AAC/B,MAAIC,IAAY;AAEhB,SAAOA,IAAYF;AACjB,IAAAC,IAAcL,EAAQK,GAAa,CAAC,GAC/BN,EAAUM,CAAW,KACxBC;AAIJ,SAAOD;AACT;AAGO,SAASE,EAAe5C,GAAgBC,GAAkC;AAC/E,MAAI,EAAAD,KAAS,QAAQC,KAAO;AAC5B,WAAO,GAAG,OAAOD,CAAK,EAAE,SAAS,GAAG,GAAG,CAAC,IAAI,OAAOC,CAAG,EAAE,SAAS,GAAG,GAAG,CAAC;AAC1E;AAGO,SAAS4C,EAAe7C,GAAuB;AACpD,SAAO,IAAI,KAAK,MAAMA,GAAO,CAAC,EAAE,QAAA;AAClC;"}
+{"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 *\n * @remarks Handles `YYYY-MM-DD` strings by parsing them in local time to avoid\n * timezone drift. Also accepts ISO timestamp strings and existing `Date`\n * instances. Returns `null` for nullish, empty, or unparseable input.\n *\n * @param dateInput - The date value to normalize.\n * @returns A `Date` instance, or `null` if the input is missing or invalid.\n * @internal\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\n/**\n * Formats a date as a short weekday plus short month and day (e.g. `Mon, Jan 5`).\n *\n * @internal\n */\nexport const formatDateShortWithWeekday = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n})\n\n/**\n * Formats a date as a short weekday, short month, day, and year (e.g. `Mon, Jan 5, 2025`).\n *\n * @internal\n */\nexport const formatDateShortWithWeekdayAndYear = createDateFormatter({\n  weekday: 'short',\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\n/**\n * Formats a date as a short month and day (e.g. `Jan 5`).\n *\n * @internal\n */\nexport const formatDateShort = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n})\n\n/**\n * Formats a date as a short month, day, and year (e.g. `Jan 5, 2025`).\n *\n * @internal\n */\nexport const formatDateShortWithYear = createDateFormatter({\n  month: 'short',\n  day: 'numeric',\n  year: 'numeric',\n})\n\n/**\n * Formats a date as a long month and day (e.g. `January 5`).\n *\n * @internal\n */\nexport const formatDateLong = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n})\n\n/**\n * Formats a date as a long month, day, and year (e.g. `January 5, 2025`).\n *\n * @internal\n */\nexport const formatDateLongWithYear = createDateFormatter({\n  month: 'long',\n  day: 'numeric',\n  year: 'numeric',\n})\n\n/**\n * Splits a date into separate locale-formatted time and date strings.\n *\n * @param dateInput - The date value to format.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.\n * @returns An object with `time` (e.g. `3:45 PM EST`) and `date` (e.g. `Mon, Jan 5`).\n * Both fields are empty strings when the input cannot be parsed.\n * @internal\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\n/**\n * Formats a pay period start and end date for display as separate fields.\n *\n * @remarks Start date renders with the long month and day; end date renders\n * with the short month, day, and year.\n *\n * @param startDateInput - Pay period start date.\n * @param endDateInput - Pay period end date.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.\n * @returns Formatted `startDate` and `endDate` strings. Both fields are empty\n * strings when either input cannot be parsed.\n * @internal\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\n/**\n * Formats a pay period as a single en-dash–separated range string.\n *\n * @param startDateInput - Pay period start date.\n * @param endDateInput - Pay period end date.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleDateString`.\n * @param options - When `useShortMonth` is true, both ends use short month names.\n * Otherwise the start uses the long month name and the end uses short.\n * @returns The formatted range (e.g. `January 1–Jan 15, 2025`), or an empty\n * string when either input cannot be parsed.\n * @internal\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\n/**\n * Formats a `Date` as a `YYYY-MM-DD` string using the local year, month, and day.\n *\n * @param date - The date to format.\n * @returns A zero-padded `YYYY-MM-DD` string, or `null` when the input is an invalid date.\n * @internal\n */\nexport const formatDateToStringDate = (date: Date): string | null => {\n  if (isNaN(date.getTime())) {\n    return null\n  }\n  const year = String(date.getFullYear()).padStart(4, '0')\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 * Converts any parseable date string to a `YYYY-MM-DD` ISO string using local time.\n *\n * @remarks Reads the local year, month, and day so the calendar date is\n * preserved regardless of the runtime timezone. Safe for dates parsed from\n * locale-format strings (e.g. `4/16/1998`) or ISO strings, both of which land\n * at local midnight when normalized.\n *\n * @param value - The date string to convert.\n * @returns A `YYYY-MM-DD` string, or `''` for nullish, empty, or unparseable input.\n * @internal\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 a `Date` to local midnight, stripping any time-of-day component.\n *\n * @param date - The date to normalize, or `null`.\n * @returns A new `Date` at local midnight, or `null` when the input is missing or invalid.\n * @internal\n */\nexport const normalizeDateToLocal = (date: Date | null): Date | null => {\n  if (!date || isNaN(date.getTime())) {\n    return null\n  }\n  return new Date(date.getFullYear(), date.getMonth(), date.getDate())\n}\n\n/**\n * Number of milliseconds in one hour.\n *\n * @internal\n */\nexport const MS_PER_HOUR = 1000 * 60 * 60\nconst MS_PER_DAY = MS_PER_HOUR * 24\n\n/**\n * Returns the number of hours from now until a deadline.\n *\n * @param deadline - Target date in the future (or past, for negative results).\n * @returns Hours until `deadline` (fractional, negative if `deadline` is in\n * the past), or `null` when the input cannot be parsed.\n * @internal\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\n/**\n * Returns the number of days from now until a deadline.\n *\n * @param deadline - Target date in the future (or past, for negative results).\n * @returns Days until `deadline` (fractional, negative if `deadline` is in\n * the past), or `null` when the input cannot be parsed.\n * @internal\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\n/**\n * Returns whether a date falls on Saturday or Sunday.\n *\n * @param date - The date to test.\n * @returns `true` if `date` is a weekend day.\n * @internal\n */\nconst isWeekend = (date: Date): boolean => {\n  const day = date.getDay()\n  return day === 0 || day === 6\n}\n\n/**\n * Returns a new `Date` offset from the input by a given number of days.\n *\n * @param date - The base date. Not mutated.\n * @param days - Number of days to add (negative values subtract).\n * @returns A new `Date` shifted by `days`.\n * @internal\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\n/**\n * Returns a new `Date` offset by a given number of business days (Monday–Friday).\n *\n * @remarks Skips Saturdays and Sundays when counting. The result is normalized\n * to local midnight. Does not account for holidays.\n *\n * @param startDate - The base date. Not mutated.\n * @param businessDays - Number of business days to add.\n * @returns A new `Date` shifted forward by `businessDays` weekdays.\n * @internal\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/**\n * Formats numeric month and day as a zero-padded `MM-DD` string.\n *\n * @param month - Month number, 1–12.\n * @param day - Day-of-month number, 1–31.\n * @returns A `MM-DD` string, or `undefined` when either argument is missing.\n * @internal\n */\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\n/**\n * Returns the number of days in a given month (1-indexed).\n *\n * @remarks Uses a non-leap year, so February always returns 28.\n *\n * @param month - Month number, 1–12.\n * @returns The number of days in that month.\n * @internal\n */\nexport function getDaysInMonth(month: number): number {\n  return new Date(2023, month, 0).getDate()\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","MS_PER_HOUR","MS_PER_DAY","getHoursUntil","deadline","deadlineDate","now","getDaysUntil","isWeekend","addDays","days","result","addBusinessDays","businessDays","currentDate","daysAdded","formatMonthDay","getDaysInMonth"],"mappings":"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"}

package/dist/helpers/ensureRequired.d.ts

@@ -1 +1,13 @@
+/**
+ * Asserts that a value is defined, throwing a translated error otherwise.
+ *
+ * @remarks Used to narrow `T | undefined` to `T` at call sites where the value
+ * is required by contract but the type system allows `undefined`.
+ *
+ * @typeParam T - The non-undefined value type.
+ * @param prop - The value to assert.
+ * @returns The same value with the `undefined` branch removed from its type.
+ * @throws Error when `prop` is `undefined`.
+ * @internal
+ */
 export declare function ensureRequired<T>(prop: T | undefined): T;

package/dist/helpers/ensureRequired.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensureRequired.js","sources":["../../src/helpers/ensureRequired.ts"],"sourcesContent":["import { t } from 'i18next'\n\nexport function ensureRequired<T>(prop: T | undefined): T {\n  if (prop === undefined) {\n    throw new Error(t('errors.ensureRequired'))\n  }\n  return prop\n}\n"],"names":["ensureRequired","prop","t"],"mappings":";AAEO,SAASA,EAAkBC,GAAwB;AACxD,MAAIA,MAAS;AACX,UAAM,IAAI,MAAMC,EAAE,uBAAuB,CAAC;AAE5C,SAAOD;AACT;"}
+{"version":3,"file":"ensureRequired.js","sources":["../../src/helpers/ensureRequired.ts"],"sourcesContent":["import { t } from 'i18next'\n\n/**\n * Asserts that a value is defined, throwing a translated error otherwise.\n *\n * @remarks Used to narrow `T | undefined` to `T` at call sites where the value\n * is required by contract but the type system allows `undefined`.\n *\n * @typeParam T - The non-undefined value type.\n * @param prop - The value to assert.\n * @returns The same value with the `undefined` branch removed from its type.\n * @throws Error when `prop` is `undefined`.\n * @internal\n */\nexport function ensureRequired<T>(prop: T | undefined): T {\n  if (prop === undefined) {\n    throw new Error(t('errors.ensureRequired'))\n  }\n  return prop\n}\n"],"names":["ensureRequired","prop","t"],"mappings":";AAcO,SAASA,EAAkBC,GAAwB;AACxD,MAAIA,MAAS;AACX,UAAM,IAAI,MAAMC,EAAE,uBAAuB,CAAC;AAE5C,SAAOD;AACT;"}

package/dist/helpers/federalEin.d.ts

@@ -1,9 +1,20 @@
 /**
- * Normalizes string input to a 9 digit EIN format with two leading digits, a dash, and 7 trailing digits removing any non-numeric characters.
+ * Normalizes a raw string to the federal EIN display format `NN-NNNNNNN`.
  *
- * @param value - Raw string value to be formatted as a federal EIN
- * @returns String in the federal EIN format with all invalid characters removed
+ * @remarks Strips non-numeric characters, then inserts a dash between the
+ * first two digits and the remaining seven. Returns an empty string when no
+ * digits are present.
+ *
+ * @param value - Raw string value to be formatted as a federal EIN.
+ * @returns A string in `NN-NNNNNNN` format with non-digit characters removed.
+ * @internal
  */
 export declare const normalizeEin: (value: string) => string;
-export declare const createPlaceholderEin: (hasEin?: boolean, placeholderEin?: string) => string | undefined;
+/**
+ * Hook that returns a translated placeholder string for a masked EIN field.
+ *
+ * @param hasEin - Whether the form currently has a stored EIN value.
+ * @returns The translated placeholder when `hasEin` is true; otherwise an empty string.
+ * @internal
+ */
 export declare const usePlaceholderEin: (hasEin?: boolean) => string | undefined;

package/dist/helpers/federalEin.js

@@ -4,7 +4,6 @@ const r = (n) => n.match(/\d*/g)?.join("").match(/(\d{0,2})(\d{0,7})/)?.slice(1)
   return t(n, e("inputs.ein.placeholder"));
 };
 export {
-  t as createPlaceholderEin,
   r as normalizeEin,
   c as usePlaceholderEin
 };

package/dist/helpers/federalEin.js.map

@@ -1 +1 @@
-{"version":3,"file":"federalEin.js","sources":["../../src/helpers/federalEin.ts"],"sourcesContent":["import { useTranslation } from 'react-i18next'\n\n/**\n * Normalizes string input to a 9 digit EIN format with two leading digits, a dash, and 7 trailing digits removing any non-numeric characters.\n *\n * @param value - Raw string value to be formatted as a federal EIN\n * @returns String in the federal EIN format with all invalid characters removed\n */\nexport const normalizeEin = (value: string) =>\n  value\n    .match(/\\d*/g)\n    ?.join('')\n    .match(/(\\d{0,2})(\\d{0,7})/)\n    ?.slice(1)\n    .filter(match => match !== '')\n    .join('-')\n    .substring(0, 10) || ''\n\nexport const createPlaceholderEin = (hasEin?: boolean, placeholderEin?: string) =>\n  hasEin ? placeholderEin : ''\n\nexport const usePlaceholderEin = (hasEin?: boolean) => {\n  const { t } = useTranslation('common')\n  return createPlaceholderEin(hasEin, t('inputs.ein.placeholder'))\n}\n"],"names":["normalizeEin","value","match","createPlaceholderEin","hasEin","placeholderEin","usePlaceholderEin","t","useTranslation"],"mappings":";AAQO,MAAMA,IAAe,CAACC,MAC3BA,EACG,MAAM,MAAM,GACX,KAAK,EAAE,EACR,MAAM,oBAAoB,GACzB,MAAM,CAAC,EACR,OAAO,CAAAC,MAASA,MAAU,EAAE,EAC5B,KAAK,GAAG,EACR,UAAU,GAAG,EAAE,KAAK,IAEZC,IAAuB,CAACC,GAAkBC,MACrDD,IAASC,IAAiB,IAEfC,IAAoB,CAACF,MAAqB;AACrD,QAAM,EAAE,GAAAG,EAAA,IAAMC,EAAe,QAAQ;AACrC,SAAOL,EAAqBC,GAAQG,EAAE,wBAAwB,CAAC;AACjE;"}
+{"version":3,"file":"federalEin.js","sources":["../../src/helpers/federalEin.ts"],"sourcesContent":["import { useTranslation } from 'react-i18next'\n\n/**\n * Normalizes a raw string to the federal EIN display format `NN-NNNNNNN`.\n *\n * @remarks Strips non-numeric characters, then inserts a dash between the\n * first two digits and the remaining seven. Returns an empty string when no\n * digits are present.\n *\n * @param value - Raw string value to be formatted as a federal EIN.\n * @returns A string in `NN-NNNNNNN` format with non-digit characters removed.\n * @internal\n */\nexport const normalizeEin = (value: string) =>\n  value\n    .match(/\\d*/g)\n    ?.join('')\n    .match(/(\\d{0,2})(\\d{0,7})/)\n    ?.slice(1)\n    .filter(match => match !== '')\n    .join('-')\n    .substring(0, 10) || ''\n\n/**\n * Returns the placeholder EIN to display when an EIN exists but is masked.\n *\n * @param hasEin - Whether the form currently has a stored EIN value.\n * @param placeholderEin - The masked placeholder string to show.\n * @returns The placeholder string when `hasEin` is true; otherwise an empty string.\n * @internal\n */\nconst createPlaceholderEin = (hasEin?: boolean, placeholderEin?: string) =>\n  hasEin ? placeholderEin : ''\n\n/**\n * Hook that returns a translated placeholder string for a masked EIN field.\n *\n * @param hasEin - Whether the form currently has a stored EIN value.\n * @returns The translated placeholder when `hasEin` is true; otherwise an empty string.\n * @internal\n */\nexport const usePlaceholderEin = (hasEin?: boolean) => {\n  const { t } = useTranslation('common')\n  return createPlaceholderEin(hasEin, t('inputs.ein.placeholder'))\n}\n"],"names":["normalizeEin","value","match","createPlaceholderEin","hasEin","placeholderEin","usePlaceholderEin","t","useTranslation"],"mappings":";AAaO,MAAMA,IAAe,CAACC,MAC3BA,EACG,MAAM,MAAM,GACX,KAAK,EAAE,EACR,MAAM,oBAAoB,GACzB,MAAM,CAAC,EACR,OAAO,CAAAC,MAASA,MAAU,EAAE,EAC5B,KAAK,GAAG,EACR,UAAU,GAAG,EAAE,KAAK,IAUnBC,IAAuB,CAACC,GAAkBC,MAC9CD,IAASC,IAAiB,IASfC,IAAoB,CAACF,MAAqB;AACrD,QAAM,EAAE,GAAAG,EAAA,IAAMC,EAAe,QAAQ;AACrC,SAAOL,EAAqBC,GAAQG,EAAE,wBAAwB,CAAC;AACjE;"}

package/dist/helpers/formattedStrings.d.ts

@@ -1,31 +1,102 @@
-import { Location } from '@gusto/embedded-api/models/components/location';
-import { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
+import { Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location';
+import { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress';
 import { TFunction } from 'i18next';
+/**
+ * Joins a first and last name into a single capitalized display string.
+ *
+ * @remarks Each name part is capitalized at its first character. A space is
+ * inserted between the parts only when the last name is present. Missing
+ * parts are treated as empty.
+ *
+ * @param name - Object with optional `first_name` and `last_name` fields.
+ * @returns The combined name, e.g. `Jane Doe`, `Jane`, or `''`.
+ * @internal
+ */
 export declare const firstLastName: ({ first_name, last_name, }: {
     first_name?: string | null;
     last_name?: string | null;
 }) => string;
+/**
+ * Combines an address's two street lines with a comma separator.
+ *
+ * @remarks Each line is prefixed with a leading space when present, producing
+ * a string like ` 123 Main St, Apt 4`. Prefer {@link formatStreetForDisplay}
+ * for new display code; this function is retained for legacy callers.
+ *
+ * @param address - Address whose `street1` and `street2` are joined.
+ * @returns The joined street string.
+ * @internal
+ */
 export declare const getStreet: (address: EmployeeAddress | Location) => string;
-/** Joins street lines with a comma for display (avoids getStreet’s leading-space/comma quirks). */
+/**
+ * Joins an address's street lines with a comma for display.
+ *
+ * @remarks Trims each line and skips empty values, avoiding the leading-space
+ * and trailing-comma artifacts of {@link getStreet}.
+ *
+ * @param address - Address whose `street1` and `street2` are joined.
+ * @returns The display-formatted street string, e.g. `123 Main St, Apt 4`.
+ * @internal
+ */
 export declare const formatStreetForDisplay: (address: EmployeeAddress | Location) => string;
+/**
+ * Formats an address's city, state, and zip into a single display string.
+ *
+ * @param address - Address whose `city`, `state`, and `zip` are joined.
+ * @returns A `City, State Zip` string. Empty fields are skipped.
+ * @internal
+ */
 export declare const getCityStateZip: (address: EmployeeAddress | Location) => string;
+/**
+ * Formats a full address as a single inline string.
+ *
+ * @param address - The address to format.
+ * @returns The combined street and city/state/zip string.
+ * @internal
+ */
 export declare const addressInline: (address: EmployeeAddress | Location) => string;
-export declare const currentDateString: () => string;
-export declare function isNumberKey({ which, keyCode }: KeyboardEvent): boolean;
-export declare const booleanToString: (value: boolean) => "true" | "false";
-export declare const amountStr: (amount: string, isPercentage: boolean) => string;
+/**
+ * Formats a number as a USD currency string with two decimal places.
+ *
+ * @param amount - The numeric value to format.
+ * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.
+ * Defaults to `en-US`.
+ * @returns A `$1,234.56` style currency string.
+ * @internal
+ */
 export declare const formatNumberAsCurrency: (amount: number, locale?: string) => string;
+/**
+ * Formats a pay rate with its payment unit, annualizing weekly and monthly values.
+ *
+ * @remarks Hourly, yearly, and paycheck rates are displayed at the input
+ * value. Weekly rates are multiplied by 52 and monthly rates by 12 to express
+ * an annualized amount. Unknown payment units render as the currency value
+ * alone.
+ *
+ * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`
+ * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation
+ * function), and optional `locale` (BCP 47 tag, default `en-US`).
+ * @returns The translated, formatted pay rate string.
+ * @internal
+ */
 export declare const formatPayRate: ({ rate, paymentUnit, t, locale, }: {
     rate: number;
     paymentUnit: string;
     t: TFunction;
     locale?: string;
 }) => string;
-export declare const useFormatPayRate: () => (rate: number, paymentUnit: string) => string;
 /**
- * Formats a compensation rate as-is, without annualizing weekly or monthly
- * values. Use this for displaying compensation card data where the stored rate
- * should be shown directly (e.g. "$950 per week", "$3,500 per month").
+ * Formats a compensation rate as-is, without annualizing weekly or monthly values.
+ *
+ * @remarks Use for displaying compensation card data where the stored rate
+ * should be shown directly (e.g. `$950 per week`, `$3,500 per month`).
+ * Unknown payment units render as the currency value alone.
+ *
+ * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`
+ * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation
+ * function), and optional `locale` (BCP 47 tag, default `en-US`).
+ * @returns The translated, formatted compensation rate string.
+ * @internal
  */
 export declare const formatCompensationRate: ({ rate, paymentUnit, t, locale, }: {
     rate: number;
@@ -33,12 +104,78 @@ export declare const formatCompensationRate: ({ rate, paymentUnit, t, locale, }:
     t: TFunction;
     locale?: string;
 }) => string;
+/**
+ * Hook that returns a memoized {@link formatCompensationRate} bound to the active locale.
+ *
+ * @returns A callback `(rate, paymentUnit) => string`.
+ * @internal
+ */
 export declare const useFormatCompensationRate: () => (rate: number, paymentUnit: string) => string;
+/**
+ * Sanitizes an HTML string for use with React's `dangerouslySetInnerHTML`.
+ *
+ * @remarks Only `<a>`, `<b>`, and `<strong>` tags are allowed, and `<a>`
+ * elements may retain only `href` and `target` attributes. All other markup
+ * is stripped via DOMPurify.
+ *
+ * @param dirty - The raw HTML string to sanitize.
+ * @returns An object shaped for `dangerouslySetInnerHTML`. The `__html`
+ * field is `''` when the input is empty.
+ * @internal
+ */
 export declare function createMarkup(dirty: string): {
     __html: string;
 };
+/**
+ * Removes all non-digit characters from a string.
+ *
+ * @param value - The string to filter.
+ * @returns The input with only the digit characters `0`–`9` retained.
+ * @internal
+ */
 export declare const removeNonDigits: (value: string) => string;
+/**
+ * Strips the trailing `.value` segment from an API error path.
+ *
+ * @remarks API validation errors target a `.value` field on the inner
+ * object, but react-hook-form registers the field under its bare name.
+ * Stripping `.value` aligns the error path with the form field name.
+ *
+ * @param errorKey - The dotted error path returned by the API.
+ * @returns The error key without a trailing `.value`.
+ * @internal
+ */
 export declare const normalizeErrorKeyForForm: (errorKey: string) => string;
+/**
+ * Converts a `snake_case` string to `camelCase`.
+ *
+ * @param s - The snake_case string to convert.
+ * @returns The camelCase equivalent.
+ * @internal
+ */
 export declare const snakeCaseToCamelCase: (s: string) => string;
+/**
+ * Converts a `camelCase` or `PascalCase` string to `snake_case`.
+ *
+ * @remarks Handles consecutive uppercase letters by inserting a separator
+ * before the final letter of a run that is followed by a lowercase letter
+ * (e.g. `HTMLParser` becomes `html_parser`).
+ *
+ * @param s - The camelCase or PascalCase string to convert.
+ * @returns The snake_case equivalent in lower case.
+ * @internal
+ */
 export declare const camelCaseToSnakeCase: (s: string) => string;
+/**
+ * Formats a US phone number as `NNN-NNN-NNNN` for display.
+ *
+ * @remarks Strips non-digit characters before formatting. A leading `1`
+ * country code on 11-digit inputs is dropped. Inputs that are not 10 or 11
+ * digits are returned as the raw digit string. Returns an empty string for
+ * nullish input.
+ *
+ * @param phoneNumber - The phone number to format.
+ * @returns The formatted phone number, the digit-only fallback, or `''`.
+ * @internal
+ */
 export declare const formatPhoneNumber: (phoneNumber: string | number | null | undefined) => string;

package/dist/helpers/formattedStrings.js

@@ -81,7 +81,6 @@ const g = (t) => t.replace(/\D/g, ""), z = (t) => t.replace(/\.value$/, ""), P =
 };
 export {
   L as addressInline,
-  f as amountStr,
   b as createMarkup,
   S as firstLastName,
   $ as formatCompensationRate,