@shipengine/elements 2.17.0 → 2.19.0

package/src/elements/theme-creator/theme-creator.d.ts

@@ -1,19 +1,8 @@
 /// <reference types="react" />
-import { CustomThemeData } from "@shipengine/giger-theme";
-export type ComponentProps = {
-    onUpdateThemeConfig: (themeConfig: CustomThemeData) => void;
-    presets?: {
-        presetName: string;
-        themeConfig: CustomThemeData;
-    }[];
-    showDrawer?: {
-        content?: React.ReactNode;
-        copyToClipboardText?: string;
-    };
-    themeConfig: CustomThemeData;
-};
-export declare const Component: ({ ...props }: ComponentProps) => import("@emotion/react/jsx-runtime").JSX.Element;
-export declare const Element: ({ resources, ...props }: ComponentProps & {
+import { ThemeCreatorProps } from "../../components/templates/theme-creator";
+export type ComponentProps = ThemeCreatorProps;
+export declare const Component: ({ ...props }: ThemeCreatorProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const Element: ({ resources, ...props }: ThemeCreatorProps & {
     resources?: {
         en: {
             "wallet-history": {
@@ -35,6 +24,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     thisMonth: string;
                     lastMonth: string;
                 };
+                category: {
+                    fundsAdded: string;
+                };
             };
             "void-label": {
                 title: string;
@@ -631,8 +623,10 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 trackingStatus: {
                     unknown: string;
                     inTransit: string;
+                    in_transit: string;
                     delivered: string;
                     error: string;
+                    voided: string;
                 };
                 actions: {
                     title: string;
@@ -652,6 +646,17 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     connectCarriers: string;
                     disconnect: string;
                     disconnectCarrier: string;
+                    downloadEula: string;
+                };
+                customForms: {
+                    fedex: {
+                        eulaName: string;
+                        disclaimerFooter: string;
+                    };
+                };
+                eula: {
+                    toContinue: string;
+                    iAgree: string;
                 };
                 noCarriersDescription: string;
                 registrationForm: {
@@ -698,6 +703,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 address: {
                     fields: {
                         name: string;
+                        fullName: string;
                         company: string;
                         county: string;
                         countryCode: string;
@@ -860,6 +866,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     unknown: string;
                     noRatesAvailable: string;
                     refreshAndTryAgain: string;
+                    updateShipFromAddress: string;
                     windsorFramework: {
                         doNotConform: string;
                         pleaseAddTheFollowingTaxIds: string;
@@ -878,6 +885,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     saveRate: string;
                     security: string;
                     shipmentStatus: string;
+                    shipFromAddress: string;
                     system: string;
                     unknown: string;
                     validation: string;
@@ -891,6 +899,8 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     shipmentId: string;
                     labelId: string;
                     labelIdFilter: string;
+                    filteredTrackingStatus: string;
+                    more: string;
                     createdDate: string;
                     shipmentIdFilter: string;
                     createdDateFilter: string;

package/src/elements/transaction-history/transaction-history-element.d.ts

@@ -22,6 +22,9 @@ export declare const Element: ({ resources, ...props }: object & {
                     thisMonth: string;
                     lastMonth: string;
                 };
+                category: {
+                    fundsAdded: string;
+                };
             };
             "void-label": {
                 title: string;
@@ -618,8 +621,10 @@ export declare const Element: ({ resources, ...props }: object & {
                 trackingStatus: {
                     unknown: string;
                     inTransit: string;
+                    in_transit: string;
                     delivered: string;
                     error: string;
+                    voided: string;
                 };
                 actions: {
                     title: string;
@@ -639,6 +644,17 @@ export declare const Element: ({ resources, ...props }: object & {
                     connectCarriers: string;
                     disconnect: string;
                     disconnectCarrier: string;
+                    downloadEula: string;
+                };
+                customForms: {
+                    fedex: {
+                        eulaName: string;
+                        disclaimerFooter: string;
+                    };
+                };
+                eula: {
+                    toContinue: string;
+                    iAgree: string;
                 };
                 noCarriersDescription: string;
                 registrationForm: {
@@ -685,6 +701,7 @@ export declare const Element: ({ resources, ...props }: object & {
                 address: {
                     fields: {
                         name: string;
+                        fullName: string;
                         company: string;
                         county: string;
                         countryCode: string;
@@ -847,6 +864,7 @@ export declare const Element: ({ resources, ...props }: object & {
                     unknown: string;
                     noRatesAvailable: string;
                     refreshAndTryAgain: string;
+                    updateShipFromAddress: string;
                     windsorFramework: {
                         doNotConform: string;
                         pleaseAddTheFollowingTaxIds: string;
@@ -865,6 +883,7 @@ export declare const Element: ({ resources, ...props }: object & {
                     saveRate: string;
                     security: string;
                     shipmentStatus: string;
+                    shipFromAddress: string;
                     system: string;
                     unknown: string;
                     validation: string;
@@ -878,6 +897,8 @@ export declare const Element: ({ resources, ...props }: object & {
                     shipmentId: string;
                     labelId: string;
                     labelIdFilter: string;
+                    filteredTrackingStatus: string;
+                    more: string;
                     createdDate: string;
                     shipmentIdFilter: string;
                     createdDateFilter: string;

package/src/elements/unit-settings/unit-settings-element.d.ts

@@ -22,6 +22,9 @@ export declare const Element: ({ resources, ...props }: object & {
                     thisMonth: string;
                     lastMonth: string;
                 };
+                category: {
+                    fundsAdded: string;
+                };
             };
             "void-label": {
                 title: string;
@@ -618,8 +621,10 @@ export declare const Element: ({ resources, ...props }: object & {
                 trackingStatus: {
                     unknown: string;
                     inTransit: string;
+                    in_transit: string;
                     delivered: string;
                     error: string;
+                    voided: string;
                 };
                 actions: {
                     title: string;
@@ -639,6 +644,17 @@ export declare const Element: ({ resources, ...props }: object & {
                     connectCarriers: string;
                     disconnect: string;
                     disconnectCarrier: string;
+                    downloadEula: string;
+                };
+                customForms: {
+                    fedex: {
+                        eulaName: string;
+                        disclaimerFooter: string;
+                    };
+                };
+                eula: {
+                    toContinue: string;
+                    iAgree: string;
                 };
                 noCarriersDescription: string;
                 registrationForm: {
@@ -685,6 +701,7 @@ export declare const Element: ({ resources, ...props }: object & {
                 address: {
                     fields: {
                         name: string;
+                        fullName: string;
                         company: string;
                         county: string;
                         countryCode: string;
@@ -847,6 +864,7 @@ export declare const Element: ({ resources, ...props }: object & {
                     unknown: string;
                     noRatesAvailable: string;
                     refreshAndTryAgain: string;
+                    updateShipFromAddress: string;
                     windsorFramework: {
                         doNotConform: string;
                         pleaseAddTheFollowingTaxIds: string;
@@ -865,6 +883,7 @@ export declare const Element: ({ resources, ...props }: object & {
                     saveRate: string;
                     security: string;
                     shipmentStatus: string;
+                    shipFromAddress: string;
                     system: string;
                     unknown: string;
                     validation: string;
@@ -878,6 +897,8 @@ export declare const Element: ({ resources, ...props }: object & {
                     shipmentId: string;
                     labelId: string;
                     labelIdFilter: string;
+                    filteredTrackingStatus: string;
+                    more: string;
                     createdDate: string;
                     shipmentIdFilter: string;
                     createdDateFilter: string;

package/src/elements/vat-settings/vat-settings-element.d.ts

@@ -22,6 +22,9 @@ export declare const Element: ({ resources, ...props }: object & {
                     thisMonth: string;
                     lastMonth: string;
                 };
+                category: {
+                    fundsAdded: string;
+                };
             };
             "void-label": {
                 title: string;
@@ -618,8 +621,10 @@ export declare const Element: ({ resources, ...props }: object & {
                 trackingStatus: {
                     unknown: string;
                     inTransit: string;
+                    in_transit: string;
                     delivered: string;
                     error: string;
+                    voided: string;
                 };
                 actions: {
                     title: string;
@@ -639,6 +644,17 @@ export declare const Element: ({ resources, ...props }: object & {
                     connectCarriers: string;
                     disconnect: string;
                     disconnectCarrier: string;
+                    downloadEula: string;
+                };
+                customForms: {
+                    fedex: {
+                        eulaName: string;
+                        disclaimerFooter: string;
+                    };
+                };
+                eula: {
+                    toContinue: string;
+                    iAgree: string;
                 };
                 noCarriersDescription: string;
                 registrationForm: {
@@ -685,6 +701,7 @@ export declare const Element: ({ resources, ...props }: object & {
                 address: {
                     fields: {
                         name: string;
+                        fullName: string;
                         company: string;
                         county: string;
                         countryCode: string;
@@ -847,6 +864,7 @@ export declare const Element: ({ resources, ...props }: object & {
                     unknown: string;
                     noRatesAvailable: string;
                     refreshAndTryAgain: string;
+                    updateShipFromAddress: string;
                     windsorFramework: {
                         doNotConform: string;
                         pleaseAddTheFollowingTaxIds: string;
@@ -865,6 +883,7 @@ export declare const Element: ({ resources, ...props }: object & {
                     saveRate: string;
                     security: string;
                     shipmentStatus: string;
+                    shipFromAddress: string;
                     system: string;
                     unknown: string;
                     validation: string;
@@ -878,6 +897,8 @@ export declare const Element: ({ resources, ...props }: object & {
                     shipmentId: string;
                     labelId: string;
                     labelIdFilter: string;
+                    filteredTrackingStatus: string;
+                    more: string;
                     createdDate: string;
                     shipmentIdFilter: string;
                     createdDateFilter: string;

package/src/elements/void-label/void-label.d.ts

@@ -109,6 +109,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     thisMonth: string;
                     lastMonth: string;
                 };
+                category: {
+                    fundsAdded: string;
+                };
             };
             "void-label": {
                 title: string;
@@ -718,7 +721,13 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 };
                 empty: {
                     title: string;
-                    subtitle: string;
+                    subtitle: string; /**
+                     * # Void Label Component Props
+                     *
+                     * - These are the base props that will be passed into the `<VoidLabel />` component.
+                     *
+                     * @see {@link VoidLabel.Component | This prop types usage in the `<VoidLabel />` component}
+                     */
                 };
                 emptyWithFilters: {
                     title: string;
@@ -733,25 +742,29 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 };
                 trackingStatus: {
                     unknown: string;
+                    /**
+                     * `onComplete` is a callback function that will be invoked when the request to void a given
+                     * shipping label is completed.
+                     */
                     inTransit: string;
+                    in_transit: string;
                     delivered: string;
                     error: string;
+                    voided: string;
                 };
                 actions: {
                     title: string;
-                    print: string;
+                    print: string; /**
+                     * `onSuccess` is a callback function that will be invoked when the request to void a given
+                     * shipping label is successful.
+                     */
                     void: string;
                     printForms: string;
                 };
                 errorMessages: {
                     title: string;
                     subtitle: string;
-                }; /**
-                 * `onViewShipment` is a callback function that will be invoked when the user clicks the
-                 * `View Shipment` button. This will take you back to the
-                 * {@link ShipmentSummary.Element | `Shipment Summary Element`} for the given shipment, where you
-                 * will be able to see the voided label listed.
-                 */
+                };
             };
             "connect-carrier": {
                 actions: {
@@ -760,6 +773,17 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     connectCarriers: string;
                     disconnect: string;
                     disconnectCarrier: string;
+                    downloadEula: string;
+                };
+                customForms: {
+                    fedex: {
+                        eulaName: string;
+                        disclaimerFooter: string;
+                    };
+                };
+                eula: {
+                    toContinue: string;
+                    iAgree: string;
                 };
                 noCarriersDescription: string;
                 registrationForm: {
@@ -806,6 +830,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 address: {
                     fields: {
                         name: string;
+                        fullName: string;
                         company: string;
                         county: string;
                         countryCode: string;
@@ -818,6 +843,10 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         email: string;
                         addressResidentialIndicator: string;
                     };
+                    /**
+                     * `onComplete` is a callback function that will be invoked when the request to void a given
+                     * shipping label is completed.
+                     */
                     noResults: string;
                     subFields: {
                         optional: string;
@@ -827,6 +856,10 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     };
                     paste: string;
                     preference: {
+                        /**
+                         * `onSuccess` is a callback function that will be invoked when the request to void a given
+                         * shipping label is successful.
+                         */
                         confirm: string;
                         addressNotValidated: string;
                         modified: string;
@@ -937,7 +970,11 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                             title: string;
                             restriction: string;
                             requirement1: string;
-                            requirement2: string;
+                            requirement2: string; /**
+                             * # Void Label Element Props
+                             *
+                             * @see {@link VoidLabel.Element | See the full type that `typeof Element` will return}
+                             */
                             requirement3: string;
                         };
                     };
@@ -968,6 +1005,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     unknown: string;
                     noRatesAvailable: string;
                     refreshAndTryAgain: string;
+                    updateShipFromAddress: string;
                     windsorFramework: {
                         doNotConform: string;
                         pleaseAddTheFollowingTaxIds: string;
@@ -986,6 +1024,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     saveRate: string;
                     security: string;
                     shipmentStatus: string;
+                    shipFromAddress: string;
                     system: string;
                     unknown: string;
                     validation: string;
@@ -999,6 +1038,8 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     shipmentId: string;
                     labelId: string;
                     labelIdFilter: string;
+                    filteredTrackingStatus: string;
+                    more: string;
                     createdDate: string;
                     shipmentIdFilter: string;
                     createdDateFilter: string;

package/src/elements-provider/elements-context-provider.d.ts

@@ -8,7 +8,7 @@ export interface ElementsContextValue {
     baseURL: string;
     cdnURL: string;
     container?: HTMLElement;
-    emotionCacheShadowRootContainer?: ShadowRoot & HTMLElement;
+    emotionCacheShadowRootContainer?: ShadowRoot | null;
     getFeatures: (key: keyof ElementsFeatureFlags) => ElementsFeatureFlags[keyof ElementsFeatureFlags];
     getToken: ShipEngineProps["getToken"];
     globalFeatures: GlobalFeatures;
@@ -27,7 +27,7 @@ export type ElementsContextProviderProps = {
     cdnURL?: string;
     children: React.ReactNode;
     container?: HTMLElement;
-    emotionCacheShadowRootContainer?: ShadowRoot & HTMLElement;
+    emotionCacheShadowRootContainer?: ShadowRoot | null;
     features?: ElementsFeatureFlags;
     locale?: string;
     onError?: ElementsErrorHandler;

package/src/elements-provider/elements-provider.d.ts

@@ -5,7 +5,6 @@ import { ShipEngineAPIConfig } from "@shipengine/react-api";
 import { ElementsContextProviderProps } from "./elements-context-provider";
 export type ElementsProviderProps = Omit<ElementsContextProviderProps, "theme"> & ShipEngineAPIConfig & {
     defaultQueryClientOptions?: DefaultOptions;
-    emotionCacheShadowRootContainer?: ShadowRoot & HTMLElement;
     themeConfig?: CustomThemeData | {
         [THEME_ID]: CustomThemeData;
     };
@@ -13,4 +12,4 @@ export type ElementsProviderProps = Omit<ElementsContextProviderProps, "theme">
 /**
  * @category Providers
  */
-export declare const ElementsProvider: ({ baseURL, cdnURL, children, container, features, getToken, headers, locale, onApiError, onError, scope, themeConfig, defaultQueryClientOptions, emotionCacheShadowRootContainer, }: ElementsProviderProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ElementsProvider: ({ baseURL, cdnURL, children, container, features, getToken, headers, locale, onApiError, onError, scope, themeConfig, defaultQueryClientOptions, emotionCacheShadowRootContainer, }: ElementsProviderProps) => import("@emotion/react/jsx-runtime").JSX.Element | null;

package/src/features/manage-carriers/manage-carriers.d.ts

@@ -1,12 +1,10 @@
-import { CodedError, Currency } from "@shipengine/react-api";
+import { CodedError, SE } from "@shipengine/react-api";
+export type AddFundsPayload = {
+    fundingSourceId: string;
+    funds: SE.Money;
+};
 export type ShipEngineCarriersProps = {
-    addFunds?: (payload: {
-        carrierId: string;
-        funds: {
-            amount: number;
-            currency: Currency;
-        };
-    }) => Promise<void>;
+    addFunds: (payload: AddFundsPayload) => Promise<void>;
     addFundsError?: CodedError[] | null;
     isUpdateFundsError?: boolean;
     isUpdatingFunds?: boolean;

package/src/features/manage-carriers/use-manage-carriers.d.ts

@@ -1,13 +1,10 @@
-import { Currency } from "@shipengine/react-api";
+import { SE } from "@shipengine/react-api";
 export declare const useManageCarriers: () => {
     addFunds: (payload: {
-        carrierId: string;
-        funds: {
-            amount: number;
-            currency: Currency;
-        };
+        fundingSourceId: string;
+        funds: SE.Money;
     }) => Promise<void>;
-    addFundsError: import("@shipengine/react-api").CodedError[] | null;
+    addFundsError: SE.CodedError[] | null;
     isAddFundsSuccess: boolean;
     isAddingFunds: boolean;
     isAddingFundsError: boolean;

package/src/features/manage-funding/manage-funding.d.ts

@@ -1,4 +1,4 @@
-import { CodedError, Currency } from "@shipengine/react-api";
+import { CodedError, SE } from "@shipengine/react-api";
 /**
  * @namespace ManageFunding
  *
@@ -15,14 +15,9 @@ import { CodedError, Currency } from "@shipengine/react-api";
  * @see {@link ManageFundingProps | The props that are passed into the `<ManageFunding />` component}
  */
 export type ManageFundingProps = {
-    addFunds?: (payload: {
-        carrierId: string;
-        funds: {
-            amount: number;
-            currency: Currency;
-        };
-    }) => Promise<void>;
+    addFunds?: (payload: SE.Money) => Promise<void>;
     addFundsError?: CodedError[] | null;
+    fundingSource?: SE.FundingSource;
     onRedirectToOnboarding?: () => void;
 };
-export declare const ManageFunding: ({ onRedirectToOnboarding, addFunds, addFundsError, }: ManageFundingProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ManageFunding: ({ onRedirectToOnboarding, addFunds, addFundsError, fundingSource, }: ManageFundingProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/src/hooks/index.d.ts

@@ -12,3 +12,4 @@ export * from "./use-scrub-errors";
 export * from "./use-toggle";
 export * from "./use-configure-shipment";
 export * from "./use-import-sales-order";
+export * from "./use-balance-services";

package/src/hooks/insurance/use-manage-funding-source-insurance.d.ts

@@ -1,6 +1,7 @@
 import { SE } from "@shipengine/react-api";
 import { InsuranceProviderProfile } from "../../types";
 export declare const useManageFundingSourceInsurance: () => {
+    fundingSourceCountryCode: string | undefined;
     hasInsuranceToRegister: boolean | undefined;
     insuranceAcceptedTerms: SE.Term[] | undefined;
     insuranceProviderProfiles: InsuranceProviderProfile[] | undefined;

package/src/hooks/options/use-date-range-options.d.ts

@@ -5,7 +5,10 @@
  *
  * @see {@link DateRangeOption | The `DateRangeOption` that uses this type}
  */
-export type DateRange = [Date, Date];
+export type DateRange = {
+    endDate: Date;
+    startDate: Date;
+};
 /**
  * @internal
  *

package/src/hooks/options/use-rate-options.d.ts

@@ -1,5 +1,6 @@
 import { SE } from "@shipengine/react-api";
 import { PreferredRateAcknowledgementMessage, PreferredRatesResponse } from "../../types";
+import { FundingOrigin } from "../use-balance-services";
 /**
  * @internal
  *
@@ -32,4 +33,4 @@ export type RateOption = Omit<SE.Rate, "warningMessages"> & {
  *
  * # Rate Options Hook
  */
-export declare const useRateOptions: (rates?: SE.Rate[], preferredRates?: PreferredRatesResponse, carriers?: SE.Carrier[], shipment?: SE.SalesOrderShipment, servicePoints?: SE.ServicePoint[], requireDhlTermsAcknowledgement?: boolean, windsorFrameworkEnabled?: boolean) => RateOption[];
+export declare const useRateOptions: (rates?: SE.Rate[], fundingOrigin?: FundingOrigin, preferredRates?: PreferredRatesResponse, carriers?: SE.Carrier[], shipment?: SE.SalesOrderShipment, servicePoints?: SE.ServicePoint[], requireDhlTermsAcknowledgement?: boolean, windsorFrameworkEnabled?: boolean) => RateOption[];

package/src/hooks/use-balance-services.d.ts

@@ -0,0 +1,22 @@
+import { CodedError, SE } from "@shipengine/react-api";
+export type FundingOrigin = {
+    balance: number;
+    currency: SE.Currency;
+    id: string;
+};
+export type UseBalanceServicesReturnType = ReturnType<typeof useBalanceServices>;
+/**
+ * The `useBalanceServices` hook retrieves and manages balance information for a carrier or funding source. If a funding source cannot be found, the hook will default to using the carrier balance associated with the provided `carrierId` as the primary source of truth.
+ *
+ * @returns `UseBalanceServicesReturnType`
+ */
+export declare const useBalanceServices: () => {
+    addFundsMutation: (funds: SE.Money) => Promise<void>;
+    errors: {
+        addFundsErrors: CodedError[] | undefined;
+        fetchBalanceErrors: CodedError[] | undefined;
+    };
+    fundingOrigin: FundingOrigin | undefined;
+    isLoadingBalance: boolean;
+    resetAddFundsMutationState: () => void;
+};

package/src/hooks/use-helpers.d.ts

@@ -1,4 +1,8 @@
 export declare const useHelpers: () => {
     helpersReady: boolean;
     sellerOnboarded: boolean;
+    validateShipFromAddress: (shipFromAddress: import("..").ShipFromAddress) => {
+        errors: unknown;
+        isValid: boolean;
+    };
 };