@gusto/embedded-react-sdk 0.46.3 → 0.47.0

package/dist/helpers/getDataProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDataProps.js","sources":["../../src/helpers/getDataProps.ts"],"sourcesContent":["import type { DataAttributes } from '@/types/Helpers'\n\ntype DataAttributeEntry = [key: keyof DataAttributes, value: DataAttributes[keyof DataAttributes]]\n\nconst isDataProp = (entry: [string, unknown]): entry is DataAttributeEntry => {\n  const [key, value] = entry\n  return (\n    key.startsWith('data-') &&\n    (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')\n  )\n}\n\nexport function getDataProps(props: Record<string, unknown>): DataAttributes {\n  const result: DataAttributes = {}\n\n  Object.entries(props).forEach(entry => {\n    if (isDataProp(entry)) {\n      const [key, value] = entry\n      result[key] = value\n    }\n  })\n\n  return result\n}\n"],"names":["isDataProp","entry","key","value","getDataProps","props","result"],"mappings":"AAIA,MAAMA,IAAa,CAACC,MAA0D;AAC5E,QAAM,CAACC,GAAKC,CAAK,IAAIF;AACrB,SACEC,EAAI,WAAW,OAAO,MACrB,OAAOC,KAAU,YAAY,OAAOA,KAAU,YAAY,OAAOA,KAAU;AAEhF;AAEO,SAASC,EAAaC,GAAgD;AAC3E,QAAMC,IAAyB,CAAA;AAE/B,gBAAO,QAAQD,CAAK,EAAE,QAAQ,CAAAJ,MAAS;AACrC,QAAID,EAAWC,CAAK,GAAG;AACrB,YAAM,CAACC,GAAKC,CAAK,IAAIF;AACrB,MAAAK,EAAOJ,CAAG,IAAIC;AAAA,IAChB;AAAA,EACF,CAAC,GAEMG;AACT;"}
+{"version":3,"file":"getDataProps.js","sources":["../../src/helpers/getDataProps.ts"],"sourcesContent":["import type { DataAttributes } from '@/types/Helpers'\n\ntype DataAttributeEntry = [key: keyof DataAttributes, value: DataAttributes[keyof DataAttributes]]\n\nconst isDataProp = (entry: [string, unknown]): entry is DataAttributeEntry => {\n  const [key, value] = entry\n  return (\n    key.startsWith('data-') &&\n    (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')\n  )\n}\n\n/**\n * Extracts `data-*` attributes from a props object for forwarding to the DOM.\n *\n * @remarks Filters out any entry whose key does not begin with `data-` or\n * whose value is not a string, number, or boolean — matching the runtime\n * shape that React permits on host elements.\n *\n * @param props - The component props to filter.\n * @returns An object containing only the `data-*` attributes from `props`.\n * @internal\n */\nexport function getDataProps(props: Record<string, unknown>): DataAttributes {\n  const result: DataAttributes = {}\n\n  Object.entries(props).forEach(entry => {\n    if (isDataProp(entry)) {\n      const [key, value] = entry\n      result[key] = value\n    }\n  })\n\n  return result\n}\n"],"names":["isDataProp","entry","key","value","getDataProps","props","result"],"mappings":"AAIA,MAAMA,IAAa,CAACC,MAA0D;AAC5E,QAAM,CAACC,GAAKC,CAAK,IAAIF;AACrB,SACEC,EAAI,WAAW,OAAO,MACrB,OAAOC,KAAU,YAAY,OAAOA,KAAU,YAAY,OAAOA,KAAU;AAEhF;AAaO,SAASC,EAAaC,GAAgD;AAC3E,QAAMC,IAAyB,CAAA;AAE/B,gBAAO,QAAQD,CAAK,EAAE,QAAQ,CAAAJ,MAAS;AACrC,QAAID,EAAWC,CAAK,GAAG;AACrB,YAAM,CAACC,GAAKC,CAAK,IAAIF;AACrB,MAAAK,EAAOJ,CAAG,IAAIC;AAAA,IAChB;AAAA,EACF,CAAC,GAEMG;AACT;"}

package/dist/helpers/mask.d.ts

@@ -2,26 +2,43 @@ import { Transform } from '../components/Common/Fields/hooks/useField';
 /**
  * Formats a string according to a specified mask pattern.
  *
+ * @remarks
+ * Strips non-alphanumeric characters from the input before applying the mask.
+ * Mask pattern characters:
+ * - `#` matches a digit (`\d`)
+ * - `@` matches a letter (`[a-zA-Z]`)
+ * - `^` matches an uppercase letter (`[A-Z]`)
+ * - `%` matches a digit or uppercase letter (`[0-9A-Z]`)
+ * - any other character is emitted as a literal
+ *
  * @param value - The input string to format
- * @param mask - The mask pattern where:
- *   `#` represents a digit (`\d`)
- *   `@` represents a letter (`[a-zA-Z]`)
- *   `^` represents an uppercase letter (`[A-Z]`)
- *   `%` represents a digit or uppercase letter (`[0-9A-Z]`)
- *   any other character represents the literal character
- * @returns The formatted string according to the mask
+ * @param mask - The mask pattern, or `null` to pass the value through unchanged
+ * @returns The formatted string according to the mask, or the original value when `value` or `mask` is empty
+ * @internal
  *
  * @example
  * ```ts
- * formatWithMask('123456789', '###-##-####') // returns '123-45-6789'
- * formatWithMask('ABC123', '@@@-###') // returns 'ABC-123'
- * formatWithMask('123456', '(###) ###-####') // returns '(123) 456'
- * formatWithMask('ABC123', '^^^-###') // returns 'ABC-123'
- * formatWithMask('A1B2C3', '%%%-%%%') // returns 'A1B-2C3'
+ * formatWithMask('123456789', '###-##-####') // '123-45-6789'
+ * formatWithMask('ABC123', '@@@-###')        // 'ABC-123'
+ * formatWithMask('123456', '(###) ###-####') // '(123) 456'
+ * formatWithMask('ABC123', '^^^-###')        // 'ABC-123'
+ * formatWithMask('A1B2C3', '%%%-%%%')        // 'A1B-2C3'
  * ```
  */
 export declare const formatWithMask: (value: string, mask: string | null) => string;
+/**
+ * Builds a Field transform that applies a mask pattern to the input value on each change.
+ *
+ * @param mask - The mask pattern accepted by {@link formatWithMask}, or `null` to pass the value through unchanged
+ * @returns A transform function suitable for passing to a Field component's `transform` prop
+ * @internal
+ */
 export declare const useMaskedTransform: (mask: string | null) => Transform<string>;
+/**
+ * Reusable mask patterns shared across Field components.
+ *
+ * @internal
+ */
 export declare const commonMasks: {
     phoneMask: string;
 };

package/dist/helpers/mask.js.map

@@ -1 +1 @@
-{"version":3,"file":"mask.js","sources":["../../src/helpers/mask.ts"],"sourcesContent":["import type { Transform } from '@/components/Common/Fields/hooks/useField'\n\n/**\n * Formats a string according to a specified mask pattern.\n *\n * @param value - The input string to format\n * @param mask - The mask pattern where:\n *   `#` represents a digit (`\\d`)\n *   `@` represents a letter (`[a-zA-Z]`)\n *   `^` represents an uppercase letter (`[A-Z]`)\n *   `%` represents a digit or uppercase letter (`[0-9A-Z]`)\n *   any other character represents the literal character\n * @returns The formatted string according to the mask\n *\n * @example\n * ```ts\n * formatWithMask('123456789', '###-##-####') // returns '123-45-6789'\n * formatWithMask('ABC123', '@@@-###') // returns 'ABC-123'\n * formatWithMask('123456', '(###) ###-####') // returns '(123) 456'\n * formatWithMask('ABC123', '^^^-###') // returns 'ABC-123'\n * formatWithMask('A1B2C3', '%%%-%%%') // returns 'A1B-2C3'\n * ```\n */\nexport const formatWithMask = (value: string, mask: string | null): string => {\n  if (!value || !mask) return value\n\n  // Remove all non-alphanumeric characters from the input\n  const sanitizedValue = value.replace(/[^a-zA-Z0-9]/g, '')\n  if (!sanitizedValue) return ''\n\n  let result = ''\n  let valueIndex = 0\n  let maskIndex = 0\n\n  while (maskIndex < mask.length) {\n    const maskChar = mask.charAt(maskIndex)\n    const valueChar = sanitizedValue.charAt(valueIndex)\n\n    // If we've processed all input characters, stop\n    if (valueIndex >= sanitizedValue.length) {\n      break\n    }\n\n    switch (maskChar) {\n      case '#':\n        if (/\\d/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      case '@':\n        if (/[a-zA-Z]/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      case '^':\n        if (/[A-Z]/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      case '%':\n        if (/[0-9A-Z]/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      default:\n        // Always add literal characters from the mask\n        result += maskChar\n        // Increment valueIndex only if the current input character matches the literal mask character.\n        if (maskChar === valueChar) {\n          valueIndex++\n        }\n    }\n    maskIndex++\n  }\n\n  return result.trim()\n}\n\nexport const useMaskedTransform = (mask: string | null): Transform<string> => {\n  return (value: string) => formatWithMask(value, mask)\n}\n\nexport const commonMasks = {\n  phoneMask: '(###) ###-####',\n}\n"],"names":["formatWithMask","value","mask","sanitizedValue","result","valueIndex","maskIndex","maskChar","valueChar","useMaskedTransform","commonMasks"],"mappings":"AAuBO,MAAMA,IAAiB,CAACC,GAAeC,MAAgC;AAC5E,MAAI,CAACD,KAAS,CAACC,EAAM,QAAOD;AAG5B,QAAME,IAAiBF,EAAM,QAAQ,iBAAiB,EAAE;AACxD,MAAI,CAACE,EAAgB,QAAO;AAE5B,MAAIC,IAAS,IACTC,IAAa,GACbC,IAAY;AAEhB,SAAOA,IAAYJ,EAAK,UAAQ;AAC9B,UAAMK,IAAWL,EAAK,OAAOI,CAAS,GAChCE,IAAYL,EAAe,OAAOE,CAAU;AAGlD,QAAIA,KAAcF,EAAe;AAC/B;AAGF,YAAQI,GAAA;AAAA,MACN,KAAK;AACH,QAAI,KAAK,KAAKC,CAAS,KACrBJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF,KAAK;AACH,QAAI,WAAW,KAAKE,CAAS,KAC3BJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF,KAAK;AACH,QAAI,QAAQ,KAAKE,CAAS,KACxBJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF,KAAK;AACH,QAAI,WAAW,KAAKE,CAAS,KAC3BJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF;AAEE,QAAAF,KAAUG,GAENA,MAAaC,KACfH;AAAA,IACF;AAEJ,IAAAC;AAAA,EACF;AAEA,SAAOF,EAAO,KAAA;AAChB,GAEaK,IAAqB,CAACP,MAC1B,CAACD,MAAkBD,EAAeC,GAAOC,CAAI,GAGzCQ,IAAc;AAAA,EACzB,WAAW;AACb;"}
+{"version":3,"file":"mask.js","sources":["../../src/helpers/mask.ts"],"sourcesContent":["import type { Transform } from '@/components/Common/Fields/hooks/useField'\n\n/**\n * Formats a string according to a specified mask pattern.\n *\n * @remarks\n * Strips non-alphanumeric characters from the input before applying the mask.\n * Mask pattern characters:\n * - `#` matches a digit (`\\d`)\n * - `@` matches a letter (`[a-zA-Z]`)\n * - `^` matches an uppercase letter (`[A-Z]`)\n * - `%` matches a digit or uppercase letter (`[0-9A-Z]`)\n * - any other character is emitted as a literal\n *\n * @param value - The input string to format\n * @param mask - The mask pattern, or `null` to pass the value through unchanged\n * @returns The formatted string according to the mask, or the original value when `value` or `mask` is empty\n * @internal\n *\n * @example\n * ```ts\n * formatWithMask('123456789', '###-##-####') // '123-45-6789'\n * formatWithMask('ABC123', '@@@-###')        // 'ABC-123'\n * formatWithMask('123456', '(###) ###-####') // '(123) 456'\n * formatWithMask('ABC123', '^^^-###')        // 'ABC-123'\n * formatWithMask('A1B2C3', '%%%-%%%')        // 'A1B-2C3'\n * ```\n */\nexport const formatWithMask = (value: string, mask: string | null): string => {\n  if (!value || !mask) return value\n\n  // Remove all non-alphanumeric characters from the input\n  const sanitizedValue = value.replace(/[^a-zA-Z0-9]/g, '')\n  if (!sanitizedValue) return ''\n\n  let result = ''\n  let valueIndex = 0\n  let maskIndex = 0\n\n  while (maskIndex < mask.length) {\n    const maskChar = mask.charAt(maskIndex)\n    const valueChar = sanitizedValue.charAt(valueIndex)\n\n    // If we've processed all input characters, stop\n    if (valueIndex >= sanitizedValue.length) {\n      break\n    }\n\n    switch (maskChar) {\n      case '#':\n        if (/\\d/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      case '@':\n        if (/[a-zA-Z]/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      case '^':\n        if (/[A-Z]/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      case '%':\n        if (/[0-9A-Z]/.test(valueChar)) {\n          result += valueChar\n          valueIndex++\n        } else {\n          valueIndex++\n          maskIndex--\n        }\n        break\n      default:\n        // Always add literal characters from the mask\n        result += maskChar\n        // Increment valueIndex only if the current input character matches the literal mask character.\n        if (maskChar === valueChar) {\n          valueIndex++\n        }\n    }\n    maskIndex++\n  }\n\n  return result.trim()\n}\n\n/**\n * Builds a Field transform that applies a mask pattern to the input value on each change.\n *\n * @param mask - The mask pattern accepted by {@link formatWithMask}, or `null` to pass the value through unchanged\n * @returns A transform function suitable for passing to a Field component's `transform` prop\n * @internal\n */\nexport const useMaskedTransform = (mask: string | null): Transform<string> => {\n  return (value: string) => formatWithMask(value, mask)\n}\n\n/**\n * Reusable mask patterns shared across Field components.\n *\n * @internal\n */\nexport const commonMasks = {\n  phoneMask: '(###) ###-####',\n}\n"],"names":["formatWithMask","value","mask","sanitizedValue","result","valueIndex","maskIndex","maskChar","valueChar","useMaskedTransform","commonMasks"],"mappings":"AA4BO,MAAMA,IAAiB,CAACC,GAAeC,MAAgC;AAC5E,MAAI,CAACD,KAAS,CAACC,EAAM,QAAOD;AAG5B,QAAME,IAAiBF,EAAM,QAAQ,iBAAiB,EAAE;AACxD,MAAI,CAACE,EAAgB,QAAO;AAE5B,MAAIC,IAAS,IACTC,IAAa,GACbC,IAAY;AAEhB,SAAOA,IAAYJ,EAAK,UAAQ;AAC9B,UAAMK,IAAWL,EAAK,OAAOI,CAAS,GAChCE,IAAYL,EAAe,OAAOE,CAAU;AAGlD,QAAIA,KAAcF,EAAe;AAC/B;AAGF,YAAQI,GAAA;AAAA,MACN,KAAK;AACH,QAAI,KAAK,KAAKC,CAAS,KACrBJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF,KAAK;AACH,QAAI,WAAW,KAAKE,CAAS,KAC3BJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF,KAAK;AACH,QAAI,QAAQ,KAAKE,CAAS,KACxBJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF,KAAK;AACH,QAAI,WAAW,KAAKE,CAAS,KAC3BJ,KAAUI,GACVH,QAEAA,KACAC;AAEF;AAAA,MACF;AAEE,QAAAF,KAAUG,GAENA,MAAaC,KACfH;AAAA,IACF;AAEJ,IAAAC;AAAA,EACF;AAEA,SAAOF,EAAO,KAAA;AAChB,GASaK,IAAqB,CAACP,MAC1B,CAACD,MAAkBD,EAAeC,GAAOC,CAAI,GAQzCQ,IAAc;AAAA,EACzB,WAAW;AACb;"}

package/dist/helpers/payRateCalculator.d.ts

@@ -1,2 +1,10 @@
-export declare const hourlyRate: (amount: number, paymentUnit: "Hour" | "Week" | "Month" | "Year" | "Paycheck") => number;
+/**
+ * Converts a pay rate expressed in the given unit into an equivalent annual rate.
+ *
+ * @param amount - The pay amount expressed in `paymentUnit`
+ * @param paymentUnit - The unit the `amount` is expressed in
+ * @returns The equivalent annual rate, or `0` when `paymentUnit` is `Paycheck`
+ * @internal
+ * @see {@link hourlyRate}
+ */
 export declare const yearlyRate: (amount: number, paymentUnit: "Hour" | "Week" | "Month" | "Year" | "Paycheck") => number;

package/dist/helpers/payRateCalculator.js

@@ -14,7 +14,6 @@ const P = (r, e) => {
   }
 }, c = (r, e) => P(r, e) * t;
 export {
-  P as hourlyRate,
   c as yearlyRate
 };
 //# sourceMappingURL=payRateCalculator.js.map

package/dist/helpers/payRateCalculator.js.map

@@ -1 +1 @@
-{"version":3,"file":"payRateCalculator.js","sources":["../../src/helpers/payRateCalculator.ts"],"sourcesContent":["import {\n  HOURS_PER_PAY_PERIOD_ANNUALLY,\n  HOURS_PER_PAY_PERIOD_MONTHLY,\n  HOURS_PER_PAY_PERIOD_WEEKLY,\n} from '@/shared/constants'\n\nexport const hourlyRate = (\n  amount: number,\n  paymentUnit: 'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck',\n) => {\n  switch (paymentUnit) {\n    case 'Hour':\n      return amount\n    case 'Week':\n      return amount / HOURS_PER_PAY_PERIOD_WEEKLY\n    case 'Month':\n      return amount / HOURS_PER_PAY_PERIOD_MONTHLY\n    case 'Year':\n      return amount / HOURS_PER_PAY_PERIOD_ANNUALLY\n    default:\n      return 0\n  }\n}\nexport const yearlyRate = (\n  amount: number,\n  paymentUnit: 'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck',\n) => {\n  return hourlyRate(amount, paymentUnit) * HOURS_PER_PAY_PERIOD_ANNUALLY\n}\n"],"names":["hourlyRate","amount","paymentUnit","HOURS_PER_PAY_PERIOD_WEEKLY","HOURS_PER_PAY_PERIOD_MONTHLY","HOURS_PER_PAY_PERIOD_ANNUALLY","yearlyRate"],"mappings":";AAMO,MAAMA,IAAa,CACxBC,GACAC,MACG;AACH,UAAQA,GAAA;AAAA,IACN,KAAK;AACH,aAAOD;AAAA,IACT,KAAK;AACH,aAAOA,IAASE;AAAA,IAClB,KAAK;AACH,aAAOF,IAASG;AAAA,IAClB,KAAK;AACH,aAAOH,IAASI;AAAA,IAClB;AACE,aAAO;AAAA,EAAA;AAEb,GACaC,IAAa,CACxBL,GACAC,MAEOF,EAAWC,GAAQC,CAAW,IAAIG;"}
+{"version":3,"file":"payRateCalculator.js","sources":["../../src/helpers/payRateCalculator.ts"],"sourcesContent":["import {\n  HOURS_PER_PAY_PERIOD_ANNUALLY,\n  HOURS_PER_PAY_PERIOD_MONTHLY,\n  HOURS_PER_PAY_PERIOD_WEEKLY,\n} from '@/shared/constants'\n\n/**\n * Converts a pay rate expressed in the given unit into an equivalent hourly rate.\n *\n * @remarks\n * Uses the standard hours-per-pay-period constants for weekly, monthly, and annual conversions.\n * Returns `0` for `Paycheck` since the hours-per-paycheck value is not fixed.\n *\n * @param amount - The pay amount expressed in `paymentUnit`\n * @param paymentUnit - The unit the `amount` is expressed in\n * @returns The equivalent hourly rate, or `0` when `paymentUnit` is `Paycheck`\n * @internal\n */\nconst hourlyRate = (\n  amount: number,\n  paymentUnit: 'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck',\n) => {\n  switch (paymentUnit) {\n    case 'Hour':\n      return amount\n    case 'Week':\n      return amount / HOURS_PER_PAY_PERIOD_WEEKLY\n    case 'Month':\n      return amount / HOURS_PER_PAY_PERIOD_MONTHLY\n    case 'Year':\n      return amount / HOURS_PER_PAY_PERIOD_ANNUALLY\n    default:\n      return 0\n  }\n}\n/**\n * Converts a pay rate expressed in the given unit into an equivalent annual rate.\n *\n * @param amount - The pay amount expressed in `paymentUnit`\n * @param paymentUnit - The unit the `amount` is expressed in\n * @returns The equivalent annual rate, or `0` when `paymentUnit` is `Paycheck`\n * @internal\n * @see {@link hourlyRate}\n */\nexport const yearlyRate = (\n  amount: number,\n  paymentUnit: 'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck',\n) => {\n  return hourlyRate(amount, paymentUnit) * HOURS_PER_PAY_PERIOD_ANNUALLY\n}\n"],"names":["hourlyRate","amount","paymentUnit","HOURS_PER_PAY_PERIOD_WEEKLY","HOURS_PER_PAY_PERIOD_MONTHLY","HOURS_PER_PAY_PERIOD_ANNUALLY","yearlyRate"],"mappings":";AAkBA,MAAMA,IAAa,CACjBC,GACAC,MACG;AACH,UAAQA,GAAA;AAAA,IACN,KAAK;AACH,aAAOD;AAAA,IACT,KAAK;AACH,aAAOA,IAASE;AAAA,IAClB,KAAK;AACH,aAAOF,IAASG;AAAA,IAClB,KAAK;AACH,aAAOH,IAASI;AAAA,IAClB;AACE,aAAO;AAAA,EAAA;AAEb,GAUaC,IAAa,CACxBL,GACAC,MAEOF,EAAWC,GAAQC,CAAW,IAAIG;"}

package/dist/helpers/percentageConversion.d.ts

@@ -1,3 +1,39 @@
+/**
+ * Converts a decimal value into its percentage equivalent.
+ *
+ * @remarks
+ * Multiplies by 100 and rounds to 12 significant digits to avoid floating-point artifacts.
+ * Returns `undefined` for `null`, `undefined`, empty strings, booleans, or values that cannot
+ * be parsed as numbers, making it safe to call on raw form input.
+ *
+ * @param value - The decimal value to convert; strings are parsed as floats
+ * @returns The percentage (e.g. `0.0625` becomes `6.25`), or `undefined` when the input is not a usable number
+ * @internal
+ */
 export declare function decimalToPercent(value: string | number | boolean | null | undefined): number | undefined;
+/**
+ * Converts a percentage value into its decimal equivalent serialized as a string.
+ *
+ * @remarks
+ * Divides by 100 and rounds to 12 significant digits to avoid floating-point artifacts.
+ * If `value` cannot be parsed as a number, it is returned as-is via `String(value)` so that
+ * partially-typed form input is preserved.
+ *
+ * @param value - The percentage value to convert; strings are parsed as floats
+ * @returns The decimal value as a string (e.g. `6.25` becomes `"0.0625"`)
+ * @internal
+ */
 export declare function percentToDecimal(value: number | string): string;
+/**
+ * Formats a decimal value as a localized percentage string with a trailing `%`.
+ *
+ * @remarks
+ * Uses `Intl.NumberFormat` with 1 to 4 fractional digits. If `decimalValue` cannot be converted
+ * to a percentage via {@link decimalToPercent}, the original string is returned unchanged.
+ *
+ * @param decimalValue - The decimal value to format, as a string
+ * @param locale - BCP 47 locale tag passed to `Intl.NumberFormat`. Defaults to `'en-US'`.
+ * @returns The localized percentage string, or `decimalValue` when it cannot be parsed
+ * @internal
+ */
 export declare function formatPercentLabel(decimalValue: string, locale?: string): string;

package/dist/helpers/percentageConversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"percentageConversion.js","sources":["../../src/helpers/percentageConversion.ts"],"sourcesContent":["const PRECISION_DIGITS = 12\n\nfunction toCleanNumber(value: number): number {\n  return parseFloat(value.toPrecision(PRECISION_DIGITS))\n}\n\nexport function decimalToPercent(\n  value: string | number | boolean | null | undefined,\n): number | undefined {\n  if (value === null || value === undefined || value === '' || typeof value === 'boolean') {\n    return undefined\n  }\n\n  const numValue = typeof value === 'number' ? value : parseFloat(value)\n\n  if (isNaN(numValue)) {\n    return undefined\n  }\n\n  return toCleanNumber(numValue * 100)\n}\n\nexport function percentToDecimal(value: number | string): string {\n  const numValue = typeof value === 'number' ? value : parseFloat(value)\n\n  if (isNaN(numValue)) {\n    return String(value)\n  }\n\n  return String(toCleanNumber(numValue / 100))\n}\n\nexport function formatPercentLabel(decimalValue: string, locale = 'en-US'): string {\n  const percent = decimalToPercent(decimalValue)\n  if (percent === undefined) return decimalValue\n\n  const formatted = new Intl.NumberFormat(locale, {\n    minimumFractionDigits: 1,\n    maximumFractionDigits: 4,\n  }).format(percent)\n\n  return `${formatted}%`\n}\n"],"names":["toCleanNumber","value","decimalToPercent","numValue","percentToDecimal","formatPercentLabel","decimalValue","locale","percent"],"mappings":"AAEA,SAASA,EAAcC,GAAuB;AAC5C,SAAO,WAAWA,EAAM,YAAY,EAAgB,CAAC;AACvD;AAEO,SAASC,EACdD,GACoB;AACpB,MAAIA,KAAU,QAA+BA,MAAU,MAAM,OAAOA,KAAU;AAC5E;AAGF,QAAME,IAAW,OAAOF,KAAU,WAAWA,IAAQ,WAAWA,CAAK;AAErE,MAAI,OAAME,CAAQ;AAIlB,WAAOH,EAAcG,IAAW,GAAG;AACrC;AAEO,SAASC,EAAiBH,GAAgC;AAC/D,QAAME,IAAW,OAAOF,KAAU,WAAWA,IAAQ,WAAWA,CAAK;AAErE,SAAI,MAAME,CAAQ,IACT,OAAOF,CAAK,IAGd,OAAOD,EAAcG,IAAW,GAAG,CAAC;AAC7C;AAEO,SAASE,EAAmBC,GAAsBC,IAAS,SAAiB;AACjF,QAAMC,IAAUN,EAAiBI,CAAY;AAC7C,SAAIE,MAAY,SAAkBF,IAO3B,GALW,IAAI,KAAK,aAAaC,GAAQ;AAAA,IAC9C,uBAAuB;AAAA,IACvB,uBAAuB;AAAA,EAAA,CACxB,EAAE,OAAOC,CAAO,CAEE;AACrB;"}
+{"version":3,"file":"percentageConversion.js","sources":["../../src/helpers/percentageConversion.ts"],"sourcesContent":["const PRECISION_DIGITS = 12\n\nfunction toCleanNumber(value: number): number {\n  return parseFloat(value.toPrecision(PRECISION_DIGITS))\n}\n\n/**\n * Converts a decimal value into its percentage equivalent.\n *\n * @remarks\n * Multiplies by 100 and rounds to 12 significant digits to avoid floating-point artifacts.\n * Returns `undefined` for `null`, `undefined`, empty strings, booleans, or values that cannot\n * be parsed as numbers, making it safe to call on raw form input.\n *\n * @param value - The decimal value to convert; strings are parsed as floats\n * @returns The percentage (e.g. `0.0625` becomes `6.25`), or `undefined` when the input is not a usable number\n * @internal\n */\nexport function decimalToPercent(\n  value: string | number | boolean | null | undefined,\n): number | undefined {\n  if (value === null || value === undefined || value === '' || typeof value === 'boolean') {\n    return undefined\n  }\n\n  const numValue = typeof value === 'number' ? value : parseFloat(value)\n\n  if (isNaN(numValue)) {\n    return undefined\n  }\n\n  return toCleanNumber(numValue * 100)\n}\n\n/**\n * Converts a percentage value into its decimal equivalent serialized as a string.\n *\n * @remarks\n * Divides by 100 and rounds to 12 significant digits to avoid floating-point artifacts.\n * If `value` cannot be parsed as a number, it is returned as-is via `String(value)` so that\n * partially-typed form input is preserved.\n *\n * @param value - The percentage value to convert; strings are parsed as floats\n * @returns The decimal value as a string (e.g. `6.25` becomes `\"0.0625\"`)\n * @internal\n */\nexport function percentToDecimal(value: number | string): string {\n  const numValue = typeof value === 'number' ? value : parseFloat(value)\n\n  if (isNaN(numValue)) {\n    return String(value)\n  }\n\n  return String(toCleanNumber(numValue / 100))\n}\n\n/**\n * Formats a decimal value as a localized percentage string with a trailing `%`.\n *\n * @remarks\n * Uses `Intl.NumberFormat` with 1 to 4 fractional digits. If `decimalValue` cannot be converted\n * to a percentage via {@link decimalToPercent}, the original string is returned unchanged.\n *\n * @param decimalValue - The decimal value to format, as a string\n * @param locale - BCP 47 locale tag passed to `Intl.NumberFormat`. Defaults to `'en-US'`.\n * @returns The localized percentage string, or `decimalValue` when it cannot be parsed\n * @internal\n */\nexport function formatPercentLabel(decimalValue: string, locale = 'en-US'): string {\n  const percent = decimalToPercent(decimalValue)\n  if (percent === undefined) return decimalValue\n\n  const formatted = new Intl.NumberFormat(locale, {\n    minimumFractionDigits: 1,\n    maximumFractionDigits: 4,\n  }).format(percent)\n\n  return `${formatted}%`\n}\n"],"names":["toCleanNumber","value","decimalToPercent","numValue","percentToDecimal","formatPercentLabel","decimalValue","locale","percent"],"mappings":"AAEA,SAASA,EAAcC,GAAuB;AAC5C,SAAO,WAAWA,EAAM,YAAY,EAAgB,CAAC;AACvD;AAcO,SAASC,EACdD,GACoB;AACpB,MAAIA,KAAU,QAA+BA,MAAU,MAAM,OAAOA,KAAU;AAC5E;AAGF,QAAME,IAAW,OAAOF,KAAU,WAAWA,IAAQ,WAAWA,CAAK;AAErE,MAAI,OAAME,CAAQ;AAIlB,WAAOH,EAAcG,IAAW,GAAG;AACrC;AAcO,SAASC,EAAiBH,GAAgC;AAC/D,QAAME,IAAW,OAAOF,KAAU,WAAWA,IAAQ,WAAWA,CAAK;AAErE,SAAI,MAAME,CAAQ,IACT,OAAOF,CAAK,IAGd,OAAOD,EAAcG,IAAW,GAAG,CAAC;AAC7C;AAcO,SAASE,EAAmBC,GAAsBC,IAAS,SAAiB;AACjF,QAAMC,IAAUN,EAAiBI,CAAY;AAC7C,SAAIE,MAAY,SAAkBF,IAO3B,GALW,IAAI,KAAK,aAAaC,GAAQ;AAAA,IAC9C,uBAAuB;AAAA,IACvB,uBAAuB;AAAA,EAAA,CACxB,EAAE,OAAOC,CAAO,CAEE;AACrB;"}

package/dist/helpers/readableStreamToBlob.d.ts

@@ -1 +1,14 @@
+/**
+ * Drains a binary `ReadableStream` and packages the bytes into a `Blob`.
+ *
+ * @remarks
+ * Reads all chunks from the stream, concatenates them into a single `Uint8Array`, and wraps the
+ * result in a `Blob` tagged with `mimeType`. Used to materialize downloads returned by streaming
+ * API responses.
+ *
+ * @param stream - The byte stream to read to completion
+ * @param mimeType - The MIME type assigned to the resulting `Blob`
+ * @returns A `Blob` containing the full contents of the stream
+ * @internal
+ */
 export declare function readableStreamToBlob(stream: ReadableStream<Uint8Array>, mimeType: string): Promise<Blob>;

package/dist/helpers/readableStreamToBlob.js.map

@@ -1 +1 @@
-{"version":3,"file":"readableStreamToBlob.js","sources":["../../src/helpers/readableStreamToBlob.ts"],"sourcesContent":["export async function readableStreamToBlob(stream: ReadableStream<Uint8Array>, mimeType: string) {\n  const reader = stream.getReader()\n  const chunks: Uint8Array[] = []\n  let done = false\n  while (!done) {\n    const { value, done: readerDone } = await reader.read()\n    if (value) chunks.push(value)\n    done = readerDone\n  }\n  // Concatenate all chunks\n  const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0)\n  const merged = new Uint8Array(totalLength)\n  let offset = 0\n  for (const chunk of chunks) {\n    merged.set(chunk, offset)\n    offset += chunk.length\n  }\n  return new Blob([merged], { type: mimeType })\n}\n"],"names":["readableStreamToBlob","stream","mimeType","reader","chunks","done","value","readerDone","totalLength","acc","chunk","merged","offset"],"mappings":"AAAA,eAAsBA,EAAqBC,GAAoCC,GAAkB;AAC/F,QAAMC,IAASF,EAAO,UAAA,GAChBG,IAAuB,CAAA;AAC7B,MAAIC,IAAO;AACX,SAAO,CAACA,KAAM;AACZ,UAAM,EAAE,OAAAC,GAAO,MAAMC,MAAe,MAAMJ,EAAO,KAAA;AACjD,IAAIG,KAAOF,EAAO,KAAKE,CAAK,GAC5BD,IAAOE;AAAA,EACT;AAEA,QAAMC,IAAcJ,EAAO,OAAO,CAACK,GAAKC,MAAUD,IAAMC,EAAM,QAAQ,CAAC,GACjEC,IAAS,IAAI,WAAWH,CAAW;AACzC,MAAII,IAAS;AACb,aAAWF,KAASN;AAClB,IAAAO,EAAO,IAAID,GAAOE,CAAM,GACxBA,KAAUF,EAAM;AAElB,SAAO,IAAI,KAAK,CAACC,CAAM,GAAG,EAAE,MAAMT,GAAU;AAC9C;"}
+{"version":3,"file":"readableStreamToBlob.js","sources":["../../src/helpers/readableStreamToBlob.ts"],"sourcesContent":["/**\n * Drains a binary `ReadableStream` and packages the bytes into a `Blob`.\n *\n * @remarks\n * Reads all chunks from the stream, concatenates them into a single `Uint8Array`, and wraps the\n * result in a `Blob` tagged with `mimeType`. Used to materialize downloads returned by streaming\n * API responses.\n *\n * @param stream - The byte stream to read to completion\n * @param mimeType - The MIME type assigned to the resulting `Blob`\n * @returns A `Blob` containing the full contents of the stream\n * @internal\n */\nexport async function readableStreamToBlob(stream: ReadableStream<Uint8Array>, mimeType: string) {\n  const reader = stream.getReader()\n  const chunks: Uint8Array[] = []\n  let done = false\n  while (!done) {\n    const { value, done: readerDone } = await reader.read()\n    if (value) chunks.push(value)\n    done = readerDone\n  }\n  // Concatenate all chunks\n  const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0)\n  const merged = new Uint8Array(totalLength)\n  let offset = 0\n  for (const chunk of chunks) {\n    merged.set(chunk, offset)\n    offset += chunk.length\n  }\n  return new Blob([merged], { type: mimeType })\n}\n"],"names":["readableStreamToBlob","stream","mimeType","reader","chunks","done","value","readerDone","totalLength","acc","chunk","merged","offset"],"mappings":"AAaA,eAAsBA,EAAqBC,GAAoCC,GAAkB;AAC/F,QAAMC,IAASF,EAAO,UAAA,GAChBG,IAAuB,CAAA;AAC7B,MAAIC,IAAO;AACX,SAAO,CAACA,KAAM;AACZ,UAAM,EAAE,OAAAC,GAAO,MAAMC,MAAe,MAAMJ,EAAO,KAAA;AACjD,IAAIG,KAAOF,EAAO,KAAKE,CAAK,GAC5BD,IAAOE;AAAA,EACT;AAEA,QAAMC,IAAcJ,EAAO,OAAO,CAACK,GAAKC,MAAUD,IAAMC,EAAM,QAAQ,CAAC,GACjEC,IAAS,IAAI,WAAWH,CAAW;AACzC,MAAII,IAAS;AACb,aAAWF,KAASN;AAClB,IAAAO,EAAO,IAAID,GAAOE,CAAM,GACxBA,KAAUF,EAAM;AAElB,SAAO,IAAI,KAAK,CAACC,CAAM,GAAG,EAAE,MAAMT,GAAU;AAC9C;"}

package/dist/helpers/rem.d.ts

@@ -1,12 +1,33 @@
 /**
- * Detects font-size on the document root element with fallback to 16px which is the default browser setting.
- * The value is cached after the first call to avoid repeated expensive getComputedStyle() calls.
+ * Reads the font size of the document root element, falling back to `'16'` when running outside the browser or when the value cannot be parsed.
  *
- * @param options - Set `forceRefresh` to force a fresh detection instead of using the cached value
- * @returns The root font size in pixels as a string
+ * @remarks
+ * The first call resolves the value via `getComputedStyle(document.documentElement)` and caches it
+ * for subsequent calls, since `getComputedStyle` triggers layout. Pass `forceRefresh: true` to
+ * recompute, e.g. after a theme change that adjusts the root font size.
+ *
+ * @param options - Optional flags. Set `forceRefresh` to `true` to bypass the cache and recompute the value.
+ * @returns The root font size in pixels as a numeric string (no `px` suffix)
+ * @internal
  */
 export declare function getRootFontSize(options?: {
     forceRefresh?: boolean;
 }): string;
+/**
+ * Converts a pixel value into a `rem`-suffixed string relative to the document root font size.
+ *
+ * @param pxValue - The value in pixels
+ * @returns The equivalent value as a string ending in `rem` (e.g. `'1.5rem'`)
+ * @internal
+ * @see {@link getRootFontSize}
+ */
 export declare function toRem(pxValue: number): string;
+/**
+ * Converts a `rem` value into pixels relative to the document root font size.
+ *
+ * @param rem - The value in `rem`. Accepts either a number (interpreted as raw `rem`) or a string that may include the `rem` suffix (e.g. `'1.5rem'`).
+ * @returns The equivalent value in pixels as a number
+ * @internal
+ * @see {@link getRootFontSize}
+ */
 export declare const remToPx: (rem: string | number) => number;

package/dist/helpers/rem.js.map

@@ -1 +1 @@
-{"version":3,"file":"rem.js","sources":["../../src/helpers/rem.ts"],"sourcesContent":["let cachedRootFontSize: string | null = null\n\n/**\n * Detects font-size on the document root element with fallback to 16px which is the default browser setting.\n * The value is cached after the first call to avoid repeated expensive getComputedStyle() calls.\n *\n * @param options - Set `forceRefresh` to force a fresh detection instead of using the cached value\n * @returns The root font size in pixels as a string\n */\nexport function getRootFontSize(options?: { forceRefresh?: boolean }) {\n  if (cachedRootFontSize && !options?.forceRefresh) {\n    return cachedRootFontSize\n  }\n\n  const defaultFontSize = '16'\n\n  if (typeof window === 'undefined') {\n    cachedRootFontSize = defaultFontSize\n    return defaultFontSize\n  }\n\n  const match = window\n    .getComputedStyle(document.documentElement)\n    .getPropertyValue('font-size')\n    .match(/\\d+/)\n\n  cachedRootFontSize = match ? match[0] : defaultFontSize\n  return cachedRootFontSize\n}\n\nexport function toRem(pxValue: number) {\n  return String(pxValue / Number(getRootFontSize())) + 'rem'\n}\n\nexport const remToPx = (rem: string | number) =>\n  typeof rem === 'number'\n    ? Number(getRootFontSize()) * rem\n    : Number(getRootFontSize()) * Number(rem.replace('rem', ''))\n"],"names":["cachedRootFontSize","getRootFontSize","options","defaultFontSize","match","toRem","pxValue","remToPx","rem"],"mappings":"AAAA,IAAIA,IAAoC;AASjC,SAASC,EAAgBC,GAAsC;AACpE,MAAIF;AACF,WAAOA;AAGT,QAAMG,IAAkB;AAExB,MAAI,OAAO,SAAW;AACpB,WAAAH,IAAqBG,GACdA;AAGT,QAAMC,IAAQ,OACX,iBAAiB,SAAS,eAAe,EACzC,iBAAiB,WAAW,EAC5B,MAAM,KAAK;AAEd,SAAAJ,IAAqBI,IAAQA,EAAM,CAAC,IAAID,GACjCH;AACT;AAEO,SAASK,EAAMC,GAAiB;AACrC,SAAO,OAAOA,IAAU,OAAOL,EAAA,CAAiB,CAAC,IAAI;AACvD;AAEO,MAAMM,IAAU,CAACC,MACtB,OAAOA,KAAQ,WACX,OAAOP,GAAiB,IAAIO,IAC5B,OAAOP,EAAA,CAAiB,IAAI,OAAOO,EAAI,QAAQ,OAAO,EAAE,CAAC;"}
+{"version":3,"file":"rem.js","sources":["../../src/helpers/rem.ts"],"sourcesContent":["let cachedRootFontSize: string | null = null\n\n/**\n * Reads the font size of the document root element, falling back to `'16'` when running outside the browser or when the value cannot be parsed.\n *\n * @remarks\n * The first call resolves the value via `getComputedStyle(document.documentElement)` and caches it\n * for subsequent calls, since `getComputedStyle` triggers layout. Pass `forceRefresh: true` to\n * recompute, e.g. after a theme change that adjusts the root font size.\n *\n * @param options - Optional flags. Set `forceRefresh` to `true` to bypass the cache and recompute the value.\n * @returns The root font size in pixels as a numeric string (no `px` suffix)\n * @internal\n */\nexport function getRootFontSize(options?: { forceRefresh?: boolean }) {\n  if (cachedRootFontSize && !options?.forceRefresh) {\n    return cachedRootFontSize\n  }\n\n  const defaultFontSize = '16'\n\n  if (typeof window === 'undefined') {\n    cachedRootFontSize = defaultFontSize\n    return defaultFontSize\n  }\n\n  const match = window\n    .getComputedStyle(document.documentElement)\n    .getPropertyValue('font-size')\n    .match(/\\d+/)\n\n  cachedRootFontSize = match ? match[0] : defaultFontSize\n  return cachedRootFontSize\n}\n\n/**\n * Converts a pixel value into a `rem`-suffixed string relative to the document root font size.\n *\n * @param pxValue - The value in pixels\n * @returns The equivalent value as a string ending in `rem` (e.g. `'1.5rem'`)\n * @internal\n * @see {@link getRootFontSize}\n */\nexport function toRem(pxValue: number) {\n  return String(pxValue / Number(getRootFontSize())) + 'rem'\n}\n\n/**\n * Converts a `rem` value into pixels relative to the document root font size.\n *\n * @param rem - The value in `rem`. Accepts either a number (interpreted as raw `rem`) or a string that may include the `rem` suffix (e.g. `'1.5rem'`).\n * @returns The equivalent value in pixels as a number\n * @internal\n * @see {@link getRootFontSize}\n */\nexport const remToPx = (rem: string | number) =>\n  typeof rem === 'number'\n    ? Number(getRootFontSize()) * rem\n    : Number(getRootFontSize()) * Number(rem.replace('rem', ''))\n"],"names":["cachedRootFontSize","getRootFontSize","options","defaultFontSize","match","toRem","pxValue","remToPx","rem"],"mappings":"AAAA,IAAIA,IAAoC;AAcjC,SAASC,EAAgBC,GAAsC;AACpE,MAAIF;AACF,WAAOA;AAGT,QAAMG,IAAkB;AAExB,MAAI,OAAO,SAAW;AACpB,WAAAH,IAAqBG,GACdA;AAGT,QAAMC,IAAQ,OACX,iBAAiB,SAAS,eAAe,EACzC,iBAAiB,WAAW,EAC5B,MAAM,KAAK;AAEd,SAAAJ,IAAqBI,IAAQA,EAAM,CAAC,IAAID,GACjCH;AACT;AAUO,SAASK,EAAMC,GAAiB;AACrC,SAAO,OAAOA,IAAU,OAAOL,EAAA,CAAiB,CAAC,IAAI;AACvD;AAUO,MAAMM,IAAU,CAACC,MACtB,OAAOA,KAAQ,WACX,OAAOP,GAAiB,IAAIO,IAC5B,OAAOP,EAAA,CAAiB,IAAI,OAAOO,EAAI,QAAQ,OAAO,EAAE,CAAC;"}

package/dist/helpers/responsive.d.ts

@@ -1,12 +1,67 @@
 import { BREAKPOINTS } from '../shared/constants';
 type BreakpointKey = (typeof BREAKPOINTS)[keyof typeof BREAKPOINTS];
+/**
+ * A value that may be specified as a single value or as a partial map of breakpoints to values.
+ *
+ * @typeParam T - The underlying value type at each breakpoint.
+ * @internal
+ */
 export type Responsive<T> = T | Partial<{
     [K in BreakpointKey]: T;
 }>;
+/**
+ * Value accepted for a CSS custom property — either a string token or a numeric pixel value.
+ *
+ * @internal
+ */
 export type CustomPropertyValue = string | number;
+/**
+ * Returns true if the value is a breakpoint-keyed object rather than a single value.
+ *
+ * @param value - The value to inspect.
+ * @returns Whether the value is keyed by a known breakpoint.
+ * @internal
+ */
 export declare function isResponsiveValue(value: Responsive<CustomPropertyValue | CustomPropertyValue[]>): boolean;
+/**
+ * Applies a transform to every breakpoint entry in a responsive value.
+ *
+ * Non-responsive values are treated as if specified at the `base` breakpoint.
+ *
+ * @param value - The responsive value to transform.
+ * @param transformValue - Function applied to each per-breakpoint value.
+ * @returns A map of breakpoint key to the transformed string value.
+ * @internal
+ */
 export declare function transformResponsiveValue(value: Responsive<CustomPropertyValue | CustomPropertyValue[]>, transformValue: (value: CustomPropertyValue | CustomPropertyValue[]) => string): Record<string, string>;
+/**
+ * Converts numeric values to rem units and passes string values through unchanged.
+ *
+ * @param value - A pixel number or a pre-formatted CSS length string.
+ * @returns The value as a rem-unit string when numeric, otherwise the original string.
+ * @internal
+ */
 export declare const toRemIfNumeric: (value: string | number) => string;
+/**
+ * Builds a map of CSS custom properties for one property across breakpoints.
+ *
+ * Each entry is keyed `--g-<property>-<breakpoint>` and numeric values are converted to rem.
+ * Array values are joined with spaces (for shorthand properties like margin).
+ *
+ * @param property - The base property name used to build custom property keys.
+ * @param value - The responsive value, or undefined to produce no properties.
+ * @returns A map of custom property names to string values.
+ * @internal
+ */
 export declare function createResponsiveCustomProperties(property: string, value?: Responsive<CustomPropertyValue | CustomPropertyValue[]>): Record<string, string>;
+/**
+ * Builds a flat map of CSS custom properties for multiple properties at once.
+ *
+ * Combines the output of {@link createResponsiveCustomProperties} for every entry in the input.
+ *
+ * @param properties - A map of property name to its responsive value.
+ * @returns A flat map of custom property names to string values suitable for a `style` prop.
+ * @internal
+ */
 export declare function setResponsiveCustomProperties(properties?: Record<string, Responsive<CustomPropertyValue | CustomPropertyValue[]> | undefined>): Record<string, string>;
 export {};

package/dist/helpers/responsive.js.map

@@ -1 +1 @@
-{"version":3,"file":"responsive.js","sources":["../../src/helpers/responsive.ts"],"sourcesContent":["import { toRem } from '@/helpers/rem'\nimport { BREAKPOINTS } from '@/shared/constants'\n\ntype BreakpointKey = (typeof BREAKPOINTS)[keyof typeof BREAKPOINTS]\n\nexport type Responsive<T> =\n  | T\n  | Partial<{\n      [K in BreakpointKey]: T\n    }>\n\nexport type CustomPropertyValue = string | number\n\nexport function isResponsiveValue(value: Responsive<CustomPropertyValue | CustomPropertyValue[]>) {\n  return Object.values(BREAKPOINTS).some(\n    breakpoint => typeof value === 'object' && breakpoint in value,\n  )\n}\n\nexport function transformResponsiveValue(\n  value: Responsive<CustomPropertyValue | CustomPropertyValue[]>,\n  transformValue: (value: CustomPropertyValue | CustomPropertyValue[]) => string,\n) {\n  const responsiveValue = isResponsiveValue(value) ? value : { base: value }\n\n  const transformedResponsiveValue: Record<string, string> = {}\n\n  Object.entries(responsiveValue).forEach(([key, value]) => {\n    transformedResponsiveValue[key] = transformValue(value)\n  })\n\n  return transformedResponsiveValue\n}\n\nexport const toRemIfNumeric = (value: string | number) => {\n  return typeof value === 'number' ? toRem(value) : value\n}\n\nexport function createResponsiveCustomProperties(\n  property: string,\n  value?: Responsive<CustomPropertyValue | CustomPropertyValue[]>,\n) {\n  if (!value && value !== 0) return {}\n\n  const responsiveValues = isResponsiveValue(value) ? value : { base: value }\n  const properties: Record<string, string> = {}\n\n  Object.entries(responsiveValues).forEach(([key, customPropertyValue]) => {\n    const customPropertyValueResult = Array.isArray(customPropertyValue)\n      ? customPropertyValue.map(toRemIfNumeric).join(' ')\n      : toRemIfNumeric(customPropertyValue)\n\n    properties[`--g-${property}-${key}`] = customPropertyValueResult\n  })\n\n  return properties\n}\n\nexport function setResponsiveCustomProperties(\n  properties?: Record<string, Responsive<CustomPropertyValue | CustomPropertyValue[]> | undefined>,\n) {\n  const allProperties: Record<string, string> = {}\n\n  if (!properties) return allProperties\n\n  Object.entries(properties).forEach(([property, value]) => {\n    Object.assign(allProperties, createResponsiveCustomProperties(property, value))\n  })\n\n  return allProperties\n}\n"],"names":["isResponsiveValue","value","BREAKPOINTS","breakpoint","toRemIfNumeric","toRem","createResponsiveCustomProperties","property","responsiveValues","properties","key","customPropertyValue","customPropertyValueResult","setResponsiveCustomProperties","allProperties"],"mappings":";;AAaO,SAASA,EAAkBC,GAAgE;AAChG,SAAO,OAAO,OAAOC,CAAW,EAAE;AAAA,IAChC,CAAAC,MAAc,OAAOF,KAAU,YAAYE,KAAcF;AAAA,EAAA;AAE7D;AAiBO,MAAMG,IAAiB,CAACH,MACtB,OAAOA,KAAU,WAAWI,EAAMJ,CAAK,IAAIA;AAG7C,SAASK,EACdC,GACAN,GACA;AACA,MAAI,CAACA,KAASA,MAAU,UAAU,CAAA;AAElC,QAAMO,IAAmBR,EAAkBC,CAAK,IAAIA,IAAQ,EAAE,MAAMA,EAAA,GAC9DQ,IAAqC,CAAA;AAE3C,gBAAO,QAAQD,CAAgB,EAAE,QAAQ,CAAC,CAACE,GAAKC,CAAmB,MAAM;AACvE,UAAMC,IAA4B,MAAM,QAAQD,CAAmB,IAC/DA,EAAoB,IAAIP,CAAc,EAAE,KAAK,GAAG,IAChDA,EAAeO,CAAmB;AAEtC,IAAAF,EAAW,OAAOF,CAAQ,IAAIG,CAAG,EAAE,IAAIE;AAAA,EACzC,CAAC,GAEMH;AACT;AAEO,SAASI,EACdJ,GACA;AACA,QAAMK,IAAwC,CAAA;AAE9C,SAAKL,KAEL,OAAO,QAAQA,CAAU,EAAE,QAAQ,CAAC,CAACF,GAAUN,CAAK,MAAM;AACxD,WAAO,OAAOa,GAAeR,EAAiCC,GAAUN,CAAK,CAAC;AAAA,EAChF,CAAC,GAEMa;AACT;"}
+{"version":3,"file":"responsive.js","sources":["../../src/helpers/responsive.ts"],"sourcesContent":["import { toRem } from '@/helpers/rem'\nimport { BREAKPOINTS } from '@/shared/constants'\n\ntype BreakpointKey = (typeof BREAKPOINTS)[keyof typeof BREAKPOINTS]\n\n/**\n * A value that may be specified as a single value or as a partial map of breakpoints to values.\n *\n * @typeParam T - The underlying value type at each breakpoint.\n * @internal\n */\nexport type Responsive<T> =\n  | T\n  | Partial<{\n      [K in BreakpointKey]: T\n    }>\n\n/**\n * Value accepted for a CSS custom property — either a string token or a numeric pixel value.\n *\n * @internal\n */\nexport type CustomPropertyValue = string | number\n\n/**\n * Returns true if the value is a breakpoint-keyed object rather than a single value.\n *\n * @param value - The value to inspect.\n * @returns Whether the value is keyed by a known breakpoint.\n * @internal\n */\nexport function isResponsiveValue(value: Responsive<CustomPropertyValue | CustomPropertyValue[]>) {\n  return Object.values(BREAKPOINTS).some(\n    breakpoint => typeof value === 'object' && breakpoint in value,\n  )\n}\n\n/**\n * Applies a transform to every breakpoint entry in a responsive value.\n *\n * Non-responsive values are treated as if specified at the `base` breakpoint.\n *\n * @param value - The responsive value to transform.\n * @param transformValue - Function applied to each per-breakpoint value.\n * @returns A map of breakpoint key to the transformed string value.\n * @internal\n */\nexport function transformResponsiveValue(\n  value: Responsive<CustomPropertyValue | CustomPropertyValue[]>,\n  transformValue: (value: CustomPropertyValue | CustomPropertyValue[]) => string,\n) {\n  const responsiveValue = isResponsiveValue(value) ? value : { base: value }\n\n  const transformedResponsiveValue: Record<string, string> = {}\n\n  Object.entries(responsiveValue).forEach(([key, value]) => {\n    transformedResponsiveValue[key] = transformValue(value)\n  })\n\n  return transformedResponsiveValue\n}\n\n/**\n * Converts numeric values to rem units and passes string values through unchanged.\n *\n * @param value - A pixel number or a pre-formatted CSS length string.\n * @returns The value as a rem-unit string when numeric, otherwise the original string.\n * @internal\n */\nexport const toRemIfNumeric = (value: string | number) => {\n  return typeof value === 'number' ? toRem(value) : value\n}\n\n/**\n * Builds a map of CSS custom properties for one property across breakpoints.\n *\n * Each entry is keyed `--g-<property>-<breakpoint>` and numeric values are converted to rem.\n * Array values are joined with spaces (for shorthand properties like margin).\n *\n * @param property - The base property name used to build custom property keys.\n * @param value - The responsive value, or undefined to produce no properties.\n * @returns A map of custom property names to string values.\n * @internal\n */\nexport function createResponsiveCustomProperties(\n  property: string,\n  value?: Responsive<CustomPropertyValue | CustomPropertyValue[]>,\n) {\n  if (!value && value !== 0) return {}\n\n  const responsiveValues = isResponsiveValue(value) ? value : { base: value }\n  const properties: Record<string, string> = {}\n\n  Object.entries(responsiveValues).forEach(([key, customPropertyValue]) => {\n    const customPropertyValueResult = Array.isArray(customPropertyValue)\n      ? customPropertyValue.map(toRemIfNumeric).join(' ')\n      : toRemIfNumeric(customPropertyValue)\n\n    properties[`--g-${property}-${key}`] = customPropertyValueResult\n  })\n\n  return properties\n}\n\n/**\n * Builds a flat map of CSS custom properties for multiple properties at once.\n *\n * Combines the output of {@link createResponsiveCustomProperties} for every entry in the input.\n *\n * @param properties - A map of property name to its responsive value.\n * @returns A flat map of custom property names to string values suitable for a `style` prop.\n * @internal\n */\nexport function setResponsiveCustomProperties(\n  properties?: Record<string, Responsive<CustomPropertyValue | CustomPropertyValue[]> | undefined>,\n) {\n  const allProperties: Record<string, string> = {}\n\n  if (!properties) return allProperties\n\n  Object.entries(properties).forEach(([property, value]) => {\n    Object.assign(allProperties, createResponsiveCustomProperties(property, value))\n  })\n\n  return allProperties\n}\n"],"names":["isResponsiveValue","value","BREAKPOINTS","breakpoint","toRemIfNumeric","toRem","createResponsiveCustomProperties","property","responsiveValues","properties","key","customPropertyValue","customPropertyValueResult","setResponsiveCustomProperties","allProperties"],"mappings":";;AA+BO,SAASA,EAAkBC,GAAgE;AAChG,SAAO,OAAO,OAAOC,CAAW,EAAE;AAAA,IAChC,CAAAC,MAAc,OAAOF,KAAU,YAAYE,KAAcF;AAAA,EAAA;AAE7D;AAkCO,MAAMG,IAAiB,CAACH,MACtB,OAAOA,KAAU,WAAWI,EAAMJ,CAAK,IAAIA;AAc7C,SAASK,EACdC,GACAN,GACA;AACA,MAAI,CAACA,KAASA,MAAU,UAAU,CAAA;AAElC,QAAMO,IAAmBR,EAAkBC,CAAK,IAAIA,IAAQ,EAAE,MAAMA,EAAA,GAC9DQ,IAAqC,CAAA;AAE3C,gBAAO,QAAQD,CAAgB,EAAE,QAAQ,CAAC,CAACE,GAAKC,CAAmB,MAAM;AACvE,UAAMC,IAA4B,MAAM,QAAQD,CAAmB,IAC/DA,EAAoB,IAAIP,CAAc,EAAE,KAAK,GAAG,IAChDA,EAAeO,CAAmB;AAEtC,IAAAF,EAAW,OAAOF,CAAQ,IAAIG,CAAG,EAAE,IAAIE;AAAA,EACzC,CAAC,GAEMH;AACT;AAWO,SAASI,EACdJ,GACA;AACA,QAAMK,IAAwC,CAAA;AAE9C,SAAKL,KAEL,OAAO,QAAQA,CAAU,EAAE,QAAQ,CAAC,CAACF,GAAUN,CAAK,MAAM;AACxD,WAAO,OAAOa,GAAeR,EAAiCC,GAAUN,CAAK,CAAC;AAAA,EAChF,CAAC,GAEMa;AACT;"}

package/dist/helpers/retryAsync.d.ts

@@ -3,5 +3,19 @@ interface RetryAsyncOptions {
     delayMs: number;
     shouldRetry: (error: unknown) => boolean;
 }
+/**
+ * Retries an async function up to a maximum number of attempts, with a fixed delay between tries.
+ *
+ * The function is invoked at least once. After a failure, `shouldRetry` decides whether to retry;
+ * if it returns false the error is rethrown immediately. Errors from the final attempt are always
+ * rethrown.
+ *
+ * @typeParam T - The resolved value type of the async function.
+ * @param fn - The async function to invoke.
+ * @param options - Retry configuration: `maxAttempts`, `delayMs` between attempts, and a `shouldRetry` predicate.
+ * @returns The resolved value from the first successful call.
+ * @throws The error from the final attempt, or the first error for which `shouldRetry` returns false.
+ * @internal
+ */
 export declare function retryAsync<T>(fn: () => Promise<T>, { maxAttempts, delayMs, shouldRetry }: RetryAsyncOptions): Promise<T>;
 export {};

package/dist/helpers/retryAsync.js.map

@@ -1 +1 @@
-{"version":3,"file":"retryAsync.js","sources":["../../src/helpers/retryAsync.ts"],"sourcesContent":["interface RetryAsyncOptions {\n  maxAttempts: number\n  delayMs: number\n  shouldRetry: (error: unknown) => boolean\n}\n\nexport async function retryAsync<T>(\n  fn: () => Promise<T>,\n  { maxAttempts, delayMs, shouldRetry }: RetryAsyncOptions,\n): Promise<T> {\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn()\n    } catch (error) {\n      const isLastAttempt = attempt === maxAttempts - 1\n      if (shouldRetry(error) && !isLastAttempt) {\n        await new Promise(resolve => setTimeout(resolve, delayMs))\n        continue\n      }\n      throw error\n    }\n  }\n\n  throw new Error('retryAsync: exhausted all attempts without resolving')\n}\n"],"names":["retryAsync","fn","maxAttempts","delayMs","shouldRetry","attempt","error","isLastAttempt","resolve"],"mappings":"AAMA,eAAsBA,EACpBC,GACA,EAAE,aAAAC,GAAa,SAAAC,GAAS,aAAAC,KACZ;AACZ,WAASC,IAAU,GAAGA,IAAUH,GAAaG;AAC3C,QAAI;AACF,aAAO,MAAMJ,EAAA;AAAA,IACf,SAASK,GAAO;AACd,YAAMC,IAAgBF,MAAYH,IAAc;AAChD,UAAIE,EAAYE,CAAK,KAAK,CAACC,GAAe;AACxC,cAAM,IAAI,QAAQ,CAAAC,MAAW,WAAWA,GAASL,CAAO,CAAC;AACzD;AAAA,MACF;AACA,YAAMG;AAAA,IACR;AAGF,QAAM,IAAI,MAAM,sDAAsD;AACxE;"}
+{"version":3,"file":"retryAsync.js","sources":["../../src/helpers/retryAsync.ts"],"sourcesContent":["interface RetryAsyncOptions {\n  maxAttempts: number\n  delayMs: number\n  shouldRetry: (error: unknown) => boolean\n}\n\n/**\n * Retries an async function up to a maximum number of attempts, with a fixed delay between tries.\n *\n * The function is invoked at least once. After a failure, `shouldRetry` decides whether to retry;\n * if it returns false the error is rethrown immediately. Errors from the final attempt are always\n * rethrown.\n *\n * @typeParam T - The resolved value type of the async function.\n * @param fn - The async function to invoke.\n * @param options - Retry configuration: `maxAttempts`, `delayMs` between attempts, and a `shouldRetry` predicate.\n * @returns The resolved value from the first successful call.\n * @throws The error from the final attempt, or the first error for which `shouldRetry` returns false.\n * @internal\n */\nexport async function retryAsync<T>(\n  fn: () => Promise<T>,\n  { maxAttempts, delayMs, shouldRetry }: RetryAsyncOptions,\n): Promise<T> {\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn()\n    } catch (error) {\n      const isLastAttempt = attempt === maxAttempts - 1\n      if (shouldRetry(error) && !isLastAttempt) {\n        await new Promise(resolve => setTimeout(resolve, delayMs))\n        continue\n      }\n      throw error\n    }\n  }\n\n  throw new Error('retryAsync: exhausted all attempts without resolving')\n}\n"],"names":["retryAsync","fn","maxAttempts","delayMs","shouldRetry","attempt","error","isLastAttempt","resolve"],"mappings":"AAoBA,eAAsBA,EACpBC,GACA,EAAE,aAAAC,GAAa,SAAAC,GAAS,aAAAC,KACZ;AACZ,WAASC,IAAU,GAAGA,IAAUH,GAAaG;AAC3C,QAAI;AACF,aAAO,MAAMJ,EAAA;AAAA,IACf,SAASK,GAAO;AACd,YAAMC,IAAgBF,MAAYH,IAAc;AAChD,UAAIE,EAAYE,CAAK,KAAK,CAACC,GAAe;AACxC,cAAM,IAAI,QAAQ,CAAAC,MAAW,WAAWA,GAASL,CAAO,CAAC;AACzD;AAAA,MACF;AACA,YAAMG;AAAA,IACR;AAGF,QAAM,IAAI,MAAM,sDAAsD;AACxE;"}

package/dist/helpers/ssn.d.ts

@@ -1,3 +1,18 @@
+/**
+ * Formats an SSN-like input string as `XXX-XX-XXXX`, stripping non-digit characters.
+ *
+ * Excess digits beyond nine are truncated.
+ *
+ * @param value - Raw user input that may contain digits, spaces, or punctuation.
+ * @returns The dash-formatted SSN, or an empty string if no digits are present.
+ * @internal
+ */
 export declare const normalizeSSN: (value: string) => string;
-export declare const createPlaceholderSSN: (hasSSN?: boolean, placeholderSSN?: string) => string | undefined;
+/**
+ * Hook that returns the localized SSN placeholder when an SSN is already on file.
+ *
+ * @param hasSSN - Whether the underlying record already has an SSN stored.
+ * @returns The translated placeholder string, or an empty string when no SSN exists.
+ * @internal
+ */
 export declare const usePlaceholderSSN: (hasSSN?: boolean) => string | undefined;

package/dist/helpers/ssn.js

@@ -4,7 +4,6 @@ const s = (o) => o.match(/\d*/g)?.join("").match(/(\d{0,3})(\d{0,2})(\d{0,4})/)?
   return n(o, e("inputs.ssn.placeholder"));
 };
 export {
-  n as createPlaceholderSSN,
   s as normalizeSSN,
   c as usePlaceholderSSN
 };

