@shipengine/elements 0.34.0 → 0.35.0

package/index.js

@@ -3,9 +3,9 @@ import { useTranslation, Trans } from 'react-i18next';
 import { InlineNotification, NotificationType, Typography, Link, ButtonSize, Spinner, Icon, IconSize, Divider, Skeleton, SkeletonAnimation, SkeletonVariant, Grid, GridChild, Pagination, SkeletonBackgroundColor, RadioGroup, Radio, SpinnerSize, FormField, FieldMessageType, Checkbox, Input, SelectAutocomplete, Select as Select$1, OptionGroup, Option, Button, Switch as Switch$1, Textarea, ChipList, Chip, ButtonVariant, ButtonColor, Tag, TagColor, Stepper, Step, IconTooltip, Table, TableBody, TableBaseRow, TableBodyCell, TableHeader, TableHeaderCell, Popover, DropdownOptionList, DatePicker as DatePicker$1, BottomSheet } from '@packlink/giger';
 import alchemy, { SE, logger, useValidateAddresses, useListCarriers, useConnectCarrier, useListWarehouses, useUpdateWarehouse, useCreateWarehouse, useDeleteWarehouse, useGetWalletHistory, useGetAccountSettings, useUpdateAccountSettings, AlchemyContext, useAddFunds, useGetCarrierById, useUpdateAutoFunding, useGetAutoFundingConfiguration, Currency, useUpdateFundingSource, useListFundingSources, useCreateFundingSource, useRegisterCarrier, useUpdateSalesOrderShipment, useParseAddress, useListCustomPackageTypes, useCalculateRates, useGetShipmentRates, useListLabels, useCreateLabel, useListSalesOrderShipments, useCreateSalesOrderShipment, useListSalesOrders, useGetSalesOrder, useListOrderSources, useRefreshOrderSource, useCreateShipment, useGetShipment, useGetSalesOrderShipment, useGetLabel, useVoidLabel } from '@shipengine/alchemy';
 import axios from 'axios';
+import _$3, { get as get$1, isEqual } from 'lodash';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
-import _$3, { get as get$1, isEqual } from 'lodash';
 import { encode } from 'js-base64';
 import * as React from 'react';
 import { useMemo, createContext, useState, useContext, useReducer, useCallback, createElement as createElement$2, useRef, useEffect, forwardRef, memo, Fragment as Fragment$1 } from 'react';
@@ -1986,6 +1986,13 @@ var addToUnscopables = addToUnscopables$3;
 // https://tc39.es/ecma262/#sec-array.prototype-@@unscopables
 addToUnscopables('flatMap');
 