package/dist/helpers/ssn.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssn.js","sources":["../../src/helpers/ssn.ts"],"sourcesContent":["import { useTranslation } from 'react-i18next'\n\nexport const normalizeSSN = (value: string) =>\n  value\n    .match(/\\d*/g)\n    ?.join('')\n    .match(/(\\d{0,3})(\\d{0,2})(\\d{0,4})/)\n    ?.slice(1)\n    .filter(match => match !== '')\n    .join('-')\n    .substring(0, 12) || ''\n\nexport const createPlaceholderSSN = (hasSSN?: boolean, placeholderSSN?: string) =>\n  hasSSN ? placeholderSSN : ''\n\nexport const usePlaceholderSSN = (hasSSN?: boolean) => {\n  const { t } = useTranslation('common')\n  return createPlaceholderSSN(hasSSN, t('inputs.ssn.placeholder'))\n}\n"],"names":["normalizeSSN","value","match","createPlaceholderSSN","hasSSN","placeholderSSN","usePlaceholderSSN","t","useTranslation"],"mappings":";AAEO,MAAMA,IAAe,CAACC,MAC3BA,EACG,MAAM,MAAM,GACX,KAAK,EAAE,EACR,MAAM,6BAA6B,GAClC,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":"ssn.js","sources":["../../src/helpers/ssn.ts"],"sourcesContent":["import { useTranslation } from 'react-i18next'\n\n/**\n * Formats an SSN-like input string as `XXX-XX-XXXX`, stripping non-digit characters.\n *\n * Excess digits beyond nine are truncated.\n *\n * @param value - Raw user input that may contain digits, spaces, or punctuation.\n * @returns The dash-formatted SSN, or an empty string if no digits are present.\n * @internal\n */\nexport const normalizeSSN = (value: string) =>\n  value\n    .match(/\\d*/g)\n    ?.join('')\n    .match(/(\\d{0,3})(\\d{0,2})(\\d{0,4})/)\n    ?.slice(1)\n    .filter(match => match !== '')\n    .join('-')\n    .substring(0, 12) || ''\n\n/**\n * Returns the masked placeholder string when an SSN is already on file, otherwise an empty string.\n *\n * @param hasSSN - Whether the underlying record already has an SSN stored.\n * @param placeholderSSN - The masked placeholder to display when an SSN exists.\n * @returns The placeholder when `hasSSN` is true, otherwise an empty string.\n * @internal\n */\nconst createPlaceholderSSN = (hasSSN?: boolean, placeholderSSN?: string) =>\n  hasSSN ? placeholderSSN : ''\n\n/**\n * Hook that returns the localized SSN placeholder when an SSN is already on file.\n *\n * @param hasSSN - Whether the underlying record already has an SSN stored.\n * @returns The translated placeholder string, or an empty string when no SSN exists.\n * @internal\n */\nexport const usePlaceholderSSN = (hasSSN?: boolean) => {\n  const { t } = useTranslation('common')\n  return createPlaceholderSSN(hasSSN, t('inputs.ssn.placeholder'))\n}\n"],"names":["normalizeSSN","value","match","createPlaceholderSSN","hasSSN","placeholderSSN","usePlaceholderSSN","t","useTranslation"],"mappings":";AAWO,MAAMA,IAAe,CAACC,MAC3BA,EACG,MAAM,MAAM,GACX,KAAK,EAAE,EACR,MAAM,6BAA6B,GAClC,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/validations.d.ts

@@ -1,8 +1,46 @@
 import { z } from 'zod';
+/**
+ * Regex matching personal names: one or two words composed of Latin or extended-Latin letters,
+ * with optional internal spaces, hyphens, or apostrophes, and an optional trailing period.
+ *
+ * @internal
+ */
 export declare const NAME_REGEX: RegExp;
+/**
+ * Zod schema validating a non-empty personal name against {@link NAME_REGEX}.
+ *
+ * @internal
+ */
 export declare const nameValidation: z.ZodString;
+/**
+ * Zod schema validating a US ZIP code in either 5-digit (`12345`) or ZIP+4 (`12345-6789`) form.
+ *
+ * @internal
+ */
 export declare const zipValidation: z.ZodString;
+/**
+ * Regex matching a valid US Social Security Number. Rejects reserved area numbers (000, 666, 9xx),
+ * a group number of 00, and a serial number of 0000.
+ *
+ * @internal
+ */
 export declare const SSN_REGEX: RegExp;
+/**
+ * Zod schema validating a US phone number. Formats the input with the phone mask and accepts it
+ * only when the digit-only form is exactly ten digits.
+ *
+ * @internal
+ */
 export declare const phoneValidation: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+/**
+ * Zod schema validating a bank routing number (exactly nine digits).
+ *
+ * @internal
+ */
 export declare const routingNumberValidation: z.ZodString;