+/**
+ * @internal
+ *
+ * # Delivery Confirmation Options Hook
+ *
+ * @category Hooks
+ */
 const useConfirmationOptions = () => {
   const {
     t
@@ -2007,6 +2014,11 @@ const hasEuCustomsRules = true,
   isUnitedStatesTerritory$1 = true,
   isUnsupportedByUps$1 = true,
   supportsByoa = true;
+/**
+ * @internal
+ *
+ * # Address Utils - Country Type
+ */
 class Country {
   constructor(name, code, rules = {}) {
     var _a, _b, _c, _d, _e;
@@ -2019,6 +2031,11 @@ class Country {
     this.isUnsupportedByUps = (_e = rules.isUnsupportedByUps) !== null && _e !== void 0 ? _e : false;
   }
 }
+/**
+ * @internal
+ *
+ * # Address Utils - Array of Countries and their codes
+ */
 const countries = [new Country("Afghanistan", "AF"), new Country("Aland Islands", "AX"), new Country("Albania", "AL"), new Country("Algeria", "DZ"), new Country("American Samoa", "AS", {
   isUnitedStatesTerritory: isUnitedStatesTerritory$1
 }), new Country("Andorra", "AD"), new Country("Angola", "AO"), new Country("Anguilla", "AI"), new Country("Antarctica", "AQ"), new Country("Antigua Barbuda", "AG"), new Country("Argentina", "AR"), new Country("Armenia", "AM"), new Country("Aruba", "AW"), new Country("Australia", "AU", {
@@ -2147,11 +2164,31 @@ new Country("Puerto Rico", "PR", {
   hasProvinces,
   supportsByoa
 }), new Country("Uruguay", "UY"), new Country("Uzbekistan", "UZ"), new Country("Vanuatu", "VU"), new Country("Venezuela", "VE"), new Country("Vietnam", "VN"), new Country("Wallis and Futuna Islands", "WF"), new Country("Western Sahara", "EH"), new Country("Yemen", "YE"), new Country("Zambia", "ZM"), new Country("Zimbabwe", "ZW")];
+/**
+ * @internal
+ *
+ * # Address Utils - Map of Country Codes
+ */
 const countryCodes = countries.map(c => c.code);
+/**
+ * @internal
+ *
+ * # Address Utils - EU Country Codes
+ */
 const euCountryCodes = countries.filter(c => c.hasEuCustomsRules).map(c => c.code);
 // #endregion
 // #region [ rgba(0,0,0,0) ] Postal Codes
+/**
+ * @internal
+ *
+ * # Address Utils - Postal Code Regex
+ */
 const postalCodeRegex$3 = /(^\d{5}$)|(^\d{5}-\d{4}$)/;
+/**
+ * @internal
+ *
+ * # Address Utils - US State Type
+ */
 class UsState {
   constructor(name, code, rules = {}) {
     var _a, _b;
@@ -2161,6 +2198,11 @@ class UsState {
     this.isUnitedStatesTerritory = (_b = rules.isUnitedStatesTerritory) !== null && _b !== void 0 ? _b : false;
   }
 }
+/**
+ * @internal
+ *
+ * # Address Utils - Array US States and their codes
+ */
 const usStates = [new UsState("Alabama", "AL"), new UsState("Alaska", "AK"), new UsState("American Samoa", "AS", {
   isUnitedStatesTerritory: isUnitedStatesTerritory$1
 }), new UsState("Arizona", "AZ"), new UsState("Arkansas", "AR"), new UsState("Armed Forces Americas", "AA", {
@@ -2180,7 +2222,17 @@ const usStates = [new UsState("Alabama", "AL"), new UsState("Alaska", "AK"), new
 }), new UsState("U.S. Minor Outlying Islands", "UM", {
   isUnitedStatesTerritory: isUnitedStatesTerritory$1
 })];
+/**
+ * @internal
+ *
+ * # Address Utils - Map of US State Codes
+ */
 const usStateCodes = usStates.map(item => item.code);
+/**
+ * @internal
+ *
+ * # Address Utils - USA City Type
+ */
 class UsaCity {
   constructor(name, code, rules = {}) {
     var _a;
@@ -2189,6 +2241,11 @@ class UsaCity {
     this.isMilitary = (_a = rules.isMilitary) !== null && _a !== void 0 ? _a : false;
   }
 }
+/**
+ * @internal
+ *
+ * # Address Utils - US Cities
+ */
 const usCities = [new UsaCity("Army Post Office", "APO", {
   isMilitary
 }), new UsaCity("Diplomatic Post Office", "DPO", {
@@ -2198,11 +2255,36 @@ const usCities = [new UsaCity("Army Post Office", "APO", {
 })];
 // #endregion
 
-const useCountryCodeOptions = domestic => useMemo(() => countries.flatMap(v => domestic && v.code !== "US" && !v.isUnitedStatesTerritory ? [] : {
-  label: v.name,
-  value: v.code
-}), [domestic]);
+/**
+ * @internal
+ *
+ * # Country Code Options Hook
+ *
+ * @category Hooks
+ */
+const useCountryCodeOptions = domestic => {
+  const countryCodeOptions = useMemo(() => countries.flatMap(v => domestic && v.code !== "US" && !v.isUnitedStatesTerritory ? [] : {
+    label: v.name,
+    value: v.code
+  }), [domestic]);
+  const defaultCountryCodeOption = useMemo(() => {
+    const defaultLocale = new Intl.NumberFormat().resolvedOptions().locale;
+    const defaultCountryCode = defaultLocale.split("-")[1];
+    return countryCodeOptions.find(option => option.value === defaultCountryCode);
+  }, [countryCodeOptions]);
+  return {
+    countryCodeOptions,
+    defaultCountryCodeOption
+  };
+};
 
+/**
+ * @internal
+ *
+ * # Customs Contents Options Hook
+ *
+ * @category Hooks
+ */
 const useCustomsContentsOptions = () => {
   const {
     t
@@ -2213,6 +2295,13 @@ const useCustomsContentsOptions = () => {
   })), [t]);
 };
 
+/**
+ * @internal
+ *
+ * # Customs Non-Delivery Options Hooks
+ *
+ * @category Hooks
+ */
 const useCustomsNonDeliveryOptions = () => {
   const {
     t
@@ -2302,6 +2391,10 @@ $$f({ target: 'Array', proto: true, forced: !STRICT_METHOD$1 || CHROME_BUG }, {
 });
 
 /**
+ * @internal
+ *
+ * # Create Dictionary Utility Function
+ *
  * @category Utilities
  */
 const createDictionary = (items, getEntry) => {
@@ -2310,6 +2403,10 @@ const createDictionary = (items, getEntry) => {
 };
 
 /**
+ * @internal
+ *
+ * # Date Utils - getDaysInMonth
+ *
  * @category Utilities
  */
 const formatDate = (date, locale = "en-US") => new Date(date).toLocaleDateString(locale, {
@@ -2318,6 +2415,10 @@ const formatDate = (date, locale = "en-US") => new Date(date).toLocaleDateString
   year: "numeric"
 });
 /**
+ * @internal
+ *
+ * # Date Utils - formatDateDDMMYY
+ *
  * @category Utilities
  */
 const formatDateDDMMYY = (date, locale = "en-US") => new Date(date).toLocaleDateString(locale, {
@@ -2326,6 +2427,10 @@ const formatDateDDMMYY = (date, locale = "en-US") => new Date(date).toLocaleDate
   year: "2-digit"
 });
 /**
+ * @internal
+ *
+ * # Date Utils - getDaysInMonth
+ *
  * @category Utilities
  */
 const daysAfter = (days, date = new Date()) => {
@@ -2334,14 +2439,26 @@ const daysAfter = (days, date = new Date()) => {
   return date;
 };
 /**
+ * @internal
+ *
+ * # Date Utils - getDaysInMonth
+ *
  * @category Utilities
  */
 const nextDayCutoff = (cutoff, date = new Date()) => date.getHours() >= cutoff ? daysAfter(1, new Date(date)) : new Date(date);
 /**
+ * @internal
+ *
+ * # Date Utils - getDaysInMonth
+ *
  * @category Utilities
  */
 const mostRecent = (...dates) => new Date(Math.max(...dates.map(Number)));
 /**
+ * @internal
+ *
+ * # Date Utils - getDaysInMonth
+ *
  * @category Utilities
  */
 const omitTime = shipDate => {
@@ -2349,6 +2466,10 @@ const omitTime = shipDate => {
   return new Date(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
 };
 /**
+ * @internal
+ *
+ * # Date Utils - getExpirationYears
+ *
  * @category Utilities
  */
 const getExpirationYears = yearsValid => {
@@ -2359,17 +2480,35 @@ const getExpirationYears = yearsValid => {
   }
   return years;
 };
+/**
+ * @internal
+ *
+ * # Date Utilities - sortByCreationDate
+ *
+ * @category Utilities
+ */
 const sortByCreationDate = (a, b, order = "desc") => {
   const [x, y] = order === "asc" ? [a, b] : [b, a];
   return new Date(x.createdAt).getTime() - new Date(y.createdAt).getTime();
 };
 /**
+ * @internal
+ *
+ * # Date Utilities - isNowOrInTheFuture
+ *
  * @category Utilities
  */
 const isNowOrInTheFuture = shipDate => {
   if (shipDate) return new Date(shipDate) >= new Date();
   return false;
 };
+/**
+ * @internal
+ *
+ * # Date Utilities - getRelativeDates
+ *
+ * @category Utilities
+ */
 const getRelativeDates = from => {
   const origin = from !== null && from !== void 0 ? from : new Date();
   return {
@@ -2383,6 +2522,12 @@ const getRelativeDates = from => {
 };
 
 /**
+ * @internal
+ *
+ * # Create Coded Errors Utlity Function
+ *
+ * - This function extracts errors from our `Axios Responses`.
+ *
  * @category Utilities
  */
 const createCodedErrors = err => {
@@ -2398,19 +2543,229 @@ const createCodedErrors = err => {
   }];
 };
 /**
- * Joins a list of error-like object's messages and throws them as a single error.
+ * @internal
+ *
+ * - Joins a list of error-like object's messages and throws them as a single error.
+ *
+ * @category Utilities
  */
 function throwJoinedMessages(errors) {
   throw new Error(errors.map(e => e.message).join(", "));
 }
 /**
- * If any CodedErrors exist, throw them all as a single error, otherwise assert errors is null.
+ * @internal
+ *
+ * - If any CodedErrors exist, throw them all as a single error, otherwise assert errors is null.
+ *
+ * @category Utilities
  */
 function throwAny(errors) {
   if (errors) throwJoinedMessages(errors);
 }
 
 /**
+ * @namespace featureFlags
+ *
+ * - The `featureFlags` namespace contains all the feature flags available throughout the
+ * application. All features are scoped by name to the component they are intended for.
+ *
+ * @example
+ * ```tsx
+ * export const featureFlags = {
+ *   ConfigureSalesOrderShipment: {
+ *     compatibleCountryCodes: ["AU", "CA", "FR", "DE", "GB", "IL", "IT", "NO", "ES", "SE", "US"],
+ *     rateForm: {
+ *       enableFunding: false,
+ *       enableGlobalPostFiltering: false,
+ *       labelLayout: false,
+ *       nicknameRate: true,
+ *       saveRate: true,
+ *     },
+ *     shipmentForm: {
+ *       browseRates: true,
+ *       includeShipsuranceInsurance: true,
+ *       includeThirdPartyInsurance: true,
+ *       selectService: true,
+ *       shippingPresets: false,
+ *     },
+ *   },
+ *   Global: {
+ *     carriers: {
+ *       enabledCarriers: ["stamps_com", "ups", "dhl_express_walleted"],
+ *     },
+ *     presentation: {
+ *       poweredByShipEngine: false,
+ *     },
+ *   },
+ *   ViewShipment: {
+ *     shipment: {
+ *       schedulePickup: true,
+ *     },
+ *   },
+ * } as const;
+ * ```
+ */
+const featureFlags = {
+  /**
+   * `ConfigureSalesOrderShipment` all scoped feature flags for the shipment configuration
+   * section of the `<PurchaseLabel />` element.
+   */
+  ConfigureSalesOrderShipment: {
+    /**
+     * `compatibleCountryCodes` is a list of all supported `countries` available in ShipEngine
+     * Elements.
+     */
+    compatibleCountryCodes: ["AU", "CA", "FR", "DE", "GB", "IL", "IT", "NO", "ES", "SE", "US"],
+    /**
+     *  `rateForm` all scoped feature flags for the `rate form` section of the `<PurchaseLabel />`
+     *  element.
+     */
+    rateForm: {
+      /**
+       * `enableFunding` enables the `funding` section of the rate form.
+       */
+      enableFunding: false,
+      /**
+       * `enableGlobalPostFiltering` enables the `global post filtering` on all rates fetched
+       * in the rates form.
+       */
+      enableGlobalPostFiltering: false,
+      /**
+       * `labelLayout` enables the `label layout` section of the `<PurchaseLabel /> element.
+       */
+      labelLayout: false,
+      /**
+       * `nicknameRate` enables showing the `carrier nickname` when rates are fetched.
+       */
+      nicknameRate: true,
+      requireDhlTermsAcknowledgement: false,
+      /**
+       * `saveRate` enables the `save rate` button in the rate form. This allows users to save a
+       * `rateId` for a shipment to be purchased later.
+       */
+      saveRate: true
+    },
+    /**
+     * `shipmentForm` all scoped feature flags for the `shipment form` section of the
+     * `<PurchaseLabel />` element.
+     */
+    shipmentForm: {
+      /**
+       * `browseRates` enables the `browse rates` button in the shipment form. This allows users
+       * to browse rates for a shipment with varying shipment configurations. This is useful for
+       * rate shopping.
+       */
+      browseRates: true,
+      /**
+       * `includeShipsuranceInsurance` enables the `shipsurance insurance` feature, allowing users
+       * to select Shipsurance when insuring their shipment.
+       */
+      includeShipsuranceInsurance: true,
+      /**
+       * `includeThirdPartyInsurance` enables the `third party insurance` feature, allowing users
+       * to opt for third party insurance when insuring their shipment.
+       */
+      includeThirdPartyInsurance: true,
+      /**
+       * `selectService` enables the `select service` feature, allowing users to select a service
+       * when rate shopping across multiple carrier providers.
+       */
+      selectService: true,
+      /**
+       * `shippingPresets` enables the `shipping presets` feature, allowing users to pass in a set
+       * of shipping presets they wish to use within the shipment form of the `<PurchaseLabel />`
+       * element.
+       */
+      shippingPresets: false
+    }
+  },
+  /**
+   * `Global` all feature flags that are intended for use anywhere in ShipEngine Elements.
+   */
+  Global: {
+    /**
+     * All global `carrier` related feature flags.
+     */
+    carriers: {
+      /**
+       * `enabledCarriers` is a list of all `carriers` that are enabled for use in ShipEngine
+       * Elements.
+       */
+      enabledCarriers: ["stamps_com", "ups", "dhl_express_walleted"]
+    },
+    /**
+     * All global `presentation` related feature flags.
+     */
+    presentation: {
+      /**
+       * `poweredByShipEngine` enables the `powered by ShipEngine` logo in the footer various
+       * elements.
+       */
+      poweredByShipEngine: false
+    }
+  },
+  /**
+   * `ViewShipment` all scoped feature flags for the `<ViewShipment />` element.
+   */
+  ViewShipment: {
+    /**
+     * `shipment` all shipment related features available in the `<ViewShipment />` element.
+     */
+    shipment: {
+      /**
+       * `schedulePickup` enables the `schedule pickup` button in the `<ViewShipment />` element,
+       * allowing users to schedule pick-ups for their shipments.
+       */
+      schedulePickup: true
+    }
+  }
+};
+/**
+ * @internal
+ *
+ * # Feature Flags - featureFlagComponentNameLookup
+ */
+const featureFlagComponentNameLookup = componentName => {
+  var _a;
+  const lookup = {
+    PurchaseLabel: "ConfigureSalesOrderShipment"
+  };
+  return (_a = lookup[componentName]) !== null && _a !== void 0 ? _a : "";
+};
+/**
+ * @internal
+ *
+ * # Feature Flags - getFeatures
+ */
+const getFeatures = (...element) => {
+  return element.map(feat => {
+    var _a;
+    return (_a = get$1(featureFlags, feat)) !== null && _a !== void 0 ? _a : {};
+  }).reduce((acc, feat) => Object.assign(acc, feat), {});
+};
+/**
+ * # Feature Flags - useFeatures
+ *
+ * - The `useFeatures` hook is used to retrieve the feature flags for a given component.
+ *
+ * @example
+ * ```tsx
+ * const features = useFeatures("Global");
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link featureFlags | All available `Feature Flags`}
+ */
+const useFeatures = (...element) => {
+  return getFeatures(...element);
+};
+
+/**
+ * @internal
+ *
+ * # Form Logger
+ *
  * @description
  * This will log the values that are submitted to the validation resolver
  * (only REGISTERED form fields) and the results of that validation.
@@ -3041,6 +3396,11 @@ fixRegExpWellKnownSymbolLogic$1('replace', function (_, nativeReplace, maybeCall
   ];
 }, !REPLACE_SUPPORTS_NAMED_GROUPS || !REPLACE_KEEPS_$0 || REGEXP_REPLACE_SUBSTITUTES_UNDEFINED_CAPTURE);
 
+/**
+ * @internal
+ *
+ * # Money Utils - currency Symbol
+ */
 const currencySymbol = {
   aud: "$",
   cad: "$",
@@ -3049,6 +3409,11 @@ const currencySymbol = {
   nzd: "$",
   usd: "$"
 };
+/**
+ * @internal
+ *
+ * # Money Utils - formatMoney
+ */
 const formatMoney = (value, locale = "en-US") => {
   const currency = Intl.NumberFormat(locale, {
     currency: value.currency,
@@ -3056,40 +3421,86 @@ const formatMoney = (value, locale = "en-US") => {
   });
   return currency.format(value.amount);
 };
+/**
+ * @internal
+ *
+ * # Money Utils - calculateTotal
+ */
 const calculateTotal = (...values) => {
   return values.reduce((total, value) => {
     var _a;
     return value ? total + ((_a = value.amount) !== null && _a !== void 0 ? _a : 0) : total;
   }, 0);
 };
+/**
+ * @internal
+ *
+ * # Money Utils - formatCreditCardNumber
+ */
 const formatCreditCardNumber = cc => [cc.substring(0, 4), cc.substring(4, 8), cc.substring(8, 12), cc.substring(12)].join(" ").trim();
+/**
+ * @internal
+ *
+ * # Money Utils - formatExpiration
+ */
 const formatExpiration = exp => {
   const digits = exp.replace(/\//g, "");
   if (digits.length > 2) return [digits.substring(0, 2), digits.substring(2, 6)].join("/").trim();
   return digits;
 };
 
+/**
+ * @internal
+ *
+ * # String Predicate Utilities
+ *
+ * @category Utilities
+ */
 const isString = x => typeof x === "string";
 
-const getRateRequiresAcknowledgement = (serviceCode, packageType) => {
+/**
+ * @internal
+ *
+ * # Rates Utilities - getRateRequiresAcknowledgement
+ *
+ * @category Utilities
+ */
+const getRateRequiresAcknowledgement = (serviceCode, packageType, requireDhlTermsAcknowledgement) => {
   switch (serviceCode) {
     case "usps_media_mail":
       return true;
     case "usps_first_class_mail":
-      if (packageType === "large_envelope_or_flat") {
-        return true;
-      }
-      return false;
+      return packageType === "large_envelope_or_flat";
+    case "dhl_express_worldwide":
+      return requireDhlTermsAcknowledgement;
     default:
       return false;
   }
 };
+/**
+ * @internal
+ *
+ * # Rates Utilities - getTotalRateAmount
+ *
+ * @category Utilities
+ */
 const getTotalRateAmount = (rateCosts = {}) => calculateTotal(...Object.values(rateCosts));
+/**
+ * @internal
+ *
+ * # Rates Utilities - overrideCarrierCodes
+ *
+ * @category Utilities
+ */
 const overrideCarrierCodes$1 = (carrier, overrides) => {
   return overrides[carrier] || carrier;
 };
 
 /**
+ * @internal
+ *
+ * # Address Utilities - isDomesticAddress
+ *
  * @category Utilities
  */
 const isDomesticAddress = address => {
@@ -3097,6 +3508,10 @@ const isDomesticAddress = address => {
   return address.countryCode === "US" || ((_a = countries.find(c => c.code === address.countryCode)) === null || _a === void 0 ? void 0 : _a.isUnitedStatesTerritory);
 };
 /**
+ * @internal
+ *
+ * # Address Utilities - isMilitaryAddress
+ *
  * @category Utilities
  */
 const isMilitaryAddress = address => {
@@ -3104,6 +3519,10 @@ const isMilitaryAddress = address => {
   return !!(((_a = usStates.find(s => s.code === address.stateProvince)) === null || _a === void 0 ? void 0 : _a.isMilitary) || ((_b = usCities.find(c => c.code === address.cityLocality)) === null || _b === void 0 ? void 0 : _b.isMilitary));
 };
 /**
+ * @internal
+ *
+ * # Address Utilities - isUnitedStatesTerritory
+ *
  * @category Utilities
  */
 const isUnitedStatesTerritory = address => {
@@ -3111,6 +3530,10 @@ const isUnitedStatesTerritory = address => {
   return !!(((_a = countries.find(c => c.code === address.countryCode)) === null || _a === void 0 ? void 0 : _a.isUnitedStatesTerritory) || ((_b = usStates.find(s => s.code === address.stateProvince)) === null || _b === void 0 ? void 0 : _b.isUnitedStatesTerritory));
 };
 /**
+ * @internal
+ *
+ * # Address Utilities - isUnsupportedByUps
+ *
  * @category Utilities
  */
 const isUnsupportedByUps = address => {
@@ -3121,39 +3544,90 @@ const PO_BOX_REGEX =
 // eslint-disable-next-line no-useless-escape
 /^(((p[\s\.\'\,]?[o\s][\.\'\,]?)\s?)|(post\s?office\s?))((box|bin|bo|b\.?)?\s?(num|number|#)?\s?\d+)/i;
 /**
+ * @internal
+ *
+ * # Address Utilities - isPoBox
+ *
  * @category Utilities
  */
 const isPoBox = addressLine => PO_BOX_REGEX.test(addressLine);
 /**
+ * @internal
+ *
+ * # Address Utilities - isPoBoxAddress
+ *
  * @category Utilities
  */
 const isPoBoxAddress = address => !!(isPoBox(address.addressLine1) || address.addressLine2 && isPoBox(address.addressLine2));
+/**
+ * @internal
+ *
+ * # Address Utilities - isEmptyAddress
+ *
+ * @category Utilities
+ */
 const isEmptyAddress = address => {
   return !address || Object.entries(address).every(([key, value]) => key === "countryCode" || [null, "", "unknown"].includes(value));
 };
 
 const USPS_CARRIER_CODES = ["usps", "stamps_com"];
+/**
+ * @internal
+ *
+ * # Carrier Utilities - isUspsCarrier
+ *
+ * @category Utilities
+ */
 const isUspsCarrier = carrierCode => USPS_CARRIER_CODES.includes(carrierCode);
+/**
+ * @internal
+ *
+ * # Carrier Utilities - isUpsCarrier
+ *
+ * @category Utilities
+ */
 const isUpsCarrier = carrierCode => carrierCode === "ups";
+/**
+ * @internal
+ *
+ * # Carrier Utilities - isFedexCarrier
+ *
+ * @category Utilities
+ */
 const getCarrierIdByCarrierCode = (carriers = [], carrierCode) => {
   const carrier = carriers.find(c => c.carrierCode === carrierCode);
   return carrier === null || carrier === void 0 ? void 0 : carrier.carrierId;
 };
 
-function convertDimensions(dimensions, {
-  allowAllZeroes
-} = {}) {
-  if ("unit" in dimensions) {
-    const dims = __rest(dimensions, ["unit"]);
-    const hasAllZeroes = Object.values(dims).every(d => d === 0);
-    return hasAllZeroes && !allowAllZeroes ? undefined : dims;
-  }
+/**
+ * @internal
+ *
+ * # Convert Dimensions Utility Function
+ *
+ * @category Utilities
+ */
+const formatDimensions = dimensions => `${dimensions.length} x ${dimensions.width} x ${dimensions.height} `;
+function convertDimensions(dimensions, {
+  allowAllZeroes
+} = {}) {
+  const {
+    length,
+    width,
+    height,
+    unit
+  } = dimensions;
+  const hasAllZeroes = [length, width, height].every(v => v === 0);
+  if (hasAllZeroes && !allowAllZeroes) return undefined;
   return Object.assign(Object.assign({}, dimensions), {
-    unit: "inch"
+    unit: unit !== null && unit !== void 0 ? unit : "inch"
   });
 }
 
 /**
+ * @internal
+ *
+ * # Sales Order Utilities - getCustomsFromSalesOrder
+ *
  * @category Utilities
  */
 const getCustomsFromSalesOrder = (salesOrder, warehouse) => ({
@@ -3167,6 +3641,10 @@ const getCustomsFromSalesOrder = (salesOrder, warehouse) => ({
   nonDelivery: "return_to_sender"
 });
 /**
+ * @internal
+ *
+ * # Sales Order Utilities - getIsCustomsRequiredForSalesOrder
+ *
  * @category Utilities
  */
 const getIsCustomsRequiredForSalesOrder = ({
@@ -3175,12 +3653,23 @@ const getIsCustomsRequiredForSalesOrder = ({
   originAddress
 }) => originAddress && isMilitaryAddress(originAddress) || shipTo && (isMilitaryAddress(shipTo) || isUnitedStatesTerritory(shipTo)) || (originAddress === null || originAddress === void 0 ? void 0 : originAddress.countryCode) !== (shipTo === null || shipTo === void 0 ? void 0 : shipTo.countryCode);
 /**
+ * @internal
+ *
+ * # Sales Order Utilities - getRequestedServices
+ *
  * @category Utilities
  */
 const getRequestedServices = salesOrder => {
   var _a;
   return Array.from(new Set((_a = salesOrder === null || salesOrder === void 0 ? void 0 : salesOrder.salesOrderItems) === null || _a === void 0 ? void 0 : _a.filter(item => !!item.requestedShippingOptions.shippingService).map(item => item.requestedShippingOptions.shippingService)));
 };
+/**
+ * @internal
+ *
+ * # Sales Order Utilities - getSalesOrderItemsFromSalesOrderOrShipment
+ *
+ * @category Utilities
+ */
 const getSalesOrderItemsFromSalesOrderOrShipment = ({
   salesOrder,
   shipment
@@ -3404,6 +3893,10 @@ $$c({ target: 'Array', proto: true, forced: FORCED$3 }, {
 });
 
 /**
+ * @internal
+ *
+ * # Shipment Utilities - getIsInternationalShipment
+ *
  * @category Utilities
  */
 const getIsInternationalShipment = ({
@@ -3411,6 +3904,10 @@ const getIsInternationalShipment = ({
   shipTo
 }) => (shipFrom === null || shipFrom === void 0 ? void 0 : shipFrom.countryCode) !== (shipTo === null || shipTo === void 0 ? void 0 : shipTo.countryCode);
 /**
+ * @internal
+ *
+ * # Shipment Utilities - getIsCustomsRequiredForShipment
+ *
  * @category Utilities
  */
 const getIsCustomsRequiredForShipment = ({
@@ -3418,32 +3915,292 @@ const getIsCustomsRequiredForShipment = ({
   shipTo
 }) => shipFrom && isMilitaryAddress(shipFrom) || shipTo && (isMilitaryAddress(shipTo) || isUnitedStatesTerritory(shipTo)) || (shipFrom === null || shipFrom === void 0 ? void 0 : shipFrom.countryCode) !== (shipTo === null || shipTo === void 0 ? void 0 : shipTo.countryCode);
 /**
+ * @internal
+ *
+ * # Shipment Utilities - getPendingShipment
+ *
  * @category Utilities
  */
 const getPendingShipment = shipments => shipments === null || shipments === void 0 ? void 0 : shipments.filter(s => s.shipmentStatus === "pending").sort(sortByCreationDate)[0];
 
-function convertWeight(weight) {
-  if ("value" in weight) {
-    const valueAsLbs = weight.value / 16;
-    return {
-      fractional: (valueAsLbs - Math.floor(valueAsLbs)) * 16,
-      whole: Math.floor(valueAsLbs)
-    };
+var uncurryThis$6 = functionUncurryThis;
+
+// `thisNumberValue` abstract operation
+// https://tc39.es/ecma262/#sec-thisnumbervalue
+var thisNumberValue$1 = uncurryThis$6(1.0.valueOf);
+
+var toIntegerOrInfinity$1 = toIntegerOrInfinity$6;
+var toString$5 = toString$c;
+var requireObjectCoercible$2 = requireObjectCoercible$9;
+
+var $RangeError$1 = RangeError;
+
+// `String.prototype.repeat` method implementation
+// https://tc39.es/ecma262/#sec-string.prototype.repeat
+var stringRepeat = function repeat(count) {
+  var str = toString$5(requireObjectCoercible$2(this));
+  var result = '';
+  var n = toIntegerOrInfinity$1(count);
+  if (n < 0 || n == Infinity) throw $RangeError$1('Wrong number of repetitions');
+  for (;n > 0; (n >>>= 1) && (str += str)) if (n & 1) result += str;
+  return result;
+};
+
+var $$b = _export;
+var uncurryThis$5 = functionUncurryThis;
+var toIntegerOrInfinity = toIntegerOrInfinity$6;
+var thisNumberValue = thisNumberValue$1;
+var $repeat = stringRepeat;
+var fails$4 = fails$q;
+
+var $RangeError = RangeError;
+var $String = String;
+var floor = Math.floor;
+var repeat = uncurryThis$5($repeat);
+var stringSlice$2 = uncurryThis$5(''.slice);
+var nativeToFixed = uncurryThis$5(1.0.toFixed);
+
+var pow = function (x, n, acc) {
+  return n === 0 ? acc : n % 2 === 1 ? pow(x, n - 1, acc * x) : pow(x * x, n / 2, acc);
+};
+
+var log = function (x) {
+  var n = 0;
+  var x2 = x;
+  while (x2 >= 4096) {
+    n += 12;
+    x2 /= 4096;
   }
-  return {
-    unit: "ounce",
-    value: (weight.whole || 0) * 16 + (weight.fractional || 0)
-  };
+  while (x2 >= 2) {
+    n += 1;
+    x2 /= 2;
+  } return n;
+};
+
+var multiply = function (data, n, c) {
+  var index = -1;
+  var c2 = c;
+  while (++index < 6) {
+    c2 += n * data[index];
+    data[index] = c2 % 1e7;
+    c2 = floor(c2 / 1e7);
+  }
+};
+
+var divide = function (data, n) {
+  var index = 6;
+  var c = 0;
+  while (--index >= 0) {
+    c += data[index];
+    data[index] = floor(c / n);
+    c = (c % n) * 1e7;
+  }
+};
+
+var dataToString = function (data) {
+  var index = 6;
+  var s = '';
+  while (--index >= 0) {
+    if (s !== '' || index === 0 || data[index] !== 0) {
+      var t = $String(data[index]);
+      s = s === '' ? t : s + repeat('0', 7 - t.length) + t;
+    }
+  } return s;
+};
+
+var FORCED$2 = fails$4(function () {
+  return nativeToFixed(0.00008, 3) !== '0.000' ||
+    nativeToFixed(0.9, 0) !== '1' ||
+    nativeToFixed(1.255, 2) !== '1.25' ||
+    nativeToFixed(1000000000000000128.0, 0) !== '1000000000000000128';
+}) || !fails$4(function () {
+  // V8 ~ Android 4.3-
+  nativeToFixed({});
+});
+
+// `Number.prototype.toFixed` method
+// https://tc39.es/ecma262/#sec-number.prototype.tofixed
+$$b({ target: 'Number', proto: true, forced: FORCED$2 }, {
+  toFixed: function toFixed(fractionDigits) {
+    var number = thisNumberValue(this);
+    var fractDigits = toIntegerOrInfinity(fractionDigits);
+    var data = [0, 0, 0, 0, 0, 0];
+    var sign = '';
+    var result = '0';
+    var e, z, j, k;
+
+    // TODO: ES2018 increased the maximum number of fraction digits to 100, need to improve the implementation
+    if (fractDigits < 0 || fractDigits > 20) throw $RangeError('Incorrect fraction digits');
+    // eslint-disable-next-line no-self-compare -- NaN check
+    if (number != number) return 'NaN';
+    if (number <= -1e21 || number >= 1e21) return $String(number);
+    if (number < 0) {
+      sign = '-';
+      number = -number;
+    }
+    if (number > 1e-21) {
+      e = log(number * pow(2, 69, 1)) - 69;
+      z = e < 0 ? number * pow(2, -e, 1) : number / pow(2, e, 1);
+      z *= 0x10000000000000;
+      e = 52 - e;
+      if (e > 0) {
+        multiply(data, 0, z);
+        j = fractDigits;
+        while (j >= 7) {
+          multiply(data, 1e7, 0);
+          j -= 7;
+        }
+        multiply(data, pow(10, j, 1), 0);
+        j = e - 1;
+        while (j >= 23) {
+          divide(data, 1 << 23);
+          j -= 23;
+        }
+        divide(data, 1 << j);
+        multiply(data, 1, 1);
+        divide(data, 2);
+        result = dataToString(data);
+      } else {
+        multiply(data, 0, z);
+        multiply(data, 1 << -e, 0);
+        result = dataToString(data) + repeat('0', fractDigits);
+      }
+    }
+    if (fractDigits > 0) {
+      k = result.length;
+      result = sign + (k <= fractDigits
+        ? '0.' + repeat('0', fractDigits - k) + result
+        : stringSlice$2(result, 0, k - fractDigits) + '.' + stringSlice$2(result, k - fractDigits));
+    } else {
+      result = sign + result;
+    } return result;
+  }
+});
+
+/**
+ * @internal
+ *
+ * # Weight Utilities - isMetricWeightUnit
+ *
+ * - This utility function checks if the weight unit is `metric` and returns a `boolean`
+ * indicating if it is metric or not.
+ *
+ * @param unit The weight unit to check (optional).
+ *
+ * @returns boolean Indicating if the weight unit is `metric`.
+ *
+ * @category Utilities
+ */
+const isMetricWeightUnit = unit => !!unit && ["gram", "kilogram"].includes(unit);
+/**
+ * @internal
+ *
+ * # Weight Utilities - isDecimalWeight
+ *
+ * - This utility function checks if the weight is a `decimal` weight and returns a `boolean`
+ * indicating if it is decimal or not.
+ *
+ * @param weight The weight to `check for a decimal` (optional).
+ *
+ * @returns boolean Indicating if the weight is a decimal weight.
+ *
+ * @category Utilities
+ */
+const isDecimalWeight = weight => "value" in weight;
+/**
+ * @internal
+ *
+ * # Weight Utilities - convertPoundsAndOuncesToOunces
+ *
+ * - This utility function converts `pounds and ounces` to a `total of ounces`.
+ *
+ * @param weight The `pound + ounce` weight to convert to ounces.
+ *
+ * @returns number The total weight in `ounces`.
+ *
+ * @category Utilities
+ */
+const convertPoundsAndOuncesToOunces = weight => {
+  var _a, _b;
+  const pounds = (_a = weight.whole) !== null && _a !== void 0 ? _a : 0;
+  const ounces = (_b = weight.fractional) !== null && _b !== void 0 ? _b : 0;
+  return pounds * 16 + ounces;
+};
+/**
+ * @internal
+ *
+ * # Weight Utilities - convertFractionalWeightToDecimalWeight
+ *
+ * - This utility function converts a `fractional weight` to a `decimal weight`.
+ *
+ * @param weight The fractional weight to convert to a decimal weight.
+ * @param unit The target weight unit to convert to (optional).
+ *
+ * @returns WeightWithUnit The decimal weight with its unit.
+ *
+ * @category Utilities
+ */
+const convertFractionalWeightToDecimalWeight = (weight, unit) => isMetricWeightUnit(unit) ? {
+  unit,
+  value: weight.whole
+} : {
+  unit: "ounce",
+  value: convertPoundsAndOuncesToOunces(weight)
+};
+/**
+ * @internal
+ *
+ * # Weight Utilities - convertDecimalWeightToFractionalWeight
+ *
+ * - This utility function converts a `decimal weight` to a `fractional weight`.
+ *
+ * @param weight The decimal weight to convert to a fractional weight.
+ *
+ * @returns FractionalWeight The converted fractional weight.
+ *
+ * @category Utilities
+ */
+const convertDecimalWeightToFractionalWeight = weight => isMetricWeightUnit(weight.unit) ? {
+  fractional: 0,
+  whole: weight.value
+} : {
+  fractional: weight.value % 16,
+  whole: Math.floor(weight.value / 16)
+};
+/**
+ * @internal
+ *
+ * # Weight Utilities - convertWeight/2
+ */
+function convertWeight(weight, unit) {
+  return isDecimalWeight(weight) ? convertDecimalWeightToFractionalWeight(weight) : convertFractionalWeightToDecimalWeight(weight, unit);
 }
 /**
+ * @internal
+ *
+ * # Weight Utilities - formatFractionalWeight
+ *
+ * - This utility function formats a `fractional weight` for ease of use.
+ *
+ * @param weight The fractional weight to be formatted.
+ *
+ * @return FractionalWeight The formatted fractional weight.
+ *
  * @category Utilities
  */
-function formatFractionalWeight(weight) {
+function formatFractionalWeight(weight, unit) {
   if (!weight) return {
     fractional: 0,
     whole: 0
   };
-  const valueAsOz = (weight.whole || 0) * 16 + (weight.fractional || 0);
+  //allow up to 5 decimal places for metric weights
+  if (isMetricWeightUnit(unit) && weight.whole) {
+    return {
+      fractional: 0,
+      whole: Number(weight.whole.toFixed(5)) || 0
+    };
+  }
+  const valueAsOz = convertPoundsAndOuncesToOunces(weight);
   const valueAsLbs = valueAsOz / 16;
   return {
     fractional: Math.round((valueAsLbs - Math.floor(valueAsLbs)) * 16 * 100) / 100,
@@ -3452,15 +4209,28 @@ function formatFractionalWeight(weight) {
 }
 
 /**
+ * @internal
+ *
+ * # Package Utilities - isFlatRatePackageCode
+ *
  * @category Utilities
  */
 const isFlatRatePackageCode = packageCode => {
   return packageCode ? packageCode.includes("flat_rate") : false;
 };
 
+/**
+ * @internal
+ *
+ * # Capitalize First Letter Utility Function
+ *
+ * - This is a utility function that `capitalizes` the first letter of a given string.
+ */
 const capitalizeFirstLetter = str => str.slice(0, 1).toUpperCase() + str.slice(1);
 
 /**
+ * @internal
+ *
  * Creates a Record of Emotion styles; eliminating the need to explicitly type styles
  * while remaining fully typesafe w/ autocomplete.
  *
@@ -3480,6 +4250,8 @@ const capitalizeFirstLetter = str => str.slice(0, 1).toUpperCase() + str.slice(1
  *   }),
  * });
  * ```
+ *
+ * @category Utilities
  */
 const createStyles = styles => styles;
 
@@ -3490,6 +4262,10 @@ const buildError = (translationKey, error) => {
   }, meta));
 };
 /**
+ * @internal
+ *
+ * # Error Map
+ *
  * @category Utilities
  */
 const errorMap = (issue, ctx) => {
@@ -3533,6 +4309,10 @@ const errorMap = (issue, ctx) => {
   };
 };
 /**
+ * @internal
+ *
+ * # Validation Resolver
+ *
  * @category Utilities
  */
 const validationResolver = schema => (values, context, resolverOptions) => __awaiter(void 0, void 0, void 0, function* () {
@@ -3543,57 +4323,14 @@ const validationResolver = schema => (values, context, resolverOptions) => __awa
   return validationResult;
 });
 
-const featureFlags = {
-  ConfigureSalesOrderShipment: {
-    compatibleCountryCodes: ["AU", "CA", "FR", "DE", "GB", "IL", "IT", "NO", "ES", "SE", "US"],
-    rateForm: {
-      enableFunding: false,
-      enableGlobalPostFiltering: false,
-      labelLayout: false,
-      nicknameRate: true,
-      saveRate: true
-    },
-    shipmentForm: {
-      browseRates: true,
-      includeShipsuranceInsurance: true,
-      includeThirdPartyInsurance: true,
-      selectService: true,
-      shippingPresets: false
-    }
-  },
-  Global: {
-    carriers: {
-      enabledCarriers: ["stamps_com", "ups", "dhl_express_walleted"]
-    },
-    presentation: {
-      poweredByShipEngine: false
-    }
-  },
-  ViewShipment: {
-    shipment: {
-      schedulePickup: true
-    }
-  }
-};
-const featureFlagComponentNameLookup = componentName => {
-  var _a;
-  const lookup = {
-    PurchaseLabel: "ConfigureSalesOrderShipment"
-  };
-  return (_a = lookup[componentName]) !== null && _a !== void 0 ? _a : "";
-};
-const getFeatures = (...element) => {
-  return element.map(feat => {
-    var _a;
-    return (_a = get$1(featureFlags, feat)) !== null && _a !== void 0 ? _a : {};
-  }).reduce((acc, feat) => Object.assign(acc, feat), {});
-};
-const useFeatures = (...element) => {
-  return getFeatures(...element);
-};
-
 /**
- * A curated list of date range options relative to the immediate date
+ * @internal
+ *
+ * # Date Range Options Hook
+ *
+ * A curated list of date range options relative to the immediate date.
+ *
+ * @see {@link DateRangeOption | The `DateRangeOption` type used in this hook}
  */
 const useDateRangeOptions = () => {
   const {
@@ -3623,6 +4360,13 @@ const useDateRangeOptions = () => {
   return [options, optionsByValue];
 };
 
+/**
+ * @internal
+ *
+ * # Expiration Month Options Hook
+ *
+ * @cateogry Hooks
+ */
 const useExpirationMonthOptions = () => {
   const {
     t
@@ -3666,6 +4410,13 @@ const useExpirationMonthOptions = () => {
   }];
 };
 
+/**
+ * @internal
+ *
+ * # Insurance Provider Options Hook
+ *
+ * @category Hooks
+ */
 const useInsuranceProviderOptions = (insuranceAccount, features) => {
   const {
     t
@@ -3676,6 +4427,13 @@ const useInsuranceProviderOptions = (insuranceAccount, features) => {
   }), [t, insuranceAccount, features === null || features === void 0 ? void 0 : features.includeThirdPartyInsurance, features === null || features === void 0 ? void 0 : features.includeShipsuranceInsurance]);
 };
 
+/**
+ * @internal
+ *
+ * # Shipment Metadata Hook
+ *
+ * @category Hooks
+ */
 const useShipmentMetadata = shipment => {
   const isInternational = useMemo(() => {
     return shipment ? getIsInternationalShipment(shipment) : false;
@@ -3689,13 +4447,22 @@ const useShipmentMetadata = shipment => {
     var _a;
     return shipment && ((_a = shipment.shipFrom) === null || _a === void 0 ? void 0 : _a.countryCode) === "MX" || (shipment === null || shipment === void 0 ? void 0 : shipment.shipTo.countryCode) === "MX";
   }, [shipment]);
-  return {
+  const shipmentUnits = useMemo(() => {
+    const packageDimensions = shipment === null || shipment === void 0 ? void 0 : shipment.packages[0].dimensions;
+    const packageWeight = shipment === null || shipment === void 0 ? void 0 : shipment.packages[0].weight;
+    const packageMeasurements = [packageDimensions === null || packageDimensions === void 0 ? void 0 : packageDimensions.height, packageDimensions === null || packageDimensions === void 0 ? void 0 : packageDimensions.length, packageDimensions === null || packageDimensions === void 0 ? void 0 : packageDimensions.width, packageWeight === null || packageWeight === void 0 ? void 0 : packageWeight.value];
+    const hasAllZeroMeasurements = packageMeasurements.every(m => m === 0);
+    return {
+      hasAllZeroMeasurements
+    };
+  }, [shipment]);
+  return Object.assign({
     isContentDescriptionRequired,
     isCustomsRequired,
     isInternational,
     isPoBox,
     isUnsupportedUpsCountry
-  };
+  }, shipmentUnits);
 };
 
 let _$2 = t => t,
@@ -3705,6 +4472,13 @@ const findGenericPackageFromCarriers = carriers => {
   const carrier = carriers.find(c => c.packages.some(p => p.packageCode === "package"));
   return carrier === null || carrier === void 0 ? void 0 : carrier.packages.find(p => p.packageCode === "package");
 };
+/**
+ * @internal
+ *
+ * # Package Options Hook
+ *
+ * @category Hooks
+ */
 const usePackageOptions = (carriers, customPackageTypes, shipment) => {
   const {
     t
@@ -3766,7 +4540,12 @@ const usePackageOptions = (carriers, customPackageTypes, shipment) => {
   }, [carriers, customPackageTypes, isPoBox, isUnsupportedUpsCountry, t]);
 };
 
-const useRateOptions = (rates, carriers, shipment, enableGlobalPostFiltering) => {
+/**
+ * @internal
+ *
+ * # Rate Options Hook
+ */
+const useRateOptions = (rates, carriers, shipment, enableGlobalPostFiltering, requireDhlTermsAcknowledgement) => {
   const carriersById = useMemo(() => createDictionary(carriers, c => ({
     [c.carrierId]: c
   })), [carriers]);
@@ -3791,13 +4570,20 @@ const useRateOptions = (rates, carriers, shipment, enableGlobalPostFiltering) =>
       return Object.assign(Object.assign({}, r), {
         balance,
         messages: r.warningMessages,
-        requiresAcknowledgement: getRateRequiresAcknowledgement(r.serviceCode, r.packageType),
+        requiresAcknowledgement: getRateRequiresAcknowledgement(r.serviceCode, r.packageType, !!requireDhlTermsAcknowledgement),
         requiresFundedAmount
       });
     });
-  }, [carriersById, enableGlobalPostFiltering, isInternational, isPoBox, isUnsupportedUpsCountry, rates]);
+  }, [carriersById, enableGlobalPostFiltering, isInternational, isPoBox, isUnsupportedUpsCountry, rates, requireDhlTermsAcknowledgement]);
 };
 
+/**
+ * @internal
+ *
+ * # Service Code Options Hook
+ *
+ * @category Hooks
+ */
 const useServiceCodeOptions = (carriers, shipment) => {
   const {
     isInternational,
@@ -3862,34 +4648,39 @@ const getWarningStyles = theme => /*#__PURE__*/css({
   width: theme.spacing()
 }, process.env.NODE_ENV === "production" ? "" : ";label:getWarningStyles;", process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbInByZXNldC1kZXNjcmlwdG9yLnN0eWxlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFxQjJDIiwiZmlsZSI6InByZXNldC1kZXNjcmlwdG9yLnN0eWxlcy50cyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGNzcyB9IGZyb20gXCJAZW1vdGlvbi9yZWFjdFwiO1xyXG5leHBvcnQgY29uc3QgZ2V0Q29udGFpbmVyU3R5bGVzID0gKHRoZW1lKSA9PiBjc3Moe1xyXG4gICAgZGlzcGxheTogXCJmbGV4XCIsXHJcbiAgICBmbGV4RGlyZWN0aW9uOiBcImNvbHVtblwiLFxyXG4gICAgaGVpZ2h0OiBcIjEwMCVcIixcclxuICAgIHBhZGRpbmdUb3A6IHRoZW1lLnNwYWNpbmcoMC41KSxcclxuICAgIHdpZHRoOiBcIm1heC1jb250ZW50XCIsXHJcbn0pO1xyXG5leHBvcnQgY29uc3QgZ2V0RGltZW5zaW9uU3R5bGVzID0gKHRoZW1lKSA9PiBjc3Moe1xyXG4gICAgY29sb3I6IHRoZW1lLnBhbGV0dGUuZ3JheS5tYWluLFxyXG4gICAgZm9udFNpemU6IHRoZW1lLnR5cG9ncmFwaHkuZm9udFNpemUuWFMsXHJcbn0pO1xyXG5leHBvcnQgY29uc3QgZ2V0U2VydmljZU5hbWVTdHlsZXMgPSAodGhlbWUpID0+IGNzcyh7XHJcbiAgICBmb250U2l6ZTogdGhlbWUudHlwb2dyYXBoeS5mb250U2l6ZS5YWFMsXHJcbiAgICBsaW5lSGVpZ2h0OiAwLFxyXG4gICAgcGFkZGluZ1RvcDogdGhlbWUuc3BhY2luZygpLFxyXG59KTtcclxuZXhwb3J0IGNvbnN0IGdldFByZXNldE5hbWVTdHlsZXMgPSAodGhlbWUpID0+IGNzcyh7XHJcbiAgICBmb250U2l6ZTogdGhlbWUudHlwb2dyYXBoeS5mb250U2l6ZS5YUyxcclxuICAgIGZvbnRXZWlnaHQ6IHRoZW1lLnR5cG9ncmFwaHkuZm9udFdlaWdodC5ib2xkLFxyXG59KTtcclxuZXhwb3J0IGNvbnN0IGdldFdhcm5pbmdTdHlsZXMgPSAodGhlbWUpID0+IGNzcyh7XHJcbiAgICBiYWNrZ3JvdW5kOiBcIm5vbmVcIixcclxuICAgIG1hcmdpbkxlZnQ6IFwiYXV0b1wiLFxyXG4gICAgbWFyZ2luUmlnaHQ6IHRoZW1lLnNwYWNpbmcoLTMpLFxyXG4gICAgbWFyZ2luVG9wOiB0aGVtZS5zcGFjaW5nKC01KSxcclxuICAgIHdpZHRoOiB0aGVtZS5zcGFjaW5nKCksXHJcbn0pO1xyXG4vLyMgc291cmNlTWFwcGluZ1VSTD1wcmVzZXQtZGVzY3JpcHRvci5zdHlsZXMuanMubWFwIl19 */");
 
-const PresetDescriptor = preset => jsx("div", Object.assign({
-  css: getContainerStyles
-}, {
-  children: jsxs("div", {
-    children: [jsxs("div", {
-      children: [jsx("span", Object.assign({
-        css: getPresetNameStyles
-      }, {
-        children: preset.name
-      })), jsx("span", Object.assign({
-        css: getDimensionStyles
-      }, {
-        children: (preset.dimensions || preset.weight) && " - "
-      })), preset.dimensions && jsxs("span", Object.assign({
-        css: getDimensionStyles
+const PresetDescriptor = preset => {
+  const {
+    t
+  } = useTranslation();
+  return jsx("div", Object.assign({
+    css: getContainerStyles
+  }, {
+    children: jsxs("div", {
+      children: [jsxs("div", {
+        children: [jsx("span", Object.assign({
+          css: getPresetNameStyles
+        }, {
+          children: preset.name
+        })), jsx("span", Object.assign({
+          css: getDimensionStyles
+        }, {
+          children: (preset.dimensions || preset.weight) && " - "
+        })), preset.dimensions && jsx("span", Object.assign({
+          css: getDimensionStyles
+        }, {
+          children: `${formatDimensions(preset.dimensions)} ` + t(`units.${preset.dimensions.unit}`)
+        }))]
+      }), jsx("div", Object.assign({
+        css: getServiceNameStyles
       }, {
-        children: [preset.dimensions.length, "x", preset.dimensions.height, "x", preset.dimensions.width]
-      }))]
-    }), jsx("div", Object.assign({
-      css: getServiceNameStyles
-    }, {
-      children: preset.serviceName && preset.serviceName
-    })), preset.serviceName && ["USPS Parcel Select Ground", "USPS First Class Mail"].includes(preset.serviceName) && jsx(InlineNotification, {
-      css: getWarningStyles,
-      type: NotificationType.ALERT
-    })]
-  })
-}));
+        children: preset.serviceName && preset.serviceName
+      })), preset.serviceName && ["USPS Parcel Select Ground", "USPS First Class Mail"].includes(preset.serviceName) && jsx(InlineNotification, {
+        css: getWarningStyles,
+        type: NotificationType.ALERT
+      })]
+    })
+  }));
+};
 
 const createCategoryFromShippingPresets = (categoryName, presets) => presets ? [{
   categoryName: categoryName,
@@ -3899,6 +4690,11 @@ const createCategoryFromShippingPresets = (categoryName, presets) => presets ? [
     value: p
   }))
 }] : [];
+/**
+ * @internal
+ *
+ * # Shipping Preset Options Component
+ */
 const useShippingPresetsOptions = ({
   platform,
   user
@@ -3914,11 +4710,25 @@ const useShippingPresetsOptions = ({
   ...createCategoryFromShippingPresets(t("shippingPresets.platform"), isInternational ? platform === null || platform === void 0 ? void 0 : platform.international : platform === null || platform === void 0 ? void 0 : platform.domestic)], [isInternational, platform, t, user]);
 };
 
+/**
+ * @internal
+ *
+ * # State Code Options Hook
+ *
+ * @category Hooks
+ */
 const useStateCodeOptions = domestic => useMemo(() => usStates.flatMap(v => !domestic || !v.isMilitary && !v.isUnitedStatesTerritory ? {
   label: v.name,
   value: v.code
 } : []), [domestic]);
 
+/**
+ * @internal
+ *
+ * # Warehouse Options Hook
+ *
+ * @category Hooks
+ */
 const useWarehouseOptions = warehouses => useMemo(() => {
   if (!warehouses) return undefined;
   return warehouses.map(warehouse => ({
@@ -4040,6 +4850,13 @@ var _carrierMetadata = [
 	}
 ];
 
+/**
+ * @internal
+ *
+ * # Carrier Metadata Hook
+ *
+ * @category Hooks
+ */
 const useCarrierMetadata = carrierCodes => {
   const carrierMetadatas = _carrierMetadata;
   return carrierCodes ? carrierCodes.flatMap(code => {
@@ -4049,7 +4866,11 @@ const useCarrierMetadata = carrierCodes => {
 };
 
 /**
- * A no-frills wrapper around React.createPortal for more elegant DOM composition
+ * @internal
+ *
+ * # Portal
+ *
+ * - A no-frills wrapper around React.createPortal for more elegant DOM composition
  *
  * @category Components
  *
@@ -4069,11 +4890,15 @@ const Portal = ({
 const RootPortalContext = /*#__PURE__*/createContext(undefined);
 RootPortalContext.displayName = "RootPortalContext";
 /**
+ * @internal
+ *
+ * # Root Portal Provider
+ *
  * Provides access to a top-level 'root-portal' DOM node, adjacent the app 'root' div
  *
  * @category Providers
  *
- * @see {@link ElementsProvider}
+ * @see {@link useRootPortal | The associated `hook` for this provider}
  */
 const RootPortalProvider = ({
   children
@@ -4094,9 +4919,18 @@ const RootPortalProvider = ({
   }));
 };
 /**
- * Must be used within {@link RootPortalProvider}
+ * @internal
+ *
+ * # Root Portal Provider Hook
+ *
+ * The `useRootPortal` hook provides access to a top-level 'root-portal' DOM node, adjacent
+ * the app 'root' div.
+ *
+ * -  Must be used within {@link RootPortalProvider | a `<RootPortalProvider />`}
  *
  * @category Elements Hooks
+ *
+ * @see {@link RootPortalProvider | The associated `provider` for this hook}
  */
 const useRootPortal = () => {
   const rootPortal = useContext(RootPortalContext);
@@ -4107,6 +4941,10 @@ const useRootPortal = () => {
 };
 
 /**
+ * @internal
+ *
+ * # Nested Form Hook Component
+ *
  * Returns a nested form element that can be rendered within another form
  *
  * Handles closing the form on cancel or submission
@@ -4156,6 +4994,13 @@ const useNestedForm = (form, props) => {
 
 const PageLayoutContext = /*#__PURE__*/createContext(undefined);
 PageLayoutContext.displayName = "PageLayoutContext";
+/**
+ * @internal
+ *
+ * # Page Layout Component
+ *
+ * @see {@link PageLayoutProviderProps | The props passed into the `<PageLayoutProvider />` component}
+ */
 const PageLayoutProvider = ({
   children
 }) => {
@@ -4206,6 +5051,13 @@ const PageLayoutProvider = ({
     }))
   }));
 };
+/**
+ * @internal
+ *
+ * # Page Layout Hook
+ *
+ * @category Hooks
+ */
 const usePageLayout = () => {
   const layoutPortals = useContext(PageLayoutContext);
   if (!layoutPortals) {
@@ -4215,7 +5067,11 @@ const usePageLayout = () => {
 };
 
 /**
- * Runs a callback once and only once when a condition is true.
+ * @internal
+ *
+ * # Run Once On True Hook
+ *
+ * - Runs a callback once and only once when a condition is true.
  *
  * @param conditionalEffect A logical expression ending with a callback
  * @example useRunOnceOnTrue(testValue && anotherTestValue && (() => console.log("Hello world!")));
@@ -4231,7 +5087,11 @@ const useRunOnceOnTrue = conditionalEffect => {
 };
 
 /**
- * Create a boolean that can be toggled or set to a specific value
+ * @internal
+ *
+ * # Toggle Hook
+ *
+ * - Create a boolean that can be toggled or set to a specific value
  *
  * @example
  * ```tsx
@@ -4375,13 +5235,13 @@ var iterate$3 = function (iterable, unboundFunction, options) {
   } return new Result(false);
 };
 
-var $$b = _export;
+var $$a = _export;
 var iterate$2 = iterate$3;
 var createProperty = createProperty$2;
 
 // `Object.fromEntries` method
 // https://github.com/tc39/proposal-object-from-entries
-$$b({ target: 'Object', stat: true }, {
+$$a({ target: 'Object', stat: true }, {
   fromEntries: function fromEntries(iterable) {
     var obj = {};
     iterate$2(iterable, function (k, v) {
@@ -4391,6 +5251,13 @@ $$b({ target: 'Object', stat: true }, {
   }
 });
 
+/**
+ * @internal
+ *
+ * # Address Validation Hook
+ *
+ * @cateogry Hooks
+ */
 const useAddressValidation = () => {
   const [validationPreference, setValidationPreference] = useState();
   const {
@@ -4478,7 +5345,9 @@ const useAddressValidation = () => {
  * There is a chance that more than one script will be mounted if this hook is used elsewhere.
  */
 /**
- * Creates an encoded device fingerprint string - aka black box - containing information about the end-user's computing device such as OS, browser, etc.
+ * @internal
+ *
+ * - Creates an encoded device fingerprint string - aka black box - containing information about the end-user's computing device such as OS, browser, etc.
  * https://developer.bazaarvoice.com/conversations-api/deprecations/iovation-web#snare_js_only
  */
 const useBlackboxDetection = ({
@@ -4532,6 +5401,30 @@ const useBlackboxDetection = ({
   }, [onSuccess, onError]);
 };
 
+/**
+ * @internal
+ *
+ * # Scrub Errors Hook
+ *
+ * Generic error pretty printer
+ *
+ * @category Hooks
+ */
+const useScrubErrors = ({
+  scrubber,
+  errors,
+  predicate
+}) => {
+  const {
+    t
+  } = useTranslation();
+  return useMemo(() => errors === null || errors === void 0 ? void 0 : errors.map(e => {
+    return t(encode(e.message), {
+      defaultValue: !predicate || predicate(e) ? t(scrubber(e)) : e.message
+    });
+  }), [errors, predicate, scrubber, t]);
+};
+
 const useListConnectedCarriers = () => {
   const {
     data: carriers,
@@ -4552,6 +5445,29 @@ const useListConnectedCarriers = () => {
   };
 };
 
+/**
+ * # List-Carriers Component
+ *
+ * @param ComponentProps The base props that will be passed into the `<List-Carriers />` component.
+ *
+ * @returns Element A React element that renders the `<List-Carriers />` component allowing users
+ * to view a list of carriers that are connected to their ShipEngine account. This component is
+ * composed in the `<AccountSettings />` Element.
+ *
+ * @example
+ * ```tsx
+ * (() => {
+ *   const features = useFeatures("Global");
+ *
+ *   return <ListCarriers.Component features={features} />;
+ * })();
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link ListCarriers.ComponentProps | The props that are passed into the `<List-Carriers />` component}
+ * @see {@link AccountSettings.Element | The `<AccountSettings />` component renders the `<List-Carriers />` component}
+ */
 const Component$6 = ({
   features
 }) => {
@@ -4596,6 +5512,29 @@ var listCarriers$1 = /*#__PURE__*/Object.freeze({
 	Component: Component$6
 });
 
+/**
+ * # Manage Warehouses Component
+ *
+ * - The `<ManageWarehouses />` component is used to manage warehouses on a user's ShipEngine account. Users can add, update, or make warehouses inactive.
+ * `<AccountSettings />` Element.
+ *
+ * @param ComponentProps The base props that will be passed into the `<ManageWarehouses />` component.
+ *
+ * @returns Element A React element that renders the `<ManageWarehouses />` component allowing users
+ * to manage warehouses on their ShipEngine account.
+ *
+ * @example
+ * ```tsx
+ * export const ManageWarehousesExample = () => {
+ *   return <ManageWarehouses.Component />;
+ * };
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link ManageWarehouses.ComponentProps | The props that are passed into the `<ManageWarehouses />` component}
+ * @see {@link AccountSettings.Element | The `<AccountSettings />` component renders the `<ManageWarehouses />` component}
+ */
 const Component$5 = ({
   onWarehouseAddressValidation
 }) => {
@@ -4682,160 +5621,6 @@ var manageWarehouses$1 = /*#__PURE__*/Object.freeze({
 	Component: Component$5
 });
 
-var uncurryThis$6 = functionUncurryThis;
-
-// `thisNumberValue` abstract operation
-// https://tc39.es/ecma262/#sec-thisnumbervalue
-var thisNumberValue$1 = uncurryThis$6(1.0.valueOf);
-
-var toIntegerOrInfinity$1 = toIntegerOrInfinity$6;
-var toString$5 = toString$c;
-var requireObjectCoercible$2 = requireObjectCoercible$9;
-
-var $RangeError$1 = RangeError;
-
-// `String.prototype.repeat` method implementation
-// https://tc39.es/ecma262/#sec-string.prototype.repeat
-var stringRepeat = function repeat(count) {
-  var str = toString$5(requireObjectCoercible$2(this));
-  var result = '';
-  var n = toIntegerOrInfinity$1(count);
-  if (n < 0 || n == Infinity) throw $RangeError$1('Wrong number of repetitions');
-  for (;n > 0; (n >>>= 1) && (str += str)) if (n & 1) result += str;
-  return result;
-};
-
-var $$a = _export;
-var uncurryThis$5 = functionUncurryThis;
-var toIntegerOrInfinity = toIntegerOrInfinity$6;
-var thisNumberValue = thisNumberValue$1;
-var $repeat = stringRepeat;
-var fails$4 = fails$q;
-
-var $RangeError = RangeError;
-var $String = String;
-var floor = Math.floor;
-var repeat = uncurryThis$5($repeat);
-var stringSlice$2 = uncurryThis$5(''.slice);
-var nativeToFixed = uncurryThis$5(1.0.toFixed);
-
-var pow = function (x, n, acc) {
-  return n === 0 ? acc : n % 2 === 1 ? pow(x, n - 1, acc * x) : pow(x * x, n / 2, acc);
-};
-
-var log = function (x) {
-  var n = 0;
-  var x2 = x;
-  while (x2 >= 4096) {
-    n += 12;
-    x2 /= 4096;
-  }
-  while (x2 >= 2) {
-    n += 1;
-    x2 /= 2;
-  } return n;
-};
-
-var multiply = function (data, n, c) {
-  var index = -1;
-  var c2 = c;
-  while (++index < 6) {
-    c2 += n * data[index];
-    data[index] = c2 % 1e7;
-    c2 = floor(c2 / 1e7);
-  }
-};
-
-var divide = function (data, n) {
-  var index = 6;
-  var c = 0;
-  while (--index >= 0) {
-    c += data[index];
-    data[index] = floor(c / n);
-    c = (c % n) * 1e7;
-  }
-};
-
-var dataToString = function (data) {
-  var index = 6;
-  var s = '';
-  while (--index >= 0) {
-    if (s !== '' || index === 0 || data[index] !== 0) {
-      var t = $String(data[index]);
-      s = s === '' ? t : s + repeat('0', 7 - t.length) + t;
-    }
-  } return s;
-};
-
-var FORCED$2 = fails$4(function () {
-  return nativeToFixed(0.00008, 3) !== '0.000' ||
-    nativeToFixed(0.9, 0) !== '1' ||
-    nativeToFixed(1.255, 2) !== '1.25' ||
-    nativeToFixed(1000000000000000128.0, 0) !== '1000000000000000128';
-}) || !fails$4(function () {
-  // V8 ~ Android 4.3-
-  nativeToFixed({});
-});
-
-// `Number.prototype.toFixed` method
-// https://tc39.es/ecma262/#sec-number.prototype.tofixed
-$$a({ target: 'Number', proto: true, forced: FORCED$2 }, {
-  toFixed: function toFixed(fractionDigits) {
-    var number = thisNumberValue(this);
-    var fractDigits = toIntegerOrInfinity(fractionDigits);
-    var data = [0, 0, 0, 0, 0, 0];
-    var sign = '';
-    var result = '0';
-    var e, z, j, k;
-
-    // TODO: ES2018 increased the maximum number of fraction digits to 100, need to improve the implementation
-    if (fractDigits < 0 || fractDigits > 20) throw $RangeError('Incorrect fraction digits');
-    // eslint-disable-next-line no-self-compare -- NaN check
-    if (number != number) return 'NaN';
-    if (number <= -1e21 || number >= 1e21) return $String(number);
-    if (number < 0) {
-      sign = '-';
-      number = -number;
-    }
-    if (number > 1e-21) {
-      e = log(number * pow(2, 69, 1)) - 69;
-      z = e < 0 ? number * pow(2, -e, 1) : number / pow(2, e, 1);
-      z *= 0x10000000000000;
-      e = 52 - e;
-      if (e > 0) {
-        multiply(data, 0, z);
-        j = fractDigits;
-        while (j >= 7) {
-          multiply(data, 1e7, 0);
-          j -= 7;
-        }
-        multiply(data, pow(10, j, 1), 0);
-        j = e - 1;
-        while (j >= 23) {
-          divide(data, 1 << 23);
-          j -= 23;
-        }
-        divide(data, 1 << j);
-        multiply(data, 1, 1);
-        divide(data, 2);
-        result = dataToString(data);
-      } else {
-        multiply(data, 0, z);
-        multiply(data, 1 << -e, 0);
-        result = dataToString(data) + repeat('0', fractDigits);
-      }
-    }
-    if (fractDigits > 0) {
-      k = result.length;
-      result = sign + (k <= fractDigits
-        ? '0.' + repeat('0', fractDigits - k) + result
-        : stringSlice$2(result, 0, k - fractDigits) + '.' + stringSlice$2(result, k - fractDigits));
-    } else {
-      result = sign + result;
-    } return result;
-  }
-});
-
 var img$5 = "data:image/svg+xml,%3csvg fill='none' height='24' viewBox='0 0 24 24' width='24' xmlns='http://www.w3.org/2000/svg'%3e %3cpath d='M22.9425 6.62223L18.63 5.81973C18.4275 5.78223 18.2325 5.91723 18.195 6.11973L17.3925 10.4322C17.355 10.6347 17.49 10.8297 17.6925 10.8672C17.715 10.8672 17.7375 10.8672 17.76 10.8672C17.94 10.8672 18.0975 10.7397 18.1275 10.5597L18.765 7.13973C21.15 10.3872 20.8125 14.9472 17.9475 17.8047C15.3225 20.4297 11.25 20.9697 8.04001 19.1247C7.86001 19.0197 7.63501 19.0797 7.53001 19.2597C7.42501 19.4397 7.49251 19.6647 7.66501 19.7697C9.05251 20.5722 10.5975 20.9622 12.1275 20.9622C14.4525 20.9622 16.755 20.0622 18.48 18.3372C21.5925 15.2247 21.9675 10.2597 19.3875 6.71973L22.8 7.34973C22.995 7.38723 23.1975 7.25223 23.235 7.04973C23.2725 6.84723 23.1375 6.65223 22.935 6.61473L22.9425 6.62223Z' fill='black' /%3e %3cpath d='M6.30022 12.7798C6.09772 12.7423 5.90272 12.8773 5.86522 13.0798L5.24272 16.4548C3.15022 13.2223 3.60022 8.91728 6.33022 6.18728C8.85022 3.66728 12.6752 3.05228 15.8477 4.65728C16.0277 4.74728 16.2602 4.67978 16.3502 4.49228C16.4402 4.30478 16.3727 4.07978 16.1852 3.98978C12.7202 2.23478 8.54272 2.90978 5.79772 5.65478C2.79022 8.66228 2.31772 13.3948 4.65022 16.9273L1.19272 16.2898C0.990221 16.2523 0.795221 16.3873 0.757721 16.5898C0.720221 16.7923 0.855221 16.9873 1.05772 17.0248L5.37022 17.8273C5.37022 17.8273 5.41522 17.8273 5.43772 17.8273C5.61772 17.8273 5.77522 17.6998 5.80522 17.5198L6.60772 13.2073C6.64522 13.0048 6.51022 12.8098 6.30772 12.7723L6.30022 12.7798Z' fill='black' /%3e %3cpath d='M15.0824 13.2223C14.9249 12.9373 14.7224 12.6973 14.4674 12.4948C14.2124 12.2998 13.9349 12.1348 13.6274 11.9998C13.3199 11.8648 13.0124 11.7598 12.7124 11.6773L12.3149 11.5648V7.87482C12.8324 7.91232 13.2749 8.06232 13.6349 8.33232C14.0549 8.64732 14.2874 9.07482 14.3399 9.60732H15.1874C15.1724 9.11982 15.0224 8.68482 14.7524 8.30232C14.4824 7.91982 14.1149 7.61982 13.6574 7.40232C13.2599 7.21482 12.8099 7.12482 12.3149 7.09482V6.31482C12.3149 6.14232 12.1799 6.00732 12.0074 6.00732C11.8349 6.00732 11.6999 6.14232 11.6999 6.31482V7.10982C11.2649 7.14732 10.8449 7.22982 10.4774 7.40232C10.0049 7.61982 9.62988 7.92732 9.35238 8.31732C9.07488 8.70732 8.93988 9.16482 8.93988 9.67482C8.93988 10.2898 9.14988 10.7998 9.56238 11.1898C9.97488 11.5798 10.5599 11.8948 11.3174 12.1198L11.6999 12.2323V16.1323C11.3849 16.1098 11.0849 16.0573 10.8224 15.9523C10.4699 15.8173 10.1849 15.6148 9.96738 15.3523C9.74988 15.0898 9.62238 14.7673 9.59238 14.3923V14.3323C9.59238 14.0848 9.38988 13.8823 9.14238 13.8823C8.89488 13.8823 8.69238 14.0848 8.69238 14.3323V14.3923C8.72988 14.8948 8.87988 15.3448 9.15738 15.7273C9.43488 16.1098 9.80988 16.4098 10.2899 16.6273C10.6949 16.8073 11.1749 16.8973 11.6999 16.9273V17.6848C11.6999 17.8573 11.8349 17.9923 12.0074 17.9923C12.1799 17.9923 12.3149 17.8573 12.3149 17.6848V16.9348C12.8699 16.9048 13.3574 16.7923 13.7774 16.5898C14.2724 16.3498 14.6549 16.0273 14.9174 15.6148C15.1799 15.2023 15.3149 14.7448 15.3149 14.2348C15.3149 13.8373 15.2399 13.4923 15.0824 13.2073V13.2223ZM11.0099 11.1448C10.7849 11.0473 10.5749 10.9348 10.3949 10.7923C10.2074 10.6573 10.0574 10.4923 9.95238 10.3048C9.84738 10.1173 9.78738 9.89232 9.78738 9.63732C9.78738 9.29232 9.88488 8.98482 10.0724 8.71482C10.2674 8.44482 10.5299 8.23482 10.8674 8.07732C11.1149 7.96482 11.3924 7.91232 11.6924 7.88232V11.3848C11.4599 11.3173 11.2349 11.2348 11.0024 11.1373L11.0099 11.1448ZM14.1449 15.2473C13.9274 15.5398 13.6349 15.7648 13.2674 15.9223C12.9824 16.0423 12.6599 16.1023 12.3149 16.1323V12.4198L12.4649 12.4648C12.8624 12.5773 13.2074 12.7123 13.5149 12.8623C13.8149 13.0123 14.0549 13.1998 14.2199 13.4173C14.3849 13.6348 14.4749 13.9123 14.4749 14.2348C14.4749 14.6173 14.3699 14.9548 14.1524 15.2473H14.1449Z' fill='black' /%3e %3cpath d='M14.7525 10.0796C14.985 10.0796 15.1725 9.89211 15.1725 9.65961V9.59961H14.3325V9.65961C14.3325 9.89211 14.52 10.0796 14.7525 10.0796Z' fill='black' /%3e%3c/svg%3e";
 
 const styles$w = ({
@@ -5751,6 +6536,11 @@ const icons = {
   download: IconNames.DOWNLOAD,
   retry: IconNames.CIRCULAR_ARROW
 };
+/**
+ * @internal
+ *
+ * # Link Action Component
+ */
 const LinkAction = _a => {
   var {
       css,
@@ -5837,6 +6627,22 @@ const ErrorDisplay = () => jsxs("div", Object.assign({
   }))]
 }));
 
+/**
+ * @internal
+ *
+ * # Spacer Component Util Function
+ *
+ * - This is a utility function that generates dynamic styles for the `<Spacer />` component.
+ *
+ * @param SpacerProps The base props that will be passed into the `<Spacer />` component at
+ * point of use.
+ *
+ * @return Styles A `SerializedStyles` object that contains styles that can be consumed by
+ * our `ThemeProvider` and `EmotionJSX.Element` components.
+ *
+ * @see {@link Spacer | The `<Spacer />` component that uses these dynamic styles}
+ *
+ */
 const getSpacerStyles = ({
   displayOn,
   multiplier: _multiplier = 4
@@ -5850,11 +6656,28 @@ const getSpacerStyles = ({
 }), {
   height: theme.spacing(_multiplier),
   width: "100%"
-}), process.env.NODE_ENV === "production" ? "" : ";label:getSpacerStyles;", process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbInNwYWNlci50c3giXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRXNFIiwiZmlsZSI6InNwYWNlci50c3giLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBqc3ggYXMgX2pzeCB9IGZyb20gXCJAZW1vdGlvbi9yZWFjdC9qc3gtcnVudGltZVwiO1xyXG5pbXBvcnQgeyBjc3MgfSBmcm9tIFwiQGVtb3Rpb24vcmVhY3RcIjtcclxuY29uc3QgZ2V0U3BhY2VyU3R5bGVzID0gKHsgZGlzcGxheU9uLCBtdWx0aXBsaWVyID0gNCB9KSA9PiAodGhlbWUpID0+IGNzcyhPYmplY3QuYXNzaWduKE9iamVjdC5hc3NpZ24oe30sIChkaXNwbGF5T25cclxuICAgID8geyBkaXNwbGF5OiBcIm5vbmVcIiwgW3RoZW1lLm1lZGlhUXVlcnkoZGlzcGxheU9uKV06IHsgZGlzcGxheTogXCJibG9ja1wiIH0gfVxyXG4gICAgOiB7IGRpc3BsYXk6IFwiYmxvY2tcIiB9KSksIHsgaGVpZ2h0OiB0aGVtZS5zcGFjaW5nKG11bHRpcGxpZXIpLCB3aWR0aDogXCIxMDAlXCIgfSkpO1xyXG5leHBvcnQgY29uc3QgU3BhY2VyID0gKHByb3BzKSA9PiBfanN4KFwiZGl2XCIsIHsgY3NzOiBnZXRTcGFjZXJTdHlsZXMocHJvcHMpIH0pO1xyXG4vLyMgc291cmNlTWFwcGluZ1VSTD1zcGFjZXIuanMubWFwIl19 */");
+}), process.env.NODE_ENV === "production" ? "" : ";label:getSpacerStyles;", process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbInNwYWNlci50c3giXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBa0JzRSIsImZpbGUiOiJzcGFjZXIudHN4Iiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsganN4IGFzIF9qc3ggfSBmcm9tIFwiQGVtb3Rpb24vcmVhY3QvanN4LXJ1bnRpbWVcIjtcclxuaW1wb3J0IHsgY3NzIH0gZnJvbSBcIkBlbW90aW9uL3JlYWN0XCI7XHJcbi8qKlxyXG4gKiBAaW50ZXJuYWxcclxuICpcclxuICogIyBTcGFjZXIgQ29tcG9uZW50IFV0aWwgRnVuY3Rpb25cclxuICpcclxuICogLSBUaGlzIGlzIGEgdXRpbGl0eSBmdW5jdGlvbiB0aGF0IGdlbmVyYXRlcyBkeW5hbWljIHN0eWxlcyBmb3IgdGhlIGA8U3BhY2VyIC8+YCBjb21wb25lbnQuXHJcbiAqXHJcbiAqIEBwYXJhbSBTcGFjZXJQcm9wcyBUaGUgYmFzZSBwcm9wcyB0aGF0IHdpbGwgYmUgcGFzc2VkIGludG8gdGhlIGA8U3BhY2VyIC8+YCBjb21wb25lbnQgYXRcclxuICogcG9pbnQgb2YgdXNlLlxyXG4gKlxyXG4gKiBAcmV0dXJuIFN0eWxlcyBBIGBTZXJpYWxpemVkU3R5bGVzYCBvYmplY3QgdGhhdCBjb250YWlucyBzdHlsZXMgdGhhdCBjYW4gYmUgY29uc3VtZWQgYnlcclxuICogb3VyIGBUaGVtZVByb3ZpZGVyYCBhbmQgYEVtb3Rpb25KU1guRWxlbWVudGAgY29tcG9uZW50cy5cclxuICpcclxuICogQHNlZSB7QGxpbmsgU3BhY2VyIHwgVGhlIGA8U3BhY2VyIC8+YCBjb21wb25lbnQgdGhhdCB1c2VzIHRoZXNlIGR5bmFtaWMgc3R5bGVzfVxyXG4gKlxyXG4gKi9cclxuY29uc3QgZ2V0U3BhY2VyU3R5bGVzID0gKHsgZGlzcGxheU9uLCBtdWx0aXBsaWVyID0gNCB9KSA9PiAodGhlbWUpID0+IGNzcyhPYmplY3QuYXNzaWduKE9iamVjdC5hc3NpZ24oe30sIChkaXNwbGF5T25cclxuICAgID8geyBkaXNwbGF5OiBcIm5vbmVcIiwgW3RoZW1lLm1lZGlhUXVlcnkoZGlzcGxheU9uKV06IHsgZGlzcGxheTogXCJibG9ja1wiIH0gfVxyXG4gICAgOiB7IGRpc3BsYXk6IFwiYmxvY2tcIiB9KSksIHsgaGVpZ2h0OiB0aGVtZS5zcGFjaW5nKG11bHRpcGxpZXIpLCB3aWR0aDogXCIxMDAlXCIgfSkpO1xyXG4vKipcclxuICogQGludGVybmFsXHJcbiAqXHJcbiAqICMgU3BhY2VyIENvbXBvc2l0aW9uIENvbXBvbmVudFxyXG4gKlxyXG4gKiAtIFRoZSBgU3BhY2VyYCBpcyBhIGNvbXBvc2l0aW9uIGNvbXBvbmVudCB1c2VkIHRvIGNyZWF0ZSBhIHNwYWNlIGJldHdlZW4gZWxlbWVudHNcclxuICogaW4gdGhlIFVJLlxyXG4gKlxyXG4gKiBAc2VlIHtAbGluayBTcGFjZXIuU3BhY2VyUHJvcHMgfCBUaGUgcHJvcHMgbmVjZXNzYXJ5IHRvIHJlbmRlciB0aGUgYDxTcGFjZXIgLz5gIGNvbXBvbmVudH1cclxuICogQHNlZSB7QGxpbmsgU3BhY2VyLmdldFNwYWNlclN0eWxlcyB8IFRoZSB1dGlsIGZ1bmN0aW9uIHRoYXQgZ2VuZXJhdGVzIHRoZSBzdHlsZXMgZm9yIHRoZSBgPFNwYWNlciAvPmAgY29tcG9uZW50fVxyXG4gKlxyXG4gKi9cclxuZXhwb3J0IGNvbnN0IFNwYWNlciA9IChwcm9wcykgPT4gX2pzeChcImRpdlwiLCB7IGNzczogZ2V0U3BhY2VyU3R5bGVzKHByb3BzKSB9KTtcclxuLy8jIHNvdXJjZU1hcHBpbmdVUkw9c3BhY2VyLmpzLm1hcCJdfQ== */");
+/**
+ * @internal
+ *
+ * # Spacer Composition Component
+ *
+ * - The `Spacer` is a composition component used to create a space between elements
+ * in the UI.
+ *
+ * @see {@link Spacer.SpacerProps | The props necessary to render the `<Spacer />` component}
+ * @see {@link Spacer.getSpacerStyles | The util function that generates the styles for the `<Spacer />` component}
+ *
+ */
 const Spacer = props => jsx("div", {
   css: getSpacerStyles(props)
 });
 
+/**
+ * @internal
+ *
+ * # Spread Component
+ */
 const Spread = ({
   children
 }) => jsx("div", Object.assign({
@@ -6280,6 +7103,11 @@ const styles$s = createStyles({
   })
 });
 
+/**
+ * @namespace WalletHistory
+ *
+ * # Wallet History
+ */
 const WalletHistory = () => {
   var _a;
   const {
@@ -6542,6 +7370,11 @@ const LabelLayoutPurchase = ({
   });
 };
 
+/**
+ * @internal
+ *
+ * # Loader Component
+ */
 const Loader = props => {
   return jsx("div", Object.assign({
     css: {
@@ -6659,7 +7492,7 @@ const SaveStatus = ({
       }))]
     }));
   }
-  return !isSaving && !errors ? jsxs("div", Object.assign({
+  return !isSaving && !(errors === null || errors === void 0 ? void 0 : errors.length) ? jsxs("div", Object.assign({
     css: styles$r.container
   }, {
     children: [jsx("svg", Object.assign({
@@ -6723,6 +7556,16 @@ const styles$q = createStyles({
   })
 });
 
+/**
+ * @internal
+ *
+ * # Collapsible Panel Component
+ *
+ * - The `<CollapsiblePanel />` composition component is used to group content together that can
+ * be expanded or collapsed.
+ *
+ * @see {@link CollapsiblePanelProps | The props that are passed into the `<CollapsiblePanel />` component}
+ */
 const CollapsiblePanel = ({
   errors,
   initialExpanded,
@@ -6970,6 +7813,11 @@ const LabelLayoutSettings = ({
   }));
 };
 
+/**
+ * @namespace LabelLayout
+ *
+ * # Label Layout Component
+ */
 const LabelLayout = ({
   display
 }) => {
@@ -7002,6 +7850,16 @@ const LabelLayout = ({
   });
 };
 
+/**
+ * @internal
+ *
+ * # Button Group Component
+ *
+ * - The `<ButtonGroup />` is a composition component used to group buttons together that are
+ * passed in as children.
+ *
+ * @see {@link ButtonGroupProps | The props that are passed into the `<ButtonGroup />` component}
+ */
 const ButtonGroup = _a => {
   var {
       children,
@@ -7038,6 +7896,11 @@ const ButtonGroup = _a => {
   }));
 };
 
+/**
+ * @internal
+ *
+ * # Field Label Component
+ */
 const FieldLabel = ({
   children,
   label,
@@ -8168,6 +9031,19 @@ const getAcknowledgementLabel = (serviceCode, packageType) => {
         });
       }
       return;
+    case "dhl_express_worldwide":
+      return jsxs(Trans, Object.assign({
+        i18nKey: "purchase-label:rates.dhlExpressTermsAcknowledgement"
+      }, {
+        children: ["To start shipping with DHL, you are confirming that you have agreed to the ", jsx(Link, Object.assign({
+          href: "https://mydhl.express.dhl/us/en/legal/terms-and-conditions.html",
+          isExternal: true,
+          rel: "noreferrer",
+          target: "_blank"
+        }, {
+          children: "terms and conditions"
+        }))]
+      }));
     default:
       return null;
   }
@@ -8579,6 +9455,10 @@ var fields = /*#__PURE__*/Object.freeze({
 });
 
 /**
+ * @internal
+ *
+ * # Form Portal Component
+ *
  * A drop-in replacement for the `<form>` tag that allows nested forms.
  *
  * Via portals, the <form> tag is mounted as a sibling of the app root. The form's
@@ -8648,6 +9528,10 @@ const styles$o = createStyles({
 });
 
 /**
+ * @internal
+ *
+ * # Money Schema
+ *
  * @category Form Validation
  */
 const moneySchema = z.object({
@@ -8656,14 +9540,33 @@ const moneySchema = z.object({
 });
 
 /**
+ * @internal
+ *
+ * # Phone utils
+ *
  * @category Form Validation
  */
 const phoneSchema = (defaultCountryCode = "US") => z.string().trim().refine(val => isValidPhoneNumber(val, defaultCountryCode), "schemaErrors.notAValidPhoneNumber");
 /**
+ * @internal
+ *
+ * # Phone utils
+ *
  * @category Form Validation
  */
 const phoneSchemaUnvalidated = z.string().trim();
 
+/**
+ * @internal
+ *
+ * # Add Funds Form Schema
+ *
+ * - A util function to create a dynamic form schema based on the mininum amount
+ * passed into the function.
+ *
+ * @param minimumAmount - The minimum amount that can be added to the account. This defaults to
+ * 10 if nothing is passed in.
+ */
 const getAddFundsSchema = (minimumAmount = 10) => z.object({
   funds: moneySchema.extend({
     amount: z.number().min(minimumAmount)
@@ -8671,9 +9574,15 @@ const getAddFundsSchema = (minimumAmount = 10) => z.object({
 }).transform(data => data.funds);
 
 /**
- * Form for adding funds to a carrier's account.
+ * @internal
+ *
+ * # Add Funds Form Component
+ *
+ * - Form for adding funds to a carrier's account.
  *
- * If a render child is provided, external control is assumed and the cancel / submit buttons are hidden.
+ * If a `render child` is provided, external control is assumed and the cancel / submit buttons are hidden.
+ *
+ * @see {@link AddFundsFormProps | The props that are passed into the `<AddFundsForm />` component}
  */
 const AddFundsForm = ({
   carrierId,
@@ -8815,7 +9724,16 @@ const AddFundsForm = ({
           }))]
         }))]
       })]
-    })), children === null || children === void 0 ? void 0 : children({
+    })), !children && addFunds.error && jsxs(Fragment, {
+      children: [jsx(Spacer, {
+        multiplier: 1
+      }), jsx(InlineNotification, Object.assign({
+        title: t("manage-funding:addFunds.error.title"),
+        type: NotificationType.ERROR
+      }, {
+        children: addFunds.error[0].message
+      }))]
+    }), children === null || children === void 0 ? void 0 : children({
       error: addFunds.error,
       isCustomAmount: selectedChip.value === "custom",
       isSubmitted,
@@ -8846,6 +9764,13 @@ const styles$n = createStyles({
   }
 });
 
+/**
+ * @internal
+ *
+ * # Auto Funding Form Schema
+ *
+ * @see {@link AutoFundingForm | Auto Funding Form component using this schema}
+ * */
 const autoFundingSchema = z.object({
   isEnabled: z.boolean(),
   lowBalancePurchaseThreshold: moneySchema.extend({
@@ -8858,10 +9783,19 @@ const autoFundingSchema = z.object({
 });
 
 /**
+ * @internal
+ *
+ * # Auto Funding Form Component
+ *
  * This form that allows users to enable or disable auto funding, and
  * configure auto funding rules in ShipEngine API.
  *
  * @param carrierId The carrierId of the carrier provider you wish to configure auto-funding rules for.
+ *
+ * @returns Element A React element that renders the Auto Funding Form allowing users to configure
+ * auto-funding rules for a given carrier provider.
+ *
+ * @see {@link AutoFundingFormProps | The props that are passed into the `<AutoFundingForm />` component}
  */
 const AutoFundingForm = ({
   carrierId
@@ -9038,6 +9972,11 @@ const styles$m = isLabelRight => createStyles({
   })
 });
 
+/**
+ * @internal
+ *
+ * # Inline Label Component
+ */
 const InlineLabel = ({
   children,
   label,
@@ -9057,6 +9996,16 @@ const styles$l = createStyles({
   })
 });
 
+/**
+ * @internal
+ *
+ * # Carrier Balance
+ *
+ * - The `<CarrierBalance />` component is used to display the current balance for a given
+ * carrier provider.
+ *
+ * @see {@link CarrierBalanceProps | The props for the `<CarrierBalance />` component}
+ */
 const CarrierBalance = ({
   balance,
   carrierId
@@ -9086,6 +10035,22 @@ const CarrierBalance = ({
   }));
 };
 
+/**
+ * @namespace ManageFunding
+ *
+ * # Manage Funding Component
+ *
+ * - The `<ManageFunding />` component is used to manage funding rules and add funds to a carrier
+ * account, and is composed in the `<AccountSettings />` component.
+ *
+ * @param ManageFundingProps The base props that will be passed into the `<ManageFunding />` component.
+ *
+ * @returns Element A React element that renders the `<ManageFunding />` component allowing users
+ * manage funding rules and add funds to their carrier accounts.
+ *
+ * @see {@link ManageFundingProps | The props that are passed into the `<ManageFunding />` component}
+ * @see {@link AccountSettings.Element | The `<AccountSettings />` component renders the `<ManageFunding />` component}
+ */
 const ManageFunding = ({
   carrierId
 }) => {
@@ -9219,7 +10184,7 @@ const styles$k = createStyles({
       flex: "1 0 100%"
     },
     display: "flex",
-    flex: "1 0 66%",
+    flex: "1 0 64%",
     width: "100%"
   },
   stateZipWrapper: theme => ({
@@ -9249,7 +10214,10 @@ const AddressFields = ({
   const {
     t
   } = useTranslation();
-  const countryCodeOptions = useCountryCodeOptions(domestic);
+  const {
+    countryCodeOptions,
+    defaultCountryCodeOption
+  } = useCountryCodeOptions(domestic);
   const stateCodeOptions = useStateCodeOptions(domestic);
   const {
     isSubmitted
@@ -9273,6 +10241,7 @@ const AddressFields = ({
       nativeLabel: true
     }), jsx(SelectAutoComplete, {
       control: form.control,
+      defaultValue: defaultCountryCodeOption === null || defaultCountryCodeOption === void 0 ? void 0 : defaultCountryCodeOption.value,
       form: formId,
       label: t("address.fields.countryCode"),
       labelWeight: "normal",
@@ -9421,6 +10390,10 @@ function nullishDefault(defaultValue) {
   return this.nullish().transform(v => v !== null && v !== void 0 ? v : defaultValue);
 }
 /**
+ * @internal
+ *
+ * # Form Utilities
+ *
  * @category Form Validation
  */
 const extendZod = () => {
@@ -9836,7 +10809,7 @@ const AddressPreferenceSelect = ({
           warehousePreference: originAddress
         })]
       })), returnAddress && jsxs(GridChild, Object.assign({
-        colSpan: 8
+        colSpan: 12
       }, {
         children: [jsx(Typography, Object.assign({
           css: {
@@ -9884,6 +10857,7 @@ const AddressPreferenceProvider = props => {
     onSubmit
   } = props;
   const [passengerData, setPassengerData] = useState();
+  const [userInput, setUserInput] = useState();
   const {
     validate: validateAddress,
     validationPreference,
@@ -9895,6 +10869,7 @@ const AddressPreferenceProvider = props => {
       onValid,
       data
     } = payload;
+    setUserInput(addresses);
     const validationPreference = yield validateAddress(addresses);
     const {
       originAddress,
@@ -9928,6 +10903,7 @@ const AddressPreferenceProvider = props => {
   return jsx(AddressPreferenceContext.Provider, Object.assign({
     value: {
       data: passengerData,
+      userInput,
       validateAddress: internalValidateAddress,
       validationPreference
     }
@@ -10181,7 +11157,7 @@ const WalletForm = ({
     resolver: validationResolver(walletSchema)
   });
   useBlackboxDetection({
-    onError: () => {
+    onError: useCallback(() => {
       setCodedErrors(errors => {
         const blackBoxError = {
           errorCode: "unspecified",
@@ -10191,8 +11167,8 @@ const WalletForm = ({
         };
         return [...(errors !== null && errors !== void 0 ? errors : []), blackBoxError];
       });
-    },
-    onSuccess: bb => form.setValue("iovationBlackbox", bb)
+    }, [setCodedErrors]),
+    onSuccess: useCallback(bb => form.setValue("iovationBlackbox", bb), [form.setValue])
   });
   const watchAddress = form.watch("address");
   const handleSubmit = form.handleSubmit(values => __awaiter(void 0, void 0, void 0, function* () {
@@ -10588,6 +11564,25 @@ const WalletCard = ({
   }));
 };
 
+/**
+ * # Payment Method Settings Component
+ *
+ * - The `<PaymentMethodSettings />` component is used to manage the users payment information
+ * and is composed in the `<AccountSettings />` component. For example, users can update their
+ * billing information.
+ *
+ * @returns Elements A React element that renders the `<PaymentMethodSettings />` component
+ * allowing uses to configure their payment settings.
+ *
+ * @example
+ * ```tsx
+ * <PaymentMethodSettings />
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link AccountSettings.Element | The `<AccountSettings />` component renders the `<PaymentMethodSettings />` component}
+ */
 const PaymentMethodSettings = () => {
   var _a;
   const {
@@ -10670,6 +11665,14 @@ const styles$f = createStyles({
   }
 });
 
+/**
+ * @internal
+ *
+ * # Powered By ShipEngine Component
+ *
+ * - The `<PoweredByShipEngine />` composition component is used to render the
+ * "Powered By ShipEngine" logo throughout the various elements.
+ */
 const PoweredByShipEngine = () => {
   const {
     t
@@ -10685,6 +11688,11 @@ const PoweredByShipEngine = () => {
   }));
 };
 
+/**
+ * @namespace UnitSettings
+ *
+ * # Unit Settings Component
+ */
 const UnitSettings = () => {
   const {
     t
@@ -11641,7 +12649,9 @@ const CustomsItemForm = ({
   const {
     t
   } = useTranslation();
-  const countryCodeOptions = useCountryCodeOptions();
+  const {
+    countryCodeOptions
+  } = useCountryCodeOptions();
   const form = useForm({
     defaultValues: customsItem ? {
       countryOfOrigin: customsItem.countryOfOrigin,
@@ -11747,6 +12757,10 @@ const CustomsItemForm = ({
 };
 
 /**
+ * @internal
+ *
+ * # Copy Button
+ *
  * A copy button that copies the content to the users' clipboard and displays a
  * checkmark on click.
  */
@@ -12319,12 +13333,15 @@ const WarehouseForm = ({
   submitButtonTitle,
   warehouse
 }) => {
+  var _a, _b;
   const {
     t
   } = useTranslation(["common", "manage-warehouses"]);
   const {
-    validateAddress
+    validateAddress,
+    userInput
   } = useAddressPreference();
+  const hasDefaultValues = !!warehouse || !!userInput;
   const form = useForm({
     defaultValues: warehouse ? Object.assign(Object.assign({}, warehouse), {
       isDefault: warehouse.isDefault,
@@ -12335,6 +13352,14 @@ const WarehouseForm = ({
         countryCode: warehouse.returnAddress.countryCode
       }),
       returnToAddressIsDifferent: !isEqual(warehouse.originAddress, warehouse.returnAddress)
+    }) : userInput ? Object.assign(Object.assign({}, userInput), {
+      originAddress: Object.assign(Object.assign({}, userInput.originAddress), {
+        countryCode: userInput.originAddress.countryCode
+      }),
+      returnAddress: Object.assign(Object.assign({}, userInput.returnAddress), {
+        countryCode: (_a = userInput.returnAddress) === null || _a === void 0 ? void 0 : _a.countryCode
+      }),
+      returnToAddressIsDifferent: (_b = !!userInput.returnAddress) !== null && _b !== void 0 ? _b : false
     }) : {
       isDefault: _isOnboarding ? true : false,
       originAddress: {
@@ -12345,8 +13370,8 @@ const WarehouseForm = ({
     resolver: validationResolver(warehouseSchema)
   });
   const handleSubmit = form.handleSubmit(values => __awaiter(void 0, void 0, void 0, function* () {
-    const _a = values,
-      payload = __rest(_a, ["returnToAddressIsDifferent"]);
+    const _c = values,
+      payload = __rest(_c, ["returnToAddressIsDifferent"]);
     yield validateAddress({
       addresses: payload,
       data: {
@@ -12375,12 +13400,6 @@ const WarehouseForm = ({
       form: form,
       formatFieldName: fieldName => `originAddress.${fieldName}`,
       optionalFields: ["addressLine2"]
-    }), jsx(CheckboxInput, {
-      checkboxLabel: t("manage-warehouses:residentialAddress"),
-      control: form.control,
-      form: "warehouse-form",
-      label: "originAddress.addressResidentialIndicator",
-      name: "originAddress.addressResidentialIndicator"
     }), !_isOnboarding && jsx(CheckboxInput, {
       checkboxLabel: t("manage-warehouses:isDefault"),
       control: form.control,
@@ -12408,18 +13427,12 @@ const WarehouseForm = ({
           });
         }
       }
-    }), form.watch("returnToAddressIsDifferent") && jsxs(Fragment, {
-      children: [jsx(AddressFields, {
+    }), form.watch("returnToAddressIsDifferent") && jsx(Fragment, {
+      children: jsx(AddressFields, {
         form: form,
         formatFieldName: fieldName => `returnAddress.${fieldName}`,
         optionalFields: ["addressLine2"]
-      }), jsx(CheckboxInput, {
-        checkboxLabel: t("manage-warehouses:residentialAddress"),
-        control: form.control,
-        form: "warehouse-form",
-        label: "returnAddress.addressResidentialIndicator",
-        name: "returnAddress.addressResidentialIndicator"
-      })]
+      })
     }), jsxs(ButtonGroup, Object.assign({
       justify: "center"
     }, {
@@ -12444,7 +13457,7 @@ const WarehouseForm = ({
           control: form.control,
           "data-testid": "warehouseFormSubmitButton",
           form: "warehouse-form",
-          requireDirty: !warehouse,
+          requireDirty: !hasDefaultValues,
           variant: _isOnboarding ? ButtonVariant.FILLED : ButtonVariant.OUTLINED
         }, {
           children: submitButtonTitle
@@ -13043,6 +14056,15 @@ const Onboarding = ({
 let _ = t => t,
   _t,
   _t2;
+/**
+ * @internal
+ *
+ * # Cube Component
+ *
+ * - This is a spinning cube that is used to display a loading state.
+ *
+ * @see {@link CubePropTypes | The props that are passed into the `<Cube />` component}
+ */
 const Cube = _a => {
   var {
       animate = false
@@ -13070,7 +14092,7 @@ const Cube = _a => {
   const styles = {
     bounce: /*#__PURE__*/css(Object.assign({}, animate && {
       animation: `${bounce} 1s infinite`
-    }), process.env.NODE_ENV === "production" ? "" : ";label:bounce;", process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImN1YmUudHN4Il0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQXlCZ0IiLCJmaWxlIjoiY3ViZS50c3giLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBfX3Jlc3QgfSBmcm9tIFwidHNsaWJcIjtcclxuaW1wb3J0IHsganN4IGFzIF9qc3ggfSBmcm9tIFwiQGVtb3Rpb24vcmVhY3QvanN4LXJ1bnRpbWVcIjtcclxuaW1wb3J0IHsgY3NzLCBrZXlmcmFtZXMsIHVzZVRoZW1lIH0gZnJvbSBcIkBlbW90aW9uL3JlYWN0XCI7XHJcbmV4cG9ydCBjb25zdCBDdWJlID0gKF9hKSA9PiB7XHJcbiAgICB2YXIgeyBhbmltYXRlID0gZmFsc2UgfSA9IF9hLCBwcm9wcyA9IF9fcmVzdChfYSwgW1wiYW5pbWF0ZVwiXSk7XHJcbiAgICBjb25zdCB0aGVtZSA9IHVzZVRoZW1lKCk7XHJcbiAgICBjb25zdCBib3VuY2UgPSBrZXlmcmFtZXMgYFxuICAgIDAlLCAxMDAlIHtcbiAgICAgIHRyYW5zZm9ybTogdHJhbnNsYXRlWSgtMjUlKTtcbiAgICAgIGFuaW1hdGlvbi10aW1pbmctZnVuY3Rpb246IGN1YmljLWJlemllcigwLjgsIDAsIDEsIDEpO1xuICAgIH1cbiAgICA1MCUge1xuICAgICAgdHJhbnNmb3JtOiB0cmFuc2xhdGVZKDApO1xuICAgICAgYW5pbWF0aW9uLXRpbWluZy1mdW5jdGlvbjogY3ViaWMtYmV6aWVyKDAsIDAsIDAuMiwgMSk7XG4gICAgfVxuICBgO1xyXG4gICAgY29uc3Qgc3BpbiA9IGtleWZyYW1lcyBgXG4gICAgZnJvbSB7XG4gICAgICB0cmFuc2Zvcm06IHJvdGF0ZSgwZGVnKTtcbiAgICB9XG4gICAgdG8ge1xuICAgICAgdHJhbnNmb3JtOiByb3RhdGUoMzYwZGVnKTtcbiAgICB9XG4gIGA7XHJcbiAgICBjb25zdCBzdHlsZXMgPSB7XHJcbiAgICAgICAgYm91bmNlOiBjc3MoT2JqZWN0LmFzc2lnbih7fSwgKGFuaW1hdGUgJiYgeyBhbmltYXRpb246IGAke2JvdW5jZX0gMXMgaW5maW5pdGVgIH0pKSksXHJcbiAgICAgICAgY29udGVudDogY3NzKE9iamVjdC5hc3NpZ24oeyBjbGlwUnVsZTogXCJldmVub2RkXCIsIGZpbGxSdWxlOiBcImV2ZW5vZGRcIiwgaGVpZ2h0OiBcIjVyZW1cIiwgc3Ryb2tlTGluZUpvaW46IFwicm91bmRcIiwgc3Ryb2tlTWl0ZXJMaW1pdDogXCIyXCIsIHdpZHRoOiBcIjVyZW1cIiB9LCAoYW5pbWF0ZSAmJiB7IGFuaW1hdGlvbjogYCR7c3Bpbn0gMXMgbGluZWFyIGluZmluaXRlO2AgfSkpKSxcclxuICAgIH07XHJcbiAgICByZXR1cm4gKF9qc3goXCJkaXZcIiwgT2JqZWN0LmFzc2lnbih7IGNzczogc3R5bGVzLmJvdW5jZSB9LCBwcm9wcywgeyByb2xlOiBcInN0YXR1c1wiIH0sIHsgY2hpbGRyZW46IF9qc3goXCJzdmdcIiwgT2JqZWN0LmFzc2lnbih7IGNzczogc3R5bGVzLmNvbnRlbnQsIGhlaWdodDogXCIxMDAlXCIsIHZpZXdCb3g6IFwiMCAwIDQ4OSA0ODlcIiwgd2lkdGg6IFwiMTAwJVwiIH0sIHsgY2hpbGRyZW46IF9qc3goXCJnXCIsIHsgY2hpbGRyZW46IF9qc3goXCJnXCIsIHsgY2hpbGRyZW46IF9qc3goXCJwYXRoXCIsIHsgZDogXCJNNDgzLjY3NCwxMDEuODM2QzQ4My42MSwxMDEuNjA0IDQ4My41MDYsMTAxLjM5NiA0ODMuNDE4LDEwMS4xOEM0ODMuMjQyLDEwMC43MjQgNDgzLjA1LDEwMC4yODQgNDgyLjc5NCw5OS44NjhDNDgyLjY1LDk5LjYzNiA0ODIuNDk4LDk5LjQyOCA0ODIuMzMsOTkuMjEyQzQ4Mi4wNTgsOTguODQ0IDQ4MS43NTQsOTguNTA4IDQ4MS40MSw5OC4xOTZDNDgxLjIxLDk4LjAwNCA0ODEuMDEsOTcuODI4IDQ4MC43ODYsOTcuNjZDNDgwLjY1OCw5Ny41NjQgNDgwLjU2Miw5Ny40NDQgNDgwLjQzNCw5Ny4zNTZDNDgwLjEzOCw5Ny4xNTYgNDc5LjgxLDk3LjA0NCA0NzkuNDk4LDk2Ljg4NEM0NzkuMzM4LDk2LjgwNCA0NzkuMjE4LDk2LjY4NCA0NzkuMDUsOTYuNjEyTDI0Ny4wNSwwLjYxMkMyNDUuMDgyLC0wLjIwNCAyNDIuODksLTAuMjA0IDI0MC45MjIsMC42MTJMOC45MjIsOTYuNjEyQzguNzU0LDk2LjY4NCA4LjYyNiw5Ni44MDQgOC40NjYsOTYuODg0QzguMTU0LDk3LjAzNiA3LjgzNCw5Ny4xNTYgNy41NDYsOTcuMzQ4QzcuNDE4LDk3LjQzNiA3LjMyMiw5Ny41NTYgNy4xOTQsOTcuNjUyQzYuOTcsOTcuODIgNi43NzgsOTguMDA0IDYuNTc4LDk4LjE4OEM2LjI0Miw5OC41IDUuOTM4LDk4LjgzNiA1LjY1OCw5OS4yMDRDNS40OSw5OS40MiA1LjMzOCw5OS42MjggNS4xOTQsOTkuODZDNC45MzgsMTAwLjI3NiA0Ljc0NiwxMDAuNzE2IDQuNTcsMTAxLjE3MkM0LjQ4MiwxMDEuMzk2IDQuMzc4LDEwMS41OTYgNC4zMTQsMTAxLjgyOEM0LjEzLDEwMi41MzIgNC4wMDIsMTAzLjI2IDQuMDAyLDEwNC4wMDRMNC4wMDIsMzg0LjAwNEM0LjAwMiwzODcuMjQ0IDUuOTU0LDM5MC4xNjQgOC45MzgsMzkxLjM5NkwyNDAuOTM4LDQ4Ny4zOTZDMjQxLjA0Miw0ODcuNDM2IDI0MS4xNTQsNDg3LjQyIDI0MS4yNTgsNDg3LjQ2QzI0Mi4xNDYsNDg3Ljc4OCAyNDMuMDU4LDQ4OC4wMDQgMjQ0LjAwMiw0ODguMDA0QzI0NC45NDYsNDg4LjAwNCAyNDUuODU4LDQ4Ny43ODggMjQ2Ljc0Niw0ODcuNDZDMjQ2Ljg1LDQ4Ny40MiAyNDYuOTYyLDQ4Ny40MzYgMjQ3LjA2Niw0ODcuMzk2TDQ3OS4wNjYsMzkxLjM5NkM0ODIuMDUsMzkwLjE2NCA0ODQuMDAyLDM4Ny4yNDQgNDg0LjAwMiwzODQuMDA0TDQ4NC4wMDIsMTA0LjAwNEM0ODQuMDAyLDEwMy4yNiA0ODMuODc0LDEwMi41MzIgNDgzLjY3NCwxMDEuODM2Wk0yMzYuMDAyLDQ2OC4wMjhMMjAuMDAyLDM3OC42NkwyMC4wMDIsMTE1Ljk3MkwyMzYuMDAyLDIwNS4zNDhMMjM2LjAwMiw0NjguMDI4Wk0yNDQuMDAyLDE5MS4zNDhMMzIuOTIyLDEwNC4wMDRMMjQ0LjAwMiwxNi42Nkw0NTUuMDgyLDEwNC4wMDRMMjQ0LjAwMiwxOTEuMzQ4Wk00NjguMDAyLDM3OC42NkwyNTIuMDAyLDQ2OC4wMzZMMjUyLjAwMiwyMDUuMzQ4TDQ2OC4wMDIsMTE1Ljk3Mkw0NjguMDAyLDM3OC42NlpcIiwgZmlsbDogdGhlbWUucGFsZXR0ZS5wcmltYXJ5Lm1haW4gfSkgfSkgfSkgfSkpIH0pKSk7XHJcbn07XHJcbi8vIyBzb3VyY2VNYXBwaW5nVVJMPWN1YmUuanMubWFwIl19 */"),
+    }), process.env.NODE_ENV === "production" ? "" : ";label:bounce;", process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImN1YmUudHN4Il0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWtDZ0IiLCJmaWxlIjoiY3ViZS50c3giLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBfX3Jlc3QgfSBmcm9tIFwidHNsaWJcIjtcclxuaW1wb3J0IHsganN4IGFzIF9qc3ggfSBmcm9tIFwiQGVtb3Rpb24vcmVhY3QvanN4LXJ1bnRpbWVcIjtcclxuaW1wb3J0IHsgY3NzLCBrZXlmcmFtZXMsIHVzZVRoZW1lIH0gZnJvbSBcIkBlbW90aW9uL3JlYWN0XCI7XHJcbi8qKlxyXG4gKiBAaW50ZXJuYWxcclxuICpcclxuICogIyBDdWJlIENvbXBvbmVudFxyXG4gKlxyXG4gKiAtIFRoaXMgaXMgYSBzcGlubmluZyBjdWJlIHRoYXQgaXMgdXNlZCB0byBkaXNwbGF5IGEgbG9hZGluZyBzdGF0ZS5cclxuICpcclxuICogQHNlZSB7QGxpbmsgQ3ViZVByb3BUeXBlcyB8IFRoZSBwcm9wcyB0aGF0IGFyZSBwYXNzZWQgaW50byB0aGUgYDxDdWJlIC8+YCBjb21wb25lbnR9XHJcbiAqL1xyXG5leHBvcnQgY29uc3QgQ3ViZSA9IChfYSkgPT4ge1xyXG4gICAgdmFyIHsgYW5pbWF0ZSA9IGZhbHNlIH0gPSBfYSwgcHJvcHMgPSBfX3Jlc3QoX2EsIFtcImFuaW1hdGVcIl0pO1xyXG4gICAgY29uc3QgdGhlbWUgPSB1c2VUaGVtZSgpO1xyXG4gICAgY29uc3QgYm91bmNlID0ga2V5ZnJhbWVzIGBcbiAgICAwJSwgMTAwJSB7XG4gICAgICB0cmFuc2Zvcm06IHRyYW5zbGF0ZVkoLTI1JSk7XG4gICAgICBhbmltYXRpb24tdGltaW5nLWZ1bmN0aW9uOiBjdWJpYy1iZXppZXIoMC44LCAwLCAxLCAxKTtcbiAgICB9XG4gICAgNTAlIHtcbiAgICAgIHRyYW5zZm9ybTogdHJhbnNsYXRlWSgwKTtcbiAgICAgIGFuaW1hdGlvbi10aW1pbmctZnVuY3Rpb246IGN1YmljLWJlemllcigwLCAwLCAwLjIsIDEpO1xuICAgIH1cbiAgYDtcclxuICAgIGNvbnN0IHNwaW4gPSBrZXlmcmFtZXMgYFxuICAgIGZyb20ge1xuICAgICAgdHJhbnNmb3JtOiByb3RhdGUoMGRlZyk7XG4gICAgfVxuICAgIHRvIHtcbiAgICAgIHRyYW5zZm9ybTogcm90YXRlKDM2MGRlZyk7XG4gICAgfVxuICBgO1xyXG4gICAgY29uc3Qgc3R5bGVzID0ge1xyXG4gICAgICAgIGJvdW5jZTogY3NzKE9iamVjdC5hc3NpZ24oe30sIChhbmltYXRlICYmIHsgYW5pbWF0aW9uOiBgJHtib3VuY2V9IDFzIGluZmluaXRlYCB9KSkpLFxyXG4gICAgICAgIGNvbnRlbnQ6IGNzcyhPYmplY3QuYXNzaWduKHsgY2xpcFJ1bGU6IFwiZXZlbm9kZFwiLCBmaWxsUnVsZTogXCJldmVub2RkXCIsIGhlaWdodDogXCI1cmVtXCIsIHN0cm9rZUxpbmVKb2luOiBcInJvdW5kXCIsIHN0cm9rZU1pdGVyTGltaXQ6IFwiMlwiLCB3aWR0aDogXCI1cmVtXCIgfSwgKGFuaW1hdGUgJiYgeyBhbmltYXRpb246IGAke3NwaW59IDFzIGxpbmVhciBpbmZpbml0ZTtgIH0pKSksXHJcbiAgICB9O1xyXG4gICAgcmV0dXJuIChfanN4KFwiZGl2XCIsIE9iamVjdC5hc3NpZ24oeyBjc3M6IHN0eWxlcy5ib3VuY2UgfSwgcHJvcHMsIHsgcm9sZTogXCJzdGF0dXNcIiB9LCB7IGNoaWxkcmVuOiBfanN4KFwic3ZnXCIsIE9iamVjdC5hc3NpZ24oeyBjc3M6IHN0eWxlcy5jb250ZW50LCBoZWlnaHQ6IFwiMTAwJVwiLCB2aWV3Qm94OiBcIjAgMCA0ODkgNDg5XCIsIHdpZHRoOiBcIjEwMCVcIiB9LCB7IGNoaWxkcmVuOiBfanN4KFwiZ1wiLCB7IGNoaWxkcmVuOiBfanN4KFwiZ1wiLCB7IGNoaWxkcmVuOiBfanN4KFwicGF0aFwiLCB7IGQ6IFwiTTQ4My42NzQsMTAxLjgzNkM0ODMuNjEsMTAxLjYwNCA0ODMuNTA2LDEwMS4zOTYgNDgzLjQxOCwxMDEuMThDNDgzLjI0MiwxMDAuNzI0IDQ4My4wNSwxMDAuMjg0IDQ4Mi43OTQsOTkuODY4QzQ4Mi42NSw5OS42MzYgNDgyLjQ5OCw5OS40MjggNDgyLjMzLDk5LjIxMkM0ODIuMDU4LDk4Ljg0NCA0ODEuNzU0LDk4LjUwOCA0ODEuNDEsOTguMTk2QzQ4MS4yMSw5OC4wMDQgNDgxLjAxLDk3LjgyOCA0ODAuNzg2LDk3LjY2QzQ4MC42NTgsOTcuNTY0IDQ4MC41NjIsOTcuNDQ0IDQ4MC40MzQsOTcuMzU2QzQ4MC4xMzgsOTcuMTU2IDQ3OS44MSw5Ny4wNDQgNDc5LjQ5OCw5Ni44ODRDNDc5LjMzOCw5Ni44MDQgNDc5LjIxOCw5Ni42ODQgNDc5LjA1LDk2LjYxMkwyNDcuMDUsMC42MTJDMjQ1LjA4MiwtMC4yMDQgMjQyLjg5LC0wLjIwNCAyNDAuOTIyLDAuNjEyTDguOTIyLDk2LjYxMkM4Ljc1NCw5Ni42ODQgOC42MjYsOTYuODA0IDguNDY2LDk2Ljg4NEM4LjE1NCw5Ny4wMzYgNy44MzQsOTcuMTU2IDcuNTQ2LDk3LjM0OEM3LjQxOCw5Ny40MzYgNy4zMjIsOTcuNTU2IDcuMTk0LDk3LjY1MkM2Ljk3LDk3LjgyIDYuNzc4LDk4LjAwNCA2LjU3OCw5OC4xODhDNi4yNDIsOTguNSA1LjkzOCw5OC44MzYgNS42NTgsOTkuMjA0QzUuNDksOTkuNDIgNS4zMzgsOTkuNjI4IDUuMTk0LDk5Ljg2QzQuOTM4LDEwMC4yNzYgNC43NDYsMTAwLjcxNiA0LjU3LDEwMS4xNzJDNC40ODIsMTAxLjM5NiA0LjM3OCwxMDEuNTk2IDQuMzE0LDEwMS44MjhDNC4xMywxMDIuNTMyIDQuMDAyLDEwMy4yNiA0LjAwMiwxMDQuMDA0TDQuMDAyLDM4NC4wMDRDNC4wMDIsMzg3LjI0NCA1Ljk1NCwzOTAuMTY0IDguOTM4LDM5MS4zOTZMMjQwLjkzOCw0ODcuMzk2QzI0MS4wNDIsNDg3LjQzNiAyNDEuMTU0LDQ4Ny40MiAyNDEuMjU4LDQ4Ny40NkMyNDIuMTQ2LDQ4Ny43ODggMjQzLjA1OCw0ODguMDA0IDI0NC4wMDIsNDg4LjAwNEMyNDQuOTQ2LDQ4OC4wMDQgMjQ1Ljg1OCw0ODcuNzg4IDI0Ni43NDYsNDg3LjQ2QzI0Ni44NSw0ODcuNDIgMjQ2Ljk2Miw0ODcuNDM2IDI0Ny4wNjYsNDg3LjM5Nkw0NzkuMDY2LDM5MS4zOTZDNDgyLjA1LDM5MC4xNjQgNDg0LjAwMiwzODcuMjQ0IDQ4NC4wMDIsMzg0LjAwNEw0ODQuMDAyLDEwNC4wMDRDNDg0LjAwMiwxMDMuMjYgNDgzLjg3NCwxMDIuNTMyIDQ4My42NzQsMTAxLjgzNlpNMjM2LjAwMiw0NjguMDI4TDIwLjAwMiwzNzguNjZMMjAuMDAyLDExNS45NzJMMjM2LjAwMiwyMDUuMzQ4TDIzNi4wMDIsNDY4LjAyOFpNMjQ0LjAwMiwxOTEuMzQ4TDMyLjkyMiwxMDQuMDA0TDI0NC4wMDIsMTYuNjZMNDU1LjA4MiwxMDQuMDA0TDI0NC4wMDIsMTkxLjM0OFpNNDY4LjAwMiwzNzguNjZMMjUyLjAwMiw0NjguMDM2TDI1Mi4wMDIsMjA1LjM0OEw0NjguMDAyLDExNS45NzJMNDY4LjAwMiwzNzguNjZaXCIsIGZpbGw6IHRoZW1lLnBhbGV0dGUucHJpbWFyeS5tYWluIH0pIH0pIH0pIH0pKSB9KSkpO1xyXG59O1xyXG4vLyMgc291cmNlTWFwcGluZ1VSTD1jdWJlLmpzLm1hcCJdfQ== */"),
     content: /*#__PURE__*/css(Object.assign({
       clipRule: "evenodd",
       fillRule: "evenodd",
@@ -13080,7 +14102,7 @@ const Cube = _a => {
       width: "5rem"
     }, animate && {
       animation: `${spin} 1s linear infinite;`
-    }), process.env.NODE_ENV === "production" ? "" : ";label:content;", process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImN1YmUudHN4Il0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQTBCaUIiLCJmaWxlIjoiY3ViZS50c3giLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBfX3Jlc3QgfSBmcm9tIFwidHNsaWJcIjtcclxuaW1wb3J0IHsganN4IGFzIF9qc3ggfSBmcm9tIFwiQGVtb3Rpb24vcmVhY3QvanN4LXJ1bnRpbWVcIjtcclxuaW1wb3J0IHsgY3NzLCBrZXlmcmFtZXMsIHVzZVRoZW1lIH0gZnJvbSBcIkBlbW90aW9uL3JlYWN0XCI7XHJcbmV4cG9ydCBjb25zdCBDdWJlID0gKF9hKSA9PiB7XHJcbiAgICB2YXIgeyBhbmltYXRlID0gZmFsc2UgfSA9IF9hLCBwcm9wcyA9IF9fcmVzdChfYSwgW1wiYW5pbWF0ZVwiXSk7XHJcbiAgICBjb25zdCB0aGVtZSA9IHVzZVRoZW1lKCk7XHJcbiAgICBjb25zdCBib3VuY2UgPSBrZXlmcmFtZXMgYFxuICAgIDAlLCAxMDAlIHtcbiAgICAgIHRyYW5zZm9ybTogdHJhbnNsYXRlWSgtMjUlKTtcbiAgICAgIGFuaW1hdGlvbi10aW1pbmctZnVuY3Rpb246IGN1YmljLWJlemllcigwLjgsIDAsIDEsIDEpO1xuICAgIH1cbiAgICA1MCUge1xuICAgICAgdHJhbnNmb3JtOiB0cmFuc2xhdGVZKDApO1xuICAgICAgYW5pbWF0aW9uLXRpbWluZy1mdW5jdGlvbjogY3ViaWMtYmV6aWVyKDAsIDAsIDAuMiwgMSk7XG4gICAgfVxuICBgO1xyXG4gICAgY29uc3Qgc3BpbiA9IGtleWZyYW1lcyBgXG4gICAgZnJvbSB7XG4gICAgICB0cmFuc2Zvcm06IHJvdGF0ZSgwZGVnKTtcbiAgICB9XG4gICAgdG8ge1xuICAgICAgdHJhbnNmb3JtOiByb3RhdGUoMzYwZGVnKTtcbiAgICB9XG4gIGA7XHJcbiAgICBjb25zdCBzdHlsZXMgPSB7XHJcbiAgICAgICAgYm91bmNlOiBjc3MoT2JqZWN0LmFzc2lnbih7fSwgKGFuaW1hdGUgJiYgeyBhbmltYXRpb246IGAke2JvdW5jZX0gMXMgaW5maW5pdGVgIH0pKSksXHJcbiAgICAgICAgY29udGVudDogY3NzKE9iamVjdC5hc3NpZ24oeyBjbGlwUnVsZTogXCJldmVub2RkXCIsIGZpbGxSdWxlOiBcImV2ZW5vZGRcIiwgaGVpZ2h0OiBcIjVyZW1cIiwgc3Ryb2tlTGluZUpvaW46IFwicm91bmRcIiwgc3Ryb2tlTWl0ZXJMaW1pdDogXCIyXCIsIHdpZHRoOiBcIjVyZW1cIiB9LCAoYW5pbWF0ZSAmJiB7IGFuaW1hdGlvbjogYCR7c3Bpbn0gMXMgbGluZWFyIGluZmluaXRlO2AgfSkpKSxcclxuICAgIH07XHJcbiAgICByZXR1cm4gKF9qc3goXCJkaXZcIiwgT2JqZWN0LmFzc2lnbih7IGNzczogc3R5bGVzLmJvdW5jZSB9LCBwcm9wcywgeyByb2xlOiBcInN0YXR1c1wiIH0sIHsgY2hpbGRyZW46IF9qc3goXCJzdmdcIiwgT2JqZWN0LmFzc2lnbih7IGNzczogc3R5bGVzLmNvbnRlbnQsIGhlaWdodDogXCIxMDAlXCIsIHZpZXdCb3g6IFwiMCAwIDQ4OSA0ODlcIiwgd2lkdGg6IFwiMTAwJVwiIH0sIHsgY2hpbGRyZW46IF9qc3goXCJnXCIsIHsgY2hpbGRyZW46IF9qc3goXCJnXCIsIHsgY2hpbGRyZW46IF9qc3goXCJwYXRoXCIsIHsgZDogXCJNNDgzLjY3NCwxMDEuODM2QzQ4My42MSwxMDEuNjA0IDQ4My41MDYsMTAxLjM5NiA0ODMuNDE4LDEwMS4xOEM0ODMuMjQyLDEwMC43MjQgNDgzLjA1LDEwMC4yODQgNDgyLjc5NCw5OS44NjhDNDgyLjY1LDk5LjYzNiA0ODIuNDk4LDk5LjQyOCA0ODIuMzMsOTkuMjEyQzQ4Mi4wNTgsOTguODQ0IDQ4MS43NTQsOTguNTA4IDQ4MS40MSw5OC4xOTZDNDgxLjIxLDk4LjAwNCA0ODEuMDEsOTcuODI4IDQ4MC43ODYsOTcuNjZDNDgwLjY1OCw5Ny41NjQgNDgwLjU2Miw5Ny40NDQgNDgwLjQzNCw5Ny4zNTZDNDgwLjEzOCw5Ny4xNTYgNDc5LjgxLDk3LjA0NCA0NzkuNDk4LDk2Ljg4NEM0NzkuMzM4LDk2LjgwNCA0NzkuMjE4LDk2LjY4NCA0NzkuMDUsOTYuNjEyTDI0Ny4wNSwwLjYxMkMyNDUuMDgyLC0wLjIwNCAyNDIuODksLTAuMjA0IDI0MC45MjIsMC42MTJMOC45MjIsOTYuNjEyQzguNzU0LDk2LjY4NCA4LjYyNiw5Ni44MDQgOC40NjYsOTYuODg0QzguMTU0LDk3LjAzNiA3LjgzNCw5Ny4xNTYgNy41NDYsOTcuMzQ4QzcuNDE4LDk3LjQzNiA3LjMyMiw5Ny41NTYgNy4xOTQsOTcuNjUyQzYuOTcsOTcuODIgNi43NzgsOTguMDA0IDYuNTc4LDk4LjE4OEM2LjI0Miw5OC41IDUuOTM4LDk4LjgzNiA1LjY1OCw5OS4yMDRDNS40OSw5OS40MiA1LjMzOCw5OS42MjggNS4xOTQsOTkuODZDNC45MzgsMTAwLjI3NiA0Ljc0NiwxMDAuNzE2IDQuNTcsMTAxLjE3MkM0LjQ4MiwxMDEuMzk2IDQuMzc4LDEwMS41OTYgNC4zMTQsMTAxLjgyOEM0LjEzLDEwMi41MzIgNC4wMDIsMTAzLjI2IDQuMDAyLDEwNC4wMDRMNC4wMDIsMzg0LjAwNEM0LjAwMiwzODcuMjQ0IDUuOTU0LDM5MC4xNjQgOC45MzgsMzkxLjM5NkwyNDAuOTM4LDQ4Ny4zOTZDMjQxLjA0Miw0ODcuNDM2IDI0MS4xNTQsNDg3LjQyIDI0MS4yNTgsNDg3LjQ2QzI0Mi4xNDYsNDg3Ljc4OCAyNDMuMDU4LDQ4OC4wMDQgMjQ0LjAwMiw0ODguMDA0QzI0NC45NDYsNDg4LjAwNCAyNDUuODU4LDQ4Ny43ODggMjQ2Ljc0Niw0ODcuNDZDMjQ2Ljg1LDQ4Ny40MiAyNDYuOTYyLDQ4Ny40MzYgMjQ3LjA2Niw0ODcuMzk2TDQ3OS4wNjYsMzkxLjM5NkM0ODIuMDUsMzkwLjE2NCA0ODQuMDAyLDM4Ny4yNDQgNDg0LjAwMiwzODQuMDA0TDQ4NC4wMDIsMTA0LjAwNEM0ODQuMDAyLDEwMy4yNiA0ODMuODc0LDEwMi41MzIgNDgzLjY3NCwxMDEuODM2Wk0yMzYuMDAyLDQ2OC4wMjhMMjAuMDAyLDM3OC42NkwyMC4wMDIsMTE1Ljk3MkwyMzYuMDAyLDIwNS4zNDhMMjM2LjAwMiw0NjguMDI4Wk0yNDQuMDAyLDE5MS4zNDhMMzIuOTIyLDEwNC4wMDRMMjQ0LjAwMiwxNi42Nkw0NTUuMDgyLDEwNC4wMDRMMjQ0LjAwMiwxOTEuMzQ4Wk00NjguMDAyLDM3OC42NkwyNTIuMDAyLDQ2OC4wMzZMMjUyLjAwMiwyMDUuMzQ4TDQ2OC4wMDIsMTE1Ljk3Mkw0NjguMDAyLDM3OC42NlpcIiwgZmlsbDogdGhlbWUucGFsZXR0ZS5wcmltYXJ5Lm1haW4gfSkgfSkgfSkgfSkpIH0pKSk7XHJcbn07XHJcbi8vIyBzb3VyY2VNYXBwaW5nVVJMPWN1YmUuanMubWFwIl19 */")
+    }), process.env.NODE_ENV === "production" ? "" : ";label:content;", process.env.NODE_ENV === "production" ? "" : "/*# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImN1YmUudHN4Il0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQW1DaUIiLCJmaWxlIjoiY3ViZS50c3giLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBfX3Jlc3QgfSBmcm9tIFwidHNsaWJcIjtcclxuaW1wb3J0IHsganN4IGFzIF9qc3ggfSBmcm9tIFwiQGVtb3Rpb24vcmVhY3QvanN4LXJ1bnRpbWVcIjtcclxuaW1wb3J0IHsgY3NzLCBrZXlmcmFtZXMsIHVzZVRoZW1lIH0gZnJvbSBcIkBlbW90aW9uL3JlYWN0XCI7XHJcbi8qKlxyXG4gKiBAaW50ZXJuYWxcclxuICpcclxuICogIyBDdWJlIENvbXBvbmVudFxyXG4gKlxyXG4gKiAtIFRoaXMgaXMgYSBzcGlubmluZyBjdWJlIHRoYXQgaXMgdXNlZCB0byBkaXNwbGF5IGEgbG9hZGluZyBzdGF0ZS5cclxuICpcclxuICogQHNlZSB7QGxpbmsgQ3ViZVByb3BUeXBlcyB8IFRoZSBwcm9wcyB0aGF0IGFyZSBwYXNzZWQgaW50byB0aGUgYDxDdWJlIC8+YCBjb21wb25lbnR9XHJcbiAqL1xyXG5leHBvcnQgY29uc3QgQ3ViZSA9IChfYSkgPT4ge1xyXG4gICAgdmFyIHsgYW5pbWF0ZSA9IGZhbHNlIH0gPSBfYSwgcHJvcHMgPSBfX3Jlc3QoX2EsIFtcImFuaW1hdGVcIl0pO1xyXG4gICAgY29uc3QgdGhlbWUgPSB1c2VUaGVtZSgpO1xyXG4gICAgY29uc3QgYm91bmNlID0ga2V5ZnJhbWVzIGBcbiAgICAwJSwgMTAwJSB7XG4gICAgICB0cmFuc2Zvcm06IHRyYW5zbGF0ZVkoLTI1JSk7XG4gICAgICBhbmltYXRpb24tdGltaW5nLWZ1bmN0aW9uOiBjdWJpYy1iZXppZXIoMC44LCAwLCAxLCAxKTtcbiAgICB9XG4gICAgNTAlIHtcbiAgICAgIHRyYW5zZm9ybTogdHJhbnNsYXRlWSgwKTtcbiAgICAgIGFuaW1hdGlvbi10aW1pbmctZnVuY3Rpb246IGN1YmljLWJlemllcigwLCAwLCAwLjIsIDEpO1xuICAgIH1cbiAgYDtcclxuICAgIGNvbnN0IHNwaW4gPSBrZXlmcmFtZXMgYFxuICAgIGZyb20ge1xuICAgICAgdHJhbnNmb3JtOiByb3RhdGUoMGRlZyk7XG4gICAgfVxuICAgIHRvIHtcbiAgICAgIHRyYW5zZm9ybTogcm90YXRlKDM2MGRlZyk7XG4gICAgfVxuICBgO1xyXG4gICAgY29uc3Qgc3R5bGVzID0ge1xyXG4gICAgICAgIGJvdW5jZTogY3NzKE9iamVjdC5hc3NpZ24oe30sIChhbmltYXRlICYmIHsgYW5pbWF0aW9uOiBgJHtib3VuY2V9IDFzIGluZmluaXRlYCB9KSkpLFxyXG4gICAgICAgIGNvbnRlbnQ6IGNzcyhPYmplY3QuYXNzaWduKHsgY2xpcFJ1bGU6IFwiZXZlbm9kZFwiLCBmaWxsUnVsZTogXCJldmVub2RkXCIsIGhlaWdodDogXCI1cmVtXCIsIHN0cm9rZUxpbmVKb2luOiBcInJvdW5kXCIsIHN0cm9rZU1pdGVyTGltaXQ6IFwiMlwiLCB3aWR0aDogXCI1cmVtXCIgfSwgKGFuaW1hdGUgJiYgeyBhbmltYXRpb246IGAke3NwaW59IDFzIGxpbmVhciBpbmZpbml0ZTtgIH0pKSksXHJcbiAgICB9O1xyXG4gICAgcmV0dXJuIChfanN4KFwiZGl2XCIsIE9iamVjdC5hc3NpZ24oeyBjc3M6IHN0eWxlcy5ib3VuY2UgfSwgcHJvcHMsIHsgcm9sZTogXCJzdGF0dXNcIiB9LCB7IGNoaWxkcmVuOiBfanN4KFwic3ZnXCIsIE9iamVjdC5hc3NpZ24oeyBjc3M6IHN0eWxlcy5jb250ZW50LCBoZWlnaHQ6IFwiMTAwJVwiLCB2aWV3Qm94OiBcIjAgMCA0ODkgNDg5XCIsIHdpZHRoOiBcIjEwMCVcIiB9LCB7IGNoaWxkcmVuOiBfanN4KFwiZ1wiLCB7IGNoaWxkcmVuOiBfanN4KFwiZ1wiLCB7IGNoaWxkcmVuOiBfanN4KFwicGF0aFwiLCB7IGQ6IFwiTTQ4My42NzQsMTAxLjgzNkM0ODMuNjEsMTAxLjYwNCA0ODMuNTA2LDEwMS4zOTYgNDgzLjQxOCwxMDEuMThDNDgzLjI0MiwxMDAuNzI0IDQ4My4wNSwxMDAuMjg0IDQ4Mi43OTQsOTkuODY4QzQ4Mi42NSw5OS42MzYgNDgyLjQ5OCw5OS40MjggNDgyLjMzLDk5LjIxMkM0ODIuMDU4LDk4Ljg0NCA0ODEuNzU0LDk4LjUwOCA0ODEuNDEsOTguMTk2QzQ4MS4yMSw5OC4wMDQgNDgxLjAxLDk3LjgyOCA0ODAuNzg2LDk3LjY2QzQ4MC42NTgsOTcuNTY0IDQ4MC41NjIsOTcuNDQ0IDQ4MC40MzQsOTcuMzU2QzQ4MC4xMzgsOTcuMTU2IDQ3OS44MSw5Ny4wNDQgNDc5LjQ5OCw5Ni44ODRDNDc5LjMzOCw5Ni44MDQgNDc5LjIxOCw5Ni42ODQgNDc5LjA1LDk2LjYxMkwyNDcuMDUsMC42MTJDMjQ1LjA4MiwtMC4yMDQgMjQyLjg5LC0wLjIwNCAyNDAuOTIyLDAuNjEyTDguOTIyLDk2LjYxMkM4Ljc1NCw5Ni42ODQgOC42MjYsOTYuODA0IDguNDY2LDk2Ljg4NEM4LjE1NCw5Ny4wMzYgNy44MzQsOTcuMTU2IDcuNTQ2LDk3LjM0OEM3LjQxOCw5Ny40MzYgNy4zMjIsOTcuNTU2IDcuMTk0LDk3LjY1MkM2Ljk3LDk3LjgyIDYuNzc4LDk4LjAwNCA2LjU3OCw5OC4xODhDNi4yNDIsOTguNSA1LjkzOCw5OC44MzYgNS42NTgsOTkuMjA0QzUuNDksOTkuNDIgNS4zMzgsOTkuNjI4IDUuMTk0LDk5Ljg2QzQuOTM4LDEwMC4yNzYgNC43NDYsMTAwLjcxNiA0LjU3LDEwMS4xNzJDNC40ODIsMTAxLjM5NiA0LjM3OCwxMDEuNTk2IDQuMzE0LDEwMS44MjhDNC4xMywxMDIuNTMyIDQuMDAyLDEwMy4yNiA0LjAwMiwxMDQuMDA0TDQuMDAyLDM4NC4wMDRDNC4wMDIsMzg3LjI0NCA1Ljk1NCwzOTAuMTY0IDguOTM4LDM5MS4zOTZMMjQwLjkzOCw0ODcuMzk2QzI0MS4wNDIsNDg3LjQzNiAyNDEuMTU0LDQ4Ny40MiAyNDEuMjU4LDQ4Ny40NkMyNDIuMTQ2LDQ4Ny43ODggMjQzLjA1OCw0ODguMDA0IDI0NC4wMDIsNDg4LjAwNEMyNDQuOTQ2LDQ4OC4wMDQgMjQ1Ljg1OCw0ODcuNzg4IDI0Ni43NDYsNDg3LjQ2QzI0Ni44NSw0ODcuNDIgMjQ2Ljk2Miw0ODcuNDM2IDI0Ny4wNjYsNDg3LjM5Nkw0NzkuMDY2LDM5MS4zOTZDNDgyLjA1LDM5MC4xNjQgNDg0LjAwMiwzODcuMjQ0IDQ4NC4wMDIsMzg0LjAwNEw0ODQuMDAyLDEwNC4wMDRDNDg0LjAwMiwxMDMuMjYgNDgzLjg3NCwxMDIuNTMyIDQ4My42NzQsMTAxLjgzNlpNMjM2LjAwMiw0NjguMDI4TDIwLjAwMiwzNzguNjZMMjAuMDAyLDExNS45NzJMMjM2LjAwMiwyMDUuMzQ4TDIzNi4wMDIsNDY4LjAyOFpNMjQ0LjAwMiwxOTEuMzQ4TDMyLjkyMiwxMDQuMDA0TDI0NC4wMDIsMTYuNjZMNDU1LjA4MiwxMDQuMDA0TDI0NC4wMDIsMTkxLjM0OFpNNDY4LjAwMiwzNzguNjZMMjUyLjAwMiw0NjguMDM2TDI1Mi4wMDIsMjA1LjM0OEw0NjguMDAyLDExNS45NzJMNDY4LjAwMiwzNzguNjZaXCIsIGZpbGw6IHRoZW1lLnBhbGV0dGUucHJpbWFyeS5tYWluIH0pIH0pIH0pIH0pKSB9KSkpO1xyXG59O1xyXG4vLyMgc291cmNlTWFwcGluZ1VSTD1jdWJlLmpzLm1hcCJdfQ== */")
   };
   return jsx("div", Object.assign({
     css: styles.bounce
@@ -13140,6 +14162,11 @@ const styles$5 = createStyles({
   })
 });
 
+/**
+ * @internal
+ *
+ * # Section Component
+ */
 const Section = _a => {
   var {
       bold,
@@ -13198,9 +14225,15 @@ const styles$4 = createStyles({
 });
 
 /**
+ * @internal
+ *
+ * # Fund And Purchase Component
+ *
  * Fund and Purchase handles the label purchase submission UX, ensuring that a user
  * has the necessary funds available and can add them if not. It allows a single button
  * to submit the funding form followed by the purchase form.
+ *
+ * @see {@link FundAndPurchaseProps | The props that are passed into the `<FundAndPurchase />` component}
  */
 const FundAndPurchase = ({
   balance: uspsBalance,
@@ -13429,7 +14462,7 @@ const RateForm = ({
   carriers,
   disabled,
   errors,
-  displayableErrors,
+  displayableRateErrors,
   displayableLabelErrors,
   features,
   labelErrors,
@@ -13443,7 +14476,7 @@ const RateForm = ({
   shipment,
   outOfBandDisplayableErrors
 }) => {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f;
   features = Object.assign({
     presentation: {
       poweredByShipEngine: false
@@ -13455,7 +14488,7 @@ const RateForm = ({
       saveRate: true
     }
   }, features !== null && features !== void 0 ? features : {});
-  const allDisplayableErrors = [...(displayableErrors !== null && displayableErrors !== void 0 ? displayableErrors : []), ...(outOfBandDisplayableErrors !== null && outOfBandDisplayableErrors !== void 0 ? outOfBandDisplayableErrors : [])];
+  const allDisplayableErrors = [...(displayableRateErrors !== null && displayableRateErrors !== void 0 ? displayableRateErrors : []), ...(outOfBandDisplayableErrors !== null && outOfBandDisplayableErrors !== void 0 ? outOfBandDisplayableErrors : [])];
   const {
     t
   } = useTranslation();
@@ -13490,7 +14523,7 @@ const RateForm = ({
       });
     }
   })));
-  const rateOptions = useRateOptions(rates, carriers, shipment, !!((_a = features === null || features === void 0 ? void 0 : features.rateForm) === null || _a === void 0 ? void 0 : _a.enableGlobalPostFiltering));
+  const rateOptions = useRateOptions(rates, carriers, shipment, !!((_a = features === null || features === void 0 ? void 0 : features.rateForm) === null || _a === void 0 ? void 0 : _a.enableGlobalPostFiltering), !!((_b = features === null || features === void 0 ? void 0 : features.rateForm) === null || _b === void 0 ? void 0 : _b.requireDhlTermsAcknowledgement));
   // Return true if User has multiple accounts for a single carrier.
   const hasDuplicateCarrierCode = carriers => {
     const uniqueCarrierCodes = new Set();
@@ -13566,7 +14599,7 @@ const RateForm = ({
           name: "rate",
           nicknameFeature:
           // if feature flag is on, and if account has duplicate carrierCodes, then show nickname
-          ((_b = features === null || features === void 0 ? void 0 : features.rateForm) === null || _b === void 0 ? void 0 : _b.nicknameRate) && carriers && hasDuplicateCarrierCode(carriers),
+          ((_c = features === null || features === void 0 ? void 0 : features.rateForm) === null || _c === void 0 ? void 0 : _c.nicknameRate) && carriers && hasDuplicateCarrierCode(carriers),
           onClick: onSelectRate,
           options: showHiddenRates ? rateOptions : filteredRateOptions
         }), rateOptions.some(option => option.requiresAcknowledgement) && rateOptions.length > 5 && jsx(Link, Object.assign({
@@ -13604,10 +14637,10 @@ const RateForm = ({
         type: NotificationType.ERROR
       }, {
         children: jsxs(Fragment, {
-          children: [displayableErrors, outOfBandDisplayableErrors, displayableLabelErrors]
+          children: [displayableRateErrors, outOfBandDisplayableErrors, displayableLabelErrors]
         })
       }))]
-    })), ((_c = features === null || features === void 0 ? void 0 : features.rateForm) === null || _c === void 0 ? void 0 : _c.labelLayout) && !labelsLoading && !(labels === null || labels === void 0 ? void 0 : labels.length) && jsx(Section, Object.assign({
+    })), ((_d = features === null || features === void 0 ? void 0 : features.rateForm) === null || _d === void 0 ? void 0 : _d.labelLayout) && !labelsLoading && !(labels === null || labels === void 0 ? void 0 : labels.length) && jsx(Section, Object.assign({
       title: t("manage-defaults:label.title")
     }, {
       children: jsx(LabelLayout, {
@@ -13619,12 +14652,12 @@ const RateForm = ({
       control: form.control,
       css: styles$3.fundAndPurchase,
       disabled: disabled,
-      isFundingEnabled: !!((_d = features === null || features === void 0 ? void 0 : features.rateForm) === null || _d === void 0 ? void 0 : _d.enableFunding),
+      isFundingEnabled: !!((_e = features === null || features === void 0 ? void 0 : features.rateForm) === null || _e === void 0 ? void 0 : _e.enableFunding),
       isFundingRequired: (selectedRate === null || selectedRate === void 0 ? void 0 : selectedRate.balance) !== undefined && !!selectedRate.requiresFundedAmount,
       onPurchase: handleSubmit,
       onSave: handleSaveRate,
       purchaseAmount: getTotalRateAmount(selectedRate)
-    }), ((_e = features === null || features === void 0 ? void 0 : features.presentation) === null || _e === void 0 ? void 0 : _e.poweredByShipEngine) && jsxs(Fragment, {
+    }), ((_f = features === null || features === void 0 ? void 0 : features.presentation) === null || _f === void 0 ? void 0 : _f.poweredByShipEngine) && jsxs(Fragment, {
       children: [jsx(Spacer, {}), jsx(PoweredByShipEngine, {})]
     })]
   }));
@@ -13696,6 +14729,11 @@ const ItemsBreakdownTableHeader = ({
     }))]
   })
 });
+/**
+ * @internal
+ *
+ * # Items Breakdown Component
+ */
 const ItemsBreakdown = ({
   items
 }) => {
@@ -14030,10 +15068,12 @@ const CustomsItemsDisplay = ({
 extendZod();
 const getShipmentSchema = ({
   allowInternationalShipFrom,
-  warehouses,
-  requireMeasurements: _requireMeasurements = false,
+  dimensionsUnit,
   isContentDescriptionRequired: _isContentDescriptionRequired = false,
-  isCustomsRequired: _isCustomsRequired = false
+  isCustomsRequired: _isCustomsRequired = false,
+  requireMeasurements: _requireMeasurements = false,
+  warehouses,
+  weightUnit
 } = {}) => {
   const baseSchema = z.object({
     advancedOptions: z.object({
@@ -14064,7 +15104,9 @@ const getShipmentSchema = ({
         height: z.number().nonnegative().nullishDefault(0),
         length: z.number().nonnegative().nullishDefault(0),
         width: z.number().nonnegative().nullishDefault(0)
-      }).nullish()).transform(dims => dims ? convertDimensions(dims) : undefined),
+      }).nullish()).transform(dims => dims ? convertDimensions(Object.assign(Object.assign({}, dims), {
+        unit: dimensionsUnit !== null && dimensionsUnit !== void 0 ? dimensionsUnit : "inch"
+      })) : undefined),
       insuredValue: moneySchema.extend({
         amount: z.number().positive()
       }).optional(),
@@ -14081,7 +15123,7 @@ const getShipmentSchema = ({
       }) => whole || fractional, "schemaErrors.required") : z.object({
         fractional: z.number().nonnegative().nullishDefault(0),
         whole: z.number().nonnegative().nullishDefault(0)
-      }).nullish()).transform(weight => weight ? convertWeight(weight) : undefined)
+      }).nullish()).transform(weight => weight ? convertWeight(weight, weightUnit) : undefined)
     }).array().min(1),
     service: z.object({
       carrierId: z.string().nullish(),
@@ -14108,7 +15150,9 @@ const getShipmentSchema = ({
         length,
         width,
         height
-      }) => [length, width, height].every(d => d === 0) || [length, width, height].every(d => d !== 0), "schemaErrors.group.allMeasurementsOrNone").nullish().transform(dims => !dims || Object.values(dims).every(d => d === 0) ? undefined : convertDimensions(dims))
+      }) => [length, width, height].every(d => d === 0) || [length, width, height].every(d => d !== 0), "schemaErrors.group.allMeasurementsOrNone").nullish().transform(dims => !dims || Object.values(dims).every(d => d === 0) ? undefined : convertDimensions(Object.assign(Object.assign({}, dims), {
+        unit: dimensionsUnit !== null && dimensionsUnit !== void 0 ? dimensionsUnit : "inch"
+      })))
     }).array().min(1),
     service: z.object({
       carrierId: z.string(),
@@ -14156,6 +15200,7 @@ const getShipmentSchema = ({
 const minimumShipDate = nextDayCutoff(17);
 const maximumShipDate = daysAfter(7, minimumShipDate);
 const ShipmentForm = ({
+  accountSettings,
   addressLoading,
   addressPreference,
   charsetWarning,
@@ -14196,14 +15241,22 @@ const ShipmentForm = ({
   const [insuranceEnabled, setInsuranceEnabled] = useState(false);
   const {
     isContentDescriptionRequired,
-    isCustomsRequired
+    isCustomsRequired,
+    hasAllZeroMeasurements
   } = useShipmentMetadata(shipment);
+  const packageDimensions = shipment === null || shipment === void 0 ? void 0 : shipment.packages[0].dimensions;
+  const packageWeight = shipment === null || shipment === void 0 ? void 0 : shipment.packages[0].weight;
+  // if package specs are all zeroes, assume it is a custom package and default to account settings units
+  const [dimensionsUnit, weightUnit] = useMemo(() => hasAllZeroMeasurements ? [accountSettings === null || accountSettings === void 0 ? void 0 : accountSettings.dimensionsUnit, accountSettings === null || accountSettings === void 0 ? void 0 : accountSettings.weightUnit] : [packageDimensions === null || packageDimensions === void 0 ? void 0 : packageDimensions.unit, packageWeight === null || packageWeight === void 0 ? void 0 : packageWeight.unit], [packageDimensions, packageWeight, hasAllZeroMeasurements, accountSettings]);
+  const hasMeasurementUnits = useMemo(() => !!dimensionsUnit && !!weightUnit, [dimensionsUnit, weightUnit]);
   const shipmentSchema = useMemo(() => getShipmentSchema({
+    dimensionsUnit,
     isContentDescriptionRequired,
     isCustomsRequired,
     requireMeasurements,
-    warehouses: warehouses !== null && warehouses !== void 0 ? warehouses : []
-  }), [isCustomsRequired, requireMeasurements, warehouses, isContentDescriptionRequired]);
+    warehouses: warehouses !== null && warehouses !== void 0 ? warehouses : [],
+    weightUnit
+  }), [isCustomsRequired, requireMeasurements, warehouses, isContentDescriptionRequired, weightUnit, dimensionsUnit]);
   const requestedServices = useMemo(() => getRequestedServices(salesOrder), [salesOrder]);
   const form = useForm({
     defaultValues: {
@@ -14254,10 +15307,10 @@ const ShipmentForm = ({
     const {
       whole,
       fractional
-    } = formatFractionalWeight(weight);
+    } = formatFractionalWeight(weight, weightUnit);
     form.setValue("packages.0.weight.whole", whole);
     form.setValue("packages.0.weight.fractional", fractional);
-  }, [form]);
+  }, [form, weightUnit]);
   const handleChangeMode = useCallback(nextMode => __awaiter(void 0, void 0, void 0, function* () {
     if (nextMode === "browse_rates") {
       // Browse Rates
@@ -14765,7 +15818,7 @@ const ShipmentForm = ({
         name: "packages.0.type",
         onCategoryChange: value => form.setValue("carrierId", value),
         options: packageOptions
-      }), requireMeasurements && jsxs(Fragment, {
+      }), hasMeasurementUnits && requireMeasurements ? jsxs(Fragment, {
         children: [jsxs(InputGroup, Object.assign({
           control: form.control,
           disabled: !!findCustomPackage(selectedPackage === null || selectedPackage === void 0 ? void 0 : selectedPackage.code),
@@ -14778,19 +15831,25 @@ const ShipmentForm = ({
             control: form.control,
             label: t("purchase-label:fields.dimensions.length"),
             name: "packages.0.dimensions.length",
-            placeholder: t("units.in")
+            placeholder: t(`units.${dimensionsUnit}`)
           }), jsx(NumberInput, {
             control: form.control,
             label: t("purchase-label:fields.dimensions.width"),
             name: "packages.0.dimensions.width",
-            placeholder: t("units.in")
+            placeholder: t(`units.${dimensionsUnit}`)
           }), jsx(NumberInput, {
             control: form.control,
             label: t("purchase-label:fields.dimensions.height"),
             name: "packages.0.dimensions.height",
-            placeholder: t("units.in")
+            placeholder: t(`units.${dimensionsUnit}`)
           })]
-        })), jsxs(InputGroup, Object.assign({
+        })), weightUnit && isMetricWeightUnit(weightUnit) ? jsx(NumberInput, {
+          control: form.control,
+          label: t("purchase-label:fields.weightGroup"),
+          name: "packages.0.weight.whole",
+          onBlur: handleBlurWeight,
+          placeholder: t(`units.${weightUnit}`)
+        }) : jsxs(InputGroup, Object.assign({
           control: form.control,
           label: t("purchase-label:fields.weightGroup"),
           name: "packages.0.weight",
@@ -14810,6 +15869,26 @@ const ShipmentForm = ({
             placeholder: t("units.oz")
           })]
         }))]
+      }) : jsxs(Fragment, {
+        children: [jsx(FieldLabel, Object.assign({
+          label: t("purchase-label:fields.dimensionsGroup")
+        }, {
+          children: jsx(Skeleton, {
+            animation: SkeletonAnimation.WAVE,
+            backgroundColor: SkeletonBackgroundColor.LIGHT,
+            height: 50,
+            variant: SkeletonVariant.TEXT
+          })
+        })), jsx(Spacer, {}), jsx(FieldLabel, Object.assign({
+          label: t("purchase-label:fields.weightGroup")
+        }, {
+          children: jsx(Skeleton, {
+            animation: SkeletonAnimation.WAVE,
+            backgroundColor: SkeletonBackgroundColor.LIGHT,
+            height: 50,
+            variant: SkeletonVariant.TEXT
+          })
+        })), jsx(Spacer, {})]
       }), isContentDescriptionRequired && jsx(TextInput, {
         control: form.control,
         hint: t("purchase-label:hints.contentDescription"),
@@ -14988,6 +16067,13 @@ const Shipment = ({
   const requestedServices = useMemo(() => getRequestedServices(salesOrder), [salesOrder]);
   const activeLabel = useMemo(() => labels === null || labels === void 0 ? void 0 : labels.find(l => l.status === "completed"), [labels]);
   const hasSalesOrder = useMemo(() => shipment.salesOrderIds.length > 0, [shipment.salesOrderIds.length]);
+  const formatWeight = weight => isMetricWeightUnit(weight.unit) ? t(`weight.${weight.unit}`, {
+    count: weight.value
+  }) : [pounds > 0 ? t("weight.pounds", {
+    count: pounds
+  }) : "", ounces > 0 ? t("weight.ounces", {
+    count: ounces
+  }) : ""].filter(msg => msg.length).join(" ");
   return jsxs(Fragment, {
     children: [jsxs(Section, Object.assign({
       "data-testid": "orderDetail"
@@ -15073,16 +16159,12 @@ const Shipment = ({
         "data-testid": "dimensions",
         label: t("view-shipment:fields.dimensions")
       }, {
-        children: [`${dimensions.height} x ${dimensions.width} x ${dimensions.length} ${dimensions.unit}`, jsx(Spacer, {})]
+        children: [`${formatDimensions(dimensions)} ` + t(`units.${dimensions.unit}`), jsx(Spacer, {})]
       })), jsx(FieldLabel, Object.assign({
         "data-testid": "weight",
         label: t("view-shipment:fields.weight")
       }, {
-        children: [pounds > 0 ? t("weight.pounds", {
-          count: pounds
-        }) : "", ounces > 0 ? t("weight.ounces", {
-          count: ounces
-        }) : ""].filter(unit => unit.length).join(" ")
+        children: formatWeight(weight)
       }))]
     })), jsxs(Section, Object.assign({
       rightContent: ((_a = features === null || features === void 0 ? void 0 : features.shipment) === null || _a === void 0 ? void 0 : _a.schedulePickup) && schedulePickupForCarrier(activeLabel === null || activeLabel === void 0 ? void 0 : activeLabel.carrierCode) ? jsx(Link, Object.assign({
@@ -15236,6 +16318,9 @@ const styles = createStyles({
   })
 });
 
+/**
+ * @internal
+ */
 const DateRangeSelect = ({
   fullWidth,
   onChange,
@@ -15269,6 +16354,13 @@ const DateRangeSelect = ({
   }));
 };
 
+/**
+ * @internal
+ *
+ * # Date Range Combo Component
+ *
+ * @see {@link DateRangeComboProps | This is the type of the props used in the `<DateRangeCombo />` component}
+ */
 const DateRangeCombo = ({
   children: renderChildren,
   onChange,
@@ -15313,9 +16405,13 @@ const DateRangeCombo = ({
 };
 
 /**
+ * @internal
+ *
+ * # Error Fallback Component
+ *
  * Fallback component for the Elements ErrorBoundary
  *
- * @see {@link registerElement}
+ * @see {@link ErrorFallbackProps | The props that are passed into the `<ErrorFallback />` component}
  */
 const ErrorFallback = ({
   error
@@ -15349,7 +16445,11 @@ const ErrorFallback = ({
 };
 
 /**
- * For relevant notes about Storybook stories
+ * @internal
+ *
+ * # Story Notes Component
+ *
+ * - For relevant notes about Storybook stories
  *
  * Stopgap until we setup https://storybook.js.org/addons/@storybook/addon-docs
  */
@@ -15634,12 +16734,17 @@ var common = {
 	weight: {
 		ounces: "{{count}} oz",
 		pounds_one: "{{count}} lb",
-		pounds_other: "{{count}} lbs"
+		pounds_other: "{{count}} lbs",
+		kilogram: "{{count}} kg",
+		gram: "{{count}} g"
 	},
 	units: {
-		"in": "in",
+		inch: "in",
 		lbs: "lbs",
-		oz: "oz"
+		oz: "oz",
+		centimeter: "cm",
+		gram: "g",
+		kilogram: "kg"
 	},
 	"VGhlIHNlbGVjdGVkIHNlcnZpY2UgaW5jbHVkZXMgaW5zdXJhbmNlIGZvciBhbiBpbnN1cmVkIGFtb3VudCB1cCB0byAkMTAwLgo=": "$100 insurance included",
 	"VGhlIHNlbGVjdGVkIHNlcnZpY2UgaW5jbHVkZXMgaW5zdXJhbmNlIGZvciBhbiBpbnN1cmVkIGFtb3VudCB1cCB0byAkNTAuCg==": "$50 insurance included",
@@ -15647,7 +16752,8 @@ var common = {
 	"QWRkcmVzcyBub3QgZm91bmQ=": "There was an issue validating your address. Please try again.",
 	QSBzaGlwcGluZyBjYXJyaWVyIGVycm9yIG9jY3VycmVkOiBVUFMgd2VpZ2h0IGxpbWl0IHBlciBwYWNrYWdlIGlzIDE1MCBsYnMu: "UPS weight limit per package is 150 lbs.",
 	UGxlYXNlIGFkZCBhIFN0YW1wcy5jb20gYWNjb3VudCB0byBTaGlwRW5naW5lIGluIG9yZGVyIHRvIGNyZWF0ZSBzaGlwcGluZyBsYWJlbHMu: "Finish setting up your ShipStation Carriers in the ShipStation app",
-	QSBzaGlwcGluZyBlcnJvciBvY2N1cnJlZDogTWlzc2luZyBvciBpbnZhbGlkIHNoaXBwZXIgbnVtYmVy: "Unable to Create Label: Missing or Invalid Shipper Number. Please contact our support team to reset the carrier connection for your account.",
+	QSBzaGlwcGluZyBlcnJvciBvY2N1cnJlZDogTWlzc2luZyBvciBpbnZhbGlkIHNoaXBwZXIgbnVtYmVy: "Unable to create label: Missing or Invalid Shipper Number. Please contact our support team to reset the carrier connection for your account.",
+	QSBzaGlwcGluZyBjYXJyaWVyIGVycm9yIG9jY3VycmVkOiBNaXNzaW5nIG9yIGludmFsaWQgc2hpcHBlciBuYW1l: "Unable to create label: The selected service requires a Company Name be added to your Ship From Location. Please contact our support team if you continue to experience issues.",
 	"QSBzaGlwcGluZyBjYXJyaWVyIGVycm9yIG9jY3VycmVkOiBNaXNzaW5nIG9yIGludmFsaWQgc2hpcCB0byBTdGF0ZVByb3ZpbmNlQ29kZQ==": "The State/Province Code Exceeds 5 Characters. Shorten the abbreviation or remove it, then try again.",
 	"QSBzaGlwcGluZyBjYXJyaWVyIGVycm9yIG9jY3VycmVkOiBJbnZhbGlkIHNvbGQgdG8gc3RhdGUgcHJvdmluY2UgY29kZS4gVmFsaWQgbGVuZ3RoIGlzIDAgdG8gNSBhbHBoYW51bWVyaWM=": "The State/Province Code Exceeds 5 Characters. Shorten the abbreviation or remove it, then try again."
 };
@@ -15903,7 +17009,8 @@ var purchaseLabel$1 = {
 	},
 	rates: {
 		uspsMediaMailAcknowledgement: "I confirm that this package is compliant with <1>USPS guidelines for Media Mail®</1>",
-		uspsFirstClassMailAcknowledgement_leof: "I understand the limitations and confirm that this package is compliant with USPS guidelines for First Class Mail Large Envelopes or Flats."
+		uspsFirstClassMailAcknowledgement_leof: "I understand the limitations and confirm that this package is compliant with USPS guidelines for First Class Mail Large Envelopes or Flats.",
+		dhlExpressTermsAcknowledgement: "To start shipping with DHL, you are confirming that you have agreed to the <1>terms and conditions</1>"
 	},
 	shipToAddressFormFields: "Ship To Address Form Fields",
 	sections: {
@@ -16053,6 +17160,31 @@ var walletHistory = {
 
 var en = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, accoutSettings), common$1), listCarriers), manageDefaults), manageFunding), manageWarehouses), manageDefaults), onboarding$2), paymentMethod), purchaseLabel$1), registerCarrier), registerWallet), viewShipment$1), voidLabel$1), walletHistory);
 
+/**
+ * # Account Settings Component
+ *
+ * - The `<AccountSettings />` component is used to display the user's account settings, as well as
+ * allowing them to make changes to various aspects of their account.
+ *
+ * @param onSaveSettings Any `void` function you wish to execute when the user saves any changes
+ * to their account settings.
+ *
+ * @returns Element An EmotionJSX.Element that will render the `<AccountSettings />` component
+ * with all the appropriate wrappers.
+ *
+ * @example
+ * You can see how the `<Component />` is used in the `createElement` function call below.
+ * ```tsx
+ * export const Element = alchemy.createElement(Component, ErrorFallback, {
+ *   css: { height: "100%", maxWidth: "800px", minWidth: "440px", width: "100%" },
+ *   resources: { en },
+ * });
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link AccountSettings.Element | The **Element** created to render `<AccountSettings />`}
+ */
 const Component$4 = ({
   onSaveSettings
 }) => {
@@ -16064,6 +17196,32 @@ const Component$4 = ({
     onSaveSettings: onSaveSettings
   });
 };
+/**
+ * # Registered Account Settings Element
+ *
+ * - This is the registered `<AccountSettings />` element that will be used to render the
+ * `<AccountSettings.Element />` component.
+ *
+ * @param ElementProps The props, callbacks, and resources necessary to render
+ * the `<AccountSettings.Element />` component.
+ *
+ * @example
+ * The `<Component />` is the source JSX that is rendered when you make use of the `AccountSettings`
+ * Element directly. Here is a brief example of how you would use it within your application.
+ * ```tsx
+ * <AccountSettings.Element
+ *   onSaveSettings={() => console.log('Settings Saved!')}
+ * />
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link AccountSettings.ComponentProps | The **props** that can be passed into the `<AccountSettings.Element />` component}
+ * @see {@link ListCarriers.Component | The `<List-Carriers />` component used to view connected carriers}
+ * @see {@link ManageWarehouses.Component | The `<ManageWarehouses />` component used to add, update, or remove warehouses}
+ * @see {@link PaymentMethodSettings | The `<PaymentMethodSettings />` component used to manage payment methods}
+ * @see {@link ManageFunding | The `<ManageFunding />` component used to manage funding rules and add funds to a carrier account}
+ */
 const Element$5 = alchemy.createElement(Component$4, ErrorFallback, {
   css: {
     height: "100%",
@@ -16082,6 +17240,39 @@ var accountSettings = /*#__PURE__*/Object.freeze({
 	Element: Element$5
 });
 
+/**
+ * # Onboarding Component
+ *
+ * - The `<Onboarding />` component is used to onboard a new user to the ShipEngine platform. This
+ * component will allow the user to create a warehouse, register a carrier, and create a funding
+ * source for their account. This is everything a user needs to begin fulfilling their shipments
+ * using the ShipEngine Platform.
+ *
+ * @param ComponentProps The base props that will be passed into the `<Onboarding />` component.
+ *
+ * @returns Element An EmotionJSX.Element that will render the `<Onboarding />` component
+ * with all the appropriate wrappers.
+ *
+ * @example
+ * You can see how the `<Component />` is used in the `createElement` function call below.
+ * ```tsx
+ * export const Element = alchemy.createElement(Component, ErrorFallback, {
+ *   css: {
+ *     height: "100%",
+ *     maxWidth: "800px",
+ *     minWidth: "440px",
+ *     overflow: "auto",
+ *     scrollbarGutter: "stable both-edges",
+ *     width: "100%",
+ *   },
+ *   resources: { en },
+ * });
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link Onboarding.Element | The **Element** created to render `<Onboarding />`}
+ */
 const Component$3 = ({
   features,
   onboardingAddress,
@@ -16150,6 +17341,28 @@ const Component$3 = ({
     warehouses: warehouses
   });
 };
+/**
+ * # Registered Onboarding Element
+ *
+ * - This is the registered `<Onboarding />` element that will be used to render the
+ * `<Onboarding.Element />` component.
+ *
+ * @param ElementProps The props, callbacks, and resources necessary to render
+ * the `<Onboarding.Element />` component.
+ *
+ * @example
+ * The `<Component />` is the source JSX that is rendered when you make use of the `Onboarding`
+ * Element directly. Here is a brief example of how you would use it within your application.
+ * ```tsx
+ * <Onboarding.Element
+ *   onCompleteOnboarding={() => console.log('Onboarding Complete!')}
+ * />
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link Onboarding.ComponentProps | The **props** that can be passed into the `<Onboarding.Element />` component}
+ */
 const Element$4 = alchemy.createElement(Component$3, ErrorFallback, {
   css: {
     height: "100%",
@@ -16410,27 +17623,6 @@ const usePresets = ({
   };
 };
 
-/**
- * Generic error pretty printer
- * @param errors
- * @param predicate
- * @param scrubber
- */
-const useScrubErrors = ({
-  scrubber,
-  errors,
-  predicate
-}) => {
-  const {
-    t
-  } = useTranslation();
-  return useMemo(() => errors === null || errors === void 0 ? void 0 : errors.map(e => {
-    return t(encode(e.message), {
-      defaultValue: !predicate || predicate(e) ? t(scrubber(e)) : e.message
-    });
-  }), [errors, predicate, scrubber, t]);
-};
-
 var usps_first_class_mail = [
 	"First Class Mail shipments must weigh less than {{weight}} oz. Shipments exceeding the weight entered when buying the label will be charged an adjustment fee by USPS."
 ];
@@ -16523,11 +17715,13 @@ const useRequestRates = ({
     reset: resetRates,
     mutateAsync: calculateRates
   } = useCalculateRates();
-  const requestRates = useCallback(shipment => __awaiter(void 0, void 0, void 0, function* () {
-    var _a;
+  const requestRates = useCallback((shipment, isInternational) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const internationalCarrierIds = (_a = carriers === null || carriers === void 0 ? void 0 : carriers.map(c => c.carrierId)) !== null && _a !== void 0 ? _a : [];
+    const domesticCarrierIds = (_b = carriers === null || carriers === void 0 ? void 0 : carriers.filter(c => !["dhl"].includes(c.carrierCode)).map(c => c.carrierId)) !== null && _b !== void 0 ? _b : [];
     const result = yield calculateRates({
       rateOptions: {
-        carrierIds: shipment.carrierId ? [shipment.carrierId] : (_a = carriers === null || carriers === void 0 ? void 0 : carriers.map(c => c.carrierId)) !== null && _a !== void 0 ? _a : [],
+        carrierIds: shipment.carrierId ? [shipment.carrierId] : isInternational ? internationalCarrierIds : domesticCarrierIds,
         packageTypes: (customPackageTypes === null || customPackageTypes === void 0 ? void 0 : customPackageTypes.find(p => p.packageId === shipment.packages[0].packageId)) ? ["package"] // Only specify package types for non-custom packages
         : shipment.packages.map(pkg => pkg.packageCode),
         serviceCodes: shipment.serviceCode ? [shipment.serviceCode] : undefined
@@ -16610,6 +17804,9 @@ const useRatesForm = ({
 }) => {
   var _a, _b;
   const [beforeCreateError, setBeforeCreateError] = useState();
+  const {
+    isInternational
+  } = useShipmentMetadata(shipment);
   const {
     data: carriers
   } = useListCarriers();
@@ -16682,11 +17879,11 @@ const useRatesForm = ({
       shipDate: isNowOrInTheFuture(shipment.shipDate) ? shipment.shipDate : undefined
     }));
     if (updatedShipment) {
-      yield requestRates(updatedShipment);
+      yield requestRates(updatedShipment, isInternational);
       yield onShipmentUpdated === null || onShipmentUpdated === void 0 ? void 0 : onShipmentUpdated(updatedShipment);
       yield onRateSaved === null || onRateSaved === void 0 ? void 0 : onRateSaved(updatedShipment);
     }
-  }), [onRateSaved, onShipmentUpdated, requestRates, shipment, updateShipment]);
+  }), [isInternational, onRateSaved, onShipmentUpdated, requestRates, shipment, updateShipment]);
   let errors = [...(ratesErrors !== null && ratesErrors !== void 0 ? ratesErrors : []), ...((_a = ratesResponse === null || ratesResponse === void 0 ? void 0 : ratesResponse.errors) !== null && _a !== void 0 ? _a : [])];
   if (beforeCreateError) errors = [...errors, beforeCreateError];
   // Sometimes no rates are returned and no top-level errors are returned
@@ -16701,7 +17898,7 @@ const useRatesForm = ({
       name: "CodedError"
     })))) !== null && _b !== void 0 ? _b : [];
   }
-  const displayableErrors = useScrubErrors({
+  const displayableRateErrors = useScrubErrors({
     errors: errors,
     predicate: useCallback(e => e.message.includes("No rates are available for service_codes"), []),
     scrubber: useCallback(() => "common:errorMessages.noRatesAvailable", [])
@@ -16712,8 +17909,8 @@ const useRatesForm = ({
   });
   return {
     carriers,
-    displayableErrors,
     displayableLabelErrors,
+    displayableRateErrors,
     errors: errors.length > 0 ? errors : undefined,
     isLoading: ratesCalculating,
     labelErrors: (labelErrors === null || labelErrors === void 0 ? void 0 : labelErrors.length) ? labelErrors : undefined,
@@ -16748,6 +17945,9 @@ const useShipmentForm = ({
   const {
     data: warehouses
   } = useListWarehouses();
+  const {
+    data: accountSettings
+  } = useGetAccountSettings();
   const {
     error: updateShipmentErrors,
     mutateAsync: updateShipment,
@@ -16807,6 +18007,7 @@ const useShipmentForm = ({
     scrubber: useCallback(() => "common:errorMessages.noRatesAvailable", [])
   });
   return {
+    accountSettings,
     addressLoading,
     addressPreference,
     carriers,
@@ -16846,6 +18047,9 @@ const ConfigureShipment = _a => {
     } = _a,
     props = __rest(_a, ["features", "onAddressValidation", "onApplyPreset", "onBeforeLabelCreate", "onChangeAddress", "onLabelCreateFailure", "onLabelCreateSuccess", "onRateSaved", "onRatesCalculated", "onShipmentUpdated", "printLabelLayout", "salesOrder", "shipment"]);
   const hydrateRef = useRef();
+  const {
+    isInternational
+  } = useShipmentMetadata(shipment);
   const _b = useRatesForm({
       onBeforeLabelCreate,
       onLabelCreateFailure,
@@ -16872,15 +18076,15 @@ const ConfigureShipment = _a => {
       onApplyPreset: useCallback((_preset, shipment) => __awaiter(void 0, void 0, void 0, function* () {
         var _d;
         if (shipment.packages[0].weight.value) {
-          yield requestRates(shipment);
+          yield requestRates(shipment, isInternational);
         }
         (_d = hydrateRef.current) === null || _d === void 0 ? void 0 : _d.call(hydrateRef, shipment);
-      }), [requestRates]),
+      }), [requestRates, isInternational]),
       onChangeAddress,
       onShipmentUpdated,
       onSubmit: useCallback(shipment => __awaiter(void 0, void 0, void 0, function* () {
-        yield requestRates(shipment);
-      }), [requestRates]),
+        yield requestRates(shipment, isInternational);
+      }), [requestRates, isInternational]),
       salesOrder,
       shipment
     }),
@@ -17182,6 +18386,30 @@ const PurchaseLabelByShipment = _a => {
   }));
 };
 
+/**
+ * # Purchase Label Component
+ *
+ * The `<PurchaseLabel />` component is used to purchase shipping labels from various carriers
+ *
+ * @param ElementProps The props necessary to render the `<PurchaseLabel />` component for shipment
+ * based or sales order based label purchasing.
+ *
+ * @returns Element An EmotionJSX.Element that will render the `<PurchaseLabel />` component
+ * with all the appropriate wrappers.
+ *
+ * @example
+ * You can see how the `<Component />` is used in the `createElement` function call below.
+ * ```tsx
+ * export const Element = alchemy.createElement(Component, ErrorFallback, {
+ *   css: { height: "100%", maxWidth: "800px", minWidth: "440px", width: "100%" },
+ *   resources: { en },
+ * });
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link PurchaseLabel.Element | The **Element** created to render `<PurchaseLabel />`}
+ */
 const Component$2 = _a => {
   var props = __rest(_a, []);
   if ("salesOrderId" in props || "orderSourceCode" in props) {
@@ -17190,6 +18418,44 @@ const Component$2 = _a => {
     return jsx(PurchaseLabelByShipment, Object.assign({}, props));
   }
 };
+/**
+ * # Registered Purchase Label Element
+ *
+ * @param ElementProps The props necessary to render the `<PurchaseLabel.Element />` for shipment
+ * based or sales order based label purchasing.
+ *
+ * @example
+ * The `<Component />` is the source JSX that is rendered when you make use of the `PurchaseLabel`
+ * Element directly.
+ * ```tsx
+ * <PurchaseLabel.Element
+ *   key={currentSalesOrderId}
+ *   printLabelLayout='4x6'
+ *   shippingPresets={presets}
+ *   onShipmentUpdated={(shipment) => console.log('Shipment Updated', shipment)}
+ *   onRateSaved={(
+ *     shipment: SE.SalesOrderShipment,
+ *     rate?: SE.Rate,
+ *     rateOptions?: SE.Rate[]
+ *   ) => console.log('Rate Saved', shipment, rate, rateOptions)}
+ *   onRatesCalculated={() => console.log('Rates Calculated')}
+ *   onBeforeLabelCreate={onBeforeLabelPurchase}
+ *   onLabelCreateSuccess={onLabelPurchaseSuccess}
+ *   onLabelCreateFailure={(rate) => console.log('Label Purchase Failed', rate)}
+ *   warehouseId={defaultWarehouseId}
+ * />
+ * ```
+ *
+ * <br />
+ *
+ * - Once a label has been purchased using this Element, you can take the `shipmentId` for the
+ * associated shipment and pass it into the `<ViewShipment.Element />` Element in order to view
+ * the shipment details.
+ *
+ * @see {@link PurchaseLabel.PurchaseLabelCommonProps | The **Common props** used in `<PurchaseLabel.Element />`}
+ *
+ * @see {@link ViewShipment.Element | The next step in the label purchase workflow `<ViewShipment.Element />`}
+ */
 const Element$3 = alchemy.createElement(Component$2, ErrorFallback, {
   css: {
     height: "100%",
@@ -17208,6 +18474,31 @@ var purchaseLabel = /*#__PURE__*/Object.freeze({
 	Element: Element$3
 });
 
+/**
+ * # View Shipment Component
+ *
+ * - The `<ViewShipment />` component is used to for viewing the shipment's tracking number, printing the label that
+ * was created, and the option to void the label. When a label is voided, you can see a list of the
+ * previously voided labels for a given shipment using this component.
+ *
+ * @param ComponentProps The base props that will be passed into the `<ViewShipment />` component.
+ *
+ * @returns Element An EmotionJSX.Element that will render the `<ViewShipment />` component
+ * with all the appropriate wrappers.
+ *
+ * @example
+ * You can see how the `<Component />` is used in the `createElement` function call below.
+ * ```tsx
+ * export const Element = alchemy.createElement(Component, ErrorFallback, {
+ *   css: { height: "100%", maxWidth: "800px", minWidth: "440px", width: "100%" },
+ *   resources: { en },
+ * });
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link ViewShipment.Element | The **Element** created to render `<ViewShipment />`}
+ */
 const Component$1 = ({
   features,
   onClickPrintLabel,
@@ -17247,6 +18538,36 @@ const Component$1 = ({
     warehouse: warehouse
   });
 };
+/**
+ * # Registered View Shipment Element
+ *
+ * - This is the registered `<ViewShipment />` element that will be used to render the
+ * `<ViewShipment.Element />` component.
+ *
+ * @param ElementProps The props, callbacks, and resources necessary to render
+ * the `<ViewShipment.Element />` component.
+ *
+ * @example
+ * The `<Component />` is the source JSX that is rendered when you make use of the `ViewShipment`
+ * Element directly. Here is a brief example of how you would use it within your application.
+ * ```tsx
+ * <ViewShipment.Element
+ *   onClickPurchaseLabel={({ salesOrderId }) => {
+ *     console.log('sales order ID', salesOrderId);
+ *   }}
+ *   onClickVoidLabel={({ labelId }) => {
+ *     console.log('voided label', labelId);
+ *   }}
+ *   shipmentId="se-1234567"
+ * />
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link ViewShipment.ComponentProps | The **props** that can be passed into the `<ViewShipment.Element />` component}
+ *
+ * @see {@link VoidLabel.Element | The next step in the label purchase workflow `<VoidLabel.Element />`}
+ **/
 const Element$2 = alchemy.createElement(Component$1, ErrorFallback, {
   css: {
     height: "100%",
@@ -17370,6 +18691,31 @@ const Message = ({
   });
 };
 
+/**
+ * # Void Label Component
+ *
+ * - The `<VoidLabel />` component is used to void a given shipping label. When a label is voided,
+ * you then get the option to view the associated shipment via the `View Shipment` Element, or
+ * you can purchase another label for the shipment via the `Purchase Label` Element.
+ *
+ * @param ComponentProps The base props that will be passed into the `<VoidLabel />` component.
+ *
+ * @returns Element An EmotionJSX.Element that will render the `<VoidLabel />` component
+ * with all the appropriate wrappers.
+ *
+ * @example
+ * You can see how the `<Component />` is used in the `createElement` function call below.
+ * ```tsx
+ * export const Element = alchemy.createElement(Component, ErrorFallback, {
+ *   css: { height: "100%", maxWidth: "800px", minWidth: "440px", width: "100%" },
+ *   resources: { en },
+ * });
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link VoidLabel.Element | The **Element** created to render `<VoidLabel />`}
+ */
 const Component = ({
   features,
   labelId,
@@ -17421,6 +18767,37 @@ const Component = ({
     })]
   });
 };
+/**
+ * # Registered Void Label Element
+ *
+ * - This is the registered `<VoidLabel />` element that will be used to render the
+ * `<VoidLabel.Element />` component.
+ *
+ * @param ElementProps The props, callbacks, and resources necessary to render
+ * the `<VoidLabel.Element />` component.
+ *
+ * @example
+ * The `<Component />` is the source JSX that is rendered when you make use of the `VoidLabel`
+ * Element directly. Here is a brief example of how you would use it within your application.
+ * ```tsx
+ * <VoidLabel.Element
+ *   labelId="se-1234567"
+ *   onComplete={() => console.log('onComplete')}
+ *   onSuccess={(_, { salesOrderIds: [salesOrderId] }) =>
+ *     console.log('sales order ID', salesOrderId)
+ *   }
+ *   onViewShipment={({ shipmentId }) => {
+ *     console.log('onViewShipment', shipmentId);
+ *   }}
+ * />
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link VoidLabel.ComponentProps | The **props** that can be passed into the `<VoidLabel.Element />` component}
+ *
+ * @see {@link PurchaseLabel.Element | Go back to the frst step in the label purchase workflow `<PurchaseLabel.Element />`}
+ */
 const Element$1 = alchemy.createElement(Component, ErrorFallback, {
   css: {
     height: "100%",
@@ -17439,6 +18816,31 @@ var voidLabel = /*#__PURE__*/Object.freeze({
 	Element: Element$1
 });
 
+/**
+ * @internal
+ *
+ * # Label Workflow Component
+ *
+ * @example
+ * ```tsx
+ *   const {
+ *     labelId,
+ *     multiplexedId,
+ *     isVoidingLabel,
+ *     shipmentId,
+ *     setLabelId,
+ *     setShipmentId,
+ *     setIsVoidingLabel,
+ *   } = useLabelWorkflow({
+ *     _labelId,
+ *     _multiplexedId,
+ *   });
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link LabelWorkflow.Element | The `<LabelWorkflow.Element />` component using this hook}
+ */
 const useLabelWorkflow = ({
   _multiplexedId,
   _labelId
@@ -17463,6 +18865,33 @@ const useLabelWorkflow = ({
     shipmentId
   };
 };
+/**
+ * @internal
+ *
+ * # Label Workflow Element
+ *
+ * - The `<LabelWorkflow.Element />` component is a composition of the PurchaseLabel, ViewShipment,
+ * and VoidLabel elements that allows users to purchase a label, view the shipment details, and optionally void their shipping label.
+ *
+ * @param LabelWorkflowProps The props necessary to render the `<LabelWorkflow.Element />` for shipment
+ * based or sales order based label purchasing.
+ *
+ * @returns Element A React Element that will render the `<LabelWorkflow />` component.
+ *
+ * @example
+ * ```tsx
+ * <LabelWorkflow
+ *       {...elementProps}
+ *       callbacks={{ onLabelCreateSuccess }}
+ *       multiplexedId={elementIdProps}
+ * />
+ * ```
+ *
+ * <br />
+ *
+ * @see {@link LabelWorkflowProps | The props that are passed into the `<LabelWorkflow />` component}
+ * @see {@link LabelWorkflow.useLabelWorkflow | The `hook` that is used to manage the state of the `<LabelWorkflow />` component}
+ */
 const Element = (
 /*
 The passed props are underscore prefixed as they will be stashed, then from them stateful versions will be made
@@ -17532,7 +18961,8 @@ The passed props are underscore prefixed as they will be stashed, then from them
 
 var labelWorkflow = /*#__PURE__*/Object.freeze({
 	__proto__: null,
+	useLabelWorkflow: useLabelWorkflow,
 	Element: Element
 });
 
-export { accountSettings as AccountSettings, AddFundsForm, AutoFundingForm, ButtonGroup, CarrierBalance, CollapsiblePanel, CopyButton, Country, Cube, DateRangeCombo, DateRangeSelect, ErrorFallback, fields as Field, FieldLabel, FormPortal, FundAndPurchase, InlineLabel, ItemsBreakdown, labelWorkflow as LabelWorkflow, LinkAction, listCarriers$1 as ListCarriers, Loader, ManageFunding, manageWarehouses$1 as ManageWarehouses, onboarding as Onboarding, PageLayoutProvider, PaymentMethodSettings, Portal, PoweredByShipEngine, purchaseLabel as PurchaseLabel, RootPortalProvider, Section, Spacer, Spread, StoryNotes, index as Templates, UsState, UsaCity, viewShipment as ViewShipment, voidLabel as VoidLabel, autoFundingSchema, calculateTotal, capitalizeFirstLetter, convertDimensions, convertWeight, countries, countryCodes, createCodedErrors, createDictionary, createStyles, currencySymbol, daysAfter, errorMap, euCountryCodes, extendZod, featureFlagComponentNameLookup, formLogger, formatCreditCardNumber, formatDate, formatDateDDMMYY, formatExpiration, formatFractionalWeight, formatMoney, getAddFundsSchema, getCarrierIdByCarrierCode, getCustomsFromSalesOrder, getExpirationYears, getFeatures, getIsCustomsRequiredForSalesOrder, getIsCustomsRequiredForShipment, getIsInternationalShipment, getPendingShipment, getRateRequiresAcknowledgement, getRelativeDates, getRequestedServices, getSalesOrderItemsFromSalesOrderOrShipment, getTotalRateAmount, isDomesticAddress, isEmptyAddress, isFlatRatePackageCode, isMilitaryAddress, isNowOrInTheFuture, isPoBox, isPoBoxAddress, isString, isUnitedStatesTerritory, isUnsupportedByUps, isUpsCarrier, isUspsCarrier, moneySchema, mostRecent, nextDayCutoff, omitTime, overrideCarrierCodes$1 as overrideCarrierCodes, phoneSchema, phoneSchemaUnvalidated, postalCodeRegex$3 as postalCodeRegex, sortByCreationDate, throwAny, throwJoinedMessages, usCities, usStateCodes, usStates, useAddressValidation, useBlackboxDetection, useCarrierMetadata, useConfirmationOptions, useCountryCodeOptions, useCustomsContentsOptions, useCustomsNonDeliveryOptions, useDateRangeOptions, useExpirationMonthOptions, useFeatures, useInsuranceProviderOptions, useNestedForm, usePackageOptions, usePageLayout, useRateOptions, useRootPortal, useRunOnceOnTrue, useServiceCodeOptions, useShipmentMetadata, useShippingPresetsOptions, useStateCodeOptions, useToggle, useWarehouseOptions, validationResolver };
+export { accountSettings as AccountSettings, AddFundsForm, AutoFundingForm, ButtonGroup, CarrierBalance, CollapsiblePanel, CopyButton, Country, Cube, DateRangeCombo, DateRangeSelect, ErrorFallback, fields as Field, FieldLabel, FormPortal, FundAndPurchase, InlineLabel, ItemsBreakdown, labelWorkflow as LabelWorkflow, LinkAction, listCarriers$1 as ListCarriers, Loader, ManageFunding, manageWarehouses$1 as ManageWarehouses, onboarding as Onboarding, PageLayoutProvider, PaymentMethodSettings, Portal, PoweredByShipEngine, purchaseLabel as PurchaseLabel, RootPortalProvider, Section, Spacer, Spread, StoryNotes, index as Templates, UsState, UsaCity, viewShipment as ViewShipment, voidLabel as VoidLabel, autoFundingSchema, calculateTotal, capitalizeFirstLetter, convertDecimalWeightToFractionalWeight, convertDimensions, convertFractionalWeightToDecimalWeight, convertPoundsAndOuncesToOunces, convertWeight, countries, countryCodes, createCodedErrors, createDictionary, createStyles, currencySymbol, daysAfter, errorMap, euCountryCodes, extendZod, featureFlagComponentNameLookup, featureFlags, formLogger, formatCreditCardNumber, formatDate, formatDateDDMMYY, formatDimensions, formatExpiration, formatFractionalWeight, formatMoney, getAddFundsSchema, getCarrierIdByCarrierCode, getCustomsFromSalesOrder, getExpirationYears, getFeatures, getIsCustomsRequiredForSalesOrder, getIsCustomsRequiredForShipment, getIsInternationalShipment, getPendingShipment, getRateRequiresAcknowledgement, getRelativeDates, getRequestedServices, getSalesOrderItemsFromSalesOrderOrShipment, getTotalRateAmount, isDecimalWeight, isDomesticAddress, isEmptyAddress, isFlatRatePackageCode, isMetricWeightUnit, isMilitaryAddress, isNowOrInTheFuture, isPoBox, isPoBoxAddress, isString, isUnitedStatesTerritory, isUnsupportedByUps, isUpsCarrier, isUspsCarrier, moneySchema, mostRecent, nextDayCutoff, omitTime, overrideCarrierCodes$1 as overrideCarrierCodes, phoneSchema, phoneSchemaUnvalidated, postalCodeRegex$3 as postalCodeRegex, sortByCreationDate, throwAny, throwJoinedMessages, usCities, usStateCodes, usStates, useAddressValidation, useBlackboxDetection, useCarrierMetadata, useConfirmationOptions, useCountryCodeOptions, useCustomsContentsOptions, useCustomsNonDeliveryOptions, useDateRangeOptions, useExpirationMonthOptions, useFeatures, useInsuranceProviderOptions, useNestedForm, usePackageOptions, usePageLayout, useRateOptions, useRootPortal, useRunOnceOnTrue, useScrubErrors, useServiceCodeOptions, useShipmentMetadata, useShippingPresetsOptions, useStateCodeOptions, useToggle, useWarehouseOptions, validationResolver };