+/**
+ * Zod schema validating a bank account number (one to seventeen digits).
+ *
+ * @internal
+ */
 export declare const accountNumberValidation: z.ZodString;

package/dist/helpers/validations.js.map

@@ -1 +1 @@
-{"version":3,"file":"validations.js","sources":["../../src/helpers/validations.ts"],"sourcesContent":["import { z } from 'zod'\nimport { commonMasks, formatWithMask } from './mask'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\nexport const NAME_REGEX = /^([a-zA-Z\\xC0-\\uFFFF]+([ \\-']{0,1}[a-zA-Z\\xC0-\\uFFFF]+)*[.]{0,1}){1,2}$/\n\nexport const nameValidation = z.string().min(1).regex(NAME_REGEX)\n\nexport const zipValidation = z.string().refine(zip => /(^\\d{5}$)|(^\\d{5}-\\d{4}$)/.test(zip))\n\nexport const SSN_REGEX = /^(?!(000|666|9))\\d{3}(?!00)\\d{2}(?!0000)\\d{4}$/\n\nexport const phoneValidation = z\n  .string()\n  .transform(value => formatWithMask(value, commonMasks.phoneMask))\n  .refine(phone => {\n    const digits = removeNonDigits(phone)\n    return digits.length === 10\n  })\n\nexport const routingNumberValidation = z.string().regex(/^[0-9]{9}$/)\nexport const accountNumberValidation = z.string().regex(/^[0-9]{1,17}$/)\n"],"names":["NAME_REGEX","nameValidation","z","zipValidation","zip","SSN_REGEX","phoneValidation","value","formatWithMask","commonMasks","phone","removeNonDigits","routingNumberValidation","accountNumberValidation"],"mappings":";;;AAIO,MAAMA,IAAa,2EAEbC,IAAiBC,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,MAAMF,CAAU,GAEnDG,IAAgBD,EAAE,SAAS,OAAO,CAAAE,MAAO,4BAA4B,KAAKA,CAAG,CAAC,GAE9EC,IAAY,kDAEZC,IAAkBJ,EAC5B,OAAA,EACA,UAAU,CAAAK,MAASC,EAAeD,GAAOE,EAAY,SAAS,CAAC,EAC/D,OAAO,CAAAC,MACSC,EAAgBD,CAAK,EACtB,WAAW,EAC1B,GAEUE,IAA0BV,EAAE,OAAA,EAAS,MAAM,YAAY,GACvDW,IAA0BX,EAAE,OAAA,EAAS,MAAM,eAAe;"}
+{"version":3,"file":"validations.js","sources":["../../src/helpers/validations.ts"],"sourcesContent":["import { z } from 'zod'\nimport { commonMasks, formatWithMask } from './mask'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\n/**\n * Regex matching personal names: one or two words composed of Latin or extended-Latin letters,\n * with optional internal spaces, hyphens, or apostrophes, and an optional trailing period.\n *\n * @internal\n */\nexport const NAME_REGEX = /^([a-zA-Z\\xC0-\\uFFFF]+([ \\-']{0,1}[a-zA-Z\\xC0-\\uFFFF]+)*[.]{0,1}){1,2}$/\n\n/**\n * Zod schema validating a non-empty personal name against {@link NAME_REGEX}.\n *\n * @internal\n */\nexport const nameValidation = z.string().min(1).regex(NAME_REGEX)\n\n/**\n * Zod schema validating a US ZIP code in either 5-digit (`12345`) or ZIP+4 (`12345-6789`) form.\n *\n * @internal\n */\nexport const zipValidation = z.string().refine(zip => /(^\\d{5}$)|(^\\d{5}-\\d{4}$)/.test(zip))\n\n/**\n * Regex matching a valid US Social Security Number. Rejects reserved area numbers (000, 666, 9xx),\n * a group number of 00, and a serial number of 0000.\n *\n * @internal\n */\nexport const SSN_REGEX = /^(?!(000|666|9))\\d{3}(?!00)\\d{2}(?!0000)\\d{4}$/\n\n/**\n * Zod schema validating a US phone number. Formats the input with the phone mask and accepts it\n * only when the digit-only form is exactly ten digits.\n *\n * @internal\n */\nexport const phoneValidation = z\n  .string()\n  .transform(value => formatWithMask(value, commonMasks.phoneMask))\n  .refine(phone => {\n    const digits = removeNonDigits(phone)\n    return digits.length === 10\n  })\n\n/**\n * Zod schema validating a bank routing number (exactly nine digits).\n *\n * @internal\n */\nexport const routingNumberValidation = z.string().regex(/^[0-9]{9}$/)\n/**\n * Zod schema validating a bank account number (one to seventeen digits).\n *\n * @internal\n */\nexport const accountNumberValidation = z.string().regex(/^[0-9]{1,17}$/)\n"],"names":["NAME_REGEX","nameValidation","z","zipValidation","zip","SSN_REGEX","phoneValidation","value","formatWithMask","commonMasks","phone","removeNonDigits","routingNumberValidation","accountNumberValidation"],"mappings":";;;AAUO,MAAMA,IAAa,2EAObC,IAAiBC,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,MAAMF,CAAU,GAOnDG,IAAgBD,EAAE,SAAS,OAAO,CAAAE,MAAO,4BAA4B,KAAKA,CAAG,CAAC,GAQ9EC,IAAY,kDAQZC,IAAkBJ,EAC5B,OAAA,EACA,UAAU,CAAAK,MAASC,EAAeD,GAAOE,EAAY,SAAS,CAAC,EAC/D,OAAO,CAAAC,MACSC,EAAgBD,CAAK,EACtB,WAAW,EAC1B,GAOUE,IAA0BV,EAAE,OAAA,EAAS,MAAM,YAAY,GAMvDW,IAA0BX,EAAE,OAAA,EAAS,MAAM,eAAe;"}

package/dist/hooks/useAsyncError.d.ts

@@ -1,6 +1,15 @@
 /**
- * Triggers re-render of a component to allow ErrorBoundary to catch a thrown error - that way we can handle all exceptions from asynchrounous functions in the same way and catch them in react boundary
+ * Surfaces an asynchronous error to the nearest React `ErrorBoundary`.
  *
- * @returns Function
+ * @remarks
+ * Errors thrown inside async callbacks (event handlers, effects, promises) are not caught by
+ * React's error boundary machinery. The returned callback schedules a state update that re-throws
+ * the supplied error during render, which causes the boundary to receive it like any sync error.
+ *
+ * Non-`Error` values are coerced — strings become the error message, anything else becomes
+ * `"Unknown error"`.
+ *
+ * @returns A callback that, when invoked with an error, triggers the surrounding error boundary.
+ * @internal
  */
 export declare const useAsyncError: () => (e: unknown) => void;

package/dist/hooks/useAsyncError.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncError.js","sources":["../../src/hooks/useAsyncError.tsx"],"sourcesContent":["import React from 'react'\n/**\n * Triggers re-render of a component to allow ErrorBoundary to catch a thrown error - that way we can handle all exceptions from asynchrounous functions in the same way and catch them in react boundary\n *\n * @returns Function\n */\nexport const useAsyncError = () => {\n  const [_, setError] = React.useState()\n  return React.useCallback(\n    (e: unknown) => {\n      const err = e instanceof Error ? e : new Error(typeof e === 'string' ? e : 'Unknown error')\n      setError(() => {\n        throw err\n      })\n    },\n    [setError],\n  )\n}\n"],"names":["useAsyncError","_","setError","React","e","err"],"mappings":";AAMO,MAAMA,IAAgB,MAAM;AACjC,QAAM,CAACC,GAAGC,CAAQ,IAAIC,EAAM,SAAA;AAC5B,SAAOA,EAAM;AAAA,IACX,CAACC,MAAe;AACd,YAAMC,IAAMD,aAAa,QAAQA,IAAI,IAAI,MAAM,OAAOA,KAAM,WAAWA,IAAI,eAAe;AAC1F,MAAAF,EAAS,MAAM;AACb,cAAMG;AAAA,MACR,CAAC;AAAA,IACH;AAAA,IACA,CAACH,CAAQ;AAAA,EAAA;AAEb;"}
+{"version":3,"file":"useAsyncError.js","sources":["../../src/hooks/useAsyncError.tsx"],"sourcesContent":["import React from 'react'\n/**\n * Surfaces an asynchronous error to the nearest React `ErrorBoundary`.\n *\n * @remarks\n * Errors thrown inside async callbacks (event handlers, effects, promises) are not caught by\n * React's error boundary machinery. The returned callback schedules a state update that re-throws\n * the supplied error during render, which causes the boundary to receive it like any sync error.\n *\n * Non-`Error` values are coerced — strings become the error message, anything else becomes\n * `\"Unknown error\"`.\n *\n * @returns A callback that, when invoked with an error, triggers the surrounding error boundary.\n * @internal\n */\nexport const useAsyncError = () => {\n  const [_, setError] = React.useState()\n  return React.useCallback(\n    (e: unknown) => {\n      const err = e instanceof Error ? e : new Error(typeof e === 'string' ? e : 'Unknown error')\n      setError(() => {\n        throw err\n      })\n    },\n    [setError],\n  )\n}\n"],"names":["useAsyncError","_","setError","React","e","err"],"mappings":";AAeO,MAAMA,IAAgB,MAAM;AACjC,QAAM,CAACC,GAAGC,CAAQ,IAAIC,EAAM,SAAA;AAC5B,SAAOA,EAAM;AAAA,IACX,CAACC,MAAe;AACd,YAAMC,IAAMD,aAAa,QAAQA,IAAI,IAAI,MAAM,OAAOA,KAAM,WAAWA,IAAI,eAAe;AAC1F,MAAAF,EAAS,MAAM;AACb,cAAMG;AAAA,MACR,CAAC;AAAA,IACH;AAAA,IACA,CAACH,CAAQ;AAAA,EAAA;AAEb;"}

package/dist/hooks/useClientPagination/useClientPagination.d.ts

@@ -19,6 +19,14 @@ interface UseClientPaginationOptions<TItem> {
      */
     searchDebounceMs?: number;
 }
+/**
+ * Return shape of {@link useClientPagination}: the current-page slice, a
+ * `PaginationControlProps`-shaped object, the controlled search value, and
+ * search actions.
+ *
+ * @typeParam TItem - The element type of the paginated list.
+ * @internal
+ */
 export interface UseClientPaginationResult<TItem> {
     /** Current-page slice. */
     data: TItem[];
@@ -32,13 +40,25 @@ export interface UseClientPaginationResult<TItem> {
     };
 }
 /**
- * Client-side pagination + optional search over an in-memory array.
+ * Client-side pagination and optional search over an in-memory array.
  *
+ * @remarks
  * Returns a `PaginationControlProps`-shaped pagination object that drops
  * straight into `useDataView` / `PaginationControl`. Use this when the
  * caller already has the full list of items and wants to paginate/search
  * it locally. Pair with `usePagination` if you want to page through an
  * API endpoint instead.
+ *
+ * Search state is owned by the hook, debounced, and resets the current
+ * page to 1 once the debounce settles. The current page is clamped to the
+ * latest total so a shrinking filtered list never lands on an empty page.
+ *
+ * @typeParam TItem - The element type of the paginated list.
+ * @param allItems - The full in-memory list to paginate and optionally filter.
+ * @param options - Search predicate, default rows-per-page, and debounce window.
+ * @returns A {@link UseClientPaginationResult} with the current-page slice,
+ *   pagination controls, the controlled search value, and search actions.
+ * @internal
  */
 export declare function useClientPagination<TItem>(allItems: TItem[], options?: UseClientPaginationOptions<TItem>): UseClientPaginationResult<TItem>;
 export {};

package/dist/hooks/useClientPagination/useClientPagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"useClientPagination.js","sources":["../../../src/hooks/useClientPagination/useClientPagination.ts"],"sourcesContent":["import { useCallback, useDeferredValue, useEffect, useMemo, useState } from 'react'\nimport type {\n  PaginationControlProps,\n  PaginationItemsPerPage,\n} from '@/components/Common/PaginationControl/PaginationControlTypes'\n\nconst DEFAULT_SEARCH_DEBOUNCE_MS = 120\n\ninterface UseClientPaginationOptions<TItem> {\n  /**\n   * Optional substring/fuzzy/etc. predicate run against the debounced,\n   * deferred, trimmed search value. The hook owns search state and\n   * resets to page 1 once the debounce settles. A trimmed-empty value is\n   * treated as \"no search\" and the predicate is not called. Omit to skip\n   * search entirely.\n   */\n  searchPredicate?: (item: TItem, query: string) => boolean\n  /** Display rows-per-page. Default 5. */\n  defaultItemsPerPage?: PaginationItemsPerPage\n  /**\n   * Debounce window (ms) applied to the search value before it reaches\n   * the predicate and page reset. Keeps the controlled input responsive\n   * while preventing the filter from running on every keystroke for\n   * large lists or expensive predicates. Defaults to 120ms. Pass 0 to\n   * disable debouncing entirely (useful for tests).\n   */\n  searchDebounceMs?: number\n}\n\nexport interface UseClientPaginationResult<TItem> {\n  /** Current-page slice. */\n  data: TItem[]\n  /** Drop-in `PaginationControlProps` for `useDataView` / `PaginationControl`. */\n  pagination: PaginationControlProps\n  /** Current search value (controlled). */\n  searchValue: string\n  actions: {\n    onSearchChange: (value: string) => void\n    onSearchClear: () => void\n  }\n}\n\n/**\n * Client-side pagination + optional search over an in-memory array.\n *\n * Returns a `PaginationControlProps`-shaped pagination object that drops\n * straight into `useDataView` / `PaginationControl`. Use this when the\n * caller already has the full list of items and wants to paginate/search\n * it locally. Pair with `usePagination` if you want to page through an\n * API endpoint instead.\n */\nexport function useClientPagination<TItem>(\n  allItems: TItem[],\n  options: UseClientPaginationOptions<TItem> = {},\n): UseClientPaginationResult<TItem> {\n  const {\n    searchPredicate,\n    defaultItemsPerPage = 5,\n    searchDebounceMs = DEFAULT_SEARCH_DEBOUNCE_MS,\n  } = options\n\n  const [searchValue, setSearchValue] = useState('')\n  const [debouncedSearchValue, setDebouncedSearchValue] = useState('')\n  const deferredSearchValue = useDeferredValue(debouncedSearchValue)\n  const [currentPage, setCurrentPage] = useState(1)\n  const [itemsPerPage, setItemsPerPage] = useState<PaginationItemsPerPage>(defaultItemsPerPage)\n\n  useEffect(() => {\n    if (searchDebounceMs <= 0) {\n      setDebouncedSearchValue(prev => (prev === searchValue ? prev : searchValue))\n      setCurrentPage(prev => (prev === 1 ? prev : 1))\n      return\n    }\n    const timeoutId = setTimeout(() => {\n      setDebouncedSearchValue(prev => (prev === searchValue ? prev : searchValue))\n      setCurrentPage(prev => (prev === 1 ? prev : 1))\n    }, searchDebounceMs)\n    return () => {\n      clearTimeout(timeoutId)\n    }\n  }, [searchValue, searchDebounceMs])\n\n  const searchFilteredItems = useMemo<TItem[]>(() => {\n    if (!searchPredicate) return allItems\n    const trimmed = deferredSearchValue.trim()\n    if (!trimmed) return allItems\n    return allItems.filter(item => searchPredicate(item, trimmed))\n  }, [allItems, deferredSearchValue, searchPredicate])\n\n  const totalCount = searchFilteredItems.length\n  const totalPages = Math.max(1, Math.ceil(totalCount / itemsPerPage))\n  // Clamp `currentPage` against the latest `totalPages` so a shrinking list\n  // (e.g. after a search filter) doesn't leave the table on an empty page.\n  const safeCurrentPage = Math.min(currentPage, totalPages)\n\n  const data = useMemo<TItem[]>(() => {\n    const start = (safeCurrentPage - 1) * itemsPerPage\n    return searchFilteredItems.slice(start, start + itemsPerPage)\n  }, [searchFilteredItems, safeCurrentPage, itemsPerPage])\n\n  const pagination = useMemo<PaginationControlProps>(\n    () => ({\n      currentPage: safeCurrentPage,\n      totalPages,\n      totalCount,\n      itemsPerPage,\n      handleFirstPage: () => {\n        setCurrentPage(1)\n      },\n      handleLastPage: () => {\n        setCurrentPage(totalPages)\n      },\n      handleNextPage: () => {\n        setCurrentPage(prev => Math.min(prev + 1, totalPages))\n      },\n      handlePreviousPage: () => {\n        setCurrentPage(prev => Math.max(prev - 1, 1))\n      },\n      handleItemsPerPageChange: (value: PaginationItemsPerPage) => {\n        if (value !== itemsPerPage) {\n          setItemsPerPage(value)\n          setCurrentPage(1)\n        }\n      },\n    }),\n    [safeCurrentPage, totalPages, totalCount, itemsPerPage],\n  )\n\n  const onSearchChange = useCallback((value: string) => {\n    setSearchValue(value)\n  }, [])\n\n  const onSearchClear = useCallback(() => {\n    setSearchValue('')\n  }, [])\n\n  const actions = useMemo(\n    () => ({ onSearchChange, onSearchClear }),\n    [onSearchChange, onSearchClear],\n  )\n\n  return {\n    data,\n    pagination,\n    searchValue,\n    actions,\n  }\n}\n"],"names":["DEFAULT_SEARCH_DEBOUNCE_MS","useClientPagination","allItems","options","searchPredicate","defaultItemsPerPage","searchDebounceMs","searchValue","setSearchValue","useState","debouncedSearchValue","setDebouncedSearchValue","deferredSearchValue","useDeferredValue","currentPage","setCurrentPage","itemsPerPage","setItemsPerPage","useEffect","prev","timeoutId","searchFilteredItems","useMemo","trimmed","item","totalCount","totalPages","safeCurrentPage","data","start","pagination","value","onSearchChange","useCallback","onSearchClear","actions"],"mappings":"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"}
+{"version":3,"file":"useClientPagination.js","sources":["../../../src/hooks/useClientPagination/useClientPagination.ts"],"sourcesContent":["import { useCallback, useDeferredValue, useEffect, useMemo, useState } from 'react'\nimport type {\n  PaginationControlProps,\n  PaginationItemsPerPage,\n} from '@/components/Common/PaginationControl/PaginationControlTypes'\n\nconst DEFAULT_SEARCH_DEBOUNCE_MS = 120\n\ninterface UseClientPaginationOptions<TItem> {\n  /**\n   * Optional substring/fuzzy/etc. predicate run against the debounced,\n   * deferred, trimmed search value. The hook owns search state and\n   * resets to page 1 once the debounce settles. A trimmed-empty value is\n   * treated as \"no search\" and the predicate is not called. Omit to skip\n   * search entirely.\n   */\n  searchPredicate?: (item: TItem, query: string) => boolean\n  /** Display rows-per-page. Default 5. */\n  defaultItemsPerPage?: PaginationItemsPerPage\n  /**\n   * Debounce window (ms) applied to the search value before it reaches\n   * the predicate and page reset. Keeps the controlled input responsive\n   * while preventing the filter from running on every keystroke for\n   * large lists or expensive predicates. Defaults to 120ms. Pass 0 to\n   * disable debouncing entirely (useful for tests).\n   */\n  searchDebounceMs?: number\n}\n\n/**\n * Return shape of {@link useClientPagination}: the current-page slice, a\n * `PaginationControlProps`-shaped object, the controlled search value, and\n * search actions.\n *\n * @typeParam TItem - The element type of the paginated list.\n * @internal\n */\nexport interface UseClientPaginationResult<TItem> {\n  /** Current-page slice. */\n  data: TItem[]\n  /** Drop-in `PaginationControlProps` for `useDataView` / `PaginationControl`. */\n  pagination: PaginationControlProps\n  /** Current search value (controlled). */\n  searchValue: string\n  actions: {\n    onSearchChange: (value: string) => void\n    onSearchClear: () => void\n  }\n}\n\n/**\n * Client-side pagination and optional search over an in-memory array.\n *\n * @remarks\n * Returns a `PaginationControlProps`-shaped pagination object that drops\n * straight into `useDataView` / `PaginationControl`. Use this when the\n * caller already has the full list of items and wants to paginate/search\n * it locally. Pair with `usePagination` if you want to page through an\n * API endpoint instead.\n *\n * Search state is owned by the hook, debounced, and resets the current\n * page to 1 once the debounce settles. The current page is clamped to the\n * latest total so a shrinking filtered list never lands on an empty page.\n *\n * @typeParam TItem - The element type of the paginated list.\n * @param allItems - The full in-memory list to paginate and optionally filter.\n * @param options - Search predicate, default rows-per-page, and debounce window.\n * @returns A {@link UseClientPaginationResult} with the current-page slice,\n *   pagination controls, the controlled search value, and search actions.\n * @internal\n */\nexport function useClientPagination<TItem>(\n  allItems: TItem[],\n  options: UseClientPaginationOptions<TItem> = {},\n): UseClientPaginationResult<TItem> {\n  const {\n    searchPredicate,\n    defaultItemsPerPage = 5,\n    searchDebounceMs = DEFAULT_SEARCH_DEBOUNCE_MS,\n  } = options\n\n  const [searchValue, setSearchValue] = useState('')\n  const [debouncedSearchValue, setDebouncedSearchValue] = useState('')\n  const deferredSearchValue = useDeferredValue(debouncedSearchValue)\n  const [currentPage, setCurrentPage] = useState(1)\n  const [itemsPerPage, setItemsPerPage] = useState<PaginationItemsPerPage>(defaultItemsPerPage)\n\n  useEffect(() => {\n    if (searchDebounceMs <= 0) {\n      setDebouncedSearchValue(prev => (prev === searchValue ? prev : searchValue))\n      setCurrentPage(prev => (prev === 1 ? prev : 1))\n      return\n    }\n    const timeoutId = setTimeout(() => {\n      setDebouncedSearchValue(prev => (prev === searchValue ? prev : searchValue))\n      setCurrentPage(prev => (prev === 1 ? prev : 1))\n    }, searchDebounceMs)\n    return () => {\n      clearTimeout(timeoutId)\n    }\n  }, [searchValue, searchDebounceMs])\n\n  const searchFilteredItems = useMemo<TItem[]>(() => {\n    if (!searchPredicate) return allItems\n    const trimmed = deferredSearchValue.trim()\n    if (!trimmed) return allItems\n    return allItems.filter(item => searchPredicate(item, trimmed))\n  }, [allItems, deferredSearchValue, searchPredicate])\n\n  const totalCount = searchFilteredItems.length\n  const totalPages = Math.max(1, Math.ceil(totalCount / itemsPerPage))\n  // Clamp `currentPage` against the latest `totalPages` so a shrinking list\n  // (e.g. after a search filter) doesn't leave the table on an empty page.\n  const safeCurrentPage = Math.min(currentPage, totalPages)\n\n  const data = useMemo<TItem[]>(() => {\n    const start = (safeCurrentPage - 1) * itemsPerPage\n    return searchFilteredItems.slice(start, start + itemsPerPage)\n  }, [searchFilteredItems, safeCurrentPage, itemsPerPage])\n\n  const pagination = useMemo<PaginationControlProps>(\n    () => ({\n      currentPage: safeCurrentPage,\n      totalPages,\n      totalCount,\n      itemsPerPage,\n      handleFirstPage: () => {\n        setCurrentPage(1)\n      },\n      handleLastPage: () => {\n        setCurrentPage(totalPages)\n      },\n      handleNextPage: () => {\n        setCurrentPage(prev => Math.min(prev + 1, totalPages))\n      },\n      handlePreviousPage: () => {\n        setCurrentPage(prev => Math.max(prev - 1, 1))\n      },\n      handleItemsPerPageChange: (value: PaginationItemsPerPage) => {\n        if (value !== itemsPerPage) {\n          setItemsPerPage(value)\n          setCurrentPage(1)\n        }\n      },\n    }),\n    [safeCurrentPage, totalPages, totalCount, itemsPerPage],\n  )\n\n  const onSearchChange = useCallback((value: string) => {\n    setSearchValue(value)\n  }, [])\n\n  const onSearchClear = useCallback(() => {\n    setSearchValue('')\n  }, [])\n\n  const actions = useMemo(\n    () => ({ onSearchChange, onSearchClear }),\n    [onSearchChange, onSearchClear],\n  )\n\n  return {\n    data,\n    pagination,\n    searchValue,\n    actions,\n  }\n}\n"],"names":["DEFAULT_SEARCH_DEBOUNCE_MS","useClientPagination","allItems","options","searchPredicate","defaultItemsPerPage","searchDebounceMs","searchValue","setSearchValue","useState","debouncedSearchValue","setDebouncedSearchValue","deferredSearchValue","useDeferredValue","currentPage","setCurrentPage","itemsPerPage","setItemsPerPage","useEffect","prev","timeoutId","searchFilteredItems","useMemo","trimmed","item","totalCount","totalPages","safeCurrentPage","data","start","pagination","value","onSearchChange","useCallback","onSearchClear","actions"],"mappings":"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"